Чтобы получить адрес по известным координатам, нужно использовать запрос:
https://geocode-maps.wialon.com/{host}/gis_geocode?coords=[{"lon":<double>,"lat":<double>}]&city_radius=<uint>& dist_from_unit=<uint>&txt_dist=<text>&flags=<uint>&uid=<long>
Использование данного запроса рассмотрено в примере Определение адреса и координат.
Название | Описание |
---|---|
coords | массив с координатами |
city_radius | минимальный радиус города (опционально) Параметр «Минимальный радиус города» определяет, что если на расстоянии, указанном как «Максимальное расстояние от объекта», населенного пункта не найдено, тогда адрес привязывается к некоторому другому городу. Радиус города, который может попасть в адресную информацию, можно указать в этом параметре. Это может понадобиться, например, чтобы в адресах фигурировали только крупные города. |
dist_from_unit | максимальное расстояние от объекта (опционально) Параметр «Максимальное расстояние от объекта» определяет, что если объект находится на дороге и в указанном расстоянии от него находится населенный пункт, то в его адрес попадает имя дороги и расстояние до этого населенного пункта (если найдено несколько, то до ближайшего). |
txt_dist | единица измерения максимального расстояния от объекта (опционально) |
flags | флаги форматирования вывода (см. ниже) |
uid | ID текущего пользователя |
search_provider | имя карт провайдера (google/yandex), опционально, по умолчанию - Gurtam карты |
По умолчанию: 45321 (Улица, Дом, Город, Регион, Страна). Для форматирования достаточно использовать любое число до 5 раз подряд. Этот формат вывода подставляется в флаги по следующему алгоритму: любая цифра задаётся тремя битами, начиная с 31 бита, т.е. максимальное количество задействованных битов равно 15 (с 31 по 17).
Формат | Десятичный вид | Бинарный | Результат |
---|---|---|---|
45321 | 1255211008 | 0 100 101 011 010 001 0000000000000000 | Улица, Дом, Город, Регион, Страна |
45 | 1241513984 | 0 100 101 000 000 000 0000000000000000 | Улица, Дом |
33333 | 920322048 | 0 011 011 011 011 011 0000000000000000 | Город, Город, Город, Город, Город |
Дополнительные флаги
Значение | Описание |
---|---|
512 | используется для возвращения данных по MGRS |
[<text>] /* массив адресов */