Locations

Topics in this section:

* An application user must have a user role with View/Modify permission to the Resources feature to add, import, edit, delete, or restore a location.

What location information is shown on this page?

What is a location?

A location is a custom description for a specific latitude and longitude.

When GPS data is available, the system uses an algorithm to describe a vehicle's location relative to the nearest city or town. When vehicles make stops at several places within the same city, the city name will be insufficient to tell one stop from another. The system therefore allows for custom locations to be defined with more specific names. If a vehicle makes a stop within the configured radius for a custom location, records created at that stop will include the custom location name as well as the city and state or province information.

For example:

Custom locations can also be used to specify the Home Location and Service Location of assets belonging to the company.

What is a yard?

A yard is a special type of location used to define the boundary of a motor carrier's property. Yards can be used to represent the carrier's main terminal or any other hub where drivers may be moving vehicles without leaving the carrier's property.

ELD-compliant mobile recording devices will use the organization's configured yards to determine when a US driver has exited the carrier's property, so that the driver's Yard Moves condition is automatically cleared and the driver's duty status is switched from On Duty to Driving.

Can I specify the location radius in kilometers instead of miles?

Yes. Your user preference for distance and odometer units will determine whether miles or kilometers may be specified when adding a location. However, you must use miles when importing a list of locations.

Adding a location*

To add a new location to the organization:

  1. Click the new button . This adds a new row to the top of the Location list and puts it in edit mode.
  2. Enter a Name. This is the name that will appear in parentheses after the city and state or province when driver or vehicle information is recorded at this location.
  3. Enter the Latitude and Longitude of the location in decimal degrees; for example, 41.948333, -87.655556.
  4. Select a location type from the dropdown, either LOCATION or YARD.
  5. Enter a Radius for the location; for example, 0.5 = half a mile. This indicates how close the vehicle must be to the specified Latitude and Longitude to be deemed as having arrived at that location.
  6. If applicable, check the box to designate the location as a Serviceable Location
    1. Requires that the "Enable Dynamic Trailer/Vehicle location for Inspection Report" feature is enabled on the DVIR tab of the Organization Details page
  7. Click the Save button to save the new location.

Importing a list of locations*

The Import option allows an organization to enter multiple locations into the system at one time.

A valid location import file will have 4 or 5 columns and one or more rows of data.

Columns must be in this specific order:

Column Name* Required/Optional Notes
Name Required Must be unique among other locations within your organization. Limited to 50 characters.
Latitude Required Must be a valid decimal formatted latitude; for example, 41.658611.
Longitude Required Must be a valid decimal formatted longitude; for example, -91.55111.
Radius Required Must be specified in miles and must have no more than one-tenth mile precision; for example, 2, 1.5 or 0.5. The maximum radius for locations (including yards) is 10 miles. The minimum radius for locations (including yards) is 0.1 miles.
Location Type Optional Either "location" or "yard". Location type will default to "location" if this column is left empty.

* Column names have been included for explanatory purposes only. Your import file must NOT include column names.

Click to view a sample import file.

More information about importing files:

Editing a location*

To edit the details of a location already existing in the organization:

  1. Locate the row containing the location you wish to edit.
  2. Click the Edit option. This enables edit mode for that row.
  3. Change the location's details.
  4. Click the Save button to save changes and exit edit mode.

Deleting a location*

Locations may be deleted from the Locations list page.

To delete an individual location from the Locations list:

  1. Make sure the Show All or Show Active filter is selected.
  2. Locate the row containing the active location you wish to delete.
  3. Click the delete button to the right of the row.
  4. A pop-up will display asking for confirmation to delete the selected location.
  5. If confirmed, this deletes the selected location.

To delete multiple locations from the Locations list:

  1. Make sure the Show All or Show Active filter is selected.
  2. Locate the row(s) containing the active location(s) you wish to delete.
  3. Check the checkbox to the left of each row.
  4. Click the delete button above the list to delete the selected location(s)
  5. A pop-up will display asking for confirmation to delete the selected location(s).
  6. If confirmed, this deletes the selected location(s).

Restoring a deleted location*

Locations may be restored from the Locations list page.

To restore an individual location from the Locations list:

  1. Make sure the Show All or Show Deleted filter is selected to show both deleted and active locations or show only deleted locations.
  2. Locate the row containing the deleted location you wish to restore.
  3. Click the restore button to the right of the row.
  4. A pop-up will display asking for confirmation to restore the selected location.
  5. If confirmed, this restores the selected location.

To restore multiple locations from the Locations list:

  1. Make sure the Show All or Show Deleted filter is selected to show both deleted and active locations or show only deleted locations.
  2. Locate the row(s) containing the deleted location(s) you wish to restore.
  3. Check the checkbox to the left of each row.
  4. Click the restore button above the list.
  5. A pop-up will display asking for confirmation to restore the selected location(s).
  6. If confirmed, this restores the selected location(s).

Using filters to search for locations

The total number of locations displayed in the table may be reduced through the use of one or more page-specific filters.
The filters are live updating. The displayed list will change as filters are selected.
Click the filter button to hide or show the page filters, or click the close button in the filter pane to hide the filters.
Click the refresh button to manually refresh the list.

The following page-specific filter options are provided:

Customizing the list display

To configure which columns are displayed:
  1. Click the more button , then click Configure Columns.
  2. Click to deselect or select columns from the list shown. Click Reset to return the selection to the default settings.
  3. Click Save when finished. The page will update to display the new selections.
  4. Click Cancel to return to the list without saving any changes.
To change the order in which columns are displayed:
  1. Click the more button , then click Configure Columns.
  2. Click and drag the handle button to the right of each column to change the display order. Click Reset to return the selection to the default settings.
  3. Click Save when finished. The page will update to display the new selections.
  4. Click Cancel to return to the list without saving any changes.

Points to remember when using filters: