De migratiehandleiding voor azure Kaarten Web SDK

Bedankt dat u de Azure Kaarten Web SDK hebt gekozen voor uw toewijzingsbehoeften. Deze migratiehandleiding helpt u bij de overgang van v1 en v2 naar v3, zodat u kunt profiteren van de nieuwste functies en verbeteringen.

Inzicht in de wijzigingen

Voordat u het migratieproces start, is het belangrijk om vertrouwd te raken met de belangrijkste wijzigingen en verbeteringen die zijn geïntroduceerd in Web SDK v3. Bekijk de releaseopmerkingen om het bereik van de nieuwe functies te begrijpen.

De web-SDK-versie bijwerken

CDN

Als u CDN (content delivery network) gebruikt, werkt u de verwijzingen naar het v3-opmaakmodel en JavaScript bij in het head element van uw HTML-bestanden.

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

Als u npm gebruikt, werkt u bij naar het meest recente besturingselement van Azure Kaarten door de volgende opdracht uit te voeren:

npm install azure-maps-control@latest

Verificatiemethoden controleren (optioneel)

Om de beveiliging te verbeteren, worden er meer verificatiemethoden opgenomen in de Web SDK vanaf v2. De nieuwe methoden omvatten Microsoft Entra-verificatie en gedeelde sleutelverificatie. Zie Verificatie beheren in Azure Kaarten voor meer informatie over Azure Kaarten-webtoepassingsbeveiliging.

Testen

Uitgebreide tests zijn essentieel tijdens de migratie. Voer grondige tests uit van de functionaliteit, prestaties en gebruikerservaring van uw toepassing in verschillende browsers en apparaten.

Geleidelijke implementatie

Overweeg een geleidelijke implementatiestrategie voor de bijgewerkte versie. Laat de gemigreerde versie los naar een kleinere groep gebruikers of in een gecontroleerde omgeving voordat u deze beschikbaar maakt voor uw hele gebruikersbestand.

Door deze stappen te volgen en aanbevolen procedures te overwegen, kunt u uw toepassing migreren van Azure Kaarten Web SDK v1 en v2 naar v3. Maak gebruik van de nieuwe mogelijkheden en verbeteringen die worden geboden door de nieuwste versie en zorg voor een soepele en naadloze overgang voor uw gebruikers. Zie best practices voor Azure Kaarten Web SDK voor meer informatie.

Volgende stappen

Meer informatie over het toevoegen van kaarten aan web- en mobiele toepassingen met behulp van de JavaScript-bibliotheek aan de clientzijde van Map Control in Azure Kaarten: