Places API ile ilgili politikalar ve ilişkilendirmeler

Bu belgede, Places API (Yeni) ile geliştirilen tüm uygulamalara özgü şartlar listelenmektedir. Bu API'nin bir parçası olan Otomatik Tamamlama (Yeni) hizmeti de bu şartlara dahildir. Google Haritalar geliştiricileri için daha genel bilgilere Google Haritalar Platformu Hizmet Şartları'ndan ulaşabilirsiniz.

Politikalar

Bu bölümde, Places API ile ilgili politikalar açıklanmaktadır. Politikalar, Hizmet'i doğru şekilde ve Google Haritalar Platformu'nun beklentileri doğrultusunda kullanmanıza yardımcı olmak için 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 kimliklerini nasıl kaydedeceğinizi, yenileyeceğinizi ve yöneteceğinizi Yer Kimlikleri Kılavuzu'ndan öğrenebilirsiniz.

Avrupa Ekonomik Alanı ülkeleri ve idari bölgeleri

Bu ürünün, Avrupa Ekonomik Alanı'nda (AEA) fatura adresi olan müşteriler için farklı Hizmet Şartları vardır ve farklı işlevler de sunabilir. Google Haritalar Platformu ile geliştirmeye başlamadan önce aşağıdaki AEA'ya özel ş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 Hizmete Özel Şartları

Google Haritalar ilişkilendirme koşulları

Bu bölümde, uygulamalarınız aracılığıyla Google Haritalar ve İçerik'in gösterilmesiyle ilgili ilişkilendirme şartları ve yönergeleri verilmektedir.

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

Uygulamanızda veya web sitenizde Google Haritalar Platformu API'lerinden İçerik gösterirken Google Haritalar ilişkilendirme şartları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 (ör. Places UI Kit'te) Google Haritalar Platformu tarafından sağlanan Google Haritalar ilişkilendirmesi için:

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

Google Haritalar logosu ve metin atfı

Mümkün olduğunda Google Haritalar logosu kullanılmalıdır. Alan sınırlı olduğunda 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 logosu 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 yönergelere 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 hatlı logoyu kullanın.
• Düz renkli veya hafif gradyan gibi sade bir arka planda ana hatları olmayan logoyu 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 başlıklı makaleyi inceleyin.

Logo erişilebilirliği

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

Metin ilişkilendirmesi

Arayüzünüzün boyutu Google Haritalar logosunun kullanılmasını desteklemiyorsa metinde 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/küçük harf kullanımını değiştirmeyin.
  • Google Haritalar'ı birden fazla satıra sarmayın.
  • 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 stilize edin:

  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 zaten 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 Material Design web sitesindeki Yazı tipi boyutu birimleri başlıklı makaleyi inceleyin.
  Harf aralıkları	Normal

Örnek CSS

Aşağıdaki CSS, Google Haritalar'ı beyaz veya açık renkli bir arka planda 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ı

• Konum ilişkilendirmesini içeriğin üst veya alt kısmına yakın ve aynı görsel kapsayıcı içinde yerleştirin. Tek bir içerik satırında, ilişkilendirme sağa veya sola yerleştirilebilir.

• Google Haritalar Platformu İçeriği'ni kenarlık, arka plan rengi, gölge veya yeterli boşluk gibi kullanıcı arayüzü işaretlerini kullanarak diğer içeriklerden görsel olarak ayırt edin.

• Google Haritalar'ı, Google Haritalar Platformu dışındaki içeriklerle ilişkilendirerek yanlış tanıtmayın.
• İlişkilendirmenin her zaman görünür ve okunabilir olduğunu doğrulayın. Asla kaldırmayın, gizlemeyin, karartmayın veya değiştirmeyin.

Aşağıdaki resimlerde bu görsel koşullara ilişkin ö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. Harita Döşemeleri API'si gibi bazı ürünler için üçüncü taraf veri sağlayıcıya gerekli atıfı sağlayabiliriz. Bu durumda, ilişkilendirmenizin metninde "Google Haritalar" adı ve ilgili veri sağlayıcılar(ör. "Harita verileri: Google, Maxar Technologies") yer almalıdır. Google üçüncü taraf ilişkilendirmesi sağladığında yalnızca "Google Haritalar" veya Google logosunu eklemek uygun ilişkilendirme değildir.

Diğer ilişkilendirme koşulları

Aşağıdaki ilişkilendirme koşulları, Places API'ye özgüdür.

Son kullanıcı adresleri için otomatik tamamlama

Bir son kullanıcı, Müşteri Uygulamanızda Otomatik Tamamlama işlevini kullanarak bir sokak adresi yazdığında ve bu sokak adresi, Otomatik Tamamlama olmadan son kullanıcı tarafından tamamen ve doğru bir şekilde sağlanmış olsaydı, son kullanıcının seçtiği adres, Google Haritalar Platformu Sözleşmenizdeki Google Haritalar İçeriği kısıtlamalarına tabi olmazdı. Bu istisna yalnızca son kullanıcı tarafından seçilen cadde adresi 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 herhangi bir ÖY veya adres arama işlevi 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 amacıyla Google Haritalar İçerikleri ile ilgili kısıtlamalara tabi olmaz.

Üçüncü taraf ilişkilendirmeleri

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

Bir yerden ilişkilendirmeleri alma

Uygulamanız, bir yer kimliğiyle Yer Ayrıntıları çağrılarak elde edilen bilgileri gösteriyorsa elde edilen yer ayrıntıları için üçüncü taraf ilişkilendirmelerini de göstermelidir.

Bir yanıttaki Place nesnesindeki ilişkilendirmeler, Attribution nesnesiyle gösterilir. Yanıtı Attribution ile eklemek için isteğin alan maskesine places.attributions (Yakınlarda Arama ve Metin Arama) veya attributions (Yer Ayrıntıları) ekleyin.

Attribution nesnesinin alanları, ilişkilendirme provider ve providerUri değerlerini içeren dizelerdir. Gösterilecek ilişkilendirme yoksa boş bir dize olur.

Fotoğraflar için atıfları görüntüleme

Uygulamanızda fotoğraf gösteriliyorsa her bir fotoğrafta varsa yazar atıflarını göstermeniz gerekir.

Yanıttaki Place nesnesinde yer alan fotoğraf hakkındaki ayrıntılar photos dizisinde bulunur. Yanıtı photos dizisi eklemek için isteğin alan maskesine places.photos (Yakınlardaki Arama ve Metin Arama) veya photos (Yer Ayrıntıları) ekleyin.

photos dizisinin her öğesi, Photo örneğidir. Bu örnek, AuthorAttribution türünde authorAttributions dizisini içerir.

AuthorAttribution nesnesinin alanları, ilişkilendirmenin displayName, uri ve photoUri değerlerini içeren dizelerdir veya gösterilecek ilişkilendirme yoksa boş bir dizedir.

Yorum görüntüleme

Bir yanıttaki Place nesnesi en fazla beş yorum içerebilir. İsteğe bağlı olarak bu yorumları uygulamanızda gösterebilirsiniz.

Google kullanıcıları tarafından gönderilen yorumları gösterirken yazarın adını yakınına yerleştirmeniz gerekir. Review nesnesinin yazar ilişkilendirme alanında mevcutsa yazarın fotoğrafını eklemenizi ve profilinin bağlantısını da paylaşmanızı öneririz. Aşağıdaki resimde bir parkla ilgili yorum örneği gösterilmektedir:

Google, yorumların nasıl sıralandığını son kullanıcıya göstermenizi de önerir.

Bir yanıtın Place nesnesindeki her yorum, Review nesnesiyle temsil edilir. Yanıtı Review nesnesiyle birlikte almak için isteğin alan maskesine places.reviews (Yakınlarda Arama ve Metin Arama) veya reviews (Yer Ayrıntıları) ekleyin.

Review nesnesinin alanları ilişkilendirmeyi içerir veya gösterilecek ilişkilendirme yoksa boştur.

Arama sonucu ilişkilendirmeleri

Avrupa'da Google'ın değiştirilmemiş sıralaması kullanılırken arama ürünlerinde, arama sonuçlarının sıralamasını belirleyen ana faktörleri ve ana faktörlerin ağırlığını açıklayan, en fazla 1 tıklama uzaklığında açıklayıcı metin bulunmalıdır. Açıklayıcı metin:

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: Tamam

Yapay zeka destekli özetler

Uygulamanızda yapay zeka destekli özetler (ör. yer, alan ve yorum özetleri) gösterdiğinizde aşağıdakileri yapmanız gerekir:

• Aşağıda tanımlandığı şekilde gerekli ilişkilendirmeleri, raporlama bağlantılarını ve referans bağlantılarını 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

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

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 özetlerine "Yorum özeti" metnini içeren bir başlık eşlik etmelidir. Ayrıca, aşağıdaki metni ve gerekli bağlantıları kullanmanız gerekir:

Otomotiv kullanım alanlarıyla ilgili rehberlik

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 oluşturuluyorsa 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 ön boyut 24 dp olmalıdır.

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