API за последна координата на обекта

Този API е много подобен на Object API, но допълнително предоставя информация за последното местоположение на даден обект (превозно средство).

При V2 API местоположението е предоставено под формата на координати, а при V3 – допълнително под формата на адрес.

Получаване на списък с обекти с последна координата v2

Тази крайна точка на API ще предостави списък с обекти, които са видими за даден потребител под определен клиент. Местоположението се предоставя под формата на координати. Ако системата няма получени координати, параметърът last_coordinate ще бъде празен.

Swagger: https://api.fm-track.com/swagger-ui.html#!/Objects32Last32Coordinate32API/getObjectsLastCoordinateUsingGET

GET /objects-last-coordinate?version=2&api_key=&limit=&continuation_token=<...><...><...> HTTP/1.1
Host: api.fm-track.com
Content-Type: application/json;charset=UTF-8

Параметър	Тип	Описание	Изисква ли се?	Забележки
версия	Int	Версия на API	ДА	ТРЯБВА ДА Е 2
api_key	Редица	Ключ за идентификация на потребителя	ДА
ограничение	Int	Количество за извличане на обекти	НЕ	по подразбиране = 100, макс. = 1000
continuation_token	Редица		НЕ

Пример за Curl заявка

За бързо тестване можете да опитате да използвате curl заявка (API ключът трябва да бъде заменен с действителния).

curl -X GET "https://api.fm-track.com/objects-last-coordinate?version=2&api_key=r5B5p-CgBlEOpb11HqjZbfbUEI_LTjO9" \
-H "Accept: application/json"

Пример за отговор

{
    "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"
}

Знак за продължаване

Ако в отговора е предоставен continuation_token, това означава, че не всички обекти се вписват в отговора и трябва да се инициира допълнително извикване. Токенът за продължаване в този случай е идентификатор на външен обект. При следващо извикване ще бъде върнат останалият списък с обекти, започвайки от този идентификатор на обект. Извикванията трябва да се повтарят, докато в отговора не бъде предоставен знак за продължение.

Получаване на един обект с последна координата v2

Ако последната координата е необходима за един обект, трябва да се използва този API.

Swagger: https://api.fm-track.com/swagger-ui.html#!/Objects32Last32Coordinate32API/getObjectLastCoordinateUsingGET

GET /objects-last-coordinate/{objectId}?version=2&api_key=<...> HTTP/1.1 Домакин: api.fm-track.com Content-Type: application/json;charset=UTF-8

Параметър	Тип	Описание	Изисква ли се?	Забележки
версия	Int	Версия на API	ДА	ТРЯБВА ДА Е 2
api_key	Редица	Ключ за идентификация на потребителя	ДА

Пример за Curl заявка

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"

Пример за отговор

{
    "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"
    }
}