計画停電 WebAPI

現在計画停電は実施されていません.

APIについて

関西電力管内の「計画停電」に関する予定を取得できるWebAPIです. 「日付」「時間帯」「グループ」で絞り込んで,関西電力により発表されている情報を取得することができます.

JSON,JSONPおよびXMLにて提供しています.

変更履歴

  • 2012年7月2日 JSON・JSONPによるWebAPI提供開始
  • 2012年7月2日 XMLによるWebAPI提供開始
  • 2012年7月3日 採用事例「Boxnyaプラグイン」・「mikutterプラグイン」を追加
  • 2012年7月4日 でんき予報データを配信情報に追加

リクエスト

以下のパラメータと共に,URLにGETでアクセスすることにより,該当する停電計画を取得するとこができます.

パラメータ等に問題が有る場合は,エラーメッセージをステータスコード400(Bad Request)と共に返却します.

URL

フォーマットURL
JSONhttp://kteiden.chibiegg.net/api/kteiden.json
JSONPhttp://kteiden.chibiegg.net/api/kteiden.json
XMLhttp://kteiden.chibiegg.net/api/kteiden.xml

パラメータ

パラメータ説明
date日付

取得する日付.
yyyy-MM-dd , yyyy/MM/dd または yyyyMMdd 形式のみ受け付けます.yyyy-MM-ddを推奨します.指定しない場合は現在の日付を利用します.

2012-07-23

period数値

取得する時間帯.
1から6までの数値を受け付けます.指定しない場合は時間帯1から時間帯6までのすべての情報を取得します.

3

group文字列

取得するグループ.
2-Dのようなグループ名を受け付けます.指定しない場合は全てのグループの情報を取得します.
グループ番号は1から6,サブグループはAからHまでが指定できます.

4-C

callback文字列

(JSONPのみ)コールバック関数名.
JSONPにおけるコールバック関数名.このオプションを指定すると,JSONPでのレスポンスとなる.

jQuery17209891077182255685_1341234342147

レスポンス

次のキーバリューを持つオブジェクト(連想配列,辞書)の配列を返します.

キー説明
date日付

日付.
yyyy-MM-dd 形式.

2012-07-23

period数値

時間帯.
1から6の時間帯.

5

order数値

順番.
同一時間帯内での計画停電実施の順番.この値が小さいほど優先的に停電が実施されます.
順番は1から8.

1

group文字列

グループ名.
3-Dのようなグループ名.グループは1から6,サブグループはAからH.

5-G

start時刻

停電開始予定時刻.
停電を実施する開始時刻の予定.基本的には時間帯の開始時刻と同一だが,「当日予定」等で細かく定められた場合はそうでない場合もあります.

10:30

end時刻

停電終了予定時刻.
停電を終了する時刻の予定.基本的には時間帯の終了時刻と同一だが,「当日予定」等で細かく定められた場合はそうでない場合もあります.

13:00

is_implementedBOOL

停電実施の有無.
計画停電を実施する可能性がある場合には true,実施する可能性が無い場合には false.
ただし,trueであったとしても,必ずしも停電が実施されるわけではない事に注意してください.詳しくはsourceパラメータの説明を参照ください.
また,関西電力からは実施しないという情報は配信されませんので,予定時刻の15分ほど前でも「月間予定」の場合に実施無しということにしています.

true

source数値

情報源.
このオブジェクトの情報源.

  • 1 「月間予定」による情報.
  • 2 「翌日予定」による情報.
  • 3 「当日予定」による情報.

基本的に停電計画は関西電力より「月間予定」として公開されています.これは,当日電力が不足した場合にどのグループの停電を実施するかを定めたものであり, 「月間予定」の時点では停電を実施するかどうかは不明です.

次に,前日の18時頃に翌日に停電を実施する可能性が高いと発表されるのが「翌日予定」です.(当サイトではオレンジ色で表記しています.)「翌日予定」が発表された グループは停電を実施する可能性があります.

最後に,当日の実施2時間程度前に発表されるのが「当日予定」であり,「当日予定」が発表されたグループはほぼ確実に停電します.(当サイトでは赤色で表記しています.)

すなわち,is_implemented=trueで,かつ,「翌日予定」や「当日予定」となっている計画が実施される可能性が高いということになります.

2

forecast連想配列

でんき予報.
関西電力による電気利用量予測値.情報が有る場合のみ存在します.
当日分については1時間毎の詳細な情報を元に,時間帯内のピーク値を用います.翌日分については18時以降発表の一日のピーク値を用いています.次のキーを持つ連想配列です.

  • rate 利用率(%)
  • level 供給度
    • 1 : 「安定」90%未満
    • 2 : 「やや厳しい」90%~95%
    • 3 : 「厳しい」95%~97%
    • 4 : 「非常に厳しい」97%以上

    {"rate":86,"level":1}

次のキーバリューを持つオブジェクト(Plan)の配列(Result)を返します.

キー説明
Date日付

日付.
yyyy-MM-dd 形式.

2012-07-23

Period数値

時間帯.
1から6の時間帯.

5

Order数値

順番.
同一時間帯内での計画停電実施の順番.この値が小さいほど優先的に停電が実施されます.
順番は1から8.

1

Grop文字列

グループ名.
3-Dのようなグループ名.グループは1から6,サブグループはAからH.

5-G

Start時刻

停電開始予定時刻.
停電を実施する開始時刻の予定.基本的には時間帯の開始時刻と同一だが,「当日予定」等で細かく定められた場合はそうでない場合もあります.

10:30

End時刻

停電終了予定時刻.
停電を終了する時刻の予定.基本的には時間帯の終了時刻と同一だが,「当日予定」等で細かく定められた場合はそうでない場合もあります.

13:00

IsImplementedBOOL

停電実施の有無.
計画停電を実施する可能性がある場合には true,実施する可能性が無い場合には false.
ただし,trueであったとしても,必ずしも停電が実施されるわけではない事に注意してください.詳しくはsourceパラメータの説明を参照ください.
また,関西電力からは実施しないという情報は配信されませんので,予定時刻の15分ほど前でも「月間予定」の場合に実施無しということにしています.

true

Source数値

情報源.
このオブジェクトの情報源.

  • 1 「月間予定」による情報.
  • 2 「翌日予定」による情報.
  • 3 「当日予定」による情報.

基本的に停電計画は関西電力より「月間予定」として公開されています.これは,当日電力が不足した場合にどのグループの停電を実施するかを定めたものであり, 「月間予定」の時点では停電を実施するかどうかは不明です.

次に,前日の18時頃に翌日に停電を実施する可能性が高いと発表されるのが「翌日予定」です.(当サイトではオレンジ色で表記しています.)「翌日予定」が発表された グループは停電を実施する可能性があります.

最後に,当日の実施2時間程度前に発表されるのが「当日予定」であり,「当日予定」が発表されたグループはほぼ確実に停電します.(当サイトでは赤色で表記しています.)

すなわち,is_implemented=trueで,かつ,「翌日予定」や「当日予定」となっている計画が実施される可能性が高いということになります.

2

Forecastオブジェクト

でんき予報.
関西電力による電気利用量予測値.情報が有る場合のみ存在します.
当日分については1時間毎の詳細な情報を元に,時間帯内のピーク値を用います.翌日分については18時以降発表の一日のピーク値を用いています.次のキーを持つ連想配列です.

  • Rate 利用率(%)
  • Level 供給度
    • 1 : 「安定」90%未満
    • 2 : 「やや厳しい」90%~95%
    • 3 : 「厳しい」95%~97%
    • 4 : 「非常に厳しい」97%以上

    <Forecast>
    <Rate>81</Rate>
    <Level>1</Level>
    </Forecast>

サンプル

  • 日付  :
  • 時間帯 :
  • グループ:

結果

バグ・問い合わせ

本システムに於ける,バグや問い合わせ,要望等はTwitterアカウント(@kteiden)で受け付けています.

免責事項

当サイトで公開されているページおよびAPI等により提供されるデータは 関西電力(株)(http://www.kepco.co.jp/) のホームページ,及びメールで配信されているデータを元に,管理者(@chibiegg)が独自にまとめて公開しているものです.

本システムに関する問い合わせはTwitterアカウント(@kteiden) にて受け付けておりますが,全ての問い合わせに回答できない場合もあることをご了承ください.

本システムは実験的に稼働しているものであり,内容の信頼性は保証いたしません.当サイトを利用したことによるいかなる損害も補償いたしません.正確な情報は 関西電力(株)ホームページ等をご覧ください.

当サイトと関西電力(株)とは一切関係ありません. 当サイトに関する問い合わせを関西電力にしたり,計画停電についての問い合わせを当サイトに頂いてもお答えできません,ご了承ください.

関西電力(株)に帰属する著作物をのぞき, このページの著作権は全て当サイトの管理者である@chibieggに帰属します. 営利目的でない場合に限り,API等から取得したデータは自由に使って構いません.