Places Widgets

Classe PlaceAutocompleteElement

google.maps.places.PlaceAutocompleteElement corso

Implementazione dell'API AutocompleteView for Places

Questo corso 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 che supporta la visualizzazione.
inputElement
L'elemento di input per cui mostrare i completamenti automatici.
Ereditato: 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 dell'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: nessuna
Questo evento viene attivato quando una richiesta al backend è stata rifiutata (ad esempio una chiave API errata). Questo evento non viene visualizzato in bolle.

Interfaccia di PlaceAutocompleteElementOptions

Interfaccia google.maps.places.PlaceAutocompleteElementOptions

Opzioni per la creazione di un PlaceAutocompleteElement.
inputElement
L'elemento di input per cui mostrare 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 principale. Ad esempio, il paese.
element optional
Tipo:  HTMLElement|SVGElement optional
Questo campo è di sola lettura. L'elemento DOM che supporta la visualizzazione.
locationBias optional
Tipo:  LocationBias optional
Un confine morbido o un suggerimento da utilizzare per la ricerca di luoghi.
locationRestriction optional
Tipo:  LocationRestriction optional
Limiti per vincolare i risultati di ricerca.
requestedLanguage optional
Tipo:  string optional
Un 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 e il filtro dei risultati. Non limita i suggerimenti per 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 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.

Completamento automatico

google.maps.places.Autocomplete corso

Un widget che fornisce previsioni sui luoghi in base agli input di testo di un utente. Si collega a un elemento di input di tipo text e rimane in ascolto della voce di testo inserita in quel campo. L'elenco delle previsioni viene presentato come elenco a discesa e viene aggiornato man mano che viene inserito il testo.

Questa lezione si estende a 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: nessuna
Valore restituito:  LatLngBounds|undefined i limiti di differenziazione.
Restituisce i limiti in base ai quali vengono fatte previsioni.
getFields
getFields()
Parametri: nessuna
Valore restituito:  Array<string>|undefined
Restituisce i campi da includere per il luogo nella risposta ai dettagli quando i dettagli sono stati recuperati correttamente. Per un elenco dei campi, vedi PlaceResult.
getPlace
getPlace()
Parametri: nessuna
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 stub Place 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 entro la quale restituire i risultati del luogo. I risultati sono orientati verso, ma non limitati a, quest'area.
setComponentRestrictions
setComponentRestrictions(restrictions)
Parametri: 
Valore restituito: nessuno
Imposta le limitazioni dei componenti. Le limitazioni 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 ai dettagli quando 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.
Ereditato: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
Argomenti: nessuna
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 che non è stato suggerito dal controllo e preme il tasto Invio, oppure se una richiesta Dettagli luogo non riesce, PlaceResult contiene l'input utente nella proprietà name, senza altre proprietà definite.

Interfaccia AutocompleteOptions

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
Le limitazioni dei componenti. Le limitazioni 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 ai dettagli quando questi vengono recuperati correttamente, che verranno fatturati. Se ['ALL'] viene passato, tutti i campi disponibili verranno restituiti e fatturati (non è consigliato per i deployment di produzione). Per un elenco dei campi, vedi PlaceResult. I campi nidificati possono essere specificati con percorsi a punti (ad esempio "geometry.location"). Il valore predefinito è ['ALL'].
placeIdOnly optional
Tipo:  boolean optional
Indica se recuperare solo gli ID luogo. I PlacePlace resi disponibili quando l'evento Place_changed viene attivato avranno solo i campi Place_id, Tipi e Nome, con l'oggetto Place_id, i tipi e la descrizione restituiti dal servizio di completamento automatico. Disabilitato per impostazione predefinita.
strictBounds optional
Tipo:  boolean optional
Un valore booleano, che indica che il widget Autocomplete dovrebbe restituire solo i luoghi che si trovano entro i limiti del widget Autocomplete al momento dell'invio della query. Se imposti il valore di limiti limitati a false (impostazione predefinita), i risultati saranno tendenzialmente orientati verso, ma non limitatamente, 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 corso

Un widget che fornisce previsioni per le query in base all'input di testo di un utente. Si collega a un elemento di input di tipo text e rimane in ascolto della voce di testo inserita in quel campo. L'elenco delle previsioni viene presentato come elenco a discesa e viene aggiornato man mano che viene inserito il testo.

Questa lezione si estende a 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: nessuna
Valore restituito:  LatLngBounds|undefined
Restituisce i limiti in base ai quali vengono previste le previsioni delle query.
getPlaces
getPlaces()
Parametri: nessuna
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 logica delle previsioni delle query. I risultati saranno solo bias in questa area e non saranno limitati completamente.
Ereditato: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
Argomenti: nessuna
Questo evento viene attivato quando l'utente seleziona una query, getPlaces deve essere utilizzato per ottenere nuovi luoghi.

Interfaccia di SearchBoxOptions

Interfaccia google.maps.places.SearchBoxOptions

Le opzioni che possono essere impostate su un oggetto SearchBox.
bounds optional
L'area verso la quale eseguire il bias delle previsioni delle query. Le previsioni sono orientate, a titolo esemplificativo, alle query che hanno come target questi limiti.