Grid Weather Real-time

Platform: API iOS Android

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

/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
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://your_api_host/v7/grid-weather/now?location=116.41,39.92'

Replace your_token and your_api_host with your JWT Authentication and API Host

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