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.

Costruttore
BasicPlaceAutocompleteElement	BasicPlaceAutocompleteElement(options) Parametri:  options:  BasicPlaceAutocompleteElementOptions

Proprietà
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	Tipo:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional 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>

Slot
prediction-item-icon	Questo spazio accetta esattamente un elemento <template> da visualizzare come icona accanto all'elemento di previsione.

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

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

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

Eventi
gmp-error	function(errorEvent) Argomenti:  errorEvent:  Event 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:  placeSelectEvent:  PlaceSelectEvent 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.

Proprietà
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	Tipo:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral 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.

Costruttore
PlaceAutocompleteElement	PlaceAutocompleteElement(options) Parametri:  options:  PlaceAutocompleteElementOptions

Proprietà
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	Tipo:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional 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>

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

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

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

Eventi
gmp-error	function(errorEvent) Argomenti:  errorEvent:  Event 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:  placePredictionSelectEvent:  PlacePredictionSelectEvent 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.

Proprietà
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	Tipo:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral 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.

Proprietà
placePrediction	Tipo:  PlacePrediction Converti questo abbonamento in un abbonamento Place chiamando il numero PlacePrediction.toPlace.

PlaceAutocompleteRequestErrorEvent class

google.maps.places.PlaceAutocompleteRequestErrorEvent classe

Deprecato: l'evento gmp-requesterror continuerà a essere attivato nel canale beta, ma non verrà attivato nella versione alpha o in quella di rilascio. Ai fini della migrazione, continua ad ascoltare l'evento gmp-requesterror, ma aggiungi anche un listener di eventi per l'evento gmp-error, che restituisce un oggetto Event.

Avviso: disponibile solo nel canale v=beta.

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

Questo corso si estende Event.

Accesso chiamando il numero const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places").
Consulta Librerie nell'API Maps JavaScript.

Classe PlaceContextualElement

google.maps.places.PlaceContextualElement classe

Avviso: disponibile solo nel canale alpha.

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.

Costruttore
PlaceContextualElement	PlaceContextualElement([options]) Parametri:  options:  PlaceContextualElementOptions optional

Proprietà
contextToken	Tipo:  string optional Il token di contesto. Attributo HTML: <gmp-place-contextual context-token="string"></gmp-place-contextual>

Metodi
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

Avviso: disponibile solo nel canale alpha.

Opzioni per PlaceContextualElement.

Proprietà
contextToken optional	Tipo:  string optional Il token di contesto fornito dalla risposta di Grounding con Google Maps.

Classe PlaceContextualListConfigElement

google.maps.places.PlaceContextualListConfigElement classe

Avviso: disponibile solo nel canale alpha.

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.

Costruttore
PlaceContextualListConfigElement	PlaceContextualListConfigElement([options]) Parametri:  options:  PlaceContextualListConfigElementOptions optional

Proprietà
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	Tipo:  PlaceContextualListMapMode optional 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>

Metodi
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

Avviso: disponibile solo nel canale alpha.

Opzioni per PlaceContextualListConfigElement.

Proprietà
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	Tipo:  PlaceContextualListMapMode 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

Avviso: disponibile solo nel canale alpha.

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.

Costanti
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

Avviso: disponibile solo nel canale alpha.

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.

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

Costruttore
PlaceDetailsElement	PlaceDetailsElement([options]) Parametri:  options:  PlaceDetailsElementOptions optional

Proprietà
place	Tipo:  Place optional Sola lettura. Oggetto luogo contenente l'ID, la posizione e il riquadro visibile del luogo attualmente visualizzato.

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

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

Eventi
gmp-error	function(event) Argomenti:  event:  Event 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:  event:  Event 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.

Costruttore
PlaceDetailsCompactElement	PlaceDetailsCompactElement([options]) Parametri:  options:  PlaceDetailsCompactElementOptions optional

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

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

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

Eventi
gmp-error	function(event) Argomenti:  event:  Event 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:  event:  Event 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.

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

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

Costruttore
PlaceDetailsPlaceRequestElement	PlaceDetailsPlaceRequestElement([options]) Parametri:  options:  PlaceDetailsPlaceRequestElementOptions optional

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

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

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

Costruttore
PlaceDetailsLocationRequestElement	PlaceDetailsLocationRequestElement([options]) Parametri:  options:  PlaceDetailsLocationRequestElementOptions optional

Proprietà
location	Tipo:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional 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>

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

Proprietà
location optional	Tipo:  LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral 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.

Costruttore
PlaceSearchElement	PlaceSearchElement([options]) Parametri:  options:  PlaceSearchElementOptions optional

Proprietà
attributionPosition	Tipo:  PlaceSearchAttributionPosition optional 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>

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

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

Eventi
gmp-error	function(event) Argomenti:  event:  Event 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:  event:  Event Questo evento viene attivato quando l'elemento carica e visualizza i suoi contenuti. Questo evento non viene propagato.
gmp-select	function(event) Argomenti:  event:  PlaceSelectEvent 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.

Proprietà
attributionPosition optional	Tipo:  PlaceSearchAttributionPosition 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.

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

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

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

Costruttore
PlaceNearbySearchRequestElement	PlaceNearbySearchRequestElement([options]) Parametri:  options:  PlaceNearbySearchRequestElementOptions optional

Proprietà
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	Tipo:  SearchNearbyRankPreference optional Predefinito: null Attributo HTML: <gmp-place-nearby-search-request rank-preference="preference"></gmp-place-nearby-search-request>

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

Proprietà
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	Tipo:  SearchNearbyRankPreference 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.

Costruttore
PlaceTextSearchRequestElement	PlaceTextSearchRequestElement([options]) Parametri:  options:  PlaceTextSearchRequestElementOptions optional

Proprietà
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	Tipo:  string|LatLngAltitude|LatLngBounds|Circle|LatLng|LatLngLiteral|LatLngAltitudeLiteral|LatLngBoundsLiteral|CircleLiteral optional 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	Tipo:  LatLngBounds|LatLngBoundsLiteral optional 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	Tipo:  SearchByTextRankPreference optional 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>

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

Proprietà
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	Tipo:  string|LatLngAltitude|LatLngBounds|Circle|LatLng|LatLngLiteral|LatLngAltitudeLiteral|LatLngBoundsLiteral|CircleLiteral optional Preferenza di località per la ricerca. Per maggiori dettagli, consulta SearchByTextRequest.locationBias e PlaceTextSearchRequestElement.locationBias.
locationRestriction optional	Tipo:  LatLngBounds|LatLngBoundsLiteral 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	Tipo:  SearchByTextRankPreference 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

Ritirato:a partire dal 1° marzo 2025, google.maps.places.Autocomplete non sarà disponibile per i nuovi clienti. Utilizza PlaceAutocompleteElement. Al momento, non è prevista la disattivazione di google.maps.places.Autocomplete, ma è consigliato l'utilizzo di PlaceAutocompleteElement al suo posto. Anche se google.maps.places.Autocomplete continuerà a ricevere correzioni di bug per eventuali regressioni importanti, i bug esistenti in google.maps.places.Autocomplete non verranno risolti. Verrà dato un preavviso di almeno 12 mesi prima dell'interruzione dell'assistenza. Per ulteriori dettagli, consulta la pagina https://developers.google.com/maps/legacy e la guida alla migrazione all'indirizzo https://developers.google.com/maps/documentation/javascript/places-migration-overview.

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.

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

Metodi
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:  bounds:  LatLngBounds|LatLngBoundsLiteral optional i limiti di distorsione. 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:  restrictions:  ComponentRestrictions optional le limitazioni di utilizzo. 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:  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 vengono specificati tipi, verranno restituiti tutti i tipi.
Ereditato: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

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

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

SearchBox class

google.maps.places.SearchBox classe

Ritirato:a partire dal 1° marzo 2025, google.maps.places.SearchBox non sarà disponibile per i nuovi clienti. Al momento, la rimozione di google.maps.places.SearchBox non è pianificata e continuerà a ricevere correzioni di bug per eventuali regressioni gravi. Verrà dato un preavviso di almeno 12 mesi prima dell'interruzione dell'assistenza. Per ulteriori dettagli, visita la pagina https://developers.google.com/maps/legacy.

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.

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

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

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

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