指定地点の3時間毎の天気データ取得

API名:

weather/three_hour

概要:

リクエストパラメータで指定される緯度経度の3時間毎の天気データを取得します。
天気データはアメダスの範囲で整備されています。

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

情報元について:
気象情報元：株式会社ベルシステム２４
このAPIが返却する上記情報は、情報元の提供規準に準拠します。

URI:

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

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

リクエストパラメータ

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

出力データ

出力フォーマット

{"info":{"pointName":"小田原",
         "date":{"pubDate":"20150421",
                 "pubTime":"0600"}},
"item":[{"weatherDate":"20150421",
          "weatherTime":"06",
          "weatherCode":"05",
          "weatherName":"雨",
          "weatherIconUrl":"http://mapcache.e-map.ne.jp/image/weather/05.gif",
          "temperature":18,
          "rainMm":1,
"rainPercent": 40}
...]}

キー名			データ型	説明
info			object	天気の取得元情報が入ります。
	pointName		string	天気観測地点名が入ります。
	date		object	天気発表情報が入ります。
		pubDate	string	天気発表日付が入ります。
		pubTime	string	天気発表時刻が入ります。発表時刻は06時、12時、18時の1日3回です。
item			array	短期天気データ配列が入ります。検索結果が0件の場合は空の配列となります。
	weatherDate		string	予報日付が入ります。
	weatherTime		string	予報時刻が入ります。
	weatherCode		string	天気コードが入ります。
	weatherName		string	天気名称が入ります。
	weatherIconUrl		string	天気アイコンURLが入ります。
	temperature		number	気温(単位:℃)が入ります。
	rainMm		number	降水量(単位:mm/h)が入ります。
	rainPercent		number	降水確率(単位:%)が入ります。

出力例

[通常出力例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/weather/three_hour?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",
          "weatherTime":"06",
          "weatherCode":"05",
          "weatherName":"雨",
          "weatherIconUrl":"https://mapcache.e-map.ne.jp/image/weather/05.gif",
          "temperature":18,
          "rainMm":1,
          "rainPercent": 40},
         {"weatherDate":"20150421",
          "weatherTime":"09",
          "weatherCode":"03",
          "weatherName":"曇り",
          "weatherIconUrl":"https://mapcache.e-map.ne.jp/image/weather/03.gif",
          "temperature":19,
          "rainMm":0,
          "rainPercent": 10},
         {"weatherDate":"20150421",
          "weatherTime":"12",
          "weatherCode":"03",
          "weatherName":"曇り",
          "weatherIconUrl":"https://mapcache.e-map.ne.jp/image/weather/03.gif",
          "temperature":17,
          "rainMm":0,
          "rainPercent": 20},
         {"weatherDate":"20150421",
          "weatherTime":"15",
          "weatherCode":"03",
          "weatherName":"曇り",
          "weatherIconUrl":"https://mapcache.e-map.ne.jp/image/weather/03.gif",
          "temperature":16,
          "rainMm":0,
          "rainPercent": 10},
         {"weatherDate":"20150421",
          "weatherTime":"18",
          "weatherCode":"03",
          "weatherName":"曇り",
          "weatherIconUrl":"https://mapcache.e-map.ne.jp/image/weather/03.gif",
          "temperature":16,
          "rainMm":0,
          "rainPercent": 0},
         {"weatherDate":"20150421",
          "weatherTime":"21",
          "weatherCode":"03",
          "weatherName":"曇り",
          "weatherIconUrl":"https://mapcache.e-map.ne.jp/image/weather/03.gif",
          "temperature":15,
          "rainMm":0,
          "rainPercent": 0},
         {"weatherDate":"20150422",
          "weatherTime":"00",
          "weatherCode":"02",
          "weatherName":"晴れ(夜)",
          "weatherIconUrl":"https://mapcache.e-map.ne.jp/image/weather/02.gif",
          "temperature":13,
          "rainMm":0},
         {"weatherDate":"20150422",
          "weatherTime":"03",
          "weatherCode":"02",
          "weatherName":"晴れ(夜)",
          "weatherIconUrl":"https://mapcache.e-map.ne.jp/image/weather/02.gif",
          "temperature":11,
          "rainMm":0,
          "rainPercent": 0},
         {"weatherDate":"20150422",
          "weatherTime":"06",
          "weatherCode":"01",
          "weatherName":"晴れ(昼)",
          "weatherIconUrl":"https://mapcache.e-map.ne.jp/image/weather/01.gif",
          "temperature":13,
          "rainMm":0,
          "rainPercent": 0},
         {"weatherDate":"20150422",
          "weatherTime":"09",
          "weatherCode":"01",
          "weatherName":"晴れ(昼)",
          "weatherIconUrl":"https://mapcache.e-map.ne.jp/image/weather/01.gif",
          "temperature":17,
          "rainMm":0,
          "rainPercent": 0},
         {"weatherDate":"20150422",
          "weatherTime":"12",
          "weatherCode":"01",
          "weatherName":"晴れ(昼)",
          "weatherIconUrl":"https://mapcache.e-map.ne.jp/image/weather/01.gif",
          "temperature":18,
          "rainMm":0,
          "rainPercent": 0},
         {"weatherDate":"20150422",
          "weatherTime":"15",
          "weatherCode":"01",
          "weatherName":"晴れ(昼)",
          "weatherIconUrl":"https://mapcache.e-map.ne.jp/image/weather/01.gif",
          "temperature":17,
          "rainMm":0,
          "rainPercent": 0},
         {"weatherDate":"20150422",
          "weatherTime":"18",
          "weatherCode":"02",
          "weatherName":"晴れ(夜)",
          "weatherIconUrl":"https://mapcache.e-map.ne.jp/image/weather/02.gif",
          "temperature":15,
          "rainMm":0,
          "rainPercent": 0},
         {"weatherDate":"20150422",
          "weatherTime":"21",
          "weatherCode":"02",
          "weatherName":"晴れ(夜)",
          "weatherIconUrl":"https://mapcache.e-map.ne.jp/image/weather/02.gif",
          "temperature":14,
          "rainMm":0,
          "rainPercent": 0}]}

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

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