3D Maps

Classe Map3DElement

google.maps.maps3d.Map3DElement corso

Map3DElement è un'interfaccia HTML per la visualizzazione della mappa 3D.

Elemento personalizzato:
<gmp-map-3d center="lat,lng,altitude" default-labels-disabled default-ui-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" range="number" roll="number" tilt="number"></gmp-map-3d>

Questa classe estende HTMLElement.

Questa classe implementa Map3DElementOptions.

Accedi chiamando const {Map3DElement} = await google.maps.importLibrary("maps3d"). Consulta la sezione Librerie nell'API Maps JavaScript.
Map3DElement
Map3DElement([options])
Parametri: 
bounds
Se impostato, limita la posizione della videocamera entro i limiti di latitudine/longitudine specificati. Tieni presente che gli oggetti al di fuori dei limiti vengono comunque visualizzati. I limiti possono limitare sia la longitudine che la latitudine oppure solo la latitudine o la longitudine. Per i limiti solo per latitudine, utilizza le longitudini ovest ed est di -180 e 180, rispettivamente. Per i limiti solo per longitudine, utilizza le latitudini nord e sud di 90 e -90, rispettivamente.
center
Il centro della mappa specificato come LatLngAltitude, dove l'altitudine è in metri sul livello del suolo. Tieni presente che non è necessariamente la posizione della videocamera, poiché il campo range influisce sulla distanza della videocamera dal centro della mappa. Se non viene impostato, il valore predefinito è {lat: 0, lng: 0, altitude: 63170000}. 63170000 metri è l'altitudine massima consentita (il raggio della Terra moltiplicato per 10).
Attributo HTML:
  • <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
defaultLabelsDisabled
Tipo:  boolean optional
Valore predefinito: false
Se true, le etichette predefinite della mappa non vengono visualizzate.
Attributo HTML:
  • <gmp-map-3d default-labels-disabled></gmp-map-3d>
defaultUIDisabled
Tipo:  boolean optional
Valore predefinito: false
Se il valore è true, tutti i pulsanti dell'interfaccia utente predefiniti vengono disattivati. Non disattiva i controlli tramite tastiera e gesti.
Attributo HTML:
  • <gmp-map-3d default-ui-disabled></gmp-map-3d>
heading
Tipo:  number optional
L'orientamento della mappa in gradi, dove il nord è pari a zero. In assenza di inclinazione, qualsiasi roll verrà interpretato come rotta.
Attributo HTML:
  • <gmp-map-3d heading="number"></gmp-map-3d>
maxAltitude
Tipo:  number optional
L'altitudine massima sopra il suolo che verrà visualizzata sulla mappa. Un valore valido è compreso tra 0 e 63170000 metri (il raggio della Terra moltiplicato per 10).
Attributo HTML:
  • <gmp-map-3d max-altitude="number"></gmp-map-3d>
maxHeading
Tipo:  number optional
L'angolo massimo di rotta (rotazione) della mappa. Un valore valido è compreso tra 0 e 360 gradi. minHeading e maxHeading rappresentano un intervallo di <= 360 gradi in cui saranno consentiti i gesti di direzione. minHeading = 180 e maxHeading = 90 consentiranno l'inserimento di intestazioni in [0, 90] e [180, 360]. minHeading = 90 e maxHeading = 180 consentiranno l'inserimento di intestazioni in [90, 180].
Attributo HTML:
  • <gmp-map-3d max-heading="number"></gmp-map-3d>
maxTilt
Tipo:  number optional
L'angolo massimo di incidenza della mappa. Un valore valido è compreso tra 0 e 90 gradi.
Attributo HTML:
  • <gmp-map-3d max-tilt="number"></gmp-map-3d>
minAltitude
Tipo:  number optional
L'altitudine minima sopra il suolo che verrà visualizzata sulla mappa. Un valore valido è compreso tra 0 e 63170000 metri (il raggio della Terra moltiplicato per 10).
Attributo HTML:
  • <gmp-map-3d min-altitude="number"></gmp-map-3d>
minHeading
Tipo:  number optional
L'angolo minimo di rotta (rotazione) della mappa. Un valore valido è compreso tra 0 e 360 gradi. minHeading e maxHeading rappresentano un intervallo di <= 360 gradi in cui saranno consentiti i gesti di direzione. minHeading = 180 e maxHeading = 90 consentiranno l'inserimento di intestazioni in [0, 90] e [180, 360]. minHeading = 90 e maxHeading = 180 consentiranno l'inserimento di intestazioni in [90, 180].
Attributo HTML:
  • <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt
Tipo:  number optional
L'angolo di incidenza minimo della mappa. Un valore valido è compreso tra 0 e 90 gradi.
Attributo HTML:
  • <gmp-map-3d min-tilt="number"></gmp-map-3d>
range
Tipo:  number optional
La distanza dalla fotocamera al centro della mappa, in metri.
Attributo HTML:
  • <gmp-map-3d range="number"></gmp-map-3d>
roll
Tipo:  number optional
L'inclinazione della fotocamera attorno al vettore di visualizzazione in gradi. Per risolvere le ambiguità, quando non è presente l'inclinazione, qualsiasi roll verrà interpretato come rotta.
Attributo HTML:
  • <gmp-map-3d roll="number"></gmp-map-3d>
tilt
Tipo:  number optional
L'inclinazione del vettore di visuale della videocamera in gradi. Un vettore di visualizzazione che guarda direttamente verso il basso sulla Terra avrebbe un'inclinazione di zero gradi. Un vettore di visualizzazione che punta lontano dalla Terra avrà un'inclinazione di 180 gradi.
Attributo HTML:
  • <gmp-map-3d tilt="number"></gmp-map-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa sensibile alle maiuscole che rappresenta il tipo di evento da ascoltare.
  • listener:  EventListener|EventListenerObject l'oggetto che riceve una notifica. Deve essere una funzione o un oggetto con il metodo handleEvent
  • options:  boolean|AddEventListenerOptions optional consulta 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 al target. Vedi addEventListener
flyCameraAround
flyCameraAround(options)
Parametri: 
Valore restituito:nessuno
Questo metodo fa orbitare la videocamera attorno a una determinata posizione per una determinata durata, compiendo il numero specificato di giri in quel periodo di tempo.

Per impostazione predefinita, la videocamera orbita in senso orario. Se viene specificato un numero negativo per i giri, la videocamera ruoterà in senso antiorario.

Il metodo è asincrono perché le animazioni possono essere avviate solo dopo che la mappa ha caricato una quantità minima. Il metodo viene restituito dopo l'avvio dell'animazione.

Se il numero di giri è zero, non verrà eseguito alcun giro e l'animazione verrà completata immediatamente dopo l'avvio.
flyCameraTo
flyCameraTo(options)
Parametri: 
Valore restituito:nessuno
Questo metodo sposta la videocamera in modo parabolico dalla posizione corrente a una determinata posizione finale in un determinato periodo di tempo.

Il metodo è asincrono perché le animazioni possono essere avviate solo dopo che la mappa ha caricato una quantità minima. Il metodo viene restituito dopo l'avvio dell'animazione.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa che specifica il tipo di evento per cui rimuovere un gestore di eventi.
  • listener:  EventListener|EventListenerObject Il listener di eventi dell'handler dell'evento da rimuovere dal target dell'evento.
  • options:  boolean|EventListenerOptions optional consulta le opzioni
Valore restituito:void
Rimuove dal target un gestore di eventi precedentemente registrato con addEventListener. Vedi removeEventListener
stopCameraAnimation
stopCameraAnimation()
Parametri: nessuno
Valore restituito:nessuno
Questo metodo interrompe qualsiasi animazione di volo che potrebbe essere in esecuzione. La videocamera rimane dove si trova durante l'animazione; non si teletrasporta al punto finale.

Il metodo è asincrono perché le animazioni possono essere avviate o interrotte solo dopo che la mappa ha caricato una quantità minima. Il metodo viene restituito al termine dell'animazione.
gmp-animationend
function(animationEndEvent)
Argomenti: 
  • animationEndEvent:  Event
Questo evento viene attivato al termine dell'animazione di volo. Questo evento viene visualizzato nell'albero DOM.
gmp-centerchange
function(centerChangeEvent)
Argomenti: 
  • centerChangeEvent:  Event
Questo evento viene attivato quando la proprietà center di Map3DElement cambia.
gmp-click
function(clickEvent)
Argomenti: 
Questo evento viene attivato quando si fa clic sull'elemento Map3DElement.
gmp-headingchange
function(headingChangeEvent)
Argomenti: 
  • headingChangeEvent:  Event
Questo evento viene attivato quando la proprietà heading di Map3DElement cambia.
gmp-rangechange
function(rangeChangeEvent)
Argomenti: 
  • rangeChangeEvent:  Event
Questo evento viene attivato quando la proprietà intervallo di Map3DElement cambia.
gmp-rollchange
function(rollChangeEvent)
Argomenti: 
  • rollChangeEvent:  Event
Questo evento viene attivato quando la proprietà roll di Map3DElement cambia.
gmp-steadychange
function(steadyChangeEvent)
Argomenti: 
Questo evento viene attivato quando cambia lo stato stabile di Map3DElement.
gmp-tiltchange
function(tiltChangeEvent)
Argomenti: 
  • tiltChangeEvent:  Event
Questo evento viene attivato quando la proprietà tilt di Map3DElement cambia.

Interfaccia Map3DElementOptions

google.maps.maps3d.Map3DElementOptions interfaccia

Oggetto Map3DElementOptions utilizzato per definire le proprietà che possono essere impostate su un elemento Map3D.
bounds optional
Leggi i Map3DElement.bounds.
center optional
Leggi i Map3DElement.center.
defaultLabelsDisabled optional
Tipo:  boolean optional
Leggi i Map3DElement.defaultLabelsDisabled.
defaultUIDisabled optional
Tipo:  boolean optional
Leggi i Map3DElement.defaultUIDisabled.
heading optional
Tipo:  number optional
Leggi i Map3DElement.heading.
maxAltitude optional
Tipo:  number optional
Leggi i Map3DElement.maxAltitude.
maxHeading optional
Tipo:  number optional
Leggi i Map3DElement.maxHeading.
maxTilt optional
Tipo:  number optional
Leggi i Map3DElement.maxTilt.
minAltitude optional
Tipo:  number optional
Leggi i Map3DElement.minAltitude.
minHeading optional
Tipo:  number optional
Leggi i Map3DElement.minHeading.
minTilt optional
Tipo:  number optional
Leggi i Map3DElement.minTilt.
range optional
Tipo:  number optional
Leggi i Map3DElement.range.
roll optional
Tipo:  number optional
Leggi i Map3DElement.roll.
tilt optional
Tipo:  number optional
Leggi i Map3DElement.tilt.

Interfaccia FlyAroundAnimationOptions

google.maps.maps3d.FlyAroundAnimationOptions interfaccia

Opzioni di personalizzazione per l'animazione FlyCameraAround.
camera
Il punto centrale verso cui deve guardare la fotocamera durante l'animazione dell'orbita. Tieni presente che la direzione della mappa cambia man mano che la fotocamera orbita attorno a questo punto centrale.
durationMillis optional
Tipo:  number optional
La durata dell'animazione in millisecondi. Si tratta della durata totale dell'animazione, non della durata di una singola rotazione.
rounds optional
Tipo:  number optional
Il numero di giri da ruotare attorno al centro nella durata specificata. Controlla la velocità complessiva della rotazione. Se passi un numero negativo a round, la videocamera ruoterà in senso antiorario anziché in senso orario predefinito.

Interfaccia FlyToAnimationOptions

google.maps.maps3d.FlyToAnimationOptions interfaccia

Opzioni di personalizzazione per l'animazione FlyCameraTo.
endCamera
La posizione in cui deve puntare la fotocamera alla fine dell'animazione.
durationMillis optional
Tipo:  number optional
La durata dell'animazione in millisecondi. Una durata pari a 0 teletrasporterà la videocamera direttamente alla posizione finale.

Interfaccia CameraOptions

google.maps.maps3d.CameraOptions interfaccia

Oggetto CameraOptions utilizzato per definire le proprietà che possono essere impostate su un oggetto videocamera. L'oggetto camera può essere qualsiasi elemento con una posizione della fotocamera, ad esempio lo stato corrente della mappa o uno stato di animazione richiesto in futuro.
center optional
Leggi i Map3DElement.center.
heading optional
Tipo:  number optional
Leggi i Map3DElement.heading.
range optional
Tipo:  number optional
Leggi i Map3DElement.range.
roll optional
Tipo:  number optional
Leggi i Map3DElement.roll.
tilt optional
Tipo:  number optional
Leggi i Map3DElement.tilt.

SteadyChangeEvent class

google.maps.maps3d.SteadyChangeEvent corso

Questo evento viene creato dal monitoraggio di uno stato stabile di Map3DElement. Questo evento viene visualizzato nell'albero DOM.

Questa classe estende Event.

Accedi chiamando const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d"). Consulta la sezione Librerie nell'API Maps JavaScript.
isSteady
Tipo:  boolean
Indica se Map3DElement è stabile (ovvero se è stato completato tutto il rendering per la scena corrente) o meno.

Classe LocationClickEvent

google.maps.maps3d.LocationClickEvent corso

Questo evento viene creato facendo clic su un elemento Map3D.

Questa classe estende Event.

Accedi chiamando const {LocationClickEvent} = await google.maps.importLibrary("maps3d"). Consulta la sezione Librerie nell'API Maps JavaScript.
position
Tipo:  LatLngAltitude optional
La latitudine/longitudine/altitudine sotto il cursore quando si è verificato l'evento. Tieni presente che a livelli più generici verranno restituiti dati meno precisi. Inoltre, l'elevazione del fondo del mare può essere restituita per il valore dell'altitudine quando si fa clic sulla superficie dell'acqua da posizioni più elevate della fotocamera. Questo evento viene visualizzato nell'albero DOM.

Classe PlaceClickEvent

google.maps.maps3d.PlaceClickEvent corso

Questo evento viene creato facendo clic su un elemento Map3D.

Questa classe estende LocationClickEvent.

Accedi chiamando const {PlaceClickEvent} = await google.maps.importLibrary("maps3d"). Consulta la sezione Librerie nell'API Maps JavaScript.
placeId
Tipo:  string
L'ID luogo della funzionalità della mappa.
Ereditato: position
fetchPlace
fetchPlace()
Parametri: nessuno
Valore restituito:Promise<Place>
Recupera un Place per questo ID luogo. Nell'oggetto Place risultante, la proprietà id verrà compilata. Successivamente è possibile richiedere altri campi tramite Place.fetchFields(), in base alla normale attivazione e fatturazione dell'API Places. La promessa viene rifiutata se si è verificato un errore durante il recupero di Place.

Classe Marker3DElement

google.maps.maps3d.Marker3DElement corso

Mostra una posizione su una mappa 3D. Tieni presente che position deve essere impostato per visualizzare Marker3DElement.

Elemento personalizzato:
<gmp-marker-3d altitude-mode="absolute" collision-behavior="required" draws-when-occluded extruded label="string" size-preserved z-index="number"></gmp-marker-3d>

Questa classe estende HTMLElement.

Questa classe implementa Marker3DElementOptions.

Accedi chiamando const {Marker3DElement} = await google.maps.importLibrary("maps3d"). Consulta la sezione Librerie nell'API Maps JavaScript.
Marker3DElement
Marker3DElement([options])
Parametri: 
Crea un Marker3DElement con le opzioni specificate.
altitudeMode
Tipo:  AltitudeMode optional
Valore predefinito: AltitudeMode.CLAMP_TO_GROUND
Specifica la modalità di interpretazione del componente altitudine della posizione.
Attributo HTML:
  • <gmp-marker-3d altitude-mode="absolute"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="clamp-to-ground"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="relative-to-ground"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="relative-to-mesh"></gmp-marker-3d>
collisionBehavior
Tipo:  CollisionBehavior optional
Valore predefinito: CollisionBehavior.REQUIRED
Un'enumerazione che specifica il comportamento di un elemento Marker3D quando entra in collisione con un altro elemento Marker3D o con le etichette della mappa di base.
Attributo HTML:
  • <gmp-marker-3d collision-behavior="required"></gmp-marker-3d>
  • <gmp-marker-3d collision-behavior="required-and-hides-optional"></gmp-marker-3d>
  • <gmp-marker-3d collision-behavior="optional-and-hides-lower-priority"></gmp-marker-3d>
drawsWhenOccluded
Tipo:  boolean optional
Valore predefinito: false
Specifica se questo indicatore deve essere disegnato o meno quando è ostruito. L'indicatore può essere coperto dalla geometria della mappa (ad es. edifici).
Attributo HTML:
  • <gmp-marker-3d draws-when-occluded></gmp-marker-3d>
extruded
Tipo:  boolean optional
Valore predefinito: false
Specifica se collegare l'indicatore al suolo. Per estrudere un indicatore, altitudeMode deve essere RELATIVE_TO_GROUND o ABSOLUTE.
Attributo HTML:
  • <gmp-marker-3d extruded></gmp-marker-3d>
label
Tipo:  string optional
Testo da visualizzare da questo indicatore.
Attributo HTML:
  • <gmp-marker-3d label="string"></gmp-marker-3d>
position
La posizione della punta dell'indicatore. L'altitudine viene ignorata in determinate modalità ed è quindi facoltativa.
sizePreserved
Tipo:  boolean optional
Valore predefinito: false
Specifica se questo indicatore deve mantenere le sue dimensioni indipendentemente dalla distanza dalla fotocamera. Per impostazione predefinita, l'indicatore viene ridimensionato in base alla distanza dalla fotocamera/all'inclinazione.
Attributo HTML:
  • <gmp-marker-3d size-preserved></gmp-marker-3d>
zIndex
Tipo:  number optional
L'indice z rispetto ad altri indicatori.
Attributo HTML:
  • <gmp-marker-3d z-index="number"></gmp-marker-3d>
default
Tutti gli elementi personalizzati aggiunti direttamente a Marker3DElement verranno inseriti, ma solo gli elementi di tipo HTMLImageElement, SVGElement e PinElement verranno utilizzati per disegnare gli indicatori, mentre gli altri elementi verranno ignorati.
HTMLImageElement e SVGElement devono essere racchiusi nell'elemento <template> prima di essere assegnati allo slot predefinito di Marker3DElement.

Al momento, le immagini e gli SVG vengono rasterizzati prima di essere visualizzati nella scena 3D, pertanto il codice HTML personalizzato incorporato nelle classi CSS o SVG aggiunte alle immagini non verrà applicato e potrebbe non essere visualizzato quando gli indicatori vengono visualizzati sullo schermo.
BetaaddEventListener
addEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa sensibile alle maiuscole che rappresenta il tipo di evento da ascoltare.
  • listener:  EventListener|EventListenerObject l'oggetto che riceve una notifica. Deve essere una funzione o un oggetto con il metodo handleEvent
  • options:  boolean|AddEventListenerOptions optional consulta 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 al target. Vedi addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa che specifica il tipo di evento per cui rimuovere un gestore di eventi.
  • listener:  EventListener|EventListenerObject Il listener di eventi dell'handler dell'evento da rimuovere dal target dell'evento.
  • options:  boolean|EventListenerOptions optional consulta le opzioni
Valore restituito:void
Rimuove dal target un gestore di eventi precedentemente registrato con addEventListener. Vedi removeEventListener

Interfaccia Marker3DElementOptions

google.maps.maps3d.Marker3DElementOptions interfaccia

Oggetto Marker3DElementOptions utilizzato per definire le proprietà che possono essere impostate su un Marker3DElement.
altitudeMode optional
Tipo:  AltitudeMode optional
Leggi i Marker3DElement.altitudeMode.
collisionBehavior optional
Tipo:  CollisionBehavior optional
Leggi i Marker3DElement.collisionBehavior.
drawsWhenOccluded optional
Tipo:  boolean optional
Leggi i Marker3DElement.drawsWhenOccluded.
extruded optional
Tipo:  boolean optional
Leggi i Marker3DElement.extruded.
label optional
Tipo:  string optional
Leggi i Marker3DElement.label.
position optional
Leggi i Marker3DElement.position.
sizePreserved optional
Tipo:  boolean optional
Leggi i Marker3DElement.sizePreserved.
zIndex optional
Tipo:  number optional
Leggi i Marker3DElement.zIndex.

Classe Marker3DInteractiveElement

google.maps.maps3d.Marker3DInteractiveElement corso

Mostra una posizione su una mappa 3D. Tieni presente che position deve essere impostato per visualizzare Marker3DInteractiveElement. A differenza di Marker3DElement, Marker3DInteractiveElement riceve un evento gmp-click.

Elemento personalizzato:
<gmp-marker-3d-interactive></gmp-marker-3d-interactive>

Questa classe estende Marker3DElement.

Questa classe implementa Marker3DInteractiveElementOptions.

Accedi chiamando const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d"). Consulta la sezione Librerie nell'API Maps JavaScript.
Marker3DInteractiveElement
Marker3DInteractiveElement([options])
Parametri: 
Crea un Marker3DInteractiveElement con le opzioni specificate.
Ereditato: altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex
default
Eventuali elementi personalizzati aggiunti direttamente a Marker3DInteractiveElement verranno inseriti, ma solo gli elementi di tipo PinElement verranno utilizzati per disegnare gli indicatori, mentre gli altri elementi verranno ignorati.
addEventListener
addEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa sensibile alle maiuscole che rappresenta il tipo di evento da ascoltare.
  • listener:  EventListener|EventListenerObject l'oggetto che riceve una notifica. Deve essere una funzione o un oggetto con il metodo handleEvent
  • options:  boolean|AddEventListenerOptions optional consulta 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 al target. Vedi addEventListener
removeEventListener
removeEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa che specifica il tipo di evento per cui rimuovere un gestore di eventi.
  • listener:  EventListener|EventListenerObject Il listener di eventi dell'handler dell'evento da rimuovere dal target dell'evento.
  • options:  boolean|EventListenerOptions optional consulta le opzioni
Valore restituito:void
Rimuove dal target un gestore di eventi precedentemente registrato con addEventListener. Vedi removeEventListener
gmp-click
function(clickEvent)
Argomenti: 
Questo evento viene attivato quando si fa clic sull'elemento Marker3DInteractiveElement.

Interfaccia Marker3DInteractiveElementOptions

google.maps.maps3d.Marker3DInteractiveElementOptions interfaccia

Oggetto Marker3DInteractiveElementOptions utilizzato per definire le proprietà che possono essere impostate su un Marker3DInteractiveElement.

Questa interfaccia estende Marker3DElementOptions.

Ereditato: altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex

Classe Model3DElement

google.maps.maps3d.Model3DElement corso

Un modello 3D che consente il rendering di modelli gLTF. Tieni presente che position e src devono essere impostati per visualizzare Model3DElement.

Le proprietà di base del gLTF PBR devono essere supportate. Al momento non sono supportate estensioni o proprietà di estensioni.

Elemento personalizzato:
<gmp-model-3d altitude-mode="absolute" src="src"></gmp-model-3d>

Questa classe estende HTMLElement.

Questa classe implementa Model3DElementOptions.

Accedi chiamando const {Model3DElement} = await google.maps.importLibrary("maps3d"). Consulta la sezione Librerie nell'API Maps JavaScript.
Model3DElement
Model3DElement([options])
Parametri: 
Crea un Model3DElement con le opzioni specificate.
altitudeMode
Tipo:  AltitudeMode optional
Valore predefinito: AltitudeMode.CLAMP_TO_GROUND
Specifica in che modo viene interpretata l'altitudine nella posizione.
Attributo HTML:
  • <gmp-model-3d altitude-mode="absolute"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="clamp-to-ground"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="relative-to-ground"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="relative-to-mesh"></gmp-model-3d>
orientation
Descrive la rotazione del sistema di coordinate di un modello 3D per posizionare il modello sulla mappa 3D.

Le rotazioni vengono applicate al modello nel seguente ordine: roll, inclinazione e orientamento.
position
Imposta la posizione di Model3DElement. L'altitudine viene ignorata in determinate modalità ed è quindi facoltativa.
scale
Tipo:  number|Vector3D|Vector3DLiteral optional
Valore predefinito: 1
Scala il modello lungo gli assi x, y e z nello spazio delle coordinate del modello.
src
Tipo:  string|URL optional
Specifica l'URL del modello 3D. Al momento sono supportati solo i modelli nel formato .glb.

Eventuali URL HTTP relativi verranno risolti in quelli assoluti corrispondenti.

Tieni presente che se ospiti i file del modello .glb su un sito web o un server diverso dall'applicazione principale, assicurati di configurare le intestazioni HTTP CORS corrette. In questo modo, la tua applicazione può accedere in modo sicuro ai file del modello dall'altro dominio.
Attributo HTML:
  • <gmp-model-3d src="src"></gmp-model-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa sensibile alle maiuscole che rappresenta il tipo di evento da ascoltare.
  • listener:  EventListener|EventListenerObject l'oggetto che riceve una notifica. Deve essere una funzione o un oggetto con il metodo handleEvent
  • options:  boolean|AddEventListenerOptions optional consulta 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 al target. Vedi addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa che specifica il tipo di evento per cui rimuovere un gestore di eventi.
  • listener:  EventListener|EventListenerObject Il listener di eventi dell'handler dell'evento da rimuovere dal target dell'evento.
  • options:  boolean|EventListenerOptions optional consulta le opzioni
Valore restituito:void
Rimuove dal target un gestore di eventi precedentemente registrato con addEventListener. Vedi removeEventListener

Interfaccia Model3DElementOptions

google.maps.maps3d.Model3DElementOptions interfaccia

Oggetto Model3DElementOptions utilizzato per definire le proprietà che possono essere impostate su un Model3DElement.
altitudeMode optional
Tipo:  AltitudeMode optional
Leggi i Model3DElement.altitudeMode.
orientation optional
Leggi i Model3DElement.orientation.
position optional
Leggi i Model3DElement.position.
scale optional
Tipo:  number|Vector3D|Vector3DLiteral optional
Leggi i Model3DElement.scale.
src optional
Tipo:  string|URL optional
Leggi i Model3DElement.src.

Classe Polyline3DElement

google.maps.maps3d.Polyline3DElement corso

Una polilinea 3D è un overlay lineare di segmenti di linea collegati su una mappa 3D.

Elemento personalizzato:
<gmp-polyline-3d altitude-mode="absolute" draws-occluded-segments extruded geodesic outer-color="string" outer-width="number" stroke-color="string" stroke-width="number" z-index="number"></gmp-polyline-3d>

Questa classe estende HTMLElement.

Questa classe implementa Polyline3DElementOptions.

Accedi chiamando const {Polyline3DElement} = await google.maps.importLibrary("maps3d"). Consulta la sezione Librerie nell'API Maps JavaScript.
Polyline3DElement
Polyline3DElement([options])
Parametri: 
Crea un Polyline3DElement con le opzioni specificate.
altitudeMode
Tipo:  AltitudeMode optional
Valore predefinito: AltitudeMode.ABSOLUTE
Specifica in che modo vengono interpretati i componenti di altitudine nelle coordinate.
Attributo HTML:
  • <gmp-polyline-3d altitude-mode="absolute"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="clamp-to-ground"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="relative-to-ground"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="relative-to-mesh"></gmp-polyline-3d>
coordinates
La sequenza ordinata delle coordinate della polilinea. L'altitudine viene ignorata in determinate modalità ed è quindi facoltativa.
drawsOccludedSegments
Tipo:  boolean optional
Valore predefinito: false
Specifica se le parti del polilinea che potrebbero essere occultate vengono disegnate o meno. Le polilinee possono essere ostruite dalla geometria della mappa (ad es. edifici).
Attributo HTML:
  • <gmp-polyline-3d draws-occluded-segments></gmp-polyline-3d>
extruded
Tipo:  boolean optional
Valore predefinito: false
Specifica se collegare il polilinea al suolo. Per estrudere una polilinea, altitudeMode deve essere RELATIVE_TO_GROUND o ABSOLUTE.
Attributo HTML:
  • <gmp-polyline-3d extruded></gmp-polyline-3d>
geodesic
Tipo:  boolean optional
Valore predefinito: false
Quando true, i bordi del polilinea vengono interpretati come geodetici e seguiranno la curvatura della Terra. Quando false, i bordi del polilinea vengono visualizzati come linee rette nello spazio dello schermo.
Attributo HTML:
  • <gmp-polyline-3d geodesic></gmp-polyline-3d>
outerColor
Tipo:  string optional
Il colore esterno. Sono supportati tutti i colori CSS3.
Attributo HTML:
  • <gmp-polyline-3d outer-color="string"></gmp-polyline-3d>
outerWidth
Tipo:  number optional
La larghezza esterna deve essere compresa tra 0.0 e 1.0. Si tratta di una percentuale del strokeWidth.
Attributo HTML:
  • <gmp-polyline-3d outer-width="number"></gmp-polyline-3d>
strokeColor
Tipo:  string optional
Il colore del tratto. Sono supportati tutti i colori CSS3.
Attributo HTML:
  • <gmp-polyline-3d stroke-color="string"></gmp-polyline-3d>
strokeWidth
Tipo:  number optional
La larghezza del tratto in pixel.
Attributo HTML:
  • <gmp-polyline-3d stroke-width="number"></gmp-polyline-3d>
zIndex
Tipo:  number optional
L'indice z rispetto ad altri poli.
Attributo HTML:
  • <gmp-polyline-3d z-index="number"></gmp-polyline-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa sensibile alle maiuscole che rappresenta il tipo di evento da ascoltare.
  • listener:  EventListener|EventListenerObject l'oggetto che riceve una notifica. Deve essere una funzione o un oggetto con il metodo handleEvent
  • options:  boolean|AddEventListenerOptions optional consulta 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 al target. Vedi addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa che specifica il tipo di evento per cui rimuovere un gestore di eventi.
  • listener:  EventListener|EventListenerObject Il listener di eventi dell'handler dell'evento da rimuovere dal target dell'evento.
  • options:  boolean|EventListenerOptions optional consulta le opzioni
Valore restituito:void
Rimuove dal target un gestore di eventi precedentemente registrato con addEventListener. Vedi removeEventListener

Interfaccia Polyline3DElementOptions

google.maps.maps3d.Polyline3DElementOptions interfaccia

Oggetto Polyline3DElementOptions utilizzato per definire le proprietà che possono essere impostate su un elemento Polyline3D.
altitudeMode optional
Tipo:  AltitudeMode optional
Leggi i Polyline3DElement.altitudeMode.
coordinates optional
Leggi i Polyline3DElement.coordinates.
drawsOccludedSegments optional
Tipo:  boolean optional
Leggi i Polyline3DElement.drawsOccludedSegments.
extruded optional
Tipo:  boolean optional
Leggi i Polyline3DElement.extruded.
geodesic optional
Tipo:  boolean optional
Leggi i Polyline3DElement.geodesic.
outerColor optional
Tipo:  string optional
Leggi i Polyline3DElement.outerColor.
outerWidth optional
Tipo:  number optional
Leggi i Polyline3DElement.outerWidth.
strokeColor optional
Tipo:  string optional
Leggi i Polyline3DElement.strokeColor.
strokeWidth optional
Tipo:  number optional
Leggi i Polyline3DElement.strokeWidth.
zIndex optional
Tipo:  number optional
Leggi i Polyline3DElement.zIndex.

Classe Polygon3DElement

google.maps.maps3d.Polygon3DElement corso

Un poligono 3D (come una polilinea 3D) definisce una serie di coordinate collegate in una sequenza ordinata. Inoltre, i poligoni formano un anello chiuso e definiscono una regione riempita.

Elemento personalizzato:
<gmp-polygon-3d altitude-mode="absolute" draws-occluded-segments extruded fill-color="string" geodesic stroke-color="string" stroke-width="number" z-index="number"></gmp-polygon-3d>

Questa classe estende HTMLElement.

Questa classe implementa Polygon3DElementOptions.

Accedi chiamando const {Polygon3DElement} = await google.maps.importLibrary("maps3d"). Consulta la sezione Librerie nell'API Maps JavaScript.
Polygon3DElement
Polygon3DElement([options])
Parametri: 
Crea un Polygon3DElement con le opzioni specificate.
altitudeMode
Tipo:  AltitudeMode optional
Valore predefinito: AltitudeMode.ABSOLUTE
Specifica in che modo vengono interpretati i componenti di altitudine nelle coordinate.
Attributo HTML:
  • <gmp-polygon-3d altitude-mode="absolute"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="clamp-to-ground"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="relative-to-ground"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="relative-to-mesh"></gmp-polygon-3d>
drawsOccludedSegments
Tipo:  boolean optional
Valore predefinito: false
Specifica se le parti del poligono che potrebbero essere occultate vengono disegnate o meno. I poligoni possono essere occultati dalla geometria della mappa (ad es. edifici).
Attributo HTML:
  • <gmp-polygon-3d draws-occluded-segments></gmp-polygon-3d>
extruded
Tipo:  boolean optional
Valore predefinito: false
Specifica se collegare il poligono al suolo. Per estrudere un poligono, altitudeMode deve essere RELATIVE_TO_GROUND o ABSOLUTE.
Attributo HTML:
  • <gmp-polygon-3d extruded></gmp-polygon-3d>
fillColor
Tipo:  string optional
Il colore di riempimento. Sono supportati tutti i colori CSS3.
Attributo HTML:
  • <gmp-polygon-3d fill-color="string"></gmp-polygon-3d>
geodesic
Tipo:  boolean optional
Valore predefinito: false
Quando true, i bordi del poligono vengono interpretati come geodetici e seguiranno la curvatura della Terra. Se false, i bordi del poligono vengono visualizzati come linee rette nello spazio dello schermo.
Attributo HTML:
  • <gmp-polygon-3d geodesic></gmp-polygon-3d>
innerCoordinates
La sequenza ordinata di coordinate che indica un circuito chiuso. A differenza delle polilinee, un poligono può essere costituito da uno o più percorsi, che creano più ritagli all'interno del poligono.
outerCoordinates
La sequenza ordinata di coordinate che indica un circuito chiuso. L'altitudine viene ignorata in determinate modalità ed è quindi facoltativa.
strokeColor
Tipo:  string optional
Il colore del tratto. Sono supportati tutti i colori CSS3.
Attributo HTML:
  • <gmp-polygon-3d stroke-color="string"></gmp-polygon-3d>
strokeWidth
Tipo:  number optional
La larghezza del tratto in pixel.
Attributo HTML:
  • <gmp-polygon-3d stroke-width="number"></gmp-polygon-3d>
zIndex
Tipo:  number optional
L'indice z rispetto ad altri poli.
Attributo HTML:
  • <gmp-polygon-3d z-index="number"></gmp-polygon-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa sensibile alle maiuscole che rappresenta il tipo di evento da ascoltare.
  • listener:  EventListener|EventListenerObject l'oggetto che riceve una notifica. Deve essere una funzione o un oggetto con il metodo handleEvent
  • options:  boolean|AddEventListenerOptions optional consulta 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 al target. Vedi addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametri: 
  • type:  string una stringa che specifica il tipo di evento per cui rimuovere un gestore di eventi.
  • listener:  EventListener|EventListenerObject Il listener di eventi dell'handler dell'evento da rimuovere dal target dell'evento.
  • options:  boolean|EventListenerOptions optional consulta le opzioni
Valore restituito:void
Rimuove dal target un gestore di eventi precedentemente registrato con addEventListener. Vedi removeEventListener

Interfaccia Polygon3DElementOptions

google.maps.maps3d.Polygon3DElementOptions interfaccia

Oggetto Polygon3DElementOptions utilizzato per definire le proprietà che possono essere impostate su un elemento Polygon3D.
altitudeMode optional
Tipo:  AltitudeMode optional
Leggi i Polygon3DElement.altitudeMode.
drawsOccludedSegments optional
Tipo:  boolean optional
Leggi i Polygon3DElement.drawsOccludedSegments.
extruded optional
Tipo:  boolean optional
Leggi i Polygon3DElement.extruded.
fillColor optional
Tipo:  string optional
Leggi i Polygon3DElement.fillColor.
geodesic optional
Tipo:  boolean optional
Leggi i Polygon3DElement.geodesic.
innerCoordinates optional
Leggi i Polygon3DElement.innerCoordinates.
outerCoordinates optional
Leggi i Polygon3DElement.outerCoordinates.
strokeColor optional
Tipo:  string optional
Leggi i Polygon3DElement.strokeColor.
strokeWidth optional
Tipo:  number optional
Leggi i Polygon3DElement.strokeWidth.
zIndex optional
Tipo:  number optional
Leggi i Polygon3DElement.zIndex.

Costanti AltitudeMode

google.maps.maps3d.AltitudeMode costanti

Specifica in che modo vengono interpretati i componenti di altitudine nelle coordinate.

Accedi chiamando const {AltitudeMode} = await google.maps.importLibrary("maps3d"). Consulta la sezione Librerie nell'API Maps JavaScript.
ABSOLUTE Consente di esprimere gli oggetti rispetto al livello medio del mare medio. Ciò significa anche che se il livello di dettaglio del terreno cambia sotto l'oggetto, la sua posizione assoluta rimarrà invariata.
CLAMP_TO_GROUND Consente di esprimere gli oggetti posizionati sul suolo. Rimarranno a livello del suolo seguendo il terreno, indipendentemente dall'altitudine fornita. Se l'oggetto è posizionato sopra un grande specchio d'acqua, verrà posizionato a livello del mare.
RELATIVE_TO_GROUND Consente di esprimere gli oggetti in base alla superficie del suolo. Se il livello di dettaglio del terreno cambia, la posizione dell'oggetto rimarrà costante rispetto al suolo. Sopra l'acqua, l'altitudine verrà interpretata come un valore in metri sul livello del mare.
RELATIVE_TO_MESH Consente di esprimere gli oggetti rispetto alla superficie più alta di suolo, edifici e acqua. Se sopra l'acqua, sarà la superficie dell'acqua; se sopra il terreno, sarà la superficie dell'edificio (se presente) o del suolo (se non sono presenti edifici).