# User location tracking

{% hint style="info" %}
Not available on all plans
{% endhint %}

FieldEdge tracks the GPS location where your canvassers log activity and compares it to the household's known location. This helps Campaign Managers spot anomalous behavior — especially useful when managing paid canvassers.

Location tracking is built into the **Stream** on the [Performance](/product-tour-or-hq/performance.md) page. There is no separate map view — location data appears as distance warnings on each activity card in the Stream.

## How It Works

When a canvasser completes a household during a walk, FieldEdge records two GPS coordinates:

* **Household location** — the address coordinates from NationBuilder
* **Activity location** — where the canvasser's device was when they logged the activity

The distance between these two points is calculated automatically and displayed on the activity card in the Stream.

## Distance Warnings

Activity cards in the Stream display a distance badge when location data is available. The badge is color-coded by severity:

| Distance  | Severity   | What It Means                                                |
| --------- | ---------- | ------------------------------------------------------------ |
| 0–30 m    | No warning | Canvasser was at or very near the household                  |
| 30–100 m  | Low        | Canvasser was nearby — typically normal                      |
| 100–500 m | Medium     | Canvasser was some distance away — worth reviewing           |
| 500+ m    | High       | Canvasser was far from the household — may indicate an issue |

{% hint style="info" %}
Use the **Warnings only** toggle in the Stream filters to show only activities with distance warnings. This is the fastest way to review location anomalies.
{% endhint %}

## Viewing Location Details

Tap an activity card in the Stream to open the detail sheet, which shows:

* **Household address** — clickable link to Google Maps
* **Household coordinates** — GPS lat/lng with a Google Maps link
* **Activity coordinates** — where the canvasser actually was, with a Google Maps link
* **Distance** — the calculated distance between the two points, with a "Get directions" link

{% hint style="info" %}
If a canvasser's device did not capture GPS coordinates, the activity card will show a "Not captured" badge instead of a distance.
{% endhint %}

{% content-ref url="/pages/81skv3NJj2yndoj1ERkb" %}
[Performance](/product-tour-or-hq/performance.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guides.fieldedgeapp.com/guide-to-canvassing-and-calls/reporting/user-location-tracking.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.