Maps JavaScript API ile ilgili politikalar ve ilişkilendirmeler

Bu dokümanda, Maps JavaScript API ile geliştirilen uygulamalarla ilgili şartlar listelenmiştir. Maps JavaScript API'nin kullanımının Google ile yaptığınız sözleşmeye tabi olduğunu unutmayın.

Politikalar

Bu bölümde, Maps JavaScript API ile ilgili politikalar açıklanmaktadır. Politikalar, Hizmet'i doğru şekilde ve Google Haritalar Platformu'nun beklentilerine uygun olarak kullanmanıza yardımcı olacak pratik uygulama yönergeleri ve şartlar sağlar.

Önbelleğe alma kısıtlamalarıyla ilgili istisnalar

Bir yeri benzersiz şekilde tanımlamak için kullanılan yer kimliğinin önbelleğe alma kısıtlamalarından muaf olduğunu unutmayın. Bu nedenle, yer kimliği değerlerini süresiz olarak saklayabilirsiniz. Yer kimliği, API yanıtlarındaki place_id alanında döndürülür. Yer kimlikleri kılavuzunda yer kimliklerini nasıl kaydedeceğinizi, yenileyeceğinizi ve yöneteceğinizi öğrenin.

İçerik kazıma

Yer Adı, kullanıcının uygulamanızla etkileşimlerine göre size döndürülebilir. Kullanıcı oturumu dışında başka bir bağlamda kullanmak üzere Yer Adı'nı yakalar veya saklarsanız bu, şartlarımıza göre izin verilmeyen kazıma işlemi olarak kabul edilir.

Avrupa Ekonomik Alanı ülkeleri ve idari bölgeleri

Bu ürünün, fatura adresi Avrupa Ekonomik Alanı'nda (AEA) olan müşteriler için farklı Hizmet Şartları vardır ve farklı işlevleri olabilir. Google Haritalar Platformu ile derleme yapmadan önce AEA'ya özgü aşağıdaki şartları ve bilgileri inceleyin:

• Google Haritalar Platformu AEA Hizmet Şartları
• Google Haritalar Platformu AEA Hizmetine Özel Şartları
• AEA ile ilgili sık sorulan sorular (SSS)
• Google Haritalar Platformu Yol Güvenliği Şartları

Fatura adresiniz AEA'da değilse aşağıdaki hizmet şartları sizin için geçerlidir:

• Google Haritalar Platformu Hizmet Şartları
• Google Haritalar Platformu Hizmetine Özel Şartlar

Google Haritalar ilişkilendirme şartları

Bu bölümde, Google Haritalar'ı ve İçerik'i uygulamalarınız aracılığıyla görüntülemeyle ilgili ilişkilendirme koşulları ve yönergeleri açıklanmaktadır.

İlişkilendirme örneği

Aşağıda, Places UI Kit için bir atıf örneği verilmiştir.

Google Haritalar ilişkilendirmesini görüntüleme

Uygulamanızda veya web sitenizde Google Haritalar Platformu API'lerinden içerik gösterirken Google Haritalar ilişkilendirme koşullarına uymanız gerekir. İçerik, ilişkilendirmenin zaten görünür olduğu bir Google Haritası'nda gösteriliyorsa ek ilişkilendirme eklemeniz gerekmez.

Google Haritalar ilişkilendirmesi dahil

Kullanıcı arayüzünde Google Haritalar Platformu tarafından sağlanan Google Haritalar atıfları için (ör. Places UI Kit'te):

• Dahil edilen atıfı, nerede gösterildiğine bakılmaksızın kaldırmayın. Atıfı değiştirmeyin, gizlemeyin veya belirsizleştirmeyin ve arka planda net bir şekilde göründüğünden emin olun.
• Kenarlık, arka plan rengi, gölge veya yeterli boşluk gibi kullanıcı arayüzü ipuçlarını kullanarak Google Haritalar Platformu içeriğini diğer içeriklerden her zaman görsel olarak ayırt edin.
• Görsel değişiklikler yaparken tüm Google Haritalar ilişkilendirme şartlarına uymanız gerekir.

Google Haritalar logosu ve metin atıfı

Atıf, mümkün olduğunda Google Haritalar logosu şeklinde olmalıdır. Yerin sınırlı olduğu durumlarda Google Haritalar metni kabul edilebilir. Son kullanıcılar, hangi içeriğin Google Haritalar tarafından sağlandığını her zaman net bir şekilde anlayabilmelidir.

Logo ilişkilendirmesi

Google Haritalar logolarını indirme

Resmi Google Haritalar logo dosyalarını kullanın. Aşağıdaki logoları indirin ve bu bölümdeki yönergeleri uygulayın.

Google Haritalar logosunu kullanırken aşağıdaki kurallara uyun.

• Logoyu hiçbir şekilde değiştirmeyin.
• Bozulmayı önlemek için logonun en boy oranını koruyun.
• Harita veya resim gibi yoğun bir arka planda ana hatları belirgin logoyu kullanın.
• Anahatları olmayan logoyu düz renk veya hafif geçişli bir arka plan gibi sade bir arka plan üzerinde kullanın.

Logo boyutu özelliği

• Minimum logo yüksekliği: 16 dp
• Maksimum logo yüksekliği: 19 dp
• Minimum logo boşluğu: Sol, sağ ve üstte 10 dp, altta 5 dp

DP hakkında bilgi edinmek için Materyal Tasarım web sitesindeki Piksel yoğunluğu bölümüne bakın.

Logo erişilebilirliği

• Logo ile arka plan arasında erişilebilir bir kontrast sağlayın.
• Google Haritalar metnini içeren bir erişilebilirlik etiketi ekleyin.

Metin ilişkilendirme

Arayüzünüzün boyutu Google Haritalar logosunun kullanımını desteklemiyorsa metin olarak Google Haritalar yazabilirsiniz. Bunun için aşağıdaki yönergeleri izleyin:

• Google Haritalar metnini hiçbir şekilde değiştirmeyin:
  
  • Google Haritalar'ın büyük harf kullanımını değiştirmeyin.
  • Google Haritalar'ı birden fazla satıra bölmeyin.
  • Google Haritalar'ı başka bir dile yerelleştirmeyin.
  • translate="no" HTML özelliğini kullanarak tarayıcıların Google Haritalar'ı çevirmesini engelleyin.

• Google Haritalar metnini aşağıdaki tabloda açıklandığı şekilde biçimlendirin:

  Google Haritalar metin stili koşulları
  Özellik	Stil
  Yazı tipi ailesi	Roboto. Yazı tipini yüklemek isteğe bağlıdır.
  Yedek yazı tipi ailesi	Ürününüzde halihazırda kullanılan herhangi bir sans serif gövde yazı tipi veya varsayılan sistem yazı tipini çağırmak için "Sans-Serif"
  Yazı tipi stili	Normal
  Yazı tipi kalınlığı	400
  Yazı tipi rengi	Beyaz, siyah (#1F1F1F) veya gri (#5E5E5E). Arka planla erişilebilir (4.5:1) kontrastı koruyun.
  Yazı tipi boyutu	Minimum yazı tipi boyutu: 12 sp Maksimum yazı tipi boyutu: 16 sp sp hakkında bilgi edinmek için Materyal Tasarım web sitesindeki Yazı tipi boyutu birimleri bölümüne bakın.
  Harf aralıkları	Normal

Örnek CSS

Aşağıdaki CSS, Google Haritalar'ı beyaz veya açık renkli bir arka plan üzerinde uygun tipografik stil ve renkle oluşturur.

@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap');

.GMP-attribution {
font-family: Roboto, Sans-Serif;
font-style: normal;
font-weight: 400;
font-size: 1rem;
letter-spacing: normal;
white-space: nowrap;
color: #5e5e5e;
}

Görsel şartlar

• Atıfı, içeriğin üst veya alt kısmına yakın bir yere ve aynı görsel kapsayıcıya yerleştirin. Tek satırlık içeriklerde ilişkilendirme sağa veya sola yerleştirilebilir.

• Kenarlık, arka plan rengi, gölge veya yeterli boşluk gibi kullanıcı arayüzü ipuçlarını kullanarak Google Haritalar Platformu içeriğini diğer içeriklerden görsel olarak ayırt edin.

• Google Haritalar Platformu dışındaki içeriklerle ilişkilendirerek Google Haritalar'ı yanlış tanıtmayın.
• Atıfın her zaman görünür ve okunaklı olduğundan emin olun. Bu bildirimi hiçbir zaman kaldırmayın, gizlemeyin, karartmayın veya değiştirmeyin.

Aşağıdaki resimlerde bu görsel şartlarla ilgili örnekler gösterilmektedir.

Üçüncü taraf veri sağlayıcıları

Harita ürünlerimizdeki bazı veriler ve resimler Google dışındaki sağlayıcılardan alınır. Map Tiles API gibi bazı ürünlerde, üçüncü taraf veri sağlayıcı için gerekli atıfı size sağlayabiliriz. Bu durumda, atıf metninizde "Google Haritalar" adı ve ilgili veri sağlayıcılar belirtilmelidir(ör. "Harita verileri: Google, Maxar Technologies"). Google, üçüncü taraf ilişkilendirmesi sağladığında yalnızca "Google Haritalar" veya Google logosunun eklenmesi uygun bir ilişkilendirme değildir.

Diğer ilişkilendirme koşulları

Üçüncü taraf ilişkilendirmelerini almak ve uygulamanızda göstermek için bu talimatları uygulayın.

Bir yerin atıflarını alma

Uygulamanız Place.fetchFields çağrısı yaparak elde edilen yorum bilgilerini gösteriyorsa elde edilen yer ayrıntıları için üçüncü taraf atıflarını da göstermelidir.

API, bir Place nesnesi döndürür. Place nesnesinden ilişkilendirmeleri almak için her istekle birlikte döndürülen Place.attributions özelliğini kullanın (alanlarla belirtmeniz gerekmez). Özellik, String nesnelerinden oluşan bir List veya gösterilecek ilişkilendirme yoksa null döndürür. Aşağıdaki örnek kodda, bir yerin nasıl alınacağı ve tüm atıfların nasıl listeleneceği gösterilmektedir.

  // Use place ID to create a new Place instance.
  const place = new Place({
      id: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen
  });

  // Call fetchFields, passing the desired data fields.
  await place.fetchFields({
      fields: ["displayName", "formattedAddress", "location", "reviews"],
  });

  // Check for any place attributions.
  if (!place.attributions) {
      console.log('No attributions were found.');
      return;
  } else {
      // Log the place attribution
      for (var attribution of place.attributions) {
          console.log(attribution);
      }
  }

  

Yorum gösterme

Bir Place nesnesi en fazla beş yorum içerebilir. Her yorum bir Review nesnesiyle temsil edilir. Dilerseniz bu yorumları uygulamanızda gösterebilirsiniz.

Google kullanıcılarının katkıda bulunduğu yorumları gösterirken yazarın adını yorumun hemen yanına yerleştirmeniz gerekir. Review nesnesinin yazar ilişkilendirme alanında mevcutsa yazarın fotoğrafını ve profilinin bağlantısını da eklemenizi öneririz. Aşağıdaki resimde bir parkla ilgili yorum örneği gösterilmektedir:

Aşağıdaki örnekte bir yerin nasıl alınacağı, yorumların nasıl kontrol edileceği ve ilk yorumdaki verilerin nasıl gösterileceği açıklanmaktadır:

// Create a new Place instance.
const place = new Place({
    id: 'ChIJpyiwa4Zw44kRBQSGWKv4wgA', // Faneuil Hall Marketplace, Boston, MA
});

// Call fetchFields, passing 'reviews' and other needed fields.
await place.fetchFields({
    fields: ['displayName', 'formattedAddress', 'location', 'reviews'],
});

// Create an HTML container.
const content = document.createElement('div');
const title = document.createElement('div');
const rating = document.createElement('div');
const address = document.createElement('div');
const review = document.createElement('div');
const authorLink = document.createElement('a');

// If there are any reviews display the first one.
if (place.reviews && place.reviews.length > 0) {
    // Get info for the first review.
    const reviewRating = place.reviews[0].rating;
    const reviewText = place.reviews[0].text;
    const authorName = place.reviews[0].authorAttribution.displayName;
    const authorUri = place.reviews[0].authorAttribution.uri;

    // Safely populate the HTML.
    title.textContent = place.displayName || '';
    address.textContent = place.formattedAddress || '';
    rating.textContent = `Rating: ${reviewRating} stars`;
    review.textContent = reviewText || '';
    authorLink.textContent = authorName;
    authorLink.href = authorUri || '';
    authorLink.target = '_blank';

    content.appendChild(title);
    content.appendChild(address);
    content.appendChild(rating);
    content.appendChild(review);
    content.appendChild(authorLink);
} else {
    content.textContent = `No reviews were found for ${place.displayName}.`;
}

// Create an infoWindow to display the review.
infoWindow = new InfoWindow({
    content,
    ariaLabel: place.displayName,
});
index.js

Yer yorumlarıyla ilgili belgelere bakın.

Bir fotoğrafın ilişkilendirmelerini görüntüleme

Uygulamanızda fotoğraf gösteriliyorsa her fotoğraf için yazar atıflarını göstermeniz gerekir. Bir yanıtın Place nesnesindeki fotoğrafla ilgili ayrıntılar photos dizisinde yer alır. Yanıta photos dizisini eklemek için isteğe photos veri alanını ekleyin.

Fotoğraflar dizisinin her öğesi, AuthorAttribution türünde authorAttributions dizisini içeren bir Photo örneğidir. AuthorAttribution nesnesinin alanları, ilişkilendirmenin displayName, uri ve photoUri değerlerini içeren dizelerdir. Gösterilecek ilişkilendirme yoksa boş bir dize gösterilir.

Yer fotoğraflarıyla ilgili belgelere bakın.

Arama sonuçları ilişkilendirmeleri

Avrupa'da, Google'ın değiştirilmemiş sıralaması kullanılırken arama ürünlerinde, arama sonuçları sıralamasını belirleyen ana faktörleri ve ana faktörlerin ağırlığını açıklayan bir açıklama metni bulunmalıdır. Bu metne en fazla 1 tıklamayla erişilebilmelidir. Açıklama metni:

Başlık: Bu sonuçlar hakkında

Gövde: Bir konumun yakınındaki işletmeleri veya yerleri aradığınızda Google Haritalar'da yerel sonuçlar gösterilir. Aramanızla ilgili en iyi sonuçları elde etmenize yardımcı olmak için öncelikli olarak alaka düzeyi, mesafe ve belirginlik gibi çeşitli faktörler birleştirilir.

1. düğme: Daha fazla bilgi
"Daha fazla bilgi" metni bir Yardım Merkezi makalesine bağlanmalıdır.

Button 2: OK

Son kullanıcı adresleri için otomatik tamamlama

Bir son kullanıcı, Müşteri Uygulamanızdaki Otomatik Tamamlama işlevini kullanarak bir açık adresi yazmaya başladığında ve bu açık adres, Otomatik Tamamlama olmadan da son kullanıcı tarafından eksiksiz ve doğru bir şekilde girilebilecek olduğunda, son kullanıcının seçtiği adres Google Haritalar Platformu Sözleşmenizdeki Google Haritalar İçerik kısıtlamalarına tabi olmaz. Bu istisna yalnızca son kullanıcı tarafından seçilen açık adres için ve yalnızca söz konusu son kullanıcının belirli işlemi için geçerlidir. Otomatik Tamamlama işlevi tarafından sağlanan önerilen adresler listesi veya diğer Google Haritalar İçerikleri için geçerli değildir. Bu istisna, diğer Google Haritalar Platformu hizmetleri tarafından sunulan ÖY veya adres arama işlevleri için geçerli değildir.

Önceki resimde, soldaki adres listesi hâlâ Google Haritalar İçeriği ile ilgili kısıtlamalara tabidir. Son kullanıcı seçtiği adresi belirledikten sonra bu adres, yalnızca söz konusu son kullanıcının geçerli işlemi için Google Haritalar İçeriği ile ilgili kısıtlamalara tabi olmaz.

Yapay zeka destekli özetler

Uygulamanızda yer, bölge ve yorum özetleri de dahil olmak üzere yapay zeka destekli özetler gösterdiğinizde aşağıdakileri yapmanız gerekir:

• Gerekli ilişkilendirmeleri, raporlama bağlantılarını ve yönlendiren bağlantıları aşağıda tanımlandığı şekilde gösterin.
• Son kullanıcılar, Google Haritalar tarafından sağlanan özet metnin tamamını okuyabilmelidir.

Yapay zeka destekli özetler açıklama metnini göster

Yapay zeka destekli bir özet gösterirken her zaman özetin hemen altına yerelleştirilmiş açıklama metnini (yanıt gövdesinin disclosureText alanında sağlanır) ekleyin. API tarafından sağlanan açıklama metnini hiçbir zaman değiştirmeyin veya genişletmeyin.

Yer ve alan özetiyle ilgili ek şartlar

Uygulamanızda gösterilen yer ve bölge özetlerine aşağıdaki metin ve gerekli bağlantılar eşlik etmelidir:

Yorum özeti koşulları

Uygulamanızda gösterilen yorum özetleri, "Yorum özeti" metnini içeren bir başlıkla birlikte sunulmalıdır. Ayrıca, aşağıdaki metni ve gerekli bağlantıları kullanmanız gerekir:

Otomotiv kullanım alanları için rehberlik gösterme

Google, sürücü güvenliği için otomotiv deneyimlerinde yapay zeka destekli özetlerin park modunda oluşturulmasını önerir. Sürüş modunda özetler gösteriliyorsa sürücünün dikkatini hızlıca yola vermesini sağlamak için ekrandaki bilgiler basit, net ve kısa olmalıdır:

• En fazla 3 satır
• En fazla 120 karakter veya 24 kelime
• Minimum yazı tipi boyutu 24 dp olmalıdır.

Özellikle otomotiv bağlamlarında, yapay zeka destekli özetleri güvenli ve tüm yerel yasa ve yönetmeliklere uygun şekilde oluşturmak geliştiricinin sorumluluğundadır.