Riferimento classe GMS PlacesClient


Panoramica

Interfaccia principale dell'SDK Places.

Utilizzato per cercare e ottenere dettagli 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 non definito. Se non diversamente specificato, tutti i callback verranno richiamati nel thread principale.

Funzioni pubbliche dei membri

(void) - lookUpPlaceID:callback:
 Visualizzare i dettagli di un luogo.
(void) - lookUpPhotosForPlaceID:callback:
 Consente di ottenere i metadati per un massimo di 10 foto associate a un luogo.
(void) - loadPlacePhoto:callback:
 Carica l'immagine di una foto specifica alle dimensioni massime.
(void) - loadPlacePhoto:constrainedToSize:scale:callback:
 Carica l'immagine di una foto specifica, ridimensionata per adattarsi alle dimensioni massime specificate.
(void) - currentPlaceWithCallback:
 Restituisce una stima del luogo in cui è attualmente noto che il dispositivo si trova.
(void) - findAutocompletePredictionsFromQuery:filter:sessionToken:callback:
 Trovare le previsioni di completamento automatico dalla query di testo.
(void) - fetchPlaceFromPlaceID:placeFields:sessionToken:callback:
 Recupera i dettagli di un luogo.
(void) - findPlaceLikelihoodsFromCurrentLocationWithPlaceFields:callback:
 Trova la probabilità di un luogo utilizzando la posizione corrente dell'utente.
(void) - isOpenWithPlaceID:callback:
 Recupera i dettagli di un luogo, inclusi tutti i campi necessari per determinare GMSPlaceOpenStatus al momento attuale.
(void) - isOpenWithPlaceID:date:callback:
 Recupera i dettagli di un luogo, inclusi tutti i campi necessari per determinare GMSPlaceOpenStatus in corrispondenza del NSDate specificato.
(void) - isOpenWithPlace:callback:
 Recupera i dettagli di un luogo, inclusi tutti i campi necessari per determinare GMSPlaceOpenStatus al momento attuale.
(void) - isOpenWithPlace:date:callback:
 Recupera i dettagli di un luogo, inclusi tutti i campi necessari per determinare GMSPlaceOpenStatus in corrispondenza del NSDate specificato.

Funzioni membri pubbliche statiche

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

typedef void(^ GMSPlaceResultCallback )(GMSPlace *_Nullable result, NSError *_Nullable error)
 Tipo di callback per ricevere ricerche dei dettagli dei luoghi.
typedef void(^ GMSPlaceLikelihoodListCallback )(GMSPlaceLikelihoodList *_Nullable rinomatoList, NSError *_Nullable error)
 Tipo di richiamata per la ricezione di elenchi di probabilità di luogo.
typedef void(^ GMSPlaceLikelihoodsCallback )(NSArray< GMSPlaceLikelihood * > *_probabilità Nullable, NSError *_errore Nullable)
 Tipo di callback per ricezione array di GMSPlaceLikelihood.
typedef void(^ GMSAutocompletePredictionsCallback )(NSArray< GMSAutocompletePrediction * > *_Nullable results, NSError *_Nullable error)
 Tipo di callback per ricevere risultati del completamento automatico.
typedef void(^ GMSPlacePhotoMetadataResultCallback )(GMSPlacePhotoMetadataList *_Nullable photos, NSError *_Nullable error)
 Tipo di callback per ricevere risultati di foto di 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)
 Tipo di richiamata per la ricezione dello stato dell'orario di apertura del luogo.

Documentazione sulle funzioni membri

+ (instancetype) sharedClient

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

Se l'applicazione utilizza spesso i metodi di GMSPlacesClient, è consigliabile mantenere 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 della piattaforma Google Cloud ed è associata all'ID pacchetto dell'applicazione per identificarla. Dovrebbe essere chiamato dall'applicazione prima di utilizzare GMSPlacesClient (ad es. 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 di 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
da richiamare: (GMSPlaceResultCallback) richiamata

Visualizzare i dettagli di un luogo.

Questo metodo non blocca.

Parametri:
placeIDL'ID del luogo da cercare.
callbackIl callback da richiamare con il risultato della ricerca.
- (void) lookUpPhotosForPlaceID: (NSString *) placeID
da richiamare: (GMSPlacePhotoMetadataResultCallback) richiamata

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

Le foto provengono da vari luoghi, tra cui i proprietari di attività e le foto fornite dagli utenti di Google+. Nella maggior parte dei casi, queste foto possono essere utilizzate senza attribuzione o avranno l'attribuzione richiesta inclusa all'interno dell'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.

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

Questo metodo esegue una ricerca di rete.

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

Carica l'immagine di una foto specifica alle dimensioni massime.

I dati delle immagini possono 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
vinedToSize: (CGSize) maxSize
scala: (CGFloat) scala
da richiamare: (GMSPlacePhotoImageResultCallback) richiamata

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

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

Se il parametro di 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 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 superiore alle dimensioni massime disponibili, potrebbe essere restituita un'immagine più piccola.
Parametri:
photoMetadataIl GMSPlacePhotoMetadata per cui caricare un UIImage.
maxSizeLa dimensione massima dell'immagine.
scalabilitàLa scala in cui caricare l'immagine.
callbackIl callback da richiamare con il UIImage caricato.

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

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

Nota:
Questo metodo richiede che la tua app abbia l'autorizzazione ad 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 la tua app non ha lo stato di autorizzazione corretto, il callback verrà chiamato con un errore.
Parametri:
callbackIl callback da richiamare con l'elenco di probabilità dei luoghi.
- (void) findAutocompletePredictionsFromQuery: (NSString *) query
filtro: (GMSAutocompleteFilter* nullable) filtro
sessionToken: (GMSAutocompleteSessionToken nullabile *) sessionToken
da richiamare: (GMSAutocompletePredictionsCallback) richiamata

Trovare le previsioni di completamento automatico dalla 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:
queryIl testo parziale da completare automaticamente.
filterIl filtro da applicare ai risultati. Questo parametro potrebbe essere nullo.
sessionTokenIl GMSAutocompleteSessionToken per associare la richiesta a una sessione di fatturazione.
callbackIl callback da richiamare con le previsioni.
- (void) fetchPlaceFromPlaceID: (NSString *) placeID
campi: (GMSPlaceField) placeFields
sessionToken: (GMSAutocompleteSessionToken nullabile *) sessionToken
da richiamare: (GMSPlaceResultCallback) richiamata

Recupera i dettagli di un luogo.

Questo metodo non blocca.

Parametri:
placeIDL'ID del luogo da cercare.
placeFieldsI singoli campi luogo richiesti per gli oggetti luogo nell'elenco.
sessionTokenIl GMSAutocompleteSessionToken per associare la richiesta a una sessione di fatturazione.
callbackIl callback da richiamare con il risultato della ricerca.
- (void) findPlaceLikelihoodsFromCurrentLocationWithPlaceFields: (GMSPlaceField) placeFields
da richiamare: (GMSPlaceLikelihoodsCallback) richiamata

Trova la 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 errore NSError in caso di errore.

Parametri:
placeFieldsI singoli campi luogo richiesti per gli oggetti luogo nell'elenco.
callbackIl callback da richiamare con le probabilità di luogo.
- (void) isOpenWithPlaceID: (NSString *) placeID
da richiamare: (GMSPlaceOpenStatusCallback) richiamata

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

Questo metodo non blocca.

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

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

Questo metodo non blocca.

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

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

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

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

Recupera i dettagli di un luogo, inclusi tutti i campi necessari per determinare GMSPlaceOpenStatus in corrispondenza del 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.


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

Tipo di callback per ricevere ricerche dei dettagli dei luoghi.

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

Parametri:
risultatoIl valore GMSPlace restituito.
erroreL'errore che si è verificato, se presente.
- (typedef void(^ GMSPlaceLikelihoodListCallback)(GMSPlaceLikelihoodList *_Nullable ReadinessList, NSError *_Nullable error)) [related]

Tipo di richiamata per la ricezione di elenchi di probabilità di luogo.

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

Parametri:
likelihoodListL'elenco delle probabilità di luogo.
erroreL'errore che si è verificato, se presente.
- (typedef void(^ GMSPlaceLikelihoodsCallback)(NSArray< GMSPlaceLikelihood * > *_Nullable probabilitàs, NSError *_Nullable error)) [related]

Tipo di callback per ricezione array di GMSPlaceLikelihood.

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

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

Tipo di callback per ricevere risultati del completamento automatico.

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

Parametri:
risultatiUn array di GMSAutocompletePrediction.
erroreL'errore che si è verificato, se presente.
- (typedef void(^ GMSPlacePhotoMetadataResultCallback)(GMSPlacePhotoMetadataList *_Nullable photos, NSError *_Nullable error)) [related]

Tipo di callback per ricevere risultati di foto di luoghi.

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

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

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

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

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

Tipo di richiamata per la ricezione dello stato dell'orario di apertura del luogo.

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

Parametri:
risultatoIl valore GMSPlaceOpenStatus restituito.
erroreL'errore che si è verificato, se presente.