premium
search_weather_info

気象コンテンツ検索[天気情報]

指定した緯度経度から降水量、天気情報、風量、気温を取得します。
予報・現況・過去情報について検索が可能です(※)。
時間が未指定の場合は、現況情報が検索されます。
※予報検索時の天気情報、現況・過去検索時の風量は無効となります。


【情報元について】気象業務支援センター

  • 全球数値予報モデルＧＰＶ(ＧＳＭ日本域)
  • 高解像度降水ナウキャスト
  • 推計気象分布

https://[domain]/search/weather/search_weather_info

HTTP request method

POST/GET

ContentType

application/x-www-form-urlencoded

Parameters

*requiredは必須
Array型のパラメータの区切り文字は特記のない限りカンマ(,)およびセミコロン(;)です。

名前 説明
position*required
array[number]		 入力緯度経度
1座標のみ指定可能です。
経度、緯度の順に座標をカンマ区切りで指定してください。
単位は10進度です。
datetime
string		 参照日時
指定した時間によって、予報・現況・過去検索が自動で切り替わります。
取得単位は1時間単位で、時を省略した場合は00時扱いになります。
※未指定の場合、現況検索が実行されます。
フォーマットは"yyyymmddhh"または"yyyymmdd"です。

過去:2021年8月23日00時～現在時刻の1時間以上前の日時を指定する
現況:現在時刻日時を指定する または 何も指定しない
予報:現在時刻の1時間以上先～73時間未満先の日時を指定する

例:2021/10/06 10:00時点で指定可能な値
2021100609　　　　　　:過去検索
2021100610または未指定:現況検索
2021100611　　　　　　:予報検索
※ただしリクエストタイミングによっては条件が1時間前後する場合があります。
mode
string
default precipitation,weather,wind,temperature
precipitation
降水量
weather
天気情報※予報検索時は無効、予報検索時にweatherのみ指定した場合、デフォルト値となる。
wind
風量※現況・過去検索時は無効、現況・過去検索時にwindのみ指定した場合、デフォルト値となる。
temperature
気温
datum
string
default JGD		 入出力座標の測地系を指定
JGD
世界測地系
TOKYO
日本測地系
TOKYO_NAVI
日本測地系(ゼンリン ナビ地図)

Responses

エラーについては「エラーメッセージ一覧」を参照してください。

Media type:application/json

キー名 説明
status
string
 		ステータス
result
info hit
integer
 件数
item
type
string
 検索タイプ
  • 01

    予報

  • 02

    現況

  • 03

    過去
datetime
string
 参照日時
予報 情報元データの参照日時
現況 情報元データの参照日時
(降水量検索を実施しない場合、サーバーの現在時刻から分秒を0埋めした日時)
過去 リクエストパラメータ日時(datetime)から分秒を0埋めした日時
latlon
lon
number
 経度
lat
number
 緯度
precipitation 降水量のオブジェクト
min
number
 最小降水量が入る。(単位:mm/h)
検索タイプが過去の場合に出力)
250mメッシュ単位での降水量が入ります。
max
number
 最大降水量が入る。(単位:mm/h)
検索タイプが過去の場合に出力
250mメッシュ単位での降水量が入ります。
avg
number
 平均降水量が入る。(単位:mm/h)
検索タイプが過去の場合に出力
250mメッシュ単位での降水量が入ります。
value
number
 降水量、積算降水量が入る。(単位:mm/h)
検索タイプが現況または予報の場合に出力
現況検索の場合は250mメッシュ単位での降水量、
予報検索の場合は13kmメッシュ単位での積算降水量が入ります。
weather ※検索タイプが過去・現況の場合に出力。
1kmメッシュ単位での天気情報のオブジェクト
code
integer
 天気コード
  • 0

    資料無し

  • 1

    晴れ

  • 2

    くもり

  • 3

    雨

  • 4

    雨または雪

  • 5

    雪
text
string
 天気テキスト
temperature 1kmメッシュ単位での気温情報
value
number
 気温、範囲は-50.0から50.0(単位:代表値℃)
wind ※検索タイプが予報の場合に出力。
風量のオブジェクト
EW
number
 風の東西成分(単位:m/s)
NS
number
 風の南北成分(単位:m/s)
speed
number
 風速(単位:m/s)
direction
number
 風向(単位:deg)

Example

リクエストURL 
https://[domain]/search/weather/search_weather_info?position=140.08785,36.10377&mode=precipitation%2Cweather%2Cwind%2Ctemperature&datum=JGD
 レスポンス 
{
  "status": "OK",
  "result": {
    "info": {
      "hit": 1
    },
    "item": [
      {
        "type": "02",
        "datetime": "20211006174000",
        "latlon": {
          "lon": 140.08785,
          "lat": 36.10377
        },
        "precipitation": {
          "value": 0
        },
        "weather": {
          "code": 1,
          "text": "晴れ"
        },
        "temperature": {
          "value": 20
        }
      }
    ]
  },
  ...
}