為方便用戶更高效的使用移動機器人,仙知向用戶開放機器人操作的相關 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 數據區: 見下表
響應示例
2025-04-21 12:16
2025-04-21 12:16
2025-04-21 12:14
2025-04-21 12:13
2025-04-21 12:13
2025-04-21 12:12
2025-04-21 12:11
2025-04-21 12:10
2025-04-21 12:09
2025-04-21 12:08