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 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.
  • Le numéro de version est spécifié avec v=n.nn.
    Vous pouvez choisir v=3.51, v=3.50, v=3.49 ou v=3.48.
    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 version 3.51. Cette version est mise à jour chaque semaine pour ajouter de nouvelles fonctionnalités, corriger des bugs et améliorer les performances.

À la mi-février, la version hebdomadaire sera mise à jour vers la version 3.52. 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 à un 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 version 3.50. 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-février, la version trimestrielle passera à la version 3.51. 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 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.50
        &key=YOUR_API_KEY&callback=initMap">
</script>

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

  • La version 3.51 reçoit des mises à jour hebdomadaires avec de nouvelles fonctionnalités, des corrections de bugs et des améliorations de performances.
  • La version 3.50 ne reçoit pas de mises à jour hebdomadaires.
  • La version 3.49 ne reçoit pas de mises à jour hebdomadaires.
  • La version 3.48 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-février, vous pourrez spécifier v=3.52, v=3.51, v=3.50 ou v=3.49.

  • La version 3.52 recevra des mises à jour hebdomadaires avec de nouvelles fonctionnalités, des corrections de bugs et des améliorations de performances.
  • La version 3.51 ne recevra plus de mises à jour hebdomadaires.
  • La version 3.50 ne recevra plus de mises à jour hebdomadaires.
  • La version 3.49 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.48 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.

15

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.51.2", utilisez v=3.50 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-février. La nouvelle version hebdomadaire fournira la version 3.52. Les autres canaux seront alors mis à jour.

Mise à jour du canal hebdomadaire

La version hebdomadaire redirige vers la version 3.51.

À la mi-février, la version hebdomadaire passera de la version 3.51 à la version 3.52. 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

La version trimestrielle pointe actuellement vers la version 3.50.

À la mi-février, la version trimestrielle passera de la version 3.50 à la version 3.51. 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-février, les numéros de version sont reportés afin de permettre la publication d'une nouvelle version.

Version 3.52

Une nouvelle version 3.52 sera publiée mi-février. 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.51. 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.51

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

Après la mi-février, 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 de fonctionnalités obsolètes et n'introduira pas d'incompatibilités ascendantes.

Version 3.50

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.49. 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.49

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.48. 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.48

Après la mi-février, 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'é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 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 :