気象庁アメダスの観測値JSON（公式APIではない）の使い方：最新時刻・観測所番号・品質フラグの読み方

10:17:08 取得 -> 2026-10-20T10:00:00+09:00（Last-Modified 10:06:40）
10:25:11 取得 -> 2026-10-20T10:10:00+09:00（Last-Modified 10:16:40）

"44132": {
  "type": "A", "elems": "11111111",
  "lat": [35, 41.5], "lon": [139, 45], "alt": 25,
  "kjName": "東京", "knName": "トウキョウ", "enName": "Tokyo"
}

{
  "pressure": [1015.6, 0], "normalPressure": [1018.4, 0],
  "temp": [22.7, 0], "humidity": [75, 0],
  "snow": [null, 5], "snow1h": [0, 6], "snow6h": [0, 6], "snow12h": [0, 6], "snow24h": [0, 6],
  "sun10m": [0, 0], "sun1h": [0, 0],
  "precipitation10m": [0, 0], "precipitation1h": [0, 0], "precipitation3h": [0, 0], "precipitation24h": [0, 0],
  "windDirection": [14, 0], "wind": [2.1, 0]
}

09:00  temp 23.3  maxTemp 23.3  maxTempTime {"hour":0,"minute":0}
09:10  temp 23.3  maxTemp 23.6  maxTempTime {"hour":0,"minute":5}
（minTempTime はどちらも {"hour":20,"minute":46}、minTemp 18.6）

44132 東京   -> amedastable の「東京」（種類A）
44172 大島   -> 「大島」（種類B）
44263 八丈島 -> 「八丈島」（種類B）
44301 父島   -> 「父島」（種類D）

// amedas-latest.mjs — 依存なし（Node.js 18 以降の組み込み fetch）
// 使い方: node amedas-latest.mjs 東京
import { readFile, writeFile, mkdir, stat } from 'node:fs/promises';

const UA = 'amedas-example/0.1 (+https://codeagent.jp/)';
const BASE = 'https://www.jma.go.jp/bosai/amedas';
const TABLE_URL = `${BASE}/const/amedastable.json`;
const TABLE_CACHE = './cache/amedastable.json';
const DAY = 24 * 60 * 60 * 1000;
// 画面のスクリプトにある品質の記号。0 と 1 以外は値として使わない
const AQC = { 0: '', 1: ')', 2: '#', 3: '#', 4: ']', 5: '休止中', 6: '×' };
const UNITS = { temp: '℃', humidity: '%', precipitation10m: 'mm', precipitation1h: 'mm', wind: 'm/s', windDirection: '16方位', sun1h: 'h', snow: 'cm', pressure: 'hPa' };

async function get(url, kind) {
  const res = await fetch(url, { headers: { 'User-Agent': UA } });
  const type = res.headers.get('content-type') ?? '';
  // 存在しない観測所は 404 の HTML が返る
  if (!res.ok || (kind === 'json' && !type.includes('json'))) {
    throw new Error(`取得失敗: ${url} -> HTTP ${res.status} (${type})`);
  }
  return kind === 'json' ? res.json() : (await res.text()).trim();
}

async function loadTable() {
  try {
    if (Date.now() - (await stat(TABLE_CACHE)).mtimeMs < DAY) return JSON.parse(await readFile(TABLE_CACHE, 'utf8'));
  } catch { /* キャッシュなし */ }
  const table = await get(TABLE_URL, 'json');
  await mkdir('./cache', { recursive: true });
  await writeFile(TABLE_CACHE, JSON.stringify(table));
  return table;
}

const toDeg = ([d, m]) => Math.round((d + m / 60) * 1e5) / 1e5; // [度, 分] → 十進の度

// [値, 品質] を { value, aqc, mark } に。品質が 0・1 以外なら値を捨てる
function reading([value, aqc] = []) {
  if (aqc === undefined) return undefined;          // その要素を観測していない
  const usable = (aqc === 0 || aqc === 1) && value !== null;
  return { value: usable ? value : null, aqc, mark: aqc === null ? '観測なし' : AQC[aqc] ?? `不明(${aqc})` };
}

// 今回の実測からUTCと推定（公式仕様は未確認）。観測時刻以前で最も近い日時として日本時間に直す
function jstTime(observedAt, t) {
  if (!t) return null;
  const obs = new Date(observedAt);
  const at = new Date(Date.UTC(obs.getUTCFullYear(), obs.getUTCMonth(), obs.getUTCDate(), t.hour, t.minute));
  if (at > obs) at.setUTCDate(at.getUTCDate() - 1);
  return new Date(at.getTime() + 9 * 3600e3).toISOString().slice(0, 16) + '+09:00';
}

// 風向は 1〜16 が北北東から時計回り、0 は静穏
const WDR = ['静穏', '北北東', '北東', '東北東', '東', '東南東', '南東', '南南東', '南', '南南西', '南西', '西南西', '西', '西北西', '北西', '北北西', '北'];

async function main(name) {
  const table = await loadTable();
  const candidates = Object.entries(table)
    .filter(([, s]) => s.kjName === name)
    .map(([code, s]) => ({ code, name: s.kjName, type: s.type, lat: toDeg(s.lat), lon: toDeg(s.lon), alt: s.alt }));
  if (candidates.length !== 1) {
    console.log(JSON.stringify({ status: candidates.length ? 'ambiguous' : 'not_found', input: name, candidates }, null, 2));
    return;
  }
  const station = candidates[0];

  // 最新時刻を先に読む。時刻を自分で計算して先回りしない
  const latest = await get(`${BASE}/data/latest_time.txt`, 'text');          // 例 2026-10-20T10:10:00+09:00
  const ymd = latest.slice(0, 10).replaceAll('-', '');
  const block = String(Math.floor(Number(latest.slice(11, 13)) / 3) * 3).padStart(2, '0');
  const pointUrl = `${BASE}/data/point/${station.code}/${ymd}_${block}.json`;
  const series = await get(pointUrl, 'json');
  const obsKey = latest.slice(0, 19).replace(/[-T:]/g, '');
  const row = series[obsKey];
  if (!row) throw new Error(`${pointUrl} に ${obsKey} がない`);

  const values = Object.fromEntries(Object.keys(UNITS).map((k) => [k, reading(row[k])]).filter(([, v]) => v));
  console.log(JSON.stringify({
    status: 'ok',
    station,
    observedAt: latest,
    values,
    windDirectionLabel: values.windDirection?.value == null ? null : WDR[values.windDirection.value],
    units: UNITS,
    maxTemp: { ...reading(row.maxTemp), at: jstTime(latest, row.maxTempTime) },
    minTemp: { ...reading(row.minTemp), at: jstTime(latest, row.minTempTime) },
    newerKeysInFile: Object.keys(series).filter((k) => k > obsKey),
    provenance: {
      sources: [`${BASE}/data/latest_time.txt`, pointUrl, TABLE_URL],
      retrievedAt: new Date().toISOString(),
      attribution: '出典：気象庁ホームページ（https://www.jma.go.jp/bosai/amedas/）を加工して作成',
      warnings: ['気象庁ホームページが内部で使うJSON。API仕様としては公開されておらず、予告なく変わりうる', '品質が0・1以外の値は value を null にしている'],
    },
  }, null, 2));
}

await main(process.argv[2]);

$ node amedas-latest.mjs 金山
{ "status": "ambiguous", "input": "金山",
  "candidates": [
    { "code": "12686", "name": "金山", "type": "C", "lat": 43.13833, "lon": 142.41667, "alt": 284 },
    { "code": "35116", ... "lat": 38.87833 }, { "code": "36342", ... "lat": 37.47333 }, { "code": "52406", ... "lat": 35.66167 } ] }

$ node amedas-latest.mjs 東京
"station": { "code": "44132", "name": "東京", "type": "A", "lat": 35.69167, "lon": 139.75, "alt": 25 }
"observedAt": "2026-10-20T10:20:00+09:00"
"values": {
  "temp": { "value": 22.1, "aqc": 0, "mark": "" },
  "humidity": { "value": 81, "aqc": 0, "mark": "" },
  "precipitation1h": { "value": 0, "aqc": 0, "mark": "" },
  "wind": { "value": 2, "aqc": 0, "mark": "" },
  "windDirection": { "value": 15, "aqc": 0, "mark": "" }, ... }
"windDirectionLabel": "北北西"
"maxTemp": { "value": 23.6, "aqc": 0, "mark": "", "at": "2026-10-20T09:05+09:00" }
"minTemp": { "value": 18.6, "aqc": 0, "mark": "", "at": "2026-10-20T05:46+09:00" }
"newerKeysInFile": []

- 観測値の回答は get_amedas_latest の結果だけを根拠にし、observedAt と出典を併記する
- value が null の要素は、mark（休止中・×など）を添えて「値なし」と書く。0 で補わない
- 観測所の候補が複数なら候補を示して止まる
- 観測値から予報や警戒の呼びかけを作らない
- 出典は「出典：気象庁ホームページ（URL）を加工して作成」の形で残す