Routing

Calculate routes and distances between locations

Calculate Route

POST /map/calculate_route.php

Calculate the optimal route between two locations.

Request Body

origin · object · required

Starting location

Show origin fields

latitud · number · required

Origin latitude

longitud · number · required

Origin longitude

direccion · string

Origin address

destination · object · required

Destination location (same structure as origin)

Response

success · boolean

Route calculation success status

route · object

Calculated route information

Show route structure

origen · object

Origin location details

destino · object

Destination location details

distancia_km · number

Total distance in kilometers

duracion_minutos · integer

Estimated duration in minutes

puntos · array

Array of coordinates forming the route path

instrucciones · string

Optional turn-by-turn directions

Request Example

cURL

curl -X POST https://76.13.114.194/map/calculate_route.php \
  -H "Content-Type: application/json" \
  -d '{
    "origin": {
      "latitud": 4.6814,
      "longitud": -74.0479,
      "direccion": "Carrera 15 #85-30"
    },
    "destination": {
      "latitud": 4.6533,
      "longitud": -74.0602,
      "direccion": "Calle 72 #10-20"
    }
  }'

Response Example

Success

{
  "success": true,
  "route": {
    "origen": {
      "latitud": 4.6814,
      "longitud": -74.0479,
      "direccion": "Carrera 15 #85-30"
    },
    "destino": {
      "latitud": 4.6533,
      "longitud": -74.0602,
      "direccion": "Calle 72 #10-20"
    },
    "distancia_km": 4.2,
    "duracion_minutos": 15,
    "puntos": [
      {
        "latitud": 4.6814,
        "longitud": -74.0479
      },
      {
        "latitud": 4.6750,
        "longitud": -74.0510
      },
      {
        "latitud": 4.6650,
        "longitud": -74.0550
      },
      {
        "latitud": 4.6533,
        "longitud": -74.0602
      }
    ],
    "instrucciones": "Siga por Carrera 15 hacia el sur..."
  }
}

---

Calculate Distance

POST /map/calculate_distance.php

Calculate the distance between two points without full route details.

Request Body

origin · object · required

Starting location with latitud and longitud

destination · object · required

Destination location with latitud and longitud

Response

success · boolean

Calculation success status

distance · number

Distance in kilometers

Request Example

cURL

curl -X POST https://76.13.114.194/map/calculate_distance.php \
  -H "Content-Type: application/json" \
  -d '{
    "origin": {"latitud": 4.6814, "longitud": -74.0479},
    "destination": {"latitud": 4.6533, "longitud": -74.0602}
  }'

Response Example

Success

{
  "success": true,
  "distance": 4.2
}

---

Display Route on Map

Use the route points to draw a polyline on the map:

import 'package:google_maps_flutter/google_maps_flutter.dart';

Polyline createRoutePolyline(RouteModel route) {
  final points = route.puntos.map((location) {
    return LatLng(location.latitud, location.longitud);
  }).toList();

  return Polyline(
    polylineId: PolylineId('route'),
    points: points,
    color: Colors.blue,
    width: 5,
    geodesic: true,
  );
}

// Usage in GoogleMap widget:
GoogleMap(
  polylines: {createRoutePolyline(route)},
  // ... other properties
);

---

Alternative Routes

Currently, the API returns a single optimal route. Support for alternative routes may be added in future versions.

---

Traffic Consideration

The duration estimate considers:

• Time of day: Rush hour vs. off-peak
• Day of week: Weekday vs. weekend
• Historical data: Average speeds on specific roads
• Real-time updates: Current traffic conditions (if available)

---

Error Responses

400 · Bad Request

Invalid coordinates or missing parameters

500 · Internal Server Error

Routing service error

See Also

• Geocoding - Convert addresses to coordinates
• Create Trip - Request a trip with calculated route
• Trip Pricing - Estimate trip cost based on distance