SPL File OSMPointMapMatcher.spl

Content

Operators
  • OSMPointMatcher: The OSMPointMapMatcher composite analyzes time based object location data to heuristically project points on a network of roads specified by an OpenStreetMaps XML map file.

Composites

composite OSMPointMatcher(output Out0; input In0)

SPL composite operator image not displayed. Problem loading file: ../../image/tk$com.teracloud.streams.geospatial/op$com.teracloud.streams.geospatial$OSMPointMatcher.svg

The OSMPointMapMatcher composite analyzes time based object location data to heuristically project points on a network of roads specified by an OpenStreetMaps XML map file. For each point, the mapped point is the best approximation of where on the path network the entity is likely to be, provided some constraints.This operator takes as input a set of locations reported by a moving object, perhaps through a GPS device. The information on known paths in the path network must be provided as input. This takes the form of a set of points or nodes and the paths (edges) between them.

Parameters

  • mapfile: This parameter specifies the path to the OpenStreetMaps XML file (.osm file) corresponding to the road network to be used. Currently only roads are processed, and other Ways are ignored.
  • historySize: This parameter indicates the number of previous tuples to to use for each reported match. This is an aid in matching the object's position to the correct path based on its previously reported locations. This parameter must be specified at compile or submission time. The minimum/default value is 1.
  • distanceThreshold: This parameter dictates the distance threshold for matching. A coordinate is considered for matching only when its distance to the nearest path segment is less than this threshold. This parameter must be specified at compile or submission time. The value must be greater than zero.
  • velocityThreshold: This parameter indicates the velocity threshold for matching, in meters per second. A coordinate is considered for matching only when the object's current velocity (measured with respect to previous point) is less than this threshold. This parameter must be specified at compile or submission time. The value must be greater than zero.
  • matchingTimeCutoff: This parameter indicates the maximum allowed time difference between two successive coordinates, in milliseconds. If the time delta is greater than this threshold, the previous history will be cleared. The value must be greather than zero.

Input Ports

  • In0: input data stream

Output Ports

  • Out0: output data stream