Overview
GPS capture records the executor's latitude and longitude at the moment a step is completed. It answers the question: "Was my cleaner actually at the property when they completed this checklist?" and "Was the car inspection conducted at the correct lot?"
GPS is opt-in per step in the TDL. Executors who deny location permission are not blocked from completing the step — the geo field in the answer is simply null. This is intentional: GPS adds accountability without creating a hard dependency on device permissions.
How it works
When geo: true is set on a step, the Rundun mobile app requests the device's current location using the platform location API (iOS Core Location / Android Location Services) at the moment the step is submitted. The coordinates are sent with the step answer and included in the webhook payload.
The app uses the most accurate available location fix. No continuous background tracking occurs — location is sampled exactly once per step, when the executor taps "Complete step".
TDL configuration
Enable GPS capture by setting geo: true on any step:
{
"id": "s-e3f2",
"type": "boolean",
"label": "Confirm you are at the property",
"required": true,
"geo": true
}Omit the geo field (or set it to false) to disable location capture for a step. GPS defaults to off.
Answer shape
When geo: true is set, the answer includes a geo object:
{
"s-e3f2": {
"value": true,
"geo": {
"lat": 37.7749,
"lng": -122.4194,
"accuracy": 5.2
},
"at": "2026-05-22T08:32:00Z"
}
}If the executor denied location permission or the device couldn't get a fix, geo is null:
{
"s-e3f2": {
"value": true,
"geo": null,
"at": "2026-05-22T08:32:00Z"
}
}Value for STR hosts
For short-term rental hosts, GPS capture on the first and last steps of a turnover checklist confirms the cleaner was physically present at the property. This is particularly useful when working with cleaning contractors — it provides an objective record if a guest later claims the property wasn't cleaned.
Value for car rental operators
Stamping GPS on a vehicle handoff checklist confirms the pre-rental and post-rental inspections occurred at the correct location (your lot, not at the customer's home two days later). Combined with timestamps, this creates an indisputable chain of custody.
When to enable GPS
Enable geo: true when the location of the action matters — confirming presence at a property, recording where damage was noted on a vehicle, or verifying a site visit occurred. Use it selectively: not every step needs a location stamp, and overusing it increases battery drain.
When to disable GPS
Leave geo: false (the default) for administrative steps, text inputs, or anything where location adds no value. For example, "Enter the guest's name" or "Rate the overall condition" don't benefit from GPS data.
Privacy considerations
Location data is collected only when the executor grants permission and only at step completion time — not continuously. The accuracy field (in meters) indicates how precise the reading is. Consider informing executors in your template instructions that location is captured for accountability purposes.