DOM elements

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

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();. Il est garanti que le constructeur OverlayView soit 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.
Vous devez appeler 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, lorsque la superposition doit être affichée à nouveau après sa suppression. La méthode draw() 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).

Cette classe étend MVCObject.

OverlayView
OverlayView()
Paramètres:aucun
Crée un OverlayView.
preventMapHitsAndGesturesFrom
preventMapHitsAndGesturesFrom(element)
Paramètres :
Valeur renvoyée : aucune
Arrête les événements de clic, d'appui, de déplacement et de molette sur l'élément lorsqu'il est ajouté à la carte. Utilisez cette option pour empêcher le déplacement de la carte, les zooms et les événements de clic sur la carte.
preventMapHitsFrom
preventMapHitsFrom(element)
Paramètres:
Valeur renvoyée : aucune
Arrête de cliquer ou d'appuyer sur l'élément pour passer à la carte. Utilisez cette option pour éviter que la carte ne déclenche des événements de clic.
draw
draw()
Paramètres:aucun
Valeur renvoyée: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 est appelée en cas de changement de zoom ou de centre. Il n'est pas recommandé de réaliser 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 OverlayView peut être affichée. 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 OverlayView. La projection n'est pas initialisée tant que onAdd n'est pas appelé par l'API.
onAdd
onAdd()
Paramètres:aucun
Valeur renvoyée : 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 renvoyée: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 de la fonction setMap(null).
setMap
setMap(map)
Paramètres:
  • mapMap|StreetViewPanorama optional carte ou panorama. Si la valeur est null, le calque est supprimé.
Valeur renvoyée: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

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 d'événements DOM. (volet 0).
markerLayer
Type : Element
Ce volet contient des repères. Il ne reçoit pas d'é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 d'é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 n'est pas garantie jusqu'à l'appel de la méthode "Draw".

fromContainerPixelToLatLng
fromContainerPixelToLatLng(pixel[, noClampNoWrap])
Paramètres:
  • pixelPoint optional
  • noClampNoWrapboolean optional
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:
  • pixel : Point optional
  • noClampNoWrap : boolean optional
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 l'emplacement géographique spécifié 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 l'emplacement géographique donné dans l'élément DOM contenant 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 Street View.
getWorldWidth
getWorldWidth()
Paramètres:aucun
Valeur renvoyée : number
Largeur du monde en pixels avec le niveau de zoom actuel. Pour les projections dont l'angle de direction est de 90 ou 270 degrés, il correspond à l'intervalle de pixels sur l'axe Y.