Пошук даних /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/uk/search/adr_street.json?text=Киев,%20Заплавная&key=YOUR_API_KEY

Отримати всі ресторани в радіусі 300 метрів від компанії Візіком:

https://api.visicom.ua/data-api/4.0/uk/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/uk/search/adm_settlement.json?text=Киев&key=YOUR_API_KEY

Отримати населені пункти, в імені яких є слова, що починаються з літер «Київ»:

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