ZTrack

USER MANUAL
Prepared by: Kamarali Khan
Aug, 2014

ZTRACK USER'S MANUAL

TABLE OF CONTENTS
Page #
1.0

GENERAL INFORMATION ...................................................................................................... 1-1

1.1

Overview.................................................................................................................................. 1-1

1.2

How Tracking works:............................................................................................................. 1-2

1.2

Important Note: ...................................................................................................................... 1-3

2.0
2.1
3.0

Funtionality .................................................................................................................................. 2-1

Application Settings................................................................................................................ 2-1
TRaCKING and geo fencing ....................................................................................................... 3-5

3.1 Dial n Track ................................................................................................................................... 3-5

3.2 Fixed Track .................................................................................................................................... 3-5
3.3 Geo Fencing .................................................................................................................................... 3-5
4.0

TRACKS and ZOOM ................................................................................................................... 4-1

4.1 Tracks ............................................................................................................................................. 4-1

4.2 ZOOM ............................................................................................................................................ 4-2
5.0

Migration from ZTRACK_FREE to ZTRACK (paid) version. .................................................. 5-3

6.0

TROUBLESHOOTING ............................................................................................................... 6-4

Users Manual

Page ii

1.0

GENERAL INFORMATION

1.1

Overview

ZTrack is an android application that can be used to track GPS device. It can communicate with the GPS
hardware devices or Motorola Alert over SMS and plots the track on inbuilt google map. It uses SMS for
communication and so it can function without internet connectivity. The inbuilt map is also not dependent
on internet connection availability and can function without it (only when it is setup for the first time, you
have to explore you respective area of interest on the map, with INTERNET connection ON).
It is very light weight application and does not have any services running for 24 hours. Whenever the
GPS device sends an SMS ZTrack becomes active and starts locating the device. You do not need to run
this app all the time, it starts whenever the configured GPS device or Android device with Moto Alert
sends SMS.

Users Manual

Page 1-1

1.2

How Tracking works:

Option 1
(With GPS hardware device)
1. Buy a GPS Device and configure it (refer your respective GPS device manual for
configuring it)
It needs a SIM.
{Lets say you put a SIM with
Number 9911223344)

2. Install ZTrack in Your Android Phone

Go to Menu=> Settings
1) Area Code for Dialing: fill the area code that you need to prepend before GPS SIM
Number in order to dial it. Leave it blank if not required.
2) SIM Number: fill the SIM number of you GPS device (e.g. 9911223344)
3) If you have changed the default password of GPS device which is 123456, then you
need to change this password wherever applicable.[refer 2.1)

3. When GPS device sends SMS to your mobile, ZTrack will become active and
read the location and plot it on its in build map.
4. For detail features and behavior, refer 2.0, 3.0 and 4.0

Users Manual

Page 1-2

Option 2
(Using Motorola Alert on Second Android Phone)

1. You need two android phones,

Lets call the android phone who will track as TRACKER and the one who will get
tracked as TRACKIE.
2. Install Motorola Alert on the TRACKIE phone (available for Free in Google market)

3. install ZTrack on the TRACKER phone and do following settings.

Go to Menu => Settings
a. SIM Number: fill the SIM number of your TRACKIE Phone

4. Whenever TRAKIE wants to get tracked, user should start Motorola alert in it.
a. Use the feature of FOLLOW ME in Motorola Alert.
b. In FOLLOW ME the recipient phone number should be set to the Phone number
of TRACKER PHONE.

5. On receiving the SMS, The ZTrack on TRACKER will plot the location on its
internal map.
6. Please note that other features like, Call n Track, Fix Track and Geo Fencing will
not be possible with this Option.

1.2

Important Note:

Please note that ZTrack supports Android versions from ICS to Kitkat (4.4.4).
This user manual is prepared with the latest version of Android (Kitkat).
The Application comes with the default settings to supports all TK series devices, and it also supports the
SMS format from Motorola Alert application
ZTrack has been tested on multiple Android systems and devices, It is found that it DOES NOT
WORKS on MI3 and RED MI Chinese devices as of now.
Users Manual

Page 1-3

Following TK series are supported.

No.

Model
1
2
3
4
5
6
7
8
9
10
11
12
13

Xexun TK 1032 D
TK 102B
Tk-106A/B
TK-103AB
TK-104
TK-107 A/B/C
TK-301
TK-302
TK-303 A/B/C/D/E/F/G
TK-304 AB
TK-305
TK- 306AB
TK-103AB

Note: Xexun TK 1032D might require some changes in settings.

Apart from above mentioned devices, ZTrack can be configured to support many other SMS based GPS
SMS formats.

Users Manual

Page 1-4

2.0

FUNTIONALITY

2.1

Application Settings
1. To configure your GPS device, bring the pull down Menu, and click Settings(Fig. 1)
(Note: we assume that you have already configured your GPS device with your phone
number. If not then you need to check your GPS device manual.)

Fig.1 - Access Settings Menu

Users Manual

2. Following Scrollable Setting dialog-box will appear.(Fig 2)

Fig.2 - Settings dialog box (It is scrollable)

3. Area Code for Dialing

- By default it is set as blank.
- For e.g. if your GPS SIM number is 9911223344 but you need to append area code +91
for dialing your GPS device. The area code should be set as +91
- Add the area code if you need it, otherwise leave it blank,
4. SIM Number
- By default it is set to 0000000000
- Please change it to your GPS device SIM number.
- Please note do not add any other code to SIM number.(this is very important for ZTrack
to recognize your GPS device correctly)
5. Message Identifier
- By default it is set to https
- This will work with all the TK series GPS devices.
- If you want to identify some other device message format, then you need to set this value
to some unique word that comes in your GPS SMS location message.
6. Latitude Regex
- By default is it set to .*q=([0-9]*\.[0-9]*).*
- This will work will all the TK series GPS devices message format and also for Motorola
Alert SMS format.
- If you want to identify some other devices message format this can be changed.
Users Manual

This is a regular expression. If you need to configure some other GPS device, then you
need to come up with a new regular expression that can extract that can extract latitude
information from your SMS message. [Refer following web link to test your regular
expressions http://www.regexplanet.com/advanced/java/index.html ]

7. Longitude Regex
- By default is it set to .*q=.*,([0-9]*\.[0-9]*).*
- This will work will all the TK series GPS devices message format and also for Motorola
Alert SMS format.
- If you want to identify some other devices message format this can be changed.
- This is a regular expression. If you need to configure some other GPS device, then you
need to come up with a new regular expression that can extract that can extract longitude
information from your SMS message. [Refer following web link to test your regular
expressions http://www.regexplanet.com/advanced/java/index.html ]

8. Geo Fence start Command

- By default it is set to stockade123456 LAT1,LON1;LAT2,LON2
- Where
o Stockade is TK device command to start geo fencing.
o 123456 is default password of GPS device.
o LAT1
is latitude of top right corner of Geo Fence rectangle
o LON1
is longitude of top right corner of Geo Fence rectangle
o LAT2
is latitude of bottom left corner of Geo Fence rectangle
o LON2
is longitude of bottom left corner of Geo Fence rectangle
- This will work will all TK devices.
- Please keep note to change the password, if you are not using the default password
123456
9. Geo Fence stop Command
- By default it is set to nostockade123456
- Where
o nostockade is TK device command to start geo fencing.
o 123456 is default password of GPS device.
- This will work will all TK devices.
- Please keep note to change the password, if you are not using the default password
123456
10. Start SMS Command
- By default it is set to fix005m***n123456
- Where
o fix is TK device command to start getting GPS SMS at fixed interval of time.
o Details of fix command can be checked in user manual of TK devices.
o 123456 is the default password.
- This will work will all TK devices.
- Please keep note to change the password, if you are not using the default password
123456
11. Stop SMS Command.
- By default it is set to nofix123456
- Where
Users Manual

o nofix is TK device command to stop getting GPS SMS at fixed interval of time.
o Details of fix command can be checked in user manual of TK devices.
o 123456 is the default password.
This will work will all TK devices.
Please keep note to change the password, if you are not using the default password
123456

12. GeoFence confirm incoming

- By default it is set to stockade ok!
- This is TK devices response SMS when GeoFence is activated.
- Please change it if your device sends some other command.
- Note that it is a complete SMS that you receive.

13. GeoFence stop confirm incoming

- By default it is set to nostockade ok
- This is TK devices response SMS when GeoFence is stopped..
- Please change it if your device sends some other command.
- Note that it is a complete SMS that you receive.
14. Custom Command A
- By default it is not set.
- If you want to configure any custom command, it can be added here.
15. Custom Command B
- By default it is not set.
- If you want to configure second custom command, it can be added here.

Users Manual

3.0

TRACKING AND GEO FENCING

3.1 Dial n Track

All TK devices have facility, where registered number can give a missed call to the device and it will
respond back with SMS having GPS location information.
You can select menu item Dial n Track and give a miss call to your GPS device via your Phone, and the
response SMS will be read by ZTrack and location will be shown in the map. .

3.2 Fixed Track

1

If you intent to track your device after every fixed interval of time you can do that by using Menu
item Start Fixed Track. [SMS will be sent to device , note : you will incur SMS charge]

If you want to stop the fixed tracking, it can be done by selecting Menu item Stop Fixed Track
[SMS will be sent to device, note: you will incur SMS charge]

3.3 Geo Fencing

For setting up Geo Fence on ZTrack do following
1. You will need to select 2 corners (Top Left and Bottom Right) of rectangle on the map.
2. For Selecting Top left corner, long tap on the map (Fig 3.1)

Users Manual

Fig. 3.1

3. A red dot will appear on the map. (Fig 3.1)

4. If the Map was not aligned vertically, it will get aligned in vertical direction.
5. Then tap again to select the Bottom Right corner, it should be below and towards the right of Top
Left Corner.(Fig. 3.2)

Users Manual

Fig. 3.2

6. Then a Green rectangle will appear on the map.

7. To enable geo fencing press menu item Start GeoFence SMS.(SMS will be send to device,
note : you will incur SMS charge)
MENU GeoFencingStart GeoFence SMS
8. On receiving the confirmation of start geo fence SMS from the device; the rectangle will turn
RED in color.
9. To stop Geo Fencing, press menu item Stop GeoFence SMS (SMS will be send to device, note :
you will incur SMS charge)
MENU GeoFencingStop GeoFence SMS
10. On receiving the confirmation of stop geo fence SMS from the device; the rectangle will turn
Green in color
11. As any point of time, you can clear the already existing Geo Fence by selecting menu item Clear
GeoFence on Map, Note that it will only clear geo fence on the map and not stop Geo Fence
command to the device.

Users Manual

Users Manual

4.0

TRACKS AND ZOOM

4.1 Tracks
All the Incoming SMS location will be plotted on the map as following. (Fig 4.1)

Fig 4.1 Tracks

1.
2.
3.
4.
5.

The Track will be shown in BLUE color

The latest position will be shown by RED marker
Old positions will be shown by Green marker.
Tapping on any marker will show you the time of tracking.
Maximum positions shown will be 200 positions. If this limit exceeds the oldest data will be
wiped off.
6. At any point of time, Track can be cleared by selecting menu item Clear Track
MENU Clear Track

Users Manual

Page 4-1

4.2 ZOOM
Hot click zoom buttons are provided on top of the map (Fig.4.2), they can be used for zooming and
locating purpose.

Fig. 4.2 Zoom Hot Click icons

- This can be used to locate the GPS target
- This can be used to location the Geo Fence if available

- This can be used to locate you on the map. [GPS of android phone should be active]

Users Manual

Page 4-2

5.0

MIGRATION FROM ZTRACK_FREE TO ZTRACK (PAID) VERSION.

a) Buy the paid version from Android Market and install it.
b) Uninstall the ZTrack_Free version of application.

Users Manual

Page 5-3

6.0

TROUBLESHOOTING

1. Unable to send SMS to GPS device from ZTrack.

- Please see if the Area Code and SIM number is configured correctly in settings.
- Please check if you have some other password, you need to change all the default
passwords in all the command. (device settings are configured for default password
123456)
2. You get SMS from GPS device but ZTrack unable to show it in map
- Please see if the Area Code and SIM number is configured correctly in settings.
- Please check if you have not changed any default settings.
- Please check if Message Identifier is set correctly and that your received SMS contains
the same identifier somewhere in SMS.
- Please check that you are using the default Latitude/Longitude regex (for TK devices) or
you have configured it correctly for your respective device.
3. Geo Fence not turning RED on receiving Geo fence confirm message.
- Please check that you have not changed the default settings of Geo Fence confirm
incoming message.
4. Unable to load the Map.
- For first time you will need to be on the internet so that the map caches successfully.
- If issue is still not resolved, please contact the application development team
(kamaralikhan@gmail.com)
5. Licensing Issue
- Make sure you have purchased the map from Google Play.
- If issue is still not resolved, please contact the application development team
(kamaralikhan@gmail.com)

Users Manual

Page 6-4