GMSPlacesClient Sınıf Referansı

Herkese Açık Üye İşlevleri | Statik Herkese Açık Üye İşlevleri | İlgili İşlevler

GMSPlacesClient Sınıf Referansı

---

Genel bakış

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

Yerleri aramak ve yerlerle ilgili ayrıntıları 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ğırma işlevleri 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 çok 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:
	Belirtilen maksimum boyutlara uyacak şekilde ölçeklendirilmiş olarak, resmi 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 yere ait ayrıntıları getirin.
(void)	- findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:callback:
	Kullanıcının mevcut konumunu kullanarak yer olasılığını bulun.
(void)	- isOpenWithPlaceID:callback:
	Bir yere ait, şu anda GMSPlaceOpenStatus belirlemek için gerekli olan tüm alanlar dahil 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:
	Bir yere ait, şu anda GMSPlaceOpenStatus belirlemek için gerekli olan tüm alanlar dahil 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.
(void)	- searchByTextWithRequest:callback:
	Yerleri metne ve kısıtlamalara göre arayın.
Statik Herkese Açık Üye İşlevleri
(instancetype)	+ 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 verir.
(NSString *)	+ openSourceLicenseInfo
	iOS için Google Rehber SDK'sı ile ilgili açık kaynak yazılım lisans bilgilerini döndürür.
(NSString *)	+ SDKVersion
	iOS için Google Rehber SDK'sının bu sürümüne ilişkin sürümü döndürür.
(NSString *)	+ SDKLongVersion
	iOS için Google Rehber SDK'sının bu sürümüne ilişkin uzun sürümü döndürür.
İlgili İşlevler
(Bunların üye işlevleri olmadığını unutmayın.)
typedef void(^	GMSPlaceResultCallback )(GMSPlace *_Nullable sonuç, NSError *_Nullable hatası)
	Yer ayrıntıları aramalarını almak için geri arama türü.
typedef void(^	GMSPlaceLikelihoodListCallbackGMSPlaceLikelihoodList
	Yer olasılığı listelerini almak için geri arama türü.
typedef void(^	GMSPlaceLikelihoodsCallback )(NSArray< GMSPlaceLikelihood * > *_Nullable olasılık, NSError *_Nullable hata)
	Alma dizisi için geri çağırma türü: GMSPlaceLikelihood.
typedef void(^	GMSAutocompletePredictionsCallback )(NSArray< GMSAutocompletePrediction * > *_Nullable results, NSError *_Nullable error)
	Otomatik tamamlama sonuçlarını almak için geri arama türü.
typedef void(^	GMSPlacePhotoMetadataResultCallback )(GMSPlacePhotoMetadataList *_Nullable fotoğraflar, 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ü.
typedef void(^	GMSPlaceSearchByTextResultCallback )(NSArray< GMSPlace * > *_Nullable places, NSError *_Nullable error)
	Metin sonuçlarına göre arama almak için geri arama türü.

---

Üye İşlevi Belgeleri

+ (instancetype) sharedClient

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

Uygulamanız sıklıkla GMSPlacesClient yöntemleri kullanıyorsa bu nesneyi doğrudan tutmak isteyebilir, aksi takdirde Google ile 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 verir.

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

İadeler:

APIKey başarıyla sağlandıysa EVET.

+ (NSString *) openSourceLicenseInfo

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

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

+ (NSString *) SDKVersion

iOS için Google Rehber 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 Rehber 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)	geri arama

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

Bu yöntem engelleyici değildir.

Parametreler:

placeID	Aranacak yerin kimliği.
geri çağırma	Arama sonucuyla birlikte çağrılacak geri çağırma.

- (void) lookUpPhotosForPlaceID:		(NSString *)	placeID
geri arama:		(GMSPlacePhotoMetadataResultCallback)	geri arama

Bir yerle ilişkili en çok 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 da dahil olmak üzere çeşitli konumlardan alınır. Çoğu durumda, bu fotoğraflar atıfta bulunulmadan kullanılabilir veya gerekli atıf resmin parçası olarak dahil edilir. Ancak, gereken ek atıfları 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 döndürülür.

Bu yöntemden birden fazla çağrı yapıldığında muhtemelen her seferinde aynı fotoğraflar döndürülür. Ancak temel veriler değişmiş olabileceğinden bu işlem garanti edilmez.

Bu yöntem bir ağ araması gerçekleştirir.

Parametreler:

placeID	Fotoğraf aranacak yerin kimliği.
geri çağırma	Arama sonucuyla birlikte çağrılacak geri çağırma.

- (void) loadPlacePhoto:		(GMSPlacePhotoMetadata *)	photoMetadata
geri arama:		(GMSPlacePhotoImageResultCallback)	geri arama

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

Resim verileri SDK tarafından önbelleğe alınabilir. İstenen fotoğraf önbellekte yoksa bir ağ araması gerçekleştirilir.

Parametreler:

photoMetadata	UIImage yüklenecek GMSPlacePhotoMetadata.
geri çağırma	Yüklenen UIImage ile çağrılacak geri çağırma.

- (void) loadPlacePhoto:		(GMSPlacePhotoMetadata *)	photoMetadata
restrictionedToSize:		(CGBoyut)	maxSize
ölçek:		(CGFloat)	ölçek
geri arama:		(GMSPlacePhotoImageResultCallback)	geri arama

Belirtilen maksimum boyutlara uyacak şekilde ölçeklendirilmiş olarak, resmi 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 olacak şekilde ayarlanır. Resimleri ekranda göstermek üzere yüklüyorsanız bu parametre ekran ölçeğine ayarlanmalıdır.

Resim verileri SDK tarafından önbelleğe alınabilir. İstenen fotoğraf önbellekte yoksa bir ağ araması gerçekleştirilir.

Not:

Ölçek faktörü uygulandıktan sonra, maxSize alanındaki 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:

photoMetadata	UIImage yüklenecek GMSPlacePhotoMetadata.
maxSize	Resmin maksimum boyutu.
yararlanın	Resmin yükleneceği ölçek.
geri çağırma	Yüklenen UIImage ile çağrılacak geri çağırma.

- (void) currentPlaceWithCallback:

(GMSPlaceLikelihoodListCallback)

geri arama

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, hata olduğunda ise 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 requestWhenInUseAuthorization] 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ğırma

Yer olasılığı listesiyle çağrılacak geri çağırma.

- (void) findAutocomplete PredictionionsFromQuery:		(NSString *)	sorgu
filtrele:		(nullable GMSAutocompleteFilter *)	filtre
sessionToken:		(nullable GMSAutocompleteSessionToken) *)	sessionToken
geri arama:		(GMSAutocompletePredictionsCallback)	geri arama

Metin sorgusundan Otomatik Tamamlama tahminlerini bulun.

Sonuçlar, isteğe bağlı olarak belirli bir konuma ağırlık verebilir 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:

sorgu	Otomatik tamamlanacak kısmi metin.
filter	Sonuçlara uygulanacak filtre. Bu parametre boş olabilir.
sessionToken	İsteği bir faturalandırma oturumuyla ilişkilendirecek GMSAutocompleteSessionToken.
geri çağırma	Tahminlerle çağrılacak geri çağırma.

- (void) fetchPlaceFromPlaceID:		(NSString *)	placeID
yer Alanları:		(GMSPlaceField)	placeFields
sessionToken:		(nullable GMSAutocompleteSessionToken) *)	sessionToken
geri arama:		(GMSPlaceResultCallback)	geri arama

Bir yere ait ayrıntıları getirin.

Bu yöntem engelleyici değildir.

Parametreler:

placeID	Aranacak yerin kimliği.
placeFields	Listedeki yer nesneleri için istenen tek yer alanları.
sessionToken	İsteği bir faturalandırma oturumuyla ilişkilendirecek GMSAutocompleteSessionToken.
geri çağırma	Arama sonucuyla birlikte çağrılacak geri çağırma.

- (void) findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:		(GMSPlaceField)	placeFields
geri arama:		(GMSPlaceLikelihoodsCallback)	geri arama

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

Bu yöntem engelleyici değildir.

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

Parametreler:

placeFields	Listedeki yer nesneleri için istenen tek yer alanları.
geri çağırma	Yer olasılıklarıyla çağrılacak geri çağırma.

- (void) isOpenWithPlaceID:		(NSString *)	placeID
geri arama:		(GMSPlaceOpenStatusCallback)	geri arama

Bir yere ait, şu anda GMSPlaceOpenStatus belirlemek için gerekli olan tüm alanlar dahil ayrıntıları alır.

Bu yöntem engelleyici değildir.

Parametreler:

placeID	Aranacak yerin kimliği.
geri çağırma	Yer sonucuyla birlikte çağrılacak geri çağırma.

- (void) isOpenWithPlaceID:		(NSString *)	placeID
tarih:		(NSDate *)	tarih
geri arama:		(GMSPlaceOpenStatusCallback)	geri arama

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:

placeID	Aranacak yerin kimliği.
tarih	Açık durumunu belirlenecek NSDate.
geri çağırma	Yer sonucuyla birlikte çağrılacak geri çağırma.

- (void) isOpenWithPlace:		(GMSPlace *)	place
geri arama:		(GMSPlaceOpenStatusCallback)	geri arama

Bir yere ait, şu anda GMSPlaceOpenStatus belirlemek için gerekli olan tüm alanlar dahil ayrıntıları alır.

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

Parametreler:

yer	Aranacak GMSPlace.
geri çağırma	Yer sonucuyla birlikte çağrılacak geri çağırma.

- (void) isOpenWithPlace:		(GMSPlace *)	place
tarih:		(NSDate *)	tarih
geri arama:		(GMSPlaceOpenStatusCallback)	geri arama

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, geri çağırmada GMSPlaceOpenStatus hemen döndürülür. Bu yöntem engelleyici değildir.

Parametreler:

yer	Aranacak GMSPlace.
tarih	Açık durumunu belirlenecek NSDate.
geri çağırma	Yer sonucuyla birlikte çağrılacak geri çağırma.

- (void) searchByTextWithRequest:		(GMSPlaceSearchByTextRequest *)	textSearchRequest
geri arama:		(GMSPlaceSearchByTextResultCallback)	geri arama

Yerleri metne ve kısıtlamalara göre arayın.

Bu yöntem engelleyici değildir.

Parametreler:

textSearchRequest	GMSPlaceSearchByTextRequest Sorgu için kullanılacak metin isteği.
geri çağırma	Arama sonucuyla birlikte çağrılacak geri çağırma.

---

Arkadaşlar ve İlişkilendirilen İşlev Belgeleri

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

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

Bir hata oluşursa result boş olur ve error hata ile ilgili bilgi içerir.

Parametreler:

sonuç	İade edilen GMSPlace.
hata	Oluşan hata (varsa).

- (typedef void(^ GMSPlaceLikelihoodListCallback)(GMSPlaceLikelihoodList *_NullableCouldnList, NSError *_Nullable error)) [related]

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

Bir hata oluşursa likelihoodList boş olur ve error hata ile ilgili bilgi içerir.

Parametreler:

likelihoodList	Yer olasılıklarının listesi.
hata	Oluşan hata (varsa).

- (typedef void(^ GMSPlaceLikelihoodsCallback)(NSArray< GMSPlaceLikelihood * > *_Nullable olasılık, NSError *_Nullable hata)) [related]

Alma dizisi için geri çağırma türü: GMSPlaceLikelihood.

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 arama türü.

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

Parametreler:

sonuç	GMSAutocompletePrediction dizisi.
hata	Oluşan hata (varsa).

- (typedef void(^ GMSPlacePhotoMetadataResultCallback)(GMSPlacePhotoMetadataList *_Nullable fotoğraf, NSError *_Nullable error)) [related]

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

Bir hata oluşursa photos boş olur ve error hata ile ilgili bilgi içerir.

Parametreler:

fotoğraflar	Sonuç GMSPlacePhotoMetadata nesne içeriyor.
hata	Oluş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 hata ile ilgili bilgi içerir.

Parametreler:

fotoğraf	Yüklenen UIImage.
hata	Oluşan hata (varsa).

- (typedef void(^ GMSPlaceOpenStatusCallback)(GMSPlaceOpenStatus sonucu, NSError *_Nullable hata)) [related]

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

Bir hata oluşursa result öğesi GMSPlaceOpenStatusUnknown olur ve error hatayla ilgili bilgileri içerir.

Parametreler:

sonuç	İade edilen GMSPlaceOpenStatus.
hata	Oluşan hata (varsa).

- (typedef void(^ GMSPlaceSearchByTextResultCallback)(NSArray< GMSPlace * > *_Nullable places, NSError *_Nullable error)) [related]

Metin sonuçlarına göre arama almak için geri arama türü.

results, sorguyla eşleşen bağımsız sonuçları temsil eden bir GMSPlace dizisidir.

Parametreler:

sonuç	GMSPlace dizisi.
hata	Oluşan hata (varsa).