实况

返回指定地点当前时刻的实况天气数据，包括气温、湿度、云量、天气现象、风、气压、体感温度、降水、空气质量和生活指数等。

更新频率与空间分辨率

实况数据为分钟级持续刷新（通常 1-5 分钟），空间分辨率为 1 km 级（局地受站点覆盖影响）。详情见 时空变量覆盖情况。

请求

GET https://api.caiyunapp.com/v2.6/{token}/{经度},{纬度}/realtime

路径参数

参数	说明
token	API 认证凭证，详见 认证与鉴权
经度	目标地点经度
纬度	目标地点纬度

注意：URL 路径中经度在前、纬度在后（如 101.6656,39.2072）；响应中的 location 字段为 [纬度, 经度] 顺序（如 [39.2072, 101.6656]）。

查询参数

参数	必填	默认值	取值范围	说明
lang	否	zh_CN	zh_CN、zh_TW、en_US、en_GB、ja	返回语言；未匹配时回落 zh_CN，详见 语言
unit	否	metric	metric、metric:v1、metric:v2、SI、imperial	单位制；其他取值报 422，详见 单位制
alert	否	false	true、false	alert=true 且 token 有预警权限时，响应附带 result.alert 块，详见 预警数据
callback	否	—	—	JSONP 包装

请求示例

curl "https://api.caiyunapp.com/v2.6/TAkhjf8d1nlSlspN/101.6656,39.2072/realtime"

{
  "status": "ok",             // 返回状态
  "api_version": "v2.6",    // API 版本
  "api_status": "active",     // API 服务状态
  "lang": "zh_CN",          // 返回语言
  "unit": "metric",        // 单位
  "tzshift": 28800,       // 时区偏移
  "timezone": "Asia/Shanghai",  // 时区
  "server_time": 1640745758,
  "location": [39.2072, 101.6656],  // [纬度, 经度]
  "result": {
    "realtime": {
      "status": "ok",
      "temperature": -7,  // 地表 2 米气温
      "humidity": 0.58,  // 地表 2 米相对湿度(0-1)
      "cloudrate": 0,  // 总云量(0.0-1.0)
      "skycon": "CLEAR_DAY",  // 天气现象
      "visibility": 7.8,  // 地表水平能见度
      "dswrf": 47.7,  // 向下短波辐射通量(W/M2)
      "wind": {
        "speed": 1.8,  // 地表 10 米风速
        "direction": 22  // 地表 10 米风向
      },
      "pressure": 85583.47,  // 地面气压
      "apparent_temperature": -9.9,  // 体感温度
      "precipitation": {
        "local": {
          "status": "ok",
          "datasource": "radar",  // 本地降水数据源（雷达覆盖区为 radar）
          "intensity": 0  // 本地降水强度（unit=metric 时为雷达降水强度 0~1，unit=metric:v2 时为 mm/h）
        },
        "nearest": {  // 仅雷达覆盖区返回
          "status": "ok",
          "distance": 10000,  // 最近降水带与本地的距离
          "intensity": 0  // 最近降水处的降水强度
        }
      },
      "air_quality": {
        "pm25": 45,  // PM25 浓度(μg/m3)
        "pm10": 49,  // PM10 浓度(μg/m3)
        "o3": 6,  // 臭氧浓度(μg/m3)
        "so2": 8,  // 二氧化硫浓度(μg/m3)
        "no2": 42,  // 二氧化氮浓度(μg/m3)
        "co": 1.1,  // 一氧化碳浓度(mg/m3)
        "aqi": {
          "chn": 63,  // 国标 AQI
          "usa": 124  // 美标 AQI
        },
        "description": {
          "chn": "良",
          "usa": "轻度污染"
        }
      },
      "life_index": {  // 生活指数
        "ultraviolet": {
          "index": 3,
          "desc": "弱"  // 参见 [生活指数](tables/lifeindex)
        },
        "comfort": {
          "index": 12,
          "desc": "湿冷"  // 参见 [生活指数](tables/lifeindex)
        }
      }
    },
    "primary": 0
  }
}

响应字段

JSONPath $.result.realtime.	说明
temperature	地表 2 米气温
apparent_temperature	体感温度
pressure	地面气压
humidity	地表 2 米相对湿度(0-1)
wind.direction	地表 10 米风向
wind.speed	地表 10 米风速
precipitation.local.datasource	本地降水数据源，雷达覆盖区为 radar
precipitation.local.intensity	本地降水强度：unit=metric 时为雷达降水强度(0~1)，unit=metric:v2 时为 mm/h，详见 降水强度
precipitation.nearest.distance	最近降水带与本地的距离；仅雷达覆盖区返回
precipitation.nearest.intensity	最近降水处的降水强度；仅雷达覆盖区返回，单位同 precipitation.local.intensity
cloudrate	总云量(0.0-1.0)
dswrf	向下短波辐射通量(W/M2)
visibility	地表水平能见度
skycon	天气现象
life_index.comfort.desc	参见 生活指数
life_index.ultraviolet.desc	参见 生活指数
air_quality.pm25	PM25 浓度(μg/m3)
air_quality.pm10	PM10 浓度(μg/m3)
air_quality.o3	臭氧浓度(μg/m3)
air_quality.no2	二氧化氮浓度(μg/m3)
air_quality.so2	二氧化硫浓度(μg/m3)
air_quality.co	一氧化碳浓度(mg/m3)
air_quality.aqi.chn	国标 AQI，详见 环境空气质量
air_quality.aqi.usa	美标 AQI，详见 环境空气质量

备注

• precipitation.nearest 仅雷达覆盖区返回，非雷达覆盖区不返回 nearest。
• 空气质量浓度单位：pm25/pm10/o3/so2/no2 为 μg/m3，co 为 mg/m3；aqi 含国标（chn）与美标（usa），详见 环境空气质量。

错误

接口错误统一返回如下结构，HTTP 状态码与含义详见 错误信息。

{
  "status": "failed",
  "error": "token is invalid",
  "api_version": "2.6"
}