获取当前位置实时天气

根据用户的经纬度地址,查询当前所属经纬度的天气情况

测试地址:

{url}/dev-api/customer/util/weather

生产地址:

{url}/api/customer/util/weather

HTTP Method:GET
Content-Type:

是否白名单:是

具体请求

header:

body:

请求参数说明

参数名 类型 是否必填 说明 示例
location String 纬度+英文逗号+经度 36.71265155,119.16837791

响应参数

成功响应示例

  1. {
  2. "msg": "操作成功",
  3. "code": 200,
  4. "data": {
  5. "province": "山东",
  6. "city": "奎文区",
  7. "adcode": "370705",
  8. "windpower": "≤3",
  9. "icon": "https://oss.icuapi.com/docs/openapi-website/20220310/1646883391805.png",
  10. "weather": "晴",
  11. "temperature": "7",
  12. "humidity": "91",
  13. "reporttime": "2022-03-11 00:01:34",
  14. "winddirection": "东南"
  15. }
  16. }

失败响应示例

响应参数说明

参数名 说明 备注
code 返回码 为200表示成功,非200表示调用失败,其他错误码请见返回码说明
msg 返回码的文本描述内容
data 返回数据
province 省份名
city 城市名
adcode 区域编码
icon 天气图标
weather 天气预报 详见天气现象列表
temperature 实时气温,单位:摄氏度
windDirection 风向,风向编码对应描述
windPower 风力,风力编码对应风力级别,单位:级
humidity 空气湿度(百分比)
reportTime 数据发布的时间

天气现象表

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

天气现象表

少云
晴间多云
多云

有风
平静
微风
和风
清风
强风/劲风
疾风
大风
烈风
风暴
狂爆风
飓风
热带风暴

中度霾
重度霾
严重霾
阵雨
雷阵雨
雷阵雨并伴有冰雹
小雨
中雨
大雨
暴雨
大暴雨
特大暴雨
强阵雨
强雷阵雨
极端降雨
毛毛雨/细雨

小雨-中雨
中雨-大雨
大雨-暴雨
暴雨-大暴雨
大暴雨-特大暴雨
雨雪天气
雨夹雪
阵雨夹雪
冻雨

阵雪
小雪
中雪
大雪
暴雪
小雪-中雪
中雪-大雪
大雪-暴雪
浮尘
扬沙
沙尘暴
强沙尘暴
龙卷风

浓雾
强浓雾
轻雾
大雾
特强浓雾


未知

风力表

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

风力表
≤3 4 5 6 7
8 9 10 11 12

风向表

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

风向表
无风向 东北 东南
西南 西 西北 旋转不定

注意事项:
该接口为限制接口: 调用量上限(次/日):3000000 并发量上限(次/秒)1000