com.graphhopper.util

Interface EdgeIteratorState

All Known Subinterfaces:

AllCHEdgesIterator, AllEdgesIterator, CHEdgeIterator, CHEdgeIteratorState, EdgeIterator

All Known Implementing Classes:

GHUtility.DisabledEdgeIterator, VirtualEdgeIteratorState

public interface EdgeIteratorState

This interface represents an edge and is one possible state of an EdgeIterator. Example: EdgeExplorer expl = graph.createEdgeExplorer(); EdgeIterator iter = expl.setBaseNode(baseNode); while(iter.next()) { iter.getBaseBase() // equals to the specified baseNode }

Author:

Peter Karich

See Also:

EdgeIterator, EdgeExplorer

Field Summary

Fields

Modifier and Type	Field and Description
static BooleanEncodedValue	REVERSE_STATE This method can be used to fetch the internal reverse state of an edge.
static BooleanEncodedValue	UNFAVORED_EDGE

Method Summary

Modifier and Type	Method and Description
EdgeIteratorState	copyPropertiesFrom(EdgeIteratorState e) Copies the properties of the specified edge into this edge.
EdgeIteratorState	detach(boolean reverse) Clones this EdgeIteratorState.
PointList	fetchWayGeometry(FetchMode mode) For road network data like OSM a way is often not just a straight line.
boolean	get(BooleanEncodedValue property)
double	get(DecimalEncodedValue property)
<T extends Enum> T	get(EnumEncodedValue<T> property)
int	get(IntEncodedValue property)
int	getAdjNode()
int	getBaseNode() Returns the node used to instantiate the EdgeIterator.
double	getDistance()
int	getEdge()
IntsRef	getFlags() Returns edge properties stored in direction of the raw database layout.
String	getName()
int	getOrigEdgeFirst()
int	getOrigEdgeLast()
boolean	getReverse(BooleanEncodedValue property)
double	getReverse(DecimalEncodedValue property)
<T extends Enum> T	getReverse(EnumEncodedValue<T> property)
int	getReverse(IntEncodedValue property)
EdgeIteratorState	set(BooleanEncodedValue property, boolean value)
EdgeIteratorState	set(DecimalEncodedValue property, double value)
<T extends Enum> EdgeIteratorState	set(EnumEncodedValue<T> property, T value)
EdgeIteratorState	set(IntEncodedValue property, int value)
EdgeIteratorState	setDistance(double dist)
EdgeIteratorState	setFlags(IntsRef edgeFlags) Stores the specified edgeFlags down to the DataAccess
EdgeIteratorState	setName(String name)
EdgeIteratorState	setReverse(BooleanEncodedValue property, boolean value)
EdgeIteratorState	setReverse(DecimalEncodedValue property, double value)
<T extends Enum> EdgeIteratorState	setReverse(EnumEncodedValue<T> property, T value)
EdgeIteratorState	setReverse(IntEncodedValue property, int value)
EdgeIteratorState	setWayGeometry(PointList list)

Field Detail

UNFAVORED_EDGE

static final BooleanEncodedValue UNFAVORED_EDGE

REVERSE_STATE

static final BooleanEncodedValue REVERSE_STATE

This method can be used to fetch the internal reverse state of an edge.

Method Detail

getEdge

int getEdge()

Returns:

the edge id of the current edge. Do not make any assumptions about the concrete values, except that for an implementation it is recommended that they'll be contiguous.

getOrigEdgeFirst

int getOrigEdgeFirst()

Returns:

the edge id of the first original edge of the current edge. This is needed for shortcuts in edge-based contraction hierarchies and otherwise simply returns the id of the current edge.

getOrigEdgeLast

int getOrigEdgeLast()

See Also:

getOrigEdgeFirst()

getBaseNode

int getBaseNode()

Returns the node used to instantiate the EdgeIterator. Often only used for convenience reasons. Do not confuse this with a source node of a directed edge.

Returns:

the requested node itself

See Also:

EdgeIterator

getAdjNode

int getAdjNode()

Returns:

the adjacent node of baseNode for the current edge.

See Also:

EdgeIterator

fetchWayGeometry

PointList fetchWayGeometry(FetchMode mode)

For road network data like OSM a way is often not just a straight line. The nodes between the junction nodes are called pillar nodes. The junction nodes are called tower nodes and used for routing. The pillar nodes are necessary to have an exact geometry. See the docs for more information (docs/core/low-level-api.md#what-are-pillar-and-tower-nodes). Updates to the returned list are not reflected in the graph, for that you've to use setWayGeometry.

Parameters:

mode - FetchMode

Returns:

the pillar and/or tower nodes depending on the mode.

setWayGeometry

EdgeIteratorState setWayGeometry(PointList list)

Parameters:

list - is a sorted collection of coordinates between the base node and the current adjacent node. Specify the list without the adjacent and base node. This method can be called multiple times, but if the distance changes, the setDistance method is not called automatically.

getDistance

double getDistance()

Returns:

the distance of the current edge in meter

setDistance

EdgeIteratorState setDistance(double dist)

getFlags

IntsRef getFlags()

Returns edge properties stored in direction of the raw database layout. So do not use it directly, instead use the appropriate set/get methods with its EncodedValue object.

setFlags

EdgeIteratorState setFlags(IntsRef edgeFlags)

Stores the specified edgeFlags down to the DataAccess

get

boolean get(BooleanEncodedValue property)

set

EdgeIteratorState set(BooleanEncodedValue property,
                      boolean value)

getReverse

boolean getReverse(BooleanEncodedValue property)

setReverse

EdgeIteratorState setReverse(BooleanEncodedValue property,
                             boolean value)

get

int get(IntEncodedValue property)

set

EdgeIteratorState set(IntEncodedValue property,
                      int value)

getReverse

int getReverse(IntEncodedValue property)

setReverse

EdgeIteratorState setReverse(IntEncodedValue property,
                             int value)

get

double get(DecimalEncodedValue property)

set

EdgeIteratorState set(DecimalEncodedValue property,
                      double value)

getReverse

double getReverse(DecimalEncodedValue property)

setReverse

EdgeIteratorState setReverse(DecimalEncodedValue property,
                             double value)

get

<T extends Enum> T get(EnumEncodedValue<T> property)

set

<T extends Enum> EdgeIteratorState set(EnumEncodedValue<T> property,
                                       T value)

getReverse

<T extends Enum> T getReverse(EnumEncodedValue<T> property)

setReverse

<T extends Enum> EdgeIteratorState setReverse(EnumEncodedValue<T> property,
                                              T value)

getName

String getName()

setName

EdgeIteratorState setName(String name)

detach

EdgeIteratorState detach(boolean reverse)

Clones this EdgeIteratorState.

Parameters:

reverse - if true a detached edgeState with reversed properties is created where base and adjacent nodes, flags and wayGeometry are in reversed order. See #162 for more details about why we need the reverse parameter.

copyPropertiesFrom

EdgeIteratorState copyPropertiesFrom(EdgeIteratorState e)

Copies the properties of the specified edge into this edge. Does not change nodes!

Returns:

the specified edge e