Запрос параметров события Fact

Структура url-запроса get-fact-args определяется форматом:

GET /api/v1/post/<post-guid>/channel/<channel-no>/\
fact/<fact-guid>

где <post-guid> — guid поста; <channel-no> — номер канала поста (возможны значения в интервале [0; 2147483647]); <fact-guid> — guid события.

GET /api/v1/fact/<fact-guid>

Сервер, после успешной обработки запроса get-fact-args или get-fact-args2, возвращает ответ с http-кодом 200. Тело ответа содержит application/json-документ с параметрами:

1. "status" <uint16_t>. Содержит 200.

2. "result" <struct>. Параметры события Fact:

1. "Id". Локальный идентификатор события (в пределах устройства-источника).

2. "Guid" <char[37]>. Глобальный идентификатор события.

3. "Bestts" <uint64_t>. Время фиксации изображений события, мкс (от 01.01.1970 00:00 UTC).

4. "Image" <uint64_t>. Идентификатор изображений событий. Содержит <media-id>.

5. "Lane" <uint8_t>. Полоса движения транспортного средства. Возможные значения в интервале [0; 8]. Значение 0 указывает, что полоса не определена.

6. "Plate" <struct>. Параметры номерной пластины транспортного средства:

1. "Text" <char[]>. Текст номера.

2. "Country" <uint16_t>. Код страны регистрации номера. Типичные значения согласно ISO 1366.

3. "Validity" <int8_t>. Достоверность распознавания номера.

4. "Exact_rect" <(double, double, double, double)>. Содержит координаты rect-региона номерной пластины на изображении зоны контроля с временем регистрации Fact/BestTs. Каждый rect-регион задается парой точек с координатами (X1, Y1) и (X2, Y2), где X1 < X2 и Y1 < Y2.  Возможные значения координат в интервале [0.0; 1.0] c разрешением не менее 1E-6.

1. [0]. Задает X1 относительно left-края изображения;

2. [1]. Задает Y1 относительно top-края изображения;

3. [2]. Задает X2 относительно left-края изображения;

4. [3]. Задает Y2 относительно top-края изображения.

7. "Speed" <uint8_t>. Опциональный параметр. Скорость движения транспортного средства, км/ч.

8. "SpeedLimit" <uint8_t | null>. Опциональный параметр. Установленное ограничение скоростного режима, км/ч.

9. "Direction" <char[16]>. Направление движения транспортного средства в зоне контроля:

1. "unknown". Неизвестно

2. "approaching". Приближается

3. "receding". Удаляется

10. "AlarmTypes" <char[][32]>. Опциональный параметр. Массив. Каждый элемент содержит тип тревоги, зафиксированный при проезде транспортным средством зоны контроля. Возможные значения типов тревог определяются запросом AlarmSet.

11. "Geodata" <struct>. Параметры геолокации устройства в момент фиксации события:

1. "latitude" <double>. Координата широты, градусов. Направление координаты определяется знаком значения:

1. Плюс. На север от экватора

2. Минус. На юг от экватора

2. "longitude" <double>. Координата долготы, градусов. Направление координаты определяется знаком значения:

1. Плюс. На восток от Гринвича

2. Минус. На запад от Гринвича

3. "altitude" <double | null>. Высота над уровнем моря, метров.

4. "speed" <double | null>. Опциональный параметр. Собственная скорость устройства в момент фиксации события (для мобильных устройств), м/с.

Пример тела ответа:

{

 "status": 200,

 "result":

 {
   "Id": 1437984917029087,

   "Guid": "3cb36c1b-5ccc-4d9c-9004-424e82530fbb",
   "Bestts": 1437984917029087,

   "Image": "1437984917029087",

   "Lane": 0,

   "Plate":

   {
     "Text": "АА0514ТР",
     "Country": 804,
     "Validity": 76,

     "Exact_rect": [9.87973e-3, 0.583429, 4.2955299999999e-2, 0.590857]
   },
   "Speed": 67,
   "SpeedLimit": 60,
   "Direction": "unknown",

   "AlarmTypes": ["speedviolation"],
   "Geodata":

   {
     "latitude": 50.43756,
     "longitude": 30.45221,
     "altitude": null,
     "speed": null
   }
 }

}