中国气象局开放平台接口使用说明书

《中国气象局开放平台接口使用说明书》由会员上传分享，免费在线阅读，更多相关内容在行业资料-天天文库。

1、SmartWeatherAPIOpen版接口使用说明书中国气象局公共气象服务中心2014/11/20版本号：3.0.3SmartWeatherAPIOpen版接口使用说明书目录一、产品概述........................................................................2二、使用说明........................................................................2三

2、、调用规范........................................................................2四、服务内容........................................................................34.1常规预报...................................................................34.2指数......................

3、.....................................................6五、编码表............................................................................75.1天气现象编码表.......................................................75.2风力风向编码表...............................................

4、........8六、数据更新频率表.............................................................81SmartWeatherAPIOpen版接口使用说明书一、产品概述SmartWeatherAPI接口(简称”SWA”接口)是中国气象局面向网络媒体、手机厂商、第三方气象服务机构等用户，通过web方式提供数据气象服务的官方载体。二、使用说明该数据主要包括3天常规预报(24小时)、指数数据内容。三、调用规范规范用于指导三方合作伙伴合理调用3天常规

5、预报(24小时)、指数服务数据。请求方式：httpget接口组成：由固定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/输入参数：参数名称参数含义参数样例areaid区域id单区域:101010100多区域:1

6、01010100

7、101010200type数据类型指数:index_f(基础)、index_v(常规)3天常规预报(24小时):forecast_f(基础)、forecast_v(常规)date客户端日期按照格式yyyyMMddHHmm获取客户端当前时间appid固定分配的型xx:12345678902SmartWeatherAPIOpen版接口使用说明书号标识传递参数时:截取appid的前6位生成公钥时:取完整的appidkey令牌由公钥(public_key)和私钥(private_key)通过

8、固定算法加密生成加密方式:private_keyxx:123456_SmartWeatherAPI_789private_key仅负责与public_key共同合成key传参，私钥不可见，客户端与服务端各存储一份;public_key为不包含key在内的完整URL其它部分（此处appid为完整appid）示例:http://open.weather.com.cn/data/?areaid=101010200&type=forecast_f&date=201211281030&appid=1234567890

9、key的算法key=base64_encode(hash_hmac('sha1',$public_key,$private_key,TRUE));key加密后通过urlencode对其编码后传参注：每一个产品使用用户分配一个唯一标识appid,用于统计用户访问情况、区分用户提供差异服务，终端用户按照终端型号分配，一个型号对应一个标识。四、服务内容4.1常规预报接口描述：返