Получить координаты устройства

Возвращает координаты места установки устройства — широту и долготу, которые сохранены в его настройках. Сервер не определяет координаты сам: их задают командой set_device_coordinates_req, при создании устройства или в веб-интерфейсе.

Запрос и ответ: get_device_coordinates_req → get_device_coordinates_resp.
Доступ: с токеном низкого уровня — устройства своего приложения и приложений, которые открыли ему доступ; с токеном высокого уровня — все устройства владельца.

Запрос

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

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

{
    "cmd": "get_device_coordinates_req",
    "operation_id": "1W3fd",
    "devEui": "D745F677B2412E03"
}

Ответ

Поле	Тип	Описание
cmd	string	get_device_coordinates_resp
operation_id	string	Значение из запроса
status	uint8	1 — успех, 2 — ошибка
deviceCount	uint32	Сколько устройств в списке
deviceList	array	Устройства: devEui, lat — широта, lon — долгота, в градусах. Если координаты не заданы — null
error_code, error_text	uint8, string	Только при ошибке, см. ниже

{
    "cmd": "get_device_coordinates_resp",
    "operation_id": "1W3fd",
    "status": 1,
    "deviceCount": 1,
    "deviceList": [
        {
            "devEui": "D745F677B2412E03",
            "lat": 43.2217921642226,
            "lon": 76.8974626064301
        }
    ]
}

Ошибки

error_code	error_text	Что случилось
3	Data is filled in with an error	devEui не из 16 hex-символов
0	—	Внутренняя ошибка сервера — повторите запрос позже

Устройство, которого нет или которое недоступно с вашим токеном, ошибкой не считается: оно просто не попадёт в deviceList.

См. также

• set_device_coordinates_req — задать координаты.