Azure Maps Web SDK Map Control v1 と Map Control バージョン 2.0.0 から 2.0.32 は廃止されました。 これらのバージョンを使用するすべてのアプリケーションはMap Control v3にアップグレードしてください。 このガイドでは、移行の完了方法を説明しています。
変更を理解する
移行プロセスを始める前に、Web SDK v3で導入された主要な変更点や改善点をよく理解しておくことが重要です。 新機能の範囲を理解するために リリースノート を見直しましょう。
Web SDKバージョンの更新
CDN
CDN(コンテンツ配信ネットワーク)を使っている場合は、HTMLファイルの head 要素にあるスタイルシートとJavaScript参照を更新してください。
移行前: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>
移行前:Map Control v2
汎用のMap Control v2 CDNパスは、特定のv2.0.xリリースではなく、最新のv2リリースを読み込みます。 したがって、このURLだけでは、アプリケーションが影響を受けたv2.0.xバージョンを使用していることを示すものではありません。
<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>
npm経由でMap Controlをインストールするアプリケーションについては、パッケージロックファイルの解決済み azure-maps-control バージョンを確認してください。 2.0.0から2.0.32までのバージョンは廃止されました。
移住後: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
npmを使用している場合は、以下のコマンドを実行してAzure Mapsコントロールの最新バージョンにアップデートしてください:
npm install azure-maps-control@latest
認証方法の確認(任意)
セキュリティ強化のため、v2からWeb SDKにはより多くの認証方法が含まれるようになりました。 新しい方法には、Microsoft Entra認証や共有鍵認証が含まれます。 Azure Mapsのウェブアプリケーションセキュリティについての詳細は、「Azure Mapsにおける認証管理」をご覧ください。
Testing
移行中は包括的な検査が不可欠です。 アプリケーションの機能、パフォーマンス、ユーザー体験をさまざまなブラウザやデバイスで徹底的にテストしてください。
段階的展開
アップデート版の段階的な展開戦略を検討してください。 移行したバージョンを、より少人数のユーザーグループや管理された環境でリリースしてから、全ユーザーベースに提供してください。
これらの手順に従い、ベストプラクティスを参考にすれば、Azure Maps Web SDK Map Control v1またはv2.0.xからv3へアプリケーションを移行できます。 詳細については、Azure Maps Web SDKのベストプラクティスをご覧ください。
次のステップ
Azure MapsのMap ControlクライアントサイドJavaScriptライブラリを使って、ウェブやモバイルアプリケーションに地図を追加する方法を学びましょう: