Migreer Azure Maps Web SDK-kaartbesturingselement v1 en v2.0.x naar v3

Azure Maps Web SDK Map Control v1 en Map Control versies 2.0.0 tot en met 2.0.32 zijn buiten gebruik gesteld. Upgrade alle applicaties die deze versies gebruiken naar Map Control v3. Deze gids legt uit hoe je de migratie kunt voltooien.

De wijzigingen begrijpen

Voordat je begint met het migratieproces, is het belangrijk om jezelf vertrouwd te maken met de belangrijkste wijzigingen en verbeteringen die zijn geïntroduceerd in Web SDK v3. Bekijk de release notes om de omvang van de nieuwe functies te begrijpen.

De Web SDK-versie updaten

CDN

Als je een CDN (content delivery network) gebruikt, werk dan het stylesheet en de JavaScript-referenties bij in het head element van je HTML-bestanden.

Voor migratie: 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>

Voor migratie: Map Control v2

Het generieke Map Control v2 CDN-pad laadt de nieuwste v2-release, niet een specifieke v2.0.x-release. Daarom geeft deze URL alleen niet aan dat een applicatie een getroffen versie v2.0.x gebruikt:

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

Voor applicaties die Map Control via npm installeren, controleer de opgeloste azure-maps-control versie in het package lock-bestand. Versies van 2.0.0 tot en met 2.0.32 werden buiten gebruik gesteld.

Na migratie: 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

Als je npm gebruikt, update dan naar de nieuwste versie van de Azure Maps-besturing door het volgende commando uit te voeren:

npm install azure-maps-control@latest

Bekijk authenticatiemethoden (optioneel)

Om de beveiliging te verbeteren, zijn er vanaf v2 meer authenticatiemethoden opgenomen in de Web SDK. De nieuwe methoden omvatten Microsoft Entra-authenticatie en gedeelde sleutelauthenticatie. Voor meer informatie over de beveiliging van Azure Maps-webapplicaties, zie Beheer Authenticatie in Azure Maps.

Testing

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

Geleidelijke uitrol

Overweeg een geleidelijke uitrolstrategie voor de bijgewerkte versie. Breng de gemigreerde versie vrij aan een kleinere groep gebruikers of in een gecontroleerde omgeving voordat je deze beschikbaar maakt voor je volledige gebruikersbasis.

Door deze stappen te volgen en best practices te overwegen, kunt u uw applicatie migreren van Azure Maps Web SDK Map Control v1 of v2.0.x naar v3. Voor meer informatie, zie Azure Maps Web SDK best practices.

Volgende stappen 

Leer hoe je kaarten toevoegt aan web- en mobiele applicaties met behulp van de Map Control client-side JavaScript-bibliotheek in Azure Maps: