Documentation and Tutorial

You can find the full developer doc here.

Our tutorial explains the basic concepts of the MapTrip Server-API and illustrates them with examples.

On our YouTube channel you will find numerous videos on development topics.

On Github you can find useful hints and examples.

ETA Calculation

For some applications, only the Estimated Time of Arrival (ETA) is required.

Via the interface for route calculation, the start, destination, vehicle type and time / date can be transferred.

The calculation of the trip duration is then performed, as desired, taking into account the current traffic situation, the estimated traffic situation (if a time / date is specified) or using a general traffic situation.

There are also special vehicle profiles for cars, trucks and for blue light journeys.

You have questions about the ETA calculation? Send us a message – we will be happy to advise you.

Route Planning

The goal of route planning is to determine a driving distance from a start to a destination as well as the travel time. The MapTrip Server-API can also take into account a variety of parameters to accurately map any application scenario. In response to a routing request, the server provides the exact geometry of the route along with key points such as travel time and length of the route.

 

 

We give an overview of the route calculation interface. In route calculation, there are numerous parameters such as traffic messages, statistical traffic data and vehicle dimensions (length, width, weight, dangerous goods, etc.).

The following parameters, among others, can be taken into account when calculating the route:

  • Vehicle type (car, truck)
  • Truck attributes (length, width, height, weight, etc.)
  • Take live traffic messages into account? Yes/no
  • Start time (to consider statistical traffic data)
  • Via points (with via points the course of the route can be specified)
  • Consider personal changes to road maps (Detour function)
  • Calculation with TomTom, Here or OpenStreetMap

The route can be exported as a reference route so that it can be seamlessly reused in MapTrip or in the FollowMe editor.

Capture Road Closures

Record road closures, the location of construction sites or simply roads that should not be used by your vehicles. This function is used e.g. by fire departments to prevent emergency vehicles from being led into streets that are not passable.

 

Using the Server-API, you can select individual road segments or entire road courses by coordinate and block or unblock them.

Define the time from which the blocking / unblocking is valid or define a period of validity.

Your closures are taken into account in route calculations.

You want to know more – write us a message!

Editing Truck Restrictions

Truck restrictions are stored in the map data of the truck navigation. They contain information such as the height of a tunnel, the maximum weight with which a bridge may be driven on or the width of a road. With the additional function “Detour” you can edit them yourself.

truck restrictions in a truck gps navigation can be edited

A missing truck restriction, e.g. a low tunnel, can be added in the Detour Editor with a few clicks. Existing truck restrictions can be changed or deleted completely. These functions are interesting for fire departments, for example, who do not have to adhere to the usual traffic rules during emergency trips. But these functions are also useful for other applications, e.g. in heavy goods traffic, e.g. to record the clearance width of a construction site. Truck restrictions can also be captured automatically via the MapTrip Server API.

 

 

 

 

Personalize Route Calculation

No route planner knows your local environment as well as you do. Even the most up-to-date maps from the most professional providers don’t know the potholes you want to avoid or the confusing intersection that always leads to dicey situations. To allow you to tailor the route planning to your exact needs, the Server-API provides functions for preferring and avoiding road sections.

Die Navigationskarte kann bearbeitet werden.

This allows you to mark individual road sections that are preferred for route calculation (and navigation).

Similarly, other routes can be avoided.

The changes you enter are taken into account during route calculation, trip planning and navigation. They are also displayed in the Detour Editor and can be edited.

Want to read more about the Detour Editor and our navigation for police and firefighters?

Features

  • Geocoding

    Geocoding is the process of assigning a geocoordinate to an address. Since route calculation and route planning require geocoordinates as input variables, geocoding is the starting point of most interactions with the Server-API. If you are looking for a solution for batch geocoding of large address quantities, please contact our sales department. We will be happy to advise you.

    More...
  • Routing

    Routing is the calculation of a concrete route between two locations. Routing requires two pairs of coordinates as an input variable. As a result, the routing provides a travel time, the length of the route and the detailed geometry of the route as a polyline. Numerous other parameters can be passed to the routing, e.g. to take into account the traffic situation or vehicle dimensions. Individual changes such as closures or preferred roads are also taken into account. The course of the route can be modified by specifying via points. In extreme cases, the route can thus be completely predefined. Each route can be exported and imported as a reference route from our editors (for further editing) or from the navigation (for driving off).

    More...
  • Sequence optimization

    The goal of sequence optimization is to determine the optimal sequence of stops in order to minimize the travel distance or travel duration. Constraints such as relative order or length of stay can be taken into account. The distance or travel time matrix on which the optimization is based is determined with all routing options (traffic, vehicle profiles, dimensions, closures, etc.).

    More...
  • Block / unblock roads

    The Server-API offers the possibility to lock or unlock single road segments (identified by one coordinate) or complete road routes (identified by multiple coordinates). Blocked roads are avoided by the routing (except for the last meters to the destination). Roads blocked in the map material (e.g. field paths, paths in parks or pedestrian zones) can be unblocked with the function.

    More...
  • Prefer / avoid roads

    Roads can be edited to be used preferentially by the routing or to be avoided. A typical application scenario is the use of a bypass road around a town or the direct route through the town center. Depending on the application scenario (bypass road for heavy traffic or the direct route for the fire department), the respective roads can be prioritized.

    More...
  • Edit truck attributes

    The function allows you to change or add properties of road segments that are taken into account during route calculation or navigation. The following values are stored or can be created as truck attributes in the maps: - Length - Height - Width - Weight - Axle load - Water hazardous materials - Dangerous goods - Explosive load The data can be taken into account in the route calculation by referencing them in the routing call. They can be visualized and also edited in the Detour Editor.

    More...

Seamless Integration With Truck Navigation

The servers behind the API also serve our GPS navigation MapTrip and its editors. The data formats generated by the Server-API can be seamlessly reused in our navigation MapTrip and in our editors. A route calculated with the Server-API can therefore easily be passed directly to MapTrip for navigation, or further processed in one of the editors.

 

What road maps are available?

You can use the Server-API with road maps from TomTom, Here or OpenStreetMap. You don’t have to worry about updates, we do that for you continuously in the background. Depending on your use case, you can choose the best map source. For truck navigation, we recommend TomTom and Here, which have included almost all truck restrictions (e.g. width, height, weight) in their maps. OpenStreetMap on the other hand offers a lot of details and numerous small routes which are partly missing in the other maps.

 

What traffic information does the Server-API use?

The traffic information comes from TomTom and from Here. Through the Server-API you have access to current traffic messages, the flow speed of traffic on each segment in real time and statistical traffic data.

 

 

 

What Tasks Can You Solve With The MapTrip Server-API?

The MapTrip Server-API provides direct access via interfaces to services such as routing, sequence optimization, route planning but also for blocking roads.

Via clearly documented interfaces (Swagger) you have direct access to the desired functions. The individual functions can be linked with each other, so that a wide range of services is available to you, with which the diverse requirements of modern route planning can be solved.

  • Tour optimization

    Are you planning bulky waste tours? Use the sequence optimization here and send the recharge points of your bulky waste tour to the MapTrip Server-API. You will receive the recharge points back in the optimal order, e.g. regarding the tour duration. Time windows, vehicle restrictions by length, height, width, etc. or road closures (see below) can also be taken into account. The calculated route from the tour optimization can be immediately loaded into MapTrip Navigation and used there.

  • ETA calculation

    Want to know as accurately as possible when your vehicles will arrive at their destinations? Simply send the current location and destination to the MapTrip Server-API. The current arrival time is calculated taking into account real-time traffic information and is available to you as a route overview or simply as a value. Also here, of course, truck dimensions such as length, height, width, weight can be included.

  • Road closures

    You have individual information about road closures? Via the MapTrip Server-API, you can ensure that these are directly taken into account in route planning and navigation. Situations in which vehicles are unplanned in front of obstacles such as road works or transit bans are thus a thing of the past.

For Whom Is The MapTrip Server-API?

  • Transport & logistics or petroleum industry

    Use the distance and time calculation as well as the route optimization, beyond a web interface, performant per standardized calls, for calculations, price calculations integrated with an own backend. The ETA calculation takes into account real-time traffic information. The result is available as a route summary or value. The MapTrip Server API can also include truck dimensions such as length, width and weight.

  • Control centers

    With the MapTrip Server-API you can make a 1-n deployment preselection in control centers. Afterwards, you can perform a detailed calculation in the Detour editor. As a dispatcher, you can thus quickly determine how long it takes a vehicle to reach a specific address.

  • Waste management, street cleaning or winter road maintenance

    The interface to the MapTrip FollowMe Server offers a deeper integration possibility of the MapTrip FollowMe Editor (Online) for coupling with other tour management systems. Especially in the municipal sector, double data backup is a frequently asked requirement (online-offline).

Perfect Trio For Professional Demands

The perfect partners of the Server-API are the MapTrip MapAPI, a JavaScript API that can be

used to develop web applications,and the MapTrip GPS Navigation, which allows you to drive the calculated tours directly.

 

MapTrip’s JavaScript MapAPI is the perfect tool for creating map-based applications. It provides easy communication with the MapTrip app for tracking positions, sending destinations and querying arrival times. In addition, MapAPI provides professional routing and planning features based on the best map and traffic data on the market.

 

MapTrip is a (truck) navigation software tailored for professional use with the following highlights:

  • Best map data from TomTom, Here or OpenStreetMap
  • Best and extensive traffic information
  • Always on the fastest route
  • Exact arrival time calculation
  • Simple and intuitive user interface – optimized for truck use
  • Truck parking
  • Gas stations with fuel prices
  • Has interfaces
  • Numerous AddOns like:

 

  • Reference route: Often tours are optimized in a complex way. If then only the navigation destination is transferred to the navigation, it calculates the route itself and the optimization results are lost. With the reference route it is possible to drive externally pre-planned routes in their exact course.
  • Remote: Remote control of MapTrip via web application, e.g. sending of single navigation destinations or complete routes, retrieval of current navigation parameters up to the course of the current route.
  • Detour: Individual blocking or unblocking of roads.