Guida alla migrazione Mappe di Azure Web SDK v1

Grazie per aver scelto Mappe di Azure Web SDK per le esigenze di mapping. Questa guida alla migrazione consente di passare dalla versione 1 alla versione 3, consentendo di sfruttare le funzionalità e i miglioramenti più recenti.

Comprendere le modifiche

Prima di avviare il processo di migrazione, è importante acquisire familiarità con le modifiche chiave e i miglioramenti introdotti in Web SDK v3. Esaminare le note sulla versione per comprendere l'ambito delle nuove funzionalità.

Aggiornamento della versione di Web SDK

Rete CDN

Se si usa rete CDN (rete per la distribuzione di contenuti), aggiornare i riferimenti al foglio di stile e a JavaScript all'interno dell'elemento head dei file HTML.

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>

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 si usa npm, eseguire l'aggiornamento al controllo Mappe di Azure più recente eseguendo il comando seguente:

npm install azure-maps-control@latest

Esaminare i metodi di autenticazione (facoltativo)

Per migliorare la sicurezza, nell'SDK Web sono inclusi altri metodi di autenticazione a partire dalla versione 2. I nuovi metodi includono [Autenticazione di Microsoft Entra] e Autenticazione con chiave condivisa. Per altre informazioni sulla sicurezza delle applicazioni Web Mappe di Azure, vedere Gestire l'autenticazione in Mappe di Azure.

Test

I test completi sono essenziali durante la migrazione. Eseguire test approfonditi delle funzionalità, delle prestazioni e dell'esperienza utente dell'applicazione in browser e dispositivi diversi.

Implementazione graduale

Prendere in considerazione una strategia di implementazione graduale per la versione aggiornata. Rilasciare la versione migrata a un gruppo più piccolo di utenti o in un ambiente controllato prima di renderla disponibile per l'intera base utente.

Seguendo questa procedura e prendendo in considerazione le procedure consigliate, è possibile eseguire correttamente la migrazione dell'applicazione da Mappe di Azure WebSDK v1 alla versione 3. Adottare le nuove funzionalità e i miglioramenti offerti dalla versione più recente, garantendo al tempo stesso una transizione fluida e trasparente per gli utenti. Per altre informazioni, vedere Mappe di Azure Procedure consigliate per Web SDK.

Passaggi successivi

Informazioni su come aggiungere mappe alle applicazioni Web e per dispositivi mobili usando la libreria JavaScript sul lato client di Map Control in Mappe di Azure: