// Mobile app sends location every 30 seconds (foreground only)
// POST /api/AgentOwnJobs/update-location
{
  "latitude": 51.5074,
  "longitude": -0.1278,
  "deviceId": "iPhone-123",
  "platform": "iOS"
}

// API Response includes real-time ETA from OSRM
{
  "message": "Location updated successfully",
  "timestamp": "2024-12-12T15:36:00Z",
  "currentJob": {
    "subJobId": 12345,
    "jobReference": "TASK-12345",
    "customerName": "John Smith",
    "address": "42 Example Road",
    "postcode": "SW1A 1AA",
    "scheduledTime": "2024-12-12T16:00:00Z",
    
    // Real-time ETA from OSRM server (xoeraapis.com:5001)
    "eta": "3:48 PM",
    "etaDateTime": "2024-12-12T15:48:00Z",
    "minutesRemaining": 12.0,
    "distanceRemaining": "2.1 miles",
    "durationDisplay": "12 mins",
    
    // Status indicators
    "isLate": false,
    "journeyStartTime": "2024-12-12T15:30:00Z",
    "minutesTraveling": 6.0
  }
}
            

// Swift - Display ETA from API response
func handleLocationUpdateResponse(_ response: LocationUpdateResponse) {
    guard let job = response.currentJob else { return }
    
    // Update ETA display based on remaining time
    switch job.minutesRemaining {
    case ...0:
        etaLabel.text = "Arriving now"
        etaLabel.textColor = .systemGreen
        progressBar.progress = 1.0
        
    case 0..<1:
        etaLabel.text = "< 1 min"
        etaLabel.textColor = .systemOrange
        
    case 1..<5:
        etaLabel.text = "Arriving in \(Int(job.minutesRemaining)) mins"
        etaLabel.textColor = .systemOrange
        
    default:
        etaLabel.text = "ETA: \(job.eta)"
        etaLabel.textColor = job.isLate ? .systemRed : .label
    }
    
    // Update distance
    distanceLabel.text = job.distanceRemaining
    
    // Update status if late
    if job.isLate {
        statusBanner.backgroundColor = .systemRed
        statusLabel.text = "Running Late"
        // Notify user
        sendLocalNotification("You're running late for \(job.customerName)")
    }
}

// Kotlin - Location updates timer
class LocationUpdateService {
    private val updateInterval = 30_000L // 30 seconds
    
    fun startLocationUpdates() {
        locationTimer = Timer().scheduleAtFixedRate(0, updateInterval) {
            if (hasLocationPermission() && isAppInForeground()) {
                val location = getCurrentLocation()
                sendLocationUpdate(location)
            }
        }
    }
}
            

// C# - DrivingDistanceService using OSRM
public async Task<DrivingRouteResult> CalculateDrivingRoute(
    decimal fromLat, decimal fromLng, 
    decimal toLat, decimal toLng)
{
    // OSRM API call (coordinates in lng,lat order)
    var url = $"http://xoeraapis.com:5001/route/v1/driving/" +
              $"{fromLng},{fromLat};{toLng},{toLat}" +
              $"?overview=false&geometries=geojson";
    
    var response = await _httpClient.GetAsync(url);
    var result = JsonConvert.DeserializeObject<OsrmResponse>(response);
    
    return new DrivingRouteResult {
        DistanceMeters = route.Distance,
        DurationSeconds = route.Duration,  // Real-time with traffic
        DistanceDisplay = FormatDistance(route.Distance * 0.000621371),
        DurationDisplay = FormatDuration(route.Duration)
    };
}
            

// Important Points:

1. NO BACKGROUND TRACKING
   - Location only sent when app is in foreground
   - Uses "When In Use" permission only
   - Battery friendly approach

2. ETA ALWAYS POSITIVE
   - Backend calculates: DateTime.UtcNow + route.DurationSeconds
   - Never shows negative ETA
   - When arrived: shows "Arriving now" instead of past time

3. REAL-TIME TRAFFIC
   - OSRM considers current traffic conditions
   - ETA updates every 30 seconds with fresh calculation
   - More accurate than static estimates

4. STATUS TRANSITIONS
   - minutesRemaining <= 0: "Arriving now" (green)
   - minutesRemaining < 1: "< 1 min" (orange)
   - minutesRemaining < 5: "Arriving in X mins" (orange)  
   - isLate == true: Show red status, notify user

5. ERROR HANDLING
   - If OSRM fails: Show last known ETA
   - If no location permission: Prompt user
   - If no network: Cache last response
            

Mobile App                      Backend                         OSRM Server
----------                      -------                         -----------
[Get Location] ──────────────► [Update Agent Location]
                                       │
                                       ├─► Save to DB
                                       │
                                       ├─► Find En Route Job
                                       │
                                       └─► [Calculate Route] ────► [Route API]
                                                                        │
[Display ETA] ◄──────────────  [Return ETA Response] ◄────────────────┘

// Response includes:
- eta: "3:48 PM"
- minutesRemaining: 12
- distanceRemaining: "2.1 miles" 
- isLate: false