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

Espace de noms 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.
computeArea
computeArea(path[, radiusOfSphere])
Paramètres:
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:
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:
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:
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 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:
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:
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:
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.

Espace de noms poly

Espace de noms 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.
containsLocation
containsLocation(point, polygon)
Paramètres:
Valeur renvoyée:boolean
Détermine si le point donné se trouve dans le polygone spécifié.
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 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.