Places Widgets

BasicPlaceAutocompleteElement class

google.maps.places.BasicPlaceAutocompleteElement classe

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

Elemento personalizzato:
<gmp-basic-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng" requested-language="string" requested-region="string" unit-system="metric"></gmp-basic-place-autocomplete>

Questo corso si estende HTMLElement.

Questa classe implementa BasicPlaceAutocompleteElementOptions.

Accesso chiamando il numero const {BasicPlaceAutocompleteElement} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
BasicPlaceAutocompleteElement
BasicPlaceAutocompleteElement(options)
Parametri: 
includedPrimaryTypes
Tipo:  Array<string> optional
Tipo di luogo principale incluso (ad esempio "ristorante" o "stazione di servizio").

Un luogo viene restituito solo se il suo tipo principale è incluso in questo elenco. È possibile specificare fino a 5 valori. Se non vengono specificati tipi, vengono restituiti tutti i tipi di luoghi.
Attributo HTML:
  • <gmp-basic-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-basic-place-autocomplete>
includedRegionCodes
Tipo:  Array<string> optional
Includi solo i risultati nelle regioni specificate, indicate come massimo 15 codici di regione CLDR di due caratteri. Un insieme vuoto non limiterà i risultati. Se sono impostati sia locationRestriction sia includedRegionCodes, i risultati si troveranno nell'area di intersezione.
Attributo HTML:
  • <gmp-basic-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-basic-place-autocomplete>
locationBias
Tipo:  LocationBias optional
Un confine o un suggerimento da utilizzare durante la ricerca di luoghi.
locationRestriction
Tipo:  LocationRestriction optional
Confini per limitare i risultati di ricerca.
name
Tipo:  string optional
Il nome da utilizzare per l'elemento di input. Per i dettagli, consulta la pagina https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name. Segue lo stesso comportamento dell'attributo nome per gli input. Tieni presente che questo è il nome che verrà utilizzato quando viene inviato un modulo. Per i dettagli, vai alla pagina https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form.
Attributo HTML:
  • <gmp-basic-place-autocomplete name="string"></gmp-basic-place-autocomplete>
origin
L'origine da cui calcolare la distanza. Se non specificata, la distanza non viene calcolata. L'altitudine, se fornita, non viene utilizzata nel calcolo.
Attributo HTML:
  • <gmp-basic-place-autocomplete origin="lat,lng"></gmp-basic-place-autocomplete>
  • <gmp-basic-place-autocomplete origin="lat,lng,altitude"></gmp-basic-place-autocomplete>
requestedLanguage
Tipo:  string optional
Un identificatore di 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.
Attributo HTML:
  • <gmp-basic-place-autocomplete requested-language="string"></gmp-basic-place-autocomplete>
requestedRegion
Tipo:  string optional
Un codice regione utilizzato per la formattazione e il filtraggio dei risultati. Non limita i suggerimenti a questo paese. Il codice regione accetta un valore di due caratteri 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 TLD nazionale del Regno Unito è "uk " (.co.uk), mentre il suo codice ISO 3166-1 è"gb " (tecnicamente per l'entità "Regno Unito di Gran Bretagna e Irlanda del Nord").
Attributo HTML:
  • <gmp-basic-place-autocomplete requested-region="string"></gmp-basic-place-autocomplete>
unitSystem
Tipo:  UnitSystem optional
Il sistema di unità di misura utilizzato per visualizzare le distanze. Se non specificato, il sistema di unità viene determinato da requestedRegion.
Attributo HTML:
  • <gmp-basic-place-autocomplete unit-system="metric"></gmp-basic-place-autocomplete>
  • <gmp-basic-place-autocomplete unit-system="imperial"></gmp-basic-place-autocomplete>
prediction-item-icon
Questo spazio accetta esattamente un elemento <template> da visualizzare come icona accanto all'elemento di previsione.
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 dei suggerimenti.
prediction-item-main-text
Una parte dell'elemento di previsione che costituisce il testo principale della previsione. Per le località geografiche, contiene il nome di un luogo, ad esempio "Sydney", o il nome e il numero di una via, ad esempio "Via del Re, 10". Per impostazione predefinita, il testo principale dell'elemento di previsione è nero. Se nell'elemento di previsione è presente altro testo, questo si trova al di fuori di prediction-item-main-text e eredita lo stile da prediction-item. Per impostazione predefinita è colorato di 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, questo testo corrispondente viene evidenziato in grassetto. Tieni presente che il testo corrispondente può trovarsi ovunque all'interno di prediction-item. Non fa necessariamente parte di prediction-item-main-text.
prediction-item-selected
L'elemento quando l'utente lo seleziona tramite la tastiera. Nota: gli elementi selezionati saranno interessati sia dagli stili delle parti che dagli stili delle parti degli elementi di previsione.
prediction-list
L'elemento visivo contenente l'elenco delle previsioni restituite dal servizio Place Autocomplete. Questo elenco viene visualizzato come elenco a discesa sotto PlaceAutocompleteElement.
background-color
Esegue l'override del colore di sfondo dell'elemento.
border
Esegue l'override del bordo dell'elemento.
border-radius
Esegue l'override del raggio del bordo dell'elemento.
color-scheme
Indica lo schema di colori in cui può essere visualizzato questo elemento. Per ulteriori dettagli, consulta la documentazione di color-scheme. Il valore predefinito è color-scheme: light dark.
addEventListener
addEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa sensibile alle maiuscole e minuscole 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 inviato alla destinazione. Vedi addEventListener.
removeEventListener
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 dal target un listener di eventi registrato in precedenza con addEventListener. Vedi removeEventListener.
gmp-error
function(errorEvent)
Argomenti: 
Questo evento viene attivato quando una richiesta al backend è stata rifiutata (ad es. chiave API errata). Questo evento non viene propagato.
gmp-select
function(placeSelectEvent)
Argomenti: 
Questo evento viene attivato quando un utente seleziona una previsione del luogo. Contiene un oggetto Place.

BasicPlaceAutocompleteElementOptions interfaccia

google.maps.places.BasicPlaceAutocompleteElementOptions interfaccia

Opzioni per la creazione di un BasicPlaceAutocompleteElement.
includedPrimaryTypes optional
Tipo:  Array<string> optional
includedRegionCodes optional
Tipo:  Array<string> optional
locationBias optional
Tipo:  LocationBias optional
locationRestriction optional
Tipo:  LocationRestriction optional
name optional
Tipo:  string optional
origin optional
requestedLanguage optional
Tipo:  string optional
requestedRegion optional
Tipo:  string optional
unitSystem optional
Tipo:  UnitSystem optional

PlaceAutocompleteElement class

google.maps.places.PlaceAutocompleteElement classe

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

PlaceAutocompleteElement utilizza internamente AutocompleteSessionToken per raggruppare le fasi di query e selezione della ricerca di completamento automatico di un utente.

La prima chiamata a Place.fetchFields su un Place restituito da PlacePrediction.toPlace includerà automaticamente il token di sessione utilizzato per recuperare PlacePrediction.

Per saperne di più su come funzionano le sessioni, consulta la pagina https://developers.google.com/maps/documentation/places/web-service/place-session-tokens.

Elemento personalizzato:
<gmp-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng" requested-language="string" requested-region="string" unit-system="metric"></gmp-place-autocomplete>

Questo corso si estende HTMLElement.

Questa classe implementa PlaceAutocompleteElementOptions.

Accesso chiamando il numero const {PlaceAutocompleteElement} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
PlaceAutocompleteElement
PlaceAutocompleteElement(options)
Parametri: 
includedPrimaryTypes
Tipo:  Array<string> optional
Tipo di luogo principale incluso (ad esempio "ristorante" o "stazione di servizio").

Un luogo viene restituito solo se il suo tipo principale è incluso in questo elenco. È possibile specificare fino a 5 valori. Se non vengono specificati tipi, vengono restituiti tutti i tipi di luoghi.
Attributo HTML:
  • <gmp-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-place-autocomplete>
includedRegionCodes
Tipo:  Array<string> optional
Includi solo i risultati nelle regioni specificate, indicate come massimo 15 codici di regione CLDR di due caratteri. Un insieme vuoto non limiterà i risultati. Se sono impostati sia locationRestriction sia includedRegionCodes, i risultati si troveranno nell'area di intersezione.
Attributo HTML:
  • <gmp-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-place-autocomplete>
locationBias
Tipo:  LocationBias optional
Un confine o un suggerimento da utilizzare durante la ricerca di luoghi.
locationRestriction
Tipo:  LocationRestriction optional
Confini per limitare i risultati di ricerca.
name
Tipo:  string optional
Il nome da utilizzare per l'elemento di input. Per i dettagli, consulta la pagina https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name. Segue lo stesso comportamento dell'attributo nome per gli input. Tieni presente che questo è il nome che verrà utilizzato quando viene inviato un modulo. Per i dettagli, vai alla pagina https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form.
Attributo HTML:
  • <gmp-place-autocomplete name="string"></gmp-place-autocomplete>
origin
L'origine da cui calcolare la distanza. Se non specificata, la distanza non viene calcolata. L'altitudine, se fornita, non viene utilizzata nel calcolo.
Attributo HTML:
  • <gmp-place-autocomplete origin="lat,lng"></gmp-place-autocomplete>
  • <gmp-place-autocomplete origin="lat,lng,altitude"></gmp-place-autocomplete>
requestedLanguage
Tipo:  string optional
Un identificatore di 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.
Attributo HTML:
  • <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion
Tipo:  string optional
Un codice regione utilizzato per la formattazione e il filtraggio dei risultati. Non limita i suggerimenti a questo paese. Il codice regione accetta un valore di due caratteri 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 TLD nazionale del Regno Unito è "uk " (.co.uk), mentre il suo 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>
unitSystem
Tipo:  UnitSystem optional
Il sistema di unità di misura utilizzato per visualizzare le distanze. Se non specificato, il sistema di unità viene determinato da requestedRegion.
Attributo HTML:
  • <gmp-place-autocomplete unit-system="metric"></gmp-place-autocomplete>
  • <gmp-place-autocomplete unit-system="imperial"></gmp-place-autocomplete>
prediction-item-icon
Questo spazio accetta esattamente un elemento <template> da visualizzare come icona accanto all'elemento di previsione.
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 dei suggerimenti.
prediction-item-main-text
Una parte dell'elemento di previsione che costituisce il testo principale della previsione. Per le località geografiche, contiene il nome di un luogo, ad esempio "Sydney", o il nome e il numero di una via, ad esempio "Via del Re, 10". Per impostazione predefinita, il testo principale dell'elemento di previsione è nero. Se nell'elemento di previsione è presente altro testo, questo si trova al di fuori di prediction-item-main-text e eredita lo stile da prediction-item. Per impostazione predefinita è colorato di 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, questo testo corrispondente viene evidenziato in grassetto. Tieni presente che il testo corrispondente può trovarsi ovunque all'interno di prediction-item. Non fa necessariamente parte di prediction-item-main-text.
prediction-item-selected
L'elemento quando l'utente lo seleziona tramite la tastiera. Nota: gli elementi selezionati saranno interessati sia dagli stili delle parti che dagli stili delle parti degli elementi di previsione.
prediction-list
L'elemento visivo contenente l'elenco delle previsioni restituite dal servizio Place Autocomplete. Questo elenco viene visualizzato come elenco a discesa sotto PlaceAutocompleteElement.
background-color
Esegue l'override del colore di sfondo dell'elemento.
border
Esegue l'override del bordo dell'elemento.
border-radius
Esegue l'override del raggio del bordo dell'elemento.
color-scheme
Indica lo schema di colori in cui può essere visualizzato questo elemento. Per ulteriori dettagli, consulta la documentazione di color-scheme. Il valore predefinito è color-scheme: light dark.
addEventListener
addEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa sensibile alle maiuscole e minuscole 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 inviato alla destinazione. Vedi addEventListener.
removeEventListener
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 dal target un listener di eventi registrato in precedenza con addEventListener. Vedi removeEventListener.
gmp-error
function(errorEvent)
Argomenti: 
Questo evento viene attivato quando una richiesta al backend è stata rifiutata (ad es. chiave API errata). Questo evento non viene propagato.
gmp-select
function(placePredictionSelectEvent)
Argomenti: 
Questo evento viene attivato quando un utente seleziona una previsione del luogo. Contiene un oggetto PlacePrediction che può essere convertito in un oggetto Place.

PlaceAutocompleteElementOptions

google.maps.places.PlaceAutocompleteElementOptions interfaccia

Opzioni per la creazione di un elemento PlaceAutocompleteElement. Per la descrizione di ogni proprietà, fai riferimento alla proprietà con lo stesso nome nella classe PlaceAutocompleteElement.
includedPrimaryTypes optional
Tipo:  Array<string> optional
includedRegionCodes optional
Tipo:  Array<string> optional
locationBias optional
Tipo:  LocationBias optional
locationRestriction optional
Tipo:  LocationRestriction optional
name optional
Tipo:  string optional
origin optional
requestedLanguage optional
Tipo:  string optional
requestedRegion optional
Tipo:  string optional
unitSystem optional
Tipo:  UnitSystem optional

Classe PlacePredictionSelectEvent

google.maps.places.PlacePredictionSelectEvent classe

Questo evento viene creato dopo che l'utente seleziona un elemento di previsione con PlaceAutocompleteElement. Accedi alla selezione con event.placePrediction.

Converti placePrediction in un Place chiamando PlacePrediction.toPlace.

Questo corso si estende Event.

Accesso chiamando il numero const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
placePrediction
Converti questo abbonamento in un abbonamento Place chiamando il numero PlacePrediction.toPlace.

Classe PlaceContextualElement

google.maps.places.PlaceContextualElement classe

Un widget che utilizza il token di contesto per visualizzare una visualizzazione contestuale della risposta di Grounding con Google Maps.

Elemento personalizzato:
<gmp-place-contextual context-token="string"></gmp-place-contextual>

Questo corso si estende HTMLElement.

Questa classe implementa PlaceContextualElementOptions.

Accesso chiamando il numero const {PlaceContextualElement} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
PlaceContextualElement
PlaceContextualElement([options])
Parametri: 
contextToken
Tipo:  string optional
Il token di contesto.
Attributo HTML:
  • <gmp-place-contextual context-token="string"></gmp-place-contextual>
addEventListener
addEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa sensibile alle maiuscole e minuscole 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 inviato alla destinazione. Vedi addEventListener.
removeEventListener
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 dal target un listener di eventi registrato in precedenza con addEventListener. Vedi removeEventListener.

Interfaccia PlaceContextualElementOptions

google.maps.places.PlaceContextualElementOptions interfaccia

Opzioni per PlaceContextualElement.
contextToken optional
Tipo:  string optional
Il token di contesto fornito dalla risposta di Grounding con Google Maps.

Classe PlaceContextualListConfigElement

google.maps.places.PlaceContextualListConfigElement classe

Un elemento HTML che configura le opzioni per la visualizzazione elenco dell'elemento contestuale del luogo.

Elemento personalizzato:
<gmp-place-contextual-list-config layout="compact" map-hidden map-mode="none"></gmp-place-contextual-list-config>

Questo corso si estende HTMLElement.

Questa classe implementa PlaceContextualListConfigElementOptions.

Accesso chiamando il numero const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
PlaceContextualListConfigElement
PlaceContextualListConfigElement([options])
Parametri: 
layout
Tipo:  PlaceContextualListLayout optional
Il layout.
Attributo HTML:
  • <gmp-place-contextual-list-config layout="compact"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config layout="vertical"></gmp-place-contextual-list-config>
mapHidden
Tipo:  boolean optional
Indica se la mappa è nascosta.
Attributo HTML:
  • <gmp-place-contextual-list-config map-hidden></gmp-place-contextual-list-config>
mapMode
La modalità mappa utilizzata nell'elemento contestuale del luogo per un elenco di luoghi.
Attributo HTML:
  • <gmp-place-contextual-list-config map-mode="none"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config map-mode="roadmap"></gmp-place-contextual-list-config>
  • <gmp-place-contextual-list-config map-mode="hybrid"></gmp-place-contextual-list-config>
addEventListener
addEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa sensibile alle maiuscole e minuscole 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 inviato alla destinazione. Vedi addEventListener.
removeEventListener
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 dal target un listener di eventi registrato in precedenza con addEventListener. Vedi removeEventListener.

Interfaccia PlaceContextualListConfigElementOptions

google.maps.places.PlaceContextualListConfigElementOptions interfaccia

Opzioni per PlaceContextualListConfigElement.
layout optional
Tipo:  PlaceContextualListLayout optional
Predefinito: PlaceContextualListLayout.VERTICAL
Il layout.
mapHidden optional
Tipo:  boolean optional
Predefinito: false
True se la mappa deve essere nascosta.
mapMode optional
Predefinito: PlaceContextualListMapMode.ROADMAP
La modalità mappa utilizzata nell'elemento contestuale del luogo per un elenco di luoghi.

PlaceContextualListLayout costanti

google.maps.places.PlaceContextualListLayout costanti

L'elenco dei layout supportati dall'elemento contestuale del luogo per la visualizzazione elenco.

Accesso chiamando il numero const {PlaceContextualListLayout} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
COMPACT Layout elenco compatto: gli elementi dell'elenco vengono visualizzati come link su una sola riga, con i contenuti in eccesso in un elenco a discesa.
VERTICAL Layout elenco verticale: gli elementi dell'elenco vengono visualizzati come schede in un elenco verticale.

Costanti PlaceContextualListMapMode

google.maps.places.PlaceContextualListMapMode costanti

La modalità mappa utilizzata nell'elemento contestuale del luogo per un elenco di luoghi.

Accesso chiamando il numero const {PlaceContextualListMapMode} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
HYBRID Un livello trasparente di strade principali su immagini satellitari o fotorealistiche in 3D.
NONE Nessuna mappa.
ROADMAP Una normale mappa stradale 2D.

PlaceDetailsElement class

google.maps.places.PlaceDetailsElement classe

Mostra i dettagli di un luogo in un layout completo. Aggiungi PlaceDetailsPlaceRequestElement o PlaceDetailsLocationRequestElement per specificare il luogo da visualizzare. Aggiungi PlaceContentConfigElement, PlaceStandardContentElement o PlaceAllContentElement per specificare i contenuti da visualizzare.

Esempio: 

 <gmp-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-details>

Per utilizzare questo elemento, attiva l'API Places UI Kit per il tuo progetto nella console Google Cloud.

Elemento personalizzato:
<gmp-place-details></gmp-place-details>

Questo corso si estende HTMLElement.

Questa classe implementa PlaceDetailsElementOptions.

Accesso chiamando il numero const {PlaceDetailsElement} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
PlaceDetailsElement
PlaceDetailsElement([options])
Parametri: 
place
Tipo:  Place optional
Sola lettura. Oggetto luogo contenente l'ID, la posizione e il riquadro visibile del luogo attualmente visualizzato.
--gmp-button-border-color
Colore del bordo del pulsante "Apri in Maps".
--gmp-button-border-radius
Raggio del bordo del pulsante "Apri in Maps".
--gmp-button-border-width
Lo spessore del bordo del pulsante "Apri in Maps".
--gmp-collage-border-radius-outer
Raggio del bordo degli angoli esterni del collage multimediale.
--gmp-dialog-border-radius
Raggio del bordo della finestra di dialogo di divulgazione di Google Maps.
--gmp-mat-color-disabled-surface
Colore della superficie destinato a indicare stati disattivati o assenza. Utilizzato per le stelle vuote delle recensioni.
--gmp-mat-color-info
Colore degli elementi della UI con sentiment informativo. Utilizzato per l'icona della sedia a rotelle.
--gmp-mat-color-negative
Colore degli elementi dell'interfaccia utente con sentiment negativo. Utilizzato per il testo "Chiuso" nello stato Aperto ora.
--gmp-mat-color-neutral-container
Colore del contenitore per gli elementi UI riempiti neutri. Utilizzato per i segnaposto delle immagini e il badge della data di pubblicazione della recensione.
--gmp-mat-color-on-neutral-container
Colore del testo e delle icone rispetto al colore neutro del contenitore. Utilizzato per il badge della data di pubblicazione della recensione e per il badge di disponibilità del caricatore per veicoli elettrici quando non è disponibile.
--gmp-mat-color-on-positive-container
Colore dei testi e delle icone rispetto al colore del contenitore positivo. Utilizzato per il badge di disponibilità della stazione di ricarica EV, se disponibile.
--gmp-mat-color-on-secondary-container
Colore del testo e delle icone rispetto al colore del contenitore secondario. Utilizzato per il testo e le icone del pulsante "Apri in Maps".
--gmp-mat-color-on-surface
Colore per testo e icone su qualsiasi colore della superficie. Utilizzato per il testo normale.
--gmp-mat-color-on-surface-variant
Colore a bassa enfasi per testo e icone su qualsiasi colore di superficie. Utilizzato per il testo meno enfatizzato.
--gmp-mat-color-outline-decorative
Colore del contorno degli elementi non interattivi. Utilizzato per il bordo dell'elemento.
--gmp-mat-color-positive
Colore degli elementi UI con sentiment positivo. Utilizzato per il testo "Aperto" nello stato Aperto ora.
--gmp-mat-color-positive-container
Colore del contenitore per gli elementi UI che trasmettono un sentimento positivo. Utilizzato per il badge di disponibilità della stazione di ricarica EV, se disponibile.
--gmp-mat-color-primary
Colore del testo e delle icone interattivi rispetto al colore della superficie. Utilizzato per il conteggio delle recensioni, i link nella finestra di dialogo delle informative di Google Maps, il link al sito web, le icone nella scheda Panoramica e (al passaggio del mouse / focus / colore del testo) nei titoli della barra delle schede.
--gmp-mat-color-secondary-container
Colore di riempimento meno evidente sulla superficie, per i componenti recessivi come i pulsanti tonali. Utilizzato per lo sfondo del pulsante "Apri in Maps".
--gmp-mat-color-surface
Colore per gli sfondi. Utilizzato per gli sfondi dell'elemento e della finestra di dialogo con le informative di Google Maps.
--gmp-mat-font-body-medium
Utilizzato per l'indirizzo, la valutazione, il tipo, il prezzo, lo stato aperto ora, gli orari di apertura, la recensione, il numero di telefono, il sito web, il plus code, le funzionalità principali e il corpo del testo nella finestra di dialogo delle informative di Google Maps.
--gmp-mat-font-body-small
Utilizzato per il corpo del testo nell'elenco delle funzionalità nella scheda "Informazioni".
--gmp-mat-font-display-small
Utilizzato per il nome del luogo e il testo di ogni intestazione delle funzionalità nella scheda "Informazioni".
--gmp-mat-font-family
Famiglia di caratteri di base utilizzata per tutto il testo.
--gmp-mat-font-headline-medium
Utilizzato per il testo dell'intestazione nella finestra di dialogo delle informative di Google Maps.
--gmp-mat-font-label-large
Utilizzato per i titoli delle schede, il pulsante "Apri in Maps", il testo di attribuzione dell'autore della recensione nella galleria fotografica, il testo di attribuzione dell'autore della recensione nella sezione delle recensioni e i link nella finestra di dialogo delle informative di Google Maps.
--gmp-mat-font-label-medium
Utilizzato per il badge con il conteggio delle foto e il badge con la data di pubblicazione della recensione.
--gmp-mat-font-title-small
Utilizzato per il titolo di ogni sezione nella scheda "Informazioni".
--gmp-mat-spacing-extra-large
Utilizzato per la spaziatura all'interno dell'elemento, ad esempio il margine e il padding intorno al testo.
--gmp-mat-spacing-extra-small
Utilizzato per la spaziatura all'interno dell'elemento, ad esempio il margine e il padding intorno al testo.
--gmp-mat-spacing-large
Utilizzato per la spaziatura all'interno dell'elemento, ad esempio il margine e il padding intorno al testo.
--gmp-mat-spacing-medium
Utilizzato per la spaziatura all'interno dell'elemento, ad esempio il margine e il padding intorno al testo.
--gmp-mat-spacing-small
Utilizzato per la spaziatura all'interno dell'elemento, ad esempio il margine e il padding intorno al testo.
--gmp-mat-spacing-two-extra-large
Utilizzato per la spaziatura all'interno dell'elemento, ad esempio il margine e il padding intorno al testo.
--gmp-star-rating-color
Il colore delle stelle piene nella valutazione.
background-color
Esegue l'override del colore di sfondo dell'elemento.
border
Esegue l'override del bordo dell'elemento.
border-radius
Esegue l'override del raggio del bordo dell'elemento.
color-scheme
Indica lo schema di colori in cui può essere visualizzato questo elemento. Per ulteriori dettagli, consulta la documentazione di color-scheme. Il valore predefinito è color-scheme: light dark.
font-size
Scala tutto il testo e le icone nell'elemento, che sono definiti internamente in em. Il valore predefinito è 16px.
addEventListener
addEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa sensibile alle maiuscole e minuscole 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 inviato alla destinazione. Vedi addEventListener.
removeEventListener
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 dal target un listener di eventi registrato in precedenza con addEventListener. Vedi removeEventListener.
gmp-error
function(event)
Argomenti: 
Questo evento viene attivato quando una richiesta al backend è stata rifiutata (ad es. chiave API errata). Questo evento non viene propagato.
gmp-load
function(event)
Argomenti: 
Questo evento viene attivato quando l'elemento carica e visualizza i suoi contenuti. Questo evento non viene propagato.

PlaceDetailsElementOptions interfaccia

google.maps.places.PlaceDetailsElementOptions interfaccia

Opzioni per PlaceDetailsElement.

PlaceDetailsCompactElement class

google.maps.places.PlaceDetailsCompactElement classe

Mostra i dettagli di un luogo in un layout compatto. Aggiungi un PlaceDetailsPlaceRequestElement o un PlaceDetailsLocationRequestElement per specificare il luogo da visualizzare. Aggiungi PlaceContentConfigElement, PlaceStandardContentElement o PlaceAllContentElement per specificare i contenuti da visualizzare.

Esempio: 

 <gmp-place-details-compact>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-details-compact>

Per utilizzare questo elemento, attiva l'API Places UI Kit per il tuo progetto nella console Google Cloud.

Elemento personalizzato:
<gmp-place-details-compact orientation="vertical" truncation-preferred></gmp-place-details-compact>

Questo corso si estende HTMLElement.

Questa classe implementa PlaceDetailsCompactElementOptions.

Accesso chiamando il numero const {PlaceDetailsCompactElement} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
PlaceDetailsCompactElement
PlaceDetailsCompactElement([options])
Parametri: 
orientation
Tipo:  PlaceDetailsOrientation optional
Predefinito: PlaceDetailsOrientation.VERTICAL
La variante di orientamento (verticale o orizzontale) dell'elemento.
Attributo HTML:
  • <gmp-place-details-compact orientation="vertical"></gmp-place-details-compact>
  • <gmp-place-details-compact orientation="horizontal"></gmp-place-details-compact>
place
Tipo:  Place optional
Sola lettura. Oggetto luogo contenente l'ID, la posizione e il riquadro visibile del luogo attualmente visualizzato.
truncationPreferred
Tipo:  boolean
Predefinito: false
Se il valore è true, il nome e l'indirizzo del luogo vengono troncati per essere visualizzati su una sola riga anziché essere mandati a capo.
Attributo HTML:
  • <gmp-place-details-compact truncation-preferred></gmp-place-details-compact>
--gmp-button-border-color
Colore del bordo del pulsante "Apri in Maps".
--gmp-button-border-radius
Raggio del bordo del pulsante "Apri in Maps".
--gmp-button-border-width
Lo spessore del bordo del pulsante "Apri in Maps".
--gmp-dialog-border-radius
Raggio del bordo della finestra di dialogo di divulgazione di Google Maps.
--gmp-mat-color-info
Colore degli elementi della UI con sentiment informativo. Utilizzato per l'icona della sedia a rotelle.
--gmp-mat-color-negative
Colore degli elementi dell'interfaccia utente con sentiment negativo. Utilizzato per il testo "Chiuso" nello stato Aperto ora.
--gmp-mat-color-neutral-container
Colore del contenitore per gli elementi UI riempiti neutri. Utilizzato per i segnaposto delle immagini.
--gmp-mat-color-on-secondary-container
Colore del testo e delle icone rispetto al colore del contenitore secondario. Utilizzato per il testo e le icone del pulsante "Apri in Maps".
--gmp-mat-color-on-surface
Colore per testo e icone su qualsiasi colore della superficie. Utilizzato per il testo normale.
--gmp-mat-color-on-surface-variant
Colore a bassa enfasi per testo e icone su qualsiasi colore di superficie. Utilizzato per il testo meno enfatizzato.
--gmp-mat-color-outline-decorative
Colore del contorno degli elementi non interattivi. Utilizzato per il bordo dell'elemento.
--gmp-mat-color-positive
Colore degli elementi UI con sentiment positivo. Utilizzato per il testo "Aperto" nello stato Aperto ora.
--gmp-mat-color-primary
Colore del testo e delle icone interattivi rispetto al colore della superficie. Utilizzato per il conteggio delle recensioni, nonché per i link nella finestra di dialogo delle informative di Google Maps.
--gmp-mat-color-secondary-container
Colore di riempimento meno evidente sulla superficie, per i componenti recessivi come i pulsanti tonali. Utilizzato per lo sfondo del pulsante "Apri in Maps".
--gmp-mat-color-surface
Colore per gli sfondi. Utilizzato per gli sfondi dell'elemento e della finestra di dialogo con le informative di Google Maps.
--gmp-mat-font-body-medium
Utilizzato per il corpo del testo nella finestra di dialogo delle informative di Google Maps.
--gmp-mat-font-body-small
Utilizzato per l'indirizzo, la valutazione, il tipo, il prezzo e lo stato aperto ora del luogo.
--gmp-mat-font-family
Famiglia di caratteri di base utilizzata per tutto il testo.
--gmp-mat-font-headline-medium
Utilizzato per il testo dell'intestazione nella finestra di dialogo delle informative di Google Maps.
--gmp-mat-font-label-large
Utilizzato per il pulsante "Apri in Maps", nonché per i link nella finestra di dialogo delle informative di Google Maps e per il testo di attribuzione dell'autore della recensione nella galleria fotografica.
--gmp-mat-font-label-medium
Utilizzato per il badge del conteggio delle foto.
--gmp-mat-font-title-small
Utilizzato per il nome del luogo.
--gmp-mat-spacing-extra-small
Utilizzato per la spaziatura all'interno dell'elemento, ad esempio il margine e il padding intorno al testo.
--gmp-mat-spacing-large
Utilizzato per la spaziatura all'interno dell'elemento, ad esempio il margine e il padding intorno al testo.
--gmp-mat-spacing-medium
Utilizzato per la spaziatura all'interno dell'elemento, ad esempio il margine e il padding intorno al testo.
--gmp-mat-spacing-small
Utilizzato per la spaziatura all'interno dell'elemento, ad esempio il margine e il padding intorno al testo.
--gmp-star-rating-color
Il colore delle stelle piene nella valutazione.
--gmp-thumbnail-border-radius
Raggio del bordo dell'immagine in miniatura del luogo.
background-color
Esegue l'override del colore di sfondo dell'elemento.
border
Esegue l'override del bordo dell'elemento.
border-radius
Esegue l'override del raggio del bordo dell'elemento.
color-scheme
Indica lo schema di colori in cui può essere visualizzato questo elemento. Per ulteriori dettagli, consulta la documentazione di color-scheme. Il valore predefinito è color-scheme: light dark.
font-size
Scala tutto il testo e le icone nell'elemento, che sono definiti internamente in em. Il valore predefinito è 16px.
addEventListener
addEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa sensibile alle maiuscole e minuscole 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 inviato alla destinazione. Vedi addEventListener.
removeEventListener
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 dal target un listener di eventi registrato in precedenza con addEventListener. Vedi removeEventListener.
gmp-error
function(event)
Argomenti: 
Questo evento viene attivato quando una richiesta al backend è stata rifiutata (ad es. chiave API errata). Questo evento non viene propagato.
gmp-load
function(event)
Argomenti: 
Questo evento viene attivato quando l'elemento carica e visualizza i suoi contenuti. Questo evento non viene propagato.

Interfaccia PlaceDetailsCompactElementOptions

google.maps.places.PlaceDetailsCompactElementOptions interfaccia

Opzioni per PlaceDetailsCompactElement.
orientation optional
Tipo:  PlaceDetailsOrientation optional
Leggi i PlaceDetailsCompactElement.orientation.
truncationPreferred optional
Tipo:  boolean optional
Leggi i PlaceDetailsCompactElement.truncationPreferred.

Costanti PlaceDetailsOrientation

google.maps.places.PlaceDetailsOrientation costanti

Varianti di orientamento per PlaceDetailsCompactElement.

Accesso chiamando il numero const {PlaceDetailsOrientation} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
HORIZONTAL Orientamento orizzontale.
VERTICAL Orientamento verticale.

PlaceDetailsPlaceRequestElement class

google.maps.places.PlaceDetailsPlaceRequestElement classe

Configura un PlaceDetailsCompactElement o un PlaceDetailsElement per caricare i dati in base a un oggetto luogo, a un ID o a un nome della risorsa. Aggiungi questo elemento come elemento secondario di PlaceDetailsCompactElement o PlaceDetailsElement per caricare i dati del luogo specificato. Ad esempio: 

 <gmp-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
 </gmp-place-details>

Elemento personalizzato:
<gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>

Questo corso si estende HTMLElement.

Questa classe implementa PlaceDetailsPlaceRequestElementOptions.

Accesso chiamando il numero const {PlaceDetailsPlaceRequestElement} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
PlaceDetailsPlaceRequestElement
PlaceDetailsPlaceRequestElement([options])
Parametri: 
place
Tipo:  Place optional
Predefinito: null
L'oggetto luogo, l'ID o il nome della risorsa per cui visualizzare i dettagli nell'elemento compatto Dettagli luogo. Questa proprietà riflette l'attributo come nome risorsa.
Attributo HTML:
  • <gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>
addEventListener
addEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa sensibile alle maiuscole e minuscole 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 inviato alla destinazione. Vedi addEventListener.
removeEventListener
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 dal target un listener di eventi registrato in precedenza con addEventListener. Vedi removeEventListener.

PlaceDetailsPlaceRequestElementOptions interfaccia

google.maps.places.PlaceDetailsPlaceRequestElementOptions interfaccia

Opzioni per PlaceDetailsPlaceRequestElement.
place optional
Tipo:  Place|string optional
Visualizza PlaceDetailsPlaceRequestElement.place

PlaceDetailsLocationRequestElement class

google.maps.places.PlaceDetailsLocationRequestElement classe

Configura un PlaceDetailsCompactElement o un PlaceDetailsElement per caricare i dati in base a una località. Aggiungi questo elemento come elemento secondario di PlaceDetailsCompactElement o PlaceDetailsElement per caricare i dati per la posizione specificata. Ad esempio: 

 <gmp-place-details>
   <gmp-place-details-location-request
     location="37.6207665,-122.4284806"
   ></gmp-place-details-location-request>
 </gmp-place-details>

Elemento personalizzato:
<gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>

Questo corso si estende HTMLElement.

Questa classe implementa PlaceDetailsLocationRequestElementOptions.

Accesso chiamando il numero const {PlaceDetailsLocationRequestElement} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
PlaceDetailsLocationRequestElement
PlaceDetailsLocationRequestElement([options])
Parametri: 
location
Predefinito: null
La posizione per cui visualizzare i dettagli nell'elemento Dettagli luogo. Normalizza a un valore LatLngAltitude.
Attributo HTML:
  • <gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>
addEventListener
addEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa sensibile alle maiuscole e minuscole 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 inviato alla destinazione. Vedi addEventListener.
removeEventListener
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 dal target un listener di eventi registrato in precedenza con addEventListener. Vedi removeEventListener.

Interfaccia PlaceDetailsLocationRequestElementOptions

google.maps.places.PlaceDetailsLocationRequestElementOptions interfaccia

Opzioni per PlaceDetailsLocationRequestElement.
location optional
La posizione in cui eseguire il rendering del luogo.

PlaceSearchElement class

google.maps.places.PlaceSearchElement classe

Visualizza i risultati di una ricerca di un luogo in un elenco. Aggiungi un PlaceTextSearchRequestElement o un PlaceNearbySearchRequestElement per specificare la richiesta di rendering dei risultati. Aggiungi PlaceContentConfigElement, PlaceStandardContentElement o PlaceAllContentElement per specificare i contenuti da visualizzare.

Esempio: 

 <gmp-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search>

Per utilizzare l'elemento di ricerca di luoghi, attiva l'API Places UI Kit per il tuo progetto nella console Google Cloud.

Elemento personalizzato:
<gmp-place-search attribution-position="top" orientation="vertical" selectable truncation-preferred></gmp-place-search>

Questo corso si estende HTMLElement.

Questa classe implementa PlaceSearchElementOptions.

Accesso chiamando il numero const {PlaceSearchElement} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
PlaceSearchElement
PlaceSearchElement([options])
Parametri: 
attributionPosition
Predefinito: PlaceSearchAttributionPosition.TOP
La posizione del logo di attribuzione e del pulsante di divulgazione legale.
Attributo HTML:
  • <gmp-place-search attribution-position="top"></gmp-place-search>
  • <gmp-place-search attribution-position="bottom"></gmp-place-search>
orientation
Tipo:  PlaceSearchOrientation optional
Predefinito: PlaceSearchOrientation.VERTICAL
La variante di orientamento (verticale o orizzontale) dell'elemento.
Attributo HTML:
  • <gmp-place-search orientation="vertical"></gmp-place-search>
  • <gmp-place-search orientation="horizontal"></gmp-place-search>
places
Tipo:  Array<Place>
Sola lettura. Array di oggetti Place contenenti gli ID, le posizioni e i viewport dei luoghi attualmente visualizzati.
selectable
Tipo:  boolean optional
Predefinito: false
Indica se gli elementi dell'elenco sono selezionabili. Se il valore è true, gli elementi dell'elenco saranno pulsanti che attivano l'evento gmp-select quando vengono selezionati. Sono supportate anche la navigazione e la selezione da tastiera accessibili.
Attributo HTML:
  • <gmp-place-search selectable></gmp-place-search>
truncationPreferred
Tipo:  boolean optional
Predefinito: false
Se il valore è vero, tronca alcune righe di contenuti per adattarle a una riga anziché mandarle a capo.
Attributo HTML:
  • <gmp-place-search truncation-preferred></gmp-place-search>
--gmp-button-border-color
Colore del bordo del pulsante "Apri in Maps".
--gmp-button-border-radius
Raggio bordo per il pulsante "Apri in Maps".
--gmp-button-border-width
Larghezza del bordo del pulsante "Apri in Maps".
--gmp-card-border-radius
Raggio del bordo per le schede dei luoghi.
--gmp-dialog-border-radius
Raggio del bordo per la finestra di dialogo di divulgazione di Google Maps.
--gmp-mat-color-info
Colore degli elementi della UI con sentiment informativo. Utilizzato per l'icona dell'ingresso accessibile.
--gmp-mat-color-negative
Colore degli elementi dell'interfaccia utente con sentiment negativo. Utilizzato per l'etichetta"Chiuso" per gli orari di apertura di un luogo.
--gmp-mat-color-neutral-container
Colore del contenitore per gli elementi UI riempiti neutri. Utilizzato per i badge con la data della recensione e per caricare le forme dei segnaposto.
--gmp-mat-color-on-neutral-container
Colore del testo e delle icone su un contenitore neutro. Utilizzato per il testo della data di revisione e il testo dell'errore di caricamento.
--gmp-mat-color-on-secondary-container
Colore del testo e delle icone rispetto a un colore del contenitore secondario. Utilizzato per il testo dei pulsanti e le icone.
--gmp-mat-color-on-surface
Colore per testo e icone su un colore di superficie. Utilizzato per i titoli e i contenuti delle finestre di dialogo.
--gmp-mat-color-on-surface-variant
Colore con enfasi minore per testo e icone su un colore di superficie. Utilizzato per le informazioni sui luoghi.
--gmp-mat-color-outline-decorative
Colore del contorno degli elementi non interattivi. Utilizzato per il bordo del contenitore.
--gmp-mat-color-positive
Colore degli elementi UI con sentiment positivo. Utilizzato per l'etichetta"Aperto" per gli orari di apertura di un luogo.
--gmp-mat-color-primary
Colore del testo e delle icone interattivi rispetto al colore della superficie. Utilizzato per link, indicatore di caricamento e icone di panoramica.
--gmp-mat-color-secondary-container
Colore di riempimento meno evidente su una superficie. Utilizzato per gli sfondi dei pulsanti.
--gmp-mat-color-surface
Colore per gli sfondi. Utilizzato per gli sfondi di container e dialoghi.
--gmp-mat-font-body-small
Utilizzato per le informazioni sui luoghi.
--gmp-mat-font-family
Famiglia di caratteri di base per tutto il testo.
--gmp-mat-font-headline-medium
Utilizzato per le intestazioni delle finestre di dialogo.
--gmp-mat-font-label-large
Utilizzato per il contenuto del pulsante.
--gmp-mat-font-title-medium
Utilizzato per il nome del luogo.
--gmp-mat-spacing-extra-small
Utilizzato per la spaziatura all'interno dell'elemento, ad esempio il margine e il padding intorno al testo.
--gmp-mat-spacing-large
Utilizzato per la spaziatura all'interno dell'elemento, ad esempio il margine e il padding intorno al testo.
--gmp-mat-spacing-medium
Utilizzato per la spaziatura all'interno dell'elemento, ad esempio il margine e il padding intorno al testo.
--gmp-mat-spacing-small
Utilizzato per la spaziatura all'interno dell'elemento, ad esempio il margine e il padding intorno al testo.
--gmp-star-rating-color
Colore delle stelle piene in una valutazione a stelle.
--gmp-thumbnail-border-radius
Raggio del bordo per l'immagine in miniatura del luogo.
background-color
Esegue l'override del colore di sfondo dell'elemento.
border
Esegue l'override del bordo dell'elemento.
border-radius
Esegue l'override del raggio del bordo dell'elemento.
color-scheme
Indica lo schema di colori in cui può essere visualizzato questo elemento. Per ulteriori dettagli, consulta la documentazione di color-scheme. Il valore predefinito è color-scheme: light dark.
font-size
Scala tutto il testo e le icone nell'elemento. Il valore predefinito è 16px.
addEventListener
addEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa sensibile alle maiuscole e minuscole 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 inviato alla destinazione. Vedi addEventListener.
removeEventListener
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 dal target un listener di eventi registrato in precedenza con addEventListener. Vedi removeEventListener.
gmp-error
function(event)
Argomenti: 
Questo evento viene attivato quando una richiesta al backend è stata rifiutata (ad es. chiave API errata). Questo evento non viene propagato.
gmp-load
function(event)
Argomenti: 
Questo evento viene attivato quando l'elemento carica e visualizza i suoi contenuti. Questo evento non viene propagato.
gmp-select
function(event)
Argomenti: 
Questo evento viene attivato quando viene selezionato un luogo dall'elenco. Contiene un oggetto Place contenente l'ID, la posizione e la finestra di visualizzazione del luogo selezionato.

Interfaccia PlaceSearchElementOptions

google.maps.places.PlaceSearchElementOptions interfaccia

Opzioni per PlaceSearchElement.
attributionPosition optional
Leggi i PlaceSearchElement.attributionPosition.
orientation optional
Tipo:  PlaceSearchOrientation optional
Leggi i PlaceSearchElement.orientation.
selectable optional
Tipo:  boolean optional
Visualizza PlaceSearchElement.selectable
truncationPreferred optional
Tipo:  boolean optional
Leggi i PlaceSearchElement.truncationPreferred.

Costanti PlaceSearchAttributionPosition

google.maps.places.PlaceSearchAttributionPosition costanti

Posizioni dell'attribuzione per PlaceSearchElement.

Accesso chiamando il numero const {PlaceSearchAttributionPosition} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
BOTTOM Attribuzione nella parte inferiore di PlaceSearchElement
TOP Attribuzione nella parte superiore di PlaceSearchElement

Costanti PlaceSearchOrientation

google.maps.places.PlaceSearchOrientation costanti

Varianti di orientamento per PlaceSearchElement.

Accesso chiamando il numero const {PlaceSearchOrientation} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
HORIZONTAL Orientamento orizzontale.
VERTICAL Orientamento verticale.

Classe PlaceSelectEvent

google.maps.places.PlaceSelectEvent classe

Questo evento viene attivato quando un luogo viene selezionato da un elenco di luoghi. Accedi alla selezione con event.place.

Questo corso si estende Event.

Accesso chiamando il numero const {PlaceSelectEvent} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
place
Tipo:  Place
Il luogo selezionato.

PlaceNearbySearchRequestElement class

google.maps.places.PlaceNearbySearchRequestElement classe

Configura un PlaceSearchElement per caricare i risultati in base a una richiesta di ricerca nelle vicinanze. La proprietà locationRestriction è obbligatoria per il caricamento dell'elemento di ricerca. Se locationRestriction non è impostato, tutte le altre proprietà configurate verranno ignorate. Aggiungi questo elemento come elemento secondario di un PlaceSearchElement per caricare i risultati. Ad esempio: 

 <gmp-place-search>
   <gmp-place-nearby-search-request
     location-restriction="RADIUS@LAT,LNG"
   ></gmp-place-nearby-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search>

Elemento personalizzato:
<gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..." excluded-types="excluded-type1 excluded-type2..." included-primary-types="included-primary-type1 included-primary-type2..." included-types="included-type1 included-type2..." location-restriction="radius@lat,lng" max-result-count="number" rank-preference="preference"></gmp-place-nearby-search-request>

Questo corso si estende HTMLElement.

Questa classe implementa PlaceNearbySearchRequestElementOptions.

Accesso chiamando il numero const {PlaceNearbySearchRequestElement} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
PlaceNearbySearchRequestElement
PlaceNearbySearchRequestElement([options])
Parametri: 
excludedPrimaryTypes
Tipo:  Array<string> optional
Predefinito: null
Attributo HTML:
  • <gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."></gmp-place-nearby-search-request>
excludedTypes
Tipo:  Array<string> optional
Predefinito: null
Attributo HTML:
  • <gmp-place-nearby-search-request excluded-types="excluded-type1 excluded-type2..."></gmp-place-nearby-search-request>
includedPrimaryTypes
Tipo:  Array<string> optional
Predefinito: null
Attributo HTML:
  • <gmp-place-nearby-search-request included-primary-types="included-primary-type1 included-primary-type2..."></gmp-place-nearby-search-request>
includedTypes
Tipo:  Array<string> optional
Predefinito: null
Attributo HTML:
  • <gmp-place-nearby-search-request included-types="included-type1 included-type2..."></gmp-place-nearby-search-request>
locationRestriction
Tipo:  Circle|CircleLiteral optional
Predefinito: null
Attributo HTML:
  • <gmp-place-nearby-search-request location-restriction="radius@lat,lng"></gmp-place-nearby-search-request>
maxResultCount
Tipo:  number optional
Predefinito: null
Attributo HTML:
  • <gmp-place-nearby-search-request max-result-count="number"></gmp-place-nearby-search-request>
rankPreference
Predefinito: null
Attributo HTML:
  • <gmp-place-nearby-search-request rank-preference="preference"></gmp-place-nearby-search-request>
addEventListener
addEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa sensibile alle maiuscole e minuscole 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 inviato alla destinazione. Vedi addEventListener.
removeEventListener
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 dal target un listener di eventi registrato in precedenza con addEventListener. Vedi removeEventListener.

Interfaccia PlaceNearbySearchRequestElementOptions

google.maps.places.PlaceNearbySearchRequestElementOptions interfaccia

Opzioni per PlaceNearbySearchRequestElement.
excludedPrimaryTypes optional
Tipo:  Array<string> optional
Tipi di luoghi principali esclusi. Per maggiori dettagli, consulta PlaceNearbySearchRequestElement.excludedPrimaryTypes e SearchNearbyRequest.excludedPrimaryTypes.
excludedTypes optional
Tipo:  Array<string> optional
Tipi di luoghi esclusi. Per maggiori dettagli, consulta PlaceNearbySearchRequestElement.excludedTypes e SearchNearbyRequest.excludedTypes.
includedPrimaryTypes optional
Tipo:  Array<string> optional
Tipi di luoghi principali inclusi. Per maggiori dettagli, consulta PlaceNearbySearchRequestElement.includedPrimaryTypes e SearchNearbyRequest.includedPrimaryTypes.
includedTypes optional
Tipo:  Array<string> optional
Tipi di luoghi inclusi. Per maggiori dettagli, consulta PlaceNearbySearchRequestElement.includedTypes e SearchNearbyRequest.includedTypes.
locationRestriction optional
Tipo:  Circle|CircleLiteral optional
La regione in cui eseguire la ricerca. Per maggiori dettagli, consulta PlaceNearbySearchRequestElement.locationRestriction e SearchNearbyRequest.locationRestriction.
maxResultCount optional
Tipo:  number optional
Il numero massimo di risultati da restituire. Per maggiori dettagli, consulta PlaceNearbySearchRequestElement.maxResultCount e SearchNearbyRequest.maxResultCount.
rankPreference optional
Come verranno classificati i risultati nella risposta. Per maggiori dettagli, consulta PlaceNearbySearchRequestElement.rankPreference e SearchNearbyRankPreference.

PlaceTextSearchRequestElement class

google.maps.places.PlaceTextSearchRequestElement classe

Configura un PlaceSearchElement per caricare i risultati in base a una richiesta di ricerca di testo. La proprietà textQuery è obbligatoria per il caricamento dell'elemento di ricerca. Se textQuery non è impostato, tutte le altre proprietà configurate verranno ignorate. Aggiungi questo elemento come elemento secondario di un PlaceSearchElement per caricare i risultati. Ad esempio: 

 <gmp-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search>

Elemento personalizzato:
<gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..." ev-minimum-charging-rate-kw="rate" included-type="type" is-open-now="true" location-bias="lat,lng" location-restriction="swlat,swlng|nelat,nelng" max-result-count="number" min-rating="number" price-levels="price-level1 price-level2..." rank-preference="preference" text-query="string" use-strict-type-filtering></gmp-place-text-search-request>

Questo corso si estende HTMLElement.

Questa classe implementa PlaceTextSearchRequestElementOptions.

Accesso chiamando il numero const {PlaceTextSearchRequestElement} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.
PlaceTextSearchRequestElement
PlaceTextSearchRequestElement([options])
Parametri: 
evConnectorTypes
Tipo:  Array<EVConnectorType> optional
Predefinito: null
Attributo HTML:
  • <gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..."></gmp-place-text-search-request>
evMinimumChargingRateKw
Tipo:  number optional
Predefinito: null
Attributo HTML:
  • <gmp-place-text-search-request ev-minimum-charging-rate-kw="rate"></gmp-place-text-search-request>
includedType
Tipo:  string optional
Predefinito: null
Attributo HTML:
  • <gmp-place-text-search-request included-type="type"></gmp-place-text-search-request>
isOpenNow
Tipo:  boolean optional
Predefinito: null
Attributo HTML:
  • <gmp-place-text-search-request is-open-now="true"></gmp-place-text-search-request>
locationBias
Predefinito: null
Attributo HTML:
  • <gmp-place-text-search-request location-bias="lat,lng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="lat,lng[,altitude]"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="swlat,swlng|nelat,nelng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="radius@lat,lng"></gmp-place-text-search-request>
  • <gmp-place-text-search-request location-bias="IP_BIAS"></gmp-place-text-search-request>
locationRestriction
Predefinito: null
Attributo HTML:
  • <gmp-place-text-search-request location-restriction="swlat,swlng|nelat,nelng"></gmp-place-text-search-request>
maxResultCount
Tipo:  number optional
Predefinito: null
Attributo HTML:
  • <gmp-place-text-search-request max-result-count="number"></gmp-place-text-search-request>
minRating
Tipo:  number optional
Predefinito: null
Attributo HTML:
  • <gmp-place-text-search-request min-rating="number"></gmp-place-text-search-request>
priceLevels
Tipo:  Array<PriceLevel> optional
Predefinito: null
Attributo HTML:
  • <gmp-place-text-search-request price-levels="price-level1 price-level2..."></gmp-place-text-search-request>
rankPreference
Predefinito: null
Attributo HTML:
  • <gmp-place-text-search-request rank-preference="preference"></gmp-place-text-search-request>
textQuery
Tipo:  string optional
Predefinito: null
Attributo HTML:
  • <gmp-place-text-search-request text-query="string"></gmp-place-text-search-request>
useStrictTypeFiltering
Tipo:  boolean optional
Predefinito: null
Attributo HTML:
  • <gmp-place-text-search-request use-strict-type-filtering></gmp-place-text-search-request>
addEventListener
addEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa sensibile alle maiuscole e minuscole 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 inviato alla destinazione. Vedi addEventListener.
removeEventListener
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 dal target un listener di eventi registrato in precedenza con addEventListener. Vedi removeEventListener.

Interfaccia PlaceTextSearchRequestElementOptions

google.maps.places.PlaceTextSearchRequestElementOptions interfaccia

Opzioni per PlaceTextSearchRequestElement.
evConnectorTypes optional
Tipo:  Array<EVConnectorType> optional
L'elenco dei tipi di connettori EV preferiti. Per maggiori dettagli, consulta SearchByTextRequest.evSearchOptions e PlaceTextSearchRequestElement.evConnectorTypes.
evMinimumChargingRateKw optional
Tipo:  number optional
Tasso di ricarica minimo richiesto in kilowatt. Per maggiori dettagli, consulta SearchByTextRequest.evSearchOptions e PlaceTextSearchRequestElement.evMinimumChargingRateKw.
includedType optional
Tipo:  string optional
Il tipo di luogo richiesto. Per maggiori dettagli, consulta SearchByTextRequest.includedType e PlaceTextSearchRequestElement.includedType.
isOpenNow optional
Tipo:  boolean optional
Utilizzato per limitare la ricerca ai luoghi attualmente aperti. Per maggiori dettagli, consulta SearchByTextRequest.isOpenNow e PlaceTextSearchRequestElement.isOpenNow.
locationBias optional
Preferenza di località per la ricerca. Per maggiori dettagli, consulta SearchByTextRequest.locationBias e PlaceTextSearchRequestElement.locationBias.
locationRestriction optional
Limitazione della località per la ricerca. Per maggiori dettagli, consulta SearchByTextRequest.locationRestriction e PlaceTextSearchRequestElement.locationRestriction.
maxResultCount optional
Tipo:  number optional
Il numero massimo di risultati da restituire. Per maggiori dettagli, consulta SearchByTextRequest.maxResultCount e PlaceTextSearchRequestElement.maxResultCount.
minRating optional
Tipo:  number optional
Filtra i risultati la cui valutazione media degli utenti è strettamente inferiore a questo limite. Per maggiori dettagli, consulta SearchByTextRequest.minRating e PlaceTextSearchRequestElement.minRating.
priceLevels optional
Tipo:  Array<PriceLevel> optional
Utilizzato per limitare la ricerca ai luoghi contrassegnati con determinati livelli di prezzo. Per maggiori dettagli, consulta SearchByTextRequest.priceLevels e PlaceTextSearchRequestElement.priceLevels.
rankPreference optional
Come verranno classificati i risultati nella risposta. Per maggiori dettagli, consulta SearchByTextRequest.rankPreference e PlaceTextSearchRequestElement.rankPreference.
textQuery optional
Tipo:  string optional
La query di testo per la ricerca testuale. Per maggiori dettagli, consulta SearchByTextRequest.textQuery e PlaceTextSearchRequestElement.textQuery.
useStrictTypeFiltering optional
Tipo:  boolean optional
Utilizzato per impostare il filtro dei tipi rigoroso per SearchByTextRequest.includedType. Per maggiori dettagli, consulta SearchByTextRequest.useStrictTypeFiltering e PlaceTextSearchRequestElement.useStrictTypeFiltering.

Classe Autocomplete

google.maps.places.Autocomplete classe

Un widget che fornisce previsioni sui luoghi in base all'input di testo di un utente. Si collega a un elemento di input di tipo text e ascolta l'inserimento di testo in quel campo. L'elenco delle previsioni viene visualizzato come elenco a discesa e viene aggiornato man mano che viene inserito il testo.

Questo corso si estende MVCObject.

Accesso chiamando il numero const {Autocomplete} = await google.maps.importLibrary("places").
Consulta 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 indicate.
getBounds
getBounds()
Parametri: nessuno
Valore restituito:  LatLngBounds|undefined i limiti di distorsione.
Restituisce i limiti a cui sono soggette le previsioni.
getFields
getFields()
Parametri: nessuno
Valore restituito:  Array<string>|undefined
Restituisce i campi da includere nella risposta dei dettagli del luogo 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 sono stati recuperati correttamente. In caso contrario, restituisce un oggetto Place stub, con la proprietà name impostata sul valore corrente del campo di input.
setBounds
setBounds(bounds)
Parametri: 
Valore restituito:nessuno
Imposta l'area preferita in cui restituire i risultati di Places. I risultati sono orientati verso questa zona, ma non sono limitati a questa.
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 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 vengono specificati tipi, verranno restituiti tutti i tipi.
Ereditato: 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 di dettagli sul luogo non va a buon fine, PlaceResult contiene l'input dell'utente nella proprietà name, senza altre proprietà definite.

Interfaccia AutocompleteOptions

google.maps.places.AutocompleteOptions interfaccia

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 principale. Ad esempio, il paese.
fields optional
Tipo:  Array<string> optional
Campi da includere nella risposta dei dettagli quando i dettagli vengono recuperati correttamente, per i quali verrà addebitato un costo. Se viene passato ['ALL'], verranno restituiti e fatturati tutti i campi disponibili (questa operazione non è consigliata per le implementazioni 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
Indica se recuperare solo gli ID luogo. Il PlaceResult reso disponibile quando viene attivato l'evento place_changed avrà solo i campi place_id, types e name, con place_id, types e description restituiti dal servizio Autocomplete. Disabilitato 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. Se imposti strictBounds su false (valore predefinito), i risultati saranno orientati verso i luoghi contenuti all'interno dei limiti, ma non limitati a questi.
types optional
Tipo:  Array<string> optional
I tipi di previsioni da restituire. Per i tipi supportati, consulta la guida per gli sviluppatori. Se non vengono specificati tipi, 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. Si collega a un elemento di input di tipo text e ascolta l'inserimento di testo in quel campo. L'elenco delle previsioni viene visualizzato come elenco a discesa e viene aggiornato man mano che viene inserito il testo.

Questo corso si estende MVCObject.

Accesso chiamando il numero const {SearchBox} = await google.maps.importLibrary("places").
Consulta 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 indicate.
getBounds
getBounds()
Parametri: nessuno
Valore restituito:  LatLngBounds|undefined
Restituisce i limiti a cui sono orientate 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 distorsione delle previsioni delle query. I risultati saranno orientati solo verso questa area e non saranno completamente limitati.
Ereditato: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
Argomenti: nessuno
Questo evento viene attivato quando l'utente seleziona una query. getPlaces deve essere utilizzato per ottenere nuovi luoghi.

Interfaccia SearchBoxOptions

google.maps.places.SearchBoxOptions interfaccia

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