02
緯度と経度だけで、
今の空気が返る。
認証は URL に付けるキー 1 つ。応答は層ごとにまとまった JSON で、単位と観測時刻がかならず横に付く。キャッシュしてよい秒数もヘッダーで返すので、呼びすぎを気にしなくていい。
{
"observed_at": "2026-09-29T14:00:00+09:00",
"temp": { "value": 28.4, "unit": "C", "feels": 30.1 },
"pressure": { "value": 1011.2, "unit": "hPa", "delta_3h": -0.8 },
"humidity": { "value": 49, "unit": "%", "dew": 16.7 },
"wind": { "speed": 3.6, "dir": 140, "gust": 6.2 },
"rain": { "now": 0.0, "next_60m": [0, 0, 0.2, 0.6] },
"solar": { "ghi": 612, "unit": "W/m2" }
}03
6 つの層に、
6 つの色。
ドキュメントでも、グラフでも、応答のキーでも、層の色は変わらない。色を覚えれば、どの画面でも迷わない。
| 層 | 単位 | 解像度 | 更新 | 内容 |
|---|---|---|---|---|
| 気温 | ℃ | 1 km | 60 秒 | 地表 2 m。体感温度も同じ応答に入る |
| 気圧 | hPa | 5 km | 5 分 | 海面更正値。3 時間の変化量つき |
| 湿度 | % | 1 km | 60 秒 | 相対湿度と露点 |
| 風 | m/s | 2 km | 60 秒 | 10 m 高の風速・風向・最大瞬間 |
| 降水 | mm/h | 250 m | 30 秒 | レーダー合成。60 分先まで予測 |
| 日射 | W/m² | 1 km | 10 分 | 太陽光パネルの発電予測向け |
04
1 日を、
色で読む。
ヒーローの背景と同じ配色で、24 時間の気温を並べた。最高気温は 14 時ごろ、最低は明け方。
05
無料枠は 1 日 10,000 回。
まずは手元の端末から。
curl "https://api.halcyon.example/v4/now?lat=35.68&lon=139.76&key=YOUR_KEY"