GraphHopper (GraphHopper Core client_hc_no

java.lang.Object
- com.graphhopper.GraphHopper

All Implemented Interfaces:

GraphHopperAPI
```
public class GraphHopper
extends Object
implements GraphHopperAPI
```
Easy to use access point to configure import and (offline) routing.

Author:

Peter Karich

See Also:

GraphHopperAPI

Constructor Summary

Constructors
Constructor and Description

GraphHopper()

GraphHopper(JsonFeatureCollection landmarkSplittingFeatureCollection)

Constructors
Constructor and Description
`GraphHopper()`
`GraphHopper(JsonFeatureCollection landmarkSplittingFeatureCollection)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`protected File`	`_getOSMFile()` Currently we use this for a few tests where the dataReaderFile is loaded from the classpath
`void`	`clean()` Removes the on-disc routing files.
`protected void`	`cleanUp()` Internal method to clean up the graph.
`void`	`close()` Releases all associated resources like memory or files.
`protected LocationIndex`	`createLocationIndex(Directory dir)`
`Weighting`	`createWeighting(Profile profile, PMap hints)`
`Weighting`	`createWeighting(Profile profile, PMap hints, boolean disableTurnCosts)`
`protected WeightingFactory`	`createWeightingFactory()`
`protected void`	`ensureNotLoaded()`
`protected void`	`ensureWriteAccess()`
`protected void`	`flush()`
`CHPreparationHandler`	`getCHPreparationHandler()`
`ElevationProvider`	`getElevationProvider()`
`EncodedValueFactory`	`getEncodedValueFactory()`
`EncodingManager`	`getEncodingManager()`
`boolean`	`getFullyLoaded()`
`String`	`getGraphHopperLocation()`
`GraphHopperStorage`	`getGraphHopperStorage()` The underlying graph used in algorithms.
`LMPreparationHandler`	`getLMPreparationHandler()`
`LocationIndex`	`getLocationIndex()` The location index created from the graph.
`String`	`getOSMFile()`
`PathDetailsBuilderFactory`	`getPathDetailsBuilderFactory()`
`Profile`	`getProfile(String profileName)` Returns the profile for the given profile name, or null if it does not exist
`List<Profile>`	`getProfiles()`
`RouterConfig`	`getRouterConfig()`
`TagParserFactory`	`getTagParserFactory()`
`TranslationMap`	`getTranslationMap()`
`protected double`	`getWayPointMaxDistance()` Return maximum distance (in meter) to reduce points via douglas peucker while OSM import.
`protected int`	`getWorkerThreads()` Threads for data reading.
`boolean`	`hasElevation()`
`void`	`importAndClose()` Imports and processes data, storing it to disk when complete.
`GraphHopper`	`importOrLoad()` Imports provided data from disc and creates graph.
`protected void`	`importOSM()`
`protected void`	`importPublicTransit()`
`GraphHopper`	`init(GraphHopperConfig ghConfig)` Reads the configuration from a `GraphHopperConfig` object which can be manually filled, or more typically is read from `config.yml`.
`protected void`	`initLocationIndex()` Initializes the location index after the import is done.
`boolean`	`isAllowWrites()`
`boolean`	`load(String graphHopperFolder)` Opens existing graph folder.
`protected GraphHopper`	`loadGraph(GraphHopperStorage g)` For testing only
`protected void`	`loadOrPrepareLM(boolean closeEarly)` For landmarks it is required to always call this method: either it creates the landmark data or it loads it.
`void`	`postProcessing()` Does the preparation and creates the location index
`protected void`	`postProcessing(boolean closeEarly)` Does the preparation and creates the location index
`protected void`	`prepareCH(boolean closeEarly)`
`protected void`	`registerCustomEncodedValues(EncodingManager.Builder emBuilder)`
`GHResponse`	`route(GHRequest request)`
`GraphHopper`	`setAllowWrites(boolean allowWrites)` Specifies if it is allowed for GraphHopper to write.
`GraphHopper`	`setElevation(boolean includeElevation)` Enable storing and fetching elevation data.
`GraphHopper`	`setElevationProvider(ElevationProvider eleProvider)`
`GraphHopper`	`setElevationWayPointMaxDistance(double elevationWayPointMaxDistance)` Sets the max elevation discrepancy between way points and the simplified polyline in meters
`GraphHopper`	`setEncodedValueFactory(EncodedValueFactory factory)`
`GraphHopper`	`setEncodingManager(EncodingManager em)` Specify which vehicles can be read by this GraphHopper instance.
`GraphHopper`	`setFlagEncoderFactory(FlagEncoderFactory factory)`
`GraphHopper`	`setGraphHopperLocation(String ghLocation)` Sets the graphhopper folder.
`void`	`setGraphHopperStorage(GraphHopperStorage ghStorage)`
`protected void`	`setLocationIndex(LocationIndex locationIndex)`
`GraphHopper`	`setLongEdgeSamplingDistance(double longEdgeSamplingDistance)` Sets the distance distance between elevation samples on long edges
`GraphHopper`	`setMinNetworkSize(int minNetworkSize)`
`GraphHopper`	`setOSMFile(String osmFile)` This file can be an osm xml (.osm), a compressed xml (.osm.zip or .osm.gz) or a protobuf file (.pbf).
`GraphHopper`	`setPathDetailsBuilderFactory(PathDetailsBuilderFactory pathBuilderFactory)`
`GraphHopper`	`setPreciseIndexResolution(int precision)` Precise location resolution index means also more space (disc/RAM) could be consumed and probably slower query times, which would be e.g.
`GraphHopper`	`setProfiles(List<Profile> profiles)`
`GraphHopper`	`setProfiles(Profile... profiles)` Sets the routing profiles that shall be supported by this GraphHopper instance.
`GraphHopper`	`setSortGraph(boolean sortGraph)` Sorts the graph which requires more RAM while import.
`GraphHopper`	`setStoreOnFlush(boolean storeOnFlush)` Only valid option for in-memory graph and if you e.g.
`GraphHopper`	`setTagParserFactory(TagParserFactory factory)`
`GraphHopper`	`setWayPointMaxDistance(double wayPointMaxDistance)` This parameter specifies how to reduce points via douglas peucker while OSM import.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - GraphHopper
```
public GraphHopper()
```
  - GraphHopper
```
public GraphHopper(JsonFeatureCollection landmarkSplittingFeatureCollection)
```
- Method Detail
  - loadGraph
```
protected GraphHopper loadGraph(GraphHopperStorage g)
```
    For testing only
  - getEncodingManager
```
public EncodingManager getEncodingManager()
```
  - setEncodingManager
```
public GraphHopper setEncodingManager(EncodingManager em)
```
    Specify which vehicles can be read by this GraphHopper instance. An encoding manager defines how data from every vehicle is written (und read) into edges of the graph.
  - getElevationProvider
```
public ElevationProvider getElevationProvider()
```
  - setElevationProvider
```
public GraphHopper setElevationProvider(ElevationProvider eleProvider)
```
  - getWorkerThreads
```
protected int getWorkerThreads()
```
    Threads for data reading.
  - getWayPointMaxDistance
```
protected double getWayPointMaxDistance()
```
    Return maximum distance (in meter) to reduce points via douglas peucker while OSM import.
  - setWayPointMaxDistance
```
public GraphHopper setWayPointMaxDistance(double wayPointMaxDistance)
```
    This parameter specifies how to reduce points via douglas peucker while OSM import. Higher value means more details, unit is meter. Default is 1. Disable via 0.
  - setPathDetailsBuilderFactory
```
public GraphHopper setPathDetailsBuilderFactory(PathDetailsBuilderFactory pathBuilderFactory)
```
  - getPathDetailsBuilderFactory
```
public PathDetailsBuilderFactory getPathDetailsBuilderFactory()
```
  - setPreciseIndexResolution
```
public GraphHopper setPreciseIndexResolution(int precision)
```
    Precise location resolution index means also more space (disc/RAM) could be consumed and probably slower query times, which would be e.g. not suitable for Android. The resolution specifies the tile width (in meter).
  - setMinNetworkSize
```
public GraphHopper setMinNetworkSize(int minNetworkSize)
```
  - setStoreOnFlush
```
public GraphHopper setStoreOnFlush(boolean storeOnFlush)
```
    Only valid option for in-memory graph and if you e.g. want to disable store on flush for unit tests. Specify storeOnFlush to true if you want that existing data will be loaded FROM disc and all in-memory data will be flushed TO disc after flush is called e.g. while OSM import.
    
    Parameters:
    
    storeOnFlush - true by default
  - setProfiles
```
public GraphHopper setProfiles(Profile... profiles)
```
    Sets the routing profiles that shall be supported by this GraphHopper instance. The (and only the) given profiles can be used for routing without preparation and for CH/LM preparation.
    Here is an example how to setup two CH profiles and one LM profile (via the Java API)
```
 
   // make sure the encoding manager contains a "car" and a "bike" flag encoder
   hopper.setProfiles(
     new Profile("my_car").setVehicle("car").setWeighting("shortest"),
     new Profile("your_bike").setVehicle("bike").setWeighting("fastest")
   );
   hopper.getCHPreparationHandler().setCHProfiles(
     new CHProfile("my_car"),
     new CHProfile("your_bike")
   );
   hopper.getLMPreparationHandler().setLMProfiles(
     new LMProfile("your_bike")
   );
 
 
```
    See also https://github.com/graphhopper/graphhopper/pull/1922.
    See Also:
    
    CHPreparationHandler.setCHProfiles(com.graphhopper.config.CHProfile...), LMPreparationHandler.setLMProfiles(com.graphhopper.config.LMProfile...)
  - setProfiles
```
public GraphHopper setProfiles(List<Profile> profiles)
```
  - getProfiles
```
public List<Profile> getProfiles()
```
  - getProfile
```
public Profile getProfile(String profileName)
```
    Returns the profile for the given profile name, or null if it does not exist
  - hasElevation
```
public boolean hasElevation()
```
    Returns:
    
    true if storing and fetching elevation data is enabled. Default is false
  - setElevation
```
public GraphHopper setElevation(boolean includeElevation)
```
    Enable storing and fetching elevation data. Default is false
  - setLongEdgeSamplingDistance
```
public GraphHopper setLongEdgeSamplingDistance(double longEdgeSamplingDistance)
```
    Sets the distance distance between elevation samples on long edges
  - setElevationWayPointMaxDistance
```
public GraphHopper setElevationWayPointMaxDistance(double elevationWayPointMaxDistance)
```
    Sets the max elevation discrepancy between way points and the simplified polyline in meters
  - getGraphHopperLocation
```
public String getGraphHopperLocation()
```
  - setGraphHopperLocation
```
public GraphHopper setGraphHopperLocation(String ghLocation)
```
    Sets the graphhopper folder.
  - getOSMFile
```
public String getOSMFile()
```
  - setOSMFile
```
public GraphHopper setOSMFile(String osmFile)
```
    This file can be an osm xml (.osm), a compressed xml (.osm.zip or .osm.gz) or a protobuf file (.pbf).
  - getGraphHopperStorage
```
public GraphHopperStorage getGraphHopperStorage()
```
    The underlying graph used in algorithms.
    
    Throws:
    
    IllegalStateException - if graph is not instantiated.
  - setGraphHopperStorage
```
public void setGraphHopperStorage(GraphHopperStorage ghStorage)
```
  - getLocationIndex
```
public LocationIndex getLocationIndex()
```
    The location index created from the graph.
    
    Throws:
    
    IllegalStateException - if index is not initialized
  - setLocationIndex
```
protected void setLocationIndex(LocationIndex locationIndex)
```
  - setSortGraph
```
public GraphHopper setSortGraph(boolean sortGraph)
```
    Sorts the graph which requires more RAM while import. See #12
  - isAllowWrites
```
public boolean isAllowWrites()
```
  - setAllowWrites
```
public GraphHopper setAllowWrites(boolean allowWrites)
```
    Specifies if it is allowed for GraphHopper to write. E.g. for read only filesystems it is not possible to create a lock file and so we can avoid write locks.
  - getTranslationMap
```
public TranslationMap getTranslationMap()
```
  - setFlagEncoderFactory
```
public GraphHopper setFlagEncoderFactory(FlagEncoderFactory factory)
```
  - getEncodedValueFactory
```
public EncodedValueFactory getEncodedValueFactory()
```
  - setEncodedValueFactory
```
public GraphHopper setEncodedValueFactory(EncodedValueFactory factory)
```
  - getTagParserFactory
```
public TagParserFactory getTagParserFactory()
```
  - setTagParserFactory
```
public GraphHopper setTagParserFactory(TagParserFactory factory)
```
  - init
```
public GraphHopper init(GraphHopperConfig ghConfig)
```
    Reads the configuration from a GraphHopperConfig object which can be manually filled, or more typically is read from `config.yml`.
  - importOrLoad
```
public GraphHopper importOrLoad()
```
    Imports provided data from disc and creates graph. Depending on the settings the resulting graph will be stored to disc so on a second call this method will only load the graph from disc which is usually a lot faster.
  - importAndClose
```
public void importAndClose()
```
    Imports and processes data, storing it to disk when complete.
  - importOSM
```
protected void importOSM()
```
  - _getOSMFile
```
protected File _getOSMFile()
```
    Currently we use this for a few tests where the dataReaderFile is loaded from the classpath
  - load
```
public boolean load(String graphHopperFolder)
```
    Opens existing graph folder.
    
    Specified by:
    
    load in interface GraphHopperAPI
    
    Parameters:
    
    graphHopperFolder - is the folder containing graphhopper files. Can be a compressed file too ala folder-content.ghz.
  - getCHPreparationHandler
```
public final CHPreparationHandler getCHPreparationHandler()
```
  - getLMPreparationHandler
```
public final LMPreparationHandler getLMPreparationHandler()
```
  - postProcessing
```
public final void postProcessing()
```
    Does the preparation and creates the location index
  - postProcessing
```
protected void postProcessing(boolean closeEarly)
```
    Does the preparation and creates the location index
    
    Parameters:
    
    closeEarly - release resources as early as possible
  - registerCustomEncodedValues
```
protected void registerCustomEncodedValues(EncodingManager.Builder emBuilder)
```
  - importPublicTransit
```
protected void importPublicTransit()
```
  - createWeighting
```
public final Weighting createWeighting(Profile profile,
                                       PMap hints)
```
  - createWeighting
```
public final Weighting createWeighting(Profile profile,
                                       PMap hints,
                                       boolean disableTurnCosts)
```
  - createWeightingFactory
```
protected WeightingFactory createWeightingFactory()
```
  - route
```
public GHResponse route(GHRequest request)
```
    Specified by:
    
    route in interface GraphHopperAPI
  - createLocationIndex
```
protected LocationIndex createLocationIndex(Directory dir)
```
  - initLocationIndex
```
protected void initLocationIndex()
```
    Initializes the location index after the import is done.
  - prepareCH
```
protected void prepareCH(boolean closeEarly)
```
  - loadOrPrepareLM
```
protected void loadOrPrepareLM(boolean closeEarly)
```
    For landmarks it is required to always call this method: either it creates the landmark data or it loads it.
  - cleanUp
```
protected void cleanUp()
```
    Internal method to clean up the graph.
  - flush
```
protected void flush()
```
  - close
```
public void close()
```
    Releases all associated resources like memory or files. But it does not remove them. To remove the files created in graphhopperLocation you have to call clean().
  - clean
```
public void clean()
```
    Removes the on-disc routing files. Call only after calling close or before importOrLoad or load
  - ensureNotLoaded
```
protected void ensureNotLoaded()
```
  - ensureWriteAccess
```
protected void ensureWriteAccess()
```
  - getFullyLoaded
```
public boolean getFullyLoaded()
```
  - getRouterConfig
```
public RouterConfig getRouterConfig()
```

Class GraphHopper

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

GraphHopper

GraphHopper

Method Detail

loadGraph

getEncodingManager

setEncodingManager

getElevationProvider

setElevationProvider

getWorkerThreads

getWayPointMaxDistance

setWayPointMaxDistance

setPathDetailsBuilderFactory

getPathDetailsBuilderFactory

setPreciseIndexResolution

setMinNetworkSize

setStoreOnFlush

setProfiles

setProfiles

getProfiles

getProfile

hasElevation

setElevation

setLongEdgeSamplingDistance

setElevationWayPointMaxDistance

getGraphHopperLocation

setGraphHopperLocation

getOSMFile

setOSMFile

getGraphHopperStorage

setGraphHopperStorage

getLocationIndex

setLocationIndex

setSortGraph

isAllowWrites

setAllowWrites

getTranslationMap

setFlagEncoderFactory

getEncodedValueFactory

setEncodedValueFactory

getTagParserFactory

setTagParserFactory

init

importOrLoad

importAndClose

importOSM

_getOSMFile

load

getCHPreparationHandler

getLMPreparationHandler

postProcessing

postProcessing

registerCustomEncodedValues

importPublicTransit

createWeighting

createWeighting

createWeightingFactory

route

createLocationIndex

initLocationIndex

prepareCH

loadOrPrepareLM

cleanUp

flush

close

clean

ensureNotLoaded

ensureWriteAccess

getFullyLoaded

getRouterConfig