Zum Hauptinhalt springen
Schneespur
Dokumentation durchblättern

Betrieb & Self-Hosting

OwnTracks / GPS-Quelle einrichten

Wie die GPS-Erfassung technisch angebunden wird: die kostenlose OwnTracks-App, der HTTP-Endpunkt, fahrerspezifische Zugangsdaten per QR-Code und die Zuordnung von Fahrzeugen.

Schneespur erfasst GPS-Tracks nicht über einen eigenen Tracking-Client, sondern über die kostenlose Open-Source-App OwnTracks (iOS und Android). Die App läuft im Hintergrund auf dem Smartphone des Fahrers und sendet die Standortdaten direkt an Ihre eigene Schneespur-Installation — nicht an einen Drittanbieter. Diese Seite beschreibt die technische Anbindung; die Funktion aus Anwendersicht erklärt GPS-Tracking.

Der HTTP-Endpunkt

Die Standortdaten kommen über eine schlanke HTTP-Schnittstelle herein:

EigenschaftWert
EndpunktPOST /api/owntracks
AuthentifizierungHTTP Basic Auth mit fahrerspezifischen Zugangsdaten
DatenformatJSON gemäß OwnTracks-Spezifikation
Antwort200 OK bei erfolgreicher Verarbeitung

Weil die Daten direkt vom Smartphone an Ihren Server gehen, sollte Ihre Installation über HTTPS erreichbar sein — Standortdaten gehören verschlüsselt übertragen. Der Endpunkt ist Teil der normalen Anwendung; er ist erreichbar, sobald das Document-Root korrekt auf public/ zeigt (siehe Installation).

Zugangsdaten und Provisionierung

Sie müssen für OwnTracks nichts von Hand konfigurieren. Der Ablauf ist bewusst so kurz, dass ein Fahrer ohne technisches Vorwissen einsatzbereit ist:

  1. Im Admin-Bereich legen Sie einen Fahrer an. Schneespur erzeugt dabei automatisch die OwnTracks-Zugangsdaten für das GPS-Tracking.
  2. Auf der Fahrer-Detailseite lassen sich diese Zugangsdaten als QR-Code anzeigen.
  3. Der Fahrer scannt den QR-Code mit der OwnTracks-App — die Verbindung steht.

Die Zugangsdaten sind fahrerspezifisch, sodass sich jeder Track eindeutig einem Fahrer zuordnen lässt. Sie können jederzeit rotiert werden — etwa wenn ein Gerät verloren geht oder ein Fahrer wechselt. Nach der Rotation muss der Fahrer den neuen QR-Code einmal neu scannen.

Fahrzeuge zuordnen

Fahrzeuge verwalten Sie zentral mit Name, Kennzeichen und einem optionalen OwnTracks-Geräte-Identifikator. Einem Fahrer lässt sich ein Standardfahrzeug zuweisen, das beim Einsatzstart bereits vorausgewählt ist — das spart im nächtlichen Einsatz einen Handgriff.

Wenn ein Fahrer den Betrieb verlässt

Beim Ausscheiden eines Fahrers werden bei der Anonymisierung auch dessen OwnTracks-Zugangsdaten unwiderruflich durch Platzhalter ersetzt. Die Einsatznachweise bleiben dabei vollständig erhalten, sind aber keiner realen Person mehr zuordenbar. Mehr zur Datenseite steht unter Datenhoheit, Export & Serverumzug.