短期天気検索

API名:

pptenki/short

概要:

指定された住所コードから短期天気データを取得します。短期天気とは今日明日の天気情報です。

※現在、新規での利用受付を中止しております
※この機能を利用するには別途契約が必要です。

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

URI:

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

<API使用例>
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/pptenki/short?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&addrcode=13101

リクエストパラメータ

パラメータ	必須	デフォルト値	説明
addrcode	○	-	住所コード住所コードを指定します。都道府県(2桁)または市区町村(5桁)で指定できます。都道府県(2桁)を指定した場合は、指定した都道府県に含まれる一時細分区域の天気情報を取得します。

出力データ

出力フォーマット

{"item":[{"area":{"code":"13101",
                  "text":"東京地方"},
          "weatherData":[{"day":"20130215",
                          "weekday":"金",
                          "detailWeather":{"code":"371",
                                           "text":"雪か雨後くもり"},
                          "rainfall0":10,
                          "rainfall6":50,
                          "rainfall12":80,
                          "rainfall18":20,
                          "minTemperature":4,
                          "maxTemperature":8},
                         {"day":"20130216",
                          "weekday":"土",
                          "detailWeather":{"code":"100",
                                           "text":"晴れ"},
                          "rainfall0":0,
                          "rainfall6":0,
                          "rainfall12":0,
                          "rainfall18":0,
                          "minTemperature":3,
                          "maxTemperature":6}]
          }...]
}

キー名				データ型	説明
item				array	検索結果天気データの配列となります。検索結果が0件の場合は空の配列となります。
	area			object	一次細分区域が入ります。
		code		string	住所コードが入ります。
		text		string	一時細分区域名称が入ります。
	weatherData			array	天気データオブジェクトが入ります。細分区域毎の天気データの配列となります。
		day		string	日付(YYYYMMDD)が入ります。
		weekday		string	曜日が入ります。
		detailWeather		object	気象詳細情報が入ります。データが存在しない場合はNULLが入ります。
			code	string	気象詳細情報コードが入ります。
			text	string	気象詳細情報が入ります。
		rainfall0		number	0時～6時の降水確率(単位:%)が入ります。データが存在しない場合はNULLが入ります。
		rainfall6		number	6時～12時の降水確率(単位:%)が入ります。データが存在しない場合はNULLが入ります。
		rainfall12		number	12時～18時の降水確率(単位:%)が入ります。データが存在しない場合はNULLが入ります。
		rainfall18		number	18時～24時の降水確率(単位:%)が入ります。データが存在しない場合はNULLが入ります。
		minTemperature		number	最低気温(単位:℃)が入ります。データが存在しない場合はNULLが入ります。
		maxTemperature		number	最高気温(単位:℃)が入ります。データが存在しない場合はNULLが入ります。

出力例

[通常出力例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/pptenki/short?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&addrcode=13101

{"item":[{"area":{"code":"13101",
                  "text":"東京地方"},
          "weatherData":[{"day":"20130215",
                          "weekday":"金",
                          "detailWeather":{"code":"371",
                                           "text":"雪か雨後くもり"},
                          "rainfall0":10,
                          "rainfall6":50,
                          "rainfall12":80,
                          "rainfall18":20,
                          "minTemperature":4,
                          "maxTemperature":8},
                         {"day":"20130216",
                          "weekday":"土",
                          "detailWeather":{"code":"100",
                                           "text":"晴れ"},
                          "rainfall0":0,
                          "rainfall6":0,
                          "rainfall12":0,
                          "rainfall18":0,
                          "minTemperature":3,
                          "maxTemperature":6}]}]}

[検索結果が0件の場合]

{"item":[]}