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. This is a premium product — access must be enabled per radar station. Please contact Caiyun Sales.

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

Realtime

Method: GET

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

Parameters:

Parameter	Description	Example
token	API token	`token=UpxxxxxxxxxxAm`
lon	Longitude	`lon=116.427301`
lat	Latitude	`lat=39.902451`

Example:

bash

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

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

Response example:

json

{
  "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
      ]
    ]
  ]
}

Forecast