La petición
- route
- Una LineString o MultiLineString GeoJSON, de hasta 20 000 km y 200 000 puntos
- departure
- Cuándo sales, con desfase horario; ahora si se omite
- speedKmh
- Velocidad media, de 2 a 80, por defecto 20
- stepKm
- Distancia entre puntos de previsión, de 0,5 a 100; por defecto cada 5 km o una centésima parte de la ruta, como máximo 200 puntos
La respuesta
{
"routeLengthKm": 64.5, "speedKmh": 20,
"departure": "2026-11-07T17:51:52.698Z", "arrival": "2026-11-07T21:05:19.533Z",
"summary": { "minTemperatureC": -1.6, "maxTemperatureC": 7.8, "maxPrecipitationMm": 0,
"maxHeadwindKmh": 3.2, "maxGustKmh": 34.1 },
"points": [
{ "km": 0, "lon": 6.143, "lat": 46.204, "time": "2026-11-07T17:51:52.698Z",
"temperatureC": 7.8, "feelsLikeC": 6.1, "precipitationMm": 0, "weatherCode": 2,
"windKmh": 4.9, "windDirDeg": 197, "gustKmh": 9.4, "cloudPct": 52, "humidityPct": 88,
"isDay": false, "headwindKmh": 1.7, "crosswindKmh": 4.6 },
...
]
}headwindKmh es la parte del viento que va en tu contra, negativa cuando lo llevas a favor; crosswindKmh es la parte que llega de lado. El resumen da el momento más frío y el más cálido, la hora más lluviosa y el viento de frente y la racha más fuertes, para que un cliente pueda avisar antes de que el usuario mire los detalles. Las previsiones llegan a 14 días vista.
Todo sobre la ruta en una petición
POST /v1/route/report recibe la misma ruta y devuelve juntas cualquiera de estas partes: el perfil de elevación con el desnivel total, el tiempo a las horas de llegada, las zonas horarias que cruzas, las estaciones de calidad del aire cercanas a la ruta, las estaciones de aforo de ríos y lo que atraviesa la ruta, como áreas protegidas y fronteras. Cada parte cuenta como una petición, así que pagas por lo que pides.
{ "route": { ... }, "include": ["profile", "weather", "timezones"], "departure": "2026-11-08T08:00:00+01:00", "speedKmh": 20 }El perfil, el tiempo, las zonas horarias, los ríos y las capas de un recorrido de 90 km llegaron en unos 6,5 segundos.
Quién la usa
Aplicaciones de ciclismo, running, senderismo y viajes: un planificador de recorridos que muestra dónde empieza a llover, una aplicación de entrenamiento que elige el sentido de un circuito según el viento, una herramienta de viajes que avisa de heladas en un puerto. La página de la API de tiempo trata las previsiones para un punto y sobre un área; las rutas pueden trazar antes el recorrido.
Créditos: datos meteorológicos de Open-Meteo.com (CC BY 4.0), basados en previsiones de ECMWF, NOAA, Deutscher Wetterdienst y Environment and Climate Change Canada.