Difference between revisions of "Bot Playground/Commands/getLocation"
From SmartBots Developers Docs
| Line 41: | Line 41: | ||
Note: [[../status|Bot.status()]] command also returns 'location' but it may be cached for up to 30 seconds. | Note: [[../status|Bot.status()]] command also returns 'location' but it may be cached for up to 30 seconds. | ||
| + | |||
| + | 'position' is just a rounded copy of 'exactPosition'. It has been added for convenience, to avoid clogging code with *Math.round* calls. | ||
== Examples == | == Examples == | ||
Revision as of 09:40, 27 February 2025
Returns current location of the bot bot.
const res = await Bot.getLocation();
console.log("Bot location:", res);
Reference
This command accepts the following parameters:
| Variable | Required | Description
| |
|---|---|---|---|
| Input: | |||
| Output: | |||
| Function returns a Promise with the following data: | |||
| success | bool | true if command completed successfully | |
| error | string | error string if command has failed | |
| online | boolean | Bot online flag | |
| region | string | Bot region name | |
| position | object | Current bot position, rounded to integer:
{
x: number; // 100
y: number; // 110
z: number; // 20
}
| |
| exactPosition | object | Exact bot position (the same as 'position' but with decimals):
{
x: number; // 100.01
y: number; // 109.65
z: number; // 20.4
}
| |
Details
Command returns bot position, mostly in real-time. Use this command to track actual bot position.
Note: Bot.status() command also returns 'location' but it may be cached for up to 30 seconds.
'position' is just a rounded copy of 'exactPosition'. It has been added for convenience, to avoid clogging code with *Math.round* calls.
Examples
const loc = await Bot.getLocation();
if(loc.region == "DuoLife") {
console.log("Wow, I'm in SmartBots region now!");
console.log(loc);
}
Example output:
{
"online":true,
"region":"DuoLife",
"position":{
"x":230,
"y":78,
"z":32
},
"exactPosition":{
"x":229.6,
"y":77.69,
"z":32.1
}
}
