天气查询

  • 接口介绍
  • 接口文档
  • 使用指南
  • 资源下载
  • 更新日志
天气查询是一个简单的HTTP接口,根据用户输入的adcode,查询目标区域当前/未来的天气情况。

天气查询 API 服务地址:

  • 接口地址:https://www.oneapi.cn/mapapi/weather

  • 请求方式:get


请求参数:

    参数名 含义 规则说明 是否必须
    app_key 非常第一数据app_key
    用户申请数据时生成的app_key
    city 要查询的城市 要查询的城市
    extensions 气象类型
    base:返回实况天气 all:返回预报天气
    app_id 非常第一数据app_id 我的数据中的app_id
    time
    当前时间戳 请求API时的时间戳
    sign
    数字签名 请参考数字签名获取和使用方法


例如:

https://www.oneapi.cn/mapapi/weather?city=南宁&app_id=10001&app_key=7741587edb4b1cd86153821682a1d37709a420b8&sign=a51230d27b4c42909744d748730253df1d04b66a32a42ea1833aae734fb79100&time=1532343526&extensions=base


返回结果参数说明:


实况天气每小时更新多次,预报天气每天更新3次,分别在8、11、18点左右更新。由于天气数据的特殊性以及数据更新的持续性,无法确定精确的更新时间,请以接口返回数据的reporttime字段为准。

名称

含义

规则说明

status

返回状态

值为0或1

1:成功;0:失败

count

返回结果总数目

info

返回的状态信息

infocode

返回状态说明,10000代表正确

lives

实况天气数据信息

province

省份名

city

城市名

adcode

区域编码

weather

天气现象(汉字描述)

temperature

实时气温,单位:摄氏度

winddirection

风向描述

windpower

风力级别,单位:级

humidity

空气湿度

reporttime

数据发布的时间

forecast

预报天气信息数据

city

城市名称

adcode

城市编码

province

省份名称

reporttime

预报发布时间

casts

预报数据list结构,元素cast,按顺序为当天、第二天、第三天的预报数据

date

日期

week

星期几

dayweather

白天天气现象

nightweather

晚上天气现象

daytemp

白天温度

nighttemp

晚上温度

daywind

白天风向

nightwind

晚上风向

daypower

白天风力

nightpower

晚上风力


下表列举了天气功能中所能返回的天气现象:

天气现象

少云

晴间多云

多云

有风

平静

微风

和风

清风

强风/劲风

疾风

大风

烈风

风暴

狂爆风

飓风

热带风暴

阵雨

雷阵雨

雷阵雨并伴有冰雹

小雨

中雨

大雨

暴雨

大暴雨

特大暴雨

强阵雨

强雷阵雨

极端降雨

毛毛雨/细雨

小雨-中雨

中雨-大雨

大雨-暴雨

暴雨-大暴雨

大暴雨-特大暴雨

雨雪天气

雨夹雪

阵雨夹雪

冻雨

阵雪

小雪

中雪

大雪

暴雪

小雪-中雪

中雪-大雪

大雪-暴雪

浮尘

扬沙

沙尘暴

强沙尘暴

龙卷风

浓雾

强浓雾

轻雾

大雾

特强浓雾

中度霾

重度霾

严重霾

未知

风力表

进行天气查询时返回的风力如下表所示:

风力表

≤3

4

5

6

7

8

9

10

11

12

风向表

进行天气查询时返回的风向如下表所示:

风向表

无风向

东北

东南

西南

西

西北

旋转不定


更新日志:

                API v1.0 2018/10/08