为方便用户更高效的使用移动机器人，仙知向用户开放机器人操作的相关 API。之前分别介绍了仙知网络协议API的概念、类别、使用教程及如何查询机器人状态API中的“机器人信息”和“机器人运行信息”等，本期将介绍“如何查询机器人定位状态”、“如何查询机器人地图载入状态”及“如何查询机器人扫图状态”：

如何查询机器人定位状态

　　查询机器人定位状态

　　请求

　　编号: 1021 (0x03FD)

　　名称: robot_status_reloc_req

　　描述: 查询机器人当前的定位状态

　　JSON 数据区: 无

　　请求示例

　　响应

　　编号: 11021 (0x2B0D)

　　名称: robot_status_reloc_res

　　描述: 查询机器人当前的定位状态的响应

　　JSON 数据区: 见下表

　　注意: 定位状态 (1021) 用于指示当前机器人定位状态是否正确，定位状态如果为 COMPLETED, 说明重定位已经完成，但是用户没有确认，此时需要通过 (2003) 来进行确认或重新进行定位。用户确认定位正确后，定位状态会变为 SUCCESS。

　　响应示例

如何查询机器人地图载入状态

　　查询机器人地图载入状态

　　请求

　　编号: 1022 (0x03FE)

　　名称: robot_status_loadmap_req

　　描述: 查询机器人当前地图载入状态

　　JSON 数据区: 无

　　请求示例

　　响应

　　编号: 11022 (0x2B0E)

　　名称: robot_status_loadmap_res

　　描述: 查询机器人当前地图载入状态的响应

　　JSON 数据区: 见下表

　　注意: 地图载入状态 (1022) 用于指示当前地图是否载入成功，当机器人刚启动或者发生切换地图操作时，地图载入状态会指示为 LOADING，此时无法进行重定位操作，必须等地图载入状态变为 SUCCESS 后才能进行重定位。

　　响应示例

如何查询机器人扫图状态

　　查询机器人扫图状态

　　请求

　　编号: 1025 (0x0401)

　　名称: robot_status_slam_req

　　描述: 查询机器人当前的扫图状态

　　JSON 数据区: 无

　　请求示例

　　响应

　　编号: 11025 (0x2B11)

　　名称: robot_status_slam_res

　　描述: 查询机器人当前的扫图状态的响应

　　JSON 数据区: 见下表

　　响应示例

　　更多仙知网络协议API使用教程

　　后期将会陆续推出

　　敬请关注下期

　　仙知网络协议API使用教程(十)