Cette page a été traduite par l'API Cloud Translation.

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.

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 de la latitude et de la longitude.

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 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 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.

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 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.

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.

Constantes
`MAX_BOUNDS`	LatLngBounds pour les limites maximales de la Terre. Ces limites engloberont 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` 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 : `other` : `LatLngBounds\|LatLngBoundsLiteral` 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.

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

Coordinates Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Classe LatLng

Constructeur

Méthodes

Interface LatLngLiteral

Propriétés

Classe LatLngBounds

Constructeur

Constantes

Méthodes

Interface LatLngBoundsLiteral

Propriétés

Classe LatLngAltitude

Coordinates