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

Bu belgede, API'nin bir parçası olan Yer Otomatik Tamamlama hizmeti de dahil olmak üzere iOS için Places SDK'sı ile geliştirilen tüm uygulamalara özgü şartlar listelenmiştir. Google Haritalar geliştiricileri için daha genel bilgilere Google Haritalar Platformu Hizmet Şartları'nda ulaşabilirsiniz.

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

iOS için Yerler SDK'sı uygulaması geliştirirseniz uygulamanızla birlikte, Google ile sözleşmenizde belirtilen yönergelere uygun bir Kullanım Şartları ve Gizlilik Politikası sunmanız gerekir:

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

Kullanım Şartlarınızı ve Gizlilik Politikanızı kullanıma sunabileceğiniz ö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ında Kullanım Şartları ile Gizlilik Politikası bağlantılarını sağlamanız önerilir.

Web uygulamaları

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

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

iOS için Yerler SDK'sını kullanan uygulamalar, Google ile sözleşmenizin şartlarına tabidir. Sözleşmenizin şartlarına tabi olarak, şartlarda belirtilen sınırlı koşullar dışında hiçbir İçeriği önceden getirmemeli, dizine eklememeli, saklamamalı 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 olduğunu unutmayın. Bu nedenle, yer kimliği değerlerini süresiz olarak saklayabilirsiniz. Konum kimliği, API yanıtlarında place_id alanında döndürülür. Yer kimlikleri kılavuzundan yer kimliklerini nasıl kaydedeceğinizi, yenileyeceğinizi ve yöneteceğinizi öğrenin.

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

iOS için Yerler SDK'sı sonuçlarını Google Haritalar'da veya harita olmadan görüntüleyebilirsiniz. iOS için Places SDK'sı sonuçlarını haritada görüntülemek istiyorsanız bu sonuçlar bir Google Haritası'nda gösterilmelidir. iOS için Yerler SDK'sı verilerinin Google haritası olmayan bir haritada kullanılması yasaktır.

Google logosunu ve ilişkilendirmeleri gösterme

Uygulamanız bir Google Haritası'nda veri gösteriyorsa Google logosu eklenir ve değiştirilemez. Google verilerini bir Google Haritası ile aynı ekranda gösteren uygulamaların Google'a daha fazla ilişkilendirme sağlaması gerekmez.

Uygulamanız, Google Haritalar'ın da gösterilmediği bir sayfada veya görünümde veri gösteriyorsa 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österiyorsa ilk sekmede Google logosu gösterilmelidir. Uygulamanızda otomatik tamamlama özelliğine sahip veya sahip olmayan arama alanları kullanılıyorsa logo satır içi olarak gösterilmelidir.

Google logosu haritanın sol alt köşesine, ilişkilendirme bilgileri ise sağ alt köşesine yerleştirilmelidir. Her ikisi de haritanın altında veya uygulamadaki başka bir yerde değil, haritanın üzerinde bir bütün olarak sunulmalıdır. Aşağıdaki harita örneğinde, haritanın sol alt kısmında Google logosu, sağ alt kısmında ise ilişkilendirme gösterilmektedir.

Açık renkli arka planlarda kullanım için	Koyu arka planda kullanım için

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

İndir: google_logo.zip

İlişkilendirmeyi değiştirmeyin. İlişkilendirme bilgilerini kaldırmayın, gizlemeyin veya kırpmayın. Google logolarını satır içi olarak kullanamazsınız (ör. "Bu haritalar [Google_logo]'dan alınmıştır").

İlişkilendirmeyi yakın tutun. Doğrudan yerleştirme dışında Google görüntülerinin ekran görüntülerini kullanıyorsanız standart ilişkilendirmeyi resimde göründüğü şekilde ekleyin. Gerekirse ilişkilendirme metninin stilini ve yerleşimini özelleştirebilirsiniz. Bunun için metnin içeriğe yakın bir yerde olması ve ortalama bir izleyici veya okuyucu tarafından okunabilir olması gerekir. İlişkilendirmeyi içeriğin dışına (ör. kitabınızın sonuna, dosyalarınızın veya programınızın jeneriğine ya da web sitenizin altbilgisine) taşıyamazsınız.

Üçüncü taraf veri sağlayıcıları dahil edin. Haritacılık ürünlerimizdeki bazı veriler ve resimler Google dışındaki sağlayıcılardan gelir. Bu tür görüntüler kullanıyorsanız ilişkilendirme metninizde "Google" adı ve ilgili veri sağlayıcılar(ör. "Harita verileri: Google, Maxar Technologies") belirtilmelidir. Görüntülerde üçüncü taraf veri sağlayıcılar belirtiliyorsa yalnızca "Google" veya Google logosunun eklenmesi uygun bir ilişkilendirme değildir.

Google Haritalar Platformu'nu ilişkilendirme görüntülemenin pratik olmadığı bir cihazda 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 koşulları

Üçüncü taraf sağlayıcılara ait ilişkilendirmeler, 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 ilişkilendirmeleri, Google ilişkilendirmesini içermez. Google logosunu ve ilişkilendirmelerini gösterme bölümünde açıklandığı gibi bu ilişkilendirmeyi kendiniz eklemeniz gerekir.

Tek bir yer veya yer koleksiyonu için üçüncü taraf ilişkilendirmelerini almak üzere bu talimatları uygulayın.

Tek bir yer için ilişkilendirmeleri alma

Kimliğe göre yer alarak bir yer aldığınızda, bu yerin ilişkilendirmelerini GMSPlace'teki attributions mülkünden alabilirsiniz.

attributions, NSAttributedString nesnesi olarak sağlanır.

Bir yer koleksiyonunun ilişkilendirmelerini alma

Uygulamanız, cihazın mevcut yerini isteyerek elde edilen bilgileri gösteriyorsa görüntülenen yer ayrıntıları için üçüncü taraf ilişkilendirmelerini de göstermelidir. İstekte getirilen tüm yerlerin ilişkilendirmelerini, GMSPlaceLikelihoodList üzerinde attributions mülkünden 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 bu nesneyi aynı şekilde görüntüleyebilirsiniz.

Arama sonucu ilişkilendirmeleri

Avrupa'da, Google'ın saf sıralaması kullanılırken arama ürünlerinde, arama sonuçları sıralamasını belirleyen ana faktörleri ve bu faktörlerin ağırlıklarını açıklayan, en fazla 1 tıklama uzaklıkta bir açıklama metni 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ğlantı vermelidir.

2. Düğme: Tamam

Fotoğraflarla ilgili atıfları gösterme

Uygulamanızda fotoğraf gösteriliyorsa bu fotoğraflarda bulunan attributions ve authorAttributions öğelerini de göstermeniz gerekir.

• İlişkilendirmelere erişmek için GMSPlacePhotoMetadata.attributions simgesini kullanın. Bu mülk bir NSAttributedString'tir veya görüntülenecek ilişkilendirme yoksa nil'tır.
• Yazar ilişkilendirmelerine erişmek için GMSPlacePhotoMetadata.authorAttributions simgesini kullanın. Bu özellik, bir GMSPlaceAuthorAttribution dizisi içerir.

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
    }
  }
}
    

[[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;
          }
        }
      }];
    

Yorumları görüntüleme

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

Google kullanıcıları tarafından eklenen yorumları gösterirken yazarın adını yakın bir yere yerleştirmeniz gerekir. GMSPlaceReview nesnesinin yazar ilişkilendirme alanında mevcut olduğunda yazarın fotoğrafını eklemenizi ve profiline de bağlantı vermenizi öneririz. Aşağıdaki resimde bir parkla ilgili yorum örneği gösterilmektedir:

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

Yorumlara erişmek için:

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

  }
})

// 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örüntüleme

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

İlişkilendirmelerdeki bağlantıların çalışabilmesi gerektiğinden, ilişkilendirmelerin gösterilmesi için önerilen yöntem UITextView kullanmaktır. Bağlantıların çalışacağından emin olmak için UITextView üzerinde bir temsilci ayarlayın ve UITextViewDelegate öğenizin shouldInteractWithURL yöntemini YES döndürecek şekilde ayarlayın.

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

// MARK: - UITextViewDelegate

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

...
  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 metinden oluşur. Örneğin:

Örnek Şirket tarafından oluşturulan girişler

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

Google ilişkilendirme için stil yönergeleri

İndirilebilir Google logosunu kullanamıyorsanız CSS ve HTML'de Google ilişkilendirmeleri için stil yönergeleri aşağıda verilmiştir.

Boş alan

Kilitlenmenin etrafındaki boş alanın boyutu, 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 boşluk, "G" harfinin yarısı kadar olmalıdır.

Okunabilirlik

Yazar adı her zaman net ve okunaklı olmalı, ayrıca belirli bir arka plana uygun renk varyasyonunda gösterilmelidir. Seçtiğiniz logo varyantında her zaman yeterli kontrast sağladığınızdan emin olun.

Renk

%0-40 oranında maksimum siyah tonunun kullanıldığı beyaz veya açık arka plan üzerinde Google Material Gray 700 metni kullanın.

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

Koyu arka planlarda, fotoğrafların veya karmaşık olmayan desenlerin üzerinde yazar adı ve ilişkilendirme için beyaz metin kullanın.

#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" ifadesini beyaz veya açık renkli bir arka planda uygun yazı tipi, renk ve aralıkla oluşturur.

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;