weather API Spain PortugalAEMET APIIPMA APItruck weather routing

Alertas Meteorológicas para Rutas de Transporte · AEMET e IPMA en Tiempo Real

Consulta alertas de AEMET e IPMA en tiempo real para rutas de transporte. Scoring de peligrosidad por tramo para decisiones de despacho más seguras.

Por Jorge Parada, CTO de Cargoffer

Alertas Meteorológicas para Rutas de Transporte · AEMET e IPMA en Tiempo Real

Las inclemencias meteorológicas causan el 15% de los retrasos graves en el transporte de mercancías por carretera. La API de TRANSCEND evalúa las condiciones climáticas a lo largo de toda la ruta utilizando datos oficiales de AEMET e IPMA. El sistema genera un 'Scoring de Peligrosidad' por tramo, permitiendo a los gestores de tráfico anticiparse a fuertes vientos o nevadas, evitar bloqueos en autopistas y mejorar la seguridad de los conductores. (Fuente: datos internos Cargoffer, 2025).

La logística en carretera está severamente expuesta al clima. TRANSCEND Weather API no es una API generalista para saber "si lloverá mañana". Es un motor de ingestión de fuentes oficiales gubernamentales (AEMET en España, IPMA en Portugal, Météo-France) que cruza las trayectorias de las tormentas y temporales con la geometría proyectada de la ruta del camión.

1. Visión Arquitectónica: El Peligro Dinámico

Un camión lona vacío circulando con vientos laterales de 80 km/h tiene un riesgo extremo de vuelco. Nuestra API convierte los avisos meteorológicos puros en un Danger Score (0-10) específico para vehículos pesados, analizando:

  • Vientos Laterales (Ráfagas).
  • Nieve/Hielo (Obligatoriedad de Cadenas que frena la marcha).
  • Lluvias torrenciales (Aquaplaning con carga).

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

El endpoint de correlación climática evalúa los puntos geográficos en momentos del tiempo (T+1, T+2 horas).

POST https://api.cargoffer.com/weather/route-risk

Headers Requeridos

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

JSON Request Payload

Pasamos la polilínea codificada y la ventana temporal.

{
  "route_polyline": "u{~vFvyys@f`@...",
  "departure_time": "2026-12-15T06:00:00Z",
  "average_speed_kmh": 80
}

JSON Response (Risk Assessment)

{
  "overall_danger_score": 8.5,
  "status": "CRITICAL",
  "alerts": [
    {
      "type": "SNOW",
      "source": "AEMET",
      "severity": "RED",
      "location": { "lat": 42.1, "lng": -0.4 },
      "impact_time": "2026-12-15T09:30:00Z",
      "instruction": "Uso obligatorio de cadenas en AP-68."
    },
    {
      "type": "WIND",
      "source": "AEMET",
      "severity": "ORANGE",
      "location": { "lat": 41.5, "lng": -1.2 },
      "wind_speed_kmh": 95,
      "crosswind_angle": 85,
      "instruction": "Peligro de vuelco para vehículos de lona."
    }
  ]
}

3. Integración Directa vía Servidor MCP

Los LLMs pueden usar esta API para alertar proactivamente a los equipos de operaciones sobre desastres naturales en tiempo real.

Instalación

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

Tools Expuestas

  • check_route_weather: Devuelve el Danger Score para una ruta específica.
  • get_active_regional_alerts: Lista todas las alertas rojas/naranjas actuales en un país (ej. country: ES).

4. Automatización con Agentes IA

System Prompt Sugerido: "Eres un Asistente de Prevención de Riesgos de Flota. Antes de despachar una ruta, DEBES ejecutar la tool check_route_weather. Si el overall_danger_score es mayor a 7, debes bloquear el despacho virtualmente y proponer al usuario una ruta alternativa (usando el enrutador) o sugerir retrasar la hora de salida (departure_time) en 12 horas hasta que pase el frente tormentoso."

Enlaces Relacionados