Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Павел Субботин on 2025/12/11 11:25
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Gadmin1 +XWiki.subbotinpa - Content
-
... ... @@ -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" %) ... ... @@ -766,7 +766,10 @@ 766 766 (% style="text-align:left" %) 767 767 (% style="color:#000000" %)**Ответ: В случае успешного выполнения запроса вернется HTTP ответ «200».** 768 768 769 -= = 747 +(% class="wikigeneratedid" id="H" %) 748 +((( 749 + 750 +))) 770 770 771 771 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Модель объекта**(%%) = 772 772 ... ... @@ -2438,7 +2438,7 @@ 2438 2438 Тело запроса: 2439 2439 2440 2440 { 2441 - "sampling": 86400, ~/~/ Частота дискретизации всекундах, минимум 60 секунд.Весь периодразбивает на подпериоды с указанной частотой.2422 + "sampling": 86400, ~/~/ Частота дискретизации, секунд, минимум - 60 (если передано, то весь период бъётся на подпериоды с указанной частотой) 2442 2442 "vehicleIds": [0], ~/~/ Список ID объектов 2443 2443 "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 2444 2444 "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода ... ... @@ -2636,161 +2636,367 @@ 2636 2636 2637 2637 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2638 2638 2639 -== (% style="color: #000000; font-size:16px" %)**Получениеспискавсехгеообъектов**(%%) ==2620 +== (% style="color: rgb(0, 0, 0); font-size: 16px" %)**Получение информации о геозоне по ID геозоны **(%%) == 2640 2640 2641 2641 (% class="box infomessage" %) 2642 2642 ((( 2643 - (% style="color:#000000; line-height:100%" %)****(% lang="en-US" %)**POST**(%%)**/api/v3/gis/find**2624 +**GET /api/v3/gis/{geozoneId}** 2644 2644 ))) 2645 2645 2646 -(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них. 2627 +Пример запроса: 2628 +\\geozoneId ~/~/ id геозоны 2647 2647 2648 -(% style="color:#000000" %)Метод запроса: **POST** 2649 2649 2650 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/find 2631 +(% style="text-align:left" %) 2632 +Ответ: 2651 2651 2652 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2634 +((( 2635 +{ 2636 + "id": 0, ~/~/ Идентификатор объекта геозоны 2637 + "name": "string", ~/~/ Наименование объекта геозоны 2638 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2639 + "description": "string", ~/~/ Описание объекта геозоны 2640 + "beginCalc": "2025-12-04T07:13:04.658Z", ~/~/ Дата начала расчетов для геозоны 2641 + "endCalc": "2025-12-04T07:13:04.658Z", ~/~/ Дата окончания расчетов для геозоны 2642 + "settingsData": "string", ~/~/ Параметры отображения в формате XML. 2643 + "type": 0, ~/~/ Тип геозоны - линия,полигон 2644 + "radius": 0, ~/~/ Радиус геозоны 2645 + "shape": "string", ~/~/ Координаты геозоны 2646 + "shape_format": "string" ~/~/ Формат xml,json 2647 +} 2648 +))) 2653 2653 2654 -(% style="text-align:left" %) 2655 -Тело запроса: 2650 +((( 2651 + 2652 +))) 2656 2656 2657 -(% style="text-align:left" %) 2654 +== **Удаление геообъекта ** == 2655 + 2656 +((( 2657 + 2658 +))) 2659 + 2660 +(% class="box errormessage" %) 2661 +((( 2662 +**DELETE /api/v3/gis/{geozoneId}** 2663 +))) 2664 + 2665 +((( 2666 +Пример запроса: 2667 +))) 2668 + 2669 +((( 2670 + 2671 +))) 2672 + 2673 +((( 2674 +geozoneId ~/~/ Id геообъекта 2675 +))) 2676 + 2677 +((( 2678 + 2679 +))) 2680 + 2681 +((( 2682 +Пример ответа: 2683 +))) 2684 + 2685 +((( 2686 + 2687 +))) 2688 + 2689 +((( 2690 +200 ~/~/ Success 2691 +))) 2692 + 2693 +((( 2694 + 2695 +))) 2696 + 2697 +== **Возвращение данных по пересечению объектами геозон ** == 2698 + 2699 +((( 2700 + 2701 +))) 2702 + 2703 +(% class="box successmessage" %) 2704 +((( 2705 +**POST /api/v3/gis/intersections/geozones** 2706 +))) 2707 + 2708 +((( 2709 +Пример запроса: 2710 +))) 2711 + 2712 +((( 2713 +((( 2658 2658 { 2659 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 2715 + "startDate": "2025-12-04T07:19:27.628Z", ~/~/ Дата и время начала расчета 2716 + "endDate": "2025-12-04T07:19:27.628Z", ~/~/ Дата и время конца расчета 2717 + "ids": [ ~/~/ Идентификаторы объектов 2718 + 0 2719 + ], 2720 + "byTime": 0, ~/~/ объединение геообъектов по времени (секунды) 2721 + "byDist": 0, ~/~/ объединение геообъектов по расстоянию(метры) 2722 + "filterByTime": 0, ~/~/ Фильтрация посещений по времени, сек. 2723 + "filterByHalfPerimeter": true, ~/~/ Фильтрация по половине периметра геообъекта 2724 + "includeMotoHours": true ~/~/ Флаг, включать ли моточасы в отчет 2660 2660 } 2726 +))) 2727 +))) 2661 2661 2662 -(% style="text-align:left" %) 2663 -Ответ: 2729 +((( 2730 + 2731 +))) 2664 2664 2733 +((( 2734 +Пример ответа: 2735 +))) 2736 + 2737 +((( 2738 +((( 2665 2665 [ 2666 2666 { 2667 - "id": 0, ~/~/ Идентификатор объекта геозоны 2668 - "name": "string", ~/~/ Название объекта геозоны 2669 - "type": 0, ~/~/ Тип объекта геозоны 2670 - "fname": "string", ~/~/ Имя файла 2671 - "parentId": "string", ~/~/ Идентификатор клиента 2672 - "radius": 0, ~/~/ Радиус геообъекта 2673 - "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета 2674 - "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета 2675 - "description": "string", ~/~/ Описание 2676 - "area": 0, ~/~/ Площадь, м^^2^^ 2677 - "perimetr": 0, ~/~/ Периметр, м 2678 - "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания 2741 + "geozoneId": 0, ~/~/ ID геозоны 2742 + "geozoneName": "string", ~/~/ Наименование геозоны 2743 + "startDate": "2025-12-04T07:19:27.629Z", ~/~/ Дату и время входа из геозоны 2744 + "endDate": "2025-12-04T07:19:27.629Z", ~/~/ Дату и время выхода из геозоны 2745 + "duration": 0, ~/~/ Продолжительность внутри геозоны 2746 + "vehicleId": 0, ~/~/ ID объекта 2747 + "vehicleName": "string", ~/~/ Имя объекта 2748 + "motoHours": 0 ~/~/ Моточасы 2679 2679 } 2680 2680 ] 2751 +))) 2752 +))) 2681 2681 2682 -== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по объектам**(%%) == 2683 - 2684 -(% class="box infomessage" %) 2685 2685 ((( 2686 - (%style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/vehicles**2755 + 2687 2687 ))) 2688 2688 2689 - (% style="color:#000000"%)Метод позволяет получитьсписокпересеченийвыбранныхобъектов совсеми геообъектамизавыбранный период.2758 +== **Возвращение данных по пересечению геозон для объектов с заданными ID ** == 2690 2690 2691 -(% style="color:#000000" %)Метод запроса: **POST** 2760 +((( 2761 + 2762 +))) 2692 2692 2693 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/vehicles 2764 +(% class="box successmessage" %) 2765 +((( 2766 +**POST /api/v3/gis/intersections/vehicles** 2767 +))) 2694 2694 2695 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2769 +((( 2770 +Пример запроса: 2771 +))) 2696 2696 2697 -(% style="text-align:left" %) 2698 -Тело запроса: 2773 +((( 2774 + 2775 +))) 2699 2699 2777 +((( 2778 +((( 2700 2700 { 2701 - "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2702 - "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2703 - "ids": [ ], ~/~/ Массив id объектов 2704 - "byTime": 0, ~/~/ Объединение событий по времени 2705 - "byDist": 0, ~/~/ Объединение событий по расстоянию 2706 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2707 - "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2780 + "startDate": "2025-12-04T07:26:11.520Z", ~/~/ Дата и время начала расчета 2781 + "endDate": "2025-12-04T07:26:11.520Z", ~/~/ Дата и время конца расчета 2782 + "ids": [ ~/~/ Идентификаторы объектов 2783 + 0 2784 + ], 2785 + "byTime": 0, ~/~/ объединение геообъектов по времени (секунды) 2786 + "byDist": 0, ~/~/ объединение геообъектов по расстоянию(метры) 2787 + "filterByTime": 0, ~/~/ Фильтрация посещений по времени, сек. 2788 + "filterByHalfPerimeter": true, ~/~/ Фильтрация по половине периметра геообъекта 2789 + "includeMotoHours": true ~/~/ Флаг, включать ли моточасы в отчет 2708 2708 } 2791 +))) 2792 +))) 2709 2709 2710 -Ответ: 2794 +((( 2795 + 2796 +))) 2797 + 2798 +((( 2799 +Пример ответа: 2800 +))) 2801 + 2802 +((( 2711 2711 [ 2712 2712 { 2713 - "geozoneId": 0, ~/~/ ID геоо бъекта2714 - "geozoneName": "string", ~/~/ Название геообъекта2715 - "startDate": "202 3-08-02T06:13:18.554Z", ~/~/Датавъезда2716 - "endDate": "202 3-08-02T06:13:18.554Z", ~/~/Датавыезда2717 - "duration": 0, ~/~/ Продолжительность нахождениявгеообъекте2805 + "geozoneId": 0, ~/~/ ID геозоны 2806 + "geozoneName": "string", ~/~/ Наименование геозоны 2807 + "startDate": "2025-12-04T07:19:27.629Z", ~/~/ Дату и время входа из геозоны 2808 + "endDate": "2025-12-04T07:19:27.629Z", ~/~/ Дату и время выхода из геозоны 2809 + "duration": 0, ~/~/ Продолжительность внутри геозоны 2718 2718 "vehicleId": 0, ~/~/ ID объекта 2719 - "vehicleName": "string" ~/~/ Имя объекта 2811 + "vehicleName": "string", ~/~/ Имя объекта 2812 + "motoHours": 0 ~/~/ Моточасы 2720 2720 } 2721 2721 ] 2815 +))) 2722 2722 2723 -== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по геообъектам**(%%) == 2724 - 2725 -(% class="box infomessage" %) 2726 2726 ((( 2727 - (%style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/geozones**2818 + 2728 2728 ))) 2729 2729 2730 - (% style="color:#000000"%)Метод позволяет получитьсписокпересечений выбранныхгеообъектов со всеми объектамиза выбранныйпериод.2821 +== **Получение списка геозон** == 2731 2731 2732 -(% style="color:#000000" %)Метод запроса: **POST** 2823 +((( 2824 + 2825 +))) 2733 2733 2734 -(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/geozones 2827 +(% class="box successmessage" %) 2828 +((( 2829 +**POST /api/v3/gis/find** 2830 +))) 2735 2735 2736 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 2832 +((( 2833 +((( 2834 +Пример запроса: 2835 +))) 2737 2737 2738 -(% style="text-align:left" %) 2739 -Тело запроса: 2837 +((( 2838 + 2839 +))) 2740 2740 2841 +((( 2741 2741 { 2742 - "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 2743 - "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 2744 - "ids": [ ], ~/~/ Массив id геообъектов 2745 - "byTime": 0, ~/~/ Объединение событий по времени 2746 - "byDist": 0, ~/~/ Объединение событий по расстоянию 2747 - "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 2748 - "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 2843 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор клиента, для которого надо получить данные. 2749 2749 } 2845 +))) 2846 +))) 2750 2750 2751 -Ответ: 2848 +((( 2849 + 2850 +))) 2752 2752 2852 +((( 2853 +Пример ответа: 2854 +))) 2855 + 2856 +((( 2857 +((( 2753 2753 [ 2754 2754 { 2755 - "geozoneId": 0, ~/~/ ID геообъекта 2756 - "geozoneName": "string", ~/~/ Название геообъекта 2757 - "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 2758 - "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 2759 - "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 2760 - "vehicleId": 0, ~/~/ ID объекта 2761 - "vehicleName": "string" ~/~/ Имя объекта 2860 + "id": 0, ~/~/ Идентификатор объекта геозоны 2861 + "name": "string", ~/~/ Название объекта геозоны 2862 + "type": 0, ~/~/ Тип объекта геозоны 2863 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2864 + "fname": "string", ~/~/ Имя файла 2865 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента 2866 + "beginCalc": "2025-12-04T07:31:23.082Z", ~/~/ Дата начала расчетов для геозоны 2867 + "endCalc": "2025-12-04T07:31:23.082Z", ~/~/ Дата окончания расчетов для геозоны 2868 + "description": "string", ~/~/ Описание объекта геозоны 2869 + "area": 0, ~/~/ Площадь, м2 2870 + "perimetr": 0, ~/~/ Периметр, м 2871 + "createDate": "2025-12-04T07:31:23.082Z" ~/~/ Дата создания в бд 2762 2762 } 2763 2763 ] 2874 +))) 2875 +))) 2764 2764 2877 +((( 2878 + 2879 +))) 2765 2765 2766 -== (% style="color:#000000; font-size:16px" %)**Обновить информациюпогеозоне**(%%)==2881 +== **Создание геообъекта** == 2767 2767 2883 +((( 2884 + 2885 +))) 2886 + 2768 2768 (% class="box successmessage" %) 2769 2769 ((( 2770 - (% style="color:#000000; line-height:100%" %)****(% lang="en-US" %)**PUT**(%%)**/api/v3/gis**2889 +**POST /api/v3/gis** 2771 2771 ))) 2772 2772 2773 -( % style="color:#000000" %)Метод запроса: **PUT**2774 - 2892 +((( 2893 +((( 2775 2775 Пример запроса: 2895 +\\{ 2896 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор клиента 2897 + "name": "string", ~/~/ Наименование объекта геозоны 2898 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2899 + "description": "string", ~/~/ Описание объекта геозоны 2900 + "beginCalc": "2025-12-04T07:35:07.395Z", ~/~/ Дата начала расчетов для геозоны 2901 + "endCalc": "2025-12-04T07:35:07.395Z", ~/~/ Дата окончания расчетов для геозоны 2902 + "settingsData": "string", ~/~/ Параметры отображения в формате XML 2903 + "type": 0, ~/~/ Тип геозоны - линия,полигон 2904 + "radius": 0, ~/~/ Радиус геозоны 2905 + "shape": "string", ~/~/ Координаты геозоны 2906 + "shape_format": "string" ~/~/ Формат xml,json, 2907 +} 2908 +))) 2909 +))) 2776 2776 2777 2777 ((( 2912 + 2913 +))) 2914 + 2915 +((( 2916 +Пример ответа: 2917 +))) 2918 + 2919 +((( 2920 + 2921 +))) 2922 + 2923 +((( 2924 +200 ~/~/ Success 2925 +))) 2926 + 2927 +((( 2928 + 2929 +))) 2930 + 2931 +== **Редактирование геообъекта ** == 2932 + 2933 +((( 2934 + 2935 +))) 2936 + 2937 +(% class="box warningmessage" %) 2938 +((( 2939 +**PUT /api/v3/gis** 2940 +))) 2941 + 2942 +((( 2943 +((( 2944 +Пример запроса: 2778 2778 { 2779 - "id": 0, ~/~/ Идентификатор объекта геозоны 2780 - "name": "string", ~/~/ Наименование объекта геозоны 2781 - "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2782 - "description": "string", ~/~/ Описание объекта геозоны 2783 - "beginCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата начала расчетов для геозоны 2784 - "endCalc": "2025-04-24T12:10:28.751Z", ~/~/ Дата окончания расчетов для геозоны 2785 - "settingsData": "string" ~/~/ Параметры отображения в формате XML. 2946 + "id": 0, ~/~/ Идентификатор объекта геозоны 2947 + "name": "string", ~/~/ Наименование объекта геозоны 2948 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 2949 + "description": "string", ~/~/ Описание объекта геозоны 2950 + "beginCalc": "2025-12-04T07:38:55.221Z", ~/~/ Дата начала расчетов для геозоны 2951 + "endCalc": "2025-12-04T07:38:55.221Z", ~/~/ Дата окончания расчетов для геозоны 2952 + "settingsData": "string", ~/~/ Параметры отображения в формате XML. 2953 + "type": 0, ~/~/ Тип геозоны - линия,полигон 2954 + "radius": 0, ~/~/ Радиус геозоны 2955 + "shape": "string", ~/~/ Координаты геозоны 2956 + "shape_format": "string" ~/~/Формат xml,json 2786 2786 } 2787 2787 ))) 2959 +))) 2788 2788 2961 +((( 2962 + 2963 +))) 2789 2789 2790 -Пример ответа: 2965 +((( 2966 +Пример ответа: 2967 +))) 2791 2791 2969 +((( 2970 + 2971 +))) 2972 + 2973 +((( 2792 2792 200 ~/~/ Success 2975 +))) 2793 2793 2977 +((( 2978 + 2979 +))) 2980 + 2794 2794 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 2795 2795 2796 2796 == (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) == ... ... @@ -2910,10 +2910,6 @@ 2910 2910 2911 2911 ))) 2912 2912 2913 -((( 2914 - 2915 -))) 2916 - 2917 2917 Ответ: 2918 2918 2919 2919 { ... ... @@ -5450,14 +5450,9 @@ 5450 5450 ))) 5451 5451 5452 5452 5453 - 5454 5454 ((( 5455 - 5456 -))) 5457 - 5458 5458 ((( 5459 5459 ((( 5460 -((( 5461 5461 == **Изменение поля** == 5462 5462 5463 5463 (% class="box infomessage" %) ... ... @@ -5722,7 +5722,7 @@ 5722 5722 "byDist": 0, ~/~/ Объединение событий по расстоянию 5723 5723 "from": "2025-07-29T12:20:28.815Z", ~/~/ Начало периода (локальное время клиента) 5724 5724 "to": "2025-07-29T12:20:28.815Z", ~/~/ Конец периода (локальное время клиента) 5725 - "timezone": 0 ~/~/ Таймзона клиента, в часах (double). Если не передана - то считается как +3, MSK5903 + "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5726 5726 } 5727 5727 5728 5728 Пример ответа: ... ... @@ -5744,6 +5744,43 @@ 5744 5744 ))) 5745 5745 5746 5746 5925 +== **Посещение поля объектами ** == 5926 + 5927 +(% class="box successmessage" %) 5928 +((( 5929 +**POST /api/v3/agroLands/visitingByField** 5930 +))) 5931 + 5932 +Пример запроса: 5933 +{ 5934 + "fieldId": 0, ~/~/ ID поля 5935 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 5936 + "byTime": 0, ~/~/ Объединение событий по времени 5937 + "filterByHalfPerimeter": true, ~/~/ Фильтрация событий по пробегу половины периметра 5938 + "byDist": 0, ~/~/ Объединение событий по расстоянию 5939 + "from": "2025-07-29T11:44:28.218Z", ~/~/ Начало периода (локальное время клиента) 5940 + "to": "2025-07-29T11:44:28.218Z", ~/~/ Конец периода (локальное время клиента) 5941 + "timezone": 0 ~/~/ Таймзона клиента, в часах. Если не передана - то считается как +3, MSK 5942 +} 5943 + 5944 +Пример ответа: 5945 + 5946 +[ 5947 + { 5948 + "fieldId": 0, ~/~/ ID поля 5949 + "vehicleName": "string", ~/~/ Наименование объекта 5950 + "fieldName": "string", ~/~/ Имя поля 5951 + "fuelUsage": 0, ~/~/ Расход топлива, л/га 5952 + "area": 0, ~/~/ Пройдено, га (информация из встроенного агрегата в модели объекта при наличии агрегата) 5953 + "vehicleId": 0, ~/~/ Идентификатор ТС 5954 + "start": "2025-07-29T11:44:28.219Z", ~/~/ Начало посещения 5955 + "end": "2025-07-29T11:44:28.219Z", ~/~/ Конец посещения 5956 + "durationSeconds": 0, ~/~/ Продолжительность посещения внутри поля 5957 + "mileage": 0 ~/~/ Пробег 5958 + } 5959 +] 5960 + 5961 + 5747 5747 == **Удаление существующего поля** == 5748 5748 5749 5749 (% class="box errormessage" %) ... ... @@ -5864,7 +5864,6 @@ 5864 5864 5865 5865 В заголовках запроса: X-Auth: Токен авторизации 5866 5866 5867 - 5868 5868 Пример запроса: 5869 5869 5870 5870 ((( ... ... @@ -5951,7 +5951,6 @@ 5951 5951 } 5952 5952 ))) 5953 5953 5954 - 5955 5955 Пример ответа: 5956 5956 5957 5957 { ... ... @@ -6082,11 +6082,9 @@ 6082 6082 ))) 6083 6083 6084 6084 ((( 6085 - 6298 +Пример ответа: 6086 6086 ))) 6087 6087 6088 -Пример ответа: 6089 - 6090 6090 { 6091 6091 "vehicleId": 0, ~/~/ Идентификатор ТС 6092 6092 "description": "string", ~/~/ Описание ... ... @@ -6238,10 +6238,6 @@ 6238 6238 6239 6239 ))) 6240 6240 6241 -((( 6242 - 6243 -))) 6244 - 6245 6245 = **Раздел: Локатор ** = 6246 6246 6247 6247 ... ... @@ -6254,7 +6254,6 @@ 6254 6254 6255 6255 В запросе указывается locatorid - идентификатор локатора 6256 6256 6257 - 6258 6258 Пример ответа: 6259 6259 6260 6260 ((( ... ... @@ -6302,13 +6302,6 @@ 6302 6302 ))) 6303 6303 6304 6304 6305 -((( 6306 -((( 6307 - 6308 -))) 6309 -))) 6310 - 6311 - 6312 6312 == **Создание локатора** == 6313 6313 6314 6314 (% class="box successmessage" %) ... ... @@ -6351,7 +6351,6 @@ 6351 6351 } 6352 6352 ))) 6353 6353 6354 - 6355 6355 Пример ответа: 6356 6356 6357 6357 ((( ... ... @@ -6378,11 +6378,6 @@ 6378 6378 6379 6379 ))) 6380 6380 6381 -((( 6382 - 6383 -))) 6384 - 6385 - 6386 6386 Пример ответа: 6387 6387 6388 6388 ((( ... ... @@ -6422,7 +6422,6 @@ 6422 6422 ))) 6423 6423 6424 6424 6425 - 6426 6426 == **Изменение локатора** == 6427 6427 6428 6428 (% class="box infomessage" %) ... ... @@ -6487,217 +6487,15 @@ 6487 6487 ))) 6488 6488 6489 6489 6682 += = 6490 6490 6491 -= **Раздел: Яндекс Маршруты** = 6492 - 6493 - 6494 -== **Возвращение списка маршрутов** == 6495 - 6496 -(% class="box infomessage" %) 6497 6497 ((( 6498 -**GET /api/v3/TransportRoutes** 6499 -))) 6500 - 6501 -Пример запроса: 6502 -Id ~/~/ Идентификатор поля 6503 - 6504 - 6505 -Пример ответа: 6506 - 6507 6507 ((( 6508 -[ 6509 - { 6510 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ id 6511 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6512 - "name": "string", ~/~/ Наименование маршрута. 6513 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6514 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6515 - 0 6516 - ] 6517 - } 6518 -] 6519 -))) 6520 - 6521 - 6522 - 6523 -== **Добавить маршрут** == 6524 - 6525 -(% class="box infomessage" %) 6526 -((( 6527 -**POST /api/v3/TransportRoutes** 6528 -))) 6529 - 6530 -Пример запроса: 6531 -{ 6532 - "name": "string", ~/~/ Опредлеляет наименование маршрута. 6533 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6534 - "kind": 0, ~/~/ Определяет вид маршрута. (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6535 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6536 - 0 6537 - ] 6538 -} 6539 - 6540 - 6541 -Пример ответа: 6542 - 6543 -((( 6544 -{ 6545 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6546 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6547 - "name": "string", ~/~/ Определяет наименование маршрута 6548 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6549 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6550 - 0 6551 - ] 6552 -} 6553 -))) 6554 - 6555 - 6556 -== **Обновление маршрута** == 6557 - 6558 -(% class="box successmessage" %) 6559 -((( 6560 -**PUT /api/v3/TransportRoutes** 6561 -))) 6562 - 6563 -Пример запроса: 6564 - 6565 -((( 6566 -{ 6567 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6568 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6569 - "name": "string", ~/~/ Опредлеляет наименование маршрута. 6570 - "kind": 0, ~/~/ Определяет вид маршрута (0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water) 6571 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6572 - 0 6573 - ] 6574 -} 6575 -))) 6576 - 6577 - 6578 -Пример ответа: 6579 - 6580 -((( 6581 -{ 6582 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID 6583 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Id записи к которой принадлежит маршрут 6584 - "name": "string", ~/~/ Определяет наименование маршрута 6585 - "kind": 0, ~/~/ Определяет вид маршрута ( 0 - Bus, 1 - Trolley, 2 - Tram, 3 - Taxi, 4 - Water ) 6586 - "vehicles": [ ~/~/ Определяет список ТС для маршрута 6587 - 0 6588 - ] 6589 -} 6590 -))) 6591 - 6592 - 6593 -== **Получить связки маршрутов ТС** == 6594 - 6595 -(% class="box infomessage" %) 6596 -((( 6597 -**POST /api/v3/TransportRoutes/getroutesvehicles** 6598 -))) 6599 - 6600 -Пример запроса: 6601 - 6602 -((( 6603 -[ 6604 - "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ идентификатор маршрута 6605 -] 6606 -))) 6607 - 6608 - 6609 -Пример ответа: 6610 - 6611 -((( 6612 -[ 6613 - { 6614 - "vehicleId": 0, ~/~/ Опредлеляет идентификатор ТС 6615 - "routeGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Определяет идентификатор маршрута 6616 - } 6617 -] 6618 -))) 6619 - 6620 - 6621 -== **Удалить маршрут** == 6622 - 6623 -(% class="box warningmessage" %) 6624 -((( 6625 -**DELETE /api/v3/TransportRoutes/{id}** 6626 -))) 6627 - 6628 -Пример запроса: 6629 -Id ~/~/ Идентификатор поля 6630 - 6631 - 6632 - 6633 -= **Раздел: Управление доступа к машинам** = 6634 - 6635 - 6636 -== Получение списка транспортных средств видимых пользователю == 6637 - 6638 -(% class="box infomessage" %) 6639 -((( 6640 -**GET /api/v3/UserVisibleVehicles/{userId}** 6641 -))) 6642 - 6643 -Пример ответа: 6644 - 6645 -((( 6646 -{ 6647 - "vehicleIds": [ ~/~/ Идентификаторы ТС 6648 - 0 6649 - ] 6650 -} 6651 -))) 6652 - 6653 - 6654 - 6655 -== Задает видимость транспортных средств пользователю == 6656 - 6657 -(% class="box infomessage" %) 6658 -((( 6659 -**POST /api/v3/UserVisibleVehicles** 6660 -))) 6661 - 6662 -Пример запроса: 6663 - 6664 -((( 6665 -((( 6666 -{ 6667 - "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор пользователя 6668 - "vehicleIds": [ ~/~/ Идентификаторы ТС 6669 - 0 6670 - ] 6671 -} 6672 -))) 6673 - 6674 -((( 6675 6675 6676 6676 ))) 6677 - 6678 -((( 6679 - 6680 6680 ))) 6681 6681 6682 -((( 6683 -Пример ответа : 6684 -))) 6685 6685 6686 -((( 6687 - 6688 -))) 6689 - 6690 -((( 6691 -200 ~/~/ Success 6692 -))) 6693 -))) 6694 - 6695 - 6696 -== == 6697 - 6698 - 6699 - 6700 - 6701 6701 (% class="box" lang="en-US" style="text-align: center;" %) 6702 6702 ((( 6703 6703 (% 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]] **