KCCS APIサービス

KCCS API データ配信サービスの仕様について概要をご案内します。
詳細な仕様についてはサービス仕様書をご確認ください。気象・天気関連データ各機能の違いについては、機能一覧表もご参照ください。

データ配信サービス標準API

気象データ配信API機能一覧表

	提供内容	提供データ	エリア	予報期間	提供方式	更新頻度
気象予報データ	全国の今日、明日、明後日の気温、風速、降水確率、気温などを提供します。	風速、風向、気温、湿度、降雨量、雲量、日射量、太陽情報	全国5kmメッシュ(約36,000地点)	最大78時間先	REST API	3時間ごと
天気予報データ	全国の今日、明日の天気、気温、風情報などを提供します。	3時間卓越天気（天気、風速、風向、気温）、6時間降水確率、1日天気（天気、風速、風向、最高気温、最低気温）	全国の府県予報区（142区域）	2日間	REST API	1日3回
週間天気予報データ	全国の明日から7日間の天気、気温、降水確率などを提供します。	1日天気（天気、最高気温、最低気温、降水確率）	全国の府県予報区（142区域）	7日間	REST API	1日2回
暑さ指数予測データ	全国の今日、明日、明後日までの暑さ指数を提供します。 ※夏季限定配信	暑さ指数（WBGT）予測値	全国の暑さ指数情報提供地点（841地点）	51時間先	REST API	1日4回
リアルタイム地上気象観測データ	全国の最新の地上気象観測データを提供します。	風速、風向、気温、湿度、雨、積雪、気圧、日照、視程	全国の観測地点（156地点）	-	REST API	1分ごと
プロフェッショナル版気象・天気予報データ　※2024/8末日終了予定	全国の今日、明日、明後日、明々後日までの天気、降水量、風情報、気温などを提供します。	天気、風速、風向、気温、湿度、降水量、気圧、雲量、日射	全国の事前に登録した緯度／経度地点の気象予報データを提供します。	最大72時間先	REST API（APIダッシュボードから地点登録）	6時間ごと
解析雨量データ	前1時間降水量を提供します。	前1時間降水量	全国1kmメッシュ(約386,555地点)	-	REST API	30分ごと
速報版解析雨量データ	前1時間降水量を提供します。	前1時間降水量	全国1kmメッシュ(約386,555地点)	-	REST API	10分ごと
降水短時間予報データ	6時間先までの1時間ごとの1時間降水量予測値を提供します。	後1時間降水量予測	全国1kmメッシュ(約386,555地点)	6時間先	REST API	30分ごと
降水15時間予報データ	7時間先から15時間先までの降水量予測値を提供します。	後1時間降水量予測	全国5kmメッシュ(約36,000地点)	15時間先	REST API	1時間ごと
速報版降水短時間予報データ	6時間先までの降水量予測値を10分間隔で提供します。	後1時間降水量予測	全国1kmメッシュ(約386,555地点)	6時間先	REST API	10分ごと
雷ナウキャストデータ	雷活動度（雷の激しさや雷の可能性）を提供します。	雷活動度（0～4の5段階） 0：発雷の可能性は低い 1：落雷の可能性がある 2：電光が見えたり、雷鳴が聞こえる。落雷の可能性が高くなっている 3：落雷がある 4：落雷が多数発生	全国1kmメッシュ(約386,555地点)	60分先	REST API	10分ごと
気象警報・注意報データ	気象警報・注意報を提供します。	二次細分での地点名、地点コード、警報名、警報コード、発表形態文言、発表形態コード、前回警報名、前回警報コード、特記事項、付加事項等	指定した緯度経度地点に最も近い大字・町丁目から二次細分区域を決定し、その区域で発表／解除されている気象警報・注意報を提供します。	概ね24時間先	REST API	警報発令時に随時更新
早期注意情報データ配信機能	早期注意情報データ配信機能を提供します。	一次細分での地点名、地点コード、警報情報、予報対象時刻、警報階級値（雨・雪・風・波・潮位）、警報文言（雨・雪・風・波・潮位）等	指定した緯度経度地点に最も近い大字・町丁目から一次細分区域を決定し、その区域で発表／解除されている早期注意情報（翌日までの警報級の可能性）を提供します。	翌日まで	REST API	1日3回

※PaaS Connect機能(接続元グローバルIPアドレスによるアクセス制限を解除)も提供しております。

全国版気象データ配信機能

	提供内容	提供データ	エリア	予報期間	提供方式	更新頻度
全国版気象予報データ配信機能	全国の今日、明日、明後日の気温、風速、降水確率、気温などをCSV形式で提供します。	風速、風向、気温、湿度、降雨量、雲量、日射量	全国5kmメッシュ(約36,000地点)	最大78時間先	Google Cloud Storage	3時間ごと
全国版積雪データ配信機能	全国の解析積雪深、解析降雪量、降雪短時間予報(積雪深/降雪量)をCSV形式で提供します。	前1時間解析積雪深、前1時間解析降雪量、6時間降雪予報(積雪深/降雪量)	全国5kmメッシュ(約36,000地点)	6時間先	Google Cloud Storage	1時間ごと

災害データPUSH配信機能

	提供内容	提供データ	エリア	提供方式	配信頻度
地震震度データPUSH配信機能	地震震度情報をPUSH配信します。	地震発生時刻、震度観測点名、震度	「日本国の国土」上の観測地点に紐づくエリア	PUSH配信	気象庁からの地震データ配信時
気象警報・注意報データPUSH配信機能	気象警報・注意報をPUSH配信します。	二次細分での地点名、地点コード、警報名、警報コード、発表形態文言、発表形態コード、前回警報名、前回警報コード、特記事項、付加事項	日本国の国土	PUSH配信	気象庁からの気象警報・注意報データ配信時
落雷データPUSH配信機能	落雷情報をPUSH配信します。	落雷発生時刻、雷多重度、放電種別(雲放電・対地放電)	気象庁雷監視システム（LIDEN）での観測に依存	PUSH配信	気象庁からの地震データ配信時
津波警報・注意報・予報データPUSH配信機能	津波警報・注意報・予報をPUSH配信します。	対象となる津波予報区、津波の到達予想時刻、予想される津波の高さ、地震の発生時刻、震源地マグニチュード	日本近海又は外国で発生した地震による津波に紐づくエリア	PUSH配信	気象庁からの津波警報・注意報・予報データ配信時
土砂災害警戒情報データPUSH配信機能	土砂災害警戒情報をPUSH配信します。	警戒文、対象市町村	日本国土	PUSH配信	気象庁からの土砂災害警戒情報データ配信時

過去データダウンロード機能

	提供内容	提供データ	エリア	予報期間	提供方式	更新頻度
過去気象予報データダウンロード機能	2016年6月以降の全国の気温、風速、降水確率、気温などのデータをダウンロード提供します。	風速、風向、気温、湿度、降雨量、雲量、日射量、太陽情報	全国5kmメッシュ(約36,000地点)	-	CSV形式（APIダッシュボードから提供）	-

気象データ配信API

気象予報データ配信機能

気象予報データを指定した地点の分だけ抽出し、利用しやすい形式（REST／JSON）で提供するものです。

サンプルデータのダウンロード ※実際のデータはインデントや改行は含まれておりません。
※文字化けする場合は、リンクを右クリックし、リンク先を名前を付けて保存してください。　

気象予報データ配信機能

機能概要

項目	内容
概要	一般財団法人気象業務支援センター（気象庁の関連団体。以下、気象業務支援センターと呼称）の「メソ数値予報モデルGPV」（1時間ごと39時間先(※)の気象予報データ。5kmメッシュの格子ごとに配信される）を基にしたデータをJSON形式に加工し配信します。 ※ 9:00、21:00(日本標準時)の予報のみ、リクエストパラメータ指定により78時間先まで配信
提供内容	①気象予報データ・指定した緯度／経度地点を含む格子の 1時間ごとの最大78時間先の気象予報データを提供します。具体的には、風速、風向(角度、文字)、気温、相対湿度、時間降雨量、雲量(全、上層、中層、下層)、太陽情報、日射量となります。 ②太陽情報・指定した緯度／経度地点の太陽情報（日の出時間、日の入時間、南中時間、南中高度）を提供します。 ※理科年表（国立天文台）ベースで計算しています。
提供方式	インターネット経由でのREST API提供となります。 ※接続元IPアドレスの絞り込みについてはサービス仕様書をご確認ください。
エリア	配信対象エリアは「日本国の国土」上となります。（海洋上、他国は配信対象外です）緯度／経度を指定することで直近の予報（5kmメッシュ）を探し、その地点の気象予報データを返します（全国約36,000地点）。
更新頻度	①気象予報データは毎日8回更新されます。更新のタイミング（最新の予報がRESTで配信されるタイミング）は、以下のとおりです。 [更新頻度] 3時間ごとに3時間前の予報を更新します。・0時時点の予報の配信：およそ3時ごろ・3時時点の予報の配信：およそ6時ごろ・6時時点の予報の配信：およそ9時ごろ・・・（21時まで3時間おきに配信されます。（計8回/日））・・・ ※上記はすべて日本時間（JST）表記です。 ※気象庁システムの障害、気象業務支援センターのシステム障害等により該当時間からみて4時間以内に配信されていない場合は、当該時刻の配信を中止することがあります。 ②太陽情報は、リクエストのたびに計算し提供しています。

天気予報データ配信機能

指定の場所から地域を特定（府県予報区、一次細分区域の特定）し、該当地域の分だけ抽出後、利用しやすい形式（REST／JSON）で天気予報データを提供するものです。

サンプルデータのダウンロード ※実際のデータはインデントや改行は含まれません。
※文字化けする場合は、リンクを右クリックし、リンク先を名前を付けて保存してください。

天気予報配信機能

機能概要

項目	内容
概要	気象業務支援センターの「府県天気予報」を基にしたデータをJSON形式に加工し配信します。
提供内容	府県天気予報・指定した緯度／経度地点に最も近い大字／町丁目から、府県予報区、一次細分区域を決定し、その区域の府県天気予報を提供します。 ※府県予報区、一次細分区域についてはこちらをご参照ください。 ※大字／町丁目については国土交通省が配信する「位置参照情報ダウンロードサービス」の都道府県単位大字／町丁目データ（平成26年度版）を利用しています。詳細についてはこちらをご参照ください。
提供方式	インターネット経由でのREST API提供となります。 ※接続元IPアドレスの絞り込みについてはサービス仕様書をご確認ください。
エリア	配信対象エリアは「日本国の国土」上となります。（海洋上、他国は配信対象外です）緯度／経度を指定することで直近の大字／町丁目を検索し、その地点の府県天気予報を返します（全国142区域）。
更新頻度	気象庁発表の府県天気予報は毎日3回更新されます。その更新タイミング（最新予報が REST で配信されるタイミング）は基本的には 5:00、11:00、17:00 ですが、部分的に配信が遅れる場合がしばしばあります。

週間天気予報データ配信機能

指定の場所から地域を特定（週間予報区の特定）し、該当地域の分だけ抽出後、利用しやすい形式（REST／JSON）で週間天気予報データを提供するものです。

週間天気予報配信機能

機能概要

項目	内容
概要	気象業務支援センターの「府県週間天気予報」を基にしたデータをJSON形式に加工し配信します。
提供内容	府県週間天気予報・指定した緯度／経度地点に最も近い大字／町丁目から、週間予報区を決定し、その区域の府県週間天気予報を提供します。 ※週間予報区についてはこちら（「サービス仕様書（別紙2）天気予報提供対象地域／地点一覧」）をご確認ください。 ※大字／町丁目については国土交通省が配信する「位置参照情報ダウンロードサービス」の都道府県単位大字／町丁目データ（平成26年度版）を利用しています。詳細についてはこちらをご参照ください。
提供方式	インターネット経由でのREST API提供となります。 ※接続元IPアドレスの絞り込みについてはサービス仕様書をご確認ください。
エリア	配信対象エリアは「日本国の国土」上となります。（海洋上、他国は配信対象外です）緯度／経度を指定することで直近の大字／町丁目を検索し、その地点の週間府県天気予報を返します（全国142区域）。
更新頻度	気象庁発表の府県週間天気予報は毎日2回更新されます。その更新タイミング（最新予報がRESTで配信されるタイミング）は11:00頃と17:00頃です。

暑さ指数予測データ配信機能

環境省の「暑さ指数（WBGT）予測値等電子情報提供サービス」を利用して配信される「暑さ指数予測」を基にした予測データを利用しやすい形式（REST／JSON）で提供するものです。

暑さ指数予測データ配信機能

機能概要

項目	内容
概要	環境省の「暑さ指数（WBGT）予測値等電子情報提供サービス」を利用して配信される「暑さ指数予測」を基にした予測データをJSON形式に加工し配信します。
提供内容	暑さ指数予測／3時間ごとの51時間先までの暑さ指数予測データを提供します。
提供方式	インターネット経由でのREST API提供となります。 ※接続元IPアドレスの絞り込みについてはサービス仕様書をご確認ください。
エリア	配信対象エリアは「日本国の国土」上となります。（海洋上、他国は配信対象外です）緯度／経度を指定することで直近の予測地点を探し、その地点の予測データを返します（全国841地点）。 ※予測地点一覧についてはサービス仕様書をご確認ください。
更新頻度	暑さ指数（WBGT）予測値は、1時間に1回、30分頃に更新されます。（※1）なお、本配信は夏季限定配信になります。 ※1：暑さ指数予測値は1日4回発表される気象庁の数値予測データを基に算出されており、最新の予測は目安として 1時／9時／15時／21時ごろに反映されます。 1時間ごとの更新では、上記の他に最新を実況値を反映した補正が行われます。

リアルタイム地上気象観測データ配信機能

指定した緯度経度地点に最も近い気象官署及び特別地域気象観測所を決定し、その地点の「地上気象観測1分値データ」を返します。

機能概要

項目	内容
概要	気象業務支援センターより配信される「地上気象観測１分値データ」（全領域:集約報）を基にした気象観測データをJSON形式に加工し配信します。
提供内容	最新の地上気象観測データを配信します。・指定した緯度経度地点に最も近い気象官署及び地上気象観測地点を決定し、その地点の観測データを返します。 ※気象官署及び「地上気象観測地点一覧」については、こちらを参照ください。
提供方式	インターネット接続によるREST形式でのAPI提供となります。 ※接続元IPアドレスの絞り込みについては「ご利用にあたって」をご確認ください。
エリア	配信対象エリアは「日本国の国土」上となります。（海洋上、他国は配信対象外です。）緯度と経度を指定することで直近の観測地点を探し、その地点の観測データを返します（全国156地点）。
更新頻度	1分ごとに最新の観測データを更新します。（基本的には最新の1分値を更新しますが関係システムの処理タイミングなどの理由により、反映が遅れることがあります。）

プロフェッショナル版気象・天気予報データ配信機能　※2024/8末日終了予定

事前に登録した地点の気象予報データをREST APIで提供します。

サンプルデータのダウンロード ※実際のデータはインデントや改行は含まれません。
※文字化けする場合は、リンクを右クリックし、リンク先を名前を付けて保存してください。

※トライアルでは、本機能の利用を制限しております。ご利用希望の場合は、有料版をお申込みください。申込書はこちら。

項目	内容
概要	伊藤忠テクノソリューションズ株式会社（予報業務許可を受けた民間気象事業）より提供される1時間ごと最大72時間先のピンポイント気象予報データを基にしたデータをJSON形式に加工し配信します。
提供内容	指定した地点の1時間ごとの72時間先のまで気象・天気予報データ、日射予測を提供します。
提供方式	インターネット接続によるREST形式でのAPI提供となります。 ※接続元IPアドレスの絞り込みについては「ご利用にあたって」をご確認ください。
エリア	配信対象エリアは「日本国の国土」上となります。（海洋上、他国は配信対象外です。）事前に登録した緯度経度の地点コードを指定することで直近の気象予報データを返します。
更新頻度	気象予報、日射予測データは毎日４回更新され、その更新タイミング（最新の予報がRESTで配信されるタイミング）は以下のとおりです。 [更新頻度] 6時間ごとに6時間前の予報を更新します。・0時時点の予報の配信：およそ2時ごろ・6時時点の予報の配信：およそ8時ごろ・12時時点の予報の配信：およそ14時ごろ・18時時点の予報の配信：およそ20時ごろ ※0時から6時間ごとに計4回/日予報が更新されます。 ※上記はすべて日本時間（JST）表記です。 ※提供元のシステム障害等により該当時間からみて6時間以内に配信されていない場合は、当該時刻の配信を中止することがあります。