更新日志
·API

天气查询接口重大升级

天气接口新增逐小时预报、分钟级降水、18项生活指数,扩展字段新增空气污染物分项数据,预报扩展至7天。部分响应字段和错误码有破坏性变更。

天气查询 API 完成重大升级,新增多项功能并包含破坏性变更。

破坏性变更

  • 错误响应码调整:移除 502UPSTREAM_ERROR / IP_LOCATION_FAILED),新增 503SERVICE_UNAVAILABLE);400 错误码由 INVALID_ARGUMENT 改为 INVALID_PARAMETER404LOCATION_NOT_FOUND 改为 NOT_FOUND

新增功能

  • 新增 hourly 参数,支持逐小时预报(24小时),返回温度、天气、风向风速、湿度、降水概率、体感温度、露点、能见度等
  • 新增 minutely 参数,支持分钟级降水预报(仅国内城市),每5分钟一个数据点,含降水类型(rain/snow)
  • indices 生活指数从 8 项扩展至 18 项,新增:出行、钓鱼、过敏、防晒、心情、啤酒、雨伞、交通、空气净化器、花粉扩散
  • extended=true 新增字段:aqi_level(AQI等级1-6)、aqi_category(等级描述)、aqi_primary(主要污染物)、air_pollutants(PM2.5/PM10/O3/NO2/SO2/CO 分项数据)
  • forecast 预报从最多3天扩展至最多7天,数组新增 wind_speed_day(风速)、sunrise(日出)、sunset(日落)
  • city 参数支持国际城市和英文名称(如 Tokyo
  • lang=en 城市名翻译覆盖扩展至 7000+ 城市

祝大家新年快乐~

Shuakami
Shuakami