Classe MapElement
Classe google.maps.MapElement
MapElement est une sous-classe HTMLElement pour le rendu des cartes. Une fois la bibliothèque maps chargée, une carte peut être créée en HTML. Exemple : 
<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>En interne, il utilise
Map, qui est accessible avec la propriété MapElement.innerMap.
Élément personnalisé :
<gmp-map center="lat,lng" heading-interaction-disabled internal-usage-attribution-ids="id1 id2" map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>
Cette classe étend HTMLElement.
Cette classe implémente MapElementOptions.
Accédez-y en appelant le const {MapElement} = await google.maps.importLibrary("maps"). 
 Consultez Bibliothèques de l'API Maps JavaScript.
| Constructeur | |
|---|---|
| MapElement | MapElement([options])Paramètres :  
 | 
| Propriétés | |
|---|---|
| center | Type :  LatLng|LatLngLiteral optionalLatitude et longitude du centre de la carte. Attribut HTML : 
 | 
| headingInteractionDisabled | Type :  boolean optionalPar défaut :  falseIndique si la carte doit autoriser le contrôle de l'orientation de la caméra par l'utilisateur (rotation). Cette option n'est effective que lorsque la carte est une carte vectorielle. Si ce paramètre n'est pas défini dans le code, la configuration cloud de l'ID de carte est utilisée (si elle est disponible). Attribut HTML : 
 | 
| innerMap | Type :  MapRéférence au  Mapque MapElement utilise en interne. | 
| internalUsageAttributionIds | Type :  Iterable<string> optionalPar défaut :  nullAjoute un ID d'attribution d'utilisation à l'initialiseur, ce qui aide Google à comprendre quelles bibliothèques et quels exemples sont utiles aux développeurs, comme l'utilisation d'une bibliothèque de regroupement de repères. Pour ne pas envoyer l'ID d'attribution de l'utilisation, vous pouvez supprimer cette propriété ou remplacer la valeur par une chaîne vide. Seules les valeurs uniques seront envoyées. Les modifications apportées à cette valeur après l'instanciation peuvent être ignorées. Attribut HTML : 
 | 
| mapId | Type :  string optionalL'ID de carte de la carte. Ce paramètre ne peut pas être défini ni modifié une fois la carte instanciée.  Map.DEMO_MAP_IDpeut être utilisé pour tester des fonctionnalités qui nécessitent un ID de carte, mais pas l'activation du cloud.Attribut HTML : 
 | 
| renderingType | Type :  RenderingType optionalPar défaut :  RenderingType.VECTORSi la carte doit être matricielle ou vectorielle. Ce paramètre ne peut pas être défini ni modifié une fois la carte instanciée. Si elle n'est pas définie, la configuration cloud de l'ID de carte déterminera le type de rendu (si disponible). Veuillez noter que les cartes vectorielles ne sont pas disponibles pour tous les appareils ni tous les navigateurs. La carte basculera vers une carte matricielle si nécessaire. Attribut HTML : 
 | 
| tiltInteractionDisabled | Type :  boolean optionalPar défaut :  falseIndique si la carte doit autoriser le contrôle de l'inclinaison de la caméra par l'utilisateur. Cette option n'est effective que lorsque la carte est une carte vectorielle. Si ce paramètre n'est pas défini dans le code, la configuration cloud de l'ID de carte est utilisée (si elle est disponible). Attribut HTML : 
 | 
| zoom | Type :  number optionalNiveau de zoom de la carte. Les valeurs de zoom valides sont des nombres compris entre zéro et le niveau de zoom maximal autorisé. Plus la valeur de zoom est élevée, plus la résolution est élevée. Attribut HTML : 
 | 
| Méthodes | |
|---|---|
| addEventListener | addEventListener(type, listener[, options])Paramètres :  
 Valeur renvoyée :  voidConfigure une fonction qui sera appelée chaque fois que l'événement spécifié sera distribué à la cible. Consultez addEventListener. | 
| removeEventListener | removeEventListener(type, listener[, options])Paramètres :  
 Valeur renvoyée :  voidSupprime un écouteur d'événements précédemment enregistré avec addEventListener de la cible. Consultez removeEventListener. | 
| Événements | |
|---|---|
| gmp-zoomchange | function(event)Arguments :   
 Cet événement est déclenché lorsque la propriété de zoom de la carte change. | 
Interface MapElementOptions
Interface google.maps.MapElementOptions
Objet MapElementOptions utilisé pour définir les propriétés pouvant être définies sur un MapElement.
| Propriétés | |
|---|---|
| center optional | Type :  LatLng|LatLngLiteral optionalConsultez les  MapElement.center. | 
| headingInteractionDisabled optional | Type :  boolean optionalConsultez les  MapElement.headingInteractionDisabled. | 
| internalUsageAttributionIds optional | Type :  Iterable<string> optionalConsultez les  MapElement.internalUsageAttributionIds. | 
| mapId optional | Type :  string optionalConsultez les  MapElement.mapId. | 
| renderingType optional | Type :  RenderingType optionalConsultez les  MapElement.renderingType. | 
| tiltInteractionDisabled optional | Type :  boolean optionalConsultez les  MapElement.tiltInteractionDisabled. | 
| zoom optional | Type :  number optionalConsultez les  MapElement.zoom. | 
Classe ZoomChangeEvent
Classe google.maps.ZoomChangeEvent
Cet événement est créé à partir d'une modification du zoom de surveillance.
Cette classe étend Event.
Accédez-y en appelant le const {ZoomChangeEvent} = await google.maps.importLibrary("maps"). 
 Consultez Bibliothèques de l'API Maps JavaScript.
Classe Map
Classe google.maps.Map
Cette classe étend MVCObject.
Accédez-y en appelant le const {Map} = await google.maps.importLibrary("maps"). 
 Consultez Bibliothèques de l'API Maps JavaScript.
| Constructeur | |
|---|---|
| Map | Map(mapDiv[, opts])Paramètres :  
 Crée une nouvelle carte à l'intérieur du conteneur HTML (en général un élément  DIV). | 
| Constantes | |
|---|---|
| DEMO_MAP_ID | ID de carte pouvant être utilisé pour les exemples de code qui nécessitent 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 les fonctionnalités qui nécessitent une configuration cloud (comme le style cloud). | 
| Propriétés | |
|---|---|
| controls | Type :  Array<MVCArray<HTMLElement>>Commandes supplémentaires à associer à la carte. Pour ajouter une commande à la carte, ajoutez le  <div>de la commande auMVCArraycorrespondant à laControlPositionoù elle doit être affichée. | 
| data | Type :  DataInstance de  Data, liée à la carte. Ajoutez des fonctionnalités à cet objetDatapour les afficher facilement sur cette carte. | 
| mapTypes | Type :  MapTypeRegistryRegistre des instances  MapTypepar ID de chaîne. | 
| overlayMapTypes | Autres types de cartes à 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). | 
| Méthodes | |
|---|---|
| fitBounds | fitBounds(bounds[, padding])Paramètres :  
 Valeur renvoyée : aucune Définit la fenêtre d'affichage pour qu'elle contienne les limites spécifiées. Remarque : Lorsque la carte est définie sur display: none, la fonctionfitBoundslit la taille de la carte comme étant 0x0 et ne fait donc rien. Pour modifier la fenêtre d'affichage lorsque la carte est masquée, définissez la carte survisibility: hidden. Vous vous assurez ainsi que le 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 par défaut (zéro). L'appel de cette méthode peut entraîner une animation fluide lorsque la carte effectue un panoramique et un zoom 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|undefinedLimites de latitude/longitude de la fenêtre d'affichage actuelle.Renvoie les limites lat/lng de la fenêtre d'affichage actuelle. Si plusieurs copies du monde sont visibles, la plage de limites de longitude est comprise entre -180 et 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 avec une inclinaison ou un cap non nuls, les limites de latitude/longitude renvoyées représentent le plus petit cadre de délimitation qui comprend la région visible de la fenêtre d'affichage de la carte. ConsultezMapCanvasProjection.getVisibleRegionpour obtenir la région visible exacte de la fenêtre d'affichage de la carte. | 
| getCenter | getCenter()Paramètres : aucun Valeur renvoyée :  LatLng|undefined | 
| getClickableIcons | getClickableIcons()Paramètres : aucun Valeur renvoyée :  boolean|undefinedRenvoie la possibilité de cliquer sur les icônes de la carte. Une icône de carte représente un point d'intérêt (POI). Si la valeur renvoyée est  true, les icônes sont cliquables sur la carte. | 
|  | getDatasetFeatureLayer(datasetId)Paramètres :  
 Valeur renvoyée :  FeatureLayerRenvoie le  FeatureLayerpour ledatasetIdspécifié. Les ID d'ensemble de données doivent être configurés dans la console Google Cloud. 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 de caractéristiques de style basé sur les données ni aucun ensemble de données configuré dans le style de carte), une erreur est consignée et la valeurFeatureLayer.isAvailablerésultante est définie sur "false". | 
| getDiv | getDiv()Paramètres : aucun Valeur renvoyée :  HTMLElementmapDiv de la carte. | 
| getFeatureLayer | getFeatureLayer(featureType)Paramètres :  
 Valeur renvoyée :  FeatureLayerRenvoie le  FeatureLayerduFeatureTypespécifique. UnFeatureLayerdoit être activé dans la console Google Cloud. Si unFeatureLayerduFeatureTypespécifié n'existe pas sur cette carte ou si le style basé sur les données n'est pas disponible (aucun ID de carte, aucune tuile vectorielle et aucunFeatureLayeractivé dans le style de carte), une erreur est enregistrée et leFeatureLayer.isAvailablerésultant est défini sur "false". | 
| getHeading | getHeading()Paramètres : aucun Valeur renvoyée :  number|undefinedRenvoie la direction indiquée par la boussole sur la carte. La valeur du cap est mesurée en degrés (dans le sens des aiguilles d'une montre) à partir du nord cardinal. Si la carte n'est pas encore initialisée, le résultat est  undefined. | 
| getHeadingInteractionEnabled | getHeadingInteractionEnabled()Paramètres : aucun Valeur renvoyée :  boolean|nullIndique si les interactions avec les titres sont activées. Cette option n'est effective que lorsque la carte est une carte vectorielle. Si ce paramètre n'est pas défini dans le code, la configuration cloud de l'ID de carte est utilisée (si elle est disponible). | 
| getInternalUsageAttributionIds | getInternalUsageAttributionIds()Paramètres : aucun Valeur renvoyée :  Iterable<string>|nullRenvoie la liste des ID d'attribution d'utilisation, qui aident Google à comprendre quelles bibliothèques et quels exemples sont utiles aux développeurs, comme l'utilisation d'une bibliothèque de regroupement de repères. | 
| getMapCapabilities | getMapCapabilities()Paramètres : aucun Valeur renvoyée :  MapCapabilitiesInforme l'appelant des fonctionnalités actuellement 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|undefinedRenvoie le  Projectionactuel. Si la carte n'est pas encore initialisée, le résultat estundefined. Écoutez l'événementprojection_changedet vérifiez sa valeur pour vous assurer qu'elle n'est pasundefined. | 
| getRenderingType | getRenderingType()Paramètres : aucun Valeur renvoyée :  RenderingTypeRenvoie le RenderingType actuel de la carte. | 
| getStreetView | getStreetView()Paramètres : aucun Valeur renvoyée :  StreetViewPanoramaPanorama lié à la carte.Renvoie la limite  StreetViewPanoramapar défaut associée à la carte, qui peut être un panorama par défaut intégré à la carte ou le panorama défini à l'aide desetStreetView(). Les modifications apportées àstreetViewControlde la carte seront reflétées dans l'affichage d'un panorama lié. | 
| getTilt | getTilt()Paramètres : aucun Valeur renvoyée :  number|undefinedRenvoie l'angle d'incidence actuel de la carte, en degrés, entre le plan de la fenêtre d'affichage et le plan de la carte. Pour les cartes matricielles, le résultat sera  0pour les images prises directement au-dessus ou45pour les images à 45°. Cette méthode ne renvoie pas la valeur définie parsetTilt. Pour en savoir plus, consultezsetTilt. | 
| getTiltInteractionEnabled | getTiltInteractionEnabled()Paramètres : aucun Valeur renvoyée :  boolean|nullIndique si les interactions d'inclinaison sont activées. Cette option n'est effective que lorsque la carte est une carte vectorielle. Si ce paramètre n'est pas défini dans le code, la configuration cloud de l'ID de carte est utilisée (si elle est disponible). | 
| getZoom | getZoom()Paramètres : aucun Valeur renvoyée :  number|undefinedRenvoie le niveau de 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 les options de caméra de la carte sur les options de caméra cibles, sans animation. | 
| panBy | panBy(x, y)Paramètres :  
 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 de manière fluide. 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 renvoyée : aucune Modifie le centre de la carte pour le  LatLngdonné. Si la modification est inférieure à la largeur et à la hauteur de la carte, la transition sera animée de manière fluide. | 
| panToBounds | panToBounds(latLngBounds[, padding])Paramètres :  
 Valeur renvoyée : aucune Effectue un panoramique de la carte sur la distance minimale nécessaire pour contenir le  LatLngBoundsdonné. Il ne garantit pas où se trouveront les limites sur la carte, si ce n'est que la carte sera déplacée pour afficher autant de limites que possible à l'intérieur de{currentMapSizeInPx} - {padding}. Pour les cartes matricielles et vectorielles, le zoom, l'inclinaison et le cap de la carte ne seront pas modifiés. | 
| setCenter | setCenter(latlng)Paramètres :  
 Valeur renvoyée : aucune | 
| setClickableIcons | setClickableIcons(value)Paramètres :  
 Valeur renvoyée : aucune Contrôle si les icônes de la carte sont cliquables ou non. Une icône de carte représente un point d'intérêt (POI). Pour désactiver la possibilité de cliquer sur les icônes de la carte, transmettez la valeur  falseà cette méthode. | 
| setHeading | setHeading(heading)Paramètres :  
 Valeur renvoyée : aucune Définit l'orientation de la boussole pour la carte, mesurée en degrés à partir du point cardinal nord. Pour les cartes raster, cette méthode ne s'applique qu'aux images aériennes. | 
| setHeadingInteractionEnabled | setHeadingInteractionEnabled(headingInteractionEnabled)Paramètres :  
 Valeur renvoyée : aucune Indique si les interactions avec les titres sont activées. Cette option n'est effective que lorsque la carte est une carte vectorielle. Si ce paramètre n'est pas défini dans le code, la configuration cloud de l'ID de carte est utilisée (si elle est disponible). | 
| setMapTypeId | setMapTypeId(mapTypeId)Paramètres :  
 Valeur renvoyée : aucune | 
| setOptions | setOptions(options)Paramètres :  
 Valeur renvoyée : aucune | 
| setRenderingType | setRenderingType(renderingType)Paramètres :  
 Valeur renvoyée : aucune Définit le RenderingType actuel de la carte. | 
| setStreetView | setStreetView(panorama)Paramètres :  
 Valeur renvoyée : aucune Associe un  StreetViewPanoramaà la carte. Ce panorama remplace leStreetViewPanoramapar défaut, ce qui permet à la carte de se lier à un panorama externe. Si vous définissez le panorama surnull, le panorama intégré par défaut est à nouveau associé à la carte. | 
| setTilt | setTilt(tilt)Paramètres :  
 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 commutation automatique de l'angle d'incidence de la carte. Les seules valeurs autorisées sont 0et45.setTilt(0)force la carte à toujours utiliser une vue aérienne à 0°, quel que soit le niveau de zoom et la fenêtre d'affichage.setTilt(45)permet à l'angle d'inclinaison de passer automatiquement à 45 lorsque des images à 45° sont disponibles pour le niveau de zoom et la fenêtre d'affichage actuels, et de revenir à 0 lorsque des 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 cartesatelliteethybrid, dans certaines zones géographiques et à certains niveaux de zoom. Remarque :getTiltrenvoie l'angle d'inclinaison actuel, et non la valeur définie parsetTilt. Étant donné quegetTiltetsetTiltfont référence à des éléments différents, nebind()pas la propriététilt, car cela pourrait avoir des effets imprévisibles. | 
| setTiltInteractionEnabled | setTiltInteractionEnabled(tiltInteractionEnabled)Paramètres :  
 Valeur renvoyée : aucune Indique si les interactions d'inclinaison sont activées. Cette option n'est effective que lorsque la carte est une carte vectorielle. Si ce paramètre n'est pas défini dans le code, la configuration cloud de l'ID de carte est utilisée (si elle est disponible). | 
| setZoom | setZoom(zoom)Paramètres :  
 Valeur renvoyée : aucune Définit le zoom de la carte. | 
| Hérité : addListener,bindTo,get,notify,set,setValues,unbind,unbindAll | |
| Événements | |
|---|---|
| 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 avec des propriétés pour l'emplacement sur lequel l'utilisateur a cliqué est renvoyé, sauf si l'utilisateur a cliqué sur une icône de lieu. Dans ce cas, un IconMouseEvent avec un ID de lieu est renvoyé. IconMouseEvent et MapMouseEvent sont identiques, sauf que IconMouseEvent comporte le champ "place ID" (identifiant de lieu). L'événement peut toujours être traité comme un MapMouseEvent lorsque l'ID du lieu n'est pas important. L'événement de clic n'est pas déclenché si l'utilisateur a cliqué sur un repère ou une fenêtre d'informations. | 
| contextmenu | function(event)Arguments :   
 Cet événement est déclenché lorsque l'événement contextmenu du DOM est déclenché sur le conteneur de la carte. | 
| dblclick | function(event)Arguments :   
 Cet événement se déclenche lorsque l'utilisateur effectue un double-clic sur la carte. Notez que l'événement de clic se déclenche parfois une fois et parfois deux fois, juste avant celui-ci. | 
| drag | function()Arguments : aucun Cet événement est déclenché à plusieurs reprises lorsque 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. Remarque : L'événement dragend n'est PAS déclenché lorsque l'utilisateur arrête de faire défiler la carte à l'aide du clavier. Veuillez plutôt utiliser l'événement  Map.idlepour déterminer quand l'utilisateur a arrêté de faire un panoramique ou 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é d'orientation de la carte change. | 
| idle | function()Arguments : aucun Cet événement est déclenché lorsque la carte devient 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 changé. | 
| mapcapabilities_changed | function()Arguments : aucun Cet événement est déclenché lorsque les fonctionnalité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 la souris de l'utilisateur se déplace 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 renderingType a changé. | 
| tilesloaded | function()Arguments : aucun Cet événement est déclenché lorsque les tuiles visibles ont fini de se charger. | 
| 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. | 
|  | function(event)Arguments :   
 Cet événement est déclenché lorsque l'utilisateur effectue un clic 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.
| Propriétés | |
|---|---|
| backgroundColor optional | Type :  string optionalCouleur utilisée pour l'arrière-plan du div de la carte. Cette couleur sera visible tant que les tuiles n'auront pas été chargées lorsque l'utilisateur fera un panoramique. Cette option ne peut être définie que lorsque la carte est initialisée. | 
| cameraControl optional | Type :  boolean optionalÉtat activé/désactivé de la commande de la caméra. | 
| cameraControlOptions optional | Type :  CameraControlOptions optionalOptions d'affichage pour la commande de la caméra. | 
| center optional | Type :  LatLng|LatLngLiteral optionalCentre initial de la carte. | 
| clickableIcons optional | Type :  boolean optionalPar défaut :  trueLorsque  false, les icônes de la carte ne sont pas cliquables. Une icône de carte représente un point d'intérêt (POI). | 
| colorScheme optional | Type :  ColorScheme|string optionalPar défaut :  ColorScheme.LIGHTJeu de couleurs initial de la carte. Cette option ne peut être définie que lorsque la carte est initialisée. | 
| controlSize optional | Type :  number optionalTaille en pixels des commandes qui s'affichent sur la carte. Cette valeur doit être fournie directement lors de la création de la carte. Si vous la modifiez ultérieurement, les commandes peuvent passer à l'état  undefined. Ne régit que les contrôles effectués par l'API Maps elle-même. Ne met pas à l'échelle les contrôles personnalisés créés par les développeurs. | 
| disableDefaultUI optional | Type :  boolean optionalActive/Désactive tous les boutons de l'UI par défaut. Peut être remplacé individuellement. Ne désactive pas les commandes au 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'optionMapOptions.gestureHandling. | 
| disableDoubleClickZoom optional | Type :  boolean optionalActive/Désactive le zoom et le centrage par double-clic. Cette option est activée par défaut.  Remarque : Cette propriété n'est pas recommandée. Pour désactiver le zoom sur double-clic, vous pouvez utiliser la propriété  | 
|  | Type :  boolean optionalSi la valeur est  false, la carte ne peut pas être déplacée. Le déplacement est activé par défaut. | 
| draggableCursor optional | Type :  string optionalNom ou URL du curseur à afficher lorsque la souris pointe sur une carte déplaçable. Cette propriété utilise l'attribut CSS  cursorpour 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 optionalNom ou URL du curseur à afficher lorsque la carte est déplacée. Cette propriété utilise l'attribut CSS  cursorpour 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é du contrôle plein écran. | 
| fullscreenControlOptions optional | Type :  FullscreenControlOptions optionalOptions d'affichage de la commande de plein écran. | 
| gestureHandling optional | Type :  string optionalCe paramètre contrôle la façon dont l'API gère les gestes sur la carte. Valeurs autorisées :  
 | 
| heading optional | Type :  number optionalOrientation des images aériennes en degrés, mesurée dans le sens des aiguilles d'une montre à partir du point cardinal nord. Les titres sont alignés sur l'angle disponible le plus proche pour lequel des images sont disponibles. | 
| headingInteractionEnabled optional | Type :  boolean optionalPar défaut :  falseIndique si la carte doit autoriser le contrôle de l'orientation de la caméra par l'utilisateur (rotation). Cette option n'est effective que lorsque la carte est une carte vectorielle. Si ce paramètre n'est pas défini dans le code, la configuration cloud de l'ID de carte est utilisée (si elle est disponible). | 
| internalUsageAttributionIds optional | Type :  Iterable<string> optionalPar défaut :  nullAjoute un ID d'attribution d'utilisation à l'initialiseur, ce qui aide Google à comprendre quelles bibliothèques et quels exemples sont utiles aux développeurs, comme l'utilisation d'une bibliothèque de regroupement de repères. Pour ne pas envoyer l'ID d'attribution de l'utilisation, vous pouvez supprimer cette propriété ou remplacer la valeur par une chaîne vide. Seules les valeurs uniques seront envoyées. Les modifications apportées à cette valeur après l'instanciation peuvent être ignorées. | 
| isFractionalZoomEnabled optional | Type :  boolean optionalPar défaut :  truepour les cartes vectorielles etfalsepour les cartes matriciellesIndique si la carte doit autoriser les niveaux de zoom fractionnaires. Écoutez  isfractionalzoomenabled_changedpour savoir quand la valeur par défaut a été définie. | 
| keyboardShortcuts optional | Type :  boolean optionalSi 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 optionalL'ID de carte de la carte. Ce paramètre ne peut pas être défini ni modifié une fois la carte instanciée.  Map.DEMO_MAP_IDpeut être utilisé pour tester des fonctionnalités qui nécessitent un ID de carte, mais pas l'activation du cloud. | 
| mapTypeControl optional | Type :  boolean optionalÉtat initial (activé/désactivé) de la commande de type de carte. | 
| mapTypeControlOptions optional | Type :  MapTypeControlOptions optionalOptions d'affichage initiales de la commande de type de carte. | 
| mapTypeId optional | Type :  MapTypeId|string optionalLe mapTypeId initial de la carte. La valeur par défaut est  ROADMAP. | 
| maxZoom optional | Type :  number optionalNiveau de zoom maximal qui s'affichera sur la carte. Si elle est omise ou définie sur  null, le niveau de zoom maximal du type de carte actuel est utilisé à la place. Les valeurs de zoom valides sont des nombres compris entre zéro et le niveau de zoom maximal autorisé. | 
| minZoom optional | Type :  number optionalNiveau de zoom minimal qui sera affiché sur la carte. Si cette valeur est omise ou définie sur  null, le niveau de zoom minimal du type de carte actuel est utilisé à la place. Les valeurs de zoom valides sont des nombres compris entre zéro et le niveau de zoom maximal autorisé. | 
| noClear optional | Type :  boolean optionalSi la valeur est  true, ne supprimez pas le contenu du div Map. | 
|  | Type :  boolean optionalÉtat activé/désactivé du contrôle du panoramique.  | 
|  | Type :  PanControlOptions optionalOptions d'affichage du contrôle du panoramique.  | 
| renderingType optional | Type :  RenderingType optionalPar défaut :  RenderingType.RASTERSi la carte doit être matricielle ou vectorielle. Ce paramètre ne peut pas être défini ni modifié une fois la carte instanciée. Si elle n'est pas définie, la configuration cloud de l'ID de carte déterminera le type de rendu (si disponible). Veuillez noter que les cartes vectorielles ne sont pas disponibles pour tous les appareils ni tous les navigateurs. La carte basculera vers une carte matricielle si nécessaire. | 
| restriction optional | Type :  MapRestriction optionalDéfinit une limite qui restreint la zone de la carte accessible aux utilisateurs. Lorsqu'elle est définie, un utilisateur ne peut effectuer un panoramique et un zoom que si la vue de la caméra reste dans les limites de la bordure. | 
| rotateControl optional | Type :  boolean optionalÉtat activé/désactivé du contrôle de la rotation. | 
| rotateControlOptions optional | Type :  RotateControlOptions optionalOptions d'affichage du contrôle de rotation. | 
| scaleControl optional | Type :  boolean optionalÉtat initial (activé/désactivé) de la commande d'échelle. | 
| scaleControlOptions optional | Type :  ScaleControlOptions optionalOptions d'affichage initiales du contrôle de la mise à l'échelle. | 
| scrollwheel optional | Type :  boolean optionalSi la valeur est  false, le zoom sur la carte à l'aide de la molette de la souris est désactivé. La molette de défilement est activée par défaut.Remarque : Cette propriété n'est pas recommandée. Pour désactiver le zoom avec la molette, vous pouvez utiliser la propriété  | 
| streetView optional | Type :  StreetViewPanorama optionalStreetViewPanoramaà afficher lorsque le Pegman Street View est déposé sur la carte. Si aucun panorama n'est spécifié, unStreetViewPanoramapar défaut s'affiche dans ledivde la carte lorsque le bonhomme Pegman est déposé. | 
| streetViewControl optional | Type :  boolean optionalÉtat initial (activé ou désactivé) de la commande Pegman Street View. Cette commande fait partie de l'UI par défaut et doit être définie sur  falselorsque vous affichez un type de carte sur lequel la superposition des routes Street View ne doit pas apparaître (par exemple, un type de carte autre que la carte de la Terre). | 
| streetViewControlOptions optional | Type :  StreetViewControlOptions optionalOptions d'affichage initiales de la commande Pegman Street View. | 
| styles optional | Type :  Array<MapTypeStyle> optionalStyles à appliquer à chacun des types de cartes par défaut. Notez que pour les modes  satellite/hybridetterrain, ces styles ne s'appliqueront qu'aux libellés et à la géométrie. Cette fonctionnalité n'est pas disponible lorsque vous utilisez un ID de carte ou des cartes vectorielles (utilisez plutôt les styles de cartes basés dans le cloud). | 
| tilt optional | Type :  number optionalPour 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  0et45. La valeur0permet à la carte d'utiliser systématiquement une vue aérienne à 0°, quels que soient le niveau de zoom et la fenêtre d'affichage. La valeur45permet à l'angle d'inclinaison de passer automatiquement à 45 lorsque des images à 45° sont disponibles pour le niveau de zoom et la fenêtre d'affichage actuels, et de revenir à 0 lorsque ces images ne sont pas disponibles (il s'agit du comportement par défaut). Les images à 45° ne sont disponibles que pour les types de cartesatelliteethybrid, dans certaines zones géographiques et à certains niveaux de zoom. Remarque :getTiltrenvoie l'angle d'inclinaison actuel, et non la valeur spécifiée par cette option. Étant donné quegetTiltet cette option font référence à des éléments différents, nebind()pas la propriététilt, car cela pourrait avoir des effets imprévisibles. | 
| tiltInteractionEnabled optional | Type :  boolean optionalPar défaut :  falseIndique si la carte doit autoriser le contrôle de l'inclinaison de la caméra par l'utilisateur. Cette option n'est effective que lorsque la carte est une carte vectorielle. Si ce paramètre n'est pas défini dans le code, la configuration cloud de l'ID de carte est utilisée (si elle est disponible). | 
| zoom optional | Type :  number optionalNiveau de zoom initial de la carte. Les valeurs de zoom valides sont des nombres compris entre zéro et le niveau de zoom maximal autorisé. 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 optionalOptions d'affichage de la commande de zoom. | 
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 et/ou caractéristiques de la carte qui doivent être affectés, et les stylers spécifient la façon dont ces éléments et caractéristiques doivent être modifiés. Pour en savoir plus, consultez la documentation de référence sur les styles.
| Propriétés | |
|---|---|
| stylers | Règles de style à appliquer aux éléments et aux caractéristiques de la carte sélectionnés. Les règles sont appliquées dans l'ordre que vous spécifiez 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 style doit être appliqué. Un élément est un aspect visuel d'une entité sur la carte. Par exemple, un libellé, une icône, le contour ou le remplissage appliqués à la géométrie, etc. Facultatif. Si  elementTypen'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 ou groupe d'éléments auquel un style doit être appliqué. Facultatif. Si  featureTypen'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é par différents événements de souris sur la carte et les calques, et contient tous les champs indiqués ci-dessous.
| Propriétés | |
|---|---|
| domEvent | Événement DOM natif correspondant. Les développeurs ne doivent pas se fier à la définition et à la cohérence des propriétés  target,currentTarget,relatedTargetetpath. Les développeurs ne doivent pas non plus s'appuyer sur la structure DOM de l'implémentation interne de l'API Maps. En raison du mappage interne des événements, ledomEventpeut avoir une sémantique différente de celle duMapMouseEvent(par exemple, un "clic"MapMouseEventpeut avoir undomEventde typeKeyboardEvent). | 
| latLng optional | Type :  LatLng optionalLatitude/longitude sous le curseur au moment de l'événement. | 
| Méthodes | |
|---|---|
| stop | stop()Paramètres : aucun Valeur renvoyée :  voidEmpêche cet événement de se propager davantage. | 
Interface IconMouseEvent
Interface google.maps.IconMouseEvent
Cet objet est envoyé dans un événement lorsqu'un utilisateur clique sur une icône sur la carte. L'ID du 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 lieux, consultez le guide du développeur de l'API Places.
Cette interface étend MapMouseEvent.
| Propriétés | |
|---|---|
| placeId optional | Type :  string optionalID du lieu sur lequel l'utilisateur a cliqué. Cet ID de lieu peut être utilisé pour obtenir plus d'informations sur la fonctionnalité sur laquelle l'utilisateur a cliqué.  Pour en savoir plus sur les ID de lieux, consultez le guide du développeur de l'API Places. | 
| Hérité : domEvent,latLng | |
| Méthodes | |
|---|---|
| Hérité : stop | 
Constantes ColorScheme
google.maps.ColorScheme
constantes
Identifiants des schémas de couleurs de la carte. Spécifiez-les par valeur ou en utilisant le nom de la constante. Par exemple, 'FOLLOW_SYSTEM' ou google.maps.ColorScheme.FOLLOW_SYSTEM.
Accédez-y en appelant le const {ColorScheme} = await google.maps.importLibrary("core"). 
 Consultez Bibliothèques de l'API Maps JavaScript.
| Constantes | |
|---|---|
| DARK | Jeu de couleurs sombres pour une carte. | 
| FOLLOW_SYSTEM | Le jeu de couleurs est sélectionné en fonction des préférences système, qui sont vérifiées une fois lors de l'exécution de la méthode. | 
| LIGHT | Jeu de couleurs claires pour une carte. Valeur par défaut pour l'ancienne Maps JS. | 
Constantes MapTypeId
google.maps.MapTypeId
constantes
Identifiants pour les 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-y en appelant le const {MapTypeId} = await google.maps.importLibrary("maps"). 
 Consultez Bibliothèques de l'API Maps JavaScript.
| Constantes | |
|---|---|
| HYBRID | Ce type de carte affiche un calque transparent des principales rues sur des images satellite. | 
| ROADMAP | Ce type de carte affiche une carte routière normale. | 
| SATELLITE | Ce type de carte affiche des images satellite. | 
| TERRAIN | Ce type de carte affiche des cartes avec des caractéristiques physiques telles que le relief et la végétation. | 
Classe MapTypeRegistry
Classe google.maps.MapTypeRegistry
Registre des instances MapType, indexées par ID MapType.
Cette classe étend MVCObject.
Accédez-y en appelant le const {MapTypeRegistry} = await google.maps.importLibrary("maps"). 
 Consultez Bibliothèques de l'API Maps JavaScript.
| Constructeur | |
|---|---|
| MapTypeRegistry | MapTypeRegistry()Paramètres : aucun MapTypeRegistrycontient la collection de types de cartes personnalisés disponibles pour la carte. L'API consulte ce registre lorsqu'elle fournit la liste des types de carte disponibles dans les commandes, par exemple. | 
| Méthodes | |
|---|---|
| set | set(id, mapType)Paramètres :  
 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 pouvant être appliquée à la carte. La fenêtre d'affichage de la carte ne dépassera pas ces restrictions.
| Propriétés | |
|---|---|
| latLngBounds | Type :  LatLngBounds|LatLngBoundsLiteralQuand ce paramètre est défini, un utilisateur ne peut faire un panoramique et un zoom qu'à l'intérieur des limites indiquées. Les limites peuvent restreindre la longitude et la latitude, ou uniquement la latitude. Pour les limites de latitude uniquement, utilisez les longitudes ouest et est de -180 et 180, respectivement. Par exemple,  latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}. | 
| strictBounds optional | Type :  boolean optionalLes limites peuvent être rendues plus restrictives en définissant le flag  strictBoundssurtrue. Cela réduit le niveau de zoom arrière d'un utilisateur, ce qui garantit que tout ce qui se trouve en dehors des limites restreintes reste masqué. La valeur par défaut estfalse, ce qui signifie qu'un utilisateur peut effectuer un zoom arrière jusqu'à ce que toute la zone délimitée soit visible, y compris les zones en dehors de la zone délimitée. | 
Classe TrafficLayer
Classe google.maps.TrafficLayer
Un calque de trafic.
Cette classe étend MVCObject.
Accédez-y en appelant le const {TrafficLayer} = await google.maps.importLibrary("maps"). 
 Consultez Bibliothèques de l'API Maps JavaScript.
| Constructeur | |
|---|---|
| TrafficLayer | TrafficLayer([opts])Paramètres :  
 Calque qui affiche le trafic routier actuel. | 
| Méthodes | |
|---|---|
| getMap | getMap()Paramètres : aucun Valeur renvoyée :  Map|nullRenvoie 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 sera 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.
| Propriétés | |
|---|---|
| autoRefresh optional | Type :  boolean optionalPar défaut :  trueIndique si la couche de trafic s'actualise automatiquement avec les informations mises à jour. | 
| map optional | Type :  Map optionalCarte 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-y en appelant le const {TransitLayer} = await google.maps.importLibrary("maps"). 
 Consultez Bibliothèques de l'API Maps JavaScript.
| Constructeur | |
|---|---|
| TransitLayer | TransitLayer()Paramètres : aucun Calque affichant les lignes de transport en commun. | 
| Méthodes | |
|---|---|
| getMap | getMap()Paramètres : aucun Valeur renvoyée :  Map|nullRenvoie la carte sur laquelle ce calque est affiché. | 
| setMap | setMap(map)Paramètres :  
 Valeur renvoyée :  voidAffiche le calque sur la carte spécifiée. Si la carte est définie sur  null, le calque sera supprimé. | 
| Hérité : addListener,bindTo,get,notify,set,setValues,unbind,unbindAll | |
Classe BicyclingLayer
Classe google.maps.BicyclingLayer
Calque montrant les pistes et bandes cyclables.
Cette classe étend MVCObject.
Accédez-y en appelant le const {BicyclingLayer} = await google.maps.importLibrary("maps"). 
 Consultez Bibliothèques de l'API Maps JavaScript.
| Constructeur | |
|---|---|
| BicyclingLayer | BicyclingLayer()Paramètres : aucun Calque qui affiche les pistes cyclables et les sentiers, et qui rétrograde les grandes routes. | 
| Méthodes | |
|---|---|
| getMap | getMap()Paramètres : aucun Valeur renvoyée :  Map|nullRenvoie la carte sur laquelle ce calque est affiché. | 
| setMap | setMap(map)Paramètres :  
 Valeur renvoyée :  voidAffiche le calque sur la carte spécifiée. Si la carte est définie sur  null, le calque sera supprimé. | 
| Hérité : addListener,bindTo,get,notify,set,setValues,unbind,unbindAll | |
Interface CameraOptions
Interface google.maps.CameraOptions
Utilisé pour définir les options de caméra de la carte.
| Propriétés | |
|---|---|
| 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 correspond à la région visible de la carte. Sur une carte vectorielle inclinée, ce polygone peut être un trapèze au lieu d'un rectangle.
| Propriétés | |
|---|---|
| farLeft | Type :  LatLng | 
| farRight | Type :  LatLng | 
| latLngBounds | Type :  LatLngBoundsLe plus petit cadre de délimitation qui comprend la région visible. | 
| nearLeft | Type :  LatLng | 
| nearRight | Type :  LatLng | 
Constantes RenderingType
google.maps.RenderingType
constantes
Accédez-y en appelant le const {RenderingType} = await google.maps.importLibrary("maps"). 
 Consultez Bibliothèques de l'API Maps JavaScript.
| Constantes | |
|---|---|
| RASTER | Indique que la carte est une carte matricielle. | 
| UNINITIALIZED | Indique qu'on ne sait pas encore si la carte est vectorielle ou matricielle, car elle n'a pas encore fini de s'initialiser. | 
| VECTOR | Indique que la carte est une carte vectorielle. | 
Interface MapCapabilities
Interface google.maps.MapCapabilities
Objet contenant un instantané des fonctionnalités actuellement disponibles pour la carte. Notez que cela ne signifie pas nécessairement que les modules concernés sont chargés ou initialisés, mais plutôt que la carte actuelle est autorisée à utiliser ces API. Consultez les propriétés pour obtenir la liste des fonctionnalités possibles.
| Propriétés | |
|---|---|
| isAdvancedMarkersAvailable optional | Type :  boolean optionalSi la valeur est "true", cela signifie que la carte est correctement configurée pour permettre l'utilisation de repères avancés. Notez que vous devez toujours importer la bibliothèque  markerpour utiliser les repères avancés. Pour en savoir plus, consultez https://goo.gle/gmp-isAdvancedMarkersAvailable. | 
| isDataDrivenStylingAvailable optional | Type :  boolean optionalSi la valeur est "true", cela signifie que cette carte est correctement configurée pour permettre l'utilisation d'un style basé sur les données pour au moins un FeatureLayer. Pour en savoir plus, consultez https://goo.gle/gmp-data-driven-styling et https://goo.gle/gmp-FeatureLayerIsAvailable. | 
| isWebGLOverlayViewAvailable optional | Type :  boolean optionalSi la valeur est "true", cette carte est configurée correctement pour permettre l'utilisation de  WebGLOverlayView. |