これは何？ | 使用データ | システム概要 | データの更新について | APIのご利用について | ご利用事例 | お問い合わせ・不具合報告
リクエストパラメータ | リクエストURLサンプル | リクエストURL生成ツール | レスポンスフィールド | レスポンスXMLサンプル
前バージョンから移行する際の注意点 | 前バーション APIv1.00β , 最新バージョン APIv2.00
停電グループデータ最終更新日時：2011-04-07 21:30
停電時間帯データ最終更新日時：2024-09-13 00:03
このページの最終更新日時：2011-07-02 02:40
現在日時：2024-09-13 02:52
リクエストパラメータ | リクエストURLサンプル | リクエストURL生成ツール | レスポンスフィールド | レスポンスXMLサンプル
前バージョンから移行する際の注意点 | 前バーション APIv1.00β , 最新バージョン APIv2.00
停電グループデータ最終更新日時：2011-04-07 21:30
停電時間帯データ最終更新日時：2024-09-13 00:03このページの最終更新日時：2011-07-02 02:40
現在日時：2024-09-13 02:52
(2011/06/20) 2011年6月20日以降の計画停電に対応いたしました。
さらに、機能の追加と改善を行った計画停電情報API Ver2.00を公開いたしました。新規にAPIをご利用される方は Ver2.00 をご利用下さい。
最新情報 Twitter @hhlab_bot 
- () twitter read error!
現在の電力使用状況
節電.go.jp (政府の節電ポータルサイト) → http://setsuden.go.jp/
今日の停電時間帯(09月13日 00時03分 更新) 最新情報は東京電力HPをご確認下さい
- 今日はすべてのグループで計画停電は予定されていません。
グループ番号と停電時間帯の組み合わせだけをXMLで出力するAPI作りました → http://mukku.org/v1.01/TGL
これは何？
「地名キーワード」「緯度経度」「郵便番号」のいずれかをリクエストパラメータとして入力すると、
計画停電のグループ番号(1～5)とサブグループ記号(A-E)、今日の停電時間帯、停電時間帯までの残り時間などをXMLやRSSの形式で取得できます。
2011年3月16日より、試験運用中です。
更新情報などは「神奈川工科大学情報学部情報メディア学科 速水・服部研究室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
郵便番号から地名への変換には葵さんの「郵便番号API」を使用しています。
http://api.aoikujira.com/
サーバはロリポップレンタルサーバを利用しています。
http://lolipop.jp/
データの更新について
各グループ(1～5)と停電時間帯の組み合わせは毎日変わります。
このため、毎日午前0時～3時頃に、各グループと停電時間帯の組み合わせを手動で設定しています。
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.00β)から移行する際の注意点
APIバージョン v1.00β から v1.01 に移行するに当たって、一部、仕様の変更があります。
・リクエストパラメータ- サブグループ指定[sgn](オプション)を追加しました
- グループID指定[gid](オプション)を追加しました
- LastUpDate フィールドと LastUpDateEpoch フィールドを、それぞれ PowerCutTime フィールドと GroupData フィールドに細分化しました
- SubGroup フィールドと GroupID フィールドを追加しました
- グループ番号表記を25グループ化しました (ex. 「グループ1」→「グループ1-A」)
リクエストパラメータ
前バージョン(v1.00β)からの変更点を太字で表記しています。| パラメータ | 値 | 説明 | 必須 |
|---|---|---|---|
| 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を指定した場合は20で固定 |
リクエストURLサンプル
・市町村名で検索- http://mukku.org/v1.01/?input=add&city=%e5%8e%9a%e6%9c%a8%e5%b8%82%e4%b8%8b%e8%8d%bb%e9%87%8e
- http://mukku.org/v1.01/?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/v1.01/?input=add&city=%e5%8e%9a%e6%9c%a8%e5%b8%82%e4%b8%8b%e8%8d%bb%e9%87%8e&output=xml
- http://mukku.org/v1.01/?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/v1.01/?input=add&city=%e5%8e%9a%e6%9c%a8%e5%b8%82%e4%b8%8b%e8%8d%bb%e9%87%8e&output=rss
- http://mukku.org/v1.01/?input=add&city=%e5%8e%9a%e6%9c%a8%e5%b8%82%e4%b8%8b%e8%8d%bb%e9%87%8e&output=html
- http://mukku.org/v1.01/?input=geo&lat=35.47673&lon=139.346093
- http://mukku.org/v1.01/?input=geo&lat=35.47673&lon=139.346093&gn=4
- http://mukku.org/v1.01/?input=geo&lat=35.47673&lon=139.346093&output=xml
- http://mukku.org/v1.01/?input=geo&lat=35.47673&lon=139.346093&output=xml&count=3
- http://mukku.org/v1.01/?input=geo&lat=35.47673&lon=139.346093&output=rss
- http://mukku.org/v1.01/?input=geo&lat=35.47673&lon=139.346093&output=html
- http://mukku.org/v1.01/?input=zip&zn=2430203
- http://mukku.org/v1.01/?input=zip&zn=2430203&gn=4
- http://mukku.org/v1.01/?input=zip&zn=2430203&output=xml
- http://mukku.org/v1.01/?input=zip&zn=2430203&output=xml&count=3
- http://mukku.org/v1.01/?input=zip&zn=2430203&output=rss
- http://mukku.org/v1.01/?input=zip&zn=2430203&output=html
- http://mukku.org/v1.01/TGL
リクエストURL生成ツール
レスポンスフィールド
前バージョン(v1.00β)からの変更点を太字で表記しています。| フィールド | 値 | 説明 |
|---|---|---|
| SearchType | add , geo , zip | 検索方法 |
| City | 文字列 | 地区名(inputでaddを指定した場合) |
| Lat | 数値 | 緯度(inputでgeoを指定した場合) |
| Lon | 数値 | 経度(inputでgeoを指定した場合) |
| Zip | 数値 | 郵便番号(inputでzipを指定した場合) |
| Group | 数値 | グループ番号(グループ番号を指定した場合) |
| SubGroup | 文字列 | サブグループ記号(サブグループ記号を指定した場合) |
| GroupID | 数値 | グループID(グループIDを指定した場合) |
| Total | 数値 | 検索ヒット数 |
| Count | 数値 | 出力件数 |
| Status | 文字列 | ステータスフラグ(OKのみ) |
| (LastUpDate) PowerCutTime |
文字列 | グループごとの停電時間帯の最終更新日時(RFC2822フォーマット) |
| (LastUpDate) GroupData |
文字列 | 地名データの最終更新日時(RFC2822フォーマット) |
| (LastUpDateEpoch) PowerCutTime |
数値 | グループごとの停電時間帯の最終更新日時(エポック秒) |
| (LastUpDateEpoch) GroupData |
数値 | 地名データの最終更新日時(エポック秒) |
| SystemTime | 文字列 | リクエスト処理日時(RFC2822フォーマット) |
| SystemTimeEpoch | 数値 | リクエスト処理日時(エポック秒) |
| SystemVersion | 文字列 | システムバージョン |
| Info | 文字列 | 管理者からのお知らせ等 |
| Description | 文字列 | 注意事項等 |
| Copyright | 文字列 | 著作権情報 |
| Prefecture | 文字列 | 都道府県名 |
| CityName1 | 文字列 | 市区群名 |
| CityName2 | 文字列 | 大字名 |
| Group | 数値 | 停電地域グループ番号 |
| SubGroup | 文字列 | 停電地域サブグループ記号 |
| GroupID | 数値 | 停電地域グループID(API独自) グループ1-Aから5-Eまでを1から25の数字で表したもの |
| All | 文字列 | 停電時間帯の日本語表記 |
| Count | 数値 | 1日で停電する回数(0から2) |
| Start | 数値 | 停電開始時間(エポック秒)※1 |
| End | 数値 | 停電終了時間(エポック秒)※1 |
| StartRfc | 文字列 | 停電開始時間(RFC2822フォーマット)※2 |
| EndRfc | 文字列 | 停電終了時間(RFC2822フォーマット)※2 |
| StartRemaining | 数値 | 停電開始までの残り時間(秒数)※3 |
| EndRemaining | 数値 | 停電終了までの残り時間(秒数)※3 |
※2：停電が1日に2回ある場合は半角セミコロン(;)区切りで2つの時間が並びます
※3：すでに過ぎた場合は経過時間になります(マイナス-がつきます)
レスポンスXMLサンプル
http://mukku.org/v1.01/?input=add&city=%e5%8e%9a%e6%9c%a8%e5%b8%82%e4%b8%8b%e8%8d%bb%e9%87%8eレスポンスRSSサンプル
http://mukku.org/v1.01/?input=add&city=%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お問い合わせフォーム
