Get Real-Time Mileage

{
  "success": true,
  "data": {
    "trip_id": "trip-abc-123",
    "status": "recording",
    "total_miles": 15.327,
    "total_km": 24.664,
    "total_meters": 24664.0,
    "data_points": 180,
    "avg_speed_kmh": 48.5,
    "max_speed_kmh": 82.3,
    "first_point_at": "2026-04-29T12:00:00Z",
    "last_point_at": "2026-04-29T12:15:00Z",
    "data_source": "duckdb_parquet"
  }
}

{
  "success": false,
  "error": "Trip not found"
}

{
  "success": false,
  "error": "Trip is not active (status: completed)"
}

For each consecutive pair of GPS points:
  distance = haversine(lat1, lng1, lat2, lng2)
  
Total Distance = SUM(all distances between consecutive points)

// Update live mileage every 10 seconds
setInterval(async () => {
  const mileage = await client.trips.getMileage('trip-abc-123');
  updateDashboard({
    distance: mileage.data.total_miles,
    avgSpeed: mileage.data.avg_speed_kmh,
    dataPoints: mileage.data.data_points
  });
}, 10000);

// Show live mileage to driver
Timer.periodic(Duration(seconds: 15), (timer) async {
  final mileage = await sdk.getCurrentTripMileage();
  
  setState(() {
    currentMiles = mileage['data']['total_miles'];
    currentSpeed = mileage['data']['avg_speed_kmh'];
  });
});

# Check if driver has reached expected mileage
async def check_delivery_progress(trip_id, expected_miles):
    mileage = await client.trips.get_mileage(trip_id)
    
    if mileage['data']['total_miles'] >= expected_miles:
        await notify_customer("Driver is approaching delivery location")

// Good: Poll every 10-30 seconds
const pollMileage = setInterval(async () => {
  const mileage = await client.trips.getMileage(tripId);
  updateUI(mileage);
}, 15000); // 15 seconds

// Bad: Poll too frequently
// Don't poll faster than every 5 seconds

import asyncio

async def get_mileage_with_retry(trip_id, max_retries=3):
    for attempt in range(max_retries):
        try:
            return await client.trips.get_mileage(trip_id)
        except Exception as e:
            if attempt < max_retries - 1:
                await asyncio.sleep(2 ** attempt)  # Exponential backoff
            else:
                raise

// Cache mileage results for smooth UI
let cachedMileage = null;
let lastFetch = 0;

async function getMileageWithCache(tripId) {
  const now = Date.now();
  
  // Return cached value if less than 10 seconds old
  if (cachedMileage && (now - lastFetch) < 10000) {
    return cachedMileage;
  }
  
  cachedMileage = await client.trips.getMileage(tripId);
  lastFetch = now;
  return cachedMileage;
}