Autocomplete Data (new)

Interfaccia AutocompleteRequest

google.maps.places.AutocompleteRequest interfaccia

Richiedi l'interfaccia per AutocompleteSuggestion.fetchAutocompleteSuggestions.

Proprietà
input	Tipo:  string La stringa di testo in cui cercare.
includedPrimaryTypes optional	Tipo:  Array<string> optional Tipo di luogo principale incluso (ad es. "ristorante" o "stazioni_di_servizio"). Un luogo viene restituito solo se il relativo tipo principale è incluso in questo elenco. È possibile specificare fino a 5 valori. Se non vengono specificati tipi, vengono restituiti tutti i tipi di luogo.
includedRegionCodes optional	Tipo:  Array<string> optional Includi solo i risultati nelle regioni specificate, specificate come massimo 15 codici regione CLDR di due caratteri. Un insieme vuoto non limita i risultati. Se sono impostati sia locationRestriction sia includedRegionCodes, i risultati si troveranno nell'area di intersezione.
inputOffset optional	Tipo:  number optional Un offset di caratteri Unicode basato su 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, verrà utilizzata la preferenza di lingua del browser. I risultati possono essere in lingue miste se la lingua utilizzata in input è diversa da language o se il luogo restituito non ha una traduzione dalla lingua locale a language.
locationBias optional	Tipo:  LocationBias optional Spostare i risultati in una posizione specificata. Deve essere impostato al massimo uno tra locationBias o locationRestriction. Se non viene impostato nessuno dei due, i risultati saranno influenzati dall'indirizzo IP, il che significa che l'indirizzo IP verrà mappato a una posizione imprecisa e utilizzato come indicatore di bias.
locationRestriction optional	Tipo:  LocationRestriction optional Limita i risultati a una località specificata. Deve essere impostato al massimo uno tra locationBias o locationRestriction. Se non viene impostato nessuno dei due, i risultati saranno influenzati dall'indirizzo IP, il che significa che l'indirizzo IP verrà mappato a una posizione imprecisa e utilizzato come indicatore di bias.
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 CLDR di due caratteri. Ciò influisce sulla formattazione degli indirizzi, sul ranking dei risultati e può influire sui risultati restituiti. Ciò non limita i risultati alla regione specificata.
sessionToken optional	Tipo:  AutocompleteSessionToken optional Un token che identifica una sessione Autocomplete a fini di 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. Al termine di 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 sessione, la sessione viene addebitata come se non fosse stato fornito alcun token sessione (ogni richiesta viene fatturata separatamente). Ti consigliamo le seguenti linee guida: Utilizza i token di sessione per tutte le chiamate di completamento automatico dei luoghi. 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.

Classe AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken corso

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

Accedi chiamando const {AutocompleteSessionToken} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.

Costruttore
AutocompleteSessionToken	AutocompleteSessionToken() Parametri: nessuno Crea una nuova istanza di AutocompleteSessionToken.

Classe AutocompleteSuggestion

google.maps.places.AutocompleteSuggestion corso

Un risultato del suggerimento di completamento automatico.

Accedi chiamando const {AutocompleteSuggestion} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.

Metodi statici
fetchAutocompleteSuggestions	fetchAutocompleteSuggestions(autocompleteRequest) Parametri:  autocompleteRequest:  AutocompleteRequest Valore restituito:Promise<{suggestions:Array<AutocompleteSuggestion>}> Recupera un elenco di AutocompleteSuggestions.

Proprietà
placePrediction	Tipo:  PlacePrediction optional Contiene il nome leggibile del risultato restituito. Per i risultati relativi a un'attività, in genere si tratta del nome e dell'indirizzo dell'attività.

Classe PlacePrediction

google.maps.places.PlacePrediction corso

Risultati della previsione per una previsione di completamento automatico dei luoghi.

Accedi chiamando const {PlacePrediction} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.

Proprietà
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 ID luogo.
secondaryText	Tipo:  FormattableText optional Rappresenta elementi aggiuntivi di disambiguazione (ad esempio una città o una regione) per identificare ulteriormente il luogo.
text	Tipo:  FormattableText Contiene il nome leggibile del risultato restituito. Per i risultati relativi a un'attività, in genere si tratta del nome e dell'indirizzo dell'attività. text è consigliato per gli sviluppatori che vogliono mostrare un singolo elemento dell'interfaccia utente. Gli sviluppatori che vogliono mostrare due elementi dell'interfaccia utente distinti, ma correlati, potrebbero preferire utilizzare PlacePrediction.mainText e PlacePrediction.secondaryText.
types	Tipo:  Array<string> 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.

Metodi
toPlace	toPlace() Parametri: nessuno Valore restituito:Place Restituisce una rappresentazione di Place di questa previsione di luogo. Per ottenere i dettagli completi del luogo è necessaria una chiamata successiva a Place.fetchFields.

Classe StringRange

google.maps.places.StringRange corso

Identifica una sottostringa all'interno di un determinato testo.

Accedi chiamando const {StringRange} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.

Proprietà
endOffset	Tipo:  number Offset a partire da zero dell'ultimo carattere Unicode della sottostringa (esclusivo).
startOffset	Tipo:  number Offset a partire da zero del primo carattere Unicode della sottostringa (incluso).

Classe FormattableText

google.maps.places.FormattableText corso

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

Accedi chiamando const {FormattableText} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.

Proprietà
matches	Tipo:  Array<StringRange> Un elenco di intervalli di stringhe che identificano la posizione in cui la richiesta di input corrisponde a 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 di stringhe (ad es. correzioni ortografica o traslitterazioni). Questi valori sono gli offset dei caratteri Unicode di FormattableText.text. Gli intervalli sono garantiti per essere ordinati in valori di offset crescenti.
text	Tipo:  string Testo che può essere utilizzato così com'è o formattato con FormattableText.matches.