Route - Get Route Directions Batch

リファレンス

サービス:: Maps

API バージョン:: 1.0

を使用して、1 つの非同期要求で Get Route Directions API にクエリのバッチを送信します。

Get Route Directions Batch API は、1 つの要求を使用して Get Route Directions API にクエリのバッチを送信する HTTP GET 要求です。 API を呼び出 Get Route Directions Batch して、非同期 (非同期) または同期 (同期) のいずれかを実行できます。非同期 API を使用すると、呼び出し元は最大 700 個の クエリをバッチ処理し、API は最大 100 個のクエリを同期できます。

非同期バッチ結果のダウンロード

非同期バッチ結果をダウンロードするには、バッチダウンロードエンドポイントに要求を発行 GET します。このダウンロード URL は、成功したPOSTバッチ要求のヘッダーからLocation取得でき、次のようになります。

https://atlas.microsoft.com/route/directions/batch/{batch-id}?api-version=1.0&subscription-key={subscription-key}

バッチ結果をダウンロードするための一般的な一連の操作を次に示します。

クライアントは、ダウンロード URL をGET使用して要求を送信します。
サーバーは、次のいずれかで応答します。

HTTP 202 Accepted - バッチ要求は受け入れられましたが、まだ処理中です。しばらくしてからやり直してください。

HTTP 200 OK - バッチ要求が正常に処理されました。応答本文には、すべてのバッチ結果が含まれています。

バッチ応答モデル

返されるデータコンテンツは、非同期要求と同期要求に似ています。非同期バッチ要求の結果をダウンロードするときに、バッチの処理が完了した場合、応答本文にはバッチ応答が含まれます。このバッチ応答には、 summary 元のバッチ要求の一部であったを示す totalRequests コンポーネント、 successfulRequestsつまり正常に実行されたクエリが含まれます。バッチ応答には、 batchItems バッチ要求内のすべてのクエリに対する応答を含む配列も含まれます。 batchItemsには、元のクエリがバッチ要求で送信された順序とまったく同じ順序で結果が含まれます。内のbatchItems各項目にはと response フィールドがstatusCode含まれています。の各 response は batchItems 、次のいずれかの種類です。

RouteDirections - クエリが正常に完了した場合。
Error - クエリが失敗した場合。この場合、応答にはとがmessage含まれますcode。

成功した結果が 1 つ、失敗した結果が 1 件のバッチ応答のサンプルを次に示します。

{
    "summary": {
        "successfulRequests": 1,
        "totalRequests": 2
    },
    "batchItems": [
        {
            "statusCode": 200,
            "response": {
                "routes": [
                    {
                        "summary": {
                            "lengthInMeters": 1758,
                            "travelTimeInSeconds": 387,
                            "trafficDelayInSeconds": 0,
                            "departureTime": "2018-07-17T00:49:56+00:00",
                            "arrivalTime": "2018-07-17T00:56:22+00:00"
                        },
                        "legs": [
                            {
                                "summary": {
                                    "lengthInMeters": 1758,
                                    "travelTimeInSeconds": 387,
                                    "trafficDelayInSeconds": 0,
                                    "departureTime": "2018-07-17T00:49:56+00:00",
                                    "arrivalTime": "2018-07-17T00:56:22+00:00"
                                },
                                "points": [
                                    {
                                        "latitude": 47.62094,
                                        "longitude": -122.34892
                                    },
                                    {
                                        "latitude": 47.62094,
                                        "longitude": -122.3485
                                    },
                                    {
                                        "latitude": 47.62095,
                                        "longitude": -122.3476
                                    }
                                ]
                            }
                        ],
                        "sections": [
                            {
                                "startPointIndex": 0,
                                "endPointIndex": 40,
                                "sectionType": "TRAVEL_MODE",
                                "travelMode": "bicycle"
                            }
                        ]
                    }
                ]
            }
        },
        {
            "statusCode": 400,
            "response":
            {
                "error":
                {
                    "code": "400 BadRequest",
                    "message": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive."
                }
            }
        }
    ]
}

GET https://atlas.microsoft.com/route/directions/batch/{format}?api-version=1.0

URI パラメーター

名前	/	必須	型	説明
format	path	True	string	操作のクエリを実行するためのバッチ ID。
api-version	query	True	string	Azure Maps API のバージョン番号。

要求ヘッダー

名前	必須	型	説明
x-ms-client-id		string	Microsoft Entra ID セキュリティモデルと組み合わせて使用するアカウントを指定します。これは Azure Maps アカウントの一意の ID を表し、Azure Maps 管理プレーンアカウント API から取得できます。 Azure Maps で Microsoft Entra ID セキュリティを使用するには、ガイダンスについては、次の記事を参照してください。

応答

名前	型	説明
200 OK	RouteDirectionsBatchResult	バッチ要求が正常に処理されました。応答本文には、すべてのバッチ結果が含まれています。
202 Accepted		非同期要求でのみサポートされます。 [Request Accepted]\(要求の承諾\): 要求は処理のために受け入れ済みです。 Location ヘッダーの URL を使用して、再試行するか、結果にアクセスしてください。ヘッダー Location: string
Other Status Codes	ErrorResponse	予期しないエラーが発生しました。

名前

型

説明

200 OK

RouteDirectionsBatchResult

バッチ要求が正常に処理されました。応答本文には、すべてのバッチ結果が含まれています。

202 Accepted

非同期要求でのみサポートされます。 [Request Accepted]\(要求の承諾\): 要求は処理のために受け入れ済みです。 Location ヘッダーの URL を使用して、再試行するか、結果にアクセスしてください。

ヘッダー

Location: string

Other Status Codes

ErrorResponse

予期しないエラーが発生しました。

セキュリティ

AADToken

これらは Microsoft Entra OAuth 2.0 フローです。 Azure ロールベースのアクセス制御と組み合わせて使用すると、Azure Maps REST API へのアクセスを制御できます。 Azure ロールベースのアクセス制御は、1 つ以上の Azure Maps リソースアカウントまたはサブリソースへのアクセスを指定するために使用されます。 Azure Maps REST API に対する 1 つ以上のアクセス許可で構成される組み込みロールまたはカスタムロールを使用して、任意のユーザー、グループ、またはサービスプリンシパルにアクセス権を付与できます。

シナリオを実装するには、認証の概念を表示することをお勧めします。要約すると、このセキュリティ定義は、特定の API とスコープに対するアクセス制御が可能なオブジェクトを使用してアプリケーションをモデル化するためのソリューションを提供します。

メモ

このセキュリティ定義では、ヘッダーを x-ms-client-id 使用して、アプリケーションがアクセスを要求している Azure Maps リソースを示す必要があります。これは、 Maps 管理 API から取得できます。

Authorization URLは、Azure パブリッククラウドインスタンスに固有です。ソブリンクラウドには、一意の承認 URL と Microsoft Entra ID 構成があります。 * Azure ロールベースのアクセス制御は、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーンから構成されます。 * Azure Maps Web SDK を使用すると、複数のユースケースに対するアプリケーションの構成ベースのセットアップが可能になります。

Microsoft ID プラットフォームの詳細については、「 Microsoft ID プラットフォームの概要」を参照してください。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

これは、Azure portal で Azure Maps アカウントを作成するとき、または PowerShell、CLI、Azure SDK、または REST API を使用するときにプロビジョニングされる共有キーです。

このキーを使用すると、すべてのアプリケーションがすべての REST API にアクセスできます。つまり、このキーは、発行されたアカウントのマスターキーとして使用できます。

公開されているアプリケーションの場合、キーを安全に格納できるように、機密クライアントアプリケーションのアプローチを使用して Azure Maps REST API にアクセスすることをお勧めします。

型: apiKey
/: query

SAS Token

これは、Azure portal、PowerShell、CLI、Azure SDK、または REST API を使用して、Azure 管理プレーンを介して Azure Maps リソースの SAS の一覧表示操作から作成される共有アクセス署名トークンです。

このトークンを使用すると、すべてのアプリケーションが Azure ロールベースのアクセス制御を使用してアクセスし、特定のトークンに使用される有効期限、レート、およびリージョンをきめ細かく制御できます。つまり、SAS トークンを使用して、アプリケーションが共有キーよりもセキュリティで保護された方法でアクセスを制御できるようにします。

公開されているアプリケーションの場合、 Map アカウントリソースで許可される配信元の特定の一覧を構成して、レンダリングの不正使用を制限し、SAS トークンを定期的に更新することをお勧めします。

型: apiKey
/: header

例

Successfully retrieve the status for the route direction batch request

要求のサンプル

HTTP

GET https://atlas.microsoft.com/route/directions/batch/11111111-2222-3333-4444-555555555555?api-version=1.0

応答のサンプル

状態コード:: 200

{
  "batchItems": [
    {
      "statusCode": 400,
      "response": {
        "error": {
          "code": "400 BadRequest",
          "message": "maxAlternatives parameter value should be between 0 and 5 inclusive"
        }
      }
    },
    {
      "statusCode": 200,
      "response": {
        "formatVersion": "0.0.12",
        "routes": [
          {
            "summary": {
              "lengthInMeters": 1754,
              "travelTimeInSeconds": 386,
              "trafficDelayInSeconds": 0,
              "departureTime": "2019-06-21T22:56:23+00:00",
              "arrivalTime": "2019-06-21T23:02:49+00:00"
            },
            "legs": [
              {
                "summary": {
                  "lengthInMeters": 1754,
                  "travelTimeInSeconds": 386,
                  "trafficDelayInSeconds": 0,
                  "departureTime": "2019-06-21T22:56:23+00:00",
                  "arrivalTime": "2019-06-21T23:02:49+00:00"
                },
                "points": [
                  {
                    "latitude": 47.62094,
                    "longitude": -122.34892
                  },
                  {
                    "latitude": 47.62094,
                    "longitude": -122.3485
                  },
                  {
                    "latitude": 47.62095,
                    "longitude": -122.3476
                  },
                  {
                    "latitude": 47.60995,
                    "longitude": -122.34174
                  },
                  {
                    "latitude": 47.61011,
                    "longitude": -122.342
                  }
                ]
              }
            ],
            "sections": [
              {
                "startPointIndex": 0,
                "endPointIndex": 44,
                "sectionType": "TRAVEL_MODE",
                "travelMode": "bicycle"
              }
            ]
          }
        ]
      }
    },
    {
      "statusCode": 200,
      "response": {
        "formatVersion": "0.0.12",
        "routes": [
          {
            "summary": {
              "lengthInMeters": 1772,
              "travelTimeInSeconds": 1276,
              "trafficDelayInSeconds": 0,
              "departureTime": "2019-06-21T22:56:23+00:00",
              "arrivalTime": "2019-06-21T23:17:38+00:00"
            },
            "legs": [
              {
                "summary": {
                  "lengthInMeters": 1772,
                  "travelTimeInSeconds": 1276,
                  "trafficDelayInSeconds": 0,
                  "departureTime": "2019-06-21T22:56:23+00:00",
                  "arrivalTime": "2019-06-21T23:17:38+00:00"
                },
                "points": [
                  {
                    "latitude": 40.75982,
                    "longitude": -73.98493
                  },
                  {
                    "latitude": 40.7601,
                    "longitude": -73.98483
                  },
                  {
                    "latitude": 40.75984,
                    "longitude": -73.98417
                  },
                  {
                    "latitude": 40.76047,
                    "longitude": -73.9837
                  },
                  {
                    "latitude": 40.77095,
                    "longitude": -73.9736
                  },
                  {
                    "latitude": 40.77114,
                    "longitude": -73.97356
                  }
                ]
              }
            ],
            "sections": [
              {
                "startPointIndex": 0,
                "endPointIndex": 47,
                "sectionType": "TRAVEL_MODE",
                "travelMode": "pedestrian"
              }
            ]
          }
        ]
      }
    }
  ],
  "summary": {
    "successfulRequests": 2,
    "totalRequests": 3
  }
}

状態コード:: 202

定義

名前	説明
DelayMagnitude	インシデントによって発生する遅延の大きさ。これらの値は、トラフィックインシデント詳細の取得 API の応答フィールド ty の値に対応します。
DrivingSide	操縦のポイントで左手と右側の運転を示します。
EffectiveSetting	このルート API を呼び出すときに使用される有効なパラメーターまたはデータ。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
GuidanceInstructionType	指示の種類、例えば、道路形態のターンまたは変更。
GuidanceManeuver	操縦を識別するコード。
JunctionType	操縦が行われるジャンクションの種類。より大きなラウンドアバウト交差点の場合、ラウンドアバウト交差点への入退出に対して 2 つの個別の命令が生成されます。
LatLongPair	緯度と経度として表される場所。
Response	クエリの結果です。クエリが正常に完了した場合は RouteDirections、それ以外の場合は ErrorResponse。
ResponseSectionType	報告されたルート応答のセクションの種類
ResponseTravelMode	計算されたルートの移動モード。このセクションで要求されたトランスポートモードが不可能な場合、値はに設定 `other` されます
Route
RouteDirectionsBatchItem	Route Directions Batch サービス呼び出しから返される項目。
RouteDirectionsBatchResult	このオブジェクトは、正常な Route Directions Batch サービス呼び出しから返されます。
RouteGuidance	ガイダンス関連の要素が含まれています。このフィールドは、ガイダンスが要求され、使用可能な場合にのみ表示されます。
RouteInstruction	"右に曲がる"、"左に置く"、"フェリーに乗る"、"高速道路を取る"、"到着" など、操縦を説明する属性のセット。
RouteInstructionGroup	相互に関連する命令要素のシーケンスをグループ化します。シーケンス範囲は、firstInstructionIndex と lastInstructionIndex で制約されます。人間が判読できるテキストメッセージにガイダンス (instructionType=text またはタグ付け) が要求されると、instructionGroup には、使用可能な場合に概要メッセージが返されます。
RouteLeg	ポイントのリストで構成されるルートの一部の説明。要求で指定された追加の各ウェイポイントは、返されるルートに追加の区間になります。
RouteLegSummary	ルートセクションの概要オブジェクト。
RouteOptimizedWaypoint	最適化されたウェイポイントオブジェクト。
RouteReport	現在の呼び出しで使用されている有効な設定を報告します。
RouteSection	ルートセクションには、ルートの一部に関する追加情報が含まれています。各セクションには、少なくとも要素 `startPointIndex`、、 `endPointIndex`および `sectionType`が含まれています。
RouteSectionTec	TPEG2-TEC 標準の定義を使用したトラフィックイベントの詳細。 effectCode を含め、要素を引き起こすことができます。
RouteSectionTecCause	トラフィックイベントの原因。 mainCauseCode 要素と subCauseCode 要素を含めることができます。アイコンと説明を定義するために使用できます。
RouteSummary	Summary オブジェクト
SimpleCategory	インシデントの種類。現在、JAM、ROAD_WORK、ROAD_CLOSURE、またはその他にすることができます。詳細については、「tec」を参照してください。
Summary	バッチ要求の結果の概要

DelayMagnitude

インシデントによって発生する遅延の大きさ。これらの値は、トラフィックインシデント詳細の取得 API の応答フィールド ty の値に対応します。

名前	型	説明
0	string	不明。
1	string	マイナー。
2	string	中程度。
3	string	メジャー。
4	string	未定義。道路の閉鎖やその他の不定の遅延に使用されます。

DrivingSide

操縦のポイントで左手と右側の運転を示します。

名前	型	説明
LEFT	string	左側。
RIGHT	string	右辺。

EffectiveSetting

このルート API を呼び出すときに使用される有効なパラメーターまたはデータ。

名前	型	説明
key	string	使用されるパラメーターの名前。
value	string	使用されるパラメーターの値。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラーコード。
details	ErrorDetail[]	エラーの詳細です。
message	string	エラーメッセージ。
target	string	エラーのターゲット。

ErrorResponse

エラー応答

名前	型	説明
error	ErrorDetail	error オブジェクト。

GuidanceInstructionType

指示の種類、例えば、道路形態のターンまたは変更。

名前	型	説明
DIRECTION_INFO	string	方向情報。
LOCATION_ARRIVAL	string	到着場所。
LOCATION_DEPARTURE	string	出発場所。
LOCATION_WAYPOINT	string	ウェイポイントの位置。
ROAD_CHANGE	string	道路の変更。
TURN	string	回る。

GuidanceManeuver

操縦を識別するコード。

名前	型	説明
ARRIVE	string	到着しました。
ARRIVE_LEFT	string	到着しました。宛先は左側にあります。
ARRIVE_RIGHT	string	到着しました。目的地が右側にあります。
BEAR_LEFT	string	左のクマ。
BEAR_RIGHT	string	権利を持つ。
DEPART	string	去る。
ENTER_FREEWAY	string	高速道路に乗ります。
ENTER_HIGHWAY	string	高速道路に乗ります。
ENTER_MOTORWAY	string	高速道路に乗ります。
ENTRANCE_RAMP	string	ランプを取る。
FOLLOW	string	従う。
KEEP_LEFT	string	左側通行。
KEEP_RIGHT	string	右に置く。
MAKE_UTURN	string	U ターンを行います。
MOTORWAY_EXIT_LEFT	string	左側の出口を出ます。
MOTORWAY_EXIT_RIGHT	string	右の出口に出ます。
ROUNDABOUT_BACK	string	ラウンドアバウトを回る。
ROUNDABOUT_CROSS	string	ラウンドアバウト交差点を渡る。
ROUNDABOUT_LEFT	string	ラウンドアバウトで左側の出口を出ます。
ROUNDABOUT_RIGHT	string	ラウンドアバウトで右側の出口を出ます。
SHARP_LEFT	string	左に鋭く曲がります。
SHARP_RIGHT	string	右に鋭く回転します。
STRAIGHT	string	そのままにしておきます。
SWITCH_MAIN_ROAD	string	主要道路に切り替えます。
SWITCH_PARALLEL_ROAD	string	平行道路に切り替えます。
TAKE_EXIT	string	終了します。
TAKE_FERRY	string	フェリーに乗る。
TRY_MAKE_UTURN	string	U ターンを試します。
TURN_LEFT	string	左に曲がります。
TURN_RIGHT	string	右折。
WAYPOINT_LEFT	string	ウェイポイントに到達しました。左側にあります。
WAYPOINT_REACHED	string	ウェイポイントに到達しました。
WAYPOINT_RIGHT	string	ウェイポイントに到達しました。右側にあります。

JunctionType

操縦が行われるジャンクションの種類。より大きなラウンドアバウト交差点の場合、ラウンドアバウト交差点への入退出に対して 2 つの個別の命令が生成されます。

名前	型	説明
BIFURCATION	string	分岐
REGULAR	string	レギュラー
ROUNDABOUT	string	ロータリー

LatLongPair

緯度と経度として表される場所。

名前	型	説明
latitude	number	Latitude プロパティ
longitude	number	Longitude プロパティ

Response

クエリの結果です。クエリが正常に完了した場合は RouteDirections、それ以外の場合は ErrorResponse。

名前	型	説明
error	ErrorDetail	error オブジェクト。
formatVersion	string	Format Version プロパティ
optimizedWaypoints	RouteOptimizedWaypoint[]	ウェイポイントの最適化されたシーケンス。元の最適化されたリストに対してユーザーが指定したウェイポイントシーケンスからのインデックスが表示されます。たとえば、応答は次のようになります。 `<optimizedWaypoints> <waypoint providedIndex="0" optimizedIndex="1"/> <waypoint providedIndex="1" optimizedIndex="2"/> <waypoint providedIndex="2" optimizedIndex="0"/> </optimizedWaypoints>` は、元のシーケンスが [0, 1, 2] であり、最適化されたシーケンスが [1, 2, 0] であることを意味します。インデックスは 0 で始まるので、元のは "first, second, third" ですが、最適化は "second, third, first" です。
report	RouteReport	現在の呼び出しで使用されている有効な設定を報告します。
routes	Route[]	Routes 配列

ResponseSectionType

報告されたルート応答のセクションの種類

名前	型	説明
CARPOOL	string	カープール(HOV/高占有車)レーンの使用を必要とするルートのセクション。
CAR_TRAIN	string	車または列車であるルートのセクション。
COUNTRY	string	ルートが含まれる国/地域を示すセクション。
FERRY	string	フェリーであるルートのセクション。
MOTORWAY	string	高速道路であるルートのセクション。
PEDESTRIAN	string	歩行者にのみ適したルートのセクション。
TOLL_ROAD	string	料金を支払う必要があるルートのセクション。
TOLL_VIGNETTE	string	有料ビネットが存在する必要があるルートのセクション。
TRAFFIC	string	トラフィック情報を含むルートのセクション。
TRAVEL_MODE	string	要求パラメーター `travelMode`に関連するセクション。
TUNNEL	string	トンネルであるルートのセクション。
URBAN	string	都市部内に位置するルートのセクション。

ResponseTravelMode

計算されたルートの移動モード。このセクションで要求されたトランスポートモードが不可能な場合、値はに設定 other されます

名前	型	説明
bicycle	string	返されるルートは、自転車レーンの使用を含め、自転車用に最適化されています。
bus	string	返されるルートは、バス専用レーンの使用を含め、バス用に最適化されています。 BETA 機能。
car	string	返されるルートは、車用に最適化されています。
motorcycle	string	返されるルートはオートバイ用に最適化されています。 BETA 機能。
other	string	このセクションでは、指定されたトランスポートモードを使用できません
pedestrian	string	返されるルートは、歩道の使用を含め、歩行者向けに最適化されています。
taxi	string	返されるルートはタクシー用に最適化されています。 BETA 機能。
truck	string	返されるルートは、トラックなどの商用車用に最適化されています。
van	string	返されるルートはバン用に最適化されています。 BETA 機能。

Route

名前	型	説明
guidance	RouteGuidance	ガイダンス関連の要素が含まれています。このフィールドは、ガイダンスが要求され、使用可能な場合にのみ表示されます。
legs	RouteLeg[]	脚の配列
sections	RouteSection[]	Sections 配列
summary	RouteSummary	Summary オブジェクト

RouteDirectionsBatchItem

Route Directions Batch サービス呼び出しから返される項目。

名前	型	説明
response	Response	クエリの結果です。クエリが正常に完了した場合は RouteDirections、それ以外の場合は ErrorResponse。
statusCode	integer	HTTP 要求の状態コード。

RouteDirectionsBatchResult

このオブジェクトは、正常な Route Directions Batch サービス呼び出しから返されます。

名前	型	説明
batchItems	RouteDirectionsBatchItem[]	バッチ結果を含む配列。
summary	Summary	バッチ要求の結果の概要

RouteGuidance

ガイダンス関連の要素が含まれています。このフィールドは、ガイダンスが要求され、使用可能な場合にのみ表示されます。

名前	型	説明
instructionGroups	RouteInstructionGroup[]	相互に関連する命令要素のシーケンスをグループ化します。
instructions	RouteInstruction[]	操作を記述する命令の一覧。

RouteInstruction

"右に曲がる"、"左に置く"、"フェリーに乗る"、"高速道路を取る"、"到着" など、操縦を説明する属性のセット。

名前	型	説明
combinedMessage	string	操縦のための人間が判読できるメッセージと、次の指示からのメッセージを組み合わせた。場合によっては、2 つの連続する命令を 1 つの命令に結合して、従いやすくすることができます。この場合、possibleCombineWithNext フラグは true になります。例: `10. Turn left onto Einsteinweg/A10/E22 towards Ring Amsterdam 11. Follow Einsteinweg/A10/E22 towards Ring Amsterdam` 命令 10 で指定できるCombineWithNext フラグは true です。これは、コード化されたガイダンスのクライアントに対して、命令 11 と組み合わせることができることを示します。指示は、人間が判読できるガイダンスを要求するクライアントに対して自動的に組み合わされます。 combinedMessage フィールドには、結合されたメッセージが含まれています。 `Turn left onto Einsteinweg/A10/E22 towards Ring Amsterdam then follow Einsteinweg/A10/E22 towards Ring Amsterdam.`
countryCode	string	3 文字の ISO 3166-1 alpha-3 国コード。例: 米国
drivingSide	DrivingSide	操縦のポイントで左手と右側の運転を示します。
exitNumber	string	現在の操縦によって取得された高速道路出口の数。出口に複数の終了番号がある場合は、"," で区切られ、"-" で集計される場合があります (例: "10,13-15")。
instructionType	GuidanceInstructionType	指示の種類(道路の形状の変更など)。
junctionType	JunctionType	操縦が行われるジャンクションのタイプ。より大きなラウンドアバウト交差点の場合は、ラウンドアバウト交差点の開始と終了に対して 2 つの個別の命令が生成されます。
maneuver	GuidanceManeuver	操縦を識別するコード。
message	string	操縦のための人間が判読できるメッセージ。
point	LatLongPair	緯度と経度として表される場所。
pointIndex	integer	命令の点に対応するポリライン "points" のリスト内の点のインデックス。
possibleCombineWithNext	boolean	必要に応じて、命令を次の命令と組み合わせることができます。これは、"左に曲がって右に曲がる" などのメッセージを作成するために使用できます。
roadNumbers	string[]	操縦後の次に重要な道路セグメントの道路番号、または従う道路の道路番号。例: ["E34", "N205"]
roundaboutExitNumber	integer	これは、ラウンドアバウト交差点で実行する終了を示します。
routeOffsetInMeters	integer	ルートの開始から命令のポイントまでの距離。
signpostText	string	操縦または従うべき方向に最も関連する道標のテキスト。
stateCode	string	ISO 3166-2 コードの 2 番目の部分で表される国の下位区分 (州など)。これは、米国、カナダ、メキシコなどの一部の国/地域でのみ使用できます。
street	string	操縦後の次に重要な道路セグメントの通り名、または従う必要がある通りの道路名。
travelTimeInSeconds	integer	routeOffsetInMeters に対応するポイントまでの推定移動時間。
turnAngleInDecimalDegrees	integer	命令の方向を示します。 junctionType がターン命令を示す場合: 180 = U ターン [-179, -1] = 左折 0 = ストレートオン ('0 度' ターン) [1, 179] = 右折 junctionType が分岐命令を示す場合: <0 - 左に保つ >0 - 正しい状態に保つ

RouteInstructionGroup

相互に関連する命令要素のシーケンスをグループ化します。シーケンス範囲は、firstInstructionIndex と lastInstructionIndex で制約されます。人間が判読できるテキストメッセージにガイダンス (instructionType=text またはタグ付け) が要求されると、instructionGroup には、使用可能な場合に概要メッセージが返されます。

名前	型	説明
firstInstructionIndex	integer	命令内の最初の命令のインデックスと、このグループに属しています。
groupLengthInMeters	integer	グループの長さ。
groupMessage	string	人間が読み取り可能なテキストメッセージにガイダンスを求められた場合の概要メッセージ (instructionType=text またはタグ付け)。
lastInstructionIndex	integer	命令の最後の命令のインデックスで、このグループに属しています。

RouteLeg

ポイントのリストで構成されるルートの一部の説明。要求で指定された追加の各ウェイポイントは、返されるルートに追加の区間になります。

名前	型	説明
points	LatLongPair[]	Points 配列
summary	RouteLegSummary	ルートセクションの概要オブジェクト。

RouteLegSummary

ルートセクションの概要オブジェクト。

名前	型	説明
arrivalTime	string	ルートまたは区間の推定到着時間。時刻は UTC です。
batteryConsumptionInkWh	number	電力消費量モデルを使用した推定電力消費量 (キロワット時間 (kWh)。 vehicleEngineType が electric に設定され、constantSpeedConsumptionInkWhPerHundredkm が指定されている場合に含まれます。 batteryConsumptionInkWh の値には再充電された電気エネルギーが含まれているため、負の値 (エネルギーの獲得を示す) になる可能性があります。 maxChargeInkWh と currentChargeInkWh の両方を指定した場合、バッテリの充電レベルが maxChargeInkWh を超えないように、再循環が制限されます。 maxChargeInkWh も currentChargeInkWh も指定されていない場合、従量課金計算では制約のない再循環が想定されます。
departureTime	string	ルートまたは区間の推定出発時間。時刻は UTC です。
fuelConsumptionInLiters	number	燃焼消費量モデルを使用した推定燃料消費量 (リットル)。 vehicleEngineType が燃焼に設定され、constantSpeedConsumptionInLitersPerHundredkm が指定されている場合に含まれます。値は負以外になります。
historicTrafficTravelTimeInSeconds	integer	時間に依存する履歴トラフィックデータを使用して計算された推定移動時間。 computeTravelTimeFor = all がクエリで使用されている場合にのみ含まれます。
lengthInMeters	integer	Length In Meters プロパティ
liveTrafficIncidentsTravelTimeInSeconds	integer	リアルタイム速度データを使用して計算された推定移動時間。 computeTravelTimeFor = all がクエリで使用されている場合にのみ含まれます。
noTrafficTravelTimeInSeconds	integer	交通状況 (輻輳など) により、ルートに遅延がないかのように計算された推定移動時間。 computeTravelTimeFor = all がクエリで使用されている場合にのみ含まれます。
trafficDelayInSeconds	integer	トラフィック情報に従って、リアルタイムインシデントによって発生した推定遅延 (秒単位)。将来出発時刻が予定されているルートの場合、遅延は常に 0 になります。さまざまな種類のトラフィック情報を使用して追加の移動時間を返すには、パラメーター computeTravelTimeFor=all を追加する必要があります。
travelTimeInSeconds	integer	リアルタイムトラフィックによる遅延を含む推定移動時間 (秒) プロパティ。 traffic=false travelTimeInSeconds の場合でも、トラフィックによる遅延が含まれていることに注意してください。 DepartAt が将来の場合、移動時間は時間に依存する履歴トラフィックデータを使用して計算されます。

RouteOptimizedWaypoint

最適化されたウェイポイントオブジェクト。

名前	型	説明
optimizedIndex	integer	システムからの最適化されたウェイポイントインデックス。
providedIndex	integer	ユーザーによって提供されるウェイポイントインデックス。

RouteReport

現在の呼び出しで使用されている有効な設定を報告します。

名前	型	説明
effectiveSettings	EffectiveSetting[]	このルート API を呼び出すときに使用される有効なパラメーターまたはデータ。

RouteSection

ルートセクションには、ルートの一部に関する追加情報が含まれています。各セクションには、少なくとも要素 startPointIndex、、 endPointIndexおよび sectionTypeが含まれています。

名前	型	説明
delayInSeconds	integer	インシデントによって発生する遅延 (秒単位)。
effectiveSpeedInKmh	integer	インシデントの有効速度 (km/h) は、その全体の長さの平均です。
endPointIndex	integer	このセクションが適用されるルートの最後のポイント (オフセット 0) のインデックス。
magnitudeOfDelay	DelayMagnitude	インシデントによって発生する遅延の大きさ。これらの値は、トラフィックインシデント詳細の取得 API の応答フィールド ty の値に対応します。
sectionType	ResponseSectionType	報告されたルート応答のセクションの種類
simpleCategory	SimpleCategory	インシデントの種類。現在、JAM、ROAD_WORK、ROAD_CLOSURE、またはその他にすることができます。詳細については、「tec」を参照してください。
startPointIndex	integer	このセクションが適用されるルートの最初のポイント (オフセット 0) のインデックス。
tec	RouteSectionTec	TPEG2-TEC 標準の定義を使用したトラフィックイベントの詳細。 effectCode を含め、要素を引き起こすことができます。
travelMode	ResponseTravelMode	計算されたルートの移動モード。このセクションで要求されたトランスポートモードが不可能な場合、値はに設定 `other` されます

RouteSectionTec

TPEG2-TEC 標準の定義を使用したトラフィックイベントの詳細。 effectCode を含め、要素を引き起こすことができます。

名前	型	説明
causes	RouteSectionTecCause[]	配列の原因
effectCode	integer	トラフィックフローへの影響。 TPEG2-TEC 標準で定義されている tec001:EffectCode テーブルの値を格納します。重要度に応じてトラフィックイベントを色分けするために使用できます。

RouteSectionTecCause

トラフィックイベントの原因。 mainCauseCode 要素と subCauseCode 要素を含めることができます。アイコンと説明を定義するために使用できます。

名前	型	説明
mainCauseCode	integer	トラフィックイベントの主な原因。 TPEG2-TEC 標準で定義されている tec002:CauseCode テーブルの値を格納します。
subCauseCode	integer	トラフィックイベントのサブキュー。 TPEG2-TEC 標準で定義されている mainCauseCode によって定義されたサブ原因テーブルの値を格納します。

RouteSummary

Summary オブジェクト

名前	型	説明
arrivalTime	string	ルートまたは区間の推定到着時間。時刻は UTC です。
departureTime	string	ルートまたは区間の推定出発時間。時刻は UTC です。
lengthInMeters	integer	Length In Meters プロパティ
trafficDelayInSeconds	integer	トラフィック情報に従って、リアルタイムインシデントによって発生した推定遅延 (秒単位)。将来出発時刻が予定されているルートの場合、遅延は常に 0 になります。さまざまな種類のトラフィック情報を使用して追加の移動時間を返すには、パラメーター computeTravelTimeFor=all を追加する必要があります。
travelTimeInSeconds	integer	リアルタイムトラフィックによる遅延を含む推定移動時間 (秒) プロパティ。 traffic=false travelTimeInSeconds の場合でも、トラフィックによる遅延が含まれていることに注意してください。 DepartAt が将来の場合、移動時間は時間に依存する履歴トラフィックデータを使用して計算されます。

SimpleCategory

インシデントの種類。現在、JAM、ROAD_WORK、ROAD_CLOSURE、またはその他にすることができます。詳細については、「tec」を参照してください。

名前	型	説明
JAM	string	交通渋滞。
OTHER	string	その他。
ROAD_CLOSURE	string	道路閉鎖。
ROAD_WORK	string	道路工事。

Summary

バッチ要求の結果の概要

名前	型	説明
successfulRequests	integer	バッチ内の成功した要求の数
totalRequests	integer	バッチ内の要求の合計数

次の方法で共有

Route - Get Route Directions Batch

非同期バッチ結果のダウンロード

バッチ応答モデル

URI パラメーター

要求ヘッダー

応答

セキュリティ

AADToken

メモ

スコープ

subscription-key

SAS Token

例

Successfully retrieve the status for the route direction batch request

要求のサンプル

応答のサンプル

定義

DelayMagnitude

DrivingSide

EffectiveSetting

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GuidanceInstructionType

GuidanceManeuver

JunctionType

LatLongPair

Response

ResponseSectionType

ResponseTravelMode

Route

RouteDirectionsBatchItem

RouteDirectionsBatchResult

RouteGuidance

RouteInstruction

RouteInstructionGroup

RouteLeg

RouteLegSummary

RouteOptimizedWaypoint

RouteReport

RouteSection

RouteSectionTec

RouteSectionTecCause

RouteSummary

SimpleCategory

Summary

その他のリソース