Places Autocomplete Service

AutocompleteService class

google.maps.places.AutocompleteService classe

Contiene metodi correlati al recupero delle previsioni del completamento automatico.

Accesso chiamando il numero const {AutocompleteService} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
AutocompleteService
AutocompleteService()
Parametri: nessuno
Crea una nuova istanza di AutocompleteService.
getPlacePredictions
getPlacePredictions(request[, callback])
Parametri: 
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: 
Valore restituito:nessuno
Recupera le previsioni di completamento automatico delle query in base alla richiesta di completamento automatico delle query fornita.

Interfaccia AutocompletionRequest

google.maps.places.AutocompletionRequest interfaccia

Una richiesta di completamento automatico da inviare a AutocompleteService.getPlacePredictions.
input
Tipo:  string
La stringa di input inserita dall'utente.
bounds optional
Limiti per la distorsione della previsione. Le previsioni saranno orientate verso, ma non limitate a, il bounds specificato. Se bounds è impostato, sia location che radius verranno ignorati.
componentRestrictions optional
Tipo:  ComponentRestrictions optional
Le limitazioni dei componenti. Le limitazioni 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 di lingua per la lingua in cui devono essere restituiti i risultati, se possibile. Ai risultati nella lingua selezionata potrebbe essere assegnato un ranking più elevato, ma i suggerimenti non sono limitati a questa lingua. Consulta l'elenco delle lingue supportate.
location optional
Tipo:  LatLng optional
Posizione per la distorsione della previsione. Le previsioni saranno orientate verso i valori location e radius forniti. In alternativa, puoi utilizzare bounds.
locationBias optional
Tipo:  LocationBias optional
Un confine o un suggerimento da utilizzare durante la ricerca di luoghi.
locationRestriction optional
Tipo:  LocationRestriction optional
Confini per limitare i risultati di ricerca.
offset optional
Tipo:  number optional
La posizione del carattere nel termine di input in corrispondenza della quale il servizio utilizza il testo per le previsioni (la posizione del cursore nel campo di input).
origin optional
Tipo:  LatLng|LatLngLiteral optional
La posizione da cui viene calcolato AutocompletePrediction.distance_meters.
radius optional
Tipo:  number optional
Il raggio dell'area utilizzata per la distorsione della 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 ccTLD ("dominio di primo livello"). La maggior parte dei codici ccTLD sono identici ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il TLD nazionale del Regno Unito è "uk " (.co.uk), mentre il suo 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 Autocomplete restituita dalla chiamata a AutocompleteService.getPlacePredictions contenente un elenco di AutocompletePrediction.
predictions
L'elenco di AutocompletePrediction.

Interfaccia QueryAutocompletionRequest

google.maps.places.QueryAutocompletionRequest interfaccia

Una richiesta QueryAutocompletion da inviare a QueryAutocompleteService.
input
Tipo:  string
La stringa di input inserita dall'utente.
bounds optional
Limiti per la distorsione della previsione. Le previsioni saranno orientate verso, ma non limitate a, il bounds specificato. Se bounds è impostato, sia location che radius verranno ignorati.
location optional
Tipo:  LatLng optional
Posizione per la distorsione della previsione. Le previsioni saranno orientate verso i valori location e radius forniti. In alternativa, puoi utilizzare bounds.
offset optional
Tipo:  number optional
La posizione del carattere nel termine di input in corrispondenza della quale il servizio utilizza il testo per le previsioni (la posizione del cursore nel campo di input).
radius optional
Tipo:  number optional
Il raggio dell'area utilizzata per la distorsione della previsione. radius è specificato in metri e deve sempre essere accompagnato da una proprietà location. In alternativa, puoi utilizzare bounds.

ComponentRestrictions interfaccia

google.maps.places.ComponentRestrictions interfaccia

Definisce le limitazioni dei componenti che possono essere utilizzate con il servizio di completamento automatico.
country optional
Tipo:  string|Array<string> optional
Limita le previsioni al paese specificato (codice paese ISO 3166-1 alpha-2, senza distinzione tra maiuscole e minuscole). Ad esempio, 'us', 'br' o 'au'. Puoi fornire una singola stringa o un array di massimo cinque stringhe di codici paese.

Interfaccia AutocompletePrediction

google.maps.places.AutocompletePrediction interfaccia

Rappresenta una singola previsione di completamento automatico.
description
Tipo:  string
Questa è la versione non formattata della query suggerita dal servizio Places.
matched_substrings
Un insieme di sottostringhe nella descrizione del luogo che corrispondono agli elementi nell'input dell'utente, adatte per essere utilizzate per evidenziare 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 Dettagli luogo (vedi PlacesService.getDetails).
structured_formatting
Informazioni strutturate sulla descrizione del luogo, suddivise in un testo principale e un testo secondario, incluso un array di sottostringhe corrispondenti dell'input di completamento automatico, identificate da un offset e una lunghezza, espresse in caratteri Unicode.
terms
Informazioni sui singoli termini nella descrizione precedente, dal più specifico 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 da AutocompletionRequest.origin.

Interfaccia QueryAutocompletePrediction

google.maps.places.QueryAutocompletePrediction interfaccia

Rappresenta una singola previsione di completamento automatico delle query.
description
Tipo:  string
Questa è la versione non formattata della query suggerita dal servizio Places.
matched_substrings
Un insieme di sottostringhe nella descrizione del luogo che corrispondono agli elementi nell'input dell'utente, adatte per essere utilizzate per evidenziare queste sottostringhe. Ogni sottostringa è identificata da un offset e una lunghezza, espressi in caratteri Unicode.
terms
Informazioni sui singoli termini nella descrizione precedente. I termini categorici vengono prima (ad esempio, "ristorante"). I termini dell'indirizzo vengono visualizzati dal più specifico 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 Dettagli luogo (vedi PlacesService.getDetails).

Interfaccia PredictionTerm

google.maps.places.PredictionTerm interfaccia

Rappresenta un termine di previsione.
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.
length
Tipo:  number
La lunghezza della sottostringa.
offset
Tipo:  number
L'offset dell'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 dell'input di completamento automatico, identificate da un offset e una lunghezza, espresse in caratteri Unicode.
main_text
Tipo:  string
Questa è la parte di testo principale della descrizione non formattata del luogo suggerito dal servizio Places. Di solito il nome del luogo.
main_text_matched_substrings
Un insieme di sottostringhe nel testo principale che corrispondono agli elementi nell'input dell'utente, adatti all'uso per evidenziare queste sottostringhe. Ogni sottostringa è identificata da un offset e una lunghezza, espressi in caratteri Unicode.
secondary_text
Tipo:  string
Questa è la parte di testo secondaria della descrizione non formattata del luogo suggerito dal servizio Places. Di solito la posizione del luogo.