GMap2(container:Node,opts?:GMapOptions)

Permet de créer une nouvelle carte à l'intérieur du container HTML donné, généralement est une balise <div>.

Si aucun ensemble de types de cartes n'est donné dans l'argument facultatif opts.mapTypes, l'ensemble G_DEFAULT_MAP_TYPES est utilisé par défaut.

Si la taille n'est pas précisée dans l'argument optionnel opts.size, alors la taille du container est utilisée.

Si opts.size est précisée, alors l'élément container de la carte est redimensionné en conséquence. Voir la classe GMapOptions.

Note :

Une carte doit être centrée avant de pouvoir être utilisée.

Vous devez immédiatement appeler GMap2.setCenter() pour initialiser une carte créée avec ce constructeur.

enableDragging()

Aucune

Active le déplacement de la carte par glissement.

Activé par défaut.

disableDragging()

Aucune

Désactive le déplacement de la carte par glissement.

draggingEnabled()

Booleénne

true ou false

Permet de tester si le déplacement de la carte par glissement est activé.

• Retourne true si le déplacement de la carte par glissement est activé,
• Retourne false si le déplacement de la carte par glissement est désactivé.

enableInfoWindow()

Aucune

Active les opérations sur les info-bulles sur la carte.

Activé par défaut.

disableInfoWindow()

Aucune

Ferme l'info-bulle, si elle est ouverte, et désactive l'ouverture de toute nouvelle info-bulle.

infoWindowEnabled()

Booleénne

true ou false

Permet de tester si l'ouverture de l'info-bulle liée au marqueur est autorisée.

• Retourne true si l'ouverture de l'info-bulle liée au marqueur est activée,
• Retourne false si l'ouverture de l'info-bulle liée au marqueur est désactivée.

enableDoubleClickZoom()

Aucune

Active le double-clic pour zoomer et dézoomer.

Activé par défaut.

Depuis la version 2.58

disableDoubleClickZoom()

Aucune

Désactive le double-clic pour zoomer et dézoomer.

Depuis la version 2.58

doubleClickZoomEnabled()

Booleénne

true ou false

Permet de tester si le zoom par double-clic est activé :

• Retourne true si le zoom par double-clic est activé,
• Retourne false si le zoom par double-clic pour est désactivé.

Depuis la version 2.58

enableContinuousZoom()

Aucune

Active le zoom progressif et continu pour les navigateurs sélectionnés.

Désactivé par défaut.

Depuis la version 2.58

disableContinuousZoom()

Aucune

Désactive le zoom progressif et continu.

Depuis la version 2.58

continuousZoomEnabled()

Booleénne

true ou false

Permet de tester si le zoom progressif et continu est activé :

• Retourne true si le zoom progressif et continu est activé,
• Retourne false si le zoom progressif et continu est désactivé.

Depuis la version 2.58

enableGoogleBar()

Aucune

Active le contrôle de recherche intégré, nommé GoogleBar, à la carte.

Lorsqu'il est activé, ce contrôle prend, par défaut, la place du logo Powered by Google..

Note :

Ce contrôle est désactivé par défaut.

La GoogleBar n'est pas, pour l'instant, compatible avec le plugin Google Earth, utilisé par le type de carte GMapType. G_SATELLITE_3D_MAP et sera désactivé tant que le plugin Google Earth est affiché.

Depuis la version 2.92

disableGoogleBar()

Aucune

Désactive le contrôle de recherche intégré à la carte nommé GoogleBar..

Lorsqu'il est désactivé, le logo par défaut Powered by Google occupe la position contenant autrefois ce contrôle.

Note :

Ce contrôle est désactivé par défaut.

Depuis la version 2.92

enableScrollWheelZoom()

Aucune

Active le zoom à l'aide de la molette d'une souris.

Note :

Le zoom, à l'aide de la molette d'une souris, est désactivé par défaut.

Depuis la version 2.78

disableScrollWheelZoom()

Aucune

Désactive le zoom à l'aide de la molette d'une souris.

Note :

le zoom, à l'aide de la molette d'une souris, est désactivé par défaut.

Depuis la version 2.78

scrollWheelZoomEnabled()

Booleénne

true ou false

Permet de tester si le zoom à l'aide de la molette d'une souris est activé :

• Retourne true si le zoom à l'aide de la molette d'une souris est activé,
• Retourne false si le zoom à l'aide de la molette d'une souris est désactivé.

Depuis la version 2.78

enablePinchToZoom()

Aucune

Active le zoom par pincement ou écartement des doigts sur l'écran de l'iPhone ou de l'iPod touch.

Note :

le zoom par pincement ou écartement est activé par défaut.

Depuis la version 2.143

disablePinchToZoom()

Aucune

Désactive le zoom par pincement ou écartement des doigts sur l'écran de l'iPhone ou de l'iPod touch.

Note :

le zoom par pincement ou écartement est activé par défaut.

Depuis la version 2.143

pinchToZoomEnabled()

Booleénne

true ou false

Permet de tester si le zoom par pincement ou écartement des doigts sur l'écran de l'iPhone ou de l'iPod touch est activé :

• Retourne true si le zoom par pincement ou écartement des doigts sur l'écran de l'iPhone ou de l'iPod touch est activé,
• Retourne false si le zoom par pincement ou écartement des doigts sur l'écran de l'iPhone ou de l'iPod touch est désactivé.

Depuis la version 2.143

getDefaultUI()

Objet

Retourne un objet GMapUIOptions spécifiant le comportement par défaut et les éléments d'interface utilisateur pour la carte, basé sur l'interface utilisateur de maps.google.com

Depuis la version 2.147

setUIToDefault()

Aucune

Ajoute à la carte les éléments de l'interface utilisateur ainsi que le comportement par défaut spécifiés dans getDefaultUI().

Depuis la version 2.147

setUI(ui:GMapUIOptions)

Aucune

Ajoute le comportement et les éléments de l'interface utilisateur spécifiés dans le paramètre ui qui peut être une version modifiée de l'objet retourné par getDefaultUI().

Depuis la version 2.147

addControl(control:GControl, position?:GControlPosition)

Aucune

Ajoute un contrôle à la carte.

L'emplacement sur la carte est déterminé grâce à l'argument optionnel position.

Si cet argument est absent, la position par défaut du contrôle est utilisée, telle que déterminée par la méthode GControl.getDefaultPosition().

L'instance d'un contrôle ne doit pas être ajoutée plus d'une fois à la carte.

removeControl(control:GControl)

Aucune

Supprime un contrôle de la carte.

Rien ne se produit si le contrôle n'a jamais été ajouté à la carte.

getContainer()

Noeud

Retourne l'objet DOM qui contient la carte.

Utilisé par GControl.initialize()

getMapTypes()

GMapType[]

Retourne le tableau contenant les types de cartes associés à la carte.

getCurrentMapType()

GMapType

Retourne le type de carte actuellement sélectionné pour afficher la carte.

setMapType(type:GMapType)

Aucune

Sélectionne le type de carte indiqué entre parenthèses.

Le type doit être connu de la carte.

Consultez le constructeur, et la méthode addMapType()

addMapType(type:GMapType)

Aucune

Ajoute le nouveau type de carte indiqué entre parenthèses à la carte.

Voir GMapType pour savoir comment définir des types de carte personnalisés.

removeMapType(type:GMapType)

Aucune

Supprime le type de carte indiqué entre parenthèses de la carte.

Mets à jour l'ensemble des boutons affichés par le GMapTypeControl ou GHierarchicalMapTypeControl et renvoie l'événement removemaptype.

isLoaded()

Booleénne

true ou false

Retourne true si la carte a été initialisée par setCenter() depuis sa création.

getCenter()

GLatLng

Retourne les coordonnées géographiques du point central de la carte actuelle.

getBounds()

GLatLngBounds

Retourne les coordonnées géographiques de la zone visible de la carte actuelle.

getBoundsZoomLevel(bounds:GLatLngBounds)

Nombre

Retourne le niveau de zoom optimum à appliquer à la carte pour que la zone rectangulaire donnée puisse s'afficher entièrement dans la carte.

Le niveau de zoom est calculé pour le type de carte actuellement sélectionné.

Si aucun type de carte n'est actuellement sélectionné, alors le premier type figurant dans la liste des types de cartes sera utilisé.

getSize()

GSize

Retourne la taille actuelle de la carte en pixels.

getZoom()

Nombre

Retourne le niveau de zoom actuel de la carte.

getDragObject()

GDraggableObject

Retourne l'objet déplaçable utilisé par cette carte.

Depuis la version 2.93

getEarthInstance(callback:Function(instance: GEPlugin))

Aucune

Récupère l'instance du plugin Google Earth Browser attachée à cette carte, et appelle la fonction de rappel passée en paramètre, une fois que l'instance est prête à recevoir des commandes, en passant l'instance de Earth ( objet GEPlugin ) comme paramètre.

Cette fonction de rappel peut-être immédiatement déclenchée si l'instance de Earth avait déjà été instanciée en définissant le type de carte Google Earth via GMap2.setMapType(G_SATELLITE_3D_MAP).

Si l'instance n'est pas encore créée, l'initialisation du Plug-in Google Earth se fera en en appelant getEarthInstance.

Ce comportement étant asynchrone, cela explique pourquoi cette méthode nécessite un rappel.

Remarque : si l'initialisation rencontre une erreur, la fonction de rappel passera le paramètre null.

Notez que même si cette méthode permet de crééer une instance de Earth, elle ne permet pas de définir le type Earth comme étant le type de carte de la vue actuelle.

Pour cela, vous devez appeler explicitement GMap2.setMapType(G_SATELLITE_3D_MAP) ou autoriser l'utilisateur à sélectionner ce type de carte via MapTypeControl.

Consultez le Guide de l'API Google Earth pour les Développeurs pour obtenir plus de détails sur la façon d'utiliser l'objet GEPlugin.

Depuis la version 2.113

setCenter(center:GLatLng, zoom?:Number, type?:GMapType)

Aucune

Centre la carte actuelle sur le point indiqué.

En option, définit également le niveau de zoom et le type de carte.

Le type de carte doit être connu de la carte. Consultez le constructeur et la méthode addMapType().

Cette méthode doit être appelée en premier après la construction pour définir l'état initial de la carte.

Appeler des opérations sur un objet GMap2 nouvellement construits est une erreur, tant que cette fonction n'a pas été invoquée.

panTo(center:GLatLng)

Aucune

Transfère le centre de la carte vers le point donné.

Si le point donné est visible depuis la vue actuelle de la carte, une animation panoramique va faire coïncider le centre de la carte avec le point donné.

panBy(distance:GSize)

Aucune

Démarre une animation panoramique en fonction d'une distance donnée en pixels.

panDirection(dx:-1 ou 0 ou +1, dy:-1 ou 0 ou +1)

Aucune

Démarre une animation panoramique d'une amplitude équivalente à la moitié de la largeur de la carte et dans les directions indiquées respectivement ci-dessous :

• +1 : droite - bas,
• -1 : gauche - haut.

setZoom(level:Number)

Aucune

Définit le niveau de zoom de la carte sur la nouvelle valeur donnée.

zoomIn(latlng?:GLatLng, doCenter?:Boolean, doContinuousZoom?:Boolean)

Aucune

Augmente le niveau de zoom d'une unité.

Si l'argument optionnel latlng est fourni, la carte va tenter de conserver cette position une fois la carte zoomée.

Note :

Le latlng doit être actuellement présents sur la carte en zoom arrière.

Si l'argument optionnel doCenter est fourni, la carte sera centrée sur la latlng fourni.

zoomOut(latlng?:GLatLng, doContinuousZoom?:Boolean)

Aucune

Diminue le niveau de zoom d'une unité.

Si l'argument optionnel latlng est fourni, la carte zoom autour de ce point.

Si l'argument optionnel doContinuousZoom est à true, la carte utilisera le zoom progressif et continu lors d'un zoom arrière.

savePosition()

Aucune

Mémorise la position et le niveau de zoom de la carte actuelle afin de pouvoir les rappeler plus tard à l'aide de returnToSavedPosition()

returnToSavedPosition()

Aucune

Restaure la vue sur la carte telle qu'elle avait été enregistrée à l'aide de savePosition()

checkResize()

Aucune

Indique à la carte que la taille de son container a été modifiée.

Appelez cette méthode après modification de la taille de l'objet DOM contenant la carte, afin que la carte puisse s'adapter à la nouvelle taille de son container.

addOverlay(overlay:GOverlay)

Aucune

Ajoute à la carte la couche indiquée et génère l'événement addoverlay.

removeOverlay(overlay:GOverlay)

Aucune

Supprime de la carte la couche indiquée.

Essayer d'enlever une couche qui n'est pas présente sur la carte constitue une erreur.

Si l'appel est un succès, l'événement removeoverlay est généré.

clearOverlays()

Aucune

Supprime toutes les couches présentent sur la carte, et génére l'événement clearoverlays.

getPane(pane:GMapPane)

Noeud

Retourne une balise <div> qui contient l'objet dans la couche identifiés par pane.

Utilisé par les instances GOverlay dans la méthode GOverlay.initialize() afin de les insérer sur la carte.

openInfoWindow(latlng:GLatLng, node:Node, opts?:GInfoWindowOptions)

Aucune

Ouvre une info-bulle simple ancréée au point donné.

Déplace la carte de telle sorte que l'info-bulle ouverte soit entièrement visible.

Le contenu de l'info-bulle est donné sous la forme d'un noeud DOM.

openInfoWindowHtml(latlng:GLatLng, html:String, opts?:GInfoWindowOptions)

Aucune

Ouvre une info-bulle simple ancréée au point donné.

Déplace la carte de telle sorte que l'info-bulle ouverte soit entièrement visible.

Le contenu de l'info-bulle est donné sous forme de code HTML.

openInfoWindowTabs(latlng:GLatLng, tabs:GInfoWindowTab[], opts?:GinfoWindowOptions)

Aucune

Ouvre une info-bulle à onglets ancréée au point donné.

Déplace la carte de telle sorte que l'info-bulle ouverte soit entièrement visible.

Le contenu de l'info-bulle est donné sous la forme de noeuds DOM.

openInfoWindowTabsHtml(latlng:GLatLng, tabs:GInfoWindowTab[], opts?:GInfoWindowOptions)

Aucune

Ouvre une info-bulle à onglets ancréée au point donné.

Déplace la carte de telle sorte que l'info-bulle ouverte soit entièrement visible.

Le contenu de l'info-bulle est donné sous forme de code HTML.

showMapBlowup(latlng:GLatLng, opts?:GInfoWindowOptions)

Aucune

Ouvre une info-bulle ancréée au point donné contenant, sous forme de carte, un gros plan des alentours de ce point.

updateInfoWindow(tabs:GInfoWindowTab[], onupdate?:Function)

Aucune

Mise à jour du contenu de l'objet GInfoWindow actuellement ouvert, sans repositionnement.

L'info-bulle est redimensionnée pour s'adapter au nouveau contenu.

La fonction de rappel optionnelle onupdate est appelée une fois que le contenu de l'info-bulle est effectivement modifié.

Depuis la version 2.85

updateCurrentTab(modifier:Function, onupdate?:Function)

Aucune

Mise à jour de l'onglet actuellement sélectionné, provoquant un redimensionnement de l'objet GInfoWindow sans repositionnement.

La fonction de modifier est utilisée pour modifier l'onglet actuellement sélectionné et passe GInfoWindowTab comme argument.

La fonction de rappel optionnelle onupdate est appelée une fois que l'info-bulle affiche le nouveau contenu.

Depuis la version 2.85

closeInfoWindow()

Aucune

Ferme l'info-bulle actuellement ouverte.

getInfoWindow()

GInfoWindow

Retourne l'objet info-bulle de cette carte.

Si aucune info-bulle n'existe, elle en créée une, mais ne l'affiche pas.

Cette opération n'est pas influencée par enableInfoWindow().

fromContainerPixelToLatLng(pixel:GPoint)

GLatLng

Calcule les coordonnées géographiques du point correspondant aux coordonnées du pixel donné dans l'élément DOM contenant la carte sur la page.

Cette fonction est très utile lorsque vous mettez en oeuvre l'interaction des commandes personnalisées avec la carte.

fromLatLngToContainerPixel(latlng:GLatLng)

GPoint

Calcule les coordonnées du pixel correspondant aux coordonnées géographique du point donné dans l'élément DOM contenant la carte sur la page.

Depuis la version 2.100

fromLatLngToDivPixel(latlng:GLatLng)

GPoint

Calcule les coordonnées du pixel, correspondant aux coordonnées géographiques du point donné dans l'élément DOM contenant la carte déplaçable.

Vous avez besoin de cette méthode pour positionner une couche personnalisée lorsque vous implémentez la méthode GOverlay.redraw() pour une couche personnalisée.

fromDivPixelToLatLng(pixel:GPoint)

GLatLng

Calcule les coordonnées géographiques à partir des coordonnées du pixel contenu dans la balise <div> contenant la carte déplaçable.

Ceci peut-être utile lorsque vous mettez en place une interaction entre des couches personnalisées qui ne prolonge pas l' interface GOverlay.

Si cela ne vous donne pas les résultats escomptés, essayez à la place la méthode fromContainerPixelToLatLng.

enableRotation(level?:Number)

Aucune

Active l'imagerie aérienne pivotante pour tous les GMapType la supportant.

Si le type de carte actuel GMapType supporte l'imagerie aérienne pivotante, les images aériennes pivotantes seront automatiquement affichées sur la carte lorsque :

• celles-ci sont disponibles,
• le niveau de zoom franchit le seuil fixé par défaut.

Depuis la version 2.194, vous pouvez spécifier de façon explicite le niveau de zoom à l'aide du paramètre optionnel level.

L'imagerie aérienne pivotante est disponible uniquement pour les types de carte suivants :

• G_SATELLITE_MAP,
• G_HYBRID_MAP.

Depuis la version 2.193

disableRotation()

Aucune

Désactive l'imagerie aérienne pivotante.

Si l'imagerie aérienne pivotante est actuellement diffusée sur la carte, de haut en bas des images seront automatiquement affichées à la place de la carte.

Depuis la version 2.193

rotationEnabled()

Booleénne

true ou false

Permet de tester si l'imagerie aérienne pivotante est activée.

Retourne true si l'imagerie aérienne pivotante est activée.

Retourne false si l'imagerie aérienne pivotante est desactivée.

Depuis la version 2.193

isRotatable()

Booleénne

true ou false

Permet de tester si la carte actuellement affichée est pivotante.

Retourne true si c'est la cas. Sinon, retourne false.

La carte est considérée comme pivotante :

• si le type de carte est G_SATELLITE_MAP ou G_HYBRID_MAP,
• et si l'imagerie aérienne pivotante est actuellement visible dans la carte affichée.

Depuis la version 2.193

changeHeading(heading:Number)

Aucune

Permet de modifier l'angle de vue de la carte actuelle à l'aide du paramètre heading.

Pour que le changement soit réussi, GMap2.isRotatable() doit renvoyer true.

Depuis la version 2.193

addmaptype(type:GMapType)

Cet événement est renvoyé lorsqu'un nouveau type de carte est ajouté à la carte.

removemaptype(type:GMapType)

Cet événement est renvoyé lorsqu'un type de carte est supprimé de la carte.

click(overlay:GOverlay, latlng:GLatLng, overlaylatlng:GLatLng)

Cet événement est renvoyé lorsque l'utilisateur clique sur la carte avec le curseur de sa souris.

Un événement click transmet des arguments différents en fonction du contexte du clic, et si le clic s'est oui ou non produit sur une couche cliquable.

Si le clic ne se produit pas sur une couche cliquable, l'argument overlay est null et l'argument latlng contient les coordonnées géographiques du point qui a été cliqué.

Si l'utilisateur clique sur une couche qui est cliquable (comme par exemple GMarker GPolygon GPolyline ou GInfoWindow l'argument overlay contient l'objet de recouvrement, tandis que l'argument overlaylatlng contient les coordonnées de la couche cliquée.

En outre, un événement click est alors également renvoyé sur la couche elle-même.

dblclick(overlay:GOverlay, latlng:GLatLng)

Cet événement est renvoyé quand un double-clic est effectué sur la carte.

Notez que cet événement ne sera pas renvoyé si le double-clic a été effectué sur un marqueur ou une autre couche cliquable.

Les coordonnées géographiques du point qui a été double-cliqué sont passées dans l'argument latlng.

L'argument overlay est toujours défini comme étant null.

Depuis la version 2.83

singlerightclick(point:GPoint, src:Element, overlay?:GOverlay)

Cet événement est renvoyé lorsque l'événement DOM contextmenu est renvoyé sur le container de la carte.

Si le clic droit est sur un marqueur ou une couche cliquable, alors la couche est passée au gestionnaire d'événements dans l'argument overlay.

Les coordonnées du pixel (dans l'élément DOM qui détient la carte) du point qui a été cliqué droit et l'élément source de l'événement DOM sont passés respectivement dans les arguments point et src.

Notez que si c'est un double-clic droit et que le double-clic pour zoomer est activé, alors la carte fait un zoom arrière et aucun événement singlerightclick n'est renvoyé.

Toutefois, si le double-clic pour zoomer est désactivé, deux événements singlerightclick seront renvoyés.

Depuis la version 2.84

movestart()

Cet événement est renvoyé lorsque la vue sur la carte commence à changer.

Cela peut être causé :

• soit par un glissement de la carte, dans quel cas un événement dragstart est également renvoyé,
• soit par l'invocation d'une méthode qui change l'apparence de la carte.

move()

Cet événement est renvoyé, éventuellement de façon répétitive, tant que l'apparence de la carte est modifiée.

moveend()

Cet événement est renvoyé lorsque les modifications sur l'apparence de la carte se terminent.

zoomend(oldLevel:Number, newLevel:Number)

Cet événement est renvoyé quand la carte atteint un nouveau niveau de zoom.

Le gestionnaire d'événement reçoit l'ancien et le nouveau niveau de zoom comme arguments.

maptypechanged() .

Cet événement est renvoyé quand un autre type de carte est sélectionné.

infowindowopen() .

Cet événement est renvoyé quand l'info-bulle s'ouvre.

infowindowbeforeclose() .

Cet événement est renvoyé avant la fermeture de l'info-bulle.

Depuis la version 2.83

infowindowclose() .

Cet événement est renvoyé quand l'info-bulle se ferme.

L'événement infowindowbeforeclose est renvoyé juste avant l'événement infowindowclose.

Si une info-bulle actuellement ouverte est ré-ouverte en un point différent en utilisant un autre appel à openInfoWindow*() les événements infowindowbeforeclose infowindowclose et infowindowopen sont renvoyés dans cet ordre.

addoverlay(overlay:GOverlay)

Cet événement est renvoyé quand un seul recouvrement est ajouté à la carte par la méthode addOverlay().

La nouvelle couche est passée comme un argument overlay au gestionnaire d'événement.

removeoverlay(overlay:GOverlay)

Cet événement est renvoyé quand un seul recouvrement est supprimé par la méthode removeOverlay().

La couche qui a été enlevée est passée comme un argument overlay au gestionnaire d'événement.

clearoverlays()

Cet événement est renvoyé lorsque toutes les couches à la fois sont supprimées par la méthode clearOverlays().

mouseover(latlng:GLatLng)

Cet événement est renvoyé lorsque l'utilisateur déplace la souris sur la carte depuis l'extérieur de la carte.

mouseout(latlng:GLatLng)

Cet événement est renvoyé lorsque l'utilisateur déplace la souris sur la carte.

mousemove(latlng:GLatLng)

Cet événement est renvoyé lorsque l'utilisateur déplace la souris sur la carte.

dragstart()

Cet événement est renvoyé lorsque l'utilisateur commence à faire glisser la carte.

drag()

Cet événement est renvoyé à plusieurs reprises tant que l'utilisateur fait glisser la carte.

dragend()

Cet événement est renvoyé lorsque l'utilisateur cesse de faire glisser la carte.

load()

Cet événement est renvoyé lorsque la présentation de la carte est complète, et isLoaded() retournera true.

Cette position implique, que le zoom, et le type de carte sont tous initialisés, mais les tuiles constituant la carte peuvent encore être en cours de chargement.

Depuis la version 2.52

tilesloaded()

Cet événement est renvoyé lorsque toutes les tuiles constituant la carte ont été chargées.

Depuis la version 2.140

headingchanged()

Cet événement est renvoyé lorsque le type de carte actuel GMapType a été changé pour un nouveau avec une position différente.

Depuis la version 2.193

rotatabilitychanged()

Cet événement est renvoyé lorsque l'angle de rotation de la carte a été modifié.

Depuis la version 2.193