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

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
  • langMulti-language setting, please see Language to find out how our multi-language works and how to set up.
  • unitSet weather data unit, the available value are unit=m for metric(default) and unit=i for imperial. See more about Unit.

Request Example

curl -X GET --compressed \
-H 'Authorization: Bearer your_token' \
'https://api.qweather.com/v7/grid-weather/now?location=116.41,39.92'

Replace your_token with your JWT or learn more about Authentication

Response

The response is in JSON format and is Gzip compressed.

{
  "code": "200",
  "updateTime": "2021-12-16T18:25+08:00",
  "fxLink": "https://www.qweather.com",
  "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": [
      "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
  • now.obsTime Observation time
  • now.temp temperature
  • now.icon Icon code for weather conditions. See also QWeather 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 last 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