Изменения документа Методы API для работы с ГЛОНАССSoft
Редактировал(а) Михаил Жучков 2025/10/30 11:26
<
отредактировано Андрей Калиновский
на 2025/06/27 16:12
на 2025/06/27 16:12
отредактировано Михаил Жучков
на 2025/10/30 11:26
на 2025/10/30 11:26
Изменить комментарий:
К данной версии нет комментариев
Комментарий
Подробности
- Свойства страницы
-
- Автор документа
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Gadmin1 +XWiki.SupportZhuchkov - Содержимое
-
... ... @@ -202,7 +202,7 @@ 202 202 (% style="color:#000000" %)Параметр запроса: 203 203 204 204 (% style="color:#000000" %){ 205 - "parentId": "string" 205 + "parentId": "(%%)string(% style="color:#000000" %)" ~/~/ для получение собственного parentId отправьте пустой запрос (пример "parentId": "" ) 206 206 } 207 207 208 208 (% style="color:#000000" %)Ответ: ... ... @@ -287,28 +287,6 @@ 287 287 "bankKS": "string" ~/~/ корр. счёт 288 288 } 289 289 290 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 291 -|(% style="width:215px" %)(% style="color:#000000" %)agentId|(% style="width:861px" %)(% style="color:#000000" %)Идентификатор клиента 292 -|(% style="width:215px" %)parentId|(% style="width:861px" %)Идентификатор клиента-родителя 293 -|(% style="width:215px" %)parentName|(% style="width:861px" %)Наименование (% style="color:#000000" %)клиента-родителя 294 -|(% style="width:215px" %)name|(% style="width:861px" %)(% style="color:#000000" %)Наименование клиента 295 -|(% style="width:215px" %)fullName|(% style="width:861px" %)(% style="color:#000000" %)Полное наименование клиента 296 -|(% style="width:215px" %)agentInfoType|(% style="width:861px" %)(% style="color:#000000" %)Тип клиента (0- Клиент, 1 - Партнер, 2 - Группа, 3 - Административная группа, 4 - Тестовый клиент, 5 - Договор) 297 -|(% style="width:215px" %)isForeign|(% style="width:861px" %)Иностранный контрагент 298 -|(% style="width:215px" %)district|(% style="width:861px" %)Округ 299 -|(% style="width:215px" %)region|(% style="width:861px" %)Регион 300 -|(% style="width:215px" %)city|(% style="width:861px" %)Город 301 -|(% style="width:215px" %)inn|(% style="width:861px" %)ИНН клиента 302 -|(% style="width:215px" %)kpp|(% style="width:861px" %)КПП клиента 303 -|(% style="width:215px" %)address|(% style="width:861px" %)Юридический адрес 304 -|(% style="width:215px" %)addressFact|(% style="width:861px" %)Фактический адрес 305 -|(% style="width:215px" %)email|(% style="width:861px" %)Электронная почта 306 -|(% style="width:215px" %)director|(% style="width:861px" %)ФИО руководителя 307 -|(% style="width:215px" %)bankName|(% style="width:861px" %)Банк 308 -|(% style="width:215px" %)bankBIK|(% style="width:861px" %)БИК 309 -|(% style="width:215px" %)bankRS|(% style="width:861px" %)Номер счета 310 -|(% style="width:215px" %)bankKS|(% style="width:861px" %)Корр. счет 311 - 312 312 == (% style="color:#000000; font-size:16px" %)**Редактирование клиента**(%%) == 313 313 314 314 (% class="box warningmessage" %) ... ... @@ -454,7 +454,7 @@ 454 454 [ 455 455 "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ группы пользователя, перечисление названия клиентских ролей 456 456 ], 457 - "language": 0~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский435 + "language": 1 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский 458 458 } 459 459 { 460 460 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -766,6 +766,11 @@ 766 766 (% style="text-align:left" %) 767 767 (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».** 768 768 747 +(% class="wikigeneratedid" id="H" %) 748 +((( 749 + 750 +))) 751 + 769 769 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Модель объекта**(%%) = 770 770 771 771 == (% style="color:#000000; font-size:16px" %)**Получение информации о модели объекта**(%%) == ... ... @@ -1074,6 +1074,12 @@ 1074 1074 "forTooltip": true, ~/~/ Отображать в подсказке 1075 1075 "forReport": true ~/~/ Отображать в отчете 1076 1076 } 1060 + ], 1061 + "vehicleGroups": [ ~/~/ Группы ТС 1062 + { 1063 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1064 + "name": "string" ~/~/ Наименование группы ТС 1065 + } 1077 1077 1078 1078 ], ~/~/ Данные с вкладки нормы 1079 1079 "consumptionPer100Km": "" , ~/~/ Расход топлива на 100 км (если заполнено, то consumptionPerHour не может быть заполнено) ... ... @@ -1124,7 +1124,7 @@ 1124 1124 "type": 0, ~/~/ Тип датчика 1125 1125 "name": "string", ~/~/ Имя датчика 1126 1126 "inputType": 0, ~/~/ Тип входа, Analog, Digital, Impulse, ImpulseFrequency, Diagnosis, Rs485, Rs232, Wire, FMS, BLE 1127 - " inputNumber":0, ~/~/Номер входа1116 + "parameterName": "string", ~/~/ Имя параметра (взамен связки Input type + port number) 1128 1128 "pseudonym": "string", ~/~/ Псевдоним 1129 1129 "medianDegree": 0, ~/~/ Медианная фильтрация 1130 1130 "isInverted": true, ~/~/ Инвертировать, true - Вкл., false - Выкл. ... ... @@ -1157,27 +1157,31 @@ 1157 1157 "additionalProp3": "string" 1158 1158 }, 1159 1159 1160 -~/~/ Характерные для произвольного: 1161 -~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off 1162 -~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы 1163 -~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off 1164 -~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний 1165 -~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off 1166 -~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off 1167 -~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off 1168 -~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область) 1169 -~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1170 -~/~/ "ValueOn": "Вкл.", 1171 -~/~/ "ValueOff": "Выкл." 1172 - "summaryMaxValue": 0 ~/~/ Макс. значение 1173 - } 1149 + "summaryMaxValue": 0, ~/~/ Определяет максимальное значение датчика в режиме накопления. 1150 + "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1151 + { 1152 + "from": 0, ~/~/ С какого значения 1153 + "color": "string", ~/~/ Каким цветом 1154 + "text": "string" ~/~/ Текст подписи к этому интервалу 1155 + } 1156 + ], 1157 + "disableEmissionsValidation": true, ~/~/ Нужно ли валидировать выбросы значений. Применяется для датчиков с типом "Накопительный" 1158 + "unitOfMeasure": 0 ~/~/ Единица измерения значений датчика. (0 - по умолчанию, 1 - секунды, 2 - часы) 1159 + } 1160 + ], 1174 1174 "drivers": [ ~/~/ Водители 1175 1175 { 1176 1176 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1177 1177 "name": "string", ~/~/ Наименование 1178 - "description": "string", 1179 - "isDefault": true ~/~/ По умолчанию 1165 + "description": "string", ~/~/ Описание 1166 + "assignments": [ ~/~/ Информация по назначениям 1167 + { 1168 + "beginTime": "2025-10-21T12:28:41.021Z", ~/~/Момент времени начала назначения. 1169 + "endTime": "2025-10-21T12:28:41.021Z", ~/~/ Момент времени окончания назначения. 1170 + "createTime": "2025-10-21T12:28:41.021Z" ~/~/ Момент времени создания назначения. 1180 1180 } 1172 + ] 1173 + } 1181 1181 ], 1182 1182 "inspectionTasks": [ ~/~/ Задания на тех. обслуживание 1183 1183 { ... ... @@ -2389,7 +2389,7 @@ 2389 2389 Тело запроса: 2390 2390 2391 2391 { 2392 - "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2385 + "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", ~/~/ Окончание периода ... ... @@ -2419,7 +2419,7 @@ 2419 2419 } 2420 2420 ] 2421 2421 2422 -== (% style="color:#000000; font-size:16px" %)**Получение данных о расходе транспортн огосредства**(%%) ==2415 +== (% style="color:#000000; font-size:16px" %)**Получение данных о расходе топлива транспортным средством**(%%) == 2423 2423 2424 2424 (% class="box infomessage" %) 2425 2425 ((( ... ... @@ -2436,7 +2436,8 @@ 2436 2436 Тело запроса: 2437 2437 2438 2438 { 2439 - "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2432 + 2433 + "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", ~/~/ Окончание периода ... ... @@ -2469,7 +2469,6 @@ 2469 2469 (% class="box warningmessage" %) 2470 2470 ((( 2471 2471 Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"". 2472 -\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling". 2473 2473 ))) 2474 2474 2475 2475 == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == ... ... @@ -2508,11 +2508,19 @@ 2508 2508 { 2509 2509 "event": 0, ~/~/ Тип события 0 - Other, 1 - Engine, 2 - Stop, 3 - FuelIn, 4 - FuelOut, 5 - Garbage, 6 - Grader, 8 - Otval, 9 - Sand, 10 - MixerLand, 11 - MixerMove, 12 - OpenCircuit, 13 - TechSpeed, 14 - Work, 15 - Braid, 16 - Broom, 17 - ReFuller, 18 - Crane, 19 - Power, 20 - TankFuelIn, 21 - TankFuelOut, 22 - BigStop, 23 - OverSpeed, 24 - Unloading, 25 - Warning, 26 - GarbageWork, 27 - Custom, 28 - CustomWork, 29 - GNSS, 30 - GrainIn, 31 - GrainOut, 32 - WeighingTerminal, 33 - Stopping, 34 - FertilizerWork, 35 - FertilizerRefueling 2510 2510 2504 +((( 2511 2511 "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 2512 2512 "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 2513 2513 "valueFuel": 0, ~/~/ Количество 2514 2514 "fuelStart": 0, ~/~/ Уровень топлива на начало события 2515 2515 "fuelEnd": 0 ~/~/ Уровень топливо на конец события 2510 +))) 2511 + 2512 +((( 2513 + "latitude": 0, ~/~/ Широта. 2514 + "longitude": 0 ~/~/ Долгота. 2515 +))) 2516 + 2516 2516 } 2517 2517 ] 2518 2518 } ... ... @@ -2632,163 +2632,8 @@ 2632 2632 } 2633 2633 2634 2634 2635 -= (%style="color:#000000;font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%)=2636 += = 2636 2636 2637 -== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == 2638 - 2639 -(% class="box infomessage" %) 2640 -((( 2641 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find** 2642 -))) 2643 - 2644 -(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них. 2645 - 2646 -(% style="color:#000000" %)Метод запроса: **POST** 2647 - 2648 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/find 2649 - 2650 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2651 - 2652 -(% style="text-align:left" %) 2653 -Тело запроса: 2654 - 2655 -(% style="text-align:left" %) 2656 -{ 2657 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2658 -} 2659 - 2660 -(% style="text-align:left" %) 2661 -Ответ: 2662 - 2663 -[ 2664 - { 2665 - "id": 0, ~/~/ Идентификатор объекта геозоны 2666 - "name": "string", ~/~/ Название объекта геозоны 2667 - "type": 0, ~/~/ Тип объекта геозоны 2668 - "fname": "string", ~/~/ Имя файла 2669 - "parentId": "string", ~/~/ Идентификатор клиента 2670 - "radius": 0, ~/~/ Радиус геообъекта 2671 - "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета 2672 - "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета 2673 - "description": "string", ~/~/ Описание 2674 - "area": 0, ~/~/ Площадь, м^^2^^ 2675 - "perimetr": 0, ~/~/ Периметр, м 2676 - "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания 2677 - } 2678 -] 2679 - 2680 -== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по объектам**(%%) == 2681 - 2682 -(% class="box infomessage" %) 2683 -((( 2684 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/vehicles** 2685 -))) 2686 - 2687 -(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных объектов со всеми геообъектами за выбранный период. 2688 - 2689 -(% style="color:#000000" %)Метод запроса: **POST** 2690 - 2691 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/vehicles 2692 - 2693 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2694 - 2695 -(% style="text-align:left" %) 2696 -Тело запроса: 2697 - 2698 -{ 2699 - "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2700 - "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2701 - "ids": [ ], ~/~/ Массив id объектов 2702 - "byTime": 0, ~/~/ Объединение событий по времени 2703 - "byDist": 0, ~/~/ Объединение событий по расстоянию 2704 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2705 - "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2706 -} 2707 - 2708 -Ответ: 2709 -[ 2710 - { 2711 - "geozoneId": 0, ~/~/ ID геообъекта 2712 - "geozoneName": "string", ~/~/ Название геообъекта 2713 - "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2714 - "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2715 - "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2716 - "vehicleId": 0, ~/~/ ID объекта 2717 - "vehicleName": "string" ~/~/ Имя объекта 2718 - } 2719 -] 2720 - 2721 -== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по геообъектам**(%%) == 2722 - 2723 -(% class="box infomessage" %) 2724 -((( 2725 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/geozones** 2726 -))) 2727 - 2728 -(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных геообъектов со всеми объектами за выбранный период. 2729 - 2730 -(% style="color:#000000" %)Метод запроса: **POST** 2731 - 2732 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/geozones 2733 - 2734 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2735 - 2736 -(% style="text-align:left" %) 2737 -Тело запроса: 2738 - 2739 -{ 2740 - "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2741 - "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2742 - "ids": [ ], ~/~/ Массив id геообъектов 2743 - "byTime": 0, ~/~/ Объединение событий по времени 2744 - "byDist": 0, ~/~/ Объединение событий по расстоянию 2745 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2746 - "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2747 -} 2748 - 2749 -Ответ: 2750 - 2751 -[ 2752 - { 2753 - "geozoneId": 0, ~/~/ ID геообъекта 2754 - "geozoneName": "string", ~/~/ Название геообъекта 2755 - "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2756 - "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2757 - "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2758 - "vehicleId": 0, ~/~/ ID объекта 2759 - "vehicleName": "string" ~/~/ Имя объекта 2760 - } 2761 -] 2762 - 2763 - 2764 -== (% style="color:#000000; font-size:16px" %)**Обновить информацию по геозоне**(%%) == 2765 - 2766 -(% class="box successmessage" %) 2767 -((( 2768 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**PUT **(%%)**/api/v3/gis** 2769 -))) 2770 - 2771 -(% style="color:#000000" %)Метод запроса: **PUT** 2772 - 2773 -Пример запроса: 2774 - 2775 -((( 2776 -{ 2777 - "id": 0, ~/~/ Идентификатор объекта геозоны 2778 - "name": "string", ~/~/ Наименование объекта геозоны 2779 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2780 - "description": "string", ~/~/ Описание объекта геозоны 2781 - "beginCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата начала расчетов для геозоны 2782 - "endCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата окончания расчетов для геозоны 2783 - "settingsData": "string" ~/~/ Параметры отображения в формате XML. 2784 -} 2785 -))) 2786 - 2787 - 2788 -Пример ответа: 2789 - 2790 -200 ~/~/ Success 2791 - 2792 2792 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 2793 2793 2794 2794 == (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == ... ... @@ -5448,33 +5448,9 @@ 5448 5448 ))) 5449 5449 5450 5450 5451 -== **Удаление существующего поля** == 5452 - 5453 -(% class="box errormessage" %) 5454 5454 ((( 5455 -**DELETE /api/v3/agroLands/{id}** 5456 -))) 5457 - 5458 -Пример запроса: 5459 -id ~/~/ Идентификатор поля 5460 - 5461 -Пример ответа: 5462 - 5463 5463 ((( 5464 -200 ~/~/ Успех 5465 -))) 5466 - 5467 5467 ((( 5468 - 5469 -))) 5470 - 5471 -((( 5472 -((( 5473 -((( 5474 - 5475 -))) 5476 - 5477 -((( 5478 5478 == **Изменение поля** == 5479 5479 5480 5480 (% class="box infomessage" %) ... ... @@ -5720,9 +5720,102 @@ 5720 5720 "perimetr": 0, ~/~/ ериметр, м 5721 5721 "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд 5722 5722 } 5545 + 5546 + 5547 +== **Какие поля посещал объект** == 5548 + 5549 +(% class="box successmessage" %) 5550 +((( 5551 +**POST /api/v3/agroLands/visitingByVehicle** 5723 5723 ))) 5724 5724 5554 +Пример запроса: 5725 5725 5556 +{ 5557 + "vehicleId": 0, ~/~/ id объекта 5558 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 5559 + "byTime": 0, ~/~/ Объединение событий по времени 5560 + "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 5561 + "byDist": 0, ~/~/ Объединение событий по расстоянию 5562 + "from": "2025-07-29T12:20:28.815Z", ~/~/ Начало периода (локальное время клиента) 5563 + "to": "2025-07-29T12:20:28.815Z", ~/~/ Конец периода (локальное время клиента) 5564 + "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5565 +} 5566 + 5567 +Пример ответа: 5568 + 5569 +[ 5570 + { 5571 + "fieldId": 0, ~/~/ id объекта 5572 + "vehicleName": "string", ~/~/ Наименование объекта 5573 + "fieldName": "string", ~/~/ Наименование поля 5574 + "fuelUsage": 0, ~/~/ Расход топлива, л/га 5575 + "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата) 5576 + "vehicleId": 0, ~/~/ Идентификатор ТС 5577 + "start": "2025-07-29T12:20:28.855Z", ~/~/ Начало посещения 5578 + "end": "2025-07-29T12:20:28.855Z", ~/~/ Конец посещения 5579 + "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 5580 + "mileage": 0 ~/~/ Пробег 5581 + } 5582 +] 5583 +))) 5584 + 5585 + 5586 +== **Посещение поля объектами ** == 5587 + 5588 +(% class="box successmessage" %) 5589 +((( 5590 +**POST /api/v3/agroLands/visitingByField** 5591 +))) 5592 + 5593 +Пример запроса: 5594 +{ 5595 + "fieldId": 0, ~/~/ ID поля 5596 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 5597 + "byTime": 0, ~/~/ Объединение событий по времени 5598 + "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 5599 + "byDist": 0, ~/~/ Объединение событий по расстоянию 5600 + "from": "2025-07-29T11:44:28.218Z", ~/~/ Начало периода (локальное время клиента) 5601 + "to": "2025-07-29T11:44:28.218Z", ~/~/ Конец периода (локальное время клиента) 5602 + "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5603 +} 5604 + 5605 +Пример ответа: 5606 + 5607 +[ 5608 + { 5609 + "fieldId": 0, ~/~/ ID поля 5610 + "vehicleName": "string", ~/~/ Наименование объекта 5611 + "fieldName": "string", ~/~/ Имя поля 5612 + "fuelUsage": 0, ~/~/ Расход топлива, л/га 5613 + "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата) 5614 + "vehicleId": 0, ~/~/ Идентификатор ТС 5615 + "start": "2025-07-29T11:44:28.219Z", ~/~/ Начало посещения 5616 + "end": "2025-07-29T11:44:28.219Z", ~/~/ Конец посещения 5617 + "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 5618 + "mileage": 0 ~/~/ Пробег 5619 + } 5620 +] 5621 + 5622 + 5623 +== **Удаление существующего поля** == 5624 + 5625 +(% class="box errormessage" %) 5626 +((( 5627 +**DELETE /api/v3/agroLands/{id}** 5628 +))) 5629 + 5630 +Пример запроса: 5631 +id ~/~/ Идентификатор поля 5632 + 5633 +Пример ответа: 5634 + 5635 +((( 5636 +200 ~/~/ Успех 5637 + 5638 + 5639 +))) 5640 + 5726 5726 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5727 5727 ))) 5728 5728 ))) ... ... @@ -6206,14 +6206,14 @@ 6206 6206 = **Раздел: Локатор ** = 6207 6207 6208 6208 6209 -== **Получение списка локаторов,доступных пользователю** ==6124 +== **Получение данных по локатору** == 6210 6210 6211 6211 (% class="box infomessage" %) 6212 6212 ((( 6213 -**GET /api/v3/locators **6128 +**GET /api/v3/locators/{locatorId}** 6214 6214 ))) 6215 6215 6216 -В за головкахзапроса:X-Auth:Токен авторизации6131 +В запросе указывается locatorid - идентификатор локатора 6217 6217 6218 6218 6219 6219 Пример ответа: ... ... @@ -6221,13 +6221,13 @@ 6221 6221 ((( 6222 6222 ((( 6223 6223 { 6224 - "vehiclesIds": [ ~/~/ Объекты6139 + "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6225 6225 0 6226 6226 ], 6227 - "geoIds": [ ~/~/ Геозоны6142 + "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6228 6228 0 6229 6229 ], 6230 - "fieldsIds": [ ~/~/ Поля6145 + "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 6231 6231 0 6232 6232 ], 6233 6233 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. ... ... @@ -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 6164 + "language": 0, ~/~/ ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6165 + 6166 + "showVehicleName": true, ~/~/ Наименование объекта 6167 + "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6168 + "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6169 + "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6170 + "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6171 + "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ГИС) 6172 + 6173 + 1 6174 + 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 ... ... @@ -6315,21 +6315,25 @@ 6315 6315 "autoProlongation": true, ~/~/ Автопродление срока действия. 6316 6316 "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6317 6317 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6318 - "vehiclesIds": [ ~/~/ Oбъекты6207 + "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6319 6319 0 6320 6320 ], 6321 - "geoIds": [ ~/~/ Геозоны6210 + "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6322 6322 0 6323 6323 ], 6324 - "fieldsIds": [ ~/~/ Поля6213 + "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ГИС) 6216 + 6217 + "showVehicleName": true, ~/~/ Наименование объекта 6218 + "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6219 + "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6220 + "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6221 + "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6222 + "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ГИС) 6223 + 6224 + 1 6225 + 6333 6333 ] 6334 6334 } 6335 6335 ))) ... ... @@ -6342,7 +6342,69 @@ 6342 6342 ))) 6343 6343 6344 6344 6238 +== **Выводит список локаторов ** == 6345 6345 6240 +(% class="box successmessage" %) 6241 +((( 6242 +**POST /api/v3/locators/find** 6243 +))) 6244 + 6245 +Пример запроса: 6246 + 6247 +((( 6248 +{ 6249 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента 6250 +} 6251 +))) 6252 + 6253 +((( 6254 + 6255 +))) 6256 + 6257 +((( 6258 + 6259 +))) 6260 + 6261 + 6262 +Пример ответа: 6263 + 6264 +((( 6265 +[ 6266 + { 6267 + "vehiclesCount": 0, ~/~/ Количество объектов. 6268 + "geozonesCount": 0, ~/~/ Количество геозон. 6269 + "fieldsCount": 0, ~/~/ Количество полей. 6270 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. 6271 + "agentGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента. 6272 + "agentName": "string", ~/~/ Наименование агента. 6273 + "isEnabled": true, ~/~/ Активность локатора 6274 + "created": "2025-07-03T12:57:58.738Z", ~/~/ Дата создания 6275 + "updated": "2025-07-03T12:57:58.738Z", ~/~/ Дата обновления 6276 + "name": "string", ~/~/ Наименование локатора 6277 + "status": 0, ~/~/ Определяет статус пользователя локатора (0 - Активный, 1 - Запланированный, 2 - Неактивный) 6278 + "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - сейчас, 1 - Запустить ко времени ) 6279 + "activationTime": "2025-07-03T12:57:58.738Z", ~/~/ Дата и время активации правила (UTC) 6280 + "validity": 0, ~/~/ Срок действия в днях (1-90) 6281 + "validityType": 0, ~/~/ Тип значения срока действия (Дни = 0, Часы = 1, Минуты = 2) 6282 + "autoProlongation": true, ~/~/ Автоматическая пролонгация 6283 + "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6284 + "creatorUserName": "string", ~/~/ Наименование пользователя создавшего локатора 6285 + "url": "string", ~/~/ ссылка на локатор 6286 + "language": 1, ~/~/ Язык локатора(1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6287 + "showVehicleName": true, ~/~/ Наименование объекта 6288 + "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6289 + "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6290 + "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6291 + "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6292 + "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ГИС) 6293 + 6294 + 0 6295 + ] 6296 + } 6297 +] 6298 +))) 6299 + 6300 + 6346 6346 == **Изменение локатора** == 6347 6347 6348 6348 (% class="box infomessage" %) ... ... @@ -6362,21 +6362,24 @@ 6362 6362 "validity": 0, ~/~/ Срок действия в днях (1-90) 6363 6363 "autoProlongation": true, ~/~/ Автопродление срока действия 6364 6364 "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6365 - "vehiclesIds": [ ~/~/Oбъекты6320 + "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6366 6366 0 6367 6367 ], 6368 - "geoIds": [ ~/~/ Геозоны6323 + "geoIds": [ ~/~/ ID геозон отображающихся в локаторе, записываются через запятую 6369 6369 0 6370 6370 ], 6371 - "fieldsIds": [ ~/~/ Поля6326 + "fieldsIds": [ ~/~/ ID полей отображающихся в локаторе, записываются через запятую 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ГИС) 6330 + "showVehicleDirection": true, ~/~/ Показывать направление движения объекта на карте 6331 + "allowTrackReport": true, ~/~/ отображение колонки и кнопок **Построить историю за сутки** 6332 + "showTrackTracing": true, ~/~/ Отображение трассировки трека на карте по ссылке. 6333 + "showSensors": true, ~/~/ Отображение заведенных датчиков на объектах 6334 + "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ГИС) 6335 + 6336 + 0 6337 + 6380 6380 ] 6381 6381 } 6382 6382 ... ... @@ -6404,7 +6404,6 @@ 6404 6404 ))) 6405 6405 6406 6406 6407 - 6408 6408 = **Раздел: Яндекс Маршруты** = 6409 6409 6410 6410 ... ... @@ -6418,7 +6418,6 @@ 6418 6418 Пример запроса: 6419 6419 Id ~/~/ Идентификатор поля 6420 6420 6421 - 6422 6422 Пример ответа: 6423 6423 6424 6424 ((( ... ... @@ -6436,7 +6436,6 @@ 6436 6436 ))) 6437 6437 6438 6438 6439 - 6440 6440 == **Добавить маршрут** == 6441 6441 6442 6442 (% class="box infomessage" %) ... ... @@ -6491,7 +6491,6 @@ 6491 6491 } 6492 6492 ))) 6493 6493 6494 - 6495 6495 Пример ответа: 6496 6496 6497 6497 ((( ... ... @@ -6522,7 +6522,6 @@ 6522 6522 ] 6523 6523 ))) 6524 6524 6525 - 6526 6526 Пример ответа: 6527 6527 6528 6528 ((( ... ... @@ -6546,7 +6546,6 @@ 6546 6546 Id ~/~/ Идентификатор поля 6547 6547 6548 6548 6549 - 6550 6550 = **Раздел: Управление доступа к машинам** = 6551 6551 6552 6552 ... ... @@ -6568,7 +6568,6 @@ 6568 6568 ))) 6569 6569 6570 6570 6571 - 6572 6572 == Задает видимость транспортных средств пользователю == 6573 6573 6574 6574 (% class="box infomessage" %) ... ... @@ -6593,10 +6593,6 @@ 6593 6593 ))) 6594 6594 6595 6595 ((( 6596 - 6597 -))) 6598 - 6599 -((( 6600 6600 Пример ответа : 6601 6601 ))) 6602 6602 ... ... @@ -6610,10 +6610,6 @@ 6610 6610 ))) 6611 6611 6612 6612 6613 - 6614 - 6615 - 6616 - 6617 6617 (% class="box" lang="en-US" style="text-align: center;" %) 6618 6618 ((( 6619 6619 (% lang="ru-RU" style="color:#000000; font-family:Liberation Serif,serif; font-size:14pt; font-style:normal; font-variant:normal" %)**По вопросам работы PUBLIC API 3.0 можно обращаться**(% lang="ru-RU" style="color:#000000; font-size:14pt" %)** на [[support@glonasssoft.ru>>mailto:support@glonasssoft.ru]] **