weather API Spain PortugalAEMET APIIPMA APItruck weather routing

Documentar `/weather` (AEMET/IPMA + danger scoring)

Mega-Tutorial: Alertas Climáticas Predictivas para Transporte Terrestre (Weather API)

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. Patrones de Prompting (System Prompts)

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."

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: