Get Route

Introduction to the Get Route Tool

The Get Route Tool gives users the ability to bring the functionality of other mapping software to their Asset ecosystem by creating travel paths between points or Objects on the map. Get Route can be opened in a number of ways, but always works the same no matter how it was initiated.

Get Route End Points

Get Route allows users to calculate Routes between two endpoints, which can take the form of map coordinates and/or objects in the portal.

Locations can be endpoints in the Get Route tool, just as they are in other mapping and routing applications. Simply click the map to set the endpoint, input the coordinates in the Starting or Ending Location fields, or search for popular landmarks, cities, and locations. To calculate a route between two Locations, open the Get Route Tool from the Map Tools in any map view.

Assets can be endpoints in the Get Route tool, and they can be routed from their most recently reported position to any Location or Place on the map. To start with an Asset as the Route From endpoint, open the Get Route Tool by clicking Route Asset option in the Asset Options menu or by clicking the Asset’s position in the Live Mode and using the Route From option in the Quick Actions menu. To start with an Asset’s position as the Route To endpoint, open the Asset’s position in the Live Mode and select the Route To option from the Quick Actions menu.

Places can also be endpoints in the Get Route tool, and they work similarly to the way Assets do. Users can Route any Asset to any Place by opening the Place in the details panel and clicking the Route Asset button. Alternatively, users can open the summary panel of any Place on the map view and choose either the Route To or Route From options in the Quick Actions menu.

Get Route Tool Fields

The Get Route Tool, when opened from the Map Tools, displays two fields for users to input two locations from which it will calculate the route. The first field is for the starting point (search, enter coordinates, or click the map) and the second field is for the ending destination (search, enter coordinates, or click the map).

When opened from either an Asset or a Place, the fields are slightly different, as they allow the user to select from a list of Places and Assets in the portal.

Route Asset to Place
Opened by clicking Route Asset while in the Place Options tab in the details panel of the Places Module, or by clicking Route Asset from the Asset Options tab in the details panel of the Assets Module.

Users first select a Place from a drop-down list (the Place that was open will be the default option), and then select the Asset they wish to Route to that Place.

There are two options for route generation. The first (Roads) will calculate the route between two points using roads that run between them, and the other (direct) will simply draw the shortest route between the two points and is for air and sea applications.

Viewing Routes

Route options will appear in the Details Panel with the name of the major roadways as the header. Users can scroll through the printed directions and view the route as a single red line on the map view. Users will typically have multiple options available, and can toggle between them by clicking the header to expand the directions and populate the route line on the map.

Interacting with Routes

Once created, users have a few options with Routes for additional functionality.

Custom Routes

Users can click and drag the red line to change the Route to suit their specific needs. Dragging the Route will cause it to appear as though the user has added a new point to the Route, and after that, each of the segments of the Route can be dragged individually to further customize the Route.

Geofence from Route

Once a Route has been created, users have the ability to draw a Geofence around that Route and save it to the portal by clicking the Add Geofence button below the Route directions.

Add Geofence from Route
Unlike drawing a normal Geofence, the Geofence from Route feature automatically generates a Geofence that stretches between 25-2000 meters from the Route line from start to finish. Users have a slider bar that allows them to specify the Route Buffer distance.

Once created, the Geofence will appear in the map view and in the Geofences Module, where it can be used for any normal functions of Geofences. Asset Managers often use the Geofence from Route feature to set up Alerts for when a vehicle strays from its intended path.

Multiple Destinations

Not all routes are direct, start-to-finish routes. To support that, the portal gives users the ability to add multiple destinations to each route in the same way that mapping tools like Google Maps do. Click the Add Destination button for each additional stop (appears below the second location field when it has been populated), and the portal will calculate the best route between each endpoint.