Изменения документа Методы API для работы с ГЛОНАССSoft
Редактировал(а) Андрей Калиновский 2025/09/16 11:13
<
отредактировано Андрей Калиновский
на 2025/09/16 11:13
на 2025/09/16 11:13
отредактировано Андрей Калиновский
на 2025/07/29 15:41
на 2025/07/29 15:41
Изменить комментарий:
К данной версии нет комментариев
Комментарий
Подробности
- Свойства страницы
-
- Содержимое
-
... ... @@ -744,10 +744,7 @@ 744 744 (% style="text-align:left" %) 745 745 (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».** 746 746 747 -(% class="wikigeneratedid" id="H" %) 748 -((( 749 - 750 -))) 747 += = 751 751 752 752 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Модель объекта**(%%) = 753 753 ... ... @@ -2419,6 +2419,7 @@ 2419 2419 Тело запроса: 2420 2420 2421 2421 { 2419 + "sampling": 86400, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 2422 2422 "vehicleIds": [0], ~/~/ Список ID объектов 2423 2423 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2424 2424 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -2451,6 +2451,7 @@ 2451 2451 (% class="box warningmessage" %) 2452 2452 ((( 2453 2453 Максимальное допустимое количество периодов в ответе - 1440. При превышении этого значения будет получена ошибка ""ApiCode":204,"ApiMessage":"Прислана неправильная модель","Message":"Задан слишком маленький период дискретизации"". 2452 +\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "sampling". 2454 2454 ))) 2455 2455 2456 2456 == (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == ... ... @@ -2489,19 +2489,11 @@ 2489 2489 { 2490 2490 "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 2491 2491 2492 -((( 2493 2493 "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 2494 2494 "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 2495 2495 "valueFuel": 0, ~/~/ Количество 2496 2496 "fuelStart": 0, ~/~/ Уровень топлива на начало события 2497 2497 "fuelEnd": 0 ~/~/ Уровень топливо на конец события 2498 -))) 2499 - 2500 -((( 2501 - "latitude": 0, ~/~/ Широта. 2502 - "longitude": 0 ~/~/ Долгота. 2503 -))) 2504 - 2505 2505 } 2506 2506 ] 2507 2507 } ... ... @@ -2621,8 +2621,163 @@ 2621 2621 } 2622 2622 2623 2623 2624 -= = 2615 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2625 2625 2617 +== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == 2618 + 2619 +(% class="box infomessage" %) 2620 +((( 2621 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find** 2622 +))) 2623 + 2624 +(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них. 2625 + 2626 +(% style="color:#000000" %)Метод запроса: **POST** 2627 + 2628 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/find 2629 + 2630 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2631 + 2632 +(% style="text-align:left" %) 2633 +Тело запроса: 2634 + 2635 +(% style="text-align:left" %) 2636 +{ 2637 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2638 +} 2639 + 2640 +(% style="text-align:left" %) 2641 +Ответ: 2642 + 2643 +[ 2644 + { 2645 + "id": 0, ~/~/ Идентификатор объекта геозоны 2646 + "name": "string", ~/~/ Название объекта геозоны 2647 + "type": 0, ~/~/ Тип объекта геозоны 2648 + "fname": "string", ~/~/ Имя файла 2649 + "parentId": "string", ~/~/ Идентификатор клиента 2650 + "radius": 0, ~/~/ Радиус геообъекта 2651 + "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета 2652 + "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета 2653 + "description": "string", ~/~/ Описание 2654 + "area": 0, ~/~/ Площадь, м^^2^^ 2655 + "perimetr": 0, ~/~/ Периметр, м 2656 + "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания 2657 + } 2658 +] 2659 + 2660 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по объектам**(%%) == 2661 + 2662 +(% class="box infomessage" %) 2663 +((( 2664 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/vehicles** 2665 +))) 2666 + 2667 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных объектов со всеми геообъектами за выбранный период. 2668 + 2669 +(% style="color:#000000" %)Метод запроса: **POST** 2670 + 2671 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/vehicles 2672 + 2673 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2674 + 2675 +(% style="text-align:left" %) 2676 +Тело запроса: 2677 + 2678 +{ 2679 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2680 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2681 + "ids": [ ], ~/~/ Массив id объектов 2682 + "byTime": 0, ~/~/ Объединение событий по времени 2683 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2684 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2685 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2686 +} 2687 + 2688 +Ответ: 2689 +[ 2690 + { 2691 + "geozoneId": 0, ~/~/ ID геообъекта 2692 + "geozoneName": "string", ~/~/ Название геообъекта 2693 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2694 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2695 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2696 + "vehicleId": 0, ~/~/ ID объекта 2697 + "vehicleName": "string" ~/~/ Имя объекта 2698 + } 2699 +] 2700 + 2701 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по геообъектам**(%%) == 2702 + 2703 +(% class="box infomessage" %) 2704 +((( 2705 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/geozones** 2706 +))) 2707 + 2708 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных геообъектов со всеми объектами за выбранный период. 2709 + 2710 +(% style="color:#000000" %)Метод запроса: **POST** 2711 + 2712 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/geozones 2713 + 2714 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2715 + 2716 +(% style="text-align:left" %) 2717 +Тело запроса: 2718 + 2719 +{ 2720 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2721 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2722 + "ids": [ ], ~/~/ Массив id геообъектов 2723 + "byTime": 0, ~/~/ Объединение событий по времени 2724 + "byDist": 0, ~/~/ Объединение событий по расстоянию 2725 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2726 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2727 +} 2728 + 2729 +Ответ: 2730 + 2731 +[ 2732 + { 2733 + "geozoneId": 0, ~/~/ ID геообъекта 2734 + "geozoneName": "string", ~/~/ Название геообъекта 2735 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2736 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2737 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2738 + "vehicleId": 0, ~/~/ ID объекта 2739 + "vehicleName": "string" ~/~/ Имя объекта 2740 + } 2741 +] 2742 + 2743 + 2744 +== (% style="color:#000000; font-size:16px" %)**Обновить информацию по геозоне**(%%) == 2745 + 2746 +(% class="box successmessage" %) 2747 +((( 2748 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**PUT **(%%)**/api/v3/gis** 2749 +))) 2750 + 2751 +(% style="color:#000000" %)Метод запроса: **PUT** 2752 + 2753 +Пример запроса: 2754 + 2755 +((( 2756 +{ 2757 + "id": 0, ~/~/ Идентификатор объекта геозоны 2758 + "name": "string", ~/~/ Наименование объекта геозоны 2759 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2760 + "description": "string", ~/~/ Описание объекта геозоны 2761 + "beginCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата начала расчетов для геозоны 2762 + "endCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата окончания расчетов для геозоны 2763 + "settingsData": "string" ~/~/ Параметры отображения в формате XML. 2764 +} 2765 +))) 2766 + 2767 + 2768 +Пример ответа: 2769 + 2770 +200 ~/~/ Success 2771 + 2626 2626 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 2627 2627 2628 2628 == (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == ... ... @@ -5282,9 +5282,14 @@ 5282 5282 ))) 5283 5283 5284 5284 5431 + 5285 5285 ((( 5433 + 5434 +))) 5435 + 5286 5286 ((( 5287 5287 ((( 5438 +((( 5288 5288 == **Изменение поля** == 5289 5289 5290 5290 (% class="box infomessage" %) ... ... @@ -5549,7 +5549,7 @@ 5549 5549 "byDist": 0, ~/~/ Объединение событий по расстоянию 5550 5550 "from": "2025-07-29T12:20:28.815Z", ~/~/ Начало периода (локальное время клиента) 5551 5551 "to": "2025-07-29T12:20:28.815Z", ~/~/ Конец периода (локальное время клиента) 5552 - "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5703 + "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 5553 5553 } 5554 5554 5555 5555 Пример ответа: ... ... @@ -5587,7 +5587,7 @@ 5587 5587 "byDist": 0, ~/~/ Объединение событий по расстоянию 5588 5588 "from": "2025-07-29T11:44:28.218Z", ~/~/ Начало периода (локальное время клиента) 5589 5589 "to": "2025-07-29T11:44:28.218Z", ~/~/ Конец периода (локальное время клиента) 5590 - "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5741 + "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK 5591 5591 } 5592 5592 5593 5593 Пример ответа: