Autocomplete Data

Contiene il nome leggibile del risultato restituito. Per i risultati relativi alle attività, in genere si tratta del nome e dell'indirizzo dell'attività.

Se è stato fornito un AutocompleteRequest.sessionToken nell'oggetto AutocompleteRequest utilizzato per recuperare questo AutocompleteSuggestion, lo stesso token verrà incluso automaticamente quando chiami Place.fetchFields per la prima volta sull'oggetto Place restituito da una chiamata a PlacePrediction.toPlace.

La stringa di testo in cui cercare.

Includi previsioni dei luoghi per le attività che non sono ancora aperte, ma che dovrebbero aprire in futuro.

Tipo di luogo principale incluso (ad esempio "restaurant" o "gas_station").

Un luogo viene restituito solo se il suo tipo principale è incluso in questo elenco. È possibile specificare fino a 5 valori. Se non vengono specificati tipi, vengono restituiti tutti i tipi di luoghi.

Includi solo i risultati nelle regioni specificate, indicate con un massimo di 15 codici regione CLDR di due caratteri. Un set vuoto non limiterà i risultati. Se sono impostati sia locationRestriction sia includedRegionCodes, i risultati verranno visualizzati nell'area di intersezione.

Un offset di caratteri Unicode in base zero di input che indica la posizione del cursore in input. La posizione del cursore può influire sulle previsioni restituite. Se non specificato, il valore predefinito è la lunghezza di input.

Identificatori utilizzati per attribuire le chiamate a pacchetti o librerie OSS specifici.

La lingua in cui restituire i risultati. Per impostazione predefinita, verranno utilizzate le preferenze sulla lingua del browser. I risultati potrebbero essere in lingue diverse se la lingua utilizzata in input è diversa da language o se il luogo restituito non ha una traduzione dalla lingua locale a language.

Influenza i risultati in base a una località specificata.

Deve essere impostato al massimo uno dei valori locationBias o locationRestriction. Se non viene impostato nessuno dei due, i risultati verranno influenzati dall'indirizzo IP, il che significa che l'indirizzo IP verrà mappato a una posizione imprecisa e utilizzato come indicatore di bias.

Limita i risultati a una località specificata.

Deve essere impostato al massimo uno dei valori locationBias o locationRestriction. Se non viene impostato nessuno dei due, i risultati verranno influenzati dall'indirizzo IP, il che significa che l'indirizzo IP verrà mappato a una posizione imprecisa e utilizzato come indicatore di bias.

Il punto di origine da cui calcolare la distanza geodetica dalla destinazione (restituita come PlacePrediction.distanceMeters). Se questo valore viene omesso, la distanza geodetica non verrà restituita.

Includi le attività al domicilio del cliente se il campo è impostato su true. Un'attività al domicilio del cliente è un'attività che effettua consegne a domicilio o che raggiunge direttamente i clienti, ma che non presta servizio ai clienti presso l'indirizzo dell'attività. Ad esempio, attività come servizi di pulizia o idraulici potrebbero non avere un indirizzo fisico o una sede su Google Maps.

Il codice regione, specificato come codice regione CLDR di due caratteri. Ciò influisce sulla formattazione degli indirizzi, sul ranking dei risultati e potrebbe influenzare i risultati restituiti. I risultati non vengono limitati alla regione specificata.

Un token che identifica una sessione di Autocomplete ai fini della fatturazione. Genera un nuovo token di sessione tramite AutocompleteSessionToken.

La sessione inizia quando l'utente inizia a digitare una query e termina quando seleziona un luogo e chiama Place.fetchFields. Ogni sessione può avere più query, seguite da una chiamata fetchFields. Le credenziali utilizzate per ogni richiesta all'interno di una sessione devono appartenere allo stesso progetto della console Google Cloud. Una volta conclusa una sessione, il token non è più valido. L'app deve generare un nuovo token per ogni sessione. Se il parametro sessionToken viene omesso o se riutilizzi un token di sessione, la sessione viene addebitata come se non fosse stato fornito alcun token di sessione (ogni richiesta viene fatturata separatamente).

Quando un token di sessione viene fornito nella richiesta a AutocompleteSuggestion.fetchAutocompleteSuggestions, lo stesso token verrà incluso automaticamente nella prima chiamata a fetchFields su un Place restituito chiamando PlacePrediction.toPlace su uno dei AutocompleteSuggestion risultanti.

Ti consigliamo di seguire queste linee guida:

• Utilizza i token di sessione per tutte le chiamate Place Autocomplete.
• Genera un nuovo token per ogni sessione.
• Assicurati di passare un token di sessione univoco per ogni nuova sessione. Se utilizzi lo stesso token per più sessioni, ogni richiesta verrà fatturata singolarmente.

La lunghezza della geodetica in metri da origin se origin è specificato.

Rappresenta il nome del luogo.

L'identificatore univoco del luogo suggerito. Questo identificatore può essere utilizzato in altre API che accettano ID luogo.

Rappresenta funzionalità di disambiguazione aggiuntive (ad esempio una città o una regione) per identificare ulteriormente il luogo.

Contiene il nome leggibile del risultato restituito. Per i risultati relativi alle attività, in genere si tratta del nome e dell'indirizzo dell'attività.

text è consigliato per gli sviluppatori che vogliono mostrare un singolo elemento UI. Gli sviluppatori che vogliono mostrare due elementi UI separati, ma correlati, potrebbero voler utilizzare PlacePrediction.mainText e PlacePrediction.secondaryText.

Elenco dei tipi che si applicano a questo luogo dalla Tabella A o dalla Tabella B in https://developers.google.com/maps/documentation/places/web-service/place-types.

Offset in base zero dell'ultimo carattere Unicode della sottostringa (escluso).

Offset in base zero del primo carattere Unicode della sottostringa (incluso).

Un elenco di intervalli di stringhe che identificano dove la richiesta di input corrisponde in FormattableText.text. Gli intervalli possono essere utilizzati per formattare parti specifiche di text. Le sottostringhe potrebbero non corrispondere esattamente a AutocompleteRequest.input se la corrispondenza è stata determinata da criteri diversi dalla corrispondenza delle stringhe (ad esempio, correzioni ortografiche o traslitterazioni). Questi valori sono offset di caratteri Unicode di FormattableText.text. Gli intervalli sono garantiti in base ai valori di offset crescenti.

Testo che può essere utilizzato così com'è o formattato con FormattableText.matches.