Classe Map3DElement
Classe google.maps.maps3d.Map3DElement
Map3DElement est une interface HTML pour la vue de carte 3D. Notez que mode
doit être défini pour que la carte 3D commence à s'afficher.
Élément personnalisé :
<gmp-map-3d center="lat,lng,altitude" default-ui-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" mode="hybrid" range="number" roll="number" tilt="number"></gmp-map-3d>
Cette classe étend HTMLElement
.
Cette classe implémente Map3DElementOptions
.
Accédez-y en appelant le const {Map3DElement} = await google.maps.importLibrary("maps3d")
.
Consultez Bibliothèques de l'API Maps JavaScript.
Constructeur | |
---|---|
Map3DElement |
Map3DElement([options]) Paramètres :
|
Propriétés | |
---|---|
bounds |
Type :
LatLngBounds|LatLngBoundsLiteral optional Lorsqu'il est défini, il limite la position de la caméra 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 fois la longitude et la latitude, ou uniquement la latitude ou la longitude. 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'un objet LatLngAltitude, où l'altitude est exprimée en mètres au-dessus du niveau du sol. Notez que cela ne correspond pas forcément à l'emplacement de 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 :
|
defaultUIDisabled |
Type :
boolean optional Par défaut :
false Lorsque la valeur est
true , tous les boutons de l'UI par défaut sont désactivés. Ne désactive pas le clavier ni les commandes gestuelles.Attribut HTML :
|
heading |
Type :
number optional Cap de la carte (en degrés), où le nord est égal à 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 sera affichée 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 du 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 cap seront autorisés. minHeading = 180 et maxHeading = 90 autorisent les titres dans [0, 90] et [180, 360] . minHeading = 90 et maxHeading = 180 autoriseront l'en-tête 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 sera affichée 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 du 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 cap seront autorisés. minHeading = 180 et maxHeading = 90 autorisent les titres dans [0, 90] et [180, 360] . minHeading = 90 et maxHeading = 180 autoriseront l'en-tête 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 :
|
mode |
Type :
MapMode optional Spécifie un mode dans lequel la carte doit être affichée. Si elle n'est pas définie, la carte ne sera pas affichée.
Attribut HTML :
|
range |
Type :
number optional Distance entre la caméra et le 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 lever toute ambiguïté, en l'absence d'inclinaison, tout angle de roulis sera 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 pointant directement vers le bas aurait une inclinaison de zéro degré. Un vecteur de vue pointant loin de la Terre aurait une inclinaison de
180 degrés.Attribut HTML :
|
Méthodes | |
---|---|
|
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 distribué à la cible. Consultez addEventListener. |
flyCameraAround |
flyCameraAround(options) Paramètres :
Valeur renvoyée : aucune
Cette méthode fait orbiter la caméra autour d'un emplacement donné pendant une durée donnée, en effectuant le nombre de tours indiqué pendant cette période. Par défaut, la caméra orbite dans le sens des aiguilles d'une montre. Si un nombre négatif est indiqué pour les tours, la caméra effectue une orbite dans le sens inverse des aiguilles d'une montre. La méthode est asynchrone, car les animations ne peuvent démarrer qu'une fois que la carte a chargé une quantité minimale. La méthode renvoie une fois l'animation démarrée. Si le nombre de tours est nul, aucune rotation ne se produit et l'animation se termine immédiatement après son démarrage. |
flyCameraTo |
flyCameraTo(options) Paramètres :
Valeur renvoyée : aucune
Cette méthode déplace la caméra de manière parabolique de l'emplacement actuel à un emplacement de fin donné sur une durée donnée. La méthode est asynchrone, car les animations ne peuvent démarrer qu'une fois que la carte a chargé une quantité minimale. La méthode renvoie une fois l'animation démarrée. |
|
removeEventListener(type, listener[, options]) Paramètres :
Valeur renvoyée :
void Supprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener. |
stopCameraAnimation |
stopCameraAnimation() Paramètres : aucun
Valeur renvoyée : aucune
Cette méthode arrête toute animation de survol en cours d'exécution. La caméra reste à l'endroit où elle se trouve au milieu de l'animation. Elle ne se téléporte pas au point final. La méthode est asynchrone, car les animations ne peuvent démarrer ou s'arrêter qu'une fois que la carte a chargé une quantité minimale. La méthode renvoie une valeur une fois l'animation arrêtée. |
Événements | |
---|---|
gmp-animationend |
function(animationEndEvent) Arguments :
Cet événement est déclenché lorsque l'animation de vol se termine. Cet événement se propage dans l'arborescence DOM. |
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é lorsque l'élément Map3DElement est cliqué. |
gmp-headingchange |
function(headingChangeEvent) Arguments :
Cet événement est déclenché lorsque la propriété d'en-tête de Map3DElement change. |
gmp-rangechange |
function(rangeChangeEvent) Arguments :
Cet événement est déclenché lorsque la propriété "range" de Map3DElement change. |
gmp-rollchange |
function(rollChangeEvent) Arguments :
Cet événement est déclenché lorsque la propriété de roulis 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 Map3DElement.
Propriétés | |
---|---|
bounds optional |
Type :
LatLngBounds|LatLngBoundsLiteral optional Consultez les
|