Изменения документа Методы API для работы с ГЛОНАССSoft
Редактировал(а) Михаил Жучков 2025/10/30 11:26
<
отредактировано Андрей Калиновский
на 2025/07/29 15:51
на 2025/07/29 15:51
отредактировано Михаил Жучков
на 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" %)Ответ: ... ... @@ -1057,6 +1057,12 @@ 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 + } 1060 1060 1061 1061 ], ~/~/ Данные с вкладки нормы 1062 1062 "consumptionPer100Km": "" , ~/~/ Расход топлива на 100 км (если заполнено, то consumptionPerHour не может быть заполнено) ... ... @@ -1107,7 +1107,7 @@ 1107 1107 "type": 0, ~/~/ Тип датчика 1108 1108 "name": "string", ~/~/ Имя датчика 1109 1109 "inputType": 0, ~/~/ Тип входа, Analog, Digital, Impulse, ImpulseFrequency, Diagnosis, Rs485, Rs232, Wire, FMS, BLE 1110 - " inputNumber":0, ~/~/Номер входа1116 + "parameterName": "string", ~/~/ Имя параметра (взамен связки Input type + port number) 1111 1111 "pseudonym": "string", ~/~/ Псевдоним 1112 1112 "medianDegree": 0, ~/~/ Медианная фильтрация 1113 1113 "isInverted": true, ~/~/ Инвертировать, true - Вкл., false - Выкл. ... ... @@ -1140,27 +1140,31 @@ 1140 1140 "additionalProp3": "string" 1141 1141 }, 1142 1142 1143 -~/~/ Характерные для произвольного: 1144 -~/~/ "EventsEnabled": "off", ~/~/ Фиксировать события работы: on, off 1145 -~/~/ "EventsTemplateName": "Работа Произвольный", ~/~/ Наименование события работы 1146 -~/~/ "EventsCountEnabled": "off", ~/~/ Фиксировать количество срабатываний: on, off 1147 -~/~/ "EventsCountTemplateName": "Количество срабатываний Произвольный", ~/~/Наименование ~/~/события количества срабатываний 1148 -~/~/ "MapDisplayEnabled": "off", ~/~/ Отображать на карте: on, off 1149 -~/~/ "ChartDisplayEnabled": "off", ~/~/ Отображать на графике объекта: on, off 1150 -~/~/ "PayloadChartDisplayEnabled": "off", ~/~/ Отображать на графике полезной нагрузки: on, off 1151 -~/~/ "DrawType": ~/~/ тип отрисовки line, bar (Линия, Область) 1152 -~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1153 -~/~/ "ValueOn": "Вкл.", 1154 -~/~/ "ValueOff": "Выкл." 1155 - "summaryMaxValue": 0 ~/~/ Макс. значение 1156 - } 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 + ], 1157 1157 "drivers": [ ~/~/ Водители 1158 1158 { 1159 1159 "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1160 1160 "name": "string", ~/~/ Наименование 1161 - "description": "string", 1162 - "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" ~/~/ Момент времени создания назначения. 1163 1163 } 1172 + ] 1173 + } 1164 1164 ], 1165 1165 "inspectionTasks": [ ~/~/ Задания на тех. обслуживание 1166 1166 { ... ... @@ -2402,7 +2402,7 @@ 2402 2402 } 2403 2403 ] 2404 2404 2405 -== (% style="color:#000000; font-size:16px" %)**Получение данных о расходе транспортн огосредства**(%%) ==2415 +== (% style="color:#000000; font-size:16px" %)**Получение данных о расходе топлива транспортным средством**(%%) == 2406 2406 2407 2407 (% class="box infomessage" %) 2408 2408 ((( ... ... @@ -2419,6 +2419,7 @@ 2419 2419 Тело запроса: 2420 2420 2421 2421 { 2432 + 2422 2422 "sampling": 86400, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2423 2423 "vehicleIds": [0], ~/~/ Список ID объектов 2424 2424 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода ... ... @@ -2452,7 +2452,6 @@ 2452 2452 (% class="box warningmessage" %) 2453 2453 ((( 2454 2454 Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"". 2455 -\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling". 2456 2456 ))) 2457 2457 2458 2458 == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == ... ... @@ -2491,11 +2491,19 @@ 2491 2491 { 2492 2492 "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 2493 2493 2504 +((( 2494 2494 "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 2495 2495 "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 2496 2496 "valueFuel": 0, ~/~/ Количество 2497 2497 "fuelStart": 0, ~/~/ Уровень топлива на начало события 2498 2498 "fuelEnd": 0 ~/~/ Уровень топливо на конец события 2510 +))) 2511 + 2512 +((( 2513 + "latitude": 0, ~/~/ Широта. 2514 + "longitude": 0 ~/~/ Долгота. 2515 +))) 2516 + 2499 2499 } 2500 2500 ] 2501 2501 } ... ... @@ -2615,163 +2615,8 @@ 2615 2615 } 2616 2616 2617 2617 2618 -= (%style="color:#000000;font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%)=2636 += = 2619 2619 2620 -== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == 2621 - 2622 -(% class="box infomessage" %) 2623 -((( 2624 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find** 2625 -))) 2626 - 2627 -(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них. 2628 - 2629 -(% style="color:#000000" %)Метод запроса: **POST** 2630 - 2631 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/find 2632 - 2633 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2634 - 2635 -(% style="text-align:left" %) 2636 -Тело запроса: 2637 - 2638 -(% style="text-align:left" %) 2639 -{ 2640 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2641 -} 2642 - 2643 -(% style="text-align:left" %) 2644 -Ответ: 2645 - 2646 -[ 2647 - { 2648 - "id": 0, ~/~/ Идентификатор объекта геозоны 2649 - "name": "string", ~/~/ Название объекта геозоны 2650 - "type": 0, ~/~/ Тип объекта геозоны 2651 - "fname": "string", ~/~/ Имя файла 2652 - "parentId": "string", ~/~/ Идентификатор клиента 2653 - "radius": 0, ~/~/ Радиус геообъекта 2654 - "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета 2655 - "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета 2656 - "description": "string", ~/~/ Описание 2657 - "area": 0, ~/~/ Площадь, м^^2^^ 2658 - "perimetr": 0, ~/~/ Периметр, м 2659 - "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания 2660 - } 2661 -] 2662 - 2663 -== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по объектам**(%%) == 2664 - 2665 -(% class="box infomessage" %) 2666 -((( 2667 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/vehicles** 2668 -))) 2669 - 2670 -(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных объектов со всеми геообъектами за выбранный период. 2671 - 2672 -(% style="color:#000000" %)Метод запроса: **POST** 2673 - 2674 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/vehicles 2675 - 2676 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2677 - 2678 -(% style="text-align:left" %) 2679 -Тело запроса: 2680 - 2681 -{ 2682 - "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2683 - "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2684 - "ids": [ ], ~/~/ Массив id объектов 2685 - "byTime": 0, ~/~/ Объединение событий по времени 2686 - "byDist": 0, ~/~/ Объединение событий по расстоянию 2687 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2688 - "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2689 -} 2690 - 2691 -Ответ: 2692 -[ 2693 - { 2694 - "geozoneId": 0, ~/~/ ID геообъекта 2695 - "geozoneName": "string", ~/~/ Название геообъекта 2696 - "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2697 - "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2698 - "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2699 - "vehicleId": 0, ~/~/ ID объекта 2700 - "vehicleName": "string" ~/~/ Имя объекта 2701 - } 2702 -] 2703 - 2704 -== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по геообъектам**(%%) == 2705 - 2706 -(% class="box infomessage" %) 2707 -((( 2708 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/geozones** 2709 -))) 2710 - 2711 -(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных геообъектов со всеми объектами за выбранный период. 2712 - 2713 -(% style="color:#000000" %)Метод запроса: **POST** 2714 - 2715 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/geozones 2716 - 2717 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2718 - 2719 -(% style="text-align:left" %) 2720 -Тело запроса: 2721 - 2722 -{ 2723 - "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2724 - "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2725 - "ids": [ ], ~/~/ Массив id геообъектов 2726 - "byTime": 0, ~/~/ Объединение событий по времени 2727 - "byDist": 0, ~/~/ Объединение событий по расстоянию 2728 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2729 - "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2730 -} 2731 - 2732 -Ответ: 2733 - 2734 -[ 2735 - { 2736 - "geozoneId": 0, ~/~/ ID геообъекта 2737 - "geozoneName": "string", ~/~/ Название геообъекта 2738 - "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2739 - "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2740 - "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2741 - "vehicleId": 0, ~/~/ ID объекта 2742 - "vehicleName": "string" ~/~/ Имя объекта 2743 - } 2744 -] 2745 - 2746 - 2747 -== (% style="color:#000000; font-size:16px" %)**Обновить информацию по геозоне**(%%) == 2748 - 2749 -(% class="box successmessage" %) 2750 -((( 2751 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**PUT **(%%)**/api/v3/gis** 2752 -))) 2753 - 2754 -(% style="color:#000000" %)Метод запроса: **PUT** 2755 - 2756 -Пример запроса: 2757 - 2758 -((( 2759 -{ 2760 - "id": 0, ~/~/ Идентификатор объекта геозоны 2761 - "name": "string", ~/~/ Наименование объекта геозоны 2762 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2763 - "description": "string", ~/~/ Описание объекта геозоны 2764 - "beginCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата начала расчетов для геозоны 2765 - "endCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата окончания расчетов для геозоны 2766 - "settingsData": "string" ~/~/ Параметры отображения в формате XML. 2767 -} 2768 -))) 2769 - 2770 - 2771 -Пример ответа: 2772 - 2773 -200 ~/~/ Success 2774 - 2775 2775 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 2776 2776 2777 2777 == (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) ==