為方便用戶更高效的使用移動機(jī)器人，仙知向用戶開放機(jī)器人操作的相關(guān) API。之前分別介紹了仙知網(wǎng)絡(luò)協(xié)議API的概念、類別、使用教程及如何查詢機(jī)器人狀態(tài)API中的“機(jī)器人信息”和“機(jī)器人運行信息”等，本期將介紹“如何查詢機(jī)器人定位狀態(tài)”、“如何查詢機(jī)器人地圖載入狀態(tài)”及“如何查詢機(jī)器人掃圖狀態(tài)”：

如何查詢機(jī)器人定位狀態(tài)

查詢機(jī)器人定位狀態(tài)

請求

編號: 1021 (0x03FD)

名稱: robot_status_reloc_req

描述: 查詢機(jī)器人當(dāng)前的定位狀態(tài)

JSON 數(shù)據(jù)區(qū): 無

請求示例

響應(yīng)

編號: 11021 (0x2B0D)

名稱: robot_status_reloc_res

描述: 查詢機(jī)器人當(dāng)前的定位狀態(tài)的響應(yīng)

JSON 數(shù)據(jù)區(qū): 見下表

注意:定位狀態(tài) (1021) 用于指示當(dāng)前機(jī)器人定位狀態(tài)是否正確，定位狀態(tài)如果為 COMPLETED, 說明重定位已經(jīng)完成，但是用戶沒有確認(rèn)，此時需要通過 (2003) 來進(jìn)行確認(rèn)或重新進(jìn)行定位。用戶確認(rèn)定位正確后，定位狀態(tài)會變?yōu)?SUCCESS。

響應(yīng)示例

如何查詢機(jī)器人地圖載入狀態(tài)

查詢機(jī)器人地圖載入狀態(tài)

請求

編號: 1022 (0x03FE)

名稱: robot_status_loadmap_req

描述: 查詢機(jī)器人當(dāng)前地圖載入狀態(tài)

JSON 數(shù)據(jù)區(qū): 無

請求示例

響應(yīng)

編號: 11022 (0x2B0E)

名稱: robot_status_loadmap_res

描述: 查詢機(jī)器人當(dāng)前地圖載入狀態(tài)的響應(yīng)

JSON 數(shù)據(jù)區(qū): 見下表

注意:地圖載入狀態(tài) (1022) 用于指示當(dāng)前地圖是否載入成功，當(dāng)機(jī)器人剛啟動或者發(fā)生切換地圖操作時，地圖載入狀態(tài)會指示為 LOADING，此時無法進(jìn)行重定位操作，必須等地圖載入狀態(tài)變?yōu)?SUCCESS 后才能進(jìn)行重定位。

響應(yīng)示例

如何查詢機(jī)器人掃圖狀態(tài)

查詢機(jī)器人掃圖狀態(tài)

請求

編號: 1025 (0x0401)

名稱: robot_status_slam_req

描述: 查詢機(jī)器人當(dāng)前的掃圖狀態(tài)

JSON 數(shù)據(jù)區(qū): 無

請求示例

響應(yīng)

編號: 11025 (0x2B11)

名稱: robot_status_slam_res

描述: 查詢機(jī)器人當(dāng)前的掃圖狀態(tài)的響應(yīng)

JSON 數(shù)據(jù)區(qū): 見下表

響應(yīng)示例