{"id":842,"date":"2017-04-21T08:16:21","date_gmt":"2017-04-21T08:16:21","guid":{"rendered":"http:\/\/www.fmsdocumentation.com\/history-api\/"},"modified":"2018-08-08T12:33:36","modified_gmt":"2018-08-08T12:33:36","slug":"history-api","status":"publish","type":"page","link":"https:\/\/www.fmsdocumentation.com\/cs\/apis\/history-api\/","title":{"rendered":"Historie sou\u0159adnic objektu API"},"content":{"rendered":"

\u00da\u010delem historie sou\u0159adnic API je v\u00fdstup historick\u00fdch dat objektu klienta (sou\u0159adnic). Historie sou\u0159adnic m\u00e1 dva koncov\u00e9 body, tud\u00ed\u017e jsou dva typy po\u017eadavk\u016f. Prvn\u00ed typ po\u017eadavku je pro objekt. Tone a ur\u010dit\u00fd datum a \u010das. Zobraz\u00ed se pouze data zaznamen\u00e1na v ur\u010dit\u00e9m datu a \u010dase.<\/p>\n

P\u0159\u00edklad po\u017eadavku pro ur\u010dit\u00fd datum:<\/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\u017eadavek Api fungoval, mus\u00ed se specifikovat\u00a0 t\u0159i parametry (krom\u011b 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
\nDoporu\u010duje se pou\u017e\u00edt parametr \u010dasu dne z druh\u00e9ho koncov\u00e9ho bodu z Historie sou\u0159adnic objektu, proto\u017ee parametr \u010dasu dne je specifikov\u00e1n t\u00edm druh\u00fdm a syst\u00e9m nehled\u00e1 data kolem spespecifikovan\u00e9ho datumu.<\/p><\/p>\n

 <\/p>\n

P\u0159\u00edklad odpov\u011bdi, kdy\u017e jsou zahrnuty v\u0161echny parametry 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

Jestli\u017ee parametr nebo API_key byl zad\u00e1n nespr\u00e1vn\u011b, syst\u00e9m odpov\u00ed chybov\u00fdm k\u00f3dem. V\u0161echny chybov\u00e9 k\u00f3dy jsou pops\u00e1ny v odd\u00edle o API. Parametry jsou pops\u00e1ny na konci tohoto odd\u00edlu.<\/p>\n

Druh\u00fd koncov\u00fd bod Historie API zobrazuje pole historick\u00fdch dat pro definovan\u00e9 obdob\u00ed. Ka\u017ed\u00e1 sada dat m\u00e1 urr\u010den\u00fd datum a \u010das, je\u017e lze pou\u017e\u00edt p\u0159i odesl\u00e1n\u00ed prvn\u00edho typu po\u017eadavku Historie API.<\/p>\n

P\u0159\u00edklad po\u017eadavku pro ur\u010den\u00e9 obdob\u00ed:<\/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\u017eadavek Api fungoval, mus\u00ed se specifikovat\u00a0 t\u0159i parametry (krom\u011b 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

Voliteln\u00e9 parametry, je\u017e nejsou povinn\u00e9, ale mohou b\u00fdt za\u010dlen\u011bny do po\u017eadavku:<\/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

P\u0159\u00edklad odpov\u011bdi:<\/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\u0161echny pole odpov\u011bdi, je\u017e mohou b\u00fdt p\u0159ijaty s ka\u017ed\u00fdm typem parametru jsou pops\u00e1ny v n\u00e1sleduj\u00edc\u00ed tabulce:<\/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

 <\/p>\n

Koncov\u00e9 body API, parametry po\u017eadavku a odpov\u011bdi lze shl\u00e9dnout v\u00a0 \u201cSwagger\u201d prost\u0159ednictv\u00edm odkazu: https:\/\/api.fm-track.com<\/a><\/p>\n

\n

\u2039   <\/span> API <\/a><\/div>
Zas\u00edl\u00e1n\u00ed sou\u0159adnic objektu pro API  \u203a <\/span> <\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"

\u00da\u010delem historie sou\u0159adnic API je v\u00fdstup historick\u00fdch dat objektu klienta (sou\u0159adnic). Historie sou\u0159adnic m\u00e1 dva koncov\u00e9 body, tud\u00ed\u017e jsou dva typy po\u017eadavk\u016f. Prvn\u00ed typ po\u017eadavku je pro objekt. Tone a ur\u010dit\u00fd datum a \u010das. Zobraz\u00ed se pouze data zaznamen\u00e1na v ur\u010dit\u00e9m datu a \u010dase. P\u0159\u00edklad po\u017eadavku pro ur\u010dit\u00fd datum: GET \/objects\/{object_id}\/coordinates\/{datetime}?version=1&api_key=<…> HOST:api.fm-track.com Content-Type:application\/json;charset=UTF-8 Aby po\u017eadavek … Pokra\u010dov\u00e1n\u00ed textu Historie sou\u0159adnic objektu API<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":843,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-842","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/pages\/842","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/comments?post=842"}],"version-history":[{"count":5,"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/pages\/842\/revisions"}],"predecessor-version":[{"id":5586,"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/pages\/842\/revisions\/5586"}],"up":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/pages\/843"}],"wp:attachment":[{"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/media?parent=842"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}