Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/14 11:58
<
>
edited by Андрей Калиновский
on 2024/12/20 13:14
on 2024/12/20 13:14
edited by Андрей Калиновский
on 2024/12/20 15:47
on 2024/12/20 15:47
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -2,10 +2,6 @@ 2 2 ((( 3 3 (% class="box warningmessage" %) 4 4 ((( 5 - 6 - 7 - 8 - 9 9 (% class="mark" %)##Для обеспечения бесперебойной работы команд и серверного оборудования ГЛОНАССSoft убедительно 10 10 просим вас соблюдать несколько простых правил при использовании API-команд:## 11 11 ))) ... ... @@ -4678,7 +4678,7 @@ 4678 4678 4679 4679 = (% style="color:#000000; font-size:18.6667px" %)**Раздел: Сельскохозяйственные поля **(%%) = 4680 4680 4681 -== **Получение участкапо id** ==4677 +== **Получение поля по id** == 4682 4682 4683 4683 (% class="box infomessage" %) 4684 4684 ((( ... ... @@ -4775,7 +4775,7 @@ 4775 4775 ))) 4776 4776 4777 4777 4778 -== **Удалить участок** ==4774 +== **Удалить поле** == 4779 4779 4780 4780 (% class="box errormessage" %) 4781 4781 ((( ... ... @@ -4796,7 +4796,7 @@ 4796 4796 ))) 4797 4797 4798 4798 ((( 4799 -== **Сохранение участка** ==4795 +== **Сохранение поля** == 4800 4800 4801 4801 (% class="box successmessage" %) 4802 4802 ((( ... ... @@ -4844,10 +4844,6 @@ 4844 4844 4845 4845 ))) 4846 4846 4847 -((( 4848 - 4849 -))) 4850 - 4851 4851 Пример ответа: 4852 4852 4853 4853 ((( ... ... @@ -4939,22 +4939,20 @@ 4939 4939 ))) 4940 4940 4941 4941 ((( 4942 - 4943 -))) 4934 +== **Изменение поля** == 4944 4944 4936 +(% class="box infomessage" %) 4945 4945 ((( 4946 -== **Изменение участка** == 4947 - 4948 -(% class="box successmessage" %) 4949 -((( 4950 -PUT /api/v3/agroLands 4938 +PUT **/api/v3/agroLands** 4951 4951 ))) 4952 4952 4953 4953 Пример запроса: 4954 4954 4955 4955 ((( 4944 +((( 4956 4956 { 4957 - "extId": "string", 4946 + "id": 0, ~/~/ Идентификатор поля 4947 + "extId": "string", ~/~/ ExtId 4958 4958 "shape": "string", ~/~/ Форма поля 4959 4959 "shapeFormat": "string", ~/~/ Формат, в котором представлена форма поля 4960 4960 "display": "string", ~/~/ Настройки отображения ... ... @@ -4961,14 +4961,53 @@ 4961 4961 "year": 0, ~/~/ Год поля 4962 4962 "name": "string", ~/~/ Наименование 4963 4963 "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 4964 - "startDate": "2024-12-20T0 8:19:59.635Z", ~/~/ Начало года урожая4965 - "endDate": "2024-12-20T0 8:19:59.635Z", ~/~/ Конец года урожая4966 - "planComment": "string", ~/~/ 4967 - "cropRotations": [ ~/~/ 4954 + "startDate": "2024-12-20T10:11:59.425Z", ~/~/ Начало года урожая 4955 + "endDate": "2024-12-20T10:11:59.425Z", ~/~/ Конец года урожая 4956 + "planComment": "string", ~/~/Комментарий к полю 4957 + "cropRotations": [ ~/~/ Данные по севообороту 4968 4968 { 4969 4969 "landId": 0, ~/~/ ID поля 4970 4970 "landName": "string", ~/~/ Название поля 4971 4971 "year": 0, ~/~/ Год урожая 4962 + "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 4963 + "cultureName": "string", ~/~/ Название культуры 4964 + "productivity": 0, ~/~/ Урожайность 4965 + "area": 0, ~/~/ Площадь поля, Га. 4966 + "total": 0, ~/~/ Валовый сбор 4967 + "productivityFact": 0, ~/~/ Фактическая урожайность 4968 + "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 4969 + "totalFact": 0, ~/~/ Фактический валовый сбор 4970 + "start": "2024-12-20T10:11:59.425Z", ~/~/ Дата начала работ 4971 + "sowing": "2024-12-20T10:11:59.425Z", ~/~/ Дата сева 4972 + "harvesting": "2024-12-20T10:11:59.425Z", ~/~/ Дата уборки урожая 4973 + "isyearplan": true, 4974 + "comment": "string" ~/~/ Комментарий 4975 + } 4976 + ], 4977 + "deleteStatistic": true ~/~/ Нужно ли удалять статистику 4978 +} 4979 +))) 4980 +))) 4981 + 4982 +((( 4983 + 4984 +))) 4985 + 4986 +Пример ответа: 4987 + 4988 +((( 4989 +((( 4990 +((( 4991 +{ 4992 + "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 4993 + "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 4994 + "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 4995 + "sourceId": 0, ~/~/ Ссылка на участок прошлого года 4996 + "cropRotations": [ ~/~/ Данные по севообороту 4997 + { 4998 + "landId": 0, ~/~/ ID поля 4999 + "landName": "string", ~/~/ Название поля 5000 + "year": 0, ~/~/ Год урожая 4972 4972 "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 4973 4973 "cultureName": "string", ~/~/ Название культуры 4974 4974 "productivity": 0, ~/~/ Урожайность ... ... @@ -4977,21 +4977,92 @@ 4977 4977 "productivityFact": 0, ~/~/ Фактическая урожайность 4978 4978 "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 4979 4979 "totalFact": 0, ~/~/ Фактический валовый сбор 4980 - "start": "2024-12-20T0 8:19:59.635Z", ~/~/ Дата начала работ4981 - "sowing": "2024-12-20T0 8:19:59.635Z", ~/~/ Дата сева4982 - "harvesting": "2024-12-20T0 8:19:59.635Z", ~/~/ Дата уборки урожая4983 - "isyearplan": true, ~/~/ Годовой план5009 + "start": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала работ 5010 + "sowing": "2024-12-20T10:11:59.533Z", ~/~/ Дата сева 5011 + "harvesting": "2024-12-20T10:11:59.533Z", ~/~/ Дата уборки урожая 5012 + "isyearplan": true, ~/~/ 4984 4984 "comment": "string" ~/~/ Комментарий 4985 4985 } 4986 - ] 5015 + ], 5016 + "cropVegetation": [ ~/~/ История вегетации поля 5017 + { 5018 + "values": [ ~/~/ Данные вегетации и состояния посева 5019 + { 5020 + "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата 5021 + "ndvi": 0 ~/~/ Индекс вегетации 5022 + } 5023 + ], 5024 + "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5025 + { 5026 + "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата 5027 + "type": "string", ~/~/ Тип 5028 + "pictureid": "string" ~/~/ Идентификатор ресурса 5029 + } 5030 + ], 5031 + "states": [ ~/~/ Ключевые даты развития поля 5032 + { 5033 + "date": "2024-12-20T10:11:59.533Z", ~/~/ Дата 5034 + "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая 5035 + } 5036 + ] 5037 + } 5038 + ], 5039 + "endDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата закрытия года урожая 5040 + "counts": { 5041 + "fieldOperations": 0, ~/~/ Количество операций на поле 5042 + "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5043 + "facts": 0 ~/~/ Счётчик факта 5044 + }, 5045 + "planComment": "string", ~/~/ Комментарий к полю 5046 + "productivity": 0, ~/~/ Урожайность. 5047 + "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5048 + "startDate": "2024-12-20T10:11:59.533Z", ~/~/ Дата открытия года урожая 5049 + "year": 0, ~/~/ Год поля 5050 + "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5051 + "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5052 + "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5053 + "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто Частично С ошибкой 5054 + "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 5055 + "id": 0, ~/~/ Идентификатор объекта геозоны 5056 + "name": "string", ~/~/ Название объекта геозоны 5057 + "type": 0, ~/~/ Тип объекта геозоны 5058 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5059 + "fname": "string", ~/~/ Имя файла 5060 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5061 + "beginCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата начала расчетов для геозоны 5062 + "endCalc": "2024-12-20T10:11:59.533Z", ~/~/ Дата окончания расчетов для геозоны 5063 + "description": "string", ~/~/ Описание объекта геозоны 5064 + "area": 0, ~/~/ Площадь, м2 5065 + "perimetr": 0, ~/~/ Периметр, м 5066 + "createDate": "2024-12-20T10:11:59.533Z" ~/~/ Дата создания в бд 4987 4987 } 4988 4988 ))) 5069 +))) 5070 +))) 5071 +))) 5072 +))) 4989 4989 5074 + 5075 +== **Функция обновляет закрытие/открытие года урожая** == 5076 + 5077 +(% class="box successmessage" %) 4990 4990 ((( 4991 - 5079 +POST **/api/v3/agroLands/updateOpenCloseYear** 4992 4992 ))) 4993 4993 5082 +Пример запроса: 5083 + 4994 4994 ((( 5085 +((( 5086 +{ 5087 + "agroLandIds": [ ~/~/ Идентификаторы полей для которых меняется год урожая 5088 + 0 5089 + ], 5090 + "newStartDate": "2024-12-20T11:43:43.921Z", ~/~/ Новая дата начала урожая 5091 + "newEndDate": "2024-12-20T11:43:43.921Z" ~/~/ Новая дата закрытия урожая 5092 +} 5093 +))) 5094 + 4995 4995 4996 4996 ))) 4997 4997 ... ... @@ -5000,17 +5000,151 @@ 5000 5000 ((( 5001 5001 ((( 5002 5002 { 5003 - "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 5103 + "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5004 5004 "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5005 - "fieldId": 0, ~/~/ С 5105 + "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5106 + "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5107 + "cropRotations": [ ~/~/ Данные по севообороту 5108 + { 5109 + "landId": 0, ~/~/ ID поля 5110 + "landName": "string", ~/~/ Название поля 5111 + "year": 0, ~/~/ Год урожая 5112 + "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID культуры 5113 + "cultureName": "string", ~/~/ Название культуры 5114 + "productivity": 0, ~/~/ Урожайность 5115 + "area": 0, ~/~/ Площадь поля, Га. 5116 + "total": 0, ~/~/ Валовый сбор 5117 + "productivityFact": 0, ~/~/ Фактическая урожайность 5118 + "areaFact": 0, ~/~/ Фактическая площадь поля, Га. 5119 + "totalFact": 0, ~/~/ Фактический валовый сбор 5120 + "start": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала работ 5121 + "sowing": "2024-12-20T11:43:44.091Z", ~/~/ Дата сева 5122 + "harvesting": "2024-12-20T11:43:44.091Z", ~/~/ Дата уборки урожая 5123 + "isyearplan": true, ~/~/ 5124 + "comment": "string" ~/~/ Комментарий 5125 + } 5126 + ], 5127 + "cropVegetation": [ ~/~/ История вегетации поля 5128 + { 5129 + "values": [ ~/~/ Данные вегетации и состояния посева 5130 + { 5131 + "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5132 + "ndvi": 0 ~/~/ Индекс вегетации 5133 + } 5134 + ], 5135 + "resources": [ ~/~/ Данные о снимках для каждого значения NDVI 5136 + { 5137 + "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5138 + "type": "string", ~/~/ Тип 5139 + "pictureid": "string" ~/~/ Идентификатор ресурса 5140 + } 5141 + ], 5142 + "states": [ ~/~/ Ключевые даты развития поля 5143 + { 5144 + "date": "2024-12-20T11:43:44.091Z", ~/~/ Дата 5145 + "state": 0 ~/~/ Статус 0 - Всходы, 1 - Вершина, 2 - Сбор урожая 5146 + } 5147 + ] 5148 + } 5149 + ], 5150 + "endDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата закрытия года урожая 5151 + "counts": { 5152 + "fieldOperations": 0, ~/~/ Количество операций на поле 5153 + "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5154 + "facts": 0 ~/~/ Счётчик факта 5155 + }, 5156 + "planComment": "string", ~/~/ Комментарий к полю 5157 + "productivity": 0, ~/~/ Урожайность. 5158 + "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5159 + "startDate": "2024-12-20T11:43:44.091Z", ~/~/ Дата открытия года урожая 5160 + "year": 0, ~/~/ Год поля 5161 + "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5162 + "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5163 + "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5164 + "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5165 + "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 5166 + "id": 0, ~/~/ Идентификатор объекта геозоны 5167 + "name": "string", ~/~/ Название объекта геозоны 5168 + "type": 0, ~/~/ Тип объекта геозоны 5169 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5170 + "fname": "string", ~/~/ Имя файла 5171 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5172 + "beginCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата начала расчетов для геозоны 5173 + "endCalc": "2024-12-20T11:43:44.091Z", ~/~/ Дата окончания расчетов для геозоны 5174 + "description": "string", ~/~/ Описание объекта геозоны 5175 + "area": 0, ~/~/ Площадь, м2 5176 + "perimetr": 0, ~/~/ ериметр, м 5177 + "createDate": "2024-12-20T11:43:44.091Z" ~/~/ Дата создания в бд 5178 +} 5006 5006 ))) 5180 + 5181 + 5182 +== **Возвращает список полей** == 5183 + 5184 +(% class="box successmessage" %) 5185 +((( 5186 +POST **/api/v3/agroLands/find** 5007 5007 ))) 5188 + 5189 +Пример запроса: 5190 + 5191 +((( 5192 +((( 5193 +((( 5194 +{ 5195 + "year": 0, ~/~/ Фильтр по году 5196 + "name": "string", ~/~/ Фильтр по названию 5197 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Фильтр по подразделению 5198 +} 5008 5008 ))) 5009 5009 ))) 5010 5010 5011 5011 5012 5012 ))) 5204 + 5205 +Пример ответа: 5206 + 5207 +((( 5208 +[ 5209 + { 5210 + "sqPlan": 0, ~/~/ Определяет площадь поля, Га. 5211 + "year": 0, ~/~/ Год поля 5212 + "startDate": "2024-12-20T12:27:07.523Z", ~/~/ Начало года урожая 5213 + "endDate": "2024-12-20T12:27:07.523Z", ~/~/ Конец года урожая 5214 + "status": 0, ~/~/ Статус с/х поля 0 - нет, 1 - открыто, 2 - закрыто 5215 + "cultureId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор культуры 5216 + "cultureTechnologyId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор технологии 5217 + "counts": { ~/~/ Счётчики с/х поля 5218 + "fieldOperations": 0, ~/~/ Количество операций на поле 5219 + "actualFieldOperations": 0, ~/~/ Кол-во актуальных операций на поле 5220 + "facts": 0 ~/~/ Счётчик факта 5221 + }, 5222 + "planState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5223 + "actualPlanState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5224 + "factState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5225 + "taskState": 0, ~/~/ Статус годового планирования участка 0 - Нет, 1 - Запланированная, 2 - Запланированная ошибка, 3 - Ошибка закрытия, 4 - Закрыто, 5 - Отменено, 6 - Закрыто частично, 7 - Закрыто частично с ошибкой 5226 + "fieldId": 0, ~/~/ Ссылка на группирующее с/х поле 5227 + "sourceId": 0, ~/~/ Ссылка на участок прошлого года 5228 + "planComment": "string", ~/~/ Комментарий к полю 5229 + "productivity": 0, ~/~/ Урожайность. 5230 + "id": 0, ~/~/ Идентификатор объекта геозоны 5231 + "name": "string", ~/~/ Название объекта геозоны 5232 + "type": 0, ~/~/ Тип объекта геозоны 5233 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Подразделение 5234 + "fname": "string", ~/~/ Имя файла 5235 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Идентификатор агента 5236 + "beginCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата начала расчетов для геозоны 5237 + "endCalc": "2024-12-20T12:27:07.523Z", ~/~/ Дата окончания расчетов для геозоны 5238 + "description": "string", ~/~/ Описание объекта геозоны 5239 + "area": 0, ~/~/ Площадь, м2 5240 + "perimetr": 0, ~/~/ Периметр, м 5241 + "createDate": "2024-12-20T12:27:07.523Z" ~/~/ Дата создания в бд 5242 + } 5243 +] 5013 5013 ))) 5245 +))) 5246 +))) 5247 +))) 5014 5014 5015 5015 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Корзина**(%%) = 5016 5016