Содержание

Адрес

Чтобы получить адрес по известным координатам, нужно использовать запрос: 

http://{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 текущего пользователя

Форматирование вывода осуществляется цифрами от 1 до 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 Город, Город, Город, Город, Город

Возвращаемый результат

[<text>]	/* массив адресов */