com.bmwcarit.barefoot.matcher

Class MatcherServer

java.lang.Object

com.bmwcarit.barefoot.util.AbstractServer

com.bmwcarit.barefoot.matcher.MatcherServer

public class MatcherServer
extends AbstractServer

Matcher server (stand-alone) for Hidden Markov Model offline map matching. It is a AbstractServer that performs map matching; and is configurable with a properties file. It can be customized to use arbitrary input and output formats by inheriting and customizing MatcherServer.InputFormatter and MatcherServer.OutputFormatter classes.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	MatcherServer.DebugJSONOutputFormatter Output formatter for writing extensive format of input and output of map matching in a JSON response message.
static class	MatcherServer.GeoJSONOutputFormatter Output formatter for writing the geometries of a map matched paths into GeoJSON response message.
static class	MatcherServer.InputFormatter Default input formatter for reading a JSON array of MatcherSample objects as input for map matching.
static class	MatcherServer.OutputFormatter Default output formatter for writing the JSON representation of a KState object with map matching of the input into a response message.
static class	MatcherServer.SlimJSONOutputFormatter Output formatter for writing map matched positions, represented be road id and fraction, and the geometry of the routes into a JSON response message.

Nested classes/interfaces inherited from class com.bmwcarit.barefoot.util.AbstractServer

AbstractServer.ResponseFactory, AbstractServer.ResponseHandler, AbstractServer.RESULT

Constructor Summary

Constructors

Constructor and Description
MatcherServer(Properties properties, RoadMap map, MatcherServer.InputFormatter input, MatcherServer.OutputFormatter output) Creates a MatcherServer object as stand-alone offline map matching server.

Method Summary

Modifier and Type	Method and Description
RoadMap	getMap() Gets RoadMap object of the server.

Methods inherited from class com.bmwcarit.barefoot.util.AbstractServer

getMaxConnectionCount, getMaxRequestTime, getMaxResponseTime, getPortNumber, getResponseFactory, runServer, stopServer

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MatcherServer

public MatcherServer(Properties properties,
                     RoadMap map,
                     MatcherServer.InputFormatter input,
                     MatcherServer.OutputFormatter output)

Creates a MatcherServer object as stand-alone offline map matching server. The provided Properties object may provide the following properties:

• server properties: see AbstractServer.AbstractServer(Properties, ResponseFactory)
• matcher.radius.max (see Matcher.setMaxRadius(double))
• matcher.distance.max (see Matcher.setMaxDistance(double))
• matcher.lambda (see Matcher.setLambda(double))
• matcher.sigma (see Matcher.setSigma(double))
• matcher.interval.min (milliseconds, optional, default: 1000, sets a minimum time interval of samples to ignore samples that are below minimum interval to reduce workload if data is extremely high sampled)
• matcher.distance.min (meters, optional, default: 0, sets minimum distance of samples to ignore samples that are below minimum distance to avoid workload if object is moving too little)

Parameters:

properties - Properties object with (optional) server and matcher settings.

map - RoadMap object with the map to be matched with.

input - MatcherServer.InputFormatter object for input formatting.

output - MatcherServer.OutputFormatter object for output formatting.

Method Detail

getMap

public RoadMap getMap()

Gets RoadMap object of the server.

Returns:

RoadMap object of the server.