Locations

Topics in this section:

• What is a location?
• What is a yard?
• Can I specify the location radius in kilometers instead of miles?
• Adding a location*
• Importing a list of locations*
• Editing a location*
• Deleting a location*
• Restoring a deleted location*
• Using filters to search for locations

* 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 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:

• Chicago, IL (Chop House)
• Chicago, IL (IGA Headquarters)
• Chicago, IL (Willits Tower)

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 the 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. Click the Update button to save changes and exit edit mode.

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 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:

• What file formats can be used for import files?
• How do I create an import file?
• How do I import a file?
• How do I import a value that has a zero or a minus sign (-) at the beginning?

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 link. This enables edit mode for that row.
3. Change the location's details.
4. Click the Update link to save changes and exit edit mode.

Deleting a location*

Locations may be deleted from the Locations list page.

To delete a location from the Locations list:

1. Locate the row(s) containing the location(s) you wish to delete.
2. Click the Delete link. This deletes the location in that row.

Restoring a deleted location*

Locations may be restored from the Locations list page.

To restore a location from the Locations list:

1. Check the Show Deleted checkbox.
2. Click the View button to reload the list of Locations.
3. Locate the row containing the location you wish to restore.
4. Click the Restore link.

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 following page-specific filter options are provided:

• Location Name text - Include only the locations having a name that begins with the text you specify

  To apply this filter:

  1. Select Location Name from the drop-down list.
  2. Enter the desired text into the box.
  3. Click the View button.

  To clear this filter:

  1. Select None from the drop-down list.
  2. Click the View button.
• Locations - Include only the locations with the type LOCATION

  To apply this filter:

  1. Select Locations from the drop-down list.
  2. Click the View button.

  To clear this filter:

  1. Select None from the drop-down list.
  2. Click the View button.
• Yards - Include only the locations with the type YARD

  To apply this filter:

  1. Select Yards from the drop-down list.
  2. Click the View button.

  To clear this filter:

  1. Select None from the drop-down list.
  2. Click the View button.
• Show Deleted items - Include deleted as well as non-deleted locations

  To include deleted locations in your search:

  1. Check the Show Deleted checkbox.
  2. Click the View button.

  To exclude deleted locations from your search:

  1. Uncheck the Show Deletedcheckbox.
  2. Click the View button.

Points to remember when using filters:

• Text-based filtering is not case sensitive, and partial matches are returned. For example, filtering by Location Name = CH or ch may return locations named Charleston Depot, Checkpoint 10, Chicago Warehouse, or Chula Vista Senior Center.