{"id":6621,"date":"2018-12-13T17:29:13","date_gmt":"2018-12-13T15:29:13","guid":{"rendered":"http:\/\/www.fmsdocumentation.com\/?page_id=6621"},"modified":"2018-12-14T09:13:00","modified_gmt":"2018-12-14T07:13:00","slug":"historia-suradnic-objektu-api","status":"publish","type":"page","link":"https:\/\/www.fmsdocumentation.com\/sk\/api\/historia-suradnic-objektu-api\/","title":{"rendered":"Hist\u00f3ria s\u00faradn\u00edc objektu API"},"content":{"rendered":"

\u00da\u010delom hist\u00f3ria s\u00faradn\u00edc API je v\u00fdstup historick\u00fdch d\u00e1t objektu klienta (s\u00faradn\u00edc). Hist\u00f3ria s\u00faradn\u00edc m\u00e1 dva koncov\u00e9 body, teda s\u00fa dva typy po\u017eiadaviek. Prv\u00fd typ po\u017eiadavky je pre objekt. Tone a ur\u010dit\u00fd d\u00e1tum a \u010das. Zobraz\u00ed sa iba d\u00e1ta zaznamenan\u00e1 v ur\u010ditom d\u00e1tume a \u010dase.<\/p>\n

Pr\u00edklad po\u017eiadavke pre ur\u010dit\u00fd d\u00e1tum:<\/p>\n

GET \/objects\/{object_id}\/coordinates\/{datetime}?version=1&api_key=<…>
\nHOST:api.fm-track.com
\nContent-Type:application\/json;charset=UTF-8<\/p>\n

Aby po\u017eiadavka Api fungoval, mus\u00ed sa \u0161pecifikova\u0165 tri parametre (okrem API_key):<\/p>\n\n\n\n\n\t\n\n\t\n\t\n\t\n\t
Parameter<\/th>Type<\/th>Description<\/th>\n<\/tr>\n<\/thead>\n
object_id<\/td>String<\/td>External object ID<\/td>\n<\/tr>\n
datetime<\/td>Date time<\/td>Requested record for the specified date and time. Date and time format example: \u201c2017-04-13T06:58:48.090Z\u201d in accordance to the ISO-8601 standard<\/td>\n<\/tr>\n
version<\/td>String<\/td>Version of the API, currently only version=1 is available<\/td>\n<\/tr>\n
api_key<\/td>String<\/td>User identification key<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n

Pozn\u00e1mka
\nOdpor\u00fa\u010da sa pou\u017ei\u0165 parameter \u010dasu d\u0148a z druh\u00e9ho koncov\u00e9ho bodu z Hist\u00f3ria s\u00faradn\u00edc objektu, preto\u017ee parameter \u010dasu d\u0148a je \u0161pecifikovan\u00fd t\u00fdm druh\u00fdm a syst\u00e9m neh\u013ead\u00e1 d\u00e1ta okolo \u0161pecifikovan\u00e9ho d\u00e1tumu.<\/span><\/p><\/p>\n

Pr\u00edklad odpovede, ke\u010f s\u00fa zahrnut\u00e9 v\u0161etky parametre a API_key je platn\u00fd:<\/p>\n

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
<\/div><\/td>
{<\/span>
\n"object_id"<\/span> :<\/span> "abc123"<\/span>,<\/span>
\n"datetime"<\/span> :<\/span> "2017-04-13T06:58:48.090Z"<\/span>,<\/span>
\n"ignition_status"<\/span> :<\/span> "UNKNOWN"<\/span>,<\/span>
\n"position"<\/span> :<\/span> {<\/span>
\n"altitude"<\/span> :<\/span> 0<\/span>,<\/span>
\n"direction"<\/span> :<\/span> 0<\/span>,<\/span>
\n"latitude"<\/span> :<\/span> 0<\/span>,<\/span>
\n"longitude"<\/span> :<\/span> 0<\/span>,<\/span>
\n"hdop"<\/span> :<\/span> 0<\/span>,<\/span>
\n"satellites_count"<\/span> :<\/span> 0<\/span>,<\/span>
\n"speed"<\/span> :<\/span> 0<\/span>
\n}<\/span>,<\/span>
\n"device_inputs"<\/span> :<\/span> {<\/span>
\n"digital_input_1"<\/span> :<\/span> true<\/span>,<\/span>
\n"digital_input_2"<\/span> :<\/span> true<\/span>,<\/span>
\n"digital_input_3"<\/span> :<\/span> true<\/span>,<\/span>
\n"digital_input_4"<\/span> :<\/span> true<\/span>,<\/span>
\n"power_supply_voltage"<\/span> :<\/span> 0<\/span>,<\/span>
\n"ibutton"<\/span> :<\/span> "xxxxxxxxxx"<\/span>,<\/span>
\n"first_driver_id"<\/span> :<\/span> "xxxxxxxxxx"<\/span>,<\/span>
\n"second_driver_id"<\/span> :<\/span> "xxxxxxxxxx"<\/span>,<\/span>
\n"temperature_sensor_0"<\/span> :<\/span> 0<\/span>,<\/span>
\n"temperature_sensor_1"<\/span> :<\/span> 0<\/span>,<\/span>
\n"temperature_sensor_2"<\/span> :<\/span> 0<\/span>,<\/span>
\n"temperature_sensor_3"<\/span> :<\/span> 0<\/span>
\n}<\/span>,<\/span>
\n"calculated_inputs"<\/span>:<\/span>{<\/span>
\n"mileage"<\/span> :<\/span> 0<\/span>
\n}<\/span>
\n}<\/span><\/div><\/td><\/tr><\/tbody><\/table><\/div>\n

Ak parameter alebo API_key bol zadan\u00fd nespr\u00e1vne, syst\u00e9m odpovie k\u00f3dom chyby. V\u0161etky chybov\u00e9 k\u00f3dy s\u00fa pop\u00edsan\u00e9 v oddiele o API. Parametre s\u00fa pop\u00edsan\u00e9 na konci tohto oddielu.<\/p>\n

Druh\u00fd koncov\u00fd bod Hist\u00f3ria API zobrazuje pole historick\u00fdch d\u00e1t pre definovan\u00e9 obdobie. Ka\u017ed\u00fd po\u010det d\u00e1t m\u00e1 ur\u010den\u00fd d\u00e1tum a \u010das, ktor\u00e9 je mo\u017en\u00e9 pou\u017ei\u0165 pri odoslan\u00ed prv\u00e9ho typu po\u017eiadavke Hist\u00f3ria API.<\/p>\n

Pr\u00edklad po\u017eiadavke pre ur\u010den\u00e9 obdobie:<\/p>\n

GET \/objects\/{object_id}\/coordinates?version=1{&from_datetime,to_datetime,continuation_token,limit}&api_key=<…>
\nHOST:api.fm-track.com
\nContent-Type:application\/json;charset=UTF-8<\/p>\n

Aby po\u017eiadavka Api fungoval, mus\u00ed sa \u0161pecifikova\u0165 tri parametre (okrem API_key):<\/p>\n\n\n\n\n\t\n\n\t\n\t\n\t\n\t
Parameter<\/th>Type<\/th>Description<\/th>\n<\/tr>\n<\/thead>\n
objectId<\/td>String<\/td>External object ID<\/td>\n<\/tr>\n
fromDatetime<\/td>Date time<\/td>Find records starting from the specified date and time. Date and time format example: \u201c2017-04-13T06:58:48.090Z\u201d in accordance to the ISO-8601 standard<\/td>\n<\/tr>\n
version<\/td>String<\/td>Version of API<\/td>\n<\/tr>\n
api_key<\/td>String<\/td>User identification key<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n

Volite\u013en\u00e9 parametre, ktor\u00e9 nie s\u00fa povinn\u00e9, ale m\u00f4\u017eu by\u0165 za\u010dlenen\u00e9 do po\u017eiadavky:<\/p>\n\n\n\n\n\t\n\n\t\n\t\n\t\n\t
Parameter<\/th>Type<\/th>Description<\/th>\n<\/tr>\n<\/thead>\n
toDatetime<\/td>Date time<\/td>Find records up until the specified date and time. If it is not specified, the system will search for records up until the current date until the limit of records is reached. Date and time format example: \u201c2017-04-13T06:58:48.090Z\u201d in accordance to the ISO-8601 standard<\/td>\n<\/tr>\n
continuationToken<\/td>Date time<\/td>Including a continuation token, will display the next set of records, after the previous limit of records was reached. <\/td>\n<\/tr>\n
limit<\/td>Integer<\/td>Limits records to the set count in the system response (default value \u2013 100 records, maximum value \u2013 1000)<\/td>\n<\/tr>\n
api_key<\/td>String<\/td>User identification code<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n

Pr\u00edklad odpovede:<\/p>\n

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
<\/div><\/td>
{<\/span>
\n"continuation_token"<\/span>:<\/span> "2017-04-13T06:58:48.121Z"<\/span>,<\/span>
\n"items"<\/span>:<\/span> [<\/span>
\n{<\/span>
\n"object_id"<\/span> :<\/span> "abc123"<\/span>,<\/span>
\n"datetime"<\/span> :<\/span> "2017-04-13T06:58:48.090Z"<\/span>,<\/span>
\n"ignition_status"<\/span> :<\/span> "UNKNOWN"<\/span>,<\/span>
\n"position"<\/span> :<\/span> {<\/span>
\n"altitude"<\/span> :<\/span> 0<\/span>,<\/span>
\n"direction"<\/span> :<\/span> 0<\/span>,<\/span>
\n"latitude"<\/span> :<\/span> 0<\/span>,<\/span>
\n"longitude"<\/span> :<\/span> 0<\/span>,<\/span>
\n"hdop"<\/span> :<\/span> 0<\/span>,<\/span>
\n"satellites_count"<\/span> :<\/span> 0<\/span>,<\/span>
\n"speed"<\/span> :<\/span> 0<\/span>
\n}<\/span>,<\/span>
\n"device_inputs"<\/span> :<\/span> {<\/span>
\n"digital_input_1"<\/span> :<\/span> true<\/span>,<\/span>
\n"digital_input_2"<\/span> :<\/span> true<\/span>,<\/span>
\n"digital_input_3"<\/span> :<\/span> true<\/span>,<\/span>
\n"digital_input_4"<\/span> :<\/span> true<\/span>,<\/span>
\n"power_supply_voltage"<\/span> :<\/span> 0<\/span>,<\/span>
\n"ibutton"<\/span> :<\/span> "xxxxxxxxxx"<\/span>,<\/span>
\n"first_driver_id"<\/span> :<\/span> "xxxxxxxxxx"<\/span>,<\/span>
\n"second_driver_id"<\/span> :<\/span> "xxxxxxxxxx"<\/span>,<\/span>
\n"temperature_sensor_0"<\/span> :<\/span> 0<\/span>,<\/span>
\n"temperature_sensor_1"<\/span> :<\/span> 0<\/span>,<\/span>
\n"temperature_sensor_2"<\/span> :<\/span> 0<\/span>,<\/span>
\n"temperature_sensor_3"<\/span> :<\/span> 0<\/span>
\n}<\/span>,<\/span>
\n"calculated_inputs"<\/span>:<\/span>{<\/span>
\n"mileage"<\/span> :<\/span> 0<\/span>
\n}<\/span>
\n}<\/span>
\n]<\/span>
\n}<\/span><\/div><\/td><\/tr><\/tbody><\/table><\/div>\n

V\u0161etky polia odpovede, ktor\u00e9 m\u00f4\u017eu by\u0165 prijat\u00e9 s ka\u017ed\u00fdm typom parametra s\u00fa pop\u00edsan\u00e9 v nasleduj\u00facej tabu\u013eke:<\/p>\n\n\n\n\n\t\n\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t\n\t
Name<\/th>Type<\/th>Description<\/th>Units<\/th>\n<\/tr>\n<\/thead>\n
continuation_token<\/td><\/td>Continuation token is received when requesting large amounts of records, for long periods, which exceeds the set records limit, the continuation token will be displayed at the end of the response. It can be used afterwards to display the next set of records for the selected period. If no more records are available after the token, the response will return empty.<\/td>Datetime<\/td>\n<\/tr>\n
device_inputs<\/td>Array<\/td>Container for parameters received from hardware<\/td><\/td>\n<\/tr>\n
calculated_inputs<\/td>Array<\/td>Container for parameters calculated in system from other parameters according to the configuration<\/td><\/td>\n<\/tr>\n
items<\/td>Array<\/td>Contains all parameters in accordance to the request<\/td><\/td>\n<\/tr>\n
object_id<\/td>String<\/td>Object identifier (external)<\/td>Text<\/td>\n<\/tr>\n
datetime<\/td>Date<\/td>Date and time point of coordinate generated in hardware
\nFormat: \"yyyy-mm-ddThh:mm:ss.sssZ\"
\n<\/td>		According ISO-8601<\/td>\n<\/tr>\n
longitude<\/td>Float<\/td>GPS coordinate - longitude value<\/td>Degrees<\/td>\n<\/tr>\n
latitude<\/td>Float<\/td>GPS coordinate - latitude value<\/td>Degrees<\/td>\n<\/tr>\n
altitude<\/td>Integer<\/td>GPS coordinate - altitude value<\/td>Number<\/td>\n<\/tr>\n
speed<\/td>Integer<\/td>Object moving speed<\/td>km\/h<\/td>\n<\/tr>\n
direction<\/td>Integer<\/td>Moving direction in degrees<\/td>0 = north, increasing clock-wise<\/td>\n<\/tr>\n
ignition_status<\/td>Enum<\/td>Indicating if object has ignition on.
\n\"ON\" - Ignition on
\n\"OFF\" - Ignition off
\n\"UNKNOWN\" - No data about ignition
\n<\/td>		ON- OFF <\/td>\n<\/tr>\n
digital_input_1<\/td>Boolean<\/td>Configurated object or its equipment status
\ntrue - status = active
\nfalse - status = inactive
\n<\/td>		True - False<\/td>\n<\/tr>\n
digital_input_2<\/td>Boolean<\/td>Configured object or its equipment status
\ntrue - status = active
\nfalse - status = inactive
\n<\/td>		True - False<\/td>\n<\/tr>\n
digital_input_3<\/td>Boolean<\/td>Configured object or its equipment status
\ntrue - status = active
\nfalse - status = inactive
\n<\/td>		True - False<\/td>\n<\/tr>\n
digital_input_4<\/td>Boolean<\/td>Configured object or its equipment status
\ntrue - status = active
\nfalse - status = inactive
\n<\/td>		True - False<\/td>\n<\/tr>\n
ibutton<\/td>String<\/td>iButton or RFID card code of a driver assigned to a vehicle<\/td>Text<\/td>\n<\/tr>\n
first_driver_id<\/td>String<\/td>TCO code of the first driver<\/td>Text<\/td>\n<\/tr>\n
second_driver_id<\/td>String<\/td>TCO code of the second driver<\/td>Text<\/td>\n<\/tr>\n
satellites_count<\/td>Integer<\/td>Number of visible GPS or GLONASS satellites(depends on device configuration) while generating record in device<\/td>Number<\/td>\n<\/tr>\n
mileage<\/td>Float<\/td>Object driven distance (depends on object configuration)<\/td>km<\/td>\n<\/tr>\n
power_supply_voltage<\/td>Integer<\/td>Object power supply voltage<\/td>mV<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n

Koncov\u00e9 body API, parametre po\u017eiadavke a odpovede mo\u017eno sledova\u0165 v “Swagger” prostredn\u00edctvom odkazu: https:\/\/api.fm-track.com<\/a><\/p>\n

\n

\u2039   <\/span> API <\/a><\/div>
Zasielanie s\u00faradn\u00edc objektu pre API  \u203a <\/span> <\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"

\u00da\u010delom hist\u00f3ria s\u00faradn\u00edc API je v\u00fdstup historick\u00fdch d\u00e1t objektu klienta (s\u00faradn\u00edc). Hist\u00f3ria s\u00faradn\u00edc m\u00e1 dva koncov\u00e9 body, teda s\u00fa dva typy po\u017eiadaviek. Prv\u00fd typ po\u017eiadavky je pre objekt. Tone a ur\u010dit\u00fd d\u00e1tum a \u010das. Zobraz\u00ed sa iba d\u00e1ta zaznamenan\u00e1 v ur\u010ditom d\u00e1tume a \u010dase. Pr\u00edklad po\u017eiadavke pre ur\u010dit\u00fd d\u00e1tum: GET \/objects\/{object_id}\/coordinates\/{datetime}?version=1&api_key=<…> HOST:api.fm-track.com Content-Type:application\/json;charset=UTF-8 Aby po\u017eiadavka … Pokra\u010dova\u0165 v \u010d\u00edtan\u00ed: Hist\u00f3ria s\u00faradn\u00edc objektu API<\/span><\/a><\/p>\n","protected":false},"author":5,"featured_media":0,"parent":6618,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-6621","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/pages\/6621","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/comments?post=6621"}],"version-history":[{"count":3,"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/pages\/6621\/revisions"}],"predecessor-version":[{"id":6681,"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/pages\/6621\/revisions\/6681"}],"up":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/pages\/6618"}],"wp:attachment":[{"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/media?parent=6621"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}