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:
| Eigenschaft | Wert |
|---|---|
| Endpunkt | POST /api/owntracks |
| Authentifizierung | HTTP Basic Auth mit fahrerspezifischen Zugangsdaten |
| Datenformat | JSON gemäß OwnTracks-Spezifikation |
| Antwort | 200 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:
- Im Admin-Bereich legen Sie einen Fahrer an. Schneespur erzeugt dabei automatisch die OwnTracks-Zugangsdaten für das GPS-Tracking.
- Auf der Fahrer-Detailseite lassen sich diese Zugangsdaten als QR-Code anzeigen.
- 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.