GMSPlacesClient Sınıf Referansı

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

GMSPlacesClient Sınıf Referansı

---

Genel bakış

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

Yerleri aramak ve yerler hakkında ayrıntılı 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 ileti dizisinden çağrılması, bir istisnaya veya tanımsız davranışa neden olur. Aksi belirtilmedikçe, tüm geri çağırmalar ana mesaj dizisinde çağrılır.

Herkese Açık Üye İşlevleri
(geçersiz)	- lookUpPlaceID:callback:
	Bir yer hakkında ayrıntılı bilgi edinin.
(geçersiz)	- lookUpPhotosForPlaceID:callback:
	Bir yerle ilişkili 10 adede kadar fotoğrafın meta verilerini alır.
(geçersiz)	- loadPlacePhoto:callback:
	Belirli bir fotoğrafın resmini maksimum boyutunda yükler.
(geçersiz)	- loadPlacePhoto:constrainedToSize:scale:callback:
	Belirtilen maksimum boyuta uyacak şekilde, belirli bir fotoğraf için resmi yükler.
(geçersiz)	- currentPlaceWithCallback:
	Cihazın şu anda bulunduğu bilinen bir yer hakkında tahmin döndürür.
(geçersiz)	- findAutocompletePredictionsFromQuery:filter:sessionToken:callback:
	Metin sorgusundan otomatik tamamlama tahminlerini bulun.
(geçersiz)	- FetchPlaceFromPlaceID:placeFields:sessionToken:çağrı:
	Bir yerin ayrıntılarını getirin.
(geçersiz)	- findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:callback:
	Kullanıcının mevcut konumunu kullanarak yer olasılığını bulun.
Statik Genel Üye İşlevleri
(ornektürü)	+ sharedClient
	iOS için Google Yerler SDK'sının paylaşılan GMSPlacesClient örneğini sağlar ve gerekirse oluşturur.
(BOOL)	+ provideAPIKey:
	API anahtarınızı iOS için Google Yerler SDK'sına sağlar.
(NSString *)	+ openSourceLisans Bilgisi
	iOS için Google Yerler SDK'sı için 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ünün sürümünü döndürür.
(NSString *)	+ SDKLongVersion
	iOS için Google Yerler SDK'sının bu sürümünün uzun sürümünü döndürür.
İlgili İşlevler
(Bunların üye işlevleri olmadığını unutmayın.)
typedef invalid(^ )	GMSPlaceResultCallback )(GMSPlace *_Nullable results, NSError *_Nullable error)
	Yer ayrıntıları aramalarını almak için geri çağırma türü.
typedef invalid(^ )	GMSPlaceLikelihoodListCallback )(GMSPlaceLikelihoodList *_NullableabilityList, NSError *_Nullable hatası)
	Yer olasılık listeleri almak için geri arama türü.
typedef invalid(^ )	GMSPlaceLikelihoodsCallback )(NSArray< GMSPlaceLikelihood * > *_Nullable possible, NSError *_Nullable error)
	GMSPlaceLikelihood dizisi almak için geri çağırma türü.
typedef invalid(^ )	GMSAutocompletePredictionsCallback )(NSArray< GMSAutocompletePrediction * > *_Nullable sonuçlar, NSError *_Nullable hatası)
	Otomatik tamamlama sonuçları almak için geri çağırma türü.
typedef invalid(^ )	GMSPlacePhotometadataResultCallback )(GMSPlacePhotometadataList *_Nullable fotoğraflar, NSError *_Nullable hatası)
	Yer fotoğrafları sonuçlarını almak için geri çağırma türü.
typedef invalid(^ )	GMSPlacePhotoImageResultCallback )(UIImage *_Nullable fotoğraf, NSError *_Nullable hatası)
	GMSPlacePhotoMetadata nesnesinden UIImage nesneleri almak için geri çağırma türü.

---

Üye İşlevi Dokümanları

+ (örnek türü) sharedClient

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

Uygulamanız sık sık GMSPlacesClient yöntemleri kullanıyorsa Google'la bağlantınız düzenli olarak yeniden başlatılabileceği için doğrudan bu nesneye sahip olmak isteyebilir.

+ (BOOL) provideAPIKey:

(NSString *)

anahtar

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

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

İadeler:

APIKey başarılı bir şekilde sağlanmışsa EVET.

+ (NSString *) openSourceCreditInfo

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

Bu bilgiler, uygulamanızda sunulmalıdır.

+ (NSString *) SDKVersion

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

. Örneğin, "1.0.0".

+ (NSString *) SDKLongVersion

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

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

- (geçersiz) LookUpPlaceID:		(NSString *)	yer kimliği
geri arama numarası:		(GMSPlaceResultCallback)	geri çağırma

Bir yer hakkında ayrıntılı bilgi edinin.

Bu yöntem, engelleyici değildir.

Parametreler:

yer kimliği	Aranacak yer kimliği.
geri çağırma	Arama sonucuyla çağrılacak geri çağırma.

- (geçersiz) LookUpPhotosForPlaceID		(NSString *)	yer kimliği
geri arama numarası:		(GMSPlacePhotometadataResultCallCall)	geri çağırma

Bir yerle ilişkili 10 adede kadar 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ıf olmadan kullanılabilir veya gerekli ilişkilendirmeyi resmin bir parçası olarak içerir. Ancak gereken ek özellikleri 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öntemin birden fazla kez çağrılması muhtemelen her seferinde aynı fotoğrafları döndürür. Ancak temel veriler değişmiş olabileceğinden bu garanti edilmez.

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

Parametreler:

yer kimliği	Fotoğrafların aranacağı yer kimliği.
geri çağırma	Arama sonucuyla çağrılacak geri çağırma.

- (boşluk)loadPlacePhoto:		(GMSPlaceFotoğrafMeta Verileri *)	fotoMeta Veri
geri arama numarası:		(GMSPlacePhotoImageResultCallCall)	geri çağırma

Belirli bir fotoğrafın resmini 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:

fotoğrafMeta verisi	UIImage dosyasının yükleneceği GMSPlacePhotoMetadata.
geri çağırma	Yüklenen UIImage ile çağrılacak geri çağırma.

- (boşluk)loadPlacePhoto:		(GMSPlaceFotoğrafMeta Verileri *)	fotoMeta Veri
restrictededToSize:		(CGSize)	maksSize
ölçek:		(CGFloat)	ölçek
geri arama numarası:		(GMSPlacePhotoImageResultCallCall)	geri çağırma

Belirtilen maksimum boyuta uyacak şekilde, belirli bir fotoğraf için resmi yükler.

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

Ölçek parametresi 1,0 maks.boyut değilse bu değer ile çarpılır ve döndürülen UIImage, belirtilen ölçeği içerecek şekilde ayarlanır. Ekranda görüntülenmek üzere resim 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ığında, maxSize'daki boyutlar en yakın tam sayıya yuvarlanır. İstenen maksimum boyuttan büyük bir resim istendiğinde daha küçük resim döndürülebilir.

Parametreler:

fotoğrafMeta verisi	UIImage dosyasının yükleneceği GMSPlacePhotoMetadata.
maks.Boyut	Resmin maksimum boyutu.
yararlanın	Resmin yükleneceği ölçek.
geri çağırma	Yüklenen UIImage ile çağrılacak geri çağırma.

- (geçersiz) currentPlaceWithCallback:

(GMSPlaceLikelihoodListCallback)

geri çağırma

Cihazın şu anda bulunduğu bilinen bir yer hakkında tahmin döndürür.

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

Not:

Bu yöntem, uygulamanızın geçerli cihaz konumuna erişim izni olmasını gerektirir. Bu numarayı aramadan önce, [CLLocationManager requestOnInUseAuthorize] veya [CLLocationManager request alwaysAuthorize] URL'sini kullanarak kullanıcının konumuna erişim isteğinde bulunduğunuzdan emin olun. Bu yöntemi ararsanız ve uygulamanız doğru yetkilendirme durumuna sahip değilse geri çağırma bir hata ile çağrılır.

Parametreler:

geri çağırma

Yer olasılık listesi ile çağırmak için geri çağırma.

- (geçersiz) findAutocompletePredictionsFromQuery:		(NSString *)	sorgu
filtre:		(null GMSAutocompleteFilter *)	filtre
sessionToken:		(null GMSAutocompleteSessionToken *)	sessionToken
geri arama numarası:		(GMSAutocompletePredictionsCallback)	geri çağırma

Metin sorgusundan otomatik tamamlama tahminlerini bulun.

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

Sağlanan geri çağırma, başarılı olduktan sonra bir dizi otomatik tamamlama tahmini ve bir hata nedeniyle NSError ile çağrılır.

Parametreler:

sorgu	Otomatik tamamlamada kullanılacak kısmi metin.
filter	Sonuçlara uygulanacak filtre. Bu parametre boş olabilir.
oturum Jetonu	İsteği bir faturalandırma oturumuyla ilişkilendirmek için GMSAutocompleteSessionToken.
geri çağırma	Tahminlerle çağrılacak geri çağırma.

- (geçersiz) fetchPlaceFromPlaceID:		(NSString *)	yer kimliği
yerAlanlar:		(GMSPlaceField)	yerAlanları
sessionToken:		(null GMSAutocompleteSessionToken *)	sessionToken
geri arama numarası:		(GMSPlaceResultCallback)	geri çağırma

Bir yerin ayrıntılarını getirin.

Bu yöntem, engelleyici değildir.

Parametreler:

yer kimliği	Aranacak yer kimliği.
YerAlanları	Listedeki yer nesneleri için istenen bağımsız yer alanları.
oturum Jetonu	İsteği bir faturalandırma oturumuyla ilişkilendirmek için GMSAutocompleteSessionToken.
geri çağırma	Arama sonucuyla çağrılacak geri çağırma.

- (geçersiz) findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:		(GMSPlaceField)	yerAlanları
geri arama numarası:		(GMSPlaceLikelihoodsCallback)	geri çağırma

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ı olma ihtimaline sahip puan dizisiyle ve hata olduğunda NSError değeri ile çağrılır.

Parametreler:

YerAlanları	Listedeki yer nesneleri için istenen bağımsız yer alanları.
geri çağırma	Yer fırsatlarıyla çağrılacak geri çağırma.

---

Arkadaşlar ve İlgili İşlev Dokümanları

- (typedef invalid(^ GMSPlaceResultCallback)(GMSPlace *_Nullable results, NSError *_Nullable error)) [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 bilgiler içerir.

Parametreler:

sonuç	Döndürülen GMSPlace.
hata	Varsa, oluşan hata.

- (typedef invalid(^ GMSPlaceLikelihoodListCallback)(GMSPlaceLikelihoodList *_NullableabilityList, NSError *_Nullable error)) [related]

Yer olasılık listeleri almak için geri arama türü.

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

Parametreler:

Olasılık Listesi	Yer olasılıklarının listesi.
hata	Varsa, oluşan hata.

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

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

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

- (typedef void(^ GMSAutocompletePredictionsCallback)(NSArray< GMSAutocompletePrediction * > *_Nullable sonuçlar, NSError *_Nullable hatası)) [related]

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

results, sorgu adaylarının tamamlamalarını temsil eden bir GMSAutocompletePredictions dizisidir.

Parametreler:

sonuç	GMSAutocompletePrediction saniye dizisi.
hata	Varsa, oluşan hata.

- (typedef void(^ GMSPlacePhotometadataResultCallback)(GMSPlacePhotometadataList *_Nullable fotoğraflar, NSError *_Nullable hatası)) [related]

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

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

Parametreler:

fotoğraflar	Sonuçta GMSPlacePhotoMetadata nesne var.
hata	Varsa, oluşan hata.

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

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

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

Parametreler:

fotoğraf	Yüklenen UIImage.
hata	Varsa, oluşan hata.