How to Match GPS Tracks Selecting Additional Parameters

This example illuminates how to obtain the complete result list including polylines for visualization and considering the result list options which have to be enabled according to the API. Please notice that the basic elements are described in the code sample: How to match GPS tracks in principle.

PTV recommends that the deprecated methods are replaced by using matchPositions for future development tasks. The enhancement of attributes is simply applicable without violating the downwards compatibility.

Create object ResultListOptions

Define the following attributes to be enabled:

• speedClass: returns the value of the speed class per segment.
• polyline: returns the corresponding points to be rendered on the PTV maps.
• vendorID: returns the unique identification consisting of provider ID, the digitalization direction and the country code.

Java

Generate class details and enable the existing parameters to be added in the result list.

ResultListOptions details = new ResultListOptions();
details.setPolyline(true);
details.setSpeedClass(true);
details.setVendorId(true);

C#

Generate class details and enable the existing parameters to be added in the result list.

ResultListOptions details = new ResultListOptions();
details.polyline = true;
details.polylineSpecified = true;
details.speedClass = true;
details.speedClassSpecified = true;
details.vendorId = true;
details.vendorIdSpecified = true;

Call matchPositions

The method contains two mandatory arguments as follows:

• trackPositions: Lists the input position of a GPS track.
• details: Enables the additional information which will listed in the class MatchResult.

Java

Call method.

matchPositions = client.matchPositions(trackPositions, details);

C#

Call method.

MatchResult matchPositions = client.matchPositions(trackPositions, details, cxt);

Output

The match result contains the above named properties in addition. Visualize the polyline and list the detailed information in a corresponding table.

Java

List the details.

for (MatchedSegment matchedSegment : matchedLocation.getPath()) {
  rows[index][1] = matchedSegment.getTileId();
  rows[index][2] = matchedSegment.getCountryCode();
  rows[index][3] = matchedSegment.getNetworkClass();
  rows[index][4] = matchedSegment.getSpeedClass();
  rows[index][5] = matchedSegment.getVendorId();
  ...
}

C#

List the details.

MapMatchTableEntry row = new MapMatchTableEntry 
{
  inputID = matchedLocation.inputId,
  tileID = matchedSegment.tileId,
  IU = matchedSegment.countryCode,
  NC = matchedSegment.networkClass,
  SC = matchedSegment.speedClass,
  vendorID = matchedSegment.vendorId,
  startXYN = startXYN,
  endXYN = endXYN
};
MapMatchingTable.Add(row);

Plot Results

The matched segments are displayed by the corresponding polyline.

The following table exemplarily illustrates the relevant attributes including the already mentioned details: speed class and vendorID.

Copyright © 2024 PTV Logistics GmbH All rights reserved. | Imprint