address (gis_geocode)
Wialon позволяет определять координаты по адресу, а также адрес по координатам. Чтобы получить адрес по известным координатам, используйте следующий запрос:
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>&gis_sid="<text>"&search_provider="<text>"
В качестве
Параметры
Обязательные параметры отмечены звездочкой (*).
| Имя | Описание |
|---|---|
| coords* | Массив координат [{“lon”:<double>,“lat”:<double>}]. |
| city_radius | Минимальный радиус города, км. Если в пределах максимального расстояния от объекта (следующий параметр) город не найден, адрес привязывается к другому городу. В этом параметре можно указать минимальный размер города, который должен использоваться для формирования адреса. Это позволяет исключить небольшие населенные пункты из адресов. |
| dist_from_unit | Максимальное расстояние от объекта, км. Если объект находится рядом с дорогой и в пределах указанного расстояния есть город, поселок или деревня, в строке адреса показываются название дороги и расстояние до этого населенного пункта. |
| txt_dist | Единицы измерения максимального расстояния от объекта. |
| flags* | Флаги формата вывода (см. ниже). |
| uid | Идентификатор текущего пользователя. Устарел, всегда используйте gis_sid. |
| gis_sid* | Уникальный идентификатор сессии пользователя. |
| search_provider* | Название провайдера. Возможные значения search_provider: google, sygic, yandex, here, trimble. |
| lang | Язык. |
| house_detect_radius | Если ближайший адрес — улица, в радиусе house_detect_radius (по умолчанию 25 метров) выполняется поиск дома, чтобы по возможности уточнить местоположение на этой улице. Если дом найден и его улица совпадает с улицей, на которой найден объект, в качестве адреса используется дом. В противном случае используется только улица. |
Формат адреса по умолчанию: 45321 (улица, дом, город, регион, страна). Его можно изменить с помощью цифр от 1 до 5:
| Цифра | Описание |
|---|---|
| 1 | Страна |
| 2 | Регион |
| 3 | Город |
| 4 | Улица |
| 5 | Дом |
Для форматирования используйте любые из этих цифр не более пяти раз. Формат вывода записывается в флаги по следующему алгоритму: каждая цифра задается 3 битами, начиная с бита 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. |
Коды ошибок
| Код ошибки | Описание |
|---|---|
| 1 | Недействительная сессия. |
| 4 | Неверные входные параметры. |
| 6 | Неизвестная ошибка. |
| 7 | Доступ запрещен, неизвестный провайдер. |
Ответ
["<text>"] /* массив адресов */