NAV API (planned)

The planned API of the INTEGALL NAV server for truck routes and addresses, with NAV keys.

Last updated: Need help? Contact support

The NAV server calculates routes for trucks (with height, width, length, weight, axle load and ADR tunnel categories), searches addresses and returns points along the road, such as truck parkings and fuel stations. It uses open map data (© OpenStreetMap contributors) and INTEGALL's own data, such as verified road reports.

Paths in the code#

PathPermissionPurpose
/v1/routerouteCalculate a truck route.
/v1/geocodegeocodeSearch an address.
/v1/poi–Points along the road (fuel stations, rest areas, truck parkings, truck wash, truck repair).
/v1/parking, /v1/events–Truck parkings and traffic events from open government data.

Authentication#

  • External systems (ERP, TMS) use a NAV key in the X-INTEGALL-Key header.
  • The office and driver apps use the user's own sign-in, not a key.

NAV keys are created by the owner or an administrator in the company panel under SettingsAPI keys, with the permissions Calculate routes, Search addresses, Map tiles and Override vehicle profile. A key is shown only once. See API keys and webhooks.

Privacy#

The NAV server does not log addresses, coordinates, search texts, keys or trip numbers; only status, duration, company, key id, engine and kilometres.

The address, the exact fields of the requests and responses and the limits will be published here as soon as the NAV server goes into production.