Coordinates

Classe LatLng

Classe google.maps.LatLng

Un LatLng est un point défini par des 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 plage 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 s'enroulent autour du globe.

Bien que la projection de carte 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 des 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.

Les appels possibles au constructeur sont les suivants :

 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 const {LatLng} = await google.maps.importLibrary("core").
Consultez Bibliothèques de l'API Maps JavaScript.

Constructeur

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 autoriser les valeurs en dehors de cette plage. Notez l'ordre de la latitude et de la longitude.

Méthodes
equals	equals(other) Paramètres :  other : LatLng 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/longitude à six décimales.

Interface LatLngLiteral

google.maps.LatLngLiteral interface

Les littéraux d'objet sont acceptés à la place des objets LatLng, par commodité, à de nombreux endroits. Ils sont convertis en objets LatLng lorsque l'API Google 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.

Propriétés
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 s'enroulent autour 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 longitudinal de 180 degrés.

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

Constructeur
LatLngBounds	LatLngBounds([swOrLatLngBounds, ne]) Paramètres :  swOrLatLngBounds : LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral optional ne : LatLng|LatLngLiteral optional Construit un rectangle à partir des points situés aux angles sud-ouest et nord-est.

Constantes
MAX_BOUNDS	LatLngBounds pour les limites maximales de la Terre. Ces limites englobent le monde entier.

Méthodes
contains	contains(latLng) Paramètres :  latLng : LatLng|LatLngLiteral Valeur renvoyée : boolean Renvoie true si la latitude/longitude donnée se trouve dans ces limites.
equals	equals(other) Paramètres :  other : LatLngBounds|LatLngBoundsLiteral optional Valeur renvoyée : boolean Renvoie true si ces limites sont approximativement égales aux limites données.
extend	extend(point) Paramètres :  point : LatLng|LatLngLiteral 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 :  other : LatLngBounds|LatLngBoundsLiteral 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 Indique 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 une plage 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 et "hi" à l'angle nord-est de ce cadre.
union	union(other) Paramètres :  other : LatLngBounds|LatLngBoundsLiteral Valeur renvoyée : LatLngBounds Étend ces limites pour contenir l'union de ces limites et des limites données.

Interface LatLngBoundsLiteral

google.maps.LatLngBoundsLiteral interface

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

Propriétés
east	Type : number Longitude est en degrés. Les valeurs en dehors de la plage [-180, 180] seront converties pour être incluses dans 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 s'enroulent autour 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 converties pour être incluses dans 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 s'enroulent autour 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 plage 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 s'enroulent autour 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 indiquent des hauteurs sous la surface du sol.

Cette classe implémente LatLngAltitudeLiteral.

Cette classe implémente LatLngLiteral.

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

Constructeur

LatLngAltitude

LatLngAltitude(value[, noClampNoWrap]) Paramètres :  value : LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral Valeur d'initialisation. noClampNoWrap : boolean optional Indique si les valeurs d'initialisation doivent être conservées, même si elles ne sont pas nécessairement des valeurs de latitude valides comprises entre -90 et 90, ou des valeurs de longitude valides comprises entre -180 et 180. La valeur par défaut est false, qui active le verrouillage de la latitude et l'encapsulage de la longitude.

Propriétés
altitude	Type : number Renvoie l'altitude.
lat	Type : number Renvoie la latitude.
lng	Type : number Renvoie la longitude.

Méthodes
equals	equals(other) Paramètres : other : LatLngAltitude optional Un autre objet LatLngAltitude. Valeur renvoyée : boolean Indique si les deux objets sont égaux. Fonction de comparaison.
toJSON	toJSON() Paramètres : aucun Valeur de retour : LatLngAltitudeLiteral Représentation JSON de cet objet.

LatLngAltitudeLiteral

google.maps.LatLngAltitudeLiteral interface

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

Cette interface étend LatLngLiteral.

Propriétés
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 s'enroulent autour du globe.
altitude optional	Type : number optional Par défaut : 0 Distance (en mètres) au-dessus de la surface du sol. Une valeur négative signifie que l'élément se trouve sous la surface du sol.

Classe Point

Classe google.maps.Point

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

Constructeur
Point	Point(x, y) Paramètres :  x : number y : number Point sur un plan bidimensionnel.

Propriétés
x	Type : number Coordonnée X
y	Type : number Coordonnée Y

Méthodes
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 de ce point sous forme de chaîne.

Classe Size

Classe google.maps.Size

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

Constructeur
Size	Size(width, height[, widthUnit, heightUnit]) Paramètres :  width : number height : number widthUnit : string optional heightUnit : string optional Taille bidimensionnelle, où la largeur est la distance sur l'axe X et la hauteur est la distance sur l'axe Y.

Propriétés
height	Type : number Hauteur le long de l'axe Y, en pixels.
width	Type : number Largeur le long de l'axe X, en pixels.

Méthodes
equals	equals(other) Paramètres :  other : Size optional Valeur renvoyée : boolean Compare deux tailles.
toString	toString() Paramètres : aucun Valeur renvoyée : string Renvoie une représentation de cette taille sous forme de chaîne.

Interface Padding

google.maps.Padding interface

Propriétés
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

google.maps.CircleLiteral interface

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

Cette interface étend CircleOptions.

Propriétés
center	Type : LatLng|LatLngLiteral 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.

• "heading" est un angle compris entre 0 et 360 degrés.
• "tilt" est un angle compris entre 0 et 360 degrés.
• "roll" est un angle compris entre 0 et 360 degrés.

Cette classe implémente Orientation3DLiteral.

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

Constructeur
Orientation3D	Orientation3D(value) Paramètres :  value : Orientation3D|Orientation3DLiteral Valeur d'initialisation.

Propriétés
heading	Type : number Par défaut : 0 Rotation autour de l'axe Z (perpendiculaire à la surface de la Terre). La valeur 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 plage seront converties pour être incluses dans la plage. 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 plage seront converties pour être incluses dans la plage. 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 plage seront converties pour être incluses dans la plage. Par exemple, une valeur de -190 sera convertie en 170. Une valeur de 530 sera également convertie en 170.

Méthodes
equals	equals(other) Paramètres :  other : Orientation3D|Orientation3DLiteral optional Un autre objet Orientation3D. 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

google.maps.Orientation3DLiteral interface

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

Propriétés
heading optional	Type : number optional Rotation autour de l'axe Z (perpendiculaire à la surface de la Terre). La valeur 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, telles que 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 const {Vector3D} = await google.maps.importLibrary("core").
Consultez Bibliothèques de l'API Maps JavaScript.

Constructeur
Vector3D	Vector3D(value) Paramètres :  value : Vector3D|Vector3DLiteral Valeur d'initialisation.

Propriétés
x	Type : number Composante X du vecteur tridimensionnel.
y	Type : number Composante Y du vecteur tridimensionnel.
z	Type : number Composante Z du vecteur tridimensionnel.

Méthodes
equals	equals(other) Paramètres :  other : Vector3D|Vector3DLiteral optional Un autre objet Vector3D ou Vector3DLiteral. 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.

Vector3DLiteral

google.maps.Vector3DLiteral interface

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

Propriétés
x	Type : number Composante X du vecteur tridimensionnel.
y	Type : number Composante Y du vecteur tridimensionnel.
z	Type : number Composante Z du vecteur tridimensionnel.