Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/14 11:58
<
>
edited by Андрей Калиновский
on 2024/11/19 14:18
on 2024/11/19 14:18
edited by Андрей Калиновский
on 2024/10/30 14:07
on 2024/10/30 14:07
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1372,19 +1372,9 @@ 1372 1372 ~/~/ Характерные для таблицы тарировки Вкл./Выкл.: 1373 1373 ~/~/ "ValueOn": "Вкл.", 1374 1374 ~/~/ "ValueOff": "Выкл." 1375 - "summaryMaxValue": 0 ~/~/ Определяет максимальное значение датчика в режиме накопления. 1376 - 1377 -((( 1378 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1379 - { 1380 - "from": 0, ~/~/ С какого значения 1381 - "color": "string", ~/~/ Каким цветом 1382 - "text": "string" ~/~/ Текст подписи к этому интервалу 1383 - } 1384 - ] 1375 + "summaryMaxValue": 0 ~/~/ Макс. значение 1385 1385 } 1386 1386 ], 1387 -))) 1388 1388 1389 1389 "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1390 1390 ... ... @@ -1391,12 +1391,12 @@ 1391 1391 1392 1392 "customFields": [ ~/~/ Произвольные поля 1393 1393 { 1394 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности1395 - "name": "string", ~/~/ Наименование произвольного поля1396 - "value": "string", ~/~/ Значение произвольного поля1397 - "forClient": true, ~/~/ Отобразить произвольное поле у клиента1398 - "forTooltip": true, ~/~/ Отобразить произвольное поле в подсказке (при наведении на ТС на карте)1399 - "forReport": true ~/~/ Отобразить произвольное поле в отчете1384 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1385 + "name": "string", 1386 + "value": "string", 1387 + "forClient": true, 1388 + "forTooltip": true, 1389 + "forReport": true 1400 1400 } 1401 1401 ] 1402 1402 } ... ... @@ -1406,7 +1406,6 @@ 1406 1406 1407 1407 ((( 1408 1408 ((( 1409 -((( 1410 1410 { 1411 1411 "vehicleId": 0, ~/~/ ID ТС 1412 1412 "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid владельца ТС ... ... @@ -1526,10 +1526,9 @@ 1526 1526 { 1527 1527 "from": 0, ~/~/ С какого значения 1528 1528 "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" 1529 1529 ))) 1530 1530 1531 -((( 1532 - "text": "string" ~/~/ Текст подписи к этому интервалу 1533 1533 } 1534 1534 ] 1535 1535 } ... ... @@ -1548,8 +1548,6 @@ 1548 1548 "motohoursCalcMethod": 0 ~/~/ Вид расчета моточасов. 0 - ByIgnitionSensor, 1 - ByMotohoursSensor, 2 - ByRelativeMotohoursSensor 1549 1549 } 1550 1550 ))) 1551 -))) 1552 -))) 1553 1553 1554 1554 1555 1555 **Валидация:** ... ... @@ -1598,12 +1598,9 @@ 1598 1598 "imei": null, ~/~/ "710179307", ~/~/ IMEI (string, опционально) 1599 1599 "sim": null, ~/~/ "938112", ~/~/ Номер телефона (string, опционально) 1600 1600 "deviceTypeId": null, ~/~/ 5, ID типа устройства (short, опционально) 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" ~/~/ Идентификатор агента, для которого надо получить данные 1587 + "parentId": null, ~/~/ ID клиента (Guid, опционально) 1588 + "unitId": null, ~/~/ "b33548c3-73c3-40e4-8b78-81470ae744ed", ID подразделения (Guid, опционально) 1589 + "customFields": null ~/~/ значение любого из произвольных полей ТС 1607 1607 } 1608 1608 1609 1609 (% style="color:#000000" %)Фильтрация осуществляется по точному совпадению значений параметров «__**vehicleId**__», «__**deviceTypeId**__», «__**parentId**__», «__**unitId**__», и по частичному - «__**name**__», «__**imei**__», «__**sim**__». Фильтрация по значению параметра «__**sim**__» осуществляется при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. ... ... @@ -1610,15 +1610,8 @@ 1610 1610 1611 1611 (% style="color:#000000" %)Ответ: 1612 1612 1613 -(% style="color:#000000" %)[ 1614 -{ 1615 - 1616 -((( 1617 - "vehicleGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid TC 1618 -))) 1619 - 1620 -((( 1621 -(% style="color:#000000" %) "vehicleId": "" ~/~/ идентификатор объекта 1596 +(% style="color:#000000" %){ 1597 + "vehicleId": "" ~/~/ идентификатор объекта 1622 1622 "name": "" ~/~/ наименование объекта 1623 1623 "imei": "" ~/~/ IMEI объекта 1624 1624 "deviceTypeId": "" ~/~/ идентификатор типа устройства ... ... @@ -1643,21 +1643,9 @@ 1643 1643 "forClient": true, ~/~/ право на отображение у клиента 1644 1644 "forTooltip": false, ~/~/ право на отображение в подсказке 1645 1645 "forReport": false ~/~/ право на отображение в отчетах 1646 -))) 1622 + }(%%) 1623 +(% style="color:#000000" %)} 1647 1647 1648 -((( 1649 - } 1650 - ], 1651 - "vehicleGroups": [ ~/~/ Группы ТС 1652 - { 1653 - "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ System.Guid идентификатор элемента сущности 1654 - "name": "string" ~/~/ Наименование группы ТС 1655 - } 1656 - ] 1657 - } 1658 -] 1659 -))) 1660 - 1661 1661 (% style="color:#000000" %) Параметры «__**sim1**__» и «__**sim2**__» содержатся в ответе при наличии у авторизованного пользователя права **«__Просмотр номеров телефонов объектов__»**. Параметр «__**status**__» содержится в ответе при наличии у авторизованного пользователя права **«__Просмотр статуса объекта__»**. 1662 1662 1663 1663 == (% style="color:#000000; font-size:16px" %)**Изменение статуса объекта**(%%) == ... ... @@ -1842,31 +1842,25 @@ 1842 1842 ~/~/ "ValueOn": "Вкл.", 1843 1843 ~/~/ "ValueOff": "Выкл." 1844 1844 "summaryMaxValue": 0 ~/~/ Макс. значение 1845 - 1846 - "valueIntervals": [ ~/~/ Интервалы значений для подсветки в мониторинге 1847 - { 1848 - "from": 0, ~/~/ С какого значения 1849 - "color": "string", ~/~/ Каким цветом 1850 - "text": "string" ~/~/ Текст подписи к этому интервалу 1851 - } 1852 - ] 1853 1853 } 1854 1854 ], 1811 + 1812 +((( 1855 1855 "highlightSensorGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/ Guid датчика, выбранного для подсветки его значения в различных интервалах 1814 +))) 1856 1856 1857 1857 "customFields": [ ~/~/ Произвольные поля 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 ~/~/ Отобразить произвольное поле в отчете1817 + { 1818 + "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 1819 + "name": "string", 1820 + "value": "string", 1821 + "forClient": true, 1822 + "forTooltip": true, 1823 + "forReport": true 1865 1865 } 1866 1866 ] 1867 1867 } 1868 1868 1869 - 1870 1870 (% style="color:#000000" %)Ответ: 1871 1871 1872 1872 ((( ... ... @@ -1906,7 +1906,7 @@ 1906 1906 "cmsv6Parameters": { ~/~/ Dto для CMSv6 1907 1907 "id": "string", ~/~/ CMSV6 Идентификатор 1908 1908 "enabled": true, ~/~/ Признак включения 1909 - "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. 1867 + "host": "string", ~/~/ IP-адрес или доменное имя из URL веб-сайта CMSV6. 1910 1910 ))) 1911 1911 1912 1912 ... ... @@ -2458,7 +2458,7 @@ 2458 2458 ], 2459 2459 "stops": [ ~/~/ События стоянок 2460 2460 { 2461 - "address": " [Street] [House] [City] [State] [Country] [Coordinates]", ~/~/ Адрес событияУлица, Дом, Город, Регион, Страна, Координаты2419 + "address": "string", ~/~/ Адрес события 2462 2462 "eventId": 0, ~/~/ Идентификатор события 2463 2463 "eventName": "string", ~/~/ Название события 2464 2464 "start": "2024-01-30T10:17:13.789Z", ~/~/ Дата и время начало события ... ... @@ -4220,67 +4220,64 @@ 4220 4220 Тело запроса: 4221 4221 4222 4222 { 4223 - "vehicleIds": [vehicleId], ~/~/Массив ID объектов4224 - "from": "2023-11-22T09:29:48.051Z", ~/~/ Дата начала запроса4225 - "to": "2023-11-22T09:29:48.051Z" ~/~/ Дата окончания запроса4181 + "vehicleIds": [vehicleId], 4182 + "from": "2023-11-22T09:29:48.051Z", 4183 + "to": "2023-11-22T09:29:48.051Z" 4226 4226 } 4227 4227 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 + 4228 4228 Ответ: 4229 4229 4230 4230 { 4231 - "items": [ ~/~/ Список в разрезе ТС4194 + "items": [ 4232 4232 { 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 ~/~/ Нарушений по датчику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 4248 4248 }, 4249 - 4250 -((( 4251 - 4252 -))) 4253 - 4254 - "moveTime": 0, ~/~/ Продолжительность движения, сек 4255 - "mileage": 0, ~/~/ Пробег, м 4256 - "tripsCount": 0, ~/~/ Кол-во рейсов 4257 - "trips": [ ~/~/ Информация по рейсу 4212 + "moveTime": 0, 4213 + "mileage": 0, 4214 + "tripsCount": 0, 4215 + "trips": [ 4258 4258 { 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 ~/~/ Нарушений по датчику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 4269 4269 }, 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": [ ~/~/ Список водителей 4228 + "moveTime": 0, 4229 + "mileage": 0, 4230 + "motohours": 0, 4231 + "maxSpeed": 0, 4232 + "startAddress": "string", 4233 + "endAddress": "string", 4234 + "drivers": [ 4280 4280 { 4281 - "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", ~/~/GUID водителя4282 - "driverName": "string", ~/~/ФИО водителя4283 - "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" ~/~/GUID радиометки4236 + "driverGuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6", 4237 + "driverName": "string", 4238 + "driverRfid": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 4284 4284 } 4285 4285 ] 4286 4286 } ... ... @@ -4289,6 +4289,34 @@ 4289 4289 ] 4290 4290 } 4291 4291 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 + 4292 4292 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Топливные карты**(%%) = 4293 4293 4294 4294 == (% style="color:#000000; font-size:16px" %)**Запрос транзакций по топливным картам**(%%) ==