GMSPlacesClient Sınıf Referansı


Genel bakış

Yerler SDK'sının ana arayüzü.

Yerleri aramak ve yerlerle ilgili bilgi almak için kullanılır. Bu sınıfa [GMSPlacesClient sharedClient] yöntemiyle erişilmelidir.

GMSPlacesClient yöntemleri yalnızca ana iş parçacığından çağrılmalıdır. Bu yöntemlerin başka bir iş parçacığından çağrılması, istisnaya veya tanımlanmamış davranışa neden olur. Aksi belirtilmedikçe tüm geri çağırmalar ana iş parçacığında çağrılır.

Herkese Açık Üye İşlevleri

(void) - lookUpPlaceID:callback:
 Bir yerle ilgili ayrıntıları öğrenin.
(void) - lookUpPhotosForPlaceID:callback:
 Bir yerle ilişkili en fazla 10 fotoğrafın meta verilerini alır.
(void) - loadPlacePhoto:callback:
 Belirli bir fotoğraf için resmi maksimum boyutunda yükler.
(void) - loadPlacePhoto:constrainedToSize:scale:callback:
 Resmi, belirtilen maksimum boyutlara uyacak şekilde ölçeklendirilmiş olarak belirli bir fotoğraf için yükler.
(void) - currentPlaceWithCallback:
 Cihazın mevcut olarak bulunduğu bilinen yere ilişkin bir tahmin döndürür.
(void) - findAutocompletePredictionsFromQuery:filter:sessionToken:callback:
 Metin sorgusundan Otomatik Tamamlama tahminlerini bulun.
(void) - fetchPlaceFromPlaceID:placeFields:sessionToken:callback:
 Bir yerle ilgili ayrıntıları getirin.
(void) - findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:callback:
 Kullanıcının mevcut konumunu kullanarak yer olasılıklarını bulun.
(void) - isOpenWithPlaceID:callback:
 Şu anki GMSPlaceOpenStatus konumunu belirlemek için gerekli tüm alanlar dahil olmak üzere bir yerle ilgili ayrıntıları alır.
(void) - isOpenWithPlaceID:date:callback:
 Belirtilen NSDate içinde GMSPlaceOpenStatus öğesini belirlemek için gerekli tüm alanlar dahil olmak üzere bir yere ilişkin ayrıntıları alır.
(void) - isOpenWithPlace:callback:
 Şu anki GMSPlaceOpenStatus konumunu belirlemek için gerekli tüm alanlar dahil olmak üzere bir yerle ilgili ayrıntıları alır.
(void) - isOpenWithPlace:date:callback:
 Belirtilen NSDate içinde GMSPlaceOpenStatus öğesini belirlemek için gerekli tüm alanlar dahil olmak üzere bir yere ilişkin ayrıntıları alır.

Statik Herkese Açık Üye İşlevleri

(ornektype)+ sharedClient
 iOS için Google Rehber SDK'sı için GMSPlacesClient paylaşılan örneğini sağlar ve gerekirse oluşturur.
(BOOL) + provideAPIKey:
 API anahtarınızı iOS için Google Rehber SDK'sına sağlar.
(NSString *)+ openSourceLicenseInfo
 iOS için Google Rehber SDK'sının açık kaynak yazılım lisans bilgilerini döndürür.
(NSString *)+ SDKVersion
 iOS için Google Yerler SDK'sının bu sürümüne ilişkin sürümü döndürür.
(NSString *)+ SDKLongVersion
 iOS için Google Yerler SDK'sının bu sürümüne ilişkin uzun sürümü döndürür.

(Bunların üye işlevleri olmadığını unutmayın.)

typedef void(^ GMSPlaceResultCallback )(GMSPlace *_Nullable sonuç, NSError *_Nullable hata)
 Yer ayrıntıları aramalarını almak için geri çağırma türü.
typedef void(^ GMSPlaceLikelihoodListCallback )(GMSPlaceLikelihoodList *_Nullable suggestedList, NSError *_Nullable hata)
 Yer olasılığı listelerini almak için geri arama türü.
typedef void(^ GMSPlaceLikelihoodsCallback )(NSArray< GMSPlaceLikelihood * > *_Nullable olasılıkları, NSError *_Nullable error)
 GMSPlaceLikelihood dizisi almanın geri çağırma türü.
typedef void(^ GMSAutocompletePredictionsCallback )(NSArray< GMSAutocompletePrediction * > *_Nullable results, NSError *_Nullable error)
 Otomatik tamamlama sonuçlarını almak için geri çağırma türü.
typedef void(^ GMSPlacePhotoMetadataResultCallback )(GMSPlacePhotoMetadataList *_Nullable photos, NSError *_Nullable error)
 Yer fotoğrafları sonuçlarını almak için geri arama türü.
typedef void(^ GMSPlacePhotoImageResultCallback )(UIImage *_Nullable fotoğraf, NSError *_Nullable hata)
 Bir GMSPlacePhotoMetadata nesnesinden UIImage nesne almak için geri çağırma türü.
typedef void(^ GMSPlaceOpenStatusCallback )(GMSPlaceOpenStatus sonucu, NSError *_Nullable hatası)
 Yerin çalışma saatleri durumunu almak için geri arama türü.

Üye İşlevi Belgeleri

+ (ornek türü) sharedClient

iOS için Google Rehber SDK'sı için GMSPlacesClient paylaşılan örneğini sağlar ve gerekirse oluşturur.

Uygulamanız sık sık GMSPlacesClient kullanıyorsa bu nesneyi doğrudan tutmak isteyebilir, aksi takdirde Google ile olan bağlantınız düzenli olarak yeniden başlatılabilir.

+ (BOOL) provideAPIKey: (NSString *) anahtar

API anahtarınızı iOS için Google Rehber SDK'sına sağlar.

Bu anahtar, Google Cloud Platform Console aracılığıyla uygulamanız için oluşturulur ve kimliğinizi tanımlamak üzere uygulamanızın paket kimliğiyle eşleştirilir. Bu, GMSPlacesClient kullanılmadan önce uygulamanız tarafından çağrılmalıdır (ör. application:didFinishLaunchingWithOptions:).

İade et:
APIKey başarıyla sağlandıysa EVET.
+ (NSString *) openSourceLicenseInfo

iOS için Google Rehber SDK'sının açık kaynak yazılım lisans bilgilerini döndürür.

Bu bilgiler, başvurunuzda yer almalıdır.

+ (NSString *) SDKVersion

iOS için Google Yerler SDK'sının bu sürümüne ilişkin sürümü döndürür.

. Örneğin, "1.0.0".

+ (NSString *) SDKLongVersion

iOS için Google Yerler SDK'sının bu sürümüne ilişkin uzun sürümü döndürür.

. Örneğin, "1.0.0 (102.1)".

- (void) LookUpPlaceID: (NSString *) placeID
geri arama: (GMSPlaceResultCallback) callback

Bir yerle ilgili ayrıntıları öğrenin.

Bu yöntem engelleyici değildir.

Parametreler:
placeIDAranacak yer kimliği.
geri çağırmaArama sonucuyla çağrılacak geri çağırma.
- (void) LookUpPhotosForPlaceID: (NSString *) placeID
geri arama: (GMSPlacePhotoMetadataResultCallback) callback

Bir yerle ilişkili en fazla 10 fotoğrafın meta verilerini alır.

Fotoğraflar, işletme sahipleri ve Google+ kullanıcılarının katkıda bulunduğu fotoğraflar dahil olmak üzere çeşitli konumlardan alınır. Çoğu durumda, bu fotoğraflar atıf olmadan kullanılabilir veya gerekli atıf resmin bir parçası olarak eklenir. Ancak gerekli ek ilişkilendirmeleri almak için yanıtta attributions özelliğini kullanmanız ve bu ilişkilendirmeleri, resmi gösterdiğiniz her yerde uygulamanızda göstermeniz gerekir. En fazla 10 fotoğraf iade edilir.

Bu yöntemin birden fazla kez çağrılması durumunda, büyük olasılıkla her seferinde aynı fotoğraflar döndürülür. Ancak temel veriler değişmiş olabileceğinden bu durum garanti edilmez.

Bu yöntemle ağ araması yapılır.

Parametreler:
placeIDFotoğraf aranacak yerin kimliği.
geri çağırmaArama sonucuyla çağrılacak geri çağırma.
- (void) loadPlacePhoto: (GMSPlacePhotoMetadata *) photoMetadata
geri arama: (GMSPlacePhotoImageResultCallback) callback

Belirli bir fotoğraf için resmi maksimum boyutunda yükler.

SDK, görsel verilerini önbelleğe alabilir. İstenen fotoğraf önbellekte yoksa bir ağ araması gerçekleştirilir.

Parametreler:
photoMetadataUIImage yüklenecek GMSPlacePhotoMetadata.
geri çağırmaYüklenen UIImage ile çağrılacak geri çağırma.
- (void) loadPlacePhoto: (GMSPlacePhotoMetadata *) photoMetadata
sınırlıToSize: (CG Boyutu) maxSize
ölçek: (CGFloat) ölçek
geri arama: (GMSPlacePhotoImageResultCallback) callback

Resmi, belirtilen maksimum boyutlara uyacak şekilde ölçeklendirilmiş olarak belirli bir fotoğraf için yükler.

Resim, orijinal resmin en boy oranı korunarak belirtilen boyutlara sığacak şekilde ölçeklendirilir. Bu ölçeklendirme, sunucu tarafında gerçekleştirilir.

Ölçek parametresi 1.0 değilse maxSize, bu değerle çarpılır ve döndürülen UIImage, belirtilen ölçeğe sahip olarak ayarlanır. Ekranda gösterilecek resimleri yüklüyorsanız bu parametre, ekran ölçeğine ayarlanmalıdır.

SDK, görsel verilerini önbelleğe alabilir. İstenen fotoğraf önbellekte yoksa bir ağ araması gerçekleştirilir.

Not:
Ölçek faktörü uygulandıktan sonra, maxSize'daki boyutlar kullanılmadan önce en yakın tam sayıya yuvarlanır. Mevcut maksimum boyuttan daha büyük bir resim istenirse daha küçük bir görsel döndürülebilir.
Parametreler:
photoMetadataUIImage yüklenecek GMSPlacePhotoMetadata.
maxSizeResmin maksimum boyutu.
yararlanınResmin yükleneceği ölçek.
geri çağırmaYüklenen UIImage ile çağrılacak geri çağırma.

Cihazın mevcut olarak bulunduğu bilinen yere ilişkin bir tahmin döndürür.

Cihazın tahmini son konumuna göre bir yer olasılığı listesi oluşturur. Sağlanan geri çağırma, başarılı olduğunda bu olasılık listesiyle ve bir hata olduğunda NSError ile çağrılır.

Not:
Bu yöntem, uygulamanızın mevcut cihaz konumuna erişim iznine sahip olmasını gerektirir. Bunu çağırmadan önce, [CLLocationManager requestTimeInUseAuthorization] veya [CLLocationManager request AlwaysAuthorization] kullanarak kullanıcıların konumuna erişim isteğinde bulunduğunuzdan emin olun. Bu yöntemi çağırırsanız ve uygulamanız doğru yetkilendirme durumuna sahip değilse geri çağırma hatayla birlikte çağrılır.
Parametreler:
geri çağırmaYer olasılığı listesiyle çağrılacak geri çağırma.
- (void) findAutocompleteEngine PredictionionsFromQuery: (NSString *) sorgu
filtrele: (null değer olan GMSAutocompleteFilter *) filtre
oturum Jetonu: (nullable GMSAutocompleteSessionToken) *) sessionToken
geri arama: (GMSAutocompletePredictionsCallback) callback

Metin sorgusundan Otomatik Tamamlama tahminlerini bulun.

Sonuçlar isteğe bağlı olarak belirli bir konuma dayalı olabilir veya bir alanla sınırlandırılabilir. Bu yöntem engelleyici değildir.

Sağlanan geri çağırma, başarılı olduğunda bir dizi otomatik tamamlama tahminiyle, hata durumunda ise NSError ile çağrılır.

Parametreler:
sorguOtomatik tamamlanacak kısmi metin.
filterSonuçlara uygulanacak filtre. Bu parametre boş olabilir.
sessionTokenİsteği bir faturalandırma oturumuyla ilişkilendirecek GMSAutocompleteSessionToken.
geri çağırmaTahminlerle çağrılacak geri çağırma.
- (void)FetchPlaceFromPlaceID: (NSString *) placeID
yer Alanları: (GMSPlaceField) placeFields
oturum Jetonu: (nullable GMSAutocompleteSessionToken) *) sessionToken
geri arama: (GMSPlaceResultCallback) callback

Bir yerle ilgili ayrıntıları getirin.

Bu yöntem engelleyici değildir.

Parametreler:
placeIDAranacak yer kimliği.
placeFieldsListedeki yer nesneleri için istenen ayrı yer alanları.
sessionTokenİsteği bir faturalandırma oturumuyla ilişkilendirecek GMSAutocompleteSessionToken.
geri çağırmaArama sonucuyla çağrılacak geri çağırma.
- (void) findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (GMSPlaceField) placeFields
geri arama: (GMSPlaceLikelihoodsCallback) callback

Kullanıcının mevcut konumunu kullanarak yer olasılıklarını bulun.

Bu yöntem engelleyici değildir.

Sağlanan geri çağırma, başarı üzerine olasılık puanları ve hata üzerine bir NSError ile birlikte bir dizi yerle çağrılır.

Parametreler:
placeFieldsListedeki yer nesneleri için istenen ayrı yer alanları.
geri çağırmaYer olasılıklarıyla çağrılacak geri çağırma.
- (void) isOpenWithPlaceID: (NSString *) placeID
geri arama: (GMSPlaceOpenStatusCallback) callback

Şu anki GMSPlaceOpenStatus konumunu belirlemek için gerekli tüm alanlar dahil olmak üzere bir yerle ilgili ayrıntıları alır.

Bu yöntem engelleyici değildir.

Parametreler:
placeIDAranacak yer kimliği.
geri çağırmaYer sonucuyla çağrılacak geri çağırma.
- (void) isOpenWithPlaceID: (NSString *) placeID
tarih: (NSDate *) tarih
geri arama: (GMSPlaceOpenStatusCallback) callback

Belirtilen NSDate içinde GMSPlaceOpenStatus öğesini belirlemek için gerekli tüm alanlar dahil olmak üzere bir yere ilişkin ayrıntıları alır.

Bu yöntem engelleyici değildir.

Parametreler:
placeIDAranacak yer kimliği.
date (tarih)Açık durumu belirlenecek NSDate.
geri çağırmaYer sonucuyla çağrılacak geri çağırma.
- (void) isOpenWithPlace: (GMSPlace *) place
geri arama: (GMSPlaceOpenStatusCallback) callback

Şu anki GMSPlaceOpenStatus konumunu belirlemek için gerekli tüm alanlar dahil olmak üzere bir yerle ilgili ayrıntıları alır.

Yalnızca GMSPlace gerekli tüm alanlara sahip değilse ek alanlar ister. Aksi takdirde GMSPlaceOpenStatus, geri çağırmada hemen döndürülür. Bu yöntem engelleyici değildir.

Parametreler:
yerAranacak GMSPlace.
geri çağırmaYer sonucuyla çağrılacak geri çağırma.
- (void) isOpenWithPlace: (GMSPlace *) place
tarih: (NSDate *) tarih
geri arama: (GMSPlaceOpenStatusCallback) callback

Belirtilen NSDate içinde GMSPlaceOpenStatus öğesini belirlemek için gerekli tüm alanlar dahil olmak üzere bir yere ilişkin ayrıntıları alır.

Yalnızca GMSPlace öğesinde gerekli tüm alanlar yoksa ek alanlar ister, aksi takdirde GMSPlaceOpenStatus\ will be returned in the callback immediately. This method is non-blocking.

Parameters:
placeThe GMSPlace to lookup.
dateThe NSDate to determine open status for.
callbackThe callback to invoke with the place result.


- (typedef void(^ GMSPlaceResultCallback)(GMSPlace *_Nullable sonuç, NSError *_Nullable hatası)) [related]

Yer ayrıntıları aramalarını almak için geri çağırma türü.

Bir hata oluşursa result boş olur ve error, hatayla ilgili bilgileri içerir.

Parametreler:
sonuçDöndürülen GMSPlace.
hataOluşan hata (varsa).
- (typedef void(^ GMSPlaceLikelihoodListCallback)(GMSPlaceLikelihoodList *_Nullable suggestedList, NSError *_Nullable error)) [related]

Yer olasılığı listelerini almak için geri arama türü.

Bir hata oluşursa likelihoodList boş olur ve error, hatayla ilgili bilgileri içerir.

Parametreler:
likelihoodListYer olasılıkları listesi.
hataOluşan hata (varsa).
- (typedef void(^ GMSPlaceLikelihoodsCallback)(NSArray< GMSPlaceLikelihood * > > *_Nullable itibariyle, NSError *_Nullable error)) [related]

GMSPlaceLikelihood dizisi almanın geri çağırma türü.

Bir hata oluşursa dizi boş olur ve error, hatayla ilgili bilgileri içerir.

- (typedef void(^ GMSAutocompletePredictionsCallback)(NSArray< GMSAutocompletePrediction * > *_Nullable results, NSError *_Nullable error)) [related]

Otomatik tamamlama sonuçlarını almak için geri çağırma türü.

results, sorgunun aday tamamlamalarını temsil eden bir GMSAutocomplete Predictionions dizisidir.

Parametreler:
sonuçGMSAutocompletePrediction dizisi.
hataOluşan hata (varsa).
- (typedef void(^ GMSPlacePhotoMetadataResultCallback)(GMSPlacePhotoMetadataList *_Nullable fotoğraflar, NSError *_Nullable hata)) [related]

Yer fotoğrafları sonuçlarını almak için geri arama türü.

Bir hata oluşursa photos boş olur ve error, hatayla ilgili bilgileri içerir.

Parametreler:
fotoğraflarGMSPlacePhotoMetadata nesne içeren sonuç.
hataOluşan hata (varsa).
- (typedef void(^ GMSPlacePhotoImageResultCallback)(UIImage *_Nullable fotoğraf, NSError *_Nullable hata)) [related]

Bir GMSPlacePhotoMetadata nesnesinden UIImage nesne almak için geri çağırma türü.

Bir hata oluşursa photo boş olur ve error, hatayla ilgili bilgileri içerir.

Parametreler:
fotoğrafYüklenen UIImage.
hataOluşan hata (varsa).
- (typedef void(^ GMSPlaceOpenStatusCallback)(GMSPlaceOpenStatus sonucu, NSError *_Nullable hatası)) [related]

Yerin çalışma saatleri durumunu almak için geri arama türü.

Bir hata oluşursa result değeri GMSPlaceOpenStatusUnknown olur ve error hatayla ilgili bilgiler içerir.

Parametreler:
sonuçDöndürülen GMSPlaceOpenStatus.
hataOluşan hata (varsa).