Places Autocomplete Service

Classe AutocompleteService

google.maps.places.AutocompleteService corso

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.

Costruttore
AutocompleteService	AutocompleteService() Parametri: nessuna 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 una matrice di oggetti AutocompletePrediction e un valore PlacesServiceStatus come argomento. 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 un array di oggetti QueryAutocompletePrediction e un valore PlacesServiceStatus come argomento. Valore restituito: nessuno Recupera le previsioni di completamento automatico delle query in base alla richiesta di completamento automatico delle query fornita.

Interfaccia Completamento automatico

Interfaccia google.maps.places.AutocompletionRequest

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

Proprietà
input	Tipo:  string L'utente ha inserito la stringa di input.
bounds optional	Ritirato: bounds è stato ritirato a maggio 2023. Usa i criteri AutocompletionRequest.locationBias e AutocompletionRequest.locationRestriction. Tipo:  LatLngBounds|LatLngBoundsLiteral optional Limiti per la logica di previsione. Le previsioni saranno tendenzialmente orientate, ma non limitate, a bounds. location e radius saranno ignorati se è impostato bounds.
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 della 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	Ritirato: location è stato ritirato a maggio 2023. Usa i criteri AutocompletionRequest.locationBias e AutocompletionRequest.locationRestriction. Tipo:  LatLng optional Posizione per la logica di previsione. Le previsioni saranno tendenziose verso i valori location e radius specificati. In alternativa, puoi utilizzare bounds.
locationBias optional	Tipo:  LocationBias optional Un confine morbido o un suggerimento da utilizzare per la ricerca di luoghi.
locationRestriction optional	Tipo:  LocationRestriction optional Limiti per vincolare i risultati di ricerca.
offset optional	Tipo:  number optional La posizione del carattere nel termine di input 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 località da cui viene calcolato AutocompletePrediction.distance_meters.
radius optional	Ritirato: radius è stato ritirato a maggio 2023. Usa i criteri AutocompletionRequest.locationBias e AutocompletionRequest.locationRestriction. Tipo:  number optional Il raggio dell'area utilizzata per la differenziazione della previsione. L'elemento radius è specificato in metri e deve essere sempre accompagnato da una proprietà location. In alternativa, puoi utilizzare bounds.
region optional	Tipo:  string optional Un codice regione utilizzato per la formattazione e il filtro dei risultati. Non limita i suggerimenti per questo paese. Il codice regione accetta un valore di due caratteri ccTLD ("dominio di primo livello"). La maggior parte dei codici ccTLD è identica 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 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 viene specificato alcun tipo, verranno 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.

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

Interfaccia QueryAutocompletionRequest

Interfaccia google.maps.places.QueryAutocompletionRequest

Richiesta di completamento QueryAuto da inviare a QueryAutocompleteService.

Proprietà
input	Tipo:  string L'utente ha inserito la stringa di input.
bounds optional	Tipo:  LatLngBounds|LatLngBoundsLiteral optional Limiti per la logica di previsione. Le previsioni saranno tendenzialmente orientate, ma non limitate, a bounds. location e radius saranno ignorati se è impostato bounds.
location optional	Tipo:  LatLng optional Posizione per la logica di previsione. Le previsioni saranno tendenziose verso i valori location e radius specificati. In alternativa, puoi utilizzare bounds.
offset optional	Tipo:  number optional La posizione del carattere nel termine di input 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 la differenziazione della previsione. L'elemento radius è specificato in metri e deve essere sempre 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 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.

Costruttore
AutocompleteSessionToken	AutocompleteSessionToken() Parametri: nessuna 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.

Proprietà
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 specificarne uno solo o un array di massimo cinque stringhe di codici paese.

Interfaccia Completamento automatico

Interfaccia google.maps.places.AutocompletePrediction

Rappresenta una singola previsione di completamento automatico.

Proprietà
description	Tipo:  string Questa è la versione non formattata della query suggerita dal servizio Places.
matched_substrings	Tipo:  Array<PredictionSubstring> Un insieme di sottostringhe nella descrizione del luogo che corrisponde agli elementi inseriti dall'utente, adatto per l'uso nella messa in evidenza di tali sottostringhe. Ogni sottostringa è identificata da un offset e da una lunghezza, espressi in caratteri Unicode.
place_id	Tipo:  string Un ID luogo che può essere utilizzato per recuperare dettagli su questo luogo tramite il servizio di dettagli del luogo (vedi PlacesService.getDetails).
structured_formatting	Tipo:  StructuredFormatting Informazioni strutturate sulla descrizione del luogo, suddivise in un testo principale e un testo secondario, tra cui una matrice delle sottostringhe abbinate ricavate dall'input del completamento automatico, identificate da un offset e una lunghezza, espresse in caratteri Unicode.
terms	Tipo:  Array<PredictionTerm> Informazioni sui singoli termini nella descrizione riportata sopra, dalla più specifica alla meno specifica. 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 dal AutocompletionRequest.origin.

Interfaccia QueryAutocompletePrediction

Interfaccia google.maps.places.QueryAutocompletePrediction

Rappresenta una singola previsione di completamento automatico delle query.

Proprietà
description	Tipo:  string Questa è la versione non formattata della query suggerita dal servizio Places.
matched_substrings	Tipo:  Array<PredictionSubstring> Un insieme di sottostringhe nella descrizione del luogo che corrisponde agli elementi inseriti dall'utente, adatto per l'uso nella messa in evidenza di tali sottostringhe. Ogni sottostringa è identificata da un offset e da una lunghezza, espressi in caratteri Unicode.
terms	Tipo:  Array<PredictionTerm> Informazioni sui singoli termini nella descrizione riportata sopra. Vengono utilizzati prima i termini categorici (ad esempio "ristorante"). I termini relativi all'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 dettagli su questo luogo tramite il servizio di dettagli del luogo (vedi PlacesService.getDetails).

Interfaccia PredictionTerm

Interfaccia google.maps.places.PredictionTerm

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

Interfaccia google.maps.places.PredictionSubstring

Rappresenta una sottostringa di previsione.

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

Interfaccia StructuredFormat

Interfaccia google.maps.places.StructuredFormatting

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

Proprietà
main_text	Tipo:  string È la parte del testo principale della descrizione non formattata del luogo suggerita dal servizio Places. Di solito il nome del luogo.
main_text_matched_substrings	Tipo:  Array<PredictionSubstring> Un insieme di sottostringhe nel testo principale che corrispondono agli elementi nell'input dell'utente, adatto per essere utilizzato per evidenziare tali sottostringhe. Ogni sottostringa è identificata da un offset e da una lunghezza, espressi in caratteri Unicode.
secondary_text	Tipo:  string Si tratta della parte di testo secondaria della descrizione non formattata del luogo suggerita dal servizio Places. Di solito la posizione del luogo.