Logo TouraineVerte

API Google Maps JavaScript version 3

OverlayView - API Googlemaps V3.9

Google Maps API & Google Web Services

Vous avez trouvé ce tutoriel intéressant ? Recommandez le en cliquant sur le bouton +1    

classe google.maps.OverlayView

Tutoriel publié le Mis à jour le
Tutoriel en Français

Vous pouvez implémenter cette classe si vous souhaitez afficher des objets personnalisés de type overlay sur la carte.

Cette classe étend MVCObject.

Accès Rapide

Constructeur OverlayView
Exemples OverlayView
Méthodes OverlayView
Exemples & Infos diverses

Constructeur OverlayView

  Constructeur    Description  
OverlayView()

Vous devez hériter de cette classe en programmant le prototype de votre overlay avec new OverlayView.prototype.

Vous devez implémenter trois méthodes :

  • onAdd(),
  • draw(),
  • onRemove.

Dans la méthode onAdd(), vous devez créer des objets DOM et les ajouter comme enfants aux carreaux (panes).

Dans la méthode draw(), vous devez positionner ces éléments.

Dans la méthode onRemove(), vous devez enlever ces objets du DOM.

Vous devez appeler 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 lors de la construction ou à n'importe quel instant lorsque l'overlay sera à nouveau affiché après avoir été effacé.

La méthode draw() sera alors appelée chaque fois qu'une propriété de la carte sera modifiée susceptible de changer la position de l'élément, tels que le zoom, le centre ou le type de carte.

Méthodes OverlayView

  Méthodes    Valeur Retournée    Description  
draw() 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 du type de carte.

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

getMap()Map

getPanes()MapPanes

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

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

getProjection()MapCanvasProjection

Retourne l'objet MapCanvasProjection associé à cet OverlayView.

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

onAdd() 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() 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
)		 none 

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

Exemples 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( .... );