Skip to content
Use-Cases
Logistics

Logistics

All requests need a token (Access and limits); in server code use a secret token (mx_sk_…) and never ship it in a web page.

Fleet and delivery software needs a route that a truck can really drive, travel times for many pairs, a good order of stops and the current traffic situation. All four are one request each. Coordinates are lon,lat, times are seconds, distances metres.

Truck routes

The profile driving-truck takes the vehicle size and avoids roads with matching weight, height, width and length limits and bans. Without parameters it assumes 40 t, 4 m high and 2.55 m wide.

curl -s -H "Authorization: Bearer YOUR_TOKEN" "https://api.mapx.at/v1/directions/driving-truck/15.6256,48.2049;15.3294,48.2272?weight=40&height=4&width=2.55&length=16.5&truck_type=semi&overview=false" \
  | jq '.routes[0] | {distance, duration, truck, toll_go_km: .toll.truck_go_km}'

routes[0].toll.truck_go_km is the length subject to the GO toll; per step it is truck_go_m. Speeds follow truck limits (80 km/h on motorways). District-wide bans from free-text ordinances are not routed: affected roads come as steps[].notices[] with type: "truck_restriction"; show them to the dispatcher. For cars, exclude=toll and exclude=motorway avoid toll sections and motorways (profiles driving, driving-traffic and driving-truck); exclude=ferry works for every profile except driving-traffic.

With the SDK:

const r = await mapx.directions("driving-truck", [[15.6256, 48.2049], [15.3294, 48.2272]], { truck: { weight: 40, height: 4, width: 2.55, length: 16.5, type: "semi" }, steps: true });
const notices = r.routes[0].legs.flatMap((l) => l.steps).flatMap((s) => s.notices ?? []);

Travel times for many pairs

matrix answers all pairs in one request, up to the limits of the Matrix API. Use sources and destinations (indices) to ask for one row only.

const depots = [[16.3725, 48.2085], [15.3294, 48.2272], [14.2858, 48.3069]];
const q = depots.map((p) => p.join(",")).join(";");
const m = await (await fetch(`https://api.mapx.at/v1/matrix/driving/${q}?annotations=duration,distance&access_token=YOUR_TOKEN`)).json();
console.log(m.durations[0][1] / 60, "min", m.distances[0][1] / 1000, "km"); // Vienna to Melk

Plan the tour

POST /v1/optimization assigns jobs to vehicles and orders them: capacity, time windows, service times (seconds), start and end per vehicle. At most 10 vehicles, 50 jobs and 60 distinct locations per request.

const body = {
  profile: "driving",
  vehicles: [{ id: 1, start: [16.3725, 48.2083], end: [16.3725, 48.2083], time_window: [28800, 61200] }],
  services: [
    { id: 1, location: [15.6256, 48.2049], service: 300, time_windows: [[32400, 43200]] },
    { id: 2, location: [14.2858, 48.3069], service: 600 },
  ],
};
const res = await fetch("https://api.mapx.at/v1/optimization?access_token=YOUR_TOKEN", { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(body) });
const tour = await res.json();
console.log(tour.routes[0].steps.map((s) => s.id ?? s.type), tour.unassigned); // unassigned: jobs that did not fit

Draw the result with one directions request through tour.routes[0].steps locations (up to 25 points); see the tour planning example.

Traffic

Use driving-traffic for a route with the current traffic and closures. Incidents on the route come with incidents=true in legs[].incidents. For a region, list the active incidents or show the traffic style:

const bbox = [14.5, 47.8, 16.9, 48.6]; // Lower Austria
const { features } = await (await fetch(`https://api.mapx.at/v1/traffic/incidents?bbox=${bbox}&active=true&type=construction&limit=50&access_token=YOUR_TOKEN`)).json();
console.log(features.length, features[0]?.properties.road, features[0]?.properties.text);

The map style traffic-day shows the flow; see the example. Traffic data: ASFINAG / EVIS.AT (CC BY 4.0).

Next steps

Real estateTourism