Android için Yerler SDK'sına Yönelik Politikalar

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

Kullanım şartlarını ve gizlilik politikasını sağlama

Android için Yerler SDK'sı geliştirirseniz uygulamanızla birlikte Google ile Sözleşmenizde belirtilen kurallara uygun olan Kullanım Şartları'nı ve Gizlilik Politikası'nı kullanıma sunmanız gerekir:

  • Kullanım Şartları ve Gizlilik Politikası herkese açık olmalıdır.
  • Uygulamanızın Kullanım Şartları'nda, uygulamanızı kullanan kullanıcıların Google’ın Hizmet Şartları'na tabi olduğunu açıkça belirtmelisiniz.
  • Gizlilik Politikanızda kullanıcılara Google Haritalar API'lerini kullandığınızı bildirmeniz ve Google Gizlilik Politikası'nı referans olarak eklemeniz gerekir.

Kullanım Şartları ve Gizlilik Politikanız'ı kullanmanız için önerilen yer, uygulamanızın platformuna bağlıdır.

Mobil uygulamalar

Mobil uygulama geliştiriyorsanız uygulamanızın ilgili uygulama mağazasındaki indirme sayfasında ve uygulama ayarları menüsünde Kullanım Şartları ve Gizlilik Politikası'nın bağlantısını sağlamanız önerilir.

Web uygulamaları

Web uygulaması geliştiriyorsanız web sitenizin altbilgi bölümüne Kullanım Şartları ve Gizlilik Politikası'nın bağlantısını sağlamanız önerilir.

İçeriği önceden getirme, önbelleğe alma veya depolama

Android için Yerler SDK'sını kullanan uygulamalar, Google ile aranızdaki Sözleşme'nin şartlarına tabidir. Sözleşmenizin şartlarına tabi olarak, şartlarda belirtilen sınırlı koşullar hariç hiçbir İçeriği önceden getirmemeli, dizine eklememeli, depolamamalı veya önbelleğe almamalısınız.

Bir yeri benzersiz şekilde tanımlamak için kullanılan yer kimliğinin, önbelleğe alma kısıtlamalarından muaf tutulduğunu unutmayın. Yer kimliği, Android yanıtları için Yerler SDK'sındaki "place_id" alanında döndürülür. Yer kimliklerinin nasıl kaydedileceğini, yenileneceğini ve yönetileceğini Yer Kimlikleri kılavuzundan öğrenebilirsiniz.

Android sonuçları için Yerler SDK'sını görüntüleme

Android için Yerler SDK'sını bir Google Haritasında veya harita olmadan görüntüleyebilirsiniz. Android için Yerler SDK'sı sonuçlarını bir haritada görüntülemek isterseniz bu sonuçlar bir Google Haritası'nda gösterilmelidir. Google haritası olmayan bir haritada Android verileri için Yerler SDK'sının kullanılması yasaktır.

Uygulamanız bir Google Haritası üzerinde veri görüntülüyorsa, Google logosu buna dahil edilir ve değiştirilemez. Google verilerini bir Google Haritasıyla aynı ekranda görüntüleyen uygulamaların, Google'a başka bir atıf sağlaması gerekmez.

Uygulamanız, aynı zamanda Google Haritası görüntülemeyen bir sayfa veya görünümde veri görüntülüyorsa bu verilerle birlikte bir Google logosu göstermeniz gerekir. Örneğin, uygulamanız bir sekmede Google verilerini, başka bir sekmede ise bu verileri içeren bir Google Haritası görüntülüyorsa ilk sekmede Google logosu gösterilmelidir. Uygulamanız, otomatik tamamlama ile veya otomatik tamamlama olmadan arama alanları kullanıyorsa logo satır içinde gösterilmelidir.

Google logosu, haritanın sol alt köşesine, atıf bilgileri sağ alt köşeye yerleştirilmeli ve her ikisi de haritada bir bütün olarak sunulmalı ve haritanın veya uygulama içindeki başka bir yerin altında sunulmamalıdır. Aşağıdaki harita örneğinde, haritanın sol alt tarafındaki Google logosu ve sağ alt kısımdaki atıf gösterilmektedir.

politika ilişkilendirme yerleşimi

Aşağıdaki zip dosyası, Google logosunu masaüstü, Android ve iOS uygulamaları için doğru boyutlarda içermektedir. Bu logoları hiçbir şekilde yeniden boyutlandıramaz veya değiştiremezsiniz.

İndir: google_logo.zip

İlişkilendirmeyi değiştirmeyin. İlişkilendirme bilgilerini kaldırmayın, üzerini kapatmayın veya kırpmayın. Google logolarını satır içinde kullanamazsınız (örneğin, "Bu haritalar [Google_logo] logosuna aittir).

İlişkilendirmeyi yakın tutun. Doğrudan yerleştirmelerin dışında Google görüntülerinin ekran görüntülerini kullanıyorsanız standart atfı resimde göründüğü gibi ekleyin. Gerekirse metnin içeriğe yakın olması ve ortalama görüntüleyen ya da okuyucu tarafından okunabilmesi koşuluyla, atıf metninin stilini ve yerleşimini özelleştirebilirsiniz. Atıfları içerikten uzağa (örneğin, kitabınızın sonuna, dosyalarınızın veya programınızın jeneriklerine ya da web sitenizin alt bilgisine) taşıyamazsınız.

Üçüncü taraf veri sağlayıcıları dahil edin. Harita ürünlerimizdeki bazı veri ve resimler Google dışındaki sağlayıcılardan gelir. Bu tür görüntüler kullanıyorsanız ilişkilendirmenizin metninde "Google" adı ve ilgili veri sağlayıcıları belirtilmelidir(ör. "Harita verileri: Google, Maxar Technologies"). Görüntülerle birlikte atıfta bulunulan üçüncü taraf veri sağlayıcıları olduğunda, yalnızca "Google"ın veya Google logosunun eklenmesi uygun bir atıf değildir.

İlişkilendirme görünümünün pratik olmadığı bir cihazda Google Haritalar Platformu'nu kullanıyorsanız kullanım alanınıza uygun lisansları görüşmek için lütfen Google satış ekibiyle iletişime geçin.

Diğer ilişkilendirme gereksinimleri

Üçüncü taraf ilişkilendirmelerini almak ve ilişkilendirmeleri uygulamanızda görüntülemek için bu talimatları izleyin.

Bir Yerden atıflar alma

Uygulamanız, Kimliğe göre yer alma çağrısıyla elde edilen bilgileri görüntülüyorsa, elde edilen yer ayrıntılarına ilişkin üçüncü taraf ilişkilendirmelerini de göstermelidir.

API bir Place nesnesi döndürür. Place nesnesinden ilişkilendirmeleri almak için Place.getAttributions() çağrısı yapın. Yöntem, String nesneden List tanesini veya görüntülenecek bir 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.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 için atıfları gösterme

Uygulamanızda fotoğraf görüntüleniyorsa, bu fotoğrafları içeren her fotoğraf için atıfları göstermeniz gerekir. PhotoMetadata iki ilişkilendirme türünden birini içerebilir:

Bir fotoğrafın dize ilişkilendirmelerini almak için PhotoMetadata.getAttributions() çağrısı yapın. Yöntem, bir HTML karakter dizisi veya görüntülenecek bir atıf 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 ilişkilendirmelerini almak için PhotoMetadata.getAuthorAttributions() numaralı telefonu arayın. Yöntem, bir AuthorAttributions nesnesi döndürür. Bu nesne, her yazar ilişkilendirmesi için bir tane olacak şekilde, List AuthorAttribution nesne 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();

Yorum görüntüleyin

Bir Place nesnesi en fazla beş yorum içerebilir. Her yorum, bir Review nesnesiyle temsil edilir. İsterseniz bu yorumları uygulamanızda görüntüleyebilirsiniz.

Google kullanıcılarının katkıda bulunduğu yorumları gösterirken, yazarın adını yakın bir şekilde yerleştirmelisiniz. Review nesnesinin yazar atıf alanında mevcut olduğunda, yazarın fotoğrafını ve profilinin bağlantısını da eklemenizi öneririz. Aşağıdaki resimde, bir park incelemesi örneği gösterilmektedir:

Yazar atfı ekranı

Google, yorumların sıralanma biçimini son kullanıcıya göstermenizi de önerir.

Yorumlara erişmek için Place.getReviews() numaralı telefonu arayı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ılarla yapılan atıflar, HTML biçiminde içerik ve bağlantılar içerir. Bu içerikleri, sağladıkları biçimde saklamanız ve kullanıcıya göstermeniz gerekir. Google, bu bilgileri yer ayrıntılarının altında görüntülemenizi önerir.

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

İlişkilendirmeleri görüntülemenin bir yolu da 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>

Google ilişkilendirmesi için stil yönergeleri

İndirilebilir Google logosunu kullanamıyorsanız CSS ve HTML'de Google ilişkilendirmeleri için stil kurallarını aşağıda bulabilirsiniz.

Boş alan

Tam logonun çevresindeki boş alan, Google'daki "G" harfinin yüksekliğine eşit veya bu yükseklikten büyük olmalıdır.

İlişkilendirme metni ile Google logosu arasındaki alan, "G" harfinin genişliğinin yarısı kadar olmalıdır.

Okunabilirlik

İmza satırı her zaman net ve okunabilir olmalı, belirli bir arka plan için doğru renk varyasyonunda görünmelidir. Seçtiğiniz logo varyasyonu için daima yeterli kontrast sağladığınızdan emin olun.

Renk

En fazla %0-%40 arasında siyah tonu kullanan beyaz veya açık renkli bir arka plan üzerinde Google Material Gray 700 metin kullanın.

Google
#5F6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

Koyu arka planlarda ve fotoğraf veya meşgul olmayan desenlerin üzerinde künyeye ekleme ve ilişkilendirme için beyaz metin kullanın.

Google
#FFFFFF
RGB 255 255 255
HSL 0 0 100
HSB 0 0 100

Yazı tipi

Roboto yazı tipini kullanın.

Örnek CSS

Aşağıdaki CSS "Google" metnine uygulandığında, "Google" kelimesini uygun yazı tipi, renk ve boşlukla beyaz veya açık arka planla görüntüler.

font-family: Roboto;
font-style: normal;
font-weight: 500;
font-size: 16px;
line-height: 16px;
padding: 16px;
letter-spacing: 0.0575em; /* 0.69px */
color: #5F6368;