Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/07/29 15:51
<
>
edited by Андрей Калиновский
on 2025/07/03 09:46
on 2025/07/03 09:46
edited by Андрей Калиновский
on 2025/07/29 15:36
on 2025/07/29 15:36
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Content
-
... ... @@ -454,7 +454,7 @@ 454 454 [ 455 455 "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ группы пользователя, перечисление названия клиентских ролей 456 456 ], 457 - "language": 0~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский457 + "language": 1 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский 458 458 } 459 459 { 460 460 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -766,6 +766,8 @@ 766 766 (% style="text-align:left" %) 767 767 (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».** 768 768 769 += = 770 + 769 769 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Модель объекта**(%%) = 770 770 771 771 == (% style="color:#000000; font-size:16px" %)**Получение информации о модели объекта**(%%) == ... ... @@ -2389,7 +2389,7 @@ 2389 2389 Тело запроса: 2390 2390 2391 2391 { 2392 - "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2394 + "sampling": 86400, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2393 2393 "vehicleIds": [0], ~/~/ Список ID объектов 2394 2394 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2395 2395 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -2436,7 +2436,7 @@ 2436 2436 Тело запроса: 2437 2437 2438 2438 { 2439 - "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2441 + "sampling": 86400, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2440 2440 "vehicleIds": [0], ~/~/ Список ID объектов 2441 2441 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2442 2442 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -5448,23 +5448,8 @@ 5448 5448 ))) 5449 5449 5450 5450 5451 -== **Удаление существующего поля** == 5452 5452 5453 -(% class="box errormessage" %) 5454 5454 ((( 5455 -**DELETE /api/v3/agroLands/{id}** 5456 -))) 5457 - 5458 -Пример запроса: 5459 -id ~/~/ Идентификатор поля 5460 - 5461 -Пример ответа: 5462 - 5463 -((( 5464 -200 ~/~/ Успех 5465 -))) 5466 - 5467 -((( 5468 5468 5469 5469 ))) 5470 5470 ... ... @@ -5471,10 +5471,6 @@ 5471 5471 ((( 5472 5472 ((( 5473 5473 ((( 5474 - 5475 -))) 5476 - 5477 -((( 5478 5478 == **Изменение поля** == 5479 5479 5480 5480 (% class="box infomessage" %) ... ... @@ -5720,9 +5720,65 @@ 5720 5720 "perimetr": 0, ~/~/ ериметр, м 5721 5721 "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд 5722 5722 } 5706 + 5707 + 5708 +== **Какие поля посещал объект** == 5709 + 5710 +(% class="box successmessage" %) 5711 +((( 5712 +**POST /api/v3/agroLands/visitingByVehicle** 5723 5723 ))) 5724 5724 5715 +Пример запроса: 5725 5725 5717 +{ 5718 + "vehicleId": 0, ~/~/ id объекта 5719 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 5720 + "byTime": 0, ~/~/ Объединение событий по времени 5721 + "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 5722 + "byDist": 0, ~/~/ Объединение событий по расстоянию 5723 + "from": "2025-07-29T12:20:28.815Z", ~/~/ Начало периода (локальное время клиента) 5724 + "to": "2025-07-29T12:20:28.815Z", ~/~/ Конец периода (локальное время клиента) 5725 + "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 5726 +} 5727 + 5728 +Пример ответа: 5729 + 5730 +[ 5731 + { 5732 + "fieldId": 0, ~/~/ id объекта 5733 + "vehicleName": "string", ~/~/ Наименование объекта 5734 + "fieldName": "string", ~/~/ Наименование поля 5735 + "fuelUsage": 0, ~/~/ Расход топлива, л/га 5736 + "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата) 5737 + "vehicleId": 0, ~/~/ Идентификатор ТС 5738 + "start": "2025-07-29T12:20:28.855Z", ~/~/ Начало посещения 5739 + "end": "2025-07-29T12:20:28.855Z", ~/~/ Конец посещения 5740 + "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 5741 + "mileage": 0 ~/~/ Пробег 5742 + } 5743 +] 5744 +))) 5745 + 5746 + 5747 +== **Удаление существующего поля** == 5748 + 5749 +(% class="box errormessage" %) 5750 +((( 5751 +**DELETE /api/v3/agroLands/{id}** 5752 +))) 5753 + 5754 +Пример запроса: 5755 +id ~/~/ Идентификатор поля 5756 + 5757 +Пример ответа: 5758 + 5759 +((( 5760 +200 ~/~/ Успех 5761 + 5762 + 5763 +))) 5764 + 5726 5726 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5727 5727 ))) 5728 5728 ))) ... ... @@ -6206,14 +6206,14 @@ 6206 6206 = **Раздел: Локатор ** = 6207 6207 6208 6208 6209 -== **Получение списка локаторов,доступных пользователю** ==6248 +== **Получение данных по локатору** == 6210 6210 6211 6211 (% class="box infomessage" %) 6212 6212 ((( 6213 -**GET /api/v3/locators 6252 +**GET /api/v3/locators/{locatorId}** 6214 6214 ))) 6215 6215 6216 -В за головкахзапроса:X-Auth:Токен авторизации6255 +В запросе указывается locatorid - идентификатор локатора 6217 6217 6218 6218 6219 6219 Пример ответа: ... ... @@ -6246,14 +6246,17 @@ 6246 6246 "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6247 6247 "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 6248 6248 "url": "string", ~/~/ Ссылка 6249 - "language": 0, ~/~/ Язык 6250 - "showVehicleName": true, ~/~/ Наименование объекта 6251 - "showVehicleDirection": true, ~/~/ Направление движения на треке 6252 - "allowTrackReport": true, ~/~/ Трек 6253 - "showTrackTracing": true, ~/~/ Трассировка трека 6254 - "showSensors": true, ~/~/ Датчик 6255 - "availableMapLayers": [ ~/~/ Слои на карте 6256 - 0 6288 + "language": 0, ~/~/ ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6289 + 6290 + "showVehicleName": true, ~/~/ Наименование объекта 6291 + "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6292 + "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6293 + "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6294 + "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6295 + "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ГИС) 6296 + 6297 + 1 6298 + 6257 6257 ] 6258 6258 } 6259 6259 ))) ... ... @@ -6260,38 +6260,9 @@ 6260 6260 ))) 6261 6261 6262 6262 6263 -== **Получение перечня моделей ** == 6264 - 6265 -(% class="box successmessage" %) 6266 6266 ((( 6267 -**POST /api/v3/models/find** 6268 -))) 6269 - 6270 -Пример запроса: 6271 - 6272 6272 ((( 6273 -((( 6274 -{ 6275 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6276 - "name": "string", ~/~/ Наименование локатора 6277 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 6278 -))) 6279 - 6280 - 6281 - 6282 - Пример ответа: 6283 6283 6284 - 6285 -((( 6286 -[ 6287 - { 6288 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6289 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, для которого надо получить данные 6290 - "parentName": "string", ~/~/ Наименование пользователя, для которого надо получить данные 6291 - "name": "string", ~/~/ Наименование локатора 6292 - "modelType": 0 ~/~/ Типы моделей транспортных средств (0 - None, 1 - Агро, 2 - Перевозчик, 3 - Машины) 6293 - } 6294 -] 6295 6295 ))) 6296 6296 ))) 6297 6297 ... ... @@ -6324,12 +6324,16 @@ 6324 6324 "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6325 6325 0 6326 6326 ], 6327 - "showVehicleName": true, ~/~/ Наименование объекта 6328 - "showVehicleDirection": true, ~/~/ Направление движения на треке 6329 - "allowTrackReport": true, ~/~/ Трек 6330 - "showTrackTracing": true, ~/~/ Трассировка трека 6331 - "showSensors": true, ~/~/ Датчик 6332 - "availableMapLayers": 1 [ ~/~/ Слои на карте ,по умолчанию 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ГИС) 6340 + 6341 + "showVehicleName": true, ~/~/ Наименование объекта 6342 + "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6343 + "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6344 + "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6345 + "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6346 + "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ГИС) 6347 + 6348 + 1 6349 + 6333 6333 ] 6334 6334 } 6335 6335 ))) ... ... @@ -6342,7 +6342,70 @@ 6342 6342 ))) 6343 6343 6344 6344 6362 +== **Выводит список локаторов ** == 6345 6345 6364 +(% class="box successmessage" %) 6365 +((( 6366 +**POST /api/v3/locators/find** 6367 +))) 6368 + 6369 +Пример запроса: 6370 + 6371 +((( 6372 +{ 6373 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента 6374 +} 6375 +))) 6376 + 6377 +((( 6378 + 6379 +))) 6380 + 6381 +((( 6382 + 6383 +))) 6384 + 6385 + 6386 +Пример ответа: 6387 + 6388 +((( 6389 +[ 6390 + { 6391 + "vehiclesCount": 0, ~/~/ Количество объектов. 6392 + "geozonesCount": 0, ~/~/ Количество геозон. 6393 + "fieldsCount": 0, ~/~/ Количество полей. 6394 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6395 + "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 6396 + "agentName": "string", ~/~/ Наименование агента. 6397 + "isEnabled": true, ~/~/ Активность локатора 6398 + "created": "2025-07-03T12:57:58.738Z", ~/~/ Дата создания 6399 + "updated": "2025-07-03T12:57:58.738Z", ~/~/ Дата обновления 6400 + "name": "string", ~/~/ Наименование локатора 6401 + "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6402 + "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 6403 + "activationTime": "2025-07-03T12:57:58.738Z", ~/~/ Дата и время активации правила (UTC) 6404 + "validity": 0, ~/~/ Срок действия в днях (1-90) 6405 + "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6406 + "autoProlongation": true, ~/~/ Автоматическая пролонгация 6407 + "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6408 + "creatorUserName": "string", ~/~/ Наименование пользователя создавшего локатора 6409 + "url": "string", ~/~/ ссылка на локатор 6410 + "language": 1, ~/~/ Язык локатора(1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6411 + "showVehicleName": true, ~/~/ Наименование объекта 6412 + "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6413 + "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6414 + "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6415 + "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6416 + "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ГИС) 6417 + 6418 + 0 6419 + ] 6420 + } 6421 +] 6422 +))) 6423 + 6424 + 6425 + 6346 6346 == **Изменение локатора** == 6347 6347 6348 6348 (% class="box infomessage" %) ... ... @@ -6372,11 +6372,14 @@ 6372 6372 0 6373 6373 ], 6374 6374 "showVehicleName": true, ~/~/ Наименование объекта 6375 - "showVehicleDirection": true, ~/~/ Направление движения на треке 6376 - "allowTrackReport": true, ~/~/ Трек 6377 - "showTrackTracing": true, ~/~/ Трассировка трека 6378 - "showSensors": true, ~/~/ Датчик 6379 - "availableMapLayers": 1 [ ~/~/ Слои на карте ,по умолчанию 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ГИС) 6455 + "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6456 + "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6457 + "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6458 + "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6459 + "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ГИС) 6460 + 6461 + 0 6462 + 6380 6380 ] 6381 6381 } 6382 6382 ... ... @@ -6610,6 +6610,7 @@ 6610 6610 ))) 6611 6611 6612 6612 6696 +== == 6613 6613 6614 6614 6615 6615