Event Notifier: events to your business system

With an Event Notifier you can signal a custom server over HTTP when something happens in GpsGate VehicleTracker. You can for example let GpsGate send a signal to your business system when a vehicle enters a geofence, a driver presses SOS, a driver logs in using an IButton or if any other conditions using Event Rules.

How to setup the Event Notifier

  1. In step 5. in the Event Rules Wizard add a Command Notifier.
  2. Select Custom Server in the first drop down.
  3. Let the second drop down keep its value _ExternalNotification.
  4. Select http in the third drop down.
  5. And finally enter the URL to your custom server in the URL text field, e.g. http://yourserver.com/yourpage.aspx
  6. Save your Event Rule.

When the Event Rule turns true GpsGate will make a HTTP GET to the URL you specified.

What the HTTP request looks like

GpsGate makes a HTTP GET to the custom server when the Event Rule is true. The URL will contain all information you need about the event. Here is an example of a SOS signal:


http://yourserver.com/yourpage.aspx?cmd=_ExternalNotification&SIGNAL_SOS=true&RULE_NAME=SOS&EVENT_TIME=2010-10-03T15:02:56&EVENT_DURATION=0&USER_USERNAME=johan&USER_NAME=johan&USER_DESCRIPTION=&POS_TIME=2010-10-03T15:02:55&POS_LATITUDE=59.28687&POS_LONGITUDE=18.08927&POS_HEADING=275&POS_ADDRESS=Nyn%C3%A4sv%C3%A4gen%20303-305,%20122%2034%20Stockholm,%20Sweden


The value of all GpsGate Variables used in evaluating the event will be included in the URL. They will be named SIGNAL_NAME, where NAME is the upper case variable name. E.g. the variable speed will be named SIGNAL_SPEED


The following variables are always included in the URL:

  • RULE_NAME
  • EVENT_TIME
  • EVENT_DURATION
  • USER_USERNAME
  • USER_NAME
  • USER_DESCRIPTION
  • POS_TIME
  • POS_LATITUDE
  • POS_LONGITUDE
  • POS_HEADING
  • POS_ADDRESS


If geofence expressions are used you find the geofence name in the variable GEOFENCE_NAME.

Reply to HTTP request

Your server must return a plain text OK. Any other kind of reply will be considered to be an error.

Troubleshooting

You can see the status of the notifier in the Queue Viewer. Login to SiteAdmin and take a look under Terminal > Queue Viewer > Commands. If you don’t have a login to SiteAdmin, please ask your GpsGate Server administrator to enable the Terminal in your VehicleTracker application.

If the HTTP GET fails, GpsGate will retry in 2 minutes, and then every 15 minutes for about 8 hours before there is a permanent failure. The most common problems are that you don’t return a plain text OK, the specified URL is wrong or you have an exception in the receiving web page. In most cases the Queue Viewer will give you the information you need to resolve the problem.

Related topics

The Command notifier can also send outgoing commands using TCP, in which case it uses the GpsGate Protocol. It can also be used to send back Template Commands to a GPS tracker.

When playing around with Event Rules it is a great help to use SimOne. SimOne is a tracker (GpsGate TrackerOne) simulator you can run from your Windows desktop. It enables you to send position reports including signals to your GpsGate Server installation and examine the outcome.

To know more about SimOne click here.