Dela via


Migreringsguiden för Azure Kartor Web SDK

Tack för att du valde Azure Kartor Web SDK för dina mappningsbehov. Den här migreringsguiden hjälper dig att övergå från v1 och v2 till v3, så att du kan dra nytta av de senaste funktionerna och förbättringarna.

Förstå ändringarna

Innan du påbörjar migreringsprocessen är det viktigt att bekanta dig med de viktiga ändringar och förbättringar som introduceras i Web SDK v3. Granska viktig information för att förstå omfånget för de nya funktionerna.

Uppdatera webb-SDK-versionen

CDN

Om du använder CDN (innehållsleveransnätverk) uppdaterar du referenserna till v3-formatmallen och JavaScript i elementet head i HTML-filerna.

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>

v2

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

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 uppdaterar du till den senaste Azure-Kartor-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 ingår fler autentiseringsmetoder i Web SDK från och med v2. De nya metoderna omfattar Microsoft Entra-autentisering och autentisering med delad nyckel. Mer information om säkerhet för Azure Kartor-webbprogram finns i Hantera autentisering i Azure Kartor.

Testning

Omfattande testning är viktigt under migreringen. Utför noggranna tester av programmets funktioner, prestanda och användarupplevelse i olika webbläsare och enheter.

Gradvis distribution

Överväg en gradvis distributionsstrategi 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 användarbasen.

Genom att följa dessa steg och överväga metodtips kan du migrera ditt program från Azure Kartor Web SDK v1 och v2 till v3. Ta till dig de nya funktionerna och förbättringarna som erbjuds av den senaste versionen samtidigt som du säkerställer en smidig och smidig övergång för dina användare. Mer information finns i Metodtips för Azure Kartor Web SDK.

Nästa steg

Lär dig hur du lägger till kartor i webb- och mobilprogram med hjälp av JavaScript-biblioteket på map control-klientsidan i Azure Kartor: