Route Geometry

The Route Geometry APIs allow you to generate commercial vehicle routes (Route Path) or determine the route that was taken using latitude/longitude pings (Derived Route).

Pre-requisites

To call the Route Geometry API, you must have a PC*Miler Web Services API key, and a license for the Trimble Maps JavaScript SDK.

Use Cases

The Trimble Maps routing algorithm has been used for more than 30 years to build safe, legal, and efficient routes for all types of commercial vehicles, around the world. When the route is created, it follows a series of GPS coordinates along roadways. These coordinates are the “route path.” The Route Geometry API allows you to create or retrieve GPS location information about route paths in order to:

• Plot and visualize a route on the map.
• Perform post-trip analysis on routes.
• Customize a route for use in GPS navigation.

Operations

The Route Geometry API can be called via both GET and POST requests.

• POST requests offer more options for the ways route stops are entered. They also allow for batch requests for reports on up to 20 routes in a single call.
• GET requests may be easier to implement, especially if API calls only use a limited number of parameters and rely mostly on default settings.

Resource URL

The Route Reports endpoints are available via the following URLs:

https://pcmiler.alk.com/apis/rest/v1.0/Service.svc/route/routePath https://pcmiler.alk.com/apis/rest/v1.0/Service.svc/derivedRoute/routePath

Getting Started

Parameter descriptions and sample report requests are available for both GET and POST requests. The GET pages also include a section where you can make sample calls with your API key.

Our developer guide also provides code samples for requests in common programming languages, as well as “How to Guides” for common tasks with the APIs.