Autocomplete Data (new)

AutocompleteSuggestion class

google.maps.places.AutocompleteSuggestion classe

Un risultato di suggerimento di completamento automatico.

Accesso chiamando il numero const {AutocompleteSuggestion} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.

Metodi statici

fetchAutocompleteSuggestions

fetchAutocompleteSuggestions(autocompleteRequest) Parametri:  autocompleteRequest:  AutocompleteRequest Valore restituito:  Promise<{suggestions:Array<AutocompleteSuggestion>}> Recupera un elenco di AutocompleteSuggestions. Se nella richiesta viene fornito un AutocompleteRequest.sessionToken, questo token di sessione verrà incluso automaticamente quando viene chiamato Place.fetchFields per la prima volta, su ogni Place restituito da PlacePrediction.toPlace nei PlacePrediction risultanti.

Proprietà

placePrediction

Tipo:  PlacePrediction optional Contiene il nome leggibile del risultato restituito. Per i risultati relativi a un'attività, di solito si tratta del nome e dell'indirizzo dell'attività. Se è stato fornito un AutocompleteRequest.sessionToken nella AutocompleteRequest utilizzata per recuperare questo AutocompleteSuggestion, lo stesso token verrà incluso automaticamente quando viene chiamato Place.fetchFields per la prima volta su Place restituito da una chiamata a PlacePrediction.toPlace.

Interfaccia AutocompleteRequest

google.maps.places.AutocompleteRequest interfaccia

Richiedi l'interfaccia per AutocompleteSuggestion.fetchAutocompleteSuggestions.

Proprietà
input	Tipo:  string La stringa di testo su cui eseguire la ricerca.
includedPrimaryTypes optional	Tipo:  Array<string> optional Tipo di luogo principale incluso (ad esempio "ristorante" o "stazione di servizio"). 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.
includedRegionCodes optional	Tipo:  Array<string> optional Includi solo i risultati nelle regioni specificate, indicate come massimo 15 codici di regione CLDR di due caratteri. Un insieme vuoto non limiterà 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 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, verrà utilizzata la lingua preferita del browser. I risultati potrebbero 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 Orientare i risultati verso una posizione specificata. Deve essere impostato al massimo un valore tra locationBias e locationRestriction. Se non è 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 segnale di distorsione.
locationRestriction optional	Tipo:  LocationRestriction optional Limita i risultati a una posizione specificata. Deve essere impostato al massimo un valore tra locationBias e locationRestriction. Se non è 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 segnale di distorsione.
origin optional	Tipo:  LatLng|LatLngLiteral optional 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.
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ò influenzare i risultati restituiti. Ciò non limita i risultati alla regione specificata.
sessionToken optional	Tipo:  AutocompleteSessionToken optional Un token che identifica una sessione 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 Google Cloud Console. Una volta terminata una sessione, il token non è più valido e la tua 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 nella richiesta a AutocompleteSuggestion.fetchAutocompleteSuggestions viene fornito un token di sessione, 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 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 trasmettere un token di sessione univoco per ogni nuova sessione. L'utilizzo dello stesso token per più di una sessione comporta l'addebito individuale di ogni richiesta.

Classe AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken classe

Rappresenta un token di sessione utilizzato per monitorare una sessione Autocomplete.

Accesso chiamando il numero const {AutocompleteSessionToken} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.

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

Classe PlacePrediction

google.maps.places.PlacePrediction classe

Risultati della previsione per una previsione di completamento automatico di Places.

Accesso chiamando il numero const {PlacePrediction} = await google.maps.importLibrary("places").
Consulta 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 ulteriori caratteristiche 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à, di solito 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 preferire utilizzare PlacePrediction.mainText e PlacePrediction.secondaryText.
types	Tipo:  Array<string> Elenco dei tipi applicabili a questo luogo dalla tabella A o dalla tabella B all'indirizzo https://developers.google.com/maps/documentation/places/web-service/place-types.

Metodi
fetchAddressValidation	Avviso: disponibile solo nel canale v=beta. fetchAddressValidation(request) Parametri:  request:  AddressValidationRequest Valore restituito:nessuno Invia una richiesta Address Validation associata a questa sessione Autocomplete (compilando internamente la richiesta con il token di sessione Autocomplete). Nessuna informazione sul luogo di PlacePrediction viene inclusa automaticamente. Si tratta di un metodo pratico per facilitare la gestione delle sessioni Autocomplete.
toPlace	toPlace() Parametri: nessuno Valore restituito:  Place Restituisce una rappresentazione Place di questo PlacePrediction. Per ottenere i dettagli completi del luogo è necessaria una chiamata successiva a Place.fetchFields. Se è stato fornito un AutocompleteRequest.sessionToken nel AutocompleteRequest utilizzato per recuperare questo PlacePrediction, lo stesso token verrà incluso automaticamente quando viene chiamato fetchFields. In alternativa, quando utilizzi PlaceAutocompleteElement, la prima chiamata a Place.fetchFields su un Place restituito da PlacePrediction.toPlace includerà automaticamente il token di sessione.

StringRange class

google.maps.places.StringRange classe

Identifica una sottostringa all'interno di un determinato testo.

Accesso chiamando il numero const {StringRange} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.

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

Classe FormattableText

google.maps.places.FormattableText classe

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

Accesso chiamando il numero const {FormattableText} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.

Proprietà
matches	Tipo:  Array<StringRange> Un elenco di intervalli di stringhe che identificano la corrispondenza della richiesta di input 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 di stringhe (ad esempio, correzioni ortografiche o traslitterazioni). Questi valori sono offset di caratteri Unicode di FormattableText.text. Gli intervalli sono garantiti per essere ordinati in base ai valori di offset crescenti.
text	Tipo:  string Testo che può essere utilizzato così com'è o formattato con FormattableText.matches.