traffic API Spainradar APIincident APIreal-time traffic

Documentar `/traffic` (incidencias + radares + blackspots)

Mega-Tutorial: Telemetría de Tráfico y Prevención de Puntos Negros (Traffic API)

TRANSCEND Traffic API expone telemetría en vivo e histórica. Mientras que Google Maps te dice si el tráfico es "rojo", TRANSCEND te dice la causa (accidente, obras, vehículo averiado, retención DGT) y prevé la disolución del atasco usando IA bayesiana.

1. Visión Arquitectónica y Beneficio Principal

Los retrasos cuestan mucho dinero en logística (rotura de cadenas de frío, penalizaciones por ventanas horarias de supermercados). La API de Tráfico se encarga de:

  • Incidentes DGT: Ingestión del panel nacional de la DGT en España, Bison Futé en Francia, etc.
  • Blackspots (Puntos Negros): Identificación de zonas con accidentes estadísticamente probables para un camión.
  • Restricciones Temporales: Cortes de carretera para vehículos > 7500kg por operación salida/retorno de verano.

2. Especificación Técnica Completa (OpenAPI)

El endpoint más potente es el evaluador de restricciones dinámicas e incidencias a lo largo de una línea temporal.

POST https://api.cargoffer.com/traffic/evaluate

Headers Requeridos

  • Content-Type: application/json
  • Authorization: Bearer <TU_API_KEY>

JSON Request Payload

{
  "route_polyline": "u{~vFvyys@f`@...",
  "vehicle_class": "heavy_goods",
  "weight_kg": 40000,
  "departure_time": "2026-08-01T15:00:00Z"
}

JSON Response

{
  "delay_seconds": 4500,
  "road_closures": [
    {
      "id": "DGT-RESTRICT-88",
      "type": "heavy_vehicle_ban",
      "description": "Restricción Operación Salida Agosto",
      "road": "A-3",
      "km_start": 30,
      "km_end": 100,
      "active_until": "2026-08-01T22:00:00Z"
    }
  ],
  "incidents": [
    {
      "type": "accident",
      "severity": "high",
      "description": "Colisión múltiple sentido Madrid",
      "expected_clearance_time": "2026-08-01T17:30:00Z"
    }
  ]
}

3. Integración Directa vía Servidor MCP

La IA puede prever disrupciones y proponer desvíos utilizando este servidor MCP.

Instalación

npx -y @cargoffer/mcp-server-transcend@latest

Tools Expuestas

  • evaluate_traffic_incidents: Comprueba incidencias en vivo para una ruta.
  • check_dgt_restrictions: Comprueba restricciones de movilidad legal para camiones.

4. Patrones de Prompting (System Prompts)

System Prompt Sugerido: "Actúas como un Controlador de Tráfico Inteligente. Si el usuario te pide trazar una ruta en fines de semana de verano o vísperas de festivos, siempre llama a check_dgt_restrictions usando vehicle_class: heavy_goods para evitar que el camión sea inmovilizado por las autoridades. Si detectas un road_closure, usa el enrutador para buscar una ruta alternativa."

5. 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: