update_messages_filter
Чтобы изменить настройки фильтрации данных о местоположении, используйте метод unit/update_messages_filter.
svc=unit/update_messages_filter¶ms={
"itemId": <long>,
"enabled": <bool>,
"skipInvalid": <bool>,
"minSats": <ubyte>,
"maxHdop": <double>,
"maxSpeed": <uint>,
"lbsCorrection": <bool>,
"wifiCorrection": <bool>,
"minWifiPoints": <ubyte>,
"maxWifiPoints": <ubyte>,
"wifiAccuracy": <double>
}
Параметры
Запрос может содержать следующие параметры. Обязательные параметры отмечены звездочкой (*).
| Параметр | Описание |
|---|---|
itemId* |
ID объекта. |
enabled* |
Фильтрация данных о местоположении: 1: включить, 0: выключить. |
skipInvalid* |
Пропускать невалидные сообщения. Позволяет игнорировать GPS-данные, которые устройство определило как невалидные. |
minSats* |
Минимальное количество спутников, по которым должны определяться координаты, чтобы сообщение считалось валидным. Рекомендуется указывать не менее четырех. Значение не может превышать 255. |
maxHdop* |
Максимальное значение HDOP, при котором сообщения считаются валидными. Значение не может превышать 9999. |
maxSpeed* |
Предельное значение скорости. Если оно превышено, сообщение считается невалидным. Нельзя указать значение больше 9999. Если указан 0, этот критерий фильтрации не учитывается. |
lbsCorrection |
Разрешить определение местоположения по базовым станциям сотовой связи. |
wifiCorrection |
Разрешить определение местоположения по точкам Wi-Fi. |
minWifiPoints |
Минимальное количество точек Wi-Fi, которое должно учитываться, чтобы сообщения считались валидными. Можно указать только целое число. Минимальное допустимое значение — 2, максимальное — 255. |
maxWifiPoints |
Максимальное количество точек Wi-Fi, которое учитывается при определении местоположения объекта. Можно указать только целое число. Минимальное допустимое значение — 2, максимальное — 255. |
wifiAccuracy |
Точность определения местоположения в метрах. Сообщение считается невалидным, если его значение точности больше указанного. Можно указать целое или дробное число, большее или равное нулю. Максимальное допустимое значение — 10 000. |
Ответ
При успешном выполнении запроса возвращается пустой объект:
{}
В противном случае возвращается код ошибки.
Коды ошибок
| Код ошибки | Описание |
|---|---|
| 4 | Неверные входные параметры. |
| 6 | Не удалось изменить настройки фильтрации данных о местоположении. |
| 7 | Объект не существует, или у пользователя нет права доступа Редактирование настроек подключения на него. |