ルート検索（徒歩）
/route_walk [GET]
基本情報
概要
徒歩を移動手段として、２地点間のルートを検索します。経由地の指定も可能です。
仕様に関する補足
出発地点と到着地点の距離制限は200kmです。
200kmを越えるとエラーが返却されます。
URL
https://{HOST}/{CID}/v1/route_walk
※APIマーケットの場合はURL体系が異なります
出力形式
- JSON
- GeoJSON
対応言語
- ja, en, ko, zh-CN, zh-TW, th
出力順
- 検索条件を考慮した最適な経路の順
パラメータ
| パラメータ名 | 必須 | 概要 | 型名 | デフォルト値 | 上下限/選択値 | 備考 |
|---|---|---|---|---|---|---|
| start | ✔ | 出発地点 | ・地点のJSON表現 ・文字列（ノードID） ・カンマ区切りの数値（緯度,経度） |
ノードIDの指定例：00007820（表参道駅） | ||
| goal | ✔ | 到着地点 | ・地点のJSON表現 ・文字列（ノードID） ・カンマ区切りの数値（緯度,経度） |
|||
| start_time | 出発時刻 | 文字列（日付時刻） YYYY-MM-DDThh:mm:ss |
時刻の指定例 2019-10-01T08:00:00 詳細はこちらをご覧ください |
|||
| goal_time | 到着時刻 | 文字列（日付時刻） YYYY-MM-DDThh:mm:ss |
時刻の指定例 2019-10-01T08:00:00 詳細はこちらをご覧ください |
|||
| via | 経由地 | 地点のJSON表現（配列） | 経由地指定の上限数はvia_typeによって異なります ・指定順：50地点 ・最適順：10地点 |
|||
| via_type | 経由地巡回モード | 文字列 | specified | specified: 指定順 optimal: 最適順 |
指定した経由地をどのように巡回するかを指定します | |
| speed | 徒歩の速度(単位：km/h) | 数値 | 4.8 | 最小値：3.0 最大値：8.0 |
小数値は第一位まで有効です conditionでavoid_step,avoid_escalatorを指定した場合は無効となります |
|
| condition | 徒歩ルート検索の優先考慮事項 | 文字列 | recommend | recommend: 推奨ルート distance: 距離が短いルート avoid_step: 階段回避ルート avoid_escalator: 階段とエスカレーター回避ルート avoid_rain: 雨に濡れにくいルート babycar: ベビーカーが通れるルート |
avoid_step,avoid_escalatorを指定した場合、speedによる徒歩の速度指定が無効となります avoid_step,avoid_escalator,avoid_rainについては、指定条件を優先的に考慮しますが、必ずしも指定した回避ルートが返却されるものではありませんので、ご留意ください |
|
| order | 出力順 | 文字列 | time | total_distance: 総移動距離 time: 所要時間 |
1対多、または多対1ルート検索の場合のみ有効です | |
| options | 追加出力情報 | 文字列 | turn_by_turn：ターンバイターン情報 | 交差点等、進行情報を案内するための地点情報を取得します | ||
| shape | 形状出力 | 真偽値 | false | true：形状を出力する false：形状を出力しない |
trueを指定時にはshapes(ルート形状)が出力されます | |
| datum | 緯度経度の測地系 | 文字列 | wgs84 | wgs84：世界測地系 tokyo：旧日本測地系 |
||
| coord_unit | 出力データに含まれる緯度経度の単位 | 文字列 | degree | degree：度表記の10進法 millisec：ミリ秒表記 |
||
| lang | 言語 | 文字列 | ja: 日本語 en: 英語 ko: 韓国語 zh-CN: 中国語(簡体字) zh-TW: 中国語(繁体字) th: タイ語 |
出力する言語を指定します ※多言語オプション申込時のみ利用可能 (APIマーケットでは利用不可) |
歩行速度の指定について
所要時間の精度向上のため、指定された速度を基準にルートの諸条件を考慮したものが利用されます。
必ずしも指定した速度の通りの所要時間にはならないことがありますので、予めご了承ください。
1対多、多対1ルート検索について
複数の経路を一度に求めることのできるルート検索です（複数地点を登録する際の上限数は10地点です）。
1対多ルート検索：1つの出発地点に対し、複数の到着地点を指定します。
多対1ルート検索：複数の出発地点に対し、1つの到着地点を指定します。
これらのルート検索を行う場合、経由地を指定することはできません。
緯度経度指定によるパラメータ指定例（1対多ルート検索）は以下の通りです。
start=35.439582,139.380180&goal=[{"lat":35.706822,"lon":139.813956},{"lat":35.655392,"lon":139.748642}]
※出発地点、到着地点の両方で複数の地点を登録することはできません（多対多ルート検索には対応していません）。
複数地点の中に「node」を含めることはできません。
※経路探索に失敗したルートはレスポンスに含まれません。
※演算負荷の高い検索を行うため、距離が長い検索を行う場合などリクエスト内容によってはエラーが発生することがあります。
また、時間当たりのリクエスト数制限についても、1対1のルート検索や他のAPIとは異なります。詳しくは営業担当までお問い合わせください。
ルート検索時の日付（時刻）指定について
出発時刻(start_time)と到着時刻(goal_time)を指定する場合は、どちらか片方を指定してください(同時指定はできません)。
・start_time（日付時刻指定）：出発地からの出発時刻の指定
・goal_time（日付時刻指定）：目的地への到着時刻の指定
両方未指定時の場合は、検索実行日時が出発時刻となります。
地点の JSON 表現
| プロパティ名 | 必須 | 概要 | 型名 | デフォルト値 | 備考 |
|---|---|---|---|---|---|
| lat | (✔) | 緯度 | 数値 | ||
| lon | (✔) | 経度 | 数値 | ||
| node | (✔) | 駅/連絡バス停ID | 文字列 | 経由地の場合、駅/連絡バス停IDは指定できません 緯度経度で指定してください |
|
| name | 地点名称 | 文字列 | |||
| stay-time | 経由地の滞在時間(単位：分) | 数値 | 最小値：0 最大値：300 経由地を指定する場合のみ使用可能です |
地点のJSON表現における必須項目の指定方法について
lat, lon, nodeがすべて指定されている場合は、nodeが優先されます。
latを指定した場合は、lonも必ず指定してください。
lonを指定した場合は、latも必ず指定してください。
lat, lonの指定がない場合は、nodeが必須となります。
経由地の指定方法について
経由地の数だけ地点のJSON表現を配列にして記述します。経由地が1点の場合でも配列表現が必要です。
経由地が1点の場合の記述例は以下の通りです。
via=[{"lat":35.654043,"lon":139.729466}]
最適順ルートを求める場合、経由地は2地点以上登録する必要があります。
経由地指定の上限数は、指定順ルートの場合は50地点、最適順ルートの場合は10地点です。出発地点、到着地点は含みません。
上限数を超える経由地を指定するとエラーとなります。
※オプション契約により、最適順ルートでも最大50地点の経由地指定が可能です。
パラメータ構成例（2点間のルート検索）
・出発地：表参道ヒルズ、到着地：調布駅、到着時刻：2019年10月1日15時
/route_walk?start={"lat":35.663836,"lon":139.712258,"name":"表参道ヒルズ"}&goal=00006197&goal_time=2019-10-01T15:00:00
JSON 表現は URL エンコードをした上でリクエストしてください
レスポンス
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| ルート情報 | items | Routeオブジェクト | 〇 | ルートに関する情報のまとまり |
| 単位情報 | unit | Unitオブジェクト | 出力される単位の情報 |
Routeオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 経路の概要 | summary | RouteSummaryオブジェクト | 経路の概要に関する情報のまとまり | |
| 地点間の移動方法 | sections | RouteSectionItemオブジェクト | 〇 | 地点間の移動に関する情報のまとまり |
| ルート形状 | shapes | FeatureCollectionオブジェクト | ルート形状に関する情報のまとまり shape=true指定時のみ出力 shapesは/shape_walkのGeoJSON形式のレスポンスと同様 |
RouteSummaryオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| ルート結果内番号 | no | 文字列 | ルート結果内番号 | |
| 出発地点 | start | RouteItemオブジェクト 地点情報 |
出発地点に関する情報 | |
| 到着地点 | goal | RouteItemオブジェクト 地点情報 |
到着地点に関する情報 | |
| 移動情報 | move | RouteItemオブジェクト 移動情報 |
||
| 経由地 | via | RouteItemオブジェクト 地点情報 |
〇 | 経由地指定時のみ出力 |
RouteItemオブジェクト（start/goal）
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| タイプ | type | 文字列 | 常にpointが入る | |
| 地点の緯度経度 | coord | Coordinateオブジェクト | 出発地点または到着地点の緯度経度が出力される | |
| 地点の名称 | name | 文字列 | 'start'または'goal'という文字列 リクエストパラメータにて入力された地点情報のJSONにおけるnameの値のどちらかが出力される langパラメータを指定した場合、指定言語の翻訳値が出力される 翻訳できない場合は入力された値または日本語の値が出力される |
Coordinateオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 地点の緯度 | lat | 数値 | ||
| 地点の経度 | lon | 数値 |
RouteItemオブジェクト（move：移動情報）
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| タイプ | type | 文字列 | 常に'move'が入る | |
| 出発時間 | from_time | 文字列 | ||
| 到着時間 | to_time | 文字列 | ||
| 総移動時間(単位：分) | time | 数値 | ||
| 移動距離(単位：m) | distance | 数値 | ||
| 消費カロリー(単位：cal) | calorie | 数値 |
RouteItemオブジェクト（via：経由地）
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 経由地出発時刻 | from_time | 文字列 | ||
| 経由地到着時刻 | to_time | 文字列 | ||
| タイプ | type | 文字列 | 常に'point'が入る | |
| 経由地の緯度経度 | coord | Coordinateオブジェクト | ||
| 経由地名称 | name | 名称 | 具体的には'経由地'という文字列または リクエストパラメータにて入力された地点情報のJSONにおけるnameの値のどちらかが出力される langパラメータを指定した場合、指定言語の翻訳値が出力される 翻訳出来ない場合は入力された値または日本語の値が出力される |
viaオブジェクトは経由地指定時のみ出力され、経由地の数だけ存在します。
RouteSectionItemオブジェクト（type=point：地点間の地点情報）
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| タイプ | type | 文字列 | 常に'point'が入る | |
| 地点の緯度経度 | coord | Coordinateオブジェクト | ||
| 地点名称 | name | 文字列 | デフォルトの名称または リクエストで入力した名称のどちらかが出力される langパラメータを指定した場合、指定言語の翻訳値が出力される 翻訳出来ない場合は入力された値または日本語の値が出力される |
|
| 経由地かどうかのフラグ | with_via | 真偽値 | 常に'true'が入る | |
| 経由地点の滞在時間 | stay_time | 数値 | 前後の移動情報から算出 | |
| 前区間からの角度 | direction | 文字列 | 右回りに16分割した角度 1の場合は22.5度 |
RouteSectionItemオブジェクト（type=move：地点間の移動情報）
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| タイプ | type | 文字列 | 常に'move'が入る | |
| 移動手段 | move | 文字列 | 常に'walk'が入る | |
| 一つ上のpointからの出発時刻 | from_time | 文字列 | ||
| 一つ下のpointへの到着時刻 | to_time | 文字列 | ||
| point間の移動時間(単位：分) | time | 数値 | ||
| point間の移動距離(単位：m) | distance | 数値 | ||
| 区間の路線情報 | line_name | 文字列 | 常に'徒歩'が入る langパラメータを指定した場合、指定言語の翻訳値が出力される |
Unitオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 緯度経度の測地系 | datum | 文字列 | ||
| 緯度経度の出力形式 | coord_unit | 文字列 | ||
| 距離の単位 | distance | 文字列 | 常に 'metre'が入る | |
| 所要時間の単位 | time | 文字列 | 常に 'minute'が入る |
レスポンス例
・出発地：表参道ヒルズ、到着地：調布駅、到着時刻：2019年10月1日15時
{
"items": [
{
"summary": {
"no": "1",
"start": {
"type": "point",
"coord": {
"lat": 35.663836,
"lon": 139.712258
},
"name": "表参道ヒルズ"
},
"goal": {
"type": "point",
"coord": {
"lat": 35.65162,
"lon": 139.54531
},
"name": "goal"
},
"move": {
"type": "move",
"from_time": "2019-10-01T11:18:00+09:00",
"to_time": "2019-10-01T15:00:00+09:00",
"time": 222,
"distance": 16907
}
},
"sections": [
{
"type": "point",
"coord": {
"lat": 35.663836,
"lon": 139.712258
},
"name": "表参道ヒルズ"
},
{
"type": "move",
"move": "walk",
"from_time": "2019-10-01T11:18:00+09:00",
"to_time": "2019-10-01T15:00:00+09:00",
"time": 222,
"distance": 16907,
"line_name": "徒歩"
},
{
"type": "point",
"coord": {
"lat": 35.65162,
"lon": 139.54531
},
"name": "goal"
}
]
}
],
"unit": {
"datum": "wgs84",
"coord_unit": "degree",
"distance": "metre",
"time": "minute"
}
}
レスポンス例(lang=en指定時)
{
"items": [
{
"summary": {
"no": "1",
"start": {
"type": "point",
"coord": {
"lat": 35.663836,
"lon": 139.712258
},
"name": "Omote-sando Hills"
},
"goal": {
"type": "point",
"coord": {
"lat": 35.651624,
"lon": 139.545301
},
"name": "Chofu(Tokyo)"
},
"move": {
"calorie": 815563,
"type": "move",
"from_time": "2019-10-01T11:19:00+09:00",
"to_time": "2019-10-01T15:00:00+09:00",
"time": 221,
"distance": 16905
}
},
"sections": [
{
"type": "point",
"coord": {
"lat": 35.663836,
"lon": 139.712258
},
"name": "Omote-sando Hills"
},
{
"type": "move",
"move": "walk",
"from_time": "2019-10-01T11:19:00+09:00",
"to_time": "2019-10-01T15:00:00+09:00",
"time": 221,
"distance": 16905,
"line_name": "Walk"
},
{
"type": "point",
"coord": {
"lat": 35.651624,
"lon": 139.545301
},
"name": "Chofu(Tokyo)"
}
]
}
],
"unit": {
"datum": "wgs84",
"coord_unit": "degree",
"distance": "metre",
"time": "minute"
}
}