Annonce:De nouveaux styles de carte de base seront bientôt disponibles dans Google Maps Platform. Cette modification des styles de cartes inclut une nouvelle palette de couleurs par défaut, des épingles modernisées et une expérience utilisateur et une usabilité améliorées. 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 exprimé en 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 font le tour 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 la section 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.

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 cette valeur LatLng. Par défaut, nous arrondons les valeurs de latitude/longitude à six décimales.

Interface LatLngLiteral

Interface google.maps.LatLngLiteral

Pour plus de commodité, les littéraux d'objets sont acceptés à la place des objets LatLng dans 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 qui croise le méridien de longitude 180 degrés.

Accédez-y en appelant const {LatLngBounds} = await google.maps.importLibrary("core"). Consultez la section 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 englobent 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 ces limites sont approximativement égales aux limites données.
`extend`	`extend(point)` Paramètres: `point`: `LatLng\|LatLngLiteral` Valeur renvoyée:`LatLngBounds` Élargit ces limites pour inclure 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 le coin nord-est de ces limites.
`getSouthWest`	`getSouthWest()` Paramètres:aucun Valeur renvoyée:`LatLng` Renvoie le coin 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 carte données en 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 au coin sud-ouest du cadre de délimitation, tandis que "hi" correspond au coin nord-est de ce cadre.
`union`	`union(other)` Paramètres: `other`: `LatLngBounds\|LatLngBoundsLiteral` Valeur renvoyée:`LatLngBounds` Élargit ces limites pour inclure l'union de celles-ci et des limites données.

Interface LatLngBoundsLiteral

Interface google.maps.LatLngBoundsLiteral

Les littéraux d'objet sont acceptés à la place des objets LatLngBounds dans l'ensemble de 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 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 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 font le tour du globe.

Classe LatLngAltitude

Classe google.maps.LatLngAltitude

Un LatLngAltitude est un point 3D exprimé 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 font le tour du globe.
L'altitude est mesurée en mètres. Les valeurs positives indiquent les hauteurs au-dessus du niveau du sol, et les valeurs négatives les 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 la section 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 dans la plage [-90, 90] ou des valeurs de longitude valides comprises dans la plage [-180, 180]. La valeur par défaut est `false`, qui active le forçage de la latitude et le forçage 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, qui active le forçage de la latitude et le forçage 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 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 à la place des objets LatLngAltitude dans de nombreux endroits. Ils sont convertis en objets LatLngAltitude lorsque l'API Maps les rencontre.

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 signifie que l'élément 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 const {Point} = await google.maps.importLibrary("core"). Consultez la section Bibliothèques de 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 chaîne de ce point.

Classe Size

Classe google.maps.Size

Accédez-y en appelant const {Size} = await google.maps.importLibrary("core"). Consultez la section 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 à deux dimensions, où la largeur correspond à la distance sur l'axe X et la hauteur à 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 chaîne de cette taille.

Interface Padding

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 gauche, en pixels.
`right optional`	Type:`number optional` Marge intérieure droite, en pixels.
`top optional`	Type:`number optional` Marge supérieure, en pixels.

Interface CircleLiteral

Interface google.maps.CircleLiteral

Litérale 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) sur 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ématique standard en termes de cap, d'inclinaison et de roulis.

L'attribut "heading" est un angle compris dans la plage [0, 360] degrés.
tilt est un angle compris dans la plage [0, 360] degrés.
roll est un angle compris dans la plage [0, 360] degrés.

Cette classe implémente Orientation3DLiteral.

Accédez-y en appelant const {Orientation3D} = await google.maps.importLibrary("core"). Consultez la section 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 (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 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` 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

Interface google.maps.Orientation3DLiteral

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

Propriétés
`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 est effectuée 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 locaux X, Y et Z.

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

Interface Vector3DLiteral

Interface google.maps.Vector3DLiteral

Pour plus de commodité, les littéraux d'objets sont acceptés à la place des objets Vector3D dans de nombreux endroits. Ils sont convertis en objets Vector3D lorsque l'API 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.

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 Padding

Propriétés

Interface CircleLiteral

Propriétés

Classe Orientation3D

Constructeur

Propriétés

Méthodes

Interface Orientation3DLiteral

Propriétés

Classe Vector3D

Constructeur

Propriétés

Méthodes

Interface Vector3DLiteral

Propriétés