Speeding Expression

The Speeding Expression plugin allows you to create Event Rules based on real speed limits from OSM (openstreetmap.org), while allowing you to provide fallback values when real speed limit is not available.

This guide explains how to install and setup the Speeding Expression.

Setup

  1. Login to SiteAdmin > Plugins Get More Plugins and install MapClient and SpeedingExpression
  2. In SiteAdmin, navigate to Applications > (select an application) > Privileges and Features > PluginsSpeedingExpression and enable _EditSpeedingExpression
  3. Click on Save

For legacy licensing model

If you are using legacy licenses, follow these steps to request this feature (pay-as-you-go model does not require these steps):

  1. Obtain a GpsGate Map client API key by emailing support@gpsgate.com. Please supply the hostname or IP address of the server(s) that will use the API key.
  2. In SiteAdmin, navigate to Settings > Services Account > Api Key and paste there the key given by support.
  3. Click on Save

At this point you have installed and enabled Speeding Expression on your server; it is time to create an Event Rule that uses it!

Speeding Event Rule Creation

Please read about How To Create Event Rules if you’re new to the Event Rules in Vehicle Tracker.

1. Login to the application and go to Admin > Event Rules

2. Follow the steps and when you reach 4. Expression, select Speeding Expression.

3. Once selected, a form will be shown listing different road types. Fill on Limit for the speeds on each of those road types. We have provided you with some default values, however those should be adjusted to correspond to your region limits.

The third column Tolerances allows you to define the tolerance value for which the over-speeding will be triggered. This speed is added to the Limit in the first column.


4. Once you have filled the values, complete the Event Rule setup and click on Save at the end.

Notification Variables

Three variables are added with the Speeding Expression. Those can be used in different Notifiers such as Arguments or Report Arguments.
Here is a list of the variables with their explanations:

Variable Description
SPEEDING_SPEED_LIMIT The speed limit used during the evaluation of the Event Rule
SPEEDING_ROAD_CATEGORY The road category such as Motorway or Primary road
SPEEDING_IS_SPEED_FALLBACK True if the speed limit used was a fallback value, otherwise false (data taken from OSM)

Furthermore, you can always use any of the standard Notification variables such as speed (SIGNAL_SPEED).

Please note that in order to use this service you need to have a valid Update and Support agreement with GpsGate.

About OSM (OpenStreetMap)

OpenStreetMap is an open source map data service created by users all around the world.

“OpenStreetMap powers map data on thousands of web sites, mobile apps, and hardware devices. OpenStreetMap is built by a community of mappers that contribute and maintain data about roads, trails, cafés, railway stations, and much more, all over the world.”

As a “mapper” you can improve the speed data for your area, read more at: https://www.openstreetmap.org/about