3D Maps

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

Cette classe étend HTMLElement.

Cette classe implémente Map3DElementOptions.

Accès en appelant const {Map3DElement} = await google.maps.importLibrary("maps3d") Consultez la section Bibliothèques de l'API Maps JavaScript.
Map3DElement
Map3DElement([options])
Paramètres :
bounds
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 quand même affichés. Les limites peuvent restreindre à la fois la longitude et la latitude, ou seulement 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
Centre de la carte indiqué en tant que 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
     :
  • <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
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
     :
  • <gmp-map-3d default-labels-disabled></gmp-map-3d>
defaultUIDisabled
Type:boolean optional
Par défaut : false
Lorsque la valeur est true, tous les boutons de l'interface utilisateur par défaut sont désactivés. Ne désactive pas le clavier ni les commandes gestuelles.
Attribut HTML
     :
  • <gmp-map-3d default-ui-disabled></gmp-map-3d>
heading
Type : number optional
Orientation de la boussole sur la carte, en degrés, où le nord géographique est égal à zéro. En l'absence d'inclinaison, tous les lancers sont interprétés comme un cap.
Attribut HTML
     :
  • <gmp-map-3d heading="number"></gmp-map-3d>
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
     :
  • <gmp-map-3d max-altitude="number"></gmp-map-3d>
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 moins de 360 degrés selon lequel les gestes de direction seront 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
     :
  • <gmp-map-3d max-heading="number"></gmp-map-3d>
maxTilt
Type : number optional
Angle d'incidence maximal de la carte. Une valeur valide est comprise entre 0 et 90 degrés.
Attribut HTML
     :
  • <gmp-map-3d max-tilt="number"></gmp-map-3d>
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
     :
  • <gmp-map-3d min-altitude="number"></gmp-map-3d>
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
     :
  • <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt
Type : number optional
Angle d'incidence minimal de la carte. Une valeur valide est comprise entre 0 et 90 degrés.
Attribut HTML
     :
  • <gmp-map-3d min-tilt="number"></gmp-map-3d>
range
Type : number optional
Distance de la caméra au centre de la carte, en mètres.
Attribut HTML
     :
  • <gmp-map-3d range="number"></gmp-map-3d>
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:
  • <gmp-map-3d roll="number"></gmp-map-3d>
tilt
Type:number optional
Inclinaison du vecteur de vue de la caméra, en degrés. Un vecteur de vue pointant directement vers la terre présenterait une inclinaison de zéro degré. Un vecteur de vue pointant vers l'extérieur de la Terre aurait une inclinaison de 180 degrés.
Attribut HTML:
  • <gmp-map-3d tilt="number"></gmp-map-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres: 
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject Objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional Voir les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
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
flyCameraAround
flyCameraAround(options)
Paramètres: 
Valeur renvoyée : aucune
Cette méthode fait tourner la caméra autour d'un emplacement donné pendant une durée donnée, effectuant le nombre de tours donné pendant ce temps.

Par défaut, la caméra tourne dans le sens des aiguilles d'une montre. Si vous définissez un nombre négatif pour les arrondis, la caméra 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é un volume minimal. La méthode renvoie une valeur une fois l'animation lancée.

Si le nombre de tours est nul, aucun spin 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 vers un emplacement final donné sur une durée donnée.

La méthode est asynchrone, car les animations ne peuvent commencer qu'après que la carte a chargé une quantité minimale. La méthode renvoie une valeur une fois l'animation lancée.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres: 
  • type : string Chaîne spécifiant le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject Écouteur d'événements du gestionnaire d'événements à supprimer de la cible d'événement.
  • options : boolean|EventListenerOptions optional Voir les options
Valeur renvoyée : void
Supprime de la cible un écouteur d'événement précédemment enregistré avec addEventListener. Voir removeEventListener
stopCameraAnimation
stopCameraAnimation()
Paramètres : aucun
Valeur renvoyée : aucune
Cette méthode arrête toute animation de vol qui pourrait être 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 commencer ou s'arrêter qu'après que la carte a chargé une quantité minimale. La méthode renvoie une valeur une fois l'animation arrêtée.
gmp-animationend
function(animationEndEvent)
Arguments:
  • animationEndEvent : Event
Cet événement est déclenché à la fin de l'animation de vol. Cet événement remonte dans l'arborescence DOM.
gmp-centerchange
function(centerChangeEvent)
Arguments : 
  • centerChangeEvent : Event
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 : 
  • headingChangeEvent : Event
Cet événement est déclenché lorsque la propriété "heading" de Map3DElement change.
gmp-rangechange
function(rangeChangeEvent)
Arguments : 
  • rangeChangeEvent:  Event
Cet événement est déclenché lorsque la propriété de plage de Map3DElement change.
gmp-rollchange
function(rollChangeEvent)
Arguments : 
  • rollChangeEvent:  Event
Cet événement est déclenché lorsque la propriété "roll" de Map3DElement est modifiée.
gmp-steadychange
function(steadyChangeEvent)
Arguments : 
Cet événement est déclenché lorsque l'état stable de Map3DElement change.
gmp-tiltchange
function(tiltChangeEvent)
Arguments : 
  • tiltChangeEvent : Event
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.
bounds optional
Consultez les Map3DElement.bounds.
center optional
Consultez les Map3DElement.center.
defaultLabelsDisabled optional
Type : boolean optional
Consultez les Map3DElement.defaultLabelsDisabled.
defaultUIDisabled optional
Type : boolean optional
Consultez les Map3DElement.defaultUIDisabled.
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.

Interface FlyAroundAnimationOptions

Interface google.maps.maps3d.FlyAroundAnimationOptions

Options de personnalisation de l'animation FlyCameraAround.
camera
Point central vers lequel la caméra doit regarder pendant l'animation en orbite. Notez que l'orientation de la carte change à mesure que la caméra tourne autour de ce point central.
durationMillis optional
Type : number optional
Durée de l'animation en millisecondes. Il s'agit de la durée totale de l'animation, et non de la durée d'une rotation unique.
rounds optional
Type : number optional
Nombre de tours à effectuer autour du centre pendant la durée donnée. Cette option contrôle la vitesse de rotation globale. Si vous transmettez un nombre négatif à rounds, la caméra pivotera dans le sens inverse des aiguilles d'une montre au lieu du sens par défaut.

Interface FlyToAnimationOptions

Interface google.maps.maps3d.FlyToAnimationOptions

Options de personnalisation de l'animation FlyCameraTo.
endCamera
Emplacement vers lequel la caméra doit pointer à la fin de l'animation.
durationMillis optional
Type : number optional
Durée de l'animation en millisecondes. Une durée de 0 téléporte la caméra directement à la position de fin.

Interface CameraOptions

Interface google.maps.maps3d.CameraOptions

Objet CameraOptions utilisé pour définir les propriétés pouvant être définies sur un objet caméra. L'objet caméra peut être n'importe quel élément qui possède une position de caméra, par exemple un état de carte actuel ou un état d'animation futur demandé.
center optional
Consultez les Map3DElement.center.
heading optional
Type : number optional
Consultez les Map3DElement.heading.
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 Bibliothèques dans l'API Maps JavaScript.
isSteady
Type : boolean
Indique si l'élément Map3DElement est stable ou non (le rendu de la scène actuelle est terminé).

Classe LocationClickEvent

Classe google.maps.maps3d.LocationClickEvent

Cet événement est créé en cliquant sur un élément Map3DElement.

Cette classe étend Event.

Accédez-y en appelant const {LocationClickEvent} = await google.maps.importLibrary("maps3d"). Consultez la section Bibliothèques de l'API Maps JavaScript.
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 PlaceClickEvent

Classe google.maps.maps3d.PlaceClickEvent

Cet événement est créé en cliquant sur un élément Map3D.

Cette classe étend LocationClickEvent.

Accédez-y en appelant const {PlaceClickEvent} = await google.maps.importLibrary("maps3d"). Consultez Bibliothèques dans l'API Maps JavaScript.
placeId
Type:string
ID de lieu de l'élément géographique de la carte.
Hérité: position
fetchPlace
fetchPlace()
Paramètres : aucun
Valeur renvoyée:  Promise<Place>
Extrait un Place pour cet identifiant de lieu. Dans l'objet Place généré, la propriété "id" sera renseignée. Vous pouvez ensuite demander des champs supplémentaires via Place.fetchFields(), sous réserve de l'activation et de la facturation normales de l'API Places. La promesse est rejetée en cas d'erreur lors de la récupération de Place.

Classe Marker3DElement

Classe google.maps.maps3d.Marker3DElement

Affiche une position sur une carte 3D. Notez que position doit être défini pour que Marker3DElement s'affiche.

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

Cette classe étend HTMLElement.

Cette classe implémente Marker3DElementOptions.

Accédez-y en appelant const {Marker3DElement} = await google.maps.importLibrary("maps3d"). Consultez la section Bibliothèques de l'API Maps JavaScript.
Marker3DElement
Marker3DElement([options])
Paramètres: 
Crée un Marker3DElement avec les options spécifiées.
altitudeMode
Type:AltitudeMode optional
Spécifie la manière dont la composante d'altitude de la position est interprétée.
Attribut 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
Type : CollisionBehavior optional
Énumération spécifiant le comportement d'un Marker3DElement en cas de collision avec un autre Marker3DElement ou les libellés de la carte de base.
Attribut 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
Type:boolean optional
Par défaut:false
Indique si ce repère doit être dessiné ou non lorsqu'il est masqué. Le repère peut être masqué par la géométrie de la carte (des bâtiments, par exemple).
Attribut HTML:
  • <gmp-marker-3d draws-when-occluded></gmp-marker-3d>
extruded
Type:boolean optional
Par défaut : false
Indique si le repère doit être connecté au sol. Pour extruder un repère, altitudeMode doit être RELATIVE_TO_GROUND ou ABSOLUTE.
Attribut HTML
     :
  • <gmp-marker-3d extruded></gmp-marker-3d>
label
Type : string optional
Texte à afficher pour ce repère.
Attribut HTML
     :
  • <gmp-marker-3d label="string"></gmp-marker-3d>
position
Emplacement de la pointe du repère. L'altitude est ignorée dans certains modes et est donc facultative.
sizePreserved
Type : boolean optional
Par défaut : false
Indique si ce repère doit conserver sa taille, quelle que soit la distance par rapport à la caméra. Par défaut, la taille du repère est proportionnelle à la distance de la caméra/à l'inclinaison.
Attribut HTML
     :
  • <gmp-marker-3d size-preserved></gmp-marker-3d>
zIndex
Type:number optional
L'indice z par rapport aux autres repères.
Attribut HTML
     :
  • <gmp-marker-3d z-index="number"></gmp-marker-3d>
default
Tous les éléments personnalisés ajoutés directement à Marker3DElement seront positionnés. Toutefois, seuls les éléments des types HTMLImageElement, SVGElement et PinElement seront utilisés pour dessiner des repères. Les autres éléments seront ignorés.
HTMLImageElement et SVGElement doivent être encapsulés dans un élément <template> avant d'être attribués à l'emplacement par défaut de Marker3DElement.

Les images et les SVG sont actuellement rastérisés avant d'être affichés dans la scène 3D. Par conséquent, le code HTML personnalisé intégré aux classes SVG ou CSS ajoutées aux images ne sera pas appliqué et risque de ne pas être reflété lorsque les repères s'afficheront à l'écran.
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres: 
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener:  EventListener|EventListenerObject objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional Voir les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
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
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string Chaîne spécifiant le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject : écouteur d'événements du gestionnaire d'événements à supprimer de la cible de l'événement.
  • options : boolean|EventListenerOptions optional Voir les options
Valeur renvoyée:  void
Supprime de la cible un écouteur d'événement précédemment enregistré avec addEventListener. Voir removeEventListener

Interface Marker3DElementOptions

Interface google.maps.maps3d.Marker3DElementOptions

Objet Marker3DElementOptions utilisé pour définir les propriétés pouvant être définies sur un élément Marker3D.
altitudeMode optional
Type : AltitudeMode optional
Consultez les Marker3DElement.altitudeMode.
collisionBehavior optional
Type : CollisionBehavior optional
Consultez les Marker3DElement.collisionBehavior.
drawsWhenOccluded optional
Type : boolean optional
Consultez les Marker3DElement.drawsWhenOccluded.
extruded optional
Type : boolean optional
Consultez les Marker3DElement.extruded.
label optional
Type : string optional
Consultez les Marker3DElement.label.
position optional
Consultez les Marker3DElement.position.
sizePreserved optional
Type : boolean optional
Consultez les Marker3DElement.sizePreserved.
zIndex optional
Type : number optional
Consultez les Marker3DElement.zIndex.

Classe Marker3DInteractiveElement

Classe google.maps.maps3d.Marker3DInteractiveElement

Affiche une position sur une carte 3D. Notez que position doit être défini pour que Marker3DInteractiveElement s'affiche. Contrairement à Marker3DElement, Marker3DInteractiveElement reçoit un événement gmp-click.

Élément personnalisé :
<gmp-marker-3d-interactive></gmp-marker-3d-interactive>

Cette classe étend Marker3DElement.

Cette classe implémente Marker3DInteractiveElementOptions.

Accédez-y en appelant const {Marker3DInteractiveElement} = await google.maps.importLibrary("maps3d"). Consultez la section Bibliothèques de l'API Maps JavaScript.
Marker3DInteractiveElement
Marker3DInteractiveElement([options])
Paramètres :
Crée un Marker3DInteractiveElement avec les options spécifiées.
Hérité : altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex
default
Tous les éléments personnalisés ajoutés directement à Marker3DInteractiveElement seront placés dans des emplacements. Toutefois, seuls les éléments de type PinElement seront utilisés pour dessiner des repères. Les autres éléments seront ignorés.
addEventListener
addEventListener(type, listener[, options])
Paramètres: 
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener:  EventListener|EventListenerObject objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional Voir les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
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 :
  • type : string Chaîne spécifiant le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject Écouteur d'événements du gestionnaire d'événements à supprimer de la cible d'événement.
  • options:  boolean|EventListenerOptions optional Voir les options
Valeur renvoyée:  void
Supprime de la cible un écouteur d'événements précédemment enregistré auprès de addEventListener. Voir removeEventListener
gmp-click
function(clickEvent)
Arguments:
Cet événement est déclenché lorsque l'utilisateur clique sur l'élément Marker3DInteractiveElement.

Interface Marker3DInteractiveElementOptions.

Interface google.maps.maps3d.Marker3DInteractiveElementOptions

Objet Marker3DInteractiveElementOptions utilisé pour définir les propriétés pouvant être définies sur un Marker3DInteractiveElement.

Cette interface étend Marker3DElementOptions.

Hérité : altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex

Classe Model3DElement

Classe google.maps.maps3d.Model3DElement

Modèle 3D permettant le rendu de modèles glTF. Notez que position et src doivent être définis pour que Model3DElement s'affiche.

Les propriétés principales du PBR glTF doivent être prises en charge. Aucune extension ou propriété d'extension n'est actuellement compatible.

Élément personnalisé :
<gmp-model-3d altitude-mode="absolute" src="src"></gmp-model-3d>

Cette classe étend HTMLElement.

Cette classe implémente Model3DElementOptions.

Accédez-y en appelant const {Model3DElement} = await google.maps.importLibrary("maps3d"). Consultez la section Bibliothèques de l'API Maps JavaScript.
Model3DElement
Model3DElement([options])
Paramètres :
Crée un Model3DElement avec les options spécifiées.
altitudeMode
Type:AltitudeMode optional
Indique comment l'altitude de la position est interprétée.
Attribut 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
Décrit la rotation du système de coordonnées d'un modèle 3D pour le positionner sur la carte 3D.

Les rotations sont appliquées au modèle dans l'ordre suivant : roulis, inclinaison, puis cap.
position
Définit la position de Model3DElement. L'altitude est ignorée dans certains modes et est donc facultative.
scale
Type : number|Vector3D|Vector3DLiteral optional
Par défaut:1
Échelle le modèle le long des axes X, Y et Z dans l'espace de coordonnées du modèle.
src
Type : string|URL optional
Spécifie l'URL du modèle 3D. Pour le moment, seuls les modèles au format .glb sont acceptés.

Toutes les URL HTTP relatives seront converties en URL absolues correspondantes.

Si vous hébergez vos fichiers de modèle .glb sur un site Web ou un serveur différent de votre application principale, veillez à configurer les en-têtes HTTP CORS appropriés. Cela permet à votre application d'accéder de manière sécurisée aux fichiers de modèle de l'autre domaine.
Attribut HTML
     :
  • <gmp-model-3d src="src"></gmp-model-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject Objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional Voir les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
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
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string Chaîne spécifiant le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject Écouteur d'événements du gestionnaire d'événements à supprimer de la cible d'événement.
  • options : boolean|EventListenerOptions optional Voir les options
Valeur renvoyée : void
Supprime de la cible un écouteur d'événement précédemment enregistré avec addEventListener. Voir removeEventListener

Interface Model3DElementOptions

Interface google.maps.maps3d.Model3DElementOptions

Objet Model3DElementOptions utilisé pour définir les propriétés pouvant être définies sur un élément Model3DElement.
altitudeMode optional
Type : AltitudeMode optional
Consultez les Model3DElement.altitudeMode.
orientation optional
Consultez les Model3DElement.orientation.
position optional
Consultez les Model3DElement.position.
scale optional
Type : number|Vector3D|Vector3DLiteral optional
Consultez les Model3DElement.scale.
src optional
Type : string|URL optional
Consultez les Model3DElement.src.

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-width="number" stroke-color="string" 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.
Polyline3DElement
Polyline3DElement([options])
Paramètres :
Crée un Polyline3DElement avec les options spécifiées.
altitudeMode
Type : AltitudeMode optional
Par défaut : AltitudeMode.ABSOLUTE
Indique comment les composants d'altitude des coordonnées sont interprétés.
Attribut 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
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
     :
  • <gmp-polyline-3d draws-occluded-segments></gmp-polyline-3d>
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
     :
  • <gmp-polyline-3d extruded></gmp-polyline-3d>
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
     :
  • <gmp-polyline-3d geodesic></gmp-polyline-3d>
outerColor
Type : string optional
Couleur extérieure. Toutes les couleurs CSS3 sont compatibles.
Attribut HTML:
  • <gmp-polyline-3d outer-color="string"></gmp-polyline-3d>
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
     :
  • <gmp-polyline-3d outer-width="number"></gmp-polyline-3d>
strokeColor
Type:string optional
Couleur du trait. Toutes les couleurs CSS3 sont compatibles.
Attribut HTML:
  • <gmp-polyline-3d stroke-color="string"></gmp-polyline-3d>
strokeWidth
Type : number optional
Épaisseur du trait, en pixels.
Attribut HTML
     :
  • <gmp-polyline-3d stroke-width="number"></gmp-polyline-3d>
zIndex
Type : number optional
L'indice z par rapport aux autres polys.
Attribut HTML
     :
  • <gmp-polyline-3d z-index="number"></gmp-polyline-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject Objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional Voir les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée : void
Configure une fonction qui est appelée chaque fois que l'événement spécifié est diffusé à la cible. Voir addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string Chaîne spécifiant le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject Écouteur d'événements du gestionnaire d'événements à supprimer de la cible d'événement.
  • options : boolean|EventListenerOptions optional Voir les options
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.
altitudeMode optional
Type : AltitudeMode optional
Consultez les Polyline3DElement.altitudeMode.
coordinates optional
Consultez les Polyline3DElement.coordinates.
drawsOccludedSegments optional
Type : boolean optional
Consultez les Polyline3DElement.drawsOccludedSegments.
extruded optional
Type : boolean optional
Consultez les Polyline3DElement.extruded.
geodesic optional
Type : boolean optional
Consultez les Polyline3DElement.geodesic.
outerColor optional
Type:string optional
Consultez les Polyline3DElement.outerColor.
outerWidth optional
Type : number optional
Consultez les Polyline3DElement.outerWidth.
strokeColor optional
Type : string optional
Consultez les Polyline3DElement.strokeColor.
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" geodesic stroke-color="string" 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 Bibliothèques dans l'API Maps JavaScript.
Polygon3DElement
Polygon3DElement([options])
Paramètres :
Crée un Polygon3DElement avec les options spécifiées.
altitudeMode
Type : AltitudeMode optional
Par défaut : AltitudeMode.ABSOLUTE
Indique comment les composants d'altitude des coordonnées sont interprétés.
Attribut 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
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 (des bâtiments, par exemple).
Attribut HTML:
  • <gmp-polygon-3d draws-occluded-segments></gmp-polygon-3d>
extruded
Type:boolean optional
Par défaut : false
Indique si le polygone doit être relié au sol. Pour extruder un polygone, altitudeMode doit être RELATIVE_TO_GROUND ou ABSOLUTE.
Attribut HTML
     :
  • <gmp-polygon-3d extruded></gmp-polygon-3d>
fillColor
Type : string optional
Couleur de remplissage. Toutes les couleurs CSS3 sont compatibles.
Attribut HTML
     :
  • <gmp-polygon-3d fill-color="string"></gmp-polygon-3d>
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 à l'écran.
Attribut HTML
     :
  • <gmp-polygon-3d geodesic></gmp-polygon-3d>
innerCoordinates
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
Séquence ordonnée de coordonnées qui désigne une boucle fermée. Dans certains modes, l'altitude est ignorée et facultative.
strokeColor
Type : string optional
Couleur du trait. Toutes les couleurs CSS3 sont compatibles.
Attribut HTML:
  • <gmp-polygon-3d stroke-color="string"></gmp-polygon-3d>
strokeWidth
Type : number optional
Épaisseur du trait, en pixels.
Attribut HTML
     :
  • <gmp-polygon-3d stroke-width="number"></gmp-polygon-3d>
zIndex
Type : number optional
L'indice z par rapport aux autres polys.
Attribut HTML
     :
  • <gmp-polygon-3d z-index="number"></gmp-polygon-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres :
  • type : string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener : EventListener|EventListenerObject Objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent.
  • options : boolean|AddEventListenerOptions optional Voir les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
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
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres :
  • type : string Chaîne spécifiant le type d'événement pour lequel supprimer un écouteur d'événement.
  • listener : EventListener|EventListenerObject Écouteur d'événements du gestionnaire d'événements à supprimer de la cible d'événement.
  • options : boolean|EventListenerOptions optional Voir les options
Valeur renvoyée:  void
Supprime de la cible un écouteur d'événements précédemment enregistré auprès de 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.
altitudeMode optional
Type : AltitudeMode optional
Consultez les Polygon3DElement.altitudeMode.
drawsOccludedSegments optional
Type:boolean optional
Consultez les Polygon3DElement.drawsOccludedSegments.
extruded optional
Type : boolean optional
Consultez les Polygon3DElement.extruded.
fillColor optional
Type:string optional
Consultez les Polygon3DElement.fillColor.
geodesic optional
Type : boolean optional
Consultez les Polygon3DElement.geodesic.
innerCoordinates optional
Consultez les Polygon3DElement.innerCoordinates.
outerCoordinates optional
Consultez les Polygon3DElement.outerCoordinates.
strokeColor optional
Type : string optional
Consultez les Polygon3DElement.strokeColor.
strokeWidth optional
Type : number optional
Consultez les Polygon3DElement.strokeWidth.
zIndex optional
Type : number optional
Consultez les Polygon3DElement.zIndex.

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.
ABSOLUTE Permet d'exprimer des 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 placé au-dessus d'une étendue d'eau, il sera 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. Sur 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).