Konfiguration von Geschwindigkeitsbegrenzungszonen

Geschwindigkeitsbegrenzungszonen ermöglichen es Ihnen, die Fahrzeuggeschwindigkeit in bestimmten Bereichen automatisch zu beschränken. Wenn ein Fahrzeug während einer aktiven Fahrt in eine Geschwindigkeitszone einfährt, sendet das System IoT-Befehle an das Fahrzeug, um seine Höchstgeschwindigkeit zu begrenzen. Wenn das Fahrzeug die Zone verlässt, wird die Geschwindigkeit auf normal zurückgesetzt.

Hauptfunktionen

Häufige Anwendungsfälle

Hierarchie der Geschwindigkeitsbegrenzungen

Das Verständnis, wie Geschwindigkeitsbegrenzungen bestimmt werden, ist für die richtige Konfiguration entscheidend. Levy Fleets verwendet eine Hierarchie von Einstellungen.

Die Geschwindigkeitsbegrenzungsformel

Effektive Geschwindigkeit = min(
  Zonengeschwindigkeitsbegrenzung,       // Aus der speed_limit Zone
  Langsamzonen-Schwellenwert,            // Aus Unterkontoeinstellungen
  Fahrzeugmodell-Höchstgeschwindigkeit   // Aus der vehicle_models Tabelle
)

Das System wendet immer das niedrigste anwendbare Limit an, um die Sicherheit zu gewährleisten.

Prioritätsreihenfolge

1. Zonenspezifische Geschwindigkeitsbegrenzung - Der auf der Zone gesetzte speed_limit_kph-Wert
2. Unterkonto-Langsamgeschwindigkeitsschwelle - Die Einstellung slow_speed_zone_limit_kph (Standard: 10 km/h)
3. Fahrzeugmodell-Maximum - Das max_speed_kmh aus dem Fahrzeugmodell

Beispielszenarien

Geschwindigkeitsbegrenzungszonen erstellen

Richtlinien für Geschwindigkeitsbegrenzungen

Gültiger Geschwindigkeitsbereich

• Minimum: 1 km/h
• Maximum: 80 km/h (Datenbankbeschränkung)
• Empfohlen: 5-20 km/h für die meisten Sicherheitszonen

Unterkonto-Geschwindigkeitseinstellungen

Jedes Unterkonto hat einen globalen Langsamzonen-Schwellenwert, der als Obergrenze für alle Geschwindigkeitszonen dient.

Zugriff auf die Einstellung

1. Gehen Sie zu Dashboard -> Einstellungen
2. Navigieren Sie zum Abschnitt Fahrzeuge
3. Finden Sie Langsamzonen-Geschwindigkeitsbegrenzung

Verhalten

Diese Einstellung definiert:

• Die maximale Geschwindigkeit, die jede Geschwindigkeitszone durchsetzen kann
• Die Standard-Geschwindigkeit, wenn eine Zone kein spezifisches Limit hat
• Eine globale Sicherheitsobergrenze für Ihre gesamte Flotte an diesem Standort

Empfehlungen

Fahrzeugmodell-Geschwindigkeitseinstellungen

Jedes Fahrzeugmodell kann eine konfigurierte Höchstgeschwindigkeit haben, die beim Wiederherstellen der Geschwindigkeit nach dem Verlassen von Zonen verwendet wird.

Konfiguration

Die Fahrzeugmodellgeschwindigkeit wird im Abschnitt Fahrzeugmodelle eingestellt:

1. Navigieren Sie zu Dashboard -> Fahrzeugmodelle
2. Wählen Sie ein Modell aus
3. Setzen Sie das Feld Höchstgeschwindigkeit (km/h)

Fallback-Verhalten

Wenn ein Fahrzeug kein zugewiesenes Modell hat oder das Modell keine Höchstgeschwindigkeit hat:

1. Prüfe das eigene max_speed_kmh-Feld des Fahrzeugs
2. Falle zurück auf den Systemstandard: 25 km/h

Warum das wichtig ist

Wenn ein Fahrzeug eine Geschwindigkeitszone verlässt, muss das System wissen, welche Geschwindigkeit wiederhergestellt werden soll. Der Wiederherstellungsbefehl verwendet:

Wiederhergestellte Geschwindigkeit = vehicle_model.max_speed_kmh ODER vehicle.max_speed_kmh ODER 25 km/h

Wie die Geschwindigkeitsdurchsetzung funktioniert

Durchsetzungsauslöser

Die Geschwindigkeitsdurchsetzung wird bei jeder GPS-Telemetrie-Aktualisierung ausgeführt, wenn:

1. Das Fahrzeug sich in einer aktiven Fahrt befindet (ride_status = 'in_progress')
2. Das Fahrzeug eine gültige IoT-IMEI hat
3. Gültige GPS-Koordinaten empfangen werden

Durchsetzungsschritte

1. Laden aller speed_limit-Zonen für das Unterkonto des Fahrzeugs
2. Prüfen, ob der Fahrzeugstandort in einem Zonenpolygon liegt
3. Wenn in Geschwindigkeitszone(n):
   • Effektives Limit berechnen (niedrigstes aus Zone + Schwelle)
   • Wenn Limit sich vom aktuellen unterscheidet, IoT-Geschwindigkeitsbefehl senden
   • Fahrzeugstatus aktualisieren
   • Zoneneintritts-Ereignis protokollieren
   • Kundenbenachrichtigung senden
4. Wenn war in Geschwindigkeitszone, aber nicht mehr:
   • Geschwindigkeitswiederherstellungsbefehl senden
   • Fahrzeugstatus löschen
   • Zonenaustritts-Ereignis protokollieren
   • Kundenbenachrichtigung senden

Befehlsdeduplizierung

Um unnötigen IoT-Verkehr zu vermeiden:

• Befehle werden nur gesendet, wenn sich das Limit tatsächlich ändert
• Der aktuelle Zonenstatus des Fahrzeugs wird in der Datenbank verfolgt
• Wiederholte Updates für dieselbe Zone/dasselbe Limit werden übersprungen

Fahrzeugverfolgungsfelder:

• current_speed_limit_zone_id - ID der aktiven Geschwindigkeitszone
• current_speed_limit_kph - Aktuell durchgesetztes Geschwindigkeitslimit
• speed_limit_enforced_at - Zeitstempel der letzten Durchsetzung

Latenz

Typische Durchsetzungslatenz:

• Telemetrie-Ankunft: 1-5 Sekunden (abhängig vom Geräte-Berichtsintervall)
• Zonenauswertung: < 100ms
• IoT-Befehlsversand: 200-500ms
• Fahrzeugantwort: 1-3 Sekunden (abhängig von Gerät/Netzwerk)

Gesamt: 3-10 Sekunden vom Zoneneintritt bis zur Geschwindigkeitsänderung

IoT-Protokollbefehle

Verschiedene IoT-Geräte erfordern unterschiedliche Befehlsformate. Levy Fleets erkennt automatisch das Protokoll und formatiert Befehle entsprechend.

Unterstützte Protokolle

Protokollerkennung

Das System bestimmt das Protokoll durch Abfrage des IoT-Gerätetyps. Das Protokoll wird aus den Feldern iot_type oder iot_model bestimmt (Groß-/Kleinschreibung wird ignoriert).

Geschwindigkeitswiederherstellung

Wenn ein Fahrzeug alle Geschwindigkeitszonen verlässt, stellt das System die normale Betriebsgeschwindigkeit wieder her.

Wiederherstellungsprozess

1. Zonenaustritt erkennen - Fahrzeug nicht mehr in einer Geschwindigkeitszone
2. Zielgeschwindigkeit berechnen aus Fahrzeugmodell oder Standard (25 km/h)
3. Wiederherstellungsbefehl senden - Gleiches Format wie Begrenzungsbefehl, mit höherem Wert
4. Fahrzeugstatus löschen - Zonenverfolgungsfelder entfernen
5. Austrittsereignis protokollieren
6. Benachrichtigung senden:

   Titel: "Langsamzone verlassen"
   Text: "Sie haben {zone_name} verlassen. Ihre Höchstgeschwindigkeit ist wiederhergestellt."
   

Wiederherstellungszeitpunkt

Geschwindigkeit wird wiederhergestellt:

• Sofort nach der ersten GPS-Messung außerhalb aller Geschwindigkeitszonen
• Keine Hystereseverzögerung (anders als bei Sperrzonen)
• Befehl wird unabhängig von der Zoneneintrittsdauer gesendet

Überlappende Geschwindigkeitszonen

Wenn ein Fahrzeug gleichzeitig in mehreren Geschwindigkeitszonen ist, gelten besondere Regeln.

Verhalten

1. Alle anwendbaren Zonen finden, die das Fahrzeug enthalten
2. Effektives Limit für jede Zone berechnen (Zonenlimit oder Schwelle, je nachdem was niedriger ist)
3. Das niedrigste Limit anwenden unter allen überlappenden Zonen

Beispiel

Fahrzeug fährt in einen Bereich mit:

• Zone A: 15 km/h Limit
• Zone B: 8 km/h Limit
• Unterkonto-Schwelle: 10 km/h

Auswertung:

• Zone A effektiv: min(15, 10) = 10 km/h
• Zone B effektiv: min(8, 10) = 8 km/h
• Angewendetes Limit: 8 km/h (niedrigstes)

Zonenverfolgung

Nur die "aktive" Zone (die mit dem niedrigsten Limit) wird im Fahrzeugstatus verfolgt.

Übergangsverhalten

Beim Wechsel zwischen überlappenden Zonen:

• Neuer Limit-Befehl wird nur gesendet, wenn sich das effektive Limit ändert
• Übergänge mit gleichem Limit werden dedupliziert (kein IoT-Verkehr)
• Austrittsereignis für vorherige Zone protokolliert, Eintrittsereignis für neue Zone

Best Practices

Zonengestaltung

1. Angemessen dimensionieren

   • Minimum: 20-30 Meter Durchmesser (GPS-Genauigkeitspuffer)
   • Maximum: Praktisch für den Bereich (Häuserblock, nicht stadtweit)

2. Einfache Polygone

   • Weniger Eckpunkte verwenden (5-8 typischerweise ausreichend)
   • Komplexe Formen mit vielen konkaven Abschnitten vermeiden
   • Einfachere Formen = schnellere Auswertung

3. Klare Grenzen

   • An physischen Merkmalen ausrichten (Straßen, Gebäude)
   • Satellitenansicht für Genauigkeit verwenden
   • 5-10m Puffer für GPS-Varianz hinzufügen

4. Strategische Platzierung

   • Auf fußgängerintensive Bereiche konzentrieren
   • Ganze Zonen abdecken, nicht nur Hotspots
   • Eintritts-/Austrittspunkte berücksichtigen

Geschwindigkeitsauswahl

1. Der Umgebung anpassen

   • Fußgängerzonen: 5-8 km/h
   • Gemischter Fußgänger-/Fahrzeugverkehr: 10-12 km/h
   • Leichter Verkehr: 12-15 km/h

2. Kundenerlebnis berücksichtigen

   • Zu langsam = frustrierte Kunden
   • Zu schnell = Sicherheitsbedenken
   • Limits unter realen Bedingungen testen

3. Regulatorische Compliance

   • Örtliche Vorschriften für E-Scooter-Geschwindigkeiten prüfen
   • Viele Städte schreiben spezifische Limits in bestimmten Zonen vor
   • Zonenzwecke für Audits dokumentieren

Namenskonventionen

Beschreibende Namen verwenden, die enthalten:

• Standortkennung
• Zweck/Typ
• Geschwindigkeitsbegrenzung (optional)

Beispiele:

• "Innenstadtkern - 10 kmh"
• "Grundschule Am Markt Schulzone"
• "Stadtpark Gemeinsamer Weg"
• "Rathaus-Platz Fußgängerzone"

Testen

Bevor Sie kritische Zonen bereitstellen:

1. Zone mit Testfahrzeug erstellen
2. Mehrmals durch Zonengrenze fahren
3. Geschwindigkeitsreduzierung am Fahrzeug überprüfen
4. Zonenereignisse im Fahrtenverlauf prüfen
5. Austritt und Geschwindigkeitswiederherstellung testen
6. Bestätigen, dass Kundenbenachrichtigungen funktionieren

Überwachung und Debugging

Dashboard-Sichtbarkeit

Fahrtdetailansicht:

• Navigieren Sie zu Dashboard -> Fahrten -> [Fahrt auswählen]
• Klicken Sie auf den Tab "Zonen"
• Zoneneintritts-/-austrittsereignisse anzeigen mit:
  • Zonenname und -typ
  • Eintritts-/Austrittszeiten
  • Angewendete Geschwindigkeitsbegrenzungen
  • IoT-Befehlserfolg/-fehler

Aktive Geschwindigkeitseinschränkungen finden

Im Dashboard können Sie sehen, welche Fahrzeuge derzeit Geschwindigkeitseinschränkungen haben, indem Sie die Fahrzeugdetailseite prüfen.

Serverprotokolle

Aktivieren Sie detaillierte Zonenprotokollierung, indem Sie Serverprotokolle auf Einträge prüfen mit:

• Zonendurchsetzung gestartet/abgeschlossen
• Punkt-im-Polygon-Prüfungen
• IoT-Befehlsversand
• Erfolgs-/Fehlerstatus

Protokollpräfixe:

• [Zones] - Alle Zonendurchsetzungsprotokolle
• Geschwindigkeitszonen-Erkennungsindikatoren
• IoT-Befehlsversand
• Erfolgs-/Fehlermarkierungen

Fehlerbehebung

Geschwindigkeit wird nicht begrenzt

Symptome: Fahrzeug verlangsamt sich nicht in Geschwindigkeitszone

Prüfungen:

1. Zonenkonfiguration:

   • Ist der Zonentyp "speed_limit"?
   • Ist das Zonenpolygon korrekt gezeichnet?
   • Ist speed_limit_kph gesetzt?
   • Ist die Zone nicht gelöscht?

2. Fahrzeugeinrichtung:

   • Hat das Fahrzeug eine IoT-IMEI?
   • Ist das IoT-Gerät online?
   • Wird das Protokoll unterstützt (Segway, OKAI, etc.)?

3. Fahrtstatus:

   • Gibt es eine aktive Fahrt auf diesem Fahrzeug?
   • Ist der Fahrtstatus "in_progress"?

4. Umgebungsvariablen:

   • Ist die IoT-API-Konfiguration korrekt?
   • Ist die IoT-Proxy-URL korrekt?

5. Protokolle:

   • Serverprotokolle auf Zoneneinträge prüfen
   • Nach Befehlsversandfehlern suchen

Geschwindigkeit wird nicht wiederhergestellt

Symptome: Fahrzeug bleibt nach Verlassen der Zone auf niedriger Geschwindigkeit

Prüfungen:

1. GPS-Genauigkeit:

   • Ist das Fahrzeug wirklich außerhalb der Zone?
   • Letzte bekannte Koordinaten des Fahrzeugs prüfen
   • Mit Zonengrenze vergleichen

2. Datenbankstatus:

   • current_speed_limit_zone_id prüfen - sollte NULL sein
   • Wenn nicht NULL, denkt die Durchsetzung möglicherweise noch, dass das Fahrzeug in der Zone ist

3. IoT-Befehl:

   • Wurde der Wiederherstellungsbefehl gesendet?
   • War er erfolgreich?
   • Fahrtzonen-Ereignisse auf Austrittsereignis prüfen

4. Fahrzeug-Hardware:

   • Einige Geräte erfordern manuellen Neustart nach Befehl
   • Gerätedokumentation auf Besonderheiten prüfen

Falsche Geschwindigkeit angewendet

Symptome: Geschwindigkeitsbegrenzung ist anders als konfiguriert

Prüfungen:

1. Langsamgeschwindigkeitsschwelle:

   • Einstellungen -> Fahrzeuge -> Langsamzonen-Geschwindigkeitsbegrenzung prüfen
   • Diese begrenzt alle Zonenlimits

2. Überlappende Zonen:

   • Befindet sich das Fahrzeug in mehreren Geschwindigkeitszonen?
   • Das niedrigste Limit wird angewendet

3. Einheitenverwechslung:

   • Geschwindigkeiten sind in km/h, nicht mph
   • 10 km/h entspricht ungefähr 6 mph

Befehle werden nicht gesendet

Symptome: Zonenereignisse protokolliert, aber keine IoT-Befehle

Prüfungen:

1. Protokollerkennung:

   • IoT-Gerätetabelle auf die IMEI prüfen
   • Überprüfen, ob IoT-Typ erkannt wird

2. API-Konnektivität:

   • IoT-Proxy manuell testen
   • Auf Firewall-Probleme prüfen

3. IMEI-Gültigkeit:

   • 15-stelliges Format erforderlich
   • Muss mit Geräteregistrierung übereinstimmen

Häufig gestellte Fragen

Wie schnell tritt die Geschwindigkeitsbegrenzung in Kraft?

Typischerweise 3-10 Sekunden nach Betreten einer Zone, abhängig von:

• GPS-Berichtsintervall des Fahrzeugs (1-10 Sekunden)
• Netzwerklatenz
• IoT-Geräteantwortzeit

Kann ich verschiedene Geschwindigkeiten für verschiedene Tageszeiten festlegen?

Nicht direkt über die Zonenkonfiguration. Aktuelle Optionen:

• Mehrere Zonen erstellen und über API aktivieren/deaktivieren
• Die Langsamgeschwindigkeitsschwelle des Unterkontos anpassen (betrifft alle Zonen)
• Zukunft: Zeitbasierte Zonenregeln sind auf der Roadmap

Was passiert, wenn die IoT-Kommunikation fehlschlägt?

• Das Zonenereignis wird trotzdem mit iot_command_success = false protokolliert
• Der Fehler wird aufgezeichnet
• Das Fahrzeug fährt mit seiner aktuellen Geschwindigkeit weiter
• Die nächste Telemetrie-Aktualisierung versucht den Befehl erneut
• Erwägen Sie die Implementierung von Warnungen für fehlgeschlagene Befehle

Betreffen Geschwindigkeitszonen alle Fahrzeuge?

Nur Fahrzeuge:

• Mit einer aktiven Fahrt
• Die zum Unterkonto der Zone gehören
• Mit einem kompatiblen IoT-Gerät

Fahrzeuge ohne aktive Fahrten sind nicht betroffen.

Können Kunden Geschwindigkeitszonen in der App sehen?

Ja, Geschwindigkeitszonen sind auf der Kundenkarte sichtbar:

• Als gelb/goldfarben gefärbte Zonen angezeigt
• Zonenname wird beim Antippen angezeigt
• Geschwindigkeitsbegrenzung wird in Zoneninfo angezeigt

Was ist die empfohlene Mindestzonengröße?

• Minimum: ~30 Meter Durchmesser
• Grund: GPS-Genauigkeitsvarianz (5-15m)
• Sehr kleine Zonen können Flackern verursachen

Wie deaktiviere ich eine Geschwindigkeitszone vorübergehend?

Optionen:

1. Zone löschen - Vollständig entfernen (Soft-Delete)
2. Zonentyp ändern - Vorübergehend zu "Parken" oder anderem Typ wechseln
3. Über Datenbank - deleted_at auf aktuellen Zeitstempel setzen

Werden Geschwindigkeitsbegrenzungen für Testfahrten durchgesetzt?

Ja, alle Fahrten mit Status "in_progress" unterliegen der Zonendurchsetzung, einschließlich von Mitarbeitern gestarteter Testfahrten.

Was kommt als Nächstes?

• Zonen erstellen und verwalten - Vollständige Zonenverwaltungsanleitung
• Wie Zonen funktionieren - Technische Vertiefung in die Zonendurchsetzung
• Fahrzeugtelemetrie - Fahrzeugdaten verstehen