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.
Constructeur | |
---|---|
Map |
Map(mapDiv[, opts]) Paramètres:
Crée une nouvelle carte à l'intérieur du conteneur HTML, qui est généralement un élément DIV . |
Propriétés | |
---|---|
controls |
Type:
Array<MVCArray<HTMLElement>> 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 |
Type:
MapTypeRegistry Registre d'instances MapType par ID de chaîne. |
overlayMapTypes |
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). |
Méthodes | |
---|---|
fitBounds |
fitBounds(bounds[, padding]) Paramètres:
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 |
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. |
|
getDatasetFeatureLayer(datasetId) Paramètres:
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:
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:
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:
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:
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:
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:
Valeur renvoyée:aucune
Définit le zoom de la carte. |
Hérité:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Constantes | |
---|---|
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). |
É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" 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 se déclenchera aussi 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. |
|
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.
Propriétés | |
---|---|
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é |
|
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 |
Type:
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:
|
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 matriciellesIndique 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é |
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 |
Type:
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.
Propriétés | |
---|---|
center |
Type:
LatLng|LatLngLiteral optional Attribut HTML:
|
innerMap |
Type:
Map Référence au Map que MapElement utilise en interne. |
mapId |
Type:
string optional Attribut HTML:
|
zoom |
Type:
number optional Attribut HTML:
|
Méthodes | |
---|---|
|
addEventListener(type, listener[, options]) Paramètres:
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 |
|
removeEventListener(type, listener[, options]) Paramètres:
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.
Propriétés | |
---|---|
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.
Propriétés | |
---|---|
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.
Propriétés | |
---|---|
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. |
Méthodes | |
---|---|
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
.
Propriétés | |
---|---|
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
|
Méthodes | |
---|---|
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. Exemples : '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.
Constantes | |
---|---|
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.
Constructeur | |
---|---|
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. |
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 qui peut être appliquée à la carte. La fenêtre d'affichage de la carte ne dépasse pas ces restrictions.
Propriétés | |
---|---|
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.
Constructeur | |
---|---|
TrafficLayer |
TrafficLayer([opts]) Paramètres:
Calque qui affiche le trafic actuel. |
Méthodes | |
---|---|
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.
Propriétés | |
---|---|
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.
Constructeur | |
---|---|
TransitLayer |
TransitLayer() Paramètres:aucun
Calque affichant les lignes de transports en commun. |
Méthodes | |
---|---|
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.
Constructeur | |
---|---|
BicyclingLayer |
BicyclingLayer() Paramètres:aucun
Calque qui affiche les pistes cyclables et les routes rétrogradées |
Méthodes | |
---|---|
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.
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 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.
Propriétés | |
---|---|
farLeft |
Type:
LatLng |
farRight |
Type:
LatLng |
latLngBounds |
Type:
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.
Constantes | |
---|---|
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. Consultez les propriétés pour connaître la liste des fonctionnalités possibles.
Propriétés | |
---|---|
isAdvancedMarkersAvailable optional |
Type:
boolean optional |
isDataDrivenStylingAvailable optional |
Type:
boolean optional |