経路マトリクスAPI (v1.2)

Download OpenAPI specification:Download

リクエストされた出発地および目的地の緯度経度地点(最大50点)に対し、自動車向け道路ネットワークとの経路マトリクスを行い、所要時間・距離のリストを返却します。

経路マトリクス

経路マトリクスAPI

リクエストされた出発地リスト・目的地リストに対して、以下を提供します。

各出発地から各目的地までの経路のサマリー情報（所要時間および道のり距離）のリスト

以下のような利用用途を想定しています。

各出発地から各目的地までの経路のサマリー情報（所要時間および道のり距離）の一括取得

本APIのご利用に際しては、以下をご留意ください。

本APIで入力可能な緯度経度の範囲は、日本国内に限定されます。
以下の地点がリクエストに含まれている場合、status_code=400 のリクエストエラーとなることがあります。
- 空路でのみアクセス可能な地点
- 弊社データにてフェリー航路が未整備の一部離島（※）の地点
  （※）八丈島（東京都）、青ヶ島（東京都）、宮古島（沖縄県）、石垣島（沖縄県）など
- 周囲に道路が無い地点
出発地から目的地までの経路が見つからない場合、その出発地と目的地の組み合わせの distance、time は null となります。
経路形状および右左折案内情報は返却されません。
本APIの応答タイムアウトは30秒です。経路距離や出発地・目的地の地点数によってはリクエストがタイムアウトする場合がございますので、その場合は地点数を減らすなどしてお試しください。
costing=truck の場合、大型貨物自動車向けの交通規制を回避する経路探索を行う都合上、costing=auto と比較してAPIの応答時間が長くなる場合があります。
本APIは秒間1リクエストのレート制限をかけています。また本APIを連続実行する場合は、前回リクエスト分のレスポンスが返却されてから次のリクエストを実行するようにしてください。
本APIのPV（ページビュー）は、コスト数（出発地×目的地の数）分、カウントされます。
出発地と目的地の組み合わせの distance 、time が null となる場合もカウント対象です。
例：出発地：10地点、目的地：100地点の場合、10×100 = 1000PV

Authorizations:

api_key

header Parameters

x-api-key required	string APIキーによる認証を行います。弊社より提供されたAPIキーを記述してください。
content-type required	string content-typeに下記を設定してください。 `application/json`

Request Body schema: application/json

required

Array of objects[ items [ 1 .. 50 ] ]

入力する出発地の緯度経度リスト

形式

"sources":[{"lon":<経度1>,"lat":<緯度1>},{"lon":<経度2>,"lat":<緯度2>},...,{"lon":<経度n>,"lat":<緯度n>}]

地点は1地点以上50地点以下を設定してください。

入力例

"sources":[
  {"lon":139.703360,"lat":35.69363}
],

required

Array of objects[ items [ 1 .. 50 ] ]

入力する目的地の緯度経度リスト

形式

"targets":[{"lon":<経度1>,"lat":<緯度1>},{"lon":<経度2>,"lat":<緯度2>},...,{"lon":<経度n>,"lat":<緯度n>}]

地点は1地点以上50地点以下を設定してください。

入力例

"targets":[
  {"lon":139.703460,"lat":35.69368}
],

costing

required

string

経路探索の対象車種

値	意味
auto	普通自動車
truck	トラック

形式

"costing":<車種>

車種は auto または truck を設定してください。

入力例

"costing":"auto"

object

経路探索のオプション

形式

"costing_options":{<車種>:{"use_ferry":<フェリー利用優先度>,"use_tolls":<有料道利用優先度>,"height":<車高>,"width":<車幅>,"weight":<車重>,"hazmat":<危険物搭載有無>}}

costing で指定する対象車種（auto または truck）の、経路探索のオプションを設定してください。costing と一致しない経路探索のオプションは無視されます。

入力例

"costing_options":{
  "auto":{
    "use_ferry":0.0,
    "use_tolls":0.0,
    "height":1.6,
    "width":1.6
  }
},

"costing_options":{
  "truck":{
    "use_ferry":0.0,
    "use_tolls":0.0,
    "height":2.6,
    "width":2.0,
    "weight":10.0,
    "hazmat":false
  }
},

Responses

Request samples

Payload

Content type

application/json

{"sources": [{"lon": 139.70336,
"lat": 35.69363
},
{"lon": 139.699163,
"lat": 35.68907
}
],
"targets": [{"lon": 139.70346,
"lat": 35.69368
},
{"lon": 139.702295,
"lat": 35.69072
}
],
"costing": "truck",
"costing_options": {"auto": {"use_ferry": 0.5,
"use_tolls": 0.5,
"height": 0,
"width": 0
},
"truck": {"use_ferry": 1,
"use_tolls": 0,
"height": 2.1,
"width": 1.9,
"weight": 10.7,
"hazmat": true
}
}
}

Response samples

200

Content type

application/json

{"sources_to_targets": [[{"from_index": 0,
"to_index": 0,
"distance": 0.431,
"time": 31
},
{"from_index": 0,
"to_index": 1,
"distance": 0.676,
"time": 61
},
{"from_index": 0,
"to_index": 2,
"distance": 0.842,
"time": 61
}
],
[{"from_index": 1,
"to_index": 0,
"distance": 0.695,
"time": 76
},
{"from_index": 1,
"to_index": 1,
"distance": 0.418,
"time": 46
},
{"from_index": 1,
"to_index": 2,
"distance": 1.106,
"time": 97
}
]
]
}

変更履歴

日付内容

2025年8月28日・costing_option に以下のリクエストインターフェースを追加
　・height（車高）
　・width（車幅）
　・weight（車重）　※truckのみ
　・hazmat（危険物搭載有無）　※truckのみ
・costingの車種に応じた車幅（auto: 1.6m、truck: 2.6m）未満の車幅制限がある道路を通行しない制限事項を削除
・status_code=400 のリクエストエラーとなるケースに「周囲に道路が無い出発地または目的地が含まれる場合」を追加

日付	内容
2025年8月28日	・`costing_option` に以下のリクエストインターフェースを追加　・`height`（車高）　・`width`（車幅）　・`weight`（車重）　※`truck`のみ　・`hazmat`（危険物搭載有無）　※`truck`のみ・`costing`の車種に応じた車幅（`auto`: 1.6m、`truck`: 2.6m）未満の車幅制限がある道路を通行しない制限事項を削除・`status_code=400` のリクエストエラーとなるケースに「周囲に道路が無い出発地または目的地が含まれる場合」を追加