OverlayView
Classe google.maps.OverlayView
Vous pouvez implémenter cette classe si vous souhaitez afficher des types personnalisés d'objets de superposition sur la carte.
Héritez de cette classe en définissant le prototype de votre superposition : MyOverlay.prototype = new google.maps.OverlayView();
. Le constructeur OverlayView
est garanti comme une fonction vide.
Vous devez implémenter trois méthodes: onAdd()
, draw()
et onRemove()
.
- Dans la méthode
onAdd()
, vous devez créer des objets DOM et les ajouter en tant qu'enfants des volets. - Dans la méthode
draw()
, vous devez positionner ces éléments. - Dans la méthode
onRemove()
, vous devez supprimer les objets du DOM.
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 construction ou à tout moment par la suite où la superposition doit de nouveau s'afficher après la suppression. La méthode draw()
est ensuite appelée chaque fois qu'une propriété de carte est susceptible de modifier la position de l'élément (zoom, centre ou type de carte, par exemple).
Cette classe étend MVCObject
.
Lorsque vous utilisez v=beta
, vous pouvez y accéder en appelant const {OverlayView} = await google.map.importLibrary("maps")
ou const {OverlayView} = await google.map.importLibrary("streetView")
. Consultez Bibliothèques dans l'API Maps JavaScript.
Constructeur | |
---|---|
OverlayView |
OverlayView() Paramètres:aucun
Crée un OverlayView . |
Méthodes statiques | |
---|---|
preventMapHitsAndGesturesFrom |
preventMapHitsAndGesturesFrom(element) Paramètres :
Valeur de retour:aucune
Empêcher les événements liés aux clics, aux appuis, aux glissements et aux rouages sur l'élément d'apparaître sur la carte Utilisez-la pour empêcher le déplacement de la carte et le zoom, ainsi que les événements de clic. |
preventMapHitsFrom |
preventMapHitsFrom(element) Paramètres:
Valeur de retour : aucune
Arrête de cliquer ou d'appuyer sur l'élément pour faire remonter l'écran sur la carte. Utilisez cette option pour empêcher la carte de déclencher des événements de type "clic". |
Méthodes | |
---|---|
draw |
draw() Paramètres:aucun
Valeur de retour:aucune
Implémentez cette méthode pour dessiner ou mettre à jour la superposition. Utilisez la position de projection.fromLatLngToDivPixel() pour positionner correctement la superposition par rapport aux MapPanes. Cette méthode est appelée après onAdd() et en cas de changement de zoom ou de centre. Il est déconseillé d'effectuer des tâches de calcul coûteuses avec cette méthode. |
getMap |
getMap() Paramètres:aucun
Valeur renvoyée :
Map|StreetViewPanorama |
getPanes |
getPanes() Paramètres:aucun
Valeur renvoyée :
MapPanes|null Renvoie les volets dans lesquels la vue en superposition peut s'afficher. Les volets ne sont pas initialisés tant que onAdd n'a pas été appelé par l'API. |
getProjection |
getProjection() Paramètres : aucun
Valeur renvoyée :
MapCanvasProjection Renvoie l'objet MapCanvasProjection associé à cet objet OverlayView . La projection n'est pas initialisée tant que onAdd n'a pas été appelé par l'API. |
onAdd |
onAdd() Paramètres:aucun
Valeur de retour : aucune
Implémentez cette méthode pour initialiser les éléments DOM en superposition. Cette méthode est appelée une fois après que setMap() a été appelé avec une carte valide. À ce stade, les volets et la projection auront été initialisés. |
onRemove |
onRemove() Paramètres:aucun
Valeur de retour:aucune
Implémentez cette méthode pour supprimer vos éléments du DOM. Cette méthode est appelée une fois après un appel à setMap(null). |
setMap |
setMap(map) Paramètres:
Valeur de retour:aucune
Ajoute la superposition à la carte ou au panorama. |
Hérité :
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Interface MapPanes
google.maps.MapPanes
interface
Propriétés | |
---|---|
floatPane |
Type:
Element Ce volet contient la fenêtre d'informations. Il se trouve au-dessus de toutes les superpositions de la carte (volet 4). |
mapPane |
Type :
Element Ce volet est le plus bas et se trouve au-dessus des tuiles. Il ne reçoit pas les événements DOM. (volet 0). |
markerLayer |
Type:
Element Ce volet contient des repères. Il ne reçoit pas les événements DOM. (volet 2). |
overlayLayer |
Type:
Element Ce volet contient des polylignes, des polygones, des superpositions au sol et des superpositions de calques de tuiles. Il ne reçoit pas les événements DOM. (volet 1). |
overlayMouseTarget |
Type:
Element Ce volet contient des éléments qui reçoivent des événements DOM. (volet 3). |
Interface MapCanvasProjection
google.maps.MapCanvasProjection
interface
Cet objet est mis à la disposition de OverlayView
à partir de la méthode de dessin. L'initialisation de l'application n'est pas garantie jusqu'à l'appel de la fonction "draw".
Méthodes | |
---|---|
fromContainerPixelToLatLng |
fromContainerPixelToLatLng(pixel[, noClampNoWrap]) Paramètres :
Valeur renvoyée:
LatLng|null Calcule les coordonnées géographiques à partir des coordonnées en pixels du conteneur de la carte. |
fromDivPixelToLatLng |
fromDivPixelToLatLng(pixel[, noClampNoWrap]) Paramètres:
Valeur renvoyée :
LatLng|null Calcule les coordonnées géographiques à partir des coordonnées en pixels de l'élément div qui contient la carte déplaçable. |
fromLatLngToContainerPixel |
fromLatLngToContainerPixel(latLng) Paramètres :
Valeur renvoyée :
Point|null Calcule les coordonnées en pixels de la zone géographique donnée dans l'élément conteneur de la carte. |
fromLatLngToDivPixel |
fromLatLngToDivPixel(latLng) Paramètres :
Valeur renvoyée :
Point|null Calcule les coordonnées en pixels de la zone géographique donnée dans l'élément DOM qui contient la carte déplaçable. |
getVisibleRegion |
getVisibleRegion() Paramètres : aucun
Valeur renvoyée:
VisibleRegion|null Région visible de la carte. Renvoie null si la carte n'a pas de taille. Renvoie null si l'élément OverlayView se trouve sur un panorama StreetView. |
getWorldWidth |
getWorldWidth() Paramètres : aucun
Valeur renvoyée :
number Largeur du monde en pixels au niveau de zoom actuel. Pour les projections dont l'angle de cap est de 90 ou 270 degrés, cela correspond à l'intervalle de pixels sur l'axe Y. |