Azure Maps Render 1.0 API の移行

Azure Maps Render API version 2024-04-01 は Render API version 1.0 を置き換えました。 この記事では、Render 1.0リクエストをバージョン2024-04-01に移行する方法を説明します。

API 等価性マッピング

Render 2024-04-01は以下の操作も提供しています:

• 地図の帰属を得る 地図タイルを表示する際に必要な帰属テキストを返します。
• Get Map Tilesetは タイルセットのメタデータを返します。

主な相違点

静止画像の許容最小および最大バウンディングボックス範囲はズームレベルによって異なります。 ワークロードを本番環境に移行する前に、既存の bbox、 height、 width 値を Get Map Static Image 要件と照らし合わせて検証してください。

マップタイルパラメータマッピング

Render 1.0では、パスフォーマットと layer および style パラメータでタイルを選択します。 Render 2024-04-01では、代わりに tilesetId を使用してください。

フォーマット、ズーム範囲、利用可能な値の完全なリストについては、 TilesetIDをご覧ください。

マップタイルのリクエストを移行する

以下のRender 1.0リクエストはラスタ道路タイルを返します:

https://atlas.microsoft.com/map/tile/png?api-version=1.0&layer=basic&style=main&zoom=6&x=10&y=22&subscription-key={Your-Azure-Maps-Subscription-key}

パスからフォーマットを削除し、 layer と style を対応する tilesetIdに置き換え、 api-versionを更新します:

https://atlas.microsoft.com/map/tile?api-version=2024-04-01&tilesetId=microsoft.base.road&zoom=6&x=10&y=22&subscription-key={Your-Azure-Maps-Subscription-key}

以下の例では、ベクター ベース タイルを移行します：

https://atlas.microsoft.com/map/tile/pbf?api-version=1.0&layer=basic&style=main&zoom=6&x=10&y=22&subscription-key={Your-Azure-Maps-Subscription-key}

現在のリクエストには microsoft.base タイルセットをご利用ください:

https://atlas.microsoft.com/map/tile?api-version=2024-04-01&tilesetId=microsoft.base&zoom=6&x=10&y=22&subscription-key={Your-Azure-Maps-Subscription-key}

地図の帰属表示

「Get Map Tile」から戻されたタイルを表示する際は、「Get Map Attribution」で表示されたタイルセット、ズームレベル、バウンディングボックスを呼び出します。 返された帰属表示は、サードパーティ製の地図コントロールやカスタム レンダリング実装を含め、タイルが表示されるすべての場所に表示してください。

https://atlas.microsoft.com/map/attribution?api-version=2024-04-01&tilesetId=microsoft.base&zoom=6&bounds=-122.414162,47.57949,-122.247157,47.668372&subscription-key={Your-Azure-Maps-Subscription-key}

実装の指針については「 正しい著作権帰属表示」をご覧ください。

画像タイルリクエストの移行

Render 1.0は別の画像パスを使用しています:

https://atlas.microsoft.com/map/imagery/png?api-version=1.0&style=satellite&zoom=6&x=10&y=22&subscription-key={Your-Azure-Maps-Subscription-key}

Render 2024-04-01で、microsoft.imageryタイルセットで「Get Map Tile」を使いましょう:

https://atlas.microsoft.com/map/tile?api-version=2024-04-01&tilesetId=microsoft.imagery&zoom=6&x=10&y=22&subscription-key={Your-Azure-Maps-Subscription-key}

静的画像リクエストの移行

以下のRender 1.0リクエストは静的なPNGロードマップを返します:

https://atlas.microsoft.com/map/static/png?api-version=1.0&layer=basic&style=main&zoom=10&center=-122.177621,47.613079&subscription-key={Your-Azure-Maps-Subscription-key}

パスからフォーマットを削除し、 layer と style を tilesetIdに置き換え、 api-versionを更新します:

https://atlas.microsoft.com/map/static?api-version=2024-04-01&tilesetId=microsoft.base.road&zoom=10&center=-122.177621,47.613079&subscription-key={Your-Azure-Maps-Subscription-key}

PNGはデフォルトで返されます。 JPEGをリクエストするには、HTTP Accept ヘッダーを image/jpegに設定してください。

移行前に、要求された画像のサイズを確認してください。 Render 1.0は1から8,192までの height および width の値を受け入れます。 Render 2024-04-01は高さ80から1,500、幅80から2,000の範囲を受け入れます。 現在の範囲外のリクエストはリサイズするか、複数のリクエストに分割する必要があります。

トラフィックフローを重ねるには trafficLayer=microsoft.traffic.relative.mainを設定します。 ピン、パス、ポリゴン、交通、画像についての詳細は「ラ スターマップ上にカスタムデータをレンダリングする」をご覧ください。

Render クライアント ライブラリの移行

APIバージョン1.0をターゲットにしたRenderクライアントライブラリは必ずアップグレードしてください。 以下のパッケージ バージョンは Render 2024-04-01 を対象としています：

2.xのクライアントライブラリはプレリリースパッケージです。 言語固有のパッケージドキュメントを確認し、更新されたクライアントを本番環境にデプロイする前にテストしてください。

移行を検証する

本番環境トラフィックを切り替える前に、移行したアプリケーションが以下のことを確認してください:

• api-version=1.0でRenderリクエストを送信しなくなりました。
• /map/tile/png、/map/tile/pbf、/map/imagery/png、/map/static/pngパスは使いません。
• すべてのタイルと静的画像のリクエストに対して期待される tilesetId を使用します。
• 要求は静的イメージのディメンションと境界ボックスをサポートしていました。
• 各タイルセットに期待されるレスポンスメディアタイプを処理します。
• 地図タイルをレンダリングする際に「 Get Map Attribution 」から返された帰属を表示します。
• すべての対応ズームレベルで、適切なラベル、注目ポイント、地図スタイル、オーバーレイ、画像を生成します。
• 反子午線付近の地図や幾何学を扱います。
• 必要なAzure地理的またはソブリンクラウドに適したエンドポイントを使用します。

関連するコンテンツ

• Azure Maps Render REST API
• Azure Maps Render v1 退職発表
• Azure Maps Render サービスの対応範囲
• サポートされた組み込みマップスタイル
• ズーム レベルとタイル グリッド