← REST APIREST endpoint

Clean up a GPS trace.

Map-match a noisy GPS recording to the road network. Returns the corrected path plus per-segment road attributes.

Get an API keySee the MCP tool
POST /v1/routing/snap
Why you need it

The problem this solves.

GPS traces from phones and trackers jump, drift, and cut corners. snap_trace pins each point to the most likely road segment and returns the cleaned path with confidence scores, surface type, road class, and speed limits per segment. The basis for fleet replay, route validation, and post-hoc analysis.

What it does for you

What comes back in the response.

  • Cleaned LineString of the snapped trace.
  • Per-segment road attributes: surface, class, speed limit, grade.
  • Confidence score per snap for quality filtering.
  • Terrain analytics for the full trace.
  • Standard POST. JSON in, JSON out.
Built for
For integrators
Try it

Call it from your backend.

Predictable HTTP. JSON in, JSON out. One auth header. Use it from any backend, edge function, or script.

Read the full reference
POST /v1/routing/snap
curl -X POST https://api.footstep.ai/v1/routing/snap \
  -H "x-api-key: sk_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ ... }'

Related capabilities.

get_directions

Point-to-point or multi-stop routes with terrain analytics. Answer 'is this walkable?' without a second call.

get_elevation

Heights in metres above sea level, with summary statistics for total ascent and descent.

search_along_route

Coffee, charging, fuel, food. Ranked by how little detour they add to the existing route.

Ready to call it?

£5 free credit on signup. One auth header, every major runtime.

Get an API keySee the MCP tool