Gehwegerkennung

Die Gehwegerkennung ist die Fahrzeug-Schicht von Levy Vision. Sie nutzt Computer-Vision-Hardware eines Drittanbieters (Drover AI oder Luna Systems), die an Ihren Scootern und Bikes installiert ist. Wenn das fahrzeuginterne Modell entscheidet, dass der Fahrer auf einem Gehweg ist, sendet der Anbieter uns ein Ereignis, und unsere Policy-Engine entscheidet, was zu tun ist — warnen, drosseln oder Antrieb abschalten.

Dieser Artikel erklärt die Pipeline von Ende zu Ende. Für die eigentliche Throttle-Cut-Leiter siehe Throttle-Cut-Policy. Für die Vendor-Onboarding-Schritte siehe Vendor-Setup — Drover & Luna.

Was Sie brauchen

• Vendor-Hardware installiert an den Fahrzeugen, die abgedeckt werden sollen. Wir integrieren heute mit Drover AI PathPilot und Luna Systems. Captur.ai wird nur für Parkpose unterstützt, nicht für Gehwegerkennung.
• Geräte provisioniert unter Safety > Vendor devices, wobei jede Geräteseriennummer einem Levy-Fahrzeug-UUID zugeordnet ist.
• Ein signiertes Webhook-Secret, das gegen Ihr Unterkonto gespeichert ist, damit wir eingehende Ereignisse verifizieren können.
• Der Schalter Sidewalk detection ist in Safety > Safety settings aktiviert.

Wenn etwas davon fehlt, fließen keine Gehweg-Ereignisse ins Dashboard.

Wie die Ereignis-Pipeline funktioniert

Fahrzeug-Cam → Vendor-Modell → Vendor-Webhook
   → POST /api/webhooks/drover/events (oder /luna/events)
   → HMAC-Signatur verifiziert
   → Payload in eine cv_events-Zeile normalisiert
   → Policy-Engine (sidewalk-policy.ts) entscheidet Aktion
   → Throttle-Controller versendet an den IoT-Befehlspfad
   → Fahrer sieht Warnung / Drosselung / Cut auf dem Telefon

Die Latenz von der Erkennung am Fahrzeug bis zur Benachrichtigung des Fahrers liegt typischerweise bei 2–4 Sekunden, abhängig von den Mobilfunkbedingungen am Vendor-Modul. Die Dashboard-Ereigniszeile erscheint im selben Fenster.

Erkennung konfigurieren

Öffnen Sie Dashboard > Safety > Safety settings. Der Abschnitt Sidewalk detection hat folgende Steuerelemente.

Sidewalk detection enabled

Hauptschalter. Aus bedeutet, Vendor-Ereignisse erreichen unsere Webhooks weiterhin (wir verwerfen sie nicht — sie werden protokolliert), aber keine Policy-Aktionen laufen und der Fahrer sieht nichts.

Vendor

Wählen Sie Drover oder Luna. Sie können Anbieter über Unterkonten mischen, aber nicht innerhalb desselben Unterkontos — die Vendor-Zuordnung erfolgt pro Unterkonto.

Schwellen-Leiter

Die drei Schwellenwerte steuern, wann jeder Durchsetzungsschritt einsetzt. Jeder ist eine Anzahl an Gehweg-Ereignissen innerhalb der aktuellen Fahrt.

Wir empfehlen dringend, Throttle Cut im ersten Monat deaktiviert zu lassen. Beobachten Sie Ereignisse, die ins Dashboard fließen, tunen Sie die Geofence-Allow-Liste (unten) und aktivieren Sie Cut erst, wenn False-Positives unter 2 % liegen.

Geofence-Allow-Liste

Manche gehweg-förmigen Flächen sollten keine Durchsetzung auslösen — geschützte Radwege, die dem Modell wie Gehwege erscheinen, Strandwege, die Ihre Stadt explizit erlaubt hat, Platz-Abkürzungen, die der Betreiber unterschrieben hat.

So fügen Sie ein Allow-List-Polygon hinzu:

1. Öffnen Sie Safety > Sidewalk hotspots (Kartenansicht).
2. Rechtsklick auf der Karte zum Zeichnen eines Polygons oder fügen Sie ein GeoJSON-Polygon im Import-Dialog ein.
3. Markieren Sie das Polygon als kind=allow und speichern Sie.

Jedes Gehweg-Ereignis, dessen Ort innerhalb eines Allow-List-Polygons liegt, wird protokolliert, löst aber keine Policy-Aktion aus. Die Ereigniszeile zeigt den Polygonnamen in der Side-Effects-Spalte.

Gehweg-Ereignisse lesen

Gehen Sie zu Safety > Events und filtern Sie nach Ereignistyp sidewalk_entry (das Hauptereignis) oder sidewalk_exit (Begleitereignis, wenn der Fahrer auf die Straße zurückkehrt).

Jede Zeile zeigt:

• Fahrer, Fahrt, Fahrzeug
• Vendor-Quelle (drover oder luna)
• Konfidenz (gesetzt vom Vendor-Modell)
• Lat/Lng mit "View on map"-Link
• Side-Effects-Spalte — welche Policy-Schritte gefeuert wurden (warn, speed_reduce, throttle_cut)

Für die geografische Ansicht öffnen Sie Safety > Sidewalk hotspots. Ereignisse clustern auf einer Heatmap, damit Sie Muster erkennen — die meisten Flotten finden eine oder zwei wiederholungsanfällige Kreuzungen, die den Großteil der Ereignisse ausmachen. Fügen Sie ein Allow-List-Polygon hinzu, falls es eine bekannte False-Positive-Zone ist, oder teilen Sie die Heatmap mit Ihrem Stadt-Kontakt als Nachweis, wo Sie durchsetzen.

Vendor-Zuverlässigkeit und Fehlerfälle

Der Vendor-Webhook ist das schwächste Glied dieser Pipeline. Wir überwachen ihn für Sie, aber so reagieren wir, wenn etwas schief geht:

• Keine Ereignisse für mehr als 5 Minuten während der Hauptzeiten — Sentry-Alarm wird ausgelöst, Durchsetzung wird für die betroffene Flotte automatisch deaktiviert, bis Ereignisse wieder fließen
• Verspätetes Ereignis (>30s Verzögerung) — Ereignis wird trotzdem protokolliert, aber keine Echtzeit-Durchsetzung; der Fahrer erhält stattdessen einen nachträglichen Warnpush
• Replay-Angriff — Webhook-Signatur-Verifizierung lehnt doppelte Payloads anhand der Vendor-Event-ID und unseres cv_events.external_event_id-Index ab
• Vendor-Signatur-Mismatch — Webhook gibt 401 zurück, Ereignis wird nicht protokolliert; prüfen Sie das Signing-Secret unter Safety > Vendor devices

Wenn Sie jemals den Verdacht haben, dass die Pipeline stillschweigend unterbrochen ist (z. B. Sie wissen, dass ein Fahrer auf dem Gehweg war, aber kein Ereignis erschien), prüfen Sie den Artikel Fehlerbehebung — der Diagnose-Baum "Keine Gehweg-Ereignisse" ist dort.

OEM-Kompatibilität

Throttle-Cut hängt davon ab, was Ihr IoT-Protokoll unterstützt. Nicht jeder OEM akzeptiert eine Geschwindigkeitsbegrenzung während der Fahrt, daher fällt die Policy-Engine elegant durch:

Wenn der IoT-Typ eines Fahrzeugs den konfigurierten Schritt nicht unterstützt, protokolliert die Policy-Engine eine skipped-Aktion und fährt mit dem nächsten Schritt fort. Sie müssen das nicht pro OEM konfigurieren — es ist automatisch.

Was der Fahrer sieht

Beim ersten Ereignis einer Fahrt zeigt die App des Fahrers das Sidewalk warning modal — ein Vollbild-Overlay mit einer kleinen Karte, die seine letzte bekannte Position vs. die erkannte Gehweg-Geometrie zeigt, plus einem "Move to the road"-CTA.

Bei Geschwindigkeitsreduktion aktualisiert sich das Modal auf "Speed reduced — return to the road". Bei Throttle-Cut sieht er den Throttle restore screen mit 30-Sekunden-Countdown und "I'm back on the road"-Button. Siehe Throttle-Cut-Policy für den Wiederherstellungs-Flow.

Auf GA gehen

Wir empfehlen diesen Rollout-Pfad für Ihren Gehweg-Pilot:

1. Woche 1–2 — Geräte installiert, Erkennung aktiviert, kein Throttle-Cut. Beobachten Sie den Events-Feed.
2. Woche 3 — fügen Sie Geofence-Allow-List-Polygone für offensichtliche False-Positive-Hotspots hinzu.
3. Woche 4 — Throttle-Cut aktivieren. Beobachten Sie Fahrerbeschwerden (unter 2 pro 1k Fahrten ist das Ziel).
4. Laufend — prüfen Sie die Karte Safety > Sidewalk hotspots wöchentlich und teilen Sie sie mit Ihrem Stadt-Kontakt.