Grid Weather Daily Forecast

Weather forecast data based on numerical models, to provide daily weather forecasts at specified coordinates around the world, with a spatial resolution of 3-5 kilometers.

Hint: The grid weather data is based on Numerical Weather Prediction (NWP) models, and it is not suitable for comparison with observation station data. For station-based city weather data, please refer to the City Weather API. Grid weather uses UTC+0 as the time zone.

Endpoint#

GET /v7/grid-weather/{days}

Parameters#

Path parameters

days (required) Forecast days. Available values are 3d and 7d.

Query parameters

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
lang Multi-language setting, please see Language to find out how our multi-language works and how to set up.
unit Data unit. Use m for metric units (default) or i for imperial units.

Request example#

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

Replace your_token and your_api_host with your JWT Authentication and API Host

Try it

Response#

{
  "code": "200",
  "updateTime": "2023-05-30T18:00+08:00",
  "fxLink": "https://www.qweather.com",
  "daily": [
    {
      "fxDate": "2023-05-30",
      "tempMax": "28",
      "tempMin": "21",
      "iconDay": "102",
      "iconNight": "306",
      "textDay": "Few Clouds",
      "textNight": "Moderate Rain",
      "wind360Day": "129",
      "windDirDay": "SE",
      "windScaleDay": "2",
      "windSpeedDay": "7",
      "wind360Night": "107",
      "windDirNight": "ESE",
      "windScaleNight": "2",
      "windSpeedNight": "8",
      "humidity": "91",
      "precip": "11.55",
      "pressure": "1004",
      "cloud": "70"
    },
    {
      "fxDate": "2023-05-31",
      "tempMax": "24",
      "tempMin": "20",
      "iconDay": "307",
      "iconNight": "306",
      "textDay": "Heavy Rain",
      "textNight": "Moderate Rain",
      "wind360Day": "96",
      "windDirDay": "E",
      "windScaleDay": "1",
      "windSpeedDay": "4",
      "wind360Night": "86",
      "windDirNight": "E",
      "windScaleNight": "1",
      "windSpeedNight": "3",
      "humidity": "93",
      "precip": "23.16",
      "pressure": "1004",
      "cloud": "66"
    },
    {
      "fxDate": "2023-06-01",
      "tempMax": "30",
      "tempMin": "22",
      "iconDay": "101",
      "iconNight": "150",
      "textDay": "Cloudy",
      "textNight": "Sunny",
      "wind360Day": "111",
      "windDirDay": "ESE",
      "windScaleDay": "1",
      "windSpeedDay": "4",
      "wind360Night": "103",
      "windDirNight": "ESE",
      "windScaleNight": "1",
      "windSpeedNight": "4",
      "humidity": "89",
      "precip": "0.00",
      "pressure": "1003",
      "cloud": "22"
    }
  ],
  "refer": {
    "sources": [
      "https://developer.qweather.com/attribution.html"
    ],
    "license": [
      "QWeather Developers License"
    ]
  }
}

code string Status code
updateTime date-time API latest update time
fxLink uri Responsive web page of this data, for embedded in website or APP
daily array Daily forecast data
- fxDate string Forecast date
- tempMax string The highest temperature of the day
- tempMin string The lowest temperature of the day
- iconDay string Icon code for daytime weather conditions. See also QWeather Icons
- textDay string Weather conditions for daytime
- iconNight string Icon code for night weather conditions. See also QWeather Icons
- textNight string Weather conditions for night
- wind360Day string Daytime wind direction in azimuth degree
- windDirDay string Daytime wind direction
- windScaleDay string Daytime wind scale
- windSpeedDay string Daytime wind speed, KM/H
- wind360Night string Nightly wind direction in azimuth degree
- windDirNight string Nightly wind direction
- windScaleNight string Nightly wind scale
- windSpeedNight string Nightly wind speed, KM/H
- humidity string Relative humidity in percent
- precip string Estimated total precipitation for the day
- pressure string Station pressure, default unit: hPa
refer object Data sources and licensing information
- sources array Data source and other statements, may be null
- license array Data license, may be null