WebService API
    开发指南
示例中心
  • 更新日志
    • 常见问题
    WebService API
    开发指南
    天气查询

    概述

    通过行政区划编码、位置经纬度，查询对应城市的实时天气或预报天气。

    请求URL

    URL：https://apis.map.qq.com/ws/weather/v1/
    Method: GET

    请求参数

    参数 必填 说明 示例
    key 是 开发密钥（Key） key=OB4BZ-D4W3U-B7VVO-4PJWW-6TKDJ-*****
    adcode 是（二选一） 行政区划代码，可支持市级和区/县级 adcode=130681
    location 位置经纬度，获取坐标所在区县的天气数据 location=39.905023,116.724502
    type 否 查询天气类型，取值：
    now[默认] 实时天气预报
    future 未来天气预报（默认获取当天和未来3天的天气信息）
    hours 未来24小时天气预报（起始时间为当前时间的前一个小时）    		 type=future
    get_md 否 未来预报天数，仅在type=future时生效，取值：
    0 [默认]当天加未来3天的天气情况
    1 当天加未来6天的天气情况    		 get_md=1
    output 否 返回格式：支持JSON/JSONP，默认JSON output=json
    callback 否 JSONP方式回调函数 callback=function1

    响应结果

    名称 类型 必有 说明
    status number 是 状态码，0为正常，其它为异常，详细请参阅状态码说明
    message string 是 对status的描述
    result object 是 天气查询结果
    realtime array of object 是 实时天气信息，type=now时返回，具体参考如下实时天气响应结果
    forecast array of object 是 预报天气信息，type=future时返回，具体参考如下预报天气响应结果

    实时天气响应结果

    名称 类型 必有 说明
    realtime array of object 是 实时天气信息
    province string 是 省份
    city string 是 市
    district string 是 区县
    adcode number 是 区划编码
    update_time string 是 更新时间
    infos object 是 天气信息
    weather string 是 天气描述，如：阴
    temperature number 是 温度，单位：摄氏度
    wind_direction string 是 风向描述，如：东北风
    wind_power string 是 风力描述，如：4-5级
    wind_power_v2 string 是 风力描述，如：4级
    humidity number 是 湿度，单位：百分比

    预报天气响应结果

    名称 类型 必有 说明
    forecast array of object 是 预报天气信息
    province string 是 省份
    city string 是 市
    district string 是 区县
    adcode number 是 区划编码
    update_time string 是 更新时间
    infos array of object 是 天气信息
    date string 是 日期，如：2024-08-16
    week string 是 星期，如：星期五
    day object 是 白天天气
    weather string 是 天气描述，如：阴
    temperature number 是 温度，单位：摄氏度
    wind_direction string 是 风向描述，如：东北风
    wind_power string 是 风力描述，如：4-5级
    humidity number 是 湿度，单位：百分比
    night object 是 夜晚天气
    weather string 是 天气描述，如：阴
    temperature number 是 温度，单位：摄氏度
    wind_direction string 是 风向描述，如：东北风
    wind_power string 是 风力描述，如：4-5级
    humidity number 是 湿度，单位：百分比

    24小时预报天气响应结果

    名称 类型 必有 说明
    forecast_hours array of object 是 预报天气信息
    province string 是 省份
    city string 是 市
    district string 是 区县
    adcode number 是 区划编码
    update_time string 是 更新时间
    infos array of object 是 天气信息
    hour string 是 时间，如：2025-09-26 18:05
    info object 是 白天天气
    weather string 是 天气描述，如：阴
    temperature number 是 温度，单位：摄氏度
    wind_direction string 是 风向描述，如：东北风
    wind_power string 是 风力描述，如：4-5级

    天气描述表
    晴天
    多云
    阴
    阵雨
    雷阵雨
    雷阵雨伴有冰雹
    雨夹雪
    小雨
    中雨
    大雨
    暴雨    		 大暴雨
    特大暴雨阵雪
    阵雪
    小雪
    中雪
    大雪
    暴雪
    雾
    冻雨
    沙尘暴
    小到中雨    		 中到大雨
    大到暴雨
    暴雨到大暴雨
    大暴雨到特大暴雨
    小到中雪
    中到大雪
    大到暴雪
    浮尘
    扬沙
    强沙尘暴
    浓雾    		 强浓雾
    霾
    中度霾
    重度霾
    严重霾
    大雾
    特强浓雾
    无
    雨
    雪

    风向/风力描述表

    风向描述 风力描述（预报/实时天气返回） 风力描述(实时天气wind_power_v2返回)
    无持续风向 微风（仅预报天气返回） 无风
    东北风 1-2级 1级
    东风 2-3级 2级
    东南风 3-4级 3级
    南风 4-5级 4级
    西南风 5-6级 5级
    西风 6-7级 6级
    西北风 7-8级 7级
    北风 8-9级 8级
    旋转风 9-10级 9级

    调用示例

    // GET请求，注意参数值要进行URL编码
    https://apis.map.qq.com/ws/weather/v1/?key=[你的key]&adcode=130681&type=future

    本页内容