忍者ブログ

2018
05
21

[PR]

×

[PR]上記の広告は3ヶ月以上新規記事投稿のないブログに表示されています。新しい記事を書く事で広告が消えます。

2018/05/21 (Mon.)

2011
04
27

電力使用状況API


前回の「東京電力管内の電力の需給状況」の記事では、「東京電力需給状況」のページを紹介しました。

今回は、「東京電力需給状況」のデータ元である「電力使用状況API」について説明しましょう。

「電力使用状況API」は、“東日本大震災に対し、自分たちの開発スキルを役立てたい”との「Hack for Japan」の趣旨に賛同して、Yahoo!デベロッパーネットワークで一般に公開されている API です。アプリケーションID さえ取得すれば、これを用いて、誰でも利用できるウェッブサービスです。

「電力使用状況API」からの出力は、XML、PHPserializ、JSON の3種類が用意されています。

リクエストURL

基本部分は、次のとおり。

http://setsuden.yahooapis.jp/v1/Setsuden/latestPowerUsage

これにパラメータを加えて、リクエストURL を作成します。

必須なのは、"appid"。したがって、最短のリクエストURL は次のようになります。

http://setsuden.yahooapis.jp/v1/Setsuden/latestPowerUsage
?appid=<あなたのアプリケーションID>

これで、最新の電力使用量と電力供給量がXML形式で取得できます。

JSON でデータを取得したい場合には、outputパラメータ、JSONP を利用したい場合には、さらに callback パラメータでコールバック関数を指定します。

http://setsuden.yahooapis.jp/v1/Setsuden/latestPowerUsage?
appid=<あなたのアプリケーションID>
&output=json&callback=callbak

過去の電力使用量と電力供給量を取得したい場合には、datetime パラメータで"yyyymmddhh"形式日時を付け加えます。

http://setsuden.yahooapis.jp/v1/Setsuden/latestPowerUsage?
appid=<あなたのアプリケーションID>
&output=json&callback=callbak
&datetime=2011042519

レスポンス

リクエストを送るとXML形式では、次のようなデータが返ってきます。

<ElectricPowerUsage
 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xmlns="urn:yahoo:jp:setsuden:latestPowerUsage"
 xsi:schemaLocation=
     "yahoo:jp:setsuden:latestPowerUsage
      http://setsuden.yahooapis.jp/v1/Setsuden/latestPowerUsage.xsd"
>
  <Area>tokyo</Area>
  <Usage unit="kW">34100000</Usage>
  <Capacity unit="kW">38500000</Capacity>
  <Date>2011-02-13</Date>
  <Hour>15</Hour>
</ElectricPowerUsage>

非常にシンプルな構造です。

JSON形式では、次のようになります。

{"ElectricPowerUsage":
  {"Area"    :"tokyo",
   "Usage"   :{"@unit":"kW","$":32910000},
   "Capacity":{"@unit":"kW","$":40000000},
   "Date":"2011-04-27",
   "Hour":19
  }
}

次回は、jQuery を用いて、「電力使用状況API」からデータを取得しましょう。

PR

2011/04/27 (Wed.) Trackback(0) Comment(0) Yahoo! Web Services

Comments

名前
メールアドレス
URL
コメント
PASS  Vodafone絵文字 i-mode絵文字 Ezweb絵文字

Trackback

Trackback for this entry:

Links

ご注意

当サイトのスクリプトは、ブラウザが FireFox 3.0 であることを前提に作成されています。IE などでは正常に動作しないものがあります。

カテゴリー

ブログ内検索

最新記事

カレンダー

04 2018/05 06
S M T W T F S
1 2 3 4 5
6 7 8 9 10 11 12
13 14 15 16 17 18 19
20 21 22 23 24 25 26
27 28 29 30 31

アーカイブ

RSS

最新CM

[04/15 jTemplate]
[05/22 寝太郎]

プロフィール

HN:
寝太郎
性別:
非公開

バーコード

P R

アクセス解析

リンク

NSM

コガネモチ

フリーエリア