Vous êtes prêt !

Pour passer à l'étape de développement, accédez à notre documentation pour les développeurs.

Activer Google Maps JavaScript API

Pour commencer, nous allons vous guider à travers la console Google Developers et effectuer deux ou trois petites choses :

  1. Créer ou sélectionner un projet
  2. Activer Google Maps JavaScript API et les services connexes
  3. Créer les clés appropriées
Continuer

Versionnage

L'équipe Google Maps JavaScript API met régulièrement à jour l'API avec de nouvelles fonctionnalités, des correctifs de bugs et des améliorations de la performance. Cette page décrit les versions de l'API qui sont disponibles pour utilisation dans votre application, que cela soit dans un environnement de test ou de production. Les versions de l'API ont les noms suivants :

  • Experimental
  • Release
  • Frozen

Nous proposons également des meilleures pratiques pour gérer vos procédures de versionnage en fonction du type ou de l'objectif de votre application.

Roulement des versions et types de version

Nous proposons chaque trimestre une nouvelle version numérotée et la rendons publique en tant que version Experimental. Au même moment, la précédente version Experimental devient la version Release et la précédente version Release devient la version Frozen. On appelle ce processus le roulement des versions.

Tout au long du trimestre, nous continuons à ajouter des correctifs de bugs à la version Experimental et à la version Release. Les mises à jour sont indiquées dans les notes de version de Google Maps JavaScript API.

Vous pouvez indiquer quelle version de l'API charger dans votre application en spécifiant le paramètre v de la requête bootstrap Google Maps JavaScript API. Les options suivantes sont prises en charge :

  • La version Experimental, indiquée par le paramètre v=3.exp.
  • La version Release, indiquée par le paramètre v=3.
  • Un numéro de version spécifique. Par exemple v=3.25 ou v=3.26.

Si vous utilisez le plan Standard et que vous ne spécifiez pas explicitement une version, vous recevrez la version Experimental par défaut (cela inclut les clients qui ne fournissent aucune clé). Si vous utilisez le plan Premium et que vous ne spécifiez aucune version, vous recevrez la version Release par défaut.

Version Experimental

La version Experimental, actuellement 3.27, contient les dernières fonctionnalités et les derniers correctifs de bugs rendus publics. Il n'est pas garanti que les modifications apportées à la version Experimental soient stables. Nous vous encourageons à régulièrement tester vos applications avec la version Experimental, ce que vous pouvez faire en ajoutant v=3.27 lorsque vous chargez l'API. Et si vous aimez prendre des risques, vous pouvez ajouter v=3.exp pour toujours recevoir la dernière version Experimental, avec toutes ses dernières fonctionnalités.

Vous pouvez spécifier la version Experimental avec la requête bootstrap suivante :

<script async defer
    src="https://maps.googleapis.com/maps/api/js?v=3.exp
        &key=YOUR_API_KEY&callback=initMap">

Version Release

Nous appliquons continuellement des correctifs de bugs à la version Release, tout en veillant à ce que l'ensemble des fonctionnalités reste stable. Les correctifs sont indiqués dans les notes de version.

L'actuelle version Release est 3.26. Vous pouvez la demander avec l'une ou l'autre des requêtes bootstrap suivantes :

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

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

Version Frozen

Lorsque nous publions une nouvelle version numérotée, nous gelons (Frozen) la précédente version Release, ce qui signifie que nous ne la mettons plus à jour avec des correctifs réguliers. Nous pouvons toutefois y apporter occasionnellement des modifications, par exemple pour des raisons juridiques.

À chaque fois que nous introduisons une nouvelle version Frozen, nous retirons la précédente version Frozen. Spécifier une version obsolète, par exemple v=3.0, renvoie toujours l'actuelle version Frozen.

L'actuelle version Frozen est 3.25. Vous pouvez la demander avec la requête bootstrap suivante :

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

Meilleures pratiques

L'équipe Google Maps JavaScript API met tout en œuvre pour garantir la compatibilité entre les différentes versions de l'API. Afin toutefois de continuer à fournir un service de pointe ainsi que pour des raisons opérationnelles, nous pouvons parfois apporter des modifications qui ont une incidence sur les fonctionnalités existantes. Le cas échéant, il pourrait s'avérer nécessaire d'apporter des ajustements au code utilisant Google Maps JavaScript API, afin qu'il continue de fonctionner comme prévu, en particulier pour les applications plus avancées. Vous trouverez ci-dessous les meilleures pratiques recommandées pour l'utilisation des versions, en fonction de différents scénarios courants.

Pour les applications à haute disponibilité / trafic élevé

Disposé à travailler plus pour garantir la stabilité et la disponibilité

Pour veiller à ce que le roulement des versions n'entraîne aucun problème, nous vous recommandons de spécifier explicitement le numéro de l'actuelle version Release de l'API dans la requête bootstrap. Par exemple, v=3.26. Afin d'éviter de vous retrouver avec la version Frozen de l'API à mesure que le temps passe, il est important de s'abonner aux notifications de Google sur le roulement des versions via le groupe Google Maps JS API v3 Notifications and Announcements.

Après un roulement de version (à chaque trimestre), votre système de production demandera la version Frozen de l'API. Nous vous recommandons de configurer à ce moment un environnement de transition/développement pour tester votre application avec la nouvelle version Release de l'API. En cas de problème, vous pourrez apporter les ajustements nécessaires à votre code. Lorsque vous êtes certain que votre application fonctionne parfaitement avec la nouvelle version Release de l'API, vous pouvez appliquer les correctifs nécessaires (le cas échéant) tout en mettant simultanément à jour votre application pour demander le numéro de version correspondant à la nouvelle version Release.

Pour les applications standard

Nous vous recommandons de spécifier v=3 dans votre requête bootstrap. Cela signifie que vous recevez toujours la dernière version Release de Google Maps JavaScript API, celle qui a déjà été sujette à un important volume de trafic et à laquelle les correctifs de bugs ont déjà été appliqués. Dans la plupart des cas, aucune action n'est nécessaire lors du roulement des versions. Toutefois, pour veiller à ce que votre application continue de bien fonctionner, nous vous recommandons de vous abonner aux notifications de Google sur le roulement des versions via le groupe Google Maps JS API v3 Notifications and Announcements.

Une fois un roulement terminé, votre application utilise une nouvelle version de Google Maps JavaScript API. Si vous le souhaitez, vous pouvez également consulter les notes de version pour connaître les changements qui pourraient vous affecter. Si vous remarquez que quelque chose ne fonctionne pas correctement dans votre application, vous pouvez revenir à la version précédente en spécifiant explicitement le numéro de l'actuelle version Frozen dans votre requête bootstrap et en profiter pour apporter les ajustements nécessaires à votre code.

Pour les applications de pointe

Bénéficier au plus vite des dernières fonctionnalités

En ce qui concerne les applications pour lesquelles une disponibilité constante est moins essentielle, nous vous recommandons d'installer les dernière fonctionnalités en demandant la version Experimental (v=3.exp) de Google Maps JavaScript API. La version Experimental est entièrement testée par Google avant d'être publiée chaque semaine et est en général relativement stable. Le cycle de publication hebdomadaire signifie toutefois que vous devez faire preuve d'une vigilance accrue pour veiller à ce que votre application continue de fonctionner comme prévu.

Vérifiez la version

Si vous rencontrez un problème, utilisez la propriété google.maps.version pour connaître la version de Google Maps JavaScript API qu'utilise votre application. L'échantillon de code suivant affiche la version de l'API dans la console du navigateur. (Pour en savoir plus sur la console du navigateur, voir le guide sur la vérification des erreurs dans le navigateur.)

<!DOCTYPE html>
<html>
  <head>
    <title>Display Google Maps API Version</title>
  </head>
  <body>
    <script>
      function initMap() {
        // Add your map here.
        console.log('Google Maps API version: ' + google.maps.version);
      }
    </script>
    <script src="https://maps.googleapis.com/maps/api/js?YOUR_API_KEY&callback=initMap"
    async defer></script>
  </body>
</html>

Documentation sur les versions de l'API

Le guide du développeur décrit toujours la version Experimental.

Il existe par ailleurs une référence tenue à jour séparément pour chaque version :

Envoyer des commentaires concernant…

Google Maps JavaScript API
Google Maps JavaScript API
Besoin d'aide ? Consultez notre page d'assistance.