Изменения документа Методы API для работы с ГЛОНАССSoft
Редактировал(а) Андрей Калиновский 2025/09/16 11:13
<
отредактировано Андрей Калиновский
на 2025/09/16 11:13
на 2025/09/16 11:13
отредактировано Андрей Калиновский
на 2025/09/03 09:05
на 2025/09/03 09:05
Изменить комментарий:
К данной версии нет комментариев
Комментарий
Подробности
- Свойства страницы
-
- Содержимое
-
... ... @@ -2419,6 +2419,7 @@ 2419 2419 Тело запроса: 2420 2420 2421 2421 { 2422 + "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":"Задан слишком маленький период дискретизации"". 2455 +\\При большом количестве периодов существенно растет нагрузка, синхронный запрос может выдать ошибку по таймауту. Рекомендуем не занижать необходимое значение параметра "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,168 @@ 2621 2621 } 2622 2622 2623 2623 2624 -= = 2618 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 2625 2625 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 + 2626 2626 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 2627 2627 2628 2628 == (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) ==