MotorSignal-App/server/waze_relay

🚔 MotorSignal Waze Alert Relay Server

A high-performance, lightweight headless relay backend that queries Waze Live Map feeds and provides normalized Police Speed Traps, Speed Cameras, Red-Light Cameras, and Road Hazard Alerts directly to the MotorSignal Motorcycle Cockpit application.

---

🚀 Quick Start

Method 1: Run with Node.js (Local or VPS)

ash cd server/waze_relay npm install npm start The server will start on http://0.0.0.0:3000.

Method 2: Run with Docker / Docker Compose

ash cd server/waze_relay docker compose up -d

---

📱 Connecting to MotorSignal

1. Open MotorSignal on your phone.
2. Go to Settings → Community Traffic Provider.
3. Under Custom Endpoint URL, enter your relay server URL: http://<YOUR_SERVER_IP>:3000/alerts (e.g., http://192.168.1.69:3000/alerts for local Wi-Fi, or https://your-domain.com/alerts for remote VPS).
4. Tap TEST CONNECTION. You will see the green CONNECTED badge!

---

📡 REST API Endpoints

1. Health Check

• GET /health or GET /
• Response: json { "status": "ok", "service": "MotorSignal Waze Community Relay", "version": "1.0.0" }

2. Live Alerts Feed

• GET /alerts?lat=37.7749&lng=-122.4194&radius=5000
• Query Parameters:
  • lat: Latitude of vehicle
  • lng: Longitude of vehicle

adius: Search radius in meters (Default: 5000m)

• Response: json { "provider": "waze_relay", "count": 2, "alerts": [ { "id": "wz_37.77490_-122.41940", "type": "POLICE", "category": "police", "latitude": 37.7749, "longitude": -122.4194, "roadName": "Market St", "description": "Hidden police speed trap reported on Market St", "severity": "high", "confidence": 0.9 } ] }

---

⚡ Features

• Police Trap Detection: Parses POLICE_HIDDEN and POLICE_VISIBLE radar traps.
• Camera Enforcement: Speed cameras and red-light enforcement cameras.
• In-Memory Geo-Grid Caching: 30-second TTL prevents rate limiting and ensures sub-10ms response times for the motorcycle HUD.