El akarja hagyni a weboldalunkat anélkül, hogy elolvasta volna a 10 praktikus tippet, hogy hogyan spórolhat a járműflottán?
Adja meg az email címét és mi elküldjük az ebook-ot a későbbi elolvasásra.
GPS Dozor JSON API webszolgáltatás dokumentációja. Az API-nak köszönhetően valós időben hozzáférhet az adatokhoz.
Az API elérhető a https://a1.gpsguard.eu/api/v1/ címen
A bejelentkezési adatok ugyanazok, mint a rendszerbe való bejelentkezésnél. A Basic authentication a HTTPS protokollt használja.
Demo belépés kipróbálása:
Login: api_gpsdozor
Jelszó: yakmwlARdn
1) Elérhető csoportok lekérdezése
Visszaadja azoknak a csoportoknak a listáját, amelyekhez a felhasználónak jogai vannak.
[{"Code":"SAGU","Name":"GPS Dozor - DEMO"}]2) A csoportban lévő járművek listájának lekérdezése
https://a1.gpsguard.eu/api/v1/vehicles/group/<group code>például.: https://a1.gpsguard.eu/api/v1/vehicles/group/SAGU
Visszaadja a járművek listáját, nevüket, rendszámukat, az akkumulátor állapotát (0, ha az akkumulátor nincs használatban), sebességüket, GPS-pozíciójukat és az utolsó válaszadási időt (UTC).
[{ "Code": "CELIRASUME", "GroupCode": "SATD", "BranchId": "51", "BranchName": "Pobocka 1", "Name": "Mercedes-Benz", "SPZ": "4EG 34-55", "BatteryPercentage": 0, "Speed": 86, "LastPosition": { "Latitude": "49.768475", "Longitude": "13.649925" }, "LastPositionTimestamp": "2018-02-09T15:25:34Z", "LastEngineRelayEvent": "2018-02-01T00:00:00Z", "EngineRelayState": 0, "Odometer": 332969827},{ "Code": "OBEHEHUGOV", "GroupCode": "SATD", "Name": "Package", "SPZ": "", "BatteryPercentage": 0, "Speed": 106, "LastPosition": { "Latitude": "43.664915", "Longitude": "-97.760474" }, "LastPositionTimestamp": "2018-02-09T15:26:11Z", "LastEngineRelayEvent": "2018-02-01T00:00:00Z", "EngineRelayState": 0, "Odometer": 332969827},...]3) Aktuális információk beszerzése a járműről
https://a1.gpsguard.eu/api/v1/vehicle/<vehicle code>például.: https://a1.gpsguard.eu/api/v1/vehicle/ZODIDOZEBU
Vissza a jármű aktuális adataihoz.
{ "Code": "ZODIDOZEBU", "GroupCode": "SATD", "BranchId": "51", "BranchName": "Pobocka 1", "Name": "Mercedes-Benz", "SPZ": "4EG 34-55", "BatteryPercentage": 0, "Speed": 4, "LastPosition": { "Latitude": "49.7581", "Longitude": "13.617875" }, "LastPositionTimestamp": "2018-02-09T15:27:51Z", "Odometer": 332969827}4) A jármű múltbéli pozícióinak lekérése
https://a1.gpsguard.eu/api/v1/vehicles/history/<coma separated vehicle codes>?from=<date+time from>&to=<date+time to>Vissza a kiválasztott intervallum pozícióinak listájához.
[{ "Name": "MAN", "VehicleCode": "ZODIDOZEBU", "From": "2017-07-19T22:00:00Z", "To": "2017-07-20T22:00:00Z", "Positions": [{ "Lat": "49.429325", "Lng": "12.012025", "Time": "2017-07-19T22:00:04Z", "Speed": 84 }, { "Lat": "49.425525", "Lng": "12.0049", "Time": "2017-07-19T22:00:31Z", "Speed": 90 }, }, { "Lat": "49.422525", "Lng": "12.0003", "Time": "2017-07-19T22:00:51Z", "Speed": 83 }, ... { "Lat": "49.3991", "Lng": "11.936325", "Time": "2017-07-19T22:05:11Z", "Speed": 82 }]}]5) Útnyilvántartás előzmények lekérdezése (napló/útnyilvántartás)
https://a1.gpsguard.eu/api/v1/vehicle/<vehicle code>/trips?from=<date+time from>&to=<date+time to>például.: https://a1.gpsguard.eu/api/v1/vehicle/ZODIDOZEBU/trips?from=2018-05-20T00:00&to=2018-05-21T00:00
Listázza a jármű útjait a kiválasztott időszakra vonatkozó részletes információkkal. Átlagsebesség, maximális sebesség, út típusa, út kezdete/vége, út kezdetének/végének a pozíciója, út kezdetének/végének a címe, menetidő, állásidő, út hossza.
[{ "AverageSpeed": 74, "MaxSpeed": 98, "TripType": false, "StartTime": "2017-07-20T01:19:19", "FinishTime": "2017-07-20T03:46:53", "StartPosition": { "Latitude": "49.174525", "Longitude": "9.9951" }, "FinishPosition": { "Latitude": "49.4903", "Longitude": "7.954725" }, "StartAddress": "", "FinishAddress": "", "TripLength":" 02:27", "TripWaitingTime": "00:00", "TotalDistance": 181.274},{ "AverageSpeed": 81, "MaxSpeed": 99, "TripType": false, "StartTime": "2017-07-20T03:51:17", "FinishTime": "2017-07-20T05:18:25", "StartPosition": { "Latitude": "49.490175", "Longitude": "7.954" }, "FinishPosition": { "Latitude": "49.13425", "Longitude": "6.546075" }, "StartAddress": "", "FinishAddress": "", "TripLength":" 01:27", "TripWaitingTime": "00:00", "TotalDistance": 118.021 "DriverName": "Doe, John", "DriverChipCode": "", "Odometer": 2000, "FuelConsumed": { "Value": 0.12141838466142181, "VolumeUnit": 0 }, "TripCost": { "Value":1.45702061593706400, "Currency": 0 }},...]Felsorolt típusértékek:
VolumeUnit{ Litre = 0, UsGallon = 1, UkGallon = 2}Currency{ CZK = 0, EUR = 1, USD = 2, PLN = 3, HUF = 4, BGN = 5, BRL = 6, BYR = 7, CAD = 8, CHF = 9, ...}6) Információt nyerni a járműmegállítás állapotára vonatkozóan
https://a1.gpsguard.eu/api/v1/vehicle//getEngineRelayStatepéldául.: https://a1.gpsguard.eu/api/v1/vehicle/ZODIDOZEBU/getEngineRelayState
Információ a járműmegállítás állapotára vonatkozóan
{ "RelayState": 0, "LastEventTimestamp": "2018-04-23T16:17:31.0621104+02:00"}Állapotértékek:
0 - kezdeti állapot1 - leállítási kérelem elküldve, de nincs megerősítve2 - a jármű megállítására vonatkozó kérelem elküldve, a rendszer megerősítette3 - leállítási kérelem törlése elküldve, de nincs megerősítve4 - a jármű megállítására vonatkozó kérelem elküldve, a rendszer megerősítette5 - a járművet nem lehet megállítani, a kérelmet elutasították vagy késleltették7) A jármű megállási állapotának beállítása
https://a1.gpsguard.eu/api/v1/vehicle//setEngineRelayState/<on or off>például.: https://a1.gpsguard.eu/api/v1/vehicle/ZODIDOZEBU/setEngineRelayState/offa jármű megállítására vonatkozó kérelmet küld a készüléknek
vagy
https://a1.gpsguard.eu/api/v1/vehicle/ZODIDOZEBU/setEngineRelayState/ona jármű megállítására vonatkozó kérelem törlését küldi a készüléknek
Aktuális információt a járműmegállítás állapotára vonatkozóan
{ "RelayState": 1, "LastEventTimestamp": "2018-04-23T16:17:31.0621104+02:00"}Megjegyzés: a getEnginerRelayState használatával ellenőrizheti az eszköz aktuális állapotát
8) A jármű leállítási funkciójának újraindítása
https://a1.gpsguard.eu/api/v1/vehicle//resetEngineRelayStatepéldául.: https://a1.gpsguard.eu/api/v1/vehicle/ZODIDOZEBU/resetEngineRelayState - a rendszerben a jármű megállási állapotát a 0 kezdeti állapotba állítja vissza, az eszköznek nem küld parancsot
Figyelmeztetés: Eltérést okozhat a rendszerben megjelenített állapot és a jármű tényleges állapota között! Csak akkor használja, ha biztos benne, hogy a jármű valóban nincs leblokkolva, és a rendszer állapota nem megfelelő.
Aktuális információt a járműmegállítás állapotára vonatkozóan
{ "RelayState": 0, "LastEventTimestamp": "2018-04-23T16:17:31.0621104+02:00"}9) A szenzorok adatainak lekérése
https://a1.gpsguard.eu/api/v1/vehicle/<vehicle code>/sensors/Rpm?from=<date+time from>&to=<date+time to>például.: https://a1.gpsguard.eu/api/v1/vehicle/AFOSINARAS/sensors/Rpm,Speed?from=2021-01-25T07:25&to=2021-01-25T07:30 - listázza a kiválasztott intervallumra és a megadott járműre vonatkozóan a fordulatszám- és sebességérzékelő adatait
A rendelkezésre álló szenzorok típusai (a jármű és a készülék konfigurációjától függően):
{ "items": [ { "name": "Rpm", "units": "int", "data": [ { "t": "2020-05-26T15:02:49Z", "v": 827 }, { "t": "2020-05-26T15:04:47Z", "v": 0 } ] }, { "name": "Speed", "units": "KilometersPerHour", "data": [ { "t": "2020-05-26T15:02:49Z", "v": 10.0 }, { "t":" 2020-05-26T15:04:47Z", "v": 13.0 } ] } ]}10) Az Eco driving adatok lekérése
https://a1.gpsguard.eu/api/v1/vehicle/<vehicle code>/eco-driving-events?from=<date+time from>&to=<date+time to>például.: https://a1.gpsguard.eu/api/v1/vehicle/AFOSINARAS/eco-driving-events?from=2021-03-01T00:00&to=2021-03-02T00:00 - a kiválasztott intervallumra és a megadott járműre vonatkozó eseményadatok a vezetési stílusra vonatkozóan
{ "EventType": 4, "EventValue": 100, "Timestamp": "2017-07-20T08:59:33", "Position": { "Latitude": 50.153774, "Longitude": 14.51775 }, "EventSeverity": 0, "Speed": 20}Felsorolt típusértékek:
EventType{ Unknown = 0, CorneringLeft = 1, CorneringRight = 2, Cornering = 3, Acceleration = 4, Braking = 5, Bump = 6, LongClutch = 7, DriveOnNeutral = 8, LongFreeWheel = 9}EventSeverity{ None = 0, Low = 1, Medium = 2, High = 3,}11) A jármű telephelyének megváltoztatása
PUT https://a1.gpsguard.eu/api/v1/vehicle/change-branchMódosítja a jármű telephelyét. A módosítási paraméterek a kérés testében kerülnek elküldésre.
Kérés teste:
{ "VehicleCode": "CELIRASUME", "BranchId": 1}12) A jármű telephelyének megváltoztatása a telephely elnevezése alapján
PUT https://a1.gpsguard.eu/api/v1/vehicle/change-branch-by-nameMódosítja a jármű telephelyét. A módosítási paraméterek a kérés testében kerülnek elküldésre. A csoport telephelyeinek egyedi névvel kell rendelkezniük.
Kérés teste:
{ "VehicleCode": "CELIRASUME", "BranchName": "Pobocka 1"}13) A csoportban található telephelyek lekérése
GET https://a1.gpsguard.eu/api/v1/groups/{groupCode}/branchespéldául.: https://a1.gpsguard.eu/api/v1/groups/sagu/branches- listázza az adott csoport telephelyeit
14) Az üzemanyagtöltő kártyák cseréje
Felülírja a jármű üzemanyagkártyáit. A módosítás paraméterei a kérés testében kerülnek elküldésre.
Kérés teste:
{ "refuelingCards": [ "123444", "1111111", "19839839848949849", "704310 08887300296", "0F97CB92", "0A907354" ]},Hiba esetén 409-es Conflict státuszkódot küld vissza.
Nincs kártya importálva, és a szótár visszaküldésre kerül. A kulcs a jármű vehicleCode-ja, az értékek pedig más járművekhez már hozzárendelt kártyaszámok.