雷

このエンドポイント群は、中央気象署が検知した雷を提供します。各件には種類（雲対雲または雲対地）、発生時刻、座標があります。サーバーは 30 秒ごとに出典を確認し、出典が更新されたときにスナップショットを 1 件追加します。3 日保持します。地図に雷の分布を描く、または雷雨の注意に向きます。共通形式は気象 API の概要を参照してください。

データライセンス

• 出典明記・商用可

  推奨表記データ出典：中央気象署、ExpTech Studio（exptech.dev）

上流の条件

• 中央気象署：中央気象署のデータ利用規約（政府データオープンライセンスなど）も適用されます。気象・地震情報は中央気象署の発表を正とします。

表記の場所、例、商用利用の申請はデータの利用条件と出典表記をご覧ください。

認証

現在は API Token は不要です。

最新の雷データを取得

最新の 1 件の雷スナップショットです。雷に観測点はありません。フィールドごとの配列では、同じ添字が同じ 1 件の雷を表します。

GEThttps://api.core-tnn1.exptech.dev/api/v5/meteor/lightning

商用可

サーバーTNN-1

リクエスト例

cURL

curl "https://api.core-tnn1.exptech.dev/api/v5/meteor/lightning"

JavaScript

const res = await fetch("https://api.core-tnn1.exptech.dev/api/v5/meteor/lightning");
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

Python

import requests

res = requests.get(
    "https://api.core-tnn1.exptech.dev/api/v5/meteor/lightning",
    timeout=10,
)
res.raise_for_status()
print(res.json())

レスポンス

200304

成功

{
  "time": 1794636300,
  "type": [
    0,
    0,
    1
  ],
  "t": [
    1794635880,
    1794635940,
    1794636120
  ],
  "lat": [
    24.802,
    24.804,
    24.818
  ],
  "lon": [
    121.008,
    121.023,
    120.978
  ]
}

すべて表示（23 行）

データは変わっていません（If-None-Match が一致）。body なしレスポンスボディなし

試してみる

API トークン（任意）

このブラウザに保存送信

トークンはこのブラウザから API へ直接送信されます。

レスポンスのフィールド

フィールド	型	説明
time	number	この一群のデータがカバーする区間の終了時刻。Unix 秒
type	number[]	雷の種類。0 は雲対雲、1 は雲対地
t	number[]	各雷の発生時刻。Unix 秒
lat	number[]	緯度。小数第 4 位
lon	number[]	経度。小数第 4 位

この期間に雷がないときは、各配列は空です。サーバーにまだデータが 1 つもないときは {} を返します。

スナップショットの時刻リストを取得

現在照会できる雷スナップショットの時刻です。差分符号化の Unix 秒で、古い順です。復元方法は差分の時刻リストを参照してください。

GEThttps://api.core-tnn1.exptech.dev/api/v5/meteor/lightning/list

商用可

サーバーTNN-1

リクエスト例

cURL

curl "https://api.core-tnn1.exptech.dev/api/v5/meteor/lightning/list"

JavaScript

const res = await fetch("https://api.core-tnn1.exptech.dev/api/v5/meteor/lightning/list");
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

Python

import requests

res = requests.get(
    "https://api.core-tnn1.exptech.dev/api/v5/meteor/lightning/list",
    timeout=10,
)
res.raise_for_status()
print(res.json())

レスポンス

200304

成功

[
  1794377100,
  300,
  300,
  600
]

データは変わっていません（If-None-Match が一致）。body なしレスポンスボディなし

試してみる

API トークン（任意）

このブラウザに保存送信

トークンはこのブラウザから API へ直接送信されます。

レスポンスのフィールド

フィールド	型	説明
[0]	number	最も古いスナップショットの時刻。Unix 秒
[i]（i ≥ 1）	number	直前の 1 件との時間差（秒）。出典が更新されたときだけ新しいスナップショットができるため、間隔は一定ではありません

スナップショットがないときは [] を返します。

指定時刻の雷データを取得

指定時刻の雷スナップショットです。構造は最新の雷データを取得と同じです。static.core だけで提供し、api.core はこのパスに 404 を返します。

GEThttps://static.core-tnn1.exptech.dev/api/v5/meteor/lightning/{time}

商用可

サーバーTNN-1

パスパラメーター

• timeinteger必須

  パスパラメータ。スナップショットの時刻。10 桁の Unix 秒。/list に出た値でなければなりません

リクエスト例

cURL

curl "https://static.core-tnn1.exptech.dev/api/v5/meteor/lightning/<time>"

JavaScript

const res = await fetch("https://static.core-tnn1.exptech.dev/api/v5/meteor/lightning/<time>");
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data);

Python

import requests

res = requests.get(
    "https://static.core-tnn1.exptech.dev/api/v5/meteor/lightning/<time>",
    timeout=10,
)
res.raise_for_status()
print(res.json())

レスポンス

200304404

成功。構造は最新の雷データと同じ

{
  "time": 1794636000,
  "type": [
    1
  ],
  "t": [
    1794635710
  ],
  "lat": [
    24.7921
  ],
  "lon": [
    121.0113
  ]
}

データは変わっていません（If-None-Match が一致）。body なしレスポンスボディなし

time が整数ではない、またはその時刻にスナップショットがない（保持期限を過ぎたときも同じ）。body なしレスポンスボディなし

試してみる

パスパラメーター

time必須

API トークン（任意）

このブラウザに保存送信

トークンはこのブラウザから API へ直接送信されます。

レスポンスのフィールド

最新の雷データを取得のレスポンスフィールドと同じです。

注意事項

• 時刻はすべて Unix 秒です。time はスナップショット区間の終了時刻で、個々の雷の時刻は t を見てください。
• スナップショットは 3 日保持します。雷には推移と観測点一覧のエンドポイントはありません。
• データ出典：中央気象署のオープンデータの雷データです。
• サーバーの選び方は気象 API の概要を参照してください。タイムスタンプ付きスナップショットは static.core、それ以外は api.core です。TNN-1 の URL を直接使うことを推奨します。