Поиск данных /search

Поиск стран, объектов административно-территориального деления, городов, улиц, адресов и точек интереса, а также обратное геокодирование.

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

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

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

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

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

  • near, intersect, contains
  • text, word_text

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

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

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

Примеры

Получить все улицы Киева, в имени которых есть слово «Заплавная»:

https://api.visicom.ua/data-api/4.0/ru/search/adr_street.json?text=Киев,%20Заплавная&key=YOUR_API_KEY

Получить все рестораны в радиусе 300 метров от компании Визиком:

https://api.visicom.ua/data-api/4.0/ru/search/poi_restaurant.json?near=POIA1KIGKN&radius=300&key=YOUR_API_KEY

Получить кинотеатры, в имени которых есть слово «Kyiv» (английский язык):

https://api.visicom.ua/data-api/4.0/en/search/poi_cinema.json?text=Kyiv&key=YOUR_API_KEY

Получить станции метро в Харькове (украинский язык):

https://api.visicom.ua/data-api/4.0/uk/search/poi_underground_railway_station.json?intersect=STL1NWULT&key=YOUR_API_KEY

Получить населенные пункты, в имени которых есть слово «Киев»:

https://api.visicom.ua/data-api/4.0/ru/search/adm_settlement.json?text=Киев&key=YOUR_API_KEY

Получить населенные пункты, в имени которых есть слова, начинающиеся с букв «Киев»:

https://api.visicom.ua/data-api/4.0/ru/search/adm_settlement.json?text=Киев*&key=YOUR_API_KEY