この記事では、Bing Maps Find a Location by Point API を Azure Maps Get Reverse Geocoding API に移行する方法について説明します。 Azure Maps Get Reverse Geocoding API は、経度と緯度の座標を人間が理解できる番地に変換するために使用されます。
[前提条件]
- Azure アカウント
- Azure Maps アカウント
- サブスクリプション キー、またはその他の形式の Azure Maps での認証
主な相違点
- Bing Maps Find a Location by Point API では、XML と JSON の応答形式がサポートされます。 Azure Maps Get Reverse Geocoding API では、 GeoJSON 応答形式がサポートされています。
- Bingマップ ポイント別の場所の検索 API では、緯度/経度形式の座標が使用されます。 Azure Maps Get Reverse Geocoding API では、 GeoJSON で定義されている経度/緯度形式の座標が使用されます。
- Bing Maps Find a Location by Point API とは異なり、Azure Maps Get Reverse Geocoding API は現在、中国の住所または道路レベルのデータをサポートしていません。
- Bing Maps Find a Location by Point API とは異なり、Azure Maps Get Reverse Geocoding API には、
viewを表す文字列である入力パラメーターがあります。view入力パラメーターは、地政学的な紛争の境界線とラベルを、指定されたユーザー領域に合わせて変更します。 詳細については、「 URI パラメーター」を参照してください。 - Bing Maps for Enterprise とは異なり、Azure Maps は地理的範囲の指定をサポートするグローバル サービスです。これにより、データ所在地をヨーロッパ (EU) または米国 (米国) の地理的地域 (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 Maps Find a Location by Point 要求パラメーターと同等の Azure Maps の一覧を示します。
| Bing地図の要求パラメーター | Bing Maps 要求パラメーターのエイリアス | Azure Maps の要求パラメーター | Azure Maps で必須 | Azure Maps のデータ型 | Description |
|---|---|---|---|---|---|
| カルチャ | c | 要求ヘッダー: Accept-Language | いいえ | 文字列 | Azure Maps Get Reverse Geocoding API では、これは検索結果を返す言語です。 これは、Azure Maps 要求ヘッダーで指定されます。 詳細については、サポートされている言語に関するページを参照してください。 |
| include | 含む | 不要 | 不要 | 不要 | Bing Maps ポイントで場所を検索するでは、応答の場所の結果の 2 文字の ISO 国コードを取得するには、"include" 入力パラメーターが必要です。 Azure Maps Get Reverse Geocoding API では、2 文字の ISO 国コードが既定で返されます。 |
| エンティティタイプを含める | 結果タイプ | いいえ | クエリ | ||
| 近隣を含む | inclnb | 不要 | 不要 | 不要 | Azure Maps Get Reverse Geocoding API では、利用可能な場合は、既定で応答で近隣情報が返されます。 |
| ポイント | coordinates | 正しい | number[] | Bing Maps Find a Location by Point API では、要求の座標と応答は緯度/経度形式で、Azure Maps Get Reverse Geocoding API では要求の座標が必要であり、応答の座標は GeoJSON で定義されているように経度/緯度形式を使用する必要があります。 | |
| userRegion | ur | ビュー | いいえ | 文字列 |
ISO 3166-1 Alpha-2 地域/国番号を表す文字列。 これにより、地政学的な紛争の境界とラベルが、指定されたユーザー領域に合わせて変更されます。 要求で定義していない場合でも、既定で View パラメーターは “Auto” に設定されています。 詳細と使用可能なビューについては、サポートされているビューに関するページを参照してください。 |
| verboseplacenames | vbpn | サポートされていません | サポートされていません | サポートされていません | Azure Maps Get Reverse Geocoding API では、 adminDistricts の短い名前 (フロリダではなく FL) の返しのみがサポートされます。 |
Azure Maps Get Reverse Geocoding API 要求パラメーターの詳細については、「 URI パラメーター」を参照してください。
要求例
Bing Maps ポイントによる場所検索 API 要求:
https://dev.virtualearth.net/REST/v1/Locations/48.830345,2.338166&key={BingMapsKey}
Azure Maps 逆ジオコーディング API 要求の取得:
https://atlas.microsoft.com/reverseGeocode?api-version=2023-06-01&coordinates=2.338166,48.830345&subscription-key={Your-Azure-Maps-Subscription-key}
応答フィールド
次の表に、Bing Maps Find a Location by Point 要求と同等の Azure Maps を実行するときに HTTP 応答に表示できるフィールドの一覧を示します。
| Bing マップの応答 | Azure Maps の応答 | Description |
|---|---|---|
| address: addressLine (JSON) アドレス: アドレスライン (XML) |
address: addressLine | |
| address: adminDistrict (JSON) アドレス: AdminDistrict (XML) |
address: adminDistricts | |
| 住所: adminDistrict2 (JSON) アドレス: AdminDistrict2 (XML) |
address: adminDistricts | |
| 住所: 国または地域 (JSON) アドレス: CountryRegion (XML) |
住所: 国または地域 | |
| アドレス: countryRegionIso2 (JSON) Address: CountryRegionIso2 (XML) |
アドレス: 国/地域 - ISO | |
| address: neighborhood (JSON) 住所: 近隣 (XML) |
住所: 近隣 | |
| address: formattedAddress (JSON) アドレス: FormattedAddress (XML) |
address: formattedAddress | |
| 住所: ローカリティ (JSON) アドレス: 地域 (XML) |
address: locality | |
| 住所: 郵便番号 (JSON) 住所: 郵便番号（XML） |
address: 郵便番号 | |
| アドレス: Intersection – baseStreet (JSON) Address: Intersection – BaseStreet (XML) |
address: intersection -baseStreet | |
| address: 交差点 – 副通り1 (JSON) 住所: 交差点 – 第二通り1 (XML) |
住所: 交差点 - 副次通り1 | |
| address: Intersection – secondaryStreet2 (JSON) 住所: 交差点 – セカンダリストリート2 (XML) |
住所: 交差点 - 第二通り2 | |
| address: Intersection – intersectionType (JSON) 住所: Intersection – IntersectionType (XML) |
address: intersection - intersectionType | |
| address: Intersection – displayName (JSON) 住所: Intersection – DisplayName (XML) |
address: intersection - displayName | |
| bbox (JSON) バウンディングボックス (XML) |
機能: bbox | Bing Maps ポイントによる場所の検索 API では、応答内の座標は緯度/経度形式です。 Azure Maps Get Reverse Geocoding API では、 GeoJSON で定義されている経度/緯度を使用して応答の座標を取得します。 |
| calculationMethod (JSON) 計算メソッド (XML) |
properties: geocodePoints - calculationMethod | |
| 信頼度 (JSON) 信頼度 (XML) |
プロパティ: 信頼度 | |
| entityType (JSON) EntityType (XML) |
プロパティ: タイプ | |
| geocodePoints (JSON) GeocodePoint (XML) |
properties: ジオコードポイント - 座標 | |
| matchCodes (JSON)（マッチコード、JSON形式） MatchCode (XML) |
プロパティ: マッチコード | |
| 名前 (JSON) 名前 (XML) |
サポートされていません | Azure Maps formattedAddress では、Bing Maps と同様の値が提供されます name |
| ポイント (JSON) ポイント (XML) |
特徴: 座標 | Bing Maps ポイントによる場所の検索 API では、応答内の座標は緯度/経度形式です。 Azure Maps Get Reverse Geocoding API では、 GeoJSON で定義されている経度/緯度形式を使用して応答の座標を取得します。 |
| 使用タイプ (JSON) 使用タイプ (XML) |
プロパティ: ジオコードポイント: 使用タイプ |
Azure Maps Get Reverse Geocoding API 応答フィールドの詳細については、「 定義」を参照してください。
応答例
次の JSON サンプルは、Bing Maps Find a Location by Point 要求の実行時に HTTP 応答の本文で返される内容を示しています。
{
"authenticationResultCode": "ValidCredentials",
"brandLogoUri": "https://dev.virtualearth.net/Branding/logo_powered_by.png",
"copyright": "Copyright © 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": "Location:http://schemas.microsoft.com/search/local/ws/rest/v1",
"bbox": [
48.826534682429326,
2.330334564829834,
48.83426011757068,
2.345980835170166
],
"name": "30 Rue Cabanis, 75014 Paris, France",
"point": {
"type": "Point",
"coordinates": [
48.8303974,
2.3381577
]
},
"address": {
"addressLine": "30 Rue Cabanis",
"adminDistrict": "Île-de-France",
"adminDistrict2": "Paris",
"countryRegion": "France",
"formattedAddress": "30 Rue Cabanis, 75014 Paris, France",
"intersection": {
"baseStreet": "Rue Cabanis",
"secondaryStreet1": "Villa de Lourcine",
"intersectionType": "Near",
"displayName": "Rue Cabanis and Villa de Lourcine"
},
"locality": "Paris",
"neighborhood": "14th Arrondissement",
"postalCode": "75014"
},
"confidence": "High",
"entityType": "Address",
"geocodePoints": [
{
"type": "Point",
"coordinates": [
48.8303974,
2.3381577
],
"calculationMethod": "Rooftop",
"usageTypes": [
"Display"
]
}
],
"matchCodes": [
"Good"
]
}
]
}
],
"statusCode": 200,
"statusDescription": "OK",
"traceId": "c525b02f7f1e9e4ee3d7b81cce266671"
次の JSON サンプルは、Azure Maps Get Reverse Geocoding 要求の実行時に HTTP 応答の本文で返される内容を示しています。
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
2.3381577,
48.8303974
]
},
"properties": {
"geocodePoints": [
{
"geometry": {
"type": "Point",
"coordinates": [
2.3381577,
48.8303974
]
},
"calculationMethod": "Rooftop",
"usageTypes": [
"Display"
]
}
],
"address": {
"addressLine": "30 Rue Cabanis",
"adminDistricts": [
{
"shortName": "Île-de-France"
},
{
"shortName": "Paris"
}
],
"countryRegion": {
"name": "France",
"iso": "FR"
},
"intersection": {
"baseStreet": "Rue Cabanis",
"displayName": "Rue Cabanis and Villa de Lourcine",
"intersectionType": "Near",
"secondaryStreet1": "Villa de Lourcine",
"secondaryStreet2": null
},
"locality": "Paris",
"neighborhood": "14th Arrondissement",
"postalCode": "75014",
"formattedAddress": "30 Rue Cabanis, 75014 Paris, France"
},
"confidence": "High",
"matchCodes": [
"Good"
],
"type": "Address"
},
"bbox": [
2.330334564829834,
48.826534682429326,
2.345980835170166,
48.83426011757068
]
}
]
}
トランザクションの使用法
Bing Maps Find a Location by Point API と同様に、Azure Maps Get Reverse Geocoding API では、要求ごとに 1 つの課金対象トランザクションがログに記録されます。 Azure Maps トランザクションの詳細については、「Azure Maps トランザクションの理解」を参照してください。
追加情報
- Azure Maps Get Reverse Geocoding Batch API: クエリのバッチを 1 つの要求で Azure Maps Get Reverse Geocoding API に送信するために使用します。
Support