Содержание
Адрес
Чтобы получить адрес по известным координатам, нужно использовать запрос:
https://geocode-maps.wialon.host/{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 карты |
Пользователь, ID которого используется в uid, должен быть залогинен в систему на момент выполнения запроса.
Форматирование вывода осуществляется цифрами от 1 до 5:
- 1 – страна
- 2 – регион
- 3 – город
- 4 – улица
- 5 – дом
По умолчанию: 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>] /* массив адресов */
