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.

Geometry Library

Espace de noms encoding

Espace de noms google.maps.geometry.encoding

Utilitaires d'encodage et de décodage des polylignes.

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

Méthodes statiques
`decodePath`	`decodePath(encodedPath)` Paramètres: `encodedPath`: `string` Valeur renvoyée:`Array<LatLng>` Décode une chaîne de tracé encodée en séquence de LatLngs.
`encodePath`	`encodePath(path)` Paramètres: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` Valeur renvoyée:`string` Encode une séquence de LatLngs en chaîne de tracé encodée.

Classe sphérique

Classe google.maps.geometry.spherical

Fonctions utilitaires pour calculer des angles, des distances et des surfaces géodésiques. Le rayon par défaut est celui de la Terre, soit 63 781 37 mètres.

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

Méthodes statiques
`computeArea`	`computeArea(path[, radiusOfSphere])` Paramètres: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>\|Circle\|CircleLiteral\|LatLngBounds\|LatLngBoundsLiteral` `radiusOfSphere`: `number optional` Valeur renvoyée:`number` Renvoie la surface non signée d'un tracé fermé, dans la plage [0, 2 × pi × rayon²]. La surface calculée utilise les mêmes unités que le rayon. La valeur par défaut de `radiusOfSphere` correspond au rayon de la Terre en mètres, auquel cas la superficie est exprimée en mètres carrés. Si vous transmettez un `Circle`, vous devez définir `radius` sur une valeur non négative. De plus, le cercle ne doit pas recouvrir plus de 100% de la sphère. De plus, lorsque vous passez un `LatLngBounds`, la latitude sud ne peut pas être plus au nord que la latitude nord.
`computeDistanceBetween`	`computeDistanceBetween(from, to[, radius])` Paramètres: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` `radius`: `number optional` Valeur renvoyée:`number` Renvoie la distance, en mètres, entre deux valeurs LatLng. Vous pouvez éventuellement spécifier un rayon personnalisé. Le rayon correspond par défaut au rayon de la Terre.
`computeHeading`	`computeHeading(from, to)` Paramètres: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` Valeur renvoyée:`number` Renvoie le cap d'un point LatLng à un autre. Les caps sont exprimés en degrés dans le sens des aiguilles d'une montre à partir du nord, dans la plage [-180,180).
`computeLength`	`computeLength(path[, radius])` Paramètres: `path`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` `radius`: `number optional` Valeur renvoyée:`number` Renvoie la longueur du chemin d'accès donné.
`computeOffset`	`computeOffset(from, distance, heading[, radius])` Paramètres: `from`: `LatLng\|LatLngLiteral` `distance`: `number` `heading`: `number` `radius`: `number optional` Valeur renvoyée:`LatLng` Renvoie les coordonnées LatLng résultant d'un déplacement d'une distance à partir d'un point d'origine dans la direction spécifiée (exprimée en degrés dans le sens des aiguilles d'une montre à partir du nord).
`computeOffsetOrigin`	`computeOffsetOrigin(to, distance, heading[, radius])` Paramètres: `to`: `LatLng\|LatLngLiteral` `distance`: `number` `heading`: `number` `radius`: `number optional` Valeur renvoyée:`LatLng\|null` Renvoie le lieu d'origine lorsqu'une destination LatLng, la distance parcourue et le cap d'origine sont fournis. Les caps sont exprimés en degrés dans le sens des aiguilles d'une montre à partir du nord. Cette fonction renvoie `null` lorsqu'aucune solution n'est disponible.
`computeSignedArea`	`computeSignedArea(loop[, radius])` Paramètres: `loop`: `Array<LatLng\|LatLngLiteral>\|MVCArray<LatLng\|LatLngLiteral>` `radius`: `number optional` Valeur renvoyée:`number` Renvoie l'aire signée d'un tracé fermé, où le sens antihoraire est positif, dans la plage [-2 × pi × rayon², 2 × pi × rayon²]. L'aire calculée utilise les mêmes unités que le rayon. Le rayon est défini par défaut sur le rayon de la Terre en mètres, auquel cas la surface est exprimée en mètres carrés. La surface est calculée à l'aide de la méthode de transport parallèle. Le transport parallèle autour d'un chemin fermé sur la sphère unité se tord d'un angle égal à la surface enclose par le chemin. Cette méthode est plus simple, plus précise et plus robuste que la triangulation utilisant Girard, l'Huilier ou Eriksson pour chaque triangle. En particulier, comme il ne triangule pas, il ne souffre d'aucune instabilité, sauf dans le cas inévitable où un côté (et non une diagonale) du polygone s'étend sur 180 degrés.
`interpolate`	`interpolate(from, to, fraction)` Paramètres: `from`: `LatLng\|LatLngLiteral` `to`: `LatLng\|LatLngLiteral` `fraction`: `number` Valeur renvoyée:`LatLng` Renvoie les coordonnées LatLng correspondant à la fraction donnée du trajet entre les coordonnées LatLng de l'origine et de la destination.

Classe poly

Classe google.maps.geometry.poly

Fonctions utilitaires pour les calculs impliquant des polygones et des polylignes.

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

Méthodes statiques
`containsLocation`	`containsLocation(point, polygon)` Paramètres: `point`: `LatLng\|LatLngLiteral` `polygon`: `Polygon` Valeur renvoyée:`boolean` Détermine si le point donné se trouve dans le polygone spécifié.
`isLocationOnEdge`	`isLocationOnEdge(point, poly[, tolerance])` Paramètres: `point`: `LatLng\|LatLngLiteral` `poly`: `Polygon\|Polyline` `tolerance`: `number optional` Valeur renvoyée:`boolean` Détermine si le point donné se trouve sur une polyligne ou à proximité, ou sur le périmètre d'un polygone ou à proximité, dans une tolérance spécifiée. Renvoie `true` lorsque la différence entre la latitude et la longitude du point fourni, et le point le plus proche du bord, est inférieure à la tolérance. La tolérance est définie par défaut sur 10^-9 degrés.

Méthodes statiques

containsLocation

containsLocation(point, polygon)

Paramètres:

point: LatLng|LatLngLiteral
polygon: Polygon

Valeur renvoyée:boolean

Détermine si le point donné se trouve dans le polygone spécifié.

isLocationOnEdge

isLocationOnEdge(point, poly[, tolerance])

Paramètres:

point: LatLng|LatLngLiteral
poly: Polygon|Polyline
tolerance: number optional

Valeur renvoyée:boolean

Détermine si le point donné se trouve sur une polyligne ou à proximité, ou sur le périmètre d'un polygone ou à proximité, dans une tolérance spécifiée. Renvoie true lorsque la différence entre la latitude et la longitude du point fourni, et le point le plus proche du bord, est inférieure à la tolérance. La tolérance est définie par défaut sur 10^-9 degrés.