Azure 地圖服務 Web SDK 第 1 版移轉指南
感謝您選擇 Azure 地圖服務 Web SDK 以符合您的對應需求。 此移轉指南可協助您從第 1 版轉換至第 3 版，讓您充分利用最新的功能和增強功能。
了解變更
開始移轉程式之前，請務必先熟悉 Web SDK v3 中引進的重要變更和改進。 檢閱版本資訊，以掌握新功能的範圍。
更新 Web SDK 版本
CDN
如果您使用 CDN (內容傳遞網路)，請在 HTML 檔案的 head 元素內更新樣式表單和 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>
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 地圖服務控制件：
npm install azure-maps-control@latest
檢閱驗證方法 (選用)
為了增強安全性，Web SDK 從第 2 版開始會包含更多驗證方法。 新的方法包括 [Microsoft Entra 驗證] 和共用密鑰驗證。 如需 Azure 地圖服務 Web 應用程式安全性的詳細資訊，請參閱管理 Azure 地圖服務中的驗證。
測試
在移轉期間，完整的測試至關重要。 在不同的瀏覽器和裝置中，對應用程式的功能、效能和使用者體驗進行徹底測試。
漸進式推出
請考慮更新版本的漸進式推出策略。 將移轉的版本釋放至較小的使用者群組，或是在受控環境中，再提供給整個使用者群使用。
遵循這些步驟並考慮最佳做法，您可以將應用程式從 Azure 地圖服務 WebSDK v1 成功移轉至 v3。 採用最新版本所提供的新功能和改進功能，同時確保使用者順利流暢的轉換。 如需詳細資訊，請參閱 Azure 地圖服務 Web SDK 的最佳做法。
下一步
了解如何使用 Azure 地圖服務中的地圖控制項用戶端 JavaScript 程式庫，將地圖新增至 Web 和行動應用程式：