
お天気Webサービス(Livedoor Weather Web Service / LWWS)は、現在全国142カ所の今日・明日・あさっての天気予報・予想気温と都道府県の天気概況情報を提供しています。
リクエストパラメータ
XMLデータをリクエストする際のベースとなるURLは以下になります。
http://weather.livedoor.com/forecast/webservice/rest/v1
このURLに下の表のパラメータを加え、実際にリクエストします。
| パラメータ名 |
説明 |
| city |
地域別に定義されたID番号を表します。
リクエストする地域とidの対応は 全国の地点定義表(RSS) 内の 「1次細分区(cityタグ)」のidをご参照下さい。(例・佐賀県 伊万里=123) |
| day |
リクエストする予報日を指定します。現在は以下の3つがサポートされています。
| パラメータ値 |
内容 |
| today |
今日 |
| tomorrow |
明日 |
| dayaftertomorrow |
あさって |
|
(例)「明日の福岡県・久留米の天気」を取得する場合
下記URLにアクセスしてXMLデータを取得します。
基本URL + 久留米のID(113) + (明日なので)tomorrow
|
レスポンスフィールド
取得したXMLデータは以下の定義に基づいて構成されています。
| タグ名 |
内容 |
| location |
予報を発表した地域を定義
| タグ名 |
内容 |
| area |
地方名(例・九州地方) |
| pref |
都道府県名(例・福岡県) |
| city |
1次細分区名(例・八幡) |
|
| title |
タイトル・見出し |
| link |
リクエストされたデータの地域に該当するlivedoor 天気情報のURL |
| forecastday |
予報日(today,tomorrow,dayaftertomorrowの3種) |
| day |
曜日 |
| forecastdate |
予報日 |
| publictime |
予報の発表日時 |
| telop |
天気(晴れ、曇り、雨など) |
| description |
天気概況文 |
| image |
| タグ名 |
内容 |
| title |
天気(晴れ、曇り、雨など) |
| link |
リクエストされたデータの地域に該当するlivedoor 天気情報のURL |
| url |
天気アイコンのURL |
| width |
天気アイコンの幅 |
| height |
天気アイコンの高さ |
|
| temperature |
max・・・最高気温
min・・・最低気温
| タグ名 |
内容 |
| celsius |
摂氏 |
| fahrenheit |
華氏 |
|
| pinpoint |
タグで以下を繰り返します。
| タグ名 |
内容 |
| title |
市区町村名 |
| link |
対応するlivedoor 天気情報のURL |
| publictime |
ピンポイント天気予報の発表時間 |
|
| copyright |
| タグ名 |
内容 |
| title |
コピーライトの文言 |
| link |
livedoor 天気情報のURL |
| image |
livedoor 天気情報へのURL、アイコンなど |
| provider |
livedoor 天気情報で使用している気象データの配信元(繰り返しあり) |
|
・XMLデータサンプル