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.
To send a position matching request you need to use the following API Endpoint
https://api.myptv.com/mapmatch/v1/positions
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).
https://api.myptv.com/mapmatch/v1/positions/49.480301/6.110667?apiKey=YOUR_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
Response
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
}