Contact us Login VIEW DEMO FREE TRIAL

list(…)


Get a list of track descriptions for the specified tracker and time period.
parameters:

name description type
tracker_id Id of the tracker (aka “object_id”). Tracker must belong to authorized user and must not be blocked. int
from A string containing date/time in “yyyy-MM-dd HH:mm:ss” format (in user’s timezone) String
to A string containing date/time in “yyyy-MM-dd HH:mm:ss” format (in user’s timezone). Specified date must be after “from” date String
filter (optional, default=true) If true, tracks which are too short (in terms of length and number of points) will be omitted from resulting list. boolean
split (optional, default=true) If false, all tracks will be merged into single one. boolean

return:

[php]
{
"success": true,
"list": [ <track_info>, … ] //list of zero or more JSON objects
}
[/php]

where <track_info> is either <regular>, <single_report> or <merged>:

[php]
<regular> =
{
"id": <track id>, //int
"start_date": <track start date, in users timezone i.e.&quot;2011-06-18 03:39:44&quot;&gt;, //string
&quot;start_address&quot;: &lt;track start address&gt;, //string
&quot;max_speed&quot;: &lt;maximum speed in km/h, i.e. 96&gt;, //int
&quot;end_date&quot;: &lt;track end date, in user
s timezone i.e."2011-06-18 05:18:36">, //string
"end_address": <track end address>, //string
"length": <track length in kilometers, i.e. 85.5>, //float
"points": <total number of points in track, i.e. 724>, //int
"avg_speed": <average speed in km/h, i.e. 70>, //int
"type": "regular" //used to distinguish this track type from the others
}

&lt;single_report&gt; = //returned if device was creating reports in &quot;interval&quot; mode (i.e. M7 tracker in interval mode)
{
    &quot;id&quot;: &lt;track id&gt;, //int
    &quot;type&quot;: &quot;single_report&quot;, //used to distinguish this track type from the others
    &quot;start_date&quot;: &lt;point creation date in user`s timezone i.e. &quot;2011-06-16 15:35:01&quot;&gt;,
    &quot;start_address&quot;: &lt;point address&gt;, //string
    &quot;avg_speed&quot;: &lt;point speed in km/h, i.e. 34&gt;  //int
}

&lt;merged&gt; =   //only returned if &quot;split&quot; is set to &quot;false&quot;
{
    &quot;start_date&quot;: &lt;track start date, in user`s timezone i.e.&quot;2011-06-18 03:39:44&quot;&gt;,  //string
    &quot;start_address&quot;: &lt;track start address&gt;, //string
    &quot;max_speed&quot;: &lt;maximum speed in km/h, i.e. 96&gt;, //int
    &quot;end_date&quot;: &lt;track end date, in user`s timezone i.e.&quot;2011-06-18 05:18:36&quot;&gt;,  //string
    &quot;end_address&quot;: &lt;track end address&gt;, //string
    &quot;length&quot;: &lt;track length in kilometers, i.e. 85.5&gt;, //float
    &quot;points&quot;: &lt;total number of points in track, i.e. 724&gt;,  //int
    &quot;avg_speed&quot;: &lt;average speed in km/h, i.e. 70&gt;,  //int
    &quot;type&quot;: &quot;merged&quot;  //used to distinguish this track type from the others
}

[/php]

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 815 9045

Mexico: +52 334 1642158

UK: +44 808 1641499

Germany: +49 1573 5988250

Russia: +7 495 223 0427

Log in

Login

[clean-login]

CLOSE
Register

[clean-login-register]

CLOSE
Loading...