格点天气预报

获取中国境内任意1公里范围内的高精度天气预报,包括:温度、湿度、大气压、天气状况、风力、风向等。

本数据仅支持中国境内地区数据。

请求URL

格点3天预报

  • 商业版https://api.qweather.com/v7/grid-weather/3d?[请求参数]

格点7天预报

  • 商业版https://api.qweather.com/v7/grid-weather/7d?[请求参数]

请求参数

请求参数包括必选和可选参数,如不填写可选参数将使用其默认值,参数之间使用&进行分隔。

key

用户认证key,请参考如何获取你的KEY。支持数字签名方式进行认证。例如 key=123456789ABC

location

需要查询地区的以英文逗号分隔的经度,纬度坐标(十进制)。例如 location=116.41,39.92

lang

多语言设置,默认中文,当数据不匹配你设置的语言时,将返回英文或其本地语言结果。

unit

度量衡单位参数选择,例如温度选摄氏度或华氏度、公里或英里。默认公制单位

  • m 公制单位,默认
  • i 英制单位

返回数据

// 坐标116.41,39.92 3天预报
// Pro: https://api.qweather.com/v7/grid-weather/3d?location=116.41,39.92&key=你的KEY

{
  "code": "200",
  "updateTime": "2021-03-12T19:06+08:00",
  "fxLink": "http://hfx.link/1",
  "daily": [
    {
      "fxDate": "2021-03-12",
      "tempMax": "10",
      "tempMin": "8",
      "iconDay": "101",
      "iconNight": "302",
      "textDay": "多云",
      "textNight": "雷阵雨",
      "windDirDay": "西风",
      "windScaleDay": "3-4",
      "windScaleNight": "1-2"
    },
    {
      "fxDate": "2021-03-13",
      "tempMax": "16",
      "tempMin": "7",
      "iconDay": "101",
      "iconNight": "101",
      "textDay": "多云",
      "textNight": "多云",
      "windDirDay": "西风",
      "windScaleDay": "1-2",
      "windScaleNight": "1-2"
    },
    {
      "fxDate": "2021-03-14",
      "tempMax": "15",
      "tempMin": "8",
      "iconDay": "101",
      "iconNight": "154",
      "textDay": "多云",
      "textNight": "阴",
      "windDirDay": "西风",
      "windScaleDay": "3-4",
      "windScaleNight": "1-2"
    }
  ],
  "refer": {
    "sources": [
      "Weather China"
    ],
    "license": [
      "commercial license"
    ]
  }
}
参数 描述
code

API状态码,具体含义请参考状态码

updateTime

当前API的最近更新时间

fxLink

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

daily.fxDate

预报日期

daily.tempMax

预报当天最高温度

daily.tempMin

预报当天最低温度

daily.iconDay

预报白天天气状况的图标代码,图标可通过天气状况和图标下载

daily.textDay

预报白天天气状况文字描述,包括阴晴雨雪等天气状态的描述

daily.iconNight

预报夜间天气状况的图标代码,图标可通过天气状况和图标下载

daily.textNight

预报晚间天气状况文字描述,包括阴晴雨雪等天气状态的描述

daily.windDirDay

预报白天风向

daily.windScaleDay

预报白天风力等级

daily.windDirNight

预报夜间当天风向

daily.windScaleNight

预报夜间风力等级

refer.sources

原始数据来源,或数据源说明,可能为空

refer.license

数据许可或版权声明,可能为空