/bulk-gpsdata - FleetUp API Docs

This API returns GPS data list for multiple devices within a specified time interval. Please note that the interval of start-time and end-time should not be more than 10 minutes

Request

Authorization

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Header Params

token

string

required

Body Params application/json

devIds

array[string]

required

List of Device Ids

start-time

string

required

Lower bound of the date range

>= 14 characters<= 14 characters

end-time

string

required

Upper bound of the date range

>= 14 characters<= 14 characters

Example

{
    "devIds": [
        "string"
    ],
    "start-time": "stringstringst",
    "end-time": "stringstringst"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200成功

application/json

200 response

Body

array of:

devId

string

optional

Device ID

tmTime

number

optional

GPS trigger time, UTC time zone, yyyyMMddHHmmss

acconTime

number

optional

Vehicle Ignition time, UTC time zone, yyyyMMddHHmmss

direction

number

optional

The returned number is between 0 and 3600, e.g. 1311
Conversion:
1311/10 = 131.1
The direction of where the vehicle is driving toward. There are 360 degrees, with zero at the 12 o’clock position, increasing in clock-wise direction. For example:
0 = 12 o’clock 90 = 3 o’clock
e.g. 1311 will be 1311 / 10 = 131.1 (direction in between 4 o’clock and 5 o’clock)

fuelWear

number

optional

Fuel consumed in centiliters

lat

number

optional

GPS data latitude, e.g. 142198116
Conversion to Decimal Degree format:
142198116 / 3600000 = 39.4994767 (Positive # = North, Negative # = South)

lng

number

optional

GPS data longitude, e.g., -438079242
Conversion to Decimal Degree format:
-438079242 / 3600000 = -121.688678 (Positive # = East, Negative # = West)

tripMileage

number

optional

Trip's incremental trip mileage in meters

rpm

number

optional

Revolutions Per Minute

speed

number

optional

The value for instant speed, unit: cm/s, e.g. 2861
Conversion:
2861 * 0.036 km/h = 102.99 km/h

deviceMileage

number

optional

Odometer from System in Meters

odometer

number

optional

Odometer from ECU in Kilometers. Consider using deviceMileage, if this reading is 0

preference

number

optional

Preferred Odometer reading for the device, 0 = from ECU and 1 = from system

Example

[
    {
        "devId": "string",
        "tmTime": 0,
        "acconTime": 0,
        "direction": 0,
        "fuelWear": 0,
        "lat": 0,
        "lng": 0,
        "tripMileage": 0,
        "rpm": 0,
        "speed": 0,
        "deviceMileage": 0,
        "odometer": 0,
        "preference": 0
    }
]