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

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

データ配信サービス 管理API

共通

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

データ配信サービス 標準API機能比較表

  提供内容 提供データ エリア 予報期間 提供方式 更新頻度
気象予報データ 全国の今日、明日、明後日の気温、風速、降水確率、気温などを提供します。 風速、風向、気温、湿度、降雨量、雲量、日射量、太陽情報 全国5kmメッシュ(約36,000地点) 最大39時間先 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分ごと
プロフェッショナル版気象・天気予報データ 全国の今日、明日、明後日、明々後日までの天気、降水量、風情報、気温などを提供します。 天気、風速、風向、気温、湿度、降水量、気圧、雲量、日射量 全国の事前に登録した緯度/経度地点の気象予報データを提供します。 最大72時間先 REST API(APIダッシュボードから地点登録) 6時間ごと
過去気象予報データダウンロード機能 2016年6月以降の全国の気温、風速、降水確率、気温などのデータをダウンロード提供します。 風速、風向、気温、湿度、降雨量、雲量、日射量、太陽情報 全国5kmメッシュ(約36,000地点) - CSV形式(APIダッシュボードから提供) -

気象予報データ配信機能

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

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

気象予報データ配信機能

機能概要

項目 内容
概要 一般財団法人気象業務支援センター(気象庁の関連団体。
以下、気象業務支援センターと呼称)の「メソ数値予報モデルGPV」
(1時間ごと最大39時間先の気象予報データ。
5kmメッシュの格子ごとに配信される)を基にしたデータを
JSON形式に加工し配信します。
提供内容 ①気象予報データ
・指定した緯度/経度地点を含む格子の
1時間ごとの最大39時間先の気象予報データを提供します。
具体的には、風速、風向(角度、文字)、気温、相対湿度、時間降雨量、
雲量(全、上層、中層、下層)、太陽情報、日射量となります。
②太陽情報
・指定した緯度/経度地点の太陽情報
(日の出時間、日の入時間、南中時間、南中高度)を提供します。
※理科年表(国立天文台)ベースで計算しています。
提供方式 インターネット経由での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分値データ」を返します。

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

機能概要

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

プロフェッショナル版気象・天気予報データ配信機能

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

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

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

※0時から6時間ごとに計4回/日予報が更新されます。
※上記はすべて日本時間(JST)表記です。
※提供元のシステム障害等により該当時間からみて6時間以内に配信されていない場合は、当該時刻の配信を中止することがあります。

過去気象予報データダウンロード機能

指定した地点(緯度・経度)に一番近い地点(5Kmメッシュ・全国約36,000地点)の過去の気象予報(気象庁発表「メソ数値予報モデル」)、および太陽情報をAPIダッシュボードから一括ダウンロードすることが可能です。

  • 1時間ごとの気象予報、太陽情報
  • 2016年6月以降の過去データ(あらかじめ取得期間を指定する)

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

データ配信サービス 管理API

本サービスにおける管理用APIをREST APIで提供しています。

No. 項目 内容
1 シークレットアクセスキー変更機能 接続時に利用するシークレットアクセスキーを
再発行します。
2 利用状況確認機能 現時点での本サービス利用状況を確認できます。

共通

価格体系について

本サービスでは各機能の利用ごとにポイント(pt)を加算し、ptに応じた金額を請求させていただきます。 価格の詳細については 価格表 をご確認ください。

機能/ポイント一覧について

下記に記載の機能一覧、および利用にかかるポイント(pt)は下記のとおりです。

No. カテゴリ 機能名 機能説明 Pt計算方法
1 標準API 気象予報データ 配信機能 指定した地点(緯度・経度)の気象予報、もしくは太陽に関する情報をREST APIで提供します。
・5kmメッシュにおける1時間ごとの最大39時間先の気象予報(風速、風向(角度、文字表現)、気温、相対湿度、時間降雨量、雲量(全、上層、中層、下層))
・太陽の情報(日の出時間、日の入時間、南中時間、南中高度)
なお、上記2種類とも提供対象範囲は「日本国の国土」となります。
(海洋上、他国は対象外。)
風速 1pt
風向(角度、文字) 1pt
気温 1pt
相対湿度 1pt
時間降雨量 1pt
雲量
(全、上層、中層、下層)
各1pt
太陽情報 1pt
日射量 1pt
2 天気予報データ
  配信機能
指定した地点(緯度・経度)における気象庁発表の天気予報(府県天気予報)をREST APIで提供します。
・3時間卓越天気、6時間降水確率、1日天気
3時間卓越天気
(天気、気温、風)
各1pt
6時間降水確率 1p
1日天気予報
(天気、気温、風)
各1pt
3 週間天気予報データ配信機能 指定した地点(緯度・経度)における気象庁発表の天気予報(府県週間天気予報)をREST APIで提供します。
・1日天気(7日分)
1日天気予報
(天気、気温、風)
各1pt
4 暑さ指数予測データ配信機能 指定した地点(緯度・軽度)に一番近い地点の環境省発表の暑さ指数(WBGT)予測をREST APIで提供します。
・3時間ごとの、51時間先の暑さ指数予測
※本配信は夏季限定配信となります。
暑さ指数予測 1p
5 リアルタイム地上気象観測データ配信機能 最新の地上気象観測データを配信します。
・指定した緯度経度地点に最も近い気象官署及び特別地域気象観測所を決定し、その地点の観測データを返します。
雨情報 1p
風情報 1p
気温情報 1p
日照情報 1p
日射量情報 1p
積雪情報 1p
気圧情報 1p
湿度情報 1p
視程情報 1p
6 プロフェッショナル版気象・天気予報データ配信機能 事前に登録した緯度経度地点の気象予報データ(伊藤忠テクノソリューションズ社提供)をREST APIで提供します。
・1時間ごとの72時間先の気象予報
気象・天気予報情報
※データ取得項目数によりません。
1p
7 管理API シークレットアクセスキー変更機能 接続時に利用するBASIC認証のシークレットアクセスキーを再取得します。
処理が成功した場合、次回以降のRESTアクセスから新しいシークレットアクセスキーでの認証となります。
シークレットアクセスキー変更 10p
※月3回以内の呼び出しについてptは加算しません。
8 利用状況確認機能 RESTアクセスした時点での本サービスの利用状況を返します。
月次でアクセス回数とptのサマリを返します。
利用状況確認 5p
※月31回以内の呼び出しについてptは加算しません。
9 APIダッシュボード 標準機能 本サービスの利用Pt履歴やその詳細の確認、およびシークレットアクセスキーの再発行機能を提供します。 - 0p
10 プロフェッショナル版気象・天気予報データ配信機能 プロフェッショナル版気象・天気予報データの利用のための事前地点登録を実施する機能を提供します。 地点マスタ維持
※1日あたり
10p
11 過去気象予報データ配信機能 指定した地点(緯度・経度)に一番近い地点の過去の気象予報(気象庁発表「メソ数値予報モデル」)、および太陽情報をAPIダッシュボードから一括ダウンロードすることが可能です。
・1時間ごとの気象予報、太陽情報
・2016年6月以降の過去データ(あらかじめ取得期間を指定する)
1日100地点あたりのデータ作成
※地点数は100地点単位でカウント
100p

<<データ配信サービストライアルの申込書はこちら>>

<<データ配信サービスの本申込書はこちら>>