Gestion des versions

L'équipe de l'API Maps JavaScript met régulièrement à jour l'API pour ajouter de nouvelles fonctionnalités, corriger des bugs et améliorer les performances. Cette page décrit les versions de l'API qui sont disponibles pour être utilisées dans votre application.

Canaux de versions et numéros de version

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

  • La version hebdomadaire est spécifiée avec v=weekly.
    Elle est mise à jour une fois par semaine. C'est la version la plus récente.
  • La version trimestrielle est spécifiée avec v=quarterly.
    Elle est mise à jour une fois par trimestre. C'est la version la plus prévisible.
  • La version bêta est spécifiée avec v=beta.
    Elle est basée sur la version weekly et est mise à jour une fois par semaine. Elle inclut des changements supplémentaires pour les tests préliminaires et les commentaires.
  • La version alpha est spécifiée avec v=alpha.
    Elle est basée sur la version beta et est mise à jour une fois par semaine. Elle inclut des tests de commentaires des clients sur les prototypes. Elle est réservée au développement et ne doit pas être utilisée en production.
  • Le numéro de version est spécifié avec v=n.nn.
    Vous pouvez choisir v=3.58, v=3.57, v=3.56 ou v=3.55.
    Les numéros de version sont mis à jour une fois par trimestre (voir Mises à jour trimestrielles).

Si vous ne spécifiez pas explicitement un canal de 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 de version ou une version, vous recevrez la version trimestrielle par défaut. Si vous spécifiez une version non valide, vous recevrez votre version par défaut.

Choisir la version hebdomadaire

Pour la plupart des applications, nous recommandons la version hebdomadaire. Il s'agit de la version la plus récente. Elle contient les dernières corrections de bugs et améliorations de performances. Vous pouvez spécifier la version hebdomadaire en chargeant l'API Maps JavaScript avec le tag de script suivant :

<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 3.58. Cette version est mise à jour chaque semaine pour ajouter de nouvelles fonctionnalités, corriger des bugs et améliorer les performances.

À la mi-novembre, le canal hebdomadaire passera au version 3.59. La nouvelle version risque alors de supprimer les fonctionnalités obsolètes et/ou d'introduire des incompatibilités ascendantes.

Choisir la version trimestrielle

Pour certaines applications, il peut s'avérer plus utile de bénéficier de mises à jour moins nombreuses, mais plus importantes, car cela augmente la prévisibilité. Ces applications doivent utiliser la version trimestrielle. Choisissez cette méthode si vous souhaitez que les corrections de bugs et les améliorations de performances soient disponibles à une date prévue (voir Mises à jour trimestrielles). Vous pouvez spécifier la version trimestrielle en chargeant l'API Maps JavaScript avec le tag de script suivant :

<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 3.57. 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, le canal trimestriel passera à la version 3.58. La nouvelle version comprendra alors de nouvelles fonctionnalités, supprimera les fonctionnalités obsolètes et/ou introduira des incompatibilités ascendantes cumulées au cours des trois mois précédents.

Choisir la version bêta

Utilisez la version bêta pour tester les nouvelles modifications et fonctionnalités bêta. Les fonctionnalités bêta sont complètes, mais peuvent comporter des problèmes en suspens. Veuillez utiliser Issue Tracker pour signaler les 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.

Elle est basée sur la version weekly et est mise à jour une fois par semaine.

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

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

Choisir la version alpha

Utilisez la version alpha pour tester de nouvelles fonctionnalités expérimentales et des modifications. Veuillez utiliser Issue Tracker pour signaler les problèmes et envoyer des commentaires. La version alpha 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. Elle est réservée au développement et ne doit pas être utilisée en production.

Elle est basée sur la version beta et est mise à jour une fois par semaine.

Vous pouvez spécifier la version alpha en chargeant l'API Maps JavaScript avec le tag de script suivant :

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

Choisir un numéro de version

N'indiquez une version via son numéro que si vous testez et mettez à jour votre application régulièrement. 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 le tag de script suivant :

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

Actuellement, vous pouvez spécifier v=3.58, v=3.57, v=3.56 ou v=3.55.

  • La version 3.58 reçoit des mises à jour hebdomadaires avec de nouvelles fonctionnalités, corrections de bugs et d'amélioration des performances.
  • La version 3.57 ne reçoit pas de mises à jour hebdomadaires.
  • La version 3.56 ne reçoit pas de mises à jour hebdomadaires.
  • La version 3.55 ne reçoit pas de mises à jour hebdomadaires.
  • De temps à autre, nous pouvons être amenés à corriger des bugs de sécurité dans n'importe quelle version.
  • Chaque nouvelle version que nous créons peut introduire des incompatibilités ascendantes.

Après la mi-novembre, vous pourrez spécifier v=3.59, v=3.58, v=3.57 ou v=3.56.

  • La version 3.59 recevra des mises à jour hebdomadaires avec de nouvelles fonctionnalités, corrections de bugs et d'amélioration des performances.
  • La version 3.58 ne recevra plus de mises à jour hebdomadaires.
  • La version 3.57 ne recevra plus de mises à jour hebdomadaires.
  • La version 3.56 ne recevra plus de mises à jour hebdomadaires.
  • De temps à autre, nous pouvons être amenés à corriger des bugs de sécurité dans n'importe quelle version.
  • La version 3.55 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 diagramme ci-dessous présente les versions disponibles pour chaque canal au cours de l'année à venir.

. . v=weekly v=trimestrielle v=3.nn v=3.nn-1 Août 2024 Nov. 2024 Févr. 2025 Mai 2025 v3.55 v3.56 v3.56 v3.57 v3.57 v3.57 v3.58 v3.58 v3.58 v3.58 v3.59 v3.59 v3.59 v3.60 v3.60 v3.61

Une mise à jour a affecté mon application

Lorsque des canaux versions sont mis à jour, cela peut affecter 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.

En guise de solution temporaire, vous pouvez reconfigurer votre application afin d'utiliser une version plus ancienne.

  1. Ouvrez la console dans les outils pour développeurs de votre 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.58.2", utilisez v=3.57 dans votre tag de script.
    Cette solution n'est que temporaire.

Une fois la solution temporaire 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, et tiendra compte des nouveaux bugs ou des nouvelles corrections de bugs.

Vous devrez ensuite rétablir le 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 (à la mi-février, à la mi-mai, à la mi-août et à la mi-novembre). La prochaine mise à jour aura lieu mi-novembre. Le nouveau canal hebdomadaire fournira la version 3.59, Les autres chaînes seront alors mises à jour.

Mise à jour du canal hebdomadaire

Le canal hebdomadaire actuel porte le numéro de version 3.58.

À la mi-novembre, le canal hebdomadaire passera de la version 3.58 à version 3.59. La nouvelle version comprendra de nouvelles fonctionnalités, supprimera les fonctionnalités obsolètes et/ou introduira des incompatibilités ascendantes. Vous devrez peut-être tester ces changements lorsque le canal sera mis à jour.

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

Mise à jour du canal trimestriel

Le canal trimestriel propose actuellement la version 3.57.

À la mi-novembre, le canal trimestriel passera à la version 3.57 à la version 3.58. La nouvelle version comprendra de nouvelles fonctionnalités, supprimera les fonctionnalités obsolètes et/ou introduira des incompatibilités ascendantes cumulées au cours des trois mois précédents. Vous devrez peut-être tester ces changements lorsque le canal sera mis à jour.

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

Mises à jour de versions

À la mi-novembre, les numéros de version seront reportés afin de s'adapter à l'arrivée d'une nouvelle version.

Version 3.59

La nouvelle version 3.59 sera disponible mi-novembre. Elle comprendra de nouvelles fonctionnalités, supprimer les fonctionnalités obsolètes, et/ou introduire des incompatibilités ascendantes par rapport à la version 3.58. Nous vous recommandons de tester votre application à chaque changement de numéro de version.

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

Version 3.58

Cette version comprend de nouvelles fonctionnalités, supprime des fonctionnalités obsolètes et/ou introduit des incompatibilités ascendantes par rapport à la version 3.57. Nous vous recommandons de tester votre application à chaque changement de numéro de version.

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

Version 3.57

Cette version comprend de nouvelles fonctionnalités, supprime des fonctionnalités obsolètes et/ou introduit des incompatibilités ascendantes par rapport à la version 3.56. Nous vous recommandons de tester votre application à chaque changement de numéro de version.

Cette version ne sera plus mise à jour avec de nouvelles fonctionnalités, corrections de bugs ni 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 ascendantes.

Version 3.56

Cette version comprend de nouvelles fonctionnalités, supprime des fonctionnalités obsolètes et/ou introduit des incompatibilités ascendantes par rapport à la version 3.55. Nous vous recommandons de tester votre application à chaque changement de numéro de version.

Cette version ne sera plus mise à jour avec de nouvelles fonctionnalités, corrections de bugs ni 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 ascendantes.

Version 3.55

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. Elles sont toutes les quatre compatibles.

Vérifications de version

En cas de problème, utilisez la propriété google.maps.version afin de connaître la version actuelle de l'API Maps JavaScript qu'utilise votre application. L'exemple 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 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?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 :