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