Debug School

Abhishek singh
Abhishek singh

Posted on

GPS Tracking Integration Report for Motoshare

GPS Tracking Integration Report for Motoshare.in

Project

Motoshare.in Vehicle GPS Tracking Setup

Tracking Server

Traccar Server: gps.motoshare.in

1. Current Understanding

We have already developed a vehicle management system for Motoshare.in.

Current completed flow:

Motoshare Vehicle Add Form
        ↓
Vehicle Details + GPS IMEI
        ↓
Create Device in gps.motoshare.in through Traccar API
        ↓
Vehicle appears in Traccar dashboard
        ↓
Tracking should happen directly on gps.motoshare.in
Enter fullscreen mode Exit fullscreen mode

The main requirement is:

When a vehicle is added in Motoshare.in with a GPS tracker IMEI number, that device should be created in Traccar, and all vehicles should be tracked directly on the Traccar map at gps.motoshare.in.

Currently, we do not need to integrate the live tracking map inside motoshare.in.

2. Important Clarification

Adding the IMEI number in Traccar only creates a device record.

It does not automatically start live tracking.

For live tracking, one GPS source must send location data to Traccar.

There are two options:

Option 1: Traccar Client Mobile App
Enter fullscreen mode Exit fullscreen mode

Yes, possible, but please understand clearly:

Option 1: Traccar Client Mobile App

This tracks the mobile phone location, not the physical vehicle tracker.

Flow:

Mobile Phone + Traccar Client App
        ↓
Phone GPS location
        ↓
gps.motoshare.in
        ↓
Shows as one device in Traccar map
Enter fullscreen mode Exit fullscreen mode

Use this when you want to track:

Driver phone
Renter phone
Staff phone
Temporary testing
Enter fullscreen mode Exit fullscreen mode

Physical GPS Tracker Device

This tracks the actual vehicle location.

Flow:

Physical GPS Tracker installed in vehicle
        ↓
SIM card inside tracker
        ↓
gps.motoshare.in
        ↓
Shows vehicle location in Traccar map
Enter fullscreen mode Exit fullscreen mode

Use this when you want to track:

Bike
Car
Rental vehicle
Fleet vehicle
Enter fullscreen mode Exit fullscreen mode

Can both be used together?

Yes, both can be used together, but they should be added as separate devices in Traccar.

Example:

Device 1:
Name: Honda Activa - Vehicle Tracker
Unique ID: 864895060123456
Source: Physical GPS tracker IMEI

Device 2:
Name: Driver Phone - Rakesh
Unique ID: 7709488616-driver
Source: Traccar Client mobile app
Enter fullscreen mode Exit fullscreen mode

Important

Do not use the same Unique ID for both mobile app and physical tracker.

Each device must have a different Unique ID.

Simple Answer 

Traccar Client App = tracks mobile phone
Physical GPS Tracker = tracks vehicle

For Motoshare vehicle tracking, physical GPS tracker is best.
For testing or driver/renter tracking, Traccar Client app can be used.
Enter fullscreen mode Exit fullscreen mode

So if your goal is track vehicle, then use physical GPS tracker device.

If your goal is test gps.motoshare.in quickly, then use Traccar Client App.

Option 2: Physical GPS Tracker Device 

Option 2: Physical GPS Tracker Device
Enter fullscreen mode Exit fullscreen mode

Since we do not want to use the Traccar Client mobile app, we need to use a physical GPS tracker device installed in each vehicle.

3. Final Required Flow Without Traccar Client App 

Physical GPS Tracker installed in vehicle
        ↓
SIM card inserted inside GPS tracker
        ↓
GPS tracker configured with server + port + APN
        ↓
GPS tracker sends location data to gps.motoshare.in
        ↓
Traccar receives GPS data
        ↓
Vehicle becomes online in Traccar dashboard
        ↓
Admin tracks all vehicles on gps.motoshare.in map
Enter fullscreen mode Exit fullscreen mode

4. What is Required for Each Vehicle?

For each vehicle, we need:

1. Physical GPS tracker device
2. SIM card with active internet
3. GPS tracker IMEI number
4. Correct GPS tracker password
5. Correct SMS command format
6. Correct Traccar protocol port
7. Device added in Traccar using IMEI as Unique ID
8. Device configured to send data to gps.motoshare.in
Enter fullscreen mode Exit fullscreen mode

5. Example Setup

Example vehicle:

Vehicle Name: Honda Activa
Vehicle Number: JH05 AB 1234
GPS Tracker IMEI: 864895060123456
GPS Tracker SIM Number: 85485125324
Traccar Server: gps.motoshare.in
GPS Port: 5023
SIM Provider: Airtel
Enter fullscreen mode Exit fullscreen mode

In Traccar, add:

Device Name: Honda Activa - JH05 AB 1234
Unique ID: 864895060123456
Enter fullscreen mode Exit fullscreen mode

Important:

Unique ID = GPS tracker IMEI number
Enter fullscreen mode Exit fullscreen mode

The SIM number and IMEI number are different.

SIM Number = number where SMS commands are sent
IMEI Number = unique GPS device ID added in Traccar
Enter fullscreen mode Exit fullscreen mode

6. SMS Command Explanation

GPS devices are configured by sending SMS commands to the SIM number inside the GPS tracker.

These commands are sent from our mobile phone to the GPS tracker SIM.

Example GPS tracker SIM number:

85485125324
Enter fullscreen mode Exit fullscreen mode

Command 1: APN Setting

Template:

apn<PASSWORD> <SIM_APN>
Enter fullscreen mode Exit fullscreen mode

Example for Airtel:

apn123456 airtelgprs.com
Enter fullscreen mode Exit fullscreen mode

Meaning:

GPS device, use Airtel internet.
Enter fullscreen mode Exit fullscreen mode

Breakdown:

apn = internet setting command
123456 = GPS tracker password
airtelgprs.com = Airtel APN
Enter fullscreen mode Exit fullscreen mode

For Jio:

apn123456 jionet
Enter fullscreen mode Exit fullscreen mode

For Vi:

apn123456 www
Enter fullscreen mode Exit fullscreen mode

Command 2: Server/IP Setting

Template:

adminip<PASSWORD> <SERVER_DOMAIN> <PORT>
Enter fullscreen mode Exit fullscreen mode

Example:

adminip123456 gps.motoshare.in 5023
Enter fullscreen mode Exit fullscreen mode

Meaning:

GPS device, send location data to gps.motoshare.in on port 5023.
Enter fullscreen mode Exit fullscreen mode

Breakdown:

adminip = server/IP setting command
123456 = GPS tracker password
gps.motoshare.in = Traccar server
5023 = GPS tracker protocol port
Enter fullscreen mode Exit fullscreen mode

Final target:

gps.motoshare.in:5023
Enter fullscreen mode Exit fullscreen mode

Command 3: Upload Interval Setting

Template:

upload<PASSWORD> <SECONDS>
Enter fullscreen mode Exit fullscreen mode

Example:

upload123456 30
Enter fullscreen mode Exit fullscreen mode

Meaning:

GPS device, send location every 30 seconds.
Enter fullscreen mode Exit fullscreen mode

Breakdown:

upload = location sending interval command
123456 = GPS tracker password
30 = every 30 seconds
Enter fullscreen mode Exit fullscreen mode

7. Complete Example SMS Flow

If SIM is Airtel and password is 123456, send these SMS messages one by one to the GPS tracker SIM number:

apn123456 airtelgprs.com
Enter fullscreen mode Exit fullscreen mode 
adminip123456 gps.motoshare.in 5023
Enter fullscreen mode Exit fullscreen mode 
upload123456 30
Enter fullscreen mode Exit fullscreen mode

Simple meaning:

1. Use Airtel internet.
2. Send GPS location to gps.motoshare.in on port 5023.
3. Send location every 30 seconds.
Enter fullscreen mode Exit fullscreen mode

8. Important: Commands Can Be Different

The above commands are common examples.

But every GPS tracker brand/model can have a different SMS command format.

Some trackers use this format:

APN,airtelgprs.com#
SERVER,gps.motoshare.in,5023#
TIMER,30#
Enter fullscreen mode Exit fullscreen mode

Some use:

adminip123456 gps.motoshare.in 5023
Enter fullscreen mode Exit fullscreen mode

Some devices may use:

SERVER,gps.motoshare.in,5023
Enter fullscreen mode Exit fullscreen mode

So the exact command must be confirmed from the GPS tracker manual or seller.

9. About Onelap GPS Tracker

We are using Onelap device.

Important limitation:

Onelap devices may be locked to Onelap’s own platform by default.

So before using Onelap device with gps.motoshare.in, we must confirm whether Onelap allows a custom server configuration.

We need to ask Onelap support:

I want to connect my Onelap GPS tracker with my own Traccar server.

Server: gps.motoshare.in

Please provide:
1. SMS command password
2. APN SMS command format
3. Server/IP/domain and port SMS command format
4. Upload interval SMS command format
5. Device protocol name
6. Correct Traccar-compatible port
7. Confirmation whether this device supports custom server or not
Enter fullscreen mode Exit fullscreen mode

If Onelap does not allow custom server configuration, then the device cannot directly send GPS data to gps.motoshare.in.

10. Where to Find GPS Tracker Password?

GPS tracker password is the password of the physical GPS device.

It is not:

Traccar password
Server password
Motoshare login password
Enter fullscreen mode Exit fullscreen mode

It is used inside SMS commands.

Example:

adminip123456 gps.motoshare.in 5023
Enter fullscreen mode Exit fullscreen mode

Here:

123456 = GPS tracker password
Enter fullscreen mode Exit fullscreen mode

Where to get it:

1. GPS tracker manual
2. Device sticker or box
3. GPS tracker seller
4. Onelap support
Enter fullscreen mode Exit fullscreen mode

Common default passwords:

123456
000000
888888
1234
Enter fullscreen mode Exit fullscreen mode

Most trackers commonly use:

123456
Enter fullscreen mode Exit fullscreen mode

But for Onelap, we should confirm from Onelap support.

11. What is Port 8082?

Our Traccar config currently shows:

<entry key='web.port'>8082</entry>
Enter fullscreen mode Exit fullscreen mode

This means:

8082 = Traccar web dashboard/API port
Enter fullscreen mode Exit fullscreen mode

It is used to open:

https://gps.motoshare.in
Enter fullscreen mode Exit fullscreen mode

But physical GPS trackers usually do not send GPS data to port 8082.

For GPS tracker data, we need a protocol port, for example:

5023
5027
5055
5086
Enter fullscreen mode Exit fullscreen mode

The correct port depends on the GPS tracker model/protocol.

So this is wrong for most physical trackers:

SERVER,gps.motoshare.in,8082
Enter fullscreen mode Exit fullscreen mode

Correct format should be:

SERVER,gps.motoshare.in,<GPS_PROTOCOL_PORT>
Enter fullscreen mode Exit fullscreen mode

Example:

SERVER,gps.motoshare.in,5023
Enter fullscreen mode Exit fullscreen mode

12. How to Find Active Traccar Ports on Server?

Run this command on the server:

sudo ss -tulnp | grep java
Enter fullscreen mode Exit fullscreen mode

or:

sudo netstat -tulnp | grep java
Enter fullscreen mode Exit fullscreen mode

This will show which ports Traccar is listening on.

Example output:

0.0.0.0:8082
0.0.0.0:5023
0.0.0.0:5055
0.0.0.0:5027
Enter fullscreen mode Exit fullscreen mode

Meaning:

8082 = Web/API port
5023 = GPS protocol port
5055 = OsmAnd / Traccar Client type port
5027 = Teltonika type port
Enter fullscreen mode Exit fullscreen mode

13. Firewall Requirement

If the GPS tracker uses port 5023, then this port must be open on the server.

Run:

sudo ufw allow 5023/tcp
sudo ufw allow 5023/udp
sudo ufw reload
Enter fullscreen mode Exit fullscreen mode

If the server is hosted on AWS/Cloud, also open the same port in:

Security Group / Firewall Inbound Rules
Enter fullscreen mode Exit fullscreen mode

Example:

Custom TCP: 5023 from 0.0.0.0/0
Custom UDP: 5023 from 0.0.0.0/0
Enter fullscreen mode Exit fullscreen mode

14. How to Check Whether Device Is Connecting?

Check Traccar logs:

sudo tail -f /opt/traccar/logs/tracker-server.log
Enter fullscreen mode Exit fullscreen mode

Then power on the GPS device or send the server command again.

If the device connects, logs should show device activity.

Also check Traccar dashboard:

https://gps.motoshare.in
Enter fullscreen mode Exit fullscreen mode

Expected result:

Device status: Online
Last update time: Current
Latitude/Longitude: Visible
Vehicle marker: Visible on map
Enter fullscreen mode Exit fullscreen mode

15. Limitations

1. IMEI registration alone is not enough

Adding IMEI in Traccar only creates the device.

It will not show live tracking unless the physical GPS tracker sends location data.

2. Correct port is mandatory

If the wrong port is configured, the device will not connect.

Example:

8082 is web/API port, not GPS data port.
Enter fullscreen mode Exit fullscreen mode

The GPS tracker needs the correct protocol port.

3. GPS tracker model dependency

Every GPS tracker has different:

SMS command format
Default password
Protocol
Port
Server setting method
Enter fullscreen mode Exit fullscreen mode

So we must know the exact device model.

4. Onelap may be locked

Onelap device may be locked to Onelap’s own server/app.

If custom server is not supported, we cannot directly connect it to Traccar.

Possible options then:

1. Use Onelap dashboard/app
2. Ask Onelap for API access
3. Use a Traccar-compatible GPS tracker
Enter fullscreen mode Exit fullscreen mode

5. SIM internet is required

The SIM inside the GPS tracker must have:

Active internet data
SMS service
Correct APN
Network coverage
Enter fullscreen mode Exit fullscreen mode

Without SIM internet, the tracker cannot send live location.

6. Server firewall must allow GPS port

Even if the GPS tracker is configured correctly, it will not connect if the port is blocked.

7. IMEI must match

The IMEI added in Traccar must exactly match the real GPS tracker IMEI.

If IMEI is wrong, Traccar may receive data but not match it with the device.

8. GPS signal required

If the device is indoors, underground, or has poor satellite signal, the location may not update properly.

16. Final Implementation Checklist

Motoshare Side 

1. Add GPS IMEI field in vehicle form.
2. Save GPS IMEI in Motoshare database.
3. Call Traccar API to create device.
4. Save Traccar device ID in Motoshare database.
5. Prevent duplicate IMEI.
Enter fullscreen mode Exit fullscreen mode

Traccar Side 

1. Device should be created with IMEI as Unique ID.
2. Correct GPS protocol port should be active.
3. Required port should be open in firewall/security group.
4. Logs should be monitored for GPS connection.
Enter fullscreen mode Exit fullscreen mode

GPS Device Side 

1. Insert active SIM card.
2. Configure APN.
3. Configure server: gps.motoshare.in.
4. Configure correct port.
5. Configure upload interval.
6. Power on device.
7. Verify device online in Traccar.
Enter fullscreen mode Exit fullscreen mode

17. Final Summary

We have already completed the basic integration where vehicles added in Motoshare.in can be registered as GPS devices in Traccar using their GPS IMEI number.

However, live tracking does not start only by saving the IMEI. For live tracking, each vehicle must have a physical GPS tracker device installed with an active SIM card. The tracker must be configured to send location data to our Traccar server gps.motoshare.in using the correct GPS protocol port.

The Traccar web/API port is 8082, but this is not normally used for physical GPS device data. We need the correct tracker protocol port based on the GPS device model.

Since we are using an Onelap GPS tracker, the main dependency is confirmation from Onelap whether the device supports a custom server. If Onelap allows custom server configuration, they must provide the SMS command format, password, APN command, server/IP command, upload interval command, and correct Traccar-compatible port.

If Onelap does not allow custom server configuration, the device cannot directly connect to gps.motoshare.in. In that case, we need either Onelap API integration or a Traccar-compatible physical GPS tracker.

Final production flow:

Motoshare.in
        ↓
Add vehicle with GPS IMEI
        ↓
Create device in gps.motoshare.in
        ↓
Install physical GPS tracker in vehicle
        ↓
Configure tracker with SIM APN + gps.motoshare.in + correct port
        ↓
Tracker sends live location to Traccar
        ↓
Admin tracks all vehicles on gps.motoshare.in
Enter fullscreen mode Exit fullscreen mode

Top comments (0)