机器人详情接口
机器人详情相关接口
机器人详情接口
接口描述
根据机器人 ID 获取机器人详细信息
请求方式
GET
请求方法
/clean/robots/detail
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| robotId | query | string | 是 | 机器人 ID |
| keyId | query | string | 是 | 机器人 ID |
返回示例
{
"success": true,
"message": "操作成功!",
"code": 200,
"result": {
"keyId": null,
"robotEntity": {
"id": 4,
"createTime": "2024-02-19 21:25:13",
"updateTime": "2025-03-13 13:41:21",
"accessAccountId": 23,
"keyId": "79",
"siteId": "92",
"workMapId": "722",
"model": "PCR-100-P",
"serialNumber": "406R4260026",
"siteName": "青岛威奥6.7MWp工商业电站",
"workingMapName": "青岛威奥3",
"leftFrontEdge": "正常",
"leftRearEdge": "正常",
"rightFrontEdge": "正常",
"rightRearEdge": "正常",
"powerOnRunningDuration": 1373688,
"powerOnStartupNumber": 98,
"controlMode": "automatic",
"inboundOutboundMode": "normal",
"robotPauseStatus": "unforcedStop",
"cleaningTaskPauseStatus": "resume",
"robotStatus": "移动中",
"hardwareStatus": "正常",
"communicationStatus": "在线",
"batteryPercentage": 93,
"robotName": "青岛威奥机器人",
"accumulatedCleaningDistance": 685426.8069404913,
"accumulatedDrivingDistance": 936701.1281686041,
"altitude": 0,
"angularVelocity": 0.0006258003540693717,
"batteryCurrent": -2.96,
"brushSpeed": 0.001040625,
"cleaningDuration": 24120,
"cleaningProgress": 18.06911241793886,
"cleaningTaskid": "68201",
"latitude": 36.26794979271398,
"latitudeType": "N",
"linearVelocity": -0.25969811559107087,
"longitude": 120.33270318038221,
"longitudeType": "E",
"maxBatteryTemperature": 28.8,
"minBatteryTemperature": 28.2,
"positioningMode": "RTK fixed",
"powerOnCleaningDistance": 34674.20294058042,
"powerOnDrivingDistance": 48829.12716866356,
"yawAngle": 4.553621244750422,
"isDelete": 0,
"monitorStation": "青岛威奥",
"monitorId": 43250,
"forwardPhotos": null,
"forwardPhotosUploadStatus": null,
"assetsViewStatus": 1,
"keepYears": null,
"keepStartTime": null,
"keepEndTime": null,
"areaDivideId": 148,
"areaDivideName": "威奥三期",
"province": null,
"city": null,
"area": null,
"provinceId": null,
"cityId": null,
"areaId": null,
"plantWeather": "晴",
"plantTemperature": "9",
"workingMapIframe": null,
"videoIframe": null,
"robotControlIframe": null,
"appKey": null,
"appSecret": null,
"icon": null,
"todayWorkingPlan": null
},
"historyTaskNum": 61,
"alarmNum": 1353,
"monitorStation": null,
"workingPlanEntity": {
"id": 15119,
"createTime": "2025-03-12 16:00:00",
"updateTime": "2025-03-12 16:06:19",
"keyId": "69",
"name": "青岛威奥清扫计划",
"cycle": 4,
"workingHours": "{周一=[15, 16, 17, 9, 11, 10, 12, 13, 14, 8, 18, 19], 周五=[17, 16, 15, 13, 10, 12, 14, 11, 9, 8, 18, 19], 周日=[17, 16, 15, 12, 9, 10, 11, 14, 13, 8, 18, 19], 周四=[17, 16, 15, 12, 13, 14, 11, 10, 9, 8, 18, 19], 周三=[17, 16, 15, 10, 12, 14, 13, 11, 9, 8, 18, 19], 周二=[17, 16, 15, 14, 13, 11, 12, 10, 9, 8, 18, 19], 周六=[17, 16, 15, 9, 13, 14, 12, 11, 10, 8, 18, 19]}",
"avoidBadWeather": null,
"remark": "",
"accessAccountId": 23
},
"todayWorkingPlan": "17, 16, 15, 13, 10, 12, 14, 11, 9, 8, 18, 19",
"cleaningTaskEntity": {
"id": 13762,
"createTime": "2025-03-10 16:00:00",
"updateTime": "2025-03-13 05:39:22",
"keyId": "68201",
"cleaningTaskId": null,
"siteId": "92",
"robotId": "79",
"workingMapId": "722",
"workingMapName": "青岛威奥3",
"workingPlanId": "69",
"workingPlanName": "青岛威奥清扫计划",
"schedulingMethod": "cycle",
"scheduledCleaningAt": "",
"status": "cleaning",
"startAt": "2025-03-11 19:31:06",
"endAt": "",
"duration": 151619,
"cleaningDuration": 24120,
"drivingDistance": 4436.29,
"cleaningDistance": 3526.77,
"chargeTimes": 7,
"targetCleaningArea": 10786.6,
"actualCleaningArea": 1949.05,
"completionPercent": 18.07,
"endReason": "",
"stage": 1,
"cleanCountStatus": 0,
"isArchived": 0
},
"appKey": null,
"appSecret": null,
"workingMapIframe": null,
"videoIframe": null,
"robotControlIframe": null,
"monitorId": null
},
"timestamp": 1741844482832
}
返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | none | none | |
| » message | string | true | none | none | |
| » code | integer | true | none | none | |
| » result | object | true | none | none | |
| »» keyId | null | true | none | 机器人 ID | none |
| »» robotEntity | object | true | none | 机器人详情 | none |
| »»» id | integer | true | none | ID | none |
| »»» createTime | string | true | none | 创建时间 | none |
| »»» updateTime | string | true | none | 更新时间 | none |
| »»» accessAccountId | integer | true | none | 访问账户 ID | none |
| »»» keyId | string | true | none | 机器人 ID | none |
| »»» siteId | string | true | none | 站点 ID | none |
| »»» workMapId | string | true | none | 作业地图 ID | none |
| »»» model | string | true | none | 型号 | none |
| »»» serialNumber | string | true | none | SN | none |
| »»» siteName | string | true | none | 站点名称 | none |
| »»» workingMapName | string | true | none | 作业地图名称 | none |
| »»» leftFrontEdge | string | true | none | 左前避障状态 | none |
| »»» leftRearEdge | string | true | none | 左后避障状态 | none |
| »»» rightFrontEdge | string | true | none | 右前避障状态 | none |
| »»» rightRearEdge | string | true | none | 右后避障状态 | none |
| »»» powerOnRunningDuration | integer | true | none | 上电运行时长 | none |
| »»» powerOnStartupNumber | integer | true | none | 上次启动次数 | none |
| »»» controlMode | string | true | none | 控制模式 | none |
| »»» inboundOutboundMode | string | true | none | 出入库模式 | none |
| »»» robotPauseStatus | string | true | none | 机器人暂停状态 | forcedStop 强制终止/解除强停 |
| »»» cleaningTaskPauseStatus | string | true | none | 清扫任务暂停状态 | none |
| »»» robotStatus | string | true | none | 机器人状态 | none |
| »»» hardwareStatus | string | true | none | 硬件状态 | none |
| »»» communicationStatus | string | true | none | 通讯状态 | none |
| »»» batteryPercentage | integer | true | none | 电池电量(百分比) | none |
| »»» robotName | string | true | none | 机器人名称 | none |
| »»» accumulatedCleaningDistance | number | true | none | 累计清扫里程(米) | none |
| »»» accumulatedDrivingDistance | number | true | none | 累计行驶里程(米) | none |
| »»» altitude | integer | true | none | 高度 | none |
| »»» angularVelocity | number | true | none | 角速度(弧度/秒) | none |
| »»» batteryCurrent | number | true | none | 电池电流 | none |
| »»» brushSpeed | number | true | none | 毛刷转速(转/秒) | none |
| »»» cleaningDuration | integer | true | none | 清扫时长 | none |
| »»» cleaningProgress | number | true | none | 清扫进度(百分比) | none |
| »»» cleaningTaskid | string | true | none | 清扫任务 ID | none |
| »»» latitude | number | true | none | 纬度 | none |
| »»» latitudeType | string | true | none | 纬度类型 | none |
| »»» linearVelocity | number | true | none | 线速度(米/秒) | none |
| »»» longitude | number | true | none | 经度 | none |
| »»» longitudeType | string | true | none | 经度类型 | none |
| »»» maxBatteryTemperature | number | true | none | 电池最高温度(摄氏度) | none |
| »»» minBatteryTemperature | number | true | none | 电池最低温度(摄氏度) | none |
| »»» positioningMode | string | true | none | 定位模式 | none |
| »»» powerOnCleaningDistance | number | true | none | 上电清扫里程(米) | none |
| »»» powerOnDrivingDistance | number | true | none | 上电行驶里程(米) | none |
| »»» yawAngle | number | true | none | 偏航角度 | none |
| »»» isDelete | integer | true | none | 是否删除 | none |
| »»» monitorStation | string | true | none | 监控电站 | none |
| »»» monitorId | integer | true | none | 监控 ID | none |
| »»» forwardPhotos | null | true | none | 转发照片 | none |
| »»» forwardPhotosUploadStatus | null | true | none | 转发照片下载状态 | none |
| »»» assetsViewStatus | integer | true | none | 资产视图状态 | none |
| »»» keepYears | null | true | none | 质保年限 | none |
| »»» keepStartTime | null | true | none | 质保开始时间 | none |
| »»» keepEndTime | null | true | none | 质保结束时间 | none |
| »»» areaDivideId | integer | true | none | 区域划分 ID | none |
| »»» areaDivideName | string | true | none | 区域划分名称 | none |
| »»» province | null | true | none | 省 | none |
| »»» city | null | true | none | 市 | none |
| »»» area | null | true | none | 区 | none |
| »»» provinceId | null | true | none | 省 ID | none |
| »»» cityId | null | true | none | 市 ID | none |
| »»» areaId | null | true | none | 区 ID | none |
| »»» plantWeather | string | true | none | 电站天气 | none |
| »»» plantTemperature | string | true | none | 电站温度 | none |
| »»» workingMapIframe | null | true | none | 工作地图框架 | none |
| »»» videoIframe | null | true | none | 视图框架 | none |
| »»» robotControlIframe | null | true | none | 机器人控制框架 | none |
| »»» appKey | null | true | none | ID | none |
| »»» appSecret | null | true | none | 密钥 | none |
| »»» icon | null | true | none | none | |
| »»» todayWorkingPlan | null | true | none | none | |
| »» historyTaskNum | integer | true | none | none | |
| »» alarmNum | integer | true | none | none | |
| »» monitorStation | null | true | none | none | |
| »» workingPlanEntity | object | true | none | none | |
| »»» id | integer | true | none | none | |
| »»» createTime | string | true | none | none | |
| »»» updateTime | string | true | none | none | |
| »»» keyId | string | true | none | none | |
| »»» name | string | true | none | none | |
| »»» cycle | integer | true | none | none | |
| »»» workingHours | string | true | none | none | |
| »»» avoidBadWeather | null | true | none | none | |
| »»» remark | string | true | none | none | |
| »»» accessAccountId | integer | true | none | none | |
| »» todayWorkingPlan | string | true | none | none | |
| »» cleaningTaskEntity | object | true | none | none | |
| »»» id | integer | true | none | none | |
| »»» createTime | string | true | none | 开始时间 | none |
| »»» updateTime | string | true | none | 更新时间 | none |
| »»» keyId | string | true | none | ID | none |
| »»» cleaningTaskId | null | true | none | 清扫任务 ID | none |
| »»» siteId | string | true | none | 站点 ID | none |
| »»» robotId | string | true | none | 机器人 ID | none |
| »»» workingMapId | string | true | none | 作业地图 ID | none |
| »»» workingMapName | string | true | none | 作业地图名称 | none |
| »»» workingPlanId | string | true | none | 作业计划 ID | none |
| »»» workingPlanName | string | true | none | 作业计划名称 | none |
| »»» schedulingMethod | string | true | none | 调度方式 | none |
| »»» scheduledCleaningAt | string | true | none | 预定清扫时间 | none |
| »»» status | string | true | none | 状态 | 状态 |
| »»» startAt | string | true | none | 开始时间 | none |
| »»» endAt | string | true | none | 结束时间 | none |
| »»» duration | integer | true | none | 任务时长 | none |
| »»» cleaningDuration | integer | true | none | 清扫时长 | none |
| »»» drivingDistance | number | true | none | 行驶里程 | none |
| »»» cleaningDistance | number | true | none | 清扫里程 | none |
| »»» chargeTimes | integer | true | none | 充电次数 | none |
| »»» targetCleaningArea | number | true | none | 目标清扫面积 | none |
| »»» actualCleaningArea | number | true | none | 实际清扫面积 | none |
| »»» completionPercent | number | true | none | 完成比例(百分比) | none |
| »»» endReason | string | true | none | 结束原因 | none |
| »»» stage | integer | true | none | 阶段 | none |
| »»» cleanCountStatus | integer | true | none | none | |
| »»» isArchived | integer | true | none | none | |
| »» appKey | null | true | none | none | |
| »» appSecret | null | true | none | none | |
| »» workingMapIframe | null | true | none | none | |
| »» videoIframe | null | true | none | none | |
| »» robotControlIframe | null | true | none | none | |
| »» monitorId | null | true | none | none | |
| » timestamp | integer | true | none | none |
清扫统计-清扫日历
接口描述
根据开始时间结束时间作业地图 id 获取清扫日历数据
请求方式
GET
请求方法
/sol_monitor/clean/robot/getRobotCleanCalendar
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| beginData | query | string | 否 | 开始时间 |
| endData | query | string | 否 | 结束时间 |
| workMapId | query | string | 是 | 作业地图 id |
返回示例
200 Response
{
"success": true,
"message": "string",
"code": 0,
"result": {
"cleanCalendarList": [
{
"id": 0,
"name": "string",
"keyId": "string",
"createTime": "string",
"workingHours": "string",
"workingHoursList": [[0]]
}
]
},
"timestamp": 0
}
返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | none | none | |
| » message | string | true | none | none | |
| » code | integer | true | none | none | |
| » result | object | true | none | none | |
| »» cleanCalendarList | [object] | true | none | none | |
| »»» id | integer | false | none | ID | none |
| »»» name | string | false | none | 机器人名称 | none |
| »»» keyId | string | false | none | 机器人 ID | none |
| »»» createTime | string | false | none | 创建时间 | none |
| »»» workingHours | string | false | none | 可作业时间 | none |
| »»» workingHoursList | [array] | false | none | 可作业时间列表 | none |
| » timestamp | integer | true | none | none |
清扫统计图表
接口描述
根据 机器人 ID,时间,时间类型 获取清扫统计图表数据
请求方式
GET
请求方法
/sol_monitor/clean/robot/cleanTask/cleanArea/arr
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| datetime | query | string | 是 | 时间 |
| robotId | query | string | 是 | 机器人 ID |
| dataType | query | string | 是 | 时间类型(七天:“SEVEN_DAY”,月:“MONTH”,年:“YEAR”,总:“TOTAL” |
返回示例
{
"success": true,
"message": "操作成功!",
"code": 200,
"result": {
"cleanArea": [
{
"cleaningDistance": 521463.2554779053,
"actualCleaningArea": 274990.5807914734,
"cleanNum": null,
"day": 16,
"month": 1,
"year": 24,
"allDate": "2024",
"time": null
},
{
"cleaningDistance": 141.81700134277344,
"actualCleaningArea": 61.97520065307617,
"cleanNum": null,
"day": 28,
"month": 12,
"year": 23,
"allDate": "2023",
"time": null
},
{
"cleaningDistance": 95583.39257144928,
"actualCleaningArea": 53943.5986328125,
"cleanNum": null,
"day": 1,
"month": 1,
"year": 25,
"allDate": "2025",
"time": null
}
]
},
"timestamp": 1741846184415
}
返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | none | none | |
| » message | string | true | none | none | |
| » code | integer | true | none | none | |
| » result | object | true | none | none | |
| »» cleanArea | [object] | true | none | none | |
| »»» cleaningDistance | number | true | none | 清扫里程 | none |
| »»» actualCleaningArea | number | true | none | 清扫面积 | none |
| »»» cleanNum | null | true | none | 清扫次数 | none |
| »»» day | integer | true | none | 日 | none |
| »»» month | integer | true | none | 月 | none |
| »»» year | integer | true | none | 年 | none |
| »»» allDate | string | true | none | 完整时间(年) | none |
| »»» time | null | true | none | none | |
| » timestamp | integer | true | none | none |
巡检异常统计图表
接口描述
根据 电站 ID、机器人 ID 获取巡检异常统计图表数据
请求方式
GET
请求方法
/clean/inspectionRecord/list
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| plantId | query | string | 是 | 电站 ID |
| robotId | query | string | 是 | 机器人 ID |
| type | query | string | 否 | none |
| status | query | string | 否 | 清除异常状态 |
返回示例
200 Response
{
"success": true,
"message": "string",
"code": 0,
"result": [
{
"id": 0,
"createTime": "string",
"updateTime": "string",
"siteId": "string",
"plantId": 0,
"workingMapId": "string",
"robotId": "string",
"photo": "string",
"photoUrl": "string",
"photoName": "string",
"type": "string",
"confidence": 0,
"area": "string",
"photoAt": "string",
"uploadAt": "string",
"status": "string",
"longitude": 0,
"longitudeType": "string",
"latitude": 0,
"latitudeType": "string",
"altitude": 0,
"positioningMode": "string",
"yawAngle": 0,
"moduleId": null,
"recognitionId": null,
"abnormalEndTime": "string",
"abnormalClearUser": null,
"keyId": "string"
}
],
"timestamp": 0
}
返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | none | none | |
| » message | string | true | none | none | |
| » code | integer | true | none | none | |
| » result | [object] | true | none | none | |
| »» id | integer | true | none | ID | none |
| »» createTime | string | true | none | 创建时间 | none |
| »» updateTime | string | true | none | 更新时间 | none |
| »» siteId | string | true | none | 站点 ID | none |
| »» plantId | integer | true | none | 电站 ID | none |
| »» workingMapId | string | true | none | 作业地图 ID | none |
| »» robotId | string | true | none | 机器人 ID | none |
| »» photo | string | true | none | 图片 | none |
| »» photoUrl | string | true | none | 图片 url | none |
| »» photoName | string | true | none | 图片名称 | none |
| »» type | string | true | none | 类型 | none |
| »» confidence | number | true | none | 置信度 | none |
| »» area | string | true | none | 区域 | none |
| »» photoAt | string | true | none | 拍摄时间 | none |
| »» uploadAt | string | true | none | 上传时间 | none |
| »» status | string | true | none | 状态 | none |
| »» longitude | number | true | none | 经度 | none |
| »» longitudeType | string | true | none | 经度类型 | none |
| »» latitude | number | true | none | 纬度 | none |
| »» latitudeType | string | true | none | 纬度类型 | none |
| »» altitude | integer | true | none | 高度 | none |
| »» positioningMode | string | true | none | 定位 | none |
| »» yawAngle | number | true | none | 偏航角 | none |
| »» moduleId | null | true | none | 模块 ID | none |
| »» recognitionId | null | true | none | 识别 Id | none |
| »» abnormalEndTime | string¦null | true | none | 清除时间 | none |
| »» abnormalClearUser | null | true | none | 清除人 | none |
| »» keyId | string | true | none | 机器人 ID | none |
| » timestamp | integer | true | none | none |
机器人任务管理列表
接口描述
根据 机器人 ID、电站 ID、清扫状态 获取机器人任务管理列表数据
请求方式
POST
请求方法
/sol_monitor/clean/robot/getRobotCleanTask
清扫状态: 进行中: cleaning:清扫中;waiting:暂停中; 待执行: reated:已创建;assigned:已下发; 已结束: cleaned:已完成;aborted:异常终止;killed:强制终止;
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| keyWord | query | string | 否 | 关键字 |
| robotId | query | string | 是 | 机器人 ID |
| plantId | query | string | 是 | 电站 ID |
| statusList | query | array[string] | 是 | 清扫状态 |
| completionPercentMin | query | string | 否 | 清扫比例最小值 |
| completionPercentMax | query | string | 否 | 清扫比例最大值 |
| startAtStart | query | string | 否 | 开始时间范围-开始时间 |
| startAtEnd | query | string | 否 | 开始时间范围-结束时间 |
| endAtStart | query | string | 否 | 结束时间范围-开始时间 |
| endAtEnd | query | string | 否 | 结束时间范围-结束时间 |
| page | query | string | 否 | 页码 |
| pageSize | query | string | 否 | 页数 |
| isQueryLog | query | string | 否 | none |
返回示例
200 Response
{
"success": true,
"message": "string",
"code": 0,
"result": {
"records": [
{
"status": "string",
"completionPercent": "string",
"id": "string",
"robotName": "string",
"serialNumber": "string",
"workName": "string",
"workId": "string",
"mapName": "string",
"mapId": "string",
"siteName": "string",
"siteId": "string",
"startAt": "string",
"endAt": "string",
"cleanCountStatus": 0,
"schedulingMethod": "string",
"cleaningStatus": 0,
"actualCleaningArea": 0,
"cleaningLogVoList": [
{
"logId": null,
"stage": null,
"completionPercent": null,
"startAt": null,
"endAt": null,
"actualCleaningArea": null,
"cleaningDistance": null,
"cleaningDuration": null,
"robotArrList": null,
"endReason": null,
"duration": null,
"drivingDistance": null,
"chargeTimes": null
}
]
}
],
"total": 0,
"size": 0,
"current": 0,
"orders": ["string"],
"optimizeCountSql": true,
"hitCount": true,
"searchCount": true,
"pages": 0
},
"timestamp": 0
}
返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | none | none | |
| » message | string | true | none | none | |
| » code | integer | true | none | none | |
| » result | object | true | none | none | |
| »» records | [object] | true | none | none | |
| »»» status | string | false | none | 状态 | cleaning,waiting,created,assigned,cleaned,aborted,killed |
| »»» completionPercent | string | false | none | 完成百分比 | none |
| »»» id | string | false | none | ID | none |
| »»» robotName | string | false | none | 机器人名称 | none |
| »»» serialNumber | string | false | none | 序列号 | none |
| »»» workName | string | false | none | 工作计划名称 | none |
| »»» workId | string | false | none | 工作计划 ID | none |
| »»» mapName | string | false | none | 作业区域名称 | none |
| »»» mapId | string | false | none | 作用区域 ID | none |
| »»» siteName | string | false | none | 站点名称 | none |
| »»» siteId | string | false | none | 站点 ID | none |
| »»» startAt | string | false | none | 开始时间 | none |
| »»» endAt | string | false | none | 结束时间 | none |
| »»» cleanCountStatus | integer | false | none | none | |
| »»» schedulingMethod | string | false | none | none | |
| »»» cleaningStatus | integer | false | none | none | |
| »»» actualCleaningArea | number | false | none | 清扫面积(㎡) | none |
| »»» cleaningLogVoList | [object] | false | none | 清扫阶段列表 | none |
| »»»» logId | null | false | none | none | |
| »»»» stage | string | false | none | 阶段 | none |
| »»»» completionPercent | string | false | none | 完成进度百分比 | none |
| »»»» startAt | string | false | none | 开始时间 | none |
| »»»» endAt | string | false | none | 结束时间 | none |
| »»»» actualCleaningArea | string | false | none | 清扫面积(㎡) | none |
| »»»» cleaningDistance | string | false | none | none | |
| »»»» cleaningDuration | string | false | none | none | |
| »»»» robotArrList | null | false | none | none | |
| »»»» endReason | string | false | none | none | |
| »»»» duration | string | false | none | none | |
| »»»» drivingDistance | string | false | none | none | |
| »»»» chargeTimes | string | false | none | none | |
| »» total | integer | true | none | none | |
| »» size | integer | true | none | none | |
| »» current | integer | true | none | none | |
| »» orders | [string] | true | none | none | |
| »» optimizeCountSql | boolean | true | none | none | |
| »» hitCount | boolean | true | none | none | |
| »» searchCount | boolean | true | none | none | |
| »» pages | integer | true | none | none | |
| » timestamp | integer | true | none | none |
机器人-任务详情
接口描述
根据 任务 ID 获取机器人任务详情
请求方式
GET
请求方法
/sol_monitor/clean/robot/getCleaningDetail
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| taskId | query | string | 是 | 任务 ID |
返回示例
200 Response
{
"success": true,
"message": "string",
"code": 0,
"result": {
"id": "string",
"siteId": "string",
"robotId": "string",
"workingMapId": "string",
"workingMapName": "string",
"workingPlanName": "string",
"workingPlanId": "string",
"schedulingMethod": "string",
"scheduledCleaningAt": "string",
"status": "string",
"startAt": "string",
"endAt": "string",
"duration": 0,
"cleaningDuration": 0,
"drivingDistance": 0,
"cleaningDistance": 0,
"chargeTimes": 0,
"targetCleaningArea": 0,
"actualCleaningArea": 0,
"completionPercent": 0,
"endReason": "string",
"stage": 0
},
"timestamp": 0
}
返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | none | none | |
| » message | string | true | none | none | |
| » code | integer | true | none | none | |
| » result | object | true | none | none | |
| »» id | string | true | none | ID | none |
| »» siteId | string | true | none | 站点 ID | none |
| »» robotId | string | true | none | 机器人 ID | none |
| »» workingMapId | string | true | none | 作业地图 ID | none |
| »» workingMapName | string | true | none | 作业地图名称 | none |
| »» workingPlanName | string | true | none | 作业计划名称 | none |
| »» workingPlanId | string | true | none | 作业计划 ID | none |
| »» schedulingMethod | string | true | none | 调度方式 | none |
| »» scheduledCleaningAt | string | true | none | 预定清扫时间 | none |
| »» status | string | true | none | 状态 | none |
| »» startAt | string | true | none | 开始时间 | none |
| »» endAt | string | true | none | 结束时间 | none |
| »» duration | integer | true | none | 任务时长 | none |
| »» cleaningDuration | integer | true | none | 清扫时长 | none |
| »» drivingDistance | number | true | none | 行驶里程(㎡) | none |
| »» cleaningDistance | number | true | none | 清扫里程(m) | none |
| »» chargeTimes | integer | true | none | 充电次数 | none |
| »» targetCleaningArea | number | true | none | 目标清扫面积(㎡) | none |
| »» actualCleaningArea | number | true | none | 实际清扫面积(㎡) | none |
| »» completionPercent | number | true | none | 完成比例(百分比) | none |
| »» endReason | string | true | none | 结束原因 | none |
| »» stage | integer | true | none | 阶段 | none |
| » timestamp | integer | true | none | none |
机器人-任务详情-阶段列表
接口描述
根据 任务 ID 获取机器人-任务详情-阶段列表数据
请求方式
GET
请求方法
/sol_monitor/clean/robot/getCleaningLogBrief
请求参数
| 名称 | 位置 | 类型 | 必选 | 说明 |
|---|---|---|---|---|
| taskId | query | string | 是 | 任务 ID |
返回示例
200 Response
{
"success": true,
"message": "string",
"code": 0,
"result": [
{
"logId": "string",
"stage": "string",
"completionPercent": "string",
"startAt": "string",
"endAt": "string",
"actualCleaningArea": "string",
"cleaningDistance": "string",
"cleaningDuration": "string",
"robotArrList": null,
"endReason": "string",
"duration": "string",
"drivingDistance": "string",
"chargeTimes": "string"
}
],
"timestamp": 0
}
返回结果
| 状态码 | 状态码含义 | 说明 | 数据模型 |
|---|---|---|---|
| 200 | OK | none | Inline |
返回数据结构
状态码 200
| 名称 | 类型 | 必选 | 约束 | 中文名 | 说明 |
|---|---|---|---|---|---|
| » success | boolean | true | none | none | |
| » message | string | true | none | none | |
| » code | integer | true | none | none | |
| » result | [object] | true | none | none | |
| »» logId | string | false | none | 日志 ID | none |
| »» stage | string | false | none | 阶段 | none |
| »» completionPercent | string | false | none | 完成进度百分比 | none |
| »» startAt | string | false | none | 开始时间 | none |
| »» endAt | string | false | none | 结束时间 | none |
| »» actualCleaningArea | string | false | none | 清扫面积 | none |
| »» cleaningDistance | string | false | none | 清扫里程 | none |
| »» cleaningDuration | string | false | none | 清扫时长 | none |
| »» robotArrList | null | false | none | none | |
| »» endReason | string | false | none | 结束原因 | none |
| »» duration | string | false | none | 任务时长 | none |
| »» drivingDistance | string | false | none | 行驶里程 | none |
| »» chargeTimes | string | false | none | 充电次数 | none |
| » timestamp | integer | true | none | none |