Ringkasan
Antarmuka utama ke Places SDK.
Digunakan untuk menelusuri dan mendapatkan detail tentang tempat. Class ini harus diakses melalui metode [GMSPlacesClient sharedClient].
Metode GMSPlacesClient hanya boleh dipanggil dari thread utama. Memanggil metode ini dari thread lain akan menghasilkan pengecualian atau perilaku yang tidak ditentukan. Kecuali jika ditentukan lain, semua callback akan dipanggil pada thread utama.
Fungsi Anggota Publik | |
(void) | - lookUpPlaceID:callback: |
Mendapatkan detail suatu tempat. | |
(void) | - fetchAutocompleteSuggestionsFromRequest:callback: |
Menemukan saran Autocomplete dari kueri teks. | |
(void) | - lookUpPhotosForPlaceID:callback: |
Mendapatkan metadata hingga 10 foto yang terkait dengan tempat. | |
(void) | - loadPlacePhoto:callback: |
Memuat gambar untuk foto tertentu pada ukuran maksimumnya. | |
(void) | - loadPlacePhoto:constrainedToSize:scale:callback: |
Memuat gambar untuk foto tertentu, yang diskalakan agar sesuai dengan dimensi maksimum yang diberikan. | |
(void) | - currentPlaceWithCallback: |
Menampilkan perkiraan tempat perangkat yang saat ini diketahui berada. | |
(void) | - findAutocompletePredictionsFromQuery:filter:sessionToken:callback: |
Menemukan prediksi Autocomplete dari kueri teks. | |
(void) | - fetchPlaceFromPlaceID:placeFields:sessionToken:callback: |
Mengambil detail tempat. | |
(void) | - findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:callback: |
Menemukan kemungkinan tempat menggunakan lokasi pengguna saat ini. | |
(void) | - isOpenWithPlaceID:callback: |
Mendapatkan detail tempat termasuk semua kolom yang diperlukan untuk menentukan GMSPlaceOpenStatus pada saat ini. | |
(void) | - isOpenWithPlaceID:date:callback: |
Mendapatkan detail tempat termasuk semua kolom yang diperlukan untuk menentukan GMSPlaceOpenStatus di NSDate yang ditentukan. | |
(void) | - isOpenWithPlace:callback: |
Mendapatkan detail tempat termasuk semua kolom yang diperlukan untuk menentukan GMSPlaceOpenStatus pada saat ini. | |
(void) | - isOpenWithPlace:date:callback: |
Mendapatkan detail tempat termasuk semua kolom yang diperlukan untuk menentukan GMSPlaceOpenStatus di NSDate yang ditentukan. | |
(void) | - searchByTextWithRequest:callback: |
Telusuri tempat berdasarkan teks dan pembatasan. | |
(void) | - fetchPlaceWithRequest:callback: |
Mendapatkan tempat menggunakan objek permintaan. | |
(void) | - fetchPhotoWithRequest:callback: |
Meminta foto menggunakan permintaan ambil foto. | |
(void) | - searchNearbyWithRequest:callback: |
Menelusuri tempat di dekat lokasi dan pembatasan. | |
Fungsi Anggota Publik Statis | |
(jenis instance) | + sharedClient |
Memberikan instance bersama GMSPlacesClient bagi Google Places SDK for iOS, yang membuatnya jika perlu. | |
(BOOL) | + provideAPIKey: |
Memberikan kunci API Anda ke Google Places SDK for iOS. | |
(NSString *) | + openSourceLicenseInfo |
Menampilkan informasi lisensi software open source untuk Google Places SDK for iOS. | |
(NSString *) | + SDKVersion |
Menampilkan versi untuk rilis Google Places SDK for iOS ini. | |
(NSString *) | + SDKLongVersion |
Menampilkan versi panjang untuk rilis Google Places SDK for iOS ini. | |
Fungsi Terkait | |
(Perhatikan bahwa ini bukan fungsi anggota.) | |
typedef void(^ | GMSPlaceResultCallback )(hasil GMSPlace *_Nullable, error NSError *_Nullable) |
Jenis callback untuk menerima pencarian detail tempat. | |
typedef void(^ | GMSPlaceLikelihoodListCallback )(GMSPlaceLikelihoodList *_Nullable iconList, error NSError *_Nullable) |
Jenis callback untuk menerima daftar kemungkinan tempat. | |
typedef void(^ | GMSPlaceLikelihoodsCallback )(NSArray< GMSPlaceLikelihood * > kemungkinan *_Nullable, error NSError *_Nullable) |
Jenis callback untuk menerima array GMSPlaceLikelihood . | |
typedef void(^ | GMSAutocompletePredictionsCallback )(NSArray< GMSAutocompletePrediction * > *_Nullable hasil, NSError *_Nullable error) |
Jenis callback untuk menerima hasil pelengkapan otomatis. | |
typedef void(^ | GMSPlacePhotoMetadataResultCallback )(GMSPlacePhotoMetadataList *_Nullable foto, NSError *_Nullable error) |
Jenis callback untuk menerima hasil foto tempat. | |
typedef void(^ | GMSPlacePhotoImageResultCallback )(UIImage *_Nullable photo, error NSError *_Nullable) |
Jenis callback untuk menerima objek UIImage dari objek GMSPlacePhotoMetadata . | |
typedef void(^ | GMSPlaceOpenStatusCallback )(hasil GMSPlaceOpenStatus, error NSError *_Nullable) |
Jenis callback untuk menerima status jam buka untuk Place. | |
typedef void(^ | GMSPlaceSearchByTextResultCallback )(NSArray< GMSPlace * > *_Nullable places, NSError *_Nullable error) |
Jenis callback untuk menerima penelusuran berdasarkan hasil teks. | |
typedef void(^ | GMSFetchPhotoResultCallback )(UIImage *_Nullable photoImage, error NSError *_Nullable) |
Jenis callback untuk menerima foto. | |
typedef void(^ | GMSAutocompleteSuggestionsCallback )(NSArray< GMSAutocompleteSuggestion * > *_Nullable hasil, error NSError *_Nullable) |
Jenis callback untuk hasil pelengkapan otomatis. | |
typedef void(^ | GMSPlaceSearchNearbyResultCallback )(NSArray< GMSPlace * > *_Nullable places, NSError *_Nullable error) |
Jenis callback untuk menerima hasil penelusuran di sekitar. |
Dokumentasi Fungsi Anggota
+ (instancetype) sharedClient |
Memberikan instance bersama GMSPlacesClient bagi Google Places SDK for iOS, yang membuatnya jika perlu.
Jika aplikasi Anda sering menggunakan metode GMSPlacesClient, aplikasi sebaiknya langsung menyimpan objek ini. Jika tidak, koneksi Anda ke Google dapat dimulai ulang secara berkala.
+ (BOOL) provideAPIKey: | (NSString *) | kunci |
Memberikan kunci API Anda ke Google Places SDK for iOS.
Kunci ini dibuat untuk aplikasi Anda melalui Google Cloud Platform Console, dan dipasangkan dengan ID paket aplikasi Anda untuk mengidentifikasinya. Layanan ini harus dipanggil oleh aplikasi Anda sebelum menggunakan GMSPlacesClient (misalnya, dalam application:didFinishLaunchingWithOptions:).
- Hasil:
- YA jika APIKey berhasil diberikan.
+ (NSString *) openSourceLicenseInfo |
Menampilkan informasi lisensi software open source untuk Google Places SDK for iOS.
Informasi ini harus disediakan dalam pengajuan permohonan Anda.
+ (NSString *) SDKVersion |
Menampilkan versi untuk rilis Google Places SDK for iOS ini.
. Misalnya, "1.0.0".
+ (NSString *) SDKLongVersion |
Menampilkan versi panjang untuk rilis Google Places SDK for iOS ini.
. Misalnya, "1.0.0 (102.1)".
- (void) searchUpPlaceID: | (NSString *) | placeID | |
: | (GMSPlaceResultCallback) | callback | |
Mendapatkan detail suatu tempat.
Metode ini bersifat non-pemblokiran.
- Parameter:
-
placeID ID tempat yang akan dicari. callback Callback yang akan dipanggil dengan hasil pencarian.
- Catatan:
- Fitur ini tidak digunakan lagi. Metode ini diganti dengan
fetchPlaceWithRequest:callback:
dan akan dihapus dalam rilis mendatang.
- (void) fetchAutocompleteSuggestionsFromRequest: | (GMSAutocompleteRequest *) | permintaan | |
: | (GMSAutocompleteSuggestionsCallback) | callback | |
Menemukan saran Autocomplete dari kueri teks.
Hasil dapat secara opsional dicondongkan ke lokasi tertentu atau terbatas pada suatu area. Metode ini bersifat non-pemblokiran.
Callback yang disediakan akan dipanggil dengan array saran pelengkapan otomatis setelah berhasil dan NSError saat terjadi error.
- Parameter:
-
minta Permintaan GMSAutocompleteRequest
untuk pelengkapan otomatis.callback Callback yang akan dipanggil dengan saran.
- (void) LookUpPhotosForPlaceID: | (NSString *) | placeID | |
: | (GMSPlacePhotoMetadataResultCallback) | callback | |
Mendapatkan metadata hingga 10 foto yang terkait dengan tempat.
Foto berasal dari berbagai lokasi, termasuk pemilik bisnis dan foto yang dikontribusikan oleh pengguna Google+. Umumnya, foto ini dapat digunakan tanpa atribusi, atau harus menyertakan atribusi yang diperlukan sebagai bagian dari gambar. Namun, Anda harus menggunakan properti attributions
dalam respons untuk mengambil atribusi tambahan yang diperlukan, dan menampilkan atribusi tersebut dalam aplikasi di mana pun Anda menampilkan gambar. Maksimum 10 foto ditampilkan.
Beberapa panggilan metode ini mungkin akan menampilkan foto yang sama setiap saat. Namun, hal ini tidak dijamin karena data pokok mungkin telah berubah.
Metode ini melakukan pencarian jaringan.
- Parameter:
-
placeID ID tempat untuk mencari foto. callback Callback yang akan dipanggil dengan hasil pencarian.
- (void) loadPlacePhoto: | (GMSPlacePhotoMetadata *) | photoMetadata | |
: | (GMSPlacePhotoImageResultCallback) | callback | |
Memuat gambar untuk foto tertentu pada ukuran maksimumnya.
Data gambar mungkin di-cache oleh SDK. Jika foto yang diminta tidak ada di cache maka pencarian jaringan akan dilakukan.
- Parameter:
-
photoMetadata GMSPlacePhotoMetadata
yang akan digunakan untuk memuatUIImage
.callback Callback yang akan dipanggil dengan UIImage
yang dimuat.
- (void) loadPlacePhoto: | (GMSPlacePhotoMetadata *) | photoMetadata | |
restrictedToSize: | (CGSize) | maxSize | |
skala: | (CGFloat) | skala | |
: | (GMSPlacePhotoImageResultCallback) | callback | |
Memuat gambar untuk foto tertentu, yang diskalakan agar sesuai dengan dimensi maksimum yang diberikan.
Gambar akan diskalakan agar sesuai dengan dimensi yang diberikan dengan tetap mempertahankan rasio aspek gambar asli. Penskalaan ini dilakukan di sisi server.
Jika parameter skala bukan 1,0 maxSize akan dikalikan dengan nilai ini dan UIImage
yang ditampilkan akan ditetapkan agar memiliki skala yang ditentukan. Parameter ini harus disetel ke skala layar jika Anda memuat gambar untuk ditampilkan di layar.
Data gambar mungkin di-cache oleh SDK. Jika foto yang diminta tidak ada di cache maka pencarian jaringan akan dilakukan.
- Catatan:
- Setelah menerapkan faktor skala, dimensi dalam maxSize akan dibulatkan ke atas ke bilangan bulat terdekat sebelum digunakan. Jika gambar yang diminta melebihi ukuran maksimum yang tersedia, gambar yang lebih kecil dapat ditampilkan.
- Parameter:
-
photoMetadata GMSPlacePhotoMetadata
yang akan digunakan untuk memuatUIImage
.maxSize Ukuran maksimum gambar. scale Skala untuk memuat gambar. callback Callback yang akan dipanggil dengan UIImage
yang dimuat.
- (void) currentPlaceWithCallback: | (GMSPlaceLikelihoodListCallback) | callback |
Menampilkan perkiraan tempat perangkat yang saat ini diketahui berada.
Menghasilkan daftar kemungkinan tempat berdasarkan perkiraan lokasi terakhir perangkat. Callback yang disediakan akan dipanggil dengan daftar kemungkinan ini setelah berhasil dan NSError saat terjadi error.
- Catatan:
- Metode ini mengharuskan aplikasi Anda memiliki izin untuk mengakses lokasi perangkat saat ini. Sebelum memanggilnya, pastikan untuk meminta akses ke lokasi pengguna menggunakan [CLLocationManager requestWhenInUseAuthorization] atau [CLLocationManager requestAlwaysAuthorization]. Jika Anda memanggil metode ini dan aplikasi Anda tidak memiliki status otorisasi yang benar, callback akan dipanggil dengan pesan error.
- Parameter:
-
callback Callback yang akan dipanggil dengan daftar kemungkinan tempat.
- (void) findAutocompletePredictionsFromQuery: | (NSString *) | query | |
filter: | (nullable GMSAutocompleteFilter *) | filter | |
sessionToken: | (nullable GMSAutocompleteSessionToken *) | sessionToken | |
: | (GMSAutocompletePredictionsCallback) | callback | |
Menemukan prediksi Autocomplete dari kueri teks.
Hasil dapat secara opsional dicondongkan ke lokasi tertentu atau terbatas pada suatu area. Metode ini bersifat non-pemblokiran.
Callback yang disediakan akan dipanggil dengan array prediksi pelengkapan otomatis jika berhasil dan NSError jika terjadi error.
- Parameter:
-
kueri Teks parsial yang akan dilengkapi otomatis. filter Filter yang akan diterapkan ke hasil. Parameter ini boleh nol. sessionToken GMSAutocompleteSessionToken
untuk mengaitkan permintaan ke sesi penagihan.callback Callback yang akan dipanggil dengan prediksi.
- (void) fetchPlaceFromPlaceID: | (NSString *) | placeID | |
PlaceFields: | (GMSPlaceField) | placeFields | |
sessionToken: | (nullable GMSAutocompleteSessionToken *) | sessionToken | |
: | (GMSPlaceResultCallback) | callback | |
Mengambil detail tempat.
Metode ini bersifat non-pemblokiran.
- Parameter:
-
placeID ID tempat yang akan dicari. placeFields Kolom tempat individual yang diminta untuk objek tempat dalam daftar. sessionToken GMSAutocompleteSessionToken
untuk mengaitkan permintaan ke sesi penagihan.callback Callback yang akan dipanggil dengan hasil pencarian.
- Catatan:
- Fitur ini tidak digunakan lagi. Metode ini diganti dengan
fetchPlaceWithRequest:callback: callback:
dan akan dihapus dalam rilis mendatang.
- (void) findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: | (GMSPlaceField) | placeFields | |
: | (GMSPlaceLikelihoodsCallback) | callback | |
Menemukan kemungkinan tempat menggunakan lokasi pengguna saat ini.
Metode ini bersifat non-pemblokiran.
Callback yang disediakan akan dipanggil dengan array tempat dengan kemungkinan skor setelah berhasil dan NSError jika terjadi error.
- Parameter:
-
placeFields Kolom tempat individual yang diminta untuk objek tempat dalam daftar. callback Callback yang akan dipanggil dengan kemungkinan tempat.
- (void) isOpenWithPlaceID: | (NSString *) | placeID | |
: | (GMSPlaceOpenStatusCallback) | callback | |
Mendapatkan detail tempat termasuk semua kolom yang diperlukan untuk menentukan GMSPlaceOpenStatus
pada saat ini.
Metode ini bersifat non-pemblokiran.
- Parameter:
-
placeID ID tempat yang akan dicari. callback Callback yang akan dipanggil dengan hasil tempat.
- (void) isOpenWithPlaceID: | (NSString *) | placeID | |
tanggal: | (NSDate *) | tanggal | |
: | (GMSPlaceOpenStatusCallback) | callback | |
Mendapatkan detail tempat termasuk semua kolom yang diperlukan untuk menentukan GMSPlaceOpenStatus
di NSDate
yang ditentukan.
Metode ini bersifat non-pemblokiran.
- Parameter:
-
placeID ID tempat yang akan dicari. date NSDate
untuk menentukan status buka.callback Callback yang akan dipanggil dengan hasil tempat.
- (void) isOpenWithPlace: | (GMSPlace *) | tempat | |
: | (GMSPlaceOpenStatusCallback) | callback | |
Mendapatkan detail tempat termasuk semua kolom yang diperlukan untuk menentukan GMSPlaceOpenStatus
pada saat ini.
Hanya minta kolom tambahan jika GMSPlace
tidak memiliki semua kolom yang diperlukan. Jika tidak, GMSPlaceOpenStatus
akan segera ditampilkan dalam callback. Metode ini bersifat non-pemblokiran.
- Parameter:
-
tempat GMSPlace
yang akan dicari.callback Callback yang akan dipanggil dengan hasil tempat.
- (void) isOpenWithPlace: | (GMSPlace *) | tempat | |
tanggal: | (NSDate *) | tanggal | |
: | (GMSPlaceOpenStatusCallback) | callback | |
Mendapatkan detail tempat termasuk semua kolom yang diperlukan untuk menentukan GMSPlaceOpenStatus
di NSDate
yang ditentukan.
Hanya minta kolom tambahan jika GMSPlace
tidak memiliki semua kolom yang diperlukan. Jika tidak, 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.
- (void) searchByTextWithRequest: | (GMSPlaceSearchByTextRequest *) | textSearchRequest | |
: | (GMSPlaceSearchByTextResultCallback) | callback | |
Telusuri tempat berdasarkan teks dan pembatasan.
Metode ini bersifat non-pemblokiran.
- Parameter:
-
textSearchRequest GMSPlaceSearchByTextRequest
Permintaan teks yang akan digunakan untuk kueri.callback Callback yang akan dipanggil dengan hasil pencarian.
- (void) fetchPlaceWithRequest: | (GMSFetchPlaceRequest *) | fetchPlaceRequest | |
: | (GMSPlaceResultCallback) | callback | |
Mendapatkan tempat menggunakan objek permintaan.
Metode ini bersifat non-pemblokiran.
- Parameter:
-
fetchPlaceRequest GMSFetchPlaceRequest
Permintaan tempat pengambilan yang akan digunakan untuk kueri.callback Callback yang akan dipanggil dengan hasil tempat.
- (void) fetchPhotoWithRequest: | (GMSFetchPhotoRequest *) | fetchPhotoRequest | |
: | (GMSFetchPhotoResultCallback) | callback | |
Meminta foto menggunakan permintaan ambil foto.
Metode ini bersifat non-pemblokiran.
- Parameter:
-
fetchPhotoRequest GMSFetchPhotoRequest
Permintaan foto yang akan digunakan.callback Callback yang akan dipanggil dengan hasil NSURL
.
- (void) searchNearbyWithRequest: | (GMSPlaceSearchNearbyRequest *) | searchNearbyRequest | |
: | (GMSPlaceSearchNearbyResultCallback) | callback | |
Menelusuri tempat di dekat lokasi dan pembatasan.
Metode ini bersifat non-pemblokiran.
- Parameter:
-
searchNearbyRequest GMSPlaceSearchNearbyRequest
Permintaan penelusuran di sekitar yang akan digunakan untuk kueri.callback Callback yang akan dipanggil dengan hasil pencarian.
Dokumentasi Teman Dan Fungsi Terkait
- (typedef void(^ GMSPlaceResultCallback)(hasil GMSPlace *_Nullable, NSError *_Nullable error)) [related] |
Jenis callback untuk menerima pencarian detail tempat.
Jika terjadi error, result
akan bernilai nol dan error
akan berisi informasi tentang error tersebut.
- Parameter:
-
hasil GMSPlace
yang ditampilkan.error Error yang terjadi, jika ada.
- (typedef void(^ GMSPlaceLikelihoodListCallback)(GMSPlaceLikelihoodList *_Nullable TerpopulerList, NSError *_Nullable error)) [related] |
Jenis callback untuk menerima daftar kemungkinan tempat.
Jika terjadi error, likelihoodList
akan bernilai nol dan error
akan berisi informasi tentang error tersebut.
- Parameter:
-
likelihoodList Daftar kemungkinan tempat. error Error yang terjadi, jika ada.
- (typedef void(^ GMSPlaceLikelihoodsCallback)(NSArray< GMSPlaceLikelihood * > kemungkinan *_Nullable, NSError *_Nullable error)) [related] |
Jenis callback untuk menerima array GMSPlaceLikelihood
.
Jika terjadi error, array akan bernilai nol dan error
akan berisi informasi tentang error tersebut.
- (typedef void(^ GMSAutocompletePredictionsCallback)(NSArray< GMSAutocompletePrediction * > *_Nullable results, NSError *_Nullable error)) [related] |
Jenis callback untuk menerima hasil pelengkapan otomatis.
results
adalah array GMSAutocompletePredictions yang mewakili kandidat penyelesaian kueri.
- Parameter:
-
hasil Array dari GMSAutocompletePrediction
.error Error yang terjadi, jika ada.
- (typedef void(^ GMSPlacePhotoMetadataResultCallback)(GMSPlacePhotoMetadataList *_Nullable foto, NSError *_Nullable error)) [related] |
Jenis callback untuk menerima hasil foto tempat.
Jika terjadi error, photos
akan bernilai nol dan error
akan berisi informasi tentang error tersebut.
- Parameter:
-
foto Hasil yang berisi objek GMSPlacePhotoMetadata
.error Error yang terjadi, jika ada.
- (typedef void(^ GMSPlacePhotoImageResultCallback)(UIImage *_Nullable photo, NSError *_Nullable error)) [related] |
Jenis callback untuk menerima objek UIImage
dari objek GMSPlacePhotoMetadata
.
Jika terjadi error, photo
akan bernilai nol dan error
akan berisi informasi tentang error tersebut.
- Parameter:
-
foto UIImage
yang telah dimuat.error Error yang terjadi, jika ada.
- (typedef void(^ GMSPlaceOpenStatusCallback)(hasil GMSPlaceOpenStatus, NSError *_Nullable error)) [related] |
Jenis callback untuk menerima status jam buka untuk Place.
Jika terjadi error, result
akan menjadi GMSPlaceOpenStatusUnknown dan error
akan berisi informasi tentang error tersebut.
- Parameter:
-
hasil GMSPlaceOpenStatus
yang ditampilkan.error Error yang terjadi, jika ada.
- (typedef void(^ GMSPlaceSearchByTextResultCallback)(NSArray< GMSPlace * > *_Nullable places, NSError *_Nullable error)) [related] |
- (typedef void(^ GMSFetchPhotoResultCallback)(UIImage *_Nullable photoImage, NSError *_Nullable error)) [related] |
Jenis callback untuk menerima foto.
photoImage
adalah UIImage
yang mewakili hasil foto yang cocok dengan permintaan yang ditentukan. Jika terjadi error, photoImage
akan bernilai nol dan error
akan berisi informasi tentang error tersebut.
- Parameter:
-
photoImage Hasil UIImage
.
- (typedef void(^ GMSAutocompleteSuggestionsCallback)(NSArray< GMSAutocompleteSuggestion * > *_Nullable results, NSError *_Nullable error)) [related] |
Jenis callback untuk hasil pelengkapan otomatis.
- Parameter:
-
hasil Array GMSAutocompleteSuggestion
.error Error yang terjadi, jika ada.
- (typedef void(^ GMSPlaceSearchNearbyResultCallback)(NSArray< GMSPlace * > *_Nullable places, NSError *_Nullable error)) [related] |
Jenis callback untuk menerima hasil penelusuran di sekitar.
- Parameter:
-
tempat Array GMSPlace
error Error yang terjadi, jika ada.