{"id":1587,"date":"2017-10-04T08:43:34","date_gmt":"2017-10-04T08:43:34","guid":{"rendered":"http:\/\/www.fmsdocumentation.com\/?page_id=1587"},"modified":"2020-08-26T16:40:13","modified_gmt":"2020-08-26T13:40:13","slug":"objektu-koordinaciu-pateikimo-api","status":"publish","type":"page","link":"https:\/\/www.fmsdocumentation.com\/lt\/api\/objektu-koordinaciu-pateikimo-api\/","title":{"rendered":"Objekt\u0173 koordina\u010di\u0173 pateikimo API"},"content":{"rendered":"\n

\n\nObjekt\u0173 koordina\u010di\u0173 pateikimo API pagrindinis tikslas yra informuoti vartotoj\u0105 apie objekt\u0173 poky\u010dius. \u0160i API s\u0105saja veikia kaip informacijos srautas, naudojantis SSE (server sent events)<\/a> technologij\u0105. Kai vartotojas nusiun\u010dia API u\u017eklaus\u0105, pirmiausia rodomos kiekvieno objekto v\u0117liausios \u017einomos koordinat\u0117s, toliau vartotojui bus pateikiami nauji duomenys, vos tik \u012fvyksta pokytis. Pakartotinai nusi\u0173sti API u\u017eklausos neb\u016btina, nebent nutr\u016bksta srauto ry\u0161ys.\n\n<\/p>\n\n\n\n

\"\"<\/a><\/figure><\/div>\n\n\n\n

Pastaba
Kadangi API pirmiausia parodo v\u0117liausias \u017einomas koordinates, tais atvejais, kai API srautas buvo nepertraukiamas ir d\u0117l kokios nors prie\u017easties buvo pakartotinai prisijungta, vartotojas gaus v\u0117liausias \u017einomas koordinates, kurios jau buvo vien\u0105 kart\u0105 gautos. D\u0117l to atsiras koordina\u010di\u0173 \u012fra\u0161o kopija. Reik\u0117t\u0173 tai atsiminti, kadangi tai gali sukelti problem\u0173 \u012fvairiose sistemose.<\/p><\/p>\n\n\n\n

Objekt\u0173 koordina\u010di\u0173 pateikimo API sraut\u0105 galima prad\u0117ti vienam konkre\u010diam objektui arba visiems vartotojui pasiekiamiems objektams.<\/p>\n\n\n\n

Konkretaus objekto u\u017eklausos pavyzdys:<\/p>\n\n\n\n

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

\n\nVis\u0173 kliento objekt\u0173 u\u017eklausos pavyzdys:\n\n<\/p>\n\n\n\n

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

Privalomi tik du parametrai, kad veikt\u0173 API:<\/p>\n\n\n\n\n\n\n\t\n\n\t\n\t
Parametras<\/th>Tipas<\/th>Apra\u0161ymas<\/th>\n<\/tr>\n<\/thead>\n
version<\/td>Tekstas<\/td>API versija, \u0161iuo metu galima tik version=1<\/td>\n<\/tr>\n
api_key<\/td>Tekstas<\/td>Vartotojo identifikacinis raktas<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n\n\n

\u012e u\u017eklaus\u0105 galima \u012fterpti tik vien\u0105 pasirenkam\u0105 parametr\u0105:<\/p>\n\n\n\n\n\n\n\t\n\n\t
Parametras<\/th>Tipas<\/th>Apra\u0161ymas<\/th>\n<\/tr>\n<\/thead>\n
object_id<\/td>Tekstas<\/td>I\u0161orinis objekto ID<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n\n\n

Serverio atsakas:<\/p>\n\n\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\n\n
Visi atsakym\u0173, kuriuos galima gauti su kiekvienu parametro tipu, laukeliai apra\u0161yti sekan\u010dioje lentel\u0117je:<\/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
Parametras<\/th>Tipas<\/th>Apra\u0161ymas<\/th>Matavimo vienetai<\/th>\n<\/tr>\n<\/thead>\n
object_id<\/td>Tekstas<\/td>Objekto identifikatorius sistemoje<\/td>Tekstas<\/td>\n<\/tr>\n
datetime<\/td>Data ir laikas<\/td>\u012erangos sugeneruota koordina\u010di\u0173 data ir laikas
\nFormatas: \"yyyy-mm-ddThh:mm:ss.sssZ\"<\/td>		Pagal ISO8601<\/td>\n<\/tr>\n
ignition_status<\/td>Enum<\/td>Nurodo, ar objekto degimas \u012fjungtas:
\n\"ON\" - degimas \u012fjungtas 
\n\"OFF\" - degimas i\u0161jungtas
\n\"UNKNOWN\" - n\u0117ra duomen\u0173 apie degim\u0105<\/td>		ON - OFF<\/td>\n<\/tr>\n
position<\/td>Masyvas<\/td>Talpina GPS \u012fra\u0161\u0173 parametrus<\/td><\/td>\n<\/tr>\n
latitude<\/td>Slenkan\u010dio kablelio<\/td>GPS koordinat\u0117 - platumos vert\u0117<\/td>Laipsniai<\/td>\n<\/tr>\n
longitude<\/td>Slenkan\u010dio kablelio<\/td>GPS koordinat\u0117 - ilgumos vert\u0117<\/td>Laipsniai<\/td>\n<\/tr>\n
altitude<\/td>Sveikasis skai\u010dius<\/td>GPS koordinat\u0117 - auk\u0161\u010dio vert\u0117<\/td>Skai\u010dius<\/td>\n<\/tr>\n
direction<\/td>Sveikasis skai\u010dius<\/td>Jud\u0117jimo kryptis laipsniais<\/td>0 = \u0161iaur\u0117, did\u0117ja pagal laikrod\u017eio rodykl\u0119<\/td>\n<\/tr>\n
speed<\/td>Sveikasis skai\u010dius<\/td>Objekto jud\u0117jimo greitis<\/td>km\/h<\/td>\n<\/tr>\n
satellites_count<\/td>Sveikasis skai\u010dius<\/td>Matom\u0173 GPS ar GLONASS palydov\u0173 skai\u010dius (priklauso nuo prietaiso konfig\u016bracijos), prietaise vykstant \u012fra\u0161o generacijai<\/td>Skai\u010dius<\/td>\n<\/tr>\n
device_inputs<\/td>Masyvas<\/td>I\u0161 \u012frangos gaut\u0173 parametr\u0173 talpykla<\/td><\/td>\n<\/tr>\n
power_supply_voltage<\/td>Sveikasis skai\u010dius<\/td>Objekto maitinimo \u0161altinio \u012ftampa<\/td>mV<\/td>\n<\/tr>\n
ibutton<\/td>Tekstas<\/td>Vairuotojo, priskirto prie transporto priemon\u0117s, iButton arba RFID kortel\u0117s kodas<\/td>Tekstas<\/td>\n<\/tr>\n
hdop<\/td>Slenkan\u010dio kablelio<\/td>GPS koordinat\u0117s tikslumas<\/td>Skai\u010dius<\/td>\n<\/tr>\n
first_driver_id<\/td>Tekstas<\/td>Pirmojo vairuotojo tachografo kodas<\/td>Tekstas<\/td>\n<\/tr>\n
second_driver_id<\/td>Tekstas<\/td>Antrojo vairuotojo tachografo kodas<\/td>Tekstas<\/td>\n<\/tr>\n
digital_input_1<\/td>Login\u0117 reik\u0161m\u0117<\/td>Sukonfig\u016bruoto objekto ar jo \u012frangos b\u016bsena:
\ntrue - status = aktyvus 
\nfalse - status = neaktyvus<\/td>		True (Tiesa) - False (Netiesa)<\/td>\n<\/tr>\n
digital_input_2<\/td>Login\u0117 reik\u0161m\u0117<\/td>Sukonfig\u016bruoto objekto ar jo \u012frangos b\u016bsena:
\ntrue - status = aktyvus 
\nfalse - status = neaktyvus<\/td>		True (Tiesa) - False (Netiesa)<\/td>\n<\/tr>\n
digital_input_3<\/td>Login\u0117 reik\u0161m\u0117<\/td>Sukonfig\u016bruoto objekto ar jo \u012frangos b\u016bsena:
\ntrue - status = aktyvus 
\nfalse - status = neaktyvus<\/td>		True (Tiesa) - False (Netiesa)<\/td>\n<\/tr>\n
digital_input_4<\/td>Login\u0117 reik\u0161m\u0117<\/td>Sukonfig\u016bruoto objekto ar jo \u012frangos b\u016bsena:
\ntrue - status = aktyvus 
\nfalse - status = neaktyvus<\/td>		True (Tiesa) - False (Netiesa)<\/td>\n<\/tr>\n
temperature_sensor_0<\/td>Slenkan\u010dio kablelio<\/td>Temperat\u016brinio jutiklio duomenys<\/td>\u00b0C<\/td>\n<\/tr>\n
temperature_sensor_1<\/td>Slenkan\u010dio kablelio<\/td>Temperat\u016brinio jutiklio duomenys<\/td>\u00b0C<\/td>\n<\/tr>\n
temperature_sensor_2<\/td>Slenkan\u010dio kablelio<\/td>Temperat\u016brinio jutiklio duomenys<\/td>\u00b0C<\/td>\n<\/tr>\n
temperature_sensor_3<\/td>Slenkan\u010dio kablelio<\/td>Temperat\u016brinio jutiklio duomenys<\/td>\u00b0C<\/td>\n<\/tr>\n
temperature_sensor_0_id<\/td>Tekstas<\/td>Temperat\u016brinio jutiklio identifikatorius<\/td>Tekstas<\/td>\n<\/tr>\n
calculated_inputs<\/td>Masyvas<\/td>I\u0161 kit\u0173 parametr\u0173 pagal konfig\u016bracij\u0105 apskai\u010diuot\u0173 parametr\u0173 talpykla<\/td><\/td>\n<\/tr>\n
mileage<\/td>Slenkan\u010dio kablelio<\/td>Objekto nuva\u017eiuotas atstumas (priklauso nuo objekto konfig\u016bracijos)<\/td>km<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n
API rezultatus, u\u017eklaus\u0173 parametrus ir atsakymus galima per\u017ei\u016br\u0117ti \u201eSwagger\u201c programoje, naudojantis \u0161ia nuoroda: https:\/\/api.fm-track.com<\/a><\/p>\n
Pastaba
Atkreipkite d\u0117mes\u012f, kad atsakymas i\u0161 serverio yra srautas duomen\u0173, kurie gaunami i\u0161 prietaiso. Visi gauti duomenys yra pateikiami tokie, kokie jie yra. Tai rei\u0161kia, kad tarp dabartin\u0117s pad\u0117ties \u012fra\u0161\u0173 prietaisas gali periodi\u0161kai si\u0173sti ankstesn\u0117s pad\u0117ties koordinates. API netikrina ir netvarko gaunam\u0173 duomen\u0173 t\u0119stinumo.<\/p><\/p>\n
\n
\u2039   <\/span> Objekt\u0173 koordina\u010di\u0173 istorijos API v3 <\/a><\/div> 
Objekt\u0173 koordina\u010di\u0173 pateikimo API v2   \u203a <\/span> <\/a><\/div><\/p>","protected":false},"excerpt":{"rendered":"
Objekt\u0173 koordina\u010di\u0173 pateikimo API pagrindinis tikslas yra informuoti vartotoj\u0105 apie objekt\u0173 poky\u010dius. \u0160i API s\u0105saja veikia kaip informacijos srautas, naudojantis SSE (server sent events) technologij\u0105. Kai vartotojas nusiun\u010dia API u\u017eklaus\u0105, pirmiausia rodomos kiekvieno objekto v\u0117liausios \u017einomos koordinat\u0117s, toliau vartotojui bus pateikiami nauji duomenys, vos tik \u012fvyksta pokytis. Pakartotinai nusi\u0173sti API u\u017eklausos neb\u016btina, nebent nutr\u016bksta srauto ry\u0161ys. … Skaityti toliau: Objekt\u0173 koordina\u010di\u0173 pateikimo API<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":1582,"menu_order":3,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-1587","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.fmsdocumentation.com\/lt\/wp-json\/wp\/v2\/pages\/1587","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.fmsdocumentation.com\/lt\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.fmsdocumentation.com\/lt\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/lt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/lt\/wp-json\/wp\/v2\/comments?post=1587"}],"version-history":[{"count":14,"href":"https:\/\/www.fmsdocumentation.com\/lt\/wp-json\/wp\/v2\/pages\/1587\/revisions"}],"predecessor-version":[{"id":8080,"href":"https:\/\/www.fmsdocumentation.com\/lt\/wp-json\/wp\/v2\/pages\/1587\/revisions\/8080"}],"up":[{"embeddable":true,"href":"https:\/\/www.fmsdocumentation.com\/lt\/wp-json\/wp\/v2\/pages\/1582"}],"wp:attachment":[{"href":"https:\/\/www.fmsdocumentation.com\/lt\/wp-json\/wp\/v2\/media?parent=1587"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}