Note : L'API Google Maps Javascript Version 3 documentées dans ces pages est désormais la version officielle de l'API Javascript. La version 2, quant à elle, a été officiellement déclarée obsolète par Google en Mai 2010, conformément à sa politique de dépréciation. Vous êtes donc conviés à migrer votre code vers cette nouvelle version améliorée et mise à jour régulièrement.
Bibliothèque géométrie sphérique
Les concepts présentés dans le présent document se réfèrent aux fonctionnalités uniquement disponibles dans la bibliothèque google.maps.geometry. Par défaut, la bibliothèque de géométrie sphérique n'est pas chargée lorsque vous appelez l'API Google Maps Javascript version 3, vous devez donc la spécifier de façon explicite à l'aide du paramètre libraries=geometry.
<script type="text/javascript" src="http://maps.googleapis.com/maps/api/js?libraries=geometry&sensor=true_OU_false"></script>
Important : dans la requête ci-dessus, le paramètre sensor a été laissé volontairement avec la variable true_OU_false afin de souligner que vous devez définir impérativement cette valeur de façon explicite sur true ou sur false.
La bibliothèque de géométrie sphérique google.maps.geometry de l'API Google Maps JavaScript V3 offre des fonctions utilitaires pour le calcul de données géométriques à la surface de la Terre. La bibliothèque comprend trois espaces de nommage :
spherical: contient des fonctions utilitaires dans le domaine de la géométrie sphérique permettant de calculer des angles, des distances et des surfaces à partir de latitudes et de longitudes.encoding: contient des fonctions utilitaires permettant l'encodage et le décodage de polylines à l'aide de l'algorithme d'encodage des polylines.poly: contient des fonctions utilitaires permettant d'effectuer des calculs liés aux polygones et polylines.
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 nommages cités ci-dessus.
google.maps.geometry.spherical.methode_statiquegoogle.maps.geometry.encoding.methode_statiquegoogle.maps.geometry.poly.methode_statique