Classe Map3DElement
Classe google.maps.maps3d.Map3DElement
Map3DElement est une interface HTML pour la vue Carte 3D.
Élément personnalisé:
<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>
Cette classe étend HTMLElement
.
Cette classe implémente Map3DElementOptions
.
Accédez-y en appelant const {Map3DElement} = await google.maps.importLibrary("maps3d")
. Consultez la section Bibliothèques de l'API Maps JavaScript.
Constructeur | |
---|---|
Map3DElement |
Map3DElement([options]) Paramètres:
|
Propriétés | |
---|---|
bounds |
Type:
LatLngBounds|LatLngBoundsLiteral optional Lorsque cette valeur est définie, la position de la caméra est limitée aux limites de latitude/longitude spécifiées. Notez que les objets situés en dehors des limites sont toujours affichés. Les limites peuvent restreindre la longitude et la latitude, ou uniquement l'une des deux. Pour les limites de latitude uniquement, utilisez les longitudes ouest et est de -180 et 180 , respectivement. Pour les limites de longitude uniquement, utilisez les latitudes nord et sud de 90 et -90 , respectivement. |
center |
Type:
LatLngAltitude|LatLngAltitudeLiteral optional Centre de la carte indiqué sous la forme d'une valeur LatLngAltitude, où l'altitude est exprimée en mètres au-dessus du niveau du sol. Notez que ce n'est pas nécessairement l'endroit où se trouve la caméra, car le champ
range affecte la distance de la caméra par rapport au centre de la carte. Si ce champ n'est pas défini, la valeur par défaut est {lat: 0, lng: 0, altitude: 63170000} . 63 170 000 mètres est l'altitude maximale autorisée (rayon de la Terre multiplié par 10).Attribut HTML
|
defaultLabelsDisabled |
Type:
boolean optional Par défaut:
false Lorsque la valeur est
true , les libellés de carte par défaut ne sont pas affichés.Attribut HTML
|
heading |
Type:
number optional Orientation de la boussole de la carte, en degrés, où le nord est à zéro. En l'absence d'inclinaison, tout roulis sera interprété comme un cap.
Attribut HTML
|
maxAltitude |
Type:
number optional Altitude maximale au-dessus du sol qui s'affichera sur la carte. Une valeur valide est comprise entre
0 et 63170000 mètres (rayon de la Terre multiplié par 10).Attribut HTML
|
maxHeading |
Type:
number optional Angle maximal de cap (rotation) de la carte. Une valeur valide est comprise entre
0 et 360 degrés. minHeading et maxHeading représentent un intervalle de <= 360 degrés dans lequel les gestes de direction sont autorisés. minHeading = 180 et maxHeading = 90 autorisent les titres dans [0, 90] et les titres dans [180, 360] . minHeading = 90 et maxHeading = 180 autorisent les titres dans [90, 180] .Attribut HTML
|
maxTilt |
Type:
number optional Angle d'incidence maximal de la carte. Une valeur valide est comprise entre
0 et 90 degrés.Attribut HTML
|
minAltitude |
Type:
number optional Altitude minimale au-dessus du sol qui s'affichera sur la carte. Une valeur valide est comprise entre
0 et 63170000 mètres (rayon de la Terre multiplié par 10).Attribut HTML
|
minHeading |
Type:
number optional Angle minimal de cap (rotation) de la carte. Une valeur valide est comprise entre
0 et 360 degrés. minHeading et maxHeading représentent un intervalle de <= 360 degrés dans lequel les gestes de direction sont autorisés. minHeading = 180 et maxHeading = 90 autorisent les titres dans [0, 90] et les titres dans [180, 360] . minHeading = 90 et maxHeading = 180 autorisent les titres dans [90, 180] .Attribut HTML
|
minTilt |
Type:
number optional Angle d'incidence minimal de la carte. Une valeur valide est comprise entre
0 et 90 degrés.Attribut HTML
|
range |
Type:
number optional Distance de la caméra au centre de la carte, en mètres.
Attribut HTML
|
roll |
Type:
number optional Inclinaison de la caméra autour du vecteur de vue, en degrés. Pour résoudre les ambiguïtés, en l'absence d'inclinaison, tout roulis est interprété comme un cap.
Attribut HTML
|
tilt |
Type:
number optional Inclinaison du vecteur de vue de la caméra, en degrés. Un vecteur de vue orienté directement vers le bas sur la Terre aurait une inclinaison de 0 degré. Un vecteur de vue pointant vers l'extérieur de la Terre aurait une inclinaison de
180 degrés.Attribut HTML
|
Méthodes | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Paramètres:
Valeur renvoyée:
void Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera envoyé à la cible. Voir addEventListener |
removeEventListener |
removeEventListener(type, listener[, options]) Paramètres:
Valeur renvoyée:
void Supprime de la cible un écouteur d'événement précédemment enregistré avec addEventListener. Voir removeEventListener |
Événements | |
---|---|
gmp-centerchange |
function(centerChangeEvent) Arguments:
Cet événement est déclenché lorsque la propriété "center" de Map3DElement change. |
gmp-click |
function(clickEvent) Arguments:
Cet événement est déclenché lorsqu'un utilisateur clique sur l'élément Map3DElement . |
gmp-headingchange |
function(headingChangeEvent) Arguments:
Cet événement est déclenché lorsque la propriété "heading" de Map3DElement change. |
gmp-rangechange |
function(rangeChangeEvent) Arguments:
Cet événement est déclenché lorsque la propriété de plage de Map3DElement change. |
gmp-rollchange |
function(rollChangeEvent) Arguments:
Cet événement est déclenché lorsque la propriété "roll" de Map3DElement change. |
gmp-steadychange |
function(steadyChangeEvent) Arguments:
Cet événement est déclenché lorsque l'état stable de Map3DElement change. |
gmp-tiltchange |
function(tiltChangeEvent) Arguments:
Cet événement est déclenché lorsque la propriété d'inclinaison de Map3DElement change. |
Interface Map3DElementOptions
Interface google.maps.maps3d.Map3DElementOptions
Objet Map3DElementOptions utilisé pour définir les propriétés pouvant être définies sur un élément Map3D.
Propriétés | |
---|---|
bounds optional |
Type:
LatLngBounds|LatLngBoundsLiteral optional Consultez les Map3DElement.bounds . |
center optional |
Type:
LatLngAltitude|LatLngAltitudeLiteral optional Consultez les Map3DElement.center . |
defaultLabelsDisabled optional |
Type:
boolean optional Consultez les Map3DElement.defaultLabelsDisabled . |
heading optional |
Type:
number optional Consultez les Map3DElement.heading . |
maxAltitude optional |
Type:
number optional Consultez les Map3DElement.maxAltitude . |
maxHeading optional |
Type:
number optional Consultez les Map3DElement.maxHeading . |
maxTilt optional |
Type:
number optional Consultez les Map3DElement.maxTilt . |
minAltitude optional |
Type:
number optional Consultez les Map3DElement.minAltitude . |
minHeading optional |
Type:
number optional Consultez les Map3DElement.minHeading . |
minTilt optional |
Type:
number optional Consultez les Map3DElement.minTilt . |
range optional |
Type:
number optional Consultez les Map3DElement.range . |
roll optional |
Type:
number optional Consultez les Map3DElement.roll . |
tilt optional |
Type:
number optional Consultez les Map3DElement.tilt . |
Classe SteadyChangeEvent
Classe google.maps.maps3d.SteadyChangeEvent
Cet événement est créé à partir de la surveillance d'un état stable de Map3DElement
. Cet événement remonte dans l'arborescence DOM.
Cette classe étend Event
.
Accédez-y en appelant const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d")
. Consultez la section Bibliothèques de l'API Maps JavaScript.
Propriétés | |
---|---|
isSteady |
Type:
boolean Indique si Map3DElement est stable (c'est-à-dire que l'affichage de la scène actuelle est terminé) ou non. |
Classe ClickEvent
Classe google.maps.maps3d.ClickEvent
Cet événement est créé en cliquant sur un élément Map3D.
Cette classe étend Event
.
Accédez-y en appelant const {ClickEvent} = await google.maps.importLibrary("maps3d")
. Consultez la section Bibliothèques de l'API Maps JavaScript.
Propriétés | |
---|---|
position |
Type:
LatLngAltitude optional Latitude/Longitude/Altitude sous le curseur au moment de l'événement. Notez que les données renvoyées seront moins précises à des niveaux plus grossiers. De plus, l'altitude peut être renvoyée pour la valeur d'altitude lorsque vous cliquez sur la surface de l'eau depuis des positions de caméra plus élevées. Cet événement remonte dans l'arborescence DOM. |
Classe CenterChangeEvent
Classe google.maps.maps3d.CenterChangeEvent
Cet événement est créé à partir du changement de centre de surveillance le Map3DElement
. Cet événement remonte dans l'arborescence DOM.
Cette classe étend Event
.
Accédez-y en appelant const {CenterChangeEvent} = await google.maps.importLibrary("maps3d")
. Consultez la section Bibliothèques de l'API Maps JavaScript.
Classe HeadingChangeEvent
Classe google.maps.maps3d.HeadingChangeEvent
Cet événement est créé à partir de la surveillance du changement de cap sur Map3DElement
. Cet événement remonte dans l'arborescence DOM.
Cette classe étend Event
.
Accédez-y en appelant const {HeadingChangeEvent} = await google.maps.importLibrary("maps3d")
. Consultez la section Bibliothèques de l'API Maps JavaScript.
Classe RangeChangeEvent
Classe google.maps.maps3d.RangeChangeEvent
Cet événement est créé à partir de la modification de la plage de surveillance le Map3DElement
. Cet événement remonte dans l'arborescence DOM.
Cette classe étend Event
.
Accédez-y en appelant const {RangeChangeEvent} = await google.maps.importLibrary("maps3d")
. Consultez la section Bibliothèques de l'API Maps JavaScript.
Classe RollChangeEvent
Classe google.maps.maps3d.RollChangeEvent
Cet événement est créé à partir du changement de rôle de surveillance sur Map3DElement
. Cet événement remonte dans l'arborescence DOM.
Cette classe étend Event
.
Accédez-y en appelant const {RollChangeEvent} = await google.maps.importLibrary("maps3d")
. Consultez la section Bibliothèques de l'API Maps JavaScript.
Classe TiltChangeEvent
Classe google.maps.maps3d.TiltChangeEvent
Cet événement est créé à partir de la surveillance du changement d'inclinaison sur Map3DElement
. Cet événement remonte dans l'arborescence DOM.
Cette classe étend Event
.
Accédez-y en appelant const {TiltChangeEvent} = await google.maps.importLibrary("maps3d")
. Consultez la section Bibliothèques de l'API Maps JavaScript.
Classe Polyline3DElement
Classe google.maps.maps3d.Polyline3DElement
Une polyligne 3D est une superposition linéaire de segments de ligne connectés sur une carte 3D.
Élément personnalisé:
<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>
Cette classe étend HTMLElement
.
Cette classe implémente Polyline3DElementOptions
.
Accédez-y en appelant const {Polyline3DElement} = await google.maps.importLibrary("maps3d")
. Consultez la section Bibliothèques de l'API Maps JavaScript.
Constructeur | |
---|---|
Polyline3DElement |
Polyline3DElement([options]) Paramètres:
|
Propriétés | |
---|---|
altitudeMode |
Type:
AltitudeMode optional Par défaut:
AltitudeMode.ABSOLUTE Indique comment les composants d'altitude des coordonnées sont interprétés.
Attribut HTML
|
coordinates |
Type:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional Séquence ordonnée des coordonnées de la polyligne. L'altitude est ignorée dans certains modes et est donc facultative. |
drawsOccludedSegments |
Type:
boolean optional Par défaut:
false Indique si les parties de la polyligne qui pourraient être masquées sont dessinées ou non. Les polylignes peuvent être masquées par la géométrie de la carte (bâtiments, par exemple).
Attribut HTML
|
extruded |
Type:
boolean optional Par défaut:
false Indique si la polyligne doit être connectée au sol. Pour extruder une polyligne,
altitudeMode doit être RELATIVE_TO_GROUND ou ABSOLUTE .Attribut HTML
|
geodesic |
Type:
boolean optional Par défaut:
false Lorsque la valeur est
true , les arêtes de la polyligne sont interprétées comme géodésiques et suivent la courbure de la Terre. Lorsque la valeur est false , les bords de la polyligne sont affichés sous forme de lignes droites dans l'espace de l'écran.Attribut HTML
|
outerColor |
Type:
string optional Couleur extérieure. Toutes les couleurs CSS3 sont compatibles.
Attribut HTML
|
outerOpacity |
Type:
number optional Opacité extérieure comprise entre
0.0 et 1.0 .Attribut HTML
|
outerWidth |
Type:
number optional La largeur extérieure est comprise entre
0.0 et 1.0 . Il s'agit d'un pourcentage de l'strokeWidth .Attribut HTML
|
strokeColor |
Type:
string optional Couleur du trait. Toutes les couleurs CSS3 sont compatibles.
Attribut HTML
|
strokeOpacity |
Type:
number optional Opacité du trait, entre
0.0 et 1.0 .Attribut HTML
|
strokeWidth |
Type:
number optional Épaisseur du trait, en pixels.
Attribut HTML
|
zIndex |
Type:
number optional L'indice z par rapport aux autres polys.
Attribut HTML
|
Méthodes | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Paramètres:
Valeur renvoyée:
void Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera envoyé à la cible. Voir addEventListener |
removeEventListener |
removeEventListener(type, listener[, options]) Paramètres:
Valeur renvoyée:
void Supprime de la cible un écouteur d'événement précédemment enregistré avec addEventListener. Voir removeEventListener |
Interface Polyline3DElementOptions
Interface google.maps.maps3d.Polyline3DElementOptions
Objet Polyline3DElementOptions utilisé pour définir les propriétés pouvant être définies sur un élément Polyline3D.
Propriétés | |
---|---|
altitudeMode optional |
Type:
AltitudeMode optional Par défaut:
AltitudeMode.ABSOLUTE Consultez les Polyline3DElement.altitudeMode . |
coordinates optional |
Type:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional Consultez les Polyline3DElement.coordinates . |
drawsOccludedSegments optional |
Type:
boolean optional Par défaut:
false Consultez les Polyline3DElement.drawsOccludedSegments . |
extruded optional |
Type:
boolean optional Par défaut:
false Consultez les Polyline3DElement.extruded . |
geodesic optional |
Type:
boolean optional Par défaut:
false Consultez les Polyline3DElement.geodesic . |
outerColor optional |
Type:
string optional Consultez les Polyline3DElement.outerColor . |
outerOpacity optional |
Type:
number optional Consultez les Polyline3DElement.outerOpacity . |
outerWidth optional |
Type:
number optional Consultez les Polyline3DElement.outerWidth . |
strokeColor optional |
Type:
string optional Consultez les Polyline3DElement.strokeColor . |
strokeOpacity optional |
Type:
number optional Consultez les Polyline3DElement.strokeOpacity . |
strokeWidth optional |
Type:
number optional Consultez les Polyline3DElement.strokeWidth . |
zIndex optional |
Type:
number optional Consultez les Polyline3DElement.zIndex . |
Classe Polygon3DElement
Classe google.maps.maps3d.Polygon3DElement
Un polygone 3D (comme une polyligne 3D) définit une série de coordonnées connectées dans une séquence ordonnée. De plus, les polygones forment une boucle fermée et définissent une région remplie.
Élément personnalisé:
<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>
Cette classe étend HTMLElement
.
Cette classe implémente Polygon3DElementOptions
.
Accédez-y en appelant const {Polygon3DElement} = await google.maps.importLibrary("maps3d")
. Consultez la section Bibliothèques de l'API Maps JavaScript.
Constructeur | |
---|---|
Polygon3DElement |
Polygon3DElement([options]) Paramètres:
|
Propriétés | |
---|---|
altitudeMode |
Type:
AltitudeMode optional Par défaut:
AltitudeMode.ABSOLUTE Indique comment les composants d'altitude des coordonnées sont interprétés.
Attribut HTML
|
drawsOccludedSegments |
Type:
boolean optional Par défaut:
false Indique si les parties du polygone qui pourraient être masquées sont dessinées ou non. Les polygones peuvent être masqués par la géométrie de la carte (bâtiments, par exemple).
Attribut HTML
|
extruded |
Type:
boolean optional Par défaut:
false Indique si le polygone doit être connecté au sol. Pour extruder un polygone,
altitudeMode doit être RELATIVE_TO_GROUND ou ABSOLUTE .Attribut HTML
|
fillColor |
Type:
string optional Couleur de remplissage. Toutes les couleurs CSS3 sont compatibles.
Attribut HTML
|
fillOpacity |
Type:
number optional Opacité de remplissage comprise entre 0,0 et 1,0.
Attribut HTML
|
geodesic |
Type:
boolean optional Par défaut:
false Lorsque la valeur est
true , les arêtes du polygone sont interprétées comme géodésiques et suivent la courbure de la Terre. Lorsque la valeur est false , les bords du polygone sont affichés sous forme de lignes droites dans l'espace de l'écran.Attribut HTML
|
innerCoordinates |
Type:
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optional Séquence ordonnée de coordonnées qui désigne une boucle fermée. Contrairement aux polylignes, un polygone peut être constitué d'un ou de plusieurs tracés, qui créent plusieurs découpes à l'intérieur du polygone. |
outerCoordinates |
Type:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional Séquence ordonnée de coordonnées qui désigne une boucle fermée. L'altitude est ignorée dans certains modes et est donc facultative. |
strokeColor |
Type:
string optional Couleur du trait. Toutes les couleurs CSS3 sont compatibles.
Attribut HTML
|
strokeOpacity |
Type:
number optional Opacité du trait, entre
0.0 et 1.0 .Attribut HTML
|
strokeWidth |
Type:
number optional Épaisseur du trait, en pixels.
Attribut HTML
|
zIndex |
Type:
number optional L'indice z par rapport aux autres polys.
Attribut HTML
|
Méthodes | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Paramètres:
Valeur renvoyée:
void Configure une fonction qui sera appelée chaque fois que l'événement spécifié sera envoyé à la cible. Voir addEventListener |
removeEventListener |
removeEventListener(type, listener[, options]) Paramètres:
Valeur renvoyée:
void Supprime de la cible un écouteur d'événement précédemment enregistré avec addEventListener. Voir removeEventListener |
Interface Polygon3DElementOptions
Interface google.maps.maps3d.Polygon3DElementOptions
Objet Polygon3DElementOptions utilisé pour définir les propriétés pouvant être définies sur un élément Polygon3D.
Constantes AltitudeMode
Constantes google.maps.maps3d.AltitudeMode
Indique comment les composants d'altitude des coordonnées sont interprétés.
Accédez-y en appelant const {AltitudeMode} = await google.maps.importLibrary("maps3d")
. Consultez la section Bibliothèques de l'API Maps JavaScript.
Constantes | |
---|---|
ABSOLUTE |
Permet d'exprimer les objets par rapport au niveau moyen de la mer. Cela signifie également que si le niveau de détail du terrain change sous l'objet, sa position absolue restera la même. |
CLAMP_TO_GROUND |
Permet d'exprimer des objets placés sur le sol. Elles resteront au niveau du sol et suivront le relief, quelle que soit l'altitude fournie. Si l'objet est positionné au-dessus d'un grand plan d'eau, il est placé au niveau de la mer. |
RELATIVE_TO_GROUND |
Permet d'exprimer des objets par rapport à la surface du sol. Si le niveau de détail du terrain change, la position de l'objet reste constante par rapport au sol. Au-dessus de l'eau, l'altitude est interprétée comme une valeur en mètres au-dessus du niveau de la mer. |
RELATIVE_TO_MESH |
Permet d'exprimer les objets par rapport à la surface la plus élevée du sol, des bâtiments et de l'eau. S'il s'agit d'un survol au-dessus de l'eau, il s'agit de la surface de l'eau. S'il s'agit d'un survol au-dessus du terrain, il s'agit de la surface du bâtiment (s'il y en a un) ou de la surface du sol (s'il n'y a pas de bâtiment). |