Places Autocomplete Service

Classe AutocompleteService

google.maps.places.AutocompleteService corso

Contiene metodi relativi al recupero delle previsioni del completamento automatico.

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

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

Metodi
getPlacePredictions	getPlacePredictions(request[, callback]) Parametri:  request:  AutocompletionRequest la richiesta di completamento automatico. callback:  function(Array<AutocompletePrediction> optional, PlacesServiceStatus): void optional un callback che accetta come argomento un array di oggetti AutocompletePrediction e un valore PlacesServiceStatus. Valore restituito:Promise<AutocompleteResponse> Recupera le previsioni di completamento automatico dei luoghi in base alla richiesta di completamento automatico fornita.
getQueryPredictions	getQueryPredictions(request, callback) Parametri:  request:  QueryAutocompletionRequest la richiesta di completamento automatico della query. callback:  function(Array<QueryAutocompletePrediction> optional, PlacesServiceStatus): void un callback che accetta come argomento un array di oggetti QueryAutocompletePrediction e un valore PlacesServiceStatus. Valore restituito:nessuno Recupera le previsioni di completamento automatico delle query in base alla richiesta di completamento automatico della query fornita.

Interfaccia AutocompletionRequest

google.maps.places.AutocompletionRequest interfaccia

Una richiesta di completamento automatico da inviare a AutocompleteService.getPlacePredictions.

Proprietà
input	Tipo:  string La stringa di input inserita dall'utente.
bounds optional	Ritiro previsto: bounds è deprecato a partire da maggio 2023. Utilizza invece AutocompletionRequest.locationBias e AutocompletionRequest.locationRestriction. Tipo:  LatLngBounds|LatLngBoundsLiteral optional Limiti per l'applicazione di bias alle previsioni. Le previsioni saranno orientate verso, ma non limitate a, bounds specificato. Sia location che radius verranno ignorati se è impostato bounds.
componentRestrictions optional	Tipo:  ComponentRestrictions optional Le limitazioni dei componenti. Le restrizioni dei componenti vengono utilizzate per limitare le previsioni solo a quelle all'interno del componente principale. Ad esempio, il paese.
language optional	Tipo:  string optional Un identificatore della lingua in cui devono essere restituiti i risultati, se possibile. I risultati nella lingua selezionata potrebbero avere un ranking più elevato, ma i suggerimenti non sono limitati a questa lingua. Consulta l'elenco delle lingue supportate.
location optional	Ritiro previsto: location è deprecato a partire da maggio 2023. Utilizza invece AutocompletionRequest.locationBias e AutocompletionRequest.locationRestriction. Tipo:  LatLng optional Posizione per l'applicazione di bias di previsione. Le previsioni saranno viziate in base ai valori location e radius specificati. In alternativa, puoi utilizzare bounds.
locationBias optional	Tipo:  LocationBias optional Un confine o un suggerimento flessibile da utilizzare durante la ricerca di luoghi.
locationRestriction optional	Tipo:  LocationRestriction optional Limiti per limitare i risultati di ricerca.
offset optional	Tipo:  number optional La posizione del carattere nel termine inserito in cui il servizio utilizza il testo per le previsioni (la posizione del cursore nel campo di immissione).
origin optional	Tipo:  LatLng|LatLngLiteral optional La posizione da cui viene calcolato AutocompletePrediction.distance_meters.
radius optional	Ritiro previsto: radius è deprecato a partire da maggio 2023. Utilizza invece AutocompletionRequest.locationBias e AutocompletionRequest.locationRestriction. Tipo:  number optional Il raggio dell'area utilizzata per l'applicazione di bias alla previsione. radius è specificato in metri e deve sempre essere accompagnato da una proprietà location. In alternativa, puoi utilizzare bounds.
region optional	Tipo:  string optional Un codice regione utilizzato per la formattazione e il filtraggio dei risultati. Non limita i suggerimenti a questo paese. Il codice regione accetta un valore di due caratteri di ccTLD ("dominio di primo livello"). La maggior parte dei codici ccTLD è identica ai codici ISO 3166-1, con alcune eccezioni notevoli. Ad esempio, il TLD di primo livello del Regno Unito è "uk " (.co.uk), mentre il codice ISO 3166-1 è"gb " (tecnicamente per l'entità "Regno Unito di Gran Bretagna e Irlanda del Nord").
sessionToken optional	Tipo:  AutocompleteSessionToken optional Riferimento univoco utilizzato per raggruppare le singole richieste in sessioni.
types optional	Tipo:  Array<string> optional I tipi di previsioni da restituire. Per i tipi supportati, consulta la guida per gli sviluppatori. Se non vengono specificati tipi, verranno restituiti tutti i tipi.

Interfaccia AutocompleteResponse

google.maps.places.AutocompleteResponse interfaccia

Una risposta di completamento automatico restituita dalla chiamata a AutocompleteService.getPlacePredictions contenente un elenco di AutocompletePrediction.

Proprietà
predictions	Tipo:  Array<AutocompletePrediction> L'elenco di AutocompletePrediction.

Interfaccia QueryAutocompletionRequest

google.maps.places.QueryAutocompletionRequest interfaccia

Una richiesta di completamento automatico delle query da inviare a QueryAutocompleteService.

Proprietà
input	Tipo:  string La stringa di input inserita dall'utente.
bounds optional	Tipo:  LatLngBounds|LatLngBoundsLiteral optional Limiti per l'applicazione di bias alle previsioni. Le previsioni saranno orientate verso, ma non limitate a, bounds specificato. Sia location che radius verranno ignorati se è impostato bounds.
location optional	Tipo:  LatLng optional Posizione per l'applicazione di bias di previsione. Le previsioni saranno viziate in base ai valori location e radius specificati. In alternativa, puoi utilizzare bounds.
offset optional	Tipo:  number optional La posizione del carattere nel termine inserito in cui il servizio utilizza il testo per le previsioni (la posizione del cursore nel campo di immissione).
radius optional	Tipo:  number optional Il raggio dell'area utilizzata per l'applicazione di bias alla previsione. radius è specificato in metri e deve sempre essere accompagnato da una proprietà location. In alternativa, puoi utilizzare bounds.

Classe AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken corso

Rappresenta un token di sessione utilizzato per monitorare una sessione di compilazione automatica, che può essere una serie di chiamate AutocompleteService.getPlacePredictions seguite da una singola chiamata PlacesService.getDetails.

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.

Interfaccia ComponentRestrictions

google.maps.places.ComponentRestrictions interfaccia

Definisce le limitazioni dei componenti che possono essere utilizzate con il servizio di completamento automatico.

Proprietà
country optional	Tipo:  string|Array<string> optional Limita le previsioni al paese specificato (codice paese ISO 3166-1 Alpha-2, non sensibile alle maiuscole). Ad esempio, 'us', 'br' o 'au'. Puoi fornire un singolo codice o un array di massimo cinque stringhe di codici paese.

Interfaccia AutocompletePrediction

google.maps.places.AutocompletePrediction interfaccia

Rappresenta una singola previsione di completamento automatico.

Proprietà
description	Tipo:  string Questa è la versione non formattata della query suggerita dal servizio Luoghi.
matched_substrings	Tipo:  Array<PredictionSubstring> Un insieme di sottostringhe nella descrizione del luogo che corrispondono agli elementi inseriti dall'utente, adatto per l'evidenziazione di queste sottostringhe. Ogni sottostringa è identificata da un offset e una lunghezza, espressi in caratteri Unicode.
place_id	Tipo:  string Un ID luogo che può essere utilizzato per recuperare i dettagli di questo luogo utilizzando il servizio di dettagli dei luoghi (vedi PlacesService.getDetails).
structured_formatting	Tipo:  StructuredFormatting Informazioni strutturate sulla descrizione del luogo, suddivise in un testo principale e un testo secondario, tra cui un array di sottostringhe corrispondenti dall'input di completamento automatico, identificate da un offset e una lunghezza, espresse in caratteri Unicode.
terms	Tipo:  Array<PredictionTerm> Informazioni sui singoli termini nella descrizione precedente, dal più al meno specifico. Ad esempio, "Taco Bell", "Willitis" e "CA".
types	Tipo:  Array<string> Un array di tipi a cui appartiene la previsione, ad esempio 'establishment' o 'geocode'.
distance_meters optional	Tipo:  number optional La distanza in metri del luogo dal AutocompletionRequest.origin.

Interfaccia QueryAutocompletePrediction

google.maps.places.QueryAutocompletePrediction interfaccia

Rappresenta una singola previsione di completamento automatico della query.

Proprietà
description	Tipo:  string Questa è la versione non formattata della query suggerita dal servizio Luoghi.
matched_substrings	Tipo:  Array<PredictionSubstring> Un insieme di sottostringhe nella descrizione del luogo che corrispondono agli elementi inseriti dall'utente, adatto per l'evidenziazione di queste sottostringhe. Ogni sottostringa è identificata da un offset e una lunghezza, espressi in caratteri Unicode.
terms	Tipo:  Array<PredictionTerm> Informazioni sui singoli termini nella descrizione sopra riportata. I termini di categoria vengono visualizzati per primi (ad es. "ristorante"). I termini di indirizzo vengono visualizzati dal più al meno specifico. Ad esempio, "San Francisco" e "CA".
place_id optional	Tipo:  string optional Disponibile solo se la previsione è un luogo. Un ID luogo che può essere utilizzato per recuperare i dettagli di questo luogo utilizzando il servizio di dettagli dei luoghi (vedi PlacesService.getDetails).

Interfaccia PredictionTerm

google.maps.places.PredictionTerm interfaccia

Rappresenta un termine di previsione.

Proprietà
offset	Tipo:  number L'offset, in caratteri Unicode, dell'inizio di questo termine nella descrizione del luogo.
value	Tipo:  string Il valore di questo termine, ad esempio "Taco Bell".

Interfaccia PredictionSubstring

google.maps.places.PredictionSubstring interfaccia

Rappresenta una sottostringa di previsione.

Proprietà
length	Tipo:  number La lunghezza della sottostringa.
offset	Tipo:  number Lo spazio dall'inizio della sottostringa all'interno della stringa di descrizione.

Interfaccia StructuredFormatting

google.maps.places.StructuredFormatting interfaccia

Contiene informazioni strutturate sulla descrizione del luogo, suddivise in un testo principale e un testo secondario, tra cui un array di sottostringhe corrispondenti dall'input di completamento automatico, identificate da un offset e una lunghezza, espressi in caratteri Unicode.

Proprietà
main_text	Tipo:  string Si tratta della parte di testo principale della descrizione non formattata del luogo suggerito dal servizio Luoghi. Di solito il nome del luogo.
main_text_matched_substrings	Tipo:  Array<PredictionSubstring> Un insieme di sottostringhe nel testo principale che corrispondono agli elementi inseriti dall'utente, adatto per l'evidenziazione di queste sottostringhe. Ogni sottostringa è identificata da un offset e una lunghezza, espressi in caratteri Unicode.
secondary_text	Tipo:  string Si tratta della parte di testo secondaria della descrizione non formattata del luogo suggerito dal servizio Luoghi. Di solito la posizione del luogo.