Skip to main content
GET
Snap a GPS trace to the road network

Authorizations

Authorization
string
header
required

API key created in the JustRouting dashboard.

Path Parameters

profile
enum<string>
required
Available options:
driving,
motorcycle
coordinates
string
required

Trace points {lng},{lat};... in time order.

Query Parameters

timestamps
string
required

UNIX timestamps (seconds) for each point, monotonically increasing, one per coordinate.

radiuses
string

GPS accuracy in meters per point (standard deviation). Use device-reported accuracy when available.

steps
boolean
default:false

Return turn-by-turn steps.

geometries
enum<string>
default:polyline

Geometry encoding of the response.

Available options:
polyline,
polyline6,
geojson
overview
enum<string>
default:simplified

How much route geometry to return.

Available options:
full,
simplified,
false
gaps
enum<string>
default:split

Whether large timestamp gaps split the trace into multiple matchings.

Available options:
split,
ignore
tidy
boolean
default:false

Allow removing noisy points to improve matching quality.

Response

Trace matched

code
enum<string>
Available options:
Ok
tracepoints
(object | null)[]

One entry per input point; null for dropped outliers.

matchings
object[]