トップ > Weather Hacks > お天気Webサービス仕様
お天気Webサービス仕様 |
お天気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つがサポートされています。
|
|
(例)「明日の福岡県・久留米の天気」を取得する場合
下記URLにアクセスしてXMLデータを取得します。
基本URL + 久留米のID(113) + (明日なので)tomorrow |
レスポンスフィールド
取得したXMLデータは以下の定義に基づいて構成されています。
| タグ名 | 内容 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| location |
予報を発表した地域を定義
|
||||||||||||
| title | タイトル・見出し | ||||||||||||
| link | リクエストされたデータの地域に該当するlivedoor 天気情報のURL | ||||||||||||
| forecastday | 予報日(today,tomorrow,dayaftertomorrowの3種) | ||||||||||||
| day | 曜日 | ||||||||||||
| forecastdate | 予報日 | ||||||||||||
| publictime | 予報の発表日時 | ||||||||||||
| telop | 天気(晴れ、曇り、雨など) | ||||||||||||
| description | 天気概況文 | ||||||||||||
| image |
|
||||||||||||
| temperature |
max・・・最高気温 min・・・最低気温
|
||||||||||||
| pinpoint |
タグで以下を繰り返します。
|
||||||||||||
| copyright |
|
メニュー
お天気トラックバック(最新3件)
';
} else {
document.getElementById('source').value = '都道府県を選択して下さい。';
document.getElementById('js_sample').innerHTML = 'ここにお天気プラグイン本体が表示されます。';
}
}
