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

Bu belgede, iOS için Yerler SDK'sı ile geliştirilen tüm uygulamalara özgü şartlar listelenmiştir. Bu API'nin bir parçası olan Yer Adı Otomatik Tamamlama hizmeti de buna dahildir. Google Haritalar geliştiricileri için daha genel bilgileri Google Haritalar Platformu Hizmet Şartları'nda bulabilirsiniz.

Politikalar

Bu bölümde, iOS 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:

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

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.

Places UI Kit Google dışı bir haritada ilişkilendirme örneği
Yer Ayrıntıları kompakt bileşenine uygulanan zorunlu atıf. Google'a ait olmayan bu haritada, Google Haritalar ilişkilendirmesi açıkça görünür ve Google Haritalar Platformu içeriği, diğer içeriklerden görsel olarak ayırt edilir.

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.

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.

Sol: Google Haritalar logo atıfı, Sağ: Google Haritalar metin atıfı
Sol: Google Haritalar logo atıf örneği, Sağ: Google Haritalar metin atıf örneği

Logo ilişkilendirmesi

Uygulamanızda veya web sitenizde Google Haritalar logosunu kullanmak için bu şartlara uyun.
Google Haritalar logosu ilişkilendirmesi için kabul edilebilir varyasyonlar
Google Haritalar logosu atfı için kabul edilebilir varyasyon örnekleri

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 ilişkilendirme öğelerini indirme

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

Google Haritalar logosu için aşağıdaki boyut özelliklerine uyun:
  • 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.

Minimum boşluk ve kabul edilebilir boyut aralığını gösteren Google Haritalar logosu
Minimum boşluk ve kabul edilebilir boyut aralığını gösteren Google Haritalar logosu örneği

Logo erişilebilirliği

Google Haritalar logosu için aşağıdaki erişilebilirlik koşullarına uyun:
  • Logo ile arka plan arasında erişilebilir bir kontrast sağlayın.
  • Google Haritalar metnini içeren bir erişilebilirlik etiketi ekleyin.
Google Haritalar logosu ilişkilendirmesi için kabul edilemez varyasyonlar ve erişilebilirlik sorunları
Google Haritalar logosu ilişkilendirmesi için kabul edilemez varyasyon ve erişilebilirlik sorunlarına örnekler

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 metin atfının kabul edilebilir varyasyonları
Google Haritalar metin atfının kabul edilebilir varyasyonlarına örnekler
  • 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 metin atıfının kabul edilemez varyasyonları
Google Haritalar metin atfının kabul edilemez varyasyonlarına örnekler

  • 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

Google Haritalar atıfının görsel olarak gösterilmesi için aşağıdaki şartlara uyun.

  • 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.

İçeriğin üstünde, altında ve yanında konumlandırılmış Google Haritalar atıf örneği
İçeriğin üstünde, altında ve yanında konumlandırılmış Google Haritalar atıf örneği

Google Haritalar İçeriği'ni (yer puanı) diğer içeriklerden ayırmak için kullanılan iki yaklaşımın örneği
Google Haritalar İçeriği'ni (yer puanı) diğer içeriklerden ayırmaya yönelik iki yaklaşım örneği

Google Haritalar atıfını gizlemeyin veya başka kaynaklardan gelen içeriklerle karıştırmayın.
Google Haritalar atıfını gizlemeyin veya diğer kaynaklardan gelen içeriklerle karıştırmayın

Üçü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 sağlayıcılara yapılan atıflar, kullanıcıya sağlandıkları biçimde göstermeniz gereken içerik ve bağlantılar içerir. Google, uygulamanızın bu bilgileri yer ayrıntılarının altında göstermesini önerir.

API tarafından döndürülen üçüncü taraf atıfları, Google atıflarını içermez. Google logosunu ve atıfları gösterme bölümünde açıklandığı şekilde bu atıfı kendiniz eklemeniz gerekir.

Tek bir yer veya bir yer koleksiyonu için üçüncü taraf atıflarını almak üzere bu talimatları uygulayın.

Tek bir yer için atıfları alma

Kimliğe göre yer alma yöntemiyle bir yer aldığınızda, GMSPlace üzerindeki attributions özelliğinden o yerin atıflarını alabilirsiniz.

attributions, NSAttributedString nesnesi olarak sağlanır.

Bir yer koleksiyonu için atıfları alma

Uygulamanız, cihazın mevcut yerini isteyerek elde edilen bilgileri gösteriyorsa gösterilen yer ayrıntıları için üçüncü taraf ilişkilendirmelerini göstermelidir. İstekte alınan tüm yerlerin atıflarını GMSPlaceLikelihoodList üzerindeki attributions özelliğinden alabilirsiniz.

attributions, NSAttributedString nesnesi olarak sağlanır. Bu nesneye, yukarıda açıklandığı gibi tek bir yerdeki attributions ile aynı şekilde erişebilir ve görüntüleyebilirsiniz.

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

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

Uygulamanız fotoğraf gösteriyorsa her fotoğraf için attributions ve authorAttributions bilgilerini göstermeniz gerekir.

Swift

GMSPlacesClient.sharedClient().lookUpPhotosForPlaceID(placeID) { (photos, error) -> Void in
  if let error = error {
    // TODO: handle the error.
    print("Error: \(error.description)")
  } else {
    // Get attribution for the first photo in the list.
    if let photo = photos?.results.first {
      let attributions = photo.attributions
    }
  }
}

Objective-C

[[GMSPlacesClient sharedClient]
    lookUpPhotosForPlaceID:placeID
      callback:^(GMSPlacePhotoMetadataList *_Nullable photos,
                  NSError *_Nullable error) {
        if (error) {
          // TODO: handle the error.
          NSLog(@"Error: %@", [error description]);
        } else {
          // Get attribution for the first photo in the list.
          if (photos.results.count > 0) {
            GMSPlacePhotoMetadata *photo = photos.results.firstObject;
            NSAttributedString *attributions = photo.attributions;
          }
        }
      }];

Yorum gösterme

Bir GMSPlace nesnesi en fazla beş yorum içerebilir. Her yorum bir GMSPlaceReview nesnesiyle temsil edilir. İsterseniz 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. GMSPlaceReview 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:

Yazar ilişkilendirme gösterimi

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

Yorumlara erişmek için:

Swift

// Define a Place ID.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"

// Specify the place data types to return.
let myProperties: [GMSPlaceProperty] = [.name, .website, .reviews]

// Create the GMSFetchPlaceRequest object.
let fetchPlaceRequest = GMSFetchPlaceRequest(placeID: placeID, placeProperties: myProperties)

client.fetchPlaceWithRequest(fetchPlaceRequest: fetchPlaceRequest, callback: {
  (place: GMSPlace?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }
  if let place = place {
    let firstReview: GMSPlaceReview = place.reviews![0]

    // Use firstReview to access review text, authorAttribution, and other fields.

  }
})

Objective-C

// Define a Place ID.
NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

// Specify the place data types to return, including reviews.
NSArray<GMSPlaceProperty *> *myProperties = @[GMSPlacePropertyName, GMSPlacePropertyWebsite,GMSPlacePropertyReviews];

GMSFetchPlaceRequest *fetchPlaceRequest = [[GMSFetchPlaceRequest alloc] initWithPlaceID:placeID placeProperties: myProperties];

[placesClient fetchPlaceWithRequest: fetchPlaceRequest, callback: ^(GMSPlace *_Nullable place, NSError *_Nullable error) {
  if (error) {
    // TODO: handle the error.
    NSLog(@"Error: %@", [error description]);
  } else {
    // Get first review.
    GMSPlaceReview *firstReview = [place reviews][0];

    // Use firstReview to access review text, authorAttribution, and other fields.

  }
}];

Üçüncü taraf ilişkilendirmelerini gösterme

Üçüncü taraf sağlayıcılara yapılan atıflar, korumanız ve kullanıcıya göstermeniz gereken içerik ve bağlantıları içeren NSAttributedString nesneleri olarak sağlanır.

İlişkilendirmeleri göstermenin önerilen yolu UITextView kullanmaktır. Çünkü ilişkilendirmelerdeki bağlantıların çalışması gerekir. Bağlantıların çalışması için UITextView üzerinde bir temsilci ayarlayın ve UITextViewDelegate öğenizin shouldInteractWithURL yöntemini YES değerini döndürecek şekilde ayarlayın.

Swift

...
  self.attributionTextView.delegate = self
...

// MARK: - UITextViewDelegate

func textView(textView: UITextView, shouldInteractWithURL URL: NSURL,
  inRange characterRange: NSRange) -> Bool {
  // Make links clickable.
  return true
}

Objective-C

...
  self.attributionTextView.delegate = self;
...

#pragma mark - UITextViewDelegate

- (BOOL)textView:(UITextView *)textView
    shouldInteractWithURL:(NSURL *)url
                  inRange:(NSRange)characterRange {
  // Make links clickable.
  return YES;
}

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

Üçüncü taraf ilişkilendirmesi genellikle bağlantı içeren bir metinden oluşur. Örneğin:

Örnek Şirket tarafından yayınlanan ilanlar

Yukarıdaki örnekte, Örnek Şirket metin aralığı bir NSLink özelliğiyle kapsanmaktadır.

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.

Son kullanıcı adresini otomatik tamamlama

Ö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.