Задать координаты устройства

Сохраняет в настройках устройства координаты места установки — широту и долготу. Координаты нужны, например, чтобы показать устройство на карте. Сервер проверяет только, что это числа; диапазон он не проверяет и координаты не уточняет.

Запрос и ответ: set_device_coordinates_req → set_device_coordinates_resp.
Доступ: с токеном любого уровня — устройства своего приложения и приложений, которые открыли ему доступ.

Запрос

Поля без пометки «обязательно» можно не передавать.

Поле	Тип	Описание
cmd	string	set_device_coordinates_req
operation_id	string	Произвольная строка; сервер вернёт её в ответе — по ней сопоставляют запрос и ответ
devEui	string	Обязательно. DevEUI устройства, 16 hex-символов
lat	float	Обязательно. Широта, градусы
lon	float	Обязательно. Долгота, градусы

{
    "cmd": "set_device_coordinates_req",
    "operation_id": "1W3fd",
    "devEui": "D745F677B2412E03",
    "lat": 42.221848,
    "lon": 75.898052
}

Ответ

Поле	Тип	Описание
cmd	string	set_device_coordinates_resp
operation_id	string	Значение из запроса
status	uint8	1 — сохранено, 2 — ошибка
devEui	string	Устройство
lat, lon	float	Сохранённые координаты
error_code, error_text	uint8, string	Только при ошибке, см. ниже

{
    "cmd": "set_device_coordinates_resp",
    "operation_id": "1W3fd",
    "status": 1,
    "devEui": "D745F677B2412E03",
    "lat": 42.221848,
    "lon": 75.898052
}

Ошибки

error_code	error_text	Что случилось
2	Required field is not filled	Не указан devEui, lat или lon
3	Data is filled in with an error	devEui не из 16 hex-символов; lat или lon — не число
8	Device does not exists	Устройство не найдено, неактивно или недоступно с вашим токеном
0	—	Внутренняя ошибка сервера — повторите запрос позже

Что важно знать

• Сервер не проверяет диапазон: широта должна быть от −90 до 90, долгота — от −180 до 180. Проверяйте значения на своей стороне.
• Не перепутайте поля: lat — широта, lon — долгота.

См. также

• get_device_coordinates_req — получить координаты.