---
title: "気象庁APIの使い方：天気予報JSONと防災情報XMLの取得手順・利用規約・実装例"
url: "https://www.issoh.co.jp/tech/details/20071/"
published: 2026-11-22
updated: 2026-11-22
categories: ["開発"]
publisher: "株式会社一創"
---

# 気象庁APIの使い方：天気予報JSONと防災情報XMLの取得手順・利用規約・実装例

気象庁の天気予報や警報を業務システムに取り込みたいとき、まず知っておくべきなのは、気象庁が「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は、気象庁ホームページの天気予報やアメダスの画面が裏で読み込んでいるデータです。項目の定義書やバージョン管理は公開されていません。[気象庁ホームページの利用規約](https://www.jma.go.jp/jma/kishou/info/coment.html)には、内容やURLは予告なく変更・削除される場合があると書かれています。

つまり、取得はできても、仕様が変わったときに知らせてもらえる約束はありません。社内のダッシュボードや参考表示に使うのは問題ありませんが、項目が欠けたら取得処理を止めて通知する作りにしておきます。

### 防災情報XMLはフォーマット仕様が公開された公式の配信形式である点

防災情報XMLは、警報・注意報、天気予報、地震・津波、火山などの情報を共通の形式で配信するための形式です。[気象庁防災情報XMLフォーマットのページ](https://xml.kishou.go.jp/)で、仕様書、技術資料、運用指針が公開されています。取得できる電文の種類は[公開電文の一覧（PDF）](https://xml.kishou.go.jp/xmllist.pdf)で確かめられます。

業務の判断材料にするなら、こちらが本筋です。電文ごとに発表時刻、発表官署、情報の種別（発表・訂正・取消など）が決まった場所に入っているため、取り込み処理を仕様書に沿って書けます。

### アメダスCSVや2週間気温予報CSVなど開発者ポータルで取れる残りのデータ

気象庁の[気象データ高度利用ポータルサイト](https://www.data.jma.go.jp/developer/index.html)には、防災情報XMLのほかに、アメダスの最新観測値と過去データのCSV、2週間気温予報と1か月予報の気温のCSV、数値予報（GPV）のサンプルデータが並んでいます。

| データ            | 形式      | 仕様の公開     | 向いている用途      |
| -------------- | ------- | --------- | ------------ |
| 天気予報・概況（bosai） | JSON    | なし        | 画面表示、社内の参考情報 |
| 警報・注意報・地震など    | 防災情報XML | あり        | 通知、業務判断のトリガー |
| アメダスの過去データ     | CSV     | ポータルに説明あり | 需要予測の学習データ   |
| 2週間気温予報        | CSV     | ポータルに説明あり | 仕入・人員の計画     |

需要予測のように過去と未来の気温をそろえて使う用途では、JSONよりCSVのほうが期間をまとめて取れるため扱いやすくなります。

## 天気予報JSONを試す：エリアコードの調べ方とcurl・Pythonでの取得

ここからは、東京都の予報を例にJSONを取得します。どの地域の予報を取るかは、府県予報区のコードで指定します。

### area.jsonで市町村から府県予報区までエリアコードを引く手順

地域コードの一覧は [area.json](https://www.jma.go.jp/bosai/common/const/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: ops@example.com)"}

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型の提供ページ](https://xml.kishou.go.jp/xmlpull.html)によると、フィードは「定時」「随時」「地震火山」「その他」の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: ops@example.com)"}
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版に沿った出典表記とデータ加工時の書き方

[気象庁ホームページの利用規約](https://www.jma.go.jp/jma/kishou/info/coment.html)では、権利表記のないコンテンツは「公共データ利用規約（第1.0版）」に準拠した条件で利用できます。商用のシステムに組み込むこともできますが、出典の記載が条件です。

記載例は「出典：気象庁ホームページ」と当該ページのURLです。予報の文言を要約したり、降水確率をグラフにしたりと加工した場合は、出典とは別に「気象庁の○○をもとに△△株式会社作成」のように、加工者が作ったと分かる形で書きます。国や気象庁が作ったように見える見せ方は禁止されています。画面のフッターなど、常に見える場所に出典を置く設計にしておくと漏れません。

### 気象業務法17条の予報業務許可と23条の警報の制限に当たる使い方

同じ規約には、気象業務法第17条第1項（予報業務の許可）と第23条（警報の制限）による利用制約があり得ると書かれています。気象庁の予報や警報をそのまま表示・転送する範囲を超えて、自社で独自に予報を作って他者に提供する場合は、予報業務の許可が要るかを確認してください。気象庁以外の者が警報を出すことも制限されています。

実装で気をつけるのは表示の言葉です。自社の機械学習モデルで出した降水の見込みを「警報」「予報」と名付けて取引先に配ると、この論点に触れます。社内の判断用に留めるか、表示名を「社内アラート」などに分けるかを、要件定義の段階で決めておきます。

## 気象データ連携の自社構築と配信事業者の利用を選ぶための判断基準

気象庁のデータは無料で取れますが、使ってよい場面と使うべきでない場面ははっきり分かれます。

### JSONやPULL型で足りる用途と、配信遅延が許されない用途の境界

社内ポータルの天気表示、翌日の配送計画や工事予定の参考、警報が出たら担当者にチャットで知らせる程度の用途なら、bosaiのJSONとPULL型のフィードで足ります。数分の遅れや一時的な停止があっても、人が気付いて補える業務です。

反対に、緊急地震速報を受けて設備を止める、津波の情報で避難の指示を出すといった、秒単位の遅れが安全に響く用途には使いません。気象庁自身が、迅速かつ確実な配信が必要な場合は気象業務支援センターや予報業務許可事業者に問い合わせるよう案内しています。この境界は迷わず配信事業者側に倒すべきです。

### 気象データを需要予測や現場アラートに組み込むときの設計と外注判断

気象データの使い道として多いのは、販売や電力の需要予測と、拠点ごとの警報アラートです。たとえば[電力需給管理システム](https://www.issoh.co.jp/column/details/16831/)では、気温の予測が需要想定の入力になります。こうした仕組みでは、取得処理そのものより、拠点と地域コードの対応表、取得失敗の検知、過去データの保存先の設計に工数がかかります。

定期実行の部分は、クラウドのスケジューラーに任せると運用の負担を減らせます。AWSなら[EventBridge Schedulerのcron式と上限](https://www.issoh.co.jp/tech/details/4019/)を前提に、1分間隔で巡回する構成が可能です。既存の基幹システムや販売管理と気象データをつなぐ連携の設計まで含めて任せたい場合は、[一創のAPI開発・システム連携](https://www.issoh.co.jp/service/system/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連携とは？仕組み・データ連携との違い・導入判断までわかりやすく解説](https://www.issoh.co.jp/column/details/15354/)：外部データを業務システムにつなぐ考え方の全体像
- [API連携ツールの選び方｜iPaaS・データ連携基盤・受託開発の使い分けを解説](https://www.issoh.co.jp/column/details/16376/)：気象データ連携を作るときの手段の比較
- [API開発とは？自社APIを公開する目的・進め方・費用と外注判断をわかりやすく解説](https://www.issoh.co.jp/column/details/16374/)：取り込んだデータを社内向けAPIとして配るとき
- [電力需給管理システムとは？同時同量・インバランス回避を回す機能と開発判断](https://www.issoh.co.jp/column/details/16831/)：気象データを需要想定に使う業務の例
- [EventBridge SchedulerのAPI｜cron式・手動実行・上限と料金の実装ガイド](https://www.issoh.co.jp/tech/details/4019/)：フィード巡回の定期実行を組むとき

---

出典: [気象庁APIの使い方：天気予報JSONと防災情報XMLの取得手順・利用規約・実装例](<https://www.issoh.co.jp/tech/details/20071/>)（株式会社一創）
