Bing Maps Get Imagery Metadata API の移行

この記事では、Bing Maps Get Imagery Metadata API を Azure Maps Get Map Tile API に移行する方法について説明します。

Azure Maps Get Map Tile API は、Azure Maps Web SDK またはサードパーティのマップコントロールで使用するマップタイルをベクトル形式またはラスター形式で提供します。要求できるタイルの例としては、Azure Maps の道路、衛星/航空、気象レーダーなどがあります。

前提条件

主な相違点

Bing Maps Get Imagery Metadata API は、マップタイルイメージを取得するための URL (ImageUrl) を含む、マップタイルメタデータを HTML 応答の本文に提供します。 Azure Maps Get Map Tile API は、HTML 応答でマップタイルイメージを直接提供しますが、メタデータは含まれません。
Bing Maps Get Imagery Metadata API は、マップタイルビンテージ情報 (vintageStart および vintageEnd) を含む、マップタイルメタデータを HTML 応答の本文に提供します。 Azure Maps Get Map Tile API は、HTML 応答の本文ではなく、応答ヘッダー (Data-Capture-Date-Range) でマップタイルビンテージ情報を提供します。
Bing Maps Get Imagery Metadata API は、マップタイルの著作権情報を含む、マップタイルメタデータを HTML 応答の本文に提供します。 Azure Maps Get Map Tile API の場合、マップの著作権帰属情報は Azure Maps Get Map Attribution API から取得できます。著作権属性情報は、Azure Maps 製品の使用条件に従ってマップに表示する必要があります。
Azure Maps Get Map Tile API は、Streetside、Birdseye、Ordnance Survey などの Bing Maps Get Imagery Metadata API マップスタイルを提供しません。
Azure Maps Get Map Tile API は、現在、Bing Maps Get Imagery Metadata API AerialWithLabelsOnDemand マップスタイルのような、道路ラベル付きの衛星/航空マップスタイルを提供していません。ただし、Azure Maps Web SDK は satellite_road_labels と呼ばれる同様のマップスタイルを提供しています。
Bing Maps Get Imagery Metadata API は 256 x 256 ピクセルのタイルサイズを提供します。 Azure Maps Get Map Tile API は 256 x 256 ピクセルのタイルサイズと 512 x 512 ピクセルのタイルサイズを提供します。詳細については、「MapTileSize」を参照してください。
Bing Maps Get Imagery Metadata API は XML および JSON 応答形式をサポートしていますが、Azure Maps Get Map Tile API は JSON のみをサポートしています。
Bing Maps Get Imagery Metadata API は、roads や satellite/hybrid のような imagerySet URI パラメーターを使用するマップスタイルのベースマップを提供します。 Azure Maps Get Map Tile API は、TilesetID URI パラメーターを使用して、同様の提供ベースマップを提供します。 Azure Maps TilesetID はマップタイルの取得で AerialWithLabelsOnDemand または AerialWithLabels タイルをサポートしていません。 Hybrid タイルは Azure Maps Web SDK マップコントロールでのみ使用できます。
Azure Maps は、Bing Maps for Enterprise とは異なり、地域スコープの指定をサポートするグローバルサービスです。これにより、データ所在地をヨーロッパ (EU) または米国 (US) の地理的地域 (geo) に制限できます。すべての要求 (入力データを含む) は、指定された地理的領域内でのみ処理されます。詳しくは、「Azure Maps サービスの地域スコープ」をご覧ください。

セキュリティと認証

Bing Maps for Enterprise がサポートしているのは、API キー認証だけです。 Azure Maps では、サブスクリプションキー、Microsoft Entra ID、Shared Access Signature (SAS) トークンなど、API 呼び出しを認証する複数の方法がサポートされています。 Azure Maps のセキュリティと認証の詳細については、「Azure Maps による認証」および Azure Maps マップタイルの取得ドキュメントの「セキュリティ」セクションを参照してください。

要求パラメーター

次の表に、Bing地図の Get Imagery Metadata 要求パラメーターと同等の Azure Maps パラメーターを示します。

Bing地図の要求パラメーター	Bing Maps の要求パラメーターの別名	Azure Maps の要求パラメーター	Azure Maps で必須	Azure Maps のデータ型	説明
imagerySet	なし	tilesetId	True	TilesetID	Azure Maps には、Maps Get Imagery Metadata API にはないBingマップスタイルがいくつかあります。 Bing Maps Get Imagery Metadata API には、Azure Maps にはないいくつかのマップスタイルがあります。 Azure Maps で提供されるマップスタイルの詳細については、TilesetID を参照してください。
centerPoint	なし	x y	True	integer int32	X、Y 座標の詳細については、「ズームレベルとタイルグリッド」を参照してください。
culture	c	language	False	文字列	詳細については、Azure Maps でサポートされている言語を参照してください。
include	incl	NA	NA	NA	Bing Maps のこのパラメーターのオプションは `ImageryProviders` のみです。指定すると、イメージプロバイダーに関する属性情報が応答に返され、地図上に表示されます。 Azure Maps Get Map Tile API の場合、マップの著作権帰属情報は Azure Maps Get Map Attribution API から取得できます。著作権属性情報は、Azure Maps 製品の使用条件に従ってマップに表示する必要があります。
mapLayer	ml	NA	N/A	NA
orientation	dir	NA	NA	NA	Azure Maps ではサポートされていない Bing Maps Birdseye マップスタイルに適用されます。
uriScheme		NA	NA	NA
zoomLevel	zl	zoom	True	integer int32	X、Y 座標の詳細については、「ズームレベルとタイルグリッド」を参照してください。

Azure Maps 要求パラメーターの詳細については、「URI パラメーター」を参照してください。

要求例

Bing地図の Get Imagery Metadata API 要求:

http://dev.virtualearth.net/REST/V1/Imagery/Metadata/road/37.770864,-122.467217?zl=15&key={YourBingMapsKey}

Azure Maps の Get Map Tile API 要求:

https://atlas.microsoft.com/map/tile?api-version=2022-08-01&tilesetId=microsoft.base&zoom=15&x=5236&y=12665&tileSize=256&subscription-key={Your-Azure-Maps-Subscription-key}

応答フィールド

次の表に、Bing地図の Get Imagery Metadata API の実行時に HTTP 応答に表れる可能性があるフィールドと、Azure Maps の同等のフィールドを示します。

Bing地図の応答フィールド	Azure Maps の応答フィールド	説明
imageHeight (JSON) ImageWidth (XML)	サポート対象外	Azure Maps の Get Map Tile API は、HTML 応答 (バイナリイメージ文字列) でマップタイル画像を直接提供し、256 x 256 ピクセルおよび 512 x 512 ピクセルのタイルサイズを提供します。
imageUrl (JSON) ImageUrl (XML)	サポート対象外	Azure Maps Get Map Tile API は、イメージ URL ではなく HTML 応答 (バイナリイメージ文字列) でマップタイル画像を直接提供します。
imageUrlSubdomains (JSON) ImageUrlSubdomains (XML)	サポート対象外	Azure Maps Get Map Tile API は、イメージ URL ではなく HTML 応答 (バイナリイメージ文字列) でマップタイル画像を直接提供します。
imageWidth (JSON) ImageWidth (XML)	サポート対象外	Azure Maps の Get Map Tile API は、HTML 応答 (バイナリイメージ文字列) でマップタイル画像を直接提供し、256 x 256 ピクセルおよび 512 x 512 ピクセルのタイルサイズを提供します。
vintageEnd (JSON) VintageEnd (XML)	サポート対象外	Azure Maps Get Map Tile API は、応答本文ではなく、応答ヘッダー (Data-Capture-Date-Range¹) でマップタイルビンテージ情報を提供します。
vintageStart (JSON) VintageStart (XML)	サポート対象外	Azure Maps Get Map Tile API は、応答本文ではなく、応答ヘッダー (Data-Capture-Date-Range¹) でマップタイルビンテージ情報を提供します。
zoomMax (JSON) ZoonMax (XML)	サポート対象外	マップタイルスタイルでサポートされるズームレベルと最大ズームについては、「ズームレベルとタイルグリッド」と「TilesetID」を参照してください。
zoomMin (JSON) ZoomMin (XML)	サポート対象外	マップタイルスタイルでサポートされるズームレベルと最大ズームについては、「ズームレベルとタイルグリッド」と「TilesetID」を参照してください。

¹Azure Maps API を使用して RGB 衛星画像を取得する場合、取得日時に関する情報も取得できます。 HTTP 応答には、Data-Capture-Date-Range というヘッダーが含まれます。これは、イメージが取得されたタイミングを示す日付範囲を提供します。たとえば、"7/31/2022-9/1/2023" のように表示される場合があります。衛星画像は、バッチ処理や異なる日付からなる複数のイメージをつなぎ合わせてシームレスな地図を作製するため、日付範囲にまたがる場合が多いことに留意してください。そのため、1 つの日付が常に適用されるとは限りませんが、日付範囲によって、画像データがいつ収集されたかを把握できます。

Azure Maps の Get Map Tile API 応答フィールドの詳細については、「応答」を参照してください。

応答例

次の JSON サンプルは、Bing地図の Get Imagery Metadata 要求の実行時に HTTP 応答の本文に返される内容を示しています。

{ 
    "authenticationResultCode": "ValidCredentials", 
    "brandLogoUri": "https://dev.virtualearth.net/Branding/logo_powered_by.png", 
    "copyright": "Copyright &copy; 2024 Microsoft and its suppliers. All rights reserved. This API cannot be accessed and the content and any results may not be used, reproduced or transmitted in any manner without express written permission from Microsoft Corporation.", 
    "resourceSets": [ 
        { 
            "estimatedTotal": 1, 
            "resources": [ 
                { 
                    "__type": "ImageryMetadata:http://schemas.microsoft.com/search/local/ws/rest/v1", 
                    "imageHeight": 256, 
                    "imageUrl": "http://ecn.t2.tiles.virtualearth.net/tiles/r023010203332102.jpeg?g=14374&mkt={culture}&shading=hill", 
                    "imageUrlSubdomains": null, 
                    "imageWidth": 256, 
                    "imageryProviders": null, 
                    "vintageEnd": "02 Dec 2019 GMT", 
                    "vintageStart": "02 Dec 2019 GMT", 
                    "zoomMax": 15, 
                    "zoomMin": 15 
                } 
            ] 
        } 
    ], 
    "statusCode": 200, 
    "statusDescription": "OK", 
    "traceId": "c0630758c8475d6f60d65af81b548c6f|MWH0032BEB|0.0.0.1" 
}

次の JSON サンプルは、Azure Maps の Get Map Tile 要求の実行時に HTTP 応答の本文に返される内容を示しています。

状態コード: 200

Content-Type: application/vnd.mapbox-vector-tile

応答本文

"binary image string"

トランザクションの使用法

Bing Maps Get Imagery Metadata API は、API 要求ごとに課金対象のトランザクションを 1 つ生成します。 Azure Maps Get Map Tile API は、15 個のタイルごとに 1 つの課金対象のトランザクションを生成します。 Azure Maps トランザクションの詳細については、「Azure Maps トランザクションの理解」を参照してください。

フィードバック

このページはお役に立ちましたか?

Last updated on 2025-04-13