因子（factor）对照表

本页汇总平台使用的传感器因子英文缩写及其中文名称、单位、出现位置。

数据来源

本表以真实调用结果为准。标注「实测」的因子均在接口返回中实际出现过， 其单位也来自真实返回；标注「扩展」的因子来自平台内部对照表， 是否在所有设备上都可用、单位与量程如何，请以实际返回为准。

因子速查表

实测因子（在真实返回中出现过）

因子	中文名称	实测单位	出现位置	备注
atc	空气温度	℃	/api/sensor-data、/api/weather-data/*	所有设备
ahc	空气湿度	%	/api/sensor-data、/api/weather-data/*	控制器
stc	土壤温度	℃	/api/sensor-data、/api/weather-data/*	控制器
swc	土壤湿度	%	/api/sensor-data、/api/weather-data/*	控制器
co2	二氧化碳	PPM	/api/sensor-data、/api/weather-data/*	控制器
light	光亮度	klux / Klux	/api/sensor-data、/api/weather-data/*	单位大小写随接口变化
lp	液位	m	/api/sensor-data、/api/weather-data/*	施肥机；多路，用 order 区分
ecfii	EC 注肥强度	%	/api/sensor-data、/api/weather-data/*	施肥机
phfii	PH 注肥强度	%	/api/sensor-data、/api/weather-data/*	施肥机

扩展因子（平台对照表，未在实测返回中出现）

因子	中文名称	典型单位	说明
ph	PH 值	暂未定义	是否可用请以实际返回为准
ec	EC 值（电导率）	暂未定义	同上
wtc	水温	暂未定义	同上
wl	水位	暂未定义	同上
aws	风速	暂未定义	同上
awd	风向	暂未定义	同上
apt	降雨量	暂未定义	同上
sleet	降雪	暂未定义	同上
ic	虫数量	暂未定义	同上

需要完整因子清单？

调用 设备列表 拿到 deviceTypeId， 再用 批量读控制参数 或 历史数据 拉一台真实设备的数据， 从返回的 icon / factor 字段反推该设备实际支持的因子。

swc 的中文名在不同接口里不一致

接口	实际出现的中文名
/api/sensor-data	土壤湿度
/api/weather-data/list 的 displayName	土壤湿度
/api/weather-data/avg 返回体的中文键	土壤湿度

文档早期版本中该因子曾出现「土壤含水量」的叫法。 做中英文映射时请按 factor（英文缩写）作为唯一键，不要依赖中文名。

因子在哪几个接口里出现

1. /api/sensor-data（实时数据）

以 factor 字段返回：

{ "name": "空气温度", "factor": "atc", "value": 26.7, "unit": "℃" }

2. /api/weather-data/list（历史数据）

以 name / displayName / icon 字段返回，name 带传感器序号后缀：

{
  "name": "atc_1",
  "displayName": "1#空气温度",
  "icon": "atc",
  "value": 28.0,
  "unit": "℃",
  "number": "1"
}

从 name 还原因子名

规则是 因子名_传感器序号。还原方法：取 _ 之前的部分，或用 icon 字段（通常就等于因子名）。

3. /api/weather-data/avg（聚合曲线）

请求用英文因子名（fields=atc,ahc），返回是中文名作 key：

{ "空气温度": 14.2, "空气湿度": 93.6, "createDate": "00" }

英文因子名 → 中文返回键 的映射

请求 fields	返回体中文键
atc	空气温度
ahc	空气湿度
stc	土壤温度
swc	土壤含水量
co2	二氧化碳
light	光照

可直接使用的映射表

Python

FACTOR_CN = {
    "atc": "空气温度",
    "ahc": "空气湿度",
    "stc": "土壤温度",
    "swc": "土壤湿度",
    "co2": "二氧化碳",
    "light": "光照",
    "ph": "PH值",
    "ec": "EC值",
    "wtc": "水温",
    "wl": "水位",
    "aws": "风速",
    "awd": "风向",
    "apt": "降雨量",
    "sleet": "降雪",
    "ic": "虫数量",
}

# 聚合接口返回体的中文键 → 英文因子
CN_TO_FACTOR = {
    "空气温度": "atc",
    "空气湿度": "ahc",
    "土壤温度": "stc",
    "土壤含水量": "swc",
    "二氧化碳": "co2",
    "光照": "light",
}


def split_factor(name: str) -> str:
    """把 'atc_1' 还原为 'atc'。"""
    return name.split("_", 1)[0]

JavaScript / TypeScript

export const FACTOR_CN = {
  atc: '空气温度', ahc: '空气湿度', stc: '土壤温度', swc: '土壤湿度',
  co2: '二氧化碳', light: '光照', ph: 'PH值', ec: 'EC值',
  wtc: '水温', wl: '水位', aws: '风速', awd: '风向',
  apt: '降雨量', sleet: '降雪', ic: '虫数量'
}

export const FACTOR_UNIT = {
  atc: '℃', ahc: '%', stc: '℃', swc: '%', co2: 'PPM', light: 'Klux'
}

export const splitFactor = (name) => name.split('_')[0]

传感器类型序号（sensorType）

/api/sensor-data 的返回项里带 sensorType 字段。示例中：

sensorType	对应因子	说明
1	atc	空气温度
2	ahc	空气湿度

其他序号暂未定义

完整对照表平台文档未收录内。请从 /api/sensor-data 的实际返回中 按「sensorType ↔ factor」成对采集并自行建立映射。

注意事项

不要按中文名做唯一键

同一因子在不同接口里有不同中文名（如 swc = 土壤湿度 / 土壤含水量 / 1#土壤湿度）， 中文名不是稳定的标识符。请始终用 factor 字段（英文缩写）作为键。

单位可能随因子或设备配置变化

本表列出的单位来自示例。实际单位请以返回体中的 unit 字段为准 （例如 light 在示例中是 Klux，实际设备可能用 Lux）。

下一步

• → 传感器实时数据：因子在实时接口中的形态
• → 历史数据：name 带序号后缀
• → 聚合数据（曲线）：请求英文、返回中文