電気自動車充電スタンド検索
/charging_station [GET]
基本情報
概要
住所コードや緯度経度、フリーワードを指定して条件に合致する電気自動車充電スタンドを検索します。
※当APIをご利用の場合は、専用データ利用のオプション契約が別途必要となります
URL
https://{HOST}/{CID}/v1/charging_station
※APIマーケットでは提供しておりません
出力形式
- JSON
対応言語
- ja, en, ko, zh-CN, zh-TW, th
出力順
- スポットコードの昇順
- 緯度経度を指定した場合は指定緯度経度からの距離昇順
- 検索ワードを指定した場合はキーワードの類似度と検索のランキングを考慮した株式会社ナビタイムジャパン独自のスコア降順
パラメータ
| パラメータ名 | 必須 | 概要 | 型名 | デフォルト値 | 上下限/選択値 | 備考 |
|---|---|---|---|---|---|---|
| word | (✔) | 検索ワード | 文字列 | 検索する文字列を指定してください word、address、coordのいずれかを必ず指定してください |
||
| address | (✔) | 住所コード | 文字列 | 大字レベル（11桁末尾0）まで指定可能 word、address、coordのいずれかを必ず指定してください addressとcoordの同時指定はできません |
||
| coord | (✔) | 検索基点 | カンマ区切りの数値 | 検索を行う基準地点の緯度経度 ・「緯度,経度」の順で指定 ・ミリ秒表記、度表記(10進数)に対応 word、address、coordのいずれかを必ず指定してください addressとcoordの同時指定はできません |
||
| radius | 検索範囲(単位：m) | 数値 | 2000 | 最大値：100000 | coord指定時のみ使用可能 | |
| options | 追加出力情報 | 文字列 | detail：詳細情報 opening_hours：営業時間情報 |
追加で出力する情報 ・ピリオド区切りで複数指定可能 |
||
| payment | 料金条件 | 文字列 | pay：有料 conditional_free：条件付き無料 free： 無料 |
指定の料金条件のみに絞り込みます | ||
| reservation | 事前予約 | 文字列 | true：事前予約必要 false：事前予約不要 |
指定の予約条件のみに絞り込みます | ||
| limit | データの出力件数 | 数値 | 10 | 最小値：1 最大値：100 |
電気自動車充電スタンドデータの出力数 | |
| offset | データの出力開始位置 | 数値 | 0 | 最小値：0 最大値：2000 |
何件目から表示されるか(1件目が0)を指定します | |
| datum | 緯度経度の測地系 | 文字列 | wgs84 | wgs84：世界測地系 tokyo：旧日本測地系 |
||
| coord_unit | 出力データに含まれる緯度経度の単位 | 文字列 | degree | degree：度表記の10進法 millisec：ミリ秒表記 |
||
| lang | 言語 | 文字列 | ja: 日本語 en: 英語 ko: 韓国語 zh-CN: 中国語(簡体字) zh-TW: 中国語(繁体字) th: タイ語 |
出力する言語を指定します ・ピリオド区切りで複数指定可能 ※多言語オプション申込時のみ利用可能 |
radiusの検索範囲について
radiusパラメータにて検索範囲を指定した場合、検索エンジンの仕様上、radius範囲外の電気自動車充電スポットが出力される可能性があります
langパラメータの指定時の注意点
・多言語に対応したレスポンスはMultilingualオブジェクトとして出力されることにご注意ください。
・一部スポットは多言語データが存在しないため、多言語指定時に値が返却されない場合があります。
パラメータ構成例
- 東京都新宿区内の電気自動車充電スタンドを5件検索
/charging_station?address=13104&limit=5
- "青山"を含む電気自動車充電スタンドを詳細情報と営業時間情報を出力して検索
/charging_station?word=青山&options=detail.opening_hours
レスポンス
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 検索数 | count | Countオブジェクト | レスポンスのヒット数などの情報 | |
| スポット情報 | items | Spotオブジェクト | 〇 | スポット情報（電気自動車充電スタンド）のまとまり |
| 単位情報 | unit | Unitオブジェクト | 出力される単位の情報 |
Countオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| トータルヒット件数 | total | 数値 | 検索ヒットした件数 | |
| オフセット値 | offset | 数値 | オフセットが設定されている場合はその値を出力 | |
| データの出力件数 | limit | 数値 | データの出力件数に設定されている値 1件しかヒットしなかった場合でも、limit=10でリクエストしている場合は10と出力 |
Spotオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| スポットコード | code | 文字列 | ||
| スポット名 | name | 文字列/Multilingualオブジェクト | langパラメータ指定時は、Multilingualオブジェクトで出力 | |
| スポット名の読み仮名 | ruby | 文字列/Multilingualオブジェクト | langパラメータ指定時は、Multilingualオブジェクトで出力 ただし"ja"を含む場合のみ(日本語のみ) |
|
| 電話番号 | phone | 文字列 | ||
| 住所コード | address_code | 文字列 | ||
| 住所の表示名 | address_name | 文字列/Multilingualオブジェクト | langパラメータ指定時は、Multilingualオブジェクトで出力 | |
| 緯度経度 | coord | Coordinateオブジェクト | ||
| 距離(単位：m) | distance | 数値 | 検索基点からの距離 パラメータ「coord」指定時のみ出力 |
|
| カテゴリ一覧 | categories | Categoryオブジェクト | 〇 | |
| 充電タイプ | chargers | Chargerオブジェクト | 〇 | データが存在する場合のみ出力 |
| メンバーシップ | memberships | ChargingStationMembershipオブジェクト | 〇 | データが存在する場合のみ出力 |
| 充電スタンド設置場所 | place | ChargingStationPlaceオブジェクト | 〇 | データが存在する場合のみ出力 |
| コンセントタイプ | connect | ChargingStationConnectオブジェクト | 〇 | データが存在する場合のみ出力 |
| 料金条件 | payment | 文字列 | データが存在する場合のみ出力 pay：有料 conditional_free：条件付き無料 free：無料 |
|
| 事前予約 | reservation | 真偽値 | データが存在する場合のみ出力 true：必要 false：不要 |
|
| 詳細情報 | details | SpotDetailオブジェクト | 〇 | パラメータ「options=detail」指定時かつデータが存在する場合のみ出力 出力優先度を考慮してソートされています |
| 認証会員 | auth_membership | 文字列 | データが存在する場合のみ出力 required：必須 acceptable：有 not_required：無 unknown：不明 |
|
| 営業時間情報 | opening_hours | SpotOpeningHoursオブジェクト | パラメータ「options=opening_hours」指定時かつデータが存在する場合のみ出力 |
Multilingualオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 英語名称 | en | 文字列 | ||
| 日本語名称 | ja | 文字列 | ||
| 韓国語名称 | ko | 文字列 | ||
| タイ語名称 | th | 文字列 | ||
| 中国語(簡体字)名称 | zh-CN | 文字列 | ||
| 中国語(繁体字)名称 | zh-TW | 文字列 |
Coordinateオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| スポットの緯度 | lat | 数値 | ||
| スポットの経度 | lon | 数値 |
Categoryオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| カテゴリコード | code | 文字列 | ||
| カテゴリ名 | name | 文字列/Multilingualオブジェクト | langパラメータ指定時は、Multilingualオブジェクトで出力 | |
| カテゴリ名の読み仮名 | ruby | 文字列/Multilingualオブジェクト | langパラメータ指定時は、Multilingualオブジェクトで出力 ただし"ja"を含む場合のみ返却(日本語のみ) |
|
| カテゴリコードのレベル | level | 文字列 | large, middle, small, detail の４階層 |
Chargerオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| コード | code | 文字列 | ||
| 充電タイプ名称 | name | 文字列 | ||
| 個数 | number | 数値 |
ChargingStationMembershipオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| コード | code | 文字列 | ||
| 認証システム名称 | name | 文字列 |
ChargingStationPlaceオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| コード | code | 文字列 | ||
| 充電スタンド設置場所種別名 | name | 文字列 |
ChargingStationConnectオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| コード | code | 文字列 | ||
| コンセントタイプ名称 | name | 文字列 |
SpotDetailオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| テキスト情報 | texts | TextItemオブジェクト | 〇 | データが存在する場合のみ出力 |
TextItemオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 見出し | label | 文字列 | ||
| 文字列値 | value | 文字列 |
SpotOpeningHoursオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 指定した時間の営業フラグ | open | 真偽値 | true：現在時刻が営業時間内の場合 false： 現在時刻が営業時間外の場合 |
|
| 24時間営業であることを示すフラグ | open24h | 真偽値 | 24時間営業であればtrue | |
| 営業時間情報一覧 | schedule | SpotOpeningHoursScheduleオブジェクト | ○ |
SpotOpeningHoursScheduleオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 曜日ID | day_id | 文字列 | 01：月曜日 02：火曜日 03：水曜日 04：木曜日 05：金曜日 06：土曜日 07：日曜日 11：祝日 |
|
| 休業日フラグ | close | 真偽値 | 休業日であればtrue 休業日が不明の場合は表示されません |
|
| 指定した日時に該当する曜日を示すフラグ | applied | 真偽値 | 現在日時に該当する曜日のオブジェクトだった場合にtrueが出力されます 該当する曜日以外の場合は表示されません |
|
| 営業時間 | periods | SpotOpeningHoursPeriodオブジェクト | ○ |
SpotOpeningHoursPeriodオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 営業開始時間 | open_time | 文字列 | ||
| 営業終了時間 | close_time | 文字列 |
Unitオブジェクト
| 名称 | レスポンス名 | 型名 | 配列 | 説明 |
|---|---|---|---|---|
| 緯度経度の測地系 | datum | 文字列 | ||
| 緯度経度の出力形式 | coord_unit | 文字列 |
レスポンス例
{
"count": {
"total": 20,
"offset": 0,
"limit": 10
},
"items": [
{
"code": "01300-23829",
"name": "[EV]東京都庁 第一本庁舎 (地下P)",
"phone": "0353207653",
"address_code": "13104070000",
"address_name": "東京都新宿区西新宿2-8-4",
"coord": {
"lat": 35.686519,
"lon": 139.69425
},
"chargers": [
{
"code": "3",
"name": "急速",
"number": 2
}
],
"place": [
{
"code": "17",
"name": "公共施設"
}
],
"connect": {
"code": "5",
"name": "普通充電器なし"
},
"payment": "free",
"reservation": false,
"details": [
{
"texts": [
{
"label": "営業時間",
"value": "[平日]08:30 - 22:00＼[土]08:30 - 22:00＼[日]08:30 - 22:00＼[祝]08:30 - 22:00"
},
{
"label": "休業日",
"value": "年末年始(12/29-1/3)・不定休あり"
},
{
"label": "CHAdeMO出力",
"value": "90kW"
},
{
"label": "備考",
"value": "【設置位置】地下駐車場 1階＼【注意】当充電設備は2台同時充電可・最大出力は対応車種で1台での充電時のみ対応"
}
]
}
],
"categories": [
{
"code": "0810002001",
"name": "急速充電",
"ruby": "きゅうそくじゅうでん",
"level": "detail"
},
{
"code": "0810002",
"name": "急速充電",
"ruby": "きゅうそくじゅうでん",
"level": "small"
},
{
"code": "0810",
"name": "電気自動車充電スタンド",
"ruby": "でんきじどうしゃじゅうでんすたんど",
"level": "middle"
},
{
"code": "08",
"name": "交通",
"ruby": "こうつう",
"level": "large"
}
],
"auth_membership": "not_required"
}
・・・
],
"unit": {
"datum": "wgs84",
"coord_unit": "degree"
}
}
レスポンス例(多言語返却時 ※lang=ja.en.ko指定)
{
"count": {
"total": 20,
"offset": 0,
"limit": 10
},
"items": [
{
"code": "01300-23829",
"name": {
"en": "[EV] Tokyo Metropolitan Government Daiichi Office Building",
"ja": "[EV]東京都庁 第一本庁舎 (地下P)",
"ko": "[EV] 도쿄 도청 다이이치 본청사"
},
"phone": "0353207653",
"address_code": "13104070000",
"address_name": {
"en": "Tokyo Shinjuku-ku Nishi-shinjuku 2-8-4",
"ja": "東京都新宿区西新宿2-8-4",
"ko": "도쿄도 신쥬쿠구 니시신주쿠 2-8-4"
},
"coord": {
"lat": 35.686519,
"lon": 139.69425
},
"chargers": [
{
"code": "3",
"name": "急速",
"number": 2
}
],
"place": [
{
"code": "17",
"name": "公共施設"
}
],
"connect": {
"code": "5",
"name": "普通充電器なし"
},
"payment": "free",
"reservation": false,
"details": [
{
"texts": [
{
"label": "営業時間",
"value": "[平日]08:30 - 22:00＼[土]08:30 - 22:00＼[日]08:30 - 22:00＼[祝]08:30 - 22:00"
},
{
"label": "休業日",
"value": "年末年始(12/29-1/3)・不定休あり"
},
{
"label": "CHAdeMO出力",
"value": "90kW"
},
{
"label": "備考",
"value": "【設置位置】地下駐車場 1階＼【注意】当充電設備は2台同時充電可・最大出力は対応車種で1台での充電時のみ対応"
}
]
}
],
"categories": [
{
"code": "0810002001",
"name": {
"en": "Fast Charging",
"ja": "急速充電",
"ko": "급속충전"
},
"ruby": {
"ja": "きゅうそくじゅうでん"
},
"level": "detail"
},
{
"code": "0810002",
"name": {
"en": "Fast Charging",
"ja": "急速充電",
"ko": "급속충전"
},
"ruby": {
"ja": "きゅうそくじゅうでん"
},
"level": "small"
},
{
"code": "0810",
"name": {
"en": "Electric Car Charging Station",
"ja": "電気自動車充電スタンド",
"ko": "전기자동차 충전소"
},
"ruby": {
"ja": "でんきじどうしゃじゅうでんすたんど"
},
"level": "middle"
},
{
"code": "08",
"name": {
"en": "Transportation",
"ja": "交通",
"ko": "교통"
},
"ruby": {
"ja": "こうつう"
},
"level": "large"
}
],
"auth_membership": "not_required"
}
・・・
],
"unit": {
"datum": "wgs84",
"coord_unit": "degree"
}
}