Geometry Library

encoding, espace de noms

google.maps.geometry.encoding espace de noms

Utilitaires d'encodage et de décodage des polylignes

Pour y accéder, appelez const {encoding} = await google.maps.importLibrary("geometry"). Consultez Bibliothèques dans l'API Maps JavaScript.

decodePath
decodePath(encodedPath)
Paramètres: 
  • encodedPathstring
Valeur renvoyée:  Array<LatLng>
Décode une chaîne de chemin encodée en une séquence de LatLngs.
encodePath
encodePath(path)
Valeur renvoyée:  string
Encode une séquence de LatLngs dans une chaîne de chemin encodée.

spherical espace de noms

google.maps.geometry.spherical espace de noms

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 de 6378137 mètres.

Pour y accéder, appelez const {spherical} = await google.maps.importLibrary("geometry"). Consultez Bibliothèques dans l'API Maps JavaScript.

computeArea
computeArea(path[, radiusOfSphere])
Paramètres: 
Valeur renvoyée:  number
Renvoie la zone non signée d'un tracé fermé, dans la plage [0, 2×pi×radius2]. L'aire calculée utilise les mêmes unités que le rayon. radiusOfSphere 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 transmission d'un élément Circle nécessite que l'élément radius soit défini sur une valeur non négative. De plus, le cercle ne doit pas recouvrir plus de 100% de la sphère. Lorsque vous transmettez une valeur LatLngBounds, la latitude LatLng sud ne peut pas être supérieure au nord.
computeDistanceBetween
computeDistanceBetween(from, to[, radius])
Paramètres: 
Valeur renvoyée:  number
Renvoie la distance, en mètres, entre deux LatLngs. Vous pouvez éventuellement spécifier un rayon personnalisé. Par défaut, le rayon est celui de la Terre.
computeHeading
computeHeading(from, to)
Paramètres: 
Valeur renvoyée:  number
Renvoie le titre 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 tracé 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 à partir d'un point de départ 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 de départ lorsque la destination LatLng, le nombre de mètres parcourus et l'orientation d'origine sont fournies. 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é, dans le sens inverse des aiguilles d'une montre, dans la plage [-2×pi×radius2, 2×pi×radius2]. L'aire calculée utilise les mêmes unités que le rayon. Par défaut, le rayon est le rayon de la Terre en mètres, auquel cas la surface est exprimée en mètres carrés.

L'aire est calculée à l'aide de la méthode de transport parallèle. Le transport parallèle autour d'un tracé fermé sur la sphère unitaire s'ajuste selon un angle égal à la surface délimitée par le tracé. Cette méthode est plus simple, plus précise et plus robuste que la triangulation avec Girard, l'Huilier ou Eriksson sur chaque triangle. En particulier, comme il n'est pas triangulé, il ne souffre d'aucune instabilité, sauf dans le cas inévitable où un arête (pas une diagonale) du polygone s'étend sur 180 degrés.
interpolate
interpolate(from, to, fraction)
Paramètres: 
Valeur renvoyée:  LatLng
Renvoie la valeur LatLng, qui correspond à la fraction donnée de la distance entre la valeur LatLng de départ et la destination LatLng.

espace de noms poly

google.maps.geometry.poly espace de noms

Fonctions utilitaires pour les calculs impliquant des polygones et des polylignes

Pour y accéder, appelez const {poly} = await google.maps.importLibrary("geometry"). Consultez Bibliothèques dans l'API Maps JavaScript.

containsLocation
containsLocation(point, polygon)
Paramètres: 
Valeur renvoyée:  boolean
Calcule si le point donné se trouve à l'intérieur du polygone spécifié.
isLocationOnEdge
isLocationOnEdge(point, poly[, tolerance])
Paramètres: 
Valeur renvoyée:  boolean
Calcule si le point donné se trouve sur une polyligne ou à proximité, ou sur le bord d'un polygone, avec 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 bord est inférieure à la tolérance. La tolérance par défaut est de 10-9 degrés.