気象情報 - クジラ週間天気API *
本APIは気象庁から取得した天気情報を元にした週間天気の情報を、形式変換してJSON/XML形式として返すAPIです。日本各地22地点の週間予報を返します。
使い方(APIのエンドポイント) *
プログラミング言語から以下のURLを呼び出し各形式のデータを取得します。
https://api.aoikujira.com/tenki/week.php?fmt=(形式)&city=(都市ID)
例えば、以下のような形式で使うことができます。
上記、URLパラメータの「city=319」を「city=329」に変えると名古屋の天気を表示します。また、「city=東京」や「city=名古屋」のように指定して天気を表示することもできます。有効な都市は、こちらの22都市です。ID番号と都市名の両方に対応しています。ただし、都市名を指定する場合は、UTF-8で日本語をURLエンコードする必要があります。また、cityパラメータを省略するとすべての都市の天気を表示します。
パラメータの一覧 *
| パラメータ | 意味 |
| city=都市名 | 都市名または都市IDを指定。省略可能。 |
| fmt=形式 | xml/json/iniの形式を指定。省略するとxmlになる。 |
実行例を確認してみよう *
注意事項 *
当APIは気象庁のWebサイトで公開されている情報を整形して出力するだけです。もし、APIが正しく動かなくなった場合、こちらのページからお知らせください。なお、週間予報はこちらのページから取得したものです。
参考 *
以下、参考資料です。
対応都市一覧 *
以下の都市の天気予報を取得できます。
都市ID | 都市名 |
|---|---|
304 | 釧路 |
302 | 旭川 |
306 | 札幌 |
308 | 青森 |
309 | 秋田 |
312 | 仙台 |
323 | 新潟 |
325 | 金沢 |
319 | 東京 |
316 | 宇都宮 |
322 | 長野 |
329 | 名古屋 |
331 | 大阪 |
341 | 高松 |
337 | 松江 |
338 | 広島 |
344 | 高知 |
346 | 福岡 |
352 | 鹿児島 |
352 | 奄美 |
353 | 那覇 |
356 | 石垣 |
JSONフォーマットの場合 *
以下、釧路を取得した場合：
{
"mkdate": "2020\/08\/06 10:31:33",
"釧路": [
{
"date": "6日(木)",
"forecast": "曇り後雨",
"mintemp": "-",
"maxtemp": "26",
"pop": "-\/10\/60\/50"
},
{
"date": "7日(金)",
"forecast": "曇り一時雨",
"mintemp": "20",
"maxtemp": "23",
"pop": "10\/50\/20\/10"
},
{
"date": "8日(土)",
"forecast": "曇り",
"mintemp": "18",
"maxtemp": "23",
"pop": "40"
}
}
つまり、以下のようなフォーマットで情報が得られます。
{
"都市名": [
{ "date": "日付", "forecast": "天気予報", "pop": "降水確率", ... },
{ "date": "日付", "forecast": "天気予報", "pop": "降水確率", ... },
{ "date": "日付", "forecast": "天気予報", "pop": "降水確率", ... },
...
],
"都市名": [
{ "date": "日付", "forecast": "天気予報", "pop": "降水確率", ... },
...
},
...
得られる情報ですが、以下の通りです。
| "date" | 日付 |
| "forecast" | 天気予報 |
| "mintemp" | 最低気温 |
| "maxtemp" | 最高気温 |
| "pop" | 降水確率 |