Eseguire la migrazione di Mappe di Azure Web SDK Map Control v1 e v2.0.x alla v3

Mappe di Azure Web SDK Map Control v1 e Map Control versioni da 2.0.0 a 2.0.32 sono state ritirate. Aggiorna tutte le applicazioni che utilizzano queste versioni a Map Control v3. Questa guida spiega come completare la migrazione.

Informazioni sulle modifiche

Prima di iniziare il processo di migrazione, è importante familiarizzare con i principali cambiamenti e miglioramenti introdotti nel Web SDK v3. Esamina le note di rilascio per comprendere l'ambito delle nuove funzionalità.

Aggiornamento della versione Web SDK

CDN

Se stai usando una CDN (content delivery network), aggiorna il foglio di stile e i riferimenti JavaScript nell'elemento head dei tuoi file HTML.

Prima della migrazione: Map Control v1

<link rel="stylesheet" href="https://atlas.microsoft.com/sdk/css/atlas.min.css?api-version=1" type="text/css" />
<script src="https://atlas.microsoft.com/sdk/js/atlas.min.js?api-version=1"></script>

Prima della migrazione: Map Control v2

Il percorso generico Map Control v2 CDN carica l'ultima versione v2, non una specifica versione v2.0.x. Pertanto, questo URL da solo non indica che un'applicazione utilizzi una versione v2.0.x interessata:

<link rel="stylesheet" href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/2/atlas.min.css" type="text/css" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/2/atlas.min.js"></script>

Per le applicazioni che installano Map Control tramite npm, controlla la versione risolta azure-maps-control nel file di blocco del pacchetto. Le versioni dalla 2.0.0 alla 2.0.32 furono ritirate.

Dopo la migrazione: Map Control v3

<link rel="stylesheet" href="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3/atlas.min.css" type="text/css" />
<script src="https://atlas.microsoft.com/sdk/javascript/mapcontrol/3/atlas.min.js"></script>

npm

Se stai usando npm, aggiorna all'ultima versione del controllo Mappe di Azure eseguendo il seguente comando:

npm install azure-maps-control@latest

Rivedi i metodi di autenticazione (opzionale)

Per migliorare la sicurezza, più metodi di autenticazione sono inclusi nel Web SDK a partire dalla v2. I nuovi metodi includono l'autenticazione Microsoft Entra e l'autenticazione con chiave condivisa. Per maggiori informazioni sulla sicurezza delle applicazioni web di Mappe di Azure, vedi Gestire l'autenticazione in Mappe di Azure.

Testing

Test completi sono essenziali durante la migrazione. Effettua test approfonditi sulle funzionalità, le prestazioni e l'esperienza utente della tua applicazione su diversi browser e dispositivi.

Distribuzione graduale

Considera una strategia di distribuzione graduale per la versione aggiornata. Rilascia la versione migrata a un gruppo più piccolo di utenti o in un ambiente controllato prima di renderla disponibile a tutta la tua base di utenti.

Seguendo questi passaggi e considerando le migliori pratiche, puoi migrare la tua applicazione da Mappe di Azure Web SDK Map Control v1 o v2.0.x a v3. Per maggiori informazioni, consulta le migliori pratiche di Mappe di Azure Web SDK.

Passaggi successivi

Scopri come aggiungere mappe alle applicazioni web e mobili utilizzando la libreria JavaScript lato client di Map Control in Mappe di Azure: