WebGL

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

WebGLOverlayView

google.maps.WebGLOverlayView Classe

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. L'utilisation d'un contexte de rendu partagé offre des 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.

La vue en superposition WebGL vous permet d'ajouter directement du contenu à vos cartes à l'aide de WebGL, ou 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 à 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 construction ou à tout moment par la suite, lorsque la superposition doit être affichée à nouveau après sa suppression. La méthode onDraw() est ensuite appelée lorsqu'une propriété de carte est susceptible de modifier la position de l'élément (par exemple, zoom, centre ou type de carte). WebGLOverlayView ne peut être ajouté qu'à une carte vectorielle ayant un MapOptions.mapId.

Cette classe étend MVCObject.

WebGLOverlayView
WebGLOverlayView()
Paramètres : aucun
Crée un 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 des structures de données intermédiaires avant de dessiner la superposition et qui ne nécessitent pas d'accès immédiat au contexte de rendu WebGL.
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. Elle vous permet de nettoyer tout état GL préexistant, car elle n'est plus nécessaire.
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 des nuanceurs ou des objets de tampon.
onDraw
onDraw(options)
Paramètres :
  • optionsWebGLDrawOptions 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 le contenu WebGL directement sur la carte. Notez que si la superposition doit être dessinée, 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). Elle vous permet de supprimer tous les objets intermédiaires.
onStateUpdate
onStateUpdate(options)
Paramètres :
  • optionsWebGLStateOptions 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 du global GL en dehors du cadre de l'animation de rendu.
requestRedraw
requestRedraw()
Paramètres : aucun
Valeur renvoyée : aucune
Déclenche la carte pour redessiner un cadre.
requestStateUpdate
requestStateUpdate()
Paramètres : aucun
Valeur renvoyée:aucune
Déclenche la mise à jour de l'état de la carte via la carte.
setMap
setMap([map])
Paramètres :
  • mapMap optional carte pour accéder à l'état div, au modèle et à la vue.
Valeur renvoyée:aucune
Ajoute la superposition à la carte.
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interface WebGLDrawOptions

google.maps.WebGLDrawOptions interface

Options de dessin

gl
WebGL DisplayContext sur lequel afficher cette vue en superposition WebGL.
transformer
Transformation de l'espace de prise de vue de la matrice aux coordonnées de latitude/longitude.

Interface WebGLStateOptions

google.maps.WebGLStateOptions interface

Options d'état GL.

gl
WebGL DisplayContext sur lequel afficher cette vue en superposition WebGL.

Interface CoordinateTransformer

google.maps.CoordinateTransformer interface

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

Remarque: Une référence à cet objet ne doit pas être stockée en dehors du champ d'application de l'appel WebGLOverlayView.onDraw d'encapsulation.

fromLatLngAltitude
fromLatLngAltitude(latLngAltitude[, rotations, scale])
Paramètres:
  • latLngAltitudeLatLngAltitude|LatLngAltitudeLiteral latitude, longitude et altitude.
  • rotationsFloat32Array optional tableau contenant un angle de rotation d'Euler en degrés, dans la convention XYZ.
  • scale : tableau Float32Array optional contenant un tableau scalaire XYZ à appliquer à l'axe cardinal.
Valeur renvoyée : matrice Float64Array à utiliser avec WebGL.
getCameraParams
getCameraParams()
Paramètres : aucun
Valeur renvoyée : CameraParams paramètres de la caméra

Interface CameraParams

google.maps.CameraParams interface

Permet de récupérer les paramètres de la caméra, tels que 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