Примеры | 2GIS Documentation

Примеры

https://catalog.api.2gis.ru/3.0/items?q=Москва кафе&type=branch&key=YOUR_KEY

Для более точного поиска без геоограничения в тексте запроса следует указывать город (посёлок, район, область), где производится поиск.


https://catalog.api.2gis.ru/3.0/items?q=кафе&type=branch&point=37.416469%2C55.619325&radius=1000&key=YOUR_KEY

https://catalog.api.2gis.ru/3.0/items?q=кафе&point=37.545423%2C55.740693&radius=1000&sort_point=37.545423%2C55.740693&sort=distance&key=YOUR_KEY

https://catalog.api.2gis.ru/3.0/items?q=кафе&sort_point=37.545423%2C55.740693&key=YOUR_KEY

Первыми будут выведены наиболее близкие к точке объекты. Город в тексте запроса можно не указывать.


https://catalog.api.2gis.ru/3.0/items?q=кафе&fields=items.point&point1=37.602631%2C55.764592&point2=37.648702%2C55.743089&key=YOUR_KEY

https://catalog.api.2gis.ru/3.0/items?q=кафе&fields=items.point&polygon=POLYGON((37.5930 55.7667,37.6494 55.7667,37.6494 55.7405,37.5930 55.7405,37.5930 55.7667))&key=YOUR_KEY

Область поиска задаётся в формате WKT.


Шаг 1. Определяем city_id, в котором производится поиск. Берём значение из поля id (часть до знака "_").

  1. Вариант 1. Поиск города по точке:
https://catalog.api.2gis.ru/3.0/items?lon=37.62143&lat=55.752966&type=adm_div.city&key=YOUR_KEY
  1. Вариант 2. Поиск города по названию:
https://catalog.api.2gis.ru/3.0/items?q=Москва&key=YOUR_KEY

Шаг 2. Значение из поля id (часть до знака "_") передаём в поле city_id при запросе.

https://catalog.api.2gis.ru/3.0/items?q=кафе&fields=items.point&city_id=4504222397630173&key=YOUR_KEY

https://catalog.api.2gis.ru/3.0/items?q=красота&city_id=4504222397630173&sort=rating&key=YOUR_KEY

Вариант 1. Поиск с названием станции в запросе.

https://catalog.api.2gis.ru/3.0/items?q=метро косино красота&city_id=4504222397630173&key=YOUR_KEY

Вариант 2. Поиск с фильтром по станции метро.

Шаг 1. Определяем id метро. Берём значение из поля id (часть до знака "_").

https://catalog.api.2gis.ru/3.0/items?type=station.metro&q=косино&fields=items.point&sort_point=37.617135%2C55.757705&key=YOUR_KEY

Шаг 2. Значение из поля id передаём в поле subway при запросе, город в названии можно не указывать:

https://catalog.api.2gis.ru/3.0/items?q=красота&fields=items.point&subway=70030076180130124&sort_point=37.617135%2C55.757705&key=YOUR_KEY

https://catalog.api.2gis.ru/3.0/items?q=красота&city_id=4504222397630173&work_time=thu,09:00&has_site=true&key=YOUR_KEY

Шаг 1. По точке или по названию ищем регион, в котором будет производиться поиск. Берём значение из поля id.

Поиск региона по названию:

https://catalog.api.2gis.ru/2.0/region/search?q=Москва&key=YOUR_KEY

Поиск региона по точке:

https://catalog.api.2gis.ru/2.0/region/search?q=37.624186%2C55.754285&key=YOUR_KEY

Шаг 2. Ищем рубрику, по которой будет раскрываться список филиалов. В region_id передаём значение из шага 1. Берём значения из поля id нужных рубрик.

https://catalog.api.2gis.ru/2.0/catalog/rubric/search?region_id=32&q=супермаркеты&key=YOUR_KEY

Шаг 3. Делаем запрос на /3.0/items с rubric_id=id из прошлого шага (или несколько id через запятую). Добавляем геоограничение (point + radius / sort_point / point1 + point2 / polygon / city_id).

https://catalog.api.2gis.ru/3.0/items?rubric_id=350,12127&point=37.624186%2C55.754285&radius=1000&key=YOUR_KEY

Шаг 1. Ищем филиалы организации, берём значение из поля items->org->id

https://catalog.api.2gis.ru/3.0/items?q=москва бургеры&fields=items.org&key=YOUR_KEY

Шаг 2. Делаем запрос на метод /3.0/items с org_id=id из прошлого шага. Добавляем геоограничение (point + radius / point1 + point2 / polygon / city_id).

https://catalog.api.2gis.ru/3.0/items?org_id=4504136499435533&city_id=4504222397630173&key=YOUR_KEY

Шаг 1. Ищем здание, берём значение из поля id (часть до знака "_").

https://catalog.api.2gis.ru/3.0/items?q=Москва Доватора, 6/6 к8&type=building&key=YOUR_KEY

Шаг 2. Делаем запрос на метод /3.0/items с building_id=id из прошлого шага.

https://catalog.api.2gis.ru/3.0/items?building_id=4504235282582289&key=YOUR_KEY


Обслуживающие компании - такие компании, как почта, поликлиника, ЖКХ, интернет-провайдеры, школа, пункт полиции.

Шаг 1. Ищем здание, берём значение из поля id (часть до знака "_").

https://catalog.api.2gis.ru/3.0/items?q=Москва, Доватора, 9&key=YOUR_KEY

Шаг 2. Делаем запрос на метод /2.0/catalog/branch/list с building_id=id из прошлого шага. Для получения обслуживающих организаций указать параметр servicing=true.

Получение служб дома (почта, поликлиника, ЖКХ):

https://catalog.api.2gis.ru/2.0/catalog/branch/list?building_id=4504235282737147&servicing=true&servicing_group=default&key=YOUR_KEY

Получение провайдеров в здании:

https://catalog.api.2gis.ru/2.0/catalog/branch/list?building_id=4504235282737147&servicing=true&servicing_group=internet&key=YOUR_KEY

Получение служб этого дома и провайдеров в одном запросе:

https://catalog.api.2gis.ru/2.0/catalog/branch/list?building_id=4504235282737147&servicing=true&key=YOUR_KEY

https://catalog.api.2gis.ru/3.0/items/byphone?phone=88001000000&fields=items.org&key=YOUR_KEY

https://catalog.api.2gis.ru/3.0/items/bysite?site=www.ikea.ru&key=YOUR_KEY

https://catalog.api.2gis.ru/2.0/catalog/branch/list?itin=7724490000&key=YOUR_KEY

https://catalog.api.2gis.ru/2.0/catalog/branch/list?trade_licence=*&key=YOUR_KEY

https://catalog.api.2gis.ru/3.0/items/byid?id=141265769584430&fields=items.links.database_entrances&key=YOUR_KEY

https://catalog.api.2gis.ru/3.0/items?q=парковки&type=parking&point=37.592004%2C55.737264&radius=1000&fields=items.capacity,items.point,items.level_count,items.purpose,items.is_paid&key=YOUR_KEY

https://catalog.api.2gis.ru/3.0/items?q=Москва Доватора, 9&fields=items.address,items.adm_div,items.floors,items.point,items.links,items.structure_info.apartments_count,items.structure_info.material,items.structure_info.porch_count&key=YOUR_KEY

Поиск станции метро в Москве:

https://catalog.api.2gis.ru/3.0/items?q=Арбатская&type=station&city_id=4504222397630173&key=YOUR_KEY

Поиск автобусной остановки в Москве:

https://catalog.api.2gis.ru/3.0/items?q=Красная площадь&type=station&city_id=4504222397630173&key=YOUR_KEY

https://catalog.api.2gis.ru/3.0/items/byid?id=4504235282757081&key=YOUR_KEY

В ответе могут быть как входы в подъезды, так и входы в организации.

https://catalog.api.2gis.ru/3.0/items/byid?id=4504235282757081&fields=items.links.database_entrances&key=YOUR_KEY

https://catalog.api.2gis.ru/3.0/items/byid?id=4504127908435201&key=YOUR_KEY

https://catalog.api.2gis.ru/3.0/items/byid?id=4504385606385704&fields=items.links.database_entrances&key=YOUR_KEY