Geometry Library

Espace de noms encoding

namespace google.maps.geometry.encoding
library "geometry"

Utilitaires pour l'encodage et le décodage des polylignes.

const {encoding} = await google.maps.importLibrary("geometry");
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 :
Valeur renvoyée : string
Encode une séquence de LatLngs en chaîne de tracé encodée.

Espace de noms spherical

namespace google.maps.geometry.spherical
library "geometry"

Fonctions utilitaires permettant de calculer des angles, des distances et des zones géodésiques. Le rayon par défaut est le rayon de la Terre, soit 6 378 137 mètres.

const {spherical} = await google.maps.importLibrary("geometry");
computeArea
computeArea(path[, radiusOfSphere])
Paramètres :
Valeur renvoyée : number
Renvoie la superficie non signée d'un tracé fermé, dans la plage [0, 2 × pi × rayon²]. La superficie calculée utilise les mêmes unités que le rayon. La valeur par défaut de radiusOfSphere est le rayon de la Terre en mètres, auquel cas la superficie est exprimée en mètres carrés. Pour transmettre un Circle, vous devez définir radius sur une valeur non négative. De plus, le cercle ne doit pas couvrir plus de 100 % de la sphère. Lorsque vous transmettez un LatLngBounds, la latitude/longitude sud ne peut pas être plus au nord que la latitude/longitude nord.
computeDistanceBetween
computeDistanceBetween(from, to[, radius])
Paramètres :
Valeur renvoyée : number
Renvoie la distance, en mètres, entre deux LatLng. Vous pouvez éventuellement spécifier un rayon personnalisé. Le rayon par défaut est le rayon de la Terre.
computeHeading
computeHeading(from, to)
Paramètres :
Valeur renvoyée : number
Renvoie le cap d'un LatLng à un autre LatLng. 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 :
Valeur renvoyée : number
Renvoie la longueur du chemin d'accès donné.
computeOffset
computeOffset(from, distance, heading[, radius])
Paramètres :
Valeur renvoyée : LatLng
Renvoie la valeur LatLng résultant du déplacement d'une distance depuis une origine dans le cap spécifié (exprimé en degrés dans le sens des aiguilles d'une montre à partir du nord).
computeOffsetOrigin
computeOffsetOrigin(to, distance, heading[, radius])
Paramètres :
Valeur renvoyée : LatLng|null
Renvoie le lieu d'origine lorsqu'une destination LatLng, la distance parcourue en mètres 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 :
Valeur renvoyée : number
Renvoie la zone signée d'un chemin fermé, où le sens inverse des aiguilles d'une montre est positif, dans la plage [-2×pi×radius², 2×pi×radius²]. La zone calculée utilise les mêmes unités que le rayon. Le rayon par défaut est le rayon de la Terre en mètres, auquel cas la superficie est exprimée en mètres carrés.

La zone 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 unitaire se tord selon un angle égal à la zone entourée par le chemin. Cette méthode est plus simple, plus précise et plus robuste que la triangulation utilisant Girard, l'Huilier ou Eriksson sur chaque triangle. En particulier, comme il n'effectue pas de triangulation, il ne souffre d'aucune instabilité, sauf dans le cas inévitable où un bord (et non une diagonale) du polygone s'étend sur 180 degrés.
interpolate
interpolate(from, to, fraction)
Paramètres :
Valeur renvoyée : LatLng
Renvoie le LatLng qui se trouve à une fraction donnée de la distance entre le LatLng d'origine et le LatLng de destination.
AlphatraversePath
traversePath(path, fraction)
Paramètres :
Valeur renvoyée : LatLngLiteral
Renvoie la position qui se trouve à la fraction donnée du chemin d'accès donné. Si vous transmettez des objets LatLngAltitude, l'altitude est actuellement ignorée, mais les versions ultérieures pourront en tenir compte.

Espace de noms poly

namespace google.maps.geometry.poly
library "geometry"

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

const {poly} = await google.maps.importLibrary("geometry");
containsLocation
containsLocation(point, polygon)
Paramètres :
Valeur renvoyée : boolean
Détermine si le point donné se trouve à l'intérieur du polygone ou du cercle spécifié. Pour transmettre un Circle, vous devez définir center et définir radius sur une valeur non négative.
isLocationOnEdge
isLocationOnEdge(point, poly[, tolerance])
Paramètres :
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, 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 sur le périmètre, est inférieure à la tolérance. La tolérance par défaut est de 10-9 degrés.