一、 產品概述

SmartWeatherAPI 介面(簡稱”SWA”介面)是中國氣象局面向

網路媒體、手機廠商、第三方氣象服務機構等使用者，通過 web 方

式提供資料氣象服務的官方載體。

二、 使用說明

該資料主要包括預警、實況、指數、常規預報(24 小時)等數

據內容。

三、 呼叫規範

規範用於指導三方合作伙伴合理呼叫預警、實況、指數、

常規預報(24 小時)等服務資料。

請求方式：http get

介面組成：由固定 URL 加 5 個不同的引數組成，完整 URL 需客戶

端經過固定方式加密後使用。

資料返回：json

完整 URL：

http://open.weather.com.cn/data/?areaid=""&type=""&date=

""&appid=""&key=".urlencode($key);

固定 URL：http://open.weather.com.cn/data/

輸入引數：

加密方式:

Ø private_key

示例:見 private_key.txt 附件

private_key 僅負責與 public_key 共同合成 key 傳參，私鑰

不可見，客戶端與服務端各儲存一份;

Ø public_key 為不包含 key 在內的完整 URL 其它部分（此處

appid 為完整 appid）

示例:

http://open.weather.com.cn/data/?areaid=101010100&ty

pe=forecast&date=201211281030&appid=cf2d61521456sads

Ø key 的演算法

key=base64_encode(hash_hmac('sha1',$public_key,$priva

te_key,TRUE));

key 加密後通過 urlencode 對其編碼後傳參

注：每一個產品使用使用者分配一個唯一標識 appid,用於統計

使用者訪問情況、區分使用者提供差異服務，終端使用者按照終端型號

四、 服務內容

4.1 實況

介面描述：返回當前實況資訊，每個欄位都放有當前的資料。(如

果沒有資料用 ? 表示)

介面請求方式：http get

介面返回型別：json

輸入示例：

http://open.weather.com.cn/data/?areaid=101010100&type

=observe&date=201212031008&appid=cf2d61&key=w%2B1%2Bfv

ngN50nJJh6xdu6Mfu7jxg%3D

4.2 常規預報

介面描述： 返回 1 天 24 小時常規預報資料

介面請求方式：http get

介面返回型別：json

輸入示例：

http://open.weather.com.cn/data/?areaid=101010100&type

=forecast1d&date=201212010741&appid=cf2d61&key=hPZf1%2

F5Ag%2F4JS2A%2BcYmpj5Yv2YA%3D