{"id":15031,"date":"2025-05-29T13:27:50","date_gmt":"2025-05-29T10:27:50","guid":{"rendered":"https:\/\/www.fmsdocumentation.com\/api-za-strujanje-koordinata-objekata\/"},"modified":"2025-05-29T13:27:54","modified_gmt":"2025-05-29T10:27:54","slug":"api-za-strujanje-koordinata-objekata","status":"publish","type":"page","link":"https:\/\/www.fmsdocumentation.com\/hr\/apis\/api-za-strujanje-koordinata-objekata\/","title":{"rendered":"API za strujanje koordinata objekata"},"content":{"rendered":"\n

\n\nGlavna svrha API-ja za strujanje koordinata objekata je informiranje korisnika o promjenama objekata. Ovaj API radi kao strujanje informacija koriste\u0107i SSE (server sent events – doga\u0111aji poslani od strane poslu\u017eitelja)<\/a> . Nakon \u0161to korisnik po\u0161alje API zahtjev, prvo se prikazuje posljednja poznata koordinata za svaki objekt, a nakon toga \u0107e se korisniku poslati novi podaci \u010dim do\u0111e do promjene. Nema potrebe za ponovnim slanjem API zahtjeva osim ako je strujna veza prekinuta. \n\n<\/p>\n\n

\"Ova<\/figure>\n\n

Bilje\u0161ka Budu\u0107i da API prvo vra\u0107a posljednju poznatu koordinatu, u slu\u010dajevima kada je API stream bio u tijeku i iz nekog razloga ponovno povezan, bez primljenih novih koordinata izme\u0111u tog vremena, korisnik \u0107e primiti posljednju poznatu koordinatu, koja je ve\u0107 jednom primljena, \u010dime se duplicira zapis koordinata. To treba imati na umu, jer mo\u017ee uzrokovati probleme u raznim sustavima. <\/p><\/p>\n\n

Streaming API-ja za koordinate objekata mo\u017ee se pokrenuti za jedan odre\u0111eni objekt ili za sve korisniku dostupne objekte.<\/p>\n\n

Primjer zahtjeva za odre\u0111eni objekt:<\/p>\n\n

GET \/object-coordinates-stream?version=1&object_id= <...>&api_key= <...>DOMA\u0106IN: api.fm-track.com Vrsta sadr\u017eaja: tekst\/tok doga\u0111aja; skup znakova=UTF-8<\/p>\n\n

\n\nPrimjer zahtjeva za sve klijentske objekte:\n\n<\/p>\n\n

GET \/object-coordinates-stream?version=1&api_key= <...>DOMA\u0106IN: api.fm-track.com Vrsta sadr\u017eaja: tekst\/tok doga\u0111aja; skup znakova=UTF-8<\/p>\n\n

Da bi ovaj API radio, obavezna su samo dva parametra:<\/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\n

I u zahtjevu se mo\u017ee uklju\u010diti samo jedan opcionalni parametar:<\/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\n

Odgovor s poslu\u017eitelja:<\/p>\n\n

\n
{\n    \"object_id\" : \"abc123\",\n    \"datetime\" : \"2017-04-13T06:58:48.090Z\",\n    \"ignition_status\" : \"UNKNOWN\",\n    \"position\" : {\n        \"altitude\" : 0,\n        \"direction\" : 0,\n        \"latitude\" : 0,\n        \"longitude\" : 0,\n        \"hdop\": 0,\n        \"satellites_count\" : 0,\n        \"speed\" : 0\n    },\n    \"device_inputs\" : {\n        \"digital_input_1\" : true,\n        \"digital_input_2\" : true,\n        \"digital_input_3\" : true,\n        \"digital_input_4\" : true,\n        \"power_supply_voltage\" : 0,\n        \"ibutton\" : \"xxxxxxxxxx\",\n        \"first_driver_id\" : \"xxxxxxxxxx\",\n        \"second_driver_id\" : \"xxxxxxxxxx\",\n         \"temperature_sensor_0\": 0,\n         \"temperature_sensor_1\": 0,\n         \"temperature_sensor_2\": 0,\n         \"temperature_sensor_3\": 0,\n         \"temperature_sensor_0_id\": \"xxxxxxxxxx\"\n    },\n    \"calculated_inputs\":{\n        \"mileage\" : 0\n    }\n}<\/pre>\n<\/div>\n
Sva polja odgovora koja se mogu primiti sa svakom vrstom parametra opisana su u sljede\u0107oj tablici:<\/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\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
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
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
position<\/td>Array<\/td>Contains all record GPS parameters<\/td><\/td>\n<\/tr>\n
latitude<\/td>Float<\/td>GPS coordinate - latitude value<\/td>Degrees<\/td>\n<\/tr>\n
longitude<\/td>Float<\/td>GPS coordinate - longitude value<\/td>Degrees<\/td>\n<\/tr>\n
altitude<\/td>Integer<\/td>GPS coordinate - altitude value<\/td>Number<\/td>\n<\/tr>\n
direction<\/td>Integer<\/td>Moving direction in degrees<\/td>0 = north, increasing clock-wise<\/td>\n<\/tr>\n
speed<\/td>Integer<\/td>Object moving speed<\/td>km\/h<\/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
device_inputs<\/td>Container for parameters received from hardware<\/td><\/td><\/td>\n<\/tr>\n
power_supply_voltage<\/td>Integer<\/td>Object power supply voltage<\/td>mV<\/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
hdop<\/td>Float<\/td>GPS precision<\/td>Number<\/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
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
temperature_sensor_0<\/td>Float<\/td>Temperature sensor data<\/td>\u00b0C<\/td>\n<\/tr>\n
temperature_sensor_1<\/td>Float<\/td>Temperature sensor data<\/td>\u00b0C<\/td>\n<\/tr>\n
temperature_sensor_2<\/td>Float<\/td>Temperature sensor data<\/td>\u00b0C<\/td>\n<\/tr>\n
temperature_sensor_3<\/td>Float<\/td>Temperature sensor data<\/td>\u00b0C<\/td>\n<\/tr>\n
temperature_sensor_0_id<\/td>String<\/td>Temperature sensor ID<\/td>Text<\/td>\n<\/tr>\n
calculated_inputs<\/td>Array<\/td><\/td><\/td>\n<\/tr>\n
mileage<\/td>float<\/td>Object driven distance (depends on object configuration)<\/td>km<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n
API krajnje to\u010dke, parametri zahtjeva i odgovori mogu se pregledati u \u201eSwaggeru\u201d putem ove poveznice: https:\/\/api.fm-track.com<\/a><\/p>\n
Bilje\u0161ka
 Imajte na umu da je odgovor poslu\u017eitelja tok podataka, isti podaci koji su primljeni s ure\u0111aja. Svi primljeni podaci pru\u017eaju se \u201ekakvi jesu\u201d. To zna\u010di da ure\u0111aj mo\u017ee periodi\u010dki slati koordinate prethodne pozicije izme\u0111u zapisa trenutne pozicije. API ne provjerava niti upravlja kontinuitetom primljenih podataka.   <\/p><\/p>\n
\n
\u2039   <\/span> API za povijest koordinata objekata v2 <\/a><\/div> 
API za strujanje koordinata objekata v2   \u203a <\/span> <\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"
Glavna svrha API-ja za strujanje koordinata objekata je informiranje korisnika o promjenama objekata. Ovaj API radi kao strujanje informacija koriste\u0107i SSE (server sent events – doga\u0111aji poslani od strane poslu\u017eitelja) . Nakon \u0161to korisnik po\u0161alje API zahtjev, prvo se prikazuje posljednja poznata koordinata za svaki objekt, a nakon toga \u0107e se korisniku poslati novi podaci … Continue reading API za strujanje koordinata objekata<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":15069,"menu_order":3,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-15031","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.fmsdocumentation.com\/hr\/wp-json\/wp\/v2\/pages\/15031","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.fmsdocumentation.com\/hr\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.fmsdocumentation.com\/hr\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/hr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/hr\/wp-json\/wp\/v2\/comments?post=15031"}],"version-history":[{"count":1,"href":"https:\/\/www.fmsdocumentation.com\/hr\/wp-json\/wp\/v2\/pages\/15031\/revisions"}],"predecessor-version":[{"id":15043,"href":"https:\/\/www.fmsdocumentation.com\/hr\/wp-json\/wp\/v2\/pages\/15031\/revisions\/15043"}],"up":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/hr\/wp-json\/wp\/v2\/pages\/15069"}],"wp:attachment":[{"href":"https:\/\/www.fmsdocumentation.com\/hr\/wp-json\/wp\/v2\/media?parent=15031"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}