最寄りIC検索

/ic/around [GET]

基本情報

概要

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

仕様に関する補足

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

URL

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

※RapidAPIでは提供しておりません

出力形式

  • 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"
    }
}