Wialon для разработчиков Руководство пользователя Документация API unit calc_last

calc_last

Чтобы получить последние известные значения датчиков, счетчиков и местоположение объектов, используйте метод unit/calc_last.

Для получения данных необходимо право доступа Просмотр элемента и его основных свойств на каждый объект, указанный в запросе.

Конечная точка

Copied!

svc=unit/calc_last&params={
    "itemIds": [<long>]
}

Параметры

Запрос должен содержать следующий параметр:

Параметр	Описание
`itemIds`	Массив ID объектов, для которых нужно получить последние известные значения. Массив не должен быть пустым.

Возвращаемый результат содержит блок только для тех ID, которые принадлежат объектам. ID элементов других типов пропускаются.

Пример

Ниже приведен пример запроса unit/calc_last.

Copied!

svc=unit/calc_last&params={
    "itemIds": [16091323, 16454260]
}

Возвращаемый результат

Если запрос выполнен успешно, возвращается результат в следующем формате:

Copied!

[
    {
        "i": <long>,         /* ID объекта */
        "mileage": {         /* Счетчик пробега */
            "value": <double>,
            "format": {
                "value": <text>  /* Отформатированное значение с единицами измерения (например, "24498.82 km") */
            }
        },
        "engine_hours": {    /* Счетчик моточасов */
            "value": <double>,
            "format": {
                "value": <text>  /* Отформатированное значение с единицами измерения (например, "0.00 h") */
            }
        },
        "pos": {             /* Последнее известное местоположение */
            "y": <double>,   /* Широта */
            "x": <double>,   /* Долгота */
            "c": <int>,      /* Курс */
            "z": {           /* Высота */
                "value": <double>,
                "format": {
                    "value": <text>  /* Отформатированное значение с единицами измерения (например, "139.00 m") */
                }
            },
            "s": {           /* Скорость */
                "value": <double>,
                "format": {
                    "value": <text>  /* Отформатированное значение с единицами измерения (например, "75.00 km/h") */
                }
            },
            "sc": <int>      /* Количество спутников */
        },
        "sensors": {         /* Значения всех датчиков объекта */
            "<sensor_id>": {
                "value": <double|text>,    /* Значение датчика */
                "format": {
                    "value": <text>        /* Отформатированное значение датчика с единицами измерения */
                }
            }
        }
    }
]

Возвращаемый результат имеет следующие особенности:

Раздел sensors содержит все датчики объекта. Для датчиков, которые возвращают текстовые значения, value содержит текст вместо числа.
Если значение датчика попадает в произвольный интервал значений с текстовым описанием (параметр ci метода unit/update_sensor), раздел format содержит это описание, за которым в скобках следует значение.
Если значение не может быть рассчитано, вместо него возвращается ---.
Если у объекта нет сообщений с местоположением, все поля pos равны нулю.
Значения преобразуются в систему измерения текущей сессии, которую можно задать с помощью метода render/set_locale.

Если запрос не выполнен, возвращается код ошибки.

Коды ошибок

Код ошибки	Описание
4	Неверные входные параметры.
7	Отсутствует право доступа Просмотр элемента и его основных свойств на объекты.

Если вы заметили ошибку в тексте, пожалуйста, выделите её и нажмите Ctrl+Enter.