充電スタンド検索 (/evstation/list)

基本情報

充電スタンドの情報を取得できます。

出力形式 デフォルト出力順
JSON
直線距離が近い順
(緯度経度が指定された場合)

リクエストパラメータ

共通パラメータについて も参照してください。

パラメータ名 概要 入力値 必須 デフォルト 説明
address 住所コード 文字列
yes

addressもしくはcoordのどちらかが必須。
   
coord 緯度経度 カンマ区切りの数値(緯度,経度)
yes

addressもしくはcoordのどちらかが必須。
  緯度経度の形式に関しては 緯度経度の形式について を参照
charger 充電タイプコード 文字列 no  
充電タイプのコード一覧についてはレスポンス(下記を参照)と同様。
ピリオド区切りで複数選択が可能。
membership 認証システムコード 文字列 no  
認証システムのコード一覧についてはレスポンス(下記を参照)と同様。
site
設置場所種別コード 文字列 no  
設置場所種別のコード一覧についてはレスポンス(下記を参照)と同様。
ピリオド区切りで複数選択が可能。
connect
コンセントタイプコード 文字列 no  
コンセントタイプのコード一覧についてはレスポンス(下記を参照)と同様。
ピリオド区切りで複数選択が可能。
pay-per-charge 充電毎料金有無 文字列 no  
有料、無料等の指定が可能。
指定方法は下記の通り。
pay : 有料
conditional_free : 条件付き無料
free : 無料
reservation 事前予約 文字列 no  
事前予約の要/不要の指定が可能。
指定方法は下記の通り。
true : 必要
false : 不要
coords 緯度経度の配列 文字列 no  
指定した緯度経度でできたポリラインを元に、ライン沿い検索を実行。
始点から終点までの距離の上限は150km。
width ポリラインからの検索幅 (m) Number no 50
5〜500 の間で指定可能。
coordsを指定した場合のみ有効。

レスポンスオブジェクト

全体概要

{
    count: {
        total: 1,
        offset: 0,
        limit: 10
    },
    items: [
        {
            code: "06014-000001",
            provider: {
                id: "06014",
                name: "ナビタイムジャパン"
            },
            name: "充電スタンド",
            ruby: "じゅうでんすたんど",
            phone: "0792350873",
            address_code: "28201133000",
            address_name: "兵庫県姫路市飾磨区溝1150-1",
            coord: {
                lon: 134.658344,
                lat: 34.79421
            },
            chargers: [
                {
                    code: "1",
                    name: "100V"
                }
            ],
            memberships: [
                {
                    code: "1",
                    name: "トヨタ PHV充電サポート"
                }
            ],
            sites: [
                {
                    code: "1",
                    name: "三菱ディーラー"
                }
            ],
            connect: {
                code: "1",
                name: "ポール型ケーブル付き"
            }
            pay_per_charge: "pay",
            reservation: true,
            auth_membership: "required"
        },
        ...
    ]
}

レスポンスオブジェクトは次のプロパティを持ちます。

プロパティ名 データ型 説明
count Object (Count) 検索件数情報
unit Object (Unit) 単位
items Array (EvStationSpot) 検索結果一覧

Count オブジェクト

Count オブジェクトは次のプロパティを持ちます。

プロパティ名 データ型 説明
total Number 検索条件に該当する総件数
offset Number 出力項目の表示開始位置
limit Number 出力項目数の最大値

例:

{
   "total": 87,
   "offset": 0,
   "limit": 10
}

EvStationSpot オブジェクト

EvStationSpot オブジェクトは次のプロパティを持ちます。

プロパティ名 データ型 説明
code String スポットコード
provider Object (Provider) 提供者情報
name String スポット名
ruby
(optional)
String スポット名の読み仮名
phone
(optional)
String 電話番号
address_code String 住所コード
address_name String 住所の表示名
coord Object (Coordinate) 緯度経度
categories Array (Category) カテゴリの一覧
distance
(conditional)
Number
指定座標からの距離
検索条件に緯度経度を指定されたときに出力される。
chargers
(optional)
Array (Charger) 充電タイプ
memberships
(optional)
Array (EvStationMembership) 認証システム
sites
(optional)
Array (EvStationSite) 充電スタンド種別
connect
(optional)
Object (EvStationConnect) コンセントタイプ
pay_per_charge
(optional)
String
充電毎料金コード
pay : 有料
conditional_free : 条件付き無料
free : 無料
reservation
(optional)
Boolean
事前予約
true : 必要
false : 不要
auth_membership
(optional)
String
認証会員
required : 必須
acceptable : 
not_required : 
unknown : 不明

Provider オブジェクト

Provider オブジェクトは次のプロパティを持ちます。

注釈

注意事項 にも記載していますが、データ提供元情報である本情報は必ず表示するようにしてください。

プロパティ名 データ型 説明
id String 提供者ID
name String 提供者名
url
(OPTIONAL)
String URL
icon.path
(OPTIONAL)
String アイコンのパス
copyright
(OPTIONAL)
String ライセンス表記

Coordinate オブジェクト

Coordinate オブジェクトは次のプロパティを持ちます。

プロパティ名 データ型 説明
lat Number 緯度
lon Number 経度

例:

{
   "lat": 35.68956761,
   "lon": 139.70070036
}

Charger オブジェクト

Charger オブジェクトは次のプロパティを持ちます。

プロパティ名 データ型 説明
code String コード
name String 充電タイプ名称
number Number 個数

充電タイプ一覧:

1 : 100V
2 : 200V
3 : 急速
4 : テスラ急速

例:

{
  "code": "1",
  "name": "100v",
  "number": 2
}

EvStationMembership オブジェクト

EvStationMembership オブジェクトは次のプロパティを持ちます。

プロパティ名 データ型 説明
code String コード
name String 認証システム名称

認証システム一覧

1 : トヨタ PHV充電サポート
2 : EVSSネットワーク
3 : BMW ChargeNow 急速・普通併用
4 : BMW ChargeNow 普通充電器用
5 : JTBおでかけCard
6 : Ene-shop
7 : トヨタ G-Station
8 : イオン WAON
9 : エネゲート エコQ電
10 : タイムズ パーク&チャージ会
11 : 日産ZESP ライト
12 : NSC 急速・普通併用
13 : JTBおでかけCard プレミア
14 : PHV DriveSupport
15 : PHV DriveSupport Plus
16 : 日産ZESP スタンダード / ZESP2
17 : 三菱自動車  電動車両サポート
18 : NCS 急速充電器用
19 : NCS 普通充電器用
99 : その他

例:

{
   "code": "1",
   "name": "トヨタ PHV充電サポート"
}

EvStationSite オブジェクト

EvStationSite オブジェクトは次のプロパティを持ちます。

プロパティ名 データ型 説明
code String コード
name String 充電スタンドの設置場所種別名称

設置場所種別一覧

1 : 三菱ディーラー
2 : 日産ディーラー
3 : トヨタディーラー
4 : メルセデスディーラー
5 : コインパーキング
6 : レストラン
7 : 自動車工場
8 : 宿泊施設・温浴施設
9 : 駅・空港
10 : ショップ・小売店
11 : コンビニ・スーパー
12 : ガソリンスタンド
13 : 道の駅
14 : サービスエリア
15 : レンタカー業者
16 : ショッピングモール
17 : 公共施設
18 : 電気工事事業者
19 : オフィスビル
20 : レジャー・スポーツ施設
22 : Volkswagenディーラー
99 : その他

例:

{
   "code": "1",
   "name": "三菱ディーラー"
}

EvStationConnect オブジェクト

EvStationConnect オブジェクトは次のプロパティを持ちます。

プロパティ名 データ型 説明
code String コード
name String コンセントタイプ名称

コンセントタイプ一覧

1 : ポール型ケーブル付き
2 : ポール型コンセント
3 : コンセントにケーブル後付け
4 : コンセントのみ
5 : 普通充電器なし
9 : 不明

例:

{
   "code": "1",
   "name": "ポール型ケーブル付き"
}

Category オブジェクト

Category オブジェクトは次のプロパティを持ちます。

プロパティ名 データ型 説明
code String カテゴリコード
name String カテゴリ名
ruby String カテゴリ名の読み仮名
level String 階層の深さ
children Array (Category)
子要素
"/category/tree" でのみ出力される。

例:

{
   "code": "0112001001",
   "name": "人気スポット",
   "ruby": "にんきすぽっと",
   "level": "detail"
}
{
   "code": "0801001",
   "name": "ガソリンスタンド",
   "ruby": "がそりんすたんど",
   "level": "small",
   "children": [
       {
           "code": "0801001003",
           "name": "エネオス(JXTG)",
           "ruby": "えねおす/じぇいえっくすてぃーじー",
           "level": "detail"
       },
       ...
   ]
}