(2011/06/20) 2011年夏期の計画停電に対応したAPI v2.00を公開しました。前バージョンから移行する際の注意点もご覧下さい。
これまでのバージョンのページ API v1.00β , API v1.01
最新情報 Twitter @hhlab_bot
- () twitter read error!
現在の電力使用状況
節電.go.jp (政府の節電ポータルサイト) → http://setsuden.go.jp/
今日の停電時間帯(11月04日 00時03分 更新) 最新情報は東京電力HPをご確認下さい
A | B | C | D | E | |
1 | グループ1-A 9時30分~12時10分 |
グループ1-B 9時30分~12時10分 |
グループ1-C 9時30分~12時10分 |
グループ1-D 9時30分~12時10分 |
グループ1-E 9時30分~12時10分 |
2 | グループ2-A 11時30分~14時10分 |
グループ2-B 11時30分~14時10分 |
グループ2-C 11時30分~14時10分 |
グループ2-D 11時30分~14時10分 |
グループ2-E 11時30分~14時10分 |
3 | グループ3-A 13時30分~16時10分 |
グループ3-B 13時30分~16時10分 |
グループ3-C 13時30分~16時10分 |
グループ3-D 13時30分~16時10分 |
グループ3-E 13時30分~16時10分 |
4 | グループ4-A 15時30分~18時10分 |
グループ4-B 15時30分~18時10分 |
グループ4-C 15時30分~18時10分 |
グループ4-D 15時30分~18時10分 |
グループ4-E 15時30分~18時10分 |
5 | グループ5-A 17時30分~20時00分 |
グループ5-B 17時30分~20時00分 |
グループ5-C 17時30分~20時00分 |
グループ5-D 17時30分~20時00分 |
グループ5-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更新履歴
- 2011年3月16日~提供開始 Ver1.00β:http://mukku.org/v1.00/ β版【2011年6月末でサービス終了】
- 2011年3月27日~提供開始 Ver1.01:http://mukku.org/v1.01/ 25グループ化対応・2011年夏期対応
- 2011年6月20日~提供開始 Ver2.00:http://mukku.org/v2.00/ 2011年夏期対応・仕様追加と修正
データの更新について
各グループ(1~5)と停電時間帯の組み合わせは毎日変わります。
各グループと停電時間帯の組み合わせはシステムで自動設定されますが、
停電実施の有無については、停電2時間前までに東京電力から発表されるため、システムへの反映が難しい場合があります。
この点をご了承いただいた上で、APIをご利用下さい。
APIのご利用について
利用に関してユーザ登録などは必要ありません。
Webアプリやスマートフォンアプリなどでご自由にお使い下さい。
ただし、データの正確性は保証できませんのでご了承下さい。
緊急時を除き、データベース内のデータの更新は1日1回手動で行っています。
最新の情報は東京電力HPをご覧下さい。
APIのご利用にあたって、利用報告や、当サイトへのリンク、ライセンス表記等は特に定めておりませんが、
APIの活用事例や利用事例をご報告頂けると、こちらも励みになります。
また、可能であれば、ご利用事例としてサイト上でもご紹介したいと思っておりますので、ぜひご連絡下さい。
APIのご利用報告はこちら
また、リクエスト数に制限などは設けていませんが、常識の範囲内でのご利用をお願いいたします。
(レンタルサーバでの運用のため、秒単位でのアクセスはお止め下さい)
ご利用事例
当APIを利用して開発されたアプリケーションをご紹介します。
(各アプリケーションの開発者様には、サイト上での公開の許可をいただいております)
・Windowsアプリケーション
Poena360様 「計画停電自動シャットダウンツール」 http://fatum.orz.hm/AutoBlackoutShutdown/ グループ(地域)を設定すると自動で計画停電時間を取得し、その時刻にPCをシャットダウンさせるツールです。 |
|
gatekeeper_info様 「計画停電.NET」 http://winpower.blog4.fc2.com/blog-entry-487.html 計画停電時間が接近したらシャットダウン、休止状態に自動移行する機能や、 東京電力の電力供給割合に応じてPCの電源プラン(Vista以上)を変更する機能を備えたアプリケーションです。 |
|
nishio_dens様 「Toden Power Information」 http://usamimi.info/~guiprog/toden/ 東京電力の電力供給情報をリアルタイムで表示するツールです。 Javaで作られているため、Windowsのほか、LinuxやMacでも動作します。 |
・Macアプリケーション
サイフォン合同会社様 「TepcoMeter for Mac」 http://scivone.com/info/2011/201103007.html 東京電力の電力供給状況に加え、計画停電の予定時刻と実施有無を通知してくれる計画停電時刻お知らせ機能や、 停電開始前に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アプリケーション
funnypainter様 「Teiden Calendar」 http://www5.pf-x.net/~funnypainter/guide/teiden.html Googleカレンダーを利用した「計画停電カレンダー」のガジェットの他、当APIのリクエストURL生成ツールを設置されています。 |
|
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アプリです。 |
|
magimatsushiro様 「輪番停電計画 for iPhone」 http://84ma.me/ iPhone(3G/3GS/4)及びiPod Touch上で東京電力が実施している計画停電のエリアを確認し、 当日の実施時間を確認する事ができます。 GPSの位置情報を解析し、計画停電までのカウントダウンを行います。 |
|
YuiChiLo様 「iTeiden」 http://itunes.apple.com/us/app/id431454624?mt=8&ls=1 計画停電、電力消費情報検索アプリです。 |
・Webサイト
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ブラウザ用アドオン
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利用者の皆様からいただいたご意見やご要望をもとに、機能の追加と修正を行いました。
特に重要な変更点を太字で表しています。
- RSS/HTML出力時の出力件数[count](オプション)の最大値をこれまでの20件から50件に変更しました
- ページ番号指定[page](オプション)を追加しました
- 翌日~2週間後の計画停電時間を取得できる日時指定機能[ad](オプション)を追加しました
- 停電時のAPIレスポンスをシミュレートする機能[test](オプション)および[rem](オプション)を追加しました
- 2011年夏期の計画停電では、原則各グループ1回までの停電に変更されたため、
Result フィールド内のCountの値を、0 もしくは 1 の 2通りに変更しました - 計画停電が予定されていない場合 (Result フィールド内の Count の値が0) でも、
本来の停電時間帯を返すように変更しました - ResultInfo フィールド内に地名のカナ表記を表す CityKana フィールドを追加しました (郵便番号での検索時のみ表示)
- ResultInfo フィールド内に Page フィールドと Day フィールドを追加しました
- JSON出力時のレスポンスデータを修正しました。各地名ごとの停電時間を CityGroup 配列に格納しました
- 生成される文章を一部変更しました
- これまでのXML出力に加え、JSON出力に対応しました
http://mukku.org/v2.00/TGL/?output=json で使用できます - 翌日~2週間後の計画停電時間を取得できる日時指定機能[ad](オプション)を追加しました
http://mukku.org/v2.00/TGL/?ad=on&days=2 で2日後の計画停電時間を取得できます
- 郵便番号から地名への変換に外部APIを使用せず、新たに構築したデータベースを使用します
リクエストパラメータ
前バージョン(v1.01)からの変更点を太字で表記しています。パラメータ | 値 | 説明 | 必須 |
---|---|---|---|
input | add , geo , zip | 検索方法の指定(いずれか1つ指定)
|
○ |
city | 文字列 | UTF-8でURLエンコードされた検索地名キーワード
|
○ (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つ指定)
|
|
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分前) |
指定できる日付は翌日から2週間後までです。過去の計画停電時間は取得できません
※2:year,mon,day を指定した場合は、days を指定する必要はありません
※3:days を指定した場合は、year,mon,day を指定する必要はありません
リクエストURLサンプル
・市町村名で検索- http://mukku.org/v2.00/?input=add&city=%e5%8e%9a%e6%9c%a8%e5%b8%82%e4%b8%8b%e8%8d%bb%e9%87%8e
- http://mukku.org/v2.00/?input=add&city=%e5%8e%9a%e6%9c%a8%e5%b8%82%e4%b8%8b%e8%8d%bb%e9%87%8e&gn=4
- http://mukku.org/v2.00/?input=add&city=%e5%8e%9a%e6%9c%a8%e5%b8%82%e4%b8%8b%e8%8d%bb%e9%87%8e&output=xml&count=3
- http://mukku.org/v2.00/?input=geo&lat=35.47673&lon=139.346093
- http://mukku.org/v2.00/?input=geo&lat=35.47673&lon=139.346093&gn=4
- http://mukku.org/v2.00/?input=geo&lat=35.47673&lon=139.346093&output=xml&count=3
- http://mukku.org/v2.00/?input=zip&zn=2430203
- http://mukku.org/v2.00/?input=zip&zn=2430203&gn=4
- http://mukku.org/v2.00/?input=zip&zn=2430203&output=xml&count=3
(本機能利用時はレスポンスデータ内の count の値が常に 0 になります)
- http://mukku.org/v2.00/?input=zip&zn=2430203&ad=on (翌日の計画停電時間を取得)
- http://mukku.org/v2.00/?input=zip&zn=2430203&ad=on&days=3 (3日後の計画停電時間を取得)
- http://mukku.org/v2.00/?input=zip&zn=2430203&ad=on&year=2011&mon=6&day=30 (2011年6月30日の計画停電時間を取得)
(本機能利用時はレスポンスデータ内の count の値が常に 1 になります。本APIを利用したアプリケーションの動作確認等にご利用下さい)
- http://mukku.org/v2.00/?input=zip&zn=2430203&test=on (停電10分前をシミュレート)
- http://mukku.org/v2.00/?input=zip&zn=2430203&test=on&rem=3600 (停電1時間前をシミュレート)
- http://mukku.org/v2.00/?input=zip&zn=2430203&test=on&rem=30 (停電30秒前をシミュレート)
- http://mukku.org/v2.00/TGL
- http://mukku.org/v2.00/TGL/?output=json
リクエスト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 |
※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お問い合わせフォーム