気象コンテンツ検索

API名: 
jmbsc/weather
概要: 

指定した緯度経度から予報・現況・過去の気象コンテンツ各データを検索します。
降水量・天気情報・風量・気温が検索可能です。

【参考】検索タイプについて
入力された時刻により、検索タイプが以下に切り替わります。

検索タイプ 特徴 対応データ
降水量 天気情報 風量 気温
過去検索 過去の時刻から各気象情報を検索します。 ×
現況検索 現在の時刻の各気象情報を検索します。 ×
予報検索 現在時刻より1時間以上後の時刻の気象情報を予報として検索します。 ×

【参考】過去・現況検索時の保存データ・使用データについて  
 高解像度降水ナウキャスト  
 https://www.jma.go.jp/jma/kishou/know/kurashi/highres_nowcast.html  

 推計気象分布(天気/気温)  
 https://www.jma.go.jp/jma/kishou/know/suikei_kishou/kaisetsu.html

【参考】予報検索時の使用データについて  
 全球数値予報モデルGPV(GSM日本域)  
 https://www.data.jma.go.jp/add/suishin/cgi-bin/catalogue/make_product_page.cgi?id=ZenModel  

※過去、現況検索の場合、データをアーカイブから取得するため
 1リクエストにつき 20~40秒程度かかる場合があります。

※この機能を利用するには別途契約が必要です。

URI: 

https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/jmbsc/weather

<API使用例>
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

リクエストパラメータ
パラメータ 必須 デフォルト値 説明
latlon - 緯度経度
緯度経度を指定します。1点のみ指定可能です。
複数件指定した場合、エラーとなります。
datetime   日時
日時を指定します。分・秒の指定は無視されます。
指定した時間によって、予報・現況・過去検索が自動で切り替わります。
取得単位は1時間単位で、時を省略した場合は00時扱いになります。
※未指定の場合、現況検索が実行されます。
指定可能な値は以下の通りです。
  日時 備考
過去 現在時刻から1時間以上前の日時 2019年1月16日00時(値:2019011600)より前の値は取得できません。
現況 現在時刻から1時間前後の日時 アーカイブ取得の都合によりリクエストタイミングによって1時間前後となります。
予報 現在時刻から1時間以上先の日時 現在時刻から73時間以上先の時刻になる場合、エラーとなります。

例:2021/2/26 10:00時点で指定可能な値
2021022609      :過去検索
2021022610または未指定:現況検索
2021022810      :予報検索

mode   precipitation,
weather,
wind,
temperature
出力項目
出力項目を指定します。複数値指定できます。
指定値 説明
precipitation 降水量
weather 天気情報
※予報検索時は無効、予報検索時にweatherのみ指定した場合、デフォルト値となります。
wind 風量
※現況・過去検索時は無効、現況・過去検索時にwindのみ指定した場合、デフォルト値となります。
temperature 気温
datum   TOKYO 測地系
入力緯度経度の測地系を指定します。
llunit   dec 緯度経度形式
緯度経度形式を指定します。

出力データ
出力フォーマット

■検索タイプが予報検索の時

{"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 検索結果ステータスが入ります。
0000 正常に検索が行われたことを示します。
  code   string ステータスコードが入ります。
  text   string ステータス内容に関するテキスト情報が入ります。
item     array 検索結果オブジェクトの配列が入ります。
検索結果が0件の場合、空の配列となります。
  type   string どのタイプの検索が実行されたかの結果が入ります。
01 予報
02 現況
03 過去
  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}}