Skip to content
GuidesPlaygroundDashboard

Map Match

Match GPS coordinates to the road network
MapMatchResult mapMatch().match(MapMatchMatchParamsparams, RequestOptionsrequestOptions = RequestOptions.none())
POST/api/v1/map-match
ModelsExpand Collapse
class MapMatchRequest:

GPS trace to match against the road network

GPS trace (GeoJSON LineString geometry)

Coordinates coordinates

GeoJSON coordinates array (nesting depth varies by geometry type)

One of the following:
List<double>
List<List<double>>
List<List<List<double>>>
List<List<List<List<double>>>>
Type type
One of the following:
POINT("Point")
LINE_STRING("LineString")
POLYGON("Polygon")
MULTI_POINT("MultiPoint")
MULTI_LINE_STRING("MultiLineString")
MULTI_POLYGON("MultiPolygon")
Optional<List<Double>> radiuses

Search radius per coordinate in meters (optional, default 50)

class MapMatchResult:

Map matching result with snapped geometry

Coordinates coordinates

GeoJSON coordinates array (nesting depth varies by geometry type)

One of the following:
List<double>
List<List<double>>
List<List<List<double>>>
List<List<List<List<double>>>>
Type type
One of the following:
POINT("Point")
LINE_STRING("LineString")
POLYGON("Polygon")
MULTI_POINT("MultiPoint")
MULTI_LINE_STRING("MultiLineString")
MULTI_POLYGON("MultiPolygon")
Properties properties
Optional<Double> confidence

Match confidence score

Optional<Double> distance

Total matched distance in meters

Optional<Double> duration

Estimated duration in seconds

Type type
Optional<List<Leg>> legs

Matched route legs between consecutive trace points