気象庁の天気予報や警報を業務システムに取り込みたいとき、まず知っておくべきなのは、気象庁が「Web API」として文書化した窓口を用意していないことです。実際に使われているのは、気象庁ホームページが画面表示に読み込んでいる天気予報のJSONと、フォーマット仕様が公開されている防災情報XMLの2つです。この記事では、エリアコードの調べ方、JSONの構造、curlとPythonでの取得コード、防災情報XMLのAtomフィードを巡回する実装、そして利用規約と気象業務法の制約までを、気象庁の公開ページと実データの確認に沿って手順で説明します。
まとめ:気象庁に公式Web APIは無く、予報JSONと防災情報XMLの2経路で取る
手早く今日・明日の天気や降水確率を表示したいなら、https://www.jma.go.jp/bosai/forecast/data/forecast/{府県予報区コード}.json を取得します。認証もキーも要りません。ただし画面表示用のデータなので、項目名やURLが予告なく変わる前提で作ります。
警報・注意報や地震情報を業務の判断に使うなら、防災情報XMLのPULL型フィードを巡回します。こちらはフォーマット仕様が公開されており、ユーザー登録も不要です。1日10GBを超えるアクセスはIPアドレスごと遮断されるため、条件付きGETと既読管理を最初から組み込みます。
どちらも配信の停止や遅延があり得るとされています。数分の遅れが損失や安全に直結する用途では、気象業務支援センターや民間の気象会社からの配信を検討してください。
気象庁APIの実態:公開されている予報JSONと防災情報XMLの違いと選び方
「気象庁 API」で検索して見つかる情報は、出どころの違う2種類のデータが混ざっています。性格を取り違えると、運用に入ってから止まります。
bosaiの予報JSONは気象庁サイトの表示用データで仕様の保証が無い点
www.jma.go.jp/bosai/ 配下のJSONは、気象庁ホームページの天気予報やアメダスの画面が裏で読み込んでいるデータです。項目の定義書やバージョン管理は公開されていません。気象庁ホームページの利用規約には、内容やURLは予告なく変更・削除される場合があると書かれています。
つまり、取得はできても、仕様が変わったときに知らせてもらえる約束はありません。社内のダッシュボードや参考表示に使うのは問題ありませんが、項目が欠けたら取得処理を止めて通知する作りにしておきます。
防災情報XMLはフォーマット仕様が公開された公式の配信形式である点
防災情報XMLは、警報・注意報、天気予報、地震・津波、火山などの情報を共通の形式で配信するための形式です。気象庁防災情報XMLフォーマットのページで、仕様書、技術資料、運用指針が公開されています。取得できる電文の種類は公開電文の一覧(PDF)で確かめられます。
業務の判断材料にするなら、こちらが本筋です。電文ごとに発表時刻、発表官署、情報の種別(発表・訂正・取消など)が決まった場所に入っているため、取り込み処理を仕様書に沿って書けます。
アメダスCSVや2週間気温予報CSVなど開発者ポータルで取れる残りのデータ
気象庁の気象データ高度利用ポータルサイトには、防災情報XMLのほかに、アメダスの最新観測値と過去データのCSV、2週間気温予報と1か月予報の気温のCSV、数値予報(GPV)のサンプルデータが並んでいます。
| データ | 形式 | 仕様の公開 | 向いている用途 |
|---|---|---|---|
| 天気予報・概況(bosai) | JSON | なし | 画面表示、社内の参考情報 |
| 警報・注意報・地震など | 防災情報XML | あり | 通知、業務判断のトリガー |
| アメダスの過去データ | CSV | ポータルに説明あり | 需要予測の学習データ |
| 2週間気温予報 | CSV | ポータルに説明あり | 仕入・人員の計画 |
需要予測のように過去と未来の気温をそろえて使う用途では、JSONよりCSVのほうが期間をまとめて取れるため扱いやすくなります。
天気予報JSONを試す:エリアコードの調べ方とcurl・Pythonでの取得
ここからは、東京都の予報を例にJSONを取得します。どの地域の予報を取るかは、府県予報区のコードで指定します。
area.jsonで市町村から府県予報区までエリアコードを引く手順
地域コードの一覧は area.json にまとまっています。2026年11月21日時点では、centers(地方予報区)、offices(府県予報区)、class10s(一次細分区域)、class15s、class20s(市町村等)の5つのキーがあり、各要素が parent と children で親子をたどれるようになっています。
# 府県予報区(offices)から「東京都」のコードを探す
curl -s https://www.jma.go.jp/bosai/common/const/area.json \
| jq -r '.offices | to_entries[] | select(.value.name == "東京都") | .key'
# 出力: 130000
# 東京都の天気予報と天気概況を取得する
curl -s https://www.jma.go.jp/bosai/forecast/data/forecast/130000.json | jq '.[0].reportDatetime'
curl -s https://www.jma.go.jp/bosai/forecast/data/overview_forecast/130000.json | jq -r '.text'
予報のURLに入れるのは offices のコード(東京都なら130000)です。市町村から引きたい場合は、class20s の parent を上にたどって府県予報区のコードまで戻します。
forecast JSONの構造:3日予報と週間予報の2ブロックとtimeSeries
forecastのJSONは2要素の配列です。1つ目が今日から明後日までの短期予報、2つ目が週間予報で、どちらも publishingOffice(発表官署)、reportDatetime(発表時刻)、timeSeries を持ちます。
| 位置 | 時刻の刻み | エリアの単位 | 主な項目 |
|---|---|---|---|
| [0].timeSeries[0] | 日ごと(3日分) | 一次細分区域(東京地方など) | 天気・天気コード・風・波 |
| [0].timeSeries[1] | 6時間ごと | 一次細分区域 | pops(降水確率) |
| [0].timeSeries[2] | 朝・日中 | 観測地点(東京など) | temps(気温) |
| [1].timeSeries[0] | 日ごと(7日分) | 一次細分区域 | 天気コード・降水確率・信頼度 |
| [1].timeSeries[1] | 日ごと(7日分) | 観測地点 | tempsMin、tempsMax と上限・下限 |
表は2026年11月21日に東京都(130000)のデータを取得して確かめた構造です。3日予報の日ごとの項目は weathers、weatherCodes、winds、waves の順で、週間予報の一次細分区域の項目は weatherCodes、pops、reliabilities の順です。値は timeDefines の時刻と同じ並び順の配列で入っているため、添字で対応させて読みます。降水確率の先頭が過ぎた時間帯の分だけ欠けることがあるので、配列の長さを決め打ちしないでください。
Python標準ライブラリで東京地方の天気と降水確率を取り出すコード
次のコードは、外部ライブラリなしで東京地方の天気と降水確率を表示します。2026年11月21日時点の応答ヘッダーには ETag、Last-Modified、Cache-Control: max-age=60 が付いており、If-None-Match を付けて送ると変更が無いときは304が返ります。これを使い、前回から変わっていなければ本文を取り直しません。
import json
import urllib.error
import urllib.request
URL = "https://www.jma.go.jp/bosai/forecast/data/forecast/130000.json"
HEADERS = {"User-Agent": "example-weather-client/1.0 (contact: [email protected])"}
def fetch_forecast(etag=None):
"""変更が無ければ (None, etag) を返す。"""
headers = dict(HEADERS)
if etag:
headers["If-None-Match"] = etag
req = urllib.request.Request(URL, headers=headers)
try:
with urllib.request.urlopen(req, timeout=10) as res:
return json.load(res), res.headers.get("ETag")
except urllib.error.HTTPError as e:
if e.code == 304:
return None, etag
raise
data, etag = fetch_forecast()
short = data[0]
print("発表:", short["publishingOffice"], short["reportDatetime"])
weather = short["timeSeries"][0]
for area in weather["areas"]:
if area["area"]["name"] == "東京地方":
for t, w in zip(weather["timeDefines"], area["weathers"]):
print(t[:10], w)
pops = short["timeSeries"][1]
for area in pops["areas"]:
if area["area"]["name"] == "東京地方":
for t, p in zip(pops["timeDefines"], area["pops"]):
print(t, f"降水確率 {p}%")
User-Agentには、自社のシステム名と連絡先を入れておくのが無難です。取得の間隔は、予報が更新される発表時刻(主に5時・11時・17時)に合わせれば足ります。1分ごとに取り直しても内容は変わりません。
防災情報XMLを受け取る:PULL型Atomフィードの巡回と電文の解析
警報や地震の情報を拾うには、Atomフィードで新着電文のURLを知り、電文本体を取りに行く2段の処理を書きます。
高頻度フィードと長期フィード計8本の更新間隔と運用時の使い分け
PULL型の提供ページによると、フィードは「定時」「随時」「地震火山」「その他」の4分類で、それぞれに高頻度と長期の2種類があります。URLはいずれも https://www.data.jma.go.jp/developer/xml/feed/ の下です。
| 種類 | 更新 | 掲載範囲 | ファイル名の末尾 |
|---|---|---|---|
| 高頻度 | 毎分 | 直近少なくとも10分の入電 | .xml |
| 長期 | 毎時 | 数日間の全入電 | _l.xml |
高頻度のファイル名は regular.xml、extra.xml、eqvol.xml、other.xml です。長期のファイル名は regular_l.xml、extra_l.xml、eqvol_l.xml、other_l.xml です。警報・注意報は「随時」のextra.xml、地震と火山はeqvol.xmlに載ります。常時動かす取り込み処理は高頻度フィードを1分間隔で読み、停止から復旧したときだけ長期フィードで取りこぼしを埋める、という分担が扱いやすい形です。長期フィードは2026年11月21日の取得時点で4MBを超えており、毎分読む対象には向きません。
If-Modified-Sinceと既読管理で1日10GBの遮断ラインを避ける実装
PULL型のページには、1日に10GB以上のダウンロードを伴うアクセスがあるとアクセス元のIPアドレスを遮断し、遮断後は取得済みファイルを再取得しないよう改修を求める、と書かれています。フィードは条件付きGETで、電文は既読のURLを記録して、二重に取りに行かない作りにします。
import time
import urllib.error
import urllib.request
import xml.etree.ElementTree as ET
FEED = "https://www.data.jma.go.jp/developer/xml/feed/extra.xml"
ATOM = {"a": "http://www.w3.org/2005/Atom"}
HEADERS = {"User-Agent": "example-weather-client/1.0 (contact: [email protected])"}
seen = set() # 本番ではDBやRedisに保存して再起動後も引き継ぐ
last_modified = None
def get(url, extra=None):
req = urllib.request.Request(url, headers={**HEADERS, **(extra or {})})
with urllib.request.urlopen(req, timeout=10) as res:
return res.read(), res.headers.get("Last-Modified")
while True:
try:
extra = {"If-Modified-Since": last_modified} if last_modified else None
body, last_modified = get(FEED, extra)
for entry in ET.fromstring(body).findall("a:entry", ATOM):
title = entry.findtext("a:title", namespaces=ATOM)
url = entry.find("a:link", ATOM).get("href")
if url in seen or not title.startswith("気象警報・注意報"):
continue
seen.add(url)
xml_body, _ = get(url)
handle_warning(xml_body) # 次のh3で中身を読む
except urllib.error.HTTPError as e:
if e.code != 304: # 304は更新なし
print("取得エラー", e.code)
time.sleep(60)
2026年11月21日の確認では、extra.xml にも Last-Modified が付き、If-Modified-Since を送ると304が返りました。304のときはフィード本文の転送が発生しないため、1分間隔で回しても転送量はほとんど増えません。複数のサーバーで同じ処理を動かす構成にすると転送量が台数分に増えるので、取得役は1台に絞り、社内へは自前のキューで配ります。
警報・注意報のXML電文から対象地域と種別を読み出すときの注意点
電文はルートの Report の下に、Control(配信の管理情報)、Head(見出し)、Body(内容)の3部で構成されます。名前空間がそれぞれ違うので、まとめて辞書に定義しておきます。
NS = {
"jmx": "http://xml.kishou.go.jp/jmaxml1/",
"ib": "http://xml.kishou.go.jp/jmaxml1/informationBasis1/",
"body": "http://xml.kishou.go.jp/jmaxml1/body/meteorology1/",
}
def handle_warning(xml_body):
root = ET.fromstring(xml_body)
if root.findtext("jmx:Control/jmx:Status", namespaces=NS) != "通常":
return # 訓練・試験の電文は業務に流さない
print(root.findtext("ib:Head/ib:Title", namespaces=NS),
root.findtext("ib:Head/ib:ReportDateTime", namespaces=NS),
root.findtext("ib:Head/ib:InfoType", namespaces=NS))
path = "body:Body/body:Warning[@type='気象警報・注意報(市町村等)']/body:Item"
for item in root.findall(path, NS):
city = item.findtext("body:Area/body:Name", namespaces=NS)
code = item.findtext("body:Area/body:Code", namespaces=NS)
for kind in item.findall("body:Kind", NS):
print(city, code, kind.findtext("body:Name", namespaces=NS),
kind.findtext("body:Status", namespaces=NS))
業務で見落としやすい点は次の2つです。1つは Control/Status で、「通常」以外に訓練や試験の電文が流れるため、ここで弾かないと訓練の警報で現場に通知が飛びます。もう1つは Kind/Status で、値は「発表」「継続」「解除」などです。「継続」のたびに通知すると同じ警報が何度も届くので、前回の状態と比べて変わったときだけ知らせます。2026年11月21日の愛媛県の電文では、Body に府県予報区・一次細分区域・市町村等をまとめた地域・市町村等の4段の Warning が入っていました。拠点の住所から市町村コードを決め、そのコードで絞り込むのが確実です。
気象庁の気象データを業務システムで使うときの利用規約と法令の制約
技術的に取れることと、業務で使ってよいことは別に確認します。社外向けのサービスに載せる場合は特に、次の2点を先に押さえます。
公共データ利用規約第1.0版に沿った出典表記とデータ加工時の書き方
気象庁ホームページの利用規約では、権利表記のないコンテンツは「公共データ利用規約(第1.0版)」に準拠した条件で利用できます。商用のシステムに組み込むこともできますが、出典の記載が条件です。
記載例は「出典:気象庁ホームページ」と当該ページのURLです。予報の文言を要約したり、降水確率をグラフにしたりと加工した場合は、出典とは別に「気象庁の○○をもとに△△株式会社作成」のように、加工者が作ったと分かる形で書きます。国や気象庁が作ったように見える見せ方は禁止されています。画面のフッターなど、常に見える場所に出典を置く設計にしておくと漏れません。
気象業務法17条の予報業務許可と23条の警報の制限に当たる使い方
同じ規約には、気象業務法第17条第1項(予報業務の許可)と第23条(警報の制限)による利用制約があり得ると書かれています。気象庁の予報や警報をそのまま表示・転送する範囲を超えて、自社で独自に予報を作って他者に提供する場合は、予報業務の許可が要るかを確認してください。気象庁以外の者が警報を出すことも制限されています。
実装で気をつけるのは表示の言葉です。自社の機械学習モデルで出した降水の見込みを「警報」「予報」と名付けて取引先に配ると、この論点に触れます。社内の判断用に留めるか、表示名を「社内アラート」などに分けるかを、要件定義の段階で決めておきます。
気象データ連携の自社構築と配信事業者の利用を選ぶための判断基準
気象庁のデータは無料で取れますが、使ってよい場面と使うべきでない場面ははっきり分かれます。
JSONやPULL型で足りる用途と、配信遅延が許されない用途の境界
社内ポータルの天気表示、翌日の配送計画や工事予定の参考、警報が出たら担当者にチャットで知らせる程度の用途なら、bosaiのJSONとPULL型のフィードで足ります。数分の遅れや一時的な停止があっても、人が気付いて補える業務です。
反対に、緊急地震速報を受けて設備を止める、津波の情報で避難の指示を出すといった、秒単位の遅れが安全に響く用途には使いません。気象庁自身が、迅速かつ確実な配信が必要な場合は気象業務支援センターや予報業務許可事業者に問い合わせるよう案内しています。この境界は迷わず配信事業者側に倒すべきです。
気象データを需要予測や現場アラートに組み込むときの設計と外注判断
気象データの使い道として多いのは、販売や電力の需要予測と、拠点ごとの警報アラートです。たとえば電力需給管理システムでは、気温の予測が需要想定の入力になります。こうした仕組みでは、取得処理そのものより、拠点と地域コードの対応表、取得失敗の検知、過去データの保存先の設計に工数がかかります。
定期実行の部分は、クラウドのスケジューラーに任せると運用の負担を減らせます。AWSならEventBridge Schedulerのcron式と上限を前提に、1分間隔で巡回する構成が可能です。既存の基幹システムや販売管理と気象データをつなぐ連携の設計まで含めて任せたい場合は、一創のAPI開発・システム連携で、取得元の選定から監視の設計までご相談いただけます。
気象庁APIの使い方と利用規約・データ取得についてよくある質問
気象庁のデータを取得するときによく出る疑問に、公開ページの記載をもとに答えます。
気象庁APIを使うのにAPIキーや登録は必要ですか?
必要ありません。bosaiの天気予報JSONは誰でもURLを指定して取得でき、防災情報XMLのPULL型フィードもユーザー登録は不要と明記されています。その代わり、1日10GB以上のダウンロードを伴うアクセスはIPアドレスごと遮断されるとされています。キーで利用者を識別しない仕組みなので、User-Agentに自社のシステム名を入れ、取得済みのデータを取り直さない作りにしてください。
気象庁の天気予報JSONは商用利用できますか?
気象庁ホームページのコンテンツは、権利表記がなければ公共データ利用規約(第1.0版)に準拠した条件で利用でき、商用の利用も対象です。条件は出典の記載で、加工したときは加工者が作成したと分かる表記が要ります。ただし、データをもとに独自の予報を作って他者に提供する場合は、気象業務法の予報業務許可に当たるかを別に確認してください。
気象庁のエリアコードや地域コードはどこで確認できますか?
天気予報JSONで使うコードは https://www.jma.go.jp/bosai/common/const/area.json で確認できます。府県予報区は offices、市町村等は class20s に入っており、parent は上位の区域をたどるための項目です。防災情報XMLの警報電文では、Area/Code に市町村等のコードが入るので、拠点の所在地のコードをあらかじめ控えておきます。
アメダスの観測データもAPIで取得できますか?
取得できます。最新の観測値と過去データは、気象データ高度利用ポータルサイトからCSVで提供されています。気象庁ホームページのアメダス画面が読み込むJSONもあり、latest_time.txt で最新の観測時刻を確かめてから地図用のJSONを取る形です。後者は天気予報JSONと同じく画面表示用のため、仕様変更に備えた監視を入れてください。
気象庁のデータ取得が急に失敗するようになったときは何を確認しますか?
まず、接続そのものが拒否されていないかを見ます。アクセス量が1日10GBを超えてIPアドレスが遮断された場合は、取得済みファイルを取り直さない改修が求められます。接続できるのにJSONの読み込みで失敗するなら、項目名やURLの変更を疑ってください。サーバーのメンテナンスで配信が止まることもあるため、気象庁ホームページの画面が表示できるかもあわせて確かめます。
関連記事
- API連携とは?仕組み・データ連携との違い・導入判断までわかりやすく解説:外部データを業務システムにつなぐ考え方の全体像
- API連携ツールの選び方|iPaaS・データ連携基盤・受託開発の使い分けを解説:気象データ連携を作るときの手段の比較
- API開発とは?自社APIを公開する目的・進め方・費用と外注判断をわかりやすく解説:取り込んだデータを社内向けAPIとして配るとき
- 電力需給管理システムとは?同時同量・インバランス回避を回す機能と開発判断:気象データを需要想定に使う業務の例
- EventBridge SchedulerのAPI|cron式・手動実行・上限と料金の実装ガイド:フィード巡回の定期実行を組むとき