到達圏探索(自転車)

/reachable_bicycle [GET]

基本情報

概要

自転車を移動手段として、指定した地点から指定した時間または距離で到達可能な地点を探索します。

URL

https://{HOST}/{CID}/v1/reachable_bicycle

※Rakuten RapidAPIの場合は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のいずれか 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"
    }
}