Toll Cost Calculations

Calculate accurate toll costs for your routes in multiple currencies to enable precise budgeting, cost comparison, and financial planning.

🎯 What are Toll Calculations?

Toll calculations provide estimated costs for toll roads, bridges, and tunnels along your route. This feature enables:

• Accurate trip cost estimation
• Route cost comparison
• Budget planning and forecasting
• Cost-effective route selection
• Financial reporting

📋 Basic Configuration

Enabling Toll Calculations

Use the tolls parameter to enable toll cost calculations:

{
  "mode": "car",
  "origin": [41.0082, 28.9784],
  "destination": [41.0150, 28.9850],
  "tolls": true,
  "currency": "EUR",
  "minimize": "duration"
}

Supported Currencies

Currency Code	Currency Name	Regions
EUR	Euro	European Union
USD	US Dollar	United States, International
TRY	Turkish Lira	Turkey

Response Structure

Toll costs appear in the route summary:

{
  "routes": [
    {
      "sections": [
        {
          "summary": {
            "distance": 8500,
            "duration": 720,
            "toll_cost": 2.50
          }
        }
      ]
    }
  ]
}

💡 Use Cases

1. Cost Comparison

Compare routes based on total cost (time + tolls):

{
  "mode": "car",
  "origin": [41.0082, 28.9784],
  "destination": [41.0150, 28.9850],
  "alternatives": 2,
  "tolls": true,
  "currency": "EUR",
  "minimize": "duration"
}

Analysis: - Route 0: 35 min, €5.50 (fastest with tolls) - Route 1: 48 min, €0.00 (slower, no tolls) - Route 2: 42 min, €2.00 (moderate time and cost)

2. Budget Planning

Calculate total transportation costs:

{
  "mode": "truck",
  "origin": [41.0082, 28.9784],
  "waypoints": [
    [41.0100, 28.9800],
    [41.0122, 28.9820]
  ],
  "destination": [41.0150, 28.9850],
  "tolls": true,
  "currency": "USD",
  "vehicle": {
    "length": 1200,
    "axle_count": 4
  }
}

Cost Breakdown: - Toll costs: $12.50 - Fuel estimate: $15.00 (based on distance) - Total trip cost: $27.50

3. Fleet Cost Analysis

Calculate daily toll expenses for fleet operations:

# Multiple routes throughout the day
routes = [
    {"origin": [41.0082, 28.9784], "destination": [41.0150, 28.9850]},
    {"origin": [41.0150, 28.9850], "destination": [41.0200, 28.9900]},
    {"origin": [41.0200, 28.9900], "destination": [41.0082, 28.9784]}
]

total_toll_cost = 0
for route in routes:
    # Calculate route with tolls
    # Sum toll_cost values
    pass
# Result: Daily toll cost per vehicle

4. Route Cost Optimization

Find the most cost-effective route:

{
  "mode": "car",
  "origin": [41.0082, 28.9784],
  "destination": [41.0150, 28.9850],
  "alternatives": 3,
  "tolls": true,
  "currency": "EUR",
  "minimize": "distance"  // Minimize distance for fuel savings
}

Combined Analysis:

for route in routes:
    distance_km = route["distance"] / 1000
    fuel_cost = distance_km * 0.15  # €0.15 per km
    toll_cost = route["toll_cost"]
    total_cost = fuel_cost + toll_cost
    time_minutes = route["duration"] / 60

    print(f"Distance: {distance_km} km")
    print(f"Fuel: €{fuel_cost:.2f}")
    print(f"Tolls: €{toll_cost:.2f}")
    print(f"Total: €{total_cost:.2f}")
    print(f"Time: {time_minutes:.0f} min")

🔧 Currency Selection

Choosing the Right Currency

// For European operations
{
  "tolls": true,
  "currency": "EUR"
}

// For US operations
{
  "tolls": true,
  "currency": "USD"
}

// For Turkish operations
{
  "tolls": true,
  "currency": "TRY"
}

Multi-Currency Operations

If your fleet operates across different regions:

def calculate_route_cost(origin, destination, region):
    currency = {
        "EU": "EUR",
        "US": "USD",
        "TR": "TRY"
    }[region]

    payload = {
        "tasks": [{
            "origin": origin,
            "destination": destination,
            "tolls": True,
            "currency": currency
        }]
    }
    # Calculate route...

📊 Cost Analysis Examples

Example 1: Time vs Cost Trade-off

// Fast route with tolls
{
  "minimize": "duration",
  "tolls": true,
  "currency": "EUR"
}
// Result: 35 min, €5.50

// Economical route without tolls
{
  "minimize": "distance",
  "avoid_features": ["toll_road"],
  "tolls": false
}
// Result: 48 min, €0.00

Decision Factors: - Time value: Is 13 minutes worth €5.50? - Trip frequency: Daily trips vs occasional travel - Delivery urgency: Express vs standard delivery

Example 2: Vehicle Size Impact

Toll costs often vary by vehicle size:

// Standard car
{
  "mode": "car",
  "tolls": true,
  "currency": "EUR"
}
// Toll cost: €2.50

// Large truck
{
  "mode": "truck",
  "vehicle": {
    "length": 1200,
    "axle_count": 4
  },
  "tolls": true,
  "currency": "EUR"
}
// Toll cost: €8.50

🎯 Best Practices

1. Always Calculate Tolls for Budgeting

{
  "tolls": true,
  "currency": "EUR",
  "alternatives": 1  // Compare toll vs non-toll routes
}

2. Match Currency to Operation Region

// Match currency to where costs are incurred
{
  "currency": "EUR"  // For EU routes
}

3. Consider Total Trip Cost

Don't focus only on toll costs:

def calculate_total_cost(route, fuel_price_per_km, labor_rate_per_hour):
    distance_km = route["distance"] / 1000
    duration_hours = route["duration"] / 3600

    fuel_cost = distance_km * fuel_price_per_km
    labor_cost = duration_hours * labor_rate_per_hour
    toll_cost = route.get("toll_cost", 0)

    total = fuel_cost + labor_cost + toll_cost
    return {
        "fuel": fuel_cost,
        "labor": labor_cost,
        "tolls": toll_cost,
        "total": total
    }

4. Update Regularly for Accuracy

Toll costs may change. Recalculate routes periodically for accurate budgets.

5. Document Toll Policies

Maintain clear policies for toll road usage:

# Company toll policy
TOLL_POLICY = {
    "express_delivery": True,   # Use tolls for fast delivery
    "standard_delivery": False, # Avoid tolls for cost savings
    "max_toll_per_trip": 10.00  # Maximum acceptable toll cost
}

⚠️ Important Considerations

Toll Cost Estimates

Toll costs are estimates and may vary due to: - Time of day (peak vs off-peak) - Payment method (electronic vs cash) - Vehicle classification - Seasonal variations - Regional promotions

Currency Exchange

If operating internationally, consider exchange rates:

def convert_toll_cost(amount, from_currency, to_currency, exchange_rate):
    return amount * exchange_rate

Missing Toll Data

Some regions may have: - Incomplete toll data - New toll roads not yet in system - Changed toll rates

Always verify with local toll authorities for critical budgeting.

📈 ROI Analysis

Calculate Toll Road Value

def toll_roi_analysis(toll_route, free_route, hourly_labor_rate):
    # Time savings
    time_saved_hours = (free_route["duration"] - toll_route["duration"]) / 3600
    labor_savings = time_saved_hours * hourly_labor_rate

    # Fuel savings (assuming free route is longer)
    distance_saved_km = (free_route["distance"] - toll_route["distance"]) / 1000
    fuel_savings = distance_saved_km * 0.15  # €0.15 per km

    # Toll cost
    toll_cost = toll_route["toll_cost"]

    # Net savings
    net_savings = labor_savings + fuel_savings - toll_cost

    return {
        "time_saved_minutes": time_saved_hours * 60,
        "labor_savings": labor_savings,
        "fuel_savings": fuel_savings,
        "toll_cost": toll_cost,
        "net_savings": net_savings,
        "roi_percentage": (net_savings / toll_cost * 100) if toll_cost > 0 else 0
    }

Example ROI Calculation

Fast Route (with tolls):
- Duration: 35 min
- Distance: 45 km
- Toll cost: €5.50

Slow Route (no tolls):
- Duration: 48 min
- Distance: 52 km
- Toll cost: €0.00

Analysis (€50/hour labor rate):
- Time saved: 13 min (€10.83 labor value)
- Fuel saved: 7 km (€1.05 fuel value)
- Toll cost: €5.50
- Net savings: €6.38
- ROI: 116%

🚀 Complete Example

import requests

API_BASE_URL = "https://api.flio.ai"
ROUTE_ENDPOINT = "/solver/route"
API_KEY = "YOUR-API-KEY"

# Calculate route with toll costs
payload = {
    "tasks": [
        {
            "mode": "car",
            "origin": [41.0082, 28.9784],
            "destination": [41.0150, 28.9850],
            "alternatives": 2,
            "tolls": True,
            "currency": "EUR",
            "minimize": "duration"
        }
    ]
}

url = f"{API_BASE_URL}{ROUTE_ENDPOINT}?api_key={API_KEY}"
response = requests.post(url, json=payload)

if response.status_code == 200:
    data = response.json()

    for idx, route in enumerate(data["tasks"][0]["routes"]):
        total_distance = 0
        total_duration = 0
        total_toll = 0

        for section in route["sections"]:
            summary = section["summary"]
            total_distance += summary["distance"]
            total_duration += summary["duration"]
            total_toll += summary.get("toll_cost", 0)

        print(f"\n=== Route {idx} ===")
        print(f"Distance: {total_distance/1000:.2f} km")
        print(f"Duration: {total_duration/60:.2f} min")
        print(f"Toll Cost: €{total_toll:.2f}")

        # Calculate total trip cost
        fuel_cost = (total_distance/1000) * 0.15
        total_cost = fuel_cost + total_toll
        print(f"Est. Fuel Cost: €{fuel_cost:.2f}")
        print(f"Total Cost: €{total_cost:.2f}")

📚 See Also

• Route API Reference
• Route Examples
• Alternative Routes
• Feature Avoidance
• Minimize Criteria

---

Accurate toll cost calculations enable informed routing decisions. Always consider total trip cost including fuel, labor, and tolls for comprehensive analysis.