GpsGate

VehicleTracker 
 Application Manual 

Version: 2.3.1
Rev: 1.0 
 GpsGate VehicleTracker Application Manual
Version: 2.3.1 - Rev: 1.0

Table of Contents
1 Introduc
Introduction
tion........
................
...............
...............
................
................
...............
...............
................
...............
...............
................
................
...............
...............
................
................
.................4
.........4
1.1 Recommended Web Browsers...............................................................................................................................4
Browsers...............................................................................................................................4
2 Overvie
Overview
w of User
User Interfa
Interface....
ce...........
...............
................
................
...............
...............
................
...............
...............
................
....................
...................................5
.......................5
2.1 Main Menu...............................................................................
Menu..............................................................................................................................................................6
...............................................................................6
2.2 Map Display
Display Options
Options......
............
...........
...........
............
............
............
...........
...........
............
............
............
...........
...........
............
............
............
...........
...........
............
.............
..........................
...................7
7
2.2.1 Google Map Features...............................
Features..................................................
.....................................
.....................................
.....................................
.....................................
.....................................
..................................7 
................7 
2.3 Vehicle Management Panel........................................................................................................................
Panel....................................................................................................................................7
............7
2.3.1 Vehicle Info Tab................
Tab..................................
.....................................
.....................................
.....................................
.....................................
.....................................
.....................................
........................................8 
......................8 
2.3.2 Status Tab.................
Tab....................................
.....................................
.....................................
.....................................
.....................................
.....................................
.....................................
.....................................
.............................8 
...........8 
2.3.3 Commands Tab.................
Tab...................................
.....................................
.....................................
.....................................
.....................................
.....................................
..........................................................8 
.......................................8 
2.4 Alarm & Geofence
Geofence Panel
Panel .......
.............
...........
...........
............
............
............
...........
...........
............
............
............
...........
...........
............
............
............
...........
...........
............
............
..................
............9
9
2.4.1 Alarms Tab................
Tab...................................
.....................................
.....................................
.....................................
.....................................
.....................................
.....................................
.....................................
.............................9
...........9
2.4.2 Geofence Tab.................
Tab...................................
.....................................
.....................................
.....................................
.....................................
.....................................
.....................................
........................................
...................... ..9
2.5 Vehicle and Track Panels................................................................................
Panels................................................................................................................................
................................................ .......9
2.5.1 Vehicle Panel Settings.............................
Settings...............................................
.....................................
.....................................
.....................................
.....................................
.....................................
..................................10 
...............10 
3 Managin
Managing
g Operator
Operators
s and Vehic
Vehicles..
les..........
...............
...............
................
................
...............
...............
................
................
......................................1
..............................11
1
3.1 User types.....................................................................
types.............................................................................................................................................................1
........................................................................................11
1
3.1.1 Vehicles.....................
Vehicles........................................
.....................................
.....................................
.....................................
.....................................
.....................................
.....................................
.....................................
...........................11
.........11
3.1.2 Operators................................
Operators..................................................
.....................................
.....................................
.....................................
.....................................
.....................................
.....................................
.............................
........... ...11
3.1.3 Application Administrators..........................
Administrators............................................
.....................................
.....................................
.....................................
.....................................
................................................
.............................. .11
3.2 Adding
Adding Operato
Operators.
rs.......
............
............
............
............
............
............
............
...........
...........
............
............
............
...........
...........
............
............
............
...........
...........
............
..........................
.....................12
.12
3.3 Adding Vehicles....................................................................................................................................................13
Vehicles....................................................................................................................................................13
3.4 Account Settings............................................................
Settings...................................................................................................................................................15
.......................................................................................15
3.4.1 Devices................................
Devices...................................................
.....................................
.....................................
.....................................
.....................................
.....................................
.....................................
...................................16 
................16 
3.4.2 Track Recorder...................................
Recorder......................................................
.....................................
.....................................
.....................................
.....................................
.....................................
....................................
.................. ..17 
3.4.3 Tags..................................
ags.....................................................
.....................................
.....................................
.....................................
.....................................
.....................................
.....................................
..................................
............... ....18 
3.4.4 Marker Color................................
Color...................................................
.....................................
.....................................
.....................................
.....................................
.....................................
.............................................18 
...........................18 
4 Drawing Tracks
Tracks and Displaying Status Signals........................................... .................... .............
...... ............19
.....19
4.1 Selecting Tracks.................................................................................................................................................
Tracks................................................................................................................................................. ..19
4.2 Drawing Tracks.....................................................................................................................................................19
Tracks.....................................................................................................................................................19
4.2.1 Track settings................................
settings...................................................
.....................................
.....................................
.....................................
.....................................
.....................................
.....................................
..........................20 
.......20 
4.2.2 Advanced Filters................................
Filters..................................................
.....................................
.....................................
.....................................
.....................................
.....................................
........................................21
.....................21
4.3 Showing Status Signals....................................................................................................
Signals........................................................................................................................................21
....................................21
5 Working
Working with
with Geofence
Geofences......
s.............
...............
................
...............
...............
................
................
...............
...............
................
................
...............
...........................2
....................22
2
5.1 Geofence
Geofence Creation..
Creation........
............
...........
...........
............
............
............
............
............
............
............
...........
...........
............
............
............
...........
...........
............
............
.................
........................
.............22
22
5.2 Geofence Editing...................................................................................................
Editing................................................................................................................................................
............................................. ..23
6 Tags and Views....
Views...........
...............
................
................
...............
...............
................
................
...............
...............
................
...............
...............
................
.............................2
.....................24
4
6.1 Manage Tags......................................................................................
ags.....................................................................................................................................................
............................................................... ...24
6.2 Manage Views...........................
Views......................................................................................................................................................25
...........................................................................................................................25
7 Sending
Sending Comman
Commands
ds to Devic
Devices...
es...........
................
...............
...............
................
...............
...............
................
................
...............
.................................2
..........................27
7
7.1 Template Commands............................................................................................................................................
Commands............................................................................................................................................27
27
8 Worksp
Workspaces
aces........
................
...............
...............
................
................
...............
...............
................
...............
...............
................
................
...............
...............
................
................
...............2
.......28
8
8.1 Adding
Adding a Workspa
Workspace..
ce........
............
............
...........
...........
............
............
............
...........
...........
............
............
............
...........
...........
............
............
............
...........
.............
............................
....................28
28
8.2 Deleting
Deleting a Workspa
Workspace..
ce........
............
............
...........
...........
............
............
............
...........
...........
............
............
............
............
............
............
............
...........
...........
.....................
.........................2
..........29
9
8.3 Public Workspaces...............................................................................................................................................29
Workspaces...............................................................................................................................................29
9 Device
Device Mappe
Mappers....
rs...........
...............
................
................
...............
...............
................
...............
...............
................
................
...............
...............
....................................3
............................30
0
9.1 Device
Device Mapper
Mapper Configurati
Configuration...
on........
...........
............
............
............
...........
...........
............
............
............
...........
...........
............
............
............
...........
...........
............
............
.................
..............30
...30
10 Event Rules.................................... .......................... ........................... ........................... ................
.......... .............
.......32
32
10.1 Event Rule Configuration............................................................................................
Configuration...................................................................................................................
....................... ......... ........ .32
10.2 Editing Event Rules.......................................................................
Rules........................................................................................................................................
................................................................. ......36
11 Reports................................................ ........................... ........................... ........................... .............
....... ..........37
....37
11.1 Distance Report Templates...................................................................
emplates.....................................................................................................................
.................................................. ........ .....38
11.1.1
11.1.1 Sample Distance Report..............................
Report................................................
.....................................
.....................................
.....................................
.....................................
.....................................
..............................40 
...........40 
11.2 Event Rule Report Templates.........................................................................
emplates...............................................................................................................................41
......................................................41
11.2.1
11.2.1 Sample Event Rule Report...............................
Report..................................................
.....................................
.....................................
.....................................
.....................................
...........................................42 
........................42 

Date: February 10, 2010 Page 2(51)

 GpsGate VehicleTracker Application Manual
Version: 2.3.1 - Rev: 1.0

12 Exporting track data.......................................... .......................... ........................... ................. .............

...... .......43
43
12.1 Using the Export Window..........................................................
Window...............................................................................................................................
..................................................................... ......43
12.2 Exporting from the Map View..............................................................
View..................................................................................................................
.................................................... ........ .....44
12.3 Exporting Views as KML..............................................................................
KML.......................................................................................................................................44
.........................................................44
13 Application Settings........................
Settings........................ ........................... .......................... ........................... .................
.......... ...........45
....45
13.1 Changing your Password.............................
Password............................................................................................................................
............................................................................................... ........ .45
13.2 Track Visualization............................
Visualization................................................................................................................................................46
....................................................................................................................46
13.3 Localization...........................................................................................................................................................46
Localization........................................................................ ...................................................................................46
13.4 Style......................................................................................................................................................................46
Style......................................................................................................................................................................46
14 Map Selection..........................
Selection.......................... ........................... ........................... ........................... ........................... ..47
15 Plug-ins
Plug-ins.......
...............
................
...............
...............
................
................
...............
...............
................
................
...............
...............
................
...............
.....................................48
..............................48
16 Mobile Web Interface..........................
Interface.......................... ........................... ........................... ........................... ................
.......... .......49
.49
17 Connecting
Connecting Devices to GpsGate
GpsGate VehicleTracker............................................
ehicleTracker............................................ .................. ............
...... ...........50
.....50
17.1 GpsGate Client........................................................................................................
Client...................................................................................................................................................
........................................... ..50
17.2 Dedicated GPS tracking devices..........................................................
devices.........................................................................................................................
............................................................... .50

Date: February 10, 2010 Page 3(51)

 GpsGate VehicleTracker Application Manual
Version: 2.3.1 - Rev: 1.0

1 Intr
Introd
oduc
ucti
tion
on
Welcome to the GpsGate VehicleTracker
VehicleTracker Application Manual!
VehicleTracker is a web based application for real time vehicle tracking and fleet status
management. You
You can view your fleet, manage and create reports with a standard web browser.
browser. You
You
can also get notifications over email and SMS for all events in the application.
applica tion. You
You can view your
vehicles and follow up on alerts in any mobile phone with a web browser. You can relax now as the
system will tell you when something is wrong with your fleet.
As an Operator you can manage vehicles and work with different workspaces for different tasks.
Each operator has a personal account and access rights are defined for each operator for a set of
vehicles. A an Application Administrator you can also access administrative functions to configure
application behavior and adjust the look-and-feel of the interface.
This guide mainly covers user functionality in GpsGate VehicleTracker.
VehicleTracker. If you need any additional
information, please ask your GpsGate Server Site Administrator for help.
Thank you for using GpsGate VehicleTracker!
VehicleTracker!

The GpsGate Team

1.1 Recommended Web Browsers

All you need to access
acc ess the GpsGate VehicleTracker user interface is a web browser. Ask your
GpsGate Server Administrator for the url (http-address) to your installation.
The recommended web browsers for f or GpsGate VehicleTracker
VehicleTracker are Firefox 3.0 (or later) and Internet
Explorer 7 (or later). GpsGate VehicleTracker
VehicleTracker also supports Internet Explorer 6, Opera 9, Safari
Safa ri 3.1
and Google Chrome.

Date: February 10, 2010 Page 4(51)

 GpsGate VehicleTracker Application Manual
Version: 2.3.1 - Rev: 1.0

2 Overvi
Overview
ew of User
User Inte
Interfa
rface
ce
The VehicleTracker
VehicleTracker user interface is made up of multiple panels that can be freely moved around
and re-sized. Any set of panels can be saved as a custom Workspace. There is a Default Workspace
that shows a map, Veh
Vehicle
icle list, Vehicle
Vehicle Info for the selected vehicle and panels with Tracks and
Track points, as shown in the picture below.

Note: Multiple Workspaces can be created where panels are moved and re-sized. Therefore your
actual user interface might differ from the pictures in is manual.

Date: February 10, 2010 Page 5(51)

 GpsGate VehicleTracker Application Manual
Version: 2.3.1 - Rev: 1.0

2.1 Main Menu  

The main menu at the top of the page has the following items.

Map view Takes you to the main page

Reports View reports and create new ones. Export vehicle data as KML or CSV files

Admin Manage users and vehicles. (only available for Application Administrators)

Settings Select languages, measurement settings, track filtering options, application layout
and change your own password

Workspace Select and manage your workspaces

Maps Choose between your maps if you have installed more than one map

Windows Select the plug-in windows available in your installation

Help Open up a new browser window with the Help pages

Logout Log out from the application

Date: February 10, 2010 Page 6(51)

 GpsGate VehicleTracker Application Manual
Version: 2.3.1 - Rev: 1.0

2.2 Map Display Options

Above the map you have the following Display options:

View – select between your different views.

KML –  Export the content in the view as a KML-feed. Can be saved or used in ex. Google Earth.
Zoom to view – If checked, changing View will zoom the map to show all vehicles in that view.
Follow selected – if checked, the map will automatically center on the position of the vehicle
selected in the Vehicle list.
Pan on click  – If checked, the map will center on a vehicle when you select it in the Vehicle list.
Show trace – This option will show a short red line after the vehicle you have selected in the
Vehicle list, the line represents the last 10 position updates for the vehicle.

2.2.1 Google Map Features

Map modes – There are currently four different Google Map views, Map, Satellite,
Hybrid and Terrain. Note that if you are using Custom maps then you will not have
these options.
Zoom control – On the left side of the map you have the zoom control bar. Drag it up
or down to zoom in and out. You can also zoom in with a double left click on the map
and zoom out with a double right click.

Zoom area – Click on the button and then hold down left mouse button and drag a square over
the area you would like to zoom into.

Zoom all Vehicles – Click on the button to zoom in on all vehicles on the map.

Request Address – Click on the button and then drag the marker to the place you want address
information for.

Clear map – Click on the button to clear all tracks from the map.
Undo Zoom – The button undoes the previous zoom operation.

2.3 Vehicle Management Panel 

The Vehicle Management Panel shows information about the vehicle that is currently selected in the
Vehicle list in the Vehicle Panel.
Note: Select a vehicle in the Vehicle list to show information about it in this panel

Date: February 10, 2010 Page 7(51)

 GpsGate VehicleTracker Application Manual
Version: 2.3.1 - Rev: 1.0

2.3.1 Vehicle Info Tab

The “Vehicle Info” tab shows information for the vehicle currently selected in the Vehicle list. It
displays information such as Latitude/Longitude, speed, heading and when it was last updated.

2.3.2 Status Tab

The “Status” tab shows all current information from the device for the currently selected user.

2.3.3 Commands Tab

The “Commands” tab contains device control and configuration commands. The “Commands” tab
shows the commands available for the currently selected vehicle.
Here you can start and stop tracking and send a poll-position SMS to request a position from an off-
line device.

Date: February 10, 2010 Page 8(51)

 GpsGate VehicleTracker Application Manual
Version: 2.3.1 - Rev: 1.0

4 Drawing Tracks and Displaying Status Signals

4.1 Selecting Tracks

You can show multiple tracks for multiple Operators/Vehicles at the same time on the map. First
you select the desired Operators/Vehicles by checking the Track box next to the name in the Vehicle
list in the Vehicle panel. This will populate the Tracks panel with the tracks of the selected
Operators/Vehicles.
The default sort order is with the newest track first, you can sort the lists in another order by
clicking the column headers. You can limit the tracks you wish to show by narrowing the start and
stop time stamps. By doing so you will only display Tracks that have Track points inside the
selected time period.
To view a Track click on the check-box in the
Select column in the Track list. This will open
then Track points panel and fill the Track points
list with all the Track points from the selected
Track.
You can also delete tracks in this list by clicking
the icon to the right of a track.
If you have selected the “Auto update points”
option all you changes in the Tracks panel will
instantly take effect in the Track Points panel. If
you are working with many tracks and Track
Points at the same time you can disable this
function by clearing the check-box. This will
Speed up load time. If you have done this then
use then Update-button to load the Track Points
into the Track Points panel.

4.2 Drawing Tracks

When you select a track in the Tracks list it is opened the Track Points panel , where you see the
individual positions in the track.
Clicking on the Draw Tracks button will draw the chosen tracks on the map in different colors for
each track. There is also a button here for clearing all tracks from the map.

Date: February 10, 2010 Page 19(51)

 GpsGate VehicleTracker Application Manual
Version: 2.3.1 - Rev: 1.0

You can select an individual track point in a track either by clicking on it on the map, or by clicking
on it in the Track point list. You remove the tracks drawn on the map by clicking the icon next
to the Draw Tracks-button.

4.2.1 Track settings

 Next to the “Draw tracks”-button you have a split-button menu (facing down
arrow). Clicking it exposes a menu with different options for track drawing.
Check the check-box next to the specific option to enable it for track drawing.
You have the following options:

● Show polyline
Select this option to connect all the track points in a track with a solid line.

● Show points
Select this option to show markers with direction arrows on the track points.
To show a bread crumb trail you should enable this option without the
 polyline option above.
● Show Fatpoints
Select this option to show “Fatpoints” where the vehicle has been idle. A
Fatpoint also includes information on the length of the stop.
● Zoom to fit
Select this option to zoom in on the selected tracks when drawing and re-drawing them. You
should un-check this option if you have zoomed in on a part of the selected tracks and you
wish to re-draw them without changing the zoom level and position of the map.

Date: February 10, 2010 Page 20(51)

 GpsGate VehicleTracker Application Manual
Version: 2.3.1 - Rev: 1.0

4.2.2 Advanced Filters

You can narrow down your search further based
on different search criteria. This is done by
expanding the Advanced filters options found
on top of the Track points panel.
You have the options time, speed and altitude.
By default the search options are disabled. You
enable them by checking the check-box to the
right of each field.
Below the search fields you have a check-box
named “Live Filtering”. When this option is
enabled the Track Point list below will update directly when you change your search criteria. If you
are working on large amounts of data you have the option to disable the Live Filtering by clearing
the check-box and using the Apply Filter button to the right.

4.3 Showing Status Signals

The “Select Columns” icon to the right of the Track points list header lets
you choose what to display in the Track points list. The drop-down is
 populated with all the status message variables you have in the selected
tracks, select the fields you want to show. The following fields are default:
• Track color identifier – identifies the vehicle in the track list
• Date – date
• Time – time stamp
• km/h – speed (shown in the selected unit)
• Alt – altitude
• Heading – heading
• Lat – latitude
• Lon – longitude
• Valid – validity of the position update

Date: February 10, 2010 Page 21(51)

 GpsGate VehicleTracker Application Manual
Version: 2.3.1 - Rev: 1.0

11.2 Event Rule Report Templates

The Event Rule Reports list all the occurrences of a specific event for a time period. To create a
report you:
7. Select an event rule to make a report template for. The event rule selection drop-down is
automatically populated with the Event Rules available in your application.
8. Check “Report by vehicle” if you like to choose only specific vehicles to be included in the
report.
9. Select a time period for your report.
10. Select the time span or full day for your report
11. Give the report a descriptive name, e.g. “Monthly SOS report for all vehicles”
12. Click “Preview” if you want to see a sample report
13. Click Save to save the template in the report list

Date: February 10, 2010 Page 42(51)

 GpsGate VehicleTracker Application Manual
Version: 2.3.1 - Rev: 1.0

11.2.1 Sample Event Rule Report

Below is sample report showing an event rule report of SOS events

Date: February 10, 2010 Page 43(51)

 GpsGate VehicleTracker Application Manual
Version: 2.3.1 - Rev: 1.0

12 Exporting track data

There are two ways to export tracks. The Export-window that you open in the “ Reports”-menu,
and the Export  button that you find in the Track points panel.

12.1 Using the Export Window 

The Export window allows you to choose one or more vehicles that you wish to export Tracks for,
the start and stop time stamps, the option to “trim” any Tracks that cross a start/stop time stamp, and
whether it should be exported as CSV (Comma Separated Values) for use in, for example, Excel or
Access, or in KML (Keyhole Markup Language) format for Google Earth.
You can select the Status Message fields to include in the export in the drop down list at the bottom
of the Track Export window.
 Note that all time stamps are exported in UTC (Universal Time Coordinated) format.

Date: February 10, 2010 Page 44(51)

 GpsGate VehicleTracker Application Manual
Version: 2.3.1 - Rev: 1.0

13.2 Track Visualization

Under the “Track Visualization” tab on the Settings menu you enable Track filtering.
Track filtering has been added to better visualize the true movement of a GPS tracking device.
Under imperfect conditions, such as under a roof or in dense areas with high buildings, a GPS
receiver can report a valid position with bad accuracy. On an unfiltered track this can be seen as
 jerky moves, that not only look ugly but also add distance traveled to a GPS device actually
standing still.
You can set the minimum time required for a fatpoint (stand still) to be displayed on the map. You
can use this setting to filter out short Fatpoints that you do not want to see.
To enable Track filtering, you check the “Use filtered reader”. This adds Fatpoints and re-calculates
the Track length to better depict the actual movement of the GPS device.
Note: The original Tracks are kept so you can un-check Track filtering at any time to see the raw
un-filtered Track data.

13.3 Localization
Under the “Localization” tab on the Settings menu you can change your preferred language and the
measurements you want your application to use.
Ask you GpsGate Server Site Administrator for help if you would like to add more languages to
your application.
Here you also set the timezone for your application. The application shows everything in local time,
so this setting control the time used in the user interface and the reports.

13.4 Style
The “Style” tab contains settings for the number of vehicles that you want to have in the vehicle list
to the right of the map. The default setting is 10 vehicles.
You also have options for map marker style and content.

Date: February 10, 2010 Page 47(51)

 GpsGate VehicleTracker Application Manual
Version: 2.3.1 - Rev: 1.0

14 Map Selection
In the Maps menu you can choose between the maps available to your VehicleTracker application.
Ask your GpsGate Server Site Administrator if you want to add custom maps to your application.

Date: February 10, 2010 Page 48(51)

 GpsGate VehicleTracker Application Manual
Version: 2.3.1 - Rev: 1.0

15 Plug-ins
Note: This chapter is mainly aimed at Application Administrators.
GpsGate VehicleTracker supports plug-ins for easy application extension. The following plug-ins
are supplied with the application in the current version.

CloudMade Map Plug-in Enables CloudMade Maps

Google StreetView Window Adds a floating window with Google map and Google StreetView
for the selected vehicle

Map24 Map Plug-in Enables Map24 Maps

OpenLayers Map Plug-in Enables OpenaLayers plugin for OpenLayers, Yahoo, Bing and
Google Maps

Terminal Window Adds a floating windows with the Terminal to analyze traffic
 between the server and the device for the selected vehicle

Date: February 10, 2010 Page 49(51)

 GpsGate VehicleTracker Application Manual
Version: 2.3.1 - Rev: 1.0

16 Mobile Web Interface

VehicleTracker has a light weight web interface for mobile devices. You can view your vehicles on
a map and act on alarms in real time. The application works on mobile devices with a web browser.
The picture below shows an SOS alert (marked “A”) and the vehicle (marked “V”).

The mobile web interface uses the same uses name and password information as the main
VehicleTracker application.
Note: Ask your System Administrator for the connection details.

Date: February 10, 2010 Page 50(51)

 GpsGate VehicleTracker Application Manual
Version: 2.3.1 - Rev: 1.0

17 Connecting Devices to GpsGate VehicleTracker 

Note: This chapter is mainly aimed at Application Administrators.
Connecting devices to GpsGate VehicleTracker is usually handled by your GpsGate Server
Administrator. This is a brief overview of how it works, please contact your GpsGate Server
Administrator for additional help.
To get position updates to GpsGate VehicleTracker you need to connect a GPS device to GpsGate
Server over the Internet. The two main device types are:
● GpsGate Client (available for Windows computers, Windows mobile devices and Java
mobile phones)
● Dedicated GPS tracking devices.

17.1 GpsGate Client 

GpsGate Client is a client product that can be downloaded from GpsGate.com. It is identified as a
VehicleTracker user with a Username and Password. Please look at these online guides for
connection instructions:
Windows: http://gpsgate.com/index.php?id=30
Windows Mobile: http://gpsgate.com/index.php?id=40
Mobile phone (Java): http://gpsgate.com/index.php?id=42

17.2 Dedicated GPS tracking devices

Tracking devices all have different identification methods. The most common is the use of an id
number or the device IMEI number. Please look at these connections guide for supported devices
and a generic guide for most devices using a NMEA based message format:
Supported devices list: http://gpsgate.com/index.php?id=41
Generic guide: http://gpsgate.com/index.php?id=45
 Note: Please contact us at  [email protected] if you have a device you would like us to support!

Date: February 10, 2010 Page 51(51)