navigation

Fit a GPS trace to the road network

Returns matched geometry, confidence scores, and OSM way IDs for an ordered GPS trace.

When to use: Match recorded travel coordinates to the road network.

post/map-match

Request

  • Base URL: https://api.mapsource.io
  • URL: https://api.mapsource.io/map-match
  • Auth: HTTP bearer

Request body

costingstring

Travel mode.

shapeMatch'map_snap' | 'edge_walk'

map_snap tolerates noise; edge_walk assumes the trace already follows the network.

Response

Fit a GPS trace to the road network

schemastring
profilestring

The costing model that produced this result.

geometryAvailable'inline' | 'handle'

Where the geometry is. handle means read geometryRef.

confidencenumber nullable

Matching confidence from 0 to 1, or null when unavailable.

geometryobject

Changes

No recorded changes to this operation across all 1 revision of this API.