Places Widgets

Classe PlaceAutocompleteElement

google.maps.places.PlaceAutocompleteElement classe

Implementazione dell'API AutocompleteView for Places

Questa classe implementa PlaceAutocompleteElementOptions.

Accedi chiamando const {PlaceAutocompleteElement} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
Parametri: 
element optional
Tipo:  HTMLElement|SVGElement optional
Questo campo è di sola lettura. L'elemento DOM a supporto della visualizzazione.
inputElement
L'elemento di input per il quale mostrare i completamenti automatici.
Ereditate: componentRestrictions, locationBias, locationRestriction, requestedLanguage, requestedRegion, types
addListener
addListener(eventName, handler)
Parametri: 
  • eventName:  string
  • handler:  Function
Valore restituito:  MapsEventListener
Aggiunge la funzione listener specificata al nome evento specificato.
gmp-placeselect
function(place)
Argomenti: 
Questo evento viene attivato quando un utente seleziona una previsione di luogo. Restituisce un oggetto Place.
gmp-requesterror
function()
Argomenti: nessuno
Questo evento viene attivato quando una richiesta al backend viene rifiutata (ad es. chiave API errata). Per questo evento non vengono visualizzate le bolle.

Interfaccia PlaceAutocompleteElementOptions

Interfaccia google.maps.places.PlaceAutocompleteElementOptions

Opzioni per la creazione di un PlaceAutocompleteElement.
inputElement
L'elemento di input per il quale mostrare i completamenti automatici.
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.
element optional
Tipo:  HTMLElement|SVGElement optional
Questo campo è di sola lettura. L'elemento DOM a supporto della visualizzazione.
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.
requestedLanguage 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.
requestedRegion 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").
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.

Completamento automatico

google.maps.places.Autocomplete classe

Un widget che fornisce previsioni dei luoghi in base all'input di testo di un utente. Viene collegato a un elemento di input di tipo text e ascolta il testo inserito in quel campo. L'elenco delle previsioni viene presentato come elenco a discesa e viene aggiornato man mano che viene inserito il testo.

Questa classe estende MVCObject.

Accedi chiamando const {Autocomplete} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.
Autocomplete
Autocomplete(inputField[, opts])
Parametri: 
Crea una nuova istanza di Autocomplete che si collega al campo di testo di input specificato con le opzioni specificate.
getBounds
getBounds()
Parametri: nessuno
Valore restituito:  LatLngBounds|undefined i limiti di differenziazione.
Restituisce i limiti sui quali vengono utilizzate le previsioni per la differenziazione.
getFields
getFields()
Parametri: nessuno
Valore restituito:  Array<string>|undefined
Restituisce i campi da includere per il luogo nella risposta ai dettagli quando i dettagli vengono recuperati correttamente. Per un elenco dei campi, vedi PlaceResult.
getPlace
getPlace()
Parametri: nessuno
Valore restituito:  PlaceResult il luogo selezionato dall'utente.
Restituisce i dettagli del luogo selezionato dall'utente, se i dettagli sono stati recuperati correttamente. In caso contrario, restituisce un oggetto Place stub con la proprietà name impostata sul valore corrente del campo di immissione.
setBounds
setBounds(bounds)
Parametri: 
Valore restituito: nessuno
Imposta l'area preferita all'interno della quale restituire i risultati sui luoghi. I risultati sono differenziati, ma non limitati a, quest'area.
setComponentRestrictions
setComponentRestrictions(restrictions)
Parametri: 
Valore restituito: nessuno
Imposta le limitazioni del componente. Le restrizioni dei componenti vengono utilizzate per limitare le previsioni solo a quelle all'interno del componente principale. Ad esempio, il paese.
setFields
setFields(fields)
Parametri: 
  • fields:  Array<string> optional
Valore restituito: nessuno
Imposta i campi da includere per il luogo nella risposta dei dettagli quando i dettagli vengono recuperati correttamente. Per un elenco dei campi, vedi PlaceResult.
setOptions
setOptions(options)
Parametri: 
Valore restituito: nessuno
setTypes
setTypes(types)
Parametri: 
  • types:  Array<string> optional i tipi di previsioni da includere.
Valore restituito: nessuno
Imposta 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.
Ereditate: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando viene reso disponibile un PlaceResult per un luogo selezionato dall'utente.
Se l'utente inserisce il nome di un luogo non suggerito dal controllo e preme il tasto Invio oppure se una richiesta Dettagli luogo non va a buon fine, PlaceResult contiene l'input utente nella proprietà name, senza altre proprietà definite.

AutocompleteOptions per l'interfaccia

Interfaccia google.maps.places.AutocompleteOptions

Le opzioni che possono essere impostate su un oggetto Autocomplete.
bounds optional
L'area in cui cercare luoghi.
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.
fields optional
Tipo:  Array<string> optional
Campi da includere per il luogo nella risposta relativa ai dettagli quando vengono recuperati correttamente i dettagli, il costo verrà addebitato. Se viene passato ['ALL'], verranno restituiti tutti i campi disponibili e verranno addebitati i relativi costi (questa operazione è sconsigliata per i deployment di produzione). Per un elenco dei campi, vedi PlaceResult. I campi nidificati possono essere specificati con percorsi con punti (ad esempio, "geometry.location"). Il valore predefinito è ['ALL'].
placeIdOnly optional
Tipo:  boolean optional
Se recuperare solo gli ID luogo. Il PlaceResult reso disponibile quando viene attivato l'evento place_changed avrà solo i campi place_id, i tipi e il nome, con place_id, i tipi e la descrizione restituiti dal servizio Autocomplete. Disattivato per impostazione predefinita.
strictBounds optional
Tipo:  boolean optional
Un valore booleano, che indica che il widget Autocomplete deve restituire solo i luoghi che si trovano all'interno dei limiti del widget Autocomplete al momento dell'invio della query. L'impostazione di restrictedBounds su false (impostazione predefinita) applica la differenziazione dei risultati verso, ma non limitati, i luoghi contenuti all'interno dei limiti.
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.

google.maps.places.SearchBox classe

Un widget che fornisce previsioni delle query in base all'input di testo di un utente. Viene collegato a un elemento di input di tipo text e ascolta il testo inserito in quel campo. L'elenco delle previsioni viene presentato come elenco a discesa e viene aggiornato man mano che viene inserito il testo.

Questa classe estende MVCObject.

Accedi chiamando const {SearchBox} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.
SearchBox
SearchBox(inputField[, opts])
Parametri: 
Crea una nuova istanza di SearchBox che si collega al campo di testo di input specificato con le opzioni specificate.
getBounds
getBounds()
Parametri: nessuno
Valore restituito:  LatLngBounds|undefined
Restituisce i limiti sui quali sono manipolate le previsioni delle query.
getPlaces
getPlaces()
Parametri: nessuno
Valore restituito:  Array<PlaceResult>|undefined
Restituisce la query selezionata dall'utente da utilizzare con l'evento places_changed.
setBounds
setBounds(bounds)
Parametri: 
Valore restituito: nessuno
Imposta la regione da utilizzare per la differenziazione delle previsioni delle query. I risultati saranno influenzati solo da quest'area e non saranno limitati a quest'ultima.
Ereditate: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando l'utente seleziona una query e deve essere utilizzato getPlaces per ottenere nuovi luoghi.

Interfaccia SearchBoxOptions

Interfaccia google.maps.places.SearchBoxOptions

Le opzioni che possono essere impostate su un oggetto SearchBox.
bounds optional
L'area verso la quale influenzare le previsioni delle query. Le previsioni sono orientate, ma non limitate, alle query che hanno come target questi limiti.