Bu belgede, API'nin parçası olan Yer Otomatik Tamamlama hizmeti de dahil olmak üzere iOS için Yerler SDK'sı ile geliştirilen tüm uygulamalara özel gereksinimler listelenmektedir. Google Haritalar geliştiricileri için daha genel bilgilere Google Haritalar Platformu Hizmet Şartları'nda ulaşabilirsiniz.
Kullanım şartları ve gizlilik politikası sağlama
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ı herkesin erişimine 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, Google Haritalar API'lerini kullandığınızı kullanıcılara 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 alt bilgisine Kullanım Şartları ve Gizlilik Politikası bağlantısını eklemeniz ö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. Yer kimliği, iOS için Yerler SDK'sı 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 sonuçları için Yerler SDK'sı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örüntüleyen uygulamaların Google'a daha fazla atıfta bulunmaları 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 planda 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ştirilmiş öğeler dışında Google görüntülerinin ekran görüntülerini kullanıyorsanız standart atıfı resimde göründüğü gibi ekleyin. Gerekirse ilişkilendirme metninin stilini ve yerleşimini özelleştirebilirsiniz. Bunun için metnin içeriğe yakın 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ını 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 atıf metninizde "Google" adı ve ilgili veri sağlayıcılar (ör. "Harita verileri: Google, Maxar Technologies") belirtilmelidir. Görüntülerle birlikte bahsedilen üçüncü taraf veri sağlayıcılar olduğunda, yalnızca "Google"ın veya Google logosunun eklenmesi uygun atıf anlamına gelmez.
Google Haritalar Platformu'nu ilişkilendirme görüntülemenin pratik olmadığı bir cihazda kullanıyorsanız lütfen kullanım alanınıza uygun lisansları görüşmek için Google satış ekibiyle iletişime geçin.
Diğer ilişkilendirme koşulları
Üçüncü taraf sağlayıcılarla yapılan ilişkilendirmelerde, kullanıcıya sağlandığı biçimde göstermeniz gereken içerik ve bağlantılar yer alır. 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 bir yer koleksiyonu ile ilgili üçüncü taraf ilişkilendirmelerini almak için aşağıdaki talimatları uygulayın.
Tek bir yere ait atıfları alma
Bir yeri kimlik bilgileriyle alarak bir yer aldığınızda, söz konusu yere ait ilişkilendirmeleri GMSPlace üzerindeki 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 alınan tüm yerlere ait atıfları
GMSPlaceLikelihoodList adresindeki 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 sonuçları 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.
Düğme 1: Daha fazla bilgi
"Daha fazla bilgi" metni bir Yardım Merkezi makalesine bağlanmalıdır.
2. Düğme: Tamam
Bir fotoğrafla 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.attributionsdeğerini kullanın. Bu mülk birNSAttributedString'tir veya görüntülenecek ilişkilendirme yoksanil'tır. - Yazar ilişkilendirmelerine erişmek için
GMSPlacePhotoMetadata.authorAttributionssimgesini kullanın. Bu özellik, birGMSPlaceAuthorAttributiondizisi içerir.
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; } } }];
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:
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ö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ışması gerektiğinden, ilişkilendirmeleri görüntülemek için önerilen yol UITextView kullanmaktır.
Bağlantıların çalıştığından emin olmak için UITextView üzerinde bir temsilci ayarlayın ve UITextViewDelegate öğenizin shouldInteractWithURL yöntemini YES 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 metinden oluşur. Örneğin:
Örnek Şirket tarafından oluşturulan girişler
Yukarıdaki örnekte, Örnek Şirket metin aralığı bir NSLink özelliğiyle kapsanmaktadı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.
Atıf kopyası ile Google logosu arasındaki alan, "G" harfinin genişliğinin yarısı kadar olmalıdır.
Okunabilirlik
Yazar adı her zaman net ve okunaklı olmalı, 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
"Google" metnine uygulandığında aşağıdaki CSS, "Google"ı beyaz veya açık renkli bir arka plan üzerinde uygun yazı tipi, renk ve boşlukla 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;