Panoramica

Interfaccia principale dell'SDK Places.

Utilizzato per cercare e ottenere dettagli sui luoghi. Questa classe deve essere accessibile tramite il metodo [GMSPlacesClient sharedClient].

I metodi GMSPlacesClient devono essere chiamati solo dal thread principale. La chiamata di questi metodi da un altro thread genererà un'eccezione o un comportamento indefinito. Se non diversamente specificato, tutti i callback verranno richiamati nel thread principale.

Funzioni pubbliche dei membri
(void)	- lookUpPlaceID:callback:
	Visualizza i dettagli di un luogo.
(void)	- lookUpPhotosForPlaceID:callback:
	Recupera i metadati di massimo 10 foto associate a un luogo.
(void)	- loadPlaceFoto:callback:
	Carica l'immagine per una foto specifica alla dimensione massima.
(void)	- loadPlacePhoto:constrainedToSize:scale:callback:
	Carica l'immagine per una foto specifica, ridimensionata per adattarsi alle dimensioni massime specificate.
(void)	- currentPlaceWithCallback:
	Restituisce una stima del luogo in cui è noto che il dispositivo si trova attualmente.
(void)	- findAutocompletePredictionsFromQuery:filter:sessionToken:callback:
	Trova le previsioni di completamento automatico da una query di testo.
(void)	- fetchPlaceFromPlaceID:placeFields:sessionToken:callback:
	Recupero dei dettagli di un luogo.
(void)	- findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:callback:
	Individua le probabilità di luogo utilizzando la posizione corrente dell'utente.
(void)	- isOpenWithPlaceID:callback:
	Recupera i dettagli di un luogo, inclusi tutti i campi necessari per determinare il valore `GMSPlaceOpenStatus` al momento attuale.
(void)	- isOpenWithPlaceID:date:callback:
	Recupera i dettagli di un luogo, inclusi tutti i campi necessari per determinare `GMSPlaceOpenStatus` nel `NSDate` specificato.
(void)	- isOpenWithPlace:callback:
	Recupera i dettagli di un luogo, inclusi tutti i campi necessari per determinare il valore `GMSPlaceOpenStatus` al momento attuale.
(void)	- isOpenWithPlace:date:callback:
	Recupera i dettagli di un luogo, inclusi tutti i campi necessari per determinare `GMSPlaceOpenStatus` nel `NSDate` specificato.
(void)	- searchByTextWithRequest:callback:
	Cerca luoghi in base al testo e alle limitazioni.
Funzioni pubbliche statiche dei membri
(instancetype)	+ sharedClient
	Fornisce l'istanza condivisa di GMSPlacesClient per l'SDK Google Places per iOS, creandola se necessario.
(BOOL)	+ provideAPIKey:
	Fornisce la chiave API a Google Places SDK for iOS.
(NSString *)	+ openSourceLicenseInfo
	Restituisce le informazioni sulla licenza software open source per l'SDK Google Places per iOS.
(NSString *)	+ SDKVersion
	Restituisce la versione per questa release dell'SDK Google Places per iOS.
(NSString *)	+ SDKLongVersion
	Restituisce la versione lunga per questa release dell'SDK Google Places per iOS.
Funzioni correlate
Tieni presente che queste non sono funzioni membro.
typedef void(^	GMSPlaceResultCallback )(GMSPlace _Nullable result, NSError _Nullable error)
	Tipo di callback per ricevere ricerche dei dettagli del luogo.
typedef void(^	GMSPlaceLikelihoodListCallback )(GMSPlaceLikelihoodList _Nullable SuccessList, NSError _Errore Nullable)
	Tipo di callback per la ricezione di elenchi di probabilità di luoghi.
typedef void(^	GMSPlaceLikelihoodsCallback )(NSArray< GMSPlaceLikelihood * > _Probabilità di nullable, NSError _Errore nullable)
	Tipo di callback per la ricezione di array di `GMSPlaceLikelihood`.
typedef void(^	GMSAutocompletePredictionsCallback )(NSArray< GMSAutocompletePrediction * > _Nullable results, NSError _Nullable error)
	Tipo di callback per la ricezione dei risultati del completamento automatico.
typedef void(^	GMSPlacePhotoMetadataResultCallback )(GMSPlacePhotoMetadataList _Foto nullable, NSError _Errore nullable)
	Tipo di callback per ricevere risultati relativi alle foto dei luoghi.
typedef void(^	GMSPlacePhotoImageResultCallback )(UIImage _Foto Nullable, NSError _Errore nullable)
	Tipo di callback per ricevere oggetti `UIImage` da un oggetto `GMSPlacePhotoMetadata`.
typedef void(^	GMSPlaceOpenStatusCallback)(risultato GMSPlaceOpenStatus, errore NSError _Nullable, errore _Nullable)
	Tipo di callback per ricevere lo stato dell'orario di apertura del luogo.
typedef void(^	GMSPlaceSearchByTextResultCallback )(NSArray< GMSPlace * > _Nullable places, NSError _Nullable error)
	Tipo di callback per ricevere risultati di ricerca tramite testo.

Documentazione sulle funzioni dei membri

+ (instancetype) sharedClient

Fornisce l'istanza condivisa di GMSPlacesClient per l'SDK Google Places per iOS, creandola se necessario.

Se la tua applicazione utilizza spesso metodi di GMSPlacesClient, è consigliabile mantenere direttamente questo oggetto, altrimenti la tua connessione a Google potrebbe essere riavviata regolarmente.

+ (BOOL) provideAPIKey: (NSString *) chiave

Fornisce la chiave API a Google Places SDK for iOS.

Questa chiave viene generata per l'applicazione tramite la console della piattaforma Google Cloud ed è abbinata all'ID pacchetto dell'applicazione per identificarla. L'applicazione dovrebbe chiamarla prima di utilizzare GMSPlacesClient, ad esempio in application:didFinishLaunchingWithOptions:.

Resi:: SÌ se l'APIKey è stata fornita correttamente.

+ (NSString *) openSourceLicenseInfo

Restituisce le informazioni sulla licenza software open source per l'SDK Google Places per iOS.

Queste informazioni devono essere rese disponibili all'interno della richiesta di partecipazione.

+ (NSString *) SDKVersion

Restituisce la versione per questa release dell'SDK Google Places per iOS.

. Ad esempio, "1.0.0".

+ (NSString *) SDKLongVersion

Restituisce la versione lunga per questa release dell'SDK Google Places per iOS.

. Ad esempio, "1.0.0 (102.1)".

- (void) lookUpPlaceID:	(NSString *)	placeID
di chiamata:	(GMSPlaceResultCallback)	callback

Visualizza i dettagli di un luogo.

Questo metodo non blocca.

Parametri:

placeID	L'ID del luogo da cercare.
callback	Il callback da richiamare con il risultato della ricerca.

- (void) lookUpPhotosForPlaceID:	(NSString *)	placeID
di chiamata:	(GMSPlacePhotoMetadataResultCallback)	callback

Recupera i metadati di massimo 10 foto associate a un luogo.

Le foto provengono da vari luoghi, tra cui i proprietari di attività e le foto fornite da utenti Google+. Nella maggior parte dei casi, queste foto possono essere utilizzate senza attribuzione o avranno l'attribuzione richiesta inclusa nell'immagine. Tuttavia, devi utilizzare la proprietà attributions nella risposta per recuperare eventuali attribuzioni aggiuntive richieste e visualizzarle nella tua applicazione ovunque mostri l'immagine. Vengono restituite un massimo di 10 foto.

Probabilmente, più chiamate con questo metodo restituiranno le stesse foto ogni volta. Tuttavia, questo non è garantito perché i dati sottostanti potrebbero essere cambiati.

Questo metodo esegue una ricerca della rete.

Parametri:

placeID	L'ID del luogo per cui cercare le foto.
callback	Il callback da richiamare con il risultato della ricerca.

- (void) loadPlaceFoto:	(GMSPlacePhotoMetadata *)	photoMetadata
di chiamata:	(GMSPlacePhotoImageResultCallback)	callback

Carica l'immagine per una foto specifica alla dimensione massima.

I dati delle immagini possono essere memorizzati nella cache dall'SDK. Se la foto richiesta non è presente nella cache, verrà eseguita una ricerca nella rete.

Parametri:

photoMetadata	Il `GMSPlacePhotoMetadata` per cui caricare un `UIImage`.
callback	Il callback da richiamare con l'oggetto `UIImage` caricato.

- (void) loadPlaceFoto:	(GMSPlacePhotoMetadata *)	photoMetadata
vinedToSize:	(CGSize)	maxSize
scala:	(CGFloat)	scala
di chiamata:	(GMSPlacePhotoImageResultCallback)	callback

Carica l'immagine per una foto specifica, ridimensionata per adattarsi alle dimensioni massime specificate.

L'immagine verrà ridimensionata per adattarsi alle dimensioni specificate, mantenendo al contempo le proporzioni dell'immagine originale. Questa scalabilità viene eseguita sul lato server.

Se il parametro della scala non è 1,0, maxSize verrà moltiplicato per questo valore e il valore UIImage restituito verrà impostato in modo da avere la scala specificata. Questo parametro deve essere impostato sulla scala dello schermo se stai caricando immagini da visualizzare sullo schermo.

I dati delle immagini possono essere memorizzati nella cache dall'SDK. Se la foto richiesta non è presente nella cache, verrà eseguita una ricerca nella rete.

Nota:: Dopo aver applicato il fattore di scala, le dimensioni in maxSize verranno arrotondate per eccesso al numero intero più vicino prima dell'uso. Se viene richiesta un'immagine più grande della dimensione massima disponibile, potrebbe essere restituita un'immagine più piccola.

Parametri:

photoMetadata	Il `GMSPlacePhotoMetadata` per cui caricare un `UIImage`.
maxSize	La dimensione massima dell'immagine.
scalabilità	La scala su cui caricare l'immagine.
callback	Il callback da richiamare con l'oggetto `UIImage` caricato.

- (void) currentPlaceWithCallback: (GMSPlaceLikelihoodListCallback) callback

Restituisce una stima del luogo in cui è noto che il dispositivo si trova attualmente.

Genera un elenco di probabilità di luogo basato sull'ultima posizione stimata del dispositivo. Il callback fornito verrà richiamato con questo elenco di probabilità in caso di esito positivo e un messaggio NSError in caso di errore.

Nota:: Questo metodo richiede che la tua app disponga dell'autorizzazione per accedere alla posizione attuale del dispositivo. Prima di effettuare la chiamata, assicurati di richiedere l'accesso alla posizione degli utenti utilizzando [CLLocationManager requestWhenInUseAuthorization] o [CLLocationManager requestAlwaysAuthorization]. Se chiami questo metodo e l'app non ha lo stato di autorizzazione corretto, il callback verrà chiamato con un errore.

Parametri:

callback Il callback da richiamare con l'elenco di probabilità di luogo.

- (void) findAutocompletePredictionsFromQuery:	(NSString *)	query
filtro:	(GMSAutocompleteFilter con valore nullo *)	filtro
sessioneToken:	(GMSAutocompleteSessionToken nullabile *)	sessionToken
di chiamata:	(GMSAutocompletePredictionsCallback)	callback

Trova le previsioni di completamento automatico da una query di testo.

I risultati possono facoltativamente essere differenziati per una determinata località o limitati a un'area. Questo metodo non blocca.

Il callback fornito verrà richiamato con un array di previsioni di completamento automatico in caso di esito positivo e un errore NSError in caso di errore.

Parametri:

query	Il testo parziale da completare automaticamente.
filter	Il filtro da applicare ai risultati. Questo parametro potrebbe essere nullo.
sessionToken	Il `GMSAutocompleteSessionToken` per associare la richiesta a una sessione di fatturazione.
callback	Il callback da richiamare con le previsioni.

- (void) fetchPlaceFromPlaceID:	(NSString *)	placeID
campi del luogo:	(GMSPlaceField)	placeFields
sessioneToken:	(GMSAutocompleteSessionToken nullabile *)	sessionToken
di chiamata:	(GMSPlaceResultCallback)	callback

Recupero dei dettagli di un luogo.

Questo metodo non blocca.

Parametri:

placeID	L'ID del luogo da cercare.
placeFields	I singoli campi luogo richiesti per gli oggetti luogo nell'elenco.
sessionToken	Il `GMSAutocompleteSessionToken` per associare la richiesta a una sessione di fatturazione.
callback	Il callback da richiamare con il risultato della ricerca.

- (void) findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:	(GMSPlaceField)	placeFields
di chiamata:	(GMSPlaceLikelihoodsCallback)	callback

Individua le probabilità di luogo utilizzando la posizione corrente dell'utente.

Questo metodo non blocca.

Il callback fornito verrà richiamato con un array di posizioni con punteggi di probabilità in caso di esito positivo e un NSError in caso di errore.

Parametri:

placeFields	I singoli campi luogo richiesti per gli oggetti luogo nell'elenco.
callback	Il callback da richiamare con le probabilità di luogo.

- (void) isOpenWithPlaceID:	(NSString *)	placeID
di chiamata:	(GMSPlaceOpenStatusCallback)	callback

Recupera i dettagli di un luogo, inclusi tutti i campi necessari per determinare il valore GMSPlaceOpenStatus al momento attuale.

Questo metodo non blocca.

Parametri:

placeID	L'ID del luogo da cercare.
callback	Il callback da richiamare con il risultato del luogo.

- (void) isOpenWithPlaceID:	(NSString *)	placeID
Data:	(NSDate *)	date
di chiamata:	(GMSPlaceOpenStatusCallback)	callback

Recupera i dettagli di un luogo, inclusi tutti i campi necessari per determinare GMSPlaceOpenStatus nel NSDate specificato.

Questo metodo non blocca.

Parametri:

placeID	L'ID del luogo da cercare.
date	Il `NSDate` per cui determinare lo stato di apertura.
callback	Il callback da richiamare con il risultato del luogo.

- (void) isOpenWithPlace:	(GMSPlace *)	luogo
di chiamata:	(GMSPlaceOpenStatusCallback)	callback

Recupera i dettagli di un luogo, inclusi tutti i campi necessari per determinare il valore GMSPlaceOpenStatus al momento attuale.

Richiede campi aggiuntivi solo se GMSPlace non dispone di tutti i campi necessari, altrimenti viene restituito immediatamente il valore GMSPlaceOpenStatus nel callback. Questo metodo non blocca.

Parametri:

posto	Il `GMSPlace` da cercare.
callback	Il callback da richiamare con il risultato del luogo.

- (void) isOpenWithPlace:	(GMSPlace *)	luogo
Data:	(NSDate *)	date
di chiamata:	(GMSPlaceOpenStatusCallback)	callback

Recupera i dettagli di un luogo, inclusi tutti i campi necessari per determinare GMSPlaceOpenStatus nel NSDate specificato.

Richiede campi aggiuntivi solo se GMSPlace non dispone di tutti i campi necessari, altrimenti viene restituito immediatamente il valore GMSPlaceOpenStatus nel callback. Questo metodo non blocca.

Parametri:

posto	Il `GMSPlace` da cercare.
date	Il `NSDate` per cui determinare lo stato di apertura.
callback	Il callback da richiamare con il risultato del luogo.

- (void) searchByTextWithRequest:	(GMSPlaceSearchByTextRequest *)	textSearchRequest
di chiamata:	(GMSPlaceSearchByTextResultCallback)	callback

Cerca luoghi in base al testo e alle limitazioni.

Questo metodo non blocca.

Parametri:

textSearchRequest	`GMSPlaceSearchByTextRequest` La richiesta di testo da utilizzare per la query.
callback	Il callback da richiamare con il risultato della ricerca.

- (typedef void(^ GMSPlaceResultCallback)(GMSPlace *_Nullable result, NSError *_Nullable error)) [related]

Tipo di callback per ricevere ricerche dei dettagli del luogo.

Se si è verificato un errore, result sarà nullo e error conterrà le informazioni relative all'errore.

Parametri:

risultato	Il valore `GMSPlace` restituito.
errore	L'errore che si è verificato, se presente.

- (typedef void(^ GMSPlaceLikelihoodListCallback)(GMSPlaceLikelihoodList *_Nullableapplicabile, NSError *_Errore nullable)) [related]

Tipo di callback per la ricezione di elenchi di probabilità di luoghi.

Se si è verificato un errore, likelihoodList sarà nullo e error conterrà le informazioni relative all'errore.

Parametri:

likelihoodList	L'elenco delle probabilità di un luogo.
errore	L'errore che si è verificato, se presente.

- (typedef void(^ GMSPlaceLikelihoodsCallback)(NSArray< GMSPlaceLikelihood * > *_Probabilità di null, NSError *_Errore nullable)) [related]

Tipo di callback per la ricezione di array di GMSPlaceLikelihood.

Se si è verificato un errore, l'array sarà nullo e error conterrà le informazioni sull'errore.

- (typedef void(^ GMSAutocompletePredictionsCallback)(NSArray< GMSAutocompletePrediction * > *_Nullable results, NSError *_Nullable error)) [related]

Tipo di callback per la ricezione dei risultati del completamento automatico.

results è un array di GMSAutocompletePredictions che rappresenta i completamenti candidati della query.

Parametri:

risultati	Un array di `GMSAutocompletePrediction`.
errore	L'errore che si è verificato, se presente.

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

Tipo di callback per ricevere risultati relativi alle foto dei luoghi.

Se si è verificato un errore, photos sarà nullo e error conterrà le informazioni relative all'errore.

Parametri:

foto	Il risultato contiene `GMSPlacePhotoMetadata` oggetti.
errore	L'errore che si è verificato, se presente.

- (typedef void(^ GMSPlacePhotoImageResultCallback)(UIImage *_Foto Nullable, NSError *_Errore Nullable)) [related]

Tipo di callback per ricevere oggetti UIImage da un oggetto GMSPlacePhotoMetadata.

Se si è verificato un errore, photo sarà nullo e error conterrà le informazioni relative all'errore.

Parametri:

foto	Il `UIImage` che è stato caricato.
errore	L'errore che si è verificato, se presente.

- (typedef void(^ GMSPlaceOpenStatusCallback)(risultato GMSPlaceOpenStatus, errore *_nullable NSError)) [related]

Tipo di callback per ricevere lo stato dell'orario di apertura del luogo.

Se si è verificato un errore, result sarà GMSPlaceOpenStatusUnknown, mentre error conterrà le informazioni relative all'errore.

Parametri:

risultato	Il valore `GMSPlaceOpenStatus` restituito.
errore	L'errore che si è verificato, se presente.

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

Tipo di callback per ricevere risultati di ricerca tramite testo.

results è un array di GMSPlace che rappresenta i singoli risultati corrispondenti alla query.

Parametri:

risultati	Un array di `GMSPlace`.
errore	L'errore che si è verificato, se presente.

Riferimento classe GMS PlacesClient

Panoramica

Funzioni pubbliche dei membri

Funzioni pubbliche statiche dei membri

Funzioni correlate

Documentazione sulle funzioni dei membri

Documentazione relativa ad amici e funzioni correlate