## Match GPS coordinates to the road network

`MapMatchResult MapMatch.Match(MapMatchMatchParamsparameters, CancellationTokencancellationToken = default)`

**post** `/api/v1/map-match`

Match GPS coordinates to the road network

### Parameters

- `MapMatchMatchParams parameters`

  - `required GeoJsonGeometry trace`

    GPS trace (GeoJSON LineString geometry)

  - `IReadOnlyList<Double>? radiuses`

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

### Returns

- `class MapMatchResult:`

  Map matching result with snapped geometry

  - `required GeoJsonGeometry Geometry`

    - `required Coordinates Coordinates`

      GeoJSON coordinates array (nesting depth varies by geometry type)

      - `IReadOnlyList<Double>`

      - `IReadOnlyList<IReadOnlyList<Double>>`

      - `IReadOnlyList<IReadOnlyList<IReadOnlyList<Double>>>`

      - `IReadOnlyList<IReadOnlyList<IReadOnlyList<IReadOnlyList<Double>>>>`

    - `required Type Type`

      - `"Point"Point`

      - `"LineString"LineString`

      - `"Polygon"Polygon`

      - `"MultiPoint"MultiPoint`

      - `"MultiLineString"MultiLineString`

      - `"MultiPolygon"MultiPolygon`

  - `required Properties Properties`

    - `Double Confidence`

      Match confidence score

    - `Double Distance`

      Total matched distance in meters

    - `Double Duration`

      Estimated duration in seconds

  - `required Type Type`

    - `"Feature"Feature`

  - `IReadOnlyList<IReadOnlyDictionary<string, JsonElement>> Legs`

    Matched route legs between consecutive trace points

### Example

```csharp
MapMatchMatchParams parameters = new()
{
    Trace = new()
    {
        Coordinates = new(

            [
                0
            ]
        ),
        Type = Type.Point,
    },
};

var mapMatchResult = await client.MapMatch.Match(parameters);

Console.WriteLine(mapMatchResult);
```