Géométrie sphérique avec la bibliothèque Geometry Library

Bibliothèque géométrie sphérique - Geometry Library

Les fonctionnalités présentées ici sont uniquement disponibles dans l'espace de nommage google.maps.geometry.

Par défaut, la bibliothèque de géométrie sphérique n'est pas intégrée dans l'API Google Maps JavaScript V3. Il faut donc préciser que l'on souhaite l'utiliser. Pour ce faire, lorsque vous appelez le script de l'API Google Maps Javascript version 3, vous devez indiquer de façon explicite le chargement de cette bibliothèque en ajoutant le paramètre libraries=geometry dans l'URL du script:

<script async defer src="https://maps.googleapis.com/maps/api/js?key=InsérezVotreCléApiGoogleMapsIci&libraries=geometry&callback=initialisation"></script>

La bibliothèque géométrie sphérique (Geometry Library), de l'API Google Maps JavaScript V3, offre des fonctions utilitaires afin d'effectuer des calculs relatifs à la géométrie sphérique. La bibliothèque comprend trois espaces de nommage :

• google.maps.geometry.spherical : contenant des fonctions utilitaires permettant de calculer un angle, calculer une distance et calculer une surface à partir des latitude et longitude de points.
  
  
• google.maps.geometry.encoding : contenant des fonctions utilitaires permettant d'encoder les coordonnées d'un polygone ou d'une polyline et de décoder les coordonnées d'un polygone ou d'une polyline à l'aide de l'algorithme d'encodage des polylines.
  
  
• google.maps.geometry.poly : contenant des fonctions utilitaires permettant d'effectuer des tests afin de déterminer si un point donné est situé sur, à proximité ou en dehors de la bordure d'un polygone ou si un point donné est situé sur, à proximité ou en dehors d'une polyline.
  
  

La bibliothèque de géométrie sphérique google.maps.geometry ne contient aucune classe, mais uniquement des méthodes statiques dans les espaces de nommage cités ci-dessus.

Fonctions pour calculer un angle, une distance ou une surface

Espace de nommage google.maps.geometry.spherical :

• google.maps.geometry.spherical.computeArea() : calcule la surface, en mètre carré, d'un tracé fermé ( rectangle, cercle, polygone, etc. ),
• google.maps.geometry.spherical.computeDistanceBetween() : Calcule la distance entre deux points LatLng
• google.maps.geometry.spherical.computeHeading() : calcule le cap, en degrès, à suivre pour aller du point A au point B,
• google.maps.geometry.spherical.computeLength() : calcule la longueur, en mètre, d'un chemin ou tracé.
• google.maps.geometry.spherical.computeOffset() : calcule les coordonnées GPS du point d'arrivée à partir :
  • des coordonnées GPS du point de départ,
  • de la distance à parcourir,
  • du cap,
• google.maps.geometry.spherical.computeOffsetOrigin() : calcule les coordonnées GPS du point de départ à partir :
  • des coordonnées GPS du point d'arrivée,
  • de la distance à parcourir,
  • du cap,
• google.maps.geometry.spherical.computeSignedArea() : calcule l'aire signée d'un tracé fermé,
• google.maps.geometry.spherical.interpolate() : calcule les coordonnées GPS d'un point placé sur le tracé séparant deux points connus from et to, et situé à une distance fractionnaire du point de départ,

Fonctions pour encoder ou décoder les coordonnées d'un polygone ou d'une polyline

Espace de nommage google.maps.geometry.encoding :

• google.maps.geometry.encoding.decodePath() : décode la chaîne encodée d'un tracé en une séquence ordonnée de points LatLng,
• google.maps.geometry.encoding.encodePath() : encode une séquence ordonnée de LatLng en une chaîne codée représentant le tracé,

Fonctions pour tester si un marqueur est hors, dans ou sur un polygone ou une polyline

Espace de nommage google.maps.geometry.poly :

• google.maps.geometry.poly.containsLocation() : calcule si le point donné se trouve à l'intérieur du polygone spécifié,
• google.maps.geometry.poly.isLocationOnEdge() :
  • pour une polyline : calcule si le point donné se trouve sur, à proximité ou en dehors d'une polyligne, en tenant compte de la tolérance spécifiée
  • pour un polygone : calcule si le point donné se trouve sur, à proximité ou en dehors de la bordure d'un polygone, en tenant compte de la tolérance spécifiée