{"id":6624,"date":"2018-12-13T17:31:15","date_gmt":"2018-12-13T15:31:15","guid":{"rendered":"http:\/\/www.fmsdocumentation.com\/?page_id=6624"},"modified":"2018-12-14T09:13:25","modified_gmt":"2018-12-14T07:13:25","slug":"zasielanie-suradnic-objektu-pre-api","status":"publish","type":"page","link":"https:\/\/www.fmsdocumentation.com\/sk\/api\/zasielanie-suradnic-objektu-pre-api\/","title":{"rendered":"Zasielanie s\u00faradn\u00edc objektu pre API"},"content":{"rendered":"

Zasielanie s\u00faradn\u00edc objektov pre API informuje u\u017e\u00edvate\u013ea o zmen\u00e1ch objektu. Toto konkr\u00e9tne API funguje ako pr\u00fad inform\u00e1ci\u00ed. Po odoslan\u00ed po\u017eiadavky API sa najprv zobraz\u00ed posledn\u00e1 zn\u00e1ma s\u00faradnice ka\u017ed\u00e9ho objektu, potom akon\u00e1hle nastane zmena bud\u00fa odosielan\u00e9 nov\u00e9 d\u00e1ta. Pokia\u013e ned\u00f4jde k preru\u0161eniu spojenia, nie je nutn\u00e9 posiela\u0165 nov\u00fa po\u017eiadavku API.
\n\"\"<\/a><\/p>\n

Pozn\u00e1mka
\nPotom \u010do API vr\u00e1ti posledn\u00fa zn\u00e1mu s\u00faradnicu a nastane situ\u00e1cia, \u017ee zasielanie s\u00faradn\u00edc bolo z nejak\u00e9ho d\u00f4vodu znovuobnovenie a v medzi\u010dase nie s\u00fa \u017eiadne nov\u00e9 s\u00faradnice, u\u017e\u00edvate\u013e dostane posledn\u00fa zn\u00e1mu s\u00faradnicu, ktor\u00fa u\u017e raz dostal a z\u00e1znam je tak duplicitn\u00e9. Treba to vedie\u0165, preto\u017ee v niektor\u00fdch syst\u00e9moch to m\u00f4\u017ee sp\u00f4sobi\u0165 probl\u00e9my.<\/p><\/p>\n

Zasielanie s\u00faradn\u00edc objektu pre API mo\u017eno aktivova\u0165 pre jeden konkr\u00e9tny objekt alebo pre v\u0161etky dostupn\u00e9 objekty u\u017e\u00edvate\u013ea.<\/p>\n

Pr\u00edklad po\u017eiadavke pre 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

Pr\u00edklad po\u017eiadavke pre v\u0161etky 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 s\u00fa povinn\u00e9 dva parametre:<\/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\u017eiadavky mo\u017eno v\u010dleni\u0165 iba jeden volite\u013en\u00fd parameter:<\/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

Odpove\u010f servera:<\/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

V\u0161etky zodpovedn\u00ed polia ktor\u00e9 mo\u017eno prija\u0165 s ka\u017ed\u00fdm tapom 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
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

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

Pozn\u00e1mka
\nJe potrebn\u00e9 si uvedomi\u0165, \u017ee odpove\u010f servera je pr\u00fad d\u00e1t, rovnak\u00fdch d\u00e1t, ktor\u00e9 prich\u00e1dzaj\u00fa od objektov. V\u0161etky prij\u00edman\u00e9 d\u00e1ta s\u00fa poskytovan\u00e9 “ako s\u00fa”. To znamen\u00e1, \u017ee jednotka m\u00f4\u017ee periodicky posiela\u0165 s\u00faradnice predch\u00e1dzaj\u00facej poz\u00edcie medzi z\u00e1znamami aktu\u00e1lnej poz\u00edcie. API nekontroluje a neriadi kontinuitu prij\u00edman\u00fdch d\u00e1t.<\/p><\/p>\n

\n

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

Zasielanie s\u00faradn\u00edc objektov pre API informuje u\u017e\u00edvate\u013ea o zmen\u00e1ch objektu. Toto konkr\u00e9tne API funguje ako pr\u00fad inform\u00e1ci\u00ed. Po odoslan\u00ed po\u017eiadavky API sa najprv zobraz\u00ed posledn\u00e1 zn\u00e1ma s\u00faradnice ka\u017ed\u00e9ho objektu, potom akon\u00e1hle nastane zmena bud\u00fa odosielan\u00e9 nov\u00e9 d\u00e1ta. Pokia\u013e ned\u00f4jde k preru\u0161eniu spojenia, nie je nutn\u00e9 posiela\u0165 nov\u00fa po\u017eiadavku API. Pozn\u00e1mka Potom \u010do API vr\u00e1ti posledn\u00fa … Pokra\u010dova\u0165 v \u010d\u00edtan\u00ed: Zasielanie s\u00faradn\u00edc objektu pre API<\/span><\/a><\/p>\n","protected":false},"author":5,"featured_media":0,"parent":6618,"menu_order":3,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-6624","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/pages\/6624","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=6624"}],"version-history":[{"count":3,"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/pages\/6624\/revisions"}],"predecessor-version":[{"id":6682,"href":"https:\/\/www.fmsdocumentation.com\/sk\/wp-json\/wp\/v2\/pages\/6624\/revisions\/6682"}],"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=6624"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}