WebGL

Classe WebGLOverlayView

Classe google.maps.WebGLOverlayView

La vue en superposition WebGL offre un accès direct au même contexte de rendu WebGL que celui utilisé par Google Maps Platform pour afficher la carte de base vectorielle. Utiliser un contexte de rendu partagé offre plusieurs avantages tels que l'occlusion de la profondeur avec la géométrie de bâtiments 3D et la possibilité de synchroniser le contenu 2D/3D avec le rendu de carte de base.

Avec la vue en superposition WebGL, vous pouvez ajouter du contenu à vos cartes en utilisant WebGL directement, ou à l'aide de bibliothèques graphiques populaires comme Three.js ou deck.gl. Pour utiliser la superposition, vous pouvez étendre google.maps.WebGLOverlayView et fournir une implémentation pour chacun des hooks de cycle de vie suivants: WebGLOverlayView.onAdd, WebGLOverlayView.onContextRestored, WebGLOverlayView.onDraw, WebGLOverlayView.onContextLost et WebGLOverlayView.onRemove.

Vous devez appeler WebGLOverlayView.setMap avec un objet Map valide pour déclencher l'appel de la méthode onAdd() et setMap(null) pour déclencher la méthode onRemove(). La méthode setMap() peut être appelée au moment de la création ou à tout moment par la suite lorsque la superposition doit être réaffichée après avoir été supprimée. La méthode onDraw() est ensuite appelée chaque fois qu'une propriété de carte est modifiée, ce qui peut modifier la position de l'élément (par exemple, le zoom, le centre ou le type de carte). WebGLOverlayView ne peut être ajouté qu'à une carte vectorielle ayant un MapOptions.mapId (y compris les cartes définies sur le MapOptions.renderingType RenderingType.VECTOR et utilisant Map.DEMO_MAP_ID comme MapOptions.mapId).

Cette classe étend MVCObject.

Accédez-y en appelant const {WebGLOverlayView} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.
WebGLOverlayView
WebGLOverlayView()
Paramètres:aucun
Crée un objet WebGLOverlayView.
getMap
getMap()
Paramètres:aucun
Valeur renvoyée:Map|null|undefined
onAdd
onAdd()
Paramètres:aucun
Valeur renvoyée:aucune
Implémentez cette méthode pour extraire ou créer, avant que la superposition ne soit dessinée, des structures de données intermédiaires qui ne nécessitent pas d'accès immédiat au contexte de rendu WebGL. Cette méthode doit être implémentée pour l'affichage.
onContextLost
onContextLost()
Paramètres:aucun
Valeur renvoyée:aucune
Cette méthode est appelée lorsque le contexte de rendu est perdu pour une raison quelconque. C'est là que vous devez nettoyer tout état GL préexistant, car vous n'en avez plus besoin.
onContextRestored
onContextRestored(options)
Paramètres:
  • options:  WebGLStateOptions qui permet aux développeurs de restaurer le contexte GL.
Valeur renvoyée:aucune
Cette méthode est appelée une fois que le contexte de rendu est disponible. Utilisez-le pour initialiser ou lier n'importe quel état WebGL, tel que les nuanceurs ou les objets de tampon.
onDraw
onDraw(options)
Paramètres:
  • options:  WebGLDrawOptions qui permet aux développeurs d'afficher du contenu sur une carte de base Google associée.
Valeur renvoyée:aucune
Implémentez cette méthode pour dessiner du contenu WebGL directement sur la carte. Notez que si la superposition nécessite un nouveau frame, appelez WebGLOverlayView.requestRedraw.
onRemove
onRemove()
Paramètres:aucun
Valeur renvoyée:aucune
Cette méthode est appelée lorsque la superposition est supprimée de la carte avec WebGLOverlayView.setMap(null). C'est là que vous devez supprimer tous les objets intermédiaires. Cette méthode doit être implémentée pour l'affichage.
onStateUpdate
onStateUpdate(options)
Paramètres:
  • options:  WebGLStateOptions qui permet aux développeurs de restaurer le contexte GL.
Valeur renvoyée:aucune
Implémentez cette méthode pour gérer les mises à jour de l'état GL en dehors du frame d'animation de rendu.
requestRedraw
requestRedraw()
Paramètres:aucun
Valeur renvoyée:aucune
Déclenche la recomposition d'un cadre sur la carte.
requestStateUpdate
requestStateUpdate()
Paramètres:aucun
Valeur renvoyée:aucune
Déclenche la mise à jour de l'état GL.
setMap
setMap([map])
Paramètres:
  • map:  Map optional Carte permettant d'accéder à l'état de la div, du modèle et de la vue.
Valeur renvoyée:aucune
Ajoute la superposition à la carte.
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interface WebGLDrawOptions

Interface google.maps.WebGLDrawOptions

Options de dessin.
gl
WebGLRenderingContext sur lequel afficher cette WebGLOverlayView.
transformer
Transformation matricielle de l'espace de la caméra en coordonnées de latitude/longitude.

Interface WebGLStateOptions

Interface google.maps.WebGLStateOptions

Options d'état GL.
gl
WebGLRenderingContext sur lequel afficher cette WebGLOverlayView.

Interface CoordinateTransformer

Interface google.maps.CoordinateTransformer

Cette interface fournit des méthodes pratiques pour générer des matrices à utiliser pour le rendu de scènes WebGL sur la carte de base Google.

Remarque: Une référence à cet objet ne doit pas être conservée en dehors du champ d'application de l'appel WebGLOverlayView.onDraw encapsulant.
fromLatLngAltitude
fromLatLngAltitude(latLngAltitude[, rotations, scale])
Paramètres:
  • latLngAltitude:  LatLngAltitude|LatLngAltitudeLiteral Latitude, longitude et altitude.
  • rotations:  Float32Array optional Tableau contenant un angle de rotation Euler en degrés, selon la convention XYZ.
  • scale:  tableau Float32Array optional contenant un tableau scalaire XYZ à appliquer à l'axe cardinal.
Valeur renvoyée:matrice MVP Float64Array à utiliser avec WebGL.
getCameraParams
getCameraParams()
Paramètres:aucun
Valeur renvoyée:paramètres de la caméra CameraParams

Interface CameraParams

Interface google.maps.CameraParams

Permet de récupérer les paramètres de l'appareil photo, comme celui de la caméra GL utilisée pour WebGLOverlayView.

Cette interface étend CameraOptions.

center
Type:LatLng
heading
Type:number
tilt
Type:number
zoom
Type:number