指定地点の短期天気データ取得

API名: 

weather/short

概要: 

リクエストパラメータで指定される緯度経度の短期天気データを取得します。
短期天気とは天気発表日時から2日間の天気情報です。
天気データはアメダスの単位(5kmメッシュ)で整備されています。

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

情報元について:
気象情報元:株式会社ポッケ
このAPIが返却する上記情報は、情報元の提供規準に準拠します。

URI: 

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

<API使用例>
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/weather/short?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.2414902,139.1315686&ssl=F

リクエストパラメータ

パラメータ 必須 デフォルト値 説明
latlon - 緯度経度の指定
本項目は必須項目であるため、未指定の場合はエラーとなります。
ssl   F SSL天気アイコン
真偽値を設定します。
Tを指定すると、出力パラメータweatherIconUrl、sentakuIconUrlが、SSLで取得可能な天気アイコンのURLになります。

出力データ

出力フォーマット

{"info":{"pointName":"神奈川県東部",
         "date":{"pubDate":"20150421",
                 "pubTime":"0600"}},
 "item":[{"weatherDate":"20150421",
          "weatherCode":"202",
          "weatherName":"曇り一時雨",
          "weatherIconUrl":"http://mapcache.e-map.ne.jp/image/weather/202.gif",
          "rainPercent":50,
          "maxTemperature":20,
          "minTemperature":null,
          "sentaku":"4",
          "sentakuName":"最適",
          "sentakuIconUrl":"http://mapcache.e-map.ne.jp/image/weather/tenki-sentaku4.gif"}
...]}
キー名 データ型 説明
info     object 天気の取得元情報が入ります。
  pointName   string 天気観測地点名が入ります。
  date   object 天気発表情報が入ります。
    pubDate string 天気発表日付が入ります。
    pubTime string 天気発表時刻が入ります。
発表時刻は06時、12時、18時の1日3回です。
item     array 短期天気データ配列が入ります。
検索結果が0件の場合は空の配列となります。
  weatherDate   string 予報日付が入ります。
  weatherCode   string 天気コードが入ります。
  weatherName   string 天気名称が入ります。
  weatherIconUrl   string 天気アイコンURLが入ります。
  rainPercent   number 降水確率(単位:%) が入ります。
降水確率とは、予報区内で一定の時間内に1mm以上の雨または雪(融けたときの降水量に換算する)が降る確率であり、0%から100%まで10%刻みの値で入ります。
  maxTemperature   number 最高気温(単位:℃) が入ります。
  minTemperature   number 最低気温(単位:℃) が入ります。
  sentaku   string 洗濯指数が入ります。
洗濯指数とは、気温、湿度、風速、紫外線の強さから乾きやすさを5段階で表しています。
  sentakuName   string 洗濯指数名称が入ります。
  sentakuIconUrl   string 洗濯指数アイコンURLが入ります。

出力例

[通常出力例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/weather/short?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=35.2414902,139.1315686&ssl=T

{"info":{"pointName":"神奈川県東部",
         "date":{"pubDate":"20150421",
                 "pubTime":"0600"}},
 "item":[{"weatherDate":"20150421",
          "weatherCode":"202",
          "weatherName":"曇り一時雨",
          "weatherIconUrl":"https://mapcache.e-map.ne.jp/image/weather/202.gif",
          "rainPercent":50,
          "maxTemperature":20,
          "minTemperature":null,
          "sentaku":"4",
          "sentakuName":"最適",
          "sentakuIconUrl":"https://mapcache.e-map.ne.jp/image/weather/tenki-sentaku4.gif"},
         {"weatherDate":"20150422",
          "weatherCode":"201",
          "weatherName":"曇り時々晴れ",
          "weatherIconUrl":"https://mapcache.e-map.ne.jp/image/weather/201.gif",
          "rainPercent":10,
          "maxTemperature":20,
          "minTemperature":11,
          "sentaku":"4",
          "sentakuName":"最適",
          "sentakuIconUrl":"https://mapcache.e-map.ne.jp/image/weather/tenki-sentaku4.gif"}]}

[検索結果が0件の場合]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/weather/short?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=0,0&ssl=T

{"info":{"pointName":"",
         "date":{"pubDate":"",
                 "pubTime":""}},
 "item":[]}