Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Azure Maps Web SDK Map Control v1 et Map Control versions 2.0.0 à 2.0.32 sont retirées. Mettez à jour toutes les applications utilisant ces versions vers Map Control v3. Ce guide explique comment effectuer la migration.
Comprendre les modifications
Avant de commencer le processus de migration, il est important de vous familiariser avec les principaux changements et améliorations introduits dans Web SDK v3. Consultez les notes de version pour comprendre l’étendue des nouvelles fonctionnalités.
Mise à jour de la version Web SDK
CDN
Si vous utilisez un CDN (réseau de diffusion de contenu), mettez à jour la feuille de style et les références JavaScript dans l’élément head de vos fichiers HTML.
Avant la migration : 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>
Avant la migration : Map Control v2
Le chemin CDN générique Map Control v2 charge la dernière version v2, pas une version spécifique v2.0.x. Par conséquent, cette URL seule n’indique pas qu’une application utilise une version v2.0.x affectée :
<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>
Pour les applications qui installent Map Control via npm, vérifiez la version résolue azure-maps-control dans le fichier de verrouillage du paquet. Les versions de la 2.0.0 à la 2.0.32 ont été retirées.
Après la migration : 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
Si vous utilisez npm, mettez à jour vers la dernière version du contrôle Azure Maps en exécutant la commande suivante :
npm install azure-maps-control@latest
Vérifier les méthodes d’authentification (facultatif)
Pour renforcer la sécurité, davantage de méthodes d’authentification sont incluses dans le Web SDK à partir de la 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, voir Gérer l’authentification dans Azure Maps.
Testing
Des tests complets sont essentiels lors de la migration. Effectuez des tests approfondis des fonctionnalités, des performances et de l’expérience utilisateur de votre application sur différents navigateurs et appareils.
Déploiement progressif
Envisagez une stratégie de déploiement progressif pour la version mise à jour. Publiez la version migrée à un groupe restreint d’utilisateurs ou dans un environnement contrôlé avant de la rendre accessible à l’ensemble de votre base d’utilisateurs.
En suivant ces étapes et en tenant compte des bonnes pratiques, vous pouvez migrer votre application d’Azure Maps Web SDK Map Control v1 ou v2.0.x vers v3. Pour plus d’informations, consultez les meilleures pratiques du SDK Web d’Azure Maps.
Étapes suivantes
Apprenez comment ajouter des cartes à des applications web et mobiles en utilisant la bibliothèque JavaScript côté client Map Control dans Azure Maps :