com.graphhopper.routing.util

Class AbstractFlagEncoder

java.lang.Object

com.graphhopper.routing.util.AbstractFlagEncoder

All Implemented Interfaces:

EncodedValueLookup, FlagEncoder

Direct Known Subclasses:

BikeCommonFlagEncoder, CarFlagEncoder, FootFlagEncoder

public abstract class AbstractFlagEncoder
extends Object
implements FlagEncoder

Abstract class which handles flag decoding and encoding. Every encoder should be registered to a EncodingManager to be usable. If you want the full long to be stored you need to enable this in the GraphHopperStorage.

Author:

Peter Karich, Nop

See Also:

EncodingManager

Field Summary

Fields

Modifier and Type	Field and Description
protected Set<String>	absoluteBarriers
protected BooleanEncodedValue	accessEnc
protected DecimalEncodedValue	avgSpeedEnc
protected EncodedValueLookup	encodedValueLookup
protected Set<String>	ferries
protected Set<String>	intendedValues
protected static double	LONG_TRIP_FERRY_SPEED
protected int	maxPossibleSpeed
protected Set<String>	oneways
protected Set<String>	potentialBarriers
protected Set<String>	restrictedValues
protected List<String>	restrictions
protected BooleanEncodedValue	roundaboutEnc
protected static double	SHORT_TRIP_FERRY_SPEED
protected int	speedBits
protected double	speedDefault
protected double	speedFactor
protected static double	UNKNOWN_DURATION_FERRY_SPEED

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractFlagEncoder(int speedBits, double speedFactor, int maxTurnCosts)

Method Summary

Modifier and Type	Method and Description
protected double	applyMaxSpeed(ReaderWay way, double speed)
void	applyWayTags(ReaderWay way, EdgeIteratorState edge) Second parsing step.
protected void	blockBarriersByDefault(boolean blockByDefault) Should potential barriers block when no access limits are given?
protected void	blockFords(boolean blockFords)
protected void	blockPrivate(boolean blockPrivate)
void	createEncodedValues(List<EncodedValue> registerNewEncodedValue, String prefix, int index) Defines bits used for edge flags used for access, speed etc.
int	defineNodeBits(int index, int shift) Defines the bits for the node flags, which are currently used for barriers only.
boolean	equals(Object obj)
protected void	flagsDefault(IntsRef edgeFlags, boolean forward, boolean backward) Sets default flags with specified access.
abstract EncodingManager.Access	getAccess(ReaderWay way) Decide whether a way is routable for a given mode of travel.
BooleanEncodedValue	getAccessEnc() This method returns the EncodedValue used for the direction-dependent access properties of this encoder.
List<EncodedValue>	getAllShared()
DecimalEncodedValue	getAverageSpeedEnc() This method returns the EncodedValue used for the average speed of this encoder.
BooleanEncodedValue	getBooleanEncodedValue(String key)
ConditionalTagInspector	getConditionalTagInspector()
DecimalEncodedValue	getDecimalEncodedValue(String key)
<T extends EncodedValue> T	getEncodedValue(String key, Class<T> encodedValueType)
<T extends Enum> EnumEncodedValue<T>	getEnumEncodedValue(String key, Class<T> enumType)
protected double	getFerrySpeed(ReaderWay way) Special handling for ferry ways.
IntEncodedValue	getIntEncodedValue(String key)
double	getMaxSpeed()
protected double	getMaxSpeed(ReaderWay way)
int	getMaxTurnCosts()
protected String	getPropertiesString()
long	handleNodeTags(ReaderNode node) Parse tags on nodes.
abstract IntsRef	handleWayTags(IntsRef edgeFlags, ReaderWay way, EncodingManager.Access access) Analyze properties of a way and create the edge flags.
boolean	hasEncodedValue(String key)
int	hashCode()
protected void	init(DateRangeParser dateRangeParser)
boolean	isBlockFords()
boolean	isRegistered()
static double	parseSpeed(String str)
protected void	setConditionalTagInspector(ConditionalTagInspector inspector)
void	setEncodedValueLookup(EncodedValueLookup encodedValueLookup)
protected void	setSpeed(boolean reverse, IntsRef edgeFlags, double speed) Most use cases do not require this method.
boolean	supports(Class<?> feature) Returns true if the feature class is supported like TurnWeighting or PriorityWeighting.
boolean	supportsTurnCosts()

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.graphhopper.routing.util.FlagEncoder

getTransportationMode, getVersion

Field Detail

restrictions

protected final List<String> restrictions

intendedValues

protected final Set<String> intendedValues

restrictedValues

protected final Set<String> restrictedValues

ferries

protected final Set<String> ferries

oneways

protected final Set<String> oneways

absoluteBarriers

protected final Set<String> absoluteBarriers

potentialBarriers

protected final Set<String> potentialBarriers

speedBits

protected final int speedBits

speedFactor

protected final double speedFactor

speedDefault

protected double speedDefault

accessEnc

protected BooleanEncodedValue accessEnc

roundaboutEnc

protected BooleanEncodedValue roundaboutEnc

avgSpeedEnc

protected DecimalEncodedValue avgSpeedEnc

maxPossibleSpeed

protected int maxPossibleSpeed

encodedValueLookup

protected EncodedValueLookup encodedValueLookup

UNKNOWN_DURATION_FERRY_SPEED

protected static final double UNKNOWN_DURATION_FERRY_SPEED

See Also:

Constant Field Values

SHORT_TRIP_FERRY_SPEED

protected static final double SHORT_TRIP_FERRY_SPEED

See Also:

Constant Field Values

LONG_TRIP_FERRY_SPEED

protected static final double LONG_TRIP_FERRY_SPEED

See Also:

Constant Field Values

Constructor Detail

AbstractFlagEncoder

protected AbstractFlagEncoder(int speedBits,
                              double speedFactor,
                              int maxTurnCosts)

Parameters:

speedBits - specify the number of bits used for speed

speedFactor - specify the factor to multiple the stored value (can be used to increase or decrease accuracy of speed value)

maxTurnCosts - specify the maximum value used for turn costs, if this value is reached a turn is forbidden and results in costs of positive infinity.

Method Detail

init

protected void init(DateRangeParser dateRangeParser)

setConditionalTagInspector

protected void setConditionalTagInspector(ConditionalTagInspector inspector)

isRegistered

public boolean isRegistered()

Specified by:

isRegistered in interface FlagEncoder

Returns:

true if already registered in an EncodingManager

blockBarriersByDefault

protected void blockBarriersByDefault(boolean blockByDefault)

Should potential barriers block when no access limits are given?

isBlockFords

public boolean isBlockFords()

blockFords

protected void blockFords(boolean blockFords)

blockPrivate

protected void blockPrivate(boolean blockPrivate)

getConditionalTagInspector

public ConditionalTagInspector getConditionalTagInspector()

defineNodeBits

public int defineNodeBits(int index,
                          int shift)

Defines the bits for the node flags, which are currently used for barriers only.

Returns:

incremented shift value pointing behind the last used bit

createEncodedValues

public void createEncodedValues(List<EncodedValue> registerNewEncodedValue,
                                String prefix,
                                int index)

Defines bits used for edge flags used for access, speed etc.

handleWayTags

public abstract IntsRef handleWayTags(IntsRef edgeFlags,
                                      ReaderWay way,
                                      EncodingManager.Access access)

Analyze properties of a way and create the edge flags. This method is called in the second parsing step.

getMaxTurnCosts

public int getMaxTurnCosts()

getAccess

public abstract EncodingManager.Access getAccess(ReaderWay way)

Decide whether a way is routable for a given mode of travel. This skips some ways before handleWayTags is called.

Returns:

the encoded value to indicate if this encoder allows travel or not.

handleNodeTags

public long handleNodeTags(ReaderNode node)

Parse tags on nodes. Node tags can add to speed (like traffic_signals) where the value is strict negative or blocks access (like a barrier), then the value is strictly positive. This method is called in the second parsing step.

Returns:

encoded values or 0 if not blocking or no value stored

flagsDefault

protected void flagsDefault(IntsRef edgeFlags,
                            boolean forward,
                            boolean backward)

Sets default flags with specified access.

getMaxSpeed

public double getMaxSpeed()

Specified by:

getMaxSpeed in interface FlagEncoder

Returns:

the maximum speed in km/h

getMaxSpeed

protected double getMaxSpeed(ReaderWay way)

Returns:

-1 if no maxspeed found

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

parseSpeed

public static double parseSpeed(String str)

Returns:

the speed in km/h

applyWayTags

public void applyWayTags(ReaderWay way,
                         EdgeIteratorState edge)

Second parsing step. Invoked after splitting the edges. Currently used to offer a hook to calculate precise speed values based on elevation data stored in the specified edge.

getFerrySpeed

protected double getFerrySpeed(ReaderWay way)

Special handling for ferry ways.

getAverageSpeedEnc

public final DecimalEncodedValue getAverageSpeedEnc()

Description copied from interface: FlagEncoder

This method returns the EncodedValue used for the average speed of this encoder.

Specified by:

getAverageSpeedEnc in interface FlagEncoder

getAccessEnc

public final BooleanEncodedValue getAccessEnc()

Description copied from interface: FlagEncoder

This method returns the EncodedValue used for the direction-dependent access properties of this encoder.

Specified by:

getAccessEnc in interface FlagEncoder

setSpeed

protected void setSpeed(boolean reverse,
                        IntsRef edgeFlags,
                        double speed)

Most use cases do not require this method. Will still keep it accessible so that one can disable it until the averageSpeedEncodedValue is moved out of the FlagEncoder.

applyMaxSpeed

protected double applyMaxSpeed(ReaderWay way,
                               double speed)

Parameters:

way - needed to retrieve tags

speed - speed guessed e.g. from the road type or other tags

Returns:

The assumed speed.

getPropertiesString

protected String getPropertiesString()

getAllShared

public List<EncodedValue> getAllShared()

Specified by:

getAllShared in interface EncodedValueLookup

getEncodedValue

public <T extends EncodedValue> T getEncodedValue(String key,
                                                  Class<T> encodedValueType)

Specified by:

getEncodedValue in interface EncodedValueLookup

getBooleanEncodedValue

public BooleanEncodedValue getBooleanEncodedValue(String key)

Specified by:

getBooleanEncodedValue in interface EncodedValueLookup

getIntEncodedValue

public IntEncodedValue getIntEncodedValue(String key)

Specified by:

getIntEncodedValue in interface EncodedValueLookup

getDecimalEncodedValue

public DecimalEncodedValue getDecimalEncodedValue(String key)

Specified by:

getDecimalEncodedValue in interface EncodedValueLookup

getEnumEncodedValue

public <T extends Enum> EnumEncodedValue<T> getEnumEncodedValue(String key,
                                                                Class<T> enumType)

Specified by:

getEnumEncodedValue in interface EncodedValueLookup

setEncodedValueLookup

public void setEncodedValueLookup(EncodedValueLookup encodedValueLookup)

supportsTurnCosts

public boolean supportsTurnCosts()

Specified by:

supportsTurnCosts in interface FlagEncoder

supports

public boolean supports(Class<?> feature)

Description copied from interface: FlagEncoder

Returns true if the feature class is supported like TurnWeighting or PriorityWeighting. Use support(String) instead.

Specified by:

supports in interface FlagEncoder

hasEncodedValue

public boolean hasEncodedValue(String key)

Specified by:

hasEncodedValue in interface EncodedValueLookup