Changes for page Методы API для работы с ГЛОНАССSoft

Last modified by Андрей Калиновский on 2025/07/29 15:51

From version < 241.1 >

edited by Андрей Калиновский
on 2025/06/10 15:42

To version < 251.3 >

edited by Андрей Калиновский
on 2025/07/29 15:36

Change comment: There is no comment for this version

Raw
Rendered

Summary

Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

@@ -454,7 +454,7 @@
      [
         "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ группы пользователя, перечисление названия клиентских ролей
      ],
--    "language": 0 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский
++    "language": 1 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский
  }
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
@@ -766,6 +766,8 @@
  (% style="text-align:left" %)
  (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».**
++=   =
++
  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Модель объекта**(%%) =
  == (% style="color:#000000; font-size:16px" %)**Получение информации о модели объекта**(%%) ==
@@ -2389,7 +2389,7 @@
  Тело запроса:
  {
--  "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.
++  "sampling": 86400, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.
    "vehicleIds": [0], ~/~/ Список ID объектов
    "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода
    "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода
@@ -2436,7 +2436,7 @@
  Тело запроса:
  {
--  "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.
++  "sampling": 86400, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.
    "vehicleIds": [0], ~/~/ Список ID объектов
    "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода
    "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода
@@ -2586,26 +2586,50 @@
  В заголовках запроса: X-Auth: Токен авторизации
--В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую.
++В массиве указываем id объектов через запятую
  Ответ:
++
++[
    {
--    "vehicleId": 0, ~/~/Идентификатор объекта.
--    "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификатор объекта.
--    "vehicleNumber": "string",~/~/Номер объекта.
--    "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер
--    "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве.
--    "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4.
--    "speed": 0,~/~/Скорость объекта.
--    "course": 0,~/~/Курс движения [0;360]
--    "latitude": 0,~/~/Широта [-90°;90°].
--    "longitude": 0,~/~/Долгота [-180°;180°].
--    "address": "string",~/~/Адрес.
--    "geozones": [ ~/~/Сведения по геозонам.
++    "vehicleId": 55728, ~/~/ Идентификатор объекта
++    "vehicleGuid": "fa9c0357-9b9f-44b9-a89c-20a2cb80a9ad", ~/~/ Guid объекта
++    "vehicleNumber": "0105 КМ", ~/~/ Номер объекта
++    "receiveTime": "2025-06-27T12:37:46.7782735Z", ~/~/ Время и дата поступления данных
++    "recordTime": "2025-06-27T12:37:19Z", ~/~/ Время и дата формирование данных
++    "state": 4, ~/~/ Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4.
++    "speed": 31, ~/~/ Скорость объекта
++    "course": 116, ~/~/ Курс движения [0;360]
++    "latitude": 45.722128, ~/~/ Широта [-90°;90°].
++    "longitude": 39.800432, ~/~/ Долгота [-180°;180°].
++    "address": "\"   Краснодарский край Россия 45,722128°, 39,800432°\"", ~/~/ Адрес
++    "geozones": [ ~/~/ Сведения по геозонам.
        {
--        "id": 0,
--        "name": "string"
++        "id": 10225647, ~/~/ ID Геозоны
++        "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны
++      },
++      {
++        "id": 10282875, ~/~/ ID Геозоны
++        "name": "Ё2" ~/~/ Наименование геозоны
++      },
++      {
++        "id": 10226240, ~/~/ ID Геозоны
++        "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны
++      },
++      {
++        "id": 9747869, ~/~/ ID Геозоны
++        "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны
++      },
++      {
++        "id": 10221123, ~/~/ ID Геозоны
++        "name": "53r" ~/~/ Наименование геозоны
++      },
++      {
++        "id": 10197638, ~/~/ ID Геозоны
++        "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны
        }
++    ]
++  }
  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) =
@@ -5424,23 +5424,8 @@
  )))
--== **Удаление существующего поля** ==
--(% class="box errormessage" %)
  (((
--**DELETE /api/v3/agroLands/{id}**
--)))
--
--Пример запроса:
--id  ~/~/ Идентификатор поля
--
--Пример ответа:
--
--(((
--200 ~/~/ Успех
--)))
--
--(((
  )))
@@ -5447,10 +5447,6 @@
  (((
  (((
  (((
--
--)))
--
--(((
  == **Изменение поля** ==
  (% class="box infomessage" %)
@@ -5696,9 +5696,65 @@
    "perimetr": 0, ~/~/ ериметр, м
    "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд
  }
++
++
++== **Какие поля посещал объект** ==
++
++(% class="box successmessage" %)
++(((
++**POST /api/v3/agroLands/visitingByVehicle**
  )))
++Пример запроса:
++{
++  "vehicleId": 0, ~/~/ id объекта
++  "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения
++  "byTime": 0, ~/~/ Объединение событий по времени
++  "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра
++  "byDist": 0, ~/~/ Объединение событий по расстоянию
++  "from": "2025-07-29T12:20:28.815Z", ~/~/ Начало периода (локальное время клиента)
++  "to": "2025-07-29T12:20:28.815Z", ~/~/ Конец периода (локальное время клиента)
++  "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK
++}
++
++Пример ответа:
++
++[
++  {
++    "fieldId": 0, ~/~/ id объекта
++    "vehicleName": "string", ~/~/ Наименование объекта
++    "fieldName": "string", ~/~/ Наименование поля
++    "fuelUsage": 0, ~/~/ Расход топлива, л/га
++    "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата)
++    "vehicleId": 0, ~/~/ Идентификатор ТС
++    "start": "2025-07-29T12:20:28.855Z", ~/~/ Начало посещения
++    "end": "2025-07-29T12:20:28.855Z", ~/~/ Конец посещения
++    "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля
++    "mileage": 0 ~/~/ Пробег
++  }
++]
++)))
++
++
++== **Удаление существующего поля** ==
++
++(% class="box errormessage" %)
++(((
++**DELETE /api/v3/agroLands/{id}**
++)))
++
++Пример запроса:
++id  ~/~/ Идентификатор поля
++
++Пример ответа:
++
++(((
++200 ~/~/ Успех
++
++
++)))
++
  = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) =
  )))
  )))
@@ -6182,14 +6182,14 @@
  = **Раздел: Локатор ** =
--== **Получение списка локаторов, доступных пользователю ** ==
++== **Получение данных по локатору** ==
  (% class="box infomessage" %)
  (((
--**GET /api/v3/locators **
++**GET /api/v3/locators/{locatorId}**
  )))
--В заголовках запроса: X-Auth: Токен авторизации
++В запросе указывается locatorid - идентификатор локатора
  Пример ответа:
@@ -6197,13 +6197,13 @@
  (((
  (((
  {
--  "vehiclesIds": [ ~/~/ Объекты
++  "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую
    ],
--  "geoIds": [ ~/~/ Геозоны
++  "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую
    ],
--  "fieldsIds": [ ~/~/ Поля
++  "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую
    ],
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора.
@@ -6222,14 +6222,17 @@
    "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор.
    "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор.
    "url": "string", ~/~/ Ссылка
--  "language": 0, ~/~/ Язык
--  "showVehicleName": true, ~/~/ Наименование объекта
--  "showVehicleDirection": true, ~/~/ Направление движения на треке
--  "allowTrackReport": true, ~/~/ Трек
--  "showTrackTracing": true, ~/~/ Трассировка трека
--  "showSensors": true, ~/~/ Датчик
--  "availableMapLayers": [ ~/~/  Слои на карте
--    0
++  "language": 0, ~/~/ ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский)
++
++ "showVehicleName": true, ~/~/ Наименование объекта
++    "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте
++    "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки**
++    "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке.
++    "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах
++    "availableMapLayers": [ ~/~/Слои на карте ,по умолчанию OpenStreetMap (1-OpenStreetMap, 2-Yandex (Карта), 3-Yandex (Спутник), 4-Yandex (Гибрид), 5-Yandex (Пробки), 6-Google (Карта), 7-Google (Гибрид), 8-Google (Рельеф), 9-Google (Спутник), 10-Bing (Карта), 11-Bing (Гибрид), 12-Bing(Темная карта), 13-2ГИС)
++
++  1
++
    ]
  }
  )))
@@ -6236,38 +6236,9 @@
  )))
--== **Получение перечня моделей ** ==
--
--(% class="box successmessage" %)
  (((
--**POST /api/v3/models/find**
--)))
--
--Пример запроса:
--
  (((
--(((
--{
--  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора
--  "name": "string", ~/~/ Наименование локатора
--  "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей
--)))
--
--
--
-- Пример ответа:
--
--(((
--[
--  {
--    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора
--    "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, для которого надо получить данные
--    "parentName": "string", ~/~/ Наименование пользователя, для которого надо получить данные
--    "name": "string", ~/~/ Наименование локатора
--    "modelType": 0 ~/~/ Типы моделей транспортных средств (0 - None, 1 - Агро, 2 - Перевозчик, 3 - Машины)
--  }
--]
  )))
  )))
@@ -6283,7 +6283,6 @@
  (((
  {
--  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора
    "isEnabled": true, ~/~/ Активность
    "name": "string", ~/~/ Наименование локатора
    "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени)
@@ -6290,26 +6290,28 @@
    "activationTime": "2025-03-12T07:00:08.272Z", ~/~/  Время активации
    "validity": 0, ~/~/ Срок действия в днях (1-90)
    "autoProlongation": true, ~/~/ Автопродление срока действия.
--  "url": "string", ~/~/ Ссылка
--  "language": 0 ~/~/ Язык
++  "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский)
    "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
--  "vehiclesIds": [ ~/~/ Oбъекты
++  "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую
    ],
--  "geoIds": [ ~/~/ Геозоны
++  "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую
    ],
--  "fieldsIds": [ ~/~/ Поля
++  "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую
    ],
--  "showVehicleName": true, ~/~/ Наименование объекта
--  "showVehicleDirection": true, ~/~/ Направление движения на треке
--  "allowTrackReport": true, ~/~/ Трек
--  "showTrackTracing": true, ~/~/ Трассировка трека
--  "showSensors": true, ~/~/ Датчик
--  "availableMapLayers": [ ~/~/ Слои на карте (по умолчанию OpenStreetMap)
--    0
--  ]
++
++ "showVehicleName": true, ~/~/ Наименование объекта
++    "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте
++    "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки**
++    "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке.
++    "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах
++    "availableMapLayers": [ ~/~/Слои на карте ,по умолчанию OpenStreetMap (1-OpenStreetMap, 2-Yandex (Карта), 3-Yandex (Спутник), 4-Yandex (Гибрид), 5-Yandex (Пробки), 6-Google (Карта), 7-Google (Гибрид), 8-Google (Рельеф), 9-Google (Спутник), 10-Bing (Карта), 11-Bing (Гибрид), 12-Bing(Темная карта), 13-2ГИС)
++
++    1
++
++      ]
  }
  )))
@@ -6321,7 +6321,70 @@
  )))
++== **Выводит список локаторов ** ==
++(% class="box successmessage" %)
++(((
++**POST /api/v3/locators/find**
++)))
++
++Пример запроса:
++
++(((
++{
++  "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента
++}
++)))
++
++(((
++
++)))
++
++(((
++
++)))
++
++
++Пример ответа:
++
++(((
++[
++  {
++    "vehiclesCount": 0, ~/~/ Количество объектов.
++    "geozonesCount": 0, ~/~/ Количество геозон.
++    "fieldsCount": 0, ~/~/ Количество полей.
++    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора.
++    "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента.
++    "agentName": "string", ~/~/ Наименование агента.
++    "isEnabled": true, ~/~/ Активность локатора
++    "created": "2025-07-03T12:57:58.738Z", ~/~/ Дата создания
++    "updated": "2025-07-03T12:57:58.738Z", ~/~/ Дата обновления
++    "name": "string", ~/~/ Наименование локатора
++    "status": 0,   ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный)
++    "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени )
++    "activationTime": "2025-07-03T12:57:58.738Z", ~/~/ Дата и время активации правила (UTC)
++    "validity": 0, ~/~/ Срок действия в днях (1-90)
++    "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2)
++    "autoProlongation": true, ~/~/ Автоматическая пролонгация
++    "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор.
++    "creatorUserName": "string", ~/~/ Наименование пользователя создавшего локатора
++    "url": "string", ~/~/ ссылка на локатор
++    "language": 1, ~/~/ Язык локатора(1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский)
++    "showVehicleName": true, ~/~/ Наименование объекта
++    "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте
++    "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки**
++    "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке.
++    "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах
++    "availableMapLayers": [ ~/~/Слои на карте ,по умолчанию OpenStreetMap (1-OpenStreetMap, 2-Yandex (Карта), 3-Yandex (Спутник), 4-Yandex (Гибрид), 5-Yandex (Пробки), 6-Google (Карта), 7-Google (Гибрид), 8-Google (Рельеф), 9-Google (Спутник), 10-Bing (Карта), 11-Bing (Гибрид), 12-Bing(Темная карта), 13-2ГИС)
++
++    0
++    ]
++  }
++]
++)))
++
++
++
  == **Изменение локатора** ==
  (% class="box infomessage" %)
@@ -6340,25 +6340,25 @@
    "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации
    "validity": 0, ~/~/ Срок действия в днях (1-90)
    "autoProlongation": true, ~/~/ Автопродление срока действия
--  "url": "string", ~/~/ Ссылка
--  "language": 0 ~/~/ Язык
--  "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента.
--  "vehiclesIds": [ ~/~/ Oбъекты
++  "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский)
++ "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую
    ],
--  "geoIds": [ ~/~/ Геозоны
++  "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую
    ],
--  "fieldsIds": [ ~/~/ Поля
++  "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую
    ],
    "showVehicleName": true, ~/~/ Наименование объекта
--  "showVehicleDirection": true, ~/~/ Направление движения на треке
--  "allowTrackReport": true, ~/~/ Трек
--  "showTrackTracing": true, ~/~/ Трассировка трека
--  "showSensors": true, ~/~/ Датчик
--  "availableMapLayers": [ ~/~/ Слои на карте (по умолчанию OpenStreetMap)
++    "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте
++    "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки**
++    "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке.
++    "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах
++    "availableMapLayers": [ ~/~/Слои на карте ,по умолчанию OpenStreetMap (1-OpenStreetMap, 2-Yandex (Карта), 3-Yandex (Спутник), 4-Yandex (Гибрид), 5-Yandex (Пробки), 6-Google (Карта), 7-Google (Гибрид), 8-Google (Рельеф), 9-Google (Спутник), 10-Bing (Карта), 11-Bing (Гибрид), 12-Bing(Темная карта), 13-2ГИС)
++
++
    ]
  }
@@ -6592,6 +6592,7 @@
  )))
++==   ==

Changes for page Методы API для работы с ГЛОНАССSoft

Summary

Details

Меню