Riferimento classe GMS PlacesClient


Panoramica

Interfaccia principale dell'SDK Places.

Utilizzato per cercare e ottenere informazioni dettagliate sui luoghi. È possibile accedere a questa classe 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 sul thread principale.

Funzioni per i membri pubbliche

(nullo)- lookUpPlaceID:callback:
 Visualizza i dettagli di un luogo.
(nullo)- fetchAutocompleteSuggestionsFromRequest:callback:
 Trovare i suggerimenti di completamento automatico dalla query di testo.
(nullo)- lookUpPhotosForPlaceID:callback:
 Consente di recuperare i metadati di un massimo di 10 foto associate a un luogo.
(nullo)- loadPlacePhoto:callback:
 Carica l'immagine per una foto specifica alle sue dimensioni massime.
(nullo)- loadPlacePhoto:constrainedToSize:scale:callback:
 Carica l'immagine per una foto specifica, ridimensionata per adattarsi alle dimensioni massime specificate.
(nullo)- currentPlaceWithCallback:
 Restituisce una stima del luogo in cui è attualmente nota la posizione del dispositivo.
(nullo)- findAutocompletePredictionsFromQuery:filter:sessionToken:callback:
 Trova le previsioni di completamento automatico dalla query di testo.
(nullo)- fetchPlaceFromPlaceID:placeFields:sessionToken:callback:
 Recupera i dettagli di un luogo.
(nullo)- findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:callback:
 Trova le probabilità di un luogo utilizzando la posizione corrente dell'utente.
(nullo)- isOpenWithRequest:callback:
 Recupera lo stato di apertura di un luogo.
(nullo)- isOpenWithPlaceID:callback:
 Recupera i dettagli di un luogo, inclusi tutti i campi necessari per determinare GMSPlaceOpenStatus all'ora attuale.
(nullo)- isOpenWithPlaceID:date:callback:
 Recupera i dettagli di un luogo, inclusi tutti i campi necessari per determinare GMSPlaceOpenStatus per il valore NSDate specificato.
(nullo)- isOpenWithPlace:callback:
 Recupera i dettagli di un luogo, inclusi tutti i campi necessari per determinare GMSPlaceOpenStatus all'ora corrente.
(nullo)- isOpenWithPlace:date:callback:
 Recupera i dettagli di un luogo, inclusi tutti i campi necessari per determinare GMSPlaceOpenStatus per il valore NSDate specificato.
(nullo)- searchByTextWithRequest:callback:
 Cerca i luoghi per testo e restrizioni.
(nullo)- fetchPlaceWithRequest:callback:
 Recupera un luogo utilizzando un oggetto di richiesta.
(nullo)- fetchPhotoWithRequest:callback:
 Richiedi una foto utilizzando la richiesta di recupero foto.
(nullo)- searchNearbyWithRequest:callback:
 Cercare luoghi nelle vicinanze di una località e di una restrizione.

Funzioni membro pubbliche statiche

(instancetype)+ sharedClient
 Fornisce l'istanza condivisa di GMSPlacesClient per l'SDK Google Places per iOS, creandola se necessario.
(BOOL)+ fornireAPIKey:
 Fornisce la chiave API all'SDK Google Places per iOS.
(NSString *)+ openSourceLicenseInfo
 Restituisce le informazioni sulla licenza del 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.

Tieni presente che non si tratta di funzioni relative ai membri.

typedef void(^GMSPlaceResultCallback)(Risultato GMSPlace *_Nullable, errore NSError *_Nullable)
 Tipo di callback per ricevere ricerche di dettagli del luogo.
typedef void(^GMSPlaceLikelihoodListCallback)(GMSPlaceLikelihoodList *_Nullable evaluateList, NSError *_Errore Nullable)
 Tipo di callback per ricevere elenchi di probabilità dei luoghi.
typedef void(^GMSPlaceLikelihoodsCallback )(NSArray< GMSPlaceLikelihood * > *_Nullable probabili, NSError *_Nullable errore)
 Tipo di callback per ricevere array di GMSPlaceLikelihood.
typedef void(^GMSAutocompletePredictionsCallback)(NSArray< GMSAutocompletePrediction * > *_Nullable risultati, NSError *_Nullable errore)
 Tipo di callback per ricevere i 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 nullabile, NSError *_errore Nullable)
 Tipo di callback per ricevere UIImage oggetti da un oggetto GMSPlacePhotoMetadata.
typedef void(^GMSPlaceOpenStatusCallback)(risultato GMSPlaceOpenStatus, errore NSError *_Nullable)
 Tipo di callback per ricevere lo stato dell'orario di apertura di questa attività.
typedef void(^GMSPlaceOpenStatusResponseCallback)(GMSPlaceIsOpenResponse *response, NSError *_Nullable errore)
 Tipo di callback per ricevere la risposta dello stato di apertura.
typedef void(^GMSPlaceSearchByTextResultCallback)(NSArray< GMSPlace * > *_Nullable places, NSError *_Nullable errore)
 Tipo di callback per ricevere risultati di ricerca tramite testo.
typedef void(^GMSFetchPhotoResultCallback)(UIImage *_Nullable photoImage, NSError *_errore Nullable)
 Tipo di callback per ricevere una foto.
typedef void(^GMSAutocompleteSuggestionsCallback)(NSArray< GMSAutocompleteSuggestion * > *_Nullable risultati, NSError *_Nullable errore)
 Tipo di callback per i risultati del completamento automatico.
typedef void(^GMSPlaceSearchNearbyResultCallback)(NSArray< GMSPlace * > *_Nullable places, NSError *_Nullable errore)
 Tipo di callback per ricevere risultati di ricerca nelle vicinanze.

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, potrebbe essere opportuno conservare direttamente questo oggetto, altrimenti la connessione a Google potrebbe essere riavviata regolarmente.

+ (BOOL) ProvideAPIKey: (NSString *) chiave

Fornisce la chiave API all'SDK Google Places per iOS.

Questa chiave viene generata per l'applicazione tramite la console di Google Cloud Platform ed è abbinata all'ID pacchetto dell'applicazione per identificarla. Questa operazione dovrebbe essere chiamata dall'applicazione prima di utilizzare GMSPlacesClient (ad es. in application:didFinishLaunchingWithOptions:).

Resi:
SÌ se la chiave API è stata fornita correttamente.
+ (NSString *) openSourceLicenseInfo

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

Queste informazioni devono essere rese disponibili nella tua applicazione.

+ (NSString *) SDKVersion

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

di Google. Ad esempio, "1.0.0".

+ (NSString *) SDKLongVersion

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

di Google. Ad esempio, "1.0.0 (102.1)".

- (void) lookUpPlaceID: (NSString *) placeID
callback: (GMSPlaceResultCallback) richiamata

Visualizza i dettagli di un luogo.

Questo metodo non blocca.

Parametri:
placeIDL'ID luogo da cercare.
callbackIl callback da richiamare con il risultato della ricerca.
Nota:
Questa strategia è deprecata. Questo metodo è stato sostituito da fetchPlaceWithRequest:callback: e verrà rimosso in una release futura.
- (void) fetchAutocompleteSuggestionsFromRequest: (Non riuscito) fetchAutocompleteSuggestionsFromRequest: (GMSAutocompleteRequest *) richiesta
callback: (GMSAutocompleteSuggestionsCallback) richiamata

Trovare i suggerimenti di completamento automatico dalla query di testo.

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

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

Parametri:
richiestaLa richiesta GMSAutocompleteRequest per il completamento automatico.
callbackIl callback da richiamare con i suggerimenti.
- (void) lookUpPhotosForPlaceID: (NSString *) placeID
callback: (GMSPlacePhotoMetadataResultCallback) richiamata

Consente di recuperare i metadati di un massimo di 10 foto associate a un luogo.

Le foto provengono da diverse posizioni, tra cui proprietari di attività e foto fornite da utenti di Google+. Nella maggior parte dei casi, queste foto possono essere utilizzate senza attribuzione o all'interno dell'immagine dovranno essere incluse le attribuzioni richieste. Tuttavia, devi utilizzare la proprietà attributions nella risposta per recuperare eventuali attribuzioni aggiuntive richieste e visualizzarle nell'applicazione ovunque mostri l'immagine. Vengono restituite al massimo 10 foto.

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

Questo metodo esegue una ricerca di rete.

Parametri:
placeIDL'ID luogo per il quale cercare le foto.
callbackIl callback da richiamare con il risultato della ricerca.
- (void) loadPlacePhoto: (GMSPlacePhotoMetadata *) photoMetadata
callback: (GMSPlacePhotoImageResultCallback) richiamata

Carica l'immagine per una foto specifica alle sue dimensioni massime.

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

Parametri:
photoMetadataIl GMSPlacePhotoMetadata per cui caricare un UIImage.
callbackIl callback da richiamare con il UIImage caricato.
- (void) loadPlacePhoto: (GMSPlacePhotoMetadata *) photoMetadata
constrainedToSize: (CGSize) maxSize
scala: (CGFloat) scalabilità
callback: (GMSPlacePhotoImageResultCallback) richiamata

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

L'immagine verrà ridimensionata per adattarsi alle dimensioni date, mantenendo le proporzioni dell'immagine originale. La 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 potrebbero essere memorizzati nella cache dall'SDK. Se la foto richiesta non esiste nella cache, verrà eseguita una ricerca di rete.

Nota:
Dopo aver applicato il fattore di scala, le dimensioni in maxSize verranno arrotondate 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:
photoMetadataIl GMSPlacePhotoMetadata per cui caricare un UIImage.
maxSizeLe dimensioni massime dell'immagine.
scalabilitàLa scala su cui caricare l'immagine.
callbackIl callback da richiamare con il UIImage caricato.

Restituisce una stima del luogo in cui è attualmente nota la posizione del dispositivo.

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

Nota:
Questo metodo richiede che la tua app abbia l'autorizzazione per accedere alla posizione attuale del dispositivo. Prima di chiamare questo utente, assicurati di richiedere l'accesso alla posizione dell'utente utilizzando [CLLocationManager requestWhenInUseAuthorization] o [CLLocationManager request AlwaysAuthorization]. Se chiami questo metodo e la tua app non presenta lo stato di autorizzazione corretto, il callback verrà chiamato con un errore.
.
Parametri:
callbackIl callback da richiamare con l'elenco delle probabilità di un luogo.
- (void) FindAutocompletePredictionsFromQuery: (NSString *) query
filtro: (GMSAutocompleteFilter con valore nullo *) filtro
sessionToken: (GMSAutocompleteSessionToken selezionabile con valore nullo *) sessionToken
callback: (GMSAutocompletePredictionsCallback) richiamata

Trova le previsioni di completamento automatico dalla query di testo.

I risultati possono essere facoltativamente orientati a 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 NSError in caso di errore.

Parametri:
queryIl testo parziale da completare automaticamente.
filtroIl filtro da applicare ai risultati. Questo parametro può essere nullo.
sessionTokenIl GMSAutocompleteSessionToken da associare alla richiesta a una sessione di fatturazione.
callbackIl callback da richiamare con le previsioni.
- (void) fetchPlaceFromPlaceID: (NSString *) placeID
Campi luogo: (GMSPlaceField) placeFields
sessionToken: (GMSAutocompleteSessionToken selezionabile con valore nullo *) sessionToken
callback: (GMSPlaceResultCallback) richiamata

Recupera i dettagli di un luogo.

Questo metodo non blocca.

Parametri:
placeIDL'ID luogo da cercare.
placeFieldsI singoli campi del luogo richiesti per gli oggetti luogo nell'elenco.
sessionTokenIl GMSAutocompleteSessionToken da associare alla richiesta a una sessione di fatturazione.
callbackIl callback da richiamare con il risultato della ricerca.
Nota:
Questa strategia è deprecata. Questo metodo è stato sostituito da fetchPlaceWithRequest:callback: callback: e verrà rimosso in una release futura.
- (void) Find PlaceLikelihoodsFromCurrentLocationWithPlaceFields: (GMSPlaceField) placeFields
callback: (GMSPlaceLikelihoodsCallback) richiamata

Trova le probabilità di un 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:
placeFieldsI singoli campi del luogo richiesti per gli oggetti luogo nell'elenco.
callbackIl callback da attivare con le probabilità di posizionamento.
- (void) isOpenWithRequest: (GMSPlaceIsOpenRequest *) isOpenRequest
callback: (GMSPlaceOpenStatusResponseCallback) richiamata

Restituisce lo stato aperto di un luogo, incluse tutte le proprietà necessarie per determinare GMSPlaceOpenStatus al NSDate specificato. Questo metodo non blocca.

Parametri:
isOpenRequestLa richiesta per determinare lo stato di apertura di un determinato luogo.
callbackIl callback da attivare con la risposta dello stato aperto.
- (void) isOpenWithPlaceID: (NSString *) placeID
callback: (GMSPlaceOpenStatusCallback) richiamata

Visualizza lo stato aperto per un luogo, inclusi tutti i campi necessari per determinare GMSPlaceOpenStatus all'ora attuale.

Questo metodo non blocca.

Parametri:
placeIDL'ID luogo da cercare.
callbackIl callback da richiamare con il risultato del luogo.
- (void) isOpenWithPlaceID: (NSString *) placeID
Data: (NSDate *) date
callback: (GMSPlaceOpenStatusCallback) richiamata

Restituisce lo stato aperto per un luogo, inclusi tutti i campi necessari per determinare GMSPlaceOpenStatus per il NSDate specificato.

Questo metodo non blocca.

Parametri:
placeIDL'ID luogo da cercare.
dataIl NSDate per cui determinare lo stato di apertura.
callbackIl callback da richiamare con il risultato del luogo.
- (void) isOpenWithPlace: (GMSPlace *) luogo
callback: (GMSPlaceOpenStatusCallback) richiamata

Visualizza lo stato aperto per un luogo, inclusi tutti i campi necessari per determinare GMSPlaceOpenStatus all'ora attuale.

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

Parametri:
postoGMSPlace da cercare.
callbackIl callback da richiamare con il risultato del luogo.
- (void) isOpenWithPlace: (GMSPlace *) luogo
Data: (NSDate *) date
callback: (GMSPlaceOpenStatusCallback) richiamata

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

Richiede campi aggiuntivi solo se GMSPlace non dispone di tutti i campi necessari, altrimenti GMSPlaceOpenStatus\ will be returned in the callback immediately. This method is non-blocking.

Parameters:
placeThe GMSPlace to lookup.
dateThe NSDate to determine open status for.
callbackThe callback to invoke with the place result.

- (void) searchByTextWithRequest: (GMSPlaceSearchByTextRequest *) textSearchRequest
callback: (GMSPlaceSearchByTextResultCallback) richiamata

Cerca i luoghi per testo e restrizioni.

Questo metodo non blocca.

Parametri:
textSearchRequestGMSPlaceSearchByTextRequest La richiesta di testo da utilizzare per la query.
callbackIl callback da richiamare con il risultato della ricerca.
- (void) fetchPlaceWithRequest: (GMSFetchPlaceRequest *) fetchPlaceRequest
callback: (GMSPlaceResultCallback) richiamata

Recupera un luogo utilizzando un oggetto di richiesta.

Questo metodo non blocca.

Parametri:
fetchPlaceRequestGMSFetchPlaceRequest La richiesta di recupero del luogo da utilizzare per la query.
callbackIl callback da richiamare con il risultato del luogo.
- (void) fetchPhotoWithRequest: (GMSFetchPhotoRequest *) fetchPhotoRequest
callback: (GMSFetchPhotoResultCallback) richiamata

Richiedi una foto utilizzando la richiesta di recupero foto.

Questo metodo non blocca.

Parametri:
fetchPhotoRequestGMSFetchPhotoRequest La foto richiesta da utilizzare.
callbackIl callback da richiamare con il risultato NSURL.
- (void) searchNearbyWithRequest: (GMSPlaceSearchNearbyRequest *) searchNearbyRequest
callback: (GMSPlaceSearchNearbyResultCallback) richiamata

Cercare luoghi nelle vicinanze di una località e di una restrizione.

Questo metodo non blocca.

Parametri:
searchNearbyRequestGMSPlaceSearchNearbyRequest La richiesta di ricerca nelle vicinanze da utilizzare per la query.
callbackIl callback da richiamare con il risultato della ricerca.

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

Tipo di callback per ricevere ricerche di dettagli del luogo.

Se si è verificato un errore, il valore result sarà nullo e error conterrà le informazioni sull'errore.

Parametri:
risultatoL'oggetto GMSPlace che è stato restituito.
erroreL'eventuale errore che si è verificato.
- (typedef void(^ GMSPlaceLikelihoodListCallback)(GMSPlaceLikelihoodList *_Nullable disapprovalList, NSError *_Nullable error)) [related]

Tipo di callback per ricevere elenchi di probabilità dei luoghi.

Se si è verificato un errore, il valore likelihoodList sarà nullo e error conterrà le informazioni sull'errore.

Parametri:
likelihoodListL'elenco delle probabilità dei luoghi.
erroreL'eventuale errore che si è verificato.
- (typedef void(^ GMSPlaceLikelihoodsCallback)(NSArray< GMSPlaceLikelihood * > *_probabilità Nullable, NSError *_errore Nullable)) [related]

Tipo di callback per ricevere 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 risultati, NSError *_Nullable errore)) [related]

Tipo di callback per ricevere i risultati del completamento automatico.

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

Parametri:
risultatiUn array di GMSAutocompletePrediction.
erroreL'eventuale errore che si è verificato.
- (typedef void(^ GMSPlacePhotoMetadataResultCallback)(GMSPlacePhotoMetadataList *_Foto Nullable, NSError *_errore nullabile)) [related]

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

Se si è verificato un errore, il valore photos sarà nullo e error conterrà le informazioni sull'errore.

Parametri:
fotoIl risultato contiene GMSPlacePhotoMetadata oggetti.
erroreL'eventuale errore che si è verificato.
- (typedef void(^ GMSPlacePhotoImageResultCallback)(UIImage *_Nullable photo, NSError *_Nullable error)) [related]

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

Se si è verificato un errore, il valore photo sarà nullo e error conterrà le informazioni sull'errore.

Parametri:
fotoL'elemento UIImage che è stato caricato.
erroreL'eventuale errore che si è verificato.
- (typedef void(^ GMSPlaceOpenStatusCallback)(risultato GMSPlaceOpenStatus, NSError *_Nullable errore)) [related]

Tipo di callback per ricevere lo stato dell'orario di apertura di questa attività.

Se si è verificato un errore, result sarà GMSPlaceOpenStatusUnknown e error conterrà informazioni sull'errore.

Parametri:
risultatoL'oggetto GMSPlaceOpenStatus che è stato restituito.
erroreL'eventuale errore che si è verificato.
- (typedef void(^ GMSPlaceOpenStatusResponseCallback)(GMSPlaceIsOpenResponse *response, NSError *_Nullable errore)) [related]

Tipo di callback per ricevere la risposta dello stato di apertura.

Se si è verificato un errore, la risposta avrà lo stato GMSPlaceOpenStatusUnknown e l'errore conterrà informazioni sull'errore.

Parametri:
rispostaL'oggetto GMSPlaceIsOpenResponse che è stato restituito.
erroreL'eventuale errore che si è verificato.
- (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:
risultatiUn array di GMSPlace.
erroreL'eventuale errore che si è verificato.
- (typedef void(^ GMSFetchPhotoResultCallback)(UIImage *_Nullable photoImage, NSError *_errore Nullable)) [related]

Tipo di callback per ricevere una foto.

photoImage è un UIImage che rappresenta la foto risultante corrispondente alla richiesta specificata. Se si è verificato un errore, il valore photoImage sarà nullo e error conterrà le informazioni sull'errore.

Parametri:
photoImageUn risultato di UIImage.
- (typedef void(^ GMSAutocompleteSuggestionsCallback)(NSArray< GMSAutocompleteSuggestion * > *_Nullable results, NSError *_Nullable error)) [related]

Tipo di callback per i risultati del completamento automatico.

Parametri:
risultatiUn array di GMSAutocompleteSuggestion.
erroreL'eventuale errore che si è verificato.
- (typedef void(^ GMSPlaceSearchNearbyResultCallback)(NSArray< GMSPlace * > *_Nullable places, NSError *_Nullable error)) [related]

Tipo di callback per ricevere risultati di ricerca nelle vicinanze.

Parametri:
luoghiUn array di GMSPlace
erroreL'eventuale errore che si è verificato.