com.graphhopper.matching

Class State

java.lang.Object

com.graphhopper.matching.State

public class State
extends Object

During map matching this represents a map matching candidate, i.e. a potential snapped point of a GPX entry. After map matching, this represents the map matched point of an GPX entry.

A Observation can either be at an undirected real (tower) node or at a directed virtual node. If this is at a directed virtual node then incoming paths from any previous State should arrive through getIncomingVirtualEdge() and outgoing paths to any following State should start with getOutgoingVirtualEdge(). This is achieved by penalizing other edges for routing. Note that virtual nodes are always connected to their adjacent nodes via 2 virtual edges (not counting reverse virtual edges).

Author:

Peter Karich, kodonnell, Stefan Holder

Constructor Summary

Constructors

Constructor and Description
State(Observation entry, com.graphhopper.storage.index.QueryResult queryResult) Creates an undirected candidate for a real node.
State(Observation entry, com.graphhopper.storage.index.QueryResult queryResult, com.graphhopper.routing.querygraph.VirtualEdgeIteratorState incomingVirtualEdge, com.graphhopper.routing.querygraph.VirtualEdgeIteratorState outgoingVirtualEdge) Creates a directed candidate for a virtual node.

Method Summary

Modifier and Type	Method and Description
Observation	getEntry()
com.graphhopper.util.EdgeIteratorState	getIncomingVirtualEdge() Returns the virtual edge that should be used by incoming paths.
com.graphhopper.util.EdgeIteratorState	getOutgoingVirtualEdge() Returns the virtual edge that should be used by outgoing paths.
com.graphhopper.storage.index.QueryResult	getQueryResult()
boolean	isOnDirectedEdge() Returns whether this State is directed.
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

State

public State(Observation entry,
             com.graphhopper.storage.index.QueryResult queryResult)

Creates an undirected candidate for a real node.

State

public State(Observation entry,
             com.graphhopper.storage.index.QueryResult queryResult,
             com.graphhopper.routing.querygraph.VirtualEdgeIteratorState incomingVirtualEdge,
             com.graphhopper.routing.querygraph.VirtualEdgeIteratorState outgoingVirtualEdge)

Creates a directed candidate for a virtual node.

Method Detail

getEntry

public Observation getEntry()

getQueryResult

public com.graphhopper.storage.index.QueryResult getQueryResult()

isOnDirectedEdge

public boolean isOnDirectedEdge()

Returns whether this State is directed. This is true if the snapped point is a virtual node, otherwise the snapped node is a real (tower) node and false is returned.

getIncomingVirtualEdge

public com.graphhopper.util.EdgeIteratorState getIncomingVirtualEdge()

Returns the virtual edge that should be used by incoming paths.

Throws:

IllegalStateException - if this State is not directed.

getOutgoingVirtualEdge

public com.graphhopper.util.EdgeIteratorState getOutgoingVirtualEdge()

Returns the virtual edge that should be used by outgoing paths.

Throws:

IllegalStateException - if this State is not directed.

toString

public String toString()

Overrides:

toString in class Object