TrackerHub

Create Position

Production reader

https://api.exati.com.br/tracking/read

POST

/position/create

Position

This method is responsible for updating positions.

Request

Body Params application/json

idPosition

integer

required

The only mandatory field for Update and Delete operation, not used for new positions.

>= 1

idDevice

integer

required

A Device ID

>= 1

latitude

number <float>

required

The latitude of the geolocation

>= -90<= 90

longitude

number <float>

required

The longitude of the geolocation

>= -180<= 180

createdAt

string

optional

The timestamp of the location in RFC 3339 standard for this position. Defaults to received time when empty

velocity

number <float>

optional

The speed sent by the tracker for this position

>= 0< 100000000

Multiple of:

0.01

odometer

number

optional

The odometer reading of a device (Vehicle) for this position

>= 0< 10000000000000

Multiple of:

0.01

direction

number

optional

The heading of the device for this position

<= 1000> -1000

Multiple of:

0.01

altitude

number

optional

The altitude data for this position

>= -430

Multiple of:

0.01

rpm

integer

optional

The RPM of the device (Vehicle) for this position

>= 0

fuelLevel

number

optional

The fuel level of the device for this position

>= 0<= 1000

Multiple of:

0.01

engineTemperature

number

optional

The engine temperature for this position

>= -273.15<= 10000

Multiple of:

0.01

distanceDelta

number

optional

The distance Delta from the previous position

>= 0

Multiple of:

0.01

batteryVoltage

number

optional

The battery voltage for this position

>= -1000<= 1000

Multiple of:

0.01

mobileSignalStrength

integer

optional

The signal strength of the tracker for this position

gpsAccuracy

number

optional

The GPS accuracy for this position

Multiple of:

0.01

engineStatus

boolean

optional

The status of a devices engine for this position

Default:

false

Example

{
    "idDevice": 1,
    "latitude": 25.997053,
    "longitude": -97.155282,
    "createdAt": "2025-02-12 10:00:00.000 -0300",
    "velocity": 60.5,
    "odometer": 150350.75,
    "direction": 180.5,
    "altitude": null,
    "rpm": 2500,
    "fuelLevel": 75.5,
    "engineTemperature": 90.25,
    "distanceDelta": 1.25,
    "mobileSignalStrength": null,
    "gpsAccuracy": null,
    "batteryVoltage": 12.5,
    "engineStatus": true
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.exati.com.br/tracking/read/position/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "idDevice": 1,
    "latitude": 25.997053,
    "longitude": -97.155282,
    "createdAt": "2025-02-12 10:00:00.000 -0300",
    "velocity": 60.5,
    "odometer": 150350.75,
    "direction": 180.5,
    "altitude": null,
    "rpm": 2500,
    "fuelLevel": 75.5,
    "engineTemperature": 90.25,
    "distanceDelta": 1.25,
    "mobileSignalStrength": null,
    "gpsAccuracy": null,
    "batteryVoltage": 12.5,
    "engineStatus": true
}'

Responses

🟢201Created

application/json

Example of a Successful response

Body

status

string

optional

message

string

optional

Entity processed successfully

Example

{
    "status": "ok",
    "message": "Entity processed successfully"
}

🟠400Bad Request

🟠422Parameter Error

Position

Position :vendor