Update: 2026-06-30 22:43:38

backend/api/location/sync_location.php

@@ -0,0 +1,42 @@
+<?php
+/**
+ * sync_location.php
+ * Unified endpoint for receiving passenger location updates from:
+ * - App Usage (Primary)
+ * - Geofencing Events (Secondary)
+ * - Silent Push Wakeups (Tertiary)
+ */
+
+require_once __DIR__ . '/../../connect.php';
+// require_once __DIR__ . '/../../functions.php';
+require_once __DIR__ . '/../../core/Services/LocationIntelligenceEngine.php';
+
+// Validate JWT or traditional auth if needed. For now, rely on standard filterRequest if used.
+$passengerId = filterRequest('passenger_id');
+$lat = filterRequest('lat', 'float');
+$lng = filterRequest('lng', 'float');
+$source = filterRequest('source') ?? 'app_usage'; // 'app_usage', 'geofence', 'silent_push'
+$batteryLevel = filterRequest('battery_level', 'int');
+
+if (!$passengerId || !$lat || !$lng) {
+    http_response_code(400);
+    echo json_encode(['status' => 'failure', 'message' => 'Missing required parameters (passenger_id, lat, lng).']);
+    exit;
+}
+
+try {
+    $engine = new LocationIntelligenceEngine($con);
+    $newGeofences = $engine->processLocationUpdate($passengerId, $lat, $lng, $source, $batteryLevel);
+    
+    // Respond with success and optionally new geofences
+    echo json_encode([
+        'status' => 'success',
+        'message' => 'Location synced successfully',
+        'update_geofences' => $newGeofences // App can use this array to update device geofencing regions
+    ]);
+} catch (Exception $e) {
+    error_log("[sync_location.php] Error: " . $e->getMessage());
+    http_response_code(500);
+    echo json_encode(['status' => 'failure', 'message' => 'Internal server error.']);
+}
+?>