Documentation menu
routing
POST/v1/weather/along
API key required, sent as Authorization: Bearer snk_… or ?api_key=snk_….
Call it
bash
curl -fsS -X POST "https://api.mapmap.ai/v1/weather/along" \
-H "Authorization: Bearer $MAPMAP_KEY" \
-H "Content-Type: application/json" \
-d @request.jsonRequest body
application/json · WeatherAlongRequest
Route shape as polyline6, optional depart_at (RFC 3339, default now), optional duration_s (route duration in seconds; omit for a generic average-speed estimate) and optional sample_interval_m (default 25,000, 5,000–100,000)
| Field | Type | Required | Description |
|---|---|---|---|
| depart_at | string | no | Departure time, RFC 3339; defaults to now. |
| duration_s | number | no | Total route duration in seconds, used to compute each sample's ETA
by arc-length fraction. Omit to fall back to a generic
[DEFAULT_AVERAGE_SPEED_KPH] estimate (flagged in the response as
duration_source: "estimated_default_speed"); pass the real value
from /route for accurate alignment. |
| sample_interval_m | number | no | Route-sampling interval in metres; default 25,000, clamped to
5,000–100,000, and the point count is separately capped at
[MAX_SAMPLES]. |
| shape | string | yes | The route shape as a polyline6 string. |
Responses
200Per-sample weather aligned to each point's estimated time of arrival
| Field | Type | Required | Description |
|---|---|---|---|
| attribution | string | no | Present when at least one sample carries real data. |
| depart_at | string | yes | The departure time actually used (RFC 3339 UTC). |
| duration_s | number | yes | The route duration actually used, seconds. |
| duration_source | string | yes | provided | estimated_default_speed — see [DurationSource]. |
| sample_interval_m | number | yes | The sampling interval actually used, metres (after clamping/the
[MAX_SAMPLES] cap — may be coarser than requested on a long
route). |
| samples | WeatherSample[] | yes | Route samples, arc_m ascending. |
400Invalid request
401Missing or invalid API key
429Quota or rate limit exceeded
501Weather-along-route is not enabled (SN_OPEN_METEO_URL unset)
Error bodies follow the shared problem model documented on API conventions.
Also under routing
POST /centroidPOST /isochronePOST /locatePOST /matrixPOST /optimisePOST /optimise/replanPOST /routePOST /route/alongPOST /route/progressPOST /route/reportGET /route/v1/{profile}/{coordinates}POST /trace_attributesPOST /trace_routePOST /v1/cameras/alongPOST /v1/charging/alongPOST /v1/clusterPOST /v1/ev/planPOST /v1/fuel/alongPOST /v1/incidents/alongPOST /v1/jobs/matrixPOST /v1/jobs/optimisePOST /v1/jobs/replanGET /v1/zones
Generated from https://api.mapmap.ai/openapi.json on 2026-09-17 · operationId post_weather_along