Minimize Criteria¶

The minimize parameter determines what the route will be optimized for.

What is Minimize Criteria?¶

The minimize parameter specifies which criterion the API will prioritize when calculating the route.

Basic Usage¶

Minimize in the Request Body¶

{
  "origin": {"latitude": 41.0082, "longitude": 28.9784},
  "destination": {"latitude": 41.0150, "longitude": 28.9850},
  "minimize": "duration"
}

Available Values¶

Value	Description	Use Case
`duration`	Targets the shortest duration	Time-sensitive deliveries, urgent situations
`distance`	Targets the shortest distance	Fuel savings, cost optimization

Use Cases¶

1. Fast Delivery (Duration)¶

For time-critical deliveries:

{
  "origin": {"latitude": 41.0082, "longitude": 28.9784},
  "destination": {"latitude": 41.0150, "longitude": 28.9850},
  "minimize": "duration"
}

2. Cost Optimization (Distance)¶

For fuel savings:

{
  "origin": {"latitude": 41.0082, "longitude": 28.9784},
  "destination": {"latitude": 41.0150, "longitude": 28.9850},
  "minimize": "distance"
}

Configuration¶

Default Behavior¶

If the minimize parameter is not specified, the API uses duration by default.

Combination with Toll Roads¶

Combine with toll roads for cost analysis:

{
  "origin": {"latitude": 41.0082, "longitude": 28.9784},
  "destination": {"latitude": 41.0150, "longitude": 28.9850},
  "minimize": "duration",
  "tolls": true,
  "currency": "TRY"
}

Comparison¶

Criteria	Advantages	Disadvantages
`duration`	Faster delivery	Longer distance, higher cost
`distance`	Lower fuel cost	Longer duration

Python Example¶

import requests

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

# Duration-focused route
duration_route = requests.post(
    f"{API_BASE_URL}/solver/route?apiKey={API_KEY}",
    json={
        "origin": {"latitude": 41.0082, "longitude": 28.9784},
        "destination": {"latitude": 41.0150, "longitude": 28.9850},
        "minimize": "duration"
    }
).json()

# Distance-focused route
distance_route = requests.post(
    f"{API_BASE_URL}/solver/route?apiKey={API_KEY}",
    json={
        "origin": {"latitude": 41.0082, "longitude": 28.9784},
        "destination": {"latitude": 41.0150, "longitude": 28.9850},
        "minimize": "distance"
    }
).json()

print(f"Duration: {duration_route['routes'][0]['summary']['duration']}s")
print(f"Distance: {distance_route['routes'][0]['summary']['distance']}m")

Minimize Criteria — Flio.ai