Contact us LoginLIVE DEMOFREE TRIAL

read(…)

Get track points for the specified track id, tracker and time period.

parameters:

namedescriptiontype
tracker_idId of the tracker (aka “object_id”). Tracker must belong to authorized user and must not be blocked.int
fromA string containing date/time in “yyyy-MM-dd HH:mm:ss” format (in user’s timezone)string
toA string containing date/time in “yyyy-MM-dd HH:mm:ss” format (in user’s timezone). Specified date must be after “from” datestring
track_id(optional) If specified, only points belonging to the specified track will be returned. If not, any valid track points between “from” and “to” will be returnedint
include_gsm_lbs(optional, default=true) If false && track_id not specified, GSM LBS points will be filtered out.boolean
point_limit(optional) If specified, the returned track will be simplified to contain this number of points. Min=2, Max=3000int
filter(optional) If specified, the returned track will be filtered, applicable only for LBS tracks nowboolean

return:

{
    "success": true, 
    "limit_exceeded": true,   // boolean. true if requested time period exceeds limit specified in tracker's tariff
     "list": [
        {
            "lat": 53.445181, // latitude
            "lng": -2.276432, // longitude
            "alt": 10,        // int. altitude in meters
            "satellites": 8,  // number of satellites used in fix for this point
            "get_time": "2011-06-18 03:39:44",  // GPS timestamp of the point, in user's timezone
            "address": "4B Albany Road, Manchester, Great Britain", // string. point address. "" if no addresss was recorded
            "heading": 298,   // int. bearing in degrees (0..360)
            "speed": 70,      // int. speed in km/h
            "precision": 100, // int. precision in meters, optional
            "gsm_lbs": true,  // boolean. true if location is detected by GSM LBS, optional
            "parking": true,  // boolean. true if point does not belongs to track, optional
        }, ... 
    ] 
}

errors:

  • 204 – Entity not found (if there is no tracker with such id belonging to authorized user)
  • 208 – Device blocked (if tracker exists but was blocked due to tariff restrictions or some other reason)
  • 211 – Requested time span is too big (if interval between “from” and “to” is too big (maximum value is specified in API config)

If you have more questions please contact our support team

Contacts

USA: +1 858 225 46 88

Mexico: +52 558 526 11 25

UK: +44 203 807 64 62

Russia: +7 495 128 35 56

Navixy team is heading to Latin America! Schedule a meeting with us here>>

We use сookies to improve our website, products and related services, analyze site traffic, and serve targeted advertisements. If you continue to use our services, you consent to our use of сookies. Read more

Log in