Bibliothèques

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 :

Aperçu : les bibliothèques suivantes sont disponibles en version bêta (v=beta) :

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 par une virgule :

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