Gestion des versions

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>
    (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
      key: "YOUR_API_KEY",
      v: "weekly",
    });
  </script>
  

Actuellement, la version du canal 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 à la 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>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "quarterly",
  });
  </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>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "beta",
  });
  </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>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "alpha",
  });
  </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>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: 3.57,
  });
  </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 améliorations 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 améliorations 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.

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. La nouvelle version hebdomadaire fournira la version 3.59. Les autres versions seront alors mises à jour.