Поиск объектов на карте

Материал из Map.BY
Перейти к: навигация, поиск

Описание: Интерфейс служит для поиска адресов, объектов, предприятий на сайте map.by

Параметры использования: Функция вызывается при помощи сформированного GETзапроса по указанному URL. Данные возвращаются в формате JSON.

http://map.by/search/api/{:query}?city_search={:city}

Параметр Описание
{:city} Наименование города. Параметр должен быть передан в виде urlencode(строка, в которой все не цифробуквенные символы, кроме -_. Заменены знаком процента (%), за которым следует два шестнадцатеричных числа, а пробелы кодируются как знак сложения (+) Формат кодировки – UTF8

В данный момент сервис понимает следующие города:

  • Минск
  • Брест
  • Гродно
  • Гомель
  • Витебск
  • Могилёв
{:query} Текст запроса. Параметр должен быть передан в виде urlencode(строка, в которой все не цифробуквенные символы, кроме -_. заменены знаком процента (%), за которым следует два шестнадцатеричных числа, а пробелы кодируются как знак сложения (+) Формат кодировки – UTF8

В случае успеха сервис вернет JSON код в виде:

{"status":"success","companies":{"2938":{"weight":50727,"attrs":{"name":"\u0421\u0435\u0440\u0432\u0438\u0441\u043d\u044b\u0439 \u0446\u0435\u043d\u0442\u0440 - 806","city_id":1,"description_small":"\u0418\u043d\u0442\u0435\u0440\u043d\u0435\u0442-\u043a\u0430\u0444\u0435","street":"\u0443\u043b. \u042f.\u041a\u043e\u043b\u043e\u0441\u0430","home_number":"63","slug":"about3505"}}},"company_found":1,"streets":[]}
Параметр Описание
status Статус ответа. Может принимать 2 варианта значений:
  • success – в случае успешного выполнения запроса
  • not_found – в случае неудачного выполнения запросапоиска
companies Найденые компании исходя из запроса. Массив, содержащий в себе параметры ответа:
  • weight –Вес релевантности поиска
  • attr – аттрибуты компани
  • name - Название
  • city - название города
  • description_small - краткое описание
  • street - навание улицы
  • home_number - номер дома
  • slug - уникальный идентификатор компании
  • streets - Найденые улицы согласно запроса
    • name - название улицы
    • addr:street - название улицы согласно рубрикатору

Если поиск завершится неудачей (записей не найдено), сервис вернет JSON нотификацию об ошибке в виде:

{"status":"not_found"}

Пример использования:

REQUEST: http://map.by/search/api/%D1%84%D0%B8%D0%BB%D0%B8%D0%BC%D0%BE%D0%BD%D0%BE%D0%B2%D0%B0?city_search=%D0%9C%D0%B8%D0%BD%D1%81%D0%BA

RESPONSE:

{
"status":"success",
"companies":{
"3467":{
"weight":150680,
"attrs":{
"name":"\u0411\u0430\u0441\u0441\u0435\u0439\u043d \u043d\u0430 \u0424\u0438\u043b\u0438\u043c\u043e\u043d\u043e\u0432\u0430",
"city_id":1,
"description_small":"\u0423\u0441\u043b\u0443\u0433\u0438 \u0431\u0430\u0441\u0441\u0435\u0439\u043d\u0430 \u0438 \u043f\u0430\u0440\u043d\u043e\u0439",
"street":"\u0443\u043b. \u0424\u0438\u043b\u0438\u043c\u043e\u043d\u043e\u0432\u0430",
"home_number":"55 \u043a2",
"slug":"about4211"
}
},
"9310":{
"weight":52732,
"attrs":{
"name":"\u0421\u0440\u043e\u0447\u043d\u043e\u0435 \u0444\u043e\u0442\u043e. \u041f\u0435\u0447\u0430\u0442\u044c \u0444\u043e\u0442\u043e\u0433\u0440\u0430\u0444\u0438\u0439.",
"city_id":1,
"description_small":"\u0421\u0420\u041e\u0427\u041d\u041e\u0415 \u0424\u041e\u0422\u041e. \u041a\u0441\u0435\u0440\u043e\u043a\u043e\u043f\u0438\u044f. \u041f\u0435\u0447\u0430\u0442\u044c \u0444\u043e\u0442\u043e\u0433\u0440\u0430\u0444\u0438\u0439. \u041e\u043f\u0435\u0440\u0430\u0442\u0438\u0432\u043d\u0430\u044f \u043f\u043e\u043b\u0438\u0433\u0440\u0430\u0444\u0438\u044f\r\n\u0433.\u041c\u0438\u043d\u0441\u043a \u0443\u043b.\u0424\u0438\u043b\u0438\u043c\u043e\u043d\u043e\u0432\u0430 13 \u043a\u043e\u0440\u043f.1 , 2 \u044d\u0442\u0430\u0436\r\n\u0412\u0440\u0435\u043c\u044f \u0440\u0430\u0431\u043e\u0442\u044b: 10.00-19.00, \u0441\u0431. 10.00-15.00\r\n\r\n\u0433.\u041c\u0438\u043d\u0441\u043a \u0443\u043b.\u0424\u0438\u043b\u0438\u043c\u043e\u043d\u043e\u0432\u0430 53-423, 4 \u044d\u0442\u0430\u0436\r\n\u0412\u0440\u0435\u043c\u044f \u0440\u0430\u0431\u043e\u0442\u044b: 08.00-19.00, \u0441\u0431. 10.00-14.30",
"street":"\u0443\u043b. \u0424\u0438\u043b\u0438\u043c\u043e\u043d\u043e\u0432\u0430",
"home_number":"13 \u043a\u043e\u0440\u043f.1",
"slug":"srochnoe-foto-pechat-fotografij"
}
},
"9311":{
"weight":52706,
"attrs":{
"name":"\u0421\u0440\u043e\u0447\u043d\u043e\u0435 \u0444\u043e\u0442\u043e. \u041f\u0435\u0447\u0430\u0442\u044c \u0444\u043e\u0442\u043e\u0433\u0440\u0430\u0444\u0438\u0439. \u041a\u0441\u0435\u0440\u043e\u043a\u043e\u043f\u0438\u044f",
"city_id":1,
"description_small":"\u0421\u0420\u041e\u0427\u041d\u041e\u0415 \u0424\u041e\u0422\u041e. \u041a\u0441\u0435\u0440\u043e\u043a\u043e\u043f\u0438\u044f. \u041f\u0435\u0447\u0430\u0442\u044c \u0444\u043e\u0442\u043e\u0433\u0440\u0430\u0444\u0438\u0439. \u041e\u043f\u0435\u0440\u0430\u0442\u0438\u0432\u043d\u0430\u044f \u043f\u043e\u043b\u0438\u0433\u0440\u0430\u0444\u0438\u044f\r\n\r\n\u0433.\u041c\u0438\u043d\u0441\u043a \u0443\u043b.\u0424\u0438\u043b\u0438\u043c\u043e\u043d\u043e\u0432\u0430 53-423, 4 \u044d\u0442\u0430\u0436\r\n\u0412\u0440\u0435\u043c\u044f \u0440\u0430\u0431\u043e\u0442\u044b: 08.00-19.00, \u0441\u0431. 10.00-14.30",
"street":"\u0443\u043b. \u0424\u0438\u043b\u0438\u043c\u043e\u043d\u043e\u0432\u0430",
"home_number":"53",
"slug":"srochnoe-foto-pechat-fotografij-kserokopiya"
}
},
"7939":{
"weight":51680,
"attrs":{
"name":"\u041e\u0414\u041e \"\u0410\u043d\u0442\u0438\u0441\u0442\u0440\u0435\u0441\u0441\"",
"city_id":1,
"description_small":"\u041c\u044b \u043f\u0435\u0440\u0435\u0435\u0445\u0430\u043b\u0438 \u0441 \u0443\u043b. \u0413\u0435\u0440\u043e\u0435\u0432 120-\u043e\u0439 \u0434\u0438\u0432\u0438\u0437\u0438\u0438 \u0434.29 \u043d\u0430 \u0443\u043b. \u0424\u0438\u043b\u0438\u043c\u043e\u043d\u043e\u0432\u0430 \u0434.2!\r\n\u041c\u044b \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u043c \u043a\u0440\u0443\u0433\u043b\u043e\u0441\u0443\u0442\u043e\u0447\u043d\u043e \u043a\u0430\u0436\u0434\u044b\u0439 \u0434\u0435\u043d\u044c \u0431\u0435\u0437 \u043e\u0431\u0435\u0434\u0430 \u0438 \u0432\u044b\u0445\u043e\u0434\u043d\u044b\u0445!",
"street":"\u0443\u043b. \u0424\u0438\u043b\u0438\u043c\u043e\u043d\u043e\u0432\u0430",
"home_number":"2",
"slug":"about10157"
}
},
"1031":{
"weight":50631,
"attrs":{
"name":"\u0416\u042d\u0421 \u2116 86",
"city_id":1,
"description_small":"\u0433\u0440\u0430\u0444\u0438\u043a \u0440\u0430\u0431\u043e\u0442\u044b \u0441\u043e\u0442\u0440\u0443\u0434\u043d\u0438\u043a\u043e\u0432 \u0416\u042d\u0421\u0430: \u043f\u043d.-\u0447\u0442.: 9.00 - 18.00, \u043f\u0442.: 9.00 - 16.45, \u043e\u0431\u0435\u0434: 13.00 - 14.00, \u0432\u044b\u0445.: \u0441\u0431., \u0432\u0441.",
"street":"\u0443\u043b. \u0424\u0438\u043b\u0438\u043c\u043e\u043d\u043e\u0432\u0430",
"home_number":"47\u0430",
"slug":"about1290"
}
},
"1112":{
"weight":50631,
"attrs":{
"name":"\u0410\u043d\u0438\u0441\u0438\u044f, \u041f\u0430\u0440\u0438\u043a\u043c\u0430\u0445\u0435\u0440\u0441\u043a\u0430\u044f",
"city_id":1,
"description_small":"\"\u0410\u043d\u0438\u0441\u0438\u044f\" \u043f\u0430\u0440\u0438\u043a\u043c\u0430\u0445\u0435\u0440\u0441\u043a\u0430\u044f",
"street":"\u0443\u043b. \u0424\u0438\u043b\u0438\u043c\u043e\u043d\u043e\u0432\u0430",
"home_number":"13 \u043a1",
"slug":"about1380"
}
},
"1136":{
"weight":50631,
"attrs":{
"name":"\u0413\u0430\u043b\u0435\u0440\u0435\u044f \u043a\u0440\u0430\u0441\u043e\u0442\u044b, \u0421\u0430\u043b\u043e\u043d-\u043f\u0430\u0440\u0438\u043a\u043c\u0430\u0445\u0435\u0440\u0441\u043a\u0430\u044f",
"city_id":1,
"description_small":"\"\u0413\u0430\u043b\u0435\u0440\u0435\u044f \u043a\u0440\u0430\u0441\u043e\u0442\u044b\" \u0441\u0430\u043b\u043e\u043d-\u043f\u0430\u0440\u0438\u043a\u043c\u0430\u0445\u0435\u0440\u0441\u043a\u0430\u044f",
"street":"\u0443\u043b. \u0424\u0438\u043b\u0438\u043c\u043e\u043d\u043e\u0432\u0430",
"home_number":"45",
"slug":"about1407"
}
},
"1262":{
"weight":50631,
"attrs":{
"name":"\u042d\u0441\u0442\u0435\u0442\u0438\u043a \u041b\u0430\u0439\u043d, \u0421\u0430\u043b\u043e\u043d \u043a\u0440\u0430\u0441\u043e\u0442\u044b",
"city_id":1,
"description_small":"\u042d\u0421\u0422\u0415\u0422\u0418\u041a \u041b\u0410\u0419\u041d - \u0442\u0435\u0440\u0440\u0438\u0442\u043e\u0440\u0438\u044f \u043a\u0440\u0430\u0441\u043e\u0442\u044b \u043f\u0440\u0435\u0434\u043b\u0430\u0433\u0430\u0435\u0442",
"street":"\u0443\u043b. \u0424\u0438\u043b\u0438\u043c\u043e\u043d\u043e\u0432\u0430",
"home_number":"63",
"slug":"about1560"
}
},
"1396":{
"weight":50631,
"attrs":{
"name":"\u0418\u043d\u0441\u0442\u0438\u0442\u0443\u0442 \u0441\u043e\u0432\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u0445 \u0437\u043d\u0430\u043d\u0438\u0439 \u0438\u043c. \u0410.\u041c.\u0428\u0438\u0440\u043e\u043a\u043e\u0432\u0430 (\u0418\u0421\u0417)",
"city_id":1,
"description_small":"\u0423\u0447\u0440\u0435\u0436\u0434\u0435\u043d\u0438\u0435 \u043e\u0431\u0440\u0430\u0437\u043e\u0432\u0430\u043d\u0438\u044f.",
"street":"\u0443\u043b. \u0424\u0438\u043b\u0438\u043c\u043e\u043d\u043e\u0432\u0430",
"home_number":"69",
"slug":"about1733"
}
},
"1800":{
"weight":50631,
"attrs":{
"name":"\u0414\u0435\u0442\u0441\u043a\u0438\u0439 \u0441\u0430\u0434 \u2116 553",
"city_id":1,
"description_small":"\u0414\u0435\u0442\u0441\u043a\u0438\u0439 \u0441\u0430\u0434 \u2116 553",
"street":"\u0443\u043b. \u0424\u0438\u043b\u0438\u043c\u043e\u043d\u043e\u0432\u0430",
"home_number":"47",
"slug":"about2146"
}
}
},
"company_found":47,
"streets":[
{
"name":"\u0443\u043b. \u0424\u0438\u043b\u0438\u043c\u043e\u043d\u043e\u0432\u0430",
"addr:street":"\u0443\u043b. \u0424\u0438\u043b\u0438\u043c\u043e\u043d\u043e\u0432\u0430"
}
]
}
Личные инструменты
Пространства имён

Варианты
Действия
Навигация
Инструменты