综合

支持打包 realtime, minutely, hourly, daily 及 alert 数据

Update Frequency and Spatial Resolution

The combined weather endpoint follows the update frequency and spatial resolution of each included data type. For details, see Variable Coverage.

Data Type	Update Frequency	Spatial Resolution
Real-time weather data	1 minute	1 km × 1 km
Minute-level precipitation data	1 minute	1 km × 1 km
Hourly forecast data	15 minutes	5 km × 5 km
Daily forecast data	2 hours	12 km × 12 km

Alert information is synchronized with the Central Meteorological Bureau and is returned by alert area and administrative division. Grid spatial resolution does not apply.

Request Example

bash

curl "https://api.caiyunapp.com/v2.6/TAkhjf8d1nlSlspN/116.3176,39.9760/weather?alert=true&dailysteps=1&hourlysteps=24"

json

{
  "status": "ok",
  "api_version": "v2.6",
  "api_status": "active",
  "lang": "zh_CN",
  "unit": "metric",
  "tzshift": 28800,
  "timezone": "Asia/Shanghai",
  "server_time": 1640758065,
  "location": [39.976, 116.3176],
  "result": {
    "alert": {
      //
    },
    "realtime": {
      //
    },
    "minutely": {
      //
    },
    "hourly": {
      //
    },
    "daily": {
      //
    },
    "primary": 0,
    "forecast_keypoint": "未来两小时不会下雨，放心出门吧"
  }
}

description & forecast_keypoint

For the weather (combined) endpoint they differ:

result.hourly.description: 24-hour weather description, same as the hourly endpoint’s description.
result.forecast_keypoint: Short-term (next 2 hours) key changes, for highlighting in the UI or “coming soon”–style hints.

综合 ​

Update Frequency and Spatial Resolution ​

Request Example ​

综合

Update Frequency and Spatial Resolution

Request Example