Matching Service

Matching API matches or snaps given GPS points to the road network in the most plausible way. Please note the request might result multiple sub-traces. Large jumps in the timestamps (> 60s) or improbable transitions lead to trace splits if a complete matching could not be found. The algorithm might not be able to match all points. Outliers are removed if they can not be matched successfully.

Path Params
string
enum
required

Mode of transportation. driving and walking are supported.

Allowed:
string
required

String of format {longitude},{latitude};{longitude},{latitude}[;{longitude},{latitude} ...] or polyline({polyline}) or polyline6({polyline6}).
You can send up to a maximum of 25 coordinate pairs per request (except Nearest API where coordinates only supports a single {longitude},{latitude} entry)

Query Params
string

Limits the search to segments with given bearing in degrees towards true north in clockwise direction. List of positive integer pairs separated by semi-colon and bearings array should be equal to length of coordinate array. Accepted Value :- {bearing};{bearing}[;{bearing} ...] Each {bearing} follows the following format: {value},{range} integer 0 .. 360,integer 0 .. 180

string

Limits the search to given radius in meters Radiuses array length should be same as coordinates array, each value separated by semi-colon. Accepted Value - {radius};{radius}[;{radius} ...] Each {radius} has following format: double >= 0 or unlimited (default)

string

Hint from previous request to derive position in street network. Accepted value: {hint};{hint}[;{hint} ...]

string

Returned route steps for each route leg. Accepted value: true, false (default)

string
Defaults to polyline

Returned route geometry format (influences overview and per step). Accepted value: polyline (default), polyline6, geojson

string
Defaults to false

Returns additional metadata for each coordinate along the route geometry. Accepted value: true, false (default), nodes, distance, duration, datasources, weight, speed

string
Defaults to simplified

Add overview geometry either full, simplified according to highest zoom level it could be display on, or not at all. Accepted value: simplified (default), full, false

string

'Timestamps for the input locations in seconds since UNIX epoch. Timestamps need to be monotonically increasing. Accepted value: {timestamp};{timestamp}[;{timestamp} ...] Each {timestamp} has the following format: integer seconds since UNIX epoch'

string
Defaults to split

Allows the input track splitting based on huge timestamp gaps between points. Accepted value: split (default), ignore

string
Defaults to false

Allows the input track modification to obtain better matching quality for noisy tracks. Accepted value: true, false (default).

string

Treats input coordinates indicated by given indices as waypoints in returned Match object. Default is to treat all input coordinates as waypoints. {index};{index};{index}... ]

Responses

Language
Credentials
Query
URL
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json