Places Widgets

PlaceAutocompleteElement

google.maps.places.PlaceAutocompleteElement classe

  • PlaceAutocompleteElement è una sottoclasse HTMLElement che fornisce un componente UI per l'API Places Autocomplete. Dopo aver caricato la libreria places, è possibile creare un input con la funzionalità di completamento automatico in HTML. Ad esempio: 
    <gmp-placeautocomplete ></gmp-placeautocomplete>

Elemento personalizzato:
<gmp-placeautocomplete></gmp-placeautocomplete>

Questa classe estende HTMLElement.

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: 
inputElement
L'elemento input per il quale visualizzare i completamenti automatici.
Ereditati: componentRestrictions, locationBias, locationRestriction, requestedLanguage, requestedRegion, types
BetaaddEventListener
addEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa sensibile alle maiuscole che rappresenta il tipo di evento da ascoltare.
  • listener:  EventListener|EventListenerObject l'oggetto che riceve una notifica. Deve essere una funzione o un oggetto con il metodo handleEvent
  • options:  boolean|AddEventListenerOptions optional Vedi le opzioni. Gli eventi personalizzati supportano solo capture e passive.
Valore restituito:  void
Imposta una funzione che verrà chiamata ogni volta che l'evento specificato viene pubblicato nella destinazione. Vedi addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa che specifica il tipo di evento per il quale rimuovere un listener di eventi.
  • listener:  EventListener|EventListenerObject il listener di eventi del gestore di eventi da rimuovere dalla destinazione dell'evento.
  • options:  boolean|EventListenerOptions optional Vedi le opzioni
Valore restituito:  void
Rimuove dalla destinazione un listener di eventi precedentemente registrato con hreflang. Vedi removeEventListener

Interfaccia PlaceAutocompleteElementOptions

Interfaccia google.maps.places.PlaceAutocompleteElementOptions

Opzioni per la creazione di un PlaceAutocompleteElement.
inputElement
L'elemento input per il quale visualizzare i completamenti automatici.
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 padre. Ad esempio, il paese.
locationBias optional
Tipo:  LocationBias optional
Un confine sfumato 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 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.
requestedRegion optional
Tipo:  string optional
Un codice regione utilizzato per la formattazione dei risultati e per il filtro dei risultati. I suggerimenti non sono limitati a questo paese. Il codice regione accetta un valore di due caratteri per il 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 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, verranno restituiti tutti i tipi.

Classe PlaceAutocompletePlaceSelectEvent

google.maps.places.PlaceAutocompletePlaceSelectEvent classe

Questo evento viene creato dopo che l'utente ha selezionato un luogo con l'elemento Place Autocomplete. Accedi alla selezione con event.place.

Questa classe estende Event.

Accedi chiamando const {PlaceAutocompletePlaceSelectEvent} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.
Alphaplace
Tipo:  Place

PlaceAutocompleteRequestErrorEvent

google.maps.places.PlaceAutocompleteRequestErrorEvent classe

Questo evento viene emesso da PlaceAutocompleteElement quando si verifica un problema con la richiesta di rete.

Questa classe estende Event.

Accedi chiamando const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places"). Consulta la sezione Librerie nell'API Maps JavaScript.

Completamento automatico

google.maps.places.Autocomplete classe

Un widget che fornisce previsioni di Place in base all'input di testo di un utente. Viene collegato a un elemento di input di tipo text e rimane in ascolto del testo inserito in quel campo. L'elenco delle previsioni viene presentato come elenco a discesa e viene aggiornato man mano che viene inserito del 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 ai quali vengono applicate la differenziazione delle previsioni.
getFields
getFields()
Parametri: nessuno
Valore restituito:  Array<string>|undefined
Restituisce i campi da includere per il luogo nella risposta 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
Consente di impostare l'area preferita all'interno della quale restituire i risultati relativi ai luoghi. I risultati sono influenzati, ma non limitati a, questa area.
setComponentRestrictions
setComponentRestrictions(restrictions)
Parametri: 
Valore restituito: nessuno
Imposta le limitazioni del componente. Le limitazioni dei componenti vengono utilizzate per limitare le previsioni solo a quelle all'interno del componente padre. 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 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, verranno restituiti tutti i tipi.
Ereditati: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando un PlaceResult viene reso disponibile 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

Interfaccia google.maps.places.AutocompleteOptions

Le opzioni che possono essere impostate su un oggetto Autocomplete.
bounds optional
L'area in cui cercare i luoghi.
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 padre. Ad esempio, il paese.
fields optional
Tipo:  Array<string> optional
Campi da includere per il luogo nella risposta relativa ai dettagli quando i dettagli sono stati recuperati correttamente, che verranno addebitati. Se ['ALL'] viene trasmesso, tutti i campi disponibili verranno restituiti e fatturati (questa operazione non è consigliata per i deployment di produzione). Per un elenco dei campi, vedi PlaceResult. I campi nidificati possono essere specificati con punti-path (ad esempio, "geometry.location"). Il valore predefinito è ['ALL'].
placeIdOnly optional
Tipo:  boolean optional
Indica se recuperare solo gli ID luogo. Il PlaceResult reso disponibile quando viene attivato l'evento place_changed includerà solo i campi place_id, i tipi e i nomi, con place_id, tipi e descrizione restituiti dal servizio di completamento automatico. Disabilitato per impostazione predefinita.
strictBounds optional
Tipo:  boolean optional
Un valore booleano che indica che il widget Completamento automatico deve restituire solo le posizioni che si trovano entro i limiti del widget Completamento automatico al momento dell'invio della query. L'impostazione di rigorosoBounds su false (impostazione predefinita) determinerà 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, verranno 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 rimane in ascolto del testo inserito in quel campo. L'elenco delle previsioni viene presentato come elenco a discesa e viene aggiornato man mano che viene inserito del 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 ai quali vengono applicate la differenziazione delle 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 orientati solo a quest'area e non saranno completamente limitati a quest'ultima.
Ereditati: 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 in cui differenziare le previsioni delle query. Le previsioni sono sbilanciate, ma non limitate a, per le query che hanno come target questi limiti.