GPS Tracking

 

GPS tracking, All of Highfive Electronics distributors, agents, dealers, clients can get GPS tracking platform service from us, including protocol data and code example, communication program, parameters, and the same time, all can get technology service and support. With these it would like to expand relevant GPS tracking function.

Please contact us for technology support as below:

 

[email protected]

 

All customer accounts can be managed  and tracked, reported, monitored by dealer’s own GPS tracking platform,  and is used and managed by distributors, agents,dealers, clients.

 

To visit our GPS tracking platform, all distributors, agents, dealers, clients need to get their account and password from us.  It would be to obtain access our GPS tracking platform, manage, tracking, monitoring, positioning all of your assets .

 

 

Protocol format

 

Public convention

public attributes of returned data

ParameterTypeRequired or notDescription
codeintYesresult code
messagestringNoCode description

Code explanation

codeValueDescription
-1-1The system is busy
00success
1xxx1001Parameter error (lack of required parameters or format error). See interface description for details
1002Illegal user/illegal device (not their own or subordinate account or device)
10003Repeat operation
1004Illegal access, token exception! (Token failure or nonexistent)
1005Illegal access, ip access exceeds limit!
1006Illegal access, too frequently request!
1007Illegal access, request method error!
1008Illegal access, abnormal incoming!
41001Exceeds maximum geo-fence numbers
41002Fence name already exists!
41003The device is not online
41004Geo-fence operation failed

 

 

Protocol details

Call entry

Call URL of API. All interfaces use this URL.

 

Authentication

 

Common parameters

API signature

To prevent the API call hacked by hackers, any API calling needs be with a signature,TOP server will authenticate signature based on request parameters., Illegal signature request will be rejected.

 

Get the latest location data based on IMEI

 

Interface

 

Get the latest location information for a single or multiple devices

 

Request URL

 

HTTP request method

 

GET/POST

 

Request parameters

 

(1)common parameter

(2)private parameters

 

params list:

ParameterTypeDescription
imeistringDevice IMEI
device_infostringDevice name
iconstringVehicle icon
statusstringDevice status 0, offline; 1, online
latdoubleLongitude (if the device expires, the value is 0)
lngdoubleLatitude (if the device expires, the value is 0)
expireFlagstringWhether expired 1- expired 0 – not expired
activationFlagstringActivate or not 1 – Activate 0 – Not active
posTypestringGPS, LBS, WIFI, BEACON
locDescstringLocation information
gpsTimestringGPS positioning time
hbTimestringHeartbeat time
speedstringSpeed (unit: km / h)
speedstringACC 0: off 1: on
electQuantitystringbattery(0-100), Some device models are not supported
powerValuestringExternal voltage(0-100), Some device models are not supported

Interface

Single device acquire 2 days track data within 3 months.

 

Request URL

 

Method value in common parameters.

HTTP request method

GET/POST

Request parameters

(1)common parameter

(2)private parameters

ParameterTypeRequired or notDefault valueDescription
access_tokenstringYesaccesstoken: used for identifying legal third party
imeistringYesDevice imei( only 1 each time)
begin_timenumberYesStart time Format: yyyy-MM-dd HH:mm:ss
end_timenumberYesEnd time Format: yyyy-MM-dd HH:mm:ss end_time should be earlier than current time
map_typestringNoIf you want to display on Baidu map, the returned latitude and longitude of map_type = BAIDU will be calibrated by baidu calibration

If you want to display on google map, the returned latitude and longitude of map_type=GOOGLE will be calibrated by google calibration. If map_type is null, then return origin latitude and longitude

Returned value

ParameterTypeDescription
codeintReturn code:
0: return correctly
Other: failure. Refer to the error code description
messagestringIf ret is not 0, there will be a corresponding error message
resultstringThe returned data

result data list:

ParameterTypeDescription
lngdoublelongitude
latdoublelatitude
gps_timestringGPS positioning time. Format yyyy-MM-dd HH: mm: ss
directionstringdirection
gpsSpeedstringGPS speed
posTypestring1. GPS, 2. LBS, 3. WIFI

Bind and Unbind the user for the device IMEI

Modify vehicle information by IMEI

 

Interface

 

Modify vehicle information by IMEI

 

Request URL

 

Method value in common parameters.

 

HTTP request method

POST

Request parameters

(1)common parameter

(2)private parameters

 

Wifi and base station locating analysis interface

 

Interface

 

 

Request URL

 

Method value in common parameters

 

HTTP request method

 

GET/POST

 

Request parameters

 

Interface Create geo-fence for IMEI

 

Request URL

 

HTTP request method

 

POST

 

Request parameters

 

Returned value

 

Delete geo-fence for device IMEI

 

Interface

 

Delete geo-fence for device IMEI

Request URL

 

Method value in common parameters.

 

HTTP request method

 

POST

 

Request parameters

 

 

Message push interface

Appendix: Device alarm type

ParameterDescription
1SOS
2Power off alarm
3Vibration alarm
4Enter the geo- fence (terminal)
5Leave the geo- fence (terminal)
6Speed alarm
9Displacement alarm
10Into the satellite blind area alarm
11Out of the satellite blind area alarm
12Power on alarm
13GPS first time positioning alarm
14External battery low alarm
15External low power protection alarm
16SIM card change alarm
17Shutdown alarm
18Flight mode alarm after external battery is low
19Tamper alarm
22Voice alarm
90Low battery alarm
128Rearview mirror vibration alarm
192Displacement alarm
194Low backup battery ala
195Boundary violation alarm
1001ACC off
1002ACC on
1003Offline alarm
1004Stop alarm
1005Stay idle alarm
1006Enter geo-fence
1007Leave geo-fence
1008Outside geo-fence for a long time
1009Inside geo-fence for a long time