Maps

Classe Map

Classe google.maps.Map

Cette classe étend MVCObject.

Accédez au compte en appelant const {Map} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans l'API Maps JavaScript.
Map
Map(mapDiv[, opts])
Paramètres:
  • mapDiv:  HTMLElement la carte s'affiche pour remplir cet élément.
  • opts:  MapOptions optional options
Crée une nouvelle carte à l'intérieur du conteneur HTML, qui est généralement un élément DIV.
controls
Commandes supplémentaires à associer à la carte. Pour ajouter une commande à la carte, ajoutez l'élément <div> de la commande à l'élément MVCArray correspondant au ControlPosition dans lequel elle doit être affichée.
data
Type:Data
Instance de Data associée à la carte. Ajoutez des éléments géographiques à cet objet Data pour les afficher facilement sur cette carte.
mapTypes
Registre d'instances MapType par ID de chaîne.
overlayMapTypes
Type:MVCArray<MapType optional>
Types de carte supplémentaires à superposer. Les types de carte de superposition s'affichent par-dessus la carte de base à laquelle ils sont associés, dans l'ordre dans lequel ils apparaissent dans le tableau overlayMapTypes (les superpositions avec des valeurs d'index plus élevées sont affichées devant celles avec des valeurs d'index plus faibles).
fitBounds
fitBounds(bounds[, padding])
Paramètres:
  • bounds:  LatLngBounds|LatLngBoundsLiteral limites à afficher.
  • padding:  number|Padding optional marge intérieure (en pixels). Les limites seront ajustées dans la partie de la carte qui reste après la suppression de la marge intérieure. Une valeur numérique donne la même marge intérieure sur les quatre côtés. Fournissez ici la valeur 0 pour que l'élément fitBounds soit idempotent sur le résultat de getBounds.
Valeur renvoyée:aucune
Définit la fenêtre d'affichage de sorte qu'elle contienne les limites données.
Remarque:Lorsque la carte est définie sur display: none, la fonction fitBounds lit la taille de la carte avec la valeur 0x0 et ne fait donc rien. Pour modifier la fenêtre d'affichage lorsque la carte est masquée, définissez la carte sur visibility: hidden, afin de vous assurer que la taille du div de la carte est réelle. Pour les cartes vectorielles, cette méthode définit l'inclinaison et le cap de leurs valeurs par défaut sur zéro. Cette méthode peut donner une animation fluide, car la carte se déplace et zoome pour s'adapter aux limites. L'animation de cette méthode dépend d'une heuristique interne.
getBounds
getBounds()
Paramètres:aucun
Valeur renvoyée:LatLngBounds|undefined limites de latitude/longitude de la fenêtre d'affichage actuelle.
Renvoie les limites de latitude/longitude de la fenêtre d'affichage actuelle. Si plusieurs copies du monde sont visibles, les limites de la longitude sont comprises entre -180 et 180 degrés. Si la carte n'est pas encore initialisée, ou si le centre et le zoom n'ont pas été définis, le résultat est undefined. Pour les cartes vectorielles avec une inclinaison ou un cap différent de zéro, les limites de latitude et longitude renvoyées représentent le plus petit cadre de délimitation qui comprend la zone visible de la fenêtre d'affichage de la carte. Pour connaître la région exacte de la fenêtre d'affichage de la carte, consultez MapCanvasProjection.getVisibleRegion.
getCenter
getCenter()
Paramètres:aucun
Valeur renvoyée:  LatLng|undefined
Renvoie la position affichée au centre de la carte. Notez que cet objet LatLng n'est pas encapsulé. Pour en savoir plus, consultez LatLng. Si le centre ou les limites n'ont pas été définis, le résultat est undefined.
getClickableIcons
getClickableIcons()
Paramètres:aucun
Valeur renvoyée:  boolean|undefined
Renvoie la cliquabilité des icônes de carte. Une icône de carte représente un point d'intérêt, également appelé POI. Si la valeur renvoyée est true, les icônes sont cliquables sur la carte.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
Paramètres:
  • datasetId:  string
Valeur renvoyée:  FeatureLayer
Renvoie le FeatureLayer correspondant à la datasetId spécifiée. Les ID d'ensembles de données doivent être configurés dans Google Cloud Console. Si l'ID de l'ensemble de données n'est pas associé au style de carte ou si le style basé sur les données n'est pas disponible (aucun ID de carte, aucune tuile vectorielle, aucun calque d'éléments géographiques ni aucun ensemble de données configuré dans le style de carte), une erreur est consignée, et la valeur FeatureLayer.isAvailable renvoyée est "false".
getDiv
getDiv()
Paramètres:aucun
Valeur renvoyée:HTMLElement mapDiv de la carte
getFeatureLayer
getFeatureLayer(featureType)
Paramètres:
Valeur renvoyée:  FeatureLayer
Renvoie le FeatureLayer du FeatureType spécifique. Un FeatureLayer doit être activé dans Google Cloud Console. Si aucun élément FeatureLayer du FeatureType spécifié n'existe sur cette carte, ou si le style basé sur les données n'est pas disponible (aucun ID de carte, aucune carte vectorielle ni aucune FeatureLayer activée dans le style de carte), une erreur est consignée, et la valeur FeatureLayer.isAvailable renvoyée est "false".
getHeading
getHeading()
Paramètres:aucun
Valeur renvoyée:  number|undefined
Renvoie l'en-tête de la carte. La valeur du cap est mesurée en degrés (dans le sens des aiguilles d'une montre) à partir de la direction nord. Si la carte n'est pas encore initialisée, le résultat est undefined.
getMapCapabilities
getMapCapabilities()
Paramètres:aucun
Valeur renvoyée:  MapCapabilities
Indique à l'appelant les fonctionnalités actuelles disponibles pour la carte en fonction de l'ID de carte fourni.
getMapTypeId
getMapTypeId()
Paramètres:aucun
Valeur renvoyée:  MapTypeId|string|undefined
getProjection
getProjection()
Paramètres:aucun
Valeur renvoyée:  Projection|undefined
Renvoie le Projection actuel. Si la carte n'est pas encore initialisée, le résultat est undefined. Écoutez l'événement projection_changed et vérifiez sa valeur pour vous assurer qu'il ne s'agit pas de undefined.
getRenderingType
getRenderingType()
Paramètres:aucun
Valeur renvoyée:  RenderingType
Renvoie le type de rendu actuel de la carte.
getStreetView
getStreetView()
Paramètres:aucun
Valeur renvoyée:StreetViewPanorama Panorama lié à la carte.
Renvoie le StreetViewPanorama par défaut lié à la carte, qui peut être un panorama par défaut intégré à la carte, ou le panorama défini à l'aide de setStreetView(). Les modifications apportées au streetViewControl de la carte sont reflétées dans le panorama auquel il est lié.
getTilt
getTilt()
Paramètres:aucun
Valeur renvoyée:  number|undefined
Renvoie l'angle actuel de la carte, en degrés, entre le plan de la fenêtre d'affichage et le plan. Pour les cartes matricielles, le résultat sera 0 pour les images prises directement au-dessus du plafond ou 45 pour les images à 45°. Cette méthode ne renvoie pas la valeur définie par setTilt. Pour en savoir plus, consultez setTilt.
getZoom
getZoom()
Paramètres:aucun
Valeur renvoyée:  number|undefined
Renvoie le zoom de la carte. Si le zoom n'a pas été défini, le résultat est undefined.
moveCamera
moveCamera(cameraOptions)
Paramètres:
Valeur renvoyée:aucune
Définit immédiatement l'appareil photo de la carte sur les options de caméra cible, sans animation.
panBy
panBy(x, y)
Paramètres:
  • x:  number nombre de pixels permettant de déplacer la carte dans le sens X.
  • y:  number nombre de pixels permettant de déplacer la carte dans la direction Y.
Valeur renvoyée:aucune
Modifie le centre de la carte en fonction de la distance donnée en pixels. Si la distance est inférieure à la largeur et à la hauteur de la carte, la transition sera animée. Notez que le système de coordonnées de carte augmente d'ouest en est (pour les valeurs x) et du nord au sud (pour les valeurs y).
panTo
panTo(latLng)
Paramètres:
Valeur renvoyée:aucune
Modifie le centre de la carte sur la valeur LatLng donnée. Si la modification est inférieure à la largeur et à la hauteur de la carte, la transition sera animée.
panToBounds
panToBounds(latLngBounds[, padding])
Paramètres:
  • latLngBounds:  LatLngBounds|LatLngBoundsLiteral limites permettant de faire un panoramique sur la carte.
  • padding:  number|Padding optional marge intérieure (en pixels). Une valeur numérique donne la même marge intérieure sur les quatre côtés. La valeur par défaut est 0.
Valeur renvoyée:aucune
Panoramique sur la carte en fonction du nombre minimal nécessaire pour contenir le LatLngBounds donné. Il n'est pas garanti que les limites de la carte soient placées à l'extérieur, si ce n'est que celle-ci sera affichée de manière à afficher le plus de limites possible dans {currentMapSizeInPx} - {padding}. Pour les cartes matricielles et vectorielles, le zoom, l'inclinaison et le cap de la carte ne sont pas modifiés.
setCenter
setCenter(latlng)
Paramètres:
Valeur renvoyée:aucune
setClickableIcons
setClickableIcons(value)
Paramètres:
  • value:  boolean
Valeur renvoyée:aucune
Détermine si les icônes de carte sont cliquables ou non. Une icône de carte représente un point d'intérêt, également appelé POI. Pour désactiver la cliquabilité des icônes de carte, transmettez une valeur false à cette méthode.
setHeading
setHeading(heading)
Paramètres:
  • heading:  number
Valeur renvoyée:aucune
Définit la direction de la boussole pour une carte mesurée en degrés à partir de la direction nord. Pour les cartes matricielles, cette méthode ne s'applique qu'aux images aériennes.
setMapTypeId
setMapTypeId(mapTypeId)
Paramètres:
Valeur renvoyée:aucune
setOptions
setOptions(options)
Paramètres:
Valeur renvoyée:aucune
setStreetView
setStreetView(panorama)
Paramètres:
Valeur renvoyée:aucune
Lie un StreetViewPanorama à la carte. Ce panorama remplace la valeur par défaut StreetViewPanorama, ce qui permet à la carte de s'associer à un panorama externe en dehors de la carte. La définition du panorama sur null lie le panorama intégré par défaut à la carte.
setTilt
setTilt(tilt)
Paramètres:
  • tilt:  number
Valeur renvoyée:aucune
Pour les cartes vectorielles, définit l'angle d'incidence de la carte. Les valeurs autorisées sont limitées en fonction du niveau de zoom de la carte. Pour les cartes matricielles, contrôle le comportement de changement automatique de l'angle de la carte. Les seules valeurs autorisées sont 0 et 45. setTilt(0) fait en sorte que la carte utilise toujours une vue aérienne de 0°, quels que soient le niveau de zoom et la fenêtre d'affichage. setTilt(45) entraîne l'inclinaison automatique de l'angle d'inclinaison à 45 chaque fois que les images à 45° sont disponibles pour le niveau de zoom et la fenêtre d'affichage actuels, et redéfinissent sur 0 lorsque les images à 45° ne sont pas disponibles (il s'agit du comportement par défaut). Les images à 45° ne sont disponibles que pour les types de carte satellite et hybrid, dans certaines zones géographiques et à certains niveaux de zoom. Remarque:getTilt renvoie l'angle d'inclinaison actuel, et non la valeur définie par setTilt. Comme getTilt et setTilt font référence à des éléments différents, ne créez pas bind() la propriété tilt. Vous risqueriez d'obtenir des effets imprévisibles.
setZoom
setZoom(zoom)
Paramètres:
  • zoom:  number des valeurs de zoom plus importantes correspondent à une résolution plus élevée.
Valeur renvoyée:aucune
Définit le zoom de la carte.
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
DEMO_MAP_ID ID de carte pouvant être utilisé pour les exemples de code nécessitant un ID de carte. Cet ID de carte n'est pas destiné à être utilisé dans des applications de production et ne peut pas être utilisé pour des fonctionnalités qui nécessitent une configuration dans le cloud (telles que les styles cloud).
bounds_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque les limites de la fenêtre d'affichage ont changé.
center_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la propriété du centre de la carte change.
click
function(event)
Arguments:
Cet événement est déclenché lorsque l'utilisateur clique sur la carte. Un "MapMouseEvent" contenant les propriétés de l'établissement sur lequel l'utilisateur a cliqué est renvoyé, sauf s'il a cliqué sur une icône de lieu, auquel cas un élément "MouseMouseEvent" avec un ID de lieu est renvoyé. IconMouseEvent et MapMouseEvent sont identiques, sauf que IconMouseEvent comporte le champ "ID de lieu". L'événement peut toujours être traité comme un événement MapMouseEvent lorsque l'ID de lieu n'est pas important. L'événement de clic ne se déclenche pas si l'utilisateur a cliqué sur un repère ou une fenêtre d'informations.
contextmenu
function(event)
Arguments:
Cet événement se déclenche lorsque le menu contextuel DOM est déclenché au niveau du conteneur de la carte.
dblclick
function(event)
Arguments:
Cet événement est déclenché lorsque l'utilisateur double-clique sur la carte. Notez que l'événement de clic peut se déclencher une fois, parfois deux fois, juste avant celui-ci.
drag
function()
Arguments:aucun
Cet événement est déclenché à plusieurs reprises pendant que l'utilisateur fait glisser la carte.
dragend
function()
Arguments:aucun
Cet événement est déclenché lorsque l'utilisateur arrête de faire glisser la carte.
dragstart
function()
Arguments:aucun
Cet événement est déclenché lorsque l'utilisateur commence à faire glisser la carte.
heading_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la propriété du titre de la carte change.
idle
function()
Arguments:aucun
Cet événement est déclenché lorsque la carte est inactive après un panoramique ou un zoom.
isfractionalzoomenabled_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la propriété isFractionalZoomEnabled a été modifiée.
mapcapabilities_changed
function()
Arguments:aucun
Cet événement se déclenche lorsque les capacités de la carte changent.
maptypeid_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la propriété mapTypeId change.
mousemove
function(event)
Arguments:
Cet événement est déclenché chaque fois que l'utilisateur passe la souris sur le conteneur de la carte.
mouseout
function(event)
Arguments:
Cet événement est déclenché lorsque la souris de l'utilisateur quitte le conteneur de la carte.
mouseover
function(event)
Arguments:
Cet événement se déclenche lorsque la souris de l'utilisateur accède au conteneur de la carte.
projection_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la projection a changé.
renderingtype_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque le renduType a changé.
tilesloaded
function()
Arguments:aucun
Cet événement se déclenche lorsque le chargement des tuiles visibles est terminé.
tilt_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la propriété d'inclinaison de la carte change.
zoom_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la propriété de zoom sur la carte change.
rightclick
function(event)
Arguments:
Cet événement est déclenché lorsque l'utilisateur clique avec le bouton droit sur la carte.

Interface MapOptions

Interface google.maps.MapOptions

Objet MapOptions utilisé pour définir les propriétés pouvant être définies sur une carte.
backgroundColor optional
Type:string optional
Couleur utilisée pour l'arrière-plan de la carte div. Cette couleur est visible lorsque les tuiles ne sont pas encore chargées lorsque l'utilisateur fait un panoramique. Cette option ne peut être définie que lorsque la carte est initialisée.
center optional
Type:LatLng|LatLngLiteral optional
Centre initial de Map.
clickableIcons optional
Type:boolean optional
Par défaut:true
Lorsque false, les icônes de carte ne sont pas cliquables. Une icône de carte représente un point d'intérêt, également appelé POI.
controlSize optional
Type:number optional
Taille en pixels des commandes affichées sur la carte. Cette valeur doit être fournie directement lors de la création de la map. Si vous la modifiez ultérieurement, les commandes risquent de passer à l'état undefined. Ne régit que les commandes effectuées par l'API Google Maps. mais pas les commandes personnalisées créées par les développeurs.
disableDefaultUI optional
Type:boolean optional
Active/désactive tous les boutons de l'interface utilisateur par défaut. Peut être ignoré individuellement. Ne désactive pas les commandes du clavier, qui sont contrôlées séparément par l'option MapOptions.keyboardShortcuts. Ne désactive pas les commandes gestuelles, qui sont contrôlées séparément par l'option MapOptions.gestureHandling.
disableDoubleClickZoom optional
Type:boolean optional
Active/Désactive le zoom et le centre lorsque l'utilisateur double-clique. Activée par défaut.

Remarque: Cette propriété n'est pas recommandée. Pour désactiver le zoom par double-clic, vous pouvez utiliser la propriété gestureHandling et la définir sur "none".
draggable optional
Type:boolean optional
Si la valeur est false, empêche le déplacement de la carte. Le déplacement est activé par défaut.
draggableCursor optional
Type:string optional
Nom ou URL du curseur à afficher lors du survol d'une carte déplaçable. Cette propriété utilise l'attribut CSS cursor pour modifier l'icône. Comme pour la propriété "css", vous devez spécifier au moins un curseur de remplacement qui n'est pas une URL. Exemple : draggableCursor: 'url(http://www.example.com/icon.png), auto;'.
draggingCursor optional
Type:string optional
Nom ou URL du curseur à afficher lorsque vous faites glisser la carte. Cette propriété utilise l'attribut CSS cursor pour modifier l'icône. Comme pour la propriété "css", vous devez spécifier au moins un curseur de remplacement qui n'est pas une URL. Exemple : draggingCursor: 'url(http://www.example.com/icon.png), auto;'.
fullscreenControl optional
Type:boolean optional
État activé/désactivé de la commande Plein écran.
fullscreenControlOptions optional
Options d'affichage de la commande Plein écran.
gestureHandling optional
Type:string optional
Ce paramètre contrôle la manière dont l'API gère les gestes sur la carte. Valeurs autorisées:
  • "cooperative": les événements de défilement et les gestes à un doigt font défiler la page, et ne font pas de zoom ni de panoramique. Les gestes tactiles à deux doigts permettent de faire un panoramique et de zoomer sur la carte. Pour faire défiler les événements, appuyez sur la touche Ctrl ou ⌘ et agrandissez la carte.
    Dans ce mode, la carte coopère avec la page.
  • "greedy": tous les gestes tactiles et les événements de défilement permettent de faire un panoramique ou de zoomer sur la carte.
  • "none": vous ne pouvez pas faire un panoramique sur la carte ni zoomer sur ceux-ci en fonction des gestes de l'utilisateur.
  • "auto": (par défaut) la gestion des gestes est coopérative ou gourmande, selon que l'utilisateur peut faire défiler la page ou dans un iFrame.
heading optional
Type:number optional
Cap pour les images aériennes en degrés mesurées dans le sens horaire à partir du nord cardinal. Les titres sont alignés sur l'angle disponible le plus proche pour lequel des images sont disponibles.
isFractionalZoomEnabled optional
Type:boolean optional
Par défaut:true pour les cartes vectorielles et false pour les cartes matricielles
Indique si la carte doit autoriser des niveaux de zoom fractionnaires. Écoutez isfractionalzoomenabled_changed pour savoir quand la valeur par défaut a été définie.
keyboardShortcuts optional
Type:boolean optional
Si la valeur est false, la carte ne peut pas être contrôlée par le clavier. Les raccourcis clavier sont activés par défaut.
mapId optional
Type:string optional
ID de carte. Ce paramètre ne peut pas être défini ni modifié après l'instanciation d'une carte.
mapTypeControl optional
Type:boolean optional
État initial activé/désactivé de la commande de type de carte.
mapTypeControlOptions optional
Type:MapTypeControlOptions optional
Options d'affichage initiales de la commande de type de carte.
mapTypeId optional
Type:MapTypeId|string optional
MapMapId initial. La valeur par défaut est ROADMAP.
maxZoom optional
Type:number optional
Niveau de zoom maximal qui sera affiché sur la carte. Si cette valeur est omise ou définie sur null, le zoom maximal du type de carte actuel est utilisé. Les valeurs de zoom valides sont des nombres compris entre zéro et le niveau de zoom maximal accepté.
minZoom optional
Type:number optional
Niveau de zoom minimal qui sera affiché sur la carte. Si cette valeur est omise ou définie sur null, le zoom minimal du type de carte actuel est utilisé. Les valeurs de zoom valides sont des nombres compris entre zéro et le niveau de zoom maximal accepté.
noClear optional
Type:boolean optional
Si la valeur est true, n'effacez pas le contenu de l'élément div de la carte.
panControl optional
Type:boolean optional
État activé/désactivé de la commande de panoramique.

Remarque: La commande Panoramique n'est pas disponible dans le nouvel ensemble de commandes introduit dans la version 3.22 de l'API Google Maps JavaScript. Avec les versions 3.22 et 3.23, vous pouvez choisir d'utiliser l'ensemble de commandes précédent plutôt que les nouveaux, ce qui rend la commande de panoramique disponible dans l'ancien ensemble de commandes. Pour en savoir plus, consultez Nouveautés de la version 3.22 des commandes de carte.
panControlOptions optional
Type:PanControlOptions optional
Options d'affichage de la commande de panoramique.

Remarque: La commande Panoramique n'est pas disponible dans le nouvel ensemble de commandes introduit dans la version 3.22 de l'API Google Maps JavaScript. Avec les versions 3.22 et 3.23, vous pouvez choisir d'utiliser l'ensemble de commandes précédent plutôt que les nouveaux, ce qui rend la commande de panoramique disponible dans l'ancien ensemble de commandes. Pour en savoir plus, consultez Nouveautés de la version 3.22 des commandes de carte.
restriction optional
Type:MapRestriction optional
Définit une limite qui limite la zone de la carte accessible aux utilisateurs. Lorsqu'elle est définie, l'utilisateur ne peut faire un panoramique et zoomer que lorsque la vue de la caméra ne dépasse pas les limites.
rotateControl optional
Type:boolean optional
État activé/désactivé de la commande de rotation
rotateControlOptions optional
Type:RotateControlOptions optional
Options d'affichage de la commande de rotation.
scaleControl optional
Type:boolean optional
État initial activé/désactivé de la commande Scale.
scaleControlOptions optional
Type:ScaleControlOptions optional
Options d'affichage initiales de la commande d'échelle.
scrollwheel optional
Type:boolean optional
Si la valeur est false, désactive le zoom sur la carte à l'aide de la molette de la souris. La molette est activée par défaut.

Remarque: Cette propriété n'est pas recommandée. Pour désactiver le zoom à l'aide de la molette, vous pouvez utiliser la propriété gestureHandling et la définir sur "cooperative" ou "none".
streetView optional
Type:StreetViewPanorama optional
Un StreetViewPanorama à afficher lorsque l'icône Street View est déposée sur la carte. Si aucun panorama n'est spécifié, un StreetViewPanorama par défaut sera affiché dans le div de la carte lorsque l'utilisateur est déposé.
streetViewControl optional
Type:boolean optional
État initial activé/désactivé de la commande Pegman de Street View. Cette commande fait partie de l'interface utilisateur par défaut et doit être définie sur false lorsque vous affichez un type de carte sur lequel la superposition de route Street View ne doit pas s'afficher (par exemple, un type de carte autre que Earth).
streetViewControlOptions optional
Options d'affichage initiales de la commande Pegman Street View.
styles optional
Type:Array<MapTypeStyle> optional
Styles à appliquer à chaque type de carte par défaut. Notez que pour les modes satellite/hybrid et terrain, ces styles ne s'appliquent qu'aux libellés et à la géométrie.
tilt optional
Type:number optional
Pour les cartes vectorielles, définit l'angle d'incidence de la carte. Les valeurs autorisées sont limitées en fonction du niveau de zoom de la carte. Pour les cartes matricielles, contrôle le comportement de changement automatique de l'angle de la carte. Les seules valeurs autorisées sont 0 et 45. Avec la valeur 0, la carte utilise toujours une vue aérienne de 0°, quel que soit le niveau de zoom et la fenêtre d'affichage. Avec la valeur 45, l'angle d'inclinaison passe automatiquement à 45 chaque fois que des images à 45° sont disponibles pour le niveau de zoom et la fenêtre d'affichage actuels, et revient à 0 lorsque les images à 45° ne sont pas disponibles (il s'agit du comportement par défaut). Les images à 45° ne sont disponibles que pour les types de carte satellite et hybrid, dans certaines zones géographiques et à certains niveaux de zoom. Remarque:getTilt renvoie l'angle d'inclinaison actuel, et non la valeur spécifiée par cette option. Comme getTilt et cette option font référence à des éléments différents, ne définissez pas bind() sur la propriété tilt, car cela pourrait avoir des effets imprévisibles.
zoom optional
Type:number optional
Niveau de zoom initial de la carte. Les valeurs de zoom valides sont des nombres compris entre zéro et le niveau de zoom maximal accepté. Les valeurs de zoom plus importantes correspondent à une résolution plus élevée.
zoomControl optional
Type:boolean optional
État activé/désactivé de la commande de zoom.
zoomControlOptions optional
Type:ZoomControlOptions optional
Options d'affichage de la commande de zoom.

Classe MapElement

Classe google.maps.MapElement

MapElement est une sous-classe HTMLElement pour le rendu des cartes. Après avoir chargé la bibliothèque maps, vous pouvez créer une carte au format HTML. Par exemple:
<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID"></gmp-map>

En interne, il utilise Map, accessible avec la propriété innerMap.

Élément personnalisé:
<gmp-map center="lat,lng" map-id="string" zoom="number"></gmp-map>

Cette classe étend HTMLElement.

Cette classe implémente MapElementOptions.

Accédez au compte en appelant const {MapElement} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans l'API Maps JavaScript.
center
Type:LatLng|LatLngLiteral optional
Latitude/longitude centrale de la carte.
Attribut HTML:
  • <gmp-map center="lat,lng"></gmp-map>
innerMap
Type:Map
Référence au Map que MapElement utilise en interne.
mapId
Type:string optional
ID de la carte. Pour en savoir plus, consultez la documentation sur les ID de carte.
Attribut HTML:
  • <gmp-map map-id="string"></gmp-map>
zoom
Type:number optional
Niveau de zoom de la carte.
Attribut HTML:
  • <gmp-map zoom="number"></gmp-map>
BetaaddEventListener
addEventListener(type, listener[, options])
Paramètres:
  • type:  string chaîne sensible à la casse représentant le type d'événement à écouter.
  • listener:  EventListener|EventListenerObject objet qui reçoit une notification. Il doit s'agir d'une fonction ou d'un objet avec la méthode handleEvent
  • options:  boolean|AddEventListenerOptions optional consultez les options. Les événements personnalisés ne sont compatibles qu'avec capture et passive.
Valeur renvoyée:  void
Configure une fonction qui est appelée chaque fois que l'événement spécifié est diffusé vers la cible. Voir GroupByKey
BetaremoveEventListener
removeEventListener(type, listener[, options])
Paramètres:
  • type:  string chaîne spécifiant le type d'événement pour lequel vous souhaitez supprimer un écouteur d'événements.
  • listener:  EventListener|EventListenerObject écouteur d'événements du gestionnaire d'événements à supprimer de la cible d'événement.
  • options:  boolean|EventListenerOptions optional Voir les options
Valeur renvoyée:  void
Supprime de la cible un écouteur d'événements précédemment enregistré auprès de GroupByKey. Voir removeEventListener

Interface MapElementOptions

Interface google.maps.MapElementOptions

Objet MapElementOptions utilisé pour définir les propriétés pouvant être définies sur un élément MapElement.
center optional
Type:LatLng|LatLngLiteral optional
Centre initial de Map.
mapId optional
Type:string optional
ID de carte. Ce paramètre ne peut pas être défini ni modifié après l'instanciation d'une carte.
zoom optional
Type:number optional
Niveau de zoom initial de la carte. Les valeurs de zoom valides sont des nombres compris entre zéro et le niveau de zoom maximal accepté. Les valeurs de zoom plus importantes correspondent à une résolution plus élevée.

Interface MapTypeStyle

Interface google.maps.MapTypeStyle

MapTypeStyle est un ensemble de sélecteurs et de stylers qui définissent le style de la carte. Les sélecteurs spécifient les éléments géographiques et/ou les éléments de la carte qui doivent être affectés, tandis que les stylers spécifient la manière dont ces éléments géographiques et/ou éléments doivent être modifiés. Pour en savoir plus, consultez la documentation de référence sur le style.
stylers
Règles de style à appliquer aux éléments géographiques et aux éléments de la carte sélectionnés. Les règles sont appliquées dans l'ordre que vous indiquez dans ce tableau. Pour obtenir des consignes sur l'utilisation et les valeurs autorisées, consultez la documentation de référence sur le style.
elementType optional
Type:string optional
Élément auquel un styler doit être appliqué. Un élément est un aspect visuel d'un élément géographique sur la carte. Exemple: un libellé, une icône, le trait ou le remplissage appliqués à la géométrie, etc. Facultatif. Si elementType n'est pas spécifié, la valeur est considérée comme 'all'. Pour en savoir plus sur l'utilisation et les valeurs autorisées, consultez la documentation de référence sur le style.
featureType optional
Type:string optional
Élément géographique, ou groupe d'éléments géographiques auxquels un styler doit être appliqué. Facultatif. Si featureType n'est pas spécifié, la valeur est considérée comme 'all'. Pour en savoir plus sur l'utilisation et les valeurs autorisées, consultez la documentation de référence sur le style.

Interface MapMouseEvent

Interface google.maps.MapMouseEvent

Cet objet est renvoyé à partir de différents événements de souris sur la carte et les superpositions. Il contient tous les champs affichés ci-dessous.
domEvent
Événement DOM natif correspondant. Les développeurs ne doivent pas s'appuyer sur les propriétés target, currentTarget, relatedTarget et path définies et cohérentes. Les développeurs ne doivent pas non plus s'appuyer sur la structure DOM de l'implémentation interne de l'API Google Maps. En raison du mappage des événements internes, la domEvent peut avoir une sémantique différente de celle de MapMouseEvent (par exemple, un "clic" MapMouseEvent peut avoir une domEvent de type KeyboardEvent).
latLng optional
Type:LatLng optional
Latitude/longitude qui étaient sous le curseur lorsque l'événement s'est produit.
stop
stop()
Paramètres:aucun
Valeur renvoyée:  void
Empêcher la diffusion de cet événement

Interface IconMouseEvent

Interface google.maps.IconMouseEvent

Cet objet est envoyé dans un événement lorsqu'un utilisateur clique sur une icône de la carte. L'identifiant de lieu de ce lieu est stocké dans le membre placeId. Pour empêcher l'affichage de la fenêtre d'informations par défaut, appelez la méthode stop() sur cet événement pour éviter qu'elle ne soit propagée. Pour en savoir plus sur les ID de lieu, consultez le guide du développeur de l'API Places.

Cette interface étend MapMouseEvent.

placeId optional
Type:string optional
ID du lieu sur lequel l'utilisateur a cliqué. Cet identifiant de lieu peut être utilisé pour interroger plus d'informations sur l'élément géographique sur lequel l'utilisateur a cliqué.

Pour en savoir plus sur les ID de lieu, consultez le guide du développeur de l'API Places.
Hérité: domEvent, latLng
Hérité: stop

Constantes MapTypeId

Constantes google.maps.MapTypeId

Identifiants des MapTypes courants. Spécifiez-les par valeur ou en utilisant le nom de la constante. Par exemple, 'satellite' ou google.maps.MapTypeId.SATELLITE.

Accédez au compte en appelant const {MapTypeId} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans l'API Maps JavaScript.
HYBRID Ce type de carte affiche un calque transparent des principales rues sur les images satellite.
ROADMAP Ce type de carte affiche une carte de rue normale.
SATELLITE Ce type de carte affiche des images satellite.
TERRAIN Ce type de carte affiche des cartes comportant des éléments physiques comme le relief et la végétation.

Classe MapTypeRegistry

Classe google.maps.MapTypeRegistry

Registre des instances MapType, associé à l'identifiant MapType.

Cette classe étend MVCObject.

Accédez au compte en appelant const {MapTypeRegistry} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans l'API Maps JavaScript.
MapTypeRegistry
MapTypeRegistry()
Paramètres:aucun
MapTypeRegistry contient la collection de types de carte personnalisés disponibles pour la carte. L'API consulte ce registre pour fournir la liste des types de carte disponibles dans les commandes, par exemple.
set
set(id, mapType)
Paramètres:
  • id:  string identifiant du MapType à ajouter au registre.
  • mapType:  MapType|* objet MapType à ajouter au registre.
Valeur renvoyée:aucune
Définit le registre pour associer l'identifiant de chaîne transmis au MapType transmis.
Hérité: addListener, bindTo, get, notify, setValues, unbind, unbindAll

Interface MapRestriction

Interface google.maps.MapRestriction

Restriction qui peut être appliquée à la carte. La fenêtre d'affichage de la carte ne dépasse pas ces restrictions.
latLngBounds
Lorsqu'elle est définie, l'utilisateur ne peut faire un panoramique et zoomer que dans les limites données. Les limites peuvent limiter à la fois la longitude et la latitude, ou seulement la latitude. Pour les limites concernant la latitude uniquement, utilisez les longitudes ouest et -180 et 180, respectivement (par exemple, latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}).
strictBounds optional
Type:boolean optional
Pour rendre les limites plus restrictives, définissez l'indicateur strictBounds sur true. Cela permet de réduire le niveau de zoom possible par l'utilisateur, de sorte que les éléments en dehors des limites restreintes restent masqués. La valeur par défaut est false, ce qui signifie qu'un utilisateur peut faire un zoom arrière jusqu'à ce que la totalité de la zone limitée soit visible, y compris les zones en dehors de celle-ci.

Classe TrafficLayer

Classe google.maps.TrafficLayer

Une couche de trafic

Cette classe étend MVCObject.

Accédez au compte en appelant const {TrafficLayer} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans l'API Maps JavaScript.
TrafficLayer
TrafficLayer([opts])
Paramètres:
Calque qui affiche le trafic actuel.
getMap
getMap()
Paramètres:aucun
Valeur renvoyée:  Map
Renvoie la carte sur laquelle ce calque est affiché.
setMap
setMap(map)
Paramètres:
Valeur renvoyée:aucune
Affiche le calque sur la carte spécifiée. Si la carte est définie sur null, le calque est supprimé.
setOptions
setOptions(options)
Paramètres:
Valeur renvoyée:aucune
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interface TrafficLayerOptions

Interface google.maps.TrafficLayerOptions

Objet TrafficLayerOptions utilisé pour définir les propriétés pouvant être définies sur un TrafficLayer.
autoRefresh optional
Type:boolean optional
Par défaut:true
Indique si le calque de trafic s'actualise automatiquement avec les informations mises à jour.
map optional
Type:Map optional
Carte sur laquelle afficher le calque de trafic.

Classe TransitLayer

Classe google.maps.TransitLayer

Calque Transit.

Cette classe étend MVCObject.

Accédez au compte en appelant const {TransitLayer} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans l'API Maps JavaScript.
TransitLayer
TransitLayer()
Paramètres:aucun
Calque affichant les lignes de transports en commun.
getMap
getMap()
Paramètres:aucun
Valeur renvoyée:  Map
Renvoie la carte sur laquelle ce calque est affiché.
setMap
setMap(map)
Paramètres:
Valeur renvoyée:aucune
Affiche le calque sur la carte spécifiée. Si la carte est définie sur null, le calque est supprimé.
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Classe BicyclingLayer

Classe google.maps.BicyclingLayer

Calque montrant les pistes cyclables et les chemins.

Cette classe étend MVCObject.

Accédez au compte en appelant const {BicyclingLayer} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans l'API Maps JavaScript.
BicyclingLayer
BicyclingLayer()
Paramètres:aucun
Calque qui affiche les pistes cyclables et les routes rétrogradées
getMap
getMap()
Paramètres:aucun
Valeur renvoyée:  Map
Renvoie la carte sur laquelle ce calque est affiché.
setMap
setMap(map)
Paramètres:
Valeur renvoyée:aucune
Affiche le calque sur la carte spécifiée. Si la carte est définie sur null, le calque est supprimé.
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interface CameraOptions

Interface google.maps.CameraOptions

Permet de définir les options d'appareil photo de la carte.
center optional
Type:LatLngLiteral|LatLng optional
heading optional
Type:number optional
tilt optional
Type:number optional
zoom optional
Type:number optional

Interface VisibleRegion

Interface google.maps.VisibleRegion

Contient les quatre points définissant le polygone à quatre côtés qui est la région visible de la carte. Sur une carte vectorielle, ce polygone peut être un trapèze plutôt qu'un rectangle, lorsqu'une carte vectorielle est inclinée.
farLeft
Type:LatLng
farRight
Type:LatLng
latLngBounds
Le plus petit cadre de délimitation qui inclut la région visible.
nearLeft
Type:LatLng
nearRight
Type:LatLng

Constantes RenderingType

Constantes google.maps.RenderingType

Accédez au compte en appelant const {RenderingType} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans l'API Maps JavaScript.
RASTER Indique que la carte est une carte matricielle.
UNINITIALIZED Indique qu'il n'est pas encore possible de déterminer si la carte est vectorielle ou matricielle, car son initialisation n'est pas encore terminée.
VECTOR Indique que la carte est vectorielle.

Interface MapCapabilities

Interface google.maps.MapCapabilities

Objet contenant un instantané des capacités actuellement disponibles pour la carte. Notez que cela ne signifie pas nécessairement que les modules pertinents sont chargés ou initialisés, mais que la carte actuelle est autorisée à utiliser ces API. Consultez les propriétés pour connaître la liste des fonctionnalités possibles.
isAdvancedMarkersAvailable optional
Type:boolean optional
Si la valeur est "true", cette carte est correctement configurée pour permettre l'utilisation de repères avancés. Notez que vous devez toujours importer la bibliothèque marker pour utiliser les repères avancés. Pour en savoir plus, consultez la page https://goo.gle/gmp-isAdvancedMarkersAvailable.
isDataDrivenStylingAvailable optional
Type:boolean optional
Si la valeur est "true", cette carte est correctement configurée afin de permettre l'utilisation du style basé sur les données pour au moins un élément LayerLayer. Pour en savoir plus, consultez https://goo.gle/gmp-data-driven-styling et https://goo.gle/gmp-FeatureLayerIsAvailable.