Classe GMarker

Un objet de type GMarker définit un point géographique sur une carte, représenté par ses coordonnées en degrés.
Pour afficher ce point sur la map, nous avons recours à la méthode addOverlay() de l’interface GOverlay.

Si l’option icon (objet de type GIcon) n’est pas renseignée dans le constructeur, l’icône par défaut (G_DEFAULT_ICON) sera utilisé.

Une fois le marker ajouté sur la carte, la fenêtre d’information qui lui est associée (openInfoWindow()) s’ouvrira suite à un click sur celui-ci.

NB : Voir aussi la gestion des événements liés aux markers et les options applicables aux markers.

Le constructeur GMarker

Signature de la classe GMarker :
GMarker(latlng:GLatLng, opts?:GMarkerOptions) .

Créé un nouvel objet de type GMarker. Il s’agit d’un point géographique représenté sur la carte par ses coordonnées géographiques en degrés (latitude & longitude), donc un objet de type GLatLng.
Les paramètres optionnels sont représentés par des instanciations de la classe GMarkerOptions (type d’icône, attribut title, …).

<script type="text/javascript">

   var map = new GMap2(document.getElementById('map'), { size: new GSize(400,400)});
   /* Ici, nous déclarons l'élément html ayant pour id "map" comme conteneur de la map
   avec une taille de 400 * 400 pixel */

   var myPoints = [];
   /* Déclaration du tableau qui contiendra nos points, objets GLatLng. */

   var bounds = new GLatLngBounds();
   /* Instanciation de la classe GLatLngBounds */

   myPoints.push( new GLatLng(48.8566667, 2.3509871)); // Paris
   myPoints.push( new GLatLng(48.8123155, 2.2381535)); // Meudon
   myPoints.push( new GLatLng(48.3906042, -4.4869013)); // Brest
   myPoints.push( new GLatLng(50.6371834, 3.0630174)); // Lille 
   /* On remplit notre tableau  */

   for(var i = 0; i < myPoints.length; i++){
     bounds.extend(myPoints[i]);
     var thisMarker = addThisMarker(myPoints[i]);
     map.addOverlay(thisMarker);
   }
   /* Extension des limites de la carte afin d'y insérer tous les points
   On ajoute également un marker pour chacun
   de ces points sur la carte   */ 

   function addThisMarker(point){
     var marker = new GMarker(point);
     return marker;
}         

   On peut ensuite utiliser une méthode map State de la classe GMap2
   intitulée getBoundsZoomLevel qui récupère le zoom nécessaire pour afficher
   la carte en fonction de ses limites.

   var newZoom = map.getBoundsZoomLevel(bounds);

   De la même manière, on récupère le centre de la région (objet GLatLngBounds)
   à l'aide de la méthode getCenter().

   var newCentre = bounds.getCenter();

   Il suffit ensuite d'initialiser la carte avec ces éléments.

   map.setCenter(newCentre, newZoom);

</script>

openInfoWindow()

La signature de la méthode openInfoWindow :
openInfoWindow(content:Node, opts?:GInfoWindowOptions) .

La méthode openInfoWindow appliquée à l’objet GMarker de référence permet d’ouvrir une fenêtre d’information sur l’icône représentant ce point. Le contenu de cette fenêtre d’information doit être défini en utilisant le DOM (Document Object Model).
Seule l’option GInfoWindowOptions.maxWidth est applicable.

openInfoWindowHtml()

La signature de la méthode openInfoWindowHtml :
openInfoWindowHtml(content:String, opts?:GInfoWindowOptions) .

La méthode openInfoWindowHtml appliquée à l’objet GMarker de référence permet d’ouvrir une fenêtre d’information sur l’icône représentant ce point. Le contenu de cette fenêtre d’information doit être une chaîne de caractère en HTML.
Seule l’option GInfoWindowOptions.maxWidth est applicable.

openInfoWindowTabs()

La signature de la méthode openInfoWindowTabs :
openInfoWindowTabs(tabs: GInfoWindowTab[], opts?:GInfoWindowOptions) .

La méthode openInfoWindowTabs appliquée à l’objet GMarker de référence permet d’ouvrir une fenêtre d’information à onglets sur l’icône représentant ce point. Le contenu de cette fenêtre d’information doit être un tableau d’onglets définis en tant que DOM (Document Object Model).
Seules les options GInfoWindowOptions.maxWidth et InfoWindowOptions.selectedTab sont applicables.

openInfoWindowTabsHtml()

La signature de la méthode openInfoWindowTabsHtml :
openInfoWindowTabsHtml(tabs: GInfoWindowTab[], opts?:GInfoWindowOptions) .

La méthode openInfoWindowTabsHtml appliquée à l’objet GMarker de référence permet d’ouvrir une fenêtre d’information à onglets sur l’icône représentant ce point. Le contenu de cette fenêtre d’information doit être un tableau d’onglets définis en Langage HTML.
Seules les options GInfoWindowOptions.maxWidth et InfoWindowOptions.selectedTab sont applicables.