Coordinates

Classe LatLng

Classe google.maps.LatLng

Un LatLng est un point de coordonnées géographiques : latitude et longitude.

  • La latitude est comprise entre -90 et 90 degrés, inclus. Les valeurs supérieures ou inférieures à cette plage seront limitées à la plage [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, elle sera définie sur -90. Si la valeur est supérieure à 90, elle sera définie sur 90.
  • La longitude est comprise entre -180 et 180 degrés, inclus. Les valeurs supérieures ou inférieures à cette fourchette seront converties pour être incluses dans la fourchette. Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 190 sera convertie en -170. Cela reflète le fait que les longitudes font le tour du globe.
 Bien que la projection cartographique par défaut associe la longitude à la coordonnée x de la carte et la latitude à la coordonnée y, la coordonnée de latitude est toujours écrite en premier, suivie de la longitude.
Notez que vous ne pouvez pas modifier les coordonnées d'un LatLng. Si vous souhaitez calculer un autre point, vous devez en créer un.

La plupart des méthodes qui acceptent les objets LatLng acceptent également un objet LatLngLiteral. Les éléments suivants sont donc équivalents :

 map.setCenter(new google.maps.LatLng(-34, 151));
map.setCenter({lat: -34, lng: 151});

Le constructeur accepte également les objets LatLngLiteral et LatLng. Si une instance LatLng est transmise au constructeur, une copie est créée.

Voici les appels possibles au constructeur :

 new google.maps.LatLng(-34, 151);
new google.maps.LatLng(-34, 151, true);
new google.maps.LatLng({lat: -34, lng: 151});
new google.maps.LatLng({lat: -34, lng: 151}, true);
new google.maps.LatLng(new google.maps.LatLng(-34, 151));
new google.maps.LatLng(new google.maps.LatLng(-34, 151), true);

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

LatLng
LatLng(latOrLatLngOrLatLngLiteral[, lngOrNoClampNoWrap, noClampNoWrap])
Paramètres :
  • latOrLatLngOrLatLngLiteral : number|LatLngLiteral|LatLng
  • lngOrNoClampNoWrap : number|boolean optional
  • noClampNoWrap : boolean optional
Crée un objet LatLng représentant un point géographique. La latitude est spécifiée en degrés dans la plage [-90, 90]. La longitude est spécifiée en degrés dans la plage [-180, 180). Définissez noClampNoWrap sur true pour activer les valeurs en dehors de cette plage. Notez l'ordre de la latitude et de la longitude.
equals
equals(other)
Paramètres :
Valeur renvoyée : boolean
Fonction de comparaison.
lat
lat()
Paramètres : aucun
Valeur renvoyée : number
Renvoie la latitude en degrés.
lng
lng()
Paramètres : aucun
Valeur renvoyée : number
Renvoie la longitude en degrés.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : LatLngLiteral
Convertit en représentation JSON. Cette fonction est destinée à être utilisée via JSON.stringify.
toString
toString()
Paramètres : aucun
Valeur renvoyée : string
Convertit en représentation de chaîne.
toUrlValue
toUrlValue([precision])
Paramètres :
  • precision : number optional
Valeur renvoyée : string
Renvoie une chaîne au format "lat,lng" pour ce LatLng. Par défaut, nous arrondissons les valeurs de latitude et de longitude à six décimales.

Interface LatLngLiteral

Interface google.maps.LatLngLiteral

Les littéraux d'objet sont acceptés à la place des objets LatLng, par souci de commodité, à de nombreux endroits. Ils sont convertis en objets LatLng lorsque l'API Maps les rencontre.

Exemples :

 map.setCenter({lat: -34, lng: 151});
new google.maps.Marker({position: {lat: -34, lng: 151}, map: map});

Les littéraux d'objet LatLng ne sont pas acceptés dans la bibliothèque Geometry.

lat
Type : number
Latitude en degrés. Les valeurs seront limitées à la plage [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, elle sera définie sur -90. Si la valeur est supérieure à 90, elle sera définie sur 90.
lng
Type : number
Longueur en degrés. Les valeurs en dehors de la plage [-180, 180] seront converties pour être incluses dans la plage. Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 190 sera convertie en -170. Cela reflète le fait que les longitudes font le tour du globe.

Classe LatLngBounds

Classe google.maps.LatLngBounds

Une instance LatLngBounds représente un rectangle en coordonnées géographiques, y compris un rectangle qui traverse le méridien de longitude de 180 degrés.

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

LatLngBounds
LatLngBounds([swOrLatLngBounds, ne])
Paramètres :
Construit un rectangle à partir des points situés à ses angles sud-ouest et nord-est.
MAX_BOUNDS LatLngBounds pour les limites maximales de la Terre. Ces limites engloberont le monde entier.
contains
contains(latLng)
Paramètres :
Valeur renvoyée : boolean
Renvoie true si la latitude/longitude donnée se trouve dans ces limites.
equals
equals(other)
Paramètres :
Valeur renvoyée : boolean
Renvoie true si ces limites sont approximativement égales aux limites données.
extend
extend(point)
Paramètres :
Valeur renvoyée : LatLngBounds
Étend ces limites pour contenir le point donné.
getCenter
getCenter()
Paramètres : aucun
Valeur renvoyée : LatLng
Calcule le centre de ce LatLngBounds.
getNorthEast
getNorthEast()
Paramètres : aucun
Valeur renvoyée : LatLng
Renvoie l'angle nord-est de ces limites.
getSouthWest
getSouthWest()
Paramètres : aucun
Valeur renvoyée : LatLng
Renvoie l'angle sud-ouest de ces limites.
intersects
intersects(other)
Paramètres :
Valeur renvoyée : boolean
Renvoie true si ces limites partagent des points avec les autres limites.
isEmpty
isEmpty()
Paramètres : aucun
Valeur renvoyée : boolean
Renvoie si les limites sont vides.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : LatLngBoundsLiteral
Convertit en représentation JSON. Cette fonction est destinée à être utilisée via JSON.stringify.
toSpan
toSpan()
Paramètres : aucun
Valeur renvoyée : LatLng
Convertit les limites de la carte données en étendue de latitude/longitude.
toString
toString()
Paramètres : aucun
Valeur renvoyée : string
Convertit en chaîne.
toUrlValue
toUrlValue([precision])
Paramètres :
  • precision : number optional
Valeur renvoyée : string
Renvoie une chaîne au format "lat_lo,lng_lo,lat_hi,lng_hi" pour ces limites, où "lo" correspond à l'angle sud-ouest du cadre de délimitation, tandis que "hi" correspond à l'angle nord-est de ce cadre.
union
union(other)
Paramètres :
Valeur renvoyée : LatLngBounds
Étend ces limites pour contenir l'union de celles-ci et des limites spécifiées.

Interface LatLngBoundsLiteral

Interface google.maps.LatLngBoundsLiteral

Les littéraux d'objet sont acceptés à la place des objets LatLngBounds dans toute l'API. Elles sont automatiquement converties en objets LatLngBounds. Tous les south, west, north et east doivent être définis, sinon une exception est générée.

east
Type : number
Longitude est en degrés. Les valeurs en dehors de la plage [-180, 180] seront ramenées à la plage [-180, 180). Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 190 sera convertie en -170. Cela reflète le fait que les longitudes font le tour du globe.
north
Type : number
Latitude nord en degrés. Les valeurs seront limitées à la plage [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, elle sera définie sur -90. Si la valeur est supérieure à 90, elle sera définie sur 90.
south
Type : number
Latitude sud en degrés. Les valeurs seront limitées à la plage [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, elle sera définie sur -90. Si la valeur est supérieure à 90, elle sera définie sur 90.
west
Type : number
Longitude ouest en degrés. Les valeurs en dehors de la plage [-180, 180] seront ramenées à la plage [-180, 180). Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 190 sera convertie en -170. Cela reflète le fait que les longitudes font le tour du globe.

Classe LatLngAltitude

Classe google.maps.LatLngAltitude

Un LatLngAltitude est un point 3D en coordonnées géographiques : latitude, longitude et altitude.

  • La latitude est comprise entre -90 et 90 degrés, inclus. Les valeurs supérieures ou inférieures à cette plage seront limitées à la plage [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, elle sera définie sur -90. Si la valeur est supérieure à 90, elle sera définie sur 90.
  • La longitude est comprise entre -180 et 180 degrés, inclus. Les valeurs supérieures ou inférieures à cette fourchette seront converties pour être incluses dans la fourchette. Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 190 sera convertie en -170. Cela reflète le fait que les longitudes font le tour du globe.
  • L'altitude est mesurée en mètres. Les valeurs positives indiquent des hauteurs au-dessus du niveau du sol, et les valeurs négatives des hauteurs en dessous de la surface du sol.

Cette classe implémente LatLngAltitudeLiteral.

Cette classe implémente LatLngLiteral.

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

LatLngAltitude
LatLngAltitude(value[, noClampNoWrap])
Paramètres :
  • value : LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral valeur d'initialisation.
  • noClampNoWrap : boolean optional Indique s'il faut conserver les valeurs d'initialisation, même si elles ne sont pas nécessairement des valeurs de latitude valides dans la plage [-90, 90] ou des valeurs de longitude valides dans la plage [-180, 180]. La valeur par défaut est false, qui active le blocage de la latitude et l'encapsulation de la longitude.
altitude
Type : number
Renvoie l'altitude.
lat
Type : number
Renvoie la latitude.
lng
Type : number
Renvoie la longitude.
equals
equals(other)
Paramètres :
Valeur renvoyée : boolean Indique si les deux objets sont égaux.
Fonction de comparaison.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : LatLngAltitudeLiteral, une représentation JSON de cet objet.

Interface LatLngAltitudeLiteral

Interface google.maps.LatLngAltitudeLiteral

Les littéraux d'objet sont acceptés à la place des objets LatLngAltitude, par souci de commodité, à de nombreux endroits. Ils sont convertis en objets LatLngAltitude lorsque l'API Maps les rencontre.

Cette interface étend LatLngLiteral.

altitude
Type : number
Par défaut : 0
Distance (en mètres) au-dessus de la surface du sol. Une valeur négative signifie que le point se trouve sous la surface du sol.
lat
Type : number
Latitude en degrés. Les valeurs seront limitées à la plage [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, elle sera définie sur -90. Si la valeur est supérieure à 90, elle sera définie sur 90.
lng
Type : number
Longueur en degrés. Les valeurs en dehors de la plage [-180, 180] seront converties pour être incluses dans la plage. Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 190 sera convertie en -170. Cela reflète le fait que les longitudes font le tour du globe.

Classe Point

Classe google.maps.Point

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

Point
Point(x, y)
Paramètres :
  • x : number
  • y : number
Point sur un plan bidimensionnel.
x
Type : number
Coordonnée X
y
Type : number
Coordonnée Y
equals
equals(other)
Paramètres :
  • other : Point optional
Valeur renvoyée : boolean
Compare deux points
toString
toString()
Paramètres : aucun
Valeur renvoyée : string
Renvoie une représentation sous forme de chaîne de ce point.

Classe Size

Classe google.maps.Size

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

Size
Size(width, height[, widthUnit, heightUnit])
Paramètres :
  • width : number
  • height : number
  • widthUnit : string optional
  • heightUnit : string optional
Taille bidimensionnelle, où la largeur correspond à la distance sur l'axe X et la hauteur à la distance sur l'axe Y.
height
Type : number
Hauteur le long de l'axe Y, en pixels.
width
Type : number
Largeur le long de l'axe X, en pixels.
equals
equals(other)
Paramètres :
Valeur renvoyée : boolean
Compare deux tailles.
toString
toString()
Paramètres : aucun
Valeur renvoyée : string
Renvoie une représentation sous forme de chaîne de cette taille.

Interface Padding

Interface google.maps.Padding

bottom optional
Type : number optional
Marge intérieure inférieure, en pixels.
left optional
Type : number optional
Marge intérieure à gauche, en pixels.
right optional
Type : number optional
Marge intérieure à droite, en pixels.
top optional
Type : number optional
Marge intérieure supérieure, en pixels.

Interface CircleLiteral

Interface google.maps.CircleLiteral

Littéral d'objet représentant un cercle.

Cette interface étend CircleOptions.

center
Centre du cercle.
radius
Type : number
Rayon en mètres à la surface de la Terre.
Hérité : clickable, draggable, editable, fillColor, fillOpacity, map, strokeColor, strokeOpacity, strokePosition, strokeWeight, visible, zIndex

Classe Orientation3D

Classe google.maps.Orientation3D

Un Orientation3D est un vecteur tridimensionnel utilisé pour les transformations de rotation mathématiques standards le long du cap, de l'inclinaison et du roulis.

  • L'orientation est un angle compris entre 0 et 360 degrés.
  • L'inclinaison est un angle compris entre 0 et 360 degrés.
  • Le roulis est un angle compris entre 0 et 360 degrés (exclus).

Cette classe implémente Orientation3DLiteral.

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

Orientation3D
Orientation3D(value)
Paramètres :
heading
Type : number
Par défaut : 0
Rotation autour de l'axe Z (normal à la surface de la Terre). Une valeur de 0 (par défaut) correspond au nord. Une rotation positive s'effectue dans le sens des aiguilles d'une montre autour de l'axe Z et est spécifiée en degrés de 0 à 360. Les valeurs supérieures ou inférieures à cette fourchette seront converties pour être incluses dans la fourchette. Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 530 sera également convertie en 170.
roll
Type : number
Par défaut : 0
Rotation autour de l'axe Y. Une rotation positive s'effectue dans le sens des aiguilles d'une montre autour de l'axe Y et est spécifiée en degrés de 0 à 360. Les valeurs supérieures ou inférieures à cette fourchette seront converties pour être incluses dans la fourchette. Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 530 sera également convertie en 170.
tilt
Type : number
Par défaut : 0
Rotation autour de l'axe X. Une rotation positive s'effectue dans le sens des aiguilles d'une montre autour de l'axe X et est spécifiée en degrés (de 0 à 360). Les valeurs supérieures ou inférieures à cette fourchette seront converties pour être incluses dans la fourchette. Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 530 sera également convertie en 170.
equals
equals(other)
Paramètres :
Valeur renvoyée : boolean Indique si les deux objets sont égaux.
Fonction de comparaison.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Orientation3DLiteral
Convertit en représentation JSON. Cette fonction est destinée à être utilisée via JSON.stringify.

Interface Orientation3DLiteral

Interface google.maps.Orientation3DLiteral

Les littéraux d'objet sont acceptés à la place des objets Orientation3D, par souci de commodité, à de nombreux endroits. Ils sont convertis en objets Orientation3D lorsque l'API Maps les rencontre.

heading optional
Type : number optional
Rotation autour de l'axe Z (normal à la surface de la Terre). Une valeur de 0 (par défaut) correspond au nord. Une rotation positive s'effectue dans le sens des aiguilles d'une montre autour de l'axe Z et est spécifiée en degrés de 0 à 360.
roll optional
Type : number optional
Rotation autour de l'axe Y. Une rotation positive s'effectue dans le sens des aiguilles d'une montre autour de l'axe Y et est spécifiée en degrés de 0 à 360.
tilt optional
Type : number optional
Rotation autour de l'axe X. Une rotation positive s'effectue dans le sens des aiguilles d'une montre autour de l'axe X et est spécifiée en degrés (de 0 à 360).

Classe Vector3D

Classe google.maps.Vector3D

Un Vector3D est un vecteur tridimensionnel utilisé pour les opérations mathématiques standards, comme la mise à l'échelle des limites d'un objet tridimensionnel le long des axes x, y et z locaux.

  • x est un nombre réel.
  • y est un nombre réel.
  • z est un nombre réel.

Cette classe implémente Vector3DLiteral.

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

Vector3D
Vector3D(value)
Paramètres :
x
Type : number
Composant X du vecteur tridimensionnel.
y
Type : number
Composant Y du vecteur tridimensionnel.
z
Type : number
Composant Z du vecteur tridimensionnel.
equals
equals(other)
Paramètres :
Valeur renvoyée : boolean
Fonction de comparaison.
toJSON
toJSON()
Paramètres : aucun
Valeur renvoyée : Vector3DLiteral
Convertit en représentation JSON. Cette fonction est destinée à être utilisée via JSON.stringify.

Interface Vector3DLiteral

Interface google.maps.Vector3DLiteral

Les littéraux d'objet sont acceptés à la place des objets Vector3D, par souci de commodité, à de nombreux endroits. Ils sont convertis en objets Vector3D lorsque l'API Maps les rencontre.

x
Type : number
Composant X du vecteur tridimensionnel.
y
Type : number
Composant Y du vecteur tridimensionnel.
z
Type : number
Composant Z du vecteur tridimensionnel.