Throttle-Cut-Policy
Wenn die Gehwegerkennung feuert, nutzt Levy Vision eine konfigurierbare Policy-Leiter, um zu entscheiden, welche Durchsetzung angewendet wird: Fahrer warnen, Höchstgeschwindigkeit reduzieren oder Antrieb vollständig abschalten. Dieser Artikel erklärt, wie die Leiter funktioniert, wie die Wiederherstellung abgesichert ist und wie Sie sie für Ihre Flotte tunen.
Die Leiter läuft gegen denselben disableVehicleThrottle()- und enableVehicleThrottle()-IoT-Befehlspfad, den Sie an anderer Stelle der Plattform bereits verwenden — es gibt keine neue Throttle-Steueroberfläche, nur einen neuen Aufrufer.
Die Standard-Leiter
Ab Werk läuft die Policy diese Schritte in dieser Reihenfolge innerhalb einer einzelnen Fahrt:
| Ereigniszahl | Aktion | Was der Fahrer sieht |
|---|---|---|
| 1. Gehweg-Ereignis | warn_push | Sidewalk Warning Modal + "Move to the road"-Push |
| 2. Gehweg-Ereignis | speed_reduce | Höchstgeschwindigkeit auf 50 % gedrosselt, Modal aktualisiert |
| 3. Gehweg-Ereignis | throttle_cut | Antrieb deaktiviert, Restore-Screen mit Countdown |
Jeder Schritt ist durch einen Pro-Unterkonto-Schwellenwert unter Safety > Safety settings gesteuert. Senken Sie die Schwellen für strengere Flotten, erhöhen Sie sie für solche mit lockeren Städten oder bekannten False-Positive-Geografien.
Wann die Leiter einen Schritt überspringt
Nicht jedes IoT-Protokoll unterstützt jeden Schritt. Die Policy-Engine liest das Protokoll des Fahrzeugs aus der Datenbank und überspringt nicht unterstützte Schritte:
- Keine Speed-Cap-Unterstützung (Queclink, Zimo, Acton Legacy) — Speed-Reduce-Schritt wird übersprungen, der Fahrer geht beim nächsten Gehweg-Ereignis direkt von Warn zu Cut
- Keine Throttle-Cut-Unterstützung — nur Warn feuert, keine Durchsetzung
- Fahrzeug nicht erreichbar (IoT offline) — die Policy protokolliert eine
queued-Aktion, die für bis zu 60 Sekunden erneut versucht, wenn das Fahrzeug zurückmeldet; danach wird die Aktion als fehlgeschlagen protokolliert
Jeder Schritt, der feuert, schreibt eine Zeile in cv_violation_actions, sodass Sie ein Audit-Log haben, was versucht wurde und ob es geklappt hat.
Die Leiter konfigurieren
Öffnen Sie Dashboard > Safety > Safety settings und finden Sie den Abschnitt Sidewalk detection.
Schwellenwert-Steuerungen
| Einstellung | Standard | Was sie steuert |
|---|---|---|
| Warn threshold | 1 | Gehweg-Ereignisse, bevor der Warn-Push feuert |
| Speed-reduce threshold | 2 | Gehweg-Ereignisse, bevor Mid-Ride-Speed-Cap |
| Cut threshold | 3 | Gehweg-Ereignisse, bevor Throttle-Deaktivierung |
| Throttle cut enabled | aus | Hauptschalter — falls aus, wird der Cut-Schritt komplett unterdrückt |
| Fee per event | 0 | Optionale Gebühr in Cent am Fahrtende pro Gehweg-Ereignis |
Sie können Schwellen auch auf 0 setzen, um einen bestimmten Schritt zu deaktivieren, ohne die Leiter neu zu ordnen — nützlich, wenn Sie nur Speed-Reduce ohne Cut wollen.
Pro Fahrt vs. kumulativ
Schwellenwerte gelten pro Fahrt. Sie setzen sich beim Start jeder neuen Fahrt auf Null zurück, auch bei wiederholten Sündern. Wenn Sie einen Mehr-Fahrten-Akkumulator wollen (z. B. "5 Ereignisse in einem Monat lösen eine manuelle Prüfung aus"), das ist eine separate Nutzung des Safety > Events-Feeds plus Ihr CRM oder Operator-Dashboard — es gibt heute keinen eingebauten kumulativen Banpfad.
Wie die Throttle-Wiederherstellung funktioniert
Wenn ein Fahrer abgeschaltet wird, sieht er den Throttle restore screen:
- Ein 30-Sekunden-Countdown
- Eine kleine Karte mit seiner Position
- "I'm back on the road"-Button (deaktiviert, bis Countdown abläuft)
Der Flow:
- Countdown läuft ab. Der Button wird aktiv.
- Fahrer tippt I'm back on the road.
- Die App postet an
/api/mobile/cv/restore-throttle-requestmit der Ride-ID. - Der Server prüft 30 Sekunden saubere Telemetrie (keine Gehweg-Ereignisse im Fenster).
- Falls sauber:
enableVehicleThrottle()wird aufgerufen, Antrieb kehrt zurück, Modal schließt. - Falls nicht sauber: Der Fahrer sieht "Still on a sidewalk — try again in 30s" und der Countdown startet neu.
Diese Absicherung existiert, um zu verhindern, dass ein Fahrer nach einem Cut sofort wieder auf den Gehweg fährt.
Operator-Manuelle-Wiederherstellung
Manchmal müssen Sie übersteuern — der Cut war ein False-Positive, der Fahrer steckt fest, das Vendor-Modell hat sich vertan. Zwei Wege:
Vom Dashboard
- Öffnen Sie Safety > Events oder Safety > Helmet compliance (Events-Feed).
- Finden Sie die Throttle-Cut-Ereigniszeile.
- Klicken Sie im Aktionsmenü auf Restore throttle.
- Der IoT-Befehl feuert; der Antrieb des Fahrers kehrt innerhalb weniger Sekunden zurück.
Die Überschreibung wird in cv_violation_actions mit action='throttle_restore' und Ihrem Benutzer als Akteur protokolliert.
Aus der Operator-App
Die Field-Tech-Operator-App hat einen Safety events-Screen mit einem Ein-Tap-Restore throttle-Button in jeder Cut-Zeile. Gleiche Wirkung wie der Dashboard-Pfad; nützlich für Techs vor Ort.
Markieren Sie den False-Positive auch
Wenn Sie manuell wiederherstellen, klicken Sie auch auf Flag false positive im zugrunde liegenden Gehweg-Ereignis. Das speist das gelabelte Bild (falls der Vendor eines gesendet hat) zurück in die Modellverbesserungs-Pipeline des Vendors.
End-of-Ride-Gebühr
Wenn Sie Fee per event auf einen Wert ungleich Null setzen, fügt jedes Gehweg-Ereignis während der Fahrt diesen Betrag zum Endfahrpreis hinzu. Wie bei Parkpose läuft die Gebühr über den Fahrtdatensatz (nicht direkt ins Wallet), sodass Net-Deposited- und Partner-Payout-Mathematik korrekt bleibt.
Falls ein Fahrer eine Gehweg-Gebühr anficht, bearbeiten Sie das wie jeden anderen Fahrpreisstreit: öffnen Sie die Fahrt, klicken Sie auf Adjust fare und reduzieren Sie das Gesamt. Die Wallet-Gutschrift (falls vorhanden) fließt automatisch.
Datenschutzhinweise
Das Vendor-Modell läuft vollständig auf dem Fahrzeug. Levy Vision erhält nur normalisierte Ereignisse (Zeitstempel, Lat/Lng, Konfidenz, Vendor-Event-ID) — niemals Video, niemals Rohbilder. Es gibt auf dieser Plattform kein Live-Operator-Streaming von Videos.
City-Compliance-Feeds aggregieren Ereignis-Lat/Lng und Zeitstempel; Fahreridentität wird gestripped, bevor der MDS-Export das System verlässt. Siehe MDS-Export für Städte für das Export-Schema.
Häufige Fragen
Kann ich die Durchsetzung auf einem bestimmten Fahrzeug deaktivieren?
Nicht über einen Pro-Fahrzeug-Schalter. Der empfohlene Weg ist ein Geofence-Allow-List-Polygon über das Territorium des Fahrzeugs oder ein flottenweiter Schwellenwert von 0 für den Cut-Schritt. Wenn Sie einen Einzelfahrzeug-Fall haben, kontaktieren Sie den Support.
Was, wenn der Cut fehlschlägt, weil das IoT offline ist?
Die Aktion wird als queued protokolliert und für 60 Sekunden erneut versucht. Danach wird sie als fehlgeschlagen protokolliert. Der Fahrer darf weiterfahren — das Fehlschlagen ist ein bekannter Modus, für den der Fahrer nicht bestraft wird. Das nächste Ereignis löst die Leiter erneut aus.
Wie weiß ich, ob die Leiter tatsächlich in der Produktion feuert?
Prüfen Sie Safety > Events auf sidewalk_entry-Ereignisse mit nicht leeren Side-Effects-Spalten. Jede gefeuerte Aktion schreibt eine cv_violation_actions-Zeile, sichtbar im Ereignis-Drawer.