杂项

查询天气

0次调用
2 积分/次

出门前,查一下天气总是个好习惯。这个接口为你提供精准、实时的天气数据,支持国内和国际城市。

功能概述

这个接口支持三种查询方式:

  • 可以传 adcode,按行政区编码查询(优先级最高)
  • 可以传 city,按城市名称查询,支持中文(北京)和英文(Tokyo
  • 两个都不传时,按客户端 IP 自动定位查询

支持 lang 参数,可选 zh(默认)和 en,城市名翻译覆盖 7000+ 城市。

可选功能模块

  • extended=true:扩展气象字段(体感温度、能见度、气压、紫外线、空气质量及污染物分项数据)
  • forecast=true:多天预报(最多7天,会额外返回每天的最高温度、最低温度,以及日出日落、风速等详细数据)
  • hourly=true:逐小时预报(24小时)
  • minutely=true:分钟级降水预报(仅国内城市,精确到2分钟)
  • indices=true:18项生活指数(穿衣、紫外线、洗车、运动、花粉等)

天气字段说明

weather 是天气现象文本,不是固定枚举。

常见值包括:晴、多云、阴、小雨、中雨、大雨、雷阵雨、小雪、中雪、大雪、雨夹雪、雾、霾、沙尘。

如果你的业务需要稳定的天气分类,建议使用 weather_code 进行映射。完整的天气图标代码请参考天气图标代码表

查询参数

city
string可选

城市名称,支持中文(北京)和英文(Tokyo)。可选参数,不传时会尝试 IP 自动定位。

adcode
string可选

城市行政区划代码(如 110000),优先级高于 city。可选参数,不传时会尝试 IP 自动定位。

extended
boolean可选

返回扩展气象字段(体感温度、能见度、气压、紫外线、降水量、云量、空气质量指数及污染物分项数据)。

forecast
boolean可选

返回多天预报数据(最多7天),含每天的最高温度、最低温度、白天夜间天气、风向风力、日出日落等。

hourly
boolean可选

返回逐小时预报(24小时),含温度、天气、风向风速、湿度、降水概率等。

minutely
boolean可选

返回分钟级降水预报(仅国内城市),精确到2分钟。

indices
boolean可选

返回18项生活指数(穿衣、紫外线、洗车、晾晒、空调、感冒、运动、舒适度、出行、钓鱼、过敏、防晒、心情、啤酒、雨伞、交通、空气净化器、花粉)。

lang
string可选

返回语言。zh 返回中文(默认),en 返回英文。城市名翻译覆盖 7000+ 城市。生活指数(indices)目前仅支持中文。

响应

200 / 请求成功

查询成功!返回该地区的实时天气信息。

JSON

400 / 错误的请求

参数无效。常见原因:adcode 格式非法、lang 非法(仅支持 zh/en)、参数值类型错误或参数组合无效。

JSON

404 / 未找到

城市未找到。

JSON

500 / 服务器内部错误

服务器内部错误。

JSON

503 / 服务不可用

天气服务暂时不可用。

JSON