Skip to content

土壤温湿度 ​

目前仅支持中国区域实况数据,逐小时更新

请求 ​

http
GET https://api.caiyunapp.com/v1/soil

查询参数 ​

参数必填默认值取值范围说明
token是——API 认证凭证,详见 认证与鉴权
lng是——经度
lat是——纬度

请求示例 ​

bash
curl "https://api.caiyunapp.com/v1/soil?token={token}&lng=116&lat=39"

响应示例 ​

json
{
  "status": "ok",
  "result": {
    "soil": [
      {
        "depth": "0-0.1",
        "tsoil": 3.100006103515625,
        "soliw": 0.1529541015625
      },
      {
        "depth": "0.1-0.4",
        "tsoil": 4.850006103515625,
        "soliw": 0.237060546875
      }
    ],
    "meta": {
      "updated_at": 1640248183, // 数据更新时间
      "datatime": 1640246400 // 数据批次时间
    }
  }
}

响应字段 ​

JSONPath类型说明
$.statusstring请求状态
$.result.soilarray<object>土壤分层数据
$.result.soil[].depthstring土壤深度范围
$.result.soil[].tsoilnumber土壤温度
$.result.soil[].soliwnumber土壤含水量
$.result.meta.updated_atnumber数据更新时间戳
$.result.meta.datatimenumber数据批次时间戳