Grid Weather Real-time

Platform: API

Get high-precision real-time weather at any latitude and longitude around the world.

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

Request URL

https://api.qweather.com/v7/grid-weather/now?[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.

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
key(required)API authentication key, please refer to How To Get Your Key. Support Signature Authentication. Example: key=12334567890ABC
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

Real-time grid weather for 116.41N, 39.92E

curl -L -X GET --compressed 'https://api.qweather.com/v7/grid-weather/now?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:25+08:00",
  "fxLink": "http://hfx.link/1",
  "now": {
    "obsTime": "2021-12-16T10:00+00:00",
    "temp": "-1",
    "icon": "150",
    "text": "晴",
    "wind360": "287",
    "windDir": "西北风",
    "windScale": "2",
    "windSpeed": "10",
    "humidity": "27",
    "precip": "0.0",
    "pressure": "1021",
    "cloud": "0",
    "dew": "-17"
  },
  "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
now.obsTime Observation time
now.temp temperature
now.icon Icon code of weather conditions, free to download weather icons
now.text Weather conditions
now.wind360 Wind direction in azimuth degree
now.windDir Wind direction
now.windScale Wind scale
now.windSpeed Wind speed, KM/H
now.humidity Relative humidity in percent
now.precip Accumulated precipitation in the current hour
now.pressure Atmospheric pressure, hPa
now.cloud Cloud cover in percent, may be null
now.dew Dew point temperature, may be null
refer.sources Data source and other statements, may be null
refer.license Data license, may be null