過去気象コンテンツ検索
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/2/26 10:00時点で2019/2/26 9:00のデータが取得可能 |
||||||||
| mode |
precipitation, weather, temperature |
出力項目 出力項目を指定します。複数値指定できます。
|
|||||||||
| datum | TOKYO |
測地系 入力緯度経度の測地系を指定します。 |
|||||||||
| llunit | dec |
緯度経度形式 緯度経度形式を指定します。 |
出力データ
出力フォーマット
"item":[{"precipitation":{"min":0,
"max":137,
"avg":17.8}
"weather":{"code":"3",
"text":"雨"}
"temperature":{"value":"20"}}]}
| キー名 | datatype | 説明 | ||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| status | string |
検索結果ステータスが入ります。
|
||||||||||||||
| item | array |
検索結果の配列が入ります。 検索結果が0件の場合、空の配列となります。 |
||||||||||||||
| precipitation | object | 250mメッシュ単位での降水量が入ります。 | ||||||||||||||
| min | number | 最小降水量が入ります。(単位:mm) | ||||||||||||||
| max | number | 最大降水量が入ります。(単位:mm) | ||||||||||||||
| avg | number | 平均降水量が入ります。(単位:mm) | ||||||||||||||
| weather | object | 1kmメッシュ単位での天気情報が入ります。 | ||||||||||||||
| code | string |
天気コードが入ります。
|
||||||||||||||
| 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
"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
"item":[]}