3D Maps

Classe Map3DElement

google.maps.maps3d.Map3DElement classe

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

Elemento personalizzato:
<gmp-map-3d center="lat,lng,altitude" default-labels-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 impostata, limita la posizione della fotocamera 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 latitudine che la longitudine oppure possono limitare solo la latitudine o la longitudine. Per i limiti di latitudine, utilizza le longitudine ovest ed est rispettivamente di -180 e 180. Per i limiti di sola longitudine, utilizza rispettivamente le latitudini nord e sud di 90 e -90.
center
Il centro della mappa indicato come LatLngAltitude, dove l'altitudine è in metri sopra il livello del suolo. Tieni presente che non è necessariamente il luogo in cui si trova la fotocamera, perché il campo range influisce sulla distanza della fotocamera dal centro della mappa. Se non viene configurato, il valore predefinito è {lat: 0, lng: 0, altitude: 63170000}. 63170000 metri è l'altitudine massima consentita (raggio terrestre moltiplicato per 10).
Attributo HTML:
  • <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
defaultLabelsDisabled
Tipo:  boolean optional
Predefinita: false
Quando true, le etichette predefinite della mappa non vengono visualizzate.
Attributo HTML:
  • <gmp-map-3d default-labels-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 rotazione viene interpretata come orientamento.
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 (raggio terrestre moltiplicato per 10).
Attributo HTML:
  • <gmp-map-3d max-altitude="number"></gmp-map-3d>
maxHeading
Tipo:  number optional
L'angolazione massima di orientamento (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 delle intestazioni. minHeading = 180 e maxHeading = 90 consentiranno le intestazioni in [0, 90] e le intestazioni in [180, 360]. minHeading = 90 e maxHeading = 180 consentiranno le 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 (raggio terrestre moltiplicato per 10).
Attributo HTML:
  • <gmp-map-3d min-altitude="number"></gmp-map-3d>
minHeading
Tipo:  number optional
L'angolo minimo di orientamento (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 delle intestazioni. minHeading = 180 e maxHeading = 90 consentiranno le intestazioni in [0, 90] e le intestazioni in [180, 360]. minHeading = 90 e maxHeading = 180 consentiranno le intestazioni in [90, 180].
Attributo HTML:
  • <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt
Tipo:  number optional
L'angolo minimo di incidenza 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
Il rullo della fotocamera intorno al vettore di visualizzazione in gradi. Per risolvere le ambiguità, in assenza di inclinazione, qualsiasi rotazione verrà interpretata come intestazione.
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 vista che guarda direttamente verso la Terra avrebbe un'inclinazione di zero gradi. Un vettore di vista che punta verso la Terra avrebbe un'inclinazione di 180 gradi.
Attributo HTML:
  • <gmp-map-3d tilt="number"></gmp-map-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parametri: 
  • typestring una stringa sensibile alle maiuscole che rappresenta il tipo di evento da ascoltare.
  • listenerEventListener|EventListenerObject l'oggetto che riceve una notifica. Deve essere una funzione o un oggetto con il metodo handleEvent
  • optionsboolean|AddEventListenerOptions optional Vedi le opzioni. Gli eventi personalizzati supportano solo capture e passive.
Valore restituito:  void
Configura una funzione che verrà chiamata ogni volta che l'evento specificato viene pubblicato nella destinazione. Consulta la colonna addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametri: 
  • typestring una stringa che specifica il tipo di evento per cui rimuovere un listener di eventi.
  • listenerEventListener|EventListenerObject il listener di eventi del gestore di eventi da rimuovere dalla destinazione dell'evento.
  • optionsboolean|EventListenerOptions optional Vedi le opzioni
Valore restituito:  void
Rimuove dalla destinazione un listener di eventi precedentemente registrato con c. Vedi removeEventListener
gmp-centerchange
function(centerChangeEvent)
Argomenti: 
Questo evento viene attivato quando la proprietà centrale di Map3DElement cambia.
gmp-click
function(clickEvent)
Argomenti: 
Questo evento viene attivato quando si fa clic sull'elemento Map3DElement.
gmp-headingchange
function(headingChangeEvent)
Argomenti: 
Questo evento viene attivato quando la proprietà di intestazione di Map3DElement cambia.
gmp-rangechange
function(rangeChangeEvent)
Argomenti: 
Questo evento viene attivato quando la proprietà intervallo di Map3DElement cambia.
gmp-rollchange
function(rollChangeEvent)
Argomenti: 
Questo evento viene attivato quando la proprietà roll di Map3DElement cambia.
gmp-steadychange
function(steadyChangeEvent)
Argomenti: 
Questo evento viene attivato quando lo stato fisso di Map3DElement cambia.
gmp-tiltchange
function(tiltChangeEvent)
Argomenti: 
Questo evento viene attivato quando la proprietà di inclinazione di Map3DElement cambia.

Interfaccia Map3DElementOptions

Interfaccia google.maps.maps3d.Map3DElementOptions

Oggetto Map3DElementOptions utilizzato per definire le proprietà che possono essere impostate su un Map3DElement.

bounds optional
center optional
defaultLabelsDisabled optional
Tipo:  boolean optional
heading optional
Tipo:  number optional
maxAltitude optional
Tipo:  number optional
maxHeading optional
Tipo:  number optional
maxTilt optional
Tipo:  number optional
minAltitude optional
Tipo:  number optional
minHeading optional
Tipo:  number optional
minTilt optional
Tipo:  number optional
range optional
Tipo:  number optional
roll optional
Tipo:  number optional
tilt optional
Tipo:  number optional

Classe SteadyChangeEvent

google.maps.maps3d.SteadyChangeEvent classe

Questo evento è stato creato in base al monitoraggio di uno stato stazionario di Map3DElement.

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 è costante (ossia, l'intero rendering della scena corrente è stato completato) o meno.

Classe ClickEvent

google.maps.maps3d.ClickEvent classe

Questo evento viene creato facendo clic su un Map3DElement.

Questa classe estende Event.

Accedi chiamando const {ClickEvent} = await google.maps.importLibrary("maps3d"). Consulta la sezione Librerie nell'API Maps JavaScript.

position
Tipo:  LatLngAltitude optional
La latitudine/longitudine/altitudine che si trovavano sotto il cursore quando si è verificato l'evento. Tieni presente che a livelli più approssimativi, verranno restituiti dati meno precisi. Inoltre, l'elevazione del fondale marino può essere restituita per il valore di altitudine quando si fa clic sulla superficie dell'acqua da posizioni più elevate della fotocamera.

Classe CenterChangeEvent

google.maps.maps3d.CenterChangeEvent classe

Questo evento viene creato a seguito della modifica del Centro di monitoraggio il giorno Map3DElement.

Questa classe estende Event.

Accedi chiamando const {CenterChangeEvent} = await google.maps.importLibrary("maps3d"). Consulta la sezione Librerie nell'API Maps JavaScript.

Classe HeadingChangeEvent

google.maps.maps3d.HeadingChangeEvent classe

Questo evento viene creato a seguito del monitoraggio della modifica dell'intestazione su Map3DElement.

Questa classe estende Event.

Accedi chiamando const {HeadingChangeEvent} = await google.maps.importLibrary("maps3d"). Consulta la sezione Librerie nell'API Maps JavaScript.

Classe RangeChangeEvent

google.maps.maps3d.RangeChangeEvent classe

Questo evento viene creato in base alla modifica dell'intervallo di monitoraggio il giorno Map3DElement.

Questa classe estende Event.

Accedi chiamando const {RangeChangeEvent} = await google.maps.importLibrary("maps3d"). Consulta la sezione Librerie nell'API Maps JavaScript.

Classe RollChangeEvent

google.maps.maps3d.RollChangeEvent classe

Questo evento viene creato a partire dal monitoraggio della modifica nel rollback il giorno Map3DElement.

Questa classe estende Event.

Accedi chiamando const {RollChangeEvent} = await google.maps.importLibrary("maps3d"). Consulta la sezione Librerie nell'API Maps JavaScript.

Classe TiltChangeEvent

google.maps.maps3d.TiltChangeEvent classe

Questo evento è stato creato in seguito al monitoraggio della variazione dell'inclinazione su Map3DElement.

Questa classe estende Event.

Accedi chiamando const {TiltChangeEvent} = await google.maps.importLibrary("maps3d"). Consulta la sezione Librerie nell'API Maps JavaScript.

Classe Polyline3DElement

google.maps.maps3d.Polyline3DElement classe

Una polilinea 3D è una sovrapposizione lineare di segmenti di linee collegate su una mappa 3D.

Elemento personalizzato:
<gmp-polyline-3d altitude-mode="absolute" draws-occluded-segments extruded geodesic outer-color="string" outer-opacity="number" outer-width="number" stroke-color="string" stroke-opacity="number" 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: 
altitudeMode
Tipo:  AltitudeMode optional
Specifica il modo in cui 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 di coordinate della polilinea. L'altitudine viene ignorata in alcune modalità e quindi è facoltativa.
drawsOccludedSegments
Tipo:  boolean optional
Predefinita: false
Specifica se le parti della polilinea che potrebbero essere oscurate sono disegnate o meno. Le polilinee possono essere nascoste dalla geometria della mappa (ad es. gli edifici).
Attributo HTML:
  • <gmp-polyline-3d draws-occluded-segments></gmp-polyline-3d>
extruded
Tipo:  boolean optional
Predefinita: false
Consente di specificare se connettere la 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
Predefinita: false
Quando true, i bordi della polilinea vengono interpretati come geodetici e seguiranno la curvatura della Terra. Quando false, i bordi della polilinea vengono visualizzati come linee rette nello spazio sullo schermo.
Attributo HTML:
  • <gmp-polyline-3d geodesic></gmp-polyline-3d>
outerColor
Tipo:  string optional
Il colore esterno. Sono supportati tutti i colori CSS3, ad eccezione dei colori con nome esteso.
Attributo HTML:
  • <gmp-polyline-3d outer-color="string"></gmp-polyline-3d>
outerOpacity
Tipo:  number optional
Opacità esterna compresa tra 0.0 e 1.0.
Attributo HTML:
  • <gmp-polyline-3d outer-opacity="number"></gmp-polyline-3d>
outerWidth
Tipo:  number optional
La larghezza esterna è 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, ad eccezione dei colori con nome esteso.
Attributo HTML:
  • <gmp-polyline-3d stroke-color="string"></gmp-polyline-3d>
strokeOpacity
Tipo:  number optional
L'opacità del tratto tra 0.0 e 1.0.
Attributo HTML:
  • <gmp-polyline-3d stroke-opacity="number"></gmp-polyline-3d>
strokeWidth
Tipo:  number optional
Lo spessore del tratto in pixel.
Attributo HTML:
  • <gmp-polyline-3d stroke-width="number"></gmp-polyline-3d>
zIndex
Tipo:  number optional
Il valore zIndex rispetto ad altri poli.
Attributo HTML:
  • <gmp-polyline-3d z-index="number"></gmp-polyline-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parametri: 
  • typestring una stringa sensibile alle maiuscole che rappresenta il tipo di evento da ascoltare.
  • listenerEventListener|EventListenerObject l'oggetto che riceve una notifica. Deve essere una funzione o un oggetto con il metodo handleEvent
  • optionsboolean|AddEventListenerOptions optional Vedi le opzioni. Gli eventi personalizzati supportano solo capture e passive.
Valore restituito:  void
Configura una funzione che verrà chiamata ogni volta che l'evento specificato viene pubblicato nella destinazione. Consulta la colonna addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametri: 
  • typestring una stringa che specifica il tipo di evento per cui rimuovere un listener di eventi.
  • listenerEventListener|EventListenerObject il listener di eventi del gestore di eventi da rimuovere dalla destinazione dell'evento.
  • optionsboolean|EventListenerOptions optional Vedi le opzioni
Valore restituito:  void
Rimuove dalla destinazione un listener di eventi precedentemente registrato con c. Vedi removeEventListener

Interfaccia Polyline3DElementOptions

Interfaccia google.maps.maps3d.Polyline3DElementOptions

Oggetto Polyline3DElementOptions utilizzato per definire le proprietà che possono essere impostate su un oggetto Polyline3DElement.

altitudeMode optional
Tipo:  AltitudeMode optional
coordinates optional
drawsOccludedSegments optional
Tipo:  boolean optional
Predefinita: false
extruded optional
Tipo:  boolean optional
Predefinita: false
geodesic optional
Tipo:  boolean optional
Predefinita: false
outerColor optional
Tipo:  string optional
outerOpacity optional
Tipo:  number optional
outerWidth optional
Tipo:  number optional
strokeColor optional
Tipo:  string optional
strokeOpacity optional
Tipo:  number optional
strokeWidth optional
Tipo:  number optional
zIndex optional
Tipo:  number optional

Classe Polygon3DElement

google.maps.maps3d.Polygon3DElement classe

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 un'area piena.

Elemento personalizzato:
<gmp-polygon-3d altitude-mode="absolute" draws-occluded-segments extruded fill-color="string" fill-opacity="number" geodesic stroke-color="string" stroke-opacity="number" 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: 
altitudeMode
Tipo:  AltitudeMode optional
Specifica il modo in cui 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
Predefinita: false
Specifica se le parti del poligono che potrebbero essere oscurate sono disegnate o meno. I poligoni possono essere nascosti dalla geometria della mappa (ad esempio, gli edifici).
Attributo HTML:
  • <gmp-polygon-3d draws-occluded-segments></gmp-polygon-3d>
extruded
Tipo:  boolean optional
Predefinita: 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, ad eccezione dei colori con nome esteso.
Attributo HTML:
  • <gmp-polygon-3d fill-color="string"></gmp-polygon-3d>
fillOpacity
Tipo:  number optional
L'opacità di riempimento tra 0,0 e 1,0.
Attributo HTML:
  • <gmp-polygon-3d fill-opacity="number"></gmp-polygon-3d>
geodesic
Tipo:  boolean optional
Predefinita: false
Se true, i bordi del poligono vengono interpretati come geodetici e seguiranno la curvatura della Terra. Quando 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 anello chiuso. A differenza delle polilinee, un poligono può consistere di uno o più percorsi che creano più ritagli all'interno del poligono.
outerCoordinates
La sequenza ordinata di coordinate che indica un anello chiuso. L'altitudine viene ignorata in alcune modalità e quindi è facoltativa.
strokeColor
Tipo:  string optional
Il colore del tratto. Sono supportati tutti i colori CSS3, ad eccezione dei colori con nome esteso.
Attributo HTML:
  • <gmp-polygon-3d stroke-color="string"></gmp-polygon-3d>
strokeOpacity
Tipo:  number optional
L'opacità del tratto tra 0.0 e 1.0.
Attributo HTML:
  • <gmp-polygon-3d stroke-opacity="number"></gmp-polygon-3d>
strokeWidth
Tipo:  number optional
Lo spessore del tratto in pixel.
Attributo HTML:
  • <gmp-polygon-3d stroke-width="number"></gmp-polygon-3d>
zIndex
Tipo:  number optional
Il valore zIndex rispetto ad altri poli.
Attributo HTML:
  • <gmp-polygon-3d z-index="number"></gmp-polygon-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parametri: 
  • typestring una stringa sensibile alle maiuscole che rappresenta il tipo di evento da ascoltare.
  • listenerEventListener|EventListenerObject l'oggetto che riceve una notifica. Deve essere una funzione o un oggetto con il metodo handleEvent
  • optionsboolean|AddEventListenerOptions optional Vedi le opzioni. Gli eventi personalizzati supportano solo capture e passive.
Valore restituito:  void
Configura una funzione che verrà chiamata ogni volta che l'evento specificato viene pubblicato nella destinazione. Consulta la colonna addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parametri: 
  • typestring una stringa che specifica il tipo di evento per cui rimuovere un listener di eventi.
  • listenerEventListener|EventListenerObject il listener di eventi del gestore di eventi da rimuovere dalla destinazione dell'evento.
  • optionsboolean|EventListenerOptions optional Vedi le opzioni
Valore restituito:  void
Rimuove dalla destinazione un listener di eventi precedentemente registrato con c. Vedi removeEventListener

Interfaccia Polygon3DElementOptions

Interfaccia google.maps.maps3d.Polygon3DElementOptions

Oggetto Polygon3DElementOptions utilizzato per definire le proprietà che possono essere impostate su un elemento Polygon3DElement.

altitudeMode optional
Tipo:  AltitudeMode optional
drawsOccludedSegments optional
Tipo:  boolean optional
Predefinita: false
extruded optional
Tipo:  boolean optional
Predefinita: false
fillColor optional
Tipo:  string optional
fillOpacity optional
Tipo:  number optional
geodesic optional
Tipo:  boolean optional
Predefinita: false
innerCoordinates optional
outerCoordinates optional
strokeColor optional
Tipo:  string optional
strokeOpacity optional
Tipo:  number optional
strokeWidth optional
Tipo:  number optional
zIndex optional
Tipo:  number optional

Costanti di AltitudeMode

google.maps.maps3d.AltitudeMode costanti

Specifica il modo in cui 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 in relazione al livello medio del mare. Ciò significa anche che se il livello di dettaglio del terreno sotto l'oggetto cambia, la sua posizione assoluta rimarrà la stessa.
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 uno specchio d'acqua principale, si trova a livello del mare.
RELATIVE_TO_GROUND Consente di esprimere gli oggetti rispetto alla superficie del suolo. Se il livello di dettaglio del terreno cambia, la posizione dell'oggetto rimarrà costante rispetto al suolo. Quando si trova sull'acqua, l'altitudine viene interpretata come un valore in metri sul livello del mare.
RELATIVE_TO_MESH Consente di esprimere oggetti rispetto alla superficie più alta del sottosuolo, della superficie edilizia e dell'acqua. Quando si trova sull'acqua, sarà la superficie dell'acqua; in caso di superficie del terreno, sarà la superficie dell'edificio (se presente) o la superficie del suolo (se non sono presenti edifici).