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.
- Obtain a GpsGate Map client API key by emailing firstname.lastname@example.org. Please supply the hostname or IP address of the server(s) that will use the API key.
- Login to SiteAdmin and navigate to Plugins
- Click on ‘Get More Plugins’ and install MapClient
- Click on ‘Get More Plugins’ and install SpeedingExpression
- In SiteAdmin, navigate to Maps and click on ‘Native Map’
- Enter the API key provided by GpsGate Support
- Click on Save and then Test to ensure the configuration is OK
- In SiteAdmin, navigate to Applications, select an application in which you want to enable SpeedingExpression, enable the SpeedingExpression and _EditSpeedingExpression under Privileges and Features
- 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.
Create an Event Rule as usual using a Speeding Expression. Once selected, you will be shown a long form listing different road types used by OSM. For each type you’re required to provide a fallback speed limit. We have provided you with some values, however those should be adjusted to correspond to your region limits.
Once you have filled in the fallback values, complete the Event Rule setup and click on save.
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:
|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