Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/14 11:58
<
>
edited by Андрей Калиновский
on 2024/10/30 14:07
on 2024/10/30 14:07
edited by Андрей Калиновский
on 2024/11/19 14:18
on 2024/11/19 14:18
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1372,9 +1372,19 @@ 1372 1372 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1373 1373 ~/~/ "ValueOn": "Вкл.", 1374 1374 ~/~/ "ValueOff": "Выкл." 1375 - "summaryMaxValue": 0 ~/~/ Макс. значение 1375 + "summaryMaxValue": 0 ~/~/ Определяет максимальное значение датчика в режиме накопления. 1376 + 1377 +((( 1378 + "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1379 + { 1380 + "from": 0, ~/~/ С какого значения 1381 + "color": "string", ~/~/ Каким цветом 1382 + "text": "string" ~/~/ Текст подписи к этому интервалу 1383 + } 1384 + ] 1376 1376 } 1377 1377 ], 1387 +))) 1378 1378 1379 1379 "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1380 1380 ... ... @@ -1381,12 +1381,12 @@ 1381 1381 1382 1382 "customFields": [ ~/~/ Произвольные поля 1383 1383 { 1384 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1385 - "name": "string", 1386 - "value": "string", 1387 - "forClient": true, 1388 - "forTooltip": true, 1389 - "forReport": true 1394 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1395 + "name": "string", ~/~/ Наименование произвольного поля 1396 + "value": "string", ~/~/ Значение произвольного поля 1397 + "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1398 + "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1399 + "forReport": true ~/~/ Отобразить произвольное поле в отчете 1390 1390 } 1391 1391 ] 1392 1392 } ... ... @@ -1396,6 +1396,7 @@ 1396 1396 1397 1397 ((( 1398 1398 ((( 1409 +((( 1399 1399 { 1400 1400 "vehicleId": 0, ~/~/ ID ТС 1401 1401 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца ТС ... ... @@ -1515,9 +1515,10 @@ 1515 1515 { 1516 1516 "from": 0, ~/~/ С какого значения 1517 1517 "color": "string", ~/~/ Каким цветом 1518 - (% style="background-color:inherit; color:inherit; font-family:Menlo,Monaco,Consolas,~"Courier New~",monospace; font-size:inherit; white-space:pre" %)"text": "string" 1519 1519 ))) 1520 1520 1531 +((( 1532 + "text": "string" ~/~/ Текст подписи к этому интервалу 1521 1521 } 1522 1522 ] 1523 1523 } ... ... @@ -1536,6 +1536,8 @@ 1536 1536 "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 1537 1537 } 1538 1538 ))) 1551 +))) 1552 +))) 1539 1539 1540 1540 1541 1541 **Валидация:** ... ... @@ -1584,9 +1584,12 @@ 1584 1584 "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально) 1585 1585 "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально) 1586 1586 "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально) 1587 - "parentId": null, ~/~/ ID клиента (Guid, опционально) 1588 - "unitId": null, ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально) 1589 - "customFields": null ~/~/ значение любого из произвольных полей ТС 1601 + "unitId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ ID подразделения (опционально) 1602 + "unitName": "string", ~/~/ Название подразделения (опционально) 1603 + "customFields": "string", ~/~/ Поиск по содержимому произвольных полей ТС (опционально) 1604 + "vehicleGroupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ ID группы ТС (опционально) 1605 + "vehicleGroupName": "string", ~/~/ Название группы ТС (опционально) 1606 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/ Идентификатор агента, для которого надо получить данные 1590 1590 } 1591 1591 1592 1592 (% style="color:#000000" %)Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. ... ... @@ -1593,8 +1593,15 @@ 1593 1593 1594 1594 (% style="color:#000000" %)Ответ: 1595 1595 1596 -(% style="color:#000000" %){ 1597 - "vehicleId": "" ~/~/ идентификатор объекта 1613 +(% style="color:#000000" %)[ 1614 +{ 1615 + 1616 +((( 1617 + "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC 1618 +))) 1619 + 1620 +((( 1621 +(% style="color:#000000" %) "vehicleId": "" ~/~/ идентификатор объекта 1598 1598 "name": "" ~/~/ наименование объекта 1599 1599 "imei": "" ~/~/ IMEI объекта 1600 1600 "deviceTypeId": "" ~/~/ идентификатор типа устройства ... ... @@ -1619,9 +1619,21 @@ 1619 1619 "forClient": true, ~/~/ право на отображение у клиента 1620 1620 "forTooltip": false, ~/~/ право на отображение в подсказке 1621 1621 "forReport": false ~/~/ право на отображение в отчетах 1622 - }(%%) 1623 -(% style="color:#000000" %)} 1646 +))) 1624 1624 1648 +((( 1649 + } 1650 + ], 1651 + "vehicleGroups": [ ~/~/ Группы ТС 1652 + { 1653 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1654 + "name": "string" ~/~/ Наименование группы ТС 1655 + } 1656 + ] 1657 + } 1658 +] 1659 +))) 1660 + 1625 1625 (% style="color:#000000" %) Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**. 1626 1626 1627 1627 == (% style="color:#000000; font-size:16px" %)**Изменение статуса объекта**(%%) == ... ... @@ -1806,25 +1806,31 @@ 1806 1806 ~/~/ "ValueOn": "Вкл.", 1807 1807 ~/~/ "ValueOff": "Выкл." 1808 1808 "summaryMaxValue": 0 ~/~/ Макс. значение 1845 + 1846 + "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1847 + { 1848 + "from": 0, ~/~/ С какого значения 1849 + "color": "string", ~/~/ Каким цветом 1850 + "text": "string" ~/~/ Текст подписи к этому интервалу 1851 + } 1852 + ] 1809 1809 } 1810 1810 ], 1811 - 1812 -((( 1813 1813 "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1814 -))) 1815 1815 1816 1816 "customFields": [ ~/~/ Произвольные поля 1817 - { 1818 - 1819 - "name": "string", 1820 - "value": "string", 1821 - "forClient": true, 1822 - "forTooltip": true, 1823 - "forReport": true 1858 + { 1859 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1860 + "name": "string", ~/~/ Наименование произвольного поля 1861 + "value": "string", ~/~/ Значение произвольного поля 1862 + "forClient": true, ~/~/ Отобразить произвольное поле у клиента 1863 + "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте) 1864 + "forReport": true ~/~/ Отобразить произвольное поле в отчете 1824 1824 } 1825 1825 ] 1826 1826 } 1827 1827 1869 + 1828 1828 (% style="color:#000000" %)Ответ: 1829 1829 1830 1830 ((( ... ... @@ -1864,7 +1864,7 @@ 1864 1864 "cmsv6Parameters": { ~/~/ Dto для CMSv6 1865 1865 "id": "string", ~/~/ CMSV6 Идентификатор 1866 1866 "enabled": true, ~/~/ Признак включения 1867 - "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. 1909 + "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. 1868 1868 ))) 1869 1869 1870 1870 ... ... @@ -2416,7 +2416,7 @@ 2416 2416 ], 2417 2417 "stops": [ ~/~/ События стоянок 2418 2418 { 2419 - "address": "strin g", ~/~/ Адрес события2461 + "address": "[Street] [House] [City] [State] [Country] [Coordinates]", ~/~/ Адрес события Улица, Дом, Город, Регион, Страна, Координаты 2420 2420 "eventId": 0, ~/~/ Идентификатор события 2421 2421 "eventName": "string", ~/~/ Название события 2422 2422 "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события ... ... @@ -4178,64 +4178,67 @@ 4178 4178 Тело запроса: 4179 4179 4180 4180 { 4181 - "vehicleIds": [vehicleId], 4182 - "from": "2023-11-22T09:29:48.051Z", 4183 - "to": "2023-11-22T09:29:48.051Z" 4223 + "vehicleIds": [vehicleId], ~/~/Массив ID объектов 4224 + "from": "2023-11-22T09:29:48.051Z", ~/~/ Дата начала запроса 4225 + "to": "2023-11-22T09:29:48.051Z" ~/~/ Дата окончания запроса 4184 4184 } 4185 4185 4186 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4187 -|vehicleIds|Массив ID объектов 4188 -|from|Дата начала запроса 4189 -|to|Дата окончания запроса 4190 - 4191 4191 Ответ: 4192 4192 4193 4193 { 4194 - "items": [ 4231 + "items": [ ~/~/ Список в разрезе ТС 4195 4195 { 4196 - "from": "2023-11-22T09:29:48.052Z", 4197 - "to": "2023-11-22T09:29:48.052Z", 4198 - "vehicleId": 0, 4199 - "vehicleName": "string", 4200 - "vehicleModel": "string", 4201 - "penalty": 0, 4202 - "score": 0, 4203 - "totalViolations": 0, 4204 - "violationsByType": { 4205 - "overspeedingViolations": 0, 4206 - "accelerationViolations": 0, 4207 - "brakingViolations": 0, 4208 - "turningViolations": 0, 4209 - "dangerousDrivingViolations": 0, 4210 - "sensorViolations": 0 4233 + "from": "2023-11-22T09:29:48.052Z", ~/~/ Дата начала периода 4234 + "to": "2023-11-22T09:29:48.052Z", ~/~/ Дата окончания периода 4235 + "vehicleId": 0, ~/~/ ID ТС 4236 + "vehicleName": "string", ~/~/ Название ТС 4237 + "vehicleModel": "string", ~/~/ Модель ТС 4238 + "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов в разрезе ТС 4239 + "score": 0, ~/~/ Рассчитанная оценка вождения в разрезе ТС 4240 + "totalViolations": 0, ~/~/ Нарушений всего 4241 + "violationsByType": { ~/~/ Информация о нарушениях по типу 4242 + "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости 4243 + "accelerationViolations": 0, ~/~/ Нарушений ускорения 4244 + "brakingViolations": 0, ~/~/ Нарушений торможения 4245 + "turningViolations": 0, ~/~/ Нарушений опасного поворота 4246 + "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения 4247 + "sensorViolations": 0 ~/~/ Нарушений по датчику 4211 4211 }, 4212 - "moveTime": 0, 4213 - "mileage": 0, 4214 - "tripsCount": 0, 4215 - "trips": [ 4249 + 4250 +((( 4251 + 4252 +))) 4253 + 4254 + "moveTime": 0, ~/~/ Продолжительность движения, сек 4255 + "mileage": 0, ~/~/ Пробег, м 4256 + "tripsCount": 0, ~/~/ Кол-во рейсов 4257 + "trips": [ ~/~/ Информация по рейсу 4216 4216 { 4217 - "penalty": 0, 4218 - "score": 0, 4219 - "violationsCount": 0, 4220 - "violationsByType": { 4221 - "overspeedingViolations": 0, 4222 - "accelerationViolations": 0, 4223 - "brakingViolations": 0, 4224 - "turningViolations": 0, 4225 - "dangerousDrivingViolations": 0, 4226 - "sensorViolations": 0 4259 + "penalty": 0, ~/~/ Кол-во рассчитанных штрафных баллов за рейс 4260 + "score": 0, ~/~/ Рассчитанная оценка вождения за рейс 4261 + "violationsCount": 0, ~/~/ Всего нарушений 4262 + "violationsByType": { ~/~/ Информация о нарушениях по типу 4263 + "overspeedingViolations": 0, ~/~/ Нарушений превышения скорости 4264 + "accelerationViolations": 0, ~/~/ Нарушений ускорения 4265 + "brakingViolations": 0, ~/~/ Нарушений торможения 4266 + "turningViolations": 0, ~/~/ Нарушений опасного поворота 4267 + "dangerousDrivingViolations": 0, ~/~/ Нарушений резкого вождения 4268 + "sensorViolations": 0 ~/~/ Нарушений по датчику 4227 4227 }, 4228 - "moveTime": 0, 4229 - "mileage": 0, 4230 - "motohours": 0, 4231 - "maxSpeed": 0, 4232 - "startAddress": "string", 4233 - "endAddress": "string", 4234 - "drivers": [ 4270 + 4271 + "startDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата начала поездки 4272 + "endDate": "2024-11-18T13:23:38.516Z", ~/~/ Дата окончания поездки 4273 + "moveTime": 0, ~/~/ Продолжительность движения, сек 4274 + "mileage": 0, ~/~/ Пробег, м 4275 + "motohours": 0, ~/~/ Моточасы, секунды 4276 + "maxSpeed": 0, ~/~/ Максимальная скорость за рейс 4277 + "startAddress": "string", ~/~/ Адрес начала рейса 4278 + "endAddress": "string", ~/~/ Адрес конца рейса 4279 + "drivers": [ ~/~/ Список водителей 4235 4235 { 4236 - "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4237 - "driverName": "string", 4238 - "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 4281 + "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/GUID водителя 4282 + "driverName": "string", ~/~/ФИО водителя 4283 + "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/GUID радиометки 4239 4239 } 4240 4240 ] 4241 4241 } ... ... @@ -4244,34 +4244,6 @@ 4244 4244 ] 4245 4245 } 4246 4246 4247 -|=(% style="width: 215px; background-color: rgb(230, 230, 230);" %)**Параметр**|=(% style="width: 861px; background-color: rgb(230, 230, 230);" %)**Описание** 4248 -|from|Дата начала запроса 4249 -|to|Дата окончания 4250 -|vehicleId|ID объекта 4251 -|vehicleName|Имя объекта 4252 -|vehicleModel|Модель объекта 4253 -|penalty|Сумма штрафных баллов 4254 -|score|Оценка 4255 -|totalViolations|Суммарное количество нарушений 4256 -|violationsByType|Список типов нарушений и количество нарушений для каждого типа 4257 -|overspeedingViolations|Превышение скорости 4258 -|accelerationViolations|Ускорение 4259 -|brakingViolations|Торможение 4260 -|turningViolations|Резкий поворот 4261 -|dangerousDrivingViolations|Резкое вождение 4262 -|sensorViolations|Нарушение по датчику 4263 -|moveTime|Время в движении 4264 -|mileage|Пробег (км) 4265 -|tripsCount|Количество рейсов 4266 -|motohours|Моточасы 4267 -|maxSpeed|Максимальная скорость 4268 -|startAddress|Адрес начала рейса 4269 -|endAddress|Адрес окончания рейса 4270 -|drivers|Список водителей, которые были на объекте в течениии рейса 4271 -|driverGuid|Guid водителя 4272 -|driverName|Имя водителя 4273 -|driverRfid|Номер Карты-метки 4274 - 4275 4275 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Топливные карты**(%%) = 4276 4276 4277 4277 == (% style="color:#000000; font-size:16px" %)**Запрос транзакций по топливным картам**(%%) ==