Skip to main content

Derived Route

The Derived Route API estimates the route a vehicle took based on a series of longitude/latitude coordinates (usually pings from the vehicle). The function works this way:

  1. The routing algorithm generates a route between the origin and destination.
  2. The latitude/longitude pings are compared with that route.
  3. Any pings that fall outside of the distance set in the offRouteMiles parameter are considered significant, and the route is reshaped to incorporate them.
  4. The estimated route is returned as a list of trip coordinates in GeoJSON format.

Requires a license for access to Trimble Maps JavaScript.

GET /derivedRoute/routePath


This table includes the most frequently used parameters. Please see the Route Geometry overview page for a full list. If you would like to test out this API, enter values in the table below and scroll down the page to submit your request. Required parameters are marked with an asterisk.




Derived Route Path Response

Data ElementDescriptionData TypeValue/Example
typeIndicates the type of response
geometryThe route points of the route that was runGeoJson Geometry


Data ElementDescriptionData TypeValue/Example
TypeIndicates the type of geometry
Multistring (currently this is the only value)
CoordinatesA series of geographic coordinate points that make up a routeJson array of arrays
Last updated November 29, 2022.