REST API, Service version 1.0.0

Routing#

Performs route computations through the road network. Also performs isochrone and origin destination matrix calculations.

Summary#

Request
1. Mandatory parameters
2. Optional parameters
Response
1. Details of fields
2. Response samples

Request#

The request must be sent with the HTTP method POST and the HTTP header Content-Type set to application/json.

Sample: URI: /bgis/service/routing/1.0 for JSON default format. Or URI: /bgis/service/routing/1.0.csv for CSV output format.

POST data:

javascript

{
	"destinations": [
		{
			"coordinateSat" : {
				"lon" : 7.41059,
				"lat" : 43.73446
			}
		},
		{
			"coordinateSat" : {
				"lon" : 7.15376,
				"lat" : 43.72189
			}
		},
		{
			"coordinateSat" : {
				"lon" : 7.15092,
				"lat" : 43.66244
			}
		},
		{
			"coordinateSat" : {
				"lon" : 7.12901,
				"lat" : 43.62986
			}
		}
	],
	"routingVehicleProfile" : {
		"transportMode" : "CAR",
		"routingVehicleFeature" : {
			"height" : 380,
			"width" : 40,
			"length" : 1875,
			"weight" : 35,
			"axleWeight" : 10
			
		}
	},
	"routingMode" : "MODE_VIAS",
	"routingCriterias" : [ "FASTEST" ],
	"outputLanguage": "fr"
}

All coordinates are defined by longitude and latitude, see the coordinate system glossary for more details.

Parameters#

destinationsRoutingDest[]required
A list of coordinates that will be used to perform the routing calculation, isochrone, matrix, etc. The number of required coordinates depends of the selected routing mode (see routingMode parameter).
RoutingDest fields
- coordinateSatCoordinateSat
  GPS coordinates.
  CoordinateSat fields
  - lonnumber (double)required
    Longitude in degrees decimal (WGS84).
    Also accepted as longitude.
  - latnumber (double)required
    Latitude in degrees decimal (WGS84).
    Also accepted as latitude.
  - headingnumber (double)
    Heading in degrees.
  - speednumber (float)
    Speed in km/h.
  - timeinteger (int64)
    GPS time in milliseconds (EPOCH).
  - satinteger (int32)
    Number of GPS satellites available.
- radiusinteger (int64)
  Radius in meters of the waypoint. This radius defines the maximum distance the route calculation should approach the waypoint.
- ignorePointboolean
  Defines if this waypoint is ignored by the route calculation.
- ignoreTrafficDirectionsboolean
  Defines if traffic directions should be ignored by route calculation between this waypoint and next one.
- ignoreRoadBlocksboolean
  Defines if road blocks should be ignored by route calculation between this waypoint and next one. See the routingRoadBlocks parameter.
- ignoreRestrictionsboolean
  Defines if forbidden maneuvers and blocked passages should be ignored by route calculation between this waypoint and next one.
- avoidUTurnenum
  Defines if a UTurn should be avoided by route calculation on this waypoint.
  3 accepted values
  UNDEF Status undefined.
  YES Status yes.
  NO Status no.
- useStartAngleenum
  If set to YES and waypoint is located on a two-way road and heading is defined, waypoint's heading will be used as a general direction for departure from this waypoint. See the heading parameter.
  3 accepted values
  UNDEF Status undefined.
  YES Status yes.
  NO Status no.
- useStopRoadSideenum
  Defines if route calculation must arrive on this waypoint on its side (if waypoint is on a two-way road).
  3 accepted values
  UNDEF Status undefined.
  YES Status yes.
  NO Status no.
- keptByMinimalWpboolean
  This parameter keptByMinimalWp (previously mandatory) will be used by the traceroute API. When the value is set to true and the option NO_MINIMAL_WAYPOINTS is not defined, the waypoint will be kept in the way-points response array.
  Also accepted as mandatory.
- stopDurationinteger (int32)
  Stop duration in seconds associated to the destination coordinate.
- customDataCustomDt[]
  Custom data is a list that can be used to set some custom information about the waypoint in input and retrieve in response.
  CustomDt fields
  - keystring
  - valuestring
geoserverstring
Geoserver name.
swidxinteger (int32)deprecated
Switch index.

routingModeenum

Defines the route calculation mode. Default is MODE_VIAS.

6 accepted values

`MODE_VIAS`	Computes a serie of routes between successive couples of via coordinates. Examples: from C1 to C2 OR from C1 to C2 to ... to Cn.
`MODE_1_TO_N`	Computes routes between a start coordinate to a list of destination coordinates. Examples (Cd is departure): from Cd to C1 OR from Cd to C1, from Cd to C2, ..., from Cd to Cn.
`MODE_N_TO_1`	Computes routes between a list of start coordinates to a destination coordinate. Examples (Ca is arrival): from C1 to Ca OR from C1 to Ca, from C2 to Ca, ... from Cn to Ca.
`MODE_N_TO_N`	Computes n² routes between each couples of a list of n coordinates.
`MODE_MATRIX`	Computes a n x p matrix of path weights between each pair of a list of origin and destination coordinates. Path weights are defined in seconds if `FASTEST` mode, meters if `SHORTEST` mode or Wh (Watt-hour) if `ECO_ENERGY` mode.
`MODE_ISOCHRONE`	Builds an isochrone polygon around one or two coordinates. With 1 coordinate: Builds an isochrone polygon representing the area that can be reached through the road network starting from this coordinate with a given limit of time or distance or energy. With two coordinates: Build the isochrone polygon representing the area that can be reached through the road network starting from start, ending at stop and with a given limit of time or distance or energy.

routingCriteriasenum[]

Criteria used to perform the routing calculation like shortest, fastest. Comma-separated list of one or more criteria. If empty or not set the default value is FASTEST.

10 accepted values

`FASTER`	Find the route which optimizes travel time.
`FASTEST`	Find the route which optimizes travel time. Default value.
`SHORTEST`	Find the route which optimizes travel distance.
`ECO_ENERGY`	Find the route which optimizes travel energy consumption.
`AVOID_FERRIES`	Finds a route which avoids ferries.
`AVOID_MOTORWAYS`	Finds a route which avoids motorways.
`AVOID_TOLLS`	Finds a route which avoids tolls.
`AVOID_UNPAVED`	Finds a route which avoids unpaved roads.
`AVOID_CROSSING_BORDER`	Finds a route which avoids country border crossings (only when all coordinates are in a same country).
`CARPOOL`	Finds a route which avoids roads reserved to carpooling.

preferredRoadsRoutingPrefRoad[]

Defines speed coefficients for specific road attributes. Only when fastest criterium is set. This parameter can be repeated.

RoutingPrefRoad fields

factornumber (float)required
Speed coefficient. This coefficient will alter the speed defined in the map data. If < 1 it will slow down the speed, if > 1 it will increase the speed (1 = unchanged). Range ]0, 256].

routingRoadAttributeenumrequired

Defines the road's attribute associated to the specific speed coefficients (factor parameter).

25 accepted values

`PREFERRED_UNDEFINED`	Roads belonging to preferred undefined network.
`PREFERRED_STAA`	Roads belonging to preferred STAA network.
`PREFERRED_NATIONAL_ACCESS`	Roads belonging to preferred national access network.
`PREFERRED_TRUCK_ROUTE`	Roads belonging to preferred route truck network.
`PREFERRED_TRUCK_BYPASS`	Roads belonging to preferred bypass truck network.
`PREFERRED_TRUCK_LOCAL`	Roads belonging to preferred local truck network.
`PREFERRED_HAZMAT_NRHM`	Roads belonging to preferred NRHM hazmat network.
`PREFERRED_HAZMAT_EXPLOSIVES`	Roads belonging to preferred explosive hazmat network.
`PREFERRED_HAZMAT_PIH`	Roads belonging to preferred PIH hazmat network.
`PREFERRED_HAZMAT_MEDICAL`	Roads belonging to preferred medical hazmat network.
`PREFERRED_HAZMAT_RADIOACTIVE`	Roads belonging to preferred radioactive hazmat network.
`PREFERRED_HAZMAT_GENERAL`	Roads belonging to preferred general hazmat network.
`PREFERRED_TOURIST_SCENIC`	Roads belonging to preferred tourist scenic roads.
`PREFERRED_TOURIST_HISTORIC`	Roads belonging to preferred tourist historic roads.
`PREFERRED_B_DOUBLES`	Roads belonging to preferred B-Doubles.
`PREFERRED_TOURIST_NATIONAL`	Roads belonging to preferred tourist national route.
`PREFERRED_TOURIST_REGIONAL`	Roads belonging to preferred tourist regional route.
`PREFERRED_TOURIST_NATURE`	Roads belonging to preferred tourist nature route.
`PREFERRED_WEIGHT_DEPENDENT`	Roads belonging to weight dependent preferred network.
`TOLL_ROAD`	Roads with tolls.
`BUILT_UP`	Roads belonging to built-up areas.
`TUNNEL`	Roads in tunnels.
`BRIDGE`	Roads on bridges.
`TAX`	Roads submitted to government tax (like German MAUT, etc.).
`CARPOOL`	Roads reserved to carpooling.

routingPonderationTypeenum

Defines if speed coefficient applies only for searching the fastest route or for calculating the route's travel time (ETA) or both. ALL by default.

3 accepted values

`ALL`	Speed coefficient applies both for finding the fastest route and calculating its ETA. Default value.
`CAL`	Speed coefficient applies only searching for the fastest route (only when fastest criteria is set).
`ETA`	Speed coefficient applies only for calculating route's travel time (ETA).

routingRoadBlocksRoutingRoadBlck[]

List of road blocks. Specifies a location where route must not go through.

RoutingRoadBlck fields

objectIdBase64string
Segment object ID to apply the road block.
coordinateCoordinate
Coordinate WGS84.
Coordinate fields
- lonnumber (double)required
  Longitude in degrees decimal (WGS84).
  Also accepted as longitude.
- latnumber (double)required
  Latitude in degrees decimal (WGS84).
  Also accepted as latitude.
headinginteger (int32)
Heading in degrees (optional).
uniDirectionalboolean
If true, this road block will only apply in direction defined by a heading (optional). Applies only if a heading parameter has been defined
ponderationnumber (float)
The speed coefficient in range [0, 256] of this road block (0 will close the road segment).

ponderationTypeenum

Defines if speed coefficient applies only for searching the fastest route or for calculating the route's travel time (ETA) or both. ALL by default.

3 accepted values

`ALL`	Speed coefficient applies both for finding the fastest route and calculating its ETA. Default value.
`CAL`	Speed coefficient applies only searching for the fastest route (only when fastest criteria is set).
`ETA`	Speed coefficient applies only for calculating route's travel time (ETA).

avoidCountryCodesstring[]
List of country code will be avoided. The ISO3166 Alpha3 country code of the country to add.

optionsenum[]

Comma-separated list of one or more options.

63 accepted values

`MAPMATCH_AVOID_TUNNEL`	Avoid tunnel during the map matching of input coordinates.
`MAPMATCH_AVOID_BRIDGE`	Avoid bridge during the map matching of input coordinates.
`STARTSTOPINFO_WITHVIA`	Returns the start/stop information with via coordinates found by the routing calculation.
`ROUTESHEET`	Returns the route sheet.
`ROUTESHEET_VERBOSE_LOW`	Low level of verbosity for the route sheet (default).
`ROUTESHEET_VERBOSE_MEDIUM`	Medium level of verbosity for the route sheet.
`ROUTESHEET_VERBOSE_HIGH`	High level of verbosity for the route sheet.
`FENCE_SHAPE`	Enables the tests between route found and geometric fences. Return the shape of fence used to perform the test.
`POLYLINE`	Returns the polyline geometry of the entire itinerary. For segmentation of this geometry, see the `EVENT` and `EVT_POLYINE` options.
`DETAILED_POLYLINE`	Returns the polyline geometry of the itinerary with more information for each sub-segments. Deprecated, use events system (like `EVENT`, `EVT_POLYLINE`) instead.
`POLYLINE_INDEX`	Enables the index calculation of the used destination on the polyline. Deprecated, use events system (like `EVENT`, `EVT_POLYLINE`) instead.
`OPENLR`	Attempt to return the geometry of the route as an encoded OpenLR base64 string. Some routes cannot be encoded in OpenLR (like U-turns).
`SEGMENTIDS`	Returns the list of segment id of itinerary.
`ROAD_SEGMENTS`	Returns the list of road segments of the itinerary. See in response the field `roadSegments`.
`JUNCTION_NODES`	Returns the junction nodes of the itinerary. See in response the field `junctionNodes`.
`WAYPOINTS`	Returns the waypoints of itinerary. A waypoint is a coordinate with properties that can be used to reproduce the computed route on other device or server.
`MINIMAL_WAYPOINTS`	Sub option of `WAYPOINTS` option. Enables the minimal waypoints algorithm. By default the waypoint list contains all waypoints. This option reduces the list to the necessary waypoints to reproduce the route.
`WAYPOINTS_POLYLINE`	Returns the polyline of the route including the waypoints coordinate.
`TRAFFIC`	Use the traffic info for routing.
`TRAFFIC_PREDICTIVE`	Use the predictive traffic info for routing.
`TRAFFIC_PATTERNS`	Need the additional `DepartureTime` or `arrivalTime` parameter to work. Use the traffic patterns for routing. This option does not have any effect if the loaded SVS map data does not contain either the HERE Traffic Patterns or TomTom Speed Profiles databases.
`OPTIMIZED_TRIP`	Computes an optimized travel through location points. Keep the start and stop points. An optional departure date time (local time) to be used for time dependent restrictions and speeds.
`OPTIMIZED_TRIP_ROUND`	See `OPTIMIZED_TRIP` option. Keep the start and come back to the initial point, but don't close the route. To close the route add `OPTIMIZED_TRIP_CLOSED` option.
`OPTIMIZED_TRIP_UNDEFSTOP`	See `OPTIMIZED_TRIP` option. Trip from a start point to an undefined final point.
`OPTIMIZED_TRIP_CLOSE`	See `OPTIMIZED_TRIP` options. Close the route by performing a routing calculation between the end point and the start point of ordered input coordinates.
`ENERGY_CONSUMPTION`	Returns the energy consumption estimation (`energyConsumption` field). This option requires the Energy vehicle feature, see field `routingVehicleProfile` and sub field `routingEnergyVehicleFeature`.
`TOLL_COST`	Enables the toll cost calculation. This option requires the Vehicle Profile, see field `routingVehicleProfile` and sub field `routingVehicleFeature`. Contact the support for the required map data. Deprecated replaced by EVT_TOLL_COST option.
`TAX_COST`	Enables the tax cost calculation. This option requires the Vehicle Profile, see field `routingVehicleProfile` and sub field `routingVehicleFeature`. Contact the support for the required map data. Deprecated replaced by `EVT_TAX_COST` option.
`ECO_TAX`	Enables the eco-tax calculation. The Vehicle feature (vf) and Euro emission class are mandatory. You can use the additional DepartureTime parameter. Deprecated replaced by `EVT_TAX_COST` option.
`SORTBY_USED_ORDER`	Sort the UsedDestinations section by the value of `useOrder` field.
`REVGEO_STRICT_DISABLE`	Disables the exception event when a coordinate entry is not found.
`REVGEO_POSTAL_ADDRESS`	Returns the postal addresses of matched input coordinates.
`ISOCHRONE_FORWARD`	Isochrone is built in the direction of traffic flow.
`ISOCHRONE_BACKWARD`	Isochrone is built in reverse direction of traffic flow. (by default).
`OPTIMIZED_ROUTE_FOR_CHARGING_STATION`	Optimizes electric vehicles charges. Checks if the route is feasible with the. current vehicle profile and the given smart routing profile. If not, the method will try to find optimal (according to the criteria used to compute the route) charging stops. Deprecated used the EV Smart Routing API instead.
`MATRIX_COMPLEMENT`	Matrix complement's path weights are defined in meters if fastest mode, seconds otherwise. Also, for performance question, these weights are calculated only for couples of points which are close to each other. For other couples of points, the default value of complement is 0x0FFFFFFF.
`MATRIX_FOR_ROUND_OPTIM`	When using the MODE_MATRIX routing mode, this option allows faster matrix computations (by ignoring some coefficients of the matrix) if the returned matrix is intended to be consumed by an external Round Trip Optimization service. Indicates if this method is used to make a round optimization (and therefore number of destination = 0). I this case, some coefficients of the matrix will not be calculated as it is assumed they are not relevant for the route optimization. This allows a faster matrix computation.
`EVENT`	Enables structure of events on road. See sub options `EVT_xxxxx` other values. At a minimum the information returned is the country code of every road segment. Each event indicates the distance, travel time and percentage from start.
`EVT_DUPLICATE_FILTER`	Sub option of `EVENT` option. Enables filter on repeated values. Avoids repeating events on every road segments when there are no changes.
`EVT_ENTRY_VALUE_AS_OBJECT`	Sub option of `EVENT` option. Enables generation of entrie's values as a JSON object instead of encapsulating in a string format.
`EVT_ROAD_FEATURE`	Sub option of `EVENT` option. Enables the road features such as: maximum speed, bridge, tunnel, number of lanes in each direction, etc.
`EVT_PROHIBITED_DRIVING`	Sub option of `EVENT` option. Enables the prohibited driving information like against traffic direction (`againstTrafficDir`), prohibited turn (`prohibitedTurn`) and prohibited blocked passage (`prohibitedBlockedPassage`).
`EVT_ELEVATION`	Sub option of `EVENT` option. Enables the elevation of road segments. Returns the altitude of first point and last point in two entries. Deprecated, use `EVT_ELEVATION2` instead.
`EVT_ELEVATION2`	Sub option of `EVENT` option. Enables the elevation of road segments. Returns the altitude of first point and last point in one entry.
`EVT_OBJECTID_BASE64`	Add object ID information encoded in base64. An BeNomad Object ID is linked to a map data release.
`EVT_SEGMENT_INFO`	Sub option of `EVENT` option. Enables the road segments information. Returns the ID of road segment (if available in the map data) and the reverse direction flag that indicates if the road segment is traveled in the opposite direction of the geometry of the road in map data.
`EVT_GEOELEMENT_TYPE`	Sub option of `EVENT` option. Enables the road segment type: The administrative levels (`roadAdminLevel` parameter): `FOURTH_ROAD`, `TERTIARY_ROAD`, `SECONDARY_ROAD`, `MAIN_ROAD`. And the `geoElementType` parameter: `PEDESTRIAN`, `ROUNDABOUT`, `SLIP_ROAD`, `ROAD`, `MOTORWAY`, `FERRY`
`EVT_POLYLINE`	Sub option of `EVENT` option. Enables the polyline geometry.
`EVT_ENCODED_POLYLINE`	Sub option of `EVENT` option. Enables the encoded polyline geometry.
`EVT_LENGTH`	Sub option of `EVENT` option. Enables length in meters of road segment.
`EVT_DURATION`	Sub option of `EVENT` option. Enables estimated travel duration in seconds of road segment.
`EVT_ENERGY_CONSUMPTION`	Sub option of `EVENT` option. Enables the autonomy limit event estimation. Additionally this option requires the Energy vehicle feature (`routingEnergyVehicleFeature`) parameter. The returned `energyEndOfAutonomyAt` field indicates the distance in meters from start. The returned `energyEndOfAutonomyCoord` field indicates the location of the autonomy limit.
`EVT_ENERGY_CONSUMPTION_SAMPLE`	Sub option of `EVENT` option. Enables the energy consumption estimation with samples data in events structure. Additionally this option requires the Energy vehicle feature (`routingEnergyVehicleFeature`) parameter. The returned energy sample (`EnergySample`) contains the following fields for each second: `distFromStart` in meters, `speed` in m/s, `acceleration` in m/s², `angle` in degrees, `slope` (coefficient), `cumulativeConsumption` in Wh, `pos` coordinate (WGS84) and altitude in meters of event.
`EVT_CHARGING_STATION`	Sub option of `EVENT` option. Add electrical charging station information (static data). Deprecated Use the API Charging Station.
`EVT_CHARGING_STATION_DYNAMIC`	Sub option of `EVENT` option. Add electrical charging station information (dynamic data). Deprecated Use the API Charging Station.
`EVT_TOLL_COST`	Sub option of `EVENT` option. Enables the toll cost calculation. This option requires the Vehicle Profile, see field `routingVehicleProfile` and sub field `routingVehicleFeature`. Contact the support for the required map data. See the response structure `RoutingTollCst` and `Tol` of entry type `TollCost`. Contact the support for the required map data.
`EVT_TAX_COST`	Sub option of `EVENT` option. Enables the tax cost calculation. This option requires the Vehicle Profile, see field `routingVehicleProfile` and sub field `routingVehicleFeature`. Contact the support for the required map data. See the response structure `RoutingTaxCst` and `RoutingTaxSect` of entry type `TaxCost`. Contact the support for the required map data.
`EVT_TRAFFIC`	Sub option of `EVENT` option. Returns the real time traffic info in event structure of type `TrafficElement`. The information contains the `jamFactor` in percentage, `reason` (text), `currentAvrSpeed` in km/h, `freeFlowAvrSpeed` in km/h, etc. NOTE: This option does not affect the route calculation, use the option `TRAFFIC` for that. Contact the support for the required map data.
`EVT_TRAFFIC_PREDICTIVE`	Sub option of `EVENT` option. Returns the real time predictive traffic info in event structure of type `TrafficElement`. The information contains the `jamFactor` in percentage, `reason` (text), `currentAvrSpeed` in km/h, `freeFlowAvrSpeed` in km/h, etc. NOTE: This option does not affect the route calculation. The route calculation is never affect by predictive traffic. Contact the support for the required map data.
`EVT_TRAFFIC_HISTORICAL`	(Beta) Sub option of `EVENT` option. Returns the historical traffic info (i.e. the real time in the past) in event structure of type `TrafficElement`. Requires a `departureTime` in the past. The information contains the `jamFactor` in percentage, `reason` (text), `currentAvrSpeed` in km/h, `freeFlowAvrSpeed` in km/h, etc. NOTE: This option does not affect the route calculation. The route calculation is never affect by predictive traffic. Contact the support for the required map data.
`EVT_ROUTESHEET`	Sub option of `EVENT` option. Enables the route-sheet turn-by-turn instructions in event structure with type `Routesheet`. See the class `RoutingInstruc`.
`EVT_TRAFFIC_SIGNS`	Sub option of `EVENT` option. Enables the traffic sign information in event structure with type `TrafficSign`. `text` (optional) text displayed below traffic sign, `matchedCoordinate` location of traffic sign, `category`, see available values: `NOT_SUPPORTED`, `ROAD_NARROWS`, `SHARP_CURVE_LEFT`, `SHARP_CURVE_RIGHT`, `WINDING_RD_LEFT`, `WINDING_RD_RIGHT`, `STEEP_HILL_UP`, `STEEP_HILL_DOWN`, `LATERAL_WIND`, `GENERAL_WARNING`, `RISK_OF_GROUNDING`, `GENERAL_CURVE`, `GENERAL_HILL`, `OBJECT_OVERHANG`, `ST_NO_OVERTAKING`, `END_NO_OVERTAKING`, `PR_OVERTAKING_EL`, `PR_OVERTAKING_ELR`, `PR_OVERTAKING_ELL`, `LANE_MERGE_RIGHT`, `LANE_MERGE_LEFT`, `LANE_MERGE_CENTER`, `RAILWAY_CROSS_PR`, `RAILWAY_CROSS_UNPR`, `ST_NO_OVERTAKING_TRUCKS`, `END_NO_OVERTAKING_TRUCKS`, `STOP`, `END_OF_ALL_RESTRICTIONS`, `ANIMAL_CROSSING`, `ICY_CONDITIONS`, `SLIPPERY_ROAD`, `FALLING_ROCKS`, `SCHOOL_ZONE`, `TRAMWAY_CROSSING`, `CONGESTION_HAZARD`, `ACCIDENT_HAZARD`, `PRIORITY_ONCOMING`, `YIELD_ONCOMING`, `RIGHT_PRIORITY`, `PEDESTRIAN_CROSSING`, `YIELD`, `NO_ENGINE_BRAKE`, `ENDOF_NO_ENGINE_BRAKE`, `NO_IDLING`, `TRUCK_ROLLOVER`, `LOW_GEAR`, `ENDOF_LOW_GEAR`, `LIGHT`, `DOUBLE_HAIRPIN`, `TRIPLE_HAIRPIN`, `TWO_WAY_TRAFFIC`, `URBAN_AREA`, `HUMP_BRIDGE`, `UNEVEN_ROAD`, `BICYCLE_CROSSING`, `YIELD_TO_BICYCLES`, `NO_TOWED_CARAVAN`, `NO_TOWED_TRAILER`, `NO_CAMPER`, `NO_TURN_ON_RED`, `TURN_ON_RED`, `EMBANKMENT`, `FLOOD_AREA`, `OBSTACLE`, `ROAD_SPLIT`.
`EVT_WAYPOINTS`	Sub option of `EVENT` option. Returns the waypoints of route in event structure. A waypoint is a coordinate with properties that can be used to reproduce the computed route on other device or server.

routingVehicleProfileRoutingVehicleProf

A routing vehicle profile defines physical, legal, toll and energetic characteristics.

RoutingVehicleProf fields

transportModeenum

Defines the transportation mode: Car, pedestrian, truck, etc. Default value is CAR, except for Traceroute service for which default value is EMERGENCY. The map data contains information which are related to transportation mode such as: traffic directions, turn restrictions and road accessibility. Therefore the transportation mode can affect the route calculation.

9 accepted values

`PEDESTRIAN`	Pedestrian.
`BICYCLE`	Bicycle.
`MOTORCYCLE`	Motorcycle.
`CAR`	Passenger car.
`TAXI`	Taxi.
`PUBLIC_BUS`	Public bus.
`EMERGENCY`	Emergency vehicle.
`DELIVERY_TRUCK`	Delivery truck. Deprecated, use `TRUCK` instead.
`TRUCK`	Truck.

maxSpeedsRoutingMaxSpd[]
Defines a maximum speed in km/h for the vehicle. It is possible to discriminate two different maximum speeds: one to be used for route calculation (CAL) and another one for route time estimation (ETA). By default (ALL) the speed applies to both cases.
RoutingMaxSpd fields
- maxSpeedinteger (int32)
  Specifies a maximum speed for a vehicle in km/h.
- typeenum
  Defines if max speed should be used for route calculation (CAL) and/or for route time estimation (ETA). By default (ALL) the speed applies to both cases.
  3 accepted values
  ALL Maximum speed apply to route calculation and to route ETA.
  CAL Maximum speed apply only to route calculation.
  ETA Maximum speed apply only to route ETA.

routingVehicleFeatureRoutingVehicleFtr

Defines the routing vehicle feature. A routing vehicle feature defines physical, legal and toll characteristics.

RoutingVehicleFtr fields

heightinteger (int32)
Height of vehicle in centimeters. Affects route calculation. Physical restriction.
widthinteger (int32)
Width of vehicle in centimeters. Affects route calculation. Physical restriction.
lengthinteger (int32)
Length of vehicle in centimeters. Affects route calculation. Physical restriction.
weightinteger (int32)
Weight of vehicle in tens of metric tons, i.e.: 35 = 3.5t. Affects route calculation. Legal and physical restrictions.
axleWeightinteger (int32)
Axle weight in tens of metric tons, i.e.: 12 = 1.2t. Affects route calculation. Legal and physical restrictions.

hazardousMaterialsenum

Hazardous materials carried by the vehicle. Affects route calculation. Legal restriction.

25 accepted values

`NONE`	No hazardous material.
`ALL`	General hazardous materials.
`EXPLOSIVE`	Trucks with Explosive and Flammable Goods.
`WATER`	Trucks with Goods Harmful for Water.
`US_CORROSIVE`	USA only : Corrosive materials (e.g., hydrochloric acid, sulfuric acid, mercury, sodium hydroxide).
`US_EXPLOSIVES`	USA only : Explosives (e.g., TNT, ammunition, flares, fireworks).
`US_FLAM`	USA only : Flammable and combustible liquids (e.g., jet fuel, gasoline, fuel oil, alcohols).
`US_FLAM_SOL`	USA only : Flammable solids, spontaneously combustible materials and water reactive substances (e.g., matches, white phosphorus, potassium).
`US_GAS`	USA only : Flammable, compressed and poisonous gases (e.g., propane, compressed oxygen, chlorine).
`US_ORGANIC`	USA only : Oxidizers and organic peroxides (e.g., ammonium nitrate and benzoyl peroxide).
`US_OTHER`	USA only : Miscellaneous hazardous materials (e.g., asbestos, dry ice, lithium batteries).
`US_PIH`	USA only : Poisonous inhalation hazards (PIH).
`US_POISON`	USA only : Poisonous (toxic) and infectious substances (e.g., cyanide, most mercury-based compounds, viruses, toxins and regulated medical waste).
`US_RADIO_ACTIVE`	USA only : Radioactive materials (e.g., plutonium-239 and uranium-235).
`TUNNEL_CAT_B`	Tunnel Category B.
`TUNNEL_CAT_B1000C`	Tunnel Category B1000C.
`TUNNEL_CAT_BD`	Tunnel Category B/D.
`TUNNEL_CAT_BE`	Tunnel Category B/E.
`TUNNEL_CAT_C`	Tunnel Category C.
`TUNNEL_CAT_C5000D`	Tunnel Category C5000D.
`TUNNEL_CAT_CD`	Tunnel Category C/D.
`TUNNEL_CAT_CE`	Tunnel Category C/E.
`TUNNEL_CAT_D`	Tunnel Category D.
`TUNNEL_CAT_DE`	Tunnel Category D/E.
`TUNNEL_CAT_E`	Tunnel Category E.

nbTrailerinteger (int32)
Vehicle's number of trailers (-1: not defined, 0: no trailer). Affects route calculation. Legal restriction.

tollTransportCategoryenum

Defines the toll vehicle category. Affects toll calculation. UNDEFINED by default.

13 accepted values

`UNDEFINED`	Undefined.
`MOTORCYCLE`	Motorcycle.
`AUTO`	Automobile.
`TRUCK`	Truck.
`MOTOR_HOME`	Motor home.
`MINIBUS`	Mini bus.
`BUS`	Bus.
`SIDECAR`	Sidecar (EU only).
`TRICYCLE`	Tricycle (EU only).
`DLV_TRUCK`	Delivery truck (EU only).
`SNOWMOBILE`	Snowmobile (US only).
`PICK_UP`	Pick up (US only).
`TRACTOR`	Tractor (US only).

caravanenum
Defines if the vehicle has a caravan. Affects toll calculation. UNDEFINED by default.
3 accepted values
UNDEFINED Undefined.
YES Yes.
NO No.
hybridenum
Defines if vehicle has a hybrid engine. Affects toll calculation. UNDEFINED by default.
3 accepted values
UNDEFINED Undefined.
YES Yes.
NO No.
disEquippedenum
Defines if vehicle is equipped for disabled people. Affects toll calculation. UNDEFINED by default.
3 accepted values
UNDEFINED Undefined.
YES Yes.
NO No.
pollMinenum
Defines if vehicle has minimal pollution. Affects toll calculation. UNDEFINED by default.
3 accepted values
UNDEFINED Undefined.
YES Yes.
NO No.
hovenum
Defines if vehicle is a High Occupancy Vehicle (USA only). See Wikipedia: High-occupancy vehicle lane. Affects toll calculation. UNDEFINED by default.
3 accepted values
UNDEFINED Undefined.
YES Yes.
NO No.
cialenum
Defines if vehicle is a commercial vehicle. Affects toll calculation. UNDEFINED by default.
3 accepted values
UNDEFINED Undefined.
YES Yes.
NO No.
nbVehAxlesinteger (int32)
Defines the number of axles of the vehicle (optional). Affects toll calculation.
nbTrailAxlesinteger (int32)
Defines the number of axles of the trailer (optional). Affects toll calculation.
nbTiresinteger (int32)
Defines the number of tires (optional). Affects toll calculation.
nbPassengersinteger (int32)
Defines the number of passengers (optional). Affects toll calculation.
vehHeightinteger (int32)
Defines vehicle's height in centimeters (optional, use field height to define total height : vehicle + trailer). Affects toll calculation.
trailHeightinteger (int32)
Defines trailer's height in centimeters (optional, use field height to define total height : vehicle + trailer). Affects toll calculation.
vehWeightinteger (int32)
Defines vehicle's weight in tens of tons (optional, use field weight to define total weight : vehicle + trailer). Affects toll calculation.

emissionClassenum

Defines vehicle's emission type (optional). See Wikipedia: European emission standards. Affects toll calculation.

18 accepted values

`UNDEFINED`	Undefined.
`EURO1`	EURO I.
`EURO2`	EURO II.
`EURO3`	EURO III.
`EURO4`	EURO IV.
`EURO5`	EURO V.
`EURO6`	EURO VI.
`EURO_EEV`	EURO EEV.
`ELECTRIC`	EURO Electric.
`EURO0`	EURO 0
`EURO2_PRC`	EURO II with PRC (Particle Reduction Composite/System)
`EURO3_PRC`	EURO III with PRC (Particle Reduction Composite/System)
`EURO6_CO2_1`	EURO VI CO2 1
`EURO6_CO2_2`	EURO VI CO2 2
`EURO6_CO2_3`	EURO VI CO2 3
`EURO6_CO2_4`	EURO VI CO2 4
`EURO6_CO2_5`	EURO VI CO2 5
`MAX`	Maximal value.

adrTunnelCategoryenum
ADR tunnel category defines all supported ADR (EU only, European Agreement concerning the International Carriage of Dangerous Goods by Road). Affects route calculation.
5 accepted values
NONE No tunnel category restriction (category A).
CAT_B Tunnel Category B.
CAT_C Tunnel Category C.
CAT_D Tunnel Category D.
CAT_E Tunnel Category E.
onlyPhysicalboolean
Defines if vehicle's weight (weight, weight per axle and trailers) and hazardous materials (hazardous materials and ADR) should be ignored outside respectively bridges and tunnels. false by default. Affects route calculation.

routingEnergyVehicleFeatureRoutingEnergyVehicleFtr
Energy vehicle feature for energy consumption estimation.
RoutingEnergyVehicleFtr fields
- scxnumber (double)
  Product of vehicle's front area and aerodynamic coefficient (in m²).
- crrnumber (double)
  Vehicle's tire rolling resistance coefficient (dimension-less, in interval ]0, 1[).
- engineEfficiencynumber (double)
  Vehicle's efficiency coefficient between engine and gear (dimension-less, in interval ]0, 1[).
- batCapacitynumber (double)
  Vehicle's capacity of the battery (in kWh, only if electric vehicle or hybrid re-chargeable, 0 otherwise).
- energyLoadnumber (double)
  Vehicle's current energy load, state of charge (in kWh).
- dryWeightinteger (int32)
  Vehicle's weight without any consumables or passengers (in kg).
- payloadinteger (int32)
  Vehicle's extra load (consumables or passengers weight for example) (in kg).
- auxConsumptioninteger (int32)
  Vehicle's instantaneous auxiliary equipments consumption (in W).
- maxAccelnumber (double)
  Maximum acceleration (superior to 0.1, in m/s², based on vehicle's acceleration capacity and expected driving behavior).
- maxDecelnumber (double)
  Maximum deceleration (inferior to -0.1, in m/s², based on vehicle's braking capacity and expected driving behavior).
- extTempnumber (float)
  Outside temperature (in °C).
- maxChargePowernumber (double)
  Maximum charge power AC single phase authorized by the vehicle (in kW).
- maxChargePowerAc3number (double)
  Maximum charge power AC three phases authorized by the vehicle (in kW).
- maxChargePowerDcnumber (double)
  Maximum charge power DC authorized by the vehicle (in kW).
- regenerativeBrakingboolean
  Defines if the vehicle supports regenerative braking (default = true).
routingEnergyVehicleConnectorTypeIdsinteger (int32)[]deprecated
Connector (plug) type of electrical vehicle, used for energy consumption estimation. Deprecated Use the API Charging Station.
routingEnergyVehicleRangesinteger (int64)[]deprecated
Energy vehicle range. Define the pre-calculated electric vehicle autonomy in meters.
chargingStationProviderNamestringdeprecated
Name of charging station provider used to research the chargning station pools. Deprecated Use the API Charging Station.

routingSpeedPonderationsRoutingSpeedPond[]

Defines a speed coefficient for the specified road element's classification. Note: This parameter has no effect on the Traceroute service.

RoutingSpeedPond fields

factornumber (float)required
Specifies the speed coefficient. A value under 1 to reduce the speed, e.g: 0.8. A value over 1 to increase the speed, e.g: 1.3. 1 by default.
levelinteger (int32)required
Road element's level (0: all 4 levels, 1: main level, 2: secondary level, 3: third level, 4: fourth level).
roadTypeenum
Define the road type.
7 accepted values
ALL All road network.
DEFAULT Default.
FERRY Ferry line.
MOTORWAY Motorway.
PEDESTRIAN Pedestrian.
ROUNDABOUNT Roundabout.
SLIPROAD Slip road.

pondTypeenum

Define the ponderation type.

3 accepted values

`ALL`	Speed coefficient applies both for finding the fastest route and calculating its ETA. Default value.
`CAL`	Speed coefficient applies only searching for the fastest route (only when fastest criteria is set).
`ETA`	Speed coefficient applies only for calculating route's travel time (ETA).

routingCrossPenaltiesCoefficientsRoutingCrossPenaltiesCoef[]

Defines a cross-penalties coefficient for the specified road element's classification. Note: This parameter has no effect on the Traceroute service.

RoutingCrossPenaltiesCoef fields

factornumber (float)required
New coefficient factor for cross-penalties (Default = 1).

ptypeenum

Enumeration taken into account by routing calculation. It defines if speed coefficient applies only for searching the fastest route (only when fastest criteria is set) or for calculating the route's travel time (ETA) or both.

3 accepted values

`ALL`	Speed coefficient applies both for finding the fastest route and calculating its ETA. Default value.
`CAL`	Speed coefficient applies only searching for the fastest route (only when fastest criteria is set).
`ETA`	Speed coefficient applies only for calculating route's travel time (ETA).

typeenum

Defines if a new coefficient applies to route calculation or to route ETA or both (Default = ALL).

3 accepted values

`ALL`	Speed coefficient applies both for finding the fastest route and calculating its ETA. Default value.
`CAL`	Speed coefficient applies only searching for the fastest route (only when fastest criteria is set).
`ETA`	Speed coefficient applies only for calculating route's travel time (ETA).

xyRadiusinteger (int32)
Maximum search radius around GPS point.
startUTurnThresholdinteger (int32)
Specifies the start UTurn threshold. This value determines, at start point or any via point for which a use start angle / avoid UTurn property is set, the threshold (in 1/10th seconds / meters / Wh in resp. FASTEST / SHORTEST / ECO mode) above which the property may be ignored (default = 3000). For instance, in SHORTEST mode, if the route from start to stop leaving start point in the desired direction is more than startUTurnThreshold meters longer than the route from start to stop leaving start point in the opposite direction, leave the start point in the opposite direction.
departureTimestring
This parameter is an EPOCH timestamp in milliseconds (UTC) or a string with ISO local date time format like '2011-12-03T10:15:30', '2011-12-03T10:15:30+01:00' or '2011-12-03T10:15:30+01:00[Europe/Paris]'. It is used to define the date and time of routing departure.
arrivalTimestring
Use this parameter to define the date and time of routing arrival. Can only work with 1 to 1 routing computation mode, no vias are currently permitted or another computation mode like 1 to n, n to 1, n to n and matrix. This parameter is an EPOCH timestamp in milliseconds (UTC) or a string with ISO local date time format like '2011-12-03T10:15:30', '2011-12-03T10:15:30+01:00' or '2011-12-03T10:15:30+01:00[Europe/Paris]'. It is used to define the date and time of routing arrival.
isoChroneLimitinteger (int64)
The limit of the isochrone. Either meters, seconds or watt/hour depending on the criteria argument (meters if SHORTEST, seconds if FASTEST and Wh if ECO_ENERGY).
corridorRadiusinteger (int32)
Builds a corridor along the calculated route with the given radius. Corridor radius in meters (notes: the corridor width = 2 * corridorRadius).
fenceShapesGeoFenceShp[]
Defines fence shapes to perform an intersection test between the route and the fences.
GeoFenceShp fields
- centerCoordinaterequired
  Center of circle fence.
  Coordinate fields
  - lonnumber (double)required
    Longitude in degrees decimal (WGS84).
    Also accepted as longitude.
  - latnumber (double)required
    Latitude in degrees decimal (WGS84).
    Also accepted as latitude.
- radiusinteger (int64)required
  Radius of circle fence.
- verticesCoordinate[]required
  Vertices of polygon fence.
  Coordinate fields
  - lonnumber (double)required
    Longitude in degrees decimal (WGS84).
    Also accepted as longitude.
  - latnumber (double)required
    Latitude in degrees decimal (WGS84).
    Also accepted as latitude.
- idinteger (int64)
  The fence id. If value is negative the server will set it with an auto-incrementing number.
- typeenum
  Define the type of geometric shape of fence, like CIRCLE or POLYGON.
  2 accepted values
  CIRCLE Circle.
  POLYGON Polygon.
outputLanguagestring
Defines the preferred language that will be used by the options ROUTESHEET, EVT_ROUTESHEET, REVGEO_POSTAL_ADDRESS, etc. Values of language code: An ASCII string that defines an (ISO 639-1)[https://fr.wikipedia.org/wiki/Liste_des_codes_ISO_639-1] (2-letter) language code.
maxAlternativeRoutesinteger (int32)
Define the maximum number of alternative routes (in range between 0 to 2).
routingChargeFeatureRoutingChargeFtr
Features of Electrical charge used during the routing calculation.
RoutingChargeFtr fields
- socAlertinteger (int32)
  SOC below which the driver does not want to descend (in % of the vehicle's battery's capacity).
- socAtArrivalinteger (int32)
  Desired SOC at the arrival. If reachChargePointAtArrival is true, this is computed by the algorithm as the SOC to reach the closest charging pool at arrival.
- reachChargePointAtArrivalboolean
  Specifies that the SOC at arrival must be sufficient to reach a suitable charge point (true by default).
- connectorTypeIdFiltersinteger (int32)[]
  List of connector type ID to perform a filtration based on those values.
- providersstring[]
  Optional list of authorized charge data providers (by default all providers are authorized).
matrixStartCountinteger (int32)
Number of destination points (xy parameter) to be used as start points (all other points will be used as stop points). 0 to disable: all destination points are used both as start and stop points.
customDataCustomDt[]
Custom data. The parameter customData can be repeated and contains a key and value.
CustomDt fields
- keystring
- valuestring

Response#

Details of fields#

usedDestinationsRoutingUsedDest[]
List of used destinations according to the request. The coordinates used for routing calculation: includes the raw coordinates and the map matched coordinates.
RoutingUsedDest fields
- inputOrderinteger (int32)
  Original order number of input coordinates.
- usedboolean
  Indicates if this coordinate has been used by the routing calculator.
- usedOrderinteger (int32)
  Final order number of input coordinates. The order can be changed by options OPTIMIZED_TRIP, OPTIMIZED_TRIP_CLOSE, OPTIMIZED_TRIP_ROUND, OPTIMIZED_TRIP_UNDEFSTOP.
- matchedCoordinateGpsCoordinateSat
  Map matched coordinate (i.e. snapped on a map road element).
  CoordinateSat fields
  - lonnumber (double)required
    Longitude in degrees decimal (WGS84).
    Also accepted as longitude.
  - latnumber (double)required
    Latitude in degrees decimal (WGS84).
    Also accepted as latitude.
  - headingnumber (double)
    Heading in degrees.
  - speednumber (float)
    Speed in km/h.
  - timeinteger (int64)
    GPS time in milliseconds (EPOCH).
  - satinteger (int32)
    Number of GPS satellites available.
- matchedPostalAddressAddress
  Postal address of map matched coordinate.
  Address fields
  - countryCodestring
    ISO code of country.
  - countrystring
    Country name.
  - statestring
    State name.
  - countystring
    County name.
  - citystring
    City name.
  - districtstring
    District name of city.
  - postalCodestring
    Postal code.
  - roadNumberstring
    Road number.
  - streetstring
    Street name.
  - streetNumberstring
    House number.
  - oppositeStreetNumberstringdeprecated
    Opposite street number.
- confidenceValuenumber (double)
  Confidence score of map matched coordinate in range ]0,1].
- distanceFromRequestnumber (double)
  Distance in meters between raw coordinate and map matched coordinate.
- exceptionMessagestring
  The exception message of the destination. Returned only when the option REVGEO_STRICT_DISABLE is defined in request.
- polylineIndexinteger (int64)deprecated
  The index of corresponding coordinate in route's polyline. Only when the option POLYLINE_INDEX is defined in request, otherwise the value is set to -1.
- waypointPolylineIndexinteger (int32)deprecated
- durationinteger (int64)
  The travel time (ETA) in seconds from start coordinate of this destination.
- lengthinteger (int64)
  The length in meters from start coordinate of this destination.
- customDataCustomDt[]
  Custom data is a list that can be used to set some custom information about the destination in input.
  CustomDt fields
  - keystring
  - valuestring

routingRoutesRoutingRt[]

Defines a list of computed routes.

RoutingRt fields

exceptionMessagestring
Error message returned when the route is not feasible.
lengthinteger (int64)
Length of route in meters.
durationinteger (int64)
Total driving time in seconds.
totalDurationinteger (int64)
The total duration in seconds represent the duration of travel + stop time.
trafficDelayinteger (int64)
Delay in seconds due to real time traffic and statistical traffic.
departureTimeinteger (int64)
arrivalTimeinteger (int64)
averageSpeednumber (float)
Average speed in km/h.
maximumSpeednumber (float)
Maximum speed in km/h.
startUTurnThresholdinteger (int32)
The start UTurn threshold. This value determines, at start point or any via point for which a use start angle / avoid UTurn property is set, the threshold (in 1/10th seconds / meters / Wh in resp. FASTEST / SHORTEST / ECO mode) above which the property may be ignored. For instance, in SHORTEST mode, if the route from start to stop leaving start point in the desired direction is more than startUTurnThreshold meters longer than the route from start to stop leaving start point in the opposite direction, leave the start point in the opposite direction.
energyConsumptionnumber (double)
Energy needed to travel route, in kWh. See options ENERGY_CONSUMPTION, EVT_ENERGY_CONSUMPTION.

routingTollCostRoutingTollCst

Total toll cost range along the route. See option EVT_TOLL_COST.

RoutingTollCst fields

tollsTol[]

List of tolls.

Tol fields

tollTypeenum
Type of toll.
4 accepted values
TOLL_FIXED_FEE Fixed fee (does not depend of origin).
TOLL_OBTAIN_TICKET Obtain ticket (no fee).
TOLL_PAY_PER_TICKET Pay per ticket (depends of origin).
TOLL_ELECTRONIC Electronic.

meanOfPaymentsenum[]

List of mean of payment.

8 accepted values

`PAYMENT_CASH`	Cash.
`PAYMENT_BANK_CARD`	Bank card.
`PAYMENT_CREDIT_CARD`	Credit card.
`PAYMENT_PASS_SUBSCRIPTION`	Pass or subscription.
`PAYMENT_TRANSPONDER`	Transponder.
`PAYMENT_VIDEO_TOLL_CHARGE`	Video toll charge.
`PAYMENT_EXACT_CASH`	Exact cash.
`PAYMENT_TRAVEL_CARD`	Travel card.

polylineIndexinteger (int64)
Index of polyline coordinate.
tollChargesTollChrg[]
List of toll charge.
TollChrg fields
- currencystring
  Currency unit in norm ISO 4217, more details on Wikipedia ISO 4217.
- categorystring
  A textual definition of vehicle category.
- pricenumber (double)
  Price.
coordinateCoordinate
Coordinate of toll.
Coordinate fields
- lonnumber (double)required
  Longitude in degrees decimal (WGS84).
  Also accepted as longitude.
- latnumber (double)required
  Latitude in degrees decimal (WGS84).
  Also accepted as latitude.

sumFeesRoutingSumF[]
List of total toll fees of route. In most cases this list contains only one entry. Only when the toll fees along the route use several currencies will the list contains several entries (one for each currency).
RoutingSumF fields
- currencystring
  Currency in norm ISO 4217, more details on Wikipedia ISO 4217 https://en.wikipedia.org/wiki/ISO_4217.
- feeMinnumber (double)
  The minimum fee.
- feeMaxnumber (double)
  The maximum fee.

routingTaxCostRoutingTaxCst

Total tax cost range along the route. See option EVT_TAX_COST.

RoutingTaxCst fields

taxSectionsRoutingTaxSect[]

List of tax sections.

RoutingTaxSect fields

taxCategoryenum
Tax category.
4 accepted values
TAX_CATEGORY_NONE No tax.
TAX_CATEGORY_1 Tax category 1.
TAX_CATEGORY_2 Tax category 2.
TAX_CATEGORY_3 Tax category 3.

meanOfPaymentsenum[]

List of mean of payment.

8 accepted values

`PAYMENT_CASH`	Cash.
`PAYMENT_BANK_CARD`	Bank card.
`PAYMENT_CREDIT_CARD`	Credit card.
`PAYMENT_PASS_SUBSCRIPTION`	Pass or subscription.
`PAYMENT_TRANSPONDER`	Transponder.
`PAYMENT_VIDEO_TOLL_CHARGE`	Video toll charge.
`PAYMENT_EXACT_CASH`	Exact cash.
`PAYMENT_TRAVEL_CARD`	Travel card.

countryCodestring
The ISO country code (ISO 3166 alpha 3) of current tax section.
lengthinteger (int32)
Length of section in meters.
firstFrmIdxinteger (int32)
Index of the first route's segment event of the tax section. See the options EVENT, EVT_POLYLINE, EVT_SEGMENT_INFO.
lastFrmIdxinteger (int32)
Index of the last route's segment event of the tax section. See the options EVENT, EVT_POLYLINE, EVT_SEGMENT_INFO.
taxChargesTaxChrg[]
List of tax charge.
TaxChrg fields
- currencystring
  Currency in norm ISO 4217, more details on Wikipedia ISO 4217 https://en.wikipedia.org/wiki/ISO_4217.
- categorystring
  A textual definition of vehicle category.
- pricenumber (double)
  Price.

sumFeesRoutingSumF[]
List of total tax fees of route. In most cases this list contains only one entry. Only when the tax fees along the route use several currencies will the list contains several entries (one for each currency).
RoutingSumF fields
- currencystring
  Currency in norm ISO 4217, more details on Wikipedia ISO 4217 https://en.wikipedia.org/wiki/ISO_4217.
- feeMinnumber (double)
  The minimum fee.
- feeMaxnumber (double)
  The maximum fee.

routingInstructionsRoutingInstruc[]

List of guidance instructions. Use ROUTESHEET option in request.

RoutingInstruc fields

typeenum

Instruction type.

11 accepted values

`FOLLOW`	Follow.
`FOLLOW_SIGN`	Follow sign.
`TAKE_RAMP`	Take ramp.
`ENTER_MOTORWAY`	Enter in motorway.
`EXIT_MOTORWAY`	Exit from motorway.
`ENTER_ROUNDABOUT`	Enter in roundabout.
`EXIT_ROUNDABOUT`	Exit from roundabout.
`TAKE_FERRY`	Take ferry.
`LEAVE_FERRY`	Leave ferry.
`STOP`	Stop.
`STOP_VIA`	Stop on via.

geoElementTypeenum

Geo element type following instruction.

61 accepted values

`ALL_ROAD`	Road types.
`PEDESTRIAN`
`ROUNDABOUT`
`SLIP_ROAD`
`ROAD`
`MOTORWAY`
`FERRY`
`MAIN_ROAD`	Road levels.
`SECONDARY_ROAD`
`TERTIARY_ROAD`
`FOURTH_ROAD`
`COUNTRY`	Administrative.
`STATE`
`COUNTY`
`CITY`
`DISTRICT`
`POSTAL_CODE`
`BUILT_UP_AREA_NA`	Urban area information not available.
`BUILT_UP_AREA_NONE`	No urban area.
`BUILT_UP_AREA_MAIN`	Urban area coverage size main, not an administrative area.
`BUILT_UP_AREA_MEDIUM`	Urban area coverage size medium (not an administrative area).
`BUILT_UP_AREA_SMALL`	Urban area coverage size small (not an administrative area).
`VEHICLE_REPAIR`	POI.
`PETROL_STATION`
`RENT_A_CAR`
`PARKING_GARAGE`
`HOTEL_MOTEL`
`RESTAURANT`
`TOURIST_OFFICE`
`MUSEUM`
`THEATRE`
`CULTURAL_CENTRE`
`SPORTS_ACTIVITY`
`HOSPITAL`
`POLICE_STATION`
`CITY_HALL`
`POST_OFFICE`
`PHARMACY`
`BANK`
`CAMPING`
`SHOPPING_CENTRE`
`STADIUM`
`TOURIST_ATTRACTION`
`BUS_STATION`
`EXHIBITION_CENTER`
`GOLF_COURSE`
`GROCERY_STORE`
`LIBRARY`
`MARINA`
`HISTORICAL_MONUMENT`
`BOWLING`
`CASINO`
`CINEMA`
`SPORTS_CENTRE`
`BEACH`
`SHOP`
`OPERA`
`TENNIS_COURT`
`MUSIC_CENTER`
`AMUSEMENT_PARK`
`ZOO`

lengthinteger (int32)
Distance in meters of current instruction.
durationinteger (int32)
Duration in seconds of current instruction.
fromNamestring
Name of last road segment before the maneuver. In specified language define in request, if available in map data
fromPhonemestring
Phonetic transcription of the name of last road segment before the maneuver. In specified language define in request, if available in map data

manoeuvreenum

The direction to follow.

10 accepted values

`STRAIGHT`	Straight ahead.
`SLIGHT_LEFT`	Turn slight left.
`LEFT`	Turn left.
`SHARP_LEFT`	Turn sharp left.
`U_TURN`	Make a u-turn.
`SHARP_RIGHT`	Turn sharp right.
`RIGHT`	Turn right.
`SLIGHT_RIGHT`	Turn slight right.
`BEAR_LEFT`	Bear left.
`BEAR_RIGHT`	Bear right.

coordinateCoordinate
Position of the maneuver.
Coordinate fields
- lonnumber (double)required
  Longitude in degrees decimal (WGS84).
  Also accepted as longitude.
- latnumber (double)required
  Latitude in degrees decimal (WGS84).
  Also accepted as latitude.
roundAboutExitNumberinteger (int32)
The exit number of a roundabout.
toNamestring
Name (or sign post) of first road segment after the maneuver. In specified language define in request, if available in map data
toOnstring
Returns the Official Name of next route section (in specified language code if available).
toOnPhonemestring
Returns phonetic transcription of the official name of next route section.
toPhonemestring
Phonetic transcription of the name (or sign post) of first road segment after the maneuver. In specified language define in request, if available in map data
toRnstring
Route number of first road segment after the maneuver.
toRnPhonemestring
Phonetic transcription of the route number of first road segment after the maneuver.
toSistring
Sign post to follow after the maneuver. In specified language define in request, if available in map data.
toSiPhonemestring
Phonetic transcription of the sign post to follow after the maneuver. In specified language define in request, if available in map data.
textDiststring
Distance instruction in human readable format can be used with text-to-speech.
textstring
Instruction in human readable format can be used with text-to-speech.
polylineIndexinteger (int32)deprecated
Index in route polyline's points array of first form of this instruction. Deprecated use instead EVENT, EVT_ROUTESHEET with EVT_POLYLINE or EVT_ENCODED_POLYLINE.

boundingBoxBoundingBox
Bounding box of the route.
BoundingBox fields
- minLonnumber (double)
  Minimum longitude, in degrees decimal (WGS84).
- minLatnumber (double)
  Minimum latitude, in degrees decimal (WGS84).
- maxLonnumber (double)
  Maximum longitude, in degrees decimal (WGS84).
- maxLatnumber (double)
  Maximum latitude, in degrees decimal (WGS84).
corridorGeometricPoly[]
Corridor around the route. Use the parameter corridorRadius in request.
GeometricPoly fields
- coordinatesCoordinate[]
  Coordinates of the polygon.
  Coordinate fields
  - lonnumber (double)required
    Longitude in degrees decimal (WGS84).
    Also accepted as longitude.
  - latnumber (double)required
    Latitude in degrees decimal (WGS84).
    Also accepted as latitude.

fenceResultsGeoFenceRes[]

List of tested fences.

GeoFenceRes fields

idinteger (int64)
Unique ID of fence.
typeenum
Type of geometry.
2 accepted values
CIRCLE Circle.
POLYGON Polygon.
fenceShapeGeoFenceShp
Shape of fence used to perform the test.
GeoFenceShp fields
- centerCoordinaterequired
  Center of circle fence.
  Coordinate fields
  - lonnumber (double)required
    Longitude in degrees decimal (WGS84).
    Also accepted as longitude.
  - latnumber (double)required
    Latitude in degrees decimal (WGS84).
    Also accepted as latitude.
- radiusinteger (int64)required
  Radius of circle fence.
- verticesCoordinate[]required
  Vertices of polygon fence.
  Coordinate fields
  - lonnumber (double)required
    Longitude in degrees decimal (WGS84).
    Also accepted as longitude.
  - latnumber (double)required
    Latitude in degrees decimal (WGS84).
    Also accepted as latitude.
- idinteger (int64)
  The fence id. If value is negative the server will set it with an auto-incrementing number.
- typeenum
  Define the type of geometric shape of fence, like CIRCLE or POLYGON.
  2 accepted values
  CIRCLE Circle.
  POLYGON Polygon.

positionStateenum

Defines position state of tested coordinate on the fence geometry.

5 accepted values

`INWARD`	Defines if the tested coordinate is an inward intersection.
`INSIDE`	Defines if the tested coordinate is in fence.
`OUTWARD`	Defines if the tested coordinate is an outward intersection.
`OUTSIDE`	Defines if the tested coordinate is out of fence.
`INTERSECT`	Position is not completely inside or outside but the shapes are intersected.

positionCoordinate
The coordinates of the intersection in WGS84.
Coordinate fields
- lonnumber (double)required
  Longitude in degrees decimal (WGS84).
  Also accepted as longitude.
- latnumber (double)required
  Latitude in degrees decimal (WGS84).
  Also accepted as latitude.
timestampinteger (int64)
The estimated time stamp of this intersection in milliseconds.

startStopInfoRoutingRouteStartStopInf
Information about the start and stop coordinates of a route found by the routing calculation.
RoutingRouteStartStopInf fields
- startCoordinate
  Start (first) coordinate of the computed route.
  Coordinate fields
  - lonnumber (double)required
    Longitude in degrees decimal (WGS84).
    Also accepted as longitude.
  - latnumber (double)required
    Latitude in degrees decimal (WGS84).
    Also accepted as latitude.
- stopCoordinate
  Stop (last) coordinate of the computed route.
  Coordinate fields
  - lonnumber (double)required
    Longitude in degrees decimal (WGS84).
    Also accepted as longitude.
  - latnumber (double)required
    Latitude in degrees decimal (WGS84).
    Also accepted as latitude.
- distanceFirstMatchednumber (double)
  Distance between first matched coordinate and the start coordinate of route found by the routing calculation. This distance is not 0 when the input matched coordinate is unaccessible.
- distanceLastMatchednumber (double)
  Distance between last matched coordinate and the stop coordinate of route found by the routing calculation. This distance is not 0 when the input matched coordinate is unaccessible.
- interDestsCoordinate[]
  List of intermediate destination coordinates reached by the computed route.
  Coordinate fields
  - lonnumber (double)required
    Longitude in degrees decimal (WGS84).
    Also accepted as longitude.
  - latnumber (double)required
    Latitude in degrees decimal (WGS84).
    Also accepted as latitude.
polylineCoordinate[]
Route polyline geometry. See the option POLYLINE.
Coordinate fields
- lonnumber (double)required
  Longitude in degrees decimal (WGS84).
  Also accepted as longitude.
- latnumber (double)required
  Latitude in degrees decimal (WGS84).
  Also accepted as latitude.
detailedPolylinesGeometricDetPolyline[]deprecated
Polyline geometry of itinerary with more information for each sub-segments. See the option DETAILED_POLYLINE. Deprecated Use events system (like EVENT, EVT_POLYLINE) instead.
GeometricDetPolyline fields
- coordinatesCoordinate[]
  Matched coordinate on a road.
  Coordinate fields
  - lonnumber (double)required
    Longitude in degrees decimal (WGS84).
    Also accepted as longitude.
  - latnumber (double)required
    Latitude in degrees decimal (WGS84).
    Also accepted as latitude.
- lengthinteger (int64)
  Length of route segment in meters.
openLrBase64string
Route geometry encoded as OpenLR (in base64 encoding).
segmentIdsinteger (int64)[]deprecated
List of segment ID of computed route.
roadSegmentsRoadSeg[]deprecated
Route segments. Deprecated use events system (like EVENT, EVT_SEGMENT_INFO, EVT_POLYLINE) instead.
RoadSeg fields
- countryCodestring
  Country code (ISO).
- idinteger (int64)
  ID of segment. -1 if information is not available.
- reverseDirectionboolean
  True if this segment has been reversed, false otherwise.
- durationnumber (double)
  The duration in seconds to travel through this route segment. -1 if information is not available.
- weightinteger (int64)
  The weight in seconds or meters to travel through this route, used only by isochrone calculation. -1 if information is not available.
- fromCoordinate
  Coordinate of first point.
  Coordinate fields
  - lonnumber (double)required
    Longitude in degrees decimal (WGS84).
    Also accepted as longitude.
  - latnumber (double)required
    Latitude in degrees decimal (WGS84).
    Also accepted as latitude.
- toCoordinate
  Coordinate of last point.
  Coordinate fields
  - lonnumber (double)required
    Longitude in degrees decimal (WGS84).
    Also accepted as longitude.
  - latnumber (double)required
    Latitude in degrees decimal (WGS84).
    Also accepted as latitude.
junctionNodesCoordinate[]deprecated
Junction nodes of route.
Coordinate fields
- lonnumber (double)required
  Longitude in degrees decimal (WGS84).
  Also accepted as longitude.
- latnumber (double)required
  Latitude in degrees decimal (WGS84).
  Also accepted as latitude.

waypointsRoutingWaypnt[]

Waypoints of route.

RoutingWaypnt fields

usedDestinationIndexinteger (int32)
The index of the used destinations (destinations). -1 if not available.
polylineIndexinteger (int32)deprecated
The index of the waypoint polyline. -1 if not available.
waypointPolylineIndexinteger (int32)
The coordinate index of the waypoint polyline.
coordinateCoordinate
Coordinate of waypoint.
Coordinate fields
- lonnumber (double)required
  Longitude in degrees decimal (WGS84).
  Also accepted as longitude.
- latnumber (double)required
  Latitude in degrees decimal (WGS84).
  Also accepted as latitude.
anglenumber (double)
Angle in degrees of the road segment (clock-wise).
radiusinteger (int64)
Radius (in meters) of the waypoint.
uturnboolean
Defines if a UTurn is done on this via point.
ignorePointboolean
Defines if this waypoint is ignored by the planner for its route calculation.
ignoreTrafficDirectionsboolean
Defines if traffic directions should be ignored by route planner between this waypoint and next one.
ignoreRoadBlocksboolean
Defines if road blocks should be ignored by route planner between this waypoint and next one.
ignoreRestrictionsboolean
Defines if forbidden manoeuvres and blocked passages should be ignored by route planner between this waypoint and next one.
avoidUTurnenum
Defines if a UTurn should be avoided (if possible) by route planner at this location.
3 accepted values
UNDEF Status undefined.
YES Status yes.
NO Status no.
useStartAngleenum
If set to YES and location is on is on a 2 way road, location's angle will be used as a general direction for departure from location.
3 accepted values
UNDEF Status undefined.
YES Status yes.
NO Status no.
useStopRoadSideenum
Defines if route planner must arrive on this waypoint on waypoint's side (if waypoint is on a 2 way road).
3 accepted values
UNDEF Status undefined.
YES Status yes.
NO Status no.

offRoadRoutingOffRd

Polyline representing the offroad section following this waypoint.

RoutingOffRd fields

geometryCoordinate[]
Geometry representing the offroad section.
Coordinate fields
- lonnumber (double)required
  Longitude in degrees decimal (WGS84).
  Also accepted as longitude.
- latnumber (double)required
  Latitude in degrees decimal (WGS84).
  Also accepted as latitude.

attributesAttributeItem[]

Attributes.

AttributeItem fields

attributeCodeenum

BeNomad Code of attribute.

132 accepted values

`__NOT_MAPPED`	Not mapped value.
`KEY`	Key.
`FEATURE_CLASS_CODE`	FCC = feature class code.
`INCLUSION_RELATION`	LAB = Inclusion relation.
`SELF_REF`	For SIV/VB SDK dynamic objects (self reference).
`ADMINISTRATIVE_CLASS`	AC = administrative class of a city (0: capital of a country, 1: capital of an order 1 area, etc.).
`ARABIC_ENGLISH_NAME`	AE = ARABIC ENGLISH name (latin alphabet).
`ARABIC_NAME`	AR = ARABIC name (arabic alphabet).
`ASSAMESE_NAME`	AS = ASSAMESE name (alphabet).
`ASSAMESE_LATIN_NAME`	AX = ASSAMESE_LATIN name (alphabet).
`AZERBAIJANI_NAME`	AZ = AZERBAIJANI name.
`BELARUSIAN_NAME`	BE = BELARUSIAN name (cyrillic alphabet).
`BULGARIAN_NAME`	BG = BULGARIAN name (cyrillic alphabet).
`BULGARIAN_LATIN_NAME`	BL = BULGARIAN name (latin alphabet).
`LANDMARK`	BM = 2D-Landmark meta data.
`BRAND_NAME`	BN = brand name.
`BOSNIAN_NAME`	BS = BOSNIAN name.
`BELARUSIAN_LATIN_NAME`	BT = BELARUSIAN name (latin alphabet).
`BENGALI_NAME`	BI = BENGALI name.
`BENGALI_LATIN_NAME`	BX = BENGALI name (latin alphabet).
`CATALAN_NAME`	CA = CATALAN name.
`COUNTRY_CODE`	CC = Country code.
`ENCODING`	CH = character encoding.
`COORDINATE_TYPE`	CO = coordinates' sytem.
`CZECH_NAME`	CS = CZECH name.
`WELSH_NAME`	CY = WELSH name.
`DANISH_NAME`	DA = DANISH name.
`GERMAN_NAME`	DE = GERMAN name.
`TRAFFIC_DIRECTION`	DF = direction of traffic flow.
`EXTRA_ATTRIBUTE`	EA = extra attributes for POIs objects.
`GREEK_GREEK_NAME`	EG = GREEK name (greek alphabet).
`GREEK_NAME`	EL = GREEK name (latin alphabet).
`ENGLISH_NAME`	EN = ENGLISH name.
`SPANISH_NAME`	ES = SPANISH name.
`ESTONIAN_NAME`	ET = ESTONIAN name.
`BASQUE_NAME`	EU = BASQUE name.
`FINNISH_NAME`	FI = FINNISH name.
`SOURCE_FORMAT`	F0 = source format.
`FRENCH_NAME`	FR = FRENCH name.
`FRISIAN_NAME`	FY = FRISISAN name.
`IRISH_NAME`	GA = IRISH name.
`GAELIC_NAME`	GD = GAELIC name.
`GALICIAN_NAME`	GL = GALICIAN name.
`GUARANI_NAME`	GN = GUARANI name.
`GEORGIAN_LATIN_NAME`	GT = GEORGIAN_LATIN name.
`GUJARATI_NAME`	GU = GUJARATI name.
`GUJARATI_LATIN_NAME`	GX = GUJARATI_LATIN name.
`HEADER`	HD = header.
`HEBREW_NAME`	HE = HEBREW name.
`HINDI_NAME`	HI = HINDI name.
`HEBREW_LATIN_NAME`	HL = HEBREW name (latin).
`ALPHA_HOUSE_NUMBER`	HN = Alphanumerical house number.
`HINDI_LATIN_NAME`	HT = HINDI name (latin).
`HUNGARIAN_NAME`	HU = HUNGARIAN name.
`INTERNATIONAL_CODE`	IC = international code.
`INDONESIAN_NAME`	IN = INDONESIAN name (ID reserved for LinkIDs).
`ICELANDIC_NAME`	IS = ICELANDIC name.
`ITALIAN_NAME`	IT = ITALIAN name.
`JAPAN_NAME`	JA = JAPAN name.
`JAPAN_LATIN_NAME`	JL = JAPAN name (latin).
`KANNADA_NAME`	KA = KANNADA name (latin).
`KAZAKH_NAME`	KK = KAZAKH name.
`KAZAKH_LATIN_NAME`	KL = KAZAKH name (latin alphabet).
`KOREAN_NAME`	KO = KOREAN name.
`KOREAN_LATIN_NAME`	KT = KOREAN name (latin).
`KANNADA_LATIN_NAME`	KX = KANNADA_LATIN name (latin).
`LANGUAGE`	LA = language for objects' names.
`LETZEBURGESCH_NAME`	LB = LETZEBURGESCH name.
`HOUSE_NUMBER_LEFT`	LE = House number left.
`LENGTH`	LG = length in meters.
`LANDMARK_3D`	LM = 3D landmark texture.
`LANE_NUMBER`	LN = number of lanes.
`LEGAL_SPEED`	LS = Legal Speed.
`LITHUANIAN_NAME`	LT = LITHUANIAN name.
`LATVIAN_NAME`	LV = LATVIAN name.
`MALAYALAM_NAME`	MA = Malayalam name.
`MACEDONIAN_LATIN_NAME`	MC = MACEDONIAN name (latin alphabet).
`MACEDONIAN_NAME`	MK = MACEDONIAN name (cyrillic alphabet).
`MOLDAVIAN_NAME`	MO = MOLDAVIAN name.
`METRO`	MO = Metro (0 : not a metro station; 1 : metro station).
`MALAY_NAME`	MS = MALAY name.
`MALTESE_NAME`	MT = MALTESE name.
`NB_BORDER_JUNCTIONS`	NB = Number border junctions.
`NB_JUNCTIONS`	NJ = Number junctions.
`DUTCH_NAME`	NL = DUTCH name.
`NORWEGIAN_NAME`	NO = NORWEGIAN name.
`STREET_NAME_AND_HOUSE_NUMBER`	NS = Street name and house number.
`OFFICIAL_CODE`	OC = Official Code.
`NAME`	ON = Official Name.
`POPULATION_CATEGORY`	PC = Population Category.
`POPULATION`	PO = Population.
`POLISH_NAME`	PL = POLISH name.
`DATA_PROVIDER`	PR = data provider's name.
`POSTAL_CODE`	PS = postal code.
`PORTUGUESE_NAME`	PT = PORTUGUESE name.
`HOUSE_NUMBER_RIGHT`	RE = House number right.
`RUSSIAN_LATIN_NAME`	RL = RUSSIAN name (latin alphabet).
`RHAETO_ROMANCE_NAME`	RM = RHAETO-ROMANCE name.
`ROUTE_NUMBER`	RN = Route number (ex. E15, A6, N7, etc.).
`ROMANIAN_NAME`	RO = ROMANIAN name.
`RUSSIAN_NAME`	RU = RUSSIAN name (cyrillic alphabet).
`SCALE`	SC = coordinates' scale.
`SERBO_CROATIAN_NAME`	SH = SERBO-CROATIAN name.
`SIGN_INFORMATION`	SI = sign information.
`SLOVAK_NAME`	SK = SLOVAK name.
`SLOVENIAN_NAME`	SL = SLOVENIAN name.
`SPEED_CATEGORY`	SP = speed category (km/h): 0=10;1=20;2=30;3=40;4=50;5=60;6=70;7=80;8=90;9=100;10=110;11=120.
`ALBANIAN_NAME`	SQ = ALBANIAN name.
`SERBO_CROATIAN_LATIN_NAME`	SR = SERBO-CROATIAN name (latin alphabet).
`SVS_TYPE`	ST = SVS type.
`SWEDISH_NAME`	SV = SWEDISH name.
`TRUCK_ATT_TIME_DOMAIN_ATTRIBUTE`	T0 = Truck Attribute with a Time domain Attribute.
`TRUCK_ATTRIBUTE`	TA = Truck Attribute.
`TIME_DOMAIN_ATTRIBUTE`	TD = Time domain Attribute.
`TEXTURE_COORD`	TE = Texture coordinates (for 3D landmarks).
`THAI_NAME`	TH = THAI name.
`TRAFIC_INFO`	TI = Traffic Info Attribute.
`TELEPHONE`	TL = telephone number.
`TMC_LOCATION`	TM = TMC location.
`TOLL_ROAD`	TR = toll road.
`TURKISH_NAME`	TU = TURKISH name.
`THAI_LATIN_NAME`	TX = THAI name (latin alphabet).
`UKRAINIAN_NAME`	UK = UKRAINIAN name (cyrillic alphabet).
`UKRAINIAN_LATIN_NAME`	UL = UKRAINIAN name (latin alphabet).
`UTM_ZONE`	UT = UTM zone : 1 - 60, positif for north, negative for south.
`VIETNAMESE_NAME`	VI = VIETNAMESE name.
`VIETNAMESE_LATIN_NAME`	VL = VIETNAMESE name (latin alphabet).
`VALENCIAN_NAME`	VL = VALENCIAN name.
`VT_MASK`	VT = vehicle type mask.
`ANY_LANG`	XX = Any language code.
`CHINESE_NAME`	ZH = Chinese name.
`CHINESE_LATIN_NAME`	ZL = Chinese name (latin alphabet).

keystring
BeNomad key of attribute.
numericKeyinteger (int32)
Numeric key.
rawDataboolean
BeNomad raw data.
typeenum
Data type.
14 accepted values
NA
BOOLEAN
BYTE
BYTES
CHAR
DOUBLE
FLOAT
INT
LONG
STRING
KEY
LABEL
META
UINT
valuestring
Data value.

waypointPolylineCoordinate[]
Waypoints polyline of route. This polyline is composed of the coordinates of the route with inserted waypoint matched coordinates.
Coordinate fields
- lonnumber (double)required
  Longitude in degrees decimal (WGS84).
  Also accepted as longitude.
- latnumber (double)required
  Latitude in degrees decimal (WGS84).
  Also accepted as latitude.
eventsRoutingEvnt[]
Events on road. See the EVENT option.
RoutingEvnt fields
- typeenum
  Type of event.
  3 accepted values
  SEGMENT Each entry values come from the road segmentation of map data.
  SAMPLING_TIME Each entry values are sampled by time.
  SAMPLING_DISTANCE Each entry values are sampled by distance.
- distanceUnitstring
  Defines the distance unit.
- timeUnitstring
  Defines the time unit.
- markersRoutingEvntMarker[]
  List of markers.
  RoutingEvntMarker fields
  - distanceinteger (int64)
    The travel distance from start of the route.
  - timeinteger (int64)
    The travel time from start of the route.
  - percentnumber (double)
    The percentage of distance from start of the route.
  - coordinateCoordinate
    The coordinate of the marker.
    Coordinate fields
    lonnumber (double)required
    Longitude in degrees decimal (WGS84).
    Also accepted as longitude.
    latnumber (double)required
    Latitude in degrees decimal (WGS84).
    Also accepted as latitude.
  - entriesRoutingEvntEntry[]
    List of entries.
    RoutingEvntEntry fields
    typestring
    Type of entry.
    namestring
    Name of entry.
    jsonObjectany
    Representation of object value by JSON.

Response sample#

JSON Sample:

javascript

{
    "usedDestinations": [
        {
            "inputOrder": 0,
            "used": true,
            "usedOrder": 0,
            "matchedCoordinateGps": {
                "time": 0,
                "lon": 7.410589515220335,
                "lat": 43.73446
            },
            "confidenceValue": 0.26293365794278756,
            "distanceFromRequest": 0.26293365794278756,
            "polylineIndex": -1,
            "duration": -1,
            "length": -1
        },
        {
            "inputOrder": 1,
            "used": true,
            "usedOrder": 0,
            "matchedCoordinateGps": {
                "time": 0,
                "lon": 7.153760258732184,
                "lat": 43.7218875
            },
            "confidenceValue": 0.2531497216525051,
            "distanceFromRequest": 0.2531497216525051,
            "polylineIndex": -1,
            "duration": 2858,
            "length": 41176
        },
        {
            "inputOrder": 2,
            "used": true,
            "usedOrder": 0,
            "matchedCoordinateGps": {
                "time": 0,
                "lon": 7.150919586466134,
                "lat": 43.66243875
            },
            "confidenceValue": 0.2166680598512079,
            "distanceFromRequest": 0.2166680598512079,
            "polylineIndex": -1,
            "duration": 3697,
            "length": 49898
        },
        {
            "inputOrder": 3,
            "used": true,
            "usedOrder": 0,
            "matchedCoordinateGps": {
                "time": 0,
                "lon": 7.129009195030274,
                "lat": 43.62986375
            },
            "confidenceValue": 0.18562016614150673,
            "distanceFromRequest": 0.18562016614150673,
            "polylineIndex": -1,
            "duration": 4409,
            "length": 55188
        }
    ],
    "routingRoutes": [
        {
            "length": 55188,
            "duration": 4409,
            "trafficDelay": 0,
            "averageSpeed": 45.061646,
            "maximumSpeed": 0.0,
            "startUTurnThreshold": 3000,
            "startStopInfo": {
                "start": {
                    "lon": 7.41059,
                    "lat": 43.73446
                },
                "stop": {
                    "lon": 7.12901,
                    "lat": 43.62986
                },
                "distanceFirstMatched": 0.0,
                "distanceLastMatched": 0.42,
                "interDests": null
            }
        }
    ]
}

`UNDEF`	Status undefined.
`YES`	Status yes.
`NO`	Status no.

`UNDEF`	Status undefined.
`YES`	Status yes.
`NO`	Status no.

`UNDEF`	Status undefined.
`YES`	Status yes.
`NO`	Status no.

`UNDEFINED`	Undefined.
`YES`	Yes.
`NO`	No.