Hilfe - MotoMunity

Dieses Handbuch hilft Ihnen bei der Einrichtung und Nutzung der MotoMunity-App.

Inhaltsverzeichnis

Android App - Einstellungen & Berechtigungen
Allgemeine Nutzungshinweise
Häufige Probleme & Lösungen
API Referenz (Entwickler)

Android App - Einstellungen & Berechtigungen

Berechtigungen

Benötigt Standortzugriff (FEINER STANDORT)
Benötigt Hintergrund-Standortzugriff
Android 13+ Benachrichtigungsberechtigung
Android 13+ Akku-Statistiken

Tracking-Einstellungen

Intervall: Positionserfassung (Standard: 5s)
Distanzfilter: Min. Bewegung (Standard: 1m)
Kurven-Erkennung: Richtungsänderungen (aktiviert)

Bluetooth-Steuerung ▼

In den Profil-Einstellungen können Sie Bluetooth-Geräte konfigurieren:

App startet Tracking beim Verbinden eines Geräts
App stoppt Tracking beim Trennen des Geräts
Im Profil unter "Bluetooth" Geräte hinzufügen

Externe Automatisierung ▼

Nutzen Sie Tasker, Automate oder ähnliche Apps mit diesen Aktionen:

com.motomunity.app.ACTION_START_TRACKING - Start Tracking
com.motomunity.app.ACTION_STOP_TRACKING - Stop Tracking

Allgemeine Nutzungshinweise

Tracking starten/stoppen ▼

In der Kartenansicht können Sie das Tracking manuell steuern:

Start-Button: Beginnt eine neue Trackingsitzung
Stop-Button: Beendet die aktuelle Sitzung
Nach dem Stop wird automatisch eine letzte Position erfasst

Routen verwalten ▼

In der Routenansicht können Sie Ihre Aufzeichnungen organisieren:

Details anzeigen (Karte, Statistiken, Fotos)
Fahrzeugzuordnung konfigurieren
Routen öffentlich teilen über Link

Schnellhilfe ▼

Falls Probleme auftreten:

Alle Berechtigungen gewährt?
Tracking-Einstellungen im Profil prüfen
Bluetooth-Gerät bei Bluetooth-Tracking verbunden?
App auf neueste Version aktualisieren

Häufige Probleme & Lösungen

Android Häufige Probleme ▼

Tracking stoppt im Hintergrund

Lösung: Akku-Optimierung deaktivieren und in "App-Starter"-Liste hinzufügen (Huawei/Xiaomi/OnePlus)

Keine Bluetooth-Geräte angezeigt

Lösung: Bluetooth-Verbindungs-Berechtigung aktivieren (Android 12+)

Upload-Fehler in Queue

Lösung: Netzwerk prüfen → "Jetzt hochladen" klicken → bei dauerhaften Fehlern "Fehlgeschlagene löschen"

GPS-Berechtigung nicht erkannt

Lösung: App schließen & neu öffnen, Standort auf "Immer erlauben" setzen

iOS Häufige Probleme ▼

Tracking stoppt nach Sperrbildschirm

Lösung: Hintergrundaktualisierung aktivieren in Einstellungen → MotoMunity

Bluetooth-Geräte nicht angezeigt

Lösung: App neu starten, Berechtigungen prüfen, Bluetooth aktivieren

Allgemein Probleme ▼

Route erscheint nicht auf Server

Lösung: Upload-Queue prüfen → Internetverbindung sicherstellen → manuell hochladen → /api/health testen

Nickname nicht genehmigt

Lösung: Administrator muss in Admin → Benutzer genehmigen, oder Abbrechen & erneut anfordern

Passwort vergessen

Lösung: "Passwort zurücksetzen" in Login-Maske nutzen oder Administrator kontaktieren

Entwickler API Referenz ▼

Verfügbare API Endpunkte

POST /api/auth/login - Benutzerlogin
POST /api/ingest/owntracks - OwnTracks Payload (Bearer Token)
GET /api/routes - Liste aller Routen
PATCH /api/routes/:id/close - Route schließen

Eigenes Tracking-System integrieren

Geräte-Token in App erstellen (Profil → Geräte)
OwnTracks-kompatible JSON an /api/ingest/owntracks senden
Authorization: Bearer <token> Header setzen

Beispiel-Payload:

{
  "_type": "location",
  "lat": 48.137154,
  "lon": 11.576124,
  "acc": 8.5,
  "alt": 520.0,
  "batt": 87,
  "tst": 1710934312,
  "topic": "trackme/geraetelabel",
  "vel": 45
}

Kontakt & Support

Für technische Probleme oder Unterstützung wenden Sie sich an den Administrator der MotoMunity-Instanz. Technischer Support ist über die Systemverwaltung des Servers möglich.