城市每日预报

注意： WebAPI v7版本的城市天气预报即将弃用，请使用每日天气预报 v1代替。

每日天气预报API，提供全球城市未来3-30天天气预报，包括：日出日落、月升月落、最高最低温度、天气白天和夜间状况、风力、风速、风向、相对湿度、站点气压、降水量、露点温度、紫外线强度、能见度等。

请求路径#

GET /v7/weather/{days}

参数#

路径参数

days^必选

string

预报天数，支持最多30天预报，可选值：3d、7d、10d、15d、30d

查询参数

location^必选

string

需要查询地区的LocationID或以英文逗号分隔的经度,纬度坐标（十进制，最多支持小数点后两位），LocationID可通过GeoAPI获取。例如 location=101010100 或 location=116.41,39.92
lang

string

多语言设置

请求示例#

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://your-api-host/v7/weather/3d?location=116.41%2C39.92'

请将your_token替换为你的JWT身份认证，将your_api_host替换为你的API Host

试一下

返回数据#

{
  "code": "200",
  "updateTime": "2021-11-15T16:35+08:00",
  "fxLink": "https://www.qweather.com/en/weather/beijing-101010100.html",
  "daily": [
    {
      "fxDate": "2021-11-15",
      "sunrise": "06:58",
      "sunset": "16:59",
      "moonrise": "15:16",
      "moonset": "03:40",
      "moonPhase": "盈凸月",
      "moonPhaseIcon": "803",
      "tempMax": "12",
      "tempMin": "-1",
      "iconDay": "101",
      "textDay": "多云",
      "iconNight": "150",
      "textNight": "晴",
      "wind360Day": "45",
      "windDirDay": "东北风",
      "windScaleDay": "1-2",
      "windSpeedDay": "3",
      "wind360Night": "0",
      "windDirNight": "北风",
      "windScaleNight": "1-2",
      "windSpeedNight": "3",
      "humidity": "65",
      "precip": "0.0",
      "pressure": "1020",
      "vis": "25",
      "cloud": "4",
      "uvIndex": "3"
    },
    {
      "fxDate": "2021-11-16",
      "sunrise": "07:00",
      "sunset": "16:58",
      "moonrise": "15:38",
      "moonset": "04:40",
      "moonPhase": "盈凸月",
      "moonPhaseIcon": "803",
      "tempMax": "13",
      "tempMin": "0",
      "iconDay": "100",
      "textDay": "晴",
      "iconNight": "101",
      "textNight": "多云",
      "wind360Day": "225",
      "windDirDay": "西南风",
      "windScaleDay": "1-2",
      "windSpeedDay": "3",
      "wind360Night": "225",
      "windDirNight": "西南风",
      "windScaleNight": "1-2",
      "windSpeedNight": "3",
      "humidity": "74",
      "precip": "0.0",
      "pressure": "1016",
      "vis": "25",
      "cloud": "1",
      "uvIndex": "3"
    },
    {
      "fxDate": "2021-11-17",
      "sunrise": "07:01",
      "sunset": "16:57",
      "moonrise": "16:01",
      "moonset": "05:41",
      "moonPhase": "盈凸月",
      "moonPhaseIcon": "803",
      "tempMax": "13",
      "tempMin": "0",
      "iconDay": "100",
      "textDay": "晴",
      "iconNight": "150",
      "textNight": "晴",
      "wind360Day": "225",
      "windDirDay": "西南风",
      "windScaleDay": "1-2",
      "windSpeedDay": "3",
      "wind360Night": "225",
      "windDirNight": "西南风",
      "windScaleNight": "1-2",
      "windSpeedNight": "3",
      "humidity": "56",
      "precip": "0.0",
      "pressure": "1009",
      "vis": "25",
      "cloud": "0",
      "uvIndex": "3"
    }
  ],
  "refer": {
    "sources": [
      "https://developer.qweather.com/attribution.html"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}

code

string

状态码
updateTime

date-time

API的最近更新时间
fxLink

uri

当前数据的响应式页面，便于嵌入网站或应用
daily

array

每日预报数据列表
- fxDate
  
  date
  
  预报日期
- sunrise
  
  string
  
  日出时间，在高纬度地区可能为空
- sunset
  
  string
  
  日落时间，在高纬度地区可能为空
- moonrise
  
  string
  
  月升时间，可能为空
- moonset
  
  string
  
  月落时间，可能为空
- moonPhase
  
  string
  
  月相名称
- moonPhaseIcon
  
  string
  
  月相图标代码
- tempMax
  
  string
  
  最高温度
- tempMin
  
  string
  
  最低温度
- iconDay
  
  string
  
  白天天气状况的图标代码，另请参考天气图标项目
- textDay
  
  string
  
  白天天气状况文字描述，包括阴晴雨雪等天气状态的描述
- iconNight
  
  string
  
  夜间天气状况的图标代码，另请参考天气图标项目
- textNight
  
  string
  
  晚间天气状况文字描述，包括阴晴雨雪等天气状态的描述
- wind360Day
  
  string
  
  白天风向360角度
- windDirDay
  
  string
  
  白天风向
- windScaleDay
  
  string
  
  白天风力等级
- windSpeedDay
  
  string
  
  白天风速，公里/小时
- wind360Night
  
  string
  
  夜间风向360角度
- windDirNight
  
  string
  
  夜间风向
- windScaleNight
  
  string
  
  夜间风力等级
- windSpeedNight
  
  string
  
  夜间风速，公里/小时
- humidity
  
  string
  
  相对湿度，百分比数值
- precip
  
  string
  
  预报当天总降水量，默认单位：毫米
- pressure
  
  string
  
  站点气压，默认单位：百帕
- uvIndex
  
  string
  
  紫外线强度指数
- vis
  
  string
  
  能见度，默认单位：公里
- cloud
  
  string
  
  云量，百分比数值
refer

object

数据来源和许可信息
- sources
  
  array
  
  原始数据来源，或数据源说明，可能为空
- license
  
  array
  
  数据许可或版权声明，可能为空