Skip to content

Route Examples

Route API usage examples and scenarios.

1. Simple A→B Route

Basic route calculation between two points:

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

Python Example

import requests

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

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

url = f"{API_BASE_URL}/solver/route?apiKey={API_KEY}"
response = requests.post(url, json=payload)
result = response.json()

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

2. Address-Based Route

Route calculation using an address instead of coordinates:

{
  "origin": {
    "address": "Sultanahmet Meydanı",
    "city": "İstanbul",
    "district": "Fatih"
  },
  "destination": {
    "address": "Taksim Meydanı",
    "city": "İstanbul",
    "district": "Beyoğlu"
  }
}

3. Multi-Stop Route with Waypoints

Route with multiple intermediate stops:

{
  "origin": {"latitude": 41.0082, "longitude": 28.9784},
  "destination": {"latitude": 41.0200, "longitude": 28.9900},
  "waypoints": [
    {
      "latitude": 41.0100,
      "longitude": 28.9800,
      "stopDuration": 300
    },
    {
      "latitude": 41.0150,
      "longitude": 28.9850,
      "stopDuration": 600
    }
  ],
  "minimize": "duration"
}

4. Truck Route

Truck route with vehicle properties:

{
  "origin": {"latitude": 41.0082, "longitude": 28.9784},
  "destination": {"latitude": 41.0150, "longitude": 28.9850},
  "vehicle": {
    "vehicleType": "truck",
    "length": 1200,
    "width": 255,
    "height": 400,
    "axle_count": 3,
    "hazardousGoods": ["flammable"]
  },
  "avoidFeatures": ["tunnel", "ferry"],
  "minimize": "distance"
}

5. Turn-by-Turn Directions

Route geometry using the direction parameter:

curl -X POST "https://api.flio.ai/solver/route?apiKey=YOUR-API-KEY&direction=geocode" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": {"latitude": 41.0082, "longitude": 28.9784},
    "destination": {"latitude": 41.0150, "longitude": 28.9850}
  }'

Turn-by-Turn Directions with Python

import requests

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

payload = {
    "origin": {"latitude": 41.0082, "longitude": 28.9784},
    "destination": {"latitude": 41.0150, "longitude": 28.9850}
}

url = f"{API_BASE_URL}/solver/route?apiKey={API_KEY}&direction=geocode"
response = requests.post(url, json=payload)
result = response.json()

# Turn-by-turn instructions
for section in result['routes'][0]['sections']:
    for action in section.get('actions', []):
        print(f"{action['instruction']}")

6. Toll Cost Calculation

Route with toll calculation:

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

Python Example

import requests

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

payload = {
    "origin": {"latitude": 41.0082, "longitude": 28.9784},
    "destination": {"latitude": 41.0150, "longitude": 28.9850},
    "tolls": True,
    "currency": "TRY"
}

url = f"{API_BASE_URL}/solver/route?apiKey={API_KEY}"
response = requests.post(url, json=payload)
result = response.json()

toll_cost = result['routes'][0]['summary']['cost']
print(f"Toll Cost: {toll_cost} TRY")

Route Examples — Flio.ai

Next Steps