Places Widgets

Classe PlaceAutocompleteElement

google.maps.places.PlaceAutocompleteElement classe

Avviso: disponibile soltanto nel canale v=beta.

PlaceAutocompleteElement è una sottoclasse HTMLElement che fornisce un componente UI per l'API Places Autocomplete.

Elemento personalizzato:
<gmp-place-autocomplete name="string" requested-language="string" requested-region="string" types="type1 type2 type3..."></gmp-place-autocomplete>

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.

Costruttore
PlaceAutocompleteElement	PlaceAutocompleteElement(options) Parametri:  options:  PlaceAutocompleteElementOptions

Proprietà
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-place-autocomplete requested-language="string"></gmp-place-autocomplete>
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-place-autocomplete requested-region="string"></gmp-place-autocomplete>
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-place-autocomplete types="type1 type2 type3..."></gmp-place-autocomplete>

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

Metodi
addEventListener	Avviso: disponibile soltanto nel canale v=beta. 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
removeEventListener	Avviso: disponibile soltanto nel canale v=beta. 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

Eventi
gmp-placeselect	function(placeAutocompletePlaceSelectEvent) Argomenti:  placeAutocompletePlaceSelectEvent:  PlaceAutocompletePlaceSelectEvent Questo evento viene attivato quando un utente seleziona una previsione di luogo. Contiene un oggetto Place.
gmp-requesterror	function(placeAutocompleteRequestErrorEvent) Argomenti:  placeAutocompleteRequestErrorEvent:  PlaceAutocompleteRequestErrorEvent 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

Avviso: disponibile soltanto nel canale v=beta.

Opzioni per la creazione di un PlaceAutocompleteElement.

Proprietà
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

Avviso: disponibile soltanto nel canale v=beta.

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.

Proprietà
place	Avviso: disponibile soltanto nel canale v=beta. Tipo:  Place

Classe PlaceAutocompleteRequestErrorEvent

google.maps.places.PlaceAutocompleteRequestErrorEvent classe

Avviso: disponibile soltanto nel canale v=beta.

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.

Costruttore
Autocomplete	Autocomplete(inputField[, opts]) Parametri:  inputField:  HTMLInputElement il campo di testo <input> a cui deve essere associato l'elemento Autocomplete. opts:  AutocompleteOptions optional opzioni. Crea una nuova istanza di Autocomplete che si collega al campo di testo di input specificato con le opzioni specificate.

Metodi
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:  bounds:  LatLngBounds|LatLngBoundsLiteral optional i limiti di differenziazione. 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:  restrictions:  ComponentRestrictions optional le limitazioni da usare. 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:  options:  AutocompleteOptions optional 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

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

Proprietà
bounds optional	Tipo:  LatLngBounds|LatLngBoundsLiteral 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	Ritirati: placeIdOnly è stato ritirato il 15 gennaio 2019 e verrà disattivato il 15 gennaio 2020. Usa invece AutocompleteOptions.fields: fields: ['place_id', 'name', 'types']. 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.

SearchBox

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.

Costruttore
SearchBox	SearchBox(inputField[, opts]) Parametri:  inputField:  HTMLInputElement opts:  SearchBoxOptions optional Crea una nuova istanza di SearchBox che si collega al campo di testo di input specificato con le opzioni specificate.

Metodi
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:  bounds:  LatLngBounds|LatLngBoundsLiteral optional 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

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

Proprietà
bounds optional	Tipo:  LatLngBounds|LatLngBoundsLiteral 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.