到達圏探索(自転車)
/reachable_bicycle [GET]
基本情報
概要
自転車を移動手段として、指定した地点から指定した時間または距離で到達可能な地点を探索します。
URL
https://{HOST}/{CID}/v1/reachable_bicycle
※APIマーケットの場合はURL体系が異なります
出力形式
- JSON
対応言語
- ja
出力順
- 所要時間の昇順
パラメータ
パラメータ名 | 必須 | 概要 | 型名 | デフォルト値 | 上下限/選択値 | 備考 |
---|---|---|---|---|---|---|
start | ✔ | 出発地点 | ・カンマ区切りの数値(緯度, 経度) ・文字列(ノードID) |
|||
term | (✔) | 探索時間の範囲(単位:分) | 数値 | 最小値:1 最大値:180 |
termまたはrangeのどちらかを必ず指定してください | |
range | (✔) | 探索距離の範囲(単位:m) | 数値 | 最小値:1 最大値:300,000 |
termまたはrangeのどちらかを必ず指定してください | |
partition_count | 到達圏探索の分割数 | 数値 | 36 | 下記のいずれか 3,4,6,9,12,18, 36,40,45,60,72,90 |
360度の探索範囲を何分割するかを指定します 36で指定した場合は10度ずつ進行方向が区切られ、計36地点が算出されます |
|
bicycle_speed | 自転車の速度(単位:km/h) | 数値 | 15 | 最小値:5 最大値:132 |
整数のみ指定可能です | |
datum | 緯度経度の測地系 | 文字列 | wgs84 | wgs84:世界測地系 tokyo:旧日本測地系 |
||
coord_unit | 出力データに含まれる緯度経度の単位 | 文字列 | degree | degree:度表記の10進法 millisec:ミリ秒表記 |
自転車の速度指定について
所要時間の精度向上のため、指定された速度を基準にルートの諸条件を考慮したものが利用されます。
必ずしも指定した速度の通りの所要時間にはならないことがありますので、予めご了承ください。
パラメータ構成例
・東京タワーから自転車で30分で到達出来る36地点を探索
/reachable_bicycle?start=35.658639,139.745471&term=30&partition_count=36
レスポンス
名称 | レスポンス名 | 型名 | 配列 | 説明 |
---|---|---|---|---|
検索数 | count | 数値 | 出力された情報数 | |
到達圏結果情報 | items | ReachablePointオブジェクト | 〇 | 到達圏結果情報のまとまり |
単位情報 | unit | Unitオブジェクト | 出力される単位の情報 |
ReachablePointオブジェクト
名称 | レスポンス名 | 型名 | 配列 | 説明 |
---|---|---|---|---|
所要時間 | time | 数値 | その地点へ到達するまでの時間 | |
緯度経度 | coord | Coordinateオブジェクト | 地点の緯度経度 |
Coordinateオブジェクト
名称 | レスポンス名 | 型名 | 配列 | 説明 |
---|---|---|---|---|
緯度 | lat | 数値 | ||
経度 | lon | 数値 |
Unitオブジェクト
名称 | レスポンス名 | 型名 | 配列 | 説明 |
---|---|---|---|---|
緯度経度の測地系 | datum | 文字列 | ||
緯度経度の出力形式 | coord_unit | 文字列 | ||
時間の単位 | time | 文字列 | minute:分 パラメータで'term'を指定した場合のみ出力 |
レスポンス例
{
"count": 36,
"items": [
{
"time": 30,
"coord": {
"lat": 35.604888,
"lon": 139.733175
}
},
{
"time": 30,
"coord": {
"lat": 35.60711,
"lon": 139.729971
}
},
{
"time": 30,
"coord": {
"lat": 35.611591,
"lon": 139.715245
}
},
{
・・・
}
],
"unit": {
"datum": "wgs84",
"coord_unit": "degree",
"time": "minute"
}
}