Migrera Azure Maps Web SDK Map Control v1 och v2.0.x till v3

Azure Maps Web SDK Map Control v1 och Map Control versionerna 2.0.0 till 2.0.32 är pensionerade. Uppgradera alla program som använder dessa versioner till Map Control v3. Denna guide förklarar hur man genomför migrationen.

Förstå utmaningarna

Innan du påbörjar migreringsprocessen är det viktigt att bekanta dig med de viktigaste förändringarna och förbättringarna som introducerats i Web SDK v3. Läs versionsanteckningarna för att förstå omfattningen av de nya funktionerna.

Uppdatering av Web SDK-versionen

CDN

Om du använder ett CDN (content delivery network), uppdatera stilmallen och JavaScript-referenserna i elementet head i dina HTML-filer.

Före migreringen: 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>

Före migreringen: Map Control v2

Den generiska Map Control v2 CDN-vägen laddar den senaste v2-versionen, inte en specifik v2.0.x-version. Därför innebär denna URL ensam inte att en applikation använder en påverkad version av v2.0.x:

<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>

För applikationer som installerar Map Control via npm, kontrollera den upplösta azure-maps-control versionen i paketlåsfilen. Versioner från 2.0.0 till 2.0.32 togs ur bruk.

Efter migreringen: 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

Om du använder npm, uppdatera till den senaste versionen av Azure Maps-kontrollen genom att köra följande kommando:

npm install azure-maps-control@latest

Granska autentiseringsmetoder (valfritt)

För att förbättra säkerheten inkluderas fler autentiseringsmetoder i Web SDK från och med v2. De nya metoderna inkluderar Microsoft Entra-autentisering och Shared Key Authentication. För mer information om Azure Maps webbapplikationssäkerhet, se Hantera autentisering i Azure Maps.

Testing

Omfattande testning är avgörande under migrationen. Genomför noggranna tester av din applikations funktionalitet, prestanda och användarupplevelse i olika webbläsare och enheter.

Gradvis utrullning

Överväg en gradvis utrullningsstrategi för den uppdaterade versionen. Släpp den migrerade versionen till en mindre grupp användare eller i en kontrollerad miljö innan du gör den tillgänglig för hela din användarbas.

Genom att följa dessa steg och ta hänsyn till bästa praxis kan du migrera din applikation från Azure Maps Web SDK Map Control v1 eller v2.0.x till v3. För mer information, se Azure Maps Web SDK bästa praxis.

Nästa steg

Lär dig hur du lägger till kartor i webb- och mobilapplikationer med hjälp av Map Control-klientsidan JavaScript-biblioteket i Azure Maps: