この記事では、Bing Maps Calculate a Route API を Azure Maps Route Directions API に移行する方法について説明します。 Azure Maps Route Directions は、自動車 (運転)、商用トラック、徒歩ルートの出発地と目的地の間の理想的なルートを返す API です。 ルートでは、現在のトラフィックや、要求された曜日と時間帯の一般的な道路速度などの要因が考慮されます。
[前提条件]
- Azure アカウント
- Azure Maps アカウント
- サブスクリプション キー、またはその他の形式の Azure Maps での認証
主な相違点
- Bing Maps Calculate a Route API は GET 要求をサポートします。 Azure Maps Route Directions API は POST 要求をサポートしています。
- Bing Maps Calculate a Route API では、XML および JSON 応答形式がサポートされます。 Azure Maps Route Directions API では、 GeoJSON 形式がサポートされています。
- Bing Maps Calculate a Route API では、ウェイポイントと viaWaypoints が緯度/経度形式である必要があります。一方、Azure Maps では、GeoJSON 形式で定義されている経度/緯度形式である必要があります。
- Bing Maps Calculate a Route API では、ポイント、ランドマーク、またはアドレスとしてウェイポイントと viaWaypoint がサポートされます。 Azure Maps Route Directions API では、ポイントのみがサポートされます。 ランドマークまたは住所をポイントに変換するには、Azure Maps Get Geocoding API を 使用できます。
- Bing Maps Calculate a Route API では、トランジット ルーティングがサポートされます。 Azure Maps Route Directions API は機能していません。
- Bing Maps for Enterprise とは異なり、Azure Maps は地理的範囲の指定をサポートするグローバル サービスであり、ヨーロッパ (EU) または米国 (米国) の地理的地域 (geo) へのデータ所在地の制限を許可します。 すべての要求 (入力データを含む) は、指定された地理的領域内でのみ処理されます。 詳細については、 地理的範囲を参照してください。
セキュリティと認証
Bing Maps for Enterprise がサポートしているのは、API キー認証だけです。 Azure Maps では、サブスクリプション キー、Microsoft Entra ID、Shared Access Signature (SAS) トークンなど、API 呼び出しを認証する複数の方法がサポートされています。 Azure Maps のセキュリティと認証の詳細については、「Azure Maps での認証」および 「Azure Maps Route Directions」ドキュメントの 「セキュリティ」セクション を参照してください。
要求パラメーター
次の表に、Bing Maps Calculate a Route 要求パラメーターと同等の Azure Maps の一覧を示します。
| Bing地図の要求パラメーター | Bing Maps の要求パラメーターの別名 | Azure Maps の要求パラメーター | Azure Maps で必須 | Azure Maps のデータ型 | 説明 |
|---|---|---|---|---|---|
| avoid | avoid | いいえ | 糸 | 次に、Bing Maps Calculate a Route API の Azure Maps Route Directions API avoid に相当する内容を示します (サポートされている場合)。 tolls: tollRoads フェリー: フェリー borderCrossings: borderCrossings minimizeDrivingSideTurn: サポートされていません minimizeAgainstDrivingSideTurn: サポートされていません minimizeUTurn: サポートされていません minimizeTolls: サポートされていません highways: limitedAccessHighways minimizeHighways: サポートされていません |
|
| dateTime | dt | departAt | いいえ | 糸 | Azure Maps Route Directions API では、目的の到着日時を指定するために使用される arriveAt パラメーターもサポートされています。 これは、departAt では使用できません。 |
| 最初の曲がり角までの距離 | dbft | サポートされていません | サポートされていません | サポートされていません | |
| distanceUnit | du | 必須ではありません | 必須ではありません | 必須ではありません | Azure Maps Route Directions API では、距離単位はメートルです。 |
| heading | hd | heading | いいえ | 整数 | |
| itineraryGroups | ig | サポートされていません | サポートされていません | ||
| maxSolutions | maxSolns | maxRouteCount (ルート数の最大値) | いいえ | 整数 | |
| 最適化 | optmz | ルートを最適化する | いいえ | ストリング | Azure Maps Route Directions API の optimizeRoute 相当機能における、Bing Maps Calculate a Route API を以下に示します。 time: 渋滞なしで最速 timeWithTraffic: fastestWithTraffic Azure Maps Route Directions API では、"optimizeRoute" 入力値として最短を指定して最短ルートを返すように、距離によるルートの最適化もサポートされています。 |
| ウェイポイントを最適化する | optWp | ウェイポイントの順序を最適化する | いいえ | boolean | |
| ルート属性 | ra | routeOutputOptions | いいえ | 糸 | Azure Maps Route Directions API の routeOutputOptions と Bing Maps Calculate a Route API の同等機能を次に示します。 routePath: routePath regionTravelSummary: 地域旅行概要 Azure Maps Route Directions API では、スケジュールや routeSummary などのより多くの値がサポートされています。 詳細については、RouteOutputOption を参照してください。 |
| routePathOutput | rpo | routeOutputOptions | いいえ | 糸 | Azure Maps Route Directions API では、要求で routeOutputOptions=routePath を渡すことで、ルート パス ジオメトリの座標を返すことがサポートされています。 |
| timeType | tt | サポートされていません | サポートされていません | サポートされていません | Azure Maps Route Directions API では、トランジット ルーティングはサポートされていません。 |
| tolerances | tl | サポートされていません | サポートされていません | サポートされていません | |
| 旅行モード | 旅行モード | いいえ | 文字列 | Azure Maps の Route Directions API における travelMode に対応する Bing Maps Calculate a Route API の相当機能は次のとおりです。 運転: 運転 Walking: walking トランジット: サポートされていません Azure Maps では、トラックルーティング用の追加の travelMode 'truck' がサポートされています。 |
|
| viaWaypoint.n | vwp.n | features InputWaypointFeaturesItem[] |
正しい | GeoJSON ポイント | waypoint と viaWaypoint は、必須のパラメーターであるフィーチャーとして指定されます。 ただし、waypoint のみが必須の pointType であり、viaWaypoint を使用せずに要求を行うことができます。 Bing Maps Calculate a Route API では、viaWaypoint はポイント、ランドマーク、またはアドレスにすることができますが、Azure Maps Route Directions API ではポイントである必要があります。 ランドマークまたは住所をポイントに変換するには、Azure Maps Get Geocoding API を使用できます。 Bing Maps Calculate a Truck Route API では、viaWaypoints が緯度/経度形式である必要があります。一方、Azure Maps では、GeoJSON 形式で定義されている経度/緯度形式である必要があります。 |
| ウェイポイント.n | wp.n | features InputWaypointFeaturesItem[] | 正しい | GeoJSON ポイント | Bing Maps Calculate a Route API では、ウェイポイントはポイント、ランドマーク、またはアドレスにすることができますが、Azure Maps Route Directions API ではポイントである必要があります。 ランドマークまたは住所をポイントに変換するには、Azure Maps Get Geocoding API を使用できます。 Bing Maps の Calculate a Route API では、ウェイポイントを緯度/経度形式で指定する必要があります。一方、Azure Maps では、GeoJSON 形式で定義されているように、ウェイポイントは経度/緯度形式で指定する必要があります。 |
Azure Maps Route Directions API 要求パラメーターの詳細については、「 URI パラメーター」を参照してください。
要求例
Bing Maps API のルート計算要求：
http://dev.virtualearth.net/REST/V1/Routes/driving?wp.0=47.610173,-122.204171&wp.1=47.612440,-122.204171key={Your-Bing-Maps-Key}
Azure Maps Route Directions API POST 要求:
https://atlas.microsoft.com/route/directions?api-version=2025-01-01&subscription-key={Your-Azure-Maps-Subscription-key}
リクエストの本文に含まれています。
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"coordinates": [
-122.204171,
47.610173
],
"type": "Point"
},
"properties": {
"pointIndex": 0,
"pointType": "waypoint"
}
},
{
"type": "Feature",
"geometry": {
"coordinates": [
-122.204171,
47.612440
],
"type": "Point"
},
"properties": {
"pointIndex": 1,
"pointType": "Waypoint"
}
}
]
}
応答フィールド
次の表に、Bing Maps Calculate a Route 要求と同等の Azure Maps を実行するときに HTTP 応答に表示できるフィールドの一覧を示します。
| Bing マップ フィールド | Azure Maps フィールド | 説明 |
|---|---|---|
| actualStart | Point フィーチャー オブジェクト | type="waypoint" と inputIndex = 0 のポイント特徴オブジェクトは、ルーティング可能な開始位置を定義します。 |
| actualEnd | Point フィーチャー オブジェクト | type="waypoint" と inputIndex = last を持つポイントフィーチャ オブジェクトは、ルーティング可能な終了位置を定義します。 |
| alternateVias | alternativeRoutes | BingマップのalternateViasは、別々のルートを識別します。 Azure Maps では、代替ルートは alternativeRoutes の新しい機能コレクションとして返されます。 |
| compassDegrees | compassDegrees | |
| compassDirection | compassDirection | |
| description | サポートされていません | |
| details | プロパティ | フィーチャー オブジェクトのプロパティには、操縦の情報が含まれます。 |
| distanceUnit | 該当しない | Azure Maps Route Directions API は距離をメートル単位で返します。 |
| durationUnit | 該当しない | Azure Maps Route Directions API は、期間を秒単位で返します。 |
| endPathIndices | range | Azure Maps は、ルートの特定の区間でカバーされる開始インデックスと終了インデックスを範囲として返します。 |
| endWaypoint | サポートされていません | Azure Maps Route Directions API 応答では、endWaypoint は type="waypoint" および inputIndex = last index から派生できます |
| フォーマットされたテキスト | フォーマットされたテキスト | |
| ヒント | サポートされていません | |
| hintType | サポートされていません | |
| iconType | サポートされていません | Bing Maps Calculate Route API は、ユーザー アプリケーションの移動モードを表すアイコンの種類を指定します。 たとえば、運転ルートに部分的なフェリー ルートがある場合、アイコンを使用して、ルート内のさまざまな移動モードを視覚的に識別できます。 Azure Maps Calculate Route API では iconType はサポートされていませんが、移動モードは応答の travelMode プロパティから派生できます。 |
| instruction | instruction | |
| isRealTimeTransit | サポートされていません | |
| isVia | viaWaypoint | Azure Maps Route Directions API 応答では、via waypoint は "type": "ViaWaypoint" として返されます |
| ロケーションコード | サポートされていません | |
| 位置識別子 | サポートされていません | |
| maneuverPoint | maneuverPoint | Azure Maps では、操縦が必要なポイント オブジェクトの type=maneuverPoint です。 Bing Maps Calculate a Route API の操作ポイントは緯度/経度形式ですが、Azure Maps では GeoJSON 形式で定義されている経度/緯度形式です。 |
| 操作タイプ | 操作タイプ | |
| mode | サポートされていません | |
| names | names | |
| リアルタイム交通遅延 | サポートされていません | |
| 道路タイプ | 道路タイプ | |
| ルートパスインデックス | routePathPoint | |
| routeSubLegs | subLegs | |
| sideOfStreet | sideOfStreet | |
| startPathIndices | range | Azure Maps は、ルートの特定の区間でカバーされる開始インデックスと終了インデックスを範囲として返します。 |
| スタートウェイポイント | サポートされていません | Azure Maps Route Directions API 応答では、startWaypoint を type="waypoint" および inputIndex = first index から派生させることができます |
| towardsRoadName | towardsRoadName | |
| 交通渋滞 | 交通渋滞 | |
| トラフィックデータ使用量 | トラフィックデータ使用量 | |
| travelDistance | distanceInMeters | |
| travelDuration | durationInSeconds | |
| travelDurationTraffic | durationTrafficInSeconds | |
| 旅行モード | 移動モード |
Azure Maps Route Directions API 応答フィールドの詳細については、「 定義」を参照してください。
応答例
次の JSON サンプルは、Bing Maps Calculate a Route 要求の実行時に 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": "Route:http://schemas.microsoft.com/search/local/ws/rest/v1",
"bbox": [
47.610173,
-122.204193,
47.611674,
-122.203012
],
"id": "v70,h570425388,i0,a0,cen-US,dAAAAAAAAAAA1,y0,s1,m1,o1,t4,wfPMbJhrOR0Cq8j0jEY1ewA2~AF2UnBAtW6QAAADgAQAAAAAA0~MTAybmQgQXZlIE5F0~~~~~~~~v12,wkWEVb2TOR0Cq8j0jEY1ewA2~AF2UnBAdU6QAAADgAQAAgD8A0~MTAzcmQgQXZlIE5F0~~~~~~~~v12,k1,pZ3NpLXBvaQ2-VHJ1ZQ2,pWC1GRC1GTElHSFQ1-Z3NpLXBvaQ2,p-,p-,p-",
"distanceUnit": "Kilometer",
"durationUnit": "Second",
"routeLegs": [
{
"actualEnd": {
"type": "Point",
"coordinates": [
47.611674,
-122.203084
]
},
"actualStart": {
"type": "Point",
"coordinates": [
47.610173,
-122.20414
]
},
"alternateVias": [],
"description": "102nd Ave NE, NE 1st St",
"endTime": "/Date(1713305954789-0700)/",
"itineraryItems": [
{
"compassDirection": "north",
"details": [
{
"compassDegrees": 356,
"endPathIndices": [
1
],
"maneuverType": "DepartStart",
"mode": "Driving",
"names": [
"102nd Ave NE"
],
"roadType": "Street",
"startPathIndices": [
0
]
}
],
"exit": "",
"iconType": "Auto",
"instruction": {
"formattedText": null,
"maneuverType": "DepartStart",
"text": "Head north on 102nd Ave NE toward NE 1st Pl"
},
"isRealTimeTransit": false,
"maneuverPoint": {
"type": "Point",
"coordinates": [
47.610173,
-122.20414
]
},
"realTimeTransitDelay": 0,
"sideOfStreet": "Unknown",
"tollZone": "",
"towardsRoadName": "NE 1st Pl",
"transitTerminus": "",
"travelDistance": 0.114,
"travelDuration": 36,
"travelMode": "Driving"
},
{
"compassDirection": "east",
"details": [
{
"compassDegrees": 89,
"endPathIndices": [
4
],
"maneuverType": "TurnRight",
"mode": "Driving",
"names": [
"NE 1st St"
],
"roadType": "Street",
"startPathIndices": [
1
]
}
],
"exit": "",
"iconType": "Auto",
"instruction": {
"formattedText": null,
"maneuverType": "TurnRight",
"text": "Turn right onto NE 1st St"
},
"isRealTimeTransit": false,
"maneuverPoint": {
"type": "Point",
"coordinates": [
47.611206,
-122.204193
]
},
"realTimeTransitDelay": 0,
"sideOfStreet": "Unknown",
"tollZone": "",
"transitTerminus": "",
"travelDistance": 0.106,
"travelDuration": 22,
"travelMode": "Driving"
},
{
"compassDirection": "northwest",
"details": [
{
"compassDegrees": 302,
"endPathIndices": [
5
],
"maneuverType": "TurnLeft",
"mode": "Driving",
"names": [
"103rd Ave NE"
],
"roadType": "Street",
"startPathIndices": [
4
]
}
],
"exit": "",
"iconType": "Auto",
"instruction": {
"formattedText": null,
"maneuverType": "TurnLeft",
"text": "Turn left onto 103rd Ave NE"
},
"isRealTimeTransit": false,
"maneuverPoint": {
"type": "Point",
"coordinates": [
47.611629,
-122.203012
]
},
"realTimeTransitDelay": 0,
"sideOfStreet": "Unknown",
"tollZone": "",
"transitTerminus": "",
"travelDistance": 0.007,
"travelDuration": 21,
"travelMode": "Driving"
},
{
"compassDirection": "northwest",
"details": [
{
"compassDegrees": 302,
"endPathIndices": [
5
],
"maneuverType": "ArriveFinish",
"mode": "Driving",
"names": [
"103rd Ave NE"
],
"roadType": "Street",
"startPathIndices": [
5
]
}
],
"exit": "",
"hints": [
{
"hintType": "PreviousIntersection",
"text": "The last intersection before your destination is NE 2nd St"
}
],
"iconType": "Auto",
"instruction": {
"formattedText": null,
"maneuverType": "ArriveFinish",
"text": "Arrive at 103rd Ave NE"
},
"isRealTimeTransit": false,
"maneuverPoint": {
"type": "Point",
"coordinates": [
47.611674,
-122.203084
]
},
"realTimeTransitDelay": 0,
"sideOfStreet": "Unknown",
"tollZone": "",
"transitTerminus": "",
"travelDistance": 0,
"travelDuration": 0,
"travelMode": "Driving"
}
],
"routeRegion": "WWMX",
"routeSubLegs": [
{
"endWaypoint": {
"type": "Point",
"coordinates": [
47.611674,
-122.203084
],
"description": "103rd Ave NE",
"isVia": false,
"locationIdentifier": "0|93|148|156|16|29|83|164|0|0|0|224|1|0|0|128|63|0|47.611674,-122.203084",
"routePathIndex": 5
},
"startWaypoint": {
"type": "Point",
"coordinates": [
47.610173,
-122.20414
],
"description": "102nd Ave NE",
"isVia": false,
"locationIdentifier": "0|93|148|156|16|45|91|164|0|0|0|224|1|0|0|0|0|0|47.610173,-122.20414",
"routePathIndex": 0
},
"travelDistance": 0.227,
"travelDuration": 80
}
],
"startTime": "/Date(1713305874789-0700)/",
"travelDistance": 0.227,
"travelDuration": 80,
"travelMode": "Driving"
}
],
"trafficCongestion": "None",
"trafficDataUsed": "None",
"travelDistance": 0.227,
"travelDuration": 80,
"travelDurationTraffic": 71,
"travelMode": "Driving"
}
]
}
],
"statusCode": 200,
"statusDescription": "OK",
"traceId": "47969a89fd7bc08f1a922bf92f4a7541|MWH0032B15|0.0.0.0|MWH0031C9B, Leg0-MWH0031C8C"
}
次の JSON サンプルは、Azure Maps の Get Map Tile 要求の実行時に HTTP 応答の本文に返される内容を示しています。
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
-122.20414,
47.610173
]
},
"properties": {
"durationInSeconds": 36,
"distanceInMeters": 114.00,
"exitIdentifier": "",
"signs": [],
"instruction": {
"formattedText": "<Action>Head</Action> <CmpsDir>north</CmpsDir> on <RoadName>102nd Ave NE</RoadName> toward <Toward>NE 1st Pl</Toward>",
"maneuverType": "DepartStart",
"text": "Head north on 102nd Ave NE toward NE 1st Pl"
},
"towardsRoadName": "NE 1st Pl",
"routePathPoint": {
"legIndex": 0,
"pointIndex": 0
},
"compassDirection": "north",
"travelMode": "driving",
"steps": [
{
"maneuverType": "DepartStart",
"routePathRange": {
"legIndex": 0,
"range": [
0,
1
]
},
"names": [
"102nd Ave NE"
],
"compassDegrees": 356.00,
"roadType": "Street"
}
],
"type": "ManeuverPoint"
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
-122.204193,
47.611206
]
},
"properties": {
"durationInSeconds": 22,
"distanceInMeters": 106.00,
"exitIdentifier": "",
"signs": [],
"instruction": {
"formattedText": "<Action>Turn</Action> <TurnDir>right</TurnDir> onto <RoadName>NE 1st St</RoadName>",
"maneuverType": "TurnRight",
"text": "Turn right onto NE 1st St"
},
"routePathPoint": {
"legIndex": 0,
"pointIndex": 1
},
"compassDirection": "east",
"travelMode": "driving",
"steps": [
{
"maneuverType": "TurnRight",
"routePathRange": {
"legIndex": 0,
"range": [
1,
4
]
},
"names": [
"NE 1st St"
],
"compassDegrees": 89.00,
"roadType": "Street"
}
],
"type": "ManeuverPoint"
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
-122.203012,
47.611629
]
},
"properties": {
"durationInSeconds": 21,
"distanceInMeters": 7.00,
"exitIdentifier": "",
"signs": [],
"instruction": {
"formattedText": "<Action>Turn</Action> <TurnDir>left</TurnDir> onto <RoadName>103rd Ave NE</RoadName>",
"maneuverType": "TurnLeft",
"text": "Turn left onto 103rd Ave NE"
},
"routePathPoint": {
"legIndex": 0,
"pointIndex": 4
},
"compassDirection": "northwest",
"travelMode": "driving",
"steps": [
{
"maneuverType": "TurnLeft",
"routePathRange": {
"legIndex": 0,
"range": [
4,
5
]
},
"names": [
"103rd Ave NE"
],
"compassDegrees": 302.00,
"roadType": "Street"
}
],
"type": "ManeuverPoint"
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
-122.203084,
47.611674
]
},
"properties": {
"durationInSeconds": 0,
"distanceInMeters": 0.00,
"exitIdentifier": "",
"signs": [],
"instruction": {
"formattedText": "<Action>Arrive</Action> at <WaypointName>103rd Ave NE</WaypointName>",
"maneuverType": "ArriveFinish",
"text": "Arrive at 103rd Ave NE"
},
"routePathPoint": {
"legIndex": 0,
"pointIndex": 5
},
"compassDirection": "northwest",
"travelMode": "driving",
"steps": [
{
"maneuverType": "ArriveFinish",
"routePathRange": {
"legIndex": 0,
"range": [
5,
5
]
},
"names": [
"103rd Ave NE"
],
"compassDegrees": 302.00,
"roadType": "Street"
}
],
"type": "ManeuverPoint"
}
},
{
"type": "Feature",
"geometry": {
"type": "MultiLineString",
"coordinates": []
},
"properties": {
"resourceId": "v70,h570425388,i0,a0,cen-US,dAAAAAAAAAAA1,y0,s1,m1,o1,t0,wfPMbJhrOR0Cq8j0jEY1ewA2~~~~~~~~~~v12,wkWEVb2TOR0Cq8j0jEY1ewA2~~~~~~~~~~v12,k1,qatt:1",
"trafficCongestion": "Mild",
"trafficDataUsed": "None",
"distanceInMeters": 227.00,
"durationInSeconds": 80,
"departureTime": "2024-04-16T22:22:27+00:00",
"arrivalTime": "2024-04-16T22:23:47+00:00",
"type": "RoutePath",
"legs": []
}
}
]
}
トランザクションの使用法
Bing Maps Calculate Route API と同様に、Azure Maps Route Direction API では、API 要求ごとに 1 つの課金対象トランザクションがログに記録されます。 Azure Maps トランザクションの詳細については、「Azure Maps トランザクションの理解」を参照してください。
追加情報
- Post Directions Batch: 1 つの同期要求で Route Directions API にクエリのバッチを送信するために使用します。
支援