Image overlays

Interface MapType

interface google.maps.MapType
implémentée par ImageMapType, StyledMapType

Cette interface définit le type de carte et est généralement utilisée pour les types de cartes personnalisés. Immuable.
maxZoom
Type : number
Niveau de zoom maximal de la carte lors de l'affichage de ce MapType. Obligatoire pour les MapTypes de base, ignoré pour les MapTypes de superposition.
minZoom
Type : number
Niveau de zoom minimal de la carte lors de l'affichage de ce MapType. Facultatif. La valeur par défaut est 0.
radius
Type : number
Rayon de la planète pour la carte, en mètres. Facultatif. La valeur par défaut est le rayon équatorial de la Terre, soit 6 378 137 mètres.
alt
facultatif
Type : string optional
Texte alternatif à afficher lorsque l'utilisateur pointe sur le bouton de ce MapType dans le MapTypeControl. Facultatif.
name
facultatif
Type : string optional
Nom à afficher dans le MapTypeControl. Facultatif.
projection
facultatif
Type : Projection optional
Projection utilisée pour afficher ce MapType. Facultatif. La valeur par défaut est "Mercator".
tileSize
facultatif
Type : Size optional
Dimensions de chaque tuile. Obligatoire.
getTile
getTile(tileCoord, zoom, ownerDocument)
Paramètres :
  • tileCoord: Point : coordonnées de la tuile.
  • zoom: number Zoom sur la tuile.
  • ownerDocument: Document : document auquel appartient cette tuile.
Valeur renvoyée : Element|null Tuile obtenue.
Renvoie une tuile pour les coordonnées de tuile (x, y) et le niveau de zoom donnés. Cette tuile sera ajoutée au document ownerDocument donné. Non disponible pour les types de carte de base.
releaseTile
releaseTile(tile)
Paramètres :
  • tile: Element optional Relâchez pour voir l'extrait.
Valeur renvoyée : void
Libère la tuile donnée, en effectuant tout nettoyage nécessaire. La tuile fournie aura déjà été supprimée du document. Facultatif.

Interface de projection

interface google.maps.Projection

Interface de projection.
fromLatLngToPoint
fromLatLngToPoint(latLng[, point])
Paramètres :
Valeur renvoyée : Point|null
Traduit du cylindre LatLng vers le plan Point. Cette interface spécifie une fonction qui implémente la traduction des valeurs LatLng données en coordonnées mondiales sur la projection de la carte. L'API Google Maps appelle cette méthode lorsqu'elle doit tracer des emplacements à l'écran. Les objets Projection doivent implémenter cette méthode, mais peuvent renvoyer null si la projection ne peut pas calculer le Point.
fromPointToLatLng
fromPointToLatLng(pixel[, noClampNoWrap])
Paramètres :
  • pixel: Point
  • noClampNoWrap: boolean optional
Valeur renvoyée : LatLng|null
Cette interface spécifie une fonction qui implémente la traduction des coordonnées mondiales d'une projection de carte en valeurs LatLng. L'API Maps appelle cette méthode lorsqu'elle doit traduire des actions à l'écran en positions sur la carte. Les objets Projection doivent implémenter cette méthode, mais peuvent renvoyer null si la projection ne peut pas calculer le LatLng.

Classe ImageMapType

class google.maps.ImageMapType extends MVCObject implements MapType
library "maps"

Cette classe implémente l'interface MapType et est fournie pour l'affichage des tuiles d'image.

const {ImageMapType} = await google.maps.importLibrary("maps");
ImageMapType
ImageMapType(opts)
Paramètres :
Construit un ImageMapType à l'aide des ImageMapTypeOptions fournies.
alt
Type : string optional
maxZoom
Type : number
minZoom
Type : number
name
Type : string optional
projection
Type : Projection optional
radius
Type : number
tileSize
Type : Size optional
getOpacity
getOpacity()
Paramètres : aucun
Valeur renvoyée : number opacity L'opacité actuelle.
Renvoie le niveau d'opacité (0 (transparent) à 1.0) des tuiles ImageMapType.
getTile
getTile(tileCoord, zoom, ownerDocument)
Paramètres :
  • tileCoord: Point optional : coordonnées de la tuile.
  • zoom: number Zoom sur la tuile.
  • ownerDocument: Document optional : document auquel appartient cette tuile.
Valeur renvoyée : Element|null Tuile obtenue.
releaseTile
releaseTile(tileDiv)
Paramètres :
  • tileDiv: Element optional Relâchez pour voir l'extrait.
Valeur renvoyée : aucune
setOpacity
setOpacity(opacity)
Paramètres :
  • opacity: number Nouvelle opacité.
Valeur renvoyée : aucune
Définit le niveau d'opacité (de 0 (transparent) à 1.0) des tuiles ImageMapType.
Héritées : addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
tilesloaded
function()
Arguments : aucun
Cet événement est déclenché lorsque le chargement des tuiles visibles est terminé.

Interface ImageMapTypeOptions

interface google.maps.ImageMapTypeOptions

Cette classe permet de créer un MapType qui affiche des tuiles d'images.
alt
facultatif
Type : string optional
Texte alternatif à afficher lorsque l'utilisateur pointe sur le bouton de ce MapType dans le MapTypeControl.
getTileUrl
facultatif
Type : function(Point, number): (string optional) optional
Renvoie une chaîne (URL) pour les coordonnées de tuile (x, y) et le niveau de zoom donnés.
maxZoom
facultatif
Type : number optional
Niveau de zoom maximal de la carte lors de l'affichage de ce MapType.
minZoom
facultatif
Type : number optional
Niveau de zoom minimal de la carte lors de l'affichage de ce MapType. Facultatif.
name
facultatif
Type : string optional
Nom à afficher dans le MapTypeControl.
opacity
facultatif
Type : number optional
Opacité à appliquer aux tuiles. L'opacité doit être spécifiée sous la forme d'une valeur flottante comprise entre 0 et 1,0, où 0 est totalement transparent et 1 totalement opaque.
tileSize
facultatif
Type : Size optional
La taille des tuiles.

Classe GroundOverlay

class google.maps.GroundOverlay extends MVCObject
library "maps"

Superposition d'image rectangulaire sur la carte.

const {GroundOverlay} = await google.maps.importLibrary("maps");
GroundOverlay
GroundOverlay(url, bounds[, opts])
Paramètres :
Crée une superposition au sol à partir de l'URL de l'image fournie et de son LatLngBounds. L'image est mise à l'échelle pour s'adapter aux limites actuelles et projetée à l'aide de la projection de la carte actuelle.
getBounds
getBounds()
Paramètres : aucun
Valeur renvoyée : LatLngBounds|null
Récupère l'élément LatLngBounds de cette superposition.
getMap
getMap()
Paramètres : aucun
Valeur renvoyée : Map|null
Renvoie la carte sur laquelle cette superposition au sol est affichée.
getOpacity
getOpacity()
Paramètres : aucun
Valeur renvoyée : number
Renvoie l'opacité de cette superposition au sol.
getUrl
getUrl()
Paramètres : aucun
Valeur renvoyée : string
Récupère l'URL de l'image projetée.
setMap
setMap(map)
Paramètres :
  • map: Map optional
Valeur renvoyée : void
Affiche la superposition au sol sur la carte spécifiée. Si la carte est définie sur null, la superposition est supprimée.
setOpacity
setOpacity(opacity)
Paramètres :
  • opacity: number
Valeur renvoyée : void
Définit l'opacité de cette superposition au sol.
Héritées : addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
click
function(event)
Arguments :
Cet événement est déclenché lorsque l'événement de clic DOM est déclenché sur l'élément GroundOverlay.
dblclick
function(event)
Arguments :
Cet événement est déclenché lorsque l'événement DOM dblclick est déclenché sur l'objet GroundOverlay.

GroundOverlayOptions

interface google.maps.GroundOverlayOptions

Cet objet définit les propriétés qui peuvent être définies sur un objet GroundOverlay.
clickable
facultatif
Type : boolean optional
Si la valeur est true, la superposition au sol peut recevoir des événements de souris.
map
facultatif
Type : Map optional
Carte sur laquelle afficher la superposition.
opacity
facultatif
Type : number optional
Par défaut : 1.0
Opacité de la superposition, exprimée sous la forme d'une valeur comprise entre 0 et 1. Facultatif.

Classe StyledMapType

class google.maps.StyledMapType extends MVCObject implements MapType
library "maps"

Crée un MapType avec un style personnalisé.

const {StyledMapType} = await google.maps.importLibrary("maps");
StyledMapType
StyledMapType(styles[, options])
Paramètres :
Crée un MapType stylisé avec les options spécifiées. StyledMapType utilise un tableau de MapTypeStyle, où chaque MapTypeStyle est appliqué consécutivement à la carte. Un MapTypeStyle ultérieur qui applique les mêmes MapTypeStyler aux mêmes sélecteurs qu'un MapTypeStyle antérieur remplacera ce dernier MapTypeStyle.

Notez que StyledMapType n'est pas compatible lorsqu'un ID de carte est défini. Si vous utilisez les deux, un avertissement s'affiche dans la console.
alt
Type : string
maxZoom
Type : number
minZoom
Type : number
name
Type : string
projection
Type : Projection optional
radius
Type : number
tileSize
Type : Size optional
getTile
getTile(tileCoord, zoom, ownerDocument)
Paramètres :
  • tileCoord: Point optional : coordonnées de la tuile.
  • zoom: number Zoom sur la tuile.
  • ownerDocument: Document optional : document auquel appartient cette tuile.
Valeur renvoyée : Element|null Tuile obtenue.
releaseTile
releaseTile(tile)
Paramètres :
  • tile: Element optional Relâchez pour voir l'extrait.
Valeur renvoyée : void
Héritées : addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interface StyledMapTypeOptions

interface google.maps.StyledMapTypeOptions

Cette classe permet de spécifier des options lors de la création d'un StyledMapType. Ces options ne peuvent pas être modifiées après l'instanciation de StyledMapType.
alt
facultatif
Type : string optional
Texte à afficher lorsque l'utilisateur pointe sur le bouton de ce MapType dans la commande de type de carte.
maxZoom
facultatif
Type : number optional
Niveau de zoom maximal de la carte lors de l'affichage de ce MapType. Facultatif.
minZoom
facultatif
Type : number optional
Niveau de zoom minimal de la carte lors de l'affichage de ce MapType. Facultatif.
name
facultatif
Type : string optional
Nom à afficher dans la commande de type de carte.