Skip to main content

​
Overview

Viax provides real-time GPS tracking for all trips, allowing you to monitor your journey from pickup to destination. This guide covers trip tracking features, safety options, and how to use the live map interface.

​
Real-Time Tracking Features

Live Map

View your current location and route on an interactive map

Driver Location

See your driver’s real-time position and movement

ETA Updates

Get accurate arrival time estimates updated continuously

Route Preview

View the planned route and any deviations

​
Trip Status Flow

Your trip progresses through several states, each providing different tracking information:
1

Searching for Driver

Status: pendiente
  • App searches for nearby available drivers
  • You see estimated wait time
  • Can cancel with no fee
2

Driver Assigned

Status: aceptado
  • Driver has accepted your request
  • See driver details (name, photo, rating, vehicle)
  • Track driver approaching your pickup location
  • View updated ETA
// Trip status update
{
  "trip_id": "12345",
  "status": "aceptado",
  "driver": {
    "id": 67,
    "name": "Carlos Rodríguez",
    "rating": 4.8,
    "vehicle_type": "carro",
    "plate_number": "ABC123"
  },
  "driver_location": {
    "lat": 4.7110,
    "lng": -74.0721
  },
  "eta_minutes": 5
}
3

Driver En Route

Status: en_ruta
  • Driver is on the way to pick you up
  • Live tracking of driver position
  • Distance and time to pickup
  • Can call or message driver
4

Trip In Progress

Status: en_curso
  • You’re in the vehicle heading to destination
  • Route displayed on map
  • Live location updates
  • Share location with contacts
  • Estimated time to destination
5

Trip Completed

Status: completado
  • Arrived at destination
  • Final fare displayed
  • Rate your driver
  • View trip summary and receipt

​
Live Map Interface

The trip tracking screen shows:
Interactive Map Elements
  • 🔵 Your location (blue marker)
  • 🚗 Driver location (car icon)
  • 📍 Pickup point (green marker)
  • 🏁 Destination (red marker)
  • 🛣️ Planned route (blue line)
  • 🚦 Traffic conditions (color-coded)
The map auto-centers and follows the driver’s movement in real-time.

​
Location Updates

The app updates your location and the driver’s location continuously: 
// Location update frequency
const locationUpdateInterval = Duration(seconds: 5);

// Geolocator settings for high accuracy
final locationSettings = LocationSettings(
  accuracy: LocationAccuracy.high,
  distanceFilter: 10, // Update every 10 meters
);

// Listen to location stream
positionStream = Geolocator.getPositionStream(
  locationSettings: locationSettings,
).listen((Position position) {
  // Update user location on map
  updateUserMarker(position);
  
  // Send location to backend for trip tracking
  if (tripStatus == TripStatus.inProgress) {
    sendLocationUpdate(position);
  }
});
During the trip, the app uses Mapbox for intelligent routing:
The route may change dynamically based on traffic conditions. Drivers can see traffic-aware navigation to optimize your trip time.
Routing Features:
  • Turn-by-turn navigation for drivers
  • Traffic-aware route calculation
  • Automatic rerouting if driver deviates
  • Multiple route options
  • Estimated time adjustments

​
Safety Features

​
Location Sharing

Share your trip in real-time with trusted contacts: 
// Create shareable trip link
final shareToken = await locationSharingService.createShareToken(
  tripId: currentTrip.id,
  expiresIn: Duration(hours: 2),
);

final shareUrl = 'https://viaxcol.online/share/$shareToken';

// Share via SMS, WhatsApp, or other apps
Share.share(
  'Following my Viax trip: $shareUrl',
  subject: 'Viax Trip Tracking',
);
See Location Sharing for detailed information.

​
Emergency Features

SOS Button

Quick access to emergency contacts and services

Trip Recording

All trips are logged with GPS coordinates and timestamps

Driver Verification

Verified driver information shown before and during trip

Support Access

In-app support available during active trips

​
Trip Information Panel

During the trip, access detailed information:
  • Trip ID
  • Start time
  • Pickup address
  • Destination address
  • Vehicle type
  • Current status
  • Distance traveled
  • Time elapsed
  • Full name
  • Profile photo
  • Rating (out of 5 stars)
  • Number of completed trips
  • Vehicle make and model
  • License plate number
  • Contact options
  • Total distance
  • Estimated duration
  • Current speed
  • Traffic conditions
  • Alternative routes
  • Time remaining

​
Contacting Your Driver

You can communicate with your driver during the trip:
  • Send text messages through the app
  • No phone number exchange required
  • Messages logged for safety
  • Quick message templates available
For your safety, contact information is only available during an active trip and is masked to protect privacy.

​
Notifications

Receive push notifications for trip updates:
  • Driver assigned to your trip
  • Driver approaching (2 minutes away)
  • Driver arrived at pickup
  • Trip started
  • Approaching destination
  • Trip completed
  • Payment received
  • Rating reminder

​
Trip Completion

When you arrive at your destination:
1

Arrival confirmation

Driver marks trip as completed in their app
2

Final fare

View the final trip cost based on actual distance and time
{
  "trip_id": "12345",
  "final_fare": {
    "base_fare": 4500,
    "distance_cost": 3200,
    "time_cost": 1800,
    "total": 9500,
    "currency": "COP"
  },
  "distance_km": 8.4,
  "duration_minutes": 18
}
3

Payment

Complete payment if not already processed
4

Rating

Rate your driver (1-5 stars) and provide optional feedback
5

Receipt

Access your trip receipt and details in trip history

​
Troubleshooting

Possible causes:
  • No internet connection
  • GPS disabled
  • Map tiles not loading
Solutions:
  • Check your internet connection
  • Enable location services
  • Restart the app
  • Clear app cache
Possible causes:
  • Driver’s GPS is disabled
  • Poor network connectivity
  • App running in background
Solutions:
  • Contact driver to check their GPS
  • Ensure app is in foreground
  • Refresh the trip screen
ETAs are estimates based on:
  • Current traffic conditions
  • Average speed
  • Route distance
They update continuously as conditions change.

​
Next Steps

Share Your Location

Learn how to share trip tracking with contacts

View Trip History

Access past trips and receipts

Build docs developers (and LLMs) love

Get started for freeTalk to us