Get the location

Output data

Information provided

When executed, this operation delivers the following data, which can be used in the same automatic task.

• Tags

• Position known {{found}}

  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.

• Tag id {{device_id}}

• Tag name {{device_name}}

• Latitude {{latitude}}

• Longitude {{longitude}}

• Accuracy (m) {{accuracy}}

  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 link {{map_url}}

• Reading date (UTC) {{updated_at}}

  When the tag sent this position, in UTC. It is not the moment the step ran.

• Reading date (epoch) {{updated_ts}}

• Minutes since the reading {{minutes_ago}}

  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 (0-5) {{battery_level}}

  Charge in bars, 0 to 5 — the same bars the tag fills on its own screen, which shows no percentage. Roughly two days of use per bar. While it is charging it reports 9 instead, so a rule like 'less than 3' warns you in time and skips the charging case on its own.

• Needs charging {{needs_charge}}

  Yes when BoT itself is flagging the tag as needing a charge. It only arrives if the tag is reporting, so it does not cover a tag that is switched off or out of coverage — for that, put the rule on the battery bars instead.