Map

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 Map

classe google.maps.Map

Cette classe hérite de la classe MVCObject.

Constructeur
Evénement
Méthode
Propriété
Constructeur Map
ConstructeurDescription
Map(
     mapDiv:Element,
     opts?:MapOptions
)

Créé une nouvelle carte à l'intérieur du conteneur HTML donné.

Il s'agit généralement d'une balise <div/>.

Evénement Map
EvénementArgumentsDescription
bounds_changedArguments :  None 

Cet événement est déclenché lorsque les limites de la zone d'affichage bounds de la carte ont changé.

center_changedArguments :  None 

Cet événement est déclenché lorsque la propriété center de la carte est modifiée.

clickArguments : MouseEvent

Cet événement est déclenché lorsque l'utilisateur clique sur la carte (mais pas lorsqu'il clique sur un marqueur ou sur une info-bulle).

dblclickArguments : MouseEvent

Cet événement est déclenché lorsque l'utilisateur double-clique sur la carte.

Notez que l'événement clic sera également déclenché, juste avant celui-ci.

dragArguments :  None 

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

dragendArguments :  None 

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

dragstartArguments :  None 

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

heading_changedArguments :  None 

Cet événement est déclenché lorsque la la propriété heading de la carte change.

idleArguments :  None 

Cet événement est déclenché lorsque la carte devient inactive après un déplacement ou un zoom.

maptypeid_changedArguments :  None 

Cet événement est déclenché lorsque la propriété mapTypeId change.

mousemoveArguments : MouseEvent

Cet événement est déclenché lorsque la souris de l'utilisateur se déplace sur le conteneur de la carte.

mouseoutArguments : MouseEvent

Cet événement est déclenché lorsque la souris de l'utilisateur sort du conteneur de la carte.

mouseoverArguments : MouseEvent

Cet événement est déclenché lorsque la souris de l'utilisateur entre dans le conteneur de la carte.

projection_changedArguments :  None 

Cet événement est déclenché lorsque la projection projection a été modifiée.

resizeArguments :  None 

Les développeurs doivent déclencher cet événement sur la carte lorsque la taille de la balise <div/> change : google.maps.event.trigger(map, 'resize').

rightclickArguments : MouseEvent

Cet événement est déclenché lorsque l'événement DOM contextmenu est déclenché sur le conteneur la carte.

tilesloadedArguments :  None 

Cet événement est déclenché lorsque toutes les tuiles constituant la carte ont fini d'être chargées.

tilt_changedArguments :  None 

Cet événement est déclenché lorsque la propriété d'inclinaison tilt de la carte change.

zoom_changedArguments :  None 

Cet événement est déclenché lorsque le niveau de zoom zoom de la carte à changé.

Méthode Map
MéthodeValeur RetournéeDescription
fitBounds(
       bounds:LatLngBounds|LatLngBoundsLiteral
)
Valeur retournée :  None 

Adapte la zone d'affichage de la carte pour qu'elle contienne les limites données.

getBounds()Valeur retournée : LatLngBounds

Retourne les limites de la zone d'affichage actuelle de la carte sous la forme latitude / longitude.

Si plusieurs vues du monde sont visibles, les limites vont de -180 à 180 degrés de longitude.

Si la carte n'est pas encore initialisée (à savoir, le mapType est toujours  null ), ou le centre et le niveau de zoom n'ont pas encore été fixés, alors le résultat est  null  ou  undefined .

getCenter()Valeur retournée : LatLng

Retourne la position affichée au centre de la carte. Notez que cet objet LatLng n'est pas encapsulé. Pour plus d'informations, consultez LatLng.

getClickableIcons()Valeur retournée :  boolean 

Retourne la cliquabilité des icônes de carte.

Une icône de carte représente un point d’intérêt, également connu sous le nom de POI.

Si la valeur retournée est  true , les icônes sont cliquables sur la carte.

getDiv()Valeur retournée : Element

Retourne l'élément contenant la carte.

getHeading()Valeur retournée :  number 

Retourne le cap de l'imagerie aérienne. La valeur la position est mesurée en degrés (sens horaire) depuis la direction cardinale du Nord.

getMapTypeId()Valeur retournée : MapTypeId |  string 

Retourne le type de carte.

getProjection()Valeur retournée : Projection

Retourne la Projection courante.

Si la carte n'est pas encore initialisée (à savoir, le maType est toujours  null ) alors le résultat est  null .

Écouter projection_changed et vérifier sa valeur pour s'asurer qu'elle n'est pas  null .

getStreetView()Valeur retournée : StreetViewPanorama

Retourne le StreetViewPanorama par défaut attaché à la carte, qui peut être un panoramique incorporé par défaut dans la carte, ou le panoramique définit à l'aide de setStreetView().

Les modifications au streetViewControl de la carte apparaîtront dans l'affichage d'un tel panoramique lié.

getTilt()Valeur retournée :  number 

Retourne l’angle d’incidence de la carte actuelle, en degrés, entre le plan de la fenêtre d’affichage et le plan de la carte.

Le résultat sera 0 pour les images prises directement à la verticale ou 45 pour l’imagerie de 45°.

Les images à 45° sont uniquement disponibles pour les types de carte SATELLITE et Hybrid, dans certains endroits et à certains niveaux de zoom.

Remarque : Cette méthode ne retourne pas la valeur définie par setTilt. Voir setTilt pour plus de détails.

getZoom()Valeur retournée :  number 

Retourne le niveau de zoom actuel de la carte.

panBy(
       x: number ,
       y: number 
)
Valeur retournée :  None 

Change le centre de la carte en utilisant la distance donnée en pixels.

Si la distance est inférieure à la largeur et à la hauteur de la carte, la carte atteindra le nouveau centre à l'aide d'un effet de glissement.

Notez que le système de coordonnées de la carte augmente d'Ouest en Est (pour les valeurs x) et du Nord au Sud (pour les valeurs y).

panTo(
       latLng:LatLng|LatLngLiteral
)
Valeur retournée :  None 

Change le centre de la carte pour la latitude/longitude LatLng ou LatLngLiteral donnée.

Si la distance nécessaire à ce changement est inférieure à la largeur et à la hauteur de la carte, la carte atteindra le nouveau centre à l'aide d'un effet de glissement.

panToBounds(
       latLngBounds:LatLngBounds|LatLngBoundsLiteral
)
Valeur retournée :  None 

Déplace la carte du minimal nécessaire pour qu'elle contienne le LatLngBounds donné.

Il ne garantit pas que les limites seront sur la carte, mais que le plus de limites possibles seront visibles.

Les limites seront placées à l'intérieur de la zone délimitée par le type de carte et les contrôles de navigation (pan, zoom, et Street View), s'ils sont présents sur la carte.

Si les limites sont supérieures à la carte, la carte sera déplacée afin d'inclure la partie Nord-Ouest des limites. Si la distance nécessaire à ce changement de position est inférieure à la largeur et à la hauteur de la carte, la carte atteindra le nouveau centre à l'aide d'un effet de glissement.

setCenter(
       latlng:LatLng|LatLngLiteral
)
Valeur retournée :  None 

Définit le centre de cette carte à l'aide de LatLng ou LatLngLiteral.

setClickableIcons(
       value: boolean 
)
Valeur retournée :  None 

Détermine si les icônes cartographiques sont cliquables ou non.

Une icône cartographique représente un point d'intérêt, aussi appelé POI.

Pour désactiver le cliquabilité des icônes cartographiques, passer la valeur  false  à cette méthode.

setHeading(
       heading: number 
)
Valeur retournée :  None 

Définit le cap pour l'imagerie aérienne mesurée en degrés à partir de la direction cardinale Nord.

setMapTypeId(
       mapTypeId:MapTypeId| string 
)
Valeur retournée :  None 

Définit le type de carte.

setOptions(
       options:MapOptions
)
Valeur retournée :  None 

Définit les options de la carte à l'aide d'un objet MapOptions.

setStreetView(
       panorama:StreetViewPanorama
)
Valeur retournée :  None 

Lie un StreetViewPanorama à la carte.

Ce panoramique ignore le StreetViewPanorama par défaut, permettant de lier à la carte un panoramique externe situé à l'extérieur de la carte.

Fixer le panoramique sur  null  lie le panoramique incorporé par défaut en arrière de la carte.

setTilt(
       tilt: number 
)
Valeur retournée :  None 

Contrôle le comportement de commutation automatique de l’angle d’incidence de la carte.

Les seules valeurs autorisées sont 0 et 45.

setTilt(0) pousse la carte à toujours utiliser une vue de dessus de 0° quel que soit le niveau de zoom et la fenêtre d’affichage.

setTilt(45) pousse l’angle d’inclinaison à passer automatiquement à 45° chaque fois que l’imagerie à 45° est disponible pour les niveau de zoom et la vue actuels, et à rebasculer vers 0 chaque fois que l’imagerie 45° n’est pas disponible (il s’agit du comportement par défaut).

L'imagerie à 45° est uniquement disponible pour les types de carte SATELLITE et HYBRID, dans certains endroits et à certains niveaux de zoom.

Remarque : getTilt renvoie l’angle d’inclinaison actuelle, pas la valeur définie par setTilt. Parce que les méthodes getTilt et setTilt font référence à des choses différentes, n'utilisez pas la méthode bind() sur la propriété d’inclinaison tilt; procéder ainsi peut mener à des effets imprévisibles.

setZoom(
       zoom: number 
)
Valeur retournée :  None 

Définit le niveau de zoom de la carte.

Propriété Map
PropriétéTypeDescription
controlsType :  Array <MVCArray< Node >>

Contrôles supplémentaires à joindre à la carte.

Pour ajouter un contrôle sur la carte, ajoutez la balise <div/> du contrôle au MVCArray correspondant, au ControlPosition où il doit être rendu.

dataType : Data

Une instance de Data, liée à la carte.

Ajouter des fonctionnalités à cet objet Data pour les afficher facilement sur cette carte.

mapTypesType : MapTypeRegistry

Registre des instances MapType par leur chaîne d'identification.

overlayMapTypesType : MVCArray<MapType>

Types de cartes supplémentaires à superposer.