過去気象コンテンツ検索

API名: 
pasttenki
概要: 

指定した緯度経度から過去の気象コンテンツ各データを検索します。
降水量・天気情報・気温が検索可能です。
指定できる時刻は現在時刻から一時間以上前の時刻です。

※データをアーカイブから取得するため 1リクエストにつき 20～40秒程度かかる場合があります。
※この機能を利用するには別途契約が必要です。

情報元について:
気象情報元：気象業務支援センター

　高解像度降水ナウキャスト
　https://www.jma.go.jp/jma/kishou/know/kurashi/highres_nowcast.html 　

　推計気象分布(天気/気温)
　https://www.jma.go.jp/jma/kishou/know/suikei_kishou/kaisetsu.html

このAPIが返却する上記情報は、情報元の提供規準に準拠します。

URI: 

https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/pasttenki

<API使用例>
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/pasttenki?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=36.473674,140.133541&datetime=2018092510

リクエストパラメータ
パラメータ 必須 デフォルト値 説明
latlon ○ - 緯度経度
緯度経度を指定します。1点のみ指定可能です。
複数件指定した場合、エラーとなります。
datetime ○ - 日時
日時を指定します。分・秒の指定は無視されます。
時を省略した場合は00時になります。
指定可能な値は以下の通りです。
取得可能期間 「2019/1/16 00:00(値:2019011600)」~
「現在時刻の一時間前」
取得単位 一時間単位

例：2019/2/26 10:00時点で2019/2/26 9:00のデータが取得可能
mode   precipitation,
weather,
temperature		 出力項目
出力項目を指定します。複数値指定できます。
指定値 説明
precipitation 降水量
weather 天気情報
temperature 気温
datum   TOKYO 測地系
入力緯度経度の測地系を指定します。
llunit   dec 緯度経度形式
緯度経度形式を指定します。

出力データ
出力フォーマット
{"status":"OK",
 "item":[{"precipitation":{"min":0,
                           "max":137,
                           "avg":17.8}
          "weather":{"code":"3",
                     "text":"雨"}
          "temperature":{"value":"20"}}]}
キー名 datatype 説明
status     string 検索結果ステータスが入ります。
OK 正常に検索が行われたことを示します。
item     array 検索結果の配列が入ります。
検索結果が0件の場合、空の配列となります。
  precipitation   object 250mメッシュ単位での降水量が入ります。
    min number 最小降水量が入ります。(単位:mm)
    max number 最大降水量が入ります。(単位:mm)
    avg number 平均降水量が入ります。(単位:mm)
  weather   object 1kmメッシュ単位での天気情報が入ります。
    code string 天気コードが入ります。
0 資料無し
1 晴れ
2 くもり
3 雨
4 雨または雪
5 雪
    text string 天気テキストが入ります。
  temperature   object 1kmメッシュ単位での気温情報が入ります。
    value string 気温が入ります。範囲は-50.0から50.0です。(単位：代表値℃)

出力例

[通常出力例]

https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/pasttenki?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=36.473674,140.133541&datetime=2018092510
{"status":"OK",
 "item":[{"precipitation":{"min":0,
                           "max":2,
                           "avg":0.2}
          "weather":{"code":"3",
                     "text":"雨"}
          "temperature":{"value":"20"}}]}

[検索結果が0件の場合]

https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/pasttenki?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=36.473674,140.133541&datetime=2017080100
{"status":"OK",
 "item":[]}