Gestion des versions

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

L'équipe de l'API Maps JavaScript met régulièrement à jour l'API avec de nouvelles fonctionnalités, des corrections de bugs et des améliorations de performances. Cette page décrit les versions de l'API disponibles dans vos applications.

Versions et numéros de version

Dans votre application, vous pouvez spécifier des versions disponibles ou des numéros de version:

  • Le canal hebdomadaire est spécifié par v=weekly.
    Il s'agit de la version la plus récente : elle est mise à jour une fois par semaine.
  • Le canal trimestriel est indiqué par v=quarterly.
    C'est la version la plus prévisible, car elle est mise à jour une fois par trimestre.
  • La version bêta est spécifiée par v=beta.
    Cette chaîne est basée sur la chaîne weekly et est mise à jour une fois par semaine. Elle inclut des changements supplémentaires pour les tests préliminaires et les commentaires.
  • Le numéro de version est spécifié avec v=n.nn.
    Vous pouvez choisir les options v=3.50, v=3.49, v=3.48 ou v=3.47.
    Les numéros de version sont mis à jour une fois par trimestre (consultez la section Mises à jour trimestrielles).

Si vous ne spécifiez pas explicitement une version ou une version, vous recevrez la version hebdomadaire par défaut. Si vous avez migré à partir du forfait Premium et que vous n'avez pas spécifié explicitement un canal ou une version, vous recevrez le canal trimestriel par défaut. Si vous spécifiez une version non valide, vous recevrez votre version par défaut.

Choisir le canal hebdomadaire

Pour la plupart des applications, nous recommandons la version hebdomadaire. Il s'agit de la version la plus récente et la plus récente. Elle contient les derniers correctifs et améliorations de performances. Vous pouvez spécifier la version hebdomadaire en chargeant l'API Maps JavaScript avec la balise de script suivante:

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

Actuellement, la version hebdomadaire est la version 3.50. Cette version est mise à jour chaque semaine avec de nouvelles fonctionnalités, des corrections de bugs et des améliorations de performances.

À la mi-novembre, la version hebdomadaire sera mise à jour vers la version 3.51. La nouvelle version risque alors de supprimer les fonctionnalités obsolètes et/ou d'introduire des rétrocompatibilités.

Choisir le canal trimestriel

Certaines applications peuvent bénéficier de mises à jour moins nombreuses, mais plus importantes, car elles offrent une plus grande prévisibilité. Ces applications doivent utiliser la version trimestrielle. Utilisez cette approche si vous souhaitez que les corrections de bugs et les améliorations de performances soient disponibles à l'heure prévue (consultez les mises à jour trimestrielles). Vous pouvez spécifier le canal trimestriel en chargeant l'API Maps JavaScript avec la balise de script suivante:

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

Actuellement, la version trimestrielle est la version 3.49. Au cours du trimestre, cette version ne bénéficie pas des nouvelles fonctionnalités, des corrections de bugs ni des améliorations des performances. De temps à autre, nous pouvons être amenés à corriger des bugs de sécurité dans cette version.

À la mi-novembre, la version trimestrielle passera à la version 3.50. La nouvelle version comprendra alors de nouvelles fonctionnalités, supprimera les fonctionnalités obsolètes et/ou introduira des incompatibilités au cours des trois mois précédents.

Choisir la version bêta

Utilisez la version bêta pour tester les nouvelles fonctionnalités et modifications bêta. Les fonctionnalités bêta sont complètes, mais peuvent comporter des problèmes en suspens (veuillez utiliser l'outil de suivi des problèmes pour signaler des problèmes et envoyer des commentaires). La version bêta n'est couverte par aucun contrat de niveau de service ni règlement relatif aux abandons. Il est possible que certaines modifications ne soient pas rétrocompatibles avec les versions antérieures.

Cette chaîne est basée sur la chaîne weekly et est mise à jour une fois par semaine.

Vous pouvez spécifier la version bêta en chargeant l'API Maps JavaScript avec la balise de script suivante:

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

Choisir un numéro de version

Spécifiez une version par numéro uniquement si vous testez et mettez à jour régulièrement votre application. En effet, les versions numérotées sont supprimées à mesure que de nouvelles versions sont créées chaque trimestre. Vous pouvez spécifier le numéro de version en chargeant l'API Maps JavaScript avec la balise de script suivante:

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

Actuellement, vous pouvez spécifier v=3.50, v=3.49, v=3.48 ou v=3.47.

  • La version 3.50 reçoit des mises à jour hebdomadaires avec de nouvelles fonctionnalités, des corrections de bugs et des améliorations de performances.
  • La version 3.49 ne reçoit pas de mises à jour hebdomadaires.
  • La version 3.48 ne reçoit pas de mises à jour hebdomadaires.
  • La version 3.47 ne reçoit pas de mises à jour hebdomadaires.
  • Nous pouvons être amenés de temps à autre à intégrer des corrections de bugs de sécurité dans n'importe quelle version.
  • Nous pouvons être amenés à introduire des modifications incompatibles avec les versions antérieures lorsque vous créez une version.

Après la mi-novembre, vous pourrez spécifier v=3.51, v=3.50, v=3.49 ou v=3.48.

  • La version 3.51 recevra des mises à jour hebdomadaires avec de nouvelles fonctionnalités, des corrections de bugs et des améliorations de performances.
  • La version 3.50 ne recevra plus de mises à jour hebdomadaires.
  • La version 3.49 ne recevra plus de mises à jour hebdomadaires.
  • La version 3.48 ne recevra plus de mises à jour hebdomadaires.
  • Nous pouvons être amenés de temps à autre à intégrer des corrections de bugs de sécurité dans n'importe quelle version.
  • La version 3.47 ne sera plus disponible. Toute tentative de chargement de cette version sera ignorée, et vous recevrez votre version par défaut à la place.

Le schéma ci-dessous présente les versions disponibles pour chaque canal au cours de l'année à venir.

15

Une mise à jour a affecté ma demande

La mise à jour des versions disponibles peut avoir un impact sur votre application. Cela peut se produire lorsque votre application repose sur des fonctionnalités non documentées ou obsolètes, ou en raison d'un bug ou d'une correction de bug que nous avons introduits.

Pour contourner ce problème, vous pouvez reconfigurer votre application afin d'utiliser une version plus ancienne.

  1. Ouvrez la console dans vos outils de développement de navigateur et examinez la valeur de google.maps.version.
  2. Mettez à jour le tag de script qui charge l'API, puis demandez un numéro de version plus ancien.
    Par exemple, si google.maps.version est "3.50.2", utilisez v=3.49 dans votre tag de script.
    Cette solution temporaire ne fonctionne que pour une durée limitée.

Une fois que la solution temporaire aura été mise en œuvre, vous aurez le temps (généralement trois à six mois) de mettre à jour votre application. Elle n'utilisera donc plus de fonctionnalités non documentées ou obsolètes, ni de comptes pour les bugs ou les corrections de bugs.

Vous devez ensuite revenir au tag de script d'origine pour charger l'API.

Vous pouvez également créer une demande d'assistance ou signaler un problème.

Mises à jour trimestrielles

Une fois par trimestre, l'équipe de l'API Maps JavaScript publie une nouvelle version. Cela se produit à la mi-février, à la mi-mai, à la mi-août et à la mi-novembre. La prochaine mise à jour aura lieu mi-novembre. La nouvelle version hebdomadaire fournira la version 3.51. Les autres canaux seront alors mis à jour.

Actualités hebdomadaires de la chaîne

La version hebdomadaire redirige vers la version 3.50.

À la mi-novembre, la version hebdomadaire passera de la version 3.50 à la version 3.51. À ce stade, la nouvelle version inclura de nouvelles fonctionnalités, supprimera les fonctionnalités obsolètes et/ou introduira des incompatibilités. Vous devrez peut-être tester ces changements lorsque la chaîne sera mise à jour.

Au cours du trimestre, la nouvelle version sera mise à jour chaque semaine pour inclure de nouvelles fonctionnalités, des corrections de bugs et des améliorations de performances. Elle ne supprimera pas les fonctionnalités obsolètes et n'introduira pas d'incompatibilités.

Informations trimestrielles sur les chaînes

La version trimestrielle pointe actuellement vers la version 3.49.

À la mi-novembre, la version trimestrielle passera de la version 3.49 à la version 3.50. Lors de la mise à jour, cette version inclura de nouvelles fonctionnalités, supprimera les fonctionnalités obsolètes et/ou introduira des incompatibilités au cours des trois mois précédents. Vous devrez peut-être tester ces changements lorsque la chaîne sera mise à jour.

Dans le courant du trimestre, cette version ne comprendra pas de nouvelles fonctionnalités, de corrections de bugs ni d'améliorations des performances. Elle ne supprimera pas les fonctionnalités obsolètes et n'introduira pas d'incompatibilités.

Mises à jour de révisions

À la mi-novembre, les numéros de version sont reportés afin de permettre la publication d'une nouvelle version.

Version 3.51

Une nouvelle version 3.51 sera disponible mi-novembre. Lors de la publication, cette version inclura de nouvelles fonctionnalités, supprimera les fonctionnalités obsolètes et/ou introduira des incompatibilités par rapport à la version 3.50. Nous vous recommandons de tester votre application lorsque vous changez de numéro de version.

Au cours du trimestre, la nouvelle version sera mise à jour chaque semaine pour inclure de nouvelles fonctionnalités, des corrections de bugs et des améliorations de performances. Elle ne supprimera pas les fonctionnalités obsolètes et n'introduira pas d'incompatibilités.

Version 3.50

Cette version inclut de nouvelles fonctionnalités, supprime les fonctionnalités obsolètes et/ou introduit des incompatibilités par rapport à la version 3.49. Nous vous recommandons de tester votre application lorsque vous changez de numéro de version.

Après la mi-novembre, cette version ne sera plus mise à jour avec les nouvelles fonctionnalités, les corrections de bugs ni les améliorations des performances. Elle ne supprimera pas les fonctionnalités obsolètes et n'introduira pas d'incompatibilités.

Version 3.49

Cette version inclut de nouvelles fonctionnalités, supprime les fonctionnalités obsolètes et/ou introduit des rétrocompatibilités par rapport à la version 3.48. Nous vous recommandons de tester votre application lorsque vous changez de numéro de version.

Cette version ne sera plus mise à jour avec les nouvelles fonctionnalités, les corrections de bugs ni les améliorations des performances. Elle ne supprimera pas les fonctionnalités obsolètes après cette version et n'introduira pas de nouvelles incompatibilités.

Version 3.48

Cette version inclut de nouvelles fonctionnalités, supprime les fonctionnalités obsolètes et/ou introduit des incompatibilités par rapport à la version 3.47. Nous vous recommandons de tester votre application lorsque vous changez de numéro de version.

Cette version ne sera plus mise à jour avec les nouvelles fonctionnalités, les corrections de bugs ni les améliorations des performances. Elle ne supprimera pas les fonctionnalités obsolètes après cette version et n'introduira pas de nouvelles incompatibilités.

Version 3.47

Après la mi-novembre, cette version sera supprimée et ne pourra plus être utilisée. Toute tentative de chargement de cette version sera ignorée, et vous recevrez votre version par défaut à la place.

Compatibilité avec les versions

Au cours d'un trimestre donné, quatre versions sont disponibles. Ces quatre versions sont compatibles.

Vérifications de version

Pour le débogage, utilisez la propriété google.maps.version pour obtenir la version actuelle de l'API Maps JavaScript dans 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, consultez le guide sur la vérification des erreurs dans votre 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?key=YOUR_API_KEY&callback=initMap"
    defer></script>
  </body>
</html>

Documentation sur les versions de l'API

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

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