{"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":"2026-11-03T11:00:55","modified_gmt":"2026-11-03T03:00:55","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><\/p>\n\n\n\n

Maps and localization are prerequisites for robot navigation. Creating a map tells the robot the area it can move in, and localization tells the robot where it currently is. The robot’s built-in “Map Tool” can perform all map and map point operations, but you can also implement these functions yourself with the API.<\/p>\n\n\n\n

Setting a point: telling the robot the name of its current location, so that you can later navigate to this map point using the API.<\/p>\n\n\n\n

Mapping and Localization<\/strong><\/p>\n\n\n\n

You can perform mapping and localization with the map tool built into the system.<\/p>\n\n\n\n

In map coordinates, x and y are the robot’s position on the map, and theta is the direction the robot is facing (in radians).<\/p>\n\n\n\n

Localization (Set the Robot’s Initial Coordinates)<\/strong><\/p>\n\n\n\n

Method name:setPoseEstimate<\/p>\n\n\n\n

How to call:<\/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                \/\/Localization succeeded\n            }\n        }\n    });\n} catch (JSONException e) {\n    e.printStackTrace();\n}<\/pre>\n\n\n\n
Supported platforms:<\/p>\n\n\n\n
GreetingBot<\/td>GreetingBot 2<\/td>GreetingBot Mini<\/td>LuckiBot<\/td>LuckiBot Pro<\/td>BigScreenBot<\/td><\/tr>
Yes<\/td>Yes<\/td>Yes<\/td>Yes<\/td>Yes<\/td>No<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Check Whether the Robot Is Localized<\/strong><\/p>\n\n\n\n
Method name:isRobotEstimate<\/p>\n\n\n\n
How to call:<\/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            \/\/Not localized\n        } else {\n            \/\/Localized\n        }\n    }\n});<\/pre>\n\n\n\n
Supported platforms:<\/p>\n\n\n\n
GreetingBot<\/td>GreetingBot 2<\/td>GreetingBot Mini<\/td>LuckiBot<\/td>LuckiBot Pro<\/td>BigScreenBot<\/td><\/tr>
Yes<\/td>Yes<\/td>Yes<\/td>Yes<\/td>Yes<\/td>No<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
Set the Name of the Current Location<\/strong><\/p>\n\n\n\n
Method name:setLocation<\/p>\n\n\n\n
How to call:<\/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            \/\/Location point saved\n        } else {\n            \/\/Failed to save location point\n        }\n    }\n});<\/pre>\n\n\n\n
Parameters<\/p>\n\n\n\n
\n
\n
\n