Quick Start

With the Map Matching service you can assign GPS positions to road segments on a digital map.

Using the Map Matching API is simple. Follow the steps on this page to get started with position matching.

API Endpoint

To send a position matching request you need to use the following API Endpoint


To match a single position near Dudelange, Luxemburg to a road use the latitude and longitude of the position in the request path.

You can test this by entering the URL into your web browser (be sure to replace YOUR_API_KEY with your actual API key).


Alternatively you can choose one of the following options to send your request. You also have the option to send the API key in the request header.

curl --location --request GET "https://api.myptv.com/mapmatch/v1/positions/49.480301/6.110667" --header "ApiKey: YOUR_API_KEY"

$headers = New-Object "System.Collections.Generic.Dictionary[[String],[String]]"
$headers.Add("ApiKey", "YOUR_API_KEY")
$response = Invoke-RestMethod "https://api.myptv.com/mapmatch/v1/positions/49.480301/6.110667" -Method GET -Headers $headers
$response | ConvertTo-Json

Get your free API Access Key


The call results in a detailed description of the match including the exact match coordinates (latitude/longitude) on the road segment.

  "latitude": 49.480319165,
  "longitude": 6.1104342698,
  "matchDistance": 17,
  "angleDifference": 3.16