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. | |
İlgili İşlevler | |
(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:
-
placeID Aranacak yer kimliği. geri çağırma Arama 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:
-
placeID Fotoğraf aranacak yerin kimliği. geri çağırma Arama 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:
-
photoMetadata UIImage
yüklenecekGMSPlacePhotoMetadata
.geri çağırma Yü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:
-
photoMetadata UIImage
yüklenecekGMSPlacePhotoMetadata
.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.
- (geçersiz) 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 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ğırma Yer 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:
-
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 | |
oturum Jetonu: | (nullable GMSAutocompleteSessionToken) *) | sessionToken | |
geri arama: | (GMSPlaceResultCallback) | callback | |
Bir yerle ilgili ayrıntıları getirin.
Bu yöntem engelleyici değildir.
- Parametreler:
-
placeID Aranacak yer kimliği. placeFields Listedeki yer nesneleri için istenen ayrı yer alanları. sessionToken İsteği bir faturalandırma oturumuyla ilişkilendirecek GMSAutocompleteSessionToken
.geri çağırma Arama 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:
-
placeFields Listedeki yer nesneleri için istenen ayrı yer alanları. geri çağırma Yer 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:
-
placeID Aranacak yer kimliği. geri çağırma Yer 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:
-
placeID Aranacak yer kimliği. date (tarih) Açık durumu belirlenecek NSDate
.geri çağırma Yer 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:
-
yer Aranacak GMSPlace
.geri çağırma Yer 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:
-
place The GMSPlace
to lookup.
date The NSDate
to determine open status for.
callback The callback to invoke with the place result.
Arkadaşlar ve İlgili İşlevler Dokümanları
- (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
.hata Oluş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:
-
likelihoodList Yer olasılıkları listesi. hata Oluş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.hata Oluş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ğraflar GMSPlacePhotoMetadata
nesne içeren sonuç.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
, hatayla ilgili bilgileri içerir.
- Parametreler:
-
fotoğraf Yüklenen UIImage
.hata Oluş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
.hata Oluşan hata (varsa).