¶ Общее
Команда позволяет выполнить внеочередной запрос к сервису Локатор для получения координат устройства по данным LBS и WiFi
Yandex Locator
Схема работы при отправке команды будет выглядеть следующим образом:
sequenceDiagram
Пользователь->>+Устройство: *!LOC "your-api-key",11
Note right of Пользователь: Команда на выполнение запроса координат с ключом<br>"your-api-key" и сырыми данными от LBS и WIFI
Устройство->>Пользователь: *@LOC OK
Note right of Пользователь: Устройсвто приняло команду к исполнению
Устройство->>+Локатор: Запрос с ключом "your-api-key" и
Локатор->>-Устройство: Ответ от сервиса
Устройство->>-Пользователь: *&LOC DATA,"time",lon,lat,acc,"map-link"
Note right of Пользователь: Ответ с координатами
¶ Команда LOC
| Структура | *!LOC[ <key>,<source>] |
|
| Обозначение | Описание | Примечание |
*!LOC |
Константа - 0x2A 0x21 0x4C 0x4F 0x43 |
|
<key> |
(Опционально) Ключ для запроса информации в сервисе Локатор. Значение ключа должно быть в двойных кавычках, например: *!LOC "ключ"Если ключ не указан, то будет использован ключ, прописанный в настройках устройства |
36 символов |
<source> |
(Опционально) Какие данные использовать для отправки запроса в Локатор: Маска (номера символов слева направо): 0 - Использовать информацию от LBS;1 - Использовать информацию от WIFI.Допустимые значения: 0 - Не использовать1 - ИспользоватьЕсли параметр не указан, то будут использованы данные, прописанные в настройках устройства |
2 символа |
¶ Примеры
-
Команда без параметров:
*!LOC -
Команда с параметрами (Ключ 123456, только LBS):
*!LOC "123456",10
¶ Ответ
Отправляется устройством сразу для подтверждения команды
| Структура | *@LOC <ans> |
|
| Обозначение | Описание | Примечание |
*@LOC |
Константа - 0x2A 0x40 0x4C 0x4F 0x43 |
|
<ans> |
Результат выполнения команды:OK – команда принята к исполнениюFAIL – ошибка, команда отменена |
|
¶ Оповещение LOC DATA
Отправляется устройством асинхронно когда получены координаты от сервиса
| Структура | *&LOC DATA,<time>,<lat>,<lon>,<acc>,<map-link> |
||
| Обозначение | Описание | Примечание | |
*&LOC |
Константа - 0x2A 0x26 0x4C 0x4F 0x43 |
||
DATA |
Результат выполнения команды:DATA – Получена координата от Локатора |
||
<time> |
Время и дата исходных данных, по которым получены координаты от Локатора | время UTC | |
<lat> |
Широта | градусы | |
<lon> |
Долгота | градусы | |
<acc> |
Точность полученных координат, в метрах | 1 метр | |
<map-link> |
Ссылка на google maps с полученными координатами | ||
¶ Пример
*&LOC DATA,"06:26:19 16.10.2026",55.783261,37.721710,150.000000,"http://maps.google.com/maps?&q=+55.783261,+37.721710&zoom=0"
¶ Оповещение LOC FAIL
Отправляется устройством асинхронно когда нет возможности получить координаты от сервиса
| Структура | *&LOC FAIL |
|
| Обозначение | Описание | Примечание |
*&LOC |
Константа - 0x2A 0x26 0x4C 0x4F 0x43 |
|
FAIL |
Результат выполнения команды:FAIL – ошибка, команда отменена |
|