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'utilizzo nelle 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 a 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 ulteriori modifiche per i test e i feedback in anteprima.
  • Il canale alfa è specificato con v=alpha.
    Questo canale si basa sul canale beta e viene aggiornato una volta alla settimana. Include esperimenti per il feedback dei clienti sui prototipi. È solo a scopo di sviluppo e non deve essere utilizzato in produzione.
  • Il numero di versione è specificato con v=n.nn.
    Puoi scegliere v=3.56, v=3.55, v=3.54 o v=3.53.
    I numeri delle versioni vengono aggiornati una volta a trimestre (consulta Aggiornamenti trimestrali).

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

Scegliere il canale settimanale

Per la maggior parte delle candidature, 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 di script:

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

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

A metà maggio, il canale settimanale verrà aggiornato alla versione 3.57. Da quel momento, la nuova versione potrebbe rimuovere funzionalità deprecate e/o introdurre incompatibilità con le versioni precedenti.

Scegliere il canale trimestrale

Alcune applicazioni possono trarre vantaggio da un numero inferiore di aggiornamenti, ma di dimensioni maggiori, perché offrono una maggiore prevedibilità. Queste candidature devono utilizzare il canale trimestrale. Utilizza questo approccio se vuoi che le correzioni di bug e i miglioramenti delle prestazioni arrivino nei tempi previsti (vedi gli aggiornamenti trimestrali). Puoi specificare il canale trimestrale caricando l'API Maps JavaScript con il seguente tag di script:

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

Attualmente, il canale trimestrale è la versione 3.55. 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à maggio, il canale trimestrale verrà aggiornato alla versione 3.56. Da quel momento, la nuova versione includerà nuove funzionalità, rimuoverà funzionalità 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 modifiche beta. Le funzionalità beta sono complete, ma potrebbero presentare alcuni problemi in sospeso (utilizza Issue Tracker per segnalare i problemi e fornire un 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 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 di script:

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

Scegliere il canale alfa

Utilizza il canale alfa per provare le nuove funzionalità e modifiche sperimentali. Utilizza Issue Tracker per segnalare i problemi e fornire un feedback. Il canale alfa non è coperto da SLA (accordo sul livello del servizio) o da norme sul ritiro e alcune modifiche potrebbero non essere compatibili 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 di script:

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

Scelta di un numero di versione

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

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

Al momento, puoi specificare v=3.56, v=3.55, v=3.54 o v=3.53.

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

Dopo metà maggio, potrai specificare v=3.57, v=3.56, v=3.55 o v=3.54.

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

Il diagramma seguente mostra quali versioni saranno disponibili in ciascun canale nel corso del prossimo anno.

v3.53v3.54v3.54v3.55v3.55v3.55v3.56v3.56v3.56v3.56v3.57v3.57v3.57v3.58v3.58v3.59

Un aggiornamento ha interessato la mia applicazione

L'aggiornamento dei canali di rilascio potrebbe influire sulla tua applicazione. Questo potrebbe verificarsi perché l'applicazione si basa su funzionalità non documentate o deprecate oppure per una correzione di bug o 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 osserva 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.56.2", utilizza v=3.55 nel tag script.
    Questa soluzione alternativa temporanea funzionerà solo per un periodo di tempo limitato.

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

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

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

Aggiornamenti trimestrali

Una volta a trimestre, il team dell'API Maps JavaScript rilascia una nuova versione. Questo si verifica metà febbraio, metà maggio, metà agosto e metà novembre. Il prossimo aggiornamento sarà a metà maggio. Il nuovo canale settimanale fornirà la versione 3.57 e da quel momento gli altri canali verranno aggiornati.

Aggiornamento settimanale del canale

Il canale settimanale attualmente rimanda alla versione 3.56.

A metà maggio, il canale settimanale verrà aggiornato dalla versione 3.56 alla versione 3.57. A questo punto, la nuova versione includerà nuove funzionalità, rimuoverà quelle deprecate e/o introdurrà incompatibilità con le versioni precedenti. Potresti dover testare queste modifiche quando il canale viene aggiornato.

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à deprecate e non introdurranno incompatibilità con le versioni precedenti.

Aggiornamento trimestrale del canale

Il canale trimestrale attualmente rimanda alla versione 3.55.

A metà maggio, il canale trimestrale verrà aggiornato dalla versione 3.55 alla versione 3.56. Dopo l'aggiornamento, questa versione includerà nuove funzionalità, rimuoverà quelle deprecate e/o introdurrà incompatibilità con le versioni precedenti dei tre mesi precedenti. Potresti dover testare 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 verranno rimosse le funzionalità deprecate e non introdurranno incompatibilità con le versioni precedenti.

Aggiornamenti della versione

A metà maggio, i numeri di versione verranno riportati per includere il rilascio di una nuova versione.

Versione 3.57

A metà maggio verrà rilasciata una nuova versione 3.57. Al momento del rilascio, questa versione includerà nuove funzionalità, rimuoverà funzionalità deprecate e/o introdurrà incompatibilità con le versioni precedenti rispetto alla versione 3.56. Dovresti testare la tua 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 verranno rimosse le funzionalità deprecate e non introdurranno incompatibilità con le versioni precedenti.

Versione 3.56

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

Dopo metà maggio, questa versione non verrà più aggiornata con nuove funzionalità, correzioni di bug o miglioramenti delle prestazioni. Non verranno rimosse le funzionalità deprecate e non introdurranno incompatibilità con le versioni precedenti.

Versione 3.55

Questa versione include nuove funzionalità, rimuove funzionalità deprecate e/o introduce incompatibilità con le versioni precedenti rispetto alla versione 3.54. Dovresti testare la tua 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à deprecate dopo questa versione e non introdurrà nuove incompatibilità con le versioni precedenti.

Versione 3.54

Questa versione include nuove funzionalità, rimuove funzionalità deprecate e/o introduce incompatibilità con le versioni precedenti rispetto alla versione 3.53. Dovresti testare la tua 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à deprecate dopo questa versione e non introdurrà nuove incompatibilità con le versioni precedenti.

Versione 3.53

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

Supporto delle versioni

Ogni trimestre sono disponibili quattro versioni. Sono supportate tutte e quattro queste versioni.

Controlli della versione

Per il debug, utilizza la proprietà google.maps.version per ottenere la versione corrente dell'API Maps JavaScript nella tua applicazione. Il seguente esempio di codice scrive la versione dell'API nella console del browser. Per ulteriori informazioni sulla console del browser, consulta la guida al controllo degli errori del 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: