premiumsearch_weather_detail_info
気象コンテンツ検索[詳細天気予報]
指定した緯度経度や住所コード、指定情報から詳細天気情報を取得します。
指定情報によって、最大で明後日までの気象情報を取得します。
今日明日については3時間毎の天気、3時間降水量階級値/降雪量階級値、最高気温、最低気温、風向、風速など詳細情報が取得可能です。
より詳細なメッシュ単位(5km)の気象情報から広域エリア(1次細分区域)の気象情報まで検索可能です。
【情報元について】気象業務支援センター
- 天気分布予報
- 府県天気予報／地域時系列予報(Ｒ１)
HTTP request method
POST/GET
ContentType
application/x-www-form-urlencoded
Parameters
*requiredは必須
Array型のパラメータの区切り文字は特記のない限りカンマ(,)およびセミコロン(;)です。
| 名前 | 説明 |
|---|---|
| position array[number] |
入力緯度経度 1座標のみ指定可能です。 経度、緯度の順に座標をカンマ区切りで指定してください。 単位は10進度です。 position,address_codeは何れか1つ必須です。 |
| address_code string |
住所コードを指定 前方一致で市区町村コードまで指定可能です。 コロン区切り複数指定可能です。(最大10件) 例:"11110:41100:31211" position,address_codeは何れか1つ必須です。 |
| timefrom string |
予報開始時刻指定フィルタリング レスポンスの予報開始時刻(forecast_from)が指定値"以降"の結果を取得します。(指定日含む) 未指定の場合、予報開始時刻でのフィルタリングは行いません。 取得できるのは今日明日明後日の情報のみです。 フォーマットは"yyyymmddhh"です。 例:2020100909 |
| timeto string |
予報終了時刻指定フィルタリング レスポンスの予報終了時刻(forecast_to)が指定値"以前"の結果を取得します。(指定日含む) 未指定の場合、予報終了時刻でのフィルタリングは行いません。 取得できるのは今日明日明後日の情報のみです。 フォーマットは"yyyymmddhh"です。 例:2020100921 |
| search_type*required integer default 0 |
検索種別
|
| datum string default JGD |
入出力座標の測地系を指定 JGD
世界測地系
TOKYO
日本測地系
TOKYO_NAVI
日本測地系(ゼンリン ナビ地図)
|
Responses
エラーについては「エラーメッセージ一覧」を参照してください。
Media type:application/json
| キー名 | 説明 | ||||
|---|---|---|---|---|---|
|
|
ステータス | ||||
|
|
|||||
|
|
今日明日3時間毎のメッシュ地点のデータ | ||||
| ref_file_nm string |
参照ファイル情報 | ||||
| report_datetime string |
発表時刻 | ||||
|
|
近傍参照緯度経度情報 | ||||
| lon number |
経度 | ||||
| lat number |
緯度 | ||||
|
|
天気データ | ||||
| forecast_from string |
予報開始時刻 | ||||
| forecast_to string |
予報終了時刻 | ||||
| weather_cd string |
メッシュ地点の天気コード
|
||||
| weather_nm string |
メッシュ地点の天気名 | ||||
| temperature_from string |
気温 | ||||
| precipLevel string |
3時間降水量階級
|
||||
| snowLevel string |
3時間降雪量階級
|
||||
| minTemperature number |
最低気温 | ||||
| maxTemperature number |
最高気温 | ||||
|
|
今日明日3時間毎の細分区域のデータ | ||||
| ref_file_nm string |
参照ファイル情報 | ||||
| pub_office string |
気象台名 | ||||
| report_datetime string |
発表時刻 | ||||
| pref_cd string |
都道府県コード | ||||
| pref_nm string |
都道府県名 | ||||
| area_cd string |
細分区域コード | ||||
| area_nm string |
細分区域名 | ||||
| rep_point | 細分区域経度緯度 | ||||
| lon number |
経度 | ||||
| lat number |
緯度 | ||||
|
array[object] |
エリア配下の市区町村情報 | ||||
| city_cd string |
市区町村コード | ||||
| city_nm string |
市区町村名 | ||||
|
|
エリア配下の市区町村情報 | ||||
| forecast_from string |
予報開始時刻 | ||||
| forecast_to string |
予報終了時刻 | ||||
| weather_cd string |
天気コード
|
||||
| weather_nm string |
天気名 | ||||
| wind_direct_cd string |
風向コード
|
||||
| wind_direct_nm string |
風向名 | ||||
| wind_direct_degree string |
風向度 | ||||
| wind_direct_radian string |
風向ラジアン | ||||
| wind_speed_level string |
風速階級
|
||||
|
|
気温予報点情報 | ||||
| temperature_station_cd string |
気温予報点コード | ||||
| temperature_station_nm string |
気温予報点名 | ||||
| temperature_from number |
気温 | ||||
| minTemperature number |
朝の最低気温 | ||||
| maxTemperature number |
日中の最高気温 | ||||
| precipChance string |
降水確率 | ||||
| precipChanceCondtion string |
降水の状態 | ||||
|
|
今日明日明後日の1日毎の細分区域単位のデータ | ||||
| ref_file_nm string |
参照ファイル情報 | ||||
| pub_office string |
気象台名 | ||||
| report_datetime string |
発表時刻 | ||||
| pref_cd string |
都道府県コード | ||||
| pref_nm string |
都道府県名 | ||||
| area_cd string |
細分区域コード | ||||
| area_nm string |
細分区域名 | ||||
| rep_point | 細分区域経度緯度 | ||||
| lon number |
経度 | ||||
| lat number |
緯度 | ||||
| city_info array[object] |
エリア配下の市区町村情報 | ||||
|
|
天気データ | ||||
| forecast_date string |
予報日 | ||||
| weather_cd string |
天気コード
|
||||
| weather_nm string |
天気名 | ||||
| weather_text string |
天気電文 | ||||
| wind_direct_cd string |
風向コード
|
||||
| wind_speed_level string |
風速階級
|
||||
| wave_height_num string |
波高(単位:m) | ||||
| wave_height_to_num string |
遷移先、波高 | ||||
| wave_text string |
波高電文 | ||||
|
|
気温予報点情報 | ||||
| temperature_station_cd string |
気温予報点コード | ||||
| temperature_station_nm string |
気温予報点名 | ||||
| minTemperature number |
最低気温※明後日分はデータなし | ||||
| maxTemperature number |
最高気温※明後日分はデータなし | ||||
Example
https://[domain]/search/weather/search_weather_detail_info?position=130.90815481698561,33.74234273474346&search_type=0&datum=JGD
{
"status": "OK",
"result": {
"mesh_weather": [
{
"ref_file_nm": "Z__C_RJTD_20211006080000_MET_GPV_Gll5km_Jtenkibunpu_FH01-31_NJ000n00_grib2.bin",
"report_datetime": "2021-10-06 17:00:00",
"ref_point": {
"lon": 130.90625,
"lat": 33.725
},
"weather_data": [
{
"forecast_from": "2021-10-06 18:00:00",
"forecast_to": "2021-10-06 21:00:00",
"weather_cd": "1",
"weather_nm": "晴れ",
"temperature_from": "23.85",
"precipLevel": "0",
"snowLevel": "0",
"minTemperature": null,
"maxTemperature": null
},
{
"forecast_from": "2021-10-06 21:00:00",
"forecast_to": "2021-10-07 00:00:00",
"weather_cd": "1",
"weather_nm": "晴れ",
"temperature_from": "19.85",
"precipLevel": "0",
"snowLevel": "0",
"minTemperature": null,
"maxTemperature": null
},
{
"forecast_from": "2021-10-07 00:00:00",
"forecast_to": "2021-10-07 03:00:00",
"weather_cd": "1",
"weather_nm": "晴れ",
"temperature_from": "17.85",
"precipLevel": "0",
"snowLevel": "0",
"minTemperature": 14.85,
"maxTemperature": null
},
{
"forecast_from": "2021-10-07 03:00:00",
"forecast_to": "2021-10-07 06:00:00",
"weather_cd": "1",
"weather_nm": "晴れ",
"temperature_from": "15.85",
"precipLevel": "0",
"snowLevel": "0",
"minTemperature": 14.85,
"maxTemperature": null
},
{
"forecast_from": "2021-10-07 06:00:00",
"forecast_to": "2021-10-07 09:00:00",
"weather_cd": "1",
"weather_nm": "晴れ",
"temperature_from": "14.85",
"precipLevel": "0",
"snowLevel": "0",
"minTemperature": 14.85,
"maxTemperature": null
},
{
"forecast_from": "2021-10-07 09:00:00",
"forecast_to": "2021-10-07 12:00:00",
"weather_cd": "1",
"weather_nm": "晴れ",
"temperature_from": "22.85",
"precipLevel": "0",
"snowLevel": "0",
"minTemperature": null,
"maxTemperature": 27.85
},
{
"forecast_from": "2021-10-07 12:00:00",
"forecast_to": "2021-10-07 15:00:00",
"weather_cd": "1",
"weather_nm": "晴れ",
"temperature_from": "26.85",
"precipLevel": "0",
"snowLevel": "0",
"minTemperature": null,
"maxTemperature": 27.85
},
{
"forecast_from": "2021-10-07 15:00:00",
"forecast_to": "2021-10-07 18:00:00",
"weather_cd": "1",
"weather_nm": "晴れ",
"temperature_from": "26.85",
"precipLevel": "0",
"snowLevel": "0",
"minTemperature": null,
"maxTemperature": 27.85
},
{
"forecast_from": "2021-10-07 18:00:00",
"forecast_to": "2021-10-07 21:00:00",
"weather_cd": "1",
"weather_nm": "晴れ",
"temperature_from": "22.85",
"precipLevel": "0",
"snowLevel": "0",
"minTemperature": null,
"maxTemperature": null
},
{
"forecast_from": "2021-10-07 21:00:00",
"forecast_to": "2021-10-08 00:00:00",
"weather_cd": "1",
"weather_nm": "晴れ",
"temperature_from": "19.85",
"precipLevel": "0",
"snowLevel": "0",
"minTemperature": null,
"maxTemperature": null
},
{
"forecast_from": "2021-10-08 00:00:00",
"forecast_to": "2021-10-08 03:00:00",
"weather_cd": null,
"weather_nm": null,
"temperature_from": "18.85",
"precipLevel": null,
"snowLevel": null,
"minTemperature": null,
"maxTemperature": null
}
]
}
],
"area_3h_weather": [
{
"ref_file_nm": "VPFD51_JPFK_060800_02_202110060733281_001.xml",
"pub_office": "福岡管区気象台",
"report_datetime": "2021-10-06 17:00:00",
"pref_cd": "40",
"pref_nm": "福岡県",
"area_cd": "400020",
"area_nm": "北九州地方",
"rep_point": {
"lon": 130.90815481698561,
"lat": 33.74234273474346
},
"city_info": [
{
"city_cd": "40642",
"city_nm": "築上郡吉富町"
},
{
"city_cd": "40621",
"city_nm": "京都郡苅田町"
},
{
"city_cd": "40625",
"city_nm": "京都郡みやこ町"
},
{
"city_cd": "40105",
"city_nm": "北九州市戸畑区"
},
{
"city_cd": "40101",
"city_nm": "北九州市門司区"
},
{
"city_cd": "40103",
"city_nm": "北九州市若松区"
},
{
"city_cd": "40106",
"city_nm": "北九州市小倉北区"
},
{
"city_cd": "40107",
"city_nm": "北九州市小倉南区"
},
{
"city_cd": "40108",
"city_nm": "北九州市八幡東区"
},
{
"city_cd": "40109",
"city_nm": "北九州市八幡西区"
},
{
"city_cd": "40213",
"city_nm": "行橋市"
},
{
"city_cd": "40214",
"city_nm": "豊前市"
},
{
"city_cd": "40215",
"city_nm": "中間市"
},
{
"city_cd": "40381",
"city_nm": "遠賀郡芦屋町"
},
{
"city_cd": "40646",
"city_nm": "築上郡上毛町"
},
{
"city_cd": "40647",
"city_nm": "築上郡築上町"
},
{
"city_cd": "40383",
"city_nm": "遠賀郡岡垣町"
},
{
"city_cd": "40384",
"city_nm": "遠賀郡遠賀町"
},
{
"city_cd": "40382",
"city_nm": "遠賀郡水巻町"
}
],
"weather_data": [
{
"forecast_from": "2021-10-07 21:00:00",
"forecast_to": "2021-10-08 00:00:00",
"weather_cd": "100",
"weather_nm": "晴れ",
"wind_direct_cd": "300",
"wind_direct_nm": "南",
"wind_direct_degree": "180",
"wind_direct_radian": "3.141592654",
"wind_speed_level": "1",
"temperature_station_info": {
"temperature_station_cd": "82056",
"temperature_station_nm": "八幡",
"temperature_from": 23,
"minTemperature": 19,
"maxTemperature": 29
},
"precipChance": "0",
"precipChanceCondtion": "雨"
},
{
"forecast_from": "2021-10-07 18:00:00",
"forecast_to": "2021-10-07 21:00:00",
"weather_cd": "100",
"weather_nm": "晴れ",
"wind_direct_cd": "100",
"wind_direct_nm": "北",
"wind_direct_degree": "360",
"wind_direct_radian": "6.283185307",
"wind_speed_level": "1",
"temperature_station_info": {
"temperature_station_cd": "82056",
"temperature_station_nm": "八幡",
"temperature_from": 25,
"minTemperature": 19,
"maxTemperature": 29
},
"precipChance": "0",
"precipChanceCondtion": "雨"
},
{
"forecast_from": "2021-10-07 15:00:00",
"forecast_to": "2021-10-07 18:00:00",
"weather_cd": "100",
"weather_nm": "晴れ",
"wind_direct_cd": "100",
"wind_direct_nm": "北",
"wind_direct_degree": "360",
"wind_direct_radian": "6.283185307",
"wind_speed_level": "2",
"temperature_station_info": {
"temperature_station_cd": "82056",
"temperature_station_nm": "八幡",
"temperature_from": 27,
"minTemperature": 19,
"maxTemperature": 29
},
"precipChance": "0",
"precipChanceCondtion": "雨"
},
{
"forecast_from": "2021-10-07 12:00:00",
"forecast_to": "2021-10-07 15:00:00",
"weather_cd": "100",
"weather_nm": "晴れ",
"wind_direct_cd": "100",
"wind_direct_nm": "北",
"wind_direct_degree": "360",
"wind_direct_radian": "6.283185307",
"wind_speed_level": "2",
"temperature_station_info": {
"temperature_station_cd": "82056",
"temperature_station_nm": "八幡",
"temperature_from": 28,
"minTemperature": 19,
"maxTemperature": 29
},
"precipChance": "0",
"precipChanceCondtion": "雨"
},
{
"forecast_from": "2021-10-07 09:00:00",
"forecast_to": "2021-10-07 12:00:00",
"weather_cd": "100",
"weather_nm": "晴れ",
"wind_direct_cd": "300",
"wind_direct_nm": "南",
"wind_direct_degree": "180",
"wind_direct_radian": "3.141592654",
"wind_speed_level": "1",
"temperature_station_info": {
"temperature_station_cd": "82056",
"temperature_station_nm": "八幡",
"temperature_from": 24,
"minTemperature": 19,
"maxTemperature": 29
},
"precipChance": "0",
"precipChanceCondtion": "雨"
},
{
"forecast_from": "2021-10-07 06:00:00",
"forecast_to": "2021-10-07 09:00:00",
"weather_cd": "100",
"weather_nm": "晴れ",
"wind_direct_cd": "300",
"wind_direct_nm": "南",
"wind_direct_degree": "180",
"wind_direct_radian": "3.141592654",
"wind_speed_level": "1",
"temperature_station_info": {
"temperature_station_cd": "82056",
"temperature_station_nm": "八幡",
"temperature_from": 19,
"minTemperature": 19,
"maxTemperature": 29
},
"precipChance": "0",
"precipChanceCondtion": "雨"
},
{
"forecast_from": "2021-10-07 03:00:00",
"forecast_to": "2021-10-07 06:00:00",
"weather_cd": "100",
"weather_nm": "晴れ",
"wind_direct_cd": "300",
"wind_direct_nm": "南",
"wind_direct_degree": "180",
"wind_direct_radian": "3.141592654",
"wind_speed_level": "1",
"temperature_station_info": {
"temperature_station_cd": "82056",
"temperature_station_nm": "八幡",
"temperature_from": 20,
"minTemperature": 19,
"maxTemperature": 29
},
"precipChance": "0",
"precipChanceCondtion": "雨"
},
{
"forecast_from": "2021-10-07 00:00:00",
"forecast_to": "2021-10-07 03:00:00",
"weather_cd": "100",
"weather_nm": "晴れ",
"wind_direct_cd": "300",
"wind_direct_nm": "南",
"wind_direct_degree": "180",
"wind_direct_radian": "3.141592654",
"wind_speed_level": "1",
"temperature_station_info": {
"temperature_station_cd": "82056",
"temperature_station_nm": "八幡",
"temperature_from": 21,
"minTemperature": 19,
"maxTemperature": 29
},
"precipChance": "0",
"precipChanceCondtion": "雨"
}
]
}
],
"area_day_weather": null
},
...
}