{"id":545,"date":"2023-03-30T17:43:06","date_gmt":"2023-03-30T09:43:06","guid":{"rendered":"https:\/\/doc.orionstar.com\/en\/?post_type=lsvr_kba&p=545"},"modified":"2023-05-24T11:02:53","modified_gmt":"2023-05-24T03:02:53","slug":"map-and-position","status":"publish","type":"lsvr_kba","link":"https:\/\/doc.orionstar.com\/en\/knowledge-base\/map-and-position\/","title":{"rendered":"Map and Position"},"content":{"rendered":"\n

Introduction<\/strong><\/a><\/h3>\n\n\n\n

Maps and positioning are the prerequisites for robot navigation. Creating a new map is equivalent to telling the robot’s walking range, and positioning is equivalent to telling the robot’s current location. The robot comes with a “map tool” that can complete all map and point operations, of course, you can also use the api to complete the function yourself.<\/p>\n\n\n\n

Set point:inform robot the name of the current point, and then you can use the interface to navigate to this point<\/pre>\n\n\n\n
Mapping and positioning<\/strong><\/a><\/h3>\n\n\n\n
Mapping and positioning can be operated with the integrated map tool on the robot.<\/p>\n\n\n\n
Positioning (set the initial coordinate point of the robot)<\/strong><\/a><\/h3>\n\n\n\n
Method name: setPoseEstimate<\/p>\n\n\n\n
Calling method:<\/p>\n\n\n\n
try {    \n    JSONObject params = new JSONObject();    \n    \/\/x coordinate    \n    params.put(Definition.JSON_NAVI_POSITION_X, x);    \n    \/\/y coordinate    \n    params.put(Definition.JSON_NAVI_POSITION_Y, y);    \n    \/\/z coordinate    \n    params.put(Definition.JSON_NAVI_POSITION_THETA, theta);        \n    RobotApi.getInstance().setPoseEstimate(reqId, params.toString(), new CommandListener() {            \n    @Override \n    public void onResult(int result, String message) {            \n            if (\"succeed\".equals(message)) {                \n                \/\/Successful positioning            \n            }        \n        }    \n    });\n} catch (JSONException e) {    \n    e.printStackTrace();\n}<\/pre>\n\n\n\n
Applicable Platform:<\/p>\n\n\n\n
GreetBot<\/th>Mini<\/th>Lucki<\/th>DeliverBot<\/th>BigScreenBot<\/th><\/tr><\/thead>
Yes<\/td>Yes<\/td>Yes<\/td>Yes<\/td>No<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Determine whether it is currently located<\/strong><\/a><\/h3>\n\n\n\n
Method name: isRobotEstimate<\/p>\n\n\n\n
Calling method:<\/p>\n\n\n\n
RobotApi.getInstance().isRobotEstimate(reqId, new CommandListener() {    \n    @Override \n    public void onResult(int result, String message) {        \n        if (!\"true\".equals(message)) {            \n            \/\/currently not located        \n        } else {            \n            \/\/currently located        \n        }    \n    }\n});<\/pre>\n\n\n\n
Applicable Platform:<\/p>\n\n\n\n
GreetBot<\/th>Mini<\/th>Lucki<\/th>DeliverBot<\/th>BigScreenBot<\/th><\/tr><\/thead>
Yes<\/td>Yes<\/td>Yes<\/td>Yes<\/td>No<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Set current location name<\/strong><\/a><\/h3>\n\n\n\n
Method name: setLocation<\/p>\n\n\n\n
Calling method:<\/p>\n\n\n\n
RobotApi.getInstance().setLocation(reqId, placeName, new CommandListener() {    \n    @Override \n    public void onResult(int result, String message) {        \n        if (\"succeed\".equals(message)) {            \n            \/\/save the location point successfully        \n        } else {            \n            \/\/failed to save location point        \n        }    \n    }\n});<\/pre>\n\n\n\n
Parameter Description:<\/p>\n\n\n\n