Station Radar

Access Restriction

This API is a premium service available only to enterprise tier developers. Please contact Caiyun Sales to purchase.

Returns single-station radar images for the radar site nearest to the requested coordinates. Access must be enabled per radar station.

Response fields and visualization are the same as the level=1 single-station endpoints in Radar.

Realtime

Request

GET https://api.caiyunapp.com/v1/radar/station/images

Query Parameters

Name	Required	Default	Range	Description
token	Yes	—	—	API token; see Authentication
lon	Yes	—	—	Longitude
lat	Yes	—	—	Latitude

Request Example

curl "https://api.caiyunapp.com/v1/radar/station/images?lon=116.427301&lat=39.902451&token={token}"

Response Example

{
  "status": "ok",
  "timezone": "Asia/Shanghai",
  "tzshift": 28800,
  "station": "NMIC_AZ9010",
  "images": [
    [
      "http://cdn-s.caiyunapp.com/weather/radar/color/AZ9010_1640780414_1640780414_ab4b91d31f3f45bca005040f96f42041.png?auth_key=xxx",
      1640780414,
      [
        37.742471186275736,
        113.78227438031607,
        41.874723213724266,
        119.16149781968394
      ]
    ]
  ]
}

Response Fields

JSONPath	Type	Description
$.status	string	Request status
$.timezone	string	Radar station timezone
$.tzshift	number	Timezone offset in seconds
$.station	string	Matched radar station ID
$.images	array<array>	Image URL, timestamp, and coordinate bounds entries

Notes

• Matches the nearest radar station to the requested coordinates and returns the latest 20 realtime frames, one every 4–6 minutes.
• The token must have permission for the matched station at /v1/radar/station/images/{station_id}, where {station_id} is the station field in the response.

Forecast

Request

GET https://api.caiyunapp.com/v1/radar/station/forecast_images

Query Parameters

Name	Required	Default	Range	Description
token	Yes	—	—	API token; see Authentication
lon	Yes	—	—	Longitude
lat	Yes	—	—	Latitude

Request Example

curl "https://api.caiyunapp.com/v1/radar/station/forecast_images?lon=116.427301&lat=39.902451&token={token}"

Response Example

{
  "status": "ok",
  "station": "NMIC_AZ9010",
  "images": [
    [
      "http://cdn-s.caiyunapp.com/weather/radar/color/AZ9010_1640780414_1640780414_ab4b91d31f3f45bca005040f96f42041.png?auth_key=xxx",
      1640780414,
      [
        37.742471186275736,
        113.78227438031607,
        41.874723213724266,
        119.16149781968394
      ]
    ]
  ]
}

Response Fields

JSONPath	Type	Description
$.status	string	Request status
$.station	string	Matched radar station ID
$.images	array<array>	Image URL, timestamp, and coordinate bounds entries

Notes

• Returns the latest realtime frame plus 2-hour forecast frames, 25 frames total, one every 4–6 minutes.
• The token must have permission for the matched station at /v1/radar/station/forecast_images/{station_id}, where {station_id} is the station field in the response.