Grid Weather Hourly Forecast

Weather forecast data based on numerical models, to provide hourly 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/{hours}

Parameters#

Path parameters

  • hours (required) Forecast hours, supports up to 72 hours, available value: 24h, 72h

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/24h?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",
  "hourly": [
    {
      "fxTime": "2023-05-30T11:00+00:00",
      "temp": "27",
      "icon": "104",
      "text": "Overcast",
      "wind360": "91",
      "windDir": "E",
      "windScale": "2",
      "windSpeed": "7",
      "humidity": "72",
      "precip": "0.0",
      "pressure": "1003",
      "cloud": "100",
      "dew": "21"
    },
    {
      "fxTime": "2023-05-30T12:00+00:00",
      "temp": "25",
      "icon": "104",
      "text": "Overcast",
      "wind360": "121",
      "windDir": "ESE",
      "windScale": "2",
      "windSpeed": "10",
      "humidity": "78",
      "precip": "0.0",
      "pressure": "1004",
      "cloud": "100",
      "dew": "21"
    },
    {
      "fxTime": "2023-05-30T13:00+00:00",
      "temp": "23",
      "icon": "305",
      "text": "Light Rain",
      "wind360": "136",
      "windDir": "SE",
      "windScale": "3",
      "windSpeed": "13",
      "humidity": "85",
      "precip": "1.41",
      "pressure": "1005",
      "cloud": "100",
      "dew": "21"
    },
    {
      "fxTime": "2023-05-30T14:00+00:00",
      "temp": "23",
      "icon": "305",
      "text": "Light Rain",
      "wind360": "130",
      "windDir": "SE",
      "windScale": "2",
      "windSpeed": "9",
      "humidity": "88",
      "precip": "0.44",
      "pressure": "1004",
      "cloud": "100",
      "dew": "20"
    },
    {
      "fxTime": "2023-05-30T15:00+00:00",
      "temp": "22",
      "icon": "104",
      "text": "Overcast",
      "wind360": "103",
      "windDir": "ESE",
      "windScale": "2",
      "windSpeed": "8",
      "humidity": "89",
      "precip": "0.0",
      "pressure": "1005",
      "cloud": "100",
      "dew": "20"
    },
    {
      "fxTime": "2023-05-30T16:00+00:00",
      "temp": "22",
      "icon": "104",
      "text": "Overcast",
      "wind360": "90",
      "windDir": "E",
      "windScale": "2",
      "windSpeed": "9",
      "humidity": "90",
      "precip": "0.0",
      "pressure": "1004",
      "cloud": "100",
      "dew": "20"
    },
    {
      "fxTime": "2023-05-30T17:00+00:00",
      "temp": "22",
      "icon": "104",
      "text": "Overcast",
      "wind360": "111",
      "windDir": "ESE",
      "windScale": "2",
      "windSpeed": "7",
      "humidity": "90",
      "precip": "0.0",
      "pressure": "1005",
      "cloud": "100",
      "dew": "20"
    },
    {
      "fxTime": "2023-05-30T18:00+00:00",
      "temp": "21",
      "icon": "306",
      "text": "Moderate Rain",
      "wind360": "92",
      "windDir": "E",
      "windScale": "2",
      "windSpeed": "10",
      "humidity": "91",
      "precip": "5.41",
      "pressure": "1004",
      "cloud": "100",
      "dew": "20"
    },
    {
      "fxTime": "2023-05-30T19:00+00:00",
      "temp": "21",
      "icon": "306",
      "text": "Moderate Rain",
      "wind360": "124",
      "windDir": "SE",
      "windScale": "2",
      "windSpeed": "7",
      "humidity": "91",
      "precip": "3.89",
      "pressure": "1004",
      "cloud": "100",
      "dew": "20"
    },
    {
      "fxTime": "2023-05-30T20:00+00:00",
      "temp": "21",
      "icon": "305",
      "text": "Light Rain",
      "wind360": "88",
      "windDir": "E",
      "windScale": "2",
      "windSpeed": "9",
      "humidity": "91",
      "precip": "0.32",
      "pressure": "1004",
      "cloud": "100",
      "dew": "20"
    },
    {
      "fxTime": "2023-05-30T21:00+00:00",
      "temp": "21",
      "icon": "104",
      "text": "Overcast",
      "wind360": "87",
      "windDir": "E",
      "windScale": "2",
      "windSpeed": "7",
      "humidity": "91",
      "precip": "0.0",
      "pressure": "1004",
      "cloud": "100",
      "dew": "20"
    },
    {
      "fxTime": "2023-05-30T22:00+00:00",
      "temp": "21",
      "icon": "104",
      "text": "Overcast",
      "wind360": "81",
      "windDir": "E",
      "windScale": "2",
      "windSpeed": "7",
      "humidity": "91",
      "precip": "0.0",
      "pressure": "1005",
      "cloud": "100",
      "dew": "20"
    }
  ],
  "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
  • hourly object
    • fxTime date-time Forecast time in ISO 8601 format
    • temp string Temperature, default unit: Celsius
    • icon string Icon code for weather conditions. See also QWeather Icons
    • text string Weather condition description
    • wind360 string Wind direction in azimuth degree
    • windDir string Wind direction
    • windScale string Wind scale
    • windSpeed string Wind speed, km/h
    • humidity string Relative humidity in percent
    • precip string Precipitation, default unit: millimeters
    • pressure string Station pressure, default unit: hPa
    • cloud string Cloud cover in percent
    • dew string Dew point temperature
  • refer object Data sources and licensing information
    • sources array Data source and other statements, may be null
    • license array Data license, may be null