電気自動車充電スタンド検索

/charging_station [GET]

基本情報

概要

住所コードや緯度経度、フリーワードを指定して条件に合致する電気自動車充電スタンドを検索します。
※当APIをご利用の場合は、専用データ利用のオプション契約が別途必要となります

URL

https://{HOST}/{CID}/v1/charging_station

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

出力形式

  • 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 の4階層

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