User avatar
Posts: 14333
Joined: Wed Aug 04, 2004 10:40 pm
Location: Sweden
Contact: Website

GpsGate Server Developer's Guide

Thu Aug 21, 2008 9:38 pm

Please note that direct database access is not supported and that the database schema changes frequently between releases. Use the rich set of available web services and file exports available instead for integration.

Useful topics for GpsGate Server developers

Here are some links to useful topics for those who extend GpsGate Server with their own custom development. We will add more information over time. If you miss information about something, please let us know and we'll add another topic

Web services

GpsGate Server exposes SOAP APIs for integration. Samples and documentation is available in "SOAP Platform Kit"

Quick test of the SOAP API.

REST API for getting Events

Web Service Scripts provide a flexible solution to create and publish customized Web Services using Javascript.

Forward track data to 3rd party system in real time

HTTP Expression can be used to forward real time position updates from GpsGate to another system.

RabbitMQ Integration

Device integration

For device integration, start by taking a look at "GpsGate TrackerOne reference design"

GpsGate TrackerOne Java Library

Scroll down for more topics on device integration below...


With Apps you can build and manage your own scripted extensions for the VehicleTracker application.

The App Console helps you to test and troubleshoot your scripts within GpsGate Server. You will spend less time wondering what is wrong and more time on building meaningful scripts for your business.
Read more here:

How to copy a script to multiple applications

RouteMessage - Create New Messages From Scripts. Makes it is possible to create new messages from a script that behave just like messages sent from a device. RouteMessage can also be used to add any kind of value to the time line of data (track history of data). E.g. Add Driver name to track history. Event Rule values to track history. Custom Fields values to track history. Basically get any value in GpsGate saved into a time line to be used for reports.

Click Scripts in User Right Click Menu.

Click Scripts for geofences enable you to trigger custom http requests whenever an operator creates, modifies or removes a geofence.

Command Click Scripts allow you to assign or remove a user from tags after a command is executed successfully for the user.


How to use SimOne to test Event Rules

Copy a tested Event Rule to the production application/server:


Translate GpsGate to new language
GpsGate v4.0
GpsGate v3.1

Customized units

Browser integration

Add tracking to your public homepage

"Display Platform Kit". Customize the VehicleTracker application. Integrate your business system into the VehicleTracker view. Display your own Windows. Everything using simple Javascript.

To add a custom "panel" to the workspace:

GpsGate Server Javascript API reference documentation:

User and device management

Add users and devices using SOAP

Map and geocoder

Maps supported

Shapefiles + Geoserver
Use Geoserver (free) + Openlayers (free) to display Shapefiles in GpsGate Server.

Add support for "any" third party map. For examples and documentation take a look in "WebMap Platform Kit": Existing map integrations can be found here

Import a raster JPEG, PNG, GIF or BMP map to GpsGate Server

Custom geocoder over HTTP/XML

Device Mapper

How to use Device Mappers:

Adding custom variables

Device Mapper Scripting

Translating variable names:

Event Rules

Script Expressions
Tips when developing Script Expressions.

Multiple events per event rule and device. Set Notifier variables from script.

Allow users to select Event Rules using Custom Fields with scripting

HTTP Expression can be used to include custom expression in Event Rules. Both in Live Event Rules and Event Rules used for Reporting (Analyze). Another area of usage is to get real time position updates from GpsGate to another system.

Notify your custom server over HTTP when an Event Rule is true:

Http Expression vs. Command Notifier

RabbitMQ Integration

Script Notifiers

Event Rule / Notifier variables


Starting points for installing and activating reports:

Reporting docs

Customize reports

Re-processing reports:

Translating reports

Add charts to reports:

Add variable values to report EV1000

Custom Trip&Idle (TR1000) report. Trip and Idle and Parking report using event rule.

Add "Custom Fields" to reports

Add Server _Odometer value to your report

Adding Ignition values to the Trip and Idle report.

Combine Trip&Idle with Event Rules

Driver/Vehicle report

Custom distance report with trip categories

Simple Driver's Journal Report

File Reports, export CSV to other systems.

Access Reporting data using SOAP

Copy Report to another server

Map links in your custom report (click actions)

Setup a GpsGate Server dedicated to processing and generating Reports based on data from another server.

More device integration

For device integration, start by taking a look at "GpsGate TrackerOne reference design" here:

Three ways to integrate an unsupported tracker:

GpsGate TrackerOne Java Library

Camera FTP integration

Native device integration:

Template Commands. Write a "template" to define commands sent to a tracker from the server. Use this to configure the tracker in ways not supported by GpsGate Server today. More info:

Template command with argument

Chat and Job Dispatch using TrackerOne

Job Dispatch using Cell phone or email

TrackerOne + Garmin FMI integration

DataForward the unmodified data sent from a device to one or many other servers.

GpsGate Server management

Troubleshoot device to GpsGate Server connection:

Customize units

Change logo and colors

Login to GpsGate Server from another site

SMS support

Add SMS support to your server

If you are a developer and want to integrate other providers of SMS, please take a look at one of those options:

SMS web service integration over HTTP:


How to build your own web repository


GpsGate Support

User avatar
Posts: 14333
Joined: Wed Aug 04, 2004 10:40 pm
Location: Sweden
Contact: Website

RE: GpsGate Server Developer's Guide

Fri Dec 06, 2013 9:19 pm

To the top.

Return to “GpsGate for Developers”