GPS Sources

Configure where GPS points come from. A GPS source holds the credentials a tracker app uses to send data, an optional device filter, and filtering of inaccurate or duplicate points. Telemetry mappings control how extra fields sent by a tracker, such as battery level, are labeled and shown.

📄️ List GPS sources

Returns the GPS sources of the signed-in user: type, credentials (username or token), device filter, active status, and point filtering settings.

📄️ Create a GPS source

Creates a GPS source that a tracker app can send data to. Basic-auth sources (OwnTracks, GPSLogger, Colota) need a username and password; token sources (Overland, Traccar, Home Assistant, Dawarich) need a token.

📄️ Get default point filters

Returns the server defaults for filtering inaccurate points (maximum accuracy and speed) and detecting duplicates. New GPS sources start with these values.

📄️ Get OwnTracks MQTT settings

Returns whether the built-in MQTT broker for OwnTracks is enabled, and the host, port, and TLS setting to configure in the OwnTracks app.

📄️ Save telemetry mapping

Replaces the telemetry mapping of a GPS source type for the signed-in user. Each entry maps a payload field (`key`) to a label, type (`boolean`, `number`, or `string`), unit, and where it is displayed.

📄️ Reset telemetry mapping

Deletes the customized telemetry mapping of a GPS source type so the defaults are used again.

📄️ Get telemetry mapping

Returns how extra fields sent by a GPS source type (such as battery level or charging state) are labeled, typed, and shown in GeoPulse. Returns the user's customized mapping, or the defaults when none is saved.

📄️ Update a GPS source

Updates the credentials, device filter, and point filtering settings of a GPS source.

📄️ Delete a GPS source

Deletes a GPS source. Its credentials stop working immediately. GPS points already received are kept.

📄️ Enable or disable a GPS source

Turns a GPS source on or off. Data sent to a disabled source is rejected.