過去天気検索(降水量・天気情報・気温)

API名: 
pasttenki
概要: 

指定した緯度経度から過去の天気データ(降水量・天気情報・気温)を取得します。
指定できる時刻は現在時刻から一時間以上前の時刻です。
データをアーカイブから取得するため 1リクエストにつき 20~40秒程度かかる場合があります。

※開発中の機能です。
※この機能を利用するには別途契約が必要です。

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時になります。
指定可能な値は以下の通りです。
2019011600から一時間単位かつ、
現在日時から一時間前まで

例:2019/2/26 10:00時点で2019/2/26 9:00のデータが取得可能

mode   precipitation,
weather,
temperature
出力項目
出力項目を指定します。複数値指定できます。
指定値 説明
precipitation 降水量
weather 天気情報
temperature 気温
datum   TOKYO 測地系
入力緯度経度の測地系を指定します。

出力データ
出力フォーマット
{"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 最小降水量が入ります。(単位:ミリメートル)
    max number 最大降水量が入ります。(単位:ミリメートル)
    avg number 平均降水量が入ります。(単位:ミリメートル)
  weather   object 1kmメッシュ単位での天気情報が入ります。
    code string 天気コードが入ります。
0 資料無し
1 晴れ
2 くもり
3
4 雨または雪
5
    text string 天気テキストが入ります。
  temperature   object 1kmメッシュ単位での気温情報が入ります。
    value number 気温が入ります。範囲は-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":[]}