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)	- 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.
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.

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.

- (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 memuat `UIImage`.
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 memuat `UIImage`.
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.

- (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 akan segera ditampilkan dalam callback. Metode ini bersifat non-pemblokiran.

Parameter:

tempat	`GMSPlace` yang akan dicari.
date	`NSDate` untuk menentukan status buka.
callback	Callback yang akan dipanggil dengan hasil tempat.

- (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.

- (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]

Jenis callback untuk menerima penelusuran berdasarkan hasil teks.

results adalah array GMSPlace yang mewakili hasil individual yang cocok dengan kueri.

Parameter:

hasil	Array dari `GMSPlace`.
error	Error yang terjadi, jika ada.

Referensi Class GMSPlacesClient

Ringkasan

Fungsi Anggota Publik

Fungsi Anggota Publik Statis

Fungsi Terkait

Dokumentasi Fungsi Anggota

Dokumentasi Teman Dan Fungsi Terkait