Referencia Completa: API de Rutas para Transporte · Parámetros y Ejemplos
Documentación completa de la API de rutas TRANSCEND. Todos los parámetros, ejemplos de request/response y restricciones de vehículo soportadas.
Referencia Completa: API de Rutas para Transporte · Parámetros y Ejemplos
La API de Rutas de TRANSCEND expone más de 40 parámetros de configuración para afinar el enrutamiento de vehículos pesados. Los desarrolladores pueden definir desde la carga por eje hasta la categoría de túnel permitida para mercancías ADR. Esta precisión permite que los sistemas ERP y TMS generen hojas de ruta 100% legales y seguras, evitando hasta un 90% de los incidentes en ruta causados por infraestructuras incompatibles con el vehículo. (Fuente: datos internos Cargoffer, 2025).
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