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 canaleweekly
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 canalebeta
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 sceglierev=3.58
,v=3.57
,v=3.56
ov=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.
Il diagramma seguente mostra le versioni disponibili in ciascun canale nel corso del prossimo anno.
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.
- Aprite la console negli strumenti per sviluppatori del browser e osservate il valore
google.maps.version
- Aggiornare il tag di script che carica l'API e
richiedi un numero di versione precedente.
Ad esempio, segoogle.maps.version
è "3.58.2", utilizzav=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:
- Riferimento API versione 3.58 (canale settimanale)
- Riferimento API della versione 3.57 (canale trimestrale)
- Riferimento API della versione 3.56
- Riferimento API versione 3.55
- Le versioni dalla 3.0 alla 3.54 sono state eliminate.