Grid Weather Hourly Forecast

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

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

Request URL

Hourly Forecast by Grid (24hrs)

  • Prohttps://api.qweather.com/v7/grid-weather/24h?[params]

Hourly Forecast by Grid (72hrs)

  • Prohttps://api.qweather.com/v7/grid-weather/72h?[params]

Request parameters

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

key

API authentication key, please refer to How To Get Your Key. Support Signature Authentication.

For example: key=12334567890ABC

location

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, if data does not match the language you set, it will return results in English or its native language.

unit

Select weather data unit, for unit parameters of all data, please refer Unit

  • m metric unit, default
  • i imperial unit

Response 

// Hourly forecast in 116.41,39.92
// Pro: https://api.qweather.com/v7/grid-weather/24h?location=116.41,39.92&lang=en&key=YOUR_KEY

{
  "code": "200",
  "updateTime": "2021-12-16T19:28+08:00",
  "fxLink": "http://hfx.link/1",
  "hourly": [
    {
      "fxTime": "2021-12-16T12:00+00:00",
      "temp": "-2",
      "icon": "150",
      "text": "Clear",
      "wind360": "285",
      "windDir": "NW",
      "windScale": "2",
      "windSpeed": "8",
      "humidity": "30",
      "precip": "0.0",
      "pressure": "1022",
      "cloud": "0",
      "dew": "-17"
    },
    {
      "fxTime": "2021-12-16T13:00+00:00",
      "temp": "-3",
      "icon": "150",
      "text": "Clear",
      "wind360": "289",
      "windDir": "NW",
      "windScale": "2",
      "windSpeed": "8",
      "humidity": "32",
      "precip": "0.0",
      "pressure": "1023",
      "cloud": "0",
      "dew": "-17"
    },
    {
      "fxTime": "2021-12-16T14:00+00:00",
      "temp": "-3",
      "icon": "150",
      "text": "Clear",
      "wind360": "293",
      "windDir": "NW",
      "windScale": "2",
      "windSpeed": "7",
      "humidity": "34",
      "precip": "0.0",
      "pressure": "1024",
      "cloud": "0",
      "dew": "-17"
    },
    {
      "fxTime": "2021-12-16T15:00+00:00",
      "temp": "-4",
      "icon": "150",
      "text": "Clear",
      "wind360": "296",
      "windDir": "NW",
      "windScale": "2",
      "windSpeed": "6",
      "humidity": "35",
      "precip": "0.0",
      "pressure": "1024",
      "cloud": "0",
      "dew": "-17"
    },
    {
      "fxTime": "2021-12-16T16:00+00:00",
      "temp": "-4",
      "icon": "150",
      "text": "Clear",
      "wind360": "294",
      "windDir": "NW",
      "windScale": "2",
      "windSpeed": "6",
      "humidity": "35",
      "precip": "0.0",
      "pressure": "1025",
      "cloud": "0",
      "dew": "-17"
    },
    {
      "fxTime": "2021-12-16T17:00+00:00",
      "temp": "-5",
      "icon": "150",
      "text": "Clear",
      "wind360": "290",
      "windDir": "NW",
      "windScale": "2",
      "windSpeed": "7",
      "humidity": "35",
      "precip": "0.0",
      "pressure": "1025",
      "cloud": "0",
      "dew": "-18"
    },
    {
      "fxTime": "2021-12-16T18:00+00:00",
      "temp": "-5",
      "icon": "150",
      "text": "Clear",
      "wind360": "280",
      "windDir": "W",
      "windScale": "2",
      "windSpeed": "8",
      "humidity": "33",
      "precip": "0.0",
      "pressure": "1025",
      "cloud": "0",
      "dew": "-19"
    },
    {
      "fxTime": "2021-12-16T19:00+00:00",
      "temp": "-6",
      "icon": "154",
      "text": "Overcast",
      "wind360": "277",
      "windDir": "W",
      "windScale": "2",
      "windSpeed": "9",
      "humidity": "30",
      "precip": "0.0",
      "pressure": "1026",
      "cloud": "6",
      "dew": "-20"
    },
    {
      "fxTime": "2021-12-16T20:00+00:00",
      "temp": "-6",
      "icon": "150",
      "text": "Clear",
      "wind360": "283",
      "windDir": "NW",
      "windScale": "2",
      "windSpeed": "9",
      "humidity": "29",
      "precip": "0.0",
      "pressure": "1026",
      "cloud": "0",
      "dew": "-21"
    },
    {
      "fxTime": "2021-12-16T21:00+00:00",
      "temp": "-7",
      "icon": "150",
      "text": "Clear",
      "wind360": "286",
      "windDir": "NW",
      "windScale": "2",
      "windSpeed": "9",
      "humidity": "27",
      "precip": "0.0",
      "pressure": "1026",
      "cloud": "0",
      "dew": "-22"
    },
    {
      "fxTime": "2021-12-16T22:00+00:00",
      "temp": "-7",
      "icon": "150",
      "text": "Clear",
      "wind360": "287",
      "windDir": "NW",
      "windScale": "2",
      "windSpeed": "8",
      "humidity": "27",
      "precip": "0.0",
      "pressure": "1026",
      "cloud": "0",
      "dew": "-23"
    },
    {
      "fxTime": "2021-12-16T23:00+00:00",
      "temp": "-7",
      "icon": "150",
      "text": "Clear",
      "wind360": "293",
      "windDir": "NW",
      "windScale": "1",
      "windSpeed": "5",
      "humidity": "28",
      "precip": "0.0",
      "pressure": "1027",
      "cloud": "0",
      "dew": "-23"
    },
    {
      "fxTime": "2021-12-17T00:00+00:00",
      "temp": "-7",
      "icon": "150",
      "text": "Clear",
      "wind360": "304",
      "windDir": "NW",
      "windScale": "1",
      "windSpeed": "3",
      "humidity": "27",
      "precip": "0.0",
      "pressure": "1027",
      "cloud": "0",
      "dew": "-23"
    },
    {
      "fxTime": "2021-12-17T01:00+00:00",
      "temp": "-7",
      "icon": "150",
      "text": "Clear",
      "wind360": "335",
      "windDir": "NW",
      "windScale": "1",
      "windSpeed": "4",
      "humidity": "24",
      "precip": "0.0",
      "pressure": "1028",
      "cloud": "0",
      "dew": "-24"
    },
    {
      "fxTime": "2021-12-17T02:00+00:00",
      "temp": "-6",
      "icon": "150",
      "text": "Clear",
      "wind360": "329",
      "windDir": "NW",
      "windScale": "2",
      "windSpeed": "8",
      "humidity": "20",
      "precip": "0.0",
      "pressure": "1028",
      "cloud": "0",
      "dew": "-25"
    },
    {
      "fxTime": "2021-12-17T03:00+00:00",
      "temp": "-5",
      "icon": "150",
      "text": "Clear",
      "wind360": "327",
      "windDir": "NW",
      "windScale": "3",
      "windSpeed": "14",
      "humidity": "17",
      "precip": "0.0",
      "pressure": "1029",
      "cloud": "0",
      "dew": "-26"
    },
    {
      "fxTime": "2021-12-17T04:00+00:00",
      "temp": "-4",
      "icon": "150",
      "text": "Clear",
      "wind360": "325",
      "windDir": "NW",
      "windScale": "3",
      "windSpeed": "14",
      "humidity": "16",
      "precip": "0.0",
      "pressure": "1028",
      "cloud": "0",
      "dew": "-26"
    },
    {
      "fxTime": "2021-12-17T05:00+00:00",
      "temp": "-3",
      "icon": "150",
      "text": "Clear",
      "wind360": "324",
      "windDir": "NW",
      "windScale": "3",
      "windSpeed": "16",
      "humidity": "15",
      "precip": "0.0",
      "pressure": "1026",
      "cloud": "0",
      "dew": "-26"
    },
    {
      "fxTime": "2021-12-17T06:00+00:00",
      "temp": "-2",
      "icon": "150",
      "text": "Clear",
      "wind360": "324",
      "windDir": "NW",
      "windScale": "3",
      "windSpeed": "15",
      "humidity": "14",
      "precip": "0.0",
      "pressure": "1025",
      "cloud": "0",
      "dew": "-25"
    },
    {
      "fxTime": "2021-12-17T07:00+00:00",
      "temp": "-1",
      "icon": "150",
      "text": "Clear",
      "wind360": "325",
      "windDir": "NW",
      "windScale": "3",
      "windSpeed": "12",
      "humidity": "13",
      "precip": "0.0",
      "pressure": "1025",
      "cloud": "0",
      "dew": "-26"
    },
    {
      "fxTime": "2021-12-17T08:00+00:00",
      "temp": "-1",
      "icon": "150",
      "text": "Clear",
      "wind360": "352",
      "windDir": "N",
      "windScale": "2",
      "windSpeed": "8",
      "humidity": "13",
      "precip": "0.0",
      "pressure": "1024",
      "cloud": "0",
      "dew": "-26"
    },
    {
      "fxTime": "2021-12-17T09:00+00:00",
      "temp": "-2",
      "icon": "150",
      "text": "Clear",
      "wind360": "44",
      "windDir": "NE",
      "windScale": "2",
      "windSpeed": "9",
      "humidity": "19",
      "precip": "0.0",
      "pressure": "1024",
      "cloud": "0",
      "dew": "-22"
    },
    {
      "fxTime": "2021-12-17T10:00+00:00",
      "temp": "-3",
      "icon": "150",
      "text": "Clear",
      "wind360": "52",
      "windDir": "NE",
      "windScale": "2",
      "windSpeed": "8",
      "humidity": "26",
      "precip": "0.0",
      "pressure": "1024",
      "cloud": "0",
      "dew": "-20"
    },
    {
      "fxTime": "2021-12-17T11:00+00:00",
      "temp": "-4",
      "icon": "154",
      "text": "Overcast",
      "wind360": "48",
      "windDir": "NE",
      "windScale": "2",
      "windSpeed": "6",
      "humidity": "29",
      "precip": "0.0",
      "pressure": "1023",
      "cloud": "91",
      "dew": "-19"
    }
  ],
  "refer": {
    "sources": [
      "QWeather"
    ],
    "license": [
      "commercial license"
    ]
  }
}
Parameters Description
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
hourly.fxTime

Forecast time
hourly.temp

temperature
hourly.icon

Icon code of weather conditions, free to download weather icons
hourly.text

Weather conditions
hourly.wind360

Wind direction in azimuth degree
hourly.windDir

Wind direction
hourly.windScale

Wind scale
hourly.windSpeed

Wind speed, KM/H
hourly.humidity

Relative humidity in percent
hourly.precip

Accumulated precipitation in the current hour
hourly.cloud

Cloud cover in percent, may be null
hourly.dew

Dew point temperature, may be null
refer.sources

Data source and other statements, may be null
refer.license

Data license, may be null