Skip to content

対応フォーマット

本APIは気象庁の予報データを、以下の12のフォーマットへ変換して配信します。用途に合わせて使い分けられます。

かつて広く利用された「Livedoor 天気情報(Weather Hacks)」互換の構造です。日本語のテロップ(telop)や日付ラベル(今日明日明後日)、降水確率の時間帯別オブジェクトを持ちます。

Terminal window
GET /api/livedoor/{area}.json
{
"publicTime": "2026-08-20T05:00:00+09:00",
"title": "東京都 東京地方 の天気",
"forecasts": [
{
"date": "2026-08-20",
"dateLabel": "今日",
"telop": "晴れ",
"temperature": {
"min": { "celsius": "24", "fahrenheit": "75" },
"max": { "celsius": "33", "fahrenheit": "91" }
},
"chanceOfRain": {
"T00_06": "0%",
"T06_12": "20%",
"T12_18": "20%",
"T18_24": "20%"
}
}
],
"location": {
"area": "関東甲信",
"pref": "東京都",
"city": "東京地方",
"id": "130000"
},
"description": { "text": "東京地方は、高気圧に覆われて…", "publicTime": "" }
}

キー名に単位が明記され(temp_cwind_kph など)、location / current / forecast の直感的な階層を持つ形式です。LLM(AIエージェント)がパース・解釈しやすい設計です。

Terminal window
GET /api/weatherapi/{area}.json
{
"location": {
"name": "東京地方",
"region": "東京都",
"country": "Japan",
"tz_id": "Asia/Tokyo",
"localtime": "2026-08-20T05:00:00+09:00"
},
"current": {
"last_updated": "2026-08-20T05:00:00+09:00",
"temp_c": 33,
"condition": { "text": "晴れ", "code": 0 }
},
"forecast": {
"forecastday": [
{
"date": "2026-08-20",
"day": { "maxtemp_c": 33, "mintemp_c": 24, "daily_chance_of_rain": 0 }
}
]
}
}

業界標準の「Current Weather Data」互換の構造です。weather 配列と main オブジェクトが分離されています。仕様に合わせて気温はケルビンで出力します。

Terminal window
GET /api/openweathermap/{area}.json
{
"weather": [
{ "id": 0, "main": "Clear", "description": "晴れ", "icon": "01d" }
],
"main": {
"temp": 306.15,
"temp_min": 297.15,
"temp_max": 306.15
},
"timezone": 32400,
"name": "東京地方",
"cod": 200
}

カラム指向・時系列配列の形式です。日時配列(daily.time)と各気象要素配列のインデックスが同期しており、グラフ描画やデータ分析に適しています。

Terminal window
GET /api/open-meteo/{area}.json
{
"timezone": "Asia/Tokyo",
"daily": {
"time": ["2026-08-20", "2026-08-21"],
"weather_code": [0, 3],
"temperature_2m_max": [33, 32],
"temperature_2m_min": [24, 24],
"precipitation_probability_max": [0, 40]
},
"daily_units": {
"temperature_2m_max": "°C",
"temperature_2m_min": "°C",
"precipitation_probability_max": "%"
}
}

グローバルな商用サービスや AI エージェントで採用が多い構造です。timelines の中に時系列データと測定値(values)が整理されています。

Terminal window
GET /api/tomorrowio/{area}.json
{
"data": {
"timelines": [
{
"timestep": "1d",
"startTime": "2026-08-20T05:00:00+09:00",
"intervals": [
{
"startTime": "2026-08-20T00:00:00+09:00",
"values": {
"weatherCode": 1000,
"temperature": 33,
"temperatureMin": 24,
"temperatureMax": 33,
"precipitationProbability": 10
}
}
]
}
]
}
}

配列のネストが浅く、Python の Pandas や BI ツール、スプレッドシートへ直接流し込みやすい実用的なフォーマットです。

Terminal window
GET /api/visualcrossing/{area}.json
{
"resolvedAddress": "東京地方, Japan",
"address": "130000",
"timezone": "Asia/Tokyo",
"days": [
{
"datetime": "2026-08-20",
"temp": 33,
"tempmax": 33,
"tempmin": 24,
"precipprob": 10,
"conditions": "Clear",
"description": "晴れ"
}
]
}

世界各国の組み込み天気アプリで利用されている形式です。1日の予報が DayNight に明確に分かれているのが特徴です(気象庁の日単位予報のため昼夜は同じ値を使用します)。

Terminal window
GET /api/accuweather/{area}.json
{
"Headline": {
"EffectiveDate": "2026-08-20T05:00:00+09:00",
"Text": "晴れ"
},
"DailyForecasts": [
{
"Date": "2026-08-20T07:00:00+09:00",
"Temperature": {
"Minimum": { "Value": 24, "Unit": "C" },
"Maximum": { "Value": 33, "Unit": "C" }
},
"Day": {
"Icon": 1,
"IconPhrase": "晴れ",
"HasPrecipitation": true,
"PrecipitationProbability": 10
},
"Night": {
"Icon": 1,
"IconPhrase": "晴れ",
"HasPrecipitation": true,
"PrecipitationProbability": 10
}
}
]
}

位置情報(緯度経度)と気象データを一体化させた国際標準形式です。MapLibre GL JS、Leaflet、Kepler.gl などの地図ライブラリにそのまま渡すだけで、日本地図上に全国の天気ピンを描画できます。座標は気象庁の予報区(代表観測地)の固定値を組み込んでいます。

Terminal window
# 単一の予報区
GET /api/geojson/{area}.json
# 全国を1つの FeatureCollection に集約
GET /api/geojson/japan.json
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [139.6917, 35.6895]
},
"properties": {
"areaCode": "130000",
"name": "東京地方",
"telop": "晴れ",
"weatherCode": "100",
"tempMax": 33,
"tempMin": 24
}
}
]
}

かつてのデファクトスタンダードで、現在も Home Assistant などの IoT プラットフォームで広く使われている形式です。直感的な currently / daily の階層構造を持ちます。

Terminal window
GET /api/darksky/{area}.json
{
"latitude": 35.6895,
"longitude": 139.6917,
"timezone": "Asia/Tokyo",
"currently": {
"time": 1724112000,
"summary": "晴れ",
"icon": "clear-day",
"temperature": 33
},
"daily": {
"summary": "向こう数日間は晴天が続く見込みです。",
"data": [
{
"time": 1724112000,
"summary": "晴れ",
"icon": "clear-day",
"temperatureHigh": 33,
"temperatureLow": 24,
"precipProbability": 0.1
}
]
}
}

iOS / macOS の「天気」アプリを支えるモダンな Apple 公式設計です。データセットごとに独立したオブジェクト(currentWeather / forecastDaily)を持ち、階層が論理的で AI やアプリに扱いやすい構造です。

Terminal window
GET /api/weatherkit/{area}.json
{
"currentWeather": {
"asOf": "2026-08-20T05:00:00+09:00",
"conditionCode": "Clear",
"temperature": 33
},
"forecastDaily": {
"days": [
{
"forecastStart": "2026-08-20T00:00:00Z",
"conditionCode": "Clear",
"temperatureMax": 33,
"temperatureMin": 24,
"precipitationChance": 0.1
}
]
}
}

W3C / Schema.org で定義されたセマンティックWeb標準です。AIエージェントやナレッジグラフに天候メタデータを認識させる用途に向いています。

Terminal window
GET /api/schemaorg/{area}.json
{
"@context": "https://schema.org",
"@type": "WeatherForecast",
"name": "東京地方の天気予報",
"validFrom": "2026-08-20T05:00:00+09:00",
"validUntil": "2026-08-21T00:00:00+09:00",
"variableMeasured": [
{
"@type": "PropertyValue",
"name": "temperatureMax",
"value": 33,
"unitCode": "CEL"
},
{
"@type": "PropertyValue",
"name": "temperatureMin",
"value": 24,
"unitCode": "CEL"
}
]
}

国内向け地図・位置情報連携で長年利用されてきた仕様です。Feature 配列の中に観測・予報の WeatherList が格納されます。気象庁データに降水量階級(Rainfall)が無いため、本APIでは "0" を返します。

Terminal window
GET /api/yahoo/{area}.json
{
"ResultInfo": {
"Count": 1,
"Status": 200
},
"Feature": [
{
"Name": "東京地方",
"Property": {
"WeatherList": {
"Weather": [
{
"Type": "observation",
"Date": "202608200500",
"Weather": "晴れ",
"WeatherCode": 100,
"Rainfall": "0"
},
{
"Type": "Forecast",
"Date": "202608200500",
"Weather": "晴れ",
"WeatherCode": 100,
"Rainfall": "0"
}
]
}
}
}
]
}