Changes for page Методы API для работы с ГЛОНАССSoft
Last modified by Андрей Калиновский on 2025/01/28 12:59
Change comment:
There is no comment for this version
Summary
Details
- Page properties
-
- Content
-
... ... @@ -1504,53 +1504,6 @@ 1504 1504 (% style="text-align:left" %) 1505 1505 (% style="color:#000000" %)} 1506 1506 1507 - 1508 -(% style="text-align:left" %) 1509 -(% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов** 1510 - 1511 -== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == 1512 - 1513 -(% class="box infomessage" %) 1514 -((( 1515 -(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find** 1516 -))) 1517 - 1518 -(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них. 1519 - 1520 -(% style="color:#000000" %)Метод запроса: **POST** 1521 - 1522 -(% style="color:#000000" %)URL запроса: (%%)[[https:~~/~~/hosting.glonasssoft.ru/api/v3/users/api/v3/gis/find>>url:https://hosting.glonasssoft.ru/api/v3/users/api/v3/devices/types]] 1523 - 1524 -(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1525 - 1526 -(% style="text-align:left" %) 1527 -Тело запроса: 1528 - 1529 -(% style="text-align:left" %) 1530 -{ 1531 - "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 1532 -} 1533 - 1534 -(% style="text-align:left" %) 1535 -Ответ: 1536 - 1537 -[ 1538 - { 1539 - "id": 0, ~/~/ Идентификатор объекта геозоны 1540 - "name": "string", ~/~/ Название объекта геозоны 1541 - "type": 0, ~/~/ Тип объекта геозоны 1542 - "fname": "string", ~/~/ Имя файла 1543 - "parentId": "string", ~/~/ Идентификатор клиента 1544 - "radius": 0, ~/~/ Радиус геообъекта 1545 - "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета 1546 - "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета 1547 - "description": "string", ~/~/ Описание 1548 - "area": 0, ~/~/ Площадь, м^^2^^ 1549 - "perimetr": 0, ~/~/ Периметр, м 1550 - "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания 1551 - } 1552 -] 1553 - 1554 1554 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Датчики**(%%) = 1555 1555 1556 1556 == (% style="color:#000000; font-size:16px" %)**Получение списка типов датчиков**(%%) == ... ... @@ -1669,6 +1669,267 @@ 1669 1669 } 1670 1670 ] 1671 1671 1625 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос данных о объекте за период**(%%) = 1626 + 1627 +== (% style="color:#000000; font-size:16px" %)**Получение данных о пробеге и моточасах транспортного средства**(%%) == 1628 + 1629 +(% class="box infomessage" %) 1630 +((( 1631 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/vehicles/mileageAndMotohours** 1632 +))) 1633 + 1634 +(% style="color:#000000" %)Метод запроса: **POST** 1635 + 1636 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/mileageAndMotohours 1637 + 1638 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1639 + 1640 +(% style="text-align:left" %) 1641 +Тело запроса: 1642 + 1643 +{ 1644 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 1645 + "vehicleIds": [0], ~/~/ Список ID объектов 1646 + "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 1647 + "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода 1648 + "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 1649 +} 1650 + 1651 +Ответ: 1652 + 1653 +[ 1654 + { 1655 + "vehicleId": 0, ~/~/ ID объекта 1656 + "name": "string", ~/~/ Имя ТС 1657 + "periods": [ ~/~/ Периоды 1658 + { 1659 + "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало 1660 + "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 1661 + "mileageBegin": 0, ~/~/ Пробег на начало периода 1662 + "mileageEnd": 0, ~/~/ Пробег на окончание периода 1663 + "motohoursBegin": 0, ~/~/ Моточасы на начало периода 1664 + "motohoursEnd": 0 ~/~/ Моточасы на окончание периода 1665 + } 1666 + ] 1667 + } 1668 +] 1669 + 1670 +== (% style="color:#000000; font-size:16px" %)**Получение данных о расходе транспортного средства**(%%) == 1671 + 1672 +(% class="box infomessage" %) 1673 +((( 1674 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/vehicles/fuelConsumption** 1675 +))) 1676 + 1677 +(% style="color:#000000" %)Метод запроса: **POST** 1678 + 1679 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/fuelConsumption 1680 + 1681 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1682 + 1683 +(% style="text-align:left" %) 1684 +Тело запроса: 1685 + 1686 +{ 1687 + "sampling": 0, ~/~/ Частота дискретизации в секундах, минимум 60 секунд. Весь период разбивает на подпериоды с указанной частотой. 1688 + "vehicleIds": [0], ~/~/ Список ID объектов 1689 + "from": "2023-08-09T14:23:14.572Z", ~/~/ Начало периода 1690 + "to": "2023-08-09T14:23:14.572Z", ~/~/ Окончание периода 1691 + "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 1692 +} 1693 + 1694 +Ответ: 1695 + 1696 +[ 1697 + { 1698 + "vehicleId": 0, ~/~/ ID объекта 1699 + "name": "string", ~/~/ Имя ТС 1700 + "periods": [ ~/~/ Периоды 1701 + { 1702 + "start": "2023-08-09T14:23:14.574Z", ~/~/ Начало 1703 + "end": "2023-08-09T14:23:14.574Z", ~/~/ Окончание 1704 + "fuelLevelStart": 0, ~/~/ Уровень топлива на начало периода 1705 + "fuelLevelEnd": 0, ~/~/ Уровень топлива на конец периода 1706 + "fuelConsumption": 0, ~/~/ Расход топлива 1707 + "fuelConsumptionMove": 0 ~/~/ Расход топлива в движении 1708 + } 1709 + ] 1710 + } 1711 +] 1712 + 1713 +== (% style="color:#000000; font-size:16px" %)**Получение данных о заправках и сливах транспортного средства**(%%) == 1714 + 1715 +(% class="box infomessage" %) 1716 +((( 1717 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/vehicles/fuelInOut** 1718 +))) 1719 + 1720 +(% style="color:#000000" %)Метод запроса: **POST** 1721 + 1722 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/vehicles/fuelInOut 1723 + 1724 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1725 + 1726 +(% style="text-align:left" %) 1727 +Тело запроса: 1728 + 1729 +{ 1730 + "vehicleIds": [0], ~/~/ Список ID объектов 1731 + "from": "2023-08-09T14:27:44.772Z", ~/~/ Дата и время начало запроса 1732 + "to": "2023-08-09T14:27:44.772Z", ~/~/ Дата и время окончания запроса 1733 + "timezone": 0 ~/~/ Временная зона. Если не указана, то по умолчанию UTC+3 1734 +} 1735 + 1736 +Ответ: 1737 + 1738 +[ 1739 + { 1740 + "start": "2023-08-09T14:27:44.773Z", ~/~/ Начало периода 1741 + "end": "2023-08-09T14:27:44.773Z", ~/~/ Окончание периода 1742 + "vehicleId": 0, ~/~/ ID объекта 1743 + "name": "string", ~/~/ Имя объекта 1744 + "model": "string", ~/~/ Модель объекта 1745 + "fuels": [ ~/~/ Массив данным по заправкам и сливам 1746 + { 1747 + "event": 0, ~/~/ Тип события 20 - TankFuelIn - заправка, 21 - TankFuelOut - слив 1748 + "startDate": "2023-08-09T14:27:44.773Z", ~/~/ Начало 1749 + "endDate": "2023-08-09T14:27:44.773Z", ~/~/ Окончание 1750 + "valueFuel": 0, ~/~/ Количество 1751 + "fuelStart": 0, ~/~/ Уровень топлива на начало события 1752 + "fuelEnd": 0 ~/~/ Уровень топливо на конец события 1753 + } 1754 + ] 1755 + } 1756 +] 1757 + 1758 += (% style="color:#000000; font-size:18.6667px" %)Раздел: **Запрос посещений геообъектов**(%%) = 1759 + 1760 +== (% style="color:#000000; font-size:16px" %)**Получение списка всех геообъектов**(%%) == 1761 + 1762 +(% class="box infomessage" %) 1763 +((( 1764 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/find** 1765 +))) 1766 + 1767 +(% style="color:#000000" %)Метод позволяет получить список геообъектов клиента. Возвращает массив геообъектов со всей информацией о них. 1768 + 1769 +(% style="color:#000000" %)Метод запроса: **POST** 1770 + 1771 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/users/api/v3/gis/find 1772 + 1773 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1774 + 1775 +(% style="text-align:left" %) 1776 +Тело запроса: 1777 + 1778 +(% style="text-align:left" %) 1779 +{ 1780 + "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6" 1781 +} 1782 + 1783 +(% style="text-align:left" %) 1784 +Ответ: 1785 + 1786 +[ 1787 + { 1788 + "id": 0, ~/~/ Идентификатор объекта геозоны 1789 + "name": "string", ~/~/ Название объекта геозоны 1790 + "type": 0, ~/~/ Тип объекта геозоны 1791 + "fname": "string", ~/~/ Имя файла 1792 + "parentId": "string", ~/~/ Идентификатор клиента 1793 + "radius": 0, ~/~/ Радиус геообъекта 1794 + "beginCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата начала расчета 1795 + "endCalc": "2023-08-01T07:54:54.893Z", ~/~/ Дата окончания расчета 1796 + "description": "string", ~/~/ Описание 1797 + "area": 0, ~/~/ Площадь, м^^2^^ 1798 + "perimetr": 0, ~/~/ Периметр, м 1799 + "createDate": "2023-08-01T07:54:54.893Z", ~/~/ Дата создания 1800 + } 1801 +] 1802 + 1803 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по объектам**(%%) == 1804 + 1805 +(% class="box infomessage" %) 1806 +((( 1807 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/vehicles** 1808 +))) 1809 + 1810 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных объектов со всеми геообъектами за выбранный период. 1811 + 1812 +(% style="color:#000000" %)Метод запроса: **POST** 1813 + 1814 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/vehicles 1815 + 1816 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1817 + 1818 +(% style="text-align:left" %) 1819 +Тело запроса: 1820 + 1821 +{ 1822 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 1823 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 1824 + "ids": [ ], ~/~/ Массив id объектов 1825 + "byTime": 0, ~/~/ Объединение событий по времени 1826 + "byDist": 0, ~/~/ Объединение событий по расстоянию 1827 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 1828 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 1829 +} 1830 + 1831 +Ответ: 1832 +[ 1833 + { 1834 + "geozoneId": 0, ~/~/ ID геообъекта 1835 + "geozoneName": "string", ~/~/ Название геообъекта 1836 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 1837 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 1838 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 1839 + "vehicleId": 0, ~/~/ ID объекта 1840 + "vehicleName": "string" ~/~/ Имя объекта 1841 + } 1842 +] 1843 + 1844 +== (% style="color:#000000; font-size:16px" %)**Запрос пересечений по геообъектам**(%%) == 1845 + 1846 +(% class="box infomessage" %) 1847 +((( 1848 +(% style="color:#000000; line-height:100%" %)** **(% lang="en-US" %)**POST **(%%)**/api/v3/gis/intersections/geozones** 1849 +))) 1850 + 1851 +(% style="color:#000000" %)Метод позволяет получить список пересечений выбранных геообъектов со всеми объектами за выбранный период. 1852 + 1853 +(% style="color:#000000" %)Метод запроса: **POST** 1854 + 1855 +(% style="color:#000000" %)URL запроса: (%%)https:~/~/hosting.glonasssoft.ru/api/v3/gis/intersections/geozones 1856 + 1857 +(% style="color:#000000" %)В заголовках запроса: X-Auth: Токен авторизации 1858 + 1859 +(% style="text-align:left" %) 1860 +Тело запроса: 1861 + 1862 +{ 1863 + "startDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата начала запроса 1864 + "endDate": "2023-08-02T06:13:18.551Z", ~/~/ Дата окончания 1865 + "ids": [ ], ~/~/ Массив id геообъектов 1866 + "byTime": 0, ~/~/ Объединение событий по времени 1867 + "byDist": 0, ~/~/ Объединение событий по расстоянию 1868 + "filterByTime": 0, ~/~/ Фильтрация событий по времени нахождения 1869 + "filterByHalfPerimeter": true ~/~/ Фильтрация событий по пробегу половины периметра 1870 +} 1871 + 1872 +Ответ: 1873 + 1874 +[ 1875 + { 1876 + "geozoneId": 0, ~/~/ ID геообъекта 1877 + "geozoneName": "string", ~/~/ Название геообъекта 1878 + "startDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата въезда 1879 + "endDate": "2023-08-02T06:13:18.554Z", ~/~/ Дата выезда 1880 + "duration": 0, ~/~/ Продолжительность нахождения в геообъекте 1881 + "vehicleId": 0, ~/~/ ID объекта 1882 + "vehicleName": "string" ~/~/ Имя объекта 1883 + } 1884 +] 1885 + 1672 1672 = (% style="color:#000000; font-size:18.6667px" %)Раздел: **Уведомления**(%%) = 1673 1673 1674 1674 == (% style="color:#000000; font-size:16px" %)**Запрос списка уведомлений клиента**(%%) ==