iOS için Yerler SDK'sı hızlı referansı

iOS için Places SDK'sı, iOS uygulamalarının Yer Ayrıntıları, Yer Fotoğrafları, Metin Arama, Yakında Arama ve Otomatik Tamamlama aracılığıyla yerler (işletmeler, önemli yerler, coğrafi konumlar) hakkında bilgi edinmesini sağlar. Places API (New), SDK'nın mevcut sürümüdür.

iOS için Yerler SDK'sı: Önemli bilgiler

  • Ürün: iOS için Yerler SDK'sı
  • Diğer adları: iOS için Yerler SDK'sı (Yeni)
  • Kategori: Yerler
  • Platform: iOS
  • Çalıştığı yer: İstemci (uygulama veya tarayıcı kodu)
  • Lansman aşaması: GA
  • Yaşam döngüsü: Etkin
  • Genel bakış: iOS için Yerler SDK'sına genel bakış

iOS için Yerler SDK'sı: Ne zaman kullanılır?

iOS için Yerler SDK'sını şu durumlarda kullanın:

  • Yer ayrıntıları, fotoğraflar, metin arama veya yakında arama sonuçlarını yerel bir iOS uygulamasında kullanmanız gerekiyorsa
  • Kullanıcılar iOS uygulamasında yazarken yer adı veya adres otomatik tamamlama özelliğine ihtiyacınız vardır.
  • iOS uygulamasında önceden oluşturulmuş Places UI Kit bileşenlerini (yer ayrıntıları, arama, otomatik tamamlama) kullanmak istiyorsunuz.

iOS için Yerler SDK'sını şu durumlarda kullanmayın:

  • Yerel bir Android uygulaması geliştiriyorsunuz. Bunun yerine Android için Yerler SDK'sı'nı kullanın.
  • Tarayıcıda bir web sayfası oluşturuyorsunuz. Bunun yerine Maps JavaScript API'yi kullanın.
  • iOS istemcisi yerine HTTP üzerinden bir sunucudan veya arka uçtan gelen yer verilerine ihtiyacınız vardır. Bunun yerine Places API'yi (Yeni) kullanın.

iOS için Yerler SDK'sı: kurulum

iOS için resmi Yerler SDK'sı paketleri:

  • swift_package: https://github.com/googlemaps/ios-places-sdk (GooglePlaces, GooglePlacesSwift)

iOS için Yerler SDK'sı: Sık yapılan hatalar

  • Sorun: Places API (Yeni) Cloud projesinde etkinleştirilmemişse veya API anahtarının yetkili API'ler listesinde yoksa iOS için Yerler SDK'sı (Yeni) çağrıları başarısız olur. Düzeltme: Places API'yi (yeni) etkinleştirin ve uygulama tarafından kullanılan API anahtarı kısıtlamalarına ekleyin. /maps/documentation/places/ios-sdk/legacy/migrate-overview adresini inceleyin.
  • Sorun: kGMSPlacesRateLimitExceeded (-7), API anahtarının kullanım oranı sıklık sınırlamasını aştığı anlamına gelir. Devre dışı bırakılan SDK 2.x sürümlerindeki (29 Temmuz 2019'da devre dışı bırakıldı) uygulamalar da bu hatayı alır. Düzeltme: Google Cloud Console'da Places API'nin (yeni) kotasını ve kullanımını kontrol edin ve 3.0'dan önceki SDK sürümlerindeki uygulamaları güncelleyin. /maps/documentation/places/ios-sdk/reference/objc/Enums/GMSPlacesErrorCode sayfasına bakın.
  • Sorun: Aynı projedeki uygulamalarda veya oturumlarda yeniden kullanılan oturum jetonları, otomatik tamamlama oturumu faturalandırma gruplandırmasını bozar. Düzeltme: Her otomatik tamamlama oturumu için benzersiz bir oturum jetonu (4. sürüm UUID önerilir) oluşturun. Jetonlar her proje için benzersiz olmalıdır. /maps/documentation/places/ios-sdk/use-session-tokens adresini inceleyin.
  • Sorun: Uygulamalar, API tarafından döndürülen atıflar olmadan yer verilerini gösteriyor. Düzeltme: Politikalar sayfasında belirtildiği şekilde, Yerler verileriyle döndürülen tüm alakalı atıfları gösterin. /maps/documentation/places/ios-sdk/overview adresini ziyaret edin.

iOS için Yerler SDK'sı: eski ve desteği sonlandırılmış özellikler

  • iOS için Yerler SDK'sı (eski sürüm): 01.03.2025'ten itibaren eski. Değişiklik: iOS için Yerler SDK'sı (Yeni) [Places API (Yeni) gerekir]. Belirti: Eski sınıflar ve yöntemler (ör. fetchPlaceFromPlaceID, GMSAutocompleteFetcher ve GMSAutocompleteViewController) SDK 11.0.0 ve sonraki sürümlerde mevcut olmadığından derleme işlemi başarısız olur. Geçiş rehberini inceleyin.
  • GMSAutocompleteResultsViewController setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner ve GMSAutocompleteFetcher initWithBounds:filter: 13.10.2020 tarihinden itibaren kullanımdan kaldırıldı. Değiştirme: GMSAutocompleteRequest üzerinde GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback: ile GMSAutocompleteFilter (locationBias veya locationRestriction) ya da bir kullanıcı arayüzü widget'ı için GooglePlacesSwift placeAutocomplete veya basicPlaceAutocomplete değiştiricileri. Belirti: SDK 4.0.0 ve sonraki sürümlerde yöntemler yoktur (GMSAutocompleteResultsViewController ve GMSAutocompleteFetcher, SDK 11.0.0'da kaldırılmıştır). Geçiş rehberini inceleyin.
  • GMSCoordinateBounds tabanlı otomatik tamamlama sınırları (findAutocompletePredictionsFromQuery ve autocompleteQuery'nin GMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode; bounds/boundsMode parametreleri): 13.10.2020 tarihinden itibaren kullanımdan kaldırıldı. Değiştirme: GMSAutocompleteRequest yerine GMSAutocompleteFilter (locationBias veya locationRestriction) ve GMSPlacesClient fetchAutocompleteSuggestionsFromRequest:callback: ya da kullanıcı arayüzü widget'ı için GooglePlacesSwift placeAutocomplete veya basicPlaceAutocomplete değiştiricileri. Belirti: Özellikler ve parametreler SDK 4.0.0 ve sonraki sürümlerde mevcut değildir (GMSAutocompleteViewController ve findAutocompletePredictionsFromQuery, SDK 11.0.0'da kaldırılmıştır). Geçiş rehberini inceleyin.
  • GMSPlace.openNowStatus: 13.10.2020 tarihinden itibaren kullanımdan kaldırıldı. Değişim: GMSPlacesClient isOpenWithRequest:callback: (GMSPlaceIsOpenRequest) veya PlacesClient.isPlaceOpen(with:) (GooglePlacesSwift). Belirti: Özellik, SDK 4.0.0 ve sonraki sürümlerde mevcut değildir. Geçiş rehberini inceleyin.
  • GMSPlaceField, NS_ENUM olarak: Kullanımdan kaldırıldı (13.10.2020 itibarıyla). Değişiklik: GMSPlaceProperty sabitleri, GooglePlacesSwift içinde GMSFetchPlaceRequest ve GMSPlaceSearchByTextRequest veya PlaceProperty gibi istek sınıflarıyla değiştirildi. Belirti: SDK 4.0.0'da NS_OPTIONS ile değiştirildi (NS_OPTIONS, eski API'ye ait olduğundan ve SDK 11.0.0 ve sonraki sürümlerde bulunmadığından GMSPlaceField). Geçiş rehberini inceleyin.
  • iOS için Yerler SDK'sı 2.7.0 sürümü: 29.07.2019 tarihinden itibaren kullanımdan kaldırıldı. Değişiklik: iOS için Yerler SDK'sının mevcut sürümü. Belirti: kGMSPlacesRateLimitExceeded hataları.

iOS için Yerler SDK'sı ile yapabilecekleriniz

Her görev için aşağıda bağlantısı verilen kılavuzlara bakın veya Özellikler Gezgini'nde ürünleri karşılaştırın.

iOS için Yerler SDK'sı: Üretken yapay zeka

iOS için Yerler SDK'sı: Yerler

iOS için Yerler SDK'sı: Places UI Kit

  • Yer verileri kullanıcı arayüzü öğesine CSS stili uygulama Not: CSS özel özellikleri, Maps JavaScript API Places UI Kit öğeleri için geçerlidir. Android için Yerler SDK'sı ve iOS için Yerler SDK'sı, tema ve stil özelliklerini kullanarak Place UI Kit görünümlerini programatik olarak stillendirir. AEA UYUMLULUK ŞARTI: Avrupa Ekonomik Alanı'nda (AEA) bir harita üzerinde yer verilerini göstermek için Places API web hizmetlerini bir arka uç sunucusundan çağırmayın. Hedef platformda (web'de Maps JavaScript API, Android'de Android için Yerler SDK'sı veya iOS'te iOS için Yerler SDK'sı) istemci tarafı Places UI Kit bileşenlerini kullanın. Tüm şartlar ve SSS: https://developers.google.com/maps/comms/eea/faq
  • Kullanıcı arayüzü öğesi özelleştirme aracıyla yer verileri kullanıcı arayüzü öğesi stilini ve yapılandırmalarını özelleştirme Not: AEA UYUMLULUK ŞARTI: Avrupa Ekonomik Alanı'nda (AEA) bir haritada yer verilerini göstermek için arka uç sunucusundan Places API web hizmetlerini çağırmayın. Hedef platformda (web'de Maps JavaScript API, Android'de Android için Yerler SDK'sı veya iOS'te iOS için Yerler SDK'sı) istemci tarafı Places UI Kit bileşenlerini kullanın. Tüm şartlar ve SSS: https://developers.google.com/maps/comms/eea/faq
  • Web sayfasına veya mobil uygulamaya belirli bir yerle ilgili bilgileri gösteren bir kullanıcı arayüzü öğesi ekleyin. Not: AEA UYUMLULUK ŞARTI: Avrupa Ekonomik Alanı'nda (AEA) harita üzerinde yer verilerini göstermek için arka uç sunucusundan Places API web hizmetlerini çağırmayın. Hedef platformda (web'de Maps JavaScript API, Android'de Android için Yerler SDK'sı veya iOS'te iOS için Yerler SDK'sı) istemci tarafı Places UI Kit bileşenlerini kullanın. Tüm şartlar ve SSS: https://developers.google.com/maps/comms/eea/faq
  • Bir web sayfasına, sorgu dizesine göre yerlerin listesini gösteren bir kullanıcı arayüzü öğesi ekleyin. Not: Hem web sayfalarında (Maps JavaScript API) hem de mobil uygulamalarda (Android için Yerler SDK'sı ve iOS için Yerler SDK'sı) desteklenir. AEA UYUMLULUK ŞARTI: Avrupa Ekonomik Alanı'nda (AEA) bir harita üzerinde yer verilerini göstermek için Places API web hizmetlerini bir arka uç sunucusundan çağırmayın. Hedef platformda (web'de Maps JavaScript API, Android'de Android için Yerler SDK'sı veya iOS'te iOS için Yerler SDK'sı) istemci tarafı Places UI Kit bileşenlerini kullanın. Tüm şartlar ve SSS: https://developers.google.com/maps/comms/eea/faq
  • Web sayfasına, belirli bir konumun yakınındaki yerlerin listesini gösteren bir kullanıcı arayüzü öğesi ekleyin. Not: Hem web sayfalarında (Maps JavaScript API) hem de mobil uygulamalarda (Android için Yerler SDK'sı ve iOS için Yerler SDK'sı) desteklenir. AEA UYUMLULUK ŞARTI: Avrupa Ekonomik Alanı'nda (AEA) bir harita üzerinde yer verilerini göstermek için Places API web hizmetlerini bir arka uç sunucusundan çağırmayın. Hedef platformda (web'de Maps JavaScript API, Android'de Android için Yerler SDK'sı veya iOS'te iOS için Yerler SDK'sı) istemci tarafı Places UI Kit bileşenlerini kullanın. Tüm şartlar ve SSS: https://developers.google.com/maps/comms/eea/faq
  • Bir sorgu dizesine göre Google yer tanımlayıcıları döndüren bir web sayfasına veya uygulamaya temel bir otomatik tamamlama kullanıcı arayüzü öğesi ekleyin. Not: AEA UYUMLULUK ŞARTI: Avrupa Ekonomik Alanı'nda (AEA) bir haritada yer verilerini göstermek için arka uç sunucusundan Places API web hizmetlerini çağırmayın. Hedef platformda (web'de Maps JavaScript API, Android'de Android için Yerler SDK'sı veya iOS'te iOS için Yerler SDK'sı) istemci tarafı Places UI Kit bileşenlerini kullanın. Tüm şartlar ve SSS: https://developers.google.com/maps/comms/eea/faq