Module graphhopper.directions

ballerinax/graphhopper.directions Ballerina library

1.5.2

Overview

The GraphHopper Directions API v1.0.0 connector(https://docs.graphhopper.com/) OpenAPI Specification.

With the GraphHopper Directions API you can integrate A-to-B route planning, turn-by-turn navigation,route optimization, isochrone calculations and other tools in your application. The GraphHopper Directions API consists of the following RESTful web services:

 * [Routing API](#tag/Routing-API),
 * [Route Optimization API](#tag/Route-Optimization-API),
 * [Isochrone API](#tag/Isochrone-API),
 * [Map Matching API](#tag/Map-Matching-API),
 * [Matrix API](#tag/Matrix-API),
 * [Geocoding API](#tag/Geocoding-API) and
 * [Cluster API](#tag/Cluster-API).

Key Features

Programmatic access to create and manage resources via REST API
Manage user accounts and profiles
Secure authentication with API key or OAuth support

Prerequisites

Before using this connector in your Ballerina application, complete the following:

Create a GraphHopper Account
Obtaining tokens

Obtain your token by following this link
Learn more on GraphHopper

Clients

graphhopper.directions: Client

Isolated

This is a generated connector for GraphHopper Directions API v1.0.0 OpenAPI Specification.

With the GraphHopper Directions API you can integrate A-to-B route planning, turn-by-turn navigation, route optimization, isochrone calculations and other tools in your application.

Constructor

Gets invoked to initialize the connector. The connector initialization requires setting the API credentials. Create an GraphHopper account and obtain tokens following this guide.

init (ApiKeysConfig apiKeyConfig, ConnectionConfig config, string serviceUrl)

apiKeyConfig ApiKeysConfig - API keys for authorization

config ConnectionConfig {} - The configurations to be used when initializing the connector

serviceUrl string "https://graphhopper.com/api/1" - URL of the target service

getRoute

Isolated FunctionRemote Function

function getRoute(string[] point, string[]? pointHint, string[]? snapPrevention, VehicleProfileId? vehicle, string[]? curbside, boolean turnCosts, string locale, boolean elevation, string[]? details, string optimize, boolean instructions, boolean calcPoints, boolean debug, boolean pointsEncoded, boolean chDisable, string weighting, int[]? heading, int headingPenalty, boolean passThrough, string? blockArea, string? avoid, string? algorithm, int roundTripDistance, int? roundTripSeed, int alternativeRouteMaxPaths, decimal alternativeRouteMaxWeightFactor, decimal alternativeRouteMaxShareFactor) returns RouteResponse|error

GET Route Endpoint

Parameters

point string[] - The points for which the route should be calculated. Format: [latitude,longitude]. Specify at least an origin and a destination. Via points are possible. The maximum number depends on your plan.

pointHint string[]? (default ()) - The point_hint is typically a road name to which the associated point parameter should be snapped to. Specify no point_hint parameter or the same number as you have point parameters.

snapPrevention string[]? (default ()) - Optional parameter to avoid snapping to a certain road class or road environment. Currently supported values are motorway, trunk, ferry, tunnel, bridge and ford. Multiple values are specified like snap_prevention=ferry&snap_prevention=motorway.

vehicle VehicleProfileId? (default ()) - The vehicle profile for which the route should be calculated.

curbside string[]? (default ()) - Optional parameter. It specifies on which side a point should be relative to the driver when she leaves/arrives at a start/target/via point. You need to specify this parameter for either none or all points. Only supported for motor vehicles and OpenStreetMap.

turnCosts boolean (default false) - Specifies if turn restrictions should be considered. Enabling this option increases the route computation time. Only supported for motor vehicles and OpenStreetMap.

locale string (default "en") - The locale of the resulting turn instructions. E.g. pt_PT for Portuguese or de for German.

elevation boolean (default false) - If true, a third coordinate, the altitude, is included with all positions in the response. This changes the format of the points and snapped_waypoints fields of the response, in both their encodings. Unless you switch off the points_encoded parameter, you need special code on the client side that can handle three-dimensional coordinates. A request can fail if the vehicle profile does not support elevation. See the features object for every vehicle profile.

details string[]? (default ()) - Optional parameter to retrieve path details. You can request additional details for the route: street_name, time, distance, max_speed, toll, road_class, road_class_link, road_access, road_environment, lanes, and surface. Read more about the usage of path details here.

optimize string (default "false") - Normally, the calculated route will visit the points in the order you specified them. If you have more than two points, you can set this parameter to "true" and the points may be re-ordered to minimize the total travel time. Keep in mind that the limits on the number of locations of the Route Optimization API applies, and the request costs more credits.

instructions boolean (default true) - If instructions should be calculated and returned

calcPoints boolean (default true) - If the points for the route should be calculated at all.

debug boolean (default false) - If true, the output will be formatted.

pointsEncoded boolean (default true) - Allows changing the encoding of location data in the response. The default is polyline encoding, which is compact but requires special client code to unpack. (We provide it in our JavaScript client library!) Set this parameter to false to switch the encoding to simple coordinate pairs like [lon,lat], or [lon,lat,elevation]. See the description of the response format for more information.

chDisable boolean (default false) - Use this parameter in combination with one or more parameters from below.

weighting string (default "fastest") - Determines the way the "best" route is calculated. Besides fastest you can use short_fastest which finds a reasonable balance between the distance influence (shortest) and the time (fastest). You could also use shortest but is deprecated and not recommended for motor vehicles. All except fastest require ch.disable=true.

heading int[]? (default ()) - Favour a heading direction for a certain point. Specify either one heading for the start point or as many as there are points. In this case headings are associated by their order to the specific points. Headings are given as north based clockwise angle between 0 and 360 degree. This parameter also influences the tour generated with algorithm=round_trip and forces the initial direction. Requires ch.disable=true.

headingPenalty int (default 120) - Time penalty in seconds for not obeying a specified heading. Requires ch.disable=true.

passThrough boolean (default false) - If true, u-turns are avoided at via-points with regard to the heading_penalty. Requires ch.disable=true.

blockArea string? (default ()) - Block road access by specifying a point close to the road segment to be blocked, with the format lat,lon. You can also block all road segments crossing a geometric shape. Specify a circle using the format lat,lon,radius, or a polygon using the format lat1,lon1,lat2,lon2,...,latN,lonN. You can specify several shapes, separating them with ;. Requires ch.disable=true.

avoid string? (default ()) - Specify which road classes and environments you would like to avoid. Possible values are motorway, steps, track, toll, ferry, tunnel and bridge. Separate several values with ;. Obviously not all the values make sense for all vehicle profiles e.g. bike is already forbidden on a motorway. Requires ch.disable=true.

algorithm string? (default ()) - Rather than looking for the shortest or fastest path, this parameter lets you solve two different problems related to routing: With alternative_route, we give you not one but several routes that are close to optimal, but not too similar to each other. With round_trip, the route will get you back to where you started. This is meant for fun (think of a bike trip), so we will add some randomness. The round_trip option requires ch.disable=true. You can control both of these features with additional parameters, see below.

roundTripDistance int (default 10000) - If algorithm=round_trip, this parameter configures approximative length of the resulting round trip. Requires ch.disable=true.

roundTripSeed int? (default ()) - If algorithm=round_trip, this sets the random seed. Change this to get a different tour for each value.

alternativeRouteMaxPaths int (default 2) - If algorithm=alternative_route, this parameter sets the number of maximum paths which should be calculated. Increasing can lead to worse alternatives.

alternativeRouteMaxWeightFactor decimal (default 1.4) - If algorithm=alternative_route, this parameter sets the factor by which the alternatives routes can be longer than the optimal route. Increasing can lead to worse alternatives.

alternativeRouteMaxShareFactor decimal (default 0.6) - If algorithm=alternative_route, this parameter specifies how similar an alternative route can be to the optimal route. Increasing can lead to worse alternatives.

Return Type

RouteResponse|error - Routing Result

postRoute

Isolated FunctionRemote Function

function postRoute(RouteRequest payload) returns RouteResponse|error

POST Route Endpoint

Parameters

payload RouteRequest - Route request details

Return Type

RouteResponse|error - Routing Result

getCoverageInformation

Isolated FunctionRemote Function

function getCoverageInformation() returns InfoResponse|error

Coverage information

Return Type

InfoResponse|error - Coverage Information

getIsochrone

Isolated FunctionRemote Function

function getIsochrone(string point, int timeLimit, int? distanceLimit, VehicleProfileId? vehicle, int buckets, boolean reverseFlow, string weighting) returns IsochroneResponse|error

Isochrone Endpoint

Parameters

point string - Specify the start coordinate

timeLimit int (default 600) - Specify which time the vehicle should travel. In seconds.

distanceLimit int? (default ()) - Specify which distance the vehicle should travel. In meters.

vehicle VehicleProfileId? (default ()) - The vehicle profile for which the route should be calculated.

buckets int (default 1) - Number by which to divide the given time_limit to create buckets nested isochrones of time intervals time_limit-n*time_limit/buckets. Applies analogously to distance_limit.

reverseFlow boolean (default false) - If false the flow goes from point to the polygon, if true the flow goes from the polygon "inside" to the point. Example use case for false: How many potential customer can be reached within 30min travel time from your store vs. true: How many customers can reach your store within 30min travel time.

weighting string (default "fastest") - Use "shortest" to get an isodistance line instead of an isochrone.

Return Type

IsochroneResponse|error - Isochrone Result

getMatrix

Isolated FunctionRemote Function

function getMatrix(string[]? point, string[]? fromPoint, string[]? toPoint, string[]? pointHint, string[]? fromPointHint, string[]? toPointHint, string[]? snapPrevention, string[]? curbside, string[]? fromCurbside, string[]? toCurbside, string[]? outArray, VehicleProfileId? vehicle, boolean failFast, boolean turnCosts) returns MatrixResponse|error

GET Matrix Endpoint

Parameters

point string[]? (default ()) - Specify multiple points in latitude,longitude for which the weight-, route-, time- or distance-matrix should be calculated. In this case the starts are identical to the destinations. If there are N points, then NxN entries will be calculated. The order of the point parameter is important. Specify at least three points. Cannot be used together with from_point or to_point.

fromPoint string[]? (default ()) - The starting points for the routes in latitude,longitude. E.g. if you want to calculate the three routes A->1, A->2, A->3 then you have one from_point parameter and three to_point parameters.

toPoint string[]? (default ()) - The destination points for the routes in latitude,longitude.

pointHint string[]? (default ()) - Optional parameter. Specifies a hint for each point parameter to prefer a certain street for the closest location lookup. E.g. if there is an address or house with two or more neighboring streets you can control for which street the closest location is looked up.

fromPointHint string[]? (default ()) - For the from_point parameter. See point_hint

toPointHint string[]? (default ()) - For the to_point parameter. See point_hint

snapPrevention string[]? (default ()) - Optional parameter to avoid snapping to a certain road class or road environment. Current supported values motorway, trunk, ferry, tunnel, bridge and ford. Multiple values are specified like snap_prevention=ferry&snap_prevention=motorway

curbside string[]? (default ()) - Optional parameter. It specifies on which side a point should be relative to the driver when she leaves/arrives at a start/target/via point. You need to specify this parameter for either none or all points. Only supported for motor vehicles and OpenStreetMap.

fromCurbside string[]? (default ()) - Curbside setting for the from_point parameter. See curbside.

toCurbside string[]? (default ()) - Curbside setting for the to_point parameter. See curbside.

outArray string[]? (default ()) - Specifies which arrays should be included in the response. Specify one or more of the following options 'weights', 'times', 'distances'. To specify more than one array use e.g. out_array=times&out_array=distances. The units of the entries of distances are meters, of times are seconds and of weights is arbitrary and it can differ for different vehicles or versions of this API.

vehicle VehicleProfileId? (default ()) - The vehicle profile for which the matrix should be calculated.

failFast boolean (default true) - Specifies whether or not the matrix calculation should return with an error as soon as possible in case some points cannot be found or some points are not connected. If set to false the time/weight/distance matrix will be calculated for all valid points and contain the null value for all entries that could not be calculated. The hint field of the response will also contain additional information about what went wrong (see its documentation).

turnCosts boolean (default false) - Specifies if turn restrictions should be considered. Enabling this option increases the matrix computation time. Only supported for motor vehicles and OpenStreetMap.

Return Type

MatrixResponse|error - Matrix API response

postMatrix

Isolated FunctionRemote Function

function postMatrix(MatrixBody payload) returns MatrixResponse|error

POST Matrix Endpoint

Parameters

payload MatrixBody - Matrix Request Detail

Return Type

MatrixResponse|error - Matrix API response

calculateMatrix

Isolated FunctionRemote Function

function calculateMatrix(MatrixCalculateBody payload) returns JobId|error

Batch Matrix Endpoint

Parameters

payload MatrixCalculateBody - Matrix request details

Return Type

JobId|error - A jobId you can use to retrieve your solution from the server.

getMatrixSolution

Isolated FunctionRemote Function

function getMatrixSolution(string jobId) returns MatrixResponse|error

GET Batch Matrix Endpoint

Parameters

jobId string - Request solution with jobId

Return Type

MatrixResponse|error - A response containing the matrix

postGPX

Isolated FunctionRemote Function

function postGPX(int? gpsAccuracy, string? vehicle) returns RouteResponse|error

Map-match a GPX file

Parameters

gpsAccuracy int? (default ()) - Specify the precision of a point, in meter

vehicle string? (default ()) - Specify the vehicle profile like car

Return Type

RouteResponse|error - Routing Result

getGeocode

Isolated FunctionRemote Function

function getGeocode(string? q, string locale, int 'limit, boolean reverse, boolean debug, string? point, string provider) returns GeocodingResponse|error

Geocoding Endpoint

Parameters

q string? (default ()) - If you do forward geocoding, this is required and is a textual description of the address you are looking for.

locale string (default "en") - Display the search results for the specified locale. Currently French (fr), English (en), German (de) and Italian (it) are supported. If the locale wasn't found the default (en) is used.

'limit int (default 10) - Specify the maximum number of results to return

reverse boolean (default false) - It is required to be true if you want to do a reverse geocoding request. If it is true, point must be defined as well, and q must not be used.

debug boolean (default false) - If true, the output will be formatted.

point string? (default ()) - Forward geocoding: The location bias in the format 'latitude,longitude' e.g. point=45.93272,11.58803. Reverse geocoding: The location to find amenities, cities.

provider string (default "default") - The provider parameter is currently under development and can fall back to default at any time. The intend is to provide alternatives to our default geocoder. Each provider has its own strenghts and might fit better for certain scenarios, so it's worth to compare the different providers. To try it append the providerparameter to the URL like &provider=nominatim, the result structure should be identical in all cases - if not, please report this back to us. Keep in mind that some providers do not support certain parameters or don't return some fields, for example osm_id and osm_type are not supported by every geocoding provider. If you would like to use additional parameters of one of the providers, but it's not available for the GraphHopper Geocoding API, yet? Please contact us. The credit costs can be different for all providers - see here for more information about it. Currently, only the default provider and gisgraphy supports autocompletion of partial search strings. All providers support normal "forward" geocoding and reverse geocoding via reverse=true. #### Default (provider=default) This provider returns results of our internal geocoding engine, as described above. In addition to the above documented parameters the following parameters are possible: * bbox - the expected format is minLon,minLat,maxLon,maxLat * osm_tag - you can filter key:value or exclude places with certain OpenStreetMap tags !key:value. E.g. osm_tag=tourism:museum or just the key osm_tag=tourism. To exclude multiple tags you add multiple osm_tag parameters. #### Nominatim (provider=nominatim) The GraphHopper Directions API uses a commercially hosted Nominatim geocoder. You can try this provider here. The provider does not fall under the restrictions of the Nominatim instance hosted by OpenStreetMap. In addition to the above documented parameters Nominatim allows to use the following parameters, which can be used as documented here: * viewbox - the expected format is minLon,minLat,maxLon,maxLat * bounded - If 1 and a viewbox is given, restrict the result to items contained within that viewbox. Default is 0. #### Gisgraphy (provider=gisgraphy) This provider returns results from the Gisgraphy geocoder which you can try here. Limitations: The locale parameter is not supported. Gisgraphy does not return OSM tags or an extent. Gisgraphy has a special autocomplete API, which you can use by adding autocomplete=true (does not work with reverse=true). The autocomplete API is optimized on predicting text input, but returns less information. In addition to the above documented parameters Gisgraphy allows to use the following parameters, which can be used as documented here: * radius - radius in meters * country - restrict search for the specified country. The value must be the ISO 3166 Alpha 2 code of the country. #### NetToolKit (provider=nettoolkit) This provider returns results from the NetToolKit provider which is specialized for US addresses and provides a wrapper around Nominatim for other addresses. You can try it here. The following additional NetToolKit parameters are supported (read here for more details): - source: User can choose which source provider to geocode the address, this value is "NetToolKit" by default - country_code: an iso-3166-2 country code (e.g : US) filter the results to the specify country code Limitations: NetToolKit does not support the locale parameter. NetToolKit does not return OSM tags (e.g. osm_id, osm_type, osm_value). #### OpenCage Data (provider=opencagedata) This provider returns results from the OpenCageData geocoder which you can try here. In addition to the above documented parameters OpenCage Data allows to use the following parameters, which can be used as documented here: * countrycode - The country code is a two letter code as defined by the ISO 3166-1 Alpha 2 standard. E.g. gb for the United Kingdom, fr for France, us for United States. * bounds - the expected format is minLon,minLat,maxLon,maxLat

Return Type

GeocodingResponse|error - An array found locations

solveVRP

Isolated FunctionRemote Function

function solveVRP(Request payload) returns Response|error

POST route optimization problem

Parameters

payload Request - The request that contains the vehicle routing problem to be solved.

Return Type

Response|error - A response containing the solution

asyncVRP

Isolated FunctionRemote Function

function asyncVRP(Request payload) returns JobId|error

POST route optimization problem (batch mode)

Parameters

payload Request - The request that contains the problem to be solved.

Return Type

JobId|error - A jobId you can use to retrieve your solution from the server - see solution endpoint.

getSolution

Isolated FunctionRemote Function

function getSolution(string jobId) returns Response|error

GET the solution (batch mode)

Parameters

jobId string - Request solution with jobId

Return Type

Response|error - A response containing the solution

solveClusteringProblem

Isolated FunctionRemote Function

function solveClusteringProblem(ClusterRequest payload) returns ClusterResponse|error

POST Cluster Endpoint

Parameters

payload ClusterRequest - Request object that contains the problem to be solved

Return Type

ClusterResponse|error - A response containing the solution

asyncClusteringProblem

Isolated FunctionRemote Function

function asyncClusteringProblem(ClusterRequest payload) returns JobId|error

Batch Cluster Endpoint

Parameters

payload ClusterRequest - Request object that contains the problem to be solved

Return Type

JobId|error - A jobId you can use to retrieve your solution from the server - see solution endpoint.

getClusterSolution

Isolated FunctionRemote Function

function getClusterSolution(string jobId) returns ClusterResponse|error

GET Batch Solution Endpoint

Parameters

jobId string - Request solution with jobId

Return Type

ClusterResponse|error - A response containing the solution

Records

graphhopper.directions: Activity

Fields

'type? string - type of activity

id? string - Id referring to the underlying service or shipment, i.e. the shipment or service this activity belongs to

location_id? string - Id that refers to address

address? ResponseAddress - Address of activity

arr_time? int - Arrival time at this activity in seconds. If type is start, this is not available (since it makes no sense to have arr_time at start). However, end_time is available and actually means "departure time" at start location. It is important to note that arr_time does not necessarily mean "start of underlying activity", it solely means arrival time at activity location. If this activity has no time windows and if there are no further preparation times, arr_time is equal to activity start time.

end_time? int - End time of and thus departure time at this activity. If type is end, this is not available (since it makes no sense to have an end_time at end) end_time at each activity is equal to the departure time at the activity location.

end_date_time? string - End date time with offset like this 1970-01-01T01:00+01:00. If you do not use time-dependent optimization, this is null.

arr_date_time? string - Arrival date time with offset like this 1970-01-01T01:00+01:00. If you do not use time-dependent optimization, this is null.

waiting_time? int - Waiting time at this activity in seconds. A waiting time can occur if the activity has at least one time window. If arr_time < time_window.earliest a waiting time of time_window_earliest - arr_time occurs.

preparation_time? int - preparation time at this activity in seconds

distance? int - cumulated distance from start to this activity in m

driving_time? int - cumulated driving time from start to this driver activity in seconds

load_before? int[] - Array with size/capacity dimensions before this activity

load_after? int[] - Array with size/capacity dimensions after this activity

graphhopper.directions: Address

Fields

location_id string - Specifies the id of the location.

name? string - Name of location.

lon float - Longitude of location.

lat float - Latitude of location.

street_hint? string - Optional parameter. Specifies a hint for each address to better snap the coordinates (lon,lat) to road network. E.g. if there is an address or house with two or more neighboring streets you can control for which street the closest location is looked up.

curbside? string - Optional parameter. Specifies on which side a point should be relative to the driver when she leaves/arrives at a start/target/via point. Only supported for motor vehicles and OpenStreetMap.

graphhopper.directions: Algorithm

Deprecated

Use objectives instead.

Fields

problem_type? string - Problem type

objective? string - Objective type

Deprecated

graphhopper.directions: ApiKeysConfig

Closed record

Provides API key configurations needed when communicating with a remote HTTP endpoint.

Fields

key string - Represents API Key key

graphhopper.directions: BadRequest

Fields

message? string - Short error message

hints? ErrorMessage[] - Optional error information.

status? string - status

graphhopper.directions: ClientHttp1Settings

Closed record

Provides settings related to HTTP/1.x protocol.

Fields

keepAlive KeepAlive(default http:KEEPALIVE_AUTO) - Specifies whether to reuse a connection for multiple requests

chunking Chunking(default http:CHUNKING_AUTO) - The chunking behaviour of the request

proxy? ProxyConfig - Proxy server related options

graphhopper.directions: Cluster

Fields

quantity? int - Cluster size

ids? string[] - Array of customer ids assigned to this specific cluster

graphhopper.directions: ClusterConfiguration

Fields

response_type? string - Specifies the response format. You can either choose geojson or json.

routing? ClusterConfigurationRouting -

clustering? ClusterConfigurationClustering -

graphhopper.directions: ClusterConfigurationClustering

Fields

num_clusters? int - Specifies the number of clusters

max_quantity? int - Specifies max. quantity in a cluster

min_quantity? int - Specifies min. quantity in a cluster

graphhopper.directions: ClusterConfigurationRouting

Fields

profile? string - The routing profile for which the travel times and distances should be calculated. Other profiles are listed here

cost_per_second? float - Cost per second (travel time)

cost_per_meter? float - Cost per meter (travel distance)

graphhopper.directions: ClusterCustomer

Fields

id? string - id of customer

address? ClusterCustomerAddress -

quantity? int - demand of customer

graphhopper.directions: ClusterCustomerAddress

Fields

lon? float - Longitude

lat? float - Latitude

street_hint? string - Optional parameter. Specifies a hint for each address to better snap the coordinates (lon,lat) to road network. E.g. if there is an address or house with two or more neighboring streets you can control for which street the closest location is looked up.

graphhopper.directions: ClusterRequest

Fields

configuration? ClusterConfiguration -

customers? ClusterCustomer[] -

graphhopper.directions: ClusterResponse

Fields

copyrights? string[] -

status? string - Indicates the current status of the job

waiting_time_in_queue? float -

processing_time? float -

clusters? Cluster[] -

graphhopper.directions: Configuration

Specifies general configurations that are taken into account when solving the vehicle routing problem.

Fields

routing? Routing - This contains all routing specific configurations.

graphhopper.directions: ConnectionConfig

Closed record

Provides a set of configurations for controlling the behaviours when communicating with a remote HTTP endpoint.

Fields

httpVersion HttpVersion(default http:HTTP_2_0) - The HTTP version understood by the client

http1Settings? ClientHttp1Settings - Configurations related to HTTP/1.x protocol

http2Settings? ClientHttp2Settings - Configurations related to HTTP/2 protocol

timeout decimal(default 60) - The maximum time to wait (in seconds) for a response before closing the connection

forwarded string(default "disable") - The choice of setting forwarded/x-forwarded header

poolConfig? PoolConfiguration - Configurations associated with request pooling

cache? CacheConfig - HTTP caching related configurations

compression Compression(default http:COMPRESSION_AUTO) - Specifies the way of handling compression (accept-encoding) header

circuitBreaker? CircuitBreakerConfig - Configurations associated with the behaviour of the Circuit Breaker

retryConfig? RetryConfig - Configurations associated with retrying

responseLimits? ResponseLimitConfigs - Configurations associated with inbound response size limits

secureSocket? ClientSecureSocket - SSL/TLS-related options

proxy? ProxyConfig - Proxy server related options

validation boolean(default true) - Enables the inbound payload validation functionality which provided by the constraint package. Enabled by default

graphhopper.directions: CostMatrix

Fields

'type? string - type of cost matrix, currently default or google are supported

location_ids? string[] -

data? CostmatrixData - JSON data of matrix response

profile? string - vehicle profile or empty if catch all fallback

graphhopper.directions: CostmatrixData

JSON data of matrix response

Fields

times? int[][] - Times values

distances? decimal[][] - Distances

info? CostmatrixDataInfo - Additional information for your request

graphhopper.directions: CostmatrixDataInfo

Additional information for your request

Fields

copyrights? string[] - Copyright details

took? float - Took value

graphhopper.directions: Detail

Fields

id? string - Id of unassigned service/shipment

code? int - Reason code Code | Reason :------|:--------- 1 | cannot serve required skill 2 | cannot be visited within time window 3 | does not fit into any vehicle due to capacity 4 | cannot be assigned due to max distance constraint of vehicles 21 | could not be assigned due to relation constraint 22 | could not be assigned due to allowed vehicle constraint 23 | could not be assigned due to max-time-in-vehicle constraint 24 | driver does not need a break 25 | could not be assigned due to disallowed vehicle constraint 26 | could not be assigned due to max drive time constraint 27 | could not be assigned due to max job constraint 28 | could not be assigned due to max activity constraint 50 | underlying location cannot be accessed over road network by at least one vehicle

reason? string - Human readable reason as listed above

graphhopper.directions: DriveTimeBreak

Fields

duration int - Specifies the duration of the break in seconds.

max_driving_time int - Specifies the max driving time (in a row) without break in seconds.

initial_driving_time? int - Specifies the initial (current) driving time of a driver to allow dynamic adaptations in seconds.

possible_split? int[] - Array specifying how a break duration (in seconds) can be split into several smaller breaks

graphhopper.directions: ErrorMessage

Fields

message? string - error message

details? string - Details

graphhopper.directions: GeocodingLocation

Fields

point? GeocodingPoint -

osm_id? string - The OSM ID of the entity

osm_type? string - N = node, R = relation, W = way

osm_key? string - The OSM key of the entity

name? string - The name of the entity. Can be a boundary, POI, address, etc

country? string - The country of the address

city? string - The city of the address

state? string - The state of the address

street? string - The street of the address

housenumber? string - The housenumber of the address

postcode? string - The postcode of the address

graphhopper.directions: GeocodingPoint

Fields

lat? float - Latitude

lng? float - Longitude

graphhopper.directions: GeocodingResponse

Fields

hits? GeocodingLocation[] -

took? int - in ms

graphhopper.directions: GHError

Fields

message? string -

hints? GherrorHints[] - Optional error information.

graphhopper.directions: GherrorHints

Fields

message? string -

graphhopper.directions: GroupRelation

Fields

'type string - Specifies the type of relation. It must be either of type - in_sequence or in_direct_sequence.

groups string[] - An array of groups that should be related

graphhopper.directions: InfoResponse

Information about the server and the geographical area that it covers.

Fields

'version? string - The version of the GraphHopper server that provided this response. This is not related to the API version.

bbox? string - The bounding box of the geographical area covered by this GraphHopper instance. Format: "minLon,minLat,maxLon,maxLat"

features? record {} - The supported features, such as elevation, per vehicle profile.

graphhopper.directions: InlineResponse404

Fields

message? string - Error message

status? string - status

graphhopper.directions: InternalErrorMessage

Fields

code? int -

message? string - Details

graphhopper.directions: IsochroneResponse

Fields

polygons? IsochroneResponsePolygon[] - The list of polygons in GeoJson format. It can be used e.g. in the Leaflet framework:
```
L.geoJson(json.polygons).addTo(map)
```
The number of polygon is identical to the specified buckets in the query. Every polygon contains the bucket number in the properties section of the GeoJson.

copyrights? string[] -

graphhopper.directions: IsochroneResponsePolygon

A found path

Fields

properties? IsochroneresponsepolygonProperties - Polygon properties

'type? string - Type detail

geometry? Polygon - Polygon details

graphhopper.directions: IsochroneresponsepolygonProperties

Polygon properties

Fields

bucket? int - Bucket detail

graphhopper.directions: JobId

Fields

job_id? string - UUID. Unique id for your job/request with which you can fetch your solution

graphhopper.directions: JobRelation

Fields

'type string - Specifies the type of relation. It must be either of type - in_same_route, in_sequence or in_direct_sequence. in_same_route: As the name suggest, it enforces the specified services or shipments to be in the same route. It can be specified as follows:
```
{
   "type": "in_same_route",
   "ids": ["serv_i_id","serv_j_id"]
}
```
This enforces service i to be in the same route as service j no matter which vehicle will be employed. If a specific vehicle (driver) is required to conduct this, just add a vehicle_id like this:
```
{
   "type": "in_same_route",
   "ids": ["serv_i_id","serv_j_id"],
   "vehicle_id": "vehicle1"
}
```
This not only enforce service i and j to be in the same route, but also makes sure that both services are in the route of vehicle1. Tip: This way initial loads and vehicle routes can be modelled. For example, if your vehicles are already on the road and new orders come in, then vehicles can still be rescheduled subject to the orders that have already been assigned to these vehicles. in_sequence: This relation type enforces n jobs to be in sequence. It can be specified as
```
{
   "type": "in_sequence",
   "ids": ["serv_i_id","serv_j_id"]
}
```
which means that service j need to be in the same route as service i AND it needs to occur somewhere after service i. As described above if a specific vehicle needs to conduct this, just add vehicle_id. in_direct_sequence: This enforces n services or shipments to be in direct sequence. It can be specified as
```
{
   "type": "in_direct_sequence",
   "ids": ["serv_i_id","serv_j_id","serv_k_id"]
}
```
yielding service j to occur directly after service i, and service k to occur directly after service j i.e. in strong order. Again, a vehicle can be assigned a priority by adding a vehicle_id to the relation. Special IDs: If you look at the previous example and you want service i to be the first in the route, use the special ID start as follows:
```
{
   "type": "in_direct_sequence",
   "ids": ["start","serv_i_id","serv_j_id","serv_k_id"]
}
```
Latter enforces the direct sequence of i, j and k at the beginning of the route. If this sequence should be bound to the end of the route, use the special ID end like this:
```
{
   "type": "in_direct_sequence",
   "ids": ["serv_i_id","service_j_id","serv_k_id","end"]
}
```
If you deal with services then you need to use the 'id' of your services in the field 'ids'. To also consider sequences of the pickups and deliveries of your shipments, you need to use a special ID, i.e. use the shipment id plus the keyword _pickup or _delivery. For example, to ensure that the pickup and delivery of the shipment with the id 'my_shipment' are direct neighbors, you need the following specification:
```
{
   "type": "in_direct_sequence",
   "ids": ["my_ship_pickup","my_ship_delivery"]
}
```

ids string[] - Specifies an array of shipment and/or service ids that are in relation. If you deal with services then you need to use the id of your services in ids. To also consider sequences of the pickups and deliveries of your shipments, you need to use a special ID, i.e. use your shipment id plus the keyword _pickup or _delivery. If you want to place a service or shipment activity at the beginning of your route, use the special ID start. In turn, use end to place it at the end of the route.

vehicle_id? string - Id of pre-assigned vehicle, i.e. the vehicle id that is determined to conduct the services and shipments in this relation.

graphhopper.directions: LineString

Fields

'type? string -

coordinates? decimal[][] - A list of coordinate pairs or triples, [lon,lat] or [lon,lat,elevation].

graphhopper.directions: MatrixRequest

Fields

from_points? decimal[][] - The starting points for the routes in an array of [longitude,latitude]. For instance, if you want to calculate three routes from point A such as A->1, A->2, A->3 then you have one from_point parameter and three to_point parameters.

to_points? decimal[][] - The destination points for the routes in an array of [longitude,latitude].

from_point_hints? string[] - See point_hintsof symmetrical matrix

to_point_hints? string[] - See point_hintsof symmetrical matrix

snap_preventions? string[] - See snap_preventions of symmetrical matrix

from_curbsides? string[] - See curbsidesof symmetrical matrix

to_curbsides? string[] - See curbsidesof symmetrical matrix

out_arrays? string[] - Specifies which matrices should be included in the response. Specify one or more of the following options weights, times, distances. The units of the entries of distances are meters, of times are seconds and of weights is arbitrary and it can differ for different vehicles or versions of this API.

vehicle? string - The vehicle profile for which the route should be calculated. Other vehicles are listed here for the details.

fail_fast? boolean - Specifies whether or not the matrix calculation should return with an error as soon as possible in case some points cannot be found or some points are not connected. If set to false the time/weight/distance matrix will be calculated for all valid points and contain the null value for all entries that could not be calculated. The hint field of the response will also contain additional information about what went wrong (see its documentation).

turn_costs? boolean - Specifies if turn restrictions should be considered. Enabling this option increases the matrix computation time. Only supported for motor vehicles and OpenStreetMap.

graphhopper.directions: MatrixResponse

Fields

distances? decimal[][] - The distance matrix for the specified points in the same order as the time matrix. The distances are in meters. If fail_fast=false the matrix will contain null for connections that could not be found.

times? decimal[][] - The time matrix for the specified points in the order [[from1->to1, from1->to2, ...], [from2->to1, from2->to2, ...], ...]. The times are in seconds. If fail_fast=false the matrix will contain null for connections that could not be found.

weights? decimal[][] - The weight matrix for the specified points in the same order as the time matrix. The weights for different vehicles can have a different unit but the weights array is perfectly suited as input for Vehicle Routing Problems as it is currently faster to calculate. If fail_fast=false the matrix will contain null for connections that could not be found.

info? ResponseInfo - Additional information for your request

hints? MatrixresponseHints[] - Optional. Additional response data.

graphhopper.directions: MatrixresponseHints

Fields

message? string - Short description of this hint

details? string - Details of this hint

invalid_from_points? decimal[] - Optional. An array of from_point indices of points that could not be found. Will only be added if fail_fast=false and some from_points were not found.

invalid_to_points? decimal[] - Optional. An array of to_point indices of points that could not be found. Will only be added if fail_fast=false and some to_points were not found.

point_pairs? decimal[][] - Optional. An array of two-element arrays representing the from/to_point indices of points for which no connection could be found. Will only be added if fail_fast=false and some connections were not found.

graphhopper.directions: Objective

Fields

'type string - Type of objective function, i.e. min or min-max.
- min: Minimizes the objective value.
- min-max: Minimizes the maximum objective value.
For instance, min -> vehicles minimizes the number of employed vehicles. min -> completion_time minimizes the sum of your vehicle routes' completion time. If you use, for example, min-max -> completion_time, it minimizes the maximum of your vehicle routes' completion time, i.e. it minimizes the overall makespan. This only makes sense if you have more than one vehicle. In case of one vehicle, switching from min to min-max should not have any impact. If you have more than one vehicle, then the algorithm tries to constantly move stops from one vehicle to another such that the completion time of longest vehicle route can be further reduced. For example, if you have one vehicle that takes 8 hours to serve all customers, adding another vehicle (and using min-max) might halve the time to serve all customers to 4 hours. However, this usually comes with higher transport costs. If you want to minimize vehicles first and, second, completion_time, you can also combine different objectives like this:
```
"objectives" : [
   {
      "type": "min",
      "value": "vehicles"
   },
   {
      "type": "min",
      "value": "completion_time"
   }
]
```
If you want to balance activities or the number of stops among all employed drivers, you need to specify it as follows:
```
"objectives" : [
   {
      "type": "min-max",
      "value": "completion_time"
   },
   {
      "type": "min-max",
      "value": "activities"
   }
]
```

value string - The value of the objective function. The objective value transport_time solely considers the time your drivers spend on the road, i.e. transport time. In contrary to transport_time, completion_time also takes waiting times at customer sites into account. The completion_time of a route is defined as the time from starting to ending the route, i.e. the route's transport time, the sum of waiting times plus the sum of activity durations. Note that choosing transport_time or completion_time only makes a difference if you specified time windows for your services/shipments since only in scenarios with time windows waiting times can occur. The objective value vehicles can only be used along with min and minimizes vehicles.

graphhopper.directions: Pickup

Fields

Fields Included from *Stop

address Address
duration int
preparation_time int
time_windows TimeWindow[]
group string
anydata...

graphhopper.directions: Polygon

Polygon details

Fields

'type? string - Type

coordinates? decimal[][][] - Coordinates

graphhopper.directions: ProxyConfig

Closed record

Proxy server configurations to be used with the HTTP client endpoint.

Fields

host string(default "") - Host name of the proxy server

port int(default 0) - Proxy server port

userName string(default "") - Proxy server username

password string(default "") - Proxy server password

graphhopper.directions: Request

Fields

vehicles? Vehicle[] - Specifies the available vehicles.

vehicle_types? VehicleType[] - Specifies the available vehicle types. These types can be assigned to vehicles.

services? Service[] - Specifies the orders of the type "service". These are, for example, pick-ups, deliveries or other stops that are to be approached by the specified vehicles. Each of these orders contains only one location.

shipments? Shipment[] - Specifies the available shipments. Each shipment contains a pickup and a delivery stop, which must be processed one after the other.

relations? JobRelation|GroupRelation[] - Defines additional relationships between orders.

algorithm? Algorithm - Use objectives instead.

objectives? Objective[] - Specifies an objective function. The vehicle routing problem is solved in such a way that this objective function is minimized.

cost_matrices? CostMatrix[] - Specifies your own tranport time and distance matrices.

configuration? Configuration - Specifies general configurations that are taken into account when solving the vehicle routing problem.

graphhopper.directions: Response

Fields

copyrights? string[] -

status? string - Indicates the current status of the job

waiting_time_in_queue? int - Waiting time in ms

processing_time? int - Processing time in ms. If job is still waiting in queue, processing_time is 0

solution? Solution - Only available if status field indicates finished.

graphhopper.directions: ResponseAddress

Address of activity

Fields

location_id? string - Specifies the id of the location.

name? string - Name of location.

lon? float - Longitude of location.

lat? float - Latitude of location.

street_hint? string - Optional parameter. Specifies a hint for each address to better snap the coordinates (lon,lat) to road network. E.g. if there is an address or house with two or more neighboring streets you can control for which street the closest location is looked up.

snapped_waypoint? SnappedWaypoint - Access point to the (road)network. It is only available if return_snapped_waypoints is true (be default it is false).

graphhopper.directions: ResponseInfo

Additional information for your request

Fields

copyrights? string[] - Attribution according to our documentation is necessary if no white-label option included.

took? float - Took value

graphhopper.directions: Route

Fields

vehicle_id? string - Id of vehicle that operates route

distance? int - Distance of route in meter

transport_time? int - Transport time of route in seconds

completion_time? int - Completion time of route in seconds

waiting_time? int - Waiting time of route in seconds

service_duration? int - Service duration of route in seconds

preparation_time? int - Preparation time of route in seconds

activities? Activity[] - Array of activities

points? RoutePoint[] - Array of route planning points

graphhopper.directions: RoutePoint

Fields

'type? string -

coordinates? record {}[] -

graphhopper.directions: RouteRequest

Fields

points? decimal[][] - The points for the route in an array of [longitude,latitude]. For instance, if you want to calculate a route from point A to B to C then you specify points: [ [A_longitude, A_latitude], [B_longitude, B_latitude], [C_longitude, C_latitude]]

point_hints? string[] - Optional parameter. Specifies a hint for each point in the points array to prefer a certain street for the closest location lookup. E.g. if there is an address or house with two or more neighboring streets you can control for which street the closest location is looked up.

snap_preventions? string[] - Optional parameter to avoid snapping to a certain road class or road environment. Current supported values motorway, trunk, ferry, tunnel, bridge and ford

curbsides? string[] - Optional parameter. It specifies on which side a point should be relative to the driver when she leaves/arrives at a start/target/via point. You need to specify this parameter for either none or all points. Only supported for motor vehicles and OpenStreetMap.

vehicle? string - The vehicle profile for which the route should be calculated. Other vehicles are listed here for the details.

locale? string - The locale of the resulting turn instructions. E.g. pt_PT for Portuguese or de for German.

elevation? boolean - If true, a third coordinate, the altitude, is included with all positions in the response. This changes the format of the points and snapped_waypoints fields of the response, in both their encodings. Unless you switch off the points_encoded parameter, you need special code on the client side that can handle three-dimensional coordinates. A request can fail if the vehicle profile does not support elevation. See the features object for every vehicle profile.

details? string[] - Optional parameter to retrieve path details. You can request additional details for the route: street_name, time, distance, max_speed, toll, road_class, road_class_link, road_access, road_environment, lanes, and surface. Read more about the usage of path details here.

optimize? string - Normally, the calculated route will visit the points in the order you specified them. If you have more than two points, you can set this parameter to "true" and the points may be re-ordered to minimize the total travel time. Keep in mind that the limits on the number of locations of the Route Optimization API applies, and the request costs more credits.

instructions? boolean - If instructions should be calculated and returned

calc_points? boolean - If the points for the route should be calculated at all.

debug? boolean - If true, the output will be formatted.

points_encoded? boolean - Allows changing the encoding of location data in the response. The default is polyline encoding, which is compact but requires special client code to unpack. (We provide it in our JavaScript client library!) Set this parameter to false to switch the encoding to simple coordinate pairs like [lon,lat], or [lon,lat,elevation]. See the description of the response format for more information.

'ch\.disable? boolean - Use this parameter in combination with one or more parameters from below.

weighting? string - Determines the way the ''best'' route is calculated. Default is fastest. Other options are shortest (e.g. for vehicle=foot or bike) and short_fastest which finds a reasonable balance between shortest and fastest. Requires ch.disable=true.

headings? int[] - Favour a heading direction for a certain point. Specify either one heading for the start point or as many as there are points. In this case headings are associated by their order to the specific points. Headings are given as north based clockwise angle between 0 and 360 degree. This parameter also influences the tour generated with algorithm=round_trip and forces the initial direction. Requires ch.disable=true.

heading_penalty? int - Time penalty in seconds for not obeying a specified heading. Requires ch.disable=true.

pass_through? boolean - If true, u-turns are avoided at via-points with regard to the heading_penalty. Requires ch.disable=true.

block_area? string - Block road access via a point with the format latitude,longitude or an area defined by a circle lat,lon,radius or a rectangle lat1,lon1,lat2,lon2. Separate several values with ;. Requires ch.disable=true.

avoid? string - Specify which road classes and environments you would like to avoid. Possible values are motorway, steps, track, toll, ferry, tunnel and bridge. Separate several values with ;. Obviously not all the values make sense for all vehicle profiles e.g. bike is already forbidden on a motorway. Requires ch.disable=true.

algorithm? string - Rather than looking for the shortest or fastest path, this lets you solve two different problems related to routing: With round_trip, the route will get you back to where you started. This is meant for fun (think of a bike trip), so we will add some randomness. This requires ch.disable=true. With alternative_route, we give you not one but several routes that are close to optimal, but not too similar to each other. You can control both of these features with additional parameters, see below.

'round\_trip\.distance? int - If algorithm=round_trip, this parameter configures approximative length of the resulting round trip. Requires ch.disable=true.

'round\_trip\.seed? int - If algorithm=round_trip, this sets the random seed. Change this to get a different tour for each value.

'alternative\_route\.max\_paths? int - If algorithm=alternative_route, this parameter sets the number of maximum paths which should be calculated. Increasing can lead to worse alternatives.

'alternative\_route\.max\_weight\_factor? decimal - If algorithm=alternative_route, this parameter sets the factor by which the alternatives routes can be longer than the optimal route. Increasing can lead to worse alternatives.

'alternative\_route\.max\_share\_factor? decimal - If algorithm=alternative_route, this parameter specifies how similar an alternative route can be to the optimal route. Increasing can lead to worse alternatives.

graphhopper.directions: RouteResponse

Fields

paths? RouteResponsePath[] -

info? ResponseInfo - Additional information for your request

graphhopper.directions: RouteResponsePath

Fields

distance? float - The total distance, in meters. To get this information for one 'leg' please read this blog post.

time? int - The total travel time, in milliseconds. To get this information for one 'leg' please read this blog post.

ascend? float - The total ascent, in meters.

descend? float - The total descent, in meters.

points? record {} -

snapped_waypoints? record {} -

points_encoded? boolean - Whether the points and snapped_waypoints fields are polyline-encoded strings rather than JSON arrays of coordinates. See the field description for more information on the two formats.

bbox? decimal[] - The bounding box of the route geometry. Format: [minLon, minLat, maxLon, maxLat].

instructions? RouteresponsepathInstructions[] - The instructions for this route. This feature is under active development, and our instructions can sometimes be misleading, so be mindful when using them for navigation.

details? record {} - Details, as requested with the details parameter. Consider the value {"street_name": [[0,2,"Frankfurter Straße"],[2,6,"Zollweg"]]}. In this example, the route uses two streets: The first, Frankfurter Straße, is used between points[0] and points[2], and the second, Zollweg, between points[2] and points[6]. See here for discussion.

points_order? int[] - An array of indices (zero-based), specifiying the order in which the input points are visited. Only present if the optimize parameter was used.

graphhopper.directions: RouteresponsepathInstructions

Fields

text? string - A description what the user has to do in order to follow the route. The language depends on the locale parameter.

street_name? string - The name of the street to turn onto in order to follow the route.

distance? float - The distance for this instruction, in meters.

time? int - The duration for this instruction, in milliseconds.

interval? int[] - Two indices into points, referring to the beginning and the end of the segment of the route this instruction refers to.

sign? int - A number which specifies the sign to show: | sign | description | |---|---| |-98| an U-turn without the knowledge if it is a right or left U-turn | | -8| a left U-turn | | -7| keep left | | -6| not yet used: leave roundabout | | -3| turn sharp left | | -2| turn left | | -1| turn slight left | | 0| continue on street | | 1| turn slight right | | 2| turn right | | 3| turn sharp right | | 4| the finish instruction before the last point | | 5| the instruction before a via point | | 6| the instruction before entering a roundabout | | 7| keep right | | 8| a right U-turn | | *| For future compatibility it is important that all clients are able to handle also unknown instruction sign numbers

exit_number? int - Only available for roundabout instructions (sign is 6). The count of exits at which the route leaves the roundabout.

turn_angle? float - Only available for roundabout instructions (sign is 6). The radian of the route within the roundabout 0 < r < 2*PI for clockwise and -2*PI < r < 0 for counterclockwise turns.

graphhopper.directions: Routing

This contains all routing specific configurations.

Fields

calc_points? boolean - It lets you specify whether the API should provide you with route geometries for vehicle routes or not. Thus, you do not need to do extra routing to get the polyline for each route.

consider_traffic? boolean - indicates whether historical traffic information should be considered

network_data_provider? string - specifies the data provider, read more about it here.

curbside_strictness? string - In some cases curbside constraints cannot be fulfilled. For example in one-way streets you cannot arrive at a building that is on the left side of the street such that the building is to the right of you (unless you drove the one-way street the wrong/illegal way). You can set the curbside_strictness to soft to ignore the curbside constraint in such cases or set it to strict to get an error response instead. You can also set it to ignore to ignore all curbside constraints (this is useful to compare the results with and without constraints without modifying every single address).

fail_fast? boolean - indicates whether matrix calculation should fail fast when points cannot be connected

return_snapped_waypoints? boolean - Indicates whether a solution includes snapped waypoints. In contrary to the address coordinate a snapped waypoint is the access point to the (road) network.

snap_preventions? string[] - Prevents snapping locations to road links of specified road types, e.g. to motorway.

graphhopper.directions: Service

Fields

id string - Specifies the id of the service. Ids need to be unique so there must not be two services/shipments with the same id.

'type? string - Specifies type of service. This makes a difference if items are loaded or unloaded, i.e. if one of the size dimensions > 0. If it is specified as service or pickup, items are loaded and will stay in the vehicle for the rest of the route (and thus consumes capacity for the rest of the route). If it is a delivery, items are implicitly loaded at the beginning of the route and will stay in the route until delivery (and thus releases capacity for the rest of the route).

priority? int - Specifies the priority. Can be 1 = high priority to 10 = low priority. Often there are more services/shipments than the available vehicle fleet can handle. Then you can set priorities to differentiate high priority tasks from those that could be left unassigned. I.e. the lower the priority the earlier these tasks are omitted in the solution.

name? string - Meaningful name for service, e.g. "deliver pizza".

address? Address -

duration? int - Specifies the duration of the service in seconds, i.e. how long it takes at the customer site.

preparation_time? int - Specifies the preparation time in seconds. It can be used to model parking lot search time since if you have 3 identical locations in a row, it only falls due once.

time_windows? TimeWindow[] - Specifies an array of time window objects (see time_window object below). Specify the time either with the recommended Unix time stamp (the number of seconds since 1970-01-01) or you can also count the seconds relative to Monday morning 00:00 and define the whole week in seconds. For example, Monday 9am is then represented by 9hour * 3600sec/hour = 32400. In turn, Wednesday 1pm corresponds to 2day * 24hour/day * 3600sec/hour + 1day * 13hour/day * 3600sec/hour = 219600. See this tutorial for more information.

size? int[] - Size can have multiple dimensions and should be in line with the capacity dimension array of the vehicle type. For example, if the item that needs to be delivered has two size dimension, volume and weight, then specify it as follow [ 20, 5 ] assuming a volume of 20 and a weight of 5.

required_skills? string[] - Specifies an array of required skills, i.e. array of string (not case sensitive). For example, if this service needs to be conducted by a technician having a drilling_machine and a screw_driver then specify the array as follows: ["drilling_machine","screw_driver"]. This means that the service can only be done by a vehicle (technician) that has the skills drilling_machine AND screw_driver in its skill array. Otherwise it remains unassigned.

allowed_vehicles? string[] - Specifies an array of allowed vehicles, i.e. array of vehicle ids. For example, if this service can only be conducted EITHER by technician_peter OR technician_stefan specify this as follows: ["technician_peter","technician_stefan"].

disallowed_vehicles? string[] - Specifies an array of disallowed vehicles, i.e. array of vehicle ids.

max_time_in_vehicle? int - Specifies the maximum time in seconds a delivery can stay in the vehicle. Currently, it only works with services of "type":"delivery".

'group? string - Group this service belongs to. See the group relation and this post on how to utilize this.

graphhopper.directions: Shipment

Fields

id string - Specifies the id of the shipment. Ids need to be unique so there must not be two services/shipments with the same id.

name? string - Meaningful name for shipment, e.g. "pickup and deliver pizza to Peter".

priority? int - Specifies the priority. Can be 1 = high priority to 10 = low priority. Often there are more services/shipments than the available vehicle fleet can handle. Then you can set priorities to differentiate high priority tasks from those that could be left unassigned. I.e. the lower the priority the earlier these tasks are omitted in the solution.

pickup Stop -

delivery Stop -

size? int[] - Size can have multiple dimensions and should be in line with the capacity dimension array of the vehicle type. For example, if the item that needs to be delivered has two size dimension, volume and weight, then specify it as follow [ 20, 5 ] assuming a volume of 20 and a weight of 5.

required_skills? string[] - Specifies an array of required skills, i.e. array of string (not case sensitive). For example, if this shipment needs to be conducted by a technician having a drilling_machine and a screw_driver then specify the array as follows: ["drilling_machine","screw_driver"]. This means that the service can only be done by a vehicle (technician) that has the skills drilling_machine AND screw_driver in its skill array. Otherwise it remains unassigned.

allowed_vehicles? string[] - Specifies an array of allowed vehicles, i.e. array of vehicle ids. For example, if this shipment can only be conducted EITHER by "technician_peter" OR "technician_stefan" specify this as follows: ["technician_peter","technician_stefan"].

disallowed_vehicles? string[] - Specifies an array of disallowed vehicles, i.e. array of vehicle ids.

max_time_in_vehicle? int - Specifies the maximum time in seconds a shipment can stay in the vehicle.

graphhopper.directions: SnappedWaypoint

Access point to the (road)network. It is only available if return_snapped_waypoints is true (be default it is false).

Fields

lon? float - Longitude of location.

lat? float - Latitude of location.

graphhopper.directions: Solution

Only available if status field indicates finished.

Fields

costs? int - The cost

distance? int - Overall distance travelled in meter, i.e. the sum of each route's transport distance

time? int - Use transport_time instead.

transport_time? int - Overall time travelled in seconds, i.e. the sum of each route's transport time.

max_operation_time? int - Operation time of longest route in seconds.

waiting_time? int - Overall waiting time in seconds.

service_duration? int - Overall service time in seconds.

preparation_time? int - Overall preparation time in seconds.

completion_time? int - Overall completion time in seconds, i.e. the sum of each routes/drivers operation time.

no_vehicles? int - Number of employed vehicles.

no_unassigned? int - Number of jobs that could not be assigned to final solution.

routes? Route[] - An array of routes

unassigned? SolutionUnassigned - Unassigned details

graphhopper.directions: SolutionUnassigned

Unassigned details

Fields

services? string[] - An array of ids of unassigned services

shipments? string[] - An array of ids of unassigned shipments

breaks? string[] - An array of ids of unassigned breaks

details? Detail[] - An array of details, i.e. reason for unassigned services or shipments

graphhopper.directions: Stop

Fields

address? Address -

duration? int - Specifies the duration of the pickup or delivery in seconds, e.g. how long it takes unload items at the customer site.

preparation_time? int - Specifies the preparation time in seconds. It can be used to model parking lot search time since if you have 3 identical locations in a row, it only falls due once.

time_windows? TimeWindow[] - Specifies an array of time window objects (see time window object below). For example, if an item needs to be delivered between 7am and 10am then specify the array as follows: [ { "earliest": 25200, "latest" : 32400 } ] (starting the day from 0 in seconds).

'group? string - Group this stop belongs to. See the group relation and this post on how to utilize this.

graphhopper.directions: SymmetricalMatrixRequest

Fields

points? decimal[][] - Specify multiple points for which the weight-, route-, time- or distance-matrix should be calculated as follows: [longitude,latitude]. In this case the origins are identical to the destinations. Thus, if there are N points, NxN entries are calculated. The order of the point parameter is important. Specify at least three points. Cannot be used together with from_point or to_point..

point_hints? string[] - Optional parameter. Specifies a hint for each point in the points array to prefer a certain street for the closest location lookup. E.g. if there is an address or house with two or more neighboring streets you can control for which street the closest location is looked up.

snap_preventions? string[] - Optional parameter to avoid snapping to a certain road class or road environment. Current supported values motorway, trunk, ferry, tunnel, bridge and ford

curbsides? string[] - Optional parameter. It specifies on which side a point should be relative to the driver when she leaves/arrives at a start/target/via point. You need to specify this parameter for either none or all points. Only supported for motor vehicles and OpenStreetMap.

out_arrays? string[] - Specifies which matrices should be included in the response. Specify one or more of the following options weights, times, distances. The units of the entries of distances are meters, of times are seconds and of weights is arbitrary and it can differ for different vehicles or versions of this API.

vehicle? string - The vehicle profile for which the route should be calculated. Other vehicles are listed here for the details.

fail_fast? boolean - Specifies whether or not the matrix calculation should return with an error as soon as possible in case some points cannot be found or some points are not connected. If set to false the time/weight/distance matrix will be calculated for all valid points and contain the null value for all entries that could not be calculated. The hint field of the response will also contain additional information about what went wrong (see its documentation).

turn_costs? boolean - Specifies if turn restrictions should be considered. Enabling this option increases the matrix computation time. Only supported for motor vehicles and OpenStreetMap.

graphhopper.directions: TimeWindow

Fields

earliest? int - Specifies the opening time of the time window in seconds, i.e. the earliest time the service can start.

latest? int - Specifies the closing time of the time window in seconds, i.e. the latest time the service can start.

graphhopper.directions: TimeWindowBreak

Fields

earliest int - Specifies the earliest start time of the break in seconds.

latest int - Specifies the latest start time of break in seconds.

duration int - Specifies the duration of the break in seconds.

graphhopper.directions: Vehicle

Fields

vehicle_id string - Specifies the ID of the vehicle. Ids must be unique, i.e. if there are two vehicles with the same ID, an error is returned.

type_id? string - The type ID assigns a vehicle type to this vehicle. You can specify types in the array of vehicle types. If you omit the type ID, the default type is used. The default type is a car with a capacity of 0.

start_address Address -

end_address? Address -

'break? TimeWindowBreak|DriveTimeBreak -

return_to_depot? boolean - If it is false, the algorithm decides where to end the vehicle route. It ends in one of your customers' locations. The end is chosen such that it contributes to the overall objective function, e.g. min transport_time. If it is true, you can either specify a specific end location (which is then regarded as end depot) or you can leave it and the driver returns to its start location.

earliest_start? int - Earliest start of vehicle in seconds. It is recommended to use the unix timestamp.

latest_end? int - Latest end of vehicle in seconds, i.e. the time the vehicle needs to be at its end location at latest.

skills? string[] - Array of skills, i.e. array of string (not case sensitive).

max_distance? int - Specifies the maximum distance (in meters) a vehicle can go.

max_driving_time? int - Specifies the maximum drive time (in seconds) a vehicle/driver can go, i.e. the maximum time on the road (service and waiting times are not included here)

max_jobs? int - Specifies the maximum number of jobs a vehicle can load.

min_jobs? int - Specifies the minimum number of jobs a vehicle should load. This is a soft constraint, i.e. if it is not possible to fulfill “min_jobs”, we will still try to get as close as possible to this constraint.

max_activities? int - Specifies the maximum number of activities a vehicle can conduct.

move_to_end_address? boolean - Indicates whether a vehicle should be moved even though it has not been assigned any jobs.

graphhopper.directions: VehicleType

Fields

type_id string - Specifies the id of the vehicle type. If a vehicle needs to be of this type, it should refer to this with its type_id attribute.

profile? string - Specifies the vehicle profile of this type. The profile is used to determine the network, speed and other physical attributes to use for routing the vehicle.

capacity? int[] - Specifies an array of capacity dimension values which need to be int values. For example, if there are two dimensions such as volume and weight then it needs to be defined as [ 1000, 300 ] assuming a maximum volume of 1000 and a maximum weight of 300.

speed_factor? float - Specifies a speed factor for this vehicle type. If the vehicle that uses this type needs to be only half as fast as what is actually calculated with our routing engine then set the speed factor to 0.5.

service_time_factor? float - Specifies a service time factor for this vehicle type. If the vehicle/driver that uses this type is able to conduct the service as double as fast as it is determined in the corresponding service or shipment then set it to 0.5.

cost_per_meter? float - BETA feature! Cost parameter per distance unit, here meter is used

cost_per_second? float - BETA feature! Cost parameter per time unit, here second is used

cost_per_activation? float - BETA feature! Cost parameter vehicle activation, i.e. fixed costs per vehicle

consider_traffic? boolean - Specifies whether traffic should be considered. if "tomtom" is used and this is false, free flow travel times from "tomtom" are calculated. If this is true, historical traffic info are used. We do not yet have traffic data for "openstreetmap", thus, setting this true has no effect at all.

network_data_provider? string - Specifies the network data provider. Either use openstreetmap (default) or tomtom (add-on required).

Union types

graphhopper.directions: MatrixCalculateBody

MatrixRequest|SymmetricalMatrixRequest

MatrixCalculateBody

graphhopper.directions: MatrixBody

MatrixRequest|SymmetricalMatrixRequest

MatrixBody

String types

graphhopper.directions: VehicleProfileId

string

VehicleProfileId

graphhopper.directions: EncodedLineString

string

EncodedLineString

A polyline-encoded list of positions. You'll need to decode this string in client code. We provide open source code in Java and JavaScript.

Import

import ballerinax/graphhopper.directions;

Other versions

1.5.2

1.5.1 1.5.0 1.4.0 1.2.0

Metadata

Released date: 9 days ago

Version: 1.5.2

License: Apache-2.0

Compatibility

Platform: any

Ballerina version: 2201.8.0

GraalVM compatible: Yes

Pull count

Total: 27

Current verison: 5

Weekly downloads

Source repository

Keywords

Type/Connector

Vendor/GraphHopper

Area/Cloud & Infrastructure

IT Operations/Cloud Services

Cost/Freemium

Contributors

Dependencies

ballerina/url/2.4.0 ballerina/http/2.10.24

Cookie policy

Delete policy

clients

records

unionTypes

stringTypes

ballerinax/graphhopper.directions Ballerina library

Overview

Key Features

Prerequisites

Clients

graphhopper.directions: Client

Constructor

getRoute

Parameters

Return Type

postRoute

Parameters

Return Type

getCoverageInformation

Return Type

getIsochrone

Parameters

Return Type

getMatrix

Parameters

Return Type

postMatrix

Parameters

Return Type

calculateMatrix

Parameters

Return Type

getMatrixSolution

Parameters

Return Type

postGPX

Parameters

Return Type

getGeocode

Parameters

Return Type

solveVRP

Parameters

Return Type

asyncVRP

Parameters

Return Type

getSolution

Parameters

Return Type

solveClusteringProblem

Parameters

Return Type

asyncClusteringProblem

Parameters

Return Type

getClusterSolution

Parameters

Return Type

Records

graphhopper.directions: Activity

Fields

graphhopper.directions: Address

Fields

graphhopper.directions: Algorithm

Fields

Deprecated

graphhopper.directions: ApiKeysConfig

Fields

graphhopper.directions: BadRequest

Fields

graphhopper.directions: ClientHttp1Settings

Fields

graphhopper.directions: Cluster

Fields

graphhopper.directions: ClusterConfiguration

Fields

graphhopper.directions: ClusterConfigurationClustering

Fields

graphhopper.directions: ClusterConfigurationRouting

Fields