Grid Weather Real-time

Weather forecast data based on numerical models, to provide current weather data 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/now

Parameters#

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/now?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-27T18:00+08:00",
  "fxLink": "https://www.qweather.com",
  "now": {
    "obsTime": "2023-05-27T10:00+00:00",
    "temp": "31",
    "icon": "101",
    "text": "Cloudy",
    "wind360": "184",
    "windDir": "S",
    "windScale": "3",
    "windSpeed": "15",
    "humidity": "78",
    "precip": "0.0",
    "pressure": "1004",
    "cloud": "31",
    "dew": "27"
  },
  "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
now object Current weather data
- obsTime date-time Observation time
- 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