2017-01-29

Slack のボットで今日の天気を通知する - JSON 確認編

OpenWeatherMap のサービスを使って、天気情報を取得できるようになりました.
今回は取得した JSON の内容を確認し、必要な情報が使えるようにしたいと思います. 雨と雪の情報もほしかったので、札幌市の天気を取得しました.

作業環境

Node.js 6.9.1 LTS

現在の天気情報 JSON

{ coord: { lon: 141.35, lat: 43.06 },
  weather:
   [ { id: 501,
       main: 'Rain',
       description: 'moderate rain',
       icon: '10d' } ],
  base: 'stations',
  main:
   { temp: 4.01,
     pressure: 994.64,
     humidity: 97,
     temp_min: 4.01,
     temp_max: 4.01,
     sea_level: 1008.09,
     grnd_level: 994.64 },
  wind: { speed: 9.56, deg: 194.002 },
  rain: { 3h: 4.905 },
  clouds: { all: 88 },
  dt: 1485498017,
  sys:
   { message: 0.0083,
     country: 'JP',
     sunrise: 1485467687,
     sunset: 1485502824 },
  id: 2128295,
  name: 'Sapporo-shi',
  cod: 200 }

ノード	参考値	概要
`coord`	`{ lon: 141.35, lat: 43.06 }`	都市の緯度経度
`weather.id`	`501`	天気状態の ID*
`weather.main`	`Rain`	天気状態のグループ名*
`weather.description`	`moderate rain`	天気状態*
`weather.icon`	`10d`	天気アイコン ID*
`main.temp`	`4.01`	気温
`main.pressure`	`994.64`	気圧、単位は hPa
`main.humidity`	`97`	湿度、単位は %
`main.temp_min`	`4.01`	現時点での最低気温
`main.temp_max`	`4.01`	現時点での最高気温
`main.sea_level`	`1008.09`	海上の気圧、単位は hPa
`main.grnd_level`	`994.64`	地上の気圧、単位は hPa
`wind.speed`	`9.56`	風速、単位はメートル/秒
`wind.deg`	`194.002`	風向、北 0 の時計回り
`clouds`	`{ all: 88 }`	曇り度合、単位は %
`rain.3h`	`4.905`	過去3時間の降雨量
`snow.3h`		過去3時間の降雪量
`dt`	`1485498017`	データ計算時間、Unix,UTC
`sys.country`	`JP`	国コード
`sys.sunrise`	`1485467687`	日の出時間、Unix,UTC
`sys.sunset`	`1485502824`	日の入り時間、Unix,UTC
`id`	`2128295`	都市 ID
`name`	`Sapporo-shi`	都市名

Weather condition codes に対応表がある
※ API ドキュメントに Internal parameter とあるものは除く

3時間ごと 5日間の天気予報 JSON

{ city:
   { id: 2128295,
     name: 'Sapporo-shi',
     coord: { lon: 141.346939, lat: 43.064171 },
     country: 'JP',
     population: 0,
     sys: { population: 0 } },
  cod: '200',
  message: 0.1264,
  cnt: 38,
  list:
   [ { dt: 1485507600,
       main:
        { temp: 0.15,
          temp_min: 0.15,
          temp_max: 0.15,
          pressure: 1000.35,
          sea_level: 1013.94,
          grnd_level: 1000.35,
          humidity: 91,
          temp_kf: 0 },
       weather:
        [ { id: 500,
            main: 'Rain',
            description: 'light rain',
            icon: '10n' } ],
       clouds: { all: 56 },
       rain: { 3h: 0.2975},
       snow: { 3h: 0.1575},
       wind: { speed: 8.3, deg: 258.503 },
       sys: { pod: 'n' },
       dt_txt: '2017-01-27 09:00:00' },
     { ... (3時間ごとの繰り返し) }
   ]
}

ノード	参考値	概要
`city.id`	`2128295`	都市 ID
`city.name`	`Sapporo-shi`	都市名
`city.coord`	`{ lon: 141.346939, lat: 43.064171 }`	都市の緯度経度
`city.country`	`JP`	国コード
`cnt`	`38`	レコード件数
`list.dt`	`1485507600`	データ計算時間、Unix,UTC
`list.main.temp`	`0.15`	気温
`list.main.temp_min`	`0.15`	計算時の最低気温
`list.main.temp_max`	`0.15`	計算時の最高気温
`list.main.pressure`	`1000.35`	気圧、単位は hPa
`list.main.sea_level`	`1013.94`	海上の気圧、単位は hPa
`list.main.grnd_level`	`1000.35`	地上の気圧、単位は hPa
`list.main.humidity`	`91`	湿度、単位は %
`list.weather.id`	`500`	天気状態の ID*
`list.weather.main`	`Rain`	天気状態のグループ名*
`list.weather.description`	`light rain`	天気状態*
`list.weather.icon`	`10n`	天気アイコン ID*
`list.clouds.all`	`56`	曇り度合、単位は %
`list.wind.speed`	`8.3`	風速、単位はメートル/秒
`list.wind.deg`	`258.503`	風向、北 0 の時計回り
`list.rain.3h`	`0.2975`	過去3時間の降雨量
`list.snow.3h`	`0.1575`	過去3時間の降雪量
`list.dt_txt`	`2017-01-27 09:00:00`	データ計算時間、UTC

Weather condition codes に対応表がある
※ API ドキュメントに Internal parameter とあるものは除く

データの利用について検討

現在の天気と予報では JSON のパラメータ名が異なるものの、おおよそで同じような内容になっています.

天気を表す部分では weather.main が中心で、グループ名(main) もしくは天気状態(description) やアイコンを使って天気を表す感じでしょうか.
アイコンは http://openweathermap.org/img/w/10d.png の最後の部分 10d に JSON で取得した値を入れることで取得できます. 昼夜で 10d、10n のようにアイコンが変わるようです.

気温などは main に入っています. ここは単位を付けるだけで簡単に使えそうです. temp_min と temp_max は大きい都市で気温差が出るようなケースに値が変わるようです.

風、特に風向きについては北を 0° として表現するようです. 現在の天気の JSON では wind: { speed: 9.56, deg: 194.002 } となっていたので、南南西の風 9.5 メートル/秒ですね.

降雨量と降雪量は rain.3h と snow.3h に過去3時間のデータが入ります. 降っていない場合は JSON にパラメータがないか、3h のパラメータがない状態となります. プログラム言語によって工夫が必要かもしれません. API ドキュメントには単位が乗ってませんでしたがミリメートルと思われます. 雨と雪の両方のデータが入っているケースがあり、その場合はどんな状況なのか、ちょっと気になります.

現在の天気のデータ計算時間は dt に入っており、Unix,UTC となっているのですが、Unix 秒です. dt や sunrise、sunset を扱う場合は、プログラム言語の処理系に合わせての対応が必要です.