Especificación: API de Rutas (Route Optimization)
Especificación Técnica: API de Rutas (Route Optimization)
La API de Rutas de TRANSCEND permite optimizar los itinerarios de camiones comerciales y flotas pesadas mediante cálculos semánticos rápidos sobre grafos de carreteras basados en el motor abierto Valhalla.
1. Resumen de Endpoint
- URL:
POST https://back.transcend.cargoffer.com/api/v1/route/optimize - Método:
POST - Auth: Bearer Token en Header
2. Parámetros del Request (Body)
| Parámetro | Tipo | Requerido | Descripción |
| :--- | :--- | :--- | :--- |
| origin | Object | Sí | Latitud y Longitud de inicio ({"lat": float, "lng": float}). |
| destination| Object | Sí | Latitud y Longitud del final. |
| vehicle | Object | Sí | Especificaciones físicas del camión (peso, altura, tipo ADR). |
| compliance | String | No | Modo de cumplimiento regulatorio (ej. EC_561_2006). |
| avoid | Array | No | Elementos a evitar en ruta (["tolls", "highways", "ferries"]). |
3. Ejemplo de Payload Abreviado
{
"origin": {"lat": 40.4167, "lng": -3.7037},
"destination": {"lat": 41.3851, "lng": 2.1734},
"vehicle": {
"type": "semi-trailer",
"weight_kg": 40000,
"height_m": 4.0,
"adr_class": "NONE"
}
}
4. Siguientes Pasos y Tutoriales Relacionados
Explora cómo combinar esta funcionalidad con otros módulos de TRANSCEND para crear flujos de trabajo avanzados en tu LLM o Agente:
- Optimización de Rutas (Valhalla)
- Cálculo Dinámico de Peajes y Costes
- Meteorología AEMET/IPMA para Rutas
- Tráfico y Puntos Negros en Tiempo Real
- Extracción de Datos de Facturas (OCR)
- Búsqueda de Puntos de Interés (Parkings/Duchas)
- Caso de Uso: Ahorro de Combustible
- Caso de Uso: Automatización Invoice-to-Cash