Модуль «Геокодирование». Помогает определить местоположение объекта по адресу и использовать геоданные в бизнес-процессах.

Описание 

Знать точное расположение объекта полезно во многих бизнес-процессах. Координаты можно использовать для расчета стоимости доставки и выездных услуг, определения зон обслуживания, геоаналитики, а в клиентском сервисе — например чтобы найти ближайшее метро или офис. 

Модуль «Геокодирование» помогает использовать адресные данные в этих сценариях: выявляет координаты по адресу и показывает точность результата. 

Основные функции

Определяет широту и долготу

Модуль определяет широту и долготу в градусах. Вместе с координатами возвращается код качества, по которому можно понять, подходит ли результат для конкретной бизнес-задачи. 

Если определить координаты не удалось, то фильтр поднимается на уровень адреса выше и выполняет поиск повторно.

Например, если для адреса Россия, Омская обл, Омск г, Дальний п, дом 14 найти координаты не удалось, фильтр выполняет повторный поиск для Россия, Омская обл, Омск г, Дальний п.

Максимальный уровень поиска — город, а при наличии в адресе населенного пункта — строение. 

Примеры

Определяет ближайшую станцию метро

Модуль находит ближайшую станцию во всех городах России, где есть метро:

• в Москве,
• Санкт-Петербурге,
• Казани,
• Самаре,
• Новосибирске,
• Екатеринбурге,
• Нижнем Новгороде.

Расстояние до метро определяется по прямой.

Рассчитывает положение относительно МКАД и КАД

Модуль знает координаты двух кольцевых дорог:

• МКАД — Московская кольцевая автомобильная дорога;
• КАД — Кольцевая автомобильная дорога Санкт-Петербурга.
  

Определяет, где находится адрес — внутри или снаружи МКАД/КАД:

• относительно МКАД проверяет адреса Москвы и Московской области и только их;
• относительно КАД проверяет адреса Санкт-Петербурга и Ленинградской области и только их.

Если адрес снаружи, то определяет расстояние до кольцевой дороги: кратчайшее, по прямой, в километрах. Если адрес внутри МКАД/КАД, то расстояние не ищется. 

Примеры

Возвращает или сохраняет результаты

Модуль может возвращать геокоординаты в методах онлайн-очистки адресов.

Также результат можно сохранять в «Едином клиенте». В этом случае требуется расширение модели адреса и переобработка накопленного массива адресов. 

Ограничения

• Геокодируются только адреса, которые есть в ФИАС.
• Покрытие адресов из ФИАС геокоординатами неполное.
• Положение относительно МКАД и КАД определяется только для адресов Москвы и Московской области, Санкт-Петербурга и Ленинградской области.
• Справочник границ МКАД и КАД и справочник метро нельзя обновлять на горячую.
• Расстояние до метро определяется по прямой.

Технические особенности

Алгоритм расчета расстояния до кольцевой
Внутренние справочники содержат координаты точек на кольцевых. Если считать точки вершинами многоугольника, то расстоянием от точки до кольцевой считается наименьшее расстояние из двух:

1. от точки до ближайшей вершины многоугольника;
2. от точки до основания перпендикуляра, опущенного из точки на сторону многоугольника.

Рекомендации по использованию
При использовании результата нужно ориентироваться на статус проверки адреса и код качества координат:

• Если статус проверки адреса VALIDATED, адрес до дома и код качества координат EXACT_HOUSE или NEAREST_HOUSE — полученное расстояние до МКАД/КАД можно использовать.
• Если статус проверки адреса NOT_VALIDATED_HAS_AMBI или NOT_VALIDATED_HAS_UNPARSED_PARTS и результирующий адрес не тот, что нужно — полученное расстояние не стоит использовать.
• Если в адресе есть дом, а код качества координат не EXACT_HOUSE или NEAREST_HOUSE — полученное расстояние не стоит использовать.