Partager via


Guide de migration d’Azure Maps Web SDK

Merci d’avoir choisi le SDK Web Azure Maps pour vos besoins de mappage. Ce guide de migration vous aide à passer de v1 et v2 à v3, vous permettant ainsi de tirer parti des dernières fonctionnalités et améliorations.

Comprendre les modifications

Avant de commencer le processus de migration, il est important de vous familiariser avec les principales modifications et améliorations introduites dans le SDK Web v3. Passez en revue les notes de publication pour comprendre l’étendue des nouvelles fonctionnalités.

Mise à jour de la version du SDK Web

CDN

Si vous utilisez CDN (réseau de distribution de contenu), mettez à jour les références à la feuille de style v3 et JavaScript dans l’élément head de vos fichiers 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>

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

Si vous utilisez npm, mettez à jour vers le contrôle Azure Maps le plus récent en exécutant la commande suivante :

npm install azure-maps-control@latest

Passer en revue les méthodes d’authentification (facultatif)

Pour renforcer la sécurité, d’autres méthodes d’authentification sont incluses dans le kit de développement logiciel (SDK) Web à partir de v2. Les nouvelles méthodes incluent l’authentification Microsoft Entra et l’authentification par clé partagée. Pour plus d’informations sur la sécurité des applications web Azure Maps, consultez Gérer l’authentification dans Azure Maps.

Test

Des tests complets sont essentiels pendant la migration. Effectuez des tests approfondis des fonctionnalités, des performances et de l’expérience utilisateur de votre application dans différents navigateurs et appareils.

Lancement progressif

Envisagez une stratégie de lancement progressif pour la version mise à jour. Donnez accès à la version migrée à un plus petit groupe d’utilisateurs ou dans un environnement contrôlé avant de la mettre à la disposition de l’ensemble de votre base d’utilisateurs.

En suivant ces étapes et en tenant compte des meilleures pratiques, vous pouvez migrer votre application d’Azure Maps Web SDK v1 et v2 vers v3. Adoptez les nouvelles fonctionnalités et améliorations offertes par la dernière version tout en garantissant une transition fluide et transparente pour vos utilisateurs. Pour plus d’informations, consultez Meilleures pratiques pour le kit de développement logiciel (SDK) Web Azure Maps.

Étapes suivantes

Découvrez comment ajouter des cartes aux applications web et mobiles à l’aide de la bibliothèque JavaScript côté client Map Control dans Azure Maps :