Grid Weather Daily Forecast
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 Gridhttps://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
-
lang
Multi-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. -
unit
Set weather data unit, the available value areunit=m
for metric(default) andunit=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": "https://www.qweather.com",
"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": [
"QWeather Developers License"
]
}
}
-
code
See 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. See also QWeather Icons -
daily.textDay
Weather conditions for daytime -
daily.iconNight
Icon code for night weather conditions. See also QWeather 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