La météo le long d'un itinéraire, à l'heure où vous y êtes

La prévision du départ d'une longue sortie à vélo ou en voiture dit peu de chose du col que vous atteindrez quatre heures plus tard. Envoyez l'itinéraire, l'heure de départ et votre vitesse : l'API calcule quand vous atteignez chaque point et renvoie la prévision de cette heure à cet endroit, avec le vent décomposé en vent de face et vent latéral selon votre direction de déplacement.

curl https://geo.runningcat.dev/v1/route/weather \
  -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
  -d '{
    "route": {"type": "LineString", "coordinates": [[6.143, 46.204], [6.4, 46.07], [6.63, 46.0], [6.869, 45.924]]},
    "departure": "2026-11-08T08:00:00+01:00",
    "speedKmh": 20,
    "stepKm": 20
  }'
Exemple de requête

La requête

route
Une LineString ou MultiLineString GeoJSON, jusqu'à 20 000 km et 200 000 points
departure
L'heure de départ, avec décalage ; maintenant si elle est omise
speedKmh
Vitesse moyenne, de 2 à 80, 20 par défaut
stepKm
Distance entre les points de prévision, de 0,5 à 100 ; par défaut tous les 5 km ou un centième de l'itinéraire, 200 points au maximum

La réponse

{
  "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 est la part du vent qui vous est opposée, négative quand il vous pousse ; crosswindKmh est la part qui vient du côté. Le résumé donne le moment le plus froid et le plus chaud, l'heure la plus pluvieuse, ainsi que le vent de face et la rafale les plus forts, pour qu'un client puisse avertir avant que l'utilisateur ne regarde le détail. Les prévisions portent jusqu'à 14 jours.

Tout sur l'itinéraire en une requête

POST /v1/route/report prend le même itinéraire et renvoie ensemble n'importe lesquelles de ces parties : le profil altimétrique avec le dénivelé positif total, la météo aux heures de passage, les fuseaux horaires traversés, les stations de mesure de l'air proches de l'itinéraire, les stations hydrométriques et ce que l'itinéraire traverse, comme les zones protégées et les frontières. Chaque partie compte pour une requête, vous payez donc ce que vous demandez.

{ "route": { ... }, "include": ["profile", "weather", "timezones"], "departure": "2026-11-08T08:00:00+01:00", "speedKmh": 20 }

Profil, météo, fuseaux horaires, rivières et couches pour une sortie de 90 km sont revenus en environ 6,5 secondes.

Qui l'utilise

Applications de cyclisme, de course à pied, de randonnée et de voyage : un planificateur de sorties qui montre où la pluie commence, une application d'entraînement qui choisit le sens d'une boucle selon le vent, un outil de voyage qui avertit du gel sur un col. La page de l'API météo traite des prévisions pour un point et sur une zone ; le routage peut d'abord tracer l'itinéraire.

Crédits : données météo d'Open-Meteo.com (CC BY 4.0), fondées sur les prévisions de l'ECMWF, de la NOAA, du Deutscher Wetterdienst et d'Environnement et Changement climatique Canada.

L’offre gratuite donne 500 requêtes par jour, y compris pour les applications commerciales. Créez un compte avec Google ou votre e-mail et générez vos clés tout de suite.