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. | |
Funzioni correlate | |
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:
-
placeID L'ID del luogo da cercare. callback Il 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:
-
placeID L'ID del luogo per il quale cercare le foto. callback Il 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:
-
photoMetadata Il GMSPlacePhotoMetadata
per cui caricare unUIImage
.callback Il 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:
-
photoMetadata Il GMSPlacePhotoMetadata
per cui caricare unUIImage
.maxSize La dimensione massima dell'immagine. scalabilità La scala in cui caricare l'immagine. callback Il callback da richiamare con il UIImage
caricato.
- (void) currentPlaceWithCallback: | (GMSPlaceLikelihoodListCallback) | richiamata |
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:
-
callback Il 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:
-
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: | (GMSPlaceField) | placeFields | |
sessionToken: | (GMSAutocompleteSessionToken nullabile *) | sessionToken | |
da richiamare: | (GMSPlaceResultCallback) | richiamata | |
Recupera i 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 | |
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:
-
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 | |
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:
-
placeID L'ID del luogo da cercare. callback Il 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:
-
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 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:
-
posto Il GMSPlace
da cercare.callback Il 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:
-
place The GMSPlace
to lookup.
date The NSDate
to determine open status for.
callback The callback to invoke with the place result.
Documentazione relativa agli amici e alle funzioni correlate
- (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:
-
risultato Il valore GMSPlace
restituito.errore L'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:
-
likelihoodList L'elenco delle probabilità di luogo. errore L'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:
-
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 di foto di luoghi.
Se si è verificato un errore, photos
sarà nullo e error
conterrà informazioni sull'errore.
- Parametri:
-
foto Il risultato contiene GMSPlacePhotoMetadata
oggetti.errore L'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:
-
foto L'elemento UIImage
che è stato caricato.errore L'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:
-
risultato Il valore GMSPlaceOpenStatus
restituito.errore L'errore che si è verificato, se presente.