出力フォーマット
■検索タイプが予報検索の時
{"status":{"code":"0000",
"text":""},
"item":[{"type":"01",
"datetime":"20210322030000",
"latlon":{"lat":36.3968383,
"lon":140.2533028},
"precipitation":{"value":0},
"wind":{"EW":-0.65675735473633,
"NS":0.46897220611572,
"speed":0.80701000806019,
"direction":324.47042143024},
"temperature":{"value":10.068231201172}}]}
■検索タイプが現況検索の時
{"status":{"code":"0000",
"text":""},
"item":[{"type":"02",
"datetime":"20210324195500",
"latlon":{"lat":36.4736739,
"lon":140.1335411},
"precipitation":{"value":0},
"weather":{"code":1,
"text":"晴れ"},
"temperature":{"value":13}}]}
■検索タイプが過去検索の時
{"status":{"code":"0000",
"text":""},
"item":[{"type":"03",
"datetime":"20210321150000",
"latlon":{"lat":36.4736739,
"lon":140.1335411},
"precipitation":{"min":0,
"max":0.35,
"avg":0.1},
"weather":{"code":3,
"text":"雨"},
"temperature":{"value":17}}]}
|
キー名 |
datatype |
説明 |
|---|
|
status |
|
|
object |
検索結果ステータスが入ります。
|
|
|
code |
|
string |
ステータスコードが入ります。 |
|
|
text |
|
string |
ステータス内容に関するテキスト情報が入ります。 |
|
item |
|
|
array |
検索結果オブジェクトの配列が入ります。
検索結果が0件の場合、空の配列となります。 |
|
|
type |
|
string |
どのタイプの検索が実行されたかの結果が入ります。
|
|
|
datetime |
|
string |
情報の参照日時が入ります。
検索タイプによって参照日時は異なります。
|
予報 |
情報元データの参照日時 |
|
現況 |
情報元データの参照日時
(降水量検索を実施しない場合、サーバの現在時刻から分秒を0埋めした日時) |
|
過去 |
リクエストパラメータ日時(datetime)から分秒を0埋めした日時 |
|
|
|
latlon |
|
object |
緯度経度が入ります。
過去・現況の場合、パラメータ指定したものと同じ値が格納されます。
予報の場合、近傍の提供データの地点座標を返却します。
近傍の提供データが複数点ある場合は、最も緯度経度の小さいものを返します。 |
|
|
precipitation※ |
|
object |
※検索タイプが現況または予報の場合に出力します。
降水量のオブジェクトが入ります。
検索タイプが過去の場合は出力されません。 |
|
|
|
value |
number |
降水量、積算降水量が入ります。(単位:mm/h)
現況検索の場合は250mメッシュ単位での降水量、
予報検索の場合は20kmメッシュ単位での積算降水量が入ります。 |
|
|
precipitation※ |
|
object |
※検索タイプが過去の場合に出力します。
降水量のオブジェクトが入ります。
250mメッシュ単位での降水量が入ります。
検索タイプが現況・予報の場合は出力されません。 |
|
|
|
min |
number |
最小降水量が入ります。(単位:mm/h) |
|
|
|
max |
number |
最大降水量が入ります。(単位:mm/h) |
|
|
|
avg |
number |
平均降水量が入ります。(単位:mm/h) |
|
|
weather※ |
|
object |
※検索タイプが過去・現況の場合に出力します。
1kmメッシュ単位での天気情報のオブジェクトが入ります。 |
|
|
|
code |
string |
天気コードが入ります。
|
0 |
資料無し |
|
1 |
晴れ |
|
2 |
くもり |
|
3 |
雨 |
|
4 |
雨または雪 |
|
5 |
雪 |
|
|
|
|
text |
string |
天気テキストが入ります。 |
|
|
temperature |
|
object |
1kmメッシュ単位での気温情報が入ります。 |
|
|
|
value |
number |
気温が入ります。範囲は-50.0から50.0です。(単位：代表値℃) |
|
|
wind※ |
|
object |
※検索タイプが予報の場合に出力します。
風量のオブジェクトが入ります。 |
|
|
|
EW |
number |
風の東西成分が入ります。(単位:m/s) |
|
|
|
NS |
number |
風の南北成分が入ります。(単位:m/s) |
|
|
|
speed |
number |
風速が入ります。(単位:m/s) |
|
|
|
direction |
string |
風向が入ります。(単位:deg) |
出力例
[通常出力例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/jmbsc/weather?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=36.473674,140.133541
{"status":{"code":"0000",
"text":""},
"item":[{"type":"02",
"datetime":"20210324200000",
"latlon":{"lat":36.4736739,
"lon":140.1335411},
"precipitation":{"value":0},
"weather":{"code":1,
"text":"晴れ"},
"temperature":{"value":13}}]}
[検索結果が0件の場合]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/jmbsc/weather?
if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=36.473674,140.133541
&datetime=2016101010&mode=precipitation,weather,temperature
{"status":{"code":"0000",
"text":""},
"item":{"type":"03",
"datetime":"20210317150000",
"latlon":null,
"precipitation":null,
"weather":null,
"temperature":null}}