Controllo delle versioni

Il team dell'API Maps JavaScript aggiorna regolarmente l'API con nuovi funzioni, correzioni di bug e miglioramenti delle prestazioni. In questa pagina vengono descritti i disponibili per l'uso 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 a settimana ed è il più attuale.
  • Il canale trimestrale è specificato con v=quarterly.
    Questo canale viene aggiornato una volta al 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. Include ulteriori modifiche per i primi test e feedback.
  • 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.58, v=3.57, v=3.56 o v=3.55.
    I numeri di versione vengono aggiornati una volta al trimestre (consulta la sezione 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 indicare esplicitamente un canale o una versione, riceverai il canale trimestrale per impostazione predefinita. Se specifica una versione non valida, riceverai il tuo canale predefinito.

Scegliere il canale settimanale

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

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

Attualmente, la versione del canale settimanale è la 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 a Versione 3.59. In quel momento, la nuova versione potrebbe rimuovere le funzionalità deprecate e/o introdurre incompatibilità con le versioni precedenti.

Scelta del canale trimestrale

Alcune applicazioni potrebbero trarre vantaggio da un numero minore di aggiornamenti, ma di dimensioni maggiori, perché offrono 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 quanto segue tag di script:

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

Attualmente, la versione del canale trimestrale è la 3.57. Durante il trimestre, questa versione non riceve nuove funzioni, 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à le funzionalità deprecate, e/o introdurre incompatibilità con le versioni precedenti dei tre mesi precedenti.

Scegliere il canale beta

Usa il canale beta per provare le nuove funzionalità beta e i cambiamenti. Funzionalità beta sono funzionalità complete, ma potrebbero presentare problemi in sospeso (utilizza Issue Tracker per segnalare problemi e fornire feedback). Il canale beta non è coperto da nessuna SLA o norme sul ritiro e alcune modifiche potrebbero non essere compatibili con le versioni precedenti 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 lo script seguente :

<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 nuove funzionalità e modifiche sperimentali. Utilizza Issue Tracker per segnalare problemi e fornire feedback. Il canale alfa non è coperto da SLA (accordo sul livello del servizio) o da 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 lo script seguente :

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

Scelta del numero di versione

Specifica una versione in base al numero solo se test e aggiorni regolarmente la tua applicazione. Il motivo è che le versioni numerate vengono poi 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 async
    src="https://maps.googleapis.com/maps/api/js?v=3.57
        &key=YOUR_API_KEY&callback=initMap">
</script>

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

  • La versione 3.58 riceve aggiornamenti settimanali con nuove funzioni, 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 per la sicurezza in qualsiasi versione.
  • Potremmo introdurre modifiche non compatibili con le versioni precedenti durante la creazione di una nuova versione.

Dopo metà novembre, potrai specificare v=3.59, v=3.58, v=3.57, oppure v=3.56.

  • La versione 3.59 riceverà aggiornamenti settimanali con nuove funzioni, 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 per la sicurezza in qualsiasi versione.
  • La versione 3.55 non sarà più disponibile. Qualsiasi tentativo di caricamento di questa versione verrà ignorato e riceverai invece il tuo canale predefinito.
di Gemini Advanced.

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

v=weekly v=trimestrale v=3.nn v=3.nn-1 Agosto 2024 Novembre 2024 Febbraio 2025 Maggio 2025 v3.55 v3.56 v3.56 v3.57 v3.57 v3.57 v3.58 v3.58 v3.58 v3.58 v3.59 v3.59 v3.59 v3.60 v3.60 v3.61

Un aggiornamento ha interessato la mia applicazione

L'aggiornamento dei canali di rilascio potrebbe influire sulla tua applicazione. Ciò può accadere perché l'applicazione si basa su funzionalità non documentate o deprecate oppure a causa di un bug o di un bug che abbiamo introdotto.

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

  1. Aprite la console negli strumenti per sviluppatori del browser e osservate il valore google.maps.version
  2. Aggiornare il tag di 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 applicata la soluzione alternativa temporanea, avrai tempo (in genere da 3 a 6 mesi) per Aggiornare l'applicazione in modo che non utilizzi più account e funzionalità non documentate o deprecate per trovare bug o correzioni di bug.

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

Puoi anche creare un richiesta di assistenza o segnala un problema.

Aggiornamenti trimestrali

Una volta ogni trimestre, il team dell'API Maps JavaScript rilascia una nuova versione. Ciò accade a metà febbraio, metà maggio, metà agosto e metà novembre. Il prossimo aggiornamento sarà a metà novembre. Il nuovo canale settimanale fornirà la versione 3.59, e gli altri canali verranno aggiornati.

Aggiornamento settimanale del canale

Attualmente il canale settimanale rimanda 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à le funzionalità deprecate, e/o introdurre 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 rimuoverà le funzionalità deprecate e non introdurrà 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. Dopo l'aggiornamento, questa versione includerà nuove funzionalità, rimuoverà le funzionalità deprecate, e/o introdurre incompatibilità con le versioni precedenti dei tre mesi precedenti. Potresti dover testare queste modifiche una volta aggiornato il canale.

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

Aggiornamenti delle versioni

A metà novembre, i numeri di versione verranno trasferiti 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à le funzionalità deprecate, e/o introdurre 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 funzioni, correzioni di bug e miglioramenti delle prestazioni. Non rimuoverà le funzionalità deprecate e non introdurrà incompatibilità con le versioni precedenti.

Versione 3.58

Questa versione include nuove funzionalità, rimuove 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à deprecate e non introdurrà incompatibilità con le versioni precedenti.

Versione 3.57

Questa versione include nuove funzionalità, rimuove funzionalità deprecate 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à deprecate dopo questa versione e non ne verranno introdotti nuovi 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. 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à deprecate dopo questa versione e non ne verranno introdotti nuovi 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 il tuo canale predefinito .

Supporto delle versioni

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

Controlli della versione

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