hisasan/jmatenki

Get the weather forecast from the Japan Meteorological Agency website.

jmatenki

気象庁サイト(http://www.jma.go.jp/)から天気予報の情報を取得してオブジェクト形式で返します。

使用方法

下記のような感じでgetWeather()関数に、都道府県名とエリア（北部、南部など）を指定して呼び出します。

const jmatenki = require('jmatenki');

async function main() {
    const tenki = jmatenki();
    const forecast = await tenki.getWeather('奈良県', '北部');
    console.dir(forecast, {depth:null});
}

main();

getWeather()関数の返値で、下記のようなオブジェクト形式の天気予報が取得できます。

{
  prefecture: '奈良県',
  area: '北部',
  daily: [
    {
      forecast: '西の風　後　東の風　晴れ',
      rain: [ { time: '12-24', percent: '0%' } ],
      temp: { max: '11度' }
    },
    {
      forecast: '東の風　後　北の風　くもり　夕方　から　晴れ',
      rain: [ { time: '00-24', percent: '0%' } ],
      temp: { min: '1度', max: '12度' }
    },
    {
      forecast: '北の風　後　北西の風　晴れ'
    }
  ],
  caption: '19日11時奈良地方気象台発表の天気予報(今日19日から明後日21日まで)',
  overview: [
    '天気概況',
    '令和０２年２月１９日１０時３４分　奈良地方気象台発表',
    '　奈良県は、高気圧に覆われておおむね晴れています。',
    '　１９日の奈良県は、高気圧に覆われて晴れるでしょう。',
    '　２０日の奈良県は、気圧の谷の影響で昼過ぎまで曇りますが、夕方からは高気圧に覆われて晴れる見込みです。'
  ]
}

プロパティ	説明
prefecture	都道府県
area	エリア
daily	1日ごとの天気予報がセットされた配列です。先頭の要素から、今日、明日、明後日となります。明後日のデータが何もないときは今日、明日の2つの要素となります。
forecast	予報
rain	time, percentプロパティを持つ降水確率オブジェクトの配列です。最大で0時～6時、6時～12時、12時～18時、18時～24時の4つが取得できますが、同じ%の時間帯はひとまとめにされます。気象庁サイトの都合上、過去の時間帯や明後日の降水確率は取得できないようです。
temp	最低気温と最高気温です。気象庁サイトの都合上、朝を過ぎると当日の最低気温、また明後日の気温は取得できないようです。
caption	発表日時場所
overview	天気概況を配列に格納します。サイトの改行で要素分割し空行は削除しています。

注意事項

勝手にサイトをスクレイピングしているので、HTMLのレイアウトが変更になった場合は正常に動作しなくなると思われます。