Coordinates

Classe LatLng

Classe google.maps.LatLng

Un LatLng est un point dans 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 fourchette seront limitées à la plage [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, elle est définie sur -90. Si elle 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 encapsulées afin qu'elles entrent 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 encapsulent le monde.

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 première, 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 autre.

La plupart des méthodes qui acceptent les objets LatLng acceptent également un objet LatLngLiteral, de sorte que les suivantes sont équivalentes:

 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 au compte en appelant const {LatLng} = await google.maps.importLibrary("core"). Consultez Bibliothèques dans 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 activer les valeurs en dehors de cette plage. Notez l'ordre d'affichage 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 à 6 décimales.

Interface LatLngLiteral

Interface google.maps.LatLngLiteral

Pour des raisons pratiques, les littéraux d'objet sont acceptés à la place des objets LatLng. Ils sont convertis en objets LatLng lorsque l'API Google Maps les détecte.

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 compatibles avec 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 est définie sur -90. Si elle est supérieure à 90, elle sera définie sur 90.
lng	Type:number Longueur en degrés. Les valeurs situées en dehors de la plage [-180, 180] seront encapsulées afin de se trouver 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 encapsulent le monde.

Classe LatLngBounds

Classe google.maps.LatLngBounds

Une instance LatLngBounds représente un rectangle aux coordonnées géographiques, dont un qui traverse le méridien longitudinal à 180 degrés.

Accédez au compte en appelant const {LatLngBounds} = await google.maps.importLibrary("core"). Consultez Bibliothèques dans 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 à ses angles sud-ouest et nord-est.

Méthodes
contains	contains(latLng) Paramètres: latLng:  LatLng|LatLngLiteral Valeur renvoyée:  boolean Renvoie true si les coordonnées de latitude et longitude données se trouvent dans ces limites.
equals	equals(other) Paramètres: other:  LatLngBounds|LatLngBoundsLiteral optional Valeur renvoyée:  boolean Renvoie true si cette limite est approximativement égale aux limites données.
extend	extend(point) Paramètres: point:  LatLng|LatLngLiteral Valeur renvoyée:  LatLngBounds Étend les limites pour qu'elles contiennent 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 cette limite.
intersects	intersects(other) Paramètres: other:  LatLngBounds|LatLngBoundsLiteral Valeur renvoyée:  boolean Renvoie true si cette limite partage 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 en un lat/lng span.
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 de la forme "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" correspond à l'angle nord-est de cette boîte.
union	union(other) Paramètres: other:  LatLngBounds|LatLngBoundsLiteral Valeur renvoyée:  LatLngBounds Étend les limites pour contenir l'union de ces limites et les suivantes.

Constantes
MAX_BOUNDS	LatLngBounds pour les limites maximales de la Terre. Ces limites englobent l'ensemble du globe.

Interface LatLngBoundsLiteral

Interface google.maps.LatLngBoundsLiteral

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 encapsulées 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 encapsulent le monde.
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 est définie sur -90. Si elle 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 est définie sur -90. Si elle 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 encapsulées 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 encapsulent le monde.

Classe LatLngAltitude

Classe google.maps.LatLngAltitude

Un LatLngAltitude est un point 3D dans des 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 fourchette seront limitées à la plage [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, elle est définie sur -90. Si elle 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 encapsulées afin qu'elles entrent 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 encapsulent le monde.
• L'altitude est mesurée en mètres. Les valeurs positives indiquent la hauteur au-dessus du sol et les valeurs négatives la hauteur sous le sol.

Cette classe implémente LatLngAltitudeLiteral.

Cette classe implémente LatLngLiteral.

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

Constructeur

LatLngAltitude

LatLngAltitude(value[, noClampNoWrap]) Paramètres: value:  LatLngAltitude|LatLngAltitudeLiteral|LatLng|LatLngLiteral valeur d'initialisation. noClampNoWrap:  boolean optional conserve les valeurs d'initialisation, même si elles ne sont pas nécessairement des valeurs de latitude valides comprises entre [-90, 90] ou des valeurs de longitude valides comprises entre [-180 et 180]. La valeur par défaut est false, ce qui active le blocage de la latitude et l'encapsulation 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 autre objet LatLngAltitude. Valeur renvoyée:boolean indique si les deux objets sont égaux. Fonction de comparaison
toJSON	toJSON() Paramètres:aucun Valeur renvoyée:LatLngAltitudeLiteral représentation JSON de cet objet.

Interface LatLngAltitudeLiteral

Interface google.maps.LatLngAltitudeLiteral

Pour des raisons pratiques, les littéraux d'objet sont acceptés à la place des objets LatLngAltitude. Ils sont convertis en objets LatLngAltitude lorsque l'API Google Maps les détecte.

Cette interface étend LatLngLiteral.

Propriétés
altitude	Type:number Par défaut:0 Distance (en mètres) au-dessus de la surface du sol. Une valeur négative correspond à une surface sous-jacente.
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 est définie sur -90. Si elle est supérieure à 90, elle sera définie sur 90.
lng	Type:number Longueur en degrés. Les valeurs situées en dehors de la plage [-180, 180] seront encapsulées afin de se trouver 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 encapsulent le monde.

Classe Point

Classe google.maps.Point

Accédez au compte en appelant const {Point} = await google.maps.importLibrary("core"). Consultez Bibliothèques dans 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 Valeur renvoyée:  boolean Comparer 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 au compte en appelant const {Size} = await google.maps.importLibrary("core"). Consultez Bibliothèques dans l'API Maps JavaScript.

Constructeur
Size	Size(width, height[, widthUnit, heightUnit]) Paramètres: width:  number height:  number widthUnit:  string optional heightUnit:  string optional Taille en deux dimensions, où la largeur correspond à la distance sur l'axe X et la hauteur sur 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 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 de remplissage

Interface google.maps.Padding

Propriétés
bottom optional	Type:number optional Marge intérieure inférieure, en pixels.
left optional	Type:number optional Marge intérieure de 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.

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