Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Михаил Жучков on 2025/10/30 11:26
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. SupportZhuchkov1 +XWiki.Gadmin - Content
-
... ... @@ -202,7 +202,7 @@ 202 202 (% style="color:#000000" %)Параметр запроса: 203 203 204 204 (% style="color:#000000" %){ 205 - "parentId": " (%%)string(% style="color:#000000" %)" ~/~/ для получение собственного parentId отправьте пустой запрос (пример "parentId": "" )205 + "parentId": "string" 206 206 } 207 207 208 208 (% style="color:#000000" %)Ответ: ... ... @@ -287,6 +287,28 @@ 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 + 290 290 == (% style="color:#000000; font-size:16px" %)**Редактирование клиента**(%%) == 291 291 292 292 (% class="box warningmessage" %) ... ... @@ -432,7 +432,7 @@ 432 432 [ 433 433 "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ группы пользователя, перечисление названия клиентских ролей 434 434 ], 435 - "language": 1~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский457 + "language": 0 ~/~/ Язык интерфейса пользователя 1 - Русский, 2 - Английский, 3 - Азербайджанский 436 436 } 437 437 { 438 438 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ... ... @@ -744,11 +744,6 @@ 744 744 (% style="text-align:left" %) 745 745 (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».** 746 746 747 -(% class="wikigeneratedid" id="H" %) 748 -((( 749 - 750 -))) 751 - 752 752 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Модель объекта**(%%) = 753 753 754 754 == (% style="color:#000000; font-size:16px" %)**Получение информации о модели объекта**(%%) == ... ... @@ -1057,12 +1057,6 @@ 1057 1057 "forTooltip": true, ~/~/ Отображать в подсказке 1058 1058 "forReport": true ~/~/ Отображать в отчете 1059 1059 } 1060 - ], 1061 - "vehicleGroups": [ ~/~/ Группы ТС 1062 - { 1063 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1064 - "name": "string" ~/~/ Наименование группы ТС 1065 - } 1066 1066 1067 1067 ], ~/~/ Данные с вкладки нормы 1068 1068 "consumptionPer100Km": "" , ~/~/ Расход топлива на 100 км (если заполнено, то consumptionPerHour не может быть заполнено) ... ... @@ -1113,7 +1113,7 @@ 1113 1113 "type": 0, ~/~/ Тип датчика 1114 1114 "name": "string", ~/~/ Имя датчика 1115 1115 "inputType": 0, ~/~/ Тип входа, Analog, Digital, Impulse, ImpulseFrequency, Diagnosis, Rs485, Rs232, Wire, FMS, BLE 1116 - "p arameterName":"string", ~/~/Имяпараметра(взамен связки Input type + port number)1127 + "inputNumber": 0, ~/~/ Номер входа 1117 1117 "pseudonym": "string", ~/~/ Псевдоним 1118 1118 "medianDegree": 0, ~/~/ Медианная фильтрация 1119 1119 "isInverted": true, ~/~/ Инвертировать, true - Вкл., false - Выкл. ... ... @@ -1146,31 +1146,27 @@ 1146 1146 "additionalProp3": "string" 1147 1147 }, 1148 1148 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 - ], 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 + } 1161 1161 "drivers": [ ~/~/ Водители 1162 1162 { 1163 1163 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1164 1164 "name": "string", ~/~/ Наименование 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" ~/~/ Момент времени создания назначения. 1178 + "description": "string", 1179 + "isDefault": true ~/~/ По умолчанию 1171 1171 } 1172 - ] 1173 - } 1174 1174 ], 1175 1175 "inspectionTasks": [ ~/~/ Задания на тех. обслуживание 1176 1176 { ... ... @@ -2382,7 +2382,7 @@ 2382 2382 Тело запроса: 2383 2383 2384 2384 { 2385 - "sampling": 86400, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой.2392 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2386 2386 "vehicleIds": [0], ~/~/ Список ID объектов 2387 2387 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2388 2388 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -2412,7 +2412,7 @@ 2412 2412 } 2413 2413 ] 2414 2414 2415 -== (% style="color:#000000; font-size:16px" %)**Получение данных о расходе т оплива транспортнымсредством**(%%) ==2422 +== (% style="color:#000000; font-size:16px" %)**Получение данных о расходе транспортного средства**(%%) == 2416 2416 2417 2417 (% class="box infomessage" %) 2418 2418 ((( ... ... @@ -2429,8 +2429,7 @@ 2429 2429 Тело запроса: 2430 2430 2431 2431 { 2432 - 2433 - "sampling": 86400, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2439 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2434 2434 "vehicleIds": [0], ~/~/ Список ID объектов 2435 2435 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2436 2436 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -2463,6 +2463,7 @@ 2463 2463 (% class="box warningmessage" %) 2464 2464 ((( 2465 2465 Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"". 2472 +\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling". 2466 2466 ))) 2467 2467 2468 2468 == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == ... ... @@ -2501,19 +2501,11 @@ 2501 2501 { 2502 2502 "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 2503 2503 2504 -((( 2505 2505 "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 2506 2506 "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 2507 2507 "valueFuel": 0, ~/~/ Количество 2508 2508 "fuelStart": 0, ~/~/ Уровень топлива на начало события 2509 2509 "fuelEnd": 0 ~/~/ Уровень топливо на конец события 2510 -))) 2511 - 2512 -((( 2513 - "latitude": 0, ~/~/ Широта. 2514 - "longitude": 0 ~/~/ Долгота. 2515 -))) 2516 - 2517 2517 } 2518 2518 ] 2519 2519 } ... ... @@ -2587,54 +2587,185 @@ 2587 2587 В заголовках запроса: X-Auth: Токен авторизации 2588 2588 2589 2589 2590 -В массивеуказываемid объектов через запятую2589 +В теле запроса перечисляете массив id объектов, в квадратных скобках через запятую. 2591 2591 2592 2592 Ответ: 2593 - 2594 -[ 2595 2595 { 2596 - "vehicleId": 55728, ~/~/Идентификатор объекта2597 - "vehicleGuid": "fa 9c0357-9b9f-44b9-a89c-20a2cb80a9ad",~/~/Guidобъекта2598 - "vehicleNumber": " 0105 КМ",~/~/Номер объекта2599 - "receiveTime": "202 5-06-27T12:37:46.7782735Z",~/~/Время идатапоступления данных2600 - "recordTime": "202 5-06-27T12:37:19Z",~/~/Время идатаформированиеданных2601 - "state": 4,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4.2602 - "speed": 31,~/~/Скорость объекта2603 - "course": 116,~/~/Курс движения [0;360]2604 - "latitude": 45.722128,~/~/Широта [-90°;90°].2605 - "longitude": 39.800432,~/~/Долгота [-180°;180°].2606 - "address": " \"Краснодарский край Россия 45,722128°, 39,800432°\"",~/~/Адрес2607 - "geozones": [ ~/~/ Сведения по геозонам.2593 + "vehicleId": 0, ~/~/Идентификатор объекта. 2594 + "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",~/~/Идентификатор объекта. 2595 + "vehicleNumber": "string",~/~/Номер объекта. 2596 + "receiveTime": "2024-02-27T14:11:00.315Z",~/~/Время получения записи на сервере, т.е. время срабатывания + время передачи от устройства на сервер 2597 + "recordTime": "2024-02-27T14:11:00.315Z",~/~/Время записи от устройства, т.е. время фактического события на транспортном средстве. 2598 + "state": 0,~/~/Определяет состояния объекта в мониторинге: нет данных - 0; отключена - 1; остановка - 2; стоянка - 3; в движении - 4. 2599 + "speed": 0,~/~/Скорость объекта. 2600 + "course": 0,~/~/Курс движения [0;360] 2601 + "latitude": 0,~/~/Широта [-90°;90°]. 2602 + "longitude": 0,~/~/Долгота [-180°;180°]. 2603 + "address": "string",~/~/Адрес. 2604 + "geozones": [ ~/~/Сведения по геозонам. 2608 2608 { 2609 - "id": 10225647, ~/~/ ID Геозоны 2610 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2611 - }, 2612 - { 2613 - "id": 10282875, ~/~/ ID Геозоны 2614 - "name": "Ё2" ~/~/ Наименование геозоны 2615 - }, 2616 - { 2617 - "id": 10226240, ~/~/ ID Геозоны 2618 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2619 - }, 2620 - { 2621 - "id": 9747869, ~/~/ ID Геозоны 2622 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2623 - }, 2624 - { 2625 - "id": 10221123, ~/~/ ID Геозоны 2626 - "name": "53r" ~/~/ Наименование геозоны 2627 - }, 2628 - { 2629 - "id": 10197638, ~/~/ ID Геозоны 2630 - "name": "Предприятие \"Газырское\" Участок №7/Поле 7-11/1" ~/~/ Наименование геозоны 2606 + "id": 0, 2607 + "name": "string" 2631 2631 } 2632 - ] 2633 - } 2634 2634 2635 2635 2636 -= = 2611 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2637 2637 2613 +== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == 2614 + 2615 +(% class="box infomessage" %) 2616 +((( 2617 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find** 2618 +))) 2619 + 2620 +(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них. 2621 + 2622 +(% style="color:#000000" %)Метод запроса: **POST** 2623 + 2624 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/find 2625 + 2626 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2627 + 2628 +(% style="text-align:left" %) 2629 +Тело запроса: 2630 + 2631 +(% style="text-align:left" %) 2632 +{ 2633 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2634 +} 2635 + 2636 +(% style="text-align:left" %) 2637 +Ответ: 2638 + 2639 +[ 2640 + { 2641 + "id": 0, ~/~/ Идентификатор объекта геозоны 2642 + "name": "string", ~/~/ Название объекта геозоны 2643 + "type": 0, ~/~/ Тип объекта геозоны 2644 + "fname": "string", ~/~/ Имя файла 2645 + "parentId": "string", ~/~/ Идентификатор клиента 2646 + "radius": 0, ~/~/ Радиус геообъекта 2647 + "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета 2648 + "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета 2649 + "description": "string", ~/~/ Описание 2650 + "area": 0, ~/~/ Площадь, м^^2^^ 2651 + "perimetr": 0, ~/~/ Периметр, м 2652 + "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания 2653 + } 2654 +] 2655 + 2656 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по объектам**(%%) == 2657 + 2658 +(% class="box infomessage" %) 2659 +((( 2660 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/vehicles** 2661 +))) 2662 + 2663 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных объектов со всеми геообъектами за выбранный период. 2664 + 2665 +(% style="color:#000000" %)Метод запроса: **POST** 2666 + 2667 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/vehicles 2668 + 2669 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2670 + 2671 +(% style="text-align:left" %) 2672 +Тело запроса: 2673 + 2674 +{ 2675 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2676 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2677 + "ids": [ ], ~/~/ Массив id объектов 2678 + "byTime": 0, ~/~/ Объединение событий по времени 2679 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2680 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2681 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2682 +} 2683 + 2684 +Ответ: 2685 +[ 2686 + { 2687 + "geozoneId": 0, ~/~/ ID геообъекта 2688 + "geozoneName": "string", ~/~/ Название геообъекта 2689 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2690 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2691 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2692 + "vehicleId": 0, ~/~/ ID объекта 2693 + "vehicleName": "string" ~/~/ Имя объекта 2694 + } 2695 +] 2696 + 2697 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по геообъектам**(%%) == 2698 + 2699 +(% class="box infomessage" %) 2700 +((( 2701 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/geozones** 2702 +))) 2703 + 2704 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных геообъектов со всеми объектами за выбранный период. 2705 + 2706 +(% style="color:#000000" %)Метод запроса: **POST** 2707 + 2708 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/geozones 2709 + 2710 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2711 + 2712 +(% style="text-align:left" %) 2713 +Тело запроса: 2714 + 2715 +{ 2716 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2717 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2718 + "ids": [ ], ~/~/ Массив id геообъектов 2719 + "byTime": 0, ~/~/ Объединение событий по времени 2720 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2721 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2722 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2723 +} 2724 + 2725 +Ответ: 2726 + 2727 +[ 2728 + { 2729 + "geozoneId": 0, ~/~/ ID геообъекта 2730 + "geozoneName": "string", ~/~/ Название геообъекта 2731 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2732 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2733 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2734 + "vehicleId": 0, ~/~/ ID объекта 2735 + "vehicleName": "string" ~/~/ Имя объекта 2736 + } 2737 +] 2738 + 2739 + 2740 +== (% style="color:#000000; font-size:16px" %)**Обновить информацию по геозоне**(%%) == 2741 + 2742 +(% class="box successmessage" %) 2743 +((( 2744 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**PUT **(%%)**/api/v3/gis** 2745 +))) 2746 + 2747 +(% style="color:#000000" %)Метод запроса: **PUT** 2748 + 2749 +Пример запроса: 2750 + 2751 +((( 2752 +{ 2753 + "id": 0, ~/~/ Идентификатор объекта геозоны 2754 + "name": "string", ~/~/ Наименование объекта геозоны 2755 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2756 + "description": "string", ~/~/ Описание объекта геозоны 2757 + "beginCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата начала расчетов для геозоны 2758 + "endCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата окончания расчетов для геозоны 2759 + "settingsData": "string" ~/~/ Параметры отображения в формате XML. 2760 +} 2761 +))) 2762 + 2763 + 2764 +Пример ответа: 2765 + 2766 +200 ~/~/ Success 2767 + 2638 2638 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 2639 2639 2640 2640 == (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == ... ... @@ -5294,9 +5294,33 @@ 5294 5294 ))) 5295 5295 5296 5296 5427 +== **Удаление существующего поля** == 5428 + 5429 +(% class="box errormessage" %) 5297 5297 ((( 5431 +**DELETE /api/v3/agroLands/{id}** 5432 +))) 5433 + 5434 +Пример запроса: 5435 +id ~/~/ Идентификатор поля 5436 + 5437 +Пример ответа: 5438 + 5298 5298 ((( 5440 +200 ~/~/ Успех 5441 +))) 5442 + 5299 5299 ((( 5444 + 5445 +))) 5446 + 5447 +((( 5448 +((( 5449 +((( 5450 + 5451 +))) 5452 + 5453 +((( 5300 5300 == **Изменение поля** == 5301 5301 5302 5302 (% class="box infomessage" %) ... ... @@ -5542,102 +5542,9 @@ 5542 5542 "perimetr": 0, ~/~/ ериметр, м 5543 5543 "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд 5544 5544 } 5545 - 5546 - 5547 -== **Какие поля посещал объект** == 5548 - 5549 -(% class="box successmessage" %) 5550 -((( 5551 -**POST /api/v3/agroLands/visitingByVehicle** 5552 5552 ))) 5553 5553 5554 -Пример запроса: 5555 5555 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 - 5641 5641 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5642 5642 ))) 5643 5643 ))) ... ... @@ -6121,14 +6121,14 @@ 6121 6121 = **Раздел: Локатор ** = 6122 6122 6123 6123 6124 -== **Получение данных полокатору** ==6185 +== **Получение списка локаторов, доступных пользователю ** == 6125 6125 6126 6126 (% class="box infomessage" %) 6127 6127 ((( 6128 -**GET /api/v3/locators /{locatorId}**6189 +**GET /api/v3/locators ** 6129 6129 ))) 6130 6130 6131 -В за просе указываетсяlocatorid- идентификаторлокатора6192 +В заголовках запроса: X-Auth: Токен авторизации 6132 6132 6133 6133 6134 6134 Пример ответа: ... ... @@ -6136,13 +6136,13 @@ 6136 6136 ((( 6137 6137 ((( 6138 6138 { 6139 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую6200 + "vehiclesIds": [ ~/~/ Объекты 6140 6140 0 6141 6141 ], 6142 - "geoIds": [ ~/~/ ID геозонотображающихся в локаторе, записываются через запятую6203 + "geoIds": [ ~/~/ Геозоны 6143 6143 0 6144 6144 ], 6145 - "fieldsIds": [ ~/~/ ID полей отображающихсяв локаторе, записываются через запятую6206 + "fieldsIds": [ ~/~/ Поля 6146 6146 0 6147 6147 ], 6148 6148 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора. ... ... @@ -6161,17 +6161,14 @@ 6161 6161 "creatorUserId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID пользователя, создавшего локатор. 6162 6162 "creatorUserName": "string", ~/~/ Имя пользователя, создавшего локатор. 6163 6163 "url": "string", ~/~/ Ссылка 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 - 6225 + "language": 0, ~/~/ Язык 6226 + "showVehicleName": true, ~/~/ Наименование объекта 6227 + "showVehicleDirection": true, ~/~/ Направление движения на треке 6228 + "allowTrackReport": true, ~/~/ Трек 6229 + "showTrackTracing": true, ~/~/ Трассировка трека 6230 + "showSensors": true, ~/~/ Датчик 6231 + "availableMapLayers": [ ~/~/ Слои на карте 6232 + 0 6175 6175 ] 6176 6176 } 6177 6177 ))) ... ... @@ -6178,9 +6178,38 @@ 6178 6178 ))) 6179 6179 6180 6180 6239 +== **Получение перечня моделей ** == 6240 + 6241 +(% class="box successmessage" %) 6181 6181 ((( 6243 +**POST /api/v3/models/find** 6244 +))) 6245 + 6246 +Пример запроса: 6247 + 6182 6182 ((( 6249 +((( 6250 +{ 6251 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6252 + "name": "string", ~/~/ Наименование локатора 6253 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор родительского элемента пользователей 6254 +))) 6255 + 6256 + 6257 + 6258 + Пример ответа: 6183 6183 6260 + 6261 +((( 6262 +[ 6263 + { 6264 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6265 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя, для которого надо получить данные 6266 + "parentName": "string", ~/~/ Наименование пользователя, для которого надо получить данные 6267 + "name": "string", ~/~/ Наименование локатора 6268 + "modelType": 0 ~/~/ Типы моделей транспортных средств (0 - None, 1 - Агро, 2 - Перевозчик, 3 - Машины) 6269 + } 6270 +] 6184 6184 ))) 6185 6185 ))) 6186 6186 ... ... @@ -6196,6 +6196,7 @@ 6196 6196 6197 6197 ((( 6198 6198 { 6286 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор локатора 6199 6199 "isEnabled": true, ~/~/ Активность 6200 6200 "name": "string", ~/~/ Наименование локатора 6201 6201 "activationMode": 0, ~/~/ Определяет вид активации локаторов (0 - Сейчас, 1 - Запустить ко времени) ... ... @@ -6202,28 +6202,26 @@ 6202 6202 "activationTime": "2025-03-12T07:00:08.272Z", ~/~/ Время активации 6203 6203 "validity": 0, ~/~/ Срок действия в днях (1-90) 6204 6204 "autoProlongation": true, ~/~/ Автопродление срока действия. 6205 - "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6293 + "url": "string", ~/~/ Ссылка 6294 + "language": 0 ~/~/ Язык 6206 6206 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6207 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую6296 + "vehiclesIds": [ ~/~/ Oбъекты 6208 6208 0 6209 6209 ], 6210 - "geoIds": [ ~/~/ ID геозонотображающихся в локаторе, записываются через запятую6299 + "geoIds": [ ~/~/ Геозоны 6211 6211 0 6212 6212 ], 6213 - "fieldsIds": [ ~/~/ ID полей отображающихсяв локаторе, записываются через запятую6302 + "fieldsIds": [ ~/~/ Поля 6214 6214 0 6215 6215 ], 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 - 6226 - ] 6305 + "showVehicleName": true, ~/~/ Наименование объекта 6306 + "showVehicleDirection": true, ~/~/ Направление движения на треке 6307 + "allowTrackReport": true, ~/~/ Трек 6308 + "showTrackTracing": true, ~/~/ Трассировка трека 6309 + "showSensors": true, ~/~/ Датчик 6310 + "availableMapLayers": [ ~/~/ Слои на карте (по умолчанию OpenStreetMap) 6311 + 0 6312 + ] 6227 6227 } 6228 6228 ))) 6229 6229 ... ... @@ -6235,69 +6235,7 @@ 6235 6235 ))) 6236 6236 6237 6237 6238 -== **Выводит список локаторов ** == 6239 6239 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 - 6301 6301 == **Изменение локатора** == 6302 6302 6303 6303 (% class="box infomessage" %) ... ... @@ -6316,25 +6316,25 @@ 6316 6316 "activationTime": "2025-03-12T07:07:53.002Z", ~/~/ Время активации 6317 6317 "validity": 0, ~/~/ Срок действия в днях (1-90) 6318 6318 "autoProlongation": true, ~/~/ Автопродление срока действия 6319 - "language": 1 ~/~/ Язык (1- Русский, 2- Английский, 3- Азербайджанский, 4 - Испанский) 6320 - "vehiclesIds": [ ~/~/ ID объектов отображающихся в локаторе, записываются через запятую 6343 + "url": "string", ~/~/ Ссылка 6344 + "language": 0 ~/~/ Язык 6345 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента. 6346 + "vehiclesIds": [ ~/~/ Oбъекты 6321 6321 0 6322 6322 ], 6323 - "geoIds": [ ~/~/ ID геозонотображающихся в локаторе, записываются через запятую6349 + "geoIds": [ ~/~/ Геозоны 6324 6324 0 6325 6325 ], 6326 - "fieldsIds": [ ~/~/ ID полей отображающихсяв локаторе, записываются через запятую6352 + "fieldsIds": [ ~/~/ Поля 6327 6327 0 6328 6328 ], 6329 6329 "showVehicleName": true, ~/~/ Наименование объекта 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 - 6356 + "showVehicleDirection": true, ~/~/ Направление движения на треке 6357 + "allowTrackReport": true, ~/~/ Трек 6358 + "showTrackTracing": true, ~/~/ Трассировка трека 6359 + "showSensors": true, ~/~/ Датчик 6360 + "availableMapLayers": [ ~/~/ Слои на карте (по умолчанию OpenStreetMap) 6336 6336 0 6337 - 6338 6338 ] 6339 6339 } 6340 6340 ... ... @@ -6362,6 +6362,7 @@ 6362 6362 ))) 6363 6363 6364 6364 6389 + 6365 6365 = **Раздел: Яндекс Маршруты** = 6366 6366 6367 6367 ... ... @@ -6375,6 +6375,7 @@ 6375 6375 Пример запроса: 6376 6376 Id ~/~/ Идентификатор поля 6377 6377 6403 + 6378 6378 Пример ответа: 6379 6379 6380 6380 ((( ... ... @@ -6392,6 +6392,7 @@ 6392 6392 ))) 6393 6393 6394 6394 6421 + 6395 6395 == **Добавить маршрут** == 6396 6396 6397 6397 (% class="box infomessage" %) ... ... @@ -6446,6 +6446,7 @@ 6446 6446 } 6447 6447 ))) 6448 6448 6476 + 6449 6449 Пример ответа: 6450 6450 6451 6451 ((( ... ... @@ -6476,6 +6476,7 @@ 6476 6476 ] 6477 6477 ))) 6478 6478 6507 + 6479 6479 Пример ответа: 6480 6480 6481 6481 ((( ... ... @@ -6499,6 +6499,7 @@ 6499 6499 Id ~/~/ Идентификатор поля 6500 6500 6501 6501 6531 + 6502 6502 = **Раздел: Управление доступа к машинам** = 6503 6503 6504 6504 ... ... @@ -6520,6 +6520,7 @@ 6520 6520 ))) 6521 6521 6522 6522 6553 + 6523 6523 == Задает видимость транспортных средств пользователю == 6524 6524 6525 6525 (% class="box infomessage" %) ... ... @@ -6544,6 +6544,10 @@ 6544 6544 ))) 6545 6545 6546 6546 ((( 6578 + 6579 +))) 6580 + 6581 +((( 6547 6547 Пример ответа : 6548 6548 ))) 6549 6549 ... ... @@ -6557,6 +6557,10 @@ 6557 6557 ))) 6558 6558 6559 6559 6595 + 6596 + 6597 + 6598 + 6560 6560 (% class="box" lang="en-US" style="text-align: center;" %) 6561 6561 ((( 6562 6562 (% 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]] **