Autocomplete Data (new)

Interfaccia AutocompleteRequest

Interfaccia google.maps.places.AutocompleteRequest

Interfaccia di richiesta per AutocompleteSuggestion.fetchAutocompleteSuggestions.
input
Tipo:  string
La stringa di testo in cui eseguire la ricerca.
includedPrimaryTypes optional
Tipo:  Array<string> optional
Tipo di luogo principale incluso (ad esempio "ristorante" 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 viene specificato alcun tipo, vengono restituiti tutti i tipi di luogo.
includedRegionCodes optional
Tipo:  Array<string> optional
Includi i risultati solo nelle regioni specificate, specificate fino a un massimo di 15 codici regione a due caratteri CLDR. Un set vuoto non limiterà i risultati. Se sono impostati sia locationRestriction sia includedRegionCodes, i risultati verranno posizionati nell'area di intersezione.
inputOffset optional
Tipo:  number optional
Un offset del carattere 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.
language optional
Tipo:  string optional
La lingua in cui restituire i risultati. Per impostazione predefinita, viene impostata la preferenza di 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 in language.
locationBias optional
Tipo:  LocationBias optional
Indirizza i risultati verso una località specificata.

Deve essere impostato al massimo uno dei valori locationBias o locationRestriction. Se nessuno dei due è impostato, i risultati saranno polarizzati in base all'indirizzo IP, il che significa che l'indirizzo IP verrà mappato su una posizione imprecisa e utilizzato come segnale di differenziazione.
locationRestriction optional
Tipo:  LocationRestriction optional
Limita i risultati a una località specificata.

Deve essere impostato al massimo uno dei valori locationBias o locationRestriction. Se nessuno dei due è impostato, i risultati saranno polarizzati in base all'indirizzo IP, il che significa che l'indirizzo IP verrà mappato su una posizione imprecisa e utilizzato come segnale di differenziazione.
origin optional
Tipo:  LatLng|LatLngLiteral optional
Il punto di partenza da cui calcolare la distanza geodetica alla destinazione (restituito come PlacePrediction.distanceMeters). Se questo valore viene omesso, la distanza geodetica non verrà restituita.
region optional
Tipo:  string optional
Il codice regione, specificato come codice regione a due caratteri CLDR. Ciò influisce sulla formattazione degli indirizzi e sul ranking dei risultati e potrebbe influire sui risultati restituiti. I risultati non vengono limitati alla regione specificata.
sessionToken optional
Tipo:  AutocompleteSessionToken optional
Un token che identifica una sessione di completamento automatico ai fini della fatturazione. Genera un nuovo token di sessione tramite AutocompleteSessionToken.

La sessione inizia quando l'utente inizia a digitare una query e si conclude 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 terminata la 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).

Consigliamo di attenerti alle seguenti linee guida:
  • Utilizza i token di sessione per tutte le chiamate Place Autocomplete.
  • Generare un nuovo token per ogni sessione.
  • Assicurati di trasmettere un token di sessione univoco per ogni nuova sessione. Se utilizzi lo stesso token per più di una sessione, ogni richiesta verrà fatturata individualmente.

Classe AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken corso

Rappresenta un token di sessione utilizzato per monitorare una sessione di completamento automatico.

Accedi chiamando il numero const {AutocompleteSessionToken} = await google.maps.importLibrary("places"). Consulta Librerie nell'API Maps JavaScript.
AutocompleteSessionToken
AutocompleteSessionToken()
Parametri: nessuno
Crea una nuova istanza di AutocompleteSessionToken.

Classe AutocompleteSuggestion

google.maps.places.AutocompleteSuggestion corso

Un risultato di suggerimento di completamento automatico.

Accedi chiamando il numero const {AutocompleteSuggestion} = await google.maps.importLibrary("places"). Consulta Librerie nell'API Maps JavaScript.
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
Parametri: 
Valore restituito:  Promise<{suggestions:Array<AutocompleteSuggestion>}>
Recupera un elenco di Suggerimenti di completamento automatico.
placePrediction
Tipo:  PlacePrediction optional
Contiene il nome leggibile per il risultato restituito. Per i risultati relativi alle attività, generalmente si tratta del nome e dell'indirizzo dell'attività.

Classe PlacePrediction

google.maps.places.PlacePrediction corso

Risultati della previsione per una previsione di Place Autocomplete.

Accedi chiamando il numero const {PlacePrediction} = await google.maps.importLibrary("places"). Consulta Librerie nell'API Maps JavaScript.
distanceMeters
Tipo:  number optional
La lunghezza della geodetica in metri da origin se origin è specificato.
mainText
Tipo:  FormattableText optional
Rappresenta il nome del luogo.
placeId
Tipo:  string
L'identificatore univoco del luogo suggerito. Questo identificatore può essere utilizzato in altre API che accettano gli ID luogo.
secondaryText
Tipo:  FormattableText optional
Rappresentano altri elementi di disambiguazione (come una città o una regione) per identificare ulteriormente il luogo.
text
Contiene il nome leggibile per il risultato restituito. Per i risultati relativi alle attività, generalmente 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 possono usare invece PlacePrediction.mainText e PlacePrediction.secondaryText.
types
Tipo:  Array<string>
Elenco dei tipi applicabili a questo luogo dalla Tabella A o dalla Tabella B in https://developers.google.com/maps/documentation/places/web-service/place-types.
toPlace
toPlace()
Parametri: nessuno
Valore restituito:  Place
Restituisce una rappresentazione Place di questa PlacePrediction. Per ottenere i dettagli completi del luogo, è necessaria una chiamata successiva al numero Place.fetchFields.

Classe StringRange

google.maps.places.StringRange corso

Identifica una sottostringa all'interno di un determinato testo.

Accedi chiamando il numero const {StringRange} = await google.maps.importLibrary("places"). Consulta Librerie nell'API Maps JavaScript.
endOffset
Tipo:  number
Offset su base zero dell'ultimo carattere Unicode della sottostringa (esclusa).
startOffset
Tipo:  number
Offset su base zero del primo carattere Unicode della sottostringa (incluso).

Classe FormattableText

google.maps.places.FormattableText corso

Testo che rappresenta una previsione di Place. Il testo può essere utilizzato così com'è o formattato.

Accedi chiamando il numero const {FormattableText} = await google.maps.importLibrary("places"). Consulta Librerie nell'API Maps JavaScript.
matches
Un elenco di intervalli di stringhe che identificano il punto in cui la richiesta di input ha trovato una corrispondenza in FormattableText.text. Gli intervalli possono essere utilizzati per formattare parti specifiche di text. Le sottostringhe potrebbero non essere corrispondenze esatte di 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 vengono comunque ordinati in valori di offset crescenti.
text
Tipo:  string
Testo che può essere utilizzato così com'è o formattato con FormattableText.matches.