Maps

Map

Classe google.maps.Map

Cette classe étend MVCObject.

Accédez à en appelant const {Map} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans l'API Maps JavaScript.

Map
Map(mapDiv[, opts])
Paramètres:
  • mapDivHTMLElement la carte s'affiche pour remplir cet élément.
  • optsMapOptions optional options
Crée une carte dans le conteneur HTML donné, qui est généralement un élément DIV.
controls
Commandes supplémentaires à associer à la carte. Pour ajouter une commande à la carte, ajoutez le <div> de la commande à la MVCArray correspondant au ControlPosition où elle doit être affichée.
data
Type:Data
Instance Data, lié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:
  • boundsLatLngBounds|LatLngBoundsLiteral limites à afficher.
  • paddingnumber|Padding optional marge intérieure en pixels Les limites seront ajustées dans la partie de la carte qui reste après le retrait de la marge intérieure. Une valeur numérique donne la même marge intérieure sur les quatre côtés. Fournissez ici 0 pour que l'élément fitBounds soit idempotent sur le résultat de getBounds.
Valeur de retour: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 en 0 x 0 et ne fait donc rien. Pour modifier la fenêtre d'affichage alors que la carte est masquée, définissez la carte sur visibility: hidden, afin de vous assurer que le tag div de la carte a une taille réelle. Pour les cartes vectorielles, cette méthode définit l'inclinaison et le cap de la carte sur leurs valeurs zéro par défaut. L'appel de cette méthode peut entraîner une animation lisse lorsque la carte se déplace et que le zoom s'ajuste aux limites. L'animation de cette méthode dépend de la méthode heuristique interne.
getBounds
getBounds()
Paramètres:aucun
Valeur renvoyée : LatLngBounds|undefined : coordonnées 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, la plage de limites est de -180 à 180 degrés (inclus). 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 dont l'inclinaison ou la direction est différente de zéro, les limites de latitude/longitude renvoyées représentent le plus petit cadre de délimitation qui inclut la région visible de la fenêtre d'affichage de la carte. Consultez MapCanvasProjection.getVisibleRegion pour obtenir la région exacte visible de la fenêtre d'affichage de la carte.
getCenter
getCenter()
Paramètres:aucun
Valeur renvoyée:LatLng|undefined
Affiche la position affichée au centre de la carte. Notez que cet objet LatLng n'est pas encapsulé. Pour en savoir plus, accédez à la page 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
Affiche 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.
getDiv
getDiv()
Paramètres:aucun
Valeur renvoyée:HTMLElement Valeur mapDiv de la carte.
BetagetFeatureLayer
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 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 tuile de vecteur et aucune FeatureLayer activée dans le style de carte), cela génère une erreur et le FeatureLayer.isAvailable obtenu est faux.
getHeading
getHeading()
Paramètres:aucun
Valeur renvoyée:number|undefined
Affiche l'orientation de la carte. La valeur de cap est mesurée en degrés (dans le sens des aiguilles d'une montre) à partir de la direction cardinale vers le nord. Si la carte n'est pas encore initialisée, le résultat est undefined.
BetagetMapCapabilities
getMapCapabilities()
Paramètres:aucun
Valeur renvoyée:MapCapabilities
Indique à l'appelant les fonctionnalités actuellement disponibles sur 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 associé à la carte.
Renvoie le StreetViewPanorama par défaut associé à 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 à la streetViewControl de la carte seront reflétées dans un panorama de ce type.
getTilt
getTilt()
Paramètres:aucun
Valeur renvoyée:number|undefined
Affiche l'angle d'incidence actuel de la carte, en degrés, entre le plan de la fenêtre d'affichage et celui du plan. Pour les cartes matricielles, le résultat est 0 pour les images prises directement au-dessus de la ligne 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 de retour:aucune
Définit immédiatement l'appareil photo de la carte sur les options de la caméra cible, sans animation.
panBy
panBy(x, y)
Paramètres:
  • xnumber nombre de pixels pour déplacer la carte dans la direction X.
  • ynumber nombre de pixels pour déplacer la carte dans la direction Y.
Valeur de retour: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 est animée. 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
panTo(latLng)
Paramètres:
Valeur de retour:aucune
Remplace le centre de la carte par la valeur LatLng donnée. Si la modification est inférieure à la largeur et à la hauteur de la carte, la transition est animée.
panToBounds
panToBounds(latLngBounds[, padding])
Paramètres:
  • latLngBoundsLatLngBounds|LatLngBoundsLiteral limites vers lesquelles déplacer la carte.
  • paddingnumber|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 de retour:aucune
Panoramique la carte selon le nombre minimal nécessaire pour contenir le LatLngBounds donné. L'emplacement des limites sur la carte n'est pas garanti. Toutefois, la carte sera panoramique pour afficher le plus de limites possible dans {currentMapSizeInPx} - {padding}. Pour les cartes matricielles et vectorielles, le zoom, l'inclinaison et la direction de la carte ne sont pas modifiés.
setCenter
setCenter(latlng)
Paramètres:
Valeur de retour:aucune
setClickableIcons
setClickableIcons(value)
Paramètres:
  • valueboolean
Valeur de retour:aucune
Détermine si les icônes de la 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:
  • headingnumber
Valeur de retour:aucune
Définit la direction de la boussole pour la carte mesurée en degrés par rapport à la direction vers le nord. Pour les cartes matricielles, cette méthode ne s'applique qu'aux images aériennes.
setMapTypeId
setMapTypeId(mapTypeId)
Paramètres:
Valeur de retour:aucune
setOptions
setOptions(options)
Paramètres:
Valeur de retour:aucune
setStreetView
setStreetView(panorama)
Paramètres:
Valeur de retour:aucune
Liez un StreetViewPanorama à la carte. Ce panorama remplace le StreetViewPanorama par défaut, ce qui permet à la carte de s'associer à un panorama externe en dehors de la carte. Définir le panorama sur null associe le panorama intégré par défaut à la carte.
setTilt
setTilt(tilt)
Paramètres:
  • tiltnumber
Valeur de retour: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 commutation automatique pour l'angle d'incidence de la carte. Les seules valeurs autorisées sont 0 et 45. setTilt(0) permet à la carte de toujours utiliser 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° lorsque des images à 45° sont disponibles pour le niveau de zoom et la fenêtre d'affichage actuels, et repasse à 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. Étant donné que getTilt et setTilt font référence à des éléments différents, ne définissez pas bind() la propriété tilt, car cela pourrait avoir des effets imprévisibles.
setZoom
setZoom(zoom)
Paramètres:
  • zoomnumber des valeurs de zoom plus élevées correspondent à une résolution plus élevée.
Valeur de retour: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 des 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 cloud (comme Cloud Styling).
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é Center Center change.
click
function(event)
Arguments: 
Cet événement est déclenché lorsque l'utilisateur clique sur la carte. Un objet MapMouseEvent associé aux propriétés de la zone géographique sur laquelle l'utilisateur a cliqué est renvoyé, sauf s'il clique sur une icône de lieu, auquel cas un élément IconMouseEvent avec un ID de lieu est renvoyé. IconMouseEvent et MapMouseEvent sont identiques, à l'exception qu'IconMouseEventEvent inclut le champ "ID de lieu". L'événement peut toujours être traité comme un événement MapMouseEvent lorsque l'identifiant de lieu n'est pas important. L'événement de clic ne se déclenche pas lorsqu'un internaute clique sur un repère ou sur une fenêtre d'informations.
contextmenu
function(event)
Arguments: 
Cet événement se déclenche lorsque l'événement DOMcontextmenu est déclenché sur le 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 se déclenche également 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 devient inactive après avoir effectué 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.
Betamapcapabilities_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque les capacités de la carte changent.
maptypeid_changed
function()
Arguments:aucun
Cet événement est déclenché lorsque la propriété mapTypeId est modifiée.
mousemove
function(event)
Arguments: 
Cet événement est déclenché chaque fois que la souris de l'utilisateur passe 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 est déclenché lorsque la souris de l'utilisateur entre dans le 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 type de rendu a changé.
tilesloaded
function()
Arguments:aucun
Cet événement est déclenché 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 de la carte change.
rightclick
function(event)
Arguments: 
Cet événement est déclenché lorsque l'utilisateur fait un clic droit sur la carte.

Interface MapOptions

google.maps.MapOptions interface

Objet MapOptions permettant de 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 l'élément div de carte. Cette couleur sera visible lorsque les tuiles ne seront pas encore chargées lorsque l'utilisateur fera 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 la carte.
clickableIcons optional
Type:boolean optional
Par défaut:true
Lorsque la valeur est 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 carte. Si vous la mettez à jour ultérieurement, les commandes risquent de passer à l'état undefined. Ne régit que les commandes effectuées par l'API Google Maps. N'ajuste pas les contrôles personnalisés créés par les développeurs.
disableDefaultUI optional
Type:boolean optional
Active/désactive tous les boutons d'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 du texte lors d'un double clic. Cette option est activée par défaut.

Remarque: Cette propriété n'est pas recommandée. Pour désactiver le zoom en double-clic, vous pouvez utiliser la propriété gestureHandling et la définir sur "none".

draggable optional
Type:boolean optional
Si la valeur est définie sur 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 lorsque l'utilisateur passe la souris sur 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 la carte est déplacée. 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 tactiles avec un doigt font défiler la page, et ne font pas de zoom ni de panoramique. Les gestes tactiles à deux doigts effectuent un panoramique et un zoom sur la carte. Utilisez la touche Ctrl ou ⌘ pour faire défiler les événements et zoomer sur la carte.
    Dans ce mode, la carte coopère avec la page.
  • "greedy": tous les gestes tactiles et les événements de défilement se déplacent ou zooment sur la carte.
  • "none": vous ne pouvez pas faire de panoramique ni zoomer sur la carte en effectuant des gestes de l'utilisateur.
  • "auto": (par défaut) la gestion des gestes se fait coopérative ou gênante, selon que l'utilisateur peut faire défiler la page ou la placer dans un cadre iFrame.
heading optional
Type:number optional
Le cap pour les images aériennes en degrés mesuré dans le sens des aiguilles d'une montre à 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 les 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 définie sur 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
Identifiant de la carte. Impossible de définir ou de modifier ce paramètre après l'instanciation d'une carte.
mapTypeControl optional
Type:boolean optional
État initial/désactivé de la commande de type de carte.
mapTypeControlOptions optional
Type:MapTypeControlOptions optional
Options d'affichage initiales pour la commande "Type de carte".
mapTypeId optional
Type:MapTypeId|string optional
Identifiant 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, c'est le zoom maximal du type de carte actuel qui est utilisé. Les valeurs de zoom valides sont des nombres allant de zéro à 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, c'est le zoom minimal du type de carte actuel qui est utilisé. Les valeurs de zoom valides sont des nombres allant de zéro à 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 associé à la carte.
panControl optional
Type:boolean optional
État activé/désactivé de la commande de panoramique.

Remarque: La commande de panoramique n'est pas disponible dans le nouvel ensemble de commandes introduit dans la version 3.22 de l'API Google Maps JavaScript. Dans les versions 3.22 et 3.23, vous pouvez choisir d'utiliser l'ensemble de commandes précédent, plutôt que les nouvelles commandes, afin que la commande de panoramique soit disponible dans l'ancienne version. Pour en savoir plus, consultez Nouveautés de la version 3.22 des commandes de la carte.

panControlOptions optional
Type:PanControlOptions optional
Options d'affichage de la commande de panoramique.

Remarque: La commande de panoramique n'est pas disponible dans le nouvel ensemble de commandes introduit dans la version 3.22 de l'API Google Maps JavaScript. Dans les versions 3.22 et 3.23, vous pouvez choisir d'utiliser l'ensemble de commandes précédent, plutôt que les nouvelles commandes, afin que la commande de panoramique soit disponible dans l'ancienne version. Pour en savoir plus, consultez Nouveautés de la version 3.22 des commandes de la carte.

restriction optional
Type:MapRestriction optional
Définit une limite qui restreint la zone de la carte accessible aux utilisateurs. Lorsqu'elle est définie, l'utilisateur ne peut effectuer un panoramique et un zoom que lorsque la vue de la caméra reste dans les limites de la limite.
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/désactivé de la commande de scaling
scaleControlOptions optional
Type:ScaleControlOptions optional
Options d'affichage initiales de la commande "Échelle".
scrollwheel optional
Type:boolean optional
Si la valeur est false, le zoom sur la carte est désactivé à 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
StreetViewPanorama à afficher lorsque Pegman est passé sur la carte. Si aucun panorama n'est spécifié, un StreetViewPanorama par défaut est affiché dans le div de la carte lorsque Pegman est supprimé.
streetViewControl optional
Type:boolean optional
État initial/désactivé de la commande Pegman Street View Cette commande fait partie de l'interface utilisateur par défaut. Elle 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 Google Earth).
streetViewControlOptions optional
Options d'affichage initiales de la commande Pegman pour Street View.
styles optional
Type:Array<MapTypeStyle> optional
Styles à appliquer à chacun des types 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 commutation automatique pour l'angle d'incidence 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 °, quels que soient le niveau de zoom et la fenêtre d'affichage. La valeur 45 entraîne automatiquement le passage de l'angle d'inclinaison à 45 dès que des images à 45° sont disponibles pour le niveau de zoom et la fenêtre d'affichage actuels, et repasse à 0 dès que 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. Étant donné que getTilt et cette option font référence à des éléments différents, ne définissez pas bind() 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 allant de zéro à le niveau de zoom maximal accepté. Plus la valeur de zoom est élevée, plus la résolution est é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.

Interface MapTypeStyle

google.maps.MapTypeStyle interface

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 qui doivent être affectés, et les stylers définissent la manière dont ces éléments géographiques et éléments doivent être modifiés. Pour en savoir plus, consultez la référence de style.

stylers
Règles de style à appliquer aux éléments géographiques et aux éléments de carte sélectionnés. Les règles sont appliquées dans l'ordre que vous spécifiez dans ce tableau. Pour en savoir plus 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: une étiquette, une icône, le trait ou le remplissage appliqué à la géométrie, etc. Facultatif. Si elementType n'est pas spécifié, la valeur est supposée être '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 auxquels un styler doit être appliqué. Facultatif. Si featureType n'est pas spécifié, la valeur est supposée être '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

google.maps.MapMouseEvent interface

Cet objet est renvoyé par divers événements de souris sur la carte et en superposition et 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 d'événements internes, la sémantique de domEvent peut être 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 était sous le curseur lorsque l'événement s'est produit.
stop
stop()
Paramètres:aucun
Valeur renvoyée:void
Empêche la propagation de cet événement.

IconMouseEvent

google.maps.IconMouseEvent interface

Cet objet est envoyé dans un événement lorsqu'un utilisateur clique sur une icône sur la carte. L'identifiant 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 empêcher sa propagation. 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 demander 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 ces valeurs par valeur ou en utilisant le nom de la constante. Exemples : 'satellite' ou google.maps.MapTypeId.SATELLITE.

Accédez à 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 d'instances MapType, associé à l'ID MapType.

Cette classe étend MVCObject.

Accédez à 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 des types de carte personnalisés disponibles pour la carte pour son utilisation. 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:
  • idstring identifiant du MapType à ajouter au registre.
  • mapTypeMapType|* objet MapType à ajouter au registre.
Valeur de retour:aucune
Définit le registre de façon à associer l'identifiant de chaîne transmis au MapType transmis.
Hérité:addListener, bindTo, get, notify, setValues, unbind, unbindAll

Interface MapRestriction

google.maps.MapRestriction interface

Restriction pouvant être appliquée à la carte. La fenêtre d'affichage de la carte ne dépassera pas ces restrictions.

latLngBounds
Lorsqu'elle est définie, l'utilisateur ne peut effectuer un panoramique et un zoom qu'à l'intérieur des limites données. Les limites peuvent limiter la longitude et la latitude, ou seulement la latitude. Pour les limites de latitude uniquement, utilisez les longitudes de l'ouest et de l'est de -180 et de 180, respectivement, par exemple, latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}.
strictBounds optional
Type:boolean optional
Vous pouvez rendre les limites plus restrictives en définissant l'option strictBounds sur true. Ainsi, l'utilisateur peut effectuer un zoom arrière de manière à masquer tous les éléments en dehors des limites. La valeur par défaut est false, ce qui signifie qu'un utilisateur peut effectuer un zoom arrière jusqu'à ce que toute la zone limitée soit visible, y compris les zones extérieures.

Classe TrafficLayer

Classe google.maps.TrafficLayer

Un calque de trafic

Cette classe étend MVCObject.

Accédez à en appelant const {TrafficLayer} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans l'API Maps JavaScript.

TrafficLayer
TrafficLayer([opts])
Paramètres:
Calque indiquant la circulation en cours.
getMap
getMap()
Paramètres:aucun
Valeur renvoyée:Map
Affiche la carte sur laquelle ce calque est affiché.
setMap
setMap(map)
Paramètres:
Valeur de retour: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 de retour:aucune
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interface TrafficLayerOptions

google.maps.TrafficLayerOptions interface

Objet TrafficLayerOptions permettant de définir les propriétés pouvant être définies sur un objet TrafficLayer.

autoRefresh optional
Type:boolean optional
Par défaut:true
Indique si le calque de trafic est actualisé 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

Un calque de transports en commun

Cette classe étend MVCObject.

Accédez à 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
Affiche la carte sur laquelle ce calque est affiché.
setMap
setMap(map)
Paramètres:
Valeur de retour: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 indiquant les pistes cyclables

Cette classe étend MVCObject.

Accédez à en appelant const {BicyclingLayer} = await google.maps.importLibrary("maps"). Consultez Bibliothèques dans l'API Maps JavaScript.

BicyclingLayer
BicyclingLayer()
Paramètres:aucun
Ce calque permet d'afficher les pistes cyclables et de rétrograder les grandes routes.
getMap
getMap()
Paramètres:aucun
Valeur renvoyée:Map
Affiche la carte sur laquelle ce calque est affiché.
setMap
setMap(map)
Paramètres:
Valeur de retour: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

CameraOptions

google.maps.CameraOptions interface

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

google.maps.VisibleRegion interface

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 incluant la région visible.
nearLeft
Type:LatLng
nearRight
Type:LatLng

Constantes RenderingType

constantes google.maps.RenderingType

Accédez à 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 de type vecteur ou raster, car l'initialisation de la carte n'est pas encore terminée.
VECTOR Indique que la carte est une carte vectorielle.

Interface MapCapabilities

google.maps.MapCapabilities interface

Objet contenant un instantané des fonctionnalités actuellement disponibles pour la carte. Consultez les propriétés pour obtenir la liste des fonctionnalités possibles.

isAdvancedMarkersAvailable optional
Type:boolean optional
isDataDrivenStylingAvailable optional
Type:boolean optional