Geometry Library

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Espace de noms encoding

Espace de noms google.maps.geometry.encoding

Utilitaires d'encodage et de décodage de polylignes

Nécessite le paramètre d'URL &libraries=geometry. Consultez la section 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 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 calculer les angles géodésiques, les distances et les zones. Le rayon par défaut est de 6378137 mètres.

Nécessite le paramètre d'URL &libraries=geometry. Consultez la section Bibliothèques dans l'API Maps JavaScript.

computeArea
computeArea(path[, radius])
Paramètres:
Valeur renvoyée : number
Affiche la zone non signée d'un tracé fermé, comprise dans la plage [0, -2×pi×radius2]. La zone 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 l'aire est exprimée en mètres carrés.
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 correspond au rayon de la Terre.
computeHeading
computeHeading(from, to)
Paramètres:
Valeur renvoyée : number
Renvoie le cap d'un LatLng à un autre. Les titres 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 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 par rapport à une origine dans le cap spécifié (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 de départ lorsqu'il est associé à une destination LatLng, aux mètres parcourus et à un cap d'origine. Les titres 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
Affiche la zone signée d'un tracé fermé, dans le sens inverse des aiguilles d'une montre, dans la plage [-2×pi×rayon2, 2×pi×rayon2]. La zone 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 l'aire est exprimée en mètres carrés.

L'aire est calculée à l'aide de la méthode parallèle. Le transport parallèle autour d'un tracé fermé sur la sphère d'unité tord un angle identique à celui de la zone 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 elle ne s'effectue pas par 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 la valeur LatLng qui correspond à la fraction donnée du chemin entre l'origine LatLng et la destination LatLng.

Espace de noms poly

Espace de noms google.maps.geometry.poly

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

Nécessite le paramètre d'URL &libraries=geometry. Consultez la section 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é de celle-ci, ou au 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 en périphérie est inférieure à la tolérance. La valeur par défaut est de 10-9 degrés.