Release History

Version Release Date Changes
2.25.2 2026-05-08
  • Routing
    • Fixed a bug that could occur in endpoint [GET] /route/reference
  • Miscellaneous
    • Internal changes to handling of dates with time zones
    • Internal changes to caching
2.25.1 2026-04-27
  • Matrix
    • Increased region size (see tutorial)
    • Added provider TomTom Orbis for matrix calculation
  • Route Optimization
    • Increased region size and maximum number of stops (see tutorial)
    • Added provider TomTom Orbis for route optimization
2.25.0 2026-04-15
  • Routing
    • Start, destination and waypoints may now also include a street name (see tutorial)
    • Added parameter output for endpoint [GET] /route (see tutorial)
    • Endpoint [GET] /route/eta now returns toll cost for routes in Germany (see tutorial)
  • Matrix
    • Added time to live to matrix calculation results (see tutorial)
  • Route Optimization
    • Added time to live to route optimization results (see tutorial)
  • Remote
    • Directions returned by [GET] /remote/route/{device} now contain text attribute
  • Miscellaneous
    • Swagger UI now with light dark theme
2.24.3 2026-03-30
  • POI
    • Endpoint [GET] /poi/parking/{from}/{to}: Fixed HappyTrucker parking areas
2.24.2 2026-03-03
  • Detour
    • Fixed point features for endpoint [GET] /detour/file/{fileid}/geojson
  • FollowMe
    • Endpoint [DELETE] /followme/folder/{folder}/file/{file} occasionally returned wrong status code
2.24.1 2026-02-24
  • Routing
    • Invalid values for signage are ignored (Orbis only)
    • Internal changes to routing request parameters
  • Remote
    • Endpoints [GET] /remote/status/{device} and [GET] /remote/status/all no longer return an invalid coordinate if device location is unknown
2.24.0 2026-01-28
  • Routing
    • Routing endpoints [GET] /route now support route flavors (see tutorial)
    • Added cost to route summary and new parameters costPerKilometer and costPerHour (see tutorial)
    • Vehicle type truck is deprecated and replaced by truck_highway (see tutorial)
    • Fixed distance calculation for routes which had multiple stops at the same coordinate
  • Remote
    • Endpoint [POST] /remote/route/itinerary/{device} now allows via points to be handled as reference routes in MapTrip
    • Endpoint [POST] /remote/route/reference/{device} prevents sending reference routes to versions which cannot handle them
  • Detour
    • New endpoints [GET] /detour/attribute/address and [GET] /detour/attribute/comment (see tutorial)
2.23.2 2025-12-11
  • Added provider TomTom Orbis for routing, detour and mapdata endpoints
2.23.1 2025-11-20
  • Endpoint [GET] /remote/devices/details now has new property type (see tutorial)
  • Endpoint [GET] /route now returns length for all destinations of a route (see tutorial)
  • Fixed endpoint [GET] /route/eta with waypoints: It now returns a list of summary objects, one for each waypoint and the destination
2.23.0 2025-10-17
  • New endpoints [GET] /poi/roadworks/points/{from}/{to} and [GET] /poi/roadworks/lines/{from}/{to} (see tutorial)
  • New filter parameter for endpoints [GET] /detour/file/{fileid}/geojson, [GET] /detour/file/{fileid}/segment/all, [GET] /detour/file/{fileid}/road/all and [GET] /detour/file/{fileid}/turnrestriction/all (see tutorial)
  • New endpoints [GET] /followme/folder/{folder}/devices and [GET] /followme/folder/{folder}/devices/details to query the devices of a FollowMe folder / pot (replacing deprecated endpoints [GET] /followme/devices and [GET] /followme/devices/details, see tutorial)
  • Fixed: [GET] /followme/devices and [GET] /followme/devices/details returned devices that were assigned to multiple pots multiple times
2.22.0 2025-08-05
  • Endpoints [GET] /poi/fuelstations/{from}/{to}, [GET] /poi/fuelstations/{fuelType}/{from}/{to} and [GET] /poi/fuelstations/{id} to query fuel stations and prices (see tutorial)
  • Endpoint [GET] /poi/parking/{from}/{to} now also returns information from Toll Collect Stellplatz-Informationsdienst (see tutorial)
  • [GET] /route: Improved problem details when called with a non-existing Detour file
2.21.1 2025-07-11
  • Endpoint [GET] /detour/file/{fileid}/geojson: Fixed format of time domains
  • Endpoints [GET] /route and [GET] /poi/parking/{from}/{to}: Malformed values for Accept-Language no longer return internal server errors
2.21.0 2025-07-02
  • Endpoint [GET] /route: Option to request toll costs for truck routes in Germany (see tutorial)
  • Endpoint [GET] /route: Improved obstacles along the road (see tutorial)
  • Endpoints [GET] /route, [GET] /route/eta and [GET] /route/reference: New parameter emergencyRouting (see tutorial)
  • Endpoint [GET] /route: Fixed the calculation of driving time and ETA for off-road starts and destinations (see tutorial)
  • Endpoint [GET] /usage now returns some additional statistics (see tutorial)
2.20.3 2025-06-11
  • Internal change to parking areas
2.20.2 2025-05-26
  • Internal change to usage counters
2.20.1 2025-05-19
  • Fix: Requests without Accept header did not get proper problem details
2.20.0 2025-05-09
  • New endpoint /route/eta (see tutorial)
  • New endpoint /poi/parking/{min}/{max} (see tutorial)
2.19.1 2025-03-18
  • Limited all /remote endpoints to devices with the license option remote
2.19.0 2025-03-06
  • New endpoint [GET] /geocoder/autocomplete (see tutorial)
  • New endpoint [GET] /followme/folder/{folder}/status (see tutorial)
  • New endpoint [GET] /followme/folder/{folder}/remarks (see tutorial)
2.18.1 2025-01-27
  • Fixed: Endpoint [POST] /detour/file/{fileid}/segments did not accept segments of type CutPoint
2.18.0 2025-01-14
  • Supports problem details according to RFC 9457 (see tutorial)
  • Endpoint [GET] /route now returns all countries through which a route passes (see tutorial)
  • Endpoint [GET] /route now adds a direction when a country border is crossed (see tutorial)
  • New endpoint /detour/file/{fileid}/geojson to allow visualization of a Detour file in maps (see tutorial)
  • Endpoints /remote/route/itinerary/{device} and /remote/route/reference/{device}: Limited length and allowed characters for message
  • Fixed: The descriptions of some error messages were in German instead of English
2.17.2 2024-12-20
  • Internal change to usage counters
2.17.1 2024-11-19
  • Endpoint [POST] /detour/file/{fileid}/turnrestriction/add now allows setting the validity
  • Internal change to endpoint [POST] /detour/file/{fileid}/segments
2.17.0 2024-11-04
  • New query parameter for endpoints [GET] /detour/file/{fileid}/segment/all, [GET] /detour/file/{fileid}/road/all and [GET] /detour/file/{fileid}/turnrestriction/all (see tutorial)
  • Endpoint [POST] /detour/file/{fileid}/turnrestriction/add now can be called with a description for the turn restriction and replaces deprecated endpoint [POST] /detour/file/{fileid}/turnrestriction
  • Endpoint [POST] /detour/file/{fileid}/turnrestriction/remove now can be called with a description for the turn restriction
  • Removed deprecated endpoints
    • [GET] /detour/attribute/vehicle/tunnelRestrictionCode (deprecated since V2.10.0)
    • [GET] /detour/turnrestrictions/geojson/{from}/{to} (deprecated since V2.10.0)
    • [GET] /detour/attribute/unblock (deprecated since V2.8.0)
2.16.1 2024-09-11
  • Endpoint [GET] /route now returns the meters with toll up to this destination for all intermediate destinations of a route (see tutorial)
  • Endpoint [POST] /remote/route/itinerary/{device} no longer uses the coordinate as default if no name is passed, so that the address is displayed more nicely in MapTrip
  • Fixed error handling if resolving the token's company fails
2.16.0 2024-08-16
  • Endpoint [GET] /route now returns driving time and estimated time of arrival for all intermediate destinations of a route (see tutorial)
2.15.1 2024-07-25
  • Internal changes to the usage limits
2.15.0 2024-06-24
  • New [POST] /detour/file/{fileid}/turnrestriction/edit to edit validity and description of a turn restriction (see tutorial)
  • The endpoint [GET] /usage now returns both daily and monthly usage data
  • Fixed: [POST] /detour/file/{fileid}/road/match now ensures that the coordinates can be matched to different road segments, and otherwise returns 400 Bad Request
  • Fixed: Endpoint [GET] /remote/route/{device}/ now returns length of route and length with toll
2.14.0 2024-05-24
  • New endpoint [GET] /detour/attribute/speed to override the driving speed of a segment replaces the deprecated endpoints [GET] /detour/attribute/prioritize and [GET] /detour/attribute/penalize
  • Driving directions of routes now have a text (see tutorial for an example and how to change the language)
  • Endpoint [GET] /route: Attribute drivingTime adjusted so that time for turning maneuvers is included
  • Fixed a caching issue for [PUT] /remote/name/{device} and [PUT] /remote/notes/{device}
  • Detour endpoints to create or update segments or roads returned wrong status code if an attribute had no name or no value
2.13.0 2024-04-18
  • Routes now have additional directions "continue on ..." for name changes
  • Routes now have names
  • New parameter useTurnRestrictions for endpoints [GET] /route and [GET] /route/reference
  • New parameter defaultRouting for endpoint [GET] /detour/attribute/validity
  • New endpoint [GET] /mapdata/prohibitedfortrucks/geojson/ to query roads prohibited for trucks (see tutorial)
  • Additional properties for endpoint [GET] /mapdata/vehicleattributes/geojson/{from}/{to} (see tutorial)
2.12.1 2024-04-10
  • Remote endpoints now accept long device IDs used by Apple devices
  • Fixed: Endpoint [GET] /route returned an error if parameter waypoints was present but empty
2.12.0 2024-03-07
  • Each error that occurs in the API now has a unique code to simplify error handling, see tutorial
  • New endpoint [GET] /usage to query your usage of the MapTrip Server API
  • New endpoint [PUT] /detour/file/{fileid}/road/{roadid} to update roads created with Detour
  • Both [GET] /detour/attribute/prioritize and [GET] /detour/attribute/penalize now have an optional parameter direction
  • Both GET /remote/status/{deviceid} and GET /remote/status/all now return additional information when MapTrip is on a tour
  • Fixed GET /remote/status/{deviceid} and GET /remote/status/all for devices missing version, application or platform information
  • All remote endpoints can now access all MapTrip devices of your company
  • The Endpoints [GET] /route and [GET] /route/reference now return 400 Bad Request when avoid highways is set and the route exceeds 100 km (beeline distance)
  • The Endpoints [POST] /matrix/async and and [POST] /matrix/sync now return 400 Bad Request when avoid highways is set and the matrix diameter exceeds 100 km
  • Fixed status codes for detour endpoints with a token not configured for detour
  • Updated documentation on adding and dividing roads in tutorial
  • Updated documentation on traffic flows and statistical traffic information in tutorial
2.11.2 2023-12-18
  • Fixed a bug in [GET] /remote/route/{device}
2.11.1 2023-11-08
  • Device status was occasionally set incorrectly for [GET] /remote/status/{device} and [GET] /remote/status/all
  • Fixed truck attributes for roads uploaded with [POST] /detour/file/{fileid}/segments
  • Endpoints [PUT] /detour/file/{fileid}/segment/{segmentid} and [POST] /detour/file/{fileid}/segments no longer accept invalid truck attributes
  • Updated response for 429 Too Many Requests
  • Added HTTP header x-iw-regionsize to endpoints [POST] /matrix/async and [POST] /matrix/sync (see tutorial)
2.11.0 2023-10-10
  • New endpoint [GET] /remote/status/all to query the status of all your MapTrip devices at once
  • [POST] /remote/route/itinerary/{device}: Both the itinerary and the addresses can now have an ID and a name
  • [GET] /remote/status/{device} and [GET] /remote/status/all now return the driving direction in degrees (if known, default is 0)
  • Endpoint [POST] /detour/file/{fileid}/segment/match replaces the deprecated endpoint [POST] /detour/match
  • Fixed endpoint [GET] /detour/attribute/deleteroad
  • Fixed OpenLR codes for [GET] /detour/turnrestrictions/{from}/{to}
  • Improved examples in the specification
2.10.1 2023-07-24
  • Fixed some status codes for these endpoints:
    • [POST] /authenticate
    • [GET] /route
    • [GET] /route/reference
    • [GET] /followme/folder/{folder}/file/{file}/csv
    • [GET] /followme/folder/{folder}/file/{file}/csv/{date}
    • [GET] /followme/folder/{folder}/file/{file}/ride/{ride}/status
2.10.0 2023-06-29
  • Endpoints related to map data, see tutorial
    • New endpoint [GET]/mapdata/roadsegments/geojson/{coordinate} to query name, type and speed of a road segment
    • Endpoint [GET] /mapdata/turnrestrictions/geojson/{from}/{to} replaces the deprecated endpoint [GET] /detour/turnrestrictions/geojson/{from}/{to}
    • Endpoint [GET] /mapdata/vehicleattributes/geojson/{from}/{to} to query vehicle attributes like height or weight limits
  • Detour endpoints:
    • New endpoint [POST] /detour/file/{fileid}/segment/divide to divide a road segment
    • New endpoint [GET] /detour/attribute/removedvehicleattributes to remove existing vehicle attributes from the map data, see tutorial
    • New endpoint [GET] /detour/file/{fileid}/connectivity to check if you need to update a Detour file due to map data updates
    • Endpoint [GET] /detour/attribute/vehicle/tunnelrestrictioncode replaces the deprecated endpoint [GET] /detour/attribute/vehicle/tunnelRestrictionCode
  • MapTrip Remote endpoints: (see tutorial)
    • New endpoint [PUT] /remote/name/{device} to rename a device
    • New endpoint [PUT] /remote/notes/{device} to add notes to a device
2.9.4 2023-06-06
  • Fixed reading of Detour files with ignored vehicle attributes
  • Slightly increased radius for endpoint [POST] /detour/file/{fileid}/road/match
2.9.3 2023-05-11
  • Fix: FollowMe endpoints did not work for files and folders with numerical names
2.9.2 2023-04-20
  • Fix for endpoint [POST] /detour/file/{fileid}/segments
2.9.1 2023-03-22
  • Fix for [GET] /detour/file/{fileid}/road/all
2.9.0 2023-03-14
  • Batch insert and delete to detour files, see tutorial:
    • Endpoint [POST] /detour/file/{fileid}/segments to batch insert Detour segments
    • Endpoint [DELETE] /detour/file/{fileid}/segments to remove all segments from a Detour file
  • New endpoint [GET] /detour/attribute/deleteroad to query attributes which remove a road from the map data
  • New endpoint [GET] /detour/attribute/validity to define whether segment attributes should be considered for emergency routes or not (see tutorial)
  • New endpoint [GET] /detour/attribute/description to add descriptions to segments which are shown in the Detour Editor
  • New endpoints for turn restrictions:
    • [GET] /detour/file/{fileid}/turnrestriction/all to query all added or removed turn restrictions from a file (see tutorial)
    • [GET] /detour/file/{fileid}/turnrestriction/{turnrestrictionid} to query one added or removed turn restriction from a file
    • [POST] /detour/file/{fileid}/turnrestriction/remove to delete added or removed turn restrictions from a file (see tutorial)
  • All geocoder endpoints now add administrative areas to addresses if available see tutorial
  • Adding and updating Detour segments, turn restrictions and roads adds created, modified and modified by attributes which are shown in the Detour Editor
  • Fixed route optimization with time slots
2.8.0 2023-01-23
  • Switched to an OpenAPI 3.0 specification (YAML and JSON)
  • Endpoint [GET] /detour/attribute/unblock is deprecated and replaced by [GET] /detour/attribute/open
  • Endpoints [GET] /detour/attribute/prioritize and [GET] /detour/attribute/penalize now can be parameterized
  • Endpoints for Turn Restrictions, see tutorial:
    • [GET] /detour/turnrestrictions/{from}/{to} to query turn restrictions from the map data
    • [GET] /detour/turnrestrictions/geojson/{from}/{to} to query turn restrictions from the map data
    • [POST] /detour/file/{fileid}/turnrestriction/remove to remove turn restrictions from the map data
    • [POST] /detour/file/{fileid}/turnrestriction to add new turn restrictions
  • Fixes:
    • Fixed a bug in [GET] /route
    • Fixed [GET] /route without startTime (time-independent route)
    • Fixed vehicle attributes for [POST] /detour/file/{fileid}/road
2.7.2 2022-12-12
  • The endpoints [GET] /detour/devices and [GET] /detour/devices/detailed now also return devices from device groups
  • The endpoints [GET] /followme/devices and [GET] /followme/devices/detailed now also return devices from device groups
  • The endpoints [GET] /remote/devices and [GET] /remote/devices/detailed now also return devices from device groups
  • For optimizations with invalid coordinates, [GET] /optimize/stops/{id} now returns 400 Bad Request instead of 500 Internal Server Error
  • For attributes with invalid values, [POST] /detour/file/{fileid}/segment now returns 400 Bad Request instead of 500 Internal Server Error
2.7.1 2022-11-22
  • Endpoint [GET] /route/reference: Added more coordinates to CSV (when called without distance) to speed up calculation in MapTrip
  • Fixed some response codes in the documentation
2.7.0 2022-10-31 Added emergency routing, see tutorial
2.6.0 2022-10-04 Endpoints to create new roads with MapTrip Detour, see tutorial
2.5.0 2022-09-13
  • Detour vehicle attributes:
    • New endpoint [GET] /detour/attribute/vehicle/axles
    • New endpoint [GET] /detour/attribute/vehicle/tunnelRestrictionCode
  • Detour time domains
    • New endpoint [GET] /detour/attribute/timedomain/start
    • New endpoint [GET] /detour/attribute/timedomain/end
    • New endpoint [GET] /detour/attribute/timedomain/daily
    • New endpoint [GET] /detour/attribute/timedomain/weekly
    • New endpoint [GET] /detour/attribute/timedomain/monthly
2.4.0 2022-06-23
  • The endpoint [POST] /remote/route/reference has a new parameter doGuideThroughStartingPoint
  • RouteSummary now has attribute delay, which indicates the delay on the route under current traffic situation in seconds
  • The endpoints [GET] /route and [GET] /route/reference now have parameters to take low emission zones into account
2.3.0 2022-06-08 New endpoint [POST] /authenticate/apikey to obtain a JWT as an alternative to [POST] /authenticate, see obtaining a JWT token with an API key
2.2.0 2022-05-27 Endpoint [GET] /route now returns obstacles on the route in the route summary
2.1.1 2022-04-19 Endpoint [GET] /route/reference now has a parameter distance that specifies the distance between the coordinates; if no distance is specified, one coordinate per segment is chosen
2.1.0 2022-03-10 Added endpoints to use Detour API with MapTrip
2.0.2 2022-03-03
  • The duration for how long the token is valid can be specified in [POST] /authenticate (up to 30 days)
  • Fix: /geocoder/structured did not return multiple results
  • Fix: Segments with /detour/attribute/block are used by MapTrip now
2.0.1 2022-02-17
  • Added optional message to [POST] /remote/route/reference/{device}
  • Itineraries can now contain (named) addresses in [POST] /remote/route/itinerary/{device}
2.0.0 2022-02-09 Added MapTrip Remote API
1.6.0 2022-01-20 Added Matrix API
1.5.2 2021-12-20 Optimization: Fixed a problem with leading and trailing blanks in names
1.5.1 2021-12-10
  • Result of [GET] /optimize/stops/{id} changed due to a bug in openapi-generator with HTTP Status 204
  • Optimization: Stops with invalid names are no longer ignored but product HTTP Status 400
1.5.0 2021-10-13 Added MapTrip FollowMe API
1.4.1 2021-09-22 Fixed model documentation for Direction and TimeSlot
1.4.0 2021-09-15 Added Optimization API
1.3.1 2021-08-20 Improved Detour API: Prioritize and penalize can be used without speed parameter
1.3.0 2021-08-18 Added prioritize and penalize Detour API
1.2.1 2021-08-13 Improved route directions
1.2.0 2021-08-11 Added vehicle attributes to Detour API
1.1.0 2021-07-28 Added to Detour API
1.0.0 2021-07-16 Added Geocoding and Routing API

Copyright © 2022-2026 infoware GmbH