Real-time Data

Get Device Position

Parameters:

  • device_token: UUID of the device
  • units: Unit system (metric/imperial) for speed/distance conversion
  • timezone: Timezone for timestamp formatting
  • date_format: Format for timestamps (unix/iso/localized)

Returns:

  • Device position with source indication (is_from_cache field)

Example Usage:

GET /devices/e4855fba-0d7e-4dbd-baad-aae9d0b90c15/position
GET /devices/e4855fba-0d7e-4dbd-baad-aae9d0b90c15/position?units=imperial&date_format=iso
get/api/v1/devices/{device_token}/position

Request

  • Base URL
    https://portal-apis.telematicssdk.com/realtime
  • URL
    https://portal-apis.telematicssdk.com/realtime/api/v1/devices/{device_token}/position
  • Auth
    HTTP bearer

Path parameters

device_tokenstring required

Query parameters

unitsstring

Unit system: metric (km/h, m) or imperial (mph, ft)

timezonestring

Timezone for timestamps (e.g., 'UTC', 'America/New_York')

date_formatstring

Date format: unix, iso, or localized

Response

Successful Response

device_tokenstring required

UUID of the device

accuracynumber required

GPS accuracy in meters

latitudenumber required

Latitude coordinate

longitudenumber required

Longitude coordinate

speednumber required

Speed in km/h or m/s

timestampinteger required

Unix timestamp in seconds

last_updatedstring date-time required

Last update time

is_from_cacheboolean

Whether data came from cache (MongoDB) vs real-time (Redis)

Changes

No recorded changes to this operation across all 1 revision of this API.