Router API

Request format

https://router.api.mappable.world/v2/
  ? apikey=<string>
  & waypoints=<lon1,lat1|lon2,lat2|...>
  & [mode=<string>]
  & [departure_time=<integer>]
  & [avoid_tolls=<boolean>]
  & [weight=<float>]
  & [axle_weight=<float>]
  & [max_weight=<float>]
  & [height=<float>]
  & [width=<float>]
  & [length=<float>]
  & [payload=<float>]
  & [eco_class=<integer>]
  & [has_trailer=<boolean>]

All params

apikey

Required parameter

The key issued in the Mappable Account.

Note

Key activation takes up to 15 minutes.

waypoints

Required parameter

Route points specified in decimal degrees (WGS84 standard).
Each point is defined as a coordinate pair in the format: <longitude,latitude>
Coordinate pairs (points) are separated with a vertical bar «|».

  • If driving or truck is specified in the mode field, the maximum number of elements is 50.
  • If walking or transit is specified in the mode field, the maximum number of elements is 25.

mode

Type of travel on the route. Acceptable values:

  • driving: Passenger car route. Used by default.
  • truck: Truck route.
  • walking: Walking route.
  • transit: Public transit route.

departure_time

The departure time in UNIX time. Used for calculating the expected traffic congestion. If this parameter is not specified, the traffic forecast is made for time when the request was processed.
This value can't be in the past.

Alert

This parameter is not used when calculating walking routes (mode=walking).

avoid_tolls

No toll roads. When true, the route avoids toll roads. Default value: false.

weight

Vehicle weight in tons (only for mode=truck).

axle_weight

Actual vehicle axle load in tons (only for mode=truck).

max_weight

Maximum allowed vehicle weight in tons (only for mode=truck).

height

Vehicle height in meters (only for mode=truck).

width

Vehicle width in meters (only for mode=truck).

length

Vehicle length in meters (only for mode=truck).

payload

Maximum vehicle load capacity in tons (only for mode=truck).

eco_class

Vehicle emission standard (only for mode=truck).

has_trailer

Trailer (only for mode=truck). Default value: false.