REST-API機能について

概要

 大気汚染物質について研究をおこなう者、また大気汚染測定データを利用するアプリ、新サービス等の開発をおこなう者に向けて
 提供するメタデータを二次利用し、研究等の効率化をおこなうために必要な各種情報を提供しています。

提供しているデータフォーマットおよび利用等に関する情報

 本サイトで提供している提供データの説明、利用方法等については、以下をご参照ください。
 ・ 提供データに関する説明(提供データ
 ・ 提供データの利用方法に関する説明(利用方法

提供データ

 本サイトでAPI提供している提供データの詳細については、以下をご参照ください。

提供データの著作権について

 ・ 本サイト上からAPIで取得するデータの著作権は、東京都が保有します。
 ・ その他、不明点があれば 東京都 環境局 環境改善部 大気保全課 までお問合せください。

提供データについて

 ・ 本サイト上からAPIで取得可能なデータは下記のとおりです。
    提供形式:CSV形式
    提供属性:下記の表に記載のとおり。

データ属性 パラメータ要素 内容
測定項目 ・なし ・要求に対して測定項目の情報を提供
測定局 ・年月(任意)
・測定項目コード(任意)
・年月、測定項目コードを指定して要求
 ※指定した測定項目を、指定した年月に測定している測定局の情報を提供
速報値 ・開始年月日時
・終了年月日時(任意)
・測定局コード
・測定項目コード
・開始/終了年月日時(最大1年分)、測定局コード、測定項目コードを指定して要求
・終了年月日時を指定しない場合、開始年月日時と同じ値となる
・1時間値(速報値)を提供
確定値 ・開始年月日時
・終了年月日時(任意)
・測定局コード
・測定項目コード
・開始/終了年月日時(最大1年分)、測定局コード、測定項目コードを指定して要求
・終了年月日時を指定しない場合、開始年月日時と同じ値となる
・1時間値(確定値)を提供
1分値 ・開始年月日時
・終了年月日時(任意)
・測定局コード
・測定項目コード
・開始/終了年月日時(最大1ヶ月分)、測定局コード、測定項目コードを指定して要求
・終了年月日時を指定しない場合、開始年月日時と同じ値となる
・1分値を提供


注意・制限事項

 (1) 本サイトで提供しているAPIで取得可能なデータのうち、速報値は、データ検証の結果、後日修正されることがあります。
   調査研究等でのデータ利用には確定値を入手されることをおすすめします。

 (2) APIの利用に関しては、多くの利用者に使用していただくため高頻度のアクセスを行うような利用はお控えください。
   他の利用者に影響があるような高頻度アクセスを検知した場合、リクエストを制限させていただく場合があります。

 (3) APIで取得可能なデータの期間は属性によって異なります。
   1分値:過去 2年間
   速報値:過去 2年間
   確定値:過去10年間

利用方法

1.測定項目データを取得する

 以下のURLによって測定項目データをCSV形式で取得できます。
  https://www.taiki.kankyo.metro.tokyo.lg.jp/taikikankyoapi/api/Mst/Item ※クリックするとCSVファイルがダウンロードされます。

 (1) データ仕様
   ファイルにはヘッダ行とデータ行が含まれます。
   ヘッダ行には、下表の項目が固定の文字列として出力されます。

項目 説明 最大桁数 備考
ITEMID 測定項目コード 3
,(カンマ) 区切り文字 1
SIMPLENAME 測定項目略称 12
,(カンマ) 区切り文字 1
ITEMNAME 測定項目名称 40
,(カンマ) 区切り文字 1
SCALE 測定項目のスケール 10 測定項目毎のスケール変換倍率(測定データは整数表示のため)
空の場合は変換不要
,(カンマ) 区切り文字 1
UNIT 測定項目の単位 10
[CR+LF] 改行コード 2


2.測定局データを取得する

 以下のパラメータを用いたURLによって測定局データをCSV形式で取得できます。
  https://www.taiki.kankyo.metro.tokyo.lg.jp/taikikankyoapi/api/Mst/Station ※クリックするとCSVファイルがダウンロードされます。

 (1) パラメータ一覧

パラメータ名称 URLに入力する名称 値の例 備考
測定年月 yyyymm <2023年11月を指定する場合>
202311
指定しない場合、要求時の年月を測定年月として要求される
測定項目コード itemid 001 指定しない場合、測定年月を考慮せずにすべての測定局データが要求される

 (2) URLの例 ※パラメータ指定あり
   https://www.taiki.kankyo.metro.tokyo.lg.jp/taikikankyoapi/api/Mst/Station?yyyymm=202311&itemid=001

 (3) データ仕様
   ファイルにはヘッダ行とデータ行が含まれます。
   ヘッダ行には、下表の項目が固定の文字列として出力されます。

項目 説明 最大桁数 備考
STATIONID 測定局コード 4
,(カンマ) 区切り文字 1
STATIONNAME 測定局名称 60
,(カンマ) 区切り文字 1
NORTH 緯度 10 ゼロパディングせずに値に応じて可変長で出力される
,(カンマ) 区切り文字 1
EAST 経度 10 ゼロパディングせずに値に応じて可変長で出力される
,(カンマ) 区切り文字 1
STATIONDIV 測定局区分 2 ゼロサプレスせずに固定の2桁で出力される
例:一般局(01)、自排局(02)、立体局(03)、大気局(04)
,(カンマ) 区切り文字 1
PREFCD 都道府県コード 2 ゼロサプレスせずに固定の2桁で出力される
例:東京都(13)
[CR+LF] 改行コード 2


3.測定データを取得する

 以下のパラメータを用いたURLによって測定データをCSV形式で取得できます。
  速報値 https://www.taiki.kankyo.metro.tokyo.lg.jp/taikikankyoapi/api/HourSokuho
  確定値 https://www.taiki.kankyo.metro.tokyo.lg.jp/taikikankyoapi/api/HourKakutei
  1分値 https://www.taiki.kankyo.metro.tokyo.lg.jp/taikikankyoapi/api/Minute

 (1) パラメータ一覧

パラメータ名称 URLに入力する名称 値の例 備考
開始年月日時 startdatetime 例1:
<2023年11月30日1時の1時間値を指定する場合>
2023113001

例2:
<2023年11月30日1時0分の1分値を指定する場合>
202311300100
・1時間値は10桁で指定
・1分値は12桁で指定

※データ取得可能期間
 1分値:過去 2年間
 速報値:過去 2年間
 確定値:過去10年間
終了年月日時 enddatetime 例1:
<2023年12月1日0時の1時間値を指定する場合>
2023113024

例2:
<2023年12月1日0時0分の1分値を指定する場合>
202311302400
・1時間値は10桁で指定
・1分値は12桁で指定
※指定しない場合、開始年月日時と同じ値が要求される
測定局コード stationid 例1:
0001,0002

例2:
all
・複数局を指定する場合はカンマ区切りする
・測定期間中の全局を指定する場合はallとする
 (大文字小文字は区別しない)
測定項目コード itemid 001

 (2) 測定局コード/測定項目コードの確認方法
    事前に「1.測定局データを取得する」および「2.測定項目データを取得する」を参照してデータを取得してください。

 (3) URLの例
   速報値 ※パラメータ指定あり
    https://www.taiki.kankyo.metro.tokyo.lg.jp/taikikankyoapi/api/HourSokuho
    ?startdatetime=2023113001
    &enddatetime=2023113024
    &stationid=0001
    &itemid=001

 (3) データ仕様
   ファイルにはヘッダ行とデータ行が含まれます。
   ヘッダ行には、下表の項目が固定の文字列として出力されます。

項目 説明 最大桁数 備考
STATIONID 測定局コード 4
,(カンマ) 区切り文字 1
ITEMID 測定項目コード 3
,(カンマ) 区切り文字 1
YEAR 測定年 4 ゼロサプレスせずに固定の4桁で出力される
,(カンマ) 区切り文字 1
MONTH 測定月 2 ゼロサプレスせずに固定の2桁で出力される
,(カンマ) 区切り文字 1
DAY 測定日 2 ゼロサプレスせずに固定の2桁で出力される
,(カンマ) 区切り文字 1
HOUR 測定時 2 ゼロサプレスせずに固定の2桁で出力される
,(カンマ) 区切り文字 1
MINUTE 測定分
2 ゼロサプレスせずに固定の2桁で出力される
※1分値の測定データの場合のみ出力される
,(カンマ) 区切り文字 1
VALUE 測定値 11 ゼロパディングせずに値に応じて可変長(整数)で出力される

・負の値である場合、先頭に"-"(マイナス)が付加される
・欠測の場合、"欠測"の文字が出力される
・未収集の場合、""(空欄)が出力される
・風向は16方位で出力される
 確定値の場合、16方位およびCALMで出力される
[CR+LF] 改行コード 2


利用される方の個人情報について

 (1) APIの利用に当たって
   利用される方のいかなる情報も提供していただくことなく、ご利用いただけます。
   また、個人情報の収集などは行いません。

 (2) 通信記録(アクセスログ)について
    本サイトのサーバ上に記録されたアクセスログについては、利用動向の調査(例:アクセス数の集計)など、
    本サイトのより良い運営のために使用することはありますが,これにより個人を特定することはありません。
    ただし、サーバに対する不正アクセス、Dos攻撃等があった場合等、
    警察等の公的機関から法令に基づいた情報提供を求められた場合はこの限りではありません。

ページの先頭へ