Запрос параметров события 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_fact-args)

Структура URL-запроса get_fact-args определяется форматом:

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

где <fact-guid>

:: char[37] — глобальный идентификатор события.

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

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

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

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

   Anchor
   bestts bestts

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

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

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

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

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

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

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

3. "Validity" <int8:: 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-края изображения.

"Speed" <uint8_t>. Опциональный параметр. Скорость

1. t. Мера достоверности фиксации номера. Большим значениям соответствует большая достоверность.

7. "Speed" :: uint8_t | null. Скорость движения транспортного средства, км/ч. Значение null (по умолчанию) означает отсутствие фиксации.

8. "SpeedLimit" <uint8:: uint8_t | null>. Опциональный параметр. Установленное null. Установленное ограничение скоростного режима, км/ч. Значение null (по умолчанию) означает отсутствие ограничения.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Пример тела ответа get_fact-args_rbody-200:

{
  "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],
      "Type": 1
    },
    "Speed": 67,
    "SpeedLimit": 60,
    "Direction": "unknown",
    "AlarmTypes": ["speedviolation"],
    "Geodata":
    {
      "latitude": 50.43756, 
      "longitude": 30.45221,
      "altitude": null,
      "speed": null
    }
  }
}

Запрос изображений, связанных с событием Fact

get_fact-image

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

GET /api/v1/post/<post-guid>/channel/<channel-no>/\
media/<media-id>/<image-class>

1. "full". Изображение зоны контроля. Содержит полный кадр (полученный от камеры), на котором зафиксированы лучшие результаты фотовидеофиксации за время проезда транспортным средством зоны контроля.

2. "body". Изображение транспортного средства. Содержит фрагмент full-изображения минимального размера, который позволяет определить модель и цвет автомобиля.

3. "plate". Изображение номера транспортного средства. Содержит фрагмент full-изображения, который позволяет определить номер автомобиля.

4. "fulltitled". Титрованное full-изображение.

5. "bodytitled". Титрованное body-изображение.

GET /api/v1/fact/<fact-guid>/media/<image-class>

Запрос метаданных изображений, связанных с событием FactFact 

get_fact-image-meta

Структура urlURL-запроса get-_fact-image-meta определяется форматом:

GET /api/v1/post/<post-guid>/channel/<channel-no>/\
media/<media-id>/<image-class>/meta

где

• <post-guid>

• :: char[37] — глобальный идентификатор поста; возможные значения согласно get_post-set_rbody-200 (см. Запрос доступных постов, каналов поста и их параметров); 
• <channel-no> :: int32_t — номер канала поста; возможны значения согласно get_post-channel-set_rbody-200 (см. Запрос доступных постов, каналов поста, и их параметров); 
• <media-id> :: int64_t  — идентификатор изображения; 
• <image-class> :: char[] — тип изображения.

Возможные значения параметра <image-class>:

1. "full". Изображение зоны контроля. Содержит полный кадр (полученный от камеры), на котором зафиксированы лучшие результаты фотовидеофиксации за время проезда транспортным средством зоны контроля.

2. "body". Изображение транспортного средства. Содержит фрагмент full-изображения минимального размера, который позволяет определить модель и цвет автомобиля.

3. "plate". Изображение номера транспортного средства. Содержит фрагмент full-изображения, который позволяет определить номер автомобиля.

4. "fulltitled". Титрованное full-изображение.

5. "bodytitled". Титрованное body-изображение.

get_fact-image-meta2

Структура urlURL-запроса get-_fact-image-meta2 определяется форматом:

GET /api/v1/fact/<fact-guid>/media/<image-class>/meta

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

2. "result" <struct>:: struct. Метаданные изображения события Fact.

1. "transform" <struct>:: struct. Матрица трансформации. Характеризует соответствие точек на full- и <image-class>-изображении. Содержит коэффициенты a, b, c, d, x, y. В случае использования full-изображения в качестве <image-class>-изображения параметр transform содержит матрицу единичного оператора (a=d=1, b=c=x=y=0).

2. "size" <:: (uint16_t, uint16_t)>. Размер изображения (ширина и высота), пикселей.

{
 "status": 200,
 "result":
 {
   "transform":
   {
     "a": 22.17142857142857,
     "b": 0.0,
     "c": 0.0,
     "d": 83.33333333333333,
     "x": -7.731958762886598e-3,
     "y": -0.7291428571428571
   },
   "size":[134, 30]
 }
}

|x”|   | a b x |   |x’|
|y”| = | c d y | * |y’|
|1 |   | 0 0 1 |   |1 |