Ovaj API je vrlo sličan Object API-ju, ali dodatno pruža najnoviju lokaciju objekta (vozila).
Na V2 API-ju lokacija je navedena u obliku koordinata, dok je na V3 dodatno navedena u obliku adrese.
Dohvati popis objekata s posljednjom koordinatom v2
Ova API krajnja točka pružit će popis objekata koji su vidljivi korisniku pod određenim klijentom. Lokacija se navodi u obliku koordinata. Ako sustav nema primljene koordinate, parametar last_coordinate bit će prazan.
GET /objekti-zadnja-koordinata?verzija=2&api_key= <...>&limit= <...>&continuation_token= <...>HTTP/1.1
Domaćin: api.fm-track.com
Vrsta sadržaja: application/json; charset=UTF-8
Parametar | Tip | Opis | Je li obavezno? | Napomene |
---|---|---|---|---|
verzija | Međunarodna | Verzija API-ja | DA | MORA BITI 2 |
API_ključ | Niz | Ključ za identifikaciju korisnika | DA | |
ograničiti | Međunarodna | Iznos preuzimanja objekta | NE | zadano = 100, maks. = 1000 |
token_nastavka | Niz | NE |
Primjer zahtjeva za Curl
Za brzo testiranje možete pokušati koristiti curl zahtjev (API ključ treba zamijeniti stvarnim).
curl -X GET "https://api.fm-track.com/objects-last-coordinate?version=2&api_key=r5B5p-CgBlEOpb11HqjZbfbUEI_LTjO9" \ -H "Accept: application/json"
Primjer odgovora
{ "results": [ { "id": "9db8ce84-85ef-11e9-89b6-b33c5b120f33", "name": "AAAAAAAA", "imei": 999955557777, "vehicle_params": { "model": "R1250", "make": "BMW", "vin": null, "plate_number": null, "average_fuel_consumption": null, "fuel_tank_capacity": null, "fuel_type": "DIESEL" }, "last_coordinate": { "satellites_count": 13, "altitude": 30, "speed": 104, "direction": 166, "latitude": 50.311658, "longitude": 14.607314, "datetime": "2025-05-01T13:02:00.000Z", "last_valid_gps_datetime": "2022-09-01T13:02:00.000Z", "server_datetime": "2022-09-02T09:25:55.980Z" } }, { "id": "7bf8990c-dba6-11e9-bdfc-1ff21de66015", "name": "AAA333", "imei": 490154203237001, "vehicle_params": { "model": "", "make": "", "vin": null, "plate_number": null, "average_fuel_consumption": 0.00, "fuel_tank_capacity": null, "fuel_type": "DIESEL" }, "last_coordinate": { "satellites_count": 13, "altitude": 30, "speed": 104, "direction": 166, "latitude": 50.311658, "longitude": 14.607314, "datetime": "2025-05-01T13:02:00.000Z", "last_valid_gps_datetime": "2022-09-01T13:02:00.000Z", "server_datetime": "2022-09-02T09:25:55.980Z" } } ], "continuation_token": "12300000-0000-0000-0000-000008823234" }
Token za nastavak
U slučaju da je unutar odgovora naveden continuation_token , to znači da se ne uklapaju svi objekti u odgovor te da treba pokrenuti dodatni poziv. Token za nastavak u ovom slučaju je vanjski ID objekta. Prilikom upućivanja sljedećeg poziva, preostali popis objekata bit će vraćen počevši od tog ID-a objekta. Pozivi se trebaju ponavljati sve dok se unutar odgovora ne navede nikakav token za nastavak.
Dobij jedan objekt s posljednjom koordinatom v2
Ako je za jedan objekt potrebna zadnja koordinata, treba koristiti ovaj API.
GET /objekti-zadnja-koordinata/{objectId} ?verzija=2&api_key= <...>HTTP/1.1 Domaćin: api.fm-track.com Vrsta sadržaja: application/json; charset=UTF-8
Parametar | Tip | Opis | Je li obavezno? | Napomene |
---|---|---|---|---|
verzija | Međunarodna | Verzija API-ja | DA | MORA BITI 2 |
API_ključ | Niz | Ključ za identifikaciju korisnika | DA |
Primjer zahtjeva za Curl
Za brzo testiranje možete pokušati koristiti curl zahtjev (API ključ treba zamijeniti stvarnim).
curl -X GET "https://api.fm-track.com/objects-last-coordinate/7bf8990c-dba6-11e9-bdfc-1ff21de66015?version=2&api_key=r5B5p-CgBlEOpb11HqjZbfbUEI_LTjO9" \ -H "Accept: application/json"
Primjer odgovora
{ "id": "7bf8990c-dba6-11e9-bdfc-1ff21de66015", "name": "AAA333", "imei": 490154203237001, "vehicle_params": { "model": "", "make": "", "vin": null, "plate_number": null, "average_fuel_consumption": 0.00, "fuel_tank_capacity": null, "fuel_type": "DIESEL" }, "last_coordinate": { "satellites_count": 13, "altitude": 30, "speed": 104, "direction": 166, "latitude": 50.311658, "longitude": 14.607314, "datetime": "2025-05-01T13:02:00.000Z", "last_valid_gps_datetime": "2025-05-01T13:02:00.000Z", "server_datetime": "2025-05-02T09:25:55.980Z" } }