Получение событий

Этот метод используется для взаимодействия с интеллектуальными дорожными событиями.

Запрос информации

Для получения событий внешней системе необходимо инициировать запрос к функции базы данных API_GLOSAV_EVENTS. Запрос на получение данных должен быть произведен следующим образом:

url_smartroad/api/integration/events?login=user_login&password=user_password&project_id=project_id

Описание дополнительных (необязательных) параметров адреса запроса

Параметр	Тип параметра	Описание
name	строка	Имя детектора. Можно указывать несколько имён, разделённых запятыми без пробелов: `имя_1`, `имя 5`, `имя-9`. DEPRECATED - нежелательный параметр
time_zone	строка	Часовой пояс. Формат записи – `TZ identifiers`. Вместо символа `слеш` допускается использовать знак подчёркивания `«_»`. По умолчанию выполняется подстановка значения параметра из профиля пользователя. Пример: `Europe/Moscow`
from to	строка строка	Определяет промежуток времени и интервал группировки, за который производится запрос данных: `from` – дата начала интервала (включительно) в формате ISO 8601 (YYYY-MM-DD HH:MM: SS) `to` – дата окончания интервала (включительно) в формате ISO 8601 (YYYY-MM-DD HH:MM: SS)
interval	число	За какое количество последних секунд выбирать события. Значение по умолчанию 300 секунд. Не имеет значения, если указаны параметры from и to.
project_id	строка	Обязательный параметр. Идентификатор проекта, по детекторам которого необходимо получить статистику
sensor_id	строка	Уникальный идентификатор детектора. Допускается указывать несколько идентификаторов через запятую.

РЕКОМЕНДУЕТСЯ

Осуществлять запрос данных каждые «N» секунд, так как возможно изменение координат события (координаты X и Y события могут измениться если объект движется во время регистрации события);
Просматривать уже зарегистрированные события, так как по окончании действия события у него может обновиться параметр end_time – время окончания события.

Получение данных

При поступлении корректного запроса Система формирует ответное сообщение в формате JSON. По умолчанию (если не указаны дополнительные параметры в адресе запроса) сформированное сообщение содержит данные по событиям за последние 300 секунд.

Примеры ответного сообщения:

Объект в области определения:

{
  "message_id": "839jfd70-f4kb-0be2-7l1f-1n6y1t3eb7e5",
  "time_zone": "Europe/Moscow",
  "message_data": [
    {
      "sensor_id": "2cg1gec8-rf1t-4eqc-8re8-18eg8a6g68h0",
      "name": "Test",
      "connected": "false",
      "lane_direction": [
        0,
        0,
        0,
        1,
        1,
        1
      ],
      "data": [
        {
          "row": 1,
          "events_id": "962635c9-12ad-4e8e-ae9b-860df642733d",
          "sensor_id": "2cg1gec8-rf1t-4eqc-8re8-18eg8a6g68h0680b",
          "projects_id": "fcff27v4-cqe4-4gdm-8eg1-na1a1d0sdav1",
          "start_time": "2024-10-28T10:37:38.639383+03:00",
          "end_time": "2024-10-28T10:37:38.639383+03:00",
          "type": 1,
          "level": 0,
          "code": 509,
          "description": [
            {
              "lang": "ru",
              "name": "Мд"
            },
            {
              "lang": "en",
              "name": "Snail"
            },
            {
              "lang": "es",
              "name": "Caracol"
            }
          ],
          "unit": "LOW_SPEED",
          "val": "24.30",
          "measure_line": null,
          "lane": 0,
          "zone": 0,
          "direction": -1,
          "obj_id": 102,
          "obj_class": 1,
          "obj_length": 4.5,
          "obj_speed": 24.3,
          "heading": 179.39,
          "point_x": 56.88,
          "point_y": -9.12,
          "close_type": 0,
          "param_data": null
        }
      ]
    }
  ]
}

Неверное направление:

{
  "row": 23,
  "events_id": "09ca6b2b-1824-4d3b-8ec8-d3f2f63b72ba",
  "sensor_id": "37d9eb0c-0b8c-4af8-90c7-f95a0355a903",
  "projects_id": "9d2ce49d-eea9-4210-ad65-49d1ee62d6ca",
  "start_time": "2024-03-06T13:08:49.9+00:00",
  "end_time": "2024-03-06T13:08:49.9+00:00",
  "type": 2,
  "level": 0,
  "code": 2001,
  "description": [
    {
      "lang": "ru",
      "name": "Неверное направление"
    },
    {
      "lang": "en",
      "name": "wrong direction"
    },
    {
      "lang": "es",
      "name": "wrong direction"
    }
  ],
  "unit": "WWD",
  "val": "-3.222486",
  "measure_line": null,
  "lane": 3,
  "zone": 0,
  "direction": 0,
  "obj_id": 35,
  "obj_class": 1,
  "obj_length": 4.5,
  "obj_speed": 7.96,
  "heading": -3.22,
  "point_x": 78.27,
  "point_y": 0.08,
  "close_type": 0
}

Описание параметров ответного сообщения

Параметр	Тип параметра	Описание
message_id	строка	Идентификатор сообщения
time_zone	строка	Часовой пояс. Формат записи – `TZ identifiers`. Вместо символа «слеш» допускается использовать знак подчёркивания `«_»`. По умолчанию выполняется подстановка значения параметра из профиля пользователя. Пример: `Europe/Moscow`.
message_data	массив	Вложенный массив данных
sensor_id	строка	Идентификатор детектора
name	строка	Имя детектора
connected	булево	Состояние подключения детектора, возможные значения: `true` / `false`
lane_direction	Массив целых чисел	Направление движения по полосе: - `0` – движение к нулевому километру дороги - `1` – движение от нулевого километра дороги; - `2` – двустороннее движение. Числа в массиве передаются по порядку следования полос, если считать от самой левой.
data	массив	Вложенный массив данных
row	число	Номер строки ответа
events_id	строка	Идентификатор события
sensor_id	строка	Идентификатор детектора
projects_id	строка	Идентификатор проекта
start_time	строка	Время и дата начала события, в формате согласно стандарту ISO 8601 (0000-00-00T00:00:00+00:00)
end_time	строка	Время и дата окончания события, в формате согласно стандарту ISO 8601 (0000-00-00T00:00:00+00:00)
type	число	Тип события. Возможные значения: - `1` – Speed events (События скорости) - `2` – Traffic events (События трафика) - `9` – Others events (Другие события) Соответствует настройкам правила события в Системе
level	число	Категория события. Возможные значения: - `0` – Information event (Информация) - `1` – Warning event (Предупреждение) - `2` – Critical event (Критическое событие) Соответствует настройкам правила события в Системе
code	число	Код события. Коды событий задаются пользователем при создании событий. Изменение кода события в Системе не влияет на события, записанные до момента изменения
description	массив	Вложенный массив, содержащий название события на русском, английском и испанском языках. Параметры, передаваемые в массиве: `lang` – язык и `name` – имя события
unit	строка	Единица измерения. Возможные значения: - `KMH` – Километры в час - `MPS` - Метры в секунду - `PEDESTRIAN` – Обнаружен пешеход - `PLACE` – Объект в области определения - `STOP` – Остановка `ТС` - `WWD` – Неверное направление
val	число с плавающей точкой	Значение параметра события. Для событий логического характера – `1`, для измеримых событий – соответствующее числовое значение. Например, для превышения скорости, первое измеренное числовое значение, удовлетворяющее правилу события.
measure_line		Всегда принимает значение null
lane		Номер полосы движения, считаются начиная с нуля, слева направо
zone		Индекс зоны, проходя через которую объект становится PVR. Зоны создаются в разделе `Управление дорогами`.
direction		Направление движения по полосе: - `(-1)`: к детектору - `1`: от детектора - `0`: в обе стороны
obj_id		Идентификатор объекта Детекторы ведут объекты, назначая им номера с момента определения объекта в области видимости, и до выхода из неё. Пул номеров циклично ротируется.
obj_class		Номер класса объекта, по заданной пользователем классификации. Нумерация классов начинается с `0`. Если детектор не смог определить класс ТС, то устанавливается значение `-1`
obj_length		Длина объекта в метрах. Значение используется для определения класса объекта
obj_speed		Скорость объекта в `км/ч`.
heading		Направление движения (угол движения к детектору в `°`)
point_x		Расстояние в метрах по оси `X`
point_y		Расстояние в метрах по оси `Y`
close_type	число	Тип закрытия: - `0` – Автоматическое - `1` – Ручное - `NULL` – Не закрыто

Запрос информации​

Получение данных​

Запрос информации

Получение данных