OverlayView

Référence API Google Maps JavaScript version 3.24

API Google Maps JavaScript version 3

Partager ce tutoriel sur les réseaux sociaux
Signaler une erreur dans cet article

Classe OverlayView

classe google.maps.OverlayView

Vous pouvez implémenter cette classe si vous voulez afficher des objets personnalisés en superposition sur la carte.

Vous pouvez hériter de cette classe en définissant le prototype de la superposition :

MyOverlay.prototype = new google.maps.OverlayView();

Le constructeur OverlayView est garanti être 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 comme les enfants aux carreaux.
  • 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 à la méthode onAdd() et setMap(null) afin de déclencher la méthode onRemove().

La méthode setMap() peut être appelée au moment de la construction ou à tout moment après, lorsque la superposition doit être ré-affichée après suppression.

La méthode draw() sera ensuite appelée chaque fois qu'une propriété de la carte change et qui pourrait changer la position de l'élément, telles que le zoom, le centre ou le type de carte.

Cette classe hérite de la classe MVCObject.

Constructeur
Méthode
Constructeur OverlayView
ConstructeurDescription
OverlayView()

Crée un OverlayView.

Méthode OverlayView
MéthodeValeur RetournéeDescription
draw()Valeur retournée :  None 

Implémenter cette méthode pour dessiner ou mettre à jour l'overlay.

Cette méthode est appelée après onAdd() et lorsque la position de projection.fromLatLngToPixel(), retourne une nouvelle valeur pour un LatLng donné.

Cela peut se produire lors du changement de niveau de zoom, de centre ou de type de carte.

Il n'est pas nécessairement appelé lors d'un glisser (drag) ou d'un redimensionnement (resize).

getMap()Valeur retournée : Map|StreetViewPanorama

getPanes()Valeur retournée : MapPanes

Retourne les carreaux (panes) dans lesquels cet OverlayView peut être rendu.

Uniquement disponible après que draw() ait été appelé.

getProjection()Valeur retournée : MapCanvasProjection

Retourne l'objet MapCanvasProjection associé à cet OverlayView.

Uniquement disponible après que draw() ait été appelé.

onAdd()Valeur retournée :  None 

Implémenter cette méthode pour initialiser les éléments DOM overlay.

Cette méthode est appelée une fois après que setMap() ait été appelé avec une carte valide.

À ce stade, les carreaux (panes) et la projection auront été initialisés.

onRemove()Valeur retournée :  None 

Implémenter 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(
       map:Map|StreetViewPanorama
)
Valeur retournée :  None 

Ajoute une superposition (overlay) à la carte ou au panoramique.

Exemple OverlayView

function overlayPerso( .... ) { .... };

overlayPerso.prototype = new google.maps.OverlayView();

overlayPerso.prototype.onAdd = function() { .... };

overlayPerso.prototype.draw = function() { .... };

overlayPerso.prototype.onRemove = function() { .... };

var monOverlay = new overlayPerso( .... );