Геокодирование /geocode

Полнотекстовый поиск объектов по всей базе с учетом ошибок и неполноты информации.

Схема запроса

https://api.visicom.ua/data-api/4.0/[lang]/geocode[.format]?[text|t][&word_text|wt][&near|n|intersect|i|contains|co][&radius|r][&limit|l][&country|c][&boost_country|bc][&zoom][&key][&callback]

Параметры запроса

ПараметрОписание
langЯзык запроса и ответа. Один из (ru, uk, en).
formatФормат данных (json, csv).
text|tТекст, который должен встречаться в описании объекта. Пример: text=Крещатик, t=Жовтень.
word_text|wtСлова, которые должны встречаться в описании объекта. Пример: word_text=Киев. В поиск не попадут Киевский, Киевская и т.д.
near|nИдентификатор объекта или геометрия в формате WKT с количеством вершин не более 250. Для точек возможна упрощенная запись в виде lng,lat. Расстояние до указанной геометрии будет учитываться при формировании результата. Пример: near=POIA1KIGKN, n=30.5113,50.4550.
radius|rРадиус в метрах вокруг местоположения, которое задано параметром near.
intersect|iИдентификатор объекта или геометрия в формате WKT с количеством вершин не более 250. Для точек возможна упрощенная запись в виде lng,lat. Запрос возвращает объекты, геометрия которых пересекается с геометрией, описанной данным параметром.
contains|coИдентификатор объекта или геометрия в формате WKT с количеством вершин не более 250. Для точек возможна упрощенная запись в виде lng,lat. Запрос возвращает объекты, геометрия которых находится внутри геометрии, описанной данным параметром.
zoom|zМасштаб карты по спецификации TMS. Чем меньше масштаб, тем меньше учитываются координаты, указанные параметром near при расчете релевантности объектов.
limit|lМаксимальное количество возвращаемых объектов. Максимум 250.
country|cКод страны.
boost_country|bcКод страны. Если не указан параметр country, то объекты в указанной этим параметром стране имеют больший приоритет.
keyКлюч авторизации.
callbackИмя функции для JSONP запроса к серверу.

Взаимоисключающие параметры

  • near, intersect, contains
  • text, word_text

Этот запрос не возвращает полную геометрию объектов. В ответе есть только гео-центроид (geo_centroid) и ограничивающая рамка (bbox). Для получения полного описания и геометрии объекта используйте запрос /feature

Ответ на запрос

Структура ответа на запрос /geocode зависит от категории объекта (список категорий). Схемы ответа в зависимости от categories можно посмотреть перейдя по ссылкам:

Пример

Найти адрес г. Киев, ул. Крещатик, 26:

https://api.visicom.ua/data-api/4.0/ru/geocode.json?text=г. Киев, ул. Крещатик, 26&key=YOUR_API_KEY