Geometry Library

Espace de noms encoding

Espace de noms google.maps.geometry.encoding

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

Accédez à en appelant 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 d'accès encodée en 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.

Espace de noms sphérique

Espace de noms google.maps.geometry.spherical

Fonctions utiles pour le calcul des angles, des distances et des zones géodésiques. Le rayon par défaut est de 6 378 137 mètres.

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

computeArea
computeArea(path[, radiusOfSphere])
Valeur renvoyée:number
Affiche la zone non signée d'un tracé fermé, comprise dans la plage [0, 2×pi×radius2]. La surface calculée utilise les mêmes unités que le rayon. Par défaut, radiusOfSphere utilise le rayon de la Terre en mètres, auquel cas la surface est en mètres carrés. La transmission d'un Circle nécessite que la radius soit définie sur une valeur non négative. En outre, le cercle ne doit pas couvrir plus de 100% de la sphère. Lorsque vous transmettez un LatLngBounds, le LatLng du 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 LatLngs. Vous pouvez éventuellement spécifier un rayon personnalisé. Le rayon par défaut est 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 horaire à partir du nord dans la plage [-180,180].
computeLength
computeLength(path[, radius])
Paramètres:
Valeur renvoyée:number
Renvoie la longueur du chemin 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 la direction spécifiée (exprimée en degrés dans le sens horaire à partir du nord).
computeOffsetOrigin
computeOffsetOrigin(to, distance, heading[, radius])
Paramètres:
Valeur renvoyée:LatLng|null
Renvoie le lieu d'origine lorsqu'il est fourni avec une destination LatLng, les mètres parcourus et un cap d'origine. Les titres 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 la zone signée d'un tracé fermé, dont le sens inverse des aiguilles d'une montre est positif, dans la plage [-2×pi×rayon2, 2×pi×rayon2]. 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 en mètres carrés. Cette méthode est plus simple, plus précise et plus efficace que la triangulation, avec Girard, l'Huilier ou Eriksson sur chaque triangle. En particulier, comme elle ne fait pas de triangulation, elle ne souffre d'aucune instabilité, sauf dans le cas inévitable où une arête (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 qui correspondent à la fraction de trajet spécifiée entre les origines LatLng et de 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 à en appelant 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 dans le 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, dans une tolérance spécifiée. Renvoie true lorsque la différence entre la latitude et la longitude du point fourni et du point le plus proche sur l'arête est inférieure à la tolérance. La tolérance par défaut est de 10-9 degrés.