レーダーエコー

中央気象署のレーダー合成エコー（エコー強度、単位 dBZ）のタイルです。東経 115°–126.5°、北緯 18°–29° をカバーし、格子間隔は 0.0125° です。約 7 日分を保持します。時間間隔は中央気象署の発表に従うため、リストを正としてください。降水エコーのアニメーションや、現在の天気の地図に向きます。

共通のルール（座標、キャッシュ、出典表示、完全な地図の例）は地図タイルの概要を参照してください。

データライセンス

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

上流の条件

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

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

認証

現在は API Token は不要です。

利用可能な時刻の取得

GEThttps://api.core-tnn1.exptech.dev/api/v2/tiles/radar/list

商用可

サーバーTNN-1

リクエスト例

curl --compressed "https://api.core-tnn1.exptech.dev/api/v2/tiles/radar/list"

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

import requests

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

レスポンス

200500

成功（データがないときは [ ]）。クライアントが対応しているときは gzip で圧縮

[
  1794641400,
  600,
  600,
  600
]

サーバーエラー（プレーンテキストのエラーメッセージ）text/plain

試してみる

レスポンスのフィールド

レスポンスは delta 符号化の整数配列です。古い順で、単位は Unix 秒です（復元方法は地図タイルの概要を参照）。

フィールド	型	説明
`[0]`	`integer`	最も古い 1 件の時刻です。Unix 秒。
`[i]（i ≥ 1）`	`integer`	直前の 1 件との差（秒）です。累積すると各件の時刻になります。

タイルの取得

GEThttps://static.core-tnn1.exptech.dev/api/v2/tiles/radar/{time}/{z}/{x}/{y}.webp

商用可

サーバーTNN-1

パスパラメーター

timeinteger必須
Unix 秒。リストにある値と完全に一致させてください（最も近い 1 件には寄りません）。
zinteger必須
ズームレベル。3–12。範囲外は 1 × 1 の透明 GIF を返します。
xinteger必須
XYZ タイルの列番号です。
yinteger必須
XYZ タイルの行番号です（北から南）。

リクエスト例

curl -o output.webp "https://static.core-tnn1.exptech.dev/api/v2/tiles/radar/<time>/<z>/<x>/<y>.webp"

const res = await fetch("https://static.core-tnn1.exptech.dev/api/v2/tiles/radar/<time>/<z>/<x>/<y>.webp");
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const blob = await res.blob();

import requests

res = requests.get(
    "https://static.core-tnn1.exptech.dev/api/v2/tiles/radar/<time>/<z>/<x>/<y>.webp",
    timeout=10,
)
res.raise_for_status()
with open("output.webp", "wb") as f:
    f.write(res.content)

レスポンス

200304400500

image/webp、256 × 256、可逆圧縮、透明な背景。エコーがある格子（dBZ > 0）だけを描きます。z が 3–12 の外、タイルがカバー範囲の外、または範囲内にエコーがないときは、1 × 1 の透明 GIF（image/gif）を返しますbinary image/webp

If-None-Match が ETag と一致。内容なしレスポンスボディなし

time が整数ではない

bad time

その時刻が存在しない、またはサーバーエラー。内容は改行 1 つだけレスポンスボディなし

試してみる

色階

dBZ は小数を切り捨て、整数ごとに 1 色です（0–65 dBZ。65 を超えるときは 65 の色）。主な区切りは次のとおりです。

dBZ	色	説明
0–14	`#00FFFF` → `#0000FF`	シアンから青。dBZ ごとに濃くなります
15–25	`#00FF00` → `#009600`	緑。dBZ ごとに濃くなります
26–29	`#33AB00` → `#CCEA00`	黄緑
30–35	`#FFFF00` → `#FFC800`	黄
36–44	`#FFB800` → `#FF1800`	オレンジ
45–55	`#FF0000` → `#960000`	赤。dBZ ごとに濃くなります
56–59	`#AB0033` → `#EA00CC`	赤紫
60–65	`#FF00FF` → `#9600FF`	マゼンタから紫

注意事項

時刻が存在しないときは 500 です。404 ではありません。 内容は改行 1 つだけです。リストにある時刻だけを使ってください。古すぎる時刻（約 7 日前）はリストから消え、タイルも取得できません。
時刻は完全に一致させてください。time は Unix 秒です。ミリ秒は使わないでください。
z、x、y が整数でないときは 400 にはならず、0 として扱われます。呼び出し側で確認してください。
使わないズームは、地図ライブラリで minzoom: 3、maxzoom: 12 を設定してください。12 を超えたときは、ズーム 12 のタイルを拡大します。
タイル URL の内容は固定なので、クライアントで長期にキャッシュできます。レスポンスに Cache-Control はありませんが、ETag で条件付きリクエストができます。
同じリストのパスはタイルホストでも取得できます。ただし約 1 時間キャッシュされるため、最新の時刻は上のリスト用ホストで取得してください。
地図には、データライセンスの推奨表記で出典を表示してください。