最寄りIC検索

/ic/around [GET]

基本情報

概要

指定した緯度経度の最寄りインターチェンジの一覧を取得します。
車での移動距離、移動時間をルート計算した結果（道なりの距離と時間）を出力します。

仕様に関する補足

取得した「code（スポットコード）」は、ルート検索（車）での経由地指定には利用できません。
ルート検索（車）での経由地指定に使用するICのIDを取得したい場合は、乗降IC検索API（/ic）をご利用ください。

URL

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

※APIマーケットでは提供しておりません

出力形式

JSON

対応言語

ja

パラメータ

パラメータ名	必須	概要	型名	デフォルト値	上下限/選択値	備考
coord	✔	検索の起点となる緯度経度	カンマ区切りの数値			検索を行う基準地点の緯度経度・「緯度,経度」の順で指定・ミリ秒表記、度表記(10進数)に対応
radius		検索半径 (単位：m)	数値	2000	最小値：1 最大値： 10000
type		出入り口指定	文字列		ピリオド区切りで複数指定できます entrance：入口 exit：出口	指定がない場合は「entrance」「exit」の両方を検索します
limit		データの出力件数	数値	5	最小値：1 最大値：5
datum		緯度経度の測地系	文字列	wgs84	wgs84：世界測地系 tokyo：旧日本測地系
coord_unit		出力データに含まれる緯度経度の単位	文字列	degree	degree：度表記の10進法 millisec：ミリ秒表記

パラメータ構成例

日本橋周辺のインターチェンジ入口を5件検索

/ic/around?coord=35.68426300,139.77446966&type=entrance

レスポンス

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

Interchangeオブジェクト

名称	レスポンス名	型名	説明
スポットコード	code	文字列
名称	name	文字列	「道路名 IC名上下線出入口」という形式で出力されます。一部の例外として、上下線、出入口に関する情報を持たないスポットが存在する場合があります
読み仮名	ruby	文字列
緯度経度	coord	オブジェクト
緯度経度からの実距離	distance	数値	道なりを考慮した距離
緯度経度からの所要時間	time	数値	道なりを考慮した移動時間
道路情報	road_info	RoadInfoオブジェクト	データが存在する場合のみ出力

Coordinateオブジェクト

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

RoadInfoオブジェクト

名称	レスポンス名	型名	配列	説明
道路種別の名称	name	文字列

Unitオブジェクト

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

レスポンス例

{
    "items": [
        {
            "code": "02007-IC800086952",
            "name": "首都都心環状線 本町出入口 外回り 入口",
            "ruby": "しゅととしんかんじょうせん ほんちょうでいりぐち そとまわり いりぐち",
            "coord": {
                "lat": 35.685619,
                "lon": 139.77681
            },
            "distance": 688,
            "time": 2,
            "road_info": {
                "name": "有料道路"
            }
        },
        {
            "code": "02007-IC800086142",
            "name": "首都都心環状線 宝町出入口 内回り 入口",
            "ruby": "しゅととしんかんじょうせん たからちょうでいりぐち うちまわり いりぐち",
            "coord": {
                "lat": 35.678619,
                "lon": 139.775095
            },
            "distance": 964,
            "time": 3,
            "road_info": {
                "name": "有料道路"
            }
        },
        {
            "code": "02007-IC800087052",
            "name": "首都都心環状線 神田橋出入口 外回り 入口",
            "ruby": "しゅととしんかんじょうせん かんだばしでいりぐち そとまわり いりぐち",
            "coord": {
                "lat": 35.689386,
                "lon": 139.764652
            },
            "distance": 1320,
            "time": 5,
            "road_info": {
                "name": "有料道路"
            }
        },
        {
            "code": "02007-IC800086262",
            "name": "首都八重洲線 八重洲出入口 北行き 入口",
            "ruby": "しゅとやえすせん やえすでいりぐち きたいき いりぐち",
            "coord": {
                "lat": 35.681147,
                "lon": 139.769424
            },
            "distance": 4647,
            "time": 11,
            "road_info": {
                "name": "有料道路"
            }
        },
        {
            "code": "02007-IC800086272",
            "name": "首都八重洲線 八重洲出入口 南行き 入口",
            "ruby": "しゅとやえすせん やえすでいりぐち みなみいき いりぐち",
            "coord": {
                "lat": 35.67961,
                "lon": 139.768732
            },
            "distance": 6573,
            "time": 15,
            "road_info": {
                "name": "有料道路"
            }
        }
    ],
    "unit": {
        "datum": "wgs84",
        "coord_unit": "degree",
        "distance": "metre",
        "time": "minute"
    }
}