Android için Yerler SDK'sı ile ilgili politikalar ve ilişkilendirmeler

Bu konuda, Android için Yerler SDK'sı ile geliştirilen tüm uygulamalar (bu API'nin bir parçası olan Yer Adı Otomatik Tamamlama hizmeti dahil) için ilişkilendirme koşulları açıklanmaktadır. Diğer Google Haritalar Platformu şartları için Google Haritalar Platformu Hizmet Şartları'na bakın.

Politikalar

Bu bölümde, Android için Yerler SDK'sı 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.

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 yerden atıfları alma

Uygulamanız kimliğe göre yer getir çağrısı yaparak elde edilen bilgileri 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 Place.getAttributions() işlevini çağırın. Yöntem, String nesnelerinden oluşan bir List döndürür veya gösterilecek ilişkilendirme yoksa null döndürür.

String placeId = "INSERT_PLACE_ID_HERE";
List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.DISPLAY_NAME);
FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

placesClient.fetchPlace(request).addOnSuccessListener((response) -> {
  Place place = response.getPlace();
  textView.append("Place found: " + place.getName());
  List<String> attributions = place.getAttributions();
  if (attributions != null) {
    StringBuilder stringBuilder = new StringBuilder("Attributions: ");
    for (String attribution : attributions) {
      stringBuilder.append(attribution).append("\n");
    }
    textView.append(stringBuilder.toString());
  }}).addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
      // Handle the error.
    }
  }
);

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

Uygulamanızda yer fotoğrafları gösteriliyorsa atıf içeren her fotoğraf için atıfları göstermeniz gerekir. PhotoMetadata, iki tür ilişkilendirmeden birini içerebilir:

• Attributions, PhotoMetadata.getAttributions() tarafından erişilen bir ilişkilendirme dizesi.
• AuthorAttributions, PhotoMetadata.getAuthorAttributions() tarafından erişilen bir AuthorAttributions nesnesidir.

Bir fotoğrafın dize ilişkilendirmelerini almak için PhotoMetadata.getAttributions() işlevini çağırın. Yöntem, bir HTML karakter dizisi veya gösterilecek ilişkilendirme yoksa boş bir dize döndürür.

// Get the photo metadata from the Place object.
PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0);

// Get the attribution text.
String attributions = photoMetadata.getAttributions();

Bir fotoğrafın yazar atıflarını almak için PhotoMetadata.getAuthorAttributions() yöntemini çağırın. Yöntem bir AuthorAttributions nesnesi döndürür. Bu nesne, her yazar ilişkilendirmesi için bir tane olmak üzere AuthorAttribution nesnelerinden oluşan bir List içerir.

// Get the photo metadata from the Place object.
PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0);

// Get the author attributions object.
AuthorAttributions authorAttributions = photoMetadata.getAuthorAttributions();
List<AuthorAttribution> authorAttributionList = authorAttributions.asList();

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

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 yakını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:

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

Yorumlara erişmek için Place.getReviews() yöntemini çağırın:

// Specify the fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.REVIEWS);

// Construct a request object, passing the place ID and fields array.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance("INSERT_PLACE_ID_HERE", placeFields);

placesClient.fetchPlace(request).addOnSuccessListener((response) -> {
    Place place = response.getPlace();
    List<Review> reviews = place.getReviews();
    // For loop for iterating over the List
    for (int i = 0; i < reviews.size(); i++) {
      // For each review, get the Review object.
        Review placeReview = reviews.get(i);

      // Get any attribution and author attribution.
        String reviewAttribution = placeReview.getAttribution();
        AuthorAttribution authorAttribution = placeReview.getAuthorAttribution();

        // Display the review contents and attributions as necessary.
    }
}).addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
        // Handle the error.
    }
});

Üçüncü taraf ilişkilendirmelerini görüntüleme

Üçüncü taraf sağlayıcılara yapılan atıflar, HTML biçiminde içerik ve bağlantılar içerir. Bunları korumanız ve kullanıcıya sağlandıkları biçimde göstermeniz gerekir. Google, bu bilgilerin yer ayrıntılarının altında gösterilmesini önerir.

API, uygulama tarafından kullanılan tüm yerler için atıf oluşturur. Atıflar yer başına değil, API çağrısı başına sağlanır.

İlişkilendirmeleri göstermenin bir yolu, TextView kullanmaktır. Örneğin:

TextView attributionsText = (TextView) findViewById(R.id.attributions);
String thirdPartyAttributions = place.getAttributions();
attributionsText.setText(thirdPartyAttributions);

Üçüncü taraf ilişkilendirme örneği

Listings by <a href="https://www.example.com/">Example Company</a>

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.