Support Document

0 mins to read

Invalid Date

Introduction

The Geotab Camera Add-In for the SurfsightTM camera allows users to view live video feeds and video recordings, create rules and exceptions to detect distracted driving behavior and harsh driving conditions, and much more.

The Add-in is only available for Customers enrolled in the Order Now program that ordered their Surfsight cameras via Order Now on the Geotab Marketplace. Currently, the Add-in is not available for Customers who purchased Surfsight cameras through a Partner.

NOTE: The Geotab Camera Add-In does not have a separate menu item in the MyGeotab navigation menu.

Get started

Before you can use the Geotab Camera Add-In for the Surfsight camera, you must add a camera to an asset in the MyGeotab database.

! IMPORTANT: Prior to adding a camera to an OEM telematics device, please ensure that the OEM telematics device is enrolled and activated.

If you are uncertain, please contact your Partner for further assistance.

Adding cameras to assets

  1. Navigate to the Cameras page.
  1. On the Cameras page, click the Add camera button.
  2. On the Add Camera page, enter the required information.

NOTE: To add a camera to an asset using the Geotab Camera Add-In, the camera must be ordered through the Geotab Marketplace using the Order Now program, and the serial number must match a GO device that has already been added to the database.

  1. Click Save to add the camera.

Adding cameras to assets in bulk

  1. Navigate to the Cameras page.
  1. On the Cameras page, select Bulk import cameras from the Add camera dropdown menu.
  2. In the Bulk Camera Import pop-up window, enter the required information for each device on a separate line.

NOTE: To add a camera to an asset using the Geotab Camera Add-In, the camera must be ordered through the Geotab Marketplace using the Order Now program, and the serial number must match a GO device that has already been added to the database.

  1. Click Import to add the cameras.

Unpairing cameras from assets

Before removing assets from MyGeotab, you must first unpair any existing cameras from the assets. After it is unpaired, the camera can be paired with another asset, either in a new asset or by installing another telematics device in the asset.

NOTE: If the asset is removed from MyGeotab while the camera is still paired, you must contact the Support team for assistance.

  1. Navigate to theCameras page.
  2. On the Cameras page, select a camera from the list.
  3. On the Asset Edit page, select the Camera Settings tab.
  4. On the Camera Settings tab, click Unpair.
  5. Click Save to save the changes.

Viewing installed cameras

Navigate to the Cameras page. On the Cameras page, the table displays a list of currently installed cameras, the current assigned driver, the associated IMEI or DRID numbers, and the serial number of the paired GO device.

Configure default settings

  1. Navigate to the Cameras page.
  2. On the Cameras page, click the Add camera dropdown and select Fleet-wide camera settings.
  3. On the Fleet-wide Camera Settings page, you have the option to select a default configuration for event capture, including units of measure, live recording and audio recording. These values will apply to all current and new cameras on the databaser.

Modifying camera settings

  1. Navigate to the Cameras page.
  2. On the Cameras page, select a camera from the list.
  3. On the Asset Edit page, select the Camera Settings tab.
  4. On the Camera Settings tab, modify the settings as needed.
  5. Click Save to save the changes.

Viewing camera data usage

  1. Navigate to the Cameras page.
  1. On the Cameras page, select a camera from the list.
  2. On the Asset Edit page, select the Camera Settings tab.
  3. On the Camera Settings tab, click Data Usage.

Viewing camera status on map

To view the camera status on the map, hover over the asset on the map. In the pop-up window, the Camera feed field displays Live if the asset is moving and camera footage is available, or Offline if the vehicle is not moving.

View camera footage

There are various options to view camera footage, outlined in the sections below.

Viewing live camera footage from the map

  1. Navigate to Map > Map.
  2. From the Map, select the asset.
  3. From the dropdown menu, select Live video. The camera footage opens on the right side of the page.
  4. Click the Play icon to start viewing the live camera footage.

Viewing camera footage for a specific time period

  1. Navigate to Map > Trips History.
  2. On the Trips History page, use the Search bar to search for the asset.
  3. On the map, select a point from the highlighted trip.
  4. From the dropdown menu, select one of the following:
    • Request 30s video recording — Shows camera footage of 30 seconds after the selected time period.
    • Request custom video recording — Allows you to choose a custom time period, using the panel on the right side of the page.

Viewing camera footage for exception events — Trips History page

  1. Navigate to Map > Trips History.
  2. On the Trips History page, use the Search bar to search for the asset.
  3. In the Camera Captured Exceptions panel, located on the right side of the page, select an exception event to view the camera footage.

Viewing camera footage for exception events — Exceptions page

  1. Navigate to Rules & Groups > Exceptions.
  2. On the Exceptions page, click the Camera exceptions.
  3. On the Camera Exceptions page, click Options and modify the filters, as needed.

  1. Select an exception event from the list. A panel opens on the right side of the page to display the video.

Viewing camera-specific events

  1. Navigate to Engine Maintenance > Engine and Device… > Measurements.
  2. On the Engine Measurements page, select the Options.
  3. In the Options menu, select the diagnostics that you would like to review from the following list, and filter for specific vehicles:
    • Driver drinking or eating detected (1 = detected)
    • Driver smoking detected (1 = detected)
    • Driver handheld mobile device usage detected (1 = detected)
    • Uncategorized driver distraction detected (1 = detected)
    • Driver seatbelt status from camera system (1 = unbuckled)
    • Other general driver concern detected (1 = detected)
    • Camera fault: all power removed - device restarted (1 = fault occurred)
    • Camera SIM cover opened (1 = opened)
    • ADAS following distance
    • Camera Lens Obstruction Detected (1 = detected)
    • Camera vibration while in standby mode (1 = vibration occurred)
    • Camera unauthorized access (1 = detected)
  4. Click Apply changes.

Viewing Video Gallery

  1. Navigate to the Cameras page.
  2. On the Cameras page, click Video Gallery.
  3. In the Video Gallery, select filters for date ranges, rules or exceptions, asset and/or driver to review events of interest.

NOTE: While reviewing video related to an exception event, you can change the status and leave comments that appear on the Exceptions Detail page for the specific event. You cannot change the status or add comments for any custom videos requested from the Trips History page.

Create rules

You have the option to create rules and record camera footage for certain driving events.

Enabling default rules for video events

  1. Navigate to Cameras page.
  2. On the Cameras page, click the Add camera dropdown and select Video Rules.
  3. On the Camera Rules page, select the event types of events and click Apply to all .

NOTE: The Camera Rules page only displays the rules that work with the cameras from the provider you are currently using. In the event the fleet is mixed with solutions from multiple providers, some rules may have a disclaimer that they will not apply to one or more of these cameras. Additionally, you will need to ensure the event capture is enabled for these specific events. Please refer to the Modifying camera settings section or the Configure default settings section for more information.

Creating custom rules for video events

  1. Navigate to Rules & Groups > Rules.
  2. On the Rules page, click Add.
  3. Under the Name tab, enter the required information, then select the Conditions tab.
  4. Under the Conditions tab, click Engine data. For Type, click Measurement or Data.

  1. For the Diagnostic: field, click Display All Diagnostics, then select an event from the dropdown menu located above the button.

  1. In the Value field, select Over and enter the value 0.
  2. Click Add.
  3. Once complete, click Save.

NOTE: You can add conditions as needed to create complex rules.

Camera diagnostics

Diagnostic Description

Surfsight Event Name

Driver drinking or eating detected (1 = detected)

Food and Drink

Driver smoking detected (1 = detected)

Smoking

Driver handheld mobile device usage detected (1 = detected)

Cell Phone Use

Uncategorized driver distraction detected (1 = detected)

Distracted Driving

Driver seatbelt status from camera system (1 = unbuckled)

Driver Unbelted

Other general driver concern detected (1 = detected)

Button Pressed

Camera fault: all power removed - device restarted (1 = fault occurred)

Power Disconnected

Camera SIM cover opened (1 = opened)

Cover Opened

ADAS following distance

Tailgating

Camera Lens Obstruction Detected (1 = detected)

Lens Obstruction

Camera vibration while in standby mode (1 = vibration occurred)

Jolt (Camera wake from Vibration)

Camera unauthorized access (1 = detected)

Wrong Pin Code

Tailgating settings

  1. On the Cameras page, select a camera from the list.
  2. On the Asset Edit page, select the Camera Settings tab.
  3. Under the Camera Settings tab, expand the Event Settings section.
  4. Inthe Event Settings section, enable Tailgating and click the gear next to the event for configuration.
  5. Modify settings as needed. When modifying the setting, keeping the following in mind:
    • Continuous time to collision is the duration for which the asset must be closer to the vehicle in front of it than the time to collision threshold. For the example below, the asset must be closer than 2 seconds time to collision to the vehicle in front of it for 3 seconds or longer to trigger an event.
    • Time to collision during day and Time to collision during night can be different to help account for changes in visibility and road conditions.

  1. Click Save.

✱ NOTE: This setting only applies to Surfsight cameras. This can also be done through the Fleet-wide camera settings page and will apply to all cameras on the database.

ADAS Calibration

  1. On the Cameras page, select a camera from the list.
  2. On the Asset Edit page, select the Camera Settings tab.
  3. On the Camera Settings tab, select Calibrate ADAS
  4. Follow the instructions on screen and complete the calibration process.
  5. Click Save.

✱ NOTE: This calibration only applies to Surfsight cameras.

Creating rules for video events with OEM telematics

Although the process to create rules and record camera footage for certain driving events for OEM telematics devices is the same as Geotab telematics devices, please ensure the rule conditions take the reporting frequency of the OEM into account.

NOTE: Camera events will not be affected by OEM reporting frequency.

Expected reporting frequency can be found in the individual OEM data sets — listed below:

For OEMs that are not currently included in the list, contact your Partner for more information.

  1. Navigate to Rules & Groups > Rules.
  2. On the Rules page, click Add.
  3. Under the Name tab, enter the required information, then select the Conditions tab.
  4. Under the Conditions tab, click Add engine. For Type, click Measurement or Data.

  1. For the Diagnostic: field, click Display All Diagnostics, then select an event from the dropdown menu located above the button.

  1. In the Value field, select Over and enter the value 0.
  2. Click Add.
  3. Once complete, click Save.

NOTE: You can add conditions as needed to create complex rules.

Support

Please refer to the Community Topic & Knowledge Base Articles for the Geotab Camera Add-In (For Internal use only).

Security Clearances

Similar to most functionality in MyGeotab, access to various parts of the Add-In is controlled using MyGeotab’s security clearance system to provide different levels of access to users.

By default, all functionality is enabled for the Administrator role.. Once the Add-In is installed, all functionality is enabled for the remaining clearances.To provide access to specific user roles, follow the steps below.

  1. Navigate to the Administration > Users page.
  2. On the Users page, click Clearances .
  3. On the Clearances page, select the user clearance level.for a list of Camera Add-In security identifiers.

NOTE: Most of the MyGeotab options are unavailable for default user clearance levels (Administrator, Supervisor, Default User, and more.. Only add-in clearances will be editable for these levels. For more information on custom clearances, refer to the How to Create a Security Sub-Clearance community article.

Security Identifier

Functionality

View “mygeotab-camera-addin” add-in

Show or hide entire Add-In across MyGeotab

Administer camera settings

Allows users to edit camera settings and calibration options, andfleet-wide camera settings. Includes all camera settings, such as formatting SD card and ADAS calibration.

Administer paired cameras

Allows users to add or pair new cameras and unpair existing cameras.

View camera live video

Allows users to view live video on the Map page.

View recorded video

Allows users to view video recordings from events, request video upload from the map, and view the video gallery and gallery content.

scroll-up