Примеры

Поиск компаний

Поиск по текстовому параметру

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

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

Поиск в радиусе

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

Поиск в радиусе с сортировкой по удалённости

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

Поиск с указанием точки поиска

https://catalog.api.2gis.com/3.0/markers?q=кафе&location=37.545423%2C55.740693&key=YOUR_KEY

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

Поиск в прямоугольной области

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

Поиск в произвольной области

https://catalog.api.2gis.com/3.0/markers?q=кафе&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. Поиск города по точке:

https://catalog.api.2gis.com/3.0/markers?lon=37.62143&lat=55.752966&type=adm_div.city&key=YOUR_KEY

Вариант 2. Поиск города по названию:

https://catalog.api.2gis.com/3.0/markers?q=Москва&key=YOUR_KEY

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

https://catalog.api.2gis.com/3.0/markers?q=кафе&city_id=4504222397630173&key=YOUR_KEY

Поиск в определённом городе с сортировкой по рейтингу

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

Поиск рядом со станцией метро

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

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

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

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

https://catalog.api.2gis.com/3.0/markers?type=station.metro&q=косино&location=37.617135%2C55.757705&key=YOUR_KEY

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

https://catalog.api.2gis.com/3.0/markers?q=красота&subway=70030076180130124&location=37.617135%2C55.757705&key=YOUR_KEY

Поиск с фильтрацией по времени работы и по наличию сайта

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

Поиск с фильтрацией по дополнительным атрибутам

https://catalog.api.2gis.com/3.0/markers?q=поесть&city_id=4504222397630173&attr[food_service_business_lunch]=true&attr[food_service_capacity]=10,30&key=YOUR_KEY

Поиск мест

Поиск парковок в радиусе

https://catalog.api.2gis.com/3.0/markers?q=парковки&type=parking&point=37.592004%2C55.737264&radius=1000&key=YOUR_KEY

Поиск здания

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

Поиск остановки

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

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

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

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