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) | - fetchAutocompleteSuggestionsFromRequest:callback: |
Trova i suggerimenti di completamento automatico da una query di testo. | |
(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. | |
(void) | - fetchPlaceWithRequest:callback: |
Ottieni un luogo utilizzando un oggetto di richiesta. | |
(void) | - fetchPhotoWithRequest:callback: |
Richiedi una foto utilizzando la richiesta di recupero foto. | |
(void) | - searchNearbyWithRequest:callback: |
Cerca luoghi nelle vicinanze di una località e di una restrizione. | |
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. | |
typedef void(^ | GMSFetchPhotoResultCallback)(UIImage *_Nullable photoImage, NSError *_Nullable errore) |
Tipo di callback per ricevere una foto. | |
typedef void(^ | GMSAutocompleteSuggestionsCallback )(NSArray< GMSAutocompleteSuggestion * > *_Nullable results, NSError *_Nullable error) |
Tipo di callback per i risultati del completamento automatico. | |
typedef void(^ | GMSPlaceSearchNearbyResultCallback )(NSArray< GMSPlace * > *_Nullable places, NSError *_Nullable error) |
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, è 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.
- Nota:
- Questo campo è stato ritirato. Questo metodo è stato sostituito da
fetchPlaceWithRequest:callback:
e verrà rimosso in una release futura.
- (void) fetchAutocompleteSuggestionsFromRequest: | (GMSAutocompleteRequest *) | richiesta | |
di chiamata: | (GMSAutocompleteSuggestionsCallback) | callback | |
Trova i suggerimenti 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 suggerimenti di completamento automatico in caso di esito positivo e un errore NSError in caso di errore.
- Parametri:
-
richiesta La richiesta GMSAutocompleteRequest
per il completamento automatico.callback Il callback da richiamare con i suggerimenti.
- (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 unUIImage
.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 unUIImage
.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. filtra 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.
- Nota:
- Questo campo è stato ritirato. Questo metodo è stato sostituito da
fetchPlaceWithRequest:callback: callback:
e verrà rimosso in una release futura.
- (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. data 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 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 | |
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.
- (void) fetchPlaceWithRequest: | (GMSFetchPlaceRequest *) | fetchPlaceRequest | |
di chiamata: | (GMSPlaceResultCallback) | callback | |
Ottieni un luogo utilizzando un oggetto di richiesta.
Questo metodo non blocca.
- Parametri:
-
fetchPlaceRequest GMSFetchPlaceRequest
La richiesta del luogo di recupero da utilizzare per la query.callback Il callback da richiamare con il risultato del luogo.
- (void) fetchFotoConRequest: | (GMSFetchPhotoRequest *) | fetchPhotoRequest | |
di chiamata: | (GMSFetchPhotoResultCallback) | callback | |
Richiedi una foto utilizzando la richiesta di recupero foto.
Questo metodo non blocca.
- Parametri:
-
fetchPhotoRequest GMSFetchPhotoRequest
La richiesta di foto da utilizzare.callback Il callback da richiamare con il risultato NSURL
.
- (void) searchNearbyWithRequest: | (GMSPlaceSearchNearbyRequest *) | searchNearbyRequest | |
di chiamata: | (GMSPlaceSearchNearbyResultCallback) | callback | |
Cerca luoghi nelle vicinanze di una località e di una restrizione.
Questo metodo non blocca.
- Parametri:
-
searchNearbyRequest GMSPlaceSearchNearbyRequest
La richiesta di ricerca nelle vicinanze da utilizzare per la query.callback Il callback da richiamare con il risultato della ricerca.
Documentazione relativa ad amici e funzioni correlate
- (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] |
- (typedef void(^ GMSFetchPhotoResultCallback)(UIImage *_Nullable photoImage, NSError *_Nullable error)) [related] |
Tipo di callback per ricevere una foto.
photoImage
è una UIImage
che rappresenta la foto risultante corrispondente alla richiesta specificata. Se si è verificato un errore, photoImage
sarà nullo e error
conterrà le informazioni relative all'errore.
- Parametri:
-
photoImage Un risultato di UIImage
.
- (typedef void(^ GMSAutocompleteSuggestionsCallback)(NSArray< GMSAutocompleteSuggestion * > *_Nullable results, NSError *_Nullable error)) [related] |
Tipo di callback per i risultati del completamento automatico.
- Parametri:
-
risultati Un array di GMSAutocompleteSuggestion
.errore L'errore che si è verificato, se presente.
- (typedef void(^ GMSPlaceSearchNearbyResultCallback)(NSArray< GMSPlace * > *_Nullable places, NSError *_Nullable error)) [related] |
Tipo di callback per ricevere risultati di ricerca nelle vicinanze.
- Parametri:
-
luoghi Un array di GMSPlace
errore L'errore che si è verificato, se presente.