matcher

Map matching is the process of mapping noisy GPS points to correct road segments.

matcher is the WherobotsDB module that performs map matching for GPS points.

load_osm(osm_path, tags_filter='')

Function loads an OSM xml file and retrieves all the edges and locations of the corresponding nodes.

Parameters:

Name	Type	Description	Default
osm_path	str	A string that represents path to the OSM xml file	required
tags_filter	str	A string denoting the tags to be used for filtering the OSM data	''

Returns:

Type	Description
DataFrame	A DataFrame object containing all the edges information required for map matching

match(edges_df, paths_df, edges_geometry, paths_geometry, id=None)

Function performs map matching for a GPS path.

Parameters:

Name	Type	Description	Default
edges_df	DataFrame	DataFrame object that contains all edges in the target dataset	required
paths_df	DataFrame	DataFrame object that contains all GPS trips for which map matching need to be performed	required
edges_geometry	str	Name of the geometry column in the edgesDf DataFrame	required
paths_geometry	str	Name of the geometry column in the pathsDf DataFrame	required
id	str	Optional - Name of the column in the pathsDf DataFrame that contains the unique identifier for each GPS trip. if not provided, the first non-geometry column is used.	None

Returns:

Type	Description
DataFrame	A DataFrame object containing the results of map matching