Route - Post Route Matrix

リファレンス

サービス:: Maps

API バージョン:: 1.0

非同期要求を使用して、出発地と目的地のリスト内のすべての可能なペアの移動時間と距離を示すルートマトリックスを取得するために使用します。

Post Route Matrix API は HTTP POST 要求であり、非同期 (非同期) 要求を使用して、出発地と宛先の場所によって定義された一連のルートのルートの概要のマトリックスを計算できます。同期 (同期) 要求を行うには、「ルート後マトリックス同期を参照してください。サービスは、指定された配信元ごとに、その配信元から特定の宛先へのルーティングのコストを計算します。起点のセットと宛先のセットは、テーブルの列ヘッダーと行ヘッダーと考えることができます。テーブル内の各セルには、そのセルの起点から宛先へのルーティングコストが含まれます。たとえば、食品配達会社に 20 人のドライバーがあり、レストランから配送を受け取るために最も近いドライバーを見つける必要があるとします。このユースケースを解決するために、Matrix Route API を呼び出すことができます。

ルートごとに、移動時間と距離が返されます。計算されたコストを使用して、Route Directions API を使用して計算する詳細なルートを決定できます。

非同期要求のマトリックスの最大サイズは 700 で、同期要求の場合は 100 (配信元の数に宛先の数を乗算) 。

手記

すべての原点と目的地は、軸で整列された 400 km x 400 km の境界ボックスに含める必要があります。それ以外の場合、一部のマトリックスセルはOUT_OF_REGIONとして解決されます。

同期ルートマトリックス要求の送信

シナリオで同期要求が必要で、マトリックスの最大サイズが 100 以下の場合は、同期要求を行うことができます。この API のマトリックスの最大サイズは、100 です (起点の数に宛先の数を乗算)。この制約を念頭に置いて、可能な行列ディメンションの例は 10x10、6x8、9x8 です (正方形である必要はありません)。

POST https://atlas.microsoft.com/route/matrix/sync/json?api-version=1.0&subscription-key={subscription-key}

非同期ルートマトリックス要求を送信する

非同期 API は、比較的複雑なルーティング要求の大量の処理に適しています。非同期要求を使用して要求を行うと、既定では、サービスは応答ヘッダーの Location フィールドのリダイレクト URL に沿って 202 応答コードを返します。この URL は、応答データまたはエラー情報が使用可能になるまで定期的に確認する必要があります。要求 waitForResults パラメーターが true に設定されている場合、要求が 120 秒以内に完了すると、ユーザーは 200 応答を受け取ります。

この API のマトリックスの最大サイズは、700 です (起点の数に宛先の数を乗算)。この制約を念頭に置いて、可能な行列ディメンションの例は 50x10、10x10、28x25 です。 10 x 70 (正方形である必要はありません)。

非同期応答は、24 時間格納されます。リダイレクト URL は、有効期限後に使用された場合、404 応答を返します。

POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&subscription-key={subscription-key}

非同期操作の一般的なシーケンスを次に示します。

クライアントがルートマトリックス POST 要求を Azure Maps に送信する
サーバーは、次のいずれかの応答を返します。

HTTP 202 Accepted - ルートマトリックス要求が受け入れされました。

HTTP Error - ルートマトリックス要求の処理中にエラーが発生しました。これは、400 Bad Request またはその他のエラー状態コードのいずれかです。
マトリックスルート要求が正常に受け入れられた場合、応答の Location ヘッダーには、要求の結果をダウンロードするための URL が含まれます。この状態 URI は次のようになります。

  GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}

クライアントは、手順 3 で取得したダウンロード URL に GET 要求を発行して結果をダウンロードします

同期結果のダウンロード

ルートマトリックス同期 API に対して POST 要求を行うと、成功した要求と応答配列に対して 200 応答コードが返されます。応答本文にはデータが含まれるため、後で結果を取得することはできません。

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

要求が 202 Accepted 応答を発行すると、非同期パイプラインを使用して要求が処理されます。応答の location ヘッダーで非同期要求の進行状況を確認する URL が表示されます。この状態 URI は次のようになります。

  GET https://atlas.microsoft.com/route/matrix/{matrixId}?api-version=1.0?subscription-key={subscription-key}

location ヘッダーによって提供される URL は、GET 要求が発行されたときに次の応答を返します。

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

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

POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0

省略可能なパラメーターを含む:

POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&waitForResults={waitForResults}&computeTravelTimeFor={computeTravelTimeFor}&sectionType={sectionType}&arriveAt={arriveAt}&departAt={departAt}&vehicleAxleWeight={vehicleAxleWeight}&vehicleLength={vehicleLength}&vehicleHeight={vehicleHeight}&vehicleWidth={vehicleWidth}&vehicleMaxSpeed={vehicleMaxSpeed}&vehicleWeight={vehicleWeight}&windingness={windingness}&hilliness={hilliness}&travelMode={travelMode}&avoid={avoid}&traffic={traffic}&routeType={routeType}&vehicleLoadType={vehicleLoadType}

URI パラメーター

名前	/	必須	型	説明
format	path	True	JsonFormat	応答の目的の形式。 `json` 形式のみがサポートされています。
api-version	query	True	string	Azure Maps API のバージョン番号。
arriveAt	query		string date-time	RFC 3339 セクション 5.6で定義されている `dateTime` 値として書式設定された宛先ポイントへの到着日時(省略可能なタイムゾーンオフセット付き)。タイムゾーンオフセットが指定されていない場合は、ターゲットポイントのオフセットと見なされます。例： 2023-12-19T16:39:57 2023-12-19T16:39:57-08:00 `arriveAt` パラメーターは、`departAt`、`minDeviationDistance`、または `minDeviationTime`と組み合わせて使用することはできません。
avoid	query		RouteAvoidType[]	ルートを決定するときに、ルートの計算で回避する必要がある何かを指定します。 1 つの要求で複数回指定できます。たとえば、'&avoid=高速道路&avoid=tollRoads&avoid=ferrys' です。ルート範囲要求では、値 alreadyUsedRoads を使用しないでください。
computeTravelTimeFor	query		ComputeTravelTime	さまざまな種類の交通情報 (なし、履歴、ライブ) と既定の最適推定移動時間を使用して、追加の移動時間を返すかどうかを指定します。
departAt	query		string date-time	RFC 3339 セクション 5.6で定義されている `dateTime` 値として書式設定された出発地からの出発日時。タイムゾーンオフセットは省略可能です。タイムゾーンオフセットが指定されていない場合は、原点のオフセットと見なされます。既定値: 今すぐその他の値: `dateTime` 例： 2023-12-19T16:39:57 2023-12-19T16:39:57-08:00 `departAt` パラメーターは、`arriveAt`と組み合わせて使用することはできません。
hilliness	query		InclineLevel	スリル満点のルートのためのヒルネスの程度。このパラメーターは、`routeType`=thrilling と組み合わせてのみ使用できます。
routeType	query		RouteType	要求されたルートの種類。
sectionType	query		SectionType[]	ルート応答で報告されるセクションの種類を指定します。たとえば、sectionType = 歩行者の場合、歩行者のみに適したセクションが返されます。 '§ionType=carTrain§ionType=歩行者§ionType=高速道路' など、1 つの要求で複数回指定できます。既定の sectionType は travelMode 入力を参照します。既定では、travelMode は car に設定されています
traffic	query		boolean	使用可能な値: true - ルーティング中に使用可能なすべてのトラフィック情報を考慮してください false - ルーティング中に現在のトラフィックデータを無視します。現在の交通データはルーティング中は無視されますが、有効な道路速度に対する履歴トラフィックの影響は引き続き組み込まれていることに注意してください。
travelMode	query		TravelMode	要求されたルートの移動モード。定義されていない場合、既定値は 'car' です。要求された travelMode は、ルート全体で使用できない場合があることに注意してください。要求された travelMode が特定のセクションで使用できない場合、そのセクションの応答の travelMode 要素は "other" になります。バス、オートバイ、タクシー、バンの移動モードはベータ機能であることに注意してください。すべての領域で完全な制限データを使用できるわけではありません。
vehicleAxleWeight	query		integer	車両の車軸あたりの重量 (kg)。値が 0 の場合、車軸あたりの重量制限は考慮されません。
vehicleHeight	query		number double	車両の高さ (メートル単位)。値が 0 の場合、高さの制限は考慮されません。
vehicleLength	query		number double	車両の長さ (メートル単位)。値 0 は、長さの制限が考慮されないことを意味します。
vehicleLoadType	query		VehicleLoadType	危険物として分類され、一部の道路から制限される可能性のある貨物の種類。使用可能な vehicleLoadType 値は、米国の Hazmat クラス 1 から 9 に加えて、他の国/地域で使用するための一般的な分類です。 USHazmat で始まる値は米国のルーティング用ですが、他のすべての国/地域には otherHazmat を使用する必要があります。 vehicleLoadType は複数回指定できます。このパラメーターは現在、travelMode=truck に対してのみ考慮されます。
vehicleMaxSpeed	query		integer	km/時間での車両の最高速度。車両プロファイルの最大速度は、高速道路で車両が許可されているかどうかを確認するために使用されます。値が 0 の場合は、車両に適した値が決定され、ルート計画中に適用されることを意味します。ルート計画中に 0 以外の値がオーバーライドされる場合があります。たとえば、現在のトラフィックフローは 60 km/時間です。車両の最高速度が 50 km/時に設定されている場合、現在の状況であるため、ルーティングエンジンは 60 km/時間を考慮します。車両の最高速度が 80 km/時間として提供されているが、現在の交通フローが 60 km/時間の場合、ルーティングエンジンは再び 60 km/時間を使用します。
vehicleWeight	query		integer	車両の重量 (キロ単位)。
vehicleWidth	query		number double	車両の幅 (メートル単位)。値が 0 の場合、幅の制限は考慮されません。
waitForResults	query		boolean	要求を同期的に実行するかどうかを示すブール値。 true に設定すると、要求が 120 秒以内に完了した場合、ユーザーは 200 応答を受け取ります。それ以外の場合、ユーザーはすぐに 202 応答を受け取ります。 202 応答の詳細については、API の説明を参照してください。非同期要求でのみサポートされます。
windingness	query		WindingnessLevel	スリル満点のルートのターンのレベル。このパラメーターは、`routeType`=thrilling と組み合わせてのみ使用できます。

要求ヘッダー

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

要求本文

名前	型	説明
destinations	GeoJsonMultiPoint	有効な `GeoJSON MultiPoint` geometry 型。詳細については、RFC 7946 を参照してください。
origins	GeoJsonMultiPoint	有効な `GeoJSON MultiPoint` geometry 型。詳細については、RFC 7946 を参照してください。

応答

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

名前

型

説明

200 OK

RouteMatrixResult

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

202 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 で、または PowerShell、CLI、Azure SDK、または REST API を使用して Azure Maps アカウントを作成場合にプロビジョニングされる共有キーです。

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

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

型: apiKey
/: query

SAS Token

これは、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーンを介して、Azure Maps リソースのリスト SAS 操作から作成される Shared Access Signature トークンです。

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

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

型: apiKey
/: header

例

Successfully submit a route matrix request

要求のサンプル

HTTP

POST https://atlas.microsoft.com/route/matrix/json?api-version=1.0&routeType=shortest

{
  "origins": {
    "type": "MultiPoint",
    "coordinates": [
      [
        4.85106,
        52.36006
      ],
      [
        4.85056,
        52.36187
      ]
    ]
  },
  "destinations": {
    "type": "MultiPoint",
    "coordinates": [
      [
        4.85003,
        52.36241
      ],
      [
        13.42937,
        52.50931
      ]
    ]
  }
}

応答のサンプル

状態コード:: 200

{
  "formatVersion": "0.0.1",
  "matrix": [
    [
      {
        "statusCode": 200,
        "response": {
          "routeSummary": {
            "lengthInMeters": 495,
            "travelTimeInSeconds": 134,
            "trafficDelayInSeconds": 0,
            "departureTime": "2018-07-27T22:55:29+00:00",
            "arrivalTime": "2018-07-27T22:57:43+00:00"
          }
        }
      },
      {
        "statusCode": 200,
        "response": {
          "routeSummary": {
            "lengthInMeters": 647651,
            "travelTimeInSeconds": 26835,
            "trafficDelayInSeconds": 489,
            "departureTime": "2018-07-27T22:55:29+00:00",
            "arrivalTime": "2018-07-28T06:22:44+00:00"
          }
        }
      }
    ],
    [
      {
        "statusCode": 200,
        "response": {
          "routeSummary": {
            "lengthInMeters": 338,
            "travelTimeInSeconds": 104,
            "trafficDelayInSeconds": 0,
            "departureTime": "2018-07-27T22:55:29+00:00",
            "arrivalTime": "2018-07-27T22:57:13+00:00"
          }
        }
      },
      {
        "statusCode": 200,
        "response": {
          "routeSummary": {
            "lengthInMeters": 647494,
            "travelTimeInSeconds": 26763,
            "trafficDelayInSeconds": 469,
            "departureTime": "2018-07-27T22:55:29+00:00",
            "arrivalTime": "2018-07-28T06:21:32+00:00"
          }
        }
      }
    ]
  ],
  "summary": {
    "successfulRoutes": 4,
    "totalRoutes": 4
  }
}

状態コード:: 202

operation-Location: New URL to check the status of the long-running operation.

定義

名前	説明
ComputeTravelTime	さまざまな種類の交通情報 (なし、履歴、ライブ) と既定の最適推定移動時間を使用して、追加の移動時間を返すかどうかを指定します。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
GeoJsonMultiPoint	有効な `GeoJSON MultiPoint` geometry 型。詳細については、RFC 7946 を参照してください。
InclineLevel	スリル満点のルートのためのヒルネスの程度。このパラメーターは、`routeType`=thrilling と組み合わせてのみ使用できます。
JsonFormat	応答の目的の形式。 `json` 形式のみがサポートされています。
RouteAvoidType	ルートを決定するときに、ルートの計算で回避する必要がある何かを指定します。 1 つの要求で複数回指定できます。たとえば、'&avoid=高速道路&avoid=tollRoads&avoid=ferrys' です。ルート範囲要求では、値 alreadyUsedRoads を使用しないでください。
RouteLegSummary	ルートセクションの概要オブジェクト。
RouteMatrix	Matrix の結果オブジェクト
RouteMatrixQuery	座標の行列を持つオブジェクト。
RouteMatrixResult	このオブジェクトは、成功したルートマトリックス呼び出しから返されます。たとえば、2 つのオリジンと 3 つの変換先が指定されている場合、それぞれに 3 つの要素を含む 2 つの配列が存在します。各要素の内容は、クエリで提供されるオプションによって異なります。
RouteMatrixResultResponse	入力マトリックス内の現在のセルの Response オブジェクト。
RouteMatrixSummary	Summary オブジェクト
RouteType	要求されたルートの種類。
SectionType	ルート応答で報告されるセクションの種類を指定します。たとえば、sectionType = 歩行者の場合、歩行者のみに適したセクションが返されます。 '§ionType=carTrain§ionType=歩行者§ionType=高速道路' など、1 つの要求で複数回指定できます。既定の sectionType は travelMode 入力を参照します。既定では、travelMode は car に設定されています
TravelMode	要求されたルートの移動モード。定義されていない場合、既定値は 'car' です。要求された travelMode は、ルート全体で使用できない場合があることに注意してください。要求された travelMode が特定のセクションで使用できない場合、そのセクションの応答の travelMode 要素は "other" になります。バス、オートバイ、タクシー、バンの移動モードはベータ機能であることに注意してください。すべての領域で完全な制限データを使用できるわけではありません。
VehicleLoadType	危険物として分類され、一部の道路から制限される可能性のある貨物の種類。使用可能な vehicleLoadType 値は、米国の Hazmat クラス 1 から 9 に加えて、他の国/地域で使用するための一般的な分類です。 USHazmat で始まる値は米国のルーティング用ですが、他のすべての国/地域には otherHazmat を使用する必要があります。 vehicleLoadType は複数回指定できます。このパラメーターは現在、travelMode=truck に対してのみ考慮されます。
WindingnessLevel	スリル満点のルートのターンのレベル。このパラメーターは、`routeType`=thrilling と組み合わせてのみ使用できます。

ComputeTravelTime

さまざまな種類の交通情報 (なし、履歴、ライブ) と既定の最適推定移動時間を使用して、追加の移動時間を返すかどうかを指定します。

名前	型	説明
all	string	すべての種類の交通情報の移動時間を計算し、ルート応答の概要に含まれるフィールド noTrafficTravelTimeInSeconds、historicTrafficTravelTimeInSeconds、liveTrafficIncidentsTravelTimeInSeconds のすべての結果を指定します。
none	string	追加の移動時間を計算しません。

ErrorAdditionalInfo

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

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

ErrorDetail

エラーの詳細。

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

ErrorResponse

エラー応答

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

GeoJsonMultiPoint

有効な GeoJSON MultiPoint geometry 型。詳細については、RFC 7946 を参照してください。

名前	型	説明
coordinates	number[]	`GeoJson MultiPoint` ジオメトリの座標。
type	string: MultiPoint	`GeoJSON` 型を指定します。 Point、MultiPoint、LineString、MultiLineString、Polygon、MultiPolygon、GeometryCollection、Feature、FeatureCollection の 9 つの有効な GeoJSON オブジェクトタイプのいずれかである必要があります。

InclineLevel

スリル満点のルートのためのヒルネスの程度。このパラメーターは、routeType=thrilling と組み合わせてのみ使用できます。

名前	型	説明
high	string	高い
low	string	低い
normal	string	正常

JsonFormat

応答の目的の形式。 json 形式のみがサポートされています。

名前	型	説明
json	string	JavaScript オブジェクト表記データ交換形式をする

RouteAvoidType

ルートを決定するときに、ルートの計算で回避する必要がある何かを指定します。 1 つの要求で複数回指定できます。たとえば、'&avoid=高速道路&avoid=tollRoads&avoid=ferrys' です。ルート範囲要求では、値 alreadyUsedRoads を使用しないでください。

名前	型	説明
alreadyUsedRoads	string	同じ道路を複数回使用しないようにします。 `routeType`=スリルと組み合わせて最も便利です。
borderCrossings	string	ルート計算で境界線の交差を回避します。
carpools	string	カープール (HOV/高占有車) レーンの使用を必要とするルートを回避します。
ferries	string	フェリーを避ける
motorways	string	高速道路を避ける
tollRoads	string	有料道路を回避します。
unpavedRoads	string	未舗装の道路を回避する

RouteLegSummary

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

名前	型	説明
arrivalTime	string	ルートまたは区間の推定到着時間。時刻は UTC です。
batteryConsumptionInkWh	number	電力消費量モデルを使用したキロワット時 (kWh) の推定電力消費量。 vehicleEngineType が電気に設定され、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 が将来の場合、移動時間は時間依存の履歴トラフィックデータを使用して計算されます。

RouteMatrix

Matrix の結果オブジェクト

名前	型	説明
response	RouteMatrixResultResponse	入力マトリックス内の現在のセルの Response オブジェクト。
statusCode	integer	入力マトリックス内の現在のセルの StatusCode プロパティ。

RouteMatrixQuery

座標の行列を持つオブジェクト。

名前	型	説明
destinations	GeoJsonMultiPoint	有効な `GeoJSON MultiPoint` geometry 型。詳細については、RFC 7946 を参照してください。
origins	GeoJsonMultiPoint	有効な `GeoJSON MultiPoint` geometry 型。詳細については、RFC 7946 を参照してください。

RouteMatrixResult

このオブジェクトは、成功したルートマトリックス呼び出しから返されます。たとえば、2 つのオリジンと 3 つの変換先が指定されている場合、それぞれに 3 つの要素を含む 2 つの配列が存在します。各要素の内容は、クエリで提供されるオプションによって異なります。

名前	型	説明
formatVersion	string	[バージョンの書式設定] プロパティ
matrix	RouteMatrix[]	ルートの概要の 2 次元配列としての結果。
summary	RouteMatrixSummary	Summary オブジェクト

RouteMatrixResultResponse

入力マトリックス内の現在のセルの Response オブジェクト。

名前	型	説明
routeSummary	RouteLegSummary	ルートセクションの概要オブジェクト。

RouteMatrixSummary

Summary オブジェクト

名前	型	説明
successfulRoutes	integer	応答内の成功したルートの数。
totalRoutes	integer	要求されたルートの合計数。入力マトリックス内のセルの数。

RouteType

要求されたルートの種類。

名前	型	説明
eco	string	エコノミーとスピードでバランスの取れたルート。
fastest	string	最速のルート。
shortest	string	距離別の最短ルート。
thrilling	string	興味深い道路や困難な道路が含まれており、できるだけ少ない高速道路を使用しています。含まれるターンのレベルと、ヒルネスの度合いを選択できます。これを設定する方法については、丘と巻き取りのパラメーターを参照してください。 `routeType`=スリルを伴って計画されているルートには900キロの制限があります

SectionType

ルート応答で報告されるセクションの種類を指定します。

たとえば、sectionType = 歩行者の場合、歩行者のみに適したセクションが返されます。 '§ionType=carTrain§ionType=歩行者§ionType=高速道路' など、1 つの要求で複数回指定できます。既定の sectionType は travelMode 入力を参照します。既定では、travelMode は car に設定されています

名前	型	説明
carTrain	string	車または電車であるルートのセクション。
carpool	string	カープール(HOV/高占有車)レーンの使用を必要とするルートのセクション。
country	string	ルートが含まれる国/地域を示すセクション。
ferry	string	フェリーであるルートのセクション。
motorway	string	高速道路であるルートのセクション。
pedestrian	string	歩行者にのみ適したルートのセクション。
tollRoad	string	通行料の支払いを必要とするルートのセクション。
tollVignette	string	有料ビネットが存在する必要があるルートのセクション。
traffic	string	トラフィック情報を含むルートのセクション。
travelMode	string	要求パラメーター `travelMode`に関連するセクション。
tunnel	string	トンネルであるルートのセクション。
urban	string	市街地内に位置するルートのセクション。

TravelMode

要求されたルートの移動モード。定義されていない場合、既定値は 'car' です。要求された travelMode は、ルート全体で使用できない場合があることに注意してください。要求された travelMode が特定のセクションで使用できない場合、そのセクションの応答の travelMode 要素は "other" になります。バス、オートバイ、タクシー、バンの移動モードはベータ機能であることに注意してください。すべての領域で完全な制限データを使用できるわけではありません。

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

VehicleLoadType

危険物として分類され、一部の道路から制限される可能性のある貨物の種類。使用可能な vehicleLoadType 値は、米国の Hazmat クラス 1 から 9 に加えて、他の国/地域で使用するための一般的な分類です。 USHazmat で始まる値は米国のルーティング用ですが、他のすべての国/地域には otherHazmat を使用する必要があります。 vehicleLoadType は複数回指定できます。このパラメーターは現在、travelMode=truck に対してのみ考慮されます。

名前	型	説明
USHazmatClass1	string	爆発物
USHazmatClass2	string	圧縮ガス
USHazmatClass3	string	引火性液体
USHazmatClass4	string	可燃性固体
USHazmatClass5	string	酸化剤
USHazmatClass6	string	毒
USHazmatClass7	string	放射性
USHazmatClass8	string	腐食性物質
USHazmatClass9	string	雑
otherHazmatExplosive	string	爆発物
otherHazmatGeneral	string	雑
otherHazmatHarmfulToWater	string	水に有害

WindingnessLevel

スリル満点のルートのターンのレベル。このパラメーターは、routeType=thrilling と組み合わせてのみ使用できます。

名前	型	説明
high	string	高い
low	string	低い
normal	string	正常

次の方法で共有

Route - Post Route Matrix

同期ルート マトリックス要求の送信

非同期ルート マトリックス要求を送信する

同期結果のダウンロード

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

URI パラメーター

要求ヘッダー

要求本文

応答

セキュリティ

AADToken

筆記

スコープ

subscription-key

SAS Token

例

Successfully submit a route matrix request

要求のサンプル

応答のサンプル

定義

ComputeTravelTime

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GeoJsonMultiPoint

InclineLevel

JsonFormat

RouteAvoidType

RouteLegSummary

RouteMatrix

RouteMatrixQuery

RouteMatrixResult

RouteMatrixResultResponse

RouteMatrixSummary

RouteType

SectionType

TravelMode

VehicleLoadType

WindingnessLevel

その他のリソース

同期ルートマトリックス要求の送信

非同期ルートマトリックス要求を送信する