## Assisted-MapMatching
Matching Tab

This plugin adjusts a GPS track on a street network (map-matching) semi-automatically.
Please read the plugin documentation before using it.

### Short description of the map-matching process

The map-matching process has 3 steps.

### Step 1: Data preparation

This step prepares the data for the map-matching process. It corrects the topology of the street network and verifies the validity of the input.
The required fields are:

#### The network layer

Select the layer to use to adjust the GPS track. The list is composed of every active layers of type LineString.
The type MultilineString isn't supported. You can convert a MultiLineString layer to a LineString using the tool "Multipart to SingleParts".

#### The GPS track layer

Select the point layerto match on the network. The list shows every active layers of type Point.

#### The point identifier field

Select an unique indentifier for every points giving the order of the features. The list shows every attributes of type "Integer/Integer64/int/int8" present in the selected point layer.

#### Buffer range:

Enter the range of the buffer that will be created around every points. Every line intersecting this buffer will be considered for map-matching. A bigger value implies a longer computing time

### Step 2: MapMatching

This step matches the points of the GPS track on the street network. After the first iteration, the user can modify the selected lines and match the points again.
Two fields can be specified:

#### The speed field

Select the attribute representing the speed of every points. The list shows every attribute of type "Integer/Integer64/int/int8" present in the selected point layer. This field is only necessary to use the matching method "by speed".

#### The Matching algorithm list

Select the type of matching to use. Three options are available.

- By speed: Taking into account the speed, the GPS track is cut into moving or stopped sections. Every point of a stopped section are merged at their average location and snapped to their closest line on the network. The moving sections are then adjusted between the sections of stopped points. Check the documentation for more details.
- By distance: This method adjusts the points along the path by calculating the ratio between the length of the original track (in between each point), and the selected path (selected lines). This ratio is then applied to the original points to project them along the selected lines to preserve the "natural" distance between two points
- To closest: This method simply projects every point to its closest line on the selected path.

### # Step 3: Export

In this step, the results are exported in the selected format. You can also do it manually from QGIS
Three options are available:

#### Export matched trace

Select the matched track present in the adjacent dropDown list to export.

#### Export the polyline

Check to export the polyline representing the selected path.

#### Export project

Check to export every elements selected in the settings inside a single file.