Геоограничение поиска
Для повышения точности поиска объектов при использовании endpoint-a /3.0/items задайте геоограничение в виде:
- текстового запроса;
- координат точки поиска;
- радиуса вокруг точки;
- прямоугольной области;
- произвольной области;
- области видимости;
- региона;
- города;
- района;
- территории;
- станции метро, рядом с которой выполнится поиск;
- здания.
Одновременно нельзя указывать геоограничения по радиусу, прямоугольной и произвольной области (параметры point, point1/point2 и polygon).
При использовании других endpoint-ов геоограничение можно не задавать.
Текстовый запрос
Вы можете указать в параметре q геоограничение для поиска: название региона, города, района, улицы, станции метро и т. д.
В параметре q можно одновременно указать и объект, и геоограничение, например кафе в Тверском районе Москвы. В запросе можно указать только один параметр q. Подробнее о поиске объектов см. в инструкции Поиск объектов.
Чтобы указать геоограничение в виде текста, отправьте GET-запрос на /3.0/items с параметром q — текстовым запросом, который содержит геоограничение, например «кафе пятницкая улица москва».
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе пятницкая улица москва&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.20949",
"code": 200,
"issue_date": "20260716"
},
"result": {
"items": [
{
"address_comment": "1 этаж",
"address_name": "Пятницкая улица, 3/4 ст1",
"id": "70000001059479230",
"name": "Хачапури и вино, кафе грузинской кухни",
"type": "branch"
},
{
"address_comment": "-1, 1 этаж",
"address_name": "Пятницкая улица, 54 ст2",
"id": "70000001048389948",
"name": "Nicepricecafe, кафе",
"type": "branch"
},
{
"address_comment": "3 этаж",
"address_name": "Пятницкая улица, 29",
"id": "70000001089085648",
"name": "True Cost, рестобар",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Пятницкая улица, 6/1 ст1",
"id": "70000001084006818",
"name": "J`pan, японское кафе",
"type": "branch"
},
{
"address_comment": "2 этаж",
"address_name": "Пятницкая улица, 29",
"id": "4504128908766878",
"name": "Козловица, чешская пивная",
"type": "branch"
},
{
"address_name": "Большая Серпуховская улица, 8/7 ст2",
"id": "70000001096198692",
"name": "Чико, кафе корейского стритфуда",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Пятницкий переулок, 4 ст1",
"id": "70000001077266426",
"name": "Старик Хинкалыч, хинкальная",
"type": "branch"
},
{
"address_name": "Пятницкая улица, 45",
"full_name": "Москва, Пятницкая улица, 45",
"id": "70000001077023503",
"name": "Ra`men, рамен-бар",
"purpose_name": "Кафе, бар",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Пятницкая улица, 25 ст1д",
"id": "70000001041362439",
"name": "Хатико, бар",
"type": "branch"
},
{
"address_name": "Пятницкая улица, 9/28 ст1",
"id": "70000001104445620",
"name": "Бардак, кафе турецкой кухни",
"type": "branch"
}
],
"total": 79
}
}
Координаты точки
С помощью параметра location вы можете задать ограничение поиска по координатам точки. В ответе первыми будут выведены наиболее близкие к точке объекты.
Чтобы указать точку в качестве области поиска, отправьте GET-запрос на /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».location— координаты точки поиска в форматедолгота,широта, напримерlocation=37.630866,55.752256.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&location=37.630866,55.752256&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260701"
},
"result": {
"items": [
{
"address_name": "улица Варварка, 6 ст3",
"id": "70000001029535674",
"name": "Зарядье, гастрономический центр",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001032763462",
"name": "The Black Swan Pub",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2 ст1",
"id": "70000001093401978",
"name": "Senti Menti",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Славянская площадь, 2/5/4 ст3",
"id": "70000001007260074",
"name": "Либерти, ночной клуб",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Лубянский проезд, 25 ст1",
"id": "4504127908781677",
"name": "Китайский Лётчик Джао Да, кафе-клуб",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001047225231",
"name": "Хачапури и вино, кафе грузинской кухни",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Новая площадь, 14",
"id": "70000001109804763",
"name": "Rusty Rat&Pizza",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Славянская площадь, 2/5",
"id": "4504128908449647",
"name": "True Cost, прожектор",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2 ст1",
"id": "70000001082439498",
"name": "Chang, кафе",
"type": "branch"
},
{
"address_comment": "2 этаж",
"address_name": "Лубянский проезд, 25 ст2",
"id": "70000001036209541",
"name": "Старый Сычуань, ресторан азиатской и восточной кухни",
"type": "branch"
}
],
"total": 1290
}
}
Радиус вокруг точки
С помощью параметра radius вы можете найти все объекты в радиусе вокруг точки. Точку можно задать с помощью параметра point или пары параметров lon и lat.
Максимальный радиус — 50 000 м. Если в запросе не указан объект в виде текстового запроса (параметр q) или в другом виде (например, ID организации org_id), максимальный радиус — 2 000 м. Рекомендуется указывать объект в запросе, чтобы получить более точные результаты поиска: см. пример запроса.
Чтобы указать радиус поиска, отправьте GET-запрос на /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».point— координаты центра точки поиска в форматедолгота,широта, напримерpoint=37.630866,55.752256.radius— радиус поиска в метрах, напримерradius=500.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&point=37.630866,55.752256&radius=500&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260702"
},
"result": {
"items": [
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001032763462",
"name": "The Black Swan Pub",
"type": "branch"
},
{
"address_name": "улица Варварка, 6 ст3",
"id": "70000001029535674",
"name": "Зарядье, гастрономический центр",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2 ст1",
"id": "70000001093401978",
"name": "Senti Menti",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001047225231",
"name": "Хачапури и вино, кафе грузинской кухни",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2 ст1",
"id": "70000001082439498",
"name": "Chang, кафе",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Лубянский проезд, 25 ст1",
"id": "4504127908781677",
"name": "Китайский Лётчик Джао Да, кафе-клуб",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1",
"id": "70000001032240412",
"name": "22 сантиметра, пиццерия",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Славянская площадь, 2/5/4 ст3",
"id": "70000001007260074",
"name": "Либерти, ночной клуб",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Славянская площадь, 2/5",
"id": "4504128908449647",
"name": "True Cost, прожектор",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Лубянский проезд, 15 ст2",
"id": "70000001007210203",
"name": "Casa Leone, итальянское кафе-джелатерия",
"type": "branch"
}
],
"total": 26
}
}
Прямоугольная область
С помощью параметров point1 и point2 вы можете ограничить результаты поиска прямоугольной областью, задав координаты левого верхнего и правого нижнего углов области. Максимальное расстояние между точками — два километра.
Чтобы указать прямоугольную область поиска, отправьте GET-запрос на /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».point1— координаты левого верхнего угла прямоугольной области в форматедолгота,широта, например37.609194,55.773293.point2— координаты правого нижнего угла прямоугольной области в форматедолгота,широта, например37.621403,55.767303.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&point1=37.609194,55.773293&point2=37.621403,55.767303&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260701"
},
"result": {
"items": [
{
"address_comment": "1 этаж",
"address_name": "Садовая-Самотечная улица, 20 ст1",
"id": "70000001069631787",
"name": "from Berlin, винный ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Петровка, 30/7",
"id": "70000001090847868",
"name": "Nothing Fancy, кафе",
"type": "branch"
},
{
"address_name": "Цветной бульвар, 11 ст3",
"full_name": "Москва, Цветной бульвар, 11 ст3",
"id": "70000001110827038",
"name": "Евгенич, бар",
"purpose_name": "Ресторан",
"type": "branch"
},
{
"address_comment": "цокольный, 1 этаж",
"address_name": "Петровский бульвар, 15 ст1",
"id": "70000001066422742",
"name": "Kook, бистро корейской кухни",
"type": "branch"
},
{
"address_name": "улица Петровка, 34 ст1",
"id": "70000001103813228",
"name": "Санто Джованни, ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Цветной бульвар, 21 ст7",
"id": "70000001037519913",
"name": "Ra`men, рамен-бар",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Цветной бульвар, 21 ст2",
"id": "70000001035056426",
"name": "Майкл Коллинз, ирландский паб",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Садовая-Каретная улица, 20 ст2",
"id": "4504127913846311",
"name": "Delicatessen, бар",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Садовая-Самотечная улица, 18 ст1",
"id": "70000001066596627",
"name": "Практика by Darvin, винный бар",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Цветной бульвар, 25 ст1",
"id": "70000001006156339",
"name": "Пипл&Паста, паста-бар",
"type": "branch"
}
],
"total": 23
}
}
Произвольная область
Чтобы указать произвольную область поиска (полигон), отправьте GET-запрос на /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».polygon— координаты вершин полигона в формате WKT.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&polygon=POLYGON((37.6146002 55.761322, 37.6175267 55.7628083, 37.6184916 55.7615712, 37.6152171 55.7605209, 37.6146002 55.761322))&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.20949",
"code": 200,
"issue_date": "20260707"
},
"result": {
"items": [
{
"address_comment": "1 этаж",
"address_name": "улица Большая Дмитровка, 10/2 ст4",
"id": "70000001094146856",
"name": "J`pan, японское кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Большая Дмитровка, 12/1",
"id": "70000001100859771",
"name": "Хачапури и вино, кафе грузинской кухни",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Большая Дмитровка, 7/5 ст5",
"id": "4504128908372099",
"name": "Moloko, кафе",
"type": "branch"
}
],
"total": 3
}
}
Область видимости
С помощью параметров viewpoint1 и viewpoint2 вы можете ограничить результаты поиска областью видимости (прямоугольной областью карты). В отличие от геоограничения прямоугольной областью, область видимости влияет на ранжирование результатов, но не ограничивает поиск строго заданными границами.
Чтобы указать область видимости, отправьте GET-запрос на /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».viewpoint1— координаты левого верхнего угла прямоугольной области в форматедолгота,широта, например37.609194,55.773293.viewpoint2— координаты правого нижнего угла прямоугольной области в форматедолгота,широта, например37.621403,55.767303.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&viewpoint1=37.609194,55.773293&viewpoint2=37.621403,55.767303&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260701"
},
"result": {
"items": [
{
"address_comment": "1 этаж",
"address_name": "улица Петровка, 30/7",
"id": "70000001090847868",
"name": "Nothing Fancy, кафе",
"type": "branch"
},
{
"address_name": "улица Петровка, 34 ст1",
"id": "70000001103813228",
"name": "Санто Джованни, ресторан",
"type": "branch"
},
{
"address_comment": "цокольный, 1 этаж",
"address_name": "Петровский бульвар, 15 ст1",
"id": "70000001066422742",
"name": "Kook, бистро корейской кухни",
"type": "branch"
},
{
"address_name": "Страстной бульвар, 12 ст5",
"id": "70000001038478346",
"name": "Салют, велокафе",
"type": "branch"
},
{
"address_name": "Цветной бульвар, 11 ст3",
"full_name": "Москва, Цветной бульвар, 11 ст3",
"id": "70000001110827038",
"name": "Евгенич, бар",
"purpose_name": "Ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Садовая-Самотечная улица, 20 ст1",
"id": "70000001069631787",
"name": "from Berlin, винный ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Цветной бульвар, 21 ст7",
"id": "70000001037519913",
"name": "Ra`men, рамен-бар",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Цветной бульвар, 21 ст2",
"id": "70000001035056426",
"name": "Майкл Коллинз, ирландский паб",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Страстной бульвар, 8а",
"id": "70000001051182296",
"name": "Моремания, кафе-магазин",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Садовая-Каретная улица, 20 ст2",
"id": "4504127913846311",
"name": "Delicatessen, бар",
"type": "branch"
}
],
"total": 2721
}
}
Регион
С помощью параметра region_id вы можете ограничить результаты поиска регионом, задав его идентификатор. Максимальное количество регионов в запросе — 50.
Чтобы указать регион в качестве области поиска, отправьте GET-запрос на /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».region_id— ID региона, напримерregion_id=32. Подробнее о получении ID см. в разделе ID региона.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе®ion_id=32&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260701"
},
"result": {
"items": [
{
"address_comment": "1, 2 этаж",
"address_name": "2-я Останкинская улица, 3",
"id": "70000001096768454",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001032763462",
"name": "The Black Swan Pub",
"type": "branch"
},
{
"address_comment": "4 этаж",
"address_name": "улица Земляной Вал, 33",
"id": "70000001098878843",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "-2 этаж; Средний уровень",
"address_name": "Манежная площадь, 1 ст2",
"id": "70000001007179642",
"name": "Му-Му, кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Новослободская улица, 16",
"id": "70000001062465220",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Душинская улица, 14",
"id": "70000001037319561",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "2 этаж",
"address_name": "Большая Тульская улица, 13",
"id": "70000001068109619",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Новая площадь, 14",
"id": "70000001109804763",
"name": "Rusty Rat&Pizza",
"type": "branch"
},
{
"address_comment": "1-2 этаж",
"address_name": "Новинский бульвар, 31",
"id": "70000001077241148",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_name": "улица Варварка, 6 ст3",
"id": "70000001029535674",
"name": "Зарядье, гастрономический центр",
"type": "branch"
}
],
"total": 8742
}
}
Город
С помощью параметра city_id вы можете ограничить результаты поиска городом, задав его идентификатор. Максимальное количество городов в запросе — 50.
Чтобы указать город в качестве области поиска, отправьте GET-запрос на /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».city_id— ID города, напримерcity_id=4504222397630173. Можно использовать несколько ID, разделённых запятыми, напримерcity_id=4504222397630173,4504222397630174. Подробнее о получении ID см. в разделе ID города.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&city_id=4504222397630173&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.20949",
"code": 200,
"issue_date": "20260716"
},
"result": {
"items": [
{
"address_comment": "1, 2 этаж",
"address_name": "2-я Останкинская улица, 3",
"id": "70000001096768454",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001032763462",
"name": "The Black Swan Pub",
"type": "branch"
},
{
"address_comment": "-2 этаж; Средний уровень",
"address_name": "Манежная площадь, 1 ст2",
"id": "70000001007179642",
"name": "Му-Му, кафе",
"type": "branch"
},
{
"address_comment": "4 этаж",
"address_name": "улица Земляной Вал, 33",
"id": "70000001098878843",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Душинская улица, 14",
"id": "70000001037319561",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Новослободская улица, 16",
"id": "70000001062465220",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Новая площадь, 14",
"id": "70000001109804763",
"name": "Rusty Rat&Pizza",
"type": "branch"
},
{
"address_comment": "3 этаж",
"address_name": "Можайское шоссе, 45Б",
"id": "70000001063551091",
"name": "Руки Вверх!, бар",
"type": "branch"
},
{
"address_name": "улица Варварка, 6 ст3",
"id": "70000001029535674",
"name": "Зарядье, гастрономический центр",
"type": "branch"
},
{
"address_name": "Сущёвская улица, 21 ст8",
"full_name": "Москва, Сущёвская улица, 21 ст8",
"id": "70000001021629955",
"name": "Молодежь, ночной клуб-рестобар",
"purpose_name": "Кафе, бар",
"type": "branch"
}
],
"total": 5039
}
}
Район
С помощью параметра district_id вы можете ограничить результаты поиска районом, задав его идентификатор. Максимальное количество районов в запросе — 50.
При использовании параметра district_id в ответе будут возвращены только объекты с типом «организация» ("type": "branch").
Чтобы указать район в качестве области поиска, отправьте GET-запрос на /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».district_id— ID района, напримерdistrict_id=4504209512726534. Можно использовать несколько ID, разделённых запятыми, напримерdistrict_id=4504209512726534,4504209512726539. Подробнее о получении ID см. в разделе ID района.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&district_id=4504209512726534&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.20949",
"code": 200,
"issue_date": "20260715"
},
"result": {
"items": [
{
"address_comment": "2 этаж",
"id": "70000001112717191",
"name": "Substance, кафе с бильярдом",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Калужская площадь, 1 к1",
"id": "70000001110471401",
"name": "Kono, раменная из Азии",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Большая Полянка, 1/3",
"id": "4504128908478282",
"name": "Чайхона №1, ресторан",
"type": "branch"
},
{
"address_name": "Крымская набережная, 10 ст2",
"full_name": "Москва, Крымская набережная, 10 ст2",
"id": "70000001113359188",
"name": "Здрасте, кофейня",
"purpose_name": "Кафе, бар",
"type": "branch"
},
{
"address_name": "улица Шаболовка, 19",
"id": "70000001066388017",
"name": "Dizengof/99, кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Крымский Вал, 9 ст32",
"id": "70000001006712029",
"name": "Гараж, кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Большая Полянка, 26 ст2",
"id": "70000001017909556",
"name": "Шоколадница, кофейня",
"type": "branch"
},
{
"address_name": "улица Крымский Вал, 9 ст21",
"full_name": "Москва, улица Крымский Вал, 9 ст21",
"id": "4504128908795031",
"name": "8 Oz, ресторан",
"purpose_name": "Ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Берсеневская набережная, 6 ст2",
"id": "70000001026770391",
"name": "Dictatura estetica, коктейльный бар",
"type": "branch"
},
{
"address_comment": "1-2 этаж",
"address_name": "улица Малая Якиманка, 24",
"id": "4504127908503148",
"name": "Квартира 44, кафе-бар",
"type": "branch"
}
],
"total": 65
}
}
Территория
С помощью параметра place_id вы можете ограничить результаты поиска территорией, задав её идентификатор. Территории — это площадные объекты: парки, пляжи, территории баз отдыха, озёра и прочие места. Максимальное количество территорий в запросе — 50.
Чтобы указать территорию в качестве области поиска, отправьте GET-запрос на /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».place_id— ID территории, напримерplace_id=4504286822138302. Можно использовать несколько ID, разделённых запятыми, напримерplace_id=4504286822138302,4504127908543952. Подробнее о получении ID см. в разделе ID территории.location— координаты точки поиска в форматедолгота,широта, напримерlocation=37.637635,55.826241.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&place_id=4504286822138302&location=37.637635,55.826241&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.20949",
"code": 200,
"issue_date": "20260716"
},
"result": {
"items": [
{
"address_comment": "1, 2 этаж",
"address_name": "2-я Останкинская улица, 3",
"id": "70000001096768454",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "проспект Мира, 119 ст521",
"full_name": "Москва, проспект Мира, 119 ст521",
"id": "70000001023459254",
"name": "Вареничная №1, кафе",
"purpose_name": "Кафе, бар",
"type": "branch"
},
{
"address_name": "проспект Мира, 119 ст523",
"full_name": "Москва, проспект Мира, 119 ст523",
"id": "70000001113876226",
"name": "Джонджоли, грузинский ресторан",
"purpose_name": "Ресторан",
"type": "branch"
},
{
"address_name": "2-я Останкинская улица, 3",
"id": "70000001069037911",
"name": "HookahPlace VDNH, лаундж-бар",
"type": "branch"
},
{
"address_comment": "2 этаж",
"address_name": "1-я Останкинская улица, 57",
"id": "70000001080100038",
"name": "Фо Ши Мин, кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "проспект Мира, 119 ст164",
"id": "70000001062580779",
"name": "Урожай, кафе-столовая",
"type": "branch"
},
{
"address_name": "проспект Мира, 119 ст337",
"full_name": "Москва, проспект Мира, 119 ст337",
"id": "70000001077390769",
"name": "Дача, кафе",
"purpose_name": "Кафе, бар",
"type": "branch"
},
{
"address_comment": "2 этаж",
"address_name": "1-я Останкинская улица, 53",
"id": "4504127908370247",
"name": "Mezzo Forte, кафе-клуб",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "1-я Останкинская улица, 53",
"id": "4504127908705664",
"name": "Шашлычный двор, кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "2-я Останкинская улица, 3",
"id": "70000001064053312",
"name": "Шоколадница, кофейня",
"type": "branch"
}
],
"total": 50
}
}
Станция метро
С помощью параметра subway вы можете задать ограничение поиска по станции метро. Максимальное количество станций в запросе — 50.
Чтобы указать станцию метро, рядом с которой будет выполняться поиск, отправьте GET-запрос на /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».subway— ID станции метро, напримерsubway=4504385606390686. Можно использовать несколько ID, разделённых запятыми, напримерsubway=4504385606388294,4504385606390686. Подробнее о получении ID см. в разделе ID станции метро.location— координаты точки поиска в форматедолгота,широта, напримерlocation=37.630866,55.752256.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&subway=4504385606390686&location=37.630866,55.752256&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260701"
},
"result": {
"items": [
{
"address_comment": "1 этаж",
"address_name": "Ломоносовский проспект, 25 к5",
"id": "70000001038965056",
"name": "Тянутая лапша Ланьчжоу, кафе",
"type": "branch"
},
{
"address_comment": "2 этаж",
"address_name": "Вернадского проспект, вл6 ст3",
"id": "70000001090652654",
"name": "Рынок и общепит",
"type": "branch"
},
{
"address_name": "Ломоносовский проспект, 25 к5",
"id": "70000001087005251",
"name": "Китайский Самовар, кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Ломоносовский проспект, 25 к5",
"id": "70000001069504590",
"name": "Hi Малатан, китайское кафе",
"type": "branch"
},
{
"address_name": "Ленинский проспект, 73/8",
"id": "70000001049547646",
"name": "Ниппон, кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Ломоносовский проспект, 25 к1",
"id": "4504128908407264",
"name": "Шоколадница, кофейня",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Ленинский проспект, 68/10",
"id": "4504127908533690",
"name": "Якитория, японский ресторан",
"type": "branch"
},
{
"address_comment": "2 этаж",
"address_name": "площадь Джавахарлала Неру, 1",
"id": "70000001076978648",
"name": "Left & Right, кафе китайской кухни",
"type": "branch"
},
{
"address_name": "Ленинский проспект, 72/2",
"id": "70000001103161874",
"name": "1872, кафе",
"type": "branch"
},
{
"address_name": "Ломоносовский проспект, 25 к5",
"id": "70000001104314538",
"name": "Рисарт, кафе китайской кухни",
"type": "branch"
}
],
"total": 32
}
}
Здание
С помощью параметра building_id вы можете ограничить результаты поиска зданием, задав его идентификатор. Максимальное количество зданий в запросе — 50.
Чтобы указать здание в качестве области поиска, отправьте GET-запрос на /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».building_id— ID здания, напримерbuilding_id=4504235299048514. Можно использовать несколько ID, разделённых запятыми, напримерbuilding_id=4504235299048514,4504235282736775. Подробнее о получении ID см. в разделе ID здания.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&building_id=4504235299048514&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.21070",
"code": 200,
"issue_date": "20260730"
},
"result": {
"items": [
{
"address_comment": "3 этаж",
"address_name": "Кадашёвская набережная, 12",
"id": "70000001114871525",
"name": "Видовое кафе",
"type": "branch"
}
],
"total": 1
}
}