{"id":1584,"date":"2017-10-04T08:41:34","date_gmt":"2017-10-04T08:41:34","guid":{"rendered":"http:\/\/www.fmsdocumentation.com\/?page_id=1584"},"modified":"2019-07-12T10:37:35","modified_gmt":"2019-07-12T08:37:35","slug":"objektu-koordinaciu-istorijos-api","status":"publish","type":"page","link":"https:\/\/www.fmsdocumentation.com\/lt\/api\/objektu-koordinaciu-istorijos-api\/","title":{"rendered":"Objekt\u0173 koordina\u010di\u0173 istorijos API"},"content":{"rendered":"\n

Objekt\u0173 koordina\u010di\u0173 istorijos API pagrindinis tikslas yra i\u0161vesti klient\u0173 objekt\u0173 istorinius duomenis (koordinates). Objekt\u0173 koordina\u010di\u0173 istorijos API turi du galutinius ta\u0161kus, tod\u0117l yra du u\u017eklaus\u0173 tipai. Pirmasis u\u017eklausos tipas yra vienam objektui su konkre\u010dia data ir laiku. Rodomi tik duomenys, \u012fra\u0161yti nurodytu laiku.<\/p>\n\n\n\n

Konkre\u010dios datos u\u017eklausos pavyzdys:<\/p>\n\n\n\n

GET \/objects\/{object_id}\/coordinates\/{datetime}?version=1&api_key=<…>
HOST:api.fm-track.com
Content-Type:application\/json;charset=UTF-8<\/p>\n\n\n\n

\u0160iam u\u017eklausos tipui reikia trij\u0173 parametr\u0173 (neskaitant API rakto), kuriuos reikia nurodyti, kad API pra\u0161ymas veikt\u0173:<\/p>\n\n\n\n\n\n\n\t\n\n\t\n\t\n\t\n\t
Parametras<\/th>Tipas<\/th>Apra\u0161ymas<\/th>\n<\/tr>\n<\/thead>\n
object_id<\/td>Tekstas<\/td>I\u0161orinio objekto ID<\/td>\n<\/tr>\n
datetime<\/td>Data ir laikas<\/td>U\u017eklaustas konkre\u010dios datos ir laiko \u012fra\u0161as. Datos ir laiko pavyzdys pagal ISO-8601 standart\u0105: \u201c2017-04-13T06:58:48.090Z\u201d<\/td>\n<\/tr>\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

Pastaba
Rekomenduojama naudoti datetime parametr\u0105 i\u0161 antrojo objekt\u0173 koordina\u010di\u0173 istorijos API galinio ta\u0161ko, sistema neie\u0161ko duomen\u0173 aplink nurodyt\u0105 dat\u0105, o pateikia koordinat\u0119 nurodytu laiku.<\/p><\/p>\n\n\n\n

U\u017eklausos pavyzdys, kai \u012ftraukiami visi parametrai, o API raktas galiojantis: <\/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\n
Jei parametras arba API raktas \u012fvestas neteisingai, sistema pateiks klaidos kod\u0105, visi klaid\u0173 kodai apra\u0161yti API skyriuje. Parametrai apra\u0161yti \u0161io skyriaus pabaigoje.<\/p>\n\n\n\n
Antrojo istorijos API galinio ta\u0161ko atveju rodomi nurodyto laikotarpio duomenys. Kiekvienas duomen\u0173 komplektas turi nurodyt\u0105 laikotarp\u012f, kur\u012f galima naudoti siun\u010diant pirmojo tipo istorijos API u\u017eklaus\u0105.<\/p>\n\n\n\n
Konkretaus laikotarpio u\u017eklausos pavyzdys:<\/p>\n\n\n\n
GET \/objects\/{object_id}\/coordinates?version=1{&from_datetime,to_datetime,continuation_token,limit}&api_key=<…>
HOST:api.fm-track.com
Content-Type:application\/json;charset=UTF-8<\/p>\n\n\n\n
\u0160iam u\u017eklausos tipui reikia trij\u0173 parametr\u0173 (neskaitant API rakto), kuriuos reikia nurodyti, kad API u\u017eklausa veikt\u0173:<\/p>\n\n\n\n\n\n\n\t\n\n\t\n\t\n\t\n\t
Parametras<\/th>Tipas<\/th>Apra\u0161ymas<\/th>\n<\/tr>\n<\/thead>\n
objectId<\/td>Tekstas<\/td>I\u0161orinio objekto ID<\/td>\n<\/tr>\n
fromDatetime<\/td>Data ir laikas<\/td>Randa \u012fra\u0161us nuo konkre\u010dios datos ir laiko. Datos ir laiko pavyzdys pagal ISO-8601 standart\u0105: \u201c2017-04-13T06:58:48.090Z\u201d<\/td>\n<\/tr>\n
version<\/td>Tekstas<\/td>API versija<\/td>\n<\/tr>\n
api_key<\/td>Tekstas<\/td>Vartotojo identifikacinis raktas<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n\n\n
Pasirenkamieji parametrai, kurie n\u0117ra privalomi, ta\u010diau juos galima \u012fterpti \u012f u\u017eklaus\u0105:<\/p>\n\n\n\n\n\n\n\t\n\n\t\n\t\n\t\n\t
Parametras<\/th>Tipas<\/th>Apra\u0161ymas<\/th>\n<\/tr>\n<\/thead>\n
toDatetime<\/td>Data ir laikas<\/td>Randa \u012fra\u0161us iki konkre\u010dios datos ir laiko. Jei konkre\u010diai nenurodyta, sistema ie\u0161ko \u012fra\u0161\u0173 iki dabartin\u0117s datos, kol nepasiektas \u012fra\u0161\u0173 limitas. Datos ir laiko pavyzdys pagal ISO-8601 standart\u0105: \u201c2017-04-13T06:58:48.090Z\u201d<\/td>\n<\/tr>\n
continuationToken<\/td>Data ir laikas<\/td>\u012eterpia t\u0119stinumo simbol\u012f bei rodo sekant\u012f duomen\u0173 komplekt\u0105, pasiekus praeit\u0105 \u012fra\u0161\u0173 limit\u0105.<\/td>\n<\/tr>\n
limit<\/td>Sveikasis skai\u010dius<\/td>Nustato \u012fra\u0161\u0173 limit\u0105 sistemos atsakyme (numatytoji vert\u0117 - 100 \u012fra\u0161\u0173, maksimali vert\u0117 - 1000)<\/td>\n<\/tr>\n
api_key<\/td>Tekstas<\/td>Vartotojo identifikacinis kodas<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n\n\n\n
Atsakymo pavyzdys pateikiamas \u017eemiau:<\/p>\n\n\n\n
\n
{\n  \"continuation_token\": \"2017-04-13T06:58:48.121Z\",\n  \"items\": [\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    }\n  ]\n}<\/pre>\n<\/div>\n\n\n\n
Visi atsakym\u0173, kuriuos galima gauti su kiekvienu parametro tipu, laukeliai yra apra\u0161yti \u0161ioje lentel\u0117je:<\/p>\n\n\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\n\t\n\t
Parametras<\/th>Tipas<\/th>Apra\u0161ymas<\/th>Matavimo vienetai<\/th>\n<\/tr>\n<\/thead>\n
continuation_token<\/td><\/td>T\u0119stinumo simbolis gaunamas, kai u\u017eklausiamas didelis \u012fra\u0161\u0173 kiekis ilgam laikotarpiui, kuomet vir\u0161ijamas nustatytas \u012fra\u0161\u0173 limitas. Tuomet atsakymo gale rodomas t\u0119stinumo simbolis. J\u012f po to galima naudoti norint atvaizduoti sekant\u012f duomen\u0173 komplekt\u0105 pasirinktam laikotarpiui. Jei po simbolio neb\u0117ra daugiau duomen\u0173, atsakymas bus tu\u0161\u010dias<\/td>Data ir laikas<\/td>\n<\/tr>\n
items<\/td>Masyvas<\/td>Talpina visus parametrus, priklausomai nuo u\u017eklausos<\/td><\/td>\n<\/tr>\n
object_id<\/td>Tekstas<\/td>Objekto identifikatorius (i\u0161orinis)<\/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\"
\n<\/td>		Pagal ISO-8601<\/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
\n<\/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
\n<\/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
\n<\/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\n\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\n\n\n
\n\n\n
\u2039   <\/span> API <\/a><\/div>\n\n\n\n
 
\u2039   <\/span> API <\/a><\/div> 
Objekt\u0173 koordina\u010di\u0173 istorijos API v2   \u203a <\/span> <\/a><\/div> <\/p>\n","protected":false},"excerpt":{"rendered":"
Objekt\u0173 koordina\u010di\u0173 istorijos API pagrindinis tikslas yra i\u0161vesti klient\u0173 objekt\u0173 istorinius duomenis (koordinates). Objekt\u0173 koordina\u010di\u0173 istorijos API turi du galutinius ta\u0161kus, tod\u0117l yra du u\u017eklaus\u0173 tipai. Pirmasis u\u017eklausos tipas yra vienam objektui su konkre\u010dia data ir laiku. Rodomi tik duomenys, \u012fra\u0161yti nurodytu laiku. Konkre\u010dios datos u\u017eklausos pavyzdys: GET \/objects\/{object_id}\/coordinates\/{datetime}?version=1&api_key=<…>HOST:api.fm-track.comContent-Type:application\/json;charset=UTF-8 \u0160iam u\u017eklausos tipui reikia trij\u0173 parametr\u0173 … Skaityti toliau: Objekt\u0173 koordina\u010di\u0173 istorijos API<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":1582,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-1584","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.fmsdocumentation.com\/lt\/wp-json\/wp\/v2\/pages\/1584","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=1584"}],"version-history":[{"count":18,"href":"https:\/\/www.fmsdocumentation.com\/lt\/wp-json\/wp\/v2\/pages\/1584\/revisions"}],"predecessor-version":[{"id":8075,"href":"https:\/\/www.fmsdocumentation.com\/lt\/wp-json\/wp\/v2\/pages\/1584\/revisions\/8075"}],"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=1584"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}