最寄り駅/バス停検索

/transport_node/around [GET]

基本情報

概要

指定した緯度経度の最寄り駅・バス停の一覧を取得します。
駅の出入り口の考慮，徒歩移動距離の計算がされます。

URL

https://{HOST}/{CID}/v1/transport_node/around

※APIマーケットの場合はURL体系が異なります

出力形式

JSON

対応言語

ja

出力順

指定地点からの距離昇順

パラメータ

パラメータ名	必須	概要	型名	デフォルト値	上下限/選択値	備考
coord	✔	緯度経度	カンマ区切りの数値(緯度, 経度)
term		検索時間範囲(単位：分)	数値	60	最小値：１最大値：1440	指定した分数未満で到達出来る最寄り駅を探索します ※周辺に駅・バス停が少ないときは検索に時間がかかるまたはエラーになる場合があります。その際はtermの時間を減らすと改善する可能性があります
walk_speed		徒歩の速度(単位：km/h)	数値	4.8	最小値: 3.0 最大値: 8.0	小数値は第一位まで有効です
type		出力する交通機関	文字列		交通機関タイプより指定	ピリオド区切りで複数指定できます出力する駅・バス停種別を限定したい場合にご利用ください（未指定の場合は全種別が検索されます）バス停の情報取得は、オプション機能のため、別途契約が必要となります (APIマーケットでは利用不可)
options		追加出力情報	文字列		by_link：路線単位で出力（駅名に加え、交通機関会社名と路線名も出力されます） reins：REINSコード to_gateway：地点から出入り口までの距離を出力(詳細はこちらをご覧ください)	ピリオド区切りで複数指定できます REINSコードのご利用にはお客様側でのREINSコードの契約が必要となります。また、オプション機能のため、別途契約が必要となります (APIマーケットでは利用不可)
limit		データの出力件数	数値	10	最小値：1 最大値：30	最寄り駅・バス停データの出力件数
bus_data		バスデータ利用情報	文字列		timetable：バスデータを利用するかどうかのフラグ	バス停の情報取得は、オプション機能のため、別途契約が必要となります (APIマーケットでは利用不可)
datum		緯度経度の測地系	文字列	wgs84	wgs84：世界測地系 tokyo：旧日本測地系
coord_unit		出力データに含まれる緯度経度の単位	文字列	degree	degree：度表記の10進法 millisec：ミリ秒表記

type（交通機関タイプ）

'type' は以下の文字列を取り得ます。

文字列	概要	備考
station	鉄道駅
airport	空港
port	港
busstop	路線バスのバス停	バス停の情報取得は、オプション機能のため、別途契約が必要となります
shuttle_busstop	空港連絡バスのバス停
highway_busstop	高速バスのバス停	バス停の情報取得は、オプション機能のため、別途契約が必要となります

駅出口情報について

駅出口情報は、ナビタイムジャパンが保有する駅出口情報の中から出力致します。
私有地内に存在するなどの理由により一部駅出口情報は出力出来ない場合がありますので、ご了承ください。

term パラメータについて

検索範囲の指定は「徒歩所要時間」のみとなります。直線距離による指定は出来ません。
なお、'term' で指定した分数「未満」で到達出来る最寄り駅・バス停が検索されます。

walk_speed パラメータについて

所要時間の精度向上のため、指定された速度を基準に、ルートの諸条件を考慮したものが利用されます。
必ずしも指定した速度の通りの所要時間にはならないことを、予めご了承ください。

by_link について

by_link を指定しない場合、各路線の駅のうち、「駅代表点を考慮した距離」が一番近い駅の、一番近い出口が返却されます。
「地点から出入り口の距離」が一番近いものではありません。
by_link 指定時の制限事項として以下の二点が挙げられます
・ruby（読み仮名）プロパティには会社・路線名が反映されません
・会社ID は取得出来ません

REINS コードについて

REINS と弊社での路線解釈が異なるため、一部路線について以下の様な事象が発生する可能性があります。
・出力される路線名称が異なります
・出力された NAVITIME 路線 ID を使って駅を検索した際に、該当する駅が出力されません

to_gatewayについて

このパラメータを指定することで、駅出入り口までの結果が出力されるようになります。
未指定の場合、結果には駅出入り口から駅の代表緯度経度までの移動距離・時間が含まれます。

パラメータ構成例

狛江周辺の最寄り駅を10件検索

/transport_node/around?coord=128275045,502477052&term=10&coord_unit=millisec

新宿３丁目周辺の最寄り駅・バス停を路線別に検索

/transport_node/around?coord=35.691468,139.70353&options=by_link

綾瀬周辺の最寄り駅のレインズコードを取得

/transport_node/around?coord=35.760658,139.822375&options=reins

レスポンス

名称	レスポンス名	型名	配列	説明
駅・バス停情報	items	Nodeオブジェクト	〇
単位情報	unit	Unitオブジェクト		出力される単位の情報

Nodeオブジェクト

名称	レスポンス名	型名	配列	説明
駅/バス停のノードID	id	文字列
駅/バス停の名称	name	文字列
駅/バス停の名称の読み仮名	ruby	文字列
ノードタイプの一覧	types	文字列	〇
住所の表示名	address_name	文字列
住所コード	address_code	文字列
駅/バス停の中心緯度経度	coord	Coordinateオブジェクト		株式会社ナビタイムジャパンが独自で算出しています
出発地点緯度経度からの距離	distance	数値
路線情報	link	Linkオブジェクト		optionsにby_linkが指定された場合にデータが返却されます
レインズコード	reinses	Reins オブジェクト	〇	options に reins が指定された場合のみ、データが存在すれば返却します
所要時間	time	数値
出入り口の名称	gateway	文字列

Coordinateオブジェクト

名称	レスポンス名	型名	配列	説明
緯度	lat	数値
経度	lon	数値

Reinsオブジェクト

名称	レスポンス名	型名	配列
エリア情報	area	ReinsArea オブジェクト
沿線情報	railroad	ReinsRailroad オブジェクト
駅情報	station	ReinsStation オブジェクト
レインズコードと紐づくナビタイムの路線情報	links	Link オブジェクト	〇

ReinsAreaオブジェクト

名称	レスポンス名	型名	配列	説明
エリアコード	code	文字列

ReinsRailroadオブジェクト

名称	レスポンス名	型名
沿線コード	code	文字列
沿線名称	name	文字列
沿線名称の読み仮名	ruby	文字列

ReinsStationオブジェクト

名称	レスポンス名	型名	配列	説明
駅コード	code	文字列
駅名称	name	文字列

Linkオブジェクト

名称	レスポンス名	型名	配列	説明
路線ID	id	文字列
路線名称	name	文字列

Unitオブジェクト

名称	レスポンス名	型名
測地系	datum	文字列
緯度経度の出力形式	coord_unit	文字列
距離の単位	distance	文字列
所要時間の単位	time	文字列

レスポンス例

{
    "items": [
        {
            "id": "00000237",
            "name": "綾瀬",
            "ruby": "あやせ",
            "types": [
                "station"
            ],
            "address_name": "東京都",
            "address_code": "13121003000",
            "coord": {
                "lat": 35.762031,
                "lon": 139.823465
            },
            "distance": 346
        },
        ・・・
    ],
    "unit": {
        "datum": "wgs84",
        "coord_unit": "degree",
        "distance": "metre",
        "time": "minute"
    }
}