Class: Routing

cercaliagl.service/Routing


Javascript ES5

const routingService = new cercaliagl.service.Routing({ ... });

Routing class calculate routes between two or more points. It make calls against Cercalia WS (https://www.cercalia.com/Documentacion/webservices/calculo-de-rutas).
There are many options to calculate route, below in constructor options those are listed.
This class can calculate logistics route for vans and trucks.

Example usage:

const routingService = new cercaliagl.service.Routing({
  origin: new cercaliagl.LonLat(-3.712916732, 40.440202761),
  destination: new cercaliagl.LonLat(-3.669923363, 40.443071692)
  weight: 'time'
});

routingService.calculateRoute((data) => {
  // Draw feature with route.
  if (data.cercalia.route.stages && data.cercalia.route.stages.stage) {
    const wkt = data.cercalia.route.stages.stage[0].wkt.value
    const feature = new cercaliagl.Feature({wkt: wkt});
    map.addFeature(feature);
    map.centerToFeatures([feature]);
  }
});

new Routing(opt_options)

service/Routing.js, line 108
Name Type Description
options

Options

Name Type Description
destination module:cercaliagl/LonLat~LonLat | module:cercaliagl/service/Routing~RoutingStep

Destination coordinates.
edges boolean

Get edges IDs
infoedges boolean

Adds specific information for each section to the route report.
An infoedges tag is added to each substage with specific information of each section.
The following attributes are reported for each section:
height: height from sea level in meters.
gradient: slope of the section
geometry: Stretch geometry
meters: Length of the section
maxkph: Legal maximum speed.
lang string

Report language (only if report parameter is true).
mindist boolean

Minimum substage distance, in meters. The larger this distance , the smaller the number of substages. Default value 1000.
origin module:cercaliagl/LonLat~LonLat | module:cercaliagl/service/Routing~RoutingStep

Origin coordinates.
reorder boolean

Specify if you want to reorder or not the route stops, to get the faster/shorter route. Maximum 10 stop points.
report boolean

Get the textual route report (if not, gets a faster response). Default 0.
steps Array.<module:cercaliagl/LonLat~LonLat> | Array.<module:cercaliagl/service/Routing~RoutingStep>

Array with stop points coordinates.
tolerance number

Route geometry generalization, in meters (if =0, returns the original geometry). Default value 5 (meters).
toll boolean

Specify if you need to get the toll roads cost for the route. Currently only avaliable for Spain, Portugal and Andorra. Default false.
weight string

Route type: time (faster), distance (shorter), money (toll free route). Default value: time.
vweight number

Route logistics parameter. Total maximum vehicle weight.
vaxleweight number

Route logistics parameter. Maximum vehicle axle weight.
vheight number

Route logistics parameter. Maximum vehicle height.
vlength number

Route logistics parameter. Maximum vehicle length.
vwidth number

Route logistics parameter. Maximum vehicle width.
vmaxvel number

Route logistics parameter. Maximum vehicle speed.
rimp boolean

Route logistics parameter. Dangerous goods
trinfodate string

Route logistics parameter. Number days to consecutives to show restrictions. Info date format YYYYMMDD.
trinfodays number

Route logistics parameter. Avoid route restrictions. In timestamp format.
trstart number

Route logistics parameter. Avoid route restrictions. In timestamp format.
originIsDepot boolean

This parameter only works if REORDER parameter is used. Values:
true (default): origin cannot be reordered (default).
false: origin is one more stop and can be reordered. Useful when you cannot choose the starting point of the vehicle.
destinationIsDepot boolean

This parameter only works if REORDER parameter is used. Values:
true (default): Destination cannot be reordered (default).
false: Destination is one more stop and can be reordered. Useful when after attending some services you don’t have to return to a base.
concurrency boolean | undefined

Default true. Multiple requests at same time. If false it cancel previous pending requests.
departuretime string

Departure time in format ISO8601.

Extends

  • module:cercaliagl/service/Service~Service

Methods

addStep(step)

service/Routing.js, line 382

Add step (or waypoint).

Name Type Description
step module:cercaliagl/LonLat~LonLat | module:cercaliagl/service/Routing~RoutingStep

Step.

calculateRoute(callbackFn, callbackErrorFn)

service/Routing.js, line 777

Calcula la ruta especificando una funcion de callback que se ejecuta al volver el resultado

Name Type Description
callbackFn function

Callback Function after calculate route
callbackErrorFn function

Callback Error Function after calculate route error.

clear()

service/Routing.js, line 645

Clear all option values to calculate route.

getDeparturetime(){string}

service/Routing.js, line 584
Returns:
Departuretime

getDestination(){module:cercaliagl/LonLat~LonLat|module:cercaliagl/service/Routing~RoutingStep}

service/Routing.js, line 373

Get route destination position

Returns:
lonLat Destination

getDestinationIsDepot(){boolean}

service/Routing.js, line 930
Returns:
Get destinationisdepot parameter value.

getEdges(){boolean}

service/Routing.js, line 460
Returns:
edges true or false if edges option is enabled.

getInfoedges(){boolean}

service/Routing.js, line 484
Returns:
edges true or false if edges option is enabled.

getMindist(){number}

service/Routing.js, line 601
Returns:
Get minimum distance option.

getNumSteps(){number}

service/Routing.js, line 409

Return number of way points.

Returns:
Number of way points.

getOrigin(){module:cercaliagl/LonLat~LonLat|module:cercaliagl/service/Routing~RoutingStep}

service/Routing.js, line 349

Get route origin position

Returns:
lonLat Origin

getOriginIsDepot(){boolean}

service/Routing.js, line 914
Returns:
Get originisdepot parameter value.

getPoicats(){Array.<string>}

service/Routing.js, line 500
Returns:
poicats Array of POI categories.

getResponse(){Object}

service/Routing.js, line 861

Get response

Returns:
response

getRouteId(routeIndex){string|null}

service/Routing.js, line 879

Get Route Id (internal id from Cercalia servers)

Name Type Description
routeIndex number (defaults to 0)

Route index alternative.
Returns:
Cercalia route id

getRoutes(){Array.<module:cercaliagl/servers~RoutingResultRoute>|null}

service/Routing.js, line 869

getShowBreaktimes(){boolean}

service/Routing.js, line 568
Returns:
Show break times.

getStages(routeIndex){Array.<module:cercaliagl/servers~RoutingResultStages>|null}

service/Routing.js, line 852

Obtiene stages.

Name Type Description
routeIndex number (defaults to 0)

Route index alternative.
Returns:
WKT de la ruta calculada. Devuelve null si no se ha calculado ninguna

getSteps(){Array.<(LonLat|RoutingStep)>|Array.<module:cercaliagl/LonLat~LonLat>|Array.<module:cercaliagl/service/Routing~RoutingStep>}

service/Routing.js, line 400

Get all steps

Returns:
Steps

getTolerance(){number}

service/Routing.js, line 443
Returns:
tolerance

getTollX(){string}

service/Routing.js, line 552
Returns:
intoll_x Get ifalculating route using roads with tolls is enabled.

getWeight(){string}

service/Routing.js, line 610

Get route weight time|realtime|money|distance

Returns:
Route weight

getWKT(routeIndex){string|null}

service/Routing.js, line 839

Obtiene WKT de la ruta calculada

Name Type Description
routeIndex number (defaults to 0)

Route index alternative.
Returns:
WKT de la ruta calculada. Devuelve null si no se ha calculado ninguna

isAlternatives(){boolean}

service/Routing.js, line 947
Returns:
Return if alternatives flag is enabled

isLogistics(){boolean}

service/Routing.js, line 898
Returns:
true if route has logistics parameters.

isReady(){boolean}

service/Routing.js, line 670

Returns true if it is ready to calculate. When options has been set. (minimum origin and destination)

Returns:
true if can calculate route.

isReorder(){boolean}

service/Routing.js, line 518

Get if reorder options to calculate route is enabled.

Returns:
Reorder true or false.

isReporting(){boolean}

service/Routing.js, line 426
Returns:
report true if report is enabled. Else false.

isToll(){boolean}

service/Routing.js, line 536

Get if toll option is enabled.

Returns:
Toll is true or false.

setAlternatives(destinationIsDepot)

service/Routing.js, line 939

Enable alternatives routing calculation

Name Type Description
destinationIsDepot boolean

Enable alternatives flag

setDeparturetime(departuretime)

service/Routing.js, line 576
Name Type Description
departuretime string

Departuretime. Example: 2019-08-26T11:49+02:00-

setDestination(destination)

service/Routing.js, line 358

Set route destination

Name Type Description
destination module:cercaliagl/LonLat~LonLat | module:cercaliagl/service/Routing~RoutingStep

Destination

setDestinationIsDepot(destinationIsDepot)

service/Routing.js, line 922
Name Type Description
destinationIsDepot boolean

Enable destinationisdepot parameter

setEdges(edges)

service/Routing.js, line 452

Set to get edges from route calculation.

Name Type Description
edges number

Edges options enabled true. Else false.

setInfoedges(infoedges)

service/Routing.js, line 476

Adds specific information for each section to the route report.
An infoedges tag is added to each substage with specific information of each section.
The following attributes are reported for each section:
height: height from sea level in meters.
gradient: slope of the section
geometry: Stretch geometry
meters: Length of the section
maxkph: Legal maximum speed

Name Type Description
infoedges boolean

Enable true. Else false.

setLogistics(isLogistics)

service/Routing.js, line 890
Name Type Description
isLogistics boolean

Enable logistic route.

setLogisticsParams(logisticsParams)

service/Routing.js, line 627
Name Type Description
logisticsParams

Logistics params.

Name Type Description
vweight number

Vehicle max wegiht
vaxleweight number

Vehicle max axle weight
vheight number

Vehicle max height
vlength number

Vehicle max length
vwidth number

Vehicle max width
vmaxvel number

Vehicle max speed
rimp boolean

Dangerous goods
trinfodate string

YYYYMMDD
trinfodays number

Number days to consecutives to show restrictions.
trstart number

Avoid route restrictions. In timestamp format.

setMindist(mindist)

service/Routing.js, line 593

Set minimum distance option.

Name Type Description
mindist number

Minimum distance

setOrigin(origin)

service/Routing.js, line 334

Set route origin

Name Type Description
origin module:cercaliagl/LonLat~LonLat | module:cercaliagl/service/Routing~RoutingStep

Origin

setOriginIsDepot(originIsDepot)

service/Routing.js, line 906
Name Type Description
originIsDepot boolean

Enable originisdepot parameter

setPoicats(poicats)

service/Routing.js, line 492
Name Type Description
poicats Array.<string>

Array of POI categories.

setReorder(reorder)

service/Routing.js, line 509

Enable calculation route reorder points in calculation.

Name Type Description
reorder boolean

true or false.

setReporting(reporting)

service/Routing.js, line 418

Enable route report.

Name Type Description
reporting boolean

Boolean to enable route report. (First need to calculate route).

setShowBreaktimes(showBreakTimes)

service/Routing.js, line 560
Name Type Description
showBreakTimes boolean

Show break times.

setSteps(steps)

service/Routing.js, line 391

Set steps passing an array.

Name Type Description
steps Array.<(module:cercaliagl/LonLat~LonLat|module:cercaliagl/service/Routing~RoutingStep)>

Steps.

setTolerance(tolerance)

service/Routing.js, line 435

Route tolerance

Name Type Description
tolerance number

Tolerance

setToll(toll)

service/Routing.js, line 527

Enable tolls in route calculation.

Name Type Description
toll boolean

true or false.

setTollX(intoll_x)

service/Routing.js, line 544
Name Type Description
intoll_x string

Calculating route using roads with tolls.

setWeight(weight)

service/Routing.js, line 619

Set weight to calculate route. Weight values available: time|realtime|money|distance

Name Type Description
weight string

Weight. time|realtime|money|distance