詳細天気検索
API名:
pptenki/mesh
概要:
5kmメッシュ毎の詳細天気情報を取得します。
※現在、新規での利用受付を中止しております
※この機能を利用するには別途契約が必要です。
情報元について:
気象・防災情報元:株式会社東芝
このAPIが返却する上記情報は、情報元の提供規準に準拠します。
URI:
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/pptenki/mesh
<API使用例>
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/pptenki/mesh?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.6633583%2C139.7613555&timelater=3
リクエストパラメータ
| パラメータ | 必須 | デフォルト値 | 説明 |
|---|---|---|---|
| latlon | △ | - |
緯度経度 緯度経度を指定します。 llboundsとの同時指定はできません。 latlon,llboundsのどちらも指定していない場合、エラーとなります。 |
| llbounds | △ | - |
緯度経度矩形範囲 緯度経度矩形範囲を指定します。 latlonとの同時指定はできません。 latlon,llboundsのどちらも指定していない場合、エラーとなります。 |
| datetime | 現在日時 |
日時 天気を取得する日時をYYYYMMDDhhの形式で指定します。 最大で指定できるのは現在時間から48時間後までです。 現在日時より過去の日時は指定できません。 |
|
| timelater | 8 |
検索範囲時間 指定日時(datetime)から天気を取得する時間(n時間分)を指定します。 1～49の範囲で指定可能です。 ただし、最大で取得できるのは現在時間から49時間分です。 |
|
| datum | TOKYO |
測地系 入出力緯度経度の測地系を指定します。 |
出力データ
出力フォーマット
"text":"OK"},
"item":[{"area":{"sw":{"lat":35.65,
"lon":139.75},
"ne":{"lat":35.7,
"lon":139.8125}},
"center":{"lat":35.675,
"lon":139.78125},
"weatherData":[{"time":"201302181200",
"weather":{"code":"2",
"text":"雨"},
"detailWeather":{"code":"300",
"text":"雨"},
"temperature":4.9,
"wind":{"code":"1",
"text":"上"},
"windVelocity":2.5,
"rainfall":0.7,
"uv":{"code":"1",
"text":"弱い"},
"lightning":{"code":"0",
"text":"なし"},
"fog":{"code":"3",
"text":"雨"}},...]
}...]
}
| キー名 | データ型 | 説明 | |||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| status | object | ステータス情報が入ります。 | |||||||||||||||||||||||
| code | string |
ステータスコードが入ります。
|
|||||||||||||||||||||||
| text | string | ステータス内容に関するテキスト情報が入ります。 | |||||||||||||||||||||||
| item | array |
検索結果天気データの配列が入ります。 検索結果が0件の場合は空の配列となります。 |
|||||||||||||||||||||||
| area | object | 天気取得矩形範囲が入ります。 | |||||||||||||||||||||||
| center | object | 天気取得中心の緯度経度が入ります。 | |||||||||||||||||||||||
| weatherData | array |
天気データオブジェクトが入ります。 1時間毎の天気データの配列となります。 |
|||||||||||||||||||||||
| time | string | 予報に該当する日時(YYYYMMDDhhmm)が入ります。 | |||||||||||||||||||||||
| weather | object |
気象情報が入ります。 データが存在しない場合はNULLが入ります。 |
|||||||||||||||||||||||
| code | string |
気象情報コード(1桁)が入ります。
|
|||||||||||||||||||||||
| text | string | 気象情報が入ります。 | |||||||||||||||||||||||
| detailWeather | object |
気象詳細情報が入ります。 データが存在しない場合はNULLが入ります。 |
|||||||||||||||||||||||
| code | string | 気象詳細情報コード(3桁)が入ります。 | |||||||||||||||||||||||
| text | string | 気象詳細情報が入ります。 | |||||||||||||||||||||||
| temperature | number |
気温(単位:℃)が入ります。 データが存在しない場合はNULLが入ります。 |
|||||||||||||||||||||||
| wind | object |
風向きが入ります。 データが存在しない場合はNULLが入ります。 |
|||||||||||||||||||||||
| code | string |
風向きコードが入ります。 北を上とした風の方向を示します。
|
|||||||||||||||||||||||
| text | string | 風向きが入ります。 | |||||||||||||||||||||||
| windVelocity | number |
風速(単位:m/s)が入ります。 データが存在しない場合はNULLが入ります。 |
|||||||||||||||||||||||
| rainfall | number |
降水量(単位:mm/h)が入ります。 データが存在しない場合はNULLが入ります。 |
|||||||||||||||||||||||
| uv | object |
UV情報が入ります。 データが存在しない場合はNULLが入ります。 |
|||||||||||||||||||||||
| code | string |
UV情報コードが入ります。
|
|||||||||||||||||||||||
| text | string | UV情報が入ります。 | |||||||||||||||||||||||
| lightning | object |
落雷情報が入ります。 データが存在しない場合はNULLが入ります。 |
|||||||||||||||||||||||
| code | string |
落雷情報コードが入ります。
|
|||||||||||||||||||||||
| text | string | 落雷情報が入ります。 | |||||||||||||||||||||||
| fog | object |
霧情報が入ります。 データが存在しない場合はNULLが入ります。 |
|||||||||||||||||||||||
| code | string |
霧情報コードが入ります。
|
|||||||||||||||||||||||
| text | string | 霧情報が入ります。 | |||||||||||||||||||||||
出力例
[通常出力例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/pptenki/mesh?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.6633583%2C139.7613555&timelater=3
"text":"OK"},
"item":[{"area":{"sw":{"lat":35.65,
"lon":139.75},
"ne":{"lat":35.7,
"lon":139.8125}},
"center":{"lat":35.675,
"lon":139.78125},
"weatherData":[{"time":"201302181200",
"weather":{"code":"2",
"text":"雨"},
"detailWeather":{"code":"300",
"text":"雨"},
"temperature":4.9,
"wind":{"code":"1",
"text":"上"},
"windVelocity":2.5,
"rainfall":0.7,
"uv":{"code":"1",
"text":"弱い"},
"lightning":{"code":"0",
"text":"なし"},
"fog":{"code":"3",
"text":"雨"}},
{"time":"201302181300",
"weather":{"code":"2",
"text":"雨"},
"detailWeather":{"code":"300",
"text":"雨"},
"temperature":5.2,
"wind":{"code":"1",
"text":"上"},
"windVelocity":1,
"rainfall":0.6,
"uv":{"code":"1",
"text":"弱い"},
"lightning":{"code":"0",
"text":"なし"},
"fog":{"code":"3",
"text":"雨"}},
{"time":"201302181400",
"weather":{"code":"2",
"text":"雨"},
"detailWeather":{"code":"300",
"text":"雨"},
"temperature":5.8,
"wind":{"code":"5",
"text":"下"},
"windVelocity":2,
"rainfall":2.3,
"uv":{"code":"1",
"text":"弱い"},
"lightning":{"code":"0",
"text":"なし"},
"fog":{"code":"3",
"text":"雨"}}]}]}
[検索結果が0件の場合]
"text":"OK"},
"item":[]}