Controllo delle versioni

Il team dell'API Maps JavaScript aggiorna regolarmente l'API con nuove funzionalità, correzioni di bug e miglioramenti delle prestazioni. In questa pagina vengono descritte le versioni dell'API disponibili per l'uso nelle tue applicazioni.

Canali di rilascio e numeri di versione

Nella tua applicazione puoi specificare i canali di rilascio o i numeri di versione:

  • Il canale settimanale è specificato con v=weekly.
    Questo canale viene aggiornato una volta alla settimana ed è il più aggiornato.
  • Il canale trimestrale è specificato con v=quarterly.
    Questo canale viene aggiornato una volta ogni trimestre ed è il più prevedibile.
  • Il canale beta è specificato con v=beta.
    Questo canale si basa sul canale weekly e viene aggiornato una volta alla settimana. Sono incluse modifiche aggiuntive per i test iniziali e il feedback.
  • Il canale alpha è specificato con v=alpha.
    Questo canale si basa sul canale beta e viene aggiornato una volta alla settimana. Sono inclusi esperimenti per il feedback dei clienti sui prototipi. È destinato esclusivamente allo sviluppo e non deve essere utilizzato in produzione.
  • Il numero di versione è specificato con v=n.nn.
    Puoi scegliere v=3.58, v=3.57, v=3.56 o v=3.55.
    I numeri di versione vengono aggiornati una volta a trimestre (consulta la sezione Aggiornamenti trimestrali).

Se non specifichi esplicitamente un canale o una versione, per impostazione predefinita riceverai il canale settimanale. Se hai eseguito la migrazione dal piano Premium e non hai specificato esplicitamente un canale o una versione, per impostazione predefinita riceverai il canale trimestrale. Se specifichi una versione non valida, riceverai il tuo canale predefinito.

Scegliere il canale settimanale

Per la maggior parte delle applicazioni, consigliamo il canale settimanale. Questa è la versione più recente e aggiornata e contiene le correzioni di bug e i miglioramenti delle prestazioni più recenti. 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 è nella versione 3.58. 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.59. A quel punto, la nuova versione potrebbe rimuovere le funzionalità ritirate e/o introdurre incompatibilità con le versioni precedenti.

Scelta del 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 correzioni di bug e miglioramenti delle prestazioni arrivino nei tempi previsti (consulta gli 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>

Attualmente, il canale trimestrale è nella versione 3.57. 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.58. A quel punto, la nuova versione includerà nuove funzionalità, rimuoverà quelle deprecate e/o introdurrà incompatibilità con le versioni precedenti rispetto ai tre mesi precedenti.

Scegliere il canale beta

Utilizza il canale beta per provare le nuove funzionalità e le modifiche beta. Le funzionalità beta sono complete, ma potrebbero verificarsi alcuni problemi in sospeso (utilizza l'Issue Tracker per segnalare i problemi e fornire feedback). Il canale beta non è coperto da SLA (accordo sul livello del servizio) o da norme sul ritiro e alcune modifiche potrebbero non essere compatibili con le release 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 alpha

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 compatibili con le versioni precedenti. È destinato esclusivamente allo 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. Il motivo è che le versioni numerate vengono eliminate ogni trimestre man mano che vengono create nuove versioni. 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.57,
  });
  </script>

Al momento, puoi specificare v=3.58, v=3.57, v=3.56 o v=3.55.

  • La versione 3.58 riceve aggiornamenti settimanali con nuove funzionalità, correzioni di bug e miglioramenti delle prestazioni.
  • La versione 3.57 non riceve aggiornamenti settimanali.
  • La versione 3.56 non riceve aggiornamenti settimanali.
  • La versione 3.55 non riceve aggiornamenti settimanali.
  • Di tanto in tanto potremmo introdurre correzioni di bug di sicurezza in qualsiasi versione.
  • Potremmo introdurre modifiche non compatibili con le versioni precedenti durante la creazione di una nuova versione.

Dopo la metà di novembre, potrai specificare v=3.59, v=3.58, v=3.57 o v=3.56.

  • La versione 3.59 riceverà aggiornamenti settimanali con nuove funzionalità, correzioni di bug e miglioramenti delle prestazioni.
  • La versione 3.58 non riceverà più aggiornamenti settimanali.
  • La versione 3.57 non riceverà più aggiornamenti settimanali.
  • La versione 3.56 non riceverà più aggiornamenti settimanali.
  • Di tanto in tanto potremmo introdurre correzioni di bug di sicurezza in qualsiasi versione.
  • La versione 3.55 non sarà più disponibile. Qualsiasi tentativo di caricare questa versione verrà ignorato e riceverai il tuo canale predefinito.

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

v3.55v3.56v3.56v3.57v3.57v3.57v3.58v3.58v3.58v3.58v3.59v3.59v3.59v3.60v3.60v3.61

Un aggiornamento ha interessato la mia richiesta

L'aggiornamento dei canali di rilascio 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 da utilizzare una versione precedente.

  1. Apri la console negli strumenti per sviluppatori del browser e controlla 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.58.2", utilizza v=3.57 nel tag script.
    Questa soluzione alternativa 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 tenga conto di bug o correzioni di bug.

Devi 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 sarà disponibile a metà novembre. Il nuovo canale settimanale fornirà la versione 3.59 e, a quel punto, gli altri canali verranno aggiornati.

Aggiornamento settimanale del canale

Al momento il canale settimanale punta alla versione 3.58.

A metà novembre, il canale settimanale verrà aggiornato dalla versione 3.58 alla versione 3.59. A questo punto, la nuova versione includerà nuove funzionalità, rimuoverà quelle ritirate e/o introdurrà incompatibilità con le versioni precedenti. Potresti dover testare queste modifiche una volta aggiornato il canale.

Nel corso del trimestre, la nuova versione verrà aggiornata settimanalmente con nuove funzionalità, correzioni di bug e miglioramenti delle prestazioni. Non verranno rimosse le funzionalità ritirate e non verranno introdotte incompatibilità con le versioni precedenti.

Aggiornamento trimestrale del canale

Al momento il canale trimestrale si riferisce alla versione 3.57.

A metà novembre, il canale trimestrale verrà aggiornato dalla versione 3.57 alla versione 3.58. Al momento dell'aggiornamento, questa versione includerà nuove funzionalità, rimuoverà quelle obsolete e/o introdurrà incompatibilità con le versioni precedenti rispetto ai tre mesi precedenti. Potresti dover verificare la presenza di queste modifiche quando il canale viene aggiornato.

Nel corso del trimestre, questa versione non includerà nuove funzionalità, correzioni di bug o miglioramenti delle prestazioni. Non rimuoverà le funzionalità ritirate e non introdurrà incompatibilità con le versioni precedenti.

Aggiornamenti delle versioni

A metà novembre, verrà eseguito il rollback dei numeri di versione per includere il rilascio di una nuova versione.

Versione 3.59

A metà novembre verrà rilasciata una nuova versione 3.59. Al momento del rilascio, questa versione includerà nuove funzionalità, rimuoverà quelle ritirate e/o introdurrà incompatibilità con le versioni precedenti rispetto alla versione 3.58. Devi testare l'applicazione quando passi da un numero di versione all'altro.

Durante il trimestre, la nuova versione verrà aggiornata settimanalmente con nuove funzionalità, correzioni di bug e miglioramenti delle prestazioni. Non rimuoverà le funzionalità ritirate e non introdurrà incompatibilità con le versioni precedenti.

Versione 3.58

Questa versione include nuove funzionalità, rimuove le funzionalità deprecate e/o introduce incompatibilità con le versioni precedenti rispetto alla versione 3.57. Devi testare l'applicazione quando passi da un numero di versione all'altro.

Dopo metà novembre, questa versione non verrà più aggiornata con nuove funzionalità, correzioni di bug o miglioramenti delle prestazioni. Non rimuoverà le funzionalità ritirate e non introdurrà incompatibilità con le versioni precedenti.

Versione 3.57

Questa versione include nuove funzionalità, rimuove quelle non più supportate e/o introduce incompatibilità con le versioni precedenti rispetto alla versione 3.56. Devi testare l'applicazione quando passi da un numero di versione all'altro.

Questa versione non verrà più aggiornata con nuove funzionalità, correzioni di bug o miglioramenti delle prestazioni. Non verranno rimosse le funzionalità ritirate dopo questa versione e non verranno introdotte nuove incompatibilità con le versioni precedenti.

Versione 3.56

Questa versione include nuove funzionalità, rimuove le funzionalità deprecate e/o introduce incompatibilità con le versioni precedenti rispetto alla versione 3.55. Devi testare l'applicazione quando passi da un numero di versione all'altro.

Questa versione non verrà più aggiornata con nuove funzionalità, correzioni di bug o miglioramenti delle prestazioni. Non verranno rimosse le funzionalità ritirate dopo questa versione e non verranno introdotte nuove incompatibilità con le versioni precedenti.

Versione 3.55

Dopo metà novembre, questa versione verrà eliminata e non potrà più essere utilizzata. Qualsiasi tentativo di caricamento di questa versione verrà ignorato e riceverai invece il canale predefinito.

Supporto delle versioni

In un determinato trimestre sono disponibili quattro versioni. Sono supportate tutte e quattro le versioni.

Controlli delle versioni

Per il debug, utilizza la proprietà google.maps.version per ottenere la versione corrente dell'API Maps JavaScript nella tua applicazione. Il seguente codice di esempio scrive la versione dell'API nella console del browser. Per ulteriori informazioni sulla console del browser, consulta la guida alla verifica degli errori nel browser.

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

Documentazione per le versioni API

La guida per gli sviluppatori descrive sempre la versione settimanale.

Inoltre, esiste un riferimento gestito separatamente per ogni versione: