Изменения документа Методы API для работы с ГЛОНАССSoft
Редактировал(а) Михаил Жучков 2025/10/30 11:26
<
>
отредактировано Михаил Жучков
на 2025/10/30 09:22
на 2025/10/30 09:22
отредактировано Андрей Калиновский
на 2025/09/03 09:05
на 2025/09/03 09:05
Изменить комментарий:
К данной версии нет комментариев
Комментарий
Подробности
- Свойства страницы
-
- Автор документа
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. SupportZhuchkov1 +XWiki.Gadmin - Содержимое
-
... ... @@ -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" %)Ответ: ... ... @@ -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)1110 + "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 - ], 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 + } 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" ~/~/ Момент времени создания назначения. 1161 + "description": "string", 1162 + "isDefault": true ~/~/ По умолчанию 1171 1171 } 1172 - ] 1173 - } 1174 1174 ], 1175 1175 "inspectionTasks": [ ~/~/ Задания на тех. обслуживание 1176 1176 { ... ... @@ -2412,7 +2412,7 @@ 2412 2412 } 2413 2413 ] 2414 2414 2415 -== (% style="color:#000000; font-size:16px" %)**Получение данных о расходе т оплива транспортнымсредством**(%%) ==2405 +== (% style="color:#000000; font-size:16px" %)**Получение данных о расходе транспортного средства**(%%) == 2416 2416 2417 2417 (% class="box infomessage" %) 2418 2418 ((( ... ... @@ -2429,6 +2429,7 @@ 2429 2429 Тело запроса: 2430 2430 2431 2431 { 2422 + "sampling": 86400, ~/~/ Частота дискретизации, секунд, минимум - 60 (если передано, то весь период бъётся на подпериоды с указанной частотой) 2432 2432 "vehicleIds": [0], ~/~/ Список ID объектов 2433 2433 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2434 2434 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -2461,6 +2461,7 @@ 2461 2461 (% class="box warningmessage" %) 2462 2462 ((( 2463 2463 Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"". 2455 +\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling". 2464 2464 ))) 2465 2465 2466 2466 == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == ... ... @@ -2499,19 +2499,11 @@ 2499 2499 { 2500 2500 "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 2501 2501 2502 -((( 2503 2503 "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 2504 2504 "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 2505 2505 "valueFuel": 0, ~/~/ Количество 2506 2506 "fuelStart": 0, ~/~/ Уровень топлива на начало события 2507 2507 "fuelEnd": 0 ~/~/ Уровень топливо на конец события 2508 -))) 2509 - 2510 -((( 2511 - "latitude": 0, ~/~/ Широта. 2512 - "longitude": 0 ~/~/ Долгота. 2513 -))) 2514 - 2515 2515 } 2516 2516 ] 2517 2517 } ... ... @@ -2631,8 +2631,168 @@ 2631 2631 } 2632 2632 2633 2633 2634 -= = 2618 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2635 2635 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 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2652 + "fname": "string", ~/~/ Имя файла 2653 + "parentId": "string", ~/~/ Идентификатор клиента 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 + "type": 0, ~/~/ Тип геозоны - линия,полигон 2768 + "radius": 0, ~/~/ Радиус геозоны 2769 + "shape": "string", ~/~/ Координаты геозоны 2770 + "shape_format": "string" ~/~/ Формат xml,json 2771 + 2772 +} 2773 +))) 2774 + 2775 + 2776 +Пример ответа: 2777 + 2778 +200 ~/~/ Success 2779 + 2636 2636 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 2637 2637 2638 2638 == (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) ==