跳至主要内容

清扫机器人

获取电站下机器人列表​

接口描述​

通过电站id获取电站下绑定的机器人信息。

请求方法​

/clean/robots/getRobotListStationId

请求方式​

POST

请求参数​

Body 请求参数示例

{
  "monitorId": "XXX",
  "page": 1,
  "pageSize": 99
}
名称位置类型必选中文名说明
X-Access-Tokenheaderstring是token
bodybodyjson是
» monitorIdbodyLong是电站id
» pagebodyinteger是当前页
» pageSizebodyinteger是当前页大小

返回数据结构​

状态码 200

名称类型必选约束中文名说明
» successbooleantrue
» messagestringtrue
» codeintegertrue
» resultList<Map>true
»» recordsList<Map>true机器人详情
»»» idLongfalse机器人id
»»» createTimestringfalse创建日期
»»» updateTimestringfalse更新时间
»»» accessAccountIdLongfalse接入账号id
»»» keyIdLongfalse恒为系统机器人id
»»» siteIdLongfalse电站id
»»» workMapIdStringfalse作业地图id
»»» modelstringfalse机器人型号
»»» serialNumberstringfalse机器人序列号
»»» siteNamestringfalse电站名称
»»» workingMapNamestringfalse作业地图名称
»»» leftFrontEdgestringfalse左前避障状态避障、正常
»»» leftRearEdgestringfalse左后避障状态避障、正常
»»» rightFrontEdgestringfalse右前避障状态避障、正常
»»» rightRearEdgestringfalse右后避障状态避障、正常
»»» powerOnRunningDurationLongfalse上电运行时长(秒)
»»» powerOnStartupNumberLongfalse上电启动次数
»»» controlModestringfalse控制模式manual手动、automatic自动
»»» inboundOutboundModestringfalse出入库模式normal正常、forcedInBound强制入库、forcedOutBound强制出库
»»» robotPauseStatusstringfalse机器人暂停状态forcedStop强制停止、unforcedStop解除强制停止
»»» cleaningTaskPauseStatusstringfalse清扫任务暂停状态suspend暂停、resume恢复
»»» robotStatusstringfalse机器人状态返回的是状态的中文描述，可以直接显示
»»» hardwareStatusstringfalse硬件状态返回的是状态的中文描述，可以直接显示
»»» communicationStatusstringfalse通讯状态0离线、1在线
»»» batteryPercentageDoublefalse电池电量(百分比)
»»» robotNamestringfalse机器人名称
»»» accumulatedCleaningDistanceDoublefalse累计清扫里程(米)
»»» accumulatedDrivingDistanceDoublefalse累计行驶里程(米)
»»» altitudeintegerfalse高度
»»» angularVelocityDoublefalse角速度(弧度/秒)
»»» batteryCurrentintegerfalse电池电流
»»» brushSpeedDoublefalse毛刷转速(转/秒)
»»» cleaningDurationDoublefalse清扫时长(秒)
»»» cleaningProgressDoublefalse清扫进度(百分比)
»»» cleaningTaskidLongfalse清扫任务ID
»»» latitudeDoublefalse纬度
»»» latitudeTypestringfalse纬度类型 E东经 W西经
»»» linearVelocityDoublefalse线速度(米/秒)
»»» longitudeDoublefalse经度
»»» longitudeTypestringfalse经度类型 N北纬 S南纬
»»» maxBatteryTemperatureDoublefalse电池最高温度(摄氏度)
»»» minBatteryTemperatureDoublefalse电池最低温度(摄氏度)
»»» positioningModestringfalse定位模式“RTK fixed”
»»» powerOnCleaningDistanceDoublefalse上电清扫里程(米)
»»» powerOnDrivingDistanceDoublefalse上电行驶里程(米)
»»» yawAngleDoublefalse偏航角度
»»» isDeleteintegerfalse是否删除 0未删除 1删除
»»» monitorStationstringfalse电站状态
»»» monitorIdLongfalse电站id
»»» forwardPhotosstringfalse正向图'
»»» forwardPhotosUploadStatusintegerfalse正向图上传状态0或null:未上传 1：已上传
»»» assetsViewStatusintegerfalse视图标记状态
»»» keepYearsIntegerfalse质保年限
»»» keepStartTimeDatefalse质保开始时间
»»» keepEndTimeDatefalse质保结束时间
»»» areaDivideIdLongfalse区域划分Id
»»» areaDivideNamestringfalse区域划分名称
»»» provinceStringfalse省
»»» cityStringfalse市
»»» areaStringfalse区
»»» provinceIdStringfalse省id
»»» cityIdStringfalse市id
»»» areaIdStringfalse区id
»»» plantWeatherstringfalse电站天气
»»» plantTemperaturestringfalse电站温度
»»» workingMapIframestringfalse作业地图Iframe地址
»»» videoIframestringfalse实时视频照片Iframe地址
»»» robotControlIframeStringfalse机器人控制Iframe地址
»»» appKeyStringfalseappKey
»»» appSecretStringfalseappSecret
»»» iconstringfalse天气图片
»»» todayWorkingPlanstringfalse今日清扫计划
»» totalintegertrue电站下机器人数量
»» sizeintegertrue当前页大小
»» currentintegertrue当前页
»» orders[string]true
»» optimizeCountSqlbooleantrue
»» hitCountbooleantrue
»» searchCountbooleantrue
»» pagesintegertrue
» timestampintegertrue响应时间戳

返回示例​

{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": {
    "records": [
      {
        "id": 5,
        "createTime": "2024-02-19 21:25:13",
        "updateTime": "2024-12-17 11:14:00",
        "accessAccountId": 23,
        "keyId": "58",
        "siteId": "91",
        "workMapId": "688",
        "model": "PCR-100-P",
        "serialNumber": "406R4260021",
        "siteName": "XXXXX",
        "workingMapName": "XXXX",
        "leftFrontEdge": "正常",
        "leftRearEdge": "正常",
        "rightFrontEdge": "正常",
        "rightRearEdge": "正常",
        "powerOnRunningDuration": 603533,
        "powerOnStartupNumber": 103,
        "controlMode": "automatic",
        "inboundOutboundMode": "forcedInbound",
        "robotPauseStatus": "unforcedStop",
        "cleaningTaskPauseStatus": "resume",
        "robotStatus": "充电中",
        "hardwareStatus": "正常",
        "communicationStatus": "在线",
        "batteryPercentage": 97,
        "robotName": "XXXXX",
        "accumulatedCleaningDistance": 679057.8849249192,
        "accumulatedDrivingDistance": 947548.4422362257,
        "altitude": 0,
        "angularVelocity": -0.0038054860372037725,
        "batteryCurrent": 0,
        "brushSpeed": -0.000128125,
        "cleaningDuration": 108913,
        "cleaningProgress": 0,
        "cleaningTaskid": "44644",
        "latitude": 31.894551520598807,
        "latitudeType": "N",
        "linearVelocity": -0.00015785207513407671,
        "longitude": 121.0514076471839,
        "longitudeType": "E",
        "maxBatteryTemperature": 15.1,
        "minBatteryTemperature": 12.2,
        "positioningMode": "RTK fixed",
        "powerOnCleaningDistance": 0.7549249193085904,
        "powerOnDrivingDistance": 1721.0242362256242,
        "yawAngle": 166.8881142440764,
        "isDelete": 0,
        "monitorStation": "XXXXX",
        "monitorId": 43223,
        "forwardPhotos": "operation/43223/11/5/8_1714034056889.png",
        "forwardPhotosUploadStatus": 1,
        "assetsViewStatus": 1,
        "keepYears": null,
        "keepStartTime": null,
        "keepEndTime": null,
        "areaDivideId": 108,
        "areaDivideName": "设备类型全",
        "province": null,
        "city": null,
        "area": null,
        "provinceId": null,
        "cityId": null,
        "areaId": null,
        "plantWeather": "晴",
        "plantTemperature": "11",
        "workingMapIframe": "hXXXXX",
        "videoIframe": "XXXXX",
        "robotControlIframe": null,
        "appKey": null,
        "appSecret": null,
        "icon": "100",
        "todayWorkingPlan": "17, 16, 15, 14, 13, 12, 11, 10, 9, 8, 18"
      }
    ],
    "total": 1,
    "size": 20,
    "current": 1,
    "orders": [],
    "optimizeCountSql": true,
    "hitCount": false,
    "searchCount": true,
    "pages": 1
  },
  "timestamp": 1734405240455
}

电站详情-设备-清扫机器人​

接口描述​

通过清扫状态，电站ID，接入状态获取电站下机器人列表。

请求方法​

/clean/robots/getRobotListStationId

请求方式​

POST

请求参数​

名称位置类型必选中文名说明
bodybodyobject否
» monitorIdbodystring是机器人 id
» namebodystring是机器人名称
» cleanStatusbodystring是清扫状态
» communicationStatusbodystring是通讯状态
» hardwareStatusbodystring是硬件状态
» pagebodyinteger是页数
» pageSizebodyinteger是页码

Body 请求参数示例​

{
  "monitorId": "43220",
  "name": "",
  "cleanStatus": "",
  "communicationStatus": "",
  "hardwareStatus": "",
  "page": 1,
  "pageSize": 20
}

返回数据结构​

状态码 200

名称类型必选约束中文名说明
» successbooleantrue
» messagestringtrue
» codeintegertrue
» resultobjecttrue
»» records[object]true
»»» idintegerfalseid
»»» createTimestringfalse创建时间
»»» updateTimestringfalse更新时间
»»» accessAccountIdintegerfalse访问帐户 id
»»» keyIdstringfalse机器人 id
»»» siteIdstringfalse电站 id
»»» workMapIdstringfalse作业地图 id
»»» modelstringfalse机器人型号
»»» serialNumberstringfalse机器人序列号
»»» siteNamestringfalse电站名称
»»» workingMapNamestringfalse作业地图名称
»»» leftFrontEdgestringfalse左前避障状态
»»» leftRearEdgestringfalse左后避障状态
»»» rightFrontEdgestringfalse右前避障状态
»»» rightRearEdgestringfalse右后避障状态
»»» powerOnRunningDurationintegerfalse上电运行时长(秒)
»»» powerOnStartupNumberintegerfalse上电启动次数
»»» controlModestringfalse控制模式
»»» inboundOutboundModestringfalse入库出库模式
»»» robotPauseStatusstringfalse机器人暂停状态
»»» cleaningTaskPauseStatusstringfalse清扫任务暂停状态
»»» robotStatusstringfalse机器人状态
»»» hardwareStatusstringfalse硬件状态
»»» communicationStatusstringfalse通讯状态
»»» batteryPercentageintegerfalse电池电量(百分比)
»»» robotNamestringfalse机器人名称
»»» accumulatedCleaningDistancenumberfalse累计清扫里程(米)
»»» accumulatedDrivingDistancenumberfalse累计行驶里程(米)
»»» altitudeintegerfalse高度
»»» angularVelocitynumberfalse角速度
»»» batteryCurrentnumberfalse电池电流
»»» brushSpeednumberfalse毛刷转速
»»» cleaningDurationintegerfalse清扫时长
»»» cleaningProgressnumberfalse清扫进度
»»» cleaningTaskidstringfalse清扫任务 id
»»» latitudenumberfalse纬度
»»» latitudeTypestringfalse纬度类型
»»» linearVelocitynumberfalse线速度(米/秒)
»»» longitudenumberfalse经度
»»» longitudeTypestringfalse经度类型
»»» maxBatteryTemperaturenumberfalse电池最高温度
»»» minBatteryTemperaturenumberfalse电池最低温度
»»» positioningModestringfalse定位模式
»»» powerOnCleaningDistancenumberfalse上电清扫里程(米)
»»» powerOnDrivingDistancenumberfalse上电行驶里程(米)
»»» yawAnglenumberfalse偏航角度
»»» isDeleteintegerfalse是否删除
»»» monitorStationstringfalse监控电站
»»» monitorIdintegerfalse电站 id
»»» forwardPhotosnullfalse转发照片
»»» forwardPhotosUploadStatusnullfalse转发照片上传状态
»»» assetsViewStatusnullfalse资产状态
»»» keepYearsnullfalse质保年限
»»» keepStartTimenullfalse质保开始时间
»»» keepEndTimenullfalse质保结束时间
»»» areaDivideIdnullfalse区域划分 Id
»»» areaDivideNamenullfalse区域划分名称
»»» provincenullfalse省
»»» citynullfalse市
»»» areanullfalse区
»»» provinceIdnullfalse省 id
»»» cityIdnullfalse市 id
»»» areaIdnullfalse区 id
»»» plantWeatherstringfalse电站天气
»»» plantTemperaturestringfalse电站温度
»»» workingMapIframestringfalse工作地图框架
»»» videoIframestringfalse视频框架
»»» robotControlIframenullfalseAI 润色 20/5000 机器人控制框架
»»» appKeynullfalseappkey
»»» appSecretnullfalseapp 密钥
»»» iconstringfalse图标
»»» todayWorkingPlannullfalse今日工作计划
»» totalintegertrue总数
»» sizeintegertrue页码
»» currentintegertrue当前页
»» orders[string]true
»» optimizeCountSqlbooleantrue
»» hitCountbooleantrue
»» searchCountbooleantrue
»» pagesintegertrue总页数
» timestampintegertrue

返回示例​

{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": {
    "records": [
      {
        "id": 55,
        "createTime": "2024-10-12 15:22:51",
        "updateTime": "2025-01-24 11:21:14",
        "accessAccountId": 23,
        "keyId": "156",
        "siteId": "77",
        "workMapId": "981",
        "model": "PCR-200-P",
        "serialNumber": "ZR2P240601007",
        "siteName": "新纺联3.6MWp工商业电站",
        "workingMapName": "新纺联地图",
        "leftFrontEdge": "正常",
        "leftRearEdge": "正常",
        "rightFrontEdge": "正常",
        "rightRearEdge": "正常",
        "powerOnRunningDuration": 764822,
        "powerOnStartupNumber": 31,
        "controlMode": "automatic",
        "inboundOutboundMode": "normal",
        "robotPauseStatus": "unforcedStop",
        "cleaningTaskPauseStatus": "resume",
        "robotStatus": "清扫中",
        "hardwareStatus": "正常",
        "communicationStatus": "在线",
        "batteryPercentage": 65,
        "robotName": "新纺联机器人",
        "accumulatedCleaningDistance": 301291.33666095504,
        "accumulatedDrivingDistance": 421960.2952652232,
        "altitude": 0,
        "angularVelocity": -0.6332540069654552,
        "batteryCurrent": -2.32,
        "brushSpeed": 1.4975686246050963,
        "cleaningDuration": 13654,
        "cleaningProgress": 51.40042600759258,
        "cleaningTaskid": "60654",
        "latitude": 31.33095017653011,
        "latitudeType": "N",
        "linearVelocity": -0.06859667506067926,
        "longitude": 121.1793433124052,
        "longitudeType": "E",
        "maxBatteryTemperature": 22.6,
        "minBatteryTemperature": 20.7,
        "positioningMode": "RTK fixed",
        "powerOnCleaningDistance": 29197.28366102189,
        "powerOnDrivingDistance": 42385.44226529036,
        "yawAngle": 89.02392551042028,
        "isDelete": 0,
        "monitorStation": "*新纺联",
        "monitorId": 43220,
        "forwardPhotos": null,
        "forwardPhotosUploadStatus": null,
        "assetsViewStatus": null,
        "keepYears": null,
        "keepStartTime": null,
        "keepEndTime": null,
        "areaDivideId": null,
        "areaDivideName": null,
        "province": null,
        "city": null,
        "area": null,
        "provinceId": null,
        "cityId": null,
        "areaId": null,
        "plantWeather": "晴",
        "plantTemperature": "13",
        "workingMapIframe": "https://clean.i-pv.cn/#/v1/robot/working_map?app-key=e2aa1db60acf43719898110f87e51c79&timestamp=1737688878153&nonce=e12e72dd64684abcbe14bbe795d089b6&robot_id=156&signature=%2FIcHlEjh%2BRj0%2FtGt3lxbbpilJVg%3D",
        "videoIframe": "https://clean.i-pv.cn/#/v1/robot/live_video_photo?app-key=e2aa1db60acf43719898110f87e51c79&timestamp=1737688878153&nonce=af2495e59fde43ce8c1da733e7554d43&robot_id=156&signature=9hM9gpKCyJVVas%2F0ymWivRTVLtU%3D",
        "robotControlIframe": null,
        "appKey": null,
        "appSecret": null,
        "icon": "100",
        "todayWorkingPlan": null
      }
    ],
    "total": 1,
    "size": 20,
    "current": 1,
    "orders": [],
    "optimizeCountSql": true,
    "hitCount": false,
    "searchCount": true,
    "pages": 1
  },
  "timestamp": 1737688878153
}

设备管理-清扫机器人​

接口描述​

通过机器人名称，清扫状态，通讯状态，硬件状态获取机器人列表

请求方法​

/sol_monitor/clean/robot/list

请求方式​

POST

Body 请求参数示例​

{
  "name": "",
  "cleanStatus": "",
  "communicationStatus": "",
  "hardwareStatus": "",
  "page": 1,
  "pageSize": 20
}

请求参数​

名称位置类型必选中文名说明
serviceModuleheaderstring是
bodybodyobject否
» namebodystring是机器人名称
» cleanStatusbodystring是清扫状态
» communicationStatusbodystring是通讯状态
» hardwareStatusbodystring是硬件状态
» pagebodyinteger是页数
» pageSizebodyinteger是页码

返回数据结构​

状态码 200

名称类型必选约束中文名说明
» successbooleantrue
» messagestringtrue
» codeintegertrue
» resultobjecttrue
»» records[object]true
»»» idintegertrueid
»»» createTimestringtrue创建时间
»»» updateTimestringtrue更新时间
»»» accessAccountIdintegertrue访问帐户 id
»»» keyIdstringtrue机器人 id
»»» siteIdstringtrue电站 id
»»» workMapIdstringtrue作业地图 id
»»» modelstringtrue机器人型号
»»» serialNumberstringtrue机器人序列号
»»» siteNamestringtrue电站名称
»»» workingMapNamestringtrue作业地图名称
»»» leftFrontEdgestringtrue左前避障状态
»»» leftRearEdgestringtrue左后避障状态
»»» rightFrontEdgestringtrue右前避障状态
»»» rightRearEdgestringtrue右后避障状态
»»» powerOnRunningDurationintegertrue上电运行时长(秒)
»»» powerOnStartupNumberintegertrue上电启动次数
»»» controlModestringtrue控制模式
»»» inboundOutboundModestringtrue入库出库模式
»»» robotPauseStatusstringtrue机器人暂停状态
»»» cleaningTaskPauseStatusstringtrue清扫任务暂停状态
»»» robotStatusstringtrue机器人状态
»»» hardwareStatusstringtrue硬件状态
»»» communicationStatusstringtrue通讯状态
»»» batteryPercentageintegertrue电池电量(百分比)
»»» robotNamestringtrue机器人名称
»»» accumulatedCleaningDistancenumbertrue累计清洗距离
»»» accumulatedDrivingDistancenumbertrue累计行驶距离
»»» altitudeintegertrue高度
»»» angularVelocitynumbertrue角速度
»»» batteryCurrentnumbertrue电池电流
»»» brushSpeedintegertrue清洗速度
»»» cleaningDurationintegertrue清洗时间
»»» cleaningProgressnumbertrue清洗进度
»»» cleaningTaskidstring¦nulltrue清扫任务 id
»»» latitudenumbertrue纬度
»»» latitudeTypestringtrue纬度类型
»»» linearVelocitynumbertrue线速度
»»» longitudenumbertrue经度
»»» longitudeTypestringtrue经度类型
»»» maxBatteryTemperaturenumbertrue电池最高温度
»»» minBatteryTemperaturenumbertrue电池最低温度
»»» positioningModestringtrue定位模式
»»» powerOnCleaningDistancenumbertrue上电清扫里程
»»» powerOnDrivingDistancenumbertrue上电行驶里程
»»» yawAnglenumbertrue偏航角度
»»» isDeleteintegertrue是否删除
»»» keepYearsnulltrue质保年限
»»» keepStartTimenulltrue质保开始时间
»»» keepEndTimenulltrue质保结束时间
»»» monitorStationstringtrue关联电站
»»» monitorIdintegertrue关联电站 id
»»» hasQuotaintegertrue订阅版本
»» totalintegertrue总数
»» sizeintegertrue页数
»» currentintegertrue当前页
»» orders[string]true
»» optimizeCountSqlbooleantrue
»» hitCountbooleantrue
»» searchCountbooleantrue
»» pagesintegertrue总页数
» timestampintegertrue

返回示例​

{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": {
    "records": [
      {
        "id": 8,
        "createTime": "2024-05-28 18:27:22",
        "updateTime": "2025-01-24 11:24:25",
        "accessAccountId": 23,
        "keyId": "114",
        "siteId": "119",
        "workMapId": "1189",
        "model": "PCR-200-P",
        "serialNumber": "ZR2P240118005",
        "siteName": "锦州中信钛业4.005MWp工商业电站",
        "workingMapName": "6万吨成品库屋顶地图（正式）修复连接桥问题",
        "leftFrontEdge": "正常",
        "leftRearEdge": "正常",
        "rightFrontEdge": "正常",
        "rightRearEdge": "正常",
        "powerOnRunningDuration": 1861422,
        "powerOnStartupNumber": 100,
        "controlMode": "automatic",
        "inboundOutboundMode": "normal",
        "robotPauseStatus": "unforcedStop",
        "cleaningTaskPauseStatus": "resume",
        "robotStatus": "清扫中",
        "hardwareStatus": "正常",
        "communicationStatus": "在线",
        "batteryPercentage": 70,
        "robotName": "6万吨成品库机器人",
        "accumulatedCleaningDistance": 775096.6706261531,
        "accumulatedDrivingDistance": 1066099.5352418837,
        "altitude": 5.605221572169325e-254,
        "angularVelocity": 0.00543937736815807,
        "batteryCurrent": -1.86,
        "brushSpeed": 0,
        "cleaningDuration": 45092,
        "cleaningProgress": 43.85845306986863,
        "cleaningTaskid": "60223",
        "latitude": 41.04620990158887,
        "latitudeType": "N",
        "linearVelocity": 0.14845072850583974,
        "longitude": 120.9916784557139,
        "longitudeType": "E",
        "maxBatteryTemperature": 8.7,
        "minBatteryTemperature": 7.2,
        "positioningMode": "RTK fixed",
        "powerOnCleaningDistance": 39555.04162624978,
        "powerOnDrivingDistance": 59030.402241885124,
        "yawAngle": 6.912325986880764,
        "isDelete": 0,
        "keepYears": null,
        "keepStartTime": null,
        "keepEndTime": null,
        "monitorStation": "锦州中信钛业4.005MWp工商业电站",
        "monitorId": 43268,
        "hasQuota": 1
      },


    ],
    "total": "Xx",
    "size": 20,
    "current": 1,
    "orders": [],
    "optimizeCountSql": true,
    "hitCount": false,
    "searchCount": true,
    "pages": 3
  },
  "timestamp": 1737689068373
}

获取清扫次数图表​

接口描述​

通过指定日期、监控电站ID或机器人id和图表数据类型，获取电站的清扫次数。电站可能有多个机器人，传电站id则返回该电站聚合所有机器人的清扫次数，传机器人id则返回单个机器人的清扫次数。

请求方法​

/sol_monitor/clean/robot/cleanNum

请求方式​

GET

请求参数​

名称位置类型必选说明
datetimequeryString是日期，格式为年-月-日，例如2024-12-10
monitorIdqueryLong否监控电站id
dataTypequerystring是图表数据类型，决定数据的聚合时间范围
robotIdqueryLong否机器人id
X-Access-Tokenheaderstring是token

枚举值​

属性值说明
dataTypeSEVEN_DAY7天，根据传入时间获取该时间往前推6天，共7天的数据
dataTypeMONTH月，根据传入时间获取这一个月的数据
dataTypeYEAR年，根据传入时间获取该年每个月的数据
dataTypeTOTAL总，每年的数据

返回数据结构​

状态码 200

名称类型必选约束中文名说明
» successbooleantrue请求是否成功
» messagestringtrue请求结果的提示消息
» codeintegertrue请求状态码
» resultList<Map>true清扫次数和天气信息的具体数据
»» cleanNumList<Map>true清扫次数list
»»» timestringtrue聚合粒度具体时间7天：日，月：日，年：月，总：年
»»» valueDoubletrue清扫次数
»»» yearstringtrue时间-年
»»» monthstringtrue时间-月
»»» allDatestringtrue时间
»» weatherList<Map>true天气
»»» idLongtrue天气id
»»» createTimestringtrue创建日期
»»» updateTimestringtrue更新时间
»»» locationIdLongtrue区县ID
»»» fxTimestringtrue预报时间
»»» sunriseLongtrue日出时间
»»» sunsetLongtrue日落时间
»»» moonriseLongtrue月出时间
»»» moonsetLongtrue月落时间
»»» moonPhasestringtrue月相名称
»»» tempMaxstringtrue预报当天最高温度
»»» tempMinstringtrue预报当天最低温度
»»» iconDaystringtrue预报白天天气状况的图标代码
»»» textDaystringtrue预报白天天气状况文字描述
»»» iconNightstringtrue预报夜间天气状况的图标代码
»»» textNightstringtrue预报晚间天气状况文字描述
»»» wind360Daystringtrue预报白天风向360角度
»»» windDirDaystringtrue预报白天风向
»»» windScaleDaystringtrue预报白天风力等级
»»» windSpeedDaystringtrue预报白天风速
»»» wind360Nightstringtrue预报夜间风向360角度
»»» windDirNightstringtrue预报夜间当天风向
»»» windScaleNightstringtrue预报夜间风力等级
»»» windSpeedNightstringtrue预报夜间风速
»»» humiditystringtrue预报当天相对湿度
»»» precipstringtrue预报当天降水量
»»» pressurestringtrue预报当天大气压强
»»» visstringtrue预报当天能见度
»»» cloudstringtrue预报当天云量
»»» uvIndexstringtrue预报当天紫外线强度指数
» timestampStringtrue响应数据的时间戳

返回示例​

{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": {
    "cleanNum": [
      {
        "time": "5",
        "value": 74.94130301475525,
        "year":  string,
        "month":  string,
        "allDate": "2024-12-05"
      }
    ],
    "weather": [
      {
        "id": 42216,
        "createTime": "2024-12-05",
        "updateTime": "2024-12-05 17:02:25",
        "locationId": 101090411,
        "fxTime": "2024-12-05",
        "sunrise": 1733354340000,
        "sunset": 1733388120000,
        "moonrise": "10:51",
        "moonset": "20:13",
        "moonPhase": "蛾眉月",
        "tempMax": "2",
        "tempMin": "-5",
        "iconDay": "101",
        "textDay": "多云",
        "iconNight": "151",
        "textNight": "多云",
        "wind360Day": "315",
        "windDirDay": "西北风",
        "windScaleDay": "3-4",
        "windSpeedDay": "24",
        "wind360Night": "315",
        "windScaleNight": "1-3",
        "windSpeedNight": "3",
        "humidity": "54",
        "precip": "0.0",
        "pressure": "953",
        "vis": "25",
        "cloud": "0",
        "uvIndex": "2",
        "windDirNight": "西北风"
      }
    ]
  },
  "timestamp": 1733887983166
}

获取清扫面积/里程​

接口描述​

通过日期、电站ID或机器人id、数据类型获取电站的清扫面积、清扫里程以及天气信息。电站可能有多个机器人，传电站id则返回该电站聚合所有机器人的清扫面积、清扫里程，传机器人id则返回单个机器人的清扫面积、清扫里程。

请求方法​

/sol_monitor/clean/robot/cleanTask/cleanArea/arr

请求方式​

GET

请求参数​

名称位置类型必选说明
datetimequeryString是日期，格式为年-月-日，例如2024-12-10
monitorIdqueryLong否监控电站id，用于唯一标识一个电站
dataTypequerystring是图表数据类型，决定数据的聚合时间范围
robotIdqueryLong否机器人id
X-Access-Tokenheaderstring是token

枚举值​

属性值说明
dataTypeSEVEN_DAY7天，根据传入时间获取该时间往前推6天，共7天的数据
dataTypeMONTH月，根据传入时间获取这一个月的数据
dataTypeYEAR年，根据传入时间获取该年每个月的数据
dataTypeTOTAL总，每年的数据

返回数据结构​

状态码 200

名称类型必选约束中文名说明
» successbooleantrue请求是否成功
» messagestringtrue请求结果提示信息
» codeintegertrue状态码
» resultList<Map>true清扫区域和天气信息具体数据
»» cleanAreaList<Map>true清扫数据list
»»» cleaningDistanceDoubletrue清扫里程(m)
»»» actualCleaningAreaDoubletrue清扫面积(㎡)
»»» cleanNumstringtrue清扫次数
»»» dayintegertrue日
»»» monthintegertrue月
»»» yearintegertrue年
»»» allDatestringtrue日期年-月-日
»»» timestringtrue聚合粒度具体时间7天：日，月：日，年：月，总：年
»» weatherList<Map>true天气
»»» idLongtrue天气id
»»» createTimestringtrue创建日期
»»» updateTimestringtrue更新时间
»»» locationIdLongtrue区县ID
»»» fxTimestringtrue预报时间
»»» sunriseLongtrue日出时间
»»» sunsetLongtrue日落时间
»»» moonriseLongtrue月出时间
»»» moonsetLongtrue月落时间
»»» moonPhasestringtrue月相名称
»»» tempMaxstringtrue预报当天最高温度
»»» tempMinstringtrue预报当天最低温度
»»» iconDaystringtrue预报白天天气状况的图标代码
»»» textDaystringtrue预报白天天气状况文字描述
»»» iconNightstringtrue预报夜间天气状况的图标代码
»»» textNightstringtrue预报晚间天气状况文字描述
»»» wind360Daystringtrue预报白天风向360角度
»»» windDirDaystringtrue预报白天风向
»»» windScaleDaystringtrue预报白天风力等级
»»» windSpeedDaystringtrue预报白天风速
»»» wind360Nightstringtrue预报夜间风向360角度
»»» windDirNightstringtrue预报夜间当天风向
»»» windScaleNightstringtrue预报夜间风力等级
»»» windSpeedNightstringtrue预报夜间风速
»»» humiditystringtrue预报当天相对湿度
»»» precipstringtrue预报当天降水量
»»» pressurestringtrue预报当天大气压强
»»» visstringtrue预报当天能见度
»»» cloudstringtrue预报当天云量
»»» uvIndexstringtrue预报当天紫外线强度指数
» timestampStringtrue响应数据的时间戳

返回示例​

{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": {
    "cleanArea": [
      {
        "cleaningDistance": 19810.919692993164,
        "actualCleaningArea": 9017.517498016357,
        "cleanNum":  string,
        "day": 4,
        "month": 12,
        "year": 2024,
        "allDate": "2024-12-04",
        "time":  string
      }
    ],
    "weather": [
      {
        "id": 42157,
        "createTime": "2024-12-04",
        "updateTime": "2024-12-04 17:01:31",
        "locationId": 101090411,
        "fxTime": "2024-12-04",
        "sunrise": 1733267880000,
        "sunset": 1733301720000,
        "moonrise": "10:08",
        "moonset": "19:01",
        "moonPhase": "蛾眉月",
        "tempMax": "3",
        "tempMin": "-6",
        "iconDay": "100",
        "textDay": "晴",
        "iconNight": "150",
        "textNight": "晴",
        "wind360Day": "315",
        "windDirDay": "西北风",
        "windScaleDay": "1-3",
        "windSpeedDay": "16",
        "wind360Night": "315",
        "windScaleNight": "1-3",
        "windSpeedNight": "3",
        "humidity": "57",
        "precip": "0.0",
        "pressure": "951",
        "vis": "25",
        "cloud": "0",
        "uvIndex": "2",
        "windDirNight": "西北风"
      }
    ]
  },
  "timestamp": 1733888017440
}

获取电站清扫分析对比组​

接口描述​

通过电站id获取电站设置的对照组和清扫组等数据

请求方法​

/clean/plant/getCompareGroup

请求方式​

GET

请求参数​

名称位置类型必选说明
plantIdqueryLong是电站id，用于唯一标识一个电站
X-Access-Tokenheaderstring是token

返回数据结构​

状态码 200

名称类型必选约束中文名说明
» successbooleantrue请求是否成功
» messagestringtrue请求结果提示信息
» codeintegertrue响应码
» resultList<Map>trueresult[0]为对照组数据，其他为清扫组数据
»» idLongtrueid
»» createTimestringtrue创建日期
»» updateTimestringtrue更新时间
»» groupNamestringtrue组名
»» statusstringtrue组状态状态0正常 1停用
»» capacityintegertrue装机容量（kWp）
»» deviceListstringtrue组下逆变器列表逆变器id列表
»» arrayListstringtrue组下组串列表
»» plantIdLongtrue电站id
»» startDatestringtrue数据对比起始日期
»» dataIsSuccessintegertrue数据是否成功执行完成
»» groupNumberintegertrue分组号
»» groupTypeintegertrue对比组类型0为机器人 1为电站
»» robotIdLongtrue机器人id机器人id
»» inverterArrayDtoListList<Map>true逆变器与组串的关联信息
»»» inverterIdLongtrue逆变器id
»»» arrayIdsList<Long>true组串id
» timestampStringtrue响应时间戳

返回示例​

{
"success": true,
"message": "操作成功！",
"code": 200,
"result": [
  {
    "id": 288,
    "createTime": "2024-12-05 16:00:00",
    "updateTime": "2024-12-05 16:00:00",
    "groupName": "未清扫",
    "status": "0",
    "capacity": 1606660,
    "deviceList": "xxx, xxx, 56454",
    "arrayList": "[{\"arrayIds\":[],\"inverterId\":56456}]",
    "plantId": 43367,
    "startDate": "2024-10-15",
    "dataIsSuccess": 1,
    "groupNumber": 1,
    "groupType": 1,
    "robotId":  string,
    "inverterArrayDtoList": [
      {
        "inverterId": 56456,
        "arrayIds": []
      }
    ]
  },
  {
    "id": 289,
    "createTime": "2024-12-05 16:00:00",
    "updateTime": "2024-12-05 16:00:00",
    "groupName": "清扫区",
    "status": "0",
    "capacity": 4433390,
    "deviceList": "XXX, 56432",
    "arrayList": "[{\"arrayIds\":[],\"inverterId\":56458}]",
    "plantId": 43367,
    "startDate": "2024-10-15",
    "dataIsSuccess": 1,
    "groupNumber": 2,
    "groupType": 1,
    "robotId":  string,
    "inverterArrayDtoList": [
      {
        "inverterId": 56458,
        "arrayIds": []
      }
    ]
  }
],
"timestamp": 1733905218216
}

获取日发电对比​

接口描述​

通过指定日期、监控电站ID或机器人id和图表数据类型，获取电站清扫组发电量，对比组发电量。电站可能有多个机器人，传电站id则返回该电站聚合的机器人发电量数据，传机器人id则返回单个机器人的发电量数据。

请求方法​

/clean/plant/getWorkMapAnalysis

请求方式​

GET

请求参数​

名称位置类型必选说明
plantIdqueryLong是电站id，用于唯一标识一个电站
dateTypequerystring是数据类型，决定数据的聚合时间范围
timequerystring是日期，格式为年-月-日，例如2024-12-10
robotIdqueryLong否机器人id
X-Access-Tokenheaderstring是token

枚举值​

属性值说明
dataTypeSEVEN_DAY7天，根据传入时间获取该时间往前推6天，共7天的数据
dataTypeMONTH月，根据传入时间获取这一个月的数据
dataTypeYEAR年，根据传入时间获取该年每个月的数据
dataTypeTOTAL总，每年的数据

返回数据结构​

状态码 200

名称类型必选约束中文名说明
» successbooleantrue
» messagestringtrue
» codeintegertrue
» resultList<Map>trueresult[0]对照组数据
result[1]清扫组数据
result[2]提升发电量
result[3]提升发电量百分比
result[4]无清扫理论发电量
result[5]清扫后实际发电量
result[6]理论发电量
result[7]理论增发电量比例
»» compareGroupNamestringtrue组名称
»» compareGroupValueList<Arr>¦ stringtrue发电量list
»»» timestringtrue聚合粒度具体时间7天：日，月：日，年：月，总：年
»»» valueDouble¦ stringtrue发电量值
»»» yearinteger¦ stringtrue年
»»» monthinteger¦ stringtrue月
»»» allDatestring¦ stringtrue发电量数据时间
»» valueDouble¦ stringtrue值compareGroupValue返回为string时的数据值
»» weatherList<Map>true天气
»»» idLongtrue天气id
»»» createTimestringtrue创建日期
»»» updateTimestringtrue更新时间
»»» locationIdLongtrue区县ID
»»» fxTimestringtrue预报时间
»»» sunriseLongtrue日出时间
»»» sunsetLongtrue日落时间
»»» moonriseLongtrue月出时间
»»» moonsetLongtrue月落时间
»»» moonPhasestringtrue月相名称
»»» tempMaxstringtrue预报当天最高温度
»»» tempMinstringtrue预报当天最低温度
»»» iconDaystringtrue预报白天天气状况的图标代码
»»» textDaystringtrue预报白天天气状况文字描述
»»» iconNightstringtrue预报夜间天气状况的图标代码
»»» textNightstringtrue预报晚间天气状况文字描述
»»» wind360Daystringtrue预报白天风向360角度
»»» windDirDaystringtrue预报白天风向
»»» windScaleDaystringtrue预报白天风力等级
»»» windSpeedDaystringtrue预报白天风速
»»» wind360Nightstringtrue预报夜间风向360角度
»»» windDirNightstringtrue预报夜间当天风向
»»» windScaleNightstringtrue预报夜间风力等级
»»» windSpeedNightstringtrue预报夜间风速
»»» humiditystringtrue预报当天相对湿度
»»» precipstringtrue预报当天降水量
»»» pressurestringtrue预报当天大气压强
»»» visstringtrue预报当天能见度
»»» cloudstringtrue预报当天云量
»»» uvIndexstringtrue预报当天紫外线强度指数
» timestampStringtrue响应时间戳

返回示例​

{
  "success": true,
  "message": "操作成功！",
  "code": 200,
  "result": [
    {
      "compareGroupValue": [
        {
          "time": "5",
          "value": 1874,
          "year": 2024,
          "month": 12,
          "allDate": "2024-12-05"
        }
      ],
      "compareGroupName": "清扫区",
      "value":  string,
      "weatherDailyList":  string
    },
    {
      "compareGroupValue": [
        {
          "time": "5",
          "value": 1637.6165971643031,
          "year": 2024,
          "month": 12,
          "allDate": "2024-12-05"
        }
      ],
      "compareGroupName": "greater_than_清扫区",
      "value":  string,
      "weatherDailyList":  string
    },
    {
      "compareGroupValue": [
        {
          "time": "5",
          "value": 0.31668733021522605,
          "year": 2024,
          "month": 12,
          "allDate": "2024-12-05"
        }
      ],
      "compareGroupName": "greater_than_per_清扫区",
      "value":  string,
      "weatherDailyList":  string
    },
    {
      "compareGroupValue": [
        {
          "time": "5",
          "value": 5171.083402835697,
          "year": 2024,
          "month": 12,
          "allDate": "2024-12-05"
        }
      ],
      "compareGroupName": "non_sweeping",
      "value":  string,
      "weatherDailyList":  string
    },
    {
      "compareGroupValue": [
        {
          "time": "5",
          "value": 6808.7,
          "year": 2024,
          "month": 12,
          "allDate": "2024-12-05"
        }
      ],
      "compareGroupName": "sweep",
      "value":  string,
      "weatherDailyList":  string
    },
    {
      "compareGroupValue":  string,
      "compareGroupName": "theory",
      "value": 10147.840033361135,
      "weatherDailyList":  string
    },
    {
      "compareGroupValue":  string,
      "compareGroupName": "theory_per",
      "value": 0.3513495749698107,
      "weatherDailyList":  string
    },
    {
      "compareGroupValue":  string,
      "compareGroupName": "weather",
      "value":  string,
      "weatherDailyList": [
        {
          "id": 42216,
          "createTime": "2024-12-05",
          "updateTime": "2024-12-05 17:02:25",
          "locationId": 101090411,
          "fxTime": "2024-12-05",
          "sunrise": 1733354340000,
          "sunset": 1733388120000,
          "moonrise": "10:51",
          "moonset": "20:13",
          "moonPhase": "蛾眉月",
          "tempMax": "2",
          "tempMin": "-5",
          "iconDay": "101",
          "textDay": "多云",
          "iconNight": "151",
          "textNight": "多云",
          "wind360Day": "315",
          "windDirDay": "西北风",
          "windScaleDay": "3-4",
          "windSpeedDay": "24",
          "wind360Night": "315",
          "windScaleNight": "1-3",
          "windSpeedNight": "3",
          "humidity": "54",
          "precip": "0.0",
          "pressure": "953",
          "vis": "25",
          "cloud": "0",
          "uvIndex": "2",
          "windDirNight": "西北风"
        }
      ]
    }
  ],
  "timestamp": 1733888050683
}