De nouveaux styles de cartes seront bientôt disponibles dans Google Maps Platform. Cette modification des styles de cartes inclut une nouvelle palette de couleurs par défaut, et améliore l'expérience utilisateur et l'usabilité des cartes. Tous les styles de cartes seront automatiquement mis à jour en mars 2025. Pour en savoir plus sur la disponibilité et la façon de s'inscrire plus tôt, consultez Nouveau style de carte pour Google Maps Platform.

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

Coordinates

Classe LatLng

Classe google.maps.LatLng

Un LatLng est un point au niveau de ses 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 à [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, elle sera définie sur -90. Et 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 renvoyées afin qu'elles soient comprises dans cette 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 couvrent le monde entier.

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 voulez 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. Par conséquent, les méthodes 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);

Pour y accéder, appelez 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 indiquée en degrés compris dans la plage [-90, 90]. La longitude est spécifiée en degrés compris dans la plage [-180, 180]. Définissez `noClampNoWrap` sur `true` pour activer des valeurs en dehors de cette plage. Notez l'ordre des coordonnées de latitude et de 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 indiquée en degrés compris dans la plage [-90, 90]. La longitude est spécifiée en degrés compris dans la plage [-180, 180]. Définissez noClampNoWrap sur true pour activer des valeurs en dehors de cette plage. Notez l'ordre des coordonnées de latitude et de 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 sous forme 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, les valeurs lat/lng sont arrondies à 6 décimales.

Interface LatLngLiteral

Interface google.maps.LatLngLiteral

Pour plus de commodité, les littéraux d'objets sont acceptés à de nombreux endroits à la place des objets LatLng. Ceux-ci 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'objets LatLng ne sont pas pris en charge dans la bibliothèque Geometry.

Propriétés
`lat`	Type:`number` Latitude en degrés. Les valeurs seront limitées à [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, elle sera définie sur -90. Et 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] sont encapsulées de sorte qu'elles soient comprises dans cette 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 couvrent le monde entier.

Classe LatLngBounds

Classe google.maps.LatLngBounds

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

Pour y accéder, appelez 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 aux angles sud-ouest et nord-est.

Constantes
`MAX_BOUNDS`	LatLngBounds pour les limites maximales de la Terre. Ces limites s'étendront à l'ensemble du globe.

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 cette limite est approximativement égale 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 cette limite.
`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 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 intervalle 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

Interface google.maps.LatLngBoundsLiteral

Les littéraux d'objets sont acceptés à la place des objets LatLngBounds dans l'API. Ces éléments sont automatiquement convertis en objets LatLngBounds. Tous les paramètres 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 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 couvrent le monde entier.
`north`	Type:`number` Latitude nord en degrés. Les valeurs seront limitées à [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, elle sera définie sur -90. Et 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 à [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, elle sera définie sur -90. Et 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 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 couvrent le monde entier.

Classe LatLngAltitude

Classe google.maps.LatLngAltitude

Un LatLngAltitude est un point 3D utilisant 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 à [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, elle sera définie sur -90. Et 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 renvoyées afin qu'elles soient comprises dans cette 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 couvrent le monde entier.
L'altitude est mesurée en mètres. Les valeurs positives correspondent aux hauteurs au-dessus du sol, et les valeurs négatives aux hauteurs sous la surface du sol.

Cette classe implémente LatLngAltitudeLiteral.

Cette classe implémente LatLngLiteral.

Pour y accéder, appelez 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` 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 dans la plage [-90, 90], ou des valeurs de longitude valides comprises dans la plage [-180, 180]. La valeur par défaut est `false`, ce qui active la limitation de la latitude et l'encapsulation de la longitude.

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 dans la plage [-90, 90], ou des valeurs de longitude valides comprises dans la plage [-180, 180]. La valeur par défaut est false, ce qui active la limitation 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` un autre objet LatLngAltitude. Return Value (Valeur renvoyée) : `boolean` si les deux objets sont égaux. Fonction de comparaison.
`toJSON`	`toJSON()` Paramètres:aucun Return Value (Valeur renvoyée) : `LatLngAltitudeLiteral`. Représentation JSON de cet objet.

Interface LatLngAltitudeLiteral

Interface google.maps.LatLngAltitudeLiteral

Pour plus de commodité, les littéraux d'objets sont acceptés à de nombreux endroits à la place des objets LatLngAltitude. Ceux-ci sont convertis en objets LatLngAltitude lorsque l'API Google Maps les rencontre.

Cette interface étend LatLngLiteral.

Propriétés
`altitude`	Type:`number` Par défaut:`0` Distance (en mètres) au-dessus du sol. Une valeur négative signifie sous la surface du sol.
`lat`	Type:`number` Latitude en degrés. Les valeurs seront limitées à [-90, 90]. Cela signifie que si la valeur spécifiée est inférieure à -90, elle sera définie sur -90. Et 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] sont encapsulées de sorte qu'elles soient comprises dans cette 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 couvrent le monde entier.

Classe Point

Classe google.maps.Point

Pour y accéder, appelez 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 dans 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` 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

Pour y accéder, appelez 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 bidimensionnelle, où la largeur est la distance sur l'axe des x et la hauteur est la distance sur l'axe des 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 les deux tailles.
`toString`	`toString()` Paramètres:aucun Valeur renvoyée: `string` Renvoie une représentation de cette taille sous forme de chaîne.

Interface Marge intérieure

Interface google.maps.Padding

Propriétés
`bottom optional`	Type:`number optional` Marge intérieure de la partie 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 pour la partie 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` Centre du cercle.
`radius`	Type:`number` Le rayon en mètres sur la surface de la Terre.
Hérité:`clickable`, `draggable`, `editable`, `fillColor`, `fillOpacity`, `map`, `strokeColor`, `strokeOpacity`, `strokePosition`, `strokeWeight`, `visible`, `zIndex`

Coordinates

Classe LatLng

Constructeur

Méthodes

Interface LatLngLiteral

Propriétés

Classe LatLngBounds

Constructeur

Constantes

Méthodes

Interface LatLngBoundsLiteral

Propriétés

Classe LatLngAltitude

Constructeur

Propriétés

Méthodes

Interface LatLngAltitudeLiteral

Propriétés

Classe Point

Constructeur

Propriétés

Méthodes

Classe Size

Constructeur

Propriétés

Méthodes

Interface Marge intérieure

Propriétés

Interface CircleLiteral

Propriétés