Geometry Library

Classe encoding

Classe google.maps.geometry.encoding

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

Accédez-y en appelant le const {encoding} = await google.maps.importLibrary("geometry").
 Consultez 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.

Classe spherical

Classe google.maps.geometry.spherical

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

Accédez-y en appelant le const {spherical} = await google.maps.importLibrary("geometry").
 Consultez Bibliothèques de l'API Maps JavaScript.
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×radius²]. La superficie 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. Lorsque vous transmettez un LatLngBounds, le LatLng sud ne peut pas être plus au nord que le LatLng 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 correspond par défaut à celui 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 indiqué.
computeOffset
computeOffset(from, distance, heading[, radius])
Paramètres :
Valeur renvoyée : LatLng
Renvoie le LatLng résultant du déplacement d'une distance à partir d'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, une distance parcourue en mètres et un cap d'origine sont fournis. Les caps sont exprimés en degrés dans le sens horaire à 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 chemin fermé, où le sens inverse des aiguilles d'une montre 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 superficie 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 chemin fermé sur la sphère unité se tord d'un angle égal à l'aire délimité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 ne triangule pas, 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 à la fraction donnée du chemin entre le LatLng d'origine et le LatLng de destination.

Classe poly

Classe google.maps.geometry.poly

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

Accédez-y en appelant le const {poly} = await google.maps.importLibrary("geometry").
 Consultez Bibliothèques de l'API Maps JavaScript.
containsLocation
containsLocation(point, polygon)
Paramètres :
Valeur renvoyée : boolean
Indique si le point donné se trouve à l'intérieur du 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 sur le bord est inférieure à la tolérance. La tolérance est définie par défaut sur 10-9 degrés.