Places Autocomplete Service

AutocompleteService

google.maps.places.AutocompleteService classe

Contiene metodi relativi al recupero delle previsioni di Completamento automatico.

Accedi chiamando const {AutocompleteService} = await google.maps.importLibrary("places"). Consulta la sezione 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 delle posizioni in base alla richiesta di completamento automatico specificata.
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

Interfaccia google.maps.places.AutocompletionRequest

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 differenziazione della previsione. Le previsioni saranno orientate, ma non limitate, al valore bounds specificato. Sia location che radius verranno ignorati se è impostato bounds.
componentRestrictions optional
Tipo:  ComponentRestrictions optional
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
L'identificatore della 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 differenziazione della previsione. Le previsioni verranno orientate in base ai valori location e radius specificati. In alternativa, è possibile utilizzare bounds.
locationBias optional
Tipo:  LocationBias optional
Un confine flessibile o un suggerimento da utilizzare per 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 di input in base al quale il servizio utilizza il testo per le previsioni (la posizione del cursore nel campo di immissione).
origin optional
Tipo:  LatLng|LatLngLiteral optional
La località da cui viene calcolato il valore AutocompletePrediction.distance_meters.
radius optional
Tipo:  number optional
Il raggio dell'area utilizzato per la differenziazione della previsione. radius è specificato in metri e deve sempre essere accompagnato da una proprietà location. In alternativa, è possibile utilizzare bounds.
region optional
Tipo:  string optional
Un codice regione utilizzato per la formattazione dei risultati e per l'applicazione di filtri ai risultati. I suggerimenti non vengono limitati a questo paese. Il codice regione accetta un ccTLD ("dominio di primo livello") a due caratteri. La maggior parte dei codici ccTLD sono identici ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il ccTLD 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 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 viene specificato alcun tipo, vengono restituiti tutti i tipi.

Interfaccia AutocompleteResponse

Interfaccia google.maps.places.AutocompleteResponse

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

predictions

Interfaccia QueryAutocompletionRequest

Interfaccia google.maps.places.QueryAutocompletionRequest

Una richiesta di completamento QueryAuto da inviare a QueryAutocompleteService.

input
Tipo:  string
La stringa di input inserita dall'utente.
bounds optional
Limiti per la differenziazione della previsione. Le previsioni saranno orientate, ma non limitate, al valore bounds specificato. Sia location che radius verranno ignorati se è impostato bounds.
location optional
Tipo:  LatLng optional
Posizione per la differenziazione della previsione. Le previsioni verranno orientate in base ai valori location e radius specificati. In alternativa, è possibile utilizzare bounds.
offset optional
Tipo:  number optional
La posizione del carattere nel termine di input in base al quale 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 utilizzato per la differenziazione della previsione. radius è specificato in metri e deve sempre essere accompagnato da una proprietà location. In alternativa, è possibile utilizzare bounds.

Classe AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken classe

Rappresenta un token di sessione utilizzato per monitorare una sessione di completamento automatico, 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.

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

Interfaccia ComponentRestrictions

Interfaccia google.maps.places.ComponentRestrictions

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 un singolo codice paese o un array di massimo cinque stringhe di codici paese.

Interfaccia di AutocompletePrediction

Interfaccia google.maps.places.AutocompletePrediction

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 di un luogo che corrispondono a elementi presenti nell'input dell'utente e possono essere utilizzate per evidenziare queste sottostringhe. Ogni sottostringa è identificata da un offset e una lunghezza, espresse in caratteri Unicode.
place_id
Tipo:  string
Un ID luogo che può essere utilizzato per recuperare informazioni dettagliate su questo luogo usando il relativo servizio (vedi PlacesService.getDetails).
structured_formatting
Informazioni strutturate sulla descrizione del luogo, divise in un testo principale e un testo secondario, che includono un array di sottostringhe corrispondenti provenienti dall'input di completamento automatico, identificate da un offset e una lunghezza, espresse in caratteri Unicode.
terms
Informazioni sui singoli termini nella descrizione sopra, dal più specifico al meno specifico. Ad esempio, "Taco Bell", "Willitis" e "CA".
types
Tipo:  Array<string>
Un array dei 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

Interfaccia google.maps.places.QueryAutocompletePrediction

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 di un luogo che corrispondono a elementi presenti nell'input dell'utente e possono essere utilizzate per evidenziare queste sottostringhe. Ogni sottostringa è identificata da un offset e una lunghezza, espresse in caratteri Unicode.
terms
Informazioni sui singoli termini nella descrizione sopra riportata. I termini categorici vengono prima di tutto (ad es. "ristorante"). I termini dell'indirizzo compaiono 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 informazioni dettagliate su questo luogo usando il relativo servizio (vedi PlacesService.getDetails).

Interfaccia PredictionTerm

Interfaccia google.maps.places.PredictionTerm

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

Interfaccia google.maps.places.PredictionSubstring

Rappresenta una sottostringa di previsione.

length
Tipo:  number
La lunghezza della sottostringa.
offset
Tipo:  number
L'offset all'inizio della sottostringa all'interno della stringa di descrizione.

Interfaccia StructuredFormatting

Interfaccia google.maps.places.StructuredFormatting

Contiene informazioni strutturate sulla descrizione del luogo, divise in un testo principale e un testo secondario, inclusi un array di sottostringhe corrispondenti provenienti dall'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 corrispondenti agli elementi nell'input dell'utente, utilizzabili per evidenziare queste sottostringhe. Ogni sottostringa è identificata da un offset e una lunghezza, espresse 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.