Plan cours
Classe google.maps.Map
Cette classe étend
MVCObject
Accès 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 carte à l'intérieur du conteneur HTML donné, qui est généralement un élément DIV . |
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. Il ne peut pas être utilisé pour les fonctionnalités qui nécessitent une configuration cloud (comme les styles dans le cloud). |
Propriétés | |
---|---|
controls |
Type:
Array<MVCArray<HTMLElement>> Commandes supplémentaires à associer à la carte. Pour ajouter une commande à la carte, ajoutez son <div> au MVCArray correspondant au ControlPosition où elle doit être affichée. |
data |
Type:
Data Instance de Data , liée à la carte. Ajoutez des éléments géographiques à cet objet Data pour les afficher facilement sur cette carte. |
mapTypes |
Type:
MapTypeRegistry Registre de MapType instances par ID de chaîne. |
overlayMapTypes |
Types de carte supplémentaires à superposer. Les types de carte de superposition s'affichent au-dessus de 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 ayant des valeurs d'index inférieures). |
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 spécifiées. Remarque:Lorsque la carte est définie sur display: none , la fonction fitBounds lit la taille de la carte en tant que 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 le tag div de la carte a une taille réelle. Pour les cartes vectorielles, cette méthode définit l'inclinaison et l'orientation de la carte sur leurs valeurs zéro par défaut. L'appel de cette méthode peut générer une animation fluide, car la carte se déplace et zoome pour respecter les limites. L'animation de cette méthode dépend ou non 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.Affiche les limites de latitude/longitude de la fenêtre d'affichage actuelle. Si plusieurs copies du monde sont visibles, les limites sont comprises 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 dont l'inclinaison ou l'orientation est différente de zéro, les limites de latitude/longitude renvoyées représentent le plus petit cadre de délimitation incluant la zone visible de la fenêtre d'affichage de la carte. Consultez MapCanvasProjection.getVisibleRegion pour obtenir la zone 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|undefined Affiche la cliquabilité des icônes de la 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 la valeur FeatureLayer pour le datasetId spécifié. Les ID d'ensembles 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 de la carte ou si le style basé sur les données n'est pas disponible (pas d'ID de carte, de tuiles vectorielles, de calques d'éléments géographiques avec style basé sur les données ni d'ensembles de données configurés dans le style de carte), une erreur est générée et le FeatureLayer.isAvailable qui en résulte 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 de l'élément FeatureType spécifique. Vous devez activer un FeatureLayer dans la console Google Cloud. 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 (pas d'ID de carte, de tuiles vectorielles, ni de FeatureLayer activé dans le style de carte), une erreur est enregistrée et la valeur FeatureLayer.isAvailable obtenue est "false". |
getHeading |
getHeading() Paramètres:aucun
Valeur renvoyée:
number|undefined Affiche l'orientation de la boussole sur la carte. La valeur de cap est mesurée en degrés (dans le sens des aiguilles d'une montre) à partir du nord. Si la carte n'est pas encore initialisée, le résultat est undefined . |
getHeadingInteractionEnabled |
getHeadingInteractionEnabled() Paramètres:aucun
Valeur renvoyée:
boolean|null Indique si les interactions avec les titres sont activées. Cette option n'est disponible que lorsque la carte est une carte vectorielle. Si elle n'est pas définie dans le code, la configuration cloud de l'ID de carte sera utilisée (si elle est disponible). |
getMapCapabilities |
getMapCapabilities() Paramètres:aucun
Valeur renvoyée:
MapCapabilities Informe 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|undefined Renvoie la valeur Projection actuelle. 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 n'est pas undefined . |
getRenderingType |
getRenderingType() Paramètres:aucun
Valeur renvoyée:
RenderingType Renvoie le RenderingType 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 à la streetViewControl de la carte se refléteront dans l'affichage de ce panorama lié. |
getTilt |
getTilt() Paramètres:aucun
Valeur renvoyée:
number|undefined Renvoie 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 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 . |
getTiltInteractionEnabled |
getTiltInteractionEnabled() Paramètres:aucun
Valeur renvoyée:
boolean|null Indique si les interactions avec inclinaison sont activées. Cette option n'est disponible que lorsque la carte est une carte vectorielle. Si elle n'est pas définie dans le code, la configuration cloud de l'ID de carte sera utilisée (si elle est disponible). |
getZoom |
getZoom() Paramètres:aucun
Valeur renvoyée:
number|undefined Renvoie 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 la caméra de la carte sur les options de la caméra cible, sans animation. |
panBy |
panBy(x, y) Paramètres:
Valeur renvoyée:aucune
Modifie le centre de la carte selon 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 façon 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
Définit le centre de la carte sur le LatLng donné. Si la modification est inférieure à la largeur et à la hauteur de la carte, la transition sera animée de façon fluide. |
panToBounds |
panToBounds(latLngBounds[, padding]) Paramètres:
Valeur renvoyée:aucune
Déplace la carte selon la quantité minimale nécessaire pour contenir la LatLngBounds donnée. Cela ne garantit pas l'emplacement des limites sur la carte, si ce n'est que la carte sera affichée en mode panoramique afin d'afficher autant de limites que possible dans {currentMapSizeInPx} - {padding} . Pour les cartes matricielles et vectorielles, le zoom, l'inclinaison et l'orientation 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 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 la valeur false à cette méthode. |
setHeading |
setHeading(heading) Paramètres:
Valeur renvoyée:aucune
Définit l'orientation de la boussole de la carte, mesurée en degrés à partir du nord cardinal. Pour les cartes matricielles, cette méthode ne s'applique qu'aux images aériennes. |
setHeadingInteractionEnabled |
setHeadingInteractionEnabled(headingInteractionEnabled) Paramètres:
Valeur renvoyée:aucune
Détermine si les interactions avec les titres sont activées. Cette option n'est disponible que lorsque la carte est une carte vectorielle. Si elle n'est pas définie dans le code, la configuration cloud de l'ID de carte sera 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
Lie un StreetViewPanorama à la carte. Ce panorama remplace la StreetViewPanorama par défaut, ce qui permet à la carte de s'associer à un panorama externe situé 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:
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, cette option permet de contrôler le changement automatique de mode pour l'angle d'incidence de la carte. Les seules valeurs autorisées sont 0 et 45 . Avec setTilt(0) , la carte utilise toujours une vue aérienne à 0°, quels que soient le niveau de zoom et la fenêtre d'affichage. Avec setTilt(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 chaque fois 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 , pour certains lieux 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 choses différentes, ne définissez pas bind() la propriété tilt . cela peut entraîner des effets imprévisibles. |
setTiltInteractionEnabled |
setTiltInteractionEnabled(tiltInteractionEnabled) Paramètres:
Valeur renvoyée:aucune
Détermine si les interactions avec inclinaison sont activées. Cette option n'est disponible que lorsque la carte est une carte vectorielle. Si elle n'est pas définie dans le code, la configuration cloud de l'ID de carte sera utilisée (si elle est disponible). |
setZoom |
setZoom(zoom) Paramètres:
Valeur renvoyée:aucune
Définit le niveau de 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 sont modifiées. |
center_changed |
function() Arguments:aucun
Cet événement est déclenché lorsque la propriété centrale de la carte est modifiée. |
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 le lieu sur lequel l'utilisateur a cliqué est renvoyé, sauf si l'utilisateur a cliqué sur une icône de lieu. Dans ce cas, un événement IconMouseEvent avec un identifiant de lieu est renvoyé. IconMouseEvent et MapMouseEvent sont identiques, sauf que IconMouseEvent comporte un champ d'identifiant de lieu. L'événement peut toujours être traité comme un MapMouseEvent lorsque l'identifiant de 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 se déclenche lorsque l'événement de menu contextuel DOM 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 parfois une ou deux fois, juste avant celui-ci. |
drag |
function() Arguments:aucun
Cet événement est déclenché plusieurs fois lorsque l'utilisateur fait glisser la carte. |
dragend |
function() Arguments:aucun
Cet événement est déclenché lorsque l'utilisateur cesse 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 est modifiée. |
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 été modifiée. |
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 est modifiée. |
mousemove |
function(event) Arguments:
Cet événement est déclenché lorsque le curseur de 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 le curseur de 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 est modifiée. |
renderingtype_changed |
function() Arguments:aucun
Cet événement est déclenché lorsque le type de rendu change. |
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 est modifiée. |
zoom_changed |
function() Arguments:aucun
Cet événement est déclenché lorsque la propriété de zoom sur la carte est modifiée. |
|
function(event) Arguments:
Cet événement est déclenché lorsque l'utilisateur effectue un clic droit sur la carte. |
MapOptions de commande
google.maps.MapOptions
de commande
MapOptions utilisé pour définir les propriétés pouvant être définies sur un Map.
Propriétés | |
---|---|
backgroundColor optional |
Type:
string optional Couleur utilisée pour l'arrière-plan du div "Map". Cette couleur est visible lorsque les tuiles n'ont pas encore été chargées lorsque l'utilisateur fait défiler la page. Cette option ne peut être définie que lorsque la carte est initialisée. |
center optional |
Type:
LatLng|LatLngLiteral optional Centre de la carte initial |
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. |
|
Type:
ColorScheme|string optional Par défaut:
ColorScheme.LIGHT Jeu de couleurs initial de la carte. Cette option ne peut être définie que lorsque la carte est initialisée. |
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 modifiez cette valeur ultérieurement, les commandes pourront passer à l'état undefined . Ne régit que les commandes effectuées par l'API Google Maps elle-même. N'effectue pas de scaling des commandes personnalisées créées par le développeur. |
disableDefaultUI optional |
Type:
boolean optional Active/Désactive tous les boutons de l'interface utilisateur par défaut. Peut être remplacé 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 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 par double-clic, vous pouvez utiliser la propriété |
|
Type:
boolean optional Si 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 optional Nom ou URL du curseur à afficher lorsque vous passez 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 |
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 Direction de l'imagerie aérienne en degrés mesurés dans le sens des aiguilles d'une montre à partir du sens cardinal du nord. Les en-têtes sont alignés sur l'angle disponible le plus proche pour lequel les images sont disponibles. |
headingInteractionEnabled optional |
Type:
boolean optional Par défaut:
false Indique si la carte doit permettre à l'utilisateur de contrôler l'orientation de la caméra (rotation). Cette option n'est disponible que lorsque la carte est une carte vectorielle. Si elle n'est pas définie dans le code, la configuration cloud de l'ID de carte sera utilisée (si elle est disponible). |
isFractionalZoomEnabled optional |
Type:
boolean optional Par défaut:
true pour les cartes vectorielles et false pour les cartes matriciellesIndique 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 false , empêche la carte d'être contrôlée par le clavier. Les raccourcis clavier sont activés par défaut. |
mapId optional |
Type:
string optional ID de carte de la carte. Ce paramètre ne peut pas être défini ni modifié après l'instanciation d'une carte. Map.DEMO_MAP_ID permet de tester des fonctionnalités qui nécessitent un ID de carte, mais qui ne nécessitent pas d'activation du cloud. |
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 initial de la commande de type de carte. |
mapTypeId optional |
Type:
MapTypeId|string optional MapTypeId initial. La valeur par défaut est ROADMAP . |
maxZoom optional |
Type:
number optional Niveau de zoom maximal affiché sur la carte. S'il est omis ou défini sur null , le 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 accepté. |
minZoom optional |
Type:
number optional Niveau de zoom minimal affiché sur la carte. S'il est omis ou défini sur null , le 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 accepté. |
noClear optional |
Type:
boolean optional Si la valeur est true , n'effacez pas le contenu de l'élément div "Map". |
|
Type:
boolean optional État activé/désactivé de la commande Panoramique. |
|
Type:
PanControlOptions optional Options d'affichage de la commande Panoramique. |
renderingType optional |
Type:
RenderingType optional Par défaut:
RenderingType.RASTER Indique si la carte doit être matricielle ou vectorielle. Ce paramètre ne peut pas être défini ni modifié après l'instanciation d'une carte. Si cette règle n'est pas configurée, la configuration cloud de l'ID de carte détermine le type de rendu (le cas échéant). Sachez qu'il est possible que les cartes vectorielles ne soient pas disponibles sur tous les appareils et navigateurs. La carte s'affichera alors sous forme de carte matricielle si nécessaire. |
restriction optional |
Type:
MapRestriction optional Définit une limite limitant la zone de la carte accessible aux utilisateurs. Lorsque cette option est définie, l'utilisateur ne peut effectuer qu'un panoramique et un zoom pendant que 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é du contrôle du scaling. |
scaleControlOptions optional |
Type:
ScaleControlOptions optional Options d'affichage initial de la commande de mise à l'é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 StreetViewPanorama à afficher lorsque Pegman de Street View est déposé 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 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 lors de l'affichage d'un type de carte sur lequel la superposition de routes Street View ne doit pas apparaître (par exemple, un type de carte autre que Google Earth). |
streetViewControlOptions optional |
Type:
StreetViewControlOptions optional Options d'affichage initiale de la commande Pegman de 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. 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 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, cette option permet de contrôler le changement automatique de l'angle d'incidence de la carte. Les seules valeurs autorisées sont 0 et 45 . Si vous définissez la valeur 0 , la carte utilise toujours une vue aérienne à 0°, quels que soient le niveau de zoom et la fenêtre d'affichage. Si vous définissez 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 chaque fois 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 , pour certains lieux 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 choses différentes, n'utilisez pas bind() pour la propriété tilt . cela peut entraîner des effets imprévisibles. |
tiltInteractionEnabled optional |
Type:
boolean optional Par défaut:
false Indique si la carte doit permettre à l'utilisateur de contrôler l'inclinaison de la caméra. Cette option n'est disponible que lorsque la carte est une carte vectorielle. Si elle n'est pas définie dans le code, la configuration cloud de l'ID de carte sera utilisée (si elle est disponible). |
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é. 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. |
MapElement cours
Classe google.maps.MapElement
MapElement est une sous-classe HTMLElement
permettant d'afficher 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">
<button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>
En interne, il utilise
Map
, qui est accessible avec la propriété innerMap
.
Élément personnalisé:
<gmp-map center="lat,lng" heading-interaction-disabled map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>
Cette classe étend
HTMLElement
Cette classe implémente
MapElementOptions
Accès en appelant const {MapElement} = await google.maps.importLibrary("maps")
Consultez Bibliothèques dans l'API Maps JavaScript.
Constructeur | |
---|---|
MapElement |
MapElement([options]) Paramètres:
|
Propriétés | |
---|---|
center |
Type:
LatLng|LatLngLiteral optional Latitude/longitude centrale de la carte
Attribut HTML:
|
headingInteractionDisabled |
Type:
boolean optional Par défaut:
false Indique si la carte doit permettre à l'utilisateur de contrôler l'orientation de la caméra (rotation). Cette option n'est disponible que lorsque la carte est une carte vectorielle. Si elle n'est pas définie dans le code, la configuration cloud de l'ID de carte sera utilisée (si elle est disponible).
Attribut HTML:
|
innerMap |
Type:
Map Référence au Map utilisé par l'élément MapElement en interne. |
mapId |
Type:
string optional ID de carte de la carte. Ce paramètre ne peut pas être défini ni modifié après l'instanciation d'une carte.
Map.DEMO_MAP_ID permet de tester des fonctionnalités qui nécessitent un ID de carte, mais qui ne nécessitent pas d'activation du cloud.Attribut HTML:
|
renderingType |
Type:
RenderingType optional Par défaut:
RenderingType.VECTOR Indique si la carte doit être matricielle ou vectorielle. Ce paramètre ne peut pas être défini ni modifié après l'instanciation d'une carte. Si cette règle n'est pas configurée, la configuration cloud de l'ID de carte détermine le type de rendu (le cas échéant). Sachez qu'il est possible que les cartes vectorielles ne soient pas disponibles sur tous les appareils et navigateurs. La carte s'affichera alors sous forme de carte matricielle si nécessaire.
Attribut HTML:
|
tiltInteractionDisabled |
Type:
boolean optional Par défaut:
false Indique si la carte doit permettre à l'utilisateur de contrôler l'inclinaison de la caméra. Cette option n'est disponible que lorsque la carte est une carte vectorielle. Si elle n'est pas définie dans le code, la configuration cloud de l'ID de carte sera utilisée (si elle est disponible).
Attribut HTML:
|
zoom |
Type:
number optional Niveau de zoom de la carte. Les valeurs de zoom valides sont des nombres compris entre zéro et le niveau de zoom maximal accepté. Plus la valeur de zoom est élevée, plus la résolution est élevée.
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é à la cible. Voir addEventListener |
|
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 addEventListener. Voir removeEventListener |
Événements | |
---|---|
gmp-zoomchange |
function(event) Arguments:
Cet événement est déclenché lorsque la propriété de zoom sur la carte est modifiée. |
MapElementOptions de commande
google.maps.MapElementOptions
de commande
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 optional Consultez les MapElement.center . |
headingInteractionDisabled optional |
Type:
boolean optional Consultez les MapElement.headingInteractionDisabled . |
mapId optional |
Type:
string optional Consultez les MapElement.mapId . |
renderingType optional |
Type:
RenderingType optional Consultez les MapElement.renderingType . |
tiltInteractionDisabled optional |
Type:
boolean optional Consultez les MapElement.tiltInteractionDisabled . |
zoom optional |
Type:
number optional Consultez les MapElement.zoom . |
ZoomChangeEvent cours
Classe google.maps.ZoomChangeEvent
Cet événement est créé à partir de la surveillance des changements de zoom.
Cette classe étend
Event
Accès en appelant const {ZoomChangeEvent} = await google.maps.importLibrary("maps")
Consultez Bibliothèques dans l'API Maps JavaScript.
MapTypeStyle de commande
google.maps.MapTypeStyle
de commande
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 cartographiques et/ou les éléments qui doivent être affectés, et les stylers indiquent comment ces éléments et é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 cartographiques sélectionnés. Les règles sont appliquées dans l'ordre que vous spécifiez dans ce tableau. Pour obtenir des consignes d'utilisation et des 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é à la géométrie, et plus encore. 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 ou groupe d'éléments géographiques 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. |
MapMouseEvent de commande
google.maps.MapMouseEvent
de commande
Cet objet est renvoyé par divers événements de souris sur la carte et les superpositions, et contient tous les champs affichés ci-dessous.
Propriétés | |
---|---|
domEvent |
Événement DOM natif correspondant Les développeurs ne doivent pas compter sur la définition et la cohérence des propriétés target , currentTarget , relatedTarget et path . Les développeurs ne doivent pas non plus se fier à la structure DOM de l'implémentation interne de l'API Google Maps. En raison de la mise en correspondance des événements internes, domEvent peut avoir une sémantique différente de MapMouseEvent (par exemple, un "clic" MapMouseEvent peut avoir un domEvent de type KeyboardEvent ). |
latLng optional |
Type:
LatLng optional Latitude/Longitude qui se trouvaient sous le curseur lorsque l'événement s'est produit. |
Méthodes | |
---|---|
stop |
stop() Paramètres:aucun
Valeur renvoyée:
void Empêche la propagation de cet événement. |
IconMouseEvent de commande
google.maps.IconMouseEvent
de commande
Cet objet est envoyé dans un événement lorsqu'un utilisateur clique sur une icône de la carte. L'ID 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 afin d'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
Propriétés | |
---|---|
placeId optional |
Type:
string optional ID du lieu ayant fait l'objet du clic. 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
|
Méthodes | |
---|---|
Hérité:
stop
|
ColorScheme constantes
google.maps.ColorScheme
constantes
Identifiants des jeux de couleurs de la carte. Spécifiez-les par valeur ou à l'aide du nom de la constante. Par exemple, 'FOLLOW_SYSTEM'
ou google.maps.ColorScheme.FOLLOW_SYSTEM
.
Accès en appelant const {ColorScheme} = await google.maps.importLibrary("core")
Consultez Bibliothèques dans l'API Maps JavaScript.
Constantes | |
---|---|
DARK |
Jeu de couleurs sombres d'une carte. |
FOLLOW_SYSTEM |
Le jeu de couleurs est sélectionné en fonction des préférences du système. |
LIGHT |
Jeu de couleurs claires d'une carte. Valeur par défaut pour l'ancienne version de Maps JS. |
MapTypeId constantes
google.maps.MapTypeId
constantes
Identifiants des MapTypes courants. Spécifiez-les par valeur ou à l'aide du nom de la constante. Par exemple, 'satellite'
ou google.maps.MapTypeId.SATELLITE
.
Accès 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 rues principales sur des images satellite. |
ROADMAP |
Ce type de carte affiche un plan de rue normal. |
SATELLITE |
Ce type de carte affiche des images satellite. |
TERRAIN |
Ce type de carte affiche des cartes avec des caractéristiques physiques, comme le relief et la végétation. |
MapTypeRegistry cours
Classe google.maps.MapTypeRegistry
Registre pour les instances MapType, associées à un ID MapType.
Cette classe étend
MVCObject
Accès en appelant const {MapTypeRegistry} = await google.maps.importLibrary("maps")
Consultez Bibliothèques dans l'API Maps JavaScript.
Constructeur | |
---|---|
MapTypeRegistry |
MapTypeRegistry() Paramètres:aucun
Le MapTypeRegistry contient l'ensemble des types de carte personnalisés disponibles pour la carte. Par exemple, l'API consulte ce registre pour fournir la liste des types de carte disponibles dans les commandes. |
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
|
MapRestriction de commande
google.maps.MapRestriction
de commande
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 |
Lorsque cette option est définie, l'utilisateur ne peut effectuer un panoramique et un zoom qu'à l'intérieur des limites données. Les limites peuvent restreindre à la fois la longitude et la latitude, ou seulement la latitude. Pour les limites basées uniquement sur la latitude, utilisez des longitudes ouest et est respectivement de -180 et 180. Par exemple, latLngBounds: {north: northLat, south: southLat, west: -180, east: 180} . |
strictBounds optional |
Type:
boolean optional Vous pouvez restreindre les limites en définissant l'option strictBounds sur true . Cela réduit le niveau de zoom arrière qu'un utilisateur peut effectuer, garantissant ainsi que tout ce qui se trouve en dehors des limites de restriction est masqué. 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 délimitée soit visible, y compris des zones situées en dehors de celle-ci. |
TrafficLayer cours
Classe google.maps.TrafficLayer
Un calque de trafic
Cette classe étend
MVCObject
Accès 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 routier 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 sera supprimé. |
setOptions |
setOptions(options) Paramètres:
Valeur renvoyée:aucune
|
Hérité:
addListener ,
bindTo ,
get
notify
set ,
setValues ,
unbind ,
unbindAll
|
TrafficLayerOptions de commande
google.maps.TrafficLayerOptions
de commande
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 est actualisé automatiquement avec les informations mises à jour. |
map optional |
Type:
Map optional Carte sur laquelle afficher le calque de trafic. |
TransitLayer cours
Classe google.maps.TransitLayer
Une couche de transports en commun.
Cette classe étend
MVCObject
Accès en appelant const {TransitLayer} = await google.maps.importLibrary("maps")
Consultez Bibliothèques dans l'API Maps JavaScript.
Constructeur | |
---|---|
TransitLayer |
TransitLayer() Paramètres:aucun
Calque qui affiche 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 sera supprimé. |
Hérité:
addListener ,
bindTo ,
get
notify
set ,
setValues ,
unbind ,
unbindAll
|
BicyclingLayer cours
Classe google.maps.BicyclingLayer
Calque montrant les bandes cyclables et les chemins
Cette classe étend
MVCObject
Accès 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 bandes cyclables et les chemins, et rétrograde les grandes routes. |
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 sera supprimé. |
Hérité:
addListener ,
bindTo ,
get
notify
set ,
setValues ,
unbind ,
unbindAll
|
CameraOptions de commande
google.maps.CameraOptions
de commande
Permet de définir les options de la 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 |
VisibleRegion de commande
google.maps.VisibleRegion
de commande
Contient les quatre points qui définissent le polygone à quatre côtés qui correspond à la région visible de la carte. Sur une carte vectorielle, ce polygone peut être un trapèze au lieu d'un rectangle, lorsqu'une carte vectorielle est inclinée.
Propriétés | |
---|---|
farLeft |
Type:
LatLng |
farRight |
Type:
LatLng |
latLngBounds |
Type:
LatLngBounds Plus petit cadre de délimitation incluant la région visible. |
nearLeft |
Type:
LatLng |
nearRight |
Type:
LatLng |
RenderingType constantes
google.maps.RenderingType
constantes
Accès en appelant const {RenderingType} = await google.maps.importLibrary("maps")
Consultez Bibliothèques dans l'API Maps JavaScript.
Constantes | |
---|---|
RASTER |
Indique que la carte est 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 une carte vectorielle. |
MapCapabilities de commande
google.maps.MapCapabilities
de commande
Objet contenant un instantané des fonctionnalités actuellement disponibles pour la carte. Notez que cela ne signifie pas nécessairement que les modules pertinents sont chargés ou initialisés, mais que la carte actuelle est autorisée à utiliser ces API. Consultez les propriétés pour voir la liste des capacités possibles.
Propriétés | |
---|---|
isAdvancedMarkersAvailable optional |
Type:
boolean optional Si la valeur est "true", la carte est correctement configurée pour permettre l'utilisation des repères avancés. Notez que vous devez quand même importer la bibliothèque marker pour utiliser les repères avancés. Pour en savoir plus, consultez la page https://goo.gle/gmp-isAdvancedMarkersAvailable. |
isDataDrivenStylingAvailable optional |
Type:
boolean optional Si la valeur est "true", cette carte est correctement configurée pour permettre l'utilisation du style basé sur les données pour au moins un FeatureLayer. Pour en savoir plus, consultez les pages https://goo.gle/gmp-data-driven-styling et https://goo.gle/gmp-FeatureLayerIsAvailable. |
isWebGLOverlayViewAvailable optional |
Type:
boolean optional Si la valeur est "true", cette carte est correctement configurée pour permettre l'utilisation de WebGLOverlayView . |