Grid Weather Daily Forecast

Platform: API

Get daily weather forecasts at any latitude and longitude in the world, including: temperature, humidity, atmospheric pressure, weather conditions, wind, wind direction, etc.

The spatial resolution is 1x1, 3x3 or 5x5 KM, depending on the region.

Request URL

3 Days Forecast by Grid
https://api.qweather.com/v7/grid-weather/3d?[params]
7 Days Forecast by Grid
https://api.qweather.com/v7/grid-weather/7d?[params]

For Free subscription, change the API Host to devapi.qweather.com. See data available for Free subscription.

Request Parameters

All parameters are separated by &. If no optional parameters are set, the default value will be used.

  • key(required)API authentication key, please refer to How To Get Your Key. Support Signature Authentication. Example: key=12334567890ABC
  • location(required)The comma-separated longitude and latitude (decimal, up to 2 decimal places) of the location to be queried. For example: location=116.41,39.92
  • langMulti-language setting, see language code for available value. If data does not match the language you set, it will return results in English or its native language.
  • unitSet weather data unit, the available value are unit=m for metric(default) and unit=i for imperial. See more about Unit.

Request Example

Grid weather 3-day forecast for 116.41N, 39.92E

curl -L -X GET --compressed 'https://api.qweather.com/v7/grid-weather/3d?location=116.41,39.92&key=YOUR_KEY'

Response

The response is in JSON format and is Gzip compressed, all fields are Strings.

{
  "code": "200",
  "updateTime": "2021-12-16T18:30+08:00",
  "fxLink": "http://hfx.link/1",
  "daily": [
    {
      "fxDate": "2021-12-16",
      "tempMax": "2",
      "tempMin": "-7",
      "iconDay": "104",
      "iconNight": "154",
      "textDay": "阴",
      "textNight": "阴",
      "wind360Day": "344",
      "windDirDay": "西北风",
      "windScaleDay": "4-5",
      "windSpeedDay": "9",
      "wind360Night": "304",
      "windDirNight": "西北风",
      "windScaleNight": "4-5",
      "windSpeedNight": "6",
      "humidity": "36",
      "precip": "0.0",
      "pressure": "1026"
    },
    {
      "fxDate": "2021-12-17",
      "tempMax": "-1",
      "tempMin": "-8",
      "iconDay": "104",
      "iconNight": "154",
      "textDay": "阴",
      "textNight": "阴",
      "wind360Day": "28",
      "windDirDay": "东北风",
      "windScaleDay": "5-6",
      "windSpeedDay": "15",
      "wind360Night": "55",
      "windDirNight": "东北风",
      "windScaleNight": "4-5",
      "windSpeedNight": "7",
      "humidity": "44",
      "precip": "0.0",
      "pressure": "1028"
    },
    {
      "fxDate": "2021-12-18",
      "tempMax": "4",
      "tempMin": "-8",
      "iconDay": "100",
      "iconNight": "150",
      "textDay": "晴",
      "textNight": "晴",
      "wind360Day": "10",
      "windDirDay": "北风",
      "windScaleDay": "5-6",
      "windSpeedDay": "17",
      "wind360Night": "48",
      "windDirNight": "东北风",
      "windScaleNight": "3-4",
      "windSpeedNight": "5",
      "humidity": "61",
      "precip": "0.0",
      "pressure": "1016"
    }
  ],
  "refer": {
    "sources": [
      "QWeather"
    ],
    "license": [
      "commercial license"
    ]
  }
}
  • code API status code, please refer to Status Code
  • updateTime API last update time
  • fxLink Responsive web page of this data, for embedded in website or APP
  • daily.fxDate Forecast date
  • daily.tempMax The highest temperature of the day
  • daily.tempMin The lowest temperature of the day
  • daily.iconDay Icon code for daytime weather conditions, free to download weather icons
  • daily.textDay Weather conditions for daytime
  • daily.iconNight Icon codes for night weather conditions, free to download weather icons
  • daily.textNight Weather conditions for night
  • daily.wind360Day Daytime wind direction in azimuth degree
  • daily.windDirDay Daytime wind direction
  • daily.windScaleDay Daytime wind scale
  • daily.windSpeedDay Daytime wind speed, KM/H
  • daily.wind360Night Nightly wind direction in azimuth degree
  • daily.windDirNight Nightly Wind direction
  • daily.windScaleNight Nightly wind scale
  • daily.windSpeedNight Nightly wind speed, KM/H
  • daily.precip Estimated total precipitation for the day
  • daily.humidity Relative humidity in percent
  • daily.pressure Atmospheric pressure, hPa
  • refer.sources Data source and other statements, may be null
  • refer.license Data license, may be null