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
- Etkinleştirilecek hizmet:
places.googleapis.com - Kimlik doğrulama: API anahtarı
- Kullanım ilişkilendirmesi: Kullanım ilişkilendirme kimliği eklemek için
GMSPlacesClient(Objective-C/Swift) veyaPlacesClient(GooglePlacesSwift) üzerindeaddInternalUsageAttributionIDsınıf yöntemini çağırın. Çağrıyı silmek, kapsam dışında kalmayı seçmenize neden olur. - Başlayın: iOS için Yerler SDK'sını ayarlama
- Referans: iOS için Yerler SDK'sı referansı
- Fiyatlandırma: iOS için Yerler SDK'sı kullanımı ve faturalandırması
- Politikalar: iOS için Yerler SDK'sı politikaları
- Sürüm notları: iOS için Yerler SDK'sı sürüm notları
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ı: İlgili ürünler
- Genellikle birlikte kullanıldığı ürünler: iOS için Haritalar SDK'sı
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,GMSAutocompleteFetcherveGMSAutocompleteViewController) SDK 11.0.0 ve sonraki sürümlerde mevcut olmadığından derleme işlemi başarısız olur. Geçiş rehberini inceleyin. GMSAutocompleteResultsViewControllersetAutocompleteBoundsUsingNorthEastCorner:SouthWestCornerveGMSAutocompleteFetcherinitWithBounds:filter: 13.10.2020 tarihinden itibaren kullanımdan kaldırıldı. Değiştirme:GMSAutocompleteRequestüzerindeGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:ileGMSAutocompleteFilter(locationBiasveyalocationRestriction) ya da bir kullanıcı arayüzü widget'ı içinGooglePlacesSwiftplaceAutocompleteveyabasicPlaceAutocompletedeğiştiricileri. Belirti: SDK 4.0.0 ve sonraki sürümlerde yöntemler yoktur (GMSAutocompleteResultsViewControllerveGMSAutocompleteFetcher, SDK 11.0.0'da kaldırılmıştır). Geçiş rehberini inceleyin.GMSCoordinateBoundstabanlı otomatik tamamlama sınırları (findAutocompletePredictionsFromQueryveautocompleteQuery'ninGMSAutocompleteViewController.autocompleteBounds/autocompleteBoundsMode;bounds/boundsModeparametreleri): 13.10.2020 tarihinden itibaren kullanımdan kaldırıldı. Değiştirme:GMSAutocompleteRequestyerineGMSAutocompleteFilter(locationBiasveyalocationRestriction) veGMSPlacesClientfetchAutocompleteSuggestionsFromRequest:callback:ya da kullanıcı arayüzü widget'ı içinGooglePlacesSwiftplaceAutocompleteveyabasicPlaceAutocompletedeğiştiricileri. Belirti: Özellikler ve parametreler SDK 4.0.0 ve sonraki sürümlerde mevcut değildir (GMSAutocompleteViewControllervefindAutocompletePredictionsFromQuery, 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:GMSPlacesClientisOpenWithRequest:callback:(GMSPlaceIsOpenRequest) veyaPlacesClient.isPlaceOpen(with:)(GooglePlacesSwift). Belirti: Özellik, SDK 4.0.0 ve sonraki sürümlerde mevcut değildir. Geçiş rehberini inceleyin.GMSPlaceField,NS_ENUMolarak: Kullanımdan kaldırıldı (13.10.2020 itibarıyla). Değişiklik:GMSPlacePropertysabitleri,GooglePlacesSwiftiçindeGMSFetchPlaceRequestveGMSPlaceSearchByTextRequestveyaPlacePropertygibi istek sınıflarıyla değiştirildi. Belirti: SDK 4.0.0'daNS_OPTIONSile değiştirildi (NS_OPTIONS, eski API'ye ait olduğundan ve SDK 11.0.0 ve sonraki sürümlerde bulunmadığındanGMSPlaceField). 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:
kGMSPlacesRateLimitExceededhataları.
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
- Belirli bir Google yer tanımlayıcısı için kullanıcı yorumlarının yapay zeka destekli özetini döndürür.
- Elektrikli araç şarj istasyonu için belirtilen Google yer tanımlayıcısının çevresindeki alanın ve imkanların yapay zeka destekli yer özetini döndürür.
iOS için Yerler SDK'sı: Yerler
- Sorgu dizesine göre yerlerin ve yer ayrıntılarının listesini döndürür.
- Belirli bir konumun yakınındaki yerlerin ve yer ayrıntılarının listesini döndürür.
- Bir sorgu dizesine göre yerlerle ilgili otomatik tamamlama sonuçları döndürür.
- Belirli bir yer hakkında ayrıntılı bilgi döndürür.
- Belirli bir yerin fotoğraflarını döndürme Not: Her fotoğrafın yazar atıflarını (yazarın adı, profil URI'sine bağlı) fotoğrafla birlikte gösterin. Her platformun Yerler politikaları bunu gerektirir (ör. /maps/documentation/javascript/policies#photo-attributions ve /maps/documentation/places/web-service/policies#photos-and-review).
- Yer fotoğraflarını yeniden boyutlandırma
- Belirli bir yerle ilgili puanları ve yorumları döndürme Not: Places API (Yeni) web hizmetinde Yer Ayrıntıları, X-Goog-FieldMask (ör. rating,userRatingCount,reviews) ile https://places.googleapis.com/v1/places/{placeId} adresine gönderilen bir HTTP GET isteğidir. Metin Arama, Yakında Arama ve Otomatik Tamamlama ise POST kullanır. Android'de Place.Field.RATING, USER_RATING_COUNT ve REVIEWS değerlerini PlacesClient.fetchPlace() yöntemine iletin. iOS'te GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal ve GMSPlacePropertyReviews değerlerini GMSFetchPlaceRequest'e iletin.
- Bir sorgu dizesine göre yerlerle ilgili sonuçlar döndüren bir web sayfasına veya uygulamaya otomatik tamamlama widget'ı ekleyin.
- Yer bilgileri yanıtlarına dahil edilen veri alanlarını belirtin.
- Yer bilgisi yanıtlarına dahil edilecek yer türlerini belirtin.
- Kullanıcının cihazının şu anda bulunduğu yerle ilgili bilgileri döndürür. Not: Eski Current Place yöntemleri, Android için Yerler SDK'sı 6.0+ ve iOS için Yerler SDK'sı 11.0+ sürümlerinden kaldırılmıştır. Cihaz koordinatlarını platform konum hizmetlerinden alın ve Yakında Arama'yı çağırın.
- Belirli bir yer için yapay zeka destekli özet döndürür.
- Belirli bir yerin çevresindeki yerleri açıklayan yapay zeka destekli bir alan özeti döndürür.
- Önceden tanımlanmış bir rota üzerinde bulunan yerler hakkında bir sorgu dizesine göre bilgi döndürür.
- Bir dizi enlem/boylam koordinatından metin araması yapılan yerlere olan mesafeyi, seyahat süresini ve yol tarifi URI'sini döndürün.
- Bir dizi enlem/boylam koordinatından yakındaki yerlere olan mesafeyi, seyahat süresini ve yol tarifi URI'sini döndürün.
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