(2011/06/20) 2011年夏期の計画停電に対応したAPI v2.00を公開しました。前バージョンから移行する際の注意点もご覧下さい。

これまでのバージョンのページ API v1.00β , API v1.01

最新情報 Twitter @hhlab_bot follow me! tweet this rss

ハッシュタグ:#TeidenAPI

現在の電力使用状況

節電.go.jp (政府の節電ポータルサイト) → http://setsuden.go.jp/

今日の停電時間帯(10月06日 00時03分 更新) 最新情報は東京電力HPをご確認下さい

  A B C D E
2 グループ2-A
9時30分~12時10分
グループ2-B
9時30分~12時10分
グループ2-C
9時30分~12時10分
グループ2-D
9時30分~12時10分
グループ2-E
9時30分~12時10分
3 グループ3-A
11時30分~14時10分
グループ3-B
11時30分~14時10分
グループ3-C
11時30分~14時10分
グループ3-D
11時30分~14時10分
グループ3-E
11時30分~14時10分
4 グループ4-A
13時30分~16時10分
グループ4-B
13時30分~16時10分
グループ4-C
13時30分~16時10分
グループ4-D
13時30分~16時10分
グループ4-E
13時30分~16時10分
5 グループ5-A
15時30分~18時10分
グループ5-B
15時30分~18時10分
グループ5-C
15時30分~18時10分
グループ5-D
15時30分~18時10分
グループ5-E
15時30分~18時10分
1 グループ1-A
17時30分~20時00分
グループ1-B
17時30分~20時00分
グループ1-C
17時30分~20時00分
グループ1-D
17時30分~20時00分
グループ1-E
17時30分~20時00分
  計画停電の予定あり 計画停電の予定なし

最新情報は東京電力HPをご確認下さい http://www.tepco.co.jp/

グループ番号と停電時間帯の組み合わせだけをXMLで出力するAPIも公開しています → http://mukku.org/v2.00/TGL

これは何?

東京電力管内で電力不足時に行われる「計画停電」に関する情報を取得できるWebAPIです。
「地名キーワード」「緯度経度」「郵便番号」のいずれかをリクエストパラメータとして入力すると、
計画停電のグループ番号(1~5)とサブグループ記号(A-E)、今日の停電時間帯、停電時間帯までの残り時間などをXMLやRSS、HTML、JSONの形式で取得できます。

2011年3月16日にv1.00βを公開し、現在、試験運用中です。

更新情報などは「神奈川工科大学情報学部情報メディア学科 速水・服部研究室Twitterアカウント」@hhlab_bot でお知らせいたします。
http://twitter.com/hhlab_bot

使用データ

東京電力HPにて公開されている計画停電の資料をもとにデータベースを構築しました。
http://www.tepco.co.jp/

システム概要

リクエストされた「地名」や「緯度経度」を基にデータベース内から検索を行い、一致するデータがあればXMLやRSSの形式で出力します。

緯度・経度から地名への変換にはYahoo!デベロッパーネットワークで提供されている「リバースジオコーダ」を使用しています。
http://developer.yahoo.co.jp/webapi/map/openlocalplatform/v1/reversegeocoder.html

郵便番号から地名への変換にはzipcloudさんの「郵便番号データ」を使用しています。
http://zipcloud.ibsnet.co.jp/

サーバはロリポップレンタルサーバを利用しています。
http://lolipop.jp/

API更新履歴

データの更新について

各グループ(1~5)と停電時間帯の組み合わせは毎日変わります。
各グループと停電時間帯の組み合わせはシステムで自動設定されますが、
停電実施の有無については、停電2時間前までに東京電力から発表されるため、システムへの反映が難しい場合があります。
この点をご了承いただいた上で、APIをご利用下さい。

APIのご利用について

利用に関してユーザ登録などは必要ありません。
Webアプリやスマートフォンアプリなどでご自由にお使い下さい。

ただし、データの正確性は保証できませんのでご了承下さい。
緊急時を除き、データベース内のデータの更新は1日1回手動で行っています。
最新の情報は東京電力HPをご覧下さい。

APIのご利用にあたって、利用報告や、当サイトへのリンク、ライセンス表記等は特に定めておりませんが、
APIの活用事例や利用事例をご報告頂けると、こちらも励みになります。
また、可能であれば、ご利用事例としてサイト上でもご紹介したいと思っておりますので、ぜひご連絡下さい。
APIのご利用報告はこちら

また、リクエスト数に制限などは設けていませんが、常識の範囲内でのご利用をお願いいたします。
(レンタルサーバでの運用のため、秒単位でのアクセスはお止め下さい)

ご利用事例

当APIを利用して開発されたアプリケーションをご紹介します。
(各アプリケーションの開発者様には、サイト上での公開の許可をいただいております)

・Windowsアプリケーション

計画停電自動シャットダウンツール Poena360様
「計画停電自動シャットダウンツール」
http://fatum.orz.hm/AutoBlackoutShutdown/
グループ(地域)を設定すると自動で計画停電時間を取得し、その時刻にPCをシャットダウンさせるツールです。
計画停電.NET gatekeeper_info様
「計画停電.NET」
http://winpower.blog4.fc2.com/blog-entry-487.html
計画停電時間が接近したらシャットダウン、休止状態に自動移行する機能や、
東京電力の電力供給割合に応じてPCの電源プラン(Vista以上)を変更する機能を備えたアプリケーションです。
Toden Power Information nishio_dens様
「Toden Power Information」
http://usamimi.info/~guiprog/toden/
東京電力の電力供給情報をリアルタイムで表示するツールです。
Javaで作られているため、Windowsのほか、LinuxやMacでも動作します。

・Macアプリケーション

TepcoMeter for Mac サイフォン合同会社様
「TepcoMeter for Mac」
http://scivone.com/info/2011/201103007.html
東京電力の電力供給状況に加え、計画停電の予定時刻と実施有無を通知してくれる計画停電時刻お知らせ機能や、
停電開始前にMacを自動的に終了する機能などを搭載しています。
電気メーター for Mac Mac OS Xソフトサーチ様
「電気メーター for Mac」
http://www.advansteps.com/macxtreme/data/denki.html
東京電力の提供する最新情報を読み込み、情報を分かりやすく表示するデスクトップアプリです。
グループを前もって入力しておけば、更新の際に、計画停電予定の有無を表示します。最大3つの場所に対応。

・AIRアプリケーション

停電リマインダー jtc21様
「停電リマインダー」
http://flash.jtc21.com/blackout_reminder/
次の計画停電の時間帯と、開始までのカウントダウン、東京電力の電力供給状況が表示されるAIRアプリケーションです。

・Webアプリケーション

Teiden Calendar funnypainter様
「Teiden Calendar」
http://www5.pf-x.net/~funnypainter/guide/teiden.html
Googleカレンダーを利用した「計画停電カレンダー」のガジェットの他、当APIのリクエストURL生成ツールを設置されています。
SOS GeoJP kehi様
「SOS GeoJP」
http://sos.geo.jp/readme.html
GPS機能搭載のガラケー全キャリア(docomo/au/softbank/willcom/eMobile)+スマートフォン(iPhone/Android)対応の、
位置情報+メッセージをTwitter上に流すWebアプリです。
計画停電マップ y_hirasawa様
「計画停電マップ」
http://t.yuto.jp/
GoogleMap上で計画停電の予定を確認できるサイトです。
東日本大震災 節電 地震 情報サイト f_zaka様
「東日本大震災 節電 地震 情報サイト」
http://west-japan.appspot.com/
計画停電の情報に加え、東京電力の電力使用状況や放射線の測定値をグラフで表示します。
でんりょくなぅ azaminat様
「でんりょくなぅ」
http://naoberry.com/home/name/power/
計画停電の実施状況と電力消費量の履歴を閲覧できるサイトです。
東京電力の電力使用状況 tnori様
「東京電力の電力使用状況」
http://norikawa.net/Tools/Japan2011/TepcoForecast/tepco.php
計画停電の実施状況に加え、電力消費量や地震と放射線量の情報を配信されています。

・スマートフォンアプリケーション

東京節電 頓智ドット様
「東京節電」
https://market.android.com/details?id=com.tonchidot.tokyosetsuden
東京電力管内の電力使用状況をシンプルなメーターで確認できます。
また、電力の不足が見込まれる場合は自動的にお知らせが届きます。
アプリのトップページで、現在位置の計画節電状況と、東京電力管内の電力使用状況を確認できます。
停電観測 kekenzy様
「停電観測」
https://market.android.com/details?id=com.kekenzy.teiden&feature=search_result
輪番停電をGoogleマップ上から検知するアプリです。
地図をダブルクリックするか、上部のTextに住所を入力し、「検索」ボタンを押下することで、その地域の停電情報を表示します。
東京電力計画停電検索ツール giantroid様
「東京電力計画停電検索ツール」
https://market.android.com/details?id=com.giantroid.android.teiden
郵便番号、もしくは住所から計画停電日時を取得するAndroidアプリです。
輪番停電計画 for iPhone magimatsushiro様
「輪番停電計画 for iPhone」
http://84ma.me/
iPhone(3G/3GS/4)及びiPod Touch上で東京電力が実施している計画停電のエリアを確認し、
当日の実施時間を確認する事ができます。
GPSの位置情報を解析し、計画停電までのカウントダウンを行います。
iTeiden YuiChiLo様
「iTeiden」
http://itunes.apple.com/us/app/id431454624?mt=8&ls=1
計画停電、電力消費情報検索アプリです。

・Webサイト

Magnetic Labo Satoshi_Magnet様
「Magnetic Labo」
http://www.magnetic-labo.com/
当APIで出力したRSSを、Webサイト上に表示されています。
トトといっしょ。 jiji_nyanko様
「トトといっしょ。」
http://pieceofsound.ddo.jp/diary/?p=3988
「東電の計画停電に自宅サーバはどう立ち向かうのか」というタイトルで、
当APIとPHPを使用したLinux環境での、Apacheの自動制御方法を掲載されています。
レンタルカート・マニア ~レンタルカートを楽しもう!~ tyszw様
「レンタルカート・マニア ~レンタルカートを楽しもう!~」
http://rentalkart-mania.com/circuit/
全国のカートコース情報を紹介されているWebサイトです。 計画停電情報の表示に当APIを利用されています。

・Webブラウザ用アドオン

東京電力 Watch (Google Chrome用) tichi73様
「東京電力 Watch (Google Chrome用)」
https://chrome.google.com/webstore/detail/mdfakdnfeiibfnngfmngjiifnloondle
現在の電力使用状況と今後の予測使用量や計画停電の予定を表示します。
データ取得には「東京電力電力供給状況API」「Yahoo!電気予報API」「計画停電情報API」「OfficialTEPCO等のツイート」を、
グラフ表示には jqPlot を利用しています。

API仕様

前バージョン(1.01)から移行する際の注意点

APIバージョン v1.01 から v2.00 に移行するに当たって、一部、仕様の変更があります。
今回の仕様変更では、ver1.01公開時にAPI利用者の皆様からいただいたご意見やご要望をもとに、機能の追加と修正を行いました。
特に重要な変更点を太字で表しています。

・リクエストパラメータ
・レスポンスフィールド(XML出力・JSON出力)
・レスポンスフィールド(RSS出力・HTML出力)
・グループ番号と停電時間帯の組み合わせを出力する専用API「TGL」
・システム構成

リクエストパラメータ

前バージョン(v1.01)からの変更点を太字で表記しています。
パラメータ 説明 必須
input add , geo , zip 検索方法の指定(いずれか1つ指定)
  • add : 市町村名で検索
  • geo : 緯度経度で検索
  • zip : 郵便番号で検索
city 文字列 UTF-8でURLエンコードされた検索地名キーワード
  • 下荻野 : %e4%b8%8b%e8%8d%bb%e9%87%8e
  • 厚木市下荻野 : %e5%8e%9a%e6%9c%a8%e5%b8%82%e4%b8%8b%e8%8d%bb%e9%87%8e
  • 神奈川県厚木市下荻野 : %e7%a5%9e%e5%a5%88%e5%b7%9d%e7%9c%8c%e5%8e%9a%e6%9c%a8%e5%b8%82%e4%b8%8b%e8%8d%bb%e9%87%8e

(inputでaddを指定した場合)
lat 数値 緯度
(ex. 35.47673)

(inputでgeoを指定した場合)
lon 数値 経度
(ex. 139.346093)

(inputでgeoを指定した場合)
datum wgs , tky 測位系
inputでgeoを指定した場合のオプション
デフォルトはwgs

zn 数値 郵便番号
7桁の数値(ex. 2430203 , 243-0203)

(inputでzipを指定した場合)
gn 数値(1~5) グループ番号
1桁の数値(ex. 4)
グループ番号での絞り込みが可能

sgn 文字列(A~E) サブグループ記号
1文字のアルファベット(ex. B)
サブグループ記号での絞り込みが可能

gid 数値(1~25) グループID(API独自)
グループ1-Aから5-Eまでを25の数字で表現(ex. 2-Bグループは7)
グループIDでの絞り込みが可能

output xml , rss , html , json 出力方法の指定(いずれか1つ指定)
  • xml : XML形式で出力
  • rss : RSS形式で出力
  • html : HTML形式で出力
  • json : JSON形式で出力
デフォルトはxml

count 数値 出力件数の指定
1~200の範囲
デフォルトは20、outputでrss/htmlを指定した場合は最大50

page 数値 出力ページ番号の指定
1~10の範囲
デフォルトは1、outputでrss/htmlを指定した場合は1で固定

ad onのみ 翌日~2週間後までの計画停電時間を取得できる機能
デフォルトでは無効
※1
days 数値 計画停電時間を取得する日時(○日後)
1(翌日)~14(2週間後)の範囲
デフォルトは1(翌日)

(adをonに設定した場合)
※2
year 数値 計画停電時間を取得する日時(年)
2011のみ

(adをonに設定した場合)
※3
mon 数値 計画停電時間を取得する日時(月)
6~12の範囲(ただし、翌日~2週間後の範囲)
デフォルトはAPIにアクセスした月

(adをonに設定した場合)
※3
day 数値 計画停電時間を取得する日時(日)
1~31の範囲(ただし、翌日~2週間後の範囲)
デフォルトはAPIにアクセスした翌日

(adをonに設定した場合)
※3
test onのみ 停電時のAPIレスポンスのシミュレート機能
デフォルトでは無効

rem 数値 (停電時シミュレート機能有効時)シミュレートする停電までの残り秒数の指定
-43200秒(停電12時間後)~43200秒(停電12時間前)の範囲
デフォルトは600秒前(停電10分前)

※1:ad を on に設定した場合は、days もしくは year,mon,day どちらかの方法で日付指定をしてください
指定できる日付は翌日から2週間後までです。過去の計画停電時間は取得できません
※2:year,mon,day を指定した場合は、days を指定する必要はありません
※3:days を指定した場合は、year,mon,day を指定する必要はありません

リクエストURLサンプル

・市町村名で検索 ・緯度・経度で検索 ・郵便番号で検索 ・取得する日時の指定機能 (APIv2.00からの新機能)
(本機能利用時はレスポンスデータ内の count の値が常に 0 になります) ・停電時シミュレート機能 (APIv2.00からの新機能)
(本機能利用時はレスポンスデータ内の count の値が常に 1 になります。本APIを利用したアプリケーションの動作確認等にご利用下さい) ・グループ番号と停電時間帯の組み合わせだけを出力(専用API・XMLとJSON出力に対応・ad/testオプションに対応)

リクエストURL生成ツール

市町村名で生成:
郵便番号で生成:

レスポンスフィールド

前バージョン(v1.01)からの変更点を太字で表記しています。
フィールド 説明
ResultInfo フィールド
SearchType 文字列 検索方法(add , geo , zip)
City 文字列 地区名(inputでadd/zipを指定した場合)
CityKana 文字列 地区名のカナ表記(inputでzipを指定した場合)
Lat 数値 緯度(inputでgeoを指定した場合)
Lon 数値 経度(inputでgeoを指定した場合)
Zip 数値 郵便番号(inputでzipを指定した場合)
Group 数値 グループ番号(グループ番号を指定した場合)
SubGroup 文字列 サブグループ記号(サブグループ記号を指定した場合)
GroupID 数値 グループID(グループIDを指定した場合)
Total 数値 検索ヒット数
Count 数値 出力件数
Page 数値 ページ番号(ページ番号を指定した場合)
Day 数値 出力日時(出力日時を指定した場合)
(1:翌日 ~ 14:2週間後)
Status 文字列 ステータスフラグ(OKのみ)
(LastUpDate)
PowerCutTime
文字列 グループごとの停電時間帯の最終更新日時(RFC2822フォーマット)
(LastUpDate)
GroupData
文字列 地名データの最終更新日時(RFC2822フォーマット)
(LastUpDateEpoch)
PowerCutTime
数値 グループごとの停電時間帯の最終更新日時(エポック秒)
(LastUpDateEpoch)
GroupData
数値 地名データの最終更新日時(エポック秒)
SystemTime 文字列 リクエスト処理日時(RFC2822フォーマット)
SystemTimeEpoch 数値 リクエスト処理日時(エポック秒)
SystemVersion 文字列 システムバージョン
Info 文字列 管理者からのお知らせ等
Description 文字列 注意事項等
Copyright 文字列 著作権情報
Result フィールド
Prefecture 文字列 都道府県名
CityName1 文字列 市区群名
CityName2 文字列 大字名
Group 数値 停電地域グループ番号
SubGroup 文字列 停電地域サブグループ記号
GroupID 数値 停電地域グループID(API独自)
グループ1-Aから5-Eまでを1から25の数字で表したもの
All 文字列 停電時間帯の日本語表記
Count 数値 1日で停電する回数(0から1)※1
Start 数値 停電開始時間(エポック秒)
End 数値 停電終了時間(エポック秒)
StartRfc 文字列 停電開始時間(RFC2822フォーマット)
EndRfc 文字列 停電終了時間(RFC2822フォーマット)
StartRemaining 数値 停電開始までの残り時間(秒数)※2
EndRemaining 数値 停電終了までの残り時間(秒数)※2
※1:countの値 0:「計画停電の予定なし」 1:「計画停電の予定あり」
※2:すでに過ぎた場合は経過時間になります(マイナス-がつきます)

レスポンスXMLサンプル

http://mukku.org/v2.00/?input=add&city=%E7%A5%9E%E5%A5%88%E5%B7%9D%E7%9C%8C%E5%8E%9A%E6%9C%A8%E5%B8%82%E4%B8%8B%E8%8D%BB%E9%87%8E

レスポンスRSSサンプル

http://mukku.org/v2.00/?input=add&city=%E7%A5%9E%E5%A5%88%E5%B7%9D%E7%9C%8C%E5%8E%9A%E6%9C%A8%E5%B8%82%E4%B8%8B%E8%8D%BB%E9%87%8E&output=rss

エラー時のレスポンスXMLサンプル

リクエストパラメータにエラーがあった場合は以下のエラーが返ってきます。

APIについてのお問い合わせ・不具合報告・ご利用報告

「神奈川工科大学情報学部情報メディア学科 速水・服部研究室Twitterアカウント」
Twitter @hhlab_bot 宛てにお願いいたします。
http://twitter.com/hhlab_bot

Twitterアカウントをお持ちでない方は、メールフォームをご利用ください。
外部サイト (フォームメーラー様) のメールフォームを利用しています。
計画停電情報APIお問い合わせフォーム

ロリポップレンタルサーバ Yahoo!デベロッパーネットワーク Valid XHTML 1.0 Transitional follow me! tweet this SSL標準装備の無料メールフォーム作成・管理ツール | フォームメーラー