Bibliothèques

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

Afin de charger le code JavaScript pour l'API Maps JavaScript, vous devez intégrer une URL d'amorçage à votre page, au format https://maps.googleapis.com/maps/api/js. Cette requête bootstrap charge tous les principaux objets et symboles JavaScript utilisés dans l'API Maps JavaScript. Certaines fonctionnalités de l'API sont également disponibles dans des bibliothèques autonomes qui ne sont pas chargées tant que vous n'en formulez pas spécialement la demande. Diviser les composants supplémentaires en bibliothèques permet à l'API principale de charger (et d'analyser) rapidement. Ainsi, vous n'entraînez une surcharge supplémentaire que lorsqu'une bibliothèque dont vous avez besoin doit être chargée et analysée.

Vous pouvez charger des bibliothèques supplémentaires en spécifiant un paramètre libraries dans la requête d'amorçage et en fournissant le nom de la ou des bibliothèques. Vous pouvez spécifier plusieurs bibliothèques sous forme de liste, en les séparant par une virgule. Vous accédez ensuite aux bibliothèques via l'espace de noms google.maps.libraryName.

Les bibliothèques suivantes sont disponibles :

  • drawing fournit une interface graphique permettant aux utilisateurs de dessiner des polygones, des rectangles, des polylignes, des cercles et des repères sur la carte. Pour en savoir plus, consultez la documentation de la bibliothèque Drawing.
  • geometry fournit des fonctions utilitaires pour calculer des valeurs géométriques scalaires (telles que des distances et des superficies) sur la surface de la Terre. Pour en savoir plus, consultez la documentation sur la bibliothèque Geometry.
  • journeySharing (disponible en version bêta uniquement) est compatible avec les solutions de transport et de logistique de Google Maps Platform.
  • localContext affiche les principaux lieux d'intérêt à proximité d'un emplacement que vous spécifiez. Pour en savoir plus, consultez la documentation de la bibliothèque de contexte local.
  • places permet à votre application de rechercher des lieux tels que des établissements, des emplacements géographiques ou des points d'intérêt dans une zone définie. Pour en savoir plus, consultez la documentation de la bibliothèque Places.
  • visualization fournit des cartes de densité pour représenter visuellement des données. Pour en savoir plus, consultez la documentation de la bibliothèque Visualization.

La requête d'amorçage suivante montre comment demander la bibliothèque google.maps.geometry de l'API Maps JavaScript :

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=geometry&callback=initMap">
</script>

Pour demander plusieurs bibliothèques, séparez-les avec une virgule :

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=geometry,places&callback=initMap">
</script>