Places Autocomplete Service (deprecated)

Classe AutocompleteService

google.maps.places.AutocompleteService libreria di
classi "places"

Ritirato: a partire dal 1° marzo 2025, google.maps.places.AutocompleteService non è disponibile per i nuovi clienti. Utilizza AutocompleteSuggestion. Al momento, non è prevista la dismissione di google.maps.places.AutocompleteService, ma è consigliabile utilizzare AutocompleteSuggestion anziché google.maps.places.AutocompleteService. Sebbene google.maps.places.AutocompleteService continuerà a ricevere correzioni di bug per eventuali regressioni importanti, i bug esistenti in google.maps.places.AutocompleteService non verranno risolti. Verrà dato un preavviso di almeno 12 mesi prima dell'interruzione dell'assistenza. Per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/legacy e la guida alla migrazione all'indirizzo https://developers.google.com/maps/documentation/javascript/places-migration-overview.

Contiene metodi relativi al recupero delle previsioni di completamento automatico.

const {AutocompleteService} = await google.maps.importLibrary("places");

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 un array 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 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 delle query fornita.

Interfaccia AutocompletionRequest

Interfaccia google.maps.places.AutocompletionRequest

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

Proprietà
input	Tipo: string La stringa di input inserita dall'utente.
bounds facoltativo	Deprecato: bounds è deprecato a partire da maggio 2023. Usa i criteri AutocompletionRequest.locationBias e AutocompletionRequest.locationRestriction. Tipo: LatLngBounds|LatLngBoundsLiteral optional Limiti per la distorsione della previsione. Le previsioni saranno orientate verso il valore bounds specificato, ma non limitate a questo. Se è impostato bounds, sia location che radius verranno ignorati.
componentRestrictions facoltativo	Tipo: ComponentRestrictions optional Le limitazioni dei componenti. I vincoli dei componenti vengono utilizzati per limitare le previsioni solo a quelle all'interno del componente principale. Ad esempio, il paese.
language facoltativo	Tipo: string optional Un 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 facoltativo	Deprecato: location è deprecato a partire da maggio 2023. Usa i criteri AutocompletionRequest.locationBias e AutocompletionRequest.locationRestriction. Tipo: LatLng optional Località per la personalizzazione della previsione. Le previsioni saranno influenzate dai valori location e radius forniti. In alternativa, puoi utilizzare bounds.
locationBias facoltativo	Tipo: LocationBias optional Un confine o un suggerimento flessibile da utilizzare durante la ricerca di luoghi.
locationRestriction facoltativo	Tipo: LocationRestriction optional Limiti per vincolare i risultati di ricerca.
offset facoltativo	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 facoltativo	Tipo: LatLng|LatLngLiteral optional La località da cui viene calcolato AutocompletePrediction.distance_meters.
radius facoltativo	Deprecato: radius è deprecato a partire da maggio 2023. Usa i criteri AutocompletionRequest.locationBias e AutocompletionRequest.locationRestriction. Tipo: number optional Il raggio dell'area utilizzata per la distorsione della previsione. radius è specificato in metri e deve essere sempre accompagnato da una proprietà location. In alternativa, puoi utilizzare bounds.
region facoltativo	Tipo: string optional Un codice regione utilizzato per la formattazione e il filtro 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 è identica ai codici ISO 3166-1, con alcune eccezioni degne di nota. Ad esempio, il ccTLD 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 facoltativo	Tipo: AutocompleteSessionToken optional Riferimento univoco utilizzato per raggruppare singole richieste in sessioni.
types facoltativo	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

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

Una richiesta QueryAutocompletion da inviare a QueryAutocompleteService.

Proprietà
input	Tipo: string La stringa di input inserita dall'utente.
bounds facoltativo	Tipo: LatLngBounds|LatLngBoundsLiteral optional Limiti per la distorsione della previsione. Le previsioni saranno orientate verso il valore bounds specificato, ma non limitate a questo. Se è impostato bounds, sia location che radius verranno ignorati.
location facoltativo	Tipo: LatLng optional Località per la personalizzazione della previsione. Le previsioni saranno influenzate dai valori location e radius forniti. In alternativa, puoi utilizzare bounds.
offset facoltativo	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 facoltativo	Tipo: number optional Il raggio dell'area utilizzata per la distorsione della previsione. radius è specificato in metri e deve essere sempre accompagnato da una proprietà location. In alternativa, puoi utilizzare bounds.

Interfaccia ComponentRestrictions

Interfaccia google.maps.places.ComponentRestrictions

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

Proprietà
country facoltativo	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 un massimo di cinque stringhe di codici paese.

Interfaccia AutocompletePrediction

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 corrispondono agli elementi dell'input dell'utente, adatte per essere utilizzate per evidenziare queste 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 i dettagli di questo luogo utilizzando il servizio Place Details (vedi PlacesService.getDetails).
structured_formatting	Tipo: StructuredFormatting Informazioni strutturate sulla descrizione del luogo, suddivise in un testo principale e un testo secondario, incluso un array di sottostringhe corrispondenti dall'input di completamento automatico, identificate da un offset e una lunghezza, espressi in caratteri Unicode.
terms	Tipo: Array<PredictionTerm> Informazioni sui singoli termini della 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 facoltativo	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 della 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 corrispondono agli elementi dell'input dell'utente, adatte per essere utilizzate per evidenziare queste sottostringhe. Ogni sottostringa è identificata da un offset e da una lunghezza, espressi in caratteri Unicode.
terms	Tipo: Array<PredictionTerm> Informazioni sui singoli termini della descrizione precedente. I termini di categoria vengono visualizzati per primi (ad esempio, "ristorante"). I termini dell'indirizzo vengono visualizzati dal più specifico al meno specifico. Ad esempio, "San Francisco" e "CA".
place_id facoltativo	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 Place Details (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 rispetto all'inizio della sottostringa all'interno della stringa di descrizione.

Interfaccia StructuredFormatting

Interfaccia google.maps.places.StructuredFormatting

Contiene informazioni strutturate sulla descrizione del luogo, suddivise in un testo principale e un testo secondario, incluso 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 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	Tipo: Array<PredictionSubstring> Un insieme di sottostringhe nel testo principale che corrispondono agli elementi nell'input dell'utente, adatto per l'evidenziazione di queste sottostringhe. Ogni sottostringa è identificata da un offset e da 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.