Image overlays

Interface MapType

Interface google.maps.MapType

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 lorsque ce type de carte est affiché. Obligatoire pour les MapTypes de base, ignoré pour les MapTypes de superposition.
minZoom
Type:number
Niveau de zoom minimal de la carte lorsque ce type de carte est affiché. 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 63 781 37 m.
tileSize
Type:Size
Dimensions de chaque carte. Obligatoire.
alt optional
Type:string optional
Texte alternatif à afficher lorsque le bouton de ce MapType est survolé dans MapTypeControl. Facultatif.
name optional
Type:string optional
Nom à afficher dans MapTypeControl. Facultatif.
projection optional
Type:Projection optional
Projection utilisée pour afficher ce MapType. Facultatif. La valeur par défaut est Mercator.
getTile
getTile(tileCoord, zoom, ownerDocument)
Paramètres:
  • tileCoord:  coordonnées de la tuile Point.
  • zoom:  zoom sur la carte number.
  • ownerDocumentDocument Document propriétaire de cette carte.
Valeur renvoyée:Element|null Carte générée.
Renvoie une tuile pour les coordonnées de tuile (x, y) et le niveau de zoom donnés. Cette carte sera ajoutée au ownerDocument donné. Non disponible pour les types de cartes de base.
releaseTile
releaseTile(tile)
Paramètres:
  • tile:  carte Element optional à publier.
Valeur renvoyée:aucune
Libère la carte donnée, en effectuant le nettoyage nécessaire. La carte fournie aura déjà été supprimée du document. Facultatif.

Interface Projection

Interface google.maps.Projection

fromLatLngToPoint
fromLatLngToPoint(latLng[, point])
Paramètres:
Valeur renvoyée:Point|null
Convertit le cylindre LatLng au 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 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 Point.
fromPointToLatLng
fromPointToLatLng(pixel[, noClampNoWrap])
Paramètres:
  • pixelPoint
  • noClampNoWrapboolean 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 les 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 LatLng.

Classe ImageMapType

Classe google.maps.ImageMapType

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

Cette classe étend MVCObject.

Cette classe implémente MapType.

Accédez-y en appelant const {ImageMapType} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

ImageMapType
ImageMapType(opts)
Paramètres:
Crée un ImageMapType à l'aide des ImageMapTypeOptions fournies.
alt
Type:string optional
maxZoom
Type:number
minZoom
Type:number
name
Type:string optional
projection
radius
Type:number
tileSize
Type:Size
getOpacity
getOpacity()
Paramètres:aucun
Valeur renvoyée:number opacity Opacité actuelle.
Renvoie le niveau d'opacité (0 (transparent) à 1.0) des cartes ImageMapType.
getTile
getTile(tileCoord, zoom, ownerDocument)
Paramètres:
  • tileCoord:  coordonnées de la tuile Point.
  • zoom:  zoom sur la carte number.
  • ownerDocumentDocument Document propriétaire de cette carte.
Valeur renvoyée:Element|null Carte générée.
releaseTile
releaseTile(tileDiv)
Paramètres:
  • tileDiv:  carte Element optional à publier.
Valeur renvoyée:aucune
setOpacity
setOpacity(opacity)
Paramètres:
  • opacitynumber Nouvelle opacité.
Valeur renvoyée:aucune
Définit le niveau d'opacité (0 (transparent) à 1.0) des cartes ImageMapType.
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
tilesloaded
function()
Arguments:aucun
Cet événement est déclenché lorsque les cartes visibles ont fini de se charger.

Interface ImageMapTypeOptions

Interface google.maps.ImageMapTypeOptions

Cette classe permet de créer un MapType qui affiche des tuiles d'images.

alt optional
Type:string optional
Texte alternatif à afficher lorsque le bouton de ce MapType est survolé dans MapTypeControl.
getTileUrl optional
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 optional
Type:number optional
Niveau de zoom maximal de la carte lorsque ce type de carte est affiché.
minZoom optional
Type:number optional
Niveau de zoom minimal de la carte lorsque ce type de carte est affiché. Facultatif.
name optional
Type:string optional
Nom à afficher dans MapTypeControl.
opacity optional
Type:number optional
Opacité à appliquer aux cartes. L'opacité doit être spécifiée sous la forme d'une valeur flottante comprise entre 0 et 1, où 0 correspond à une transparence totale et 1 à une opacité totale.
tileSize optional
Type:Size optional
Taille des tuiles.

Classe GroundOverlay

Classe google.maps.GroundOverlay

Superposition d'une image rectangulaire sur la carte.

Cette classe étend MVCObject.

Accédez-y en appelant const {GroundOverlay} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

GroundOverlay
GroundOverlay(url, bounds[, opts])
Paramètres:
Crée un calque de fond à 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
Récupère le LatLngBounds de cette superposition.
getMap
getMap()
Paramètres:aucun
Valeur renvoyée:Map
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:
Valeur renvoyée:aucune
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:
  • opacitynumber
Valeur renvoyée:aucune
Définit l'opacité de cette superposition au sol.
Hérité: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
click
function(event)
Arguments: 
Cet événement se déclenche lorsque l'événement de clic DOM se déclenche sur le GroundOverlay.
dblclick
function(event)
Arguments: 
Cet événement se déclenche lorsque l'événement de double-clic DOM se déclenche sur le GroundOverlay.

Interface GroundOverlayOptions

Interface google.maps.GroundOverlayOptions

Cet objet définit les propriétés pouvant être définies sur un objet GroundOverlay.

clickable optional
Type:boolean optional
Si la valeur est true, la superposition au sol peut recevoir des événements de souris.
map optional
Type:Map optional
Carte sur laquelle afficher la superposition.
opacity optional
Type:number optional
Par défaut:1.0
Opacité de la superposition, exprimée sous la forme d'un nombre compris entre 0 et 1. Facultatif.

Classe StyledMapType

Classe google.maps.StyledMapType

Crée une MapType avec un style personnalisé.

Cette classe étend MVCObject.

Cette classe implémente MapType.

Accédez-y en appelant const {StyledMapType} = await google.maps.importLibrary("maps"). Consultez la section Bibliothèques de l'API Maps JavaScript.

StyledMapType
StyledMapType(styles[, options])
Paramètres:
Crée un MapType stylisé avec les options spécifiées. StyledMapType prend un tableau de MapTypeStyle, où chaque MapTypeStyle est appliqué à la carte de manière consécutive. Un MapTypeStyle ultérieur qui applique les mêmes MapTypeStyler aux mêmes sélecteurs qu'un MapTypeStyle précédent remplace ce dernier.MapTypeStyle

Notez que StyledMapType n'est pas accepté lorsqu'un ID de carte est défini. Si vous utilisez les deux en même temps, vous recevrez un avertissement dans la console.
alt
Type:string
maxZoom
Type:number
minZoom
Type:number
name
Type:string
projection
radius
Type:number
tileSize
Type:Size
getTile
getTile(tileCoord, zoom, ownerDocument)
Paramètres:
  • tileCoord:  coordonnées de la tuile Point.
  • zoom:  zoom sur la carte number.
  • ownerDocumentDocument Document propriétaire de cette carte.
Valeur renvoyée:Element|null Carte générée.
releaseTile
releaseTile(tile)
Paramètres:
  • tile:  carte Element optional à publier.
Valeur renvoyée:aucune
Hérité: 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 plus être modifiées une fois l'instance StyledMapType créée.

alt optional
Type:string optional
Texte à afficher lorsque vous pointez sur le bouton de cette MapType dans la commande de type de carte.
maxZoom optional
Type:number optional
Niveau de zoom maximal de la carte lorsque vous affichez cette MapType. Facultatif.
minZoom optional
Type:number optional
Niveau de zoom minimal de la carte lors de l'affichage de cet élément MapType. Facultatif.
name optional
Type:string optional
Nom à afficher dans la commande du type de carte.