Controllo delle versioni

Scelta del canale settimanale

Per la maggior parte delle applicazioni, consigliamo il canale settimanale. Questa è la versione più recente e aggiornata e contiene le ultime correzioni di bug e miglioramenti delle prestazioni. Puoi specificare il canale settimanale caricando l'API Maps JavaScript con il seguente tag script:

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

Al momento, il canale settimanale è la versione 3.62. Questa versione viene aggiornata settimanalmente con nuove funzionalità, correzioni di bug e miglioramenti delle prestazioni.

A metà novembre, il canale settimanale verrà aggiornato alla versione 3.63. In quel momento, la nuova versione potrebbe rimuovere le funzionalità ritirate e/o introdurre incompatibilità con le versioni precedenti.

Scegliere il canale trimestrale

Alcune applicazioni potrebbero trarre vantaggio da aggiornamenti meno frequenti ma più grandi, perché offrono una maggiore prevedibilità. Queste applicazioni devono utilizzare il canale trimestrale. Utilizza questo approccio se vuoi che le correzioni di bug e i miglioramenti delle prestazioni arrivino in un momento previsto (vedi aggiornamenti trimestrali). Puoi specificare il canale trimestrale caricando l'API Maps JavaScript con il seguente tag script:

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

Al momento, il canale trimestrale è la versione 3.61. Durante il trimestre, questa versione non riceve nuove funzionalità, correzioni di bug o miglioramenti delle prestazioni. Di tanto in tanto, potremmo introdurre correzioni di bug di sicurezza in questa versione.

A metà novembre, il canale trimestrale verrà aggiornato alla versione 3.62. A quel punto, la nuova versione includerà nuove funzionalità, rimuoverà quelle deprecate e/o introdurrà incompatibilità con le versioni precedenti nei tre mesi precedenti.

Scegliere il canale beta

Utilizza il canale beta per provare nuove funzionalità e modifiche beta. Le funzionalità beta sono complete, ma potrebbero presentare alcuni problemi in sospeso (utilizza Issue Tracker per segnalare problemi e fornire feedback). Il canale beta non è coperto da SLA (accordo sul livello del servizio) o da norme relative al ritiro e alcune modifiche potrebbero non essere retrocompatibili con le versioni precedenti.

Questo canale si basa sul canale weekly e viene aggiornato una volta alla settimana.

Puoi specificare il canale beta caricando l'API Maps JavaScript con il seguente tag script:

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

Scegliere il canale alfa

Utilizza il canale alpha per provare nuove funzionalità e modifiche sperimentali. Utilizza Issue Tracker per segnalare problemi e fornire feedback. Il canale alpha non è coperto da SLA (accordo sul livello del servizio) o da norme relative al ritiro e alcune modifiche potrebbero non essere retrocompatibili con le versioni precedenti. È solo a scopo di sviluppo e non deve essere utilizzato in produzione.

Questo canale si basa sul canale beta e viene aggiornato una volta alla settimana.

Puoi specificare il canale alfa caricando l'API Maps JavaScript con il seguente tag script:

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

Scegliere un numero di versione

Specifica una versione per numero solo se testi e aggiorni regolarmente l'applicazione. Questo perché le versioni numerate vengono eliminate man mano che vengono create nuove versioni ogni trimestre. Puoi specificare il numero di versione caricando l'API Maps JavaScript con il seguente tag script:

  <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.61,
  });
  </script>

Al momento, puoi specificare v=3.62, v=3.61, v=3.60 o v=3.59.

• La versione 3.62 riceve aggiornamenti settimanali con nuove funzionalità, correzioni di bug e miglioramenti delle prestazioni.
• La versione 3.61 non riceve aggiornamenti settimanali.
• La versione 3.60 non riceve aggiornamenti settimanali.
• La versione 3.59 non riceve aggiornamenti settimanali.
• Di tanto in tanto potremmo introdurre correzioni di bug di sicurezza in qualsiasi versione.
• Quando creiamo una nuova versione, potremmo introdurre modifiche incompatibili con le versioni precedenti.

Dopo metà novembre, potrai specificare v=3.63, v=3.62, v=3.61 o v=3.60.

• La versione 3.63 riceverà aggiornamenti settimanali con nuove funzionalità, correzioni di bug e miglioramenti delle prestazioni.
• La versione 3.62 non riceverà più aggiornamenti settimanali.
• La versione 3.61 non riceverà più aggiornamenti settimanali.
• La versione 3.60 non riceverà più aggiornamenti settimanali.
• Di tanto in tanto potremmo introdurre correzioni di bug di sicurezza in qualsiasi versione.
• La versione 3.59 non sarà più disponibile. Qualsiasi tentativo di caricamento di questa versione verrà ignorato e riceverai invece il canale predefinito.

Il diagramma seguente mostra le versioni che saranno disponibili in ogni canale nel corso del prossimo anno.

Un aggiornamento ha influito sulla mia applicazione

Quando aggiorniamo i canali di rilascio, ciò potrebbe influire sulla tua applicazione. Ciò potrebbe verificarsi perché la tua applicazione si basa su funzionalità non documentate o ritirate oppure a causa di un bug o di una correzione di bug che abbiamo introdotto.

Come soluzione alternativa temporanea, puoi riconfigurare l'applicazione in modo che utilizzi una versione precedente.

1. Apri la console negli strumenti per sviluppatori del browser e guarda il valore di google.maps.version.
2. Aggiorna il tag script che carica l'API e richiedi un numero di versione precedente.
   Ad esempio, se google.maps.version è "3.62.2", utilizza v=3.61 nel tag script.
   Questa soluzione temporanea funzionerà solo per un periodo di tempo limitato.

Una volta implementata la soluzione temporanea, avrai tempo (in genere da 3 a 6 mesi) per aggiornare l'applicazione in modo che non utilizzi più funzionalità non documentate o ritirate e per tenere conto di bug o correzioni di bug.

Dovresti quindi ripristinare il tag di script originale per caricare l'API.

Puoi anche creare una richiesta di assistenza o segnalare un problema.

Aggiornamenti trimestrali

Una volta al trimestre, il team dell'API Maps JavaScript rilascia una nuova versione. Ciò avviene a metà febbraio, metà maggio, metà agosto e metà novembre. Il prossimo aggiornamento verrà effettuato a metà novembre. Il nuovo canale settimanale fornirà la versione 3.63, e a quel punto gli altri canali verranno aggiornati.