{"id":841,"date":"2017-04-21T08:34:44","date_gmt":"2017-04-21T08:34:44","guid":{"rendered":"http:\/\/www.fmsdocumentation.com\/status-api\/"},"modified":"2018-08-08T12:35:16","modified_gmt":"2018-08-08T12:35:16","slug":"status-api","status":"publish","type":"page","link":"https:\/\/www.fmsdocumentation.com\/cs\/apis\/status-api\/","title":{"rendered":"Zas\u00edl\u00e1n\u00ed sou\u0159adnic objektu pro API"},"content":{"rendered":"

Zas\u00edl\u00e1n\u00ed sou\u0159adnic objekt\u016f pro API informuje u\u017eivatele o zm\u011bn\u00e1ch objektu. Toto konkr\u00e9tn\u00ed API funguje jako proud informac\u00ed. Po odesl\u00e1n\u00ed po\u017eadavku API se nejprve zobraz\u00ed posledn\u00ed zn\u00e1ma sou\u0159adnice ka\u017ed\u00e9ho objektu, potom jakmile nastane zm\u011bna budou odes\u00edl\u00e1na nov\u00e1 data.\u00a0\u00a0 Pokud nedojde k p\u0159eru\u0161en\u00ed spojen\u00ed, nen\u00ed nutno pos\u00edlat nov\u00fd po\u017eadavek API. \"\"<\/a><\/p>\n

Pozn\u00e1mka
\nPot\u00e9 co API vr\u00e1t\u00ed posledn\u00ed zn\u00e1mou sou\u0159adnici a nastane situace, \u017ee zas\u00edl\u00e1n\u00ed sou\u0159adnic bylo z n\u011bjak\u00e9ho d\u016fvodu znovuobnoveno a v mezi\u010dase nedo\u0161ly \u017e\u00e1dn\u00e9 nov\u00e9 sou\u0159adnice, u\u017eivatel obdr\u017e\u00ed posledn\u00ed zn\u00e1mou sou\u0159adnici, kterou ji\u017e jednou obdr\u017eel a z\u00e1znam je tak duplicitn\u00ed. Je t\u0159eba to v\u011bd\u011bt, proto\u017ee v n\u011bkter\u00fdch syst\u00e9mech to m\u016f\u017ee p\u016fsobit probl\u00e9my.<\/p><\/p>\n

Zas\u00edl\u00e1n\u00ed sou\u0159adnic objektu pro API lze aktivovat pro jeden konkr\u00e9tn\u00ed objekt nebo pro v\u0161echny dostupn\u00e9 objekty u\u017eivatele.<\/p>\n

P\u0159\u00edklad po\u017eadavku pro jeden objekt:<\/p>\n

GET \/object-coordinates-stream?version=1&object_id=<…>&api_key=<…>
\nHOST:api.fm-track.com
\nContent-Type:text\/event-stream;charset=UTF-8<\/p>\n

P\u0159\u00edklad po\u017eadavku pro v\u0161echny objekty:<\/p>\n

GET \/object-coordinates-stream?version=1&api_key=<…>
\nHOST:api.fm-track.com
\nContent-Type:text\/event-stream;charset=UTF-8<\/p>\n

Aby toto API fungovalo jsou povinn\u00e9 dva parametry:<\/p>\n\n\n\n\n\t\n\n\t\n\t
Parameter<\/th>Type<\/th>Description<\/th>\n<\/tr>\n<\/thead>\n
version<\/td>String<\/td>Version of the API, currently only version=1 is available<\/td>\n<\/tr>\n
api_key<\/td>User identification key<\/td><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n

Do po\u017eadavku lze v\u010dlenit pouze jeden voliteln\u00fd parametr:<\/p>\n\n\n\n\n\t\n\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<\/tbody>\n<\/table>\n\n

Odpov\u011b\u010f serveru:
\n<\/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>
data:<\/span>{<\/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

<\/span><\/strong>
\nV\u0161echna odpov\u011bdn\u00ed pole kter\u00e1 lze p\u0159ijmout s ka\u017ed\u00fdm tapem 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
Name<\/th>Type<\/th>Description<\/th>Units<\/th>\n<\/tr>\n<\/thead>\n
object_id<\/td>String<\/td>Object identifier in our system<\/td>Text<\/td>\n<\/tr>\n
device_inputs<\/td>Container for parameters received from hardware<\/td><\/td><\/td>\n<\/tr>\n
calculated_inputs<\/td>Container for parameters calculated in system from other parameters according configuration<\/td><\/td><\/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 ISO8601<\/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>Configured 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\u017eadavk\u016f a odpov\u011bdi lze zhl\u00e9dnout v\u00a0 \u201cSwagger\u201d prost\u0159ednictv\u00edm odkazu: https:\/\/api.fm-track.com<\/a><\/p>\n

Pozn\u00e1mka
\nJe t\u0159eba si uv\u011bdomit, \u017ee odpov\u011b\u010f serveru je proud dat, stejn\u00fdch dat, je\u017e p\u0159ich\u00e1zej\u00ed od objekt\u016f.\u00a0 V\u0161echna p\u0159ij\u00edm\u00e1na data jsou poskytov\u00e1na “jak jsou”. To znamen\u00e1, \u017ee jednotka m\u016f\u017ee periodicky pos\u00edlat sou\u0159adnice p\u0159edchoz\u00ed pozice mezi z\u00e1znamy aktu\u00e1ln\u00ed pozice. API nekontroluje a ne\u0159\u00edd\u00ed kontinuitu p\u0159ij\u00edman\u00fdch dat.<\/p><\/p>\n

\n

\u2039   <\/span> Historie sou\u0159adnic objektu API <\/a><\/div>
Objekt API  \u203a <\/span> <\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"

Zas\u00edl\u00e1n\u00ed sou\u0159adnic objekt\u016f pro API informuje u\u017eivatele o zm\u011bn\u00e1ch objektu. Toto konkr\u00e9tn\u00ed API funguje jako proud informac\u00ed. Po odesl\u00e1n\u00ed po\u017eadavku API se nejprve zobraz\u00ed posledn\u00ed zn\u00e1ma sou\u0159adnice ka\u017ed\u00e9ho objektu, potom jakmile nastane zm\u011bna budou odes\u00edl\u00e1na nov\u00e1 data.\u00a0\u00a0 Pokud nedojde k p\u0159eru\u0161en\u00ed spojen\u00ed, nen\u00ed nutno pos\u00edlat nov\u00fd po\u017eadavek API. Pozn\u00e1mka Pot\u00e9 co API vr\u00e1t\u00ed posledn\u00ed zn\u00e1mou … Pokra\u010dov\u00e1n\u00ed textu Zas\u00edl\u00e1n\u00ed sou\u0159adnic objektu pro API<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":843,"menu_order":3,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-841","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/pages\/841","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=841"}],"version-history":[{"count":3,"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/pages\/841\/revisions"}],"predecessor-version":[{"id":5588,"href":"https:\/\/www.fmsdocumentation.com\/cs\/wp-json\/wp\/v2\/pages\/841\/revisions\/5588"}],"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=841"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}