Places Widgets

Classe 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, sarà possibile creare un input con la funzionalità di completamento automatico nel codice HTML. Ad esempio: 
    <gmp-placeautocomplete ></gmp-placeautocomplete>

Elemento personalizzato:
<gmp-placeautocomplete name="string" requested-language="string" requested-region="string" types="type1 type2 type3..."></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: 
componentRestrictions
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.
locationBias
Tipo:  LocationBias optional
Un confine flessibile o un suggerimento da utilizzare per la ricerca di luoghi.
locationRestriction
Tipo:  LocationRestriction optional
Limiti per limitare i risultati di ricerca.
name
Tipo:  string optional
Il nome da utilizzare per l'elemento di input. Per maggiori dettagli, visita la pagina https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name. Segue lo stesso comportamento dell'attributo name per gli input. Tieni presente che questo è il nome che verrà utilizzato quando viene inviato un modulo. Per maggiori dettagli, visita la pagina https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form.
Attributo HTML:
  • <gmp-placeautocomplete name="string"></gmp-placeautocomplete>
requestedLanguage
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.
Attributo HTML:
  • <gmp-placeautocomplete requested-language="string"></gmp-placeautocomplete>
requestedRegion
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").
Attributo HTML:
  • <gmp-placeautocomplete requested-region="string"></gmp-placeautocomplete>
types
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.
Attributo HTML:
  • <gmp-placeautocomplete types="type1 type2 type3..."></gmp-placeautocomplete>
prediction-item
Un elemento nel menu a discesa delle previsioni che rappresenta una singola previsione.
prediction-item-icon
L'icona visualizzata a sinistra di ogni elemento nell'elenco delle previsioni.
prediction-item-main-text
Una parte dell'elemento di previsione che rappresenta il testo principale della previsione. Per le località geografiche, contiene il nome di un luogo, come "Sydney", o il nome di una via e un numero civico, come "Via Roma 10". Per impostazione predefinita, previsione-item-main-text è di colore nero. Se è presente testo aggiuntivo nell'elemento di previsione, si trova al di fuori della previsione-item-main-text ed eredita lo stile dall'elemento di previsione. Per impostazione predefinita è di colore grigio. Il testo aggiuntivo è in genere un indirizzo.
prediction-item-match
La parte della previsione restituita che corrisponde all'input dell'utente. Per impostazione predefinita, il testo corrispondente viene evidenziato in grassetto. Tieni presente che il testo corrispondente può trovarsi ovunque all'interno dell'elemento della previsione. Non fa necessariamente parte di previsione-item-main-text.
prediction-item-selected
L'elemento quando l'utente vi accede tramite tastiera. Nota: gli elementi selezionati saranno interessati sia dagli stili di questa parte sia dagli stili della parte degli elementi di previsione.
prediction-list
L'elemento visivo contenente l'elenco di previsioni restituite dal servizio Place Autocomplete. che viene visualizzato come un elenco a discesa sotto PlaceAutocompleteElement.
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
Configura una funzione che verrà chiamata ogni volta che l'evento specificato viene pubblicato nella destinazione. Consulta la colonna addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa che specifica il tipo di evento per cui 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 c. Vedi removeEventListener

Interfaccia PlaceAutocompleteElementOptions

Interfaccia google.maps.places.PlaceAutocompleteElementOptions

Opzioni per la creazione di un PlaceAutocompleteElement.
componentRestrictions optional
Tipo:  ComponentRestrictions optional
Visualizza PlaceAutocompleteElement.componentRestrictions
locationBias optional
Tipo:  LocationBias optional
Visualizza PlaceAutocompleteElement.locationBias
locationRestriction optional
Tipo:  LocationRestriction optional
Visualizza PlaceAutocompleteElement.locationRestriction
requestedLanguage optional
Tipo:  string optional
Visualizza PlaceAutocompleteElement.requestedLanguage
requestedRegion optional
Tipo:  string optional
Visualizza PlaceAutocompleteElement.requestedRegion
types optional
Tipo:  Array<string> optional
Visualizza PlaceAutocompleteElement.types

Classe PlaceAutocompletePlaceSelectEvent

google.maps.places.PlaceAutocompletePlaceSelectEvent classe

Questo evento viene creato dopo che l'utente seleziona 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.
Betaplace
Tipo:  Place

Classe 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 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.