你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Azure Maps Web SDK 迁移指南
感谢你选择 Azure Maps Web SDK 以满足映射需求。 此迁移指南可帮助从 v1 和 v2 迁移到 v3，使你能够利用最新的功能和增强功能。
了解更改
在开始迁移过程之前，必须熟悉 Web SDK v3 中引入的关键更改和改进。 请查看发行说明，了解新功能的范围。
更新 Web SDK 版本
CDN
如果正在使用 CDN（内容分发网络），请在 HTML 文件的 head 元素中更新对 v3 样式表和 JavaScript 的引用。
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
如果使用 npm，请运行以下命令来更新到最新的 Azure Maps 控件：
npm install azure-maps-control@latest
查看身份验证方法（可选）
为了增强安全性，从 v2 开始，Web SDK 中包含了更多身份验证方法。 新方法包括 Microsoft Entra 身份验证和共享密钥身份验证。 有关 Azure Maps Web 应用程序安全的详细信息，请参阅在 Azure Maps 中管理身份验证。
测试
在迁移过程中，全面测试至关重要。 在不同的浏览器和设备中对应用程序的功能、性能和用户体验进行彻底测试。
逐步推出
请考虑为更新的版本逐步推出策略。 在向整个用户群提供迁移版本之前，将其发布到较小的用户组或受控环境中。
通过遵循这些步骤并考虑最佳做法，可以将应用程序从 Azure Maps Web SDK v1 和 v2 成功迁移到 v3。 接受最新版本提供的新功能和改进，同时确保用户顺利无缝过渡。 有关详细信息，请参阅Azure Maps Web SDK 最佳做法。
后续步骤
了解如何使用 Azure Maps 中的 Map Control 客户端 JavaScript 库将地图添加到 Web 和移动应用程序：