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	Сума вилучення об’єкта	НІ	default = 100, max = 1000
продовження_token	Рядок		НІ

Приклад запиту на згортання

Для швидкого тестування ви можете спробувати використати 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"
}

Токен продовження

Якщо у відповіді міститься маркер продовження, це означає, що не всі об’єкти помістилися у відповідь і потрібно ініціювати додатковий виклик. Токеном продовження у цьому випадку є зовнішній ідентифікатор об’єкта. При наступному виклику буде повернуто список об’єктів, що залишилися, починаючи з цього ідентифікатора. Виклики слід повторювати до тих пір, поки у відповіді не буде надано жодного маркера продовження.

Отримати один об’єкт з останньою координатою 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 Host: api.fm-track.com Content-Type: application/json;charset=UTF-8

Параметр	Тип	Опис	Це обов’язково?	Зауваження
версія	Int	Версія API	ТАК.	ПОВИННО БУТИ 2
api_key	Рядок	Ідентифікаційний ключ користувача	ТАК.

Приклад запиту на згортання

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