Геокодування /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

Відповідь на запит

Залежить від категорії об'єкта (список категорій). Схеми відповіді в залежності від categories можна подивитися перейшовши за посиланнями:

Приклад

Знайти адресу м. Київ, вул. Хрещатик, 26:

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