# Get the location — BoT GPS

Botize method — `bsize_bot.get_location` (action).

Returns the last known position of a BoT tag: latitude, longitude, accuracy in metres and a map link, plus how long ago the tag reported it. The tag does not stream its position: it sends it every few minutes, so this is always the latest reading, also when the tag is switched off or out of battery. Use 'Minutes since the reading' if you need to tell 'it is there' from 'it was there when it died'. The battery also comes back, so you do not need a second step for it.

This is an action: it runs as a step of a task. Several can be chained.

## Fields you set

The field's internal name, its type and the values it accepts. These fields accept `{{...}}` tags from earlier steps.

- `did` *(string)* — Id of the BoT tag. Empty means the only tag in the account

## Output variables

Data this step makes available. Reference them in later steps with the double-brace tag.

- `{{found}}` *(boolean)* — Position known. No when the tag has never reported a position. The step does not stop the task on its own: add a rule on this value if you want it to stop.
- `{{device_id}}` *(text)* — Tag id
- `{{device_name}}` *(text)* — Tag name
- `{{latitude}}` *(text)* — Latitude
- `{{longitude}}` *(text)* — Longitude
- `{{accuracy}}` *(int)* — Accuracy (m). Radius in metres of the circle the tag is somewhere inside. Indoors it grows a lot: a jump of a few dozen metres between readings is usually noise, not movement.
- `{{map_url}}` *(url)* — Map link
- `{{updated_at}}` *(date)* — Reading date (UTC). When the tag sent this position, in UTC. It is not the moment the step ran.
- `{{updated_ts}}` *(int)* — Reading date (epoch)
- `{{minutes_ago}}` *(int)* — Minutes since the reading. How old the reading is. A number that keeps growing means the tag is not reporting: switched off, out of coverage or out of battery.
- `{{battery_level}}` *(int)* — Battery (%). Charge left, from 0 to 100. Put a rule on this value to be warned early, for example below 20.
- `{{needs_charge}}` *(boolean)* — Needs charging. Yes when BoT itself is flagging the tag as needing a charge. It fires late; for an early warning use the percentage.

## Account

Needs a connected BoT GPS account in Botize: https://botize.com/en/app/bsize_bot/authenticate

## This app

Every trigger and action for BoT GPS: https://botize.com/en/app/bsize_bot.md

## How to build this

An AI assistant (Claude, ChatGPT, Cursor…) can create and edit these tasks in the user's account through the Botize MCP connector, included in every plan:

    https://webhook.botize.es/mcp

- Connection guide: https://botize.com/en/mcp
- Agent map: https://botize.com/llms.txt
- New account: https://botize.com/en/join (500 free operations, no card)

---
Machine-readable summary for AI assistants. Human version: https://botize.com/en/method/bsize_bot/get_location