Перейти к основному содержимому

/3.0/markers/clustered

API docs by Redocly

Каталог маркеров объектов (3.0)

2GIS API Support: api@2gis.ru URL: https://docs.2gis.com/

Маркеры

Получение коллекции генерализованных маркеров

Возвращает коллекцию генерализованных маркеров, удовлетворяющих параметрам, переданным в запросе. Маркер является представлением объекта на карте, то есть маркером может быть только объект с координатами.

query Parameters
key
required
string

Уникальный ключ пользователя API.

locale
string
Examples:
  • locale=ar_AE - Арабский язык для ОАЭ
  • locale=ru_RU - Русский язык для России

Локаль, с которой производится поиск и отдаются результаты.
Список доступных локалей:

  • az_AZ — азербайджанский (Азербайджан);
  • ru_AZ — русский (Азербайджан);
  • hy_AM — армянский (Армения);
  • ru_AM — русский (Армения);
  • ar_BH — арабский (Бахрейн);
  • en_BH — английский (Бахрейн);
  • ru_BY — русский (Беларусь);
  • ka_GE — грузинский (Грузия);
  • ru_GE — русский (Грузия);
  • en_EG — английский (Египет);
  • ar_EG — арабский (Египет);
  • it_IT — итальянский (Италия);
  • en_IQ — английский (Ирак);
  • ar_IQ — арабский (Ирак);
  • kk_KZ — казахский (Казахстан);
  • ru_KZ — русский (Казахстан);
  • en_QA — английский (Катар);
  • ar_QA — арабский (Катар);
  • en_CY — английский (Кипр);
  • es_CL — испанский (Кипр);
  • ky_KG — кыргызский (Кыргызстан);
  • ru_KG — русский (Кыргызстан);
  • en_CN — английский (Китай);
  • zh_CN — китайский (Китай);
  • ru_CN — русский (Китай);
  • en_KW — английский (Кувейт);
  • ar_KW — арабский (Кувейт);
  • en_MA — английский (Марокко);
  • ar_MA — арабский (Марокко);
  • en_AE — английский (ОАЭ);
  • ar_AE — арабский (ОАЭ);
  • en_OM — английский (Оман);
  • ar_OM — арабский (Оман);
  • en_RU — английский (Россия);
  • ar_RU — арабский (Россия);
  • es_RU — испанский (Россия);
  • it_RU — итальянский (Россия);
  • ru_RU — русский (Россия);
  • uk_RU — украинский (Россия);
  • cs_RU — чешский (Россия);
  • en_SA — английский (Саудовская Аравия);
  • ar_SA — арабский (Саудовская Аравия);
  • ru_TJ — русский (Таджикистан);
  • tg_TJ — таджикский (Таджикистан);
  • ru_UZ — русский (Узбекистан);
  • uz_UZ — узбекский (Узбекистан);
  • ru_UA — русский (Украина);
  • uk_UA — украинский (Украина);
  • cs_CZ — чешский (Чехия).

fields
Array of strings
Examples:
  • fields=items.name,items.schedule - Пример нескольких полей
  • fields=items.name - Пример единичного поля

Дополнительные поля, которые необходимо отобразить в ответе, перечисляются через запятую.
Список доступных полей:

  • items.name — название объекта;
  • items.org — организация, к которой относится филиал;
  • items.context — динамическая информация;
  • items.stop_factors — набор блокирующих атрибутов, соответствующих запросу;
  • items.schedule — расписание работы;
  • items.schedule_special — особое расписание работы;
  • items.reviews — статистика по отзывам;
  • items.temporary_unavailable_atm_services — признак наличия неработающих услуг у банкомата или терминала;
  • items.name_back — для дорожного знака локализованное название в обратном направлении при наличии;
  • items.value_back — для дорожного знака номер километра в обратном направлении;
  • items.has_ads_model — признак наличия рекламной 3D модели в здании;
  • items.floor_id — идентификатор этажа;

map_width
required
integer

Ширина в пикселях DOM-объекта, отображающего карту.

map_height
required
integer

Высота в пикселях DOM-объекта, отображающего карту.

q
required
string [ 1 .. 500 ] characters

Произвольная поисковая строка.

type
Array of strings
Examples:
  • type=adm_div,street - Пример нескольких типов
  • type=adm_div - Пример единичного типа

Типы объектов, среди которых производится поиск. При передаче нескольких типов менее релевантные результаты одних типов могут вытесниться более релевантными других типов. Типы перечисляются через запятую.
Значение adm_div является псевдонимом для всех типов adm_div.* одновременно.
Список доступных типов:

  • branch — компания;
  • building — здание;
  • street — улица;
  • parking — парковка;
  • station — остановки или станция общественного транспорта;
  • station.metro — станция метро;
  • station_entrance — вход на станцию;
  • station_platform — остановочная платформа;
  • attraction — достопримечательность;
  • crossroad — перекрёсток;
  • gate — проход/проезд;
  • road — дорога;
  • route — маршрут;
  • adm_div — административная единица;
  • adm_div.city — город;
  • adm_div.country — страна;
  • adm_div.district_area — район области;
  • adm_div.district — район;
  • adm_div.division — округ;
  • adm_div.living_area — жилмассив, микрорайон;
  • adm_div.place — разные площадные объекты: парки, пляжи, территории баз отдыха, озёра и прочие места;
  • adm_div.region — регион (область/край/республика и т.п.);
  • adm_div.settlement — населённый пункт (деревня, посёлок и т.п.);
  • adm_div.amana — амана;
  • coordinates — глобальная координата в системе координат WGS84 в формате lon, lat;
  • coordinates_additional — дополнительная глобальная координата в системе координат WGS84 в формате lon, lat;
  • kilometer_road_sign — знак километра.

Список доступных подтипов (subtype) для разных типов объектов можно посмотреть в схеме ответа внутри items.

search_type
string
Default: "discovery"

Тип производимого поиска.
Допустимые значения:

  • discovery — максимально широкий поиск с возможностью раскрытия связанных объектов (категории, соответствующие запросу, будут раскрыты до входящих в них компаний);
  • one_branch — идентичен discovery, но для организации будет отдан только один филиал компании;
  • indoor — конфигурация для качественного поиска компаний в здании. Допускает поиск по префиксу, как подсказчик. Для отключения префикса используйте search_is_query_text_complete;
  • ads — идентичен discovery, но будут выданы только объекты с рекламой. Кроме того, для организации будет отдан только один первый по ранжированию филиал компании;
  • discovery_partial_searcher — идентичен discovery, но будет задействовано больше вариантов пересечений связей;
  • discovery_partial_searcher_strict — идентичен discovery_partial_searcher, но с выключенным префиксным поиском.

search_only_within_view
boolean

Указание поисковому движку, что нужно взять результаты только из области видимости. Область видимости (вьюпорт) задается параметрами viewpoint1 и viewpoint2.

search_is_query_text_complete
boolean

Указание поисковому движку, что запрос является законченным (пользователь нажал на кнопку завершения ввода). Отключает префиксность, т.е. по "банк" не будет находиться "банкомат".

search_nearby
boolean

Указание поисковому движку использовать режима поиска рядом с пользователем. Сильно повышает значимость расстояния от пользователя. В ранжирование всё ещё участвует популярность, реклама и другие параметры, но в меньшей степени.

search_input_method
string

Указание поисковому движку способа ввода текста запроса:

  • hardware_qwerty_keyboard — физическая QWERTY-клавиатура
  • on_screen_keyboard — экранная touch screen клавиатура
  • voice — голосовой ввод
  • hand_writing — рукописный ввод
  • scanning — ввод который используется людьми с ограниченными возможностями. C помощью пальца или глазными движениями
  • software_generated — текст сгенерирован программным обеспечением
  • other — прочие типы ввода
search_device_type
string

Тип устройства:

  • mobile — мобильное устройство
  • desktop — десктоп (стационарное устройство)
search_disable_clipping_by_relevance
boolean

Запрет поиску откидывать малорелевантные запросу результаты из выдачи.

rubric_id
Array of integers
Examples:
  • rubric_id=19290,360 - Пример нескольких записей
  • rubric_id=19290 - Пример единичной записи

Идентификатор категории. Необходимо передать параметр region_id.
Также можно передавать список идентификаторов категорий через запятую. В этом случае все категории должны быть из одного региона.

org_id
integer

Фильтр по идентификатору организации, к которой относится компания.

ads_id
Array of integers
Examples:
  • ads_id=111,222 - Пример нескольких записей
  • ads_id=111 - Пример единичной записи

Идентификатор рекламной компании. Также можно передавать список идентификаторов через запятую.

is_reviewable_on_flamp
boolean

Разрешены ли отзывы к организациям на flamp.ru. Принимает значения: true или false.

has_photos
boolean

Фильтр по наличию фотографий. Принимает значения: true или false.

has_rating
boolean

Фильтр по наличию рейтинга на flamp.ru. Принимает значения: true или false.

has_reviews
boolean

Фильтр по наличию отзывов на flamp.ru. Принимает значения: true или false.

has_reviews_on_flamp
boolean

Фильтр по наличию отзывов на flamp.ru. В отличие от has_reviews, не учитывается статус ссылки в 2ГИС. Принимает значения: true или false.

has_site
boolean

Фильтр по наличию сайта. Принимает значения: true или false.

work_time
string
Examples:
  • work_time=now - Прямо сейчас
  • work_time=tue,alltime - Вторник, круглосуточно

Время работы организации. Формат: [day],[time] или now (текущий день и время).
Примеры:

  • Понедельник, 17:00 — mon,17:00
  • Четверг, 9:00 — thu,09:00
  • Сегодня, 9:00 — today,09:00
  • Пятница, весь день — fri,alltime
  • Сейчас — now

opened_after_date
string <date>
Examples:
  • opened_after_date=2007-09-03 - Позже чем 3 сентября 2007 года

Фильтрует компании у которых дата открытия позже чем переданный параметр.
Принимает значения в формате YYYY-MM-DD.

has_itin
boolean

Фильтр по наличию индивидуального номера налогоплательщика. Принимает значения: true или false.

has_trade_license
boolean

Фильтр по наличию торговой лицензии. Принимает значения true или false.

has_delivery
boolean

Фильтр по наличию доставки. Принимает значения true или false.

has_goods
boolean

Фильтр по наличию загруженного списка товаров. Принимает значения: true или false.

allow_deleted
boolean

Включать ли в выборку удаленные объекты. Принимает значения: true или false.

booking_checkin_date
string <date>
Example: booking_checkin_date=2025-09-02

Фильтр подбора свободных номеров в отелях. Дата выезда.

booking_checkin_date
string <date>
Example: booking_checkin_date=2025-09-02

Фильтр подбора свободных номеров в отелях. Дата выезда.

booking_adult_count
integer >= 1
Example: booking_adult_count=2

Фильтр подбора свободных номеров в отелях. Кол-во взрослых.

booking_children_ages
string
Example: booking_children_ages=7,10

Фильтр подбора свободных номеров в отелях. Возраста детей через запятую.

shv
string

Версия оболочки. Если параметр не передан, будет взята текущая версия API.

sort
string
Default: "relevance"

Сортировка результатов. Допустимые значения:

  • distance — по возрастанию расстояния, если передан параметр sort_point, point или location (расстояние рассчитывается от переданной точки до геометрии объекта по кратчайшему пути), иначе — сортировка по типу объекта и его площади;
  • relevance — по убыванию релевантности. В поиске участвует название организации и категории, в которые входит организация. Учитывает максимум разных факторов: точность соответствия запроса объекту, популярность объектов, рейтинг, расположение, реклама и многое другое;
  • rating — по убыванию рейтинга;
  • flamp_rating — по убыванию рейтинга Флампа;
  • creation_time — по убыванию даты создания компании;
  • opened_time — по убыванию даты открытия;
  • name — по наименованию (в алфавитном порядке по возрастанию).

sort_point
string
Deprecated
Examples:
  • sort_point=82.921663,55.030195 - Долгота и широта

Координаты точки, от которой производится сортировка (координаты точки в формате lon, lat). Устаревший параметр, вместо него нужно использовать параметр location.

location
string
Examples:
  • location=82.921663,55.030195 - Долгота и широта

Координаты пользователя в формате lon, lat.

district_id
Array of integers
Examples:
  • district_id=141347373711435,141347373711473,141347373711478 - Пример нескольких идентификаторов
  • district_id=141347373711435 - Пример единичного идентификатора

Идентификаторы районов, разделённые запятыми. Используется для фильтрации объектов по району.
Максимальное количество — 50.

building_id
Array of integers
Examples:
  • building_id=141373143515660,141373143523268 - Пример нескольких идентификаторов
  • building_id=141373143515660 - Пример единичного идентификатора

Идентификаторы зданий, разделённые запятыми. Используется для фильтрации объектов в здании.
Максимальное количество — 50.

place_id
Array of integers
Examples:
  • place_id=141424683123045,141424683123024 - Пример нескольких идентификаторов
  • place_id=141424683123045 - Пример единичного идентификатора

Идентификаторы мест, разделённые запятыми. Используется для фильтрации объектов на территории.
Максимальное количество — 50.

city_id
Array of integers
Examples:
  • city_id=141373143515660,141373143523268 - Пример нескольких идентификаторов
  • city_id=141373143515660 - Пример единичного идентификатора

Идентификаторы городов, разделённые запятыми. Используется для фильтрации объектов по городу.
Максимальное количество — 50.

subway
Array of integers
Examples:
  • subway=141523467371731,141523467371220 - Пример нескольких идентификаторов
  • subway=141523467371731 - Пример единичного идентификатора

Идентификаторы станций метро, разделённые запятыми. Используется для фильтрации объектов по станциям метро.
Максимальное количество — 50.

polygon
string
Examples:
  • polygon=POLYGON((82.91259527206421 55.0614369017519,82.90572881698608 55.05902823221974,82.91521310806274 55.05580825372468,82.91259527206421 55.0614369017519)) - Формат WKT

Полигон в формате WKT.
Используется для фильтрации результатов в произвольной области. Допустимая площадь полигона ~ 6 км^2. Если передан параметр q — ограничения не накладываются. Параметр конфликтует с параметрами point, point1, point2.

viewpoint1
required
string
Examples:
  • viewpoint1=82.921663,55.030195 - Долгота и широта

Координаты левой верхней вершины прямоугольной области видимости в формате lon, lat. Параметры viewpoint1 и viewpoint2 передают область карты, куда смотрел пользователь перед вводом запроса. Используется как один из критериев для выбора, где нужны результаты, и для ранжирования. Не ограничивает жёстко результаты поиска только переданной областью.

viewpoint2
required
string
Examples:
  • viewpoint2=82.921663,55.030195 - Долгота и широта

Координаты правой нижней вершины прямоугольной области видимости в формате lon, lat. Параметры viewpoint1 и viewpoint2 передают область карты, куда смотрел пользователь перед вводом запроса. Используется как один из критериев для выбора, где нужны результаты, и для ранжирования. Не ограничивает жёстко результаты поиска только переданной областью.

is_viewport_change
boolean

Признак явного изменения границ области видимости. Принимает значения true или false.

page
integer [ 1 .. 1000000 ]
Default: 1

Номер запрашиваемой страницы.

page_size
integer [ 1 .. 15000 ]
Default: 15000

Количество результатов поиска, выводимых на одной странице.

header Parameters
Authorization
string

Заголовок аутентификации пользователя в сессии.

Responses

Response Schema: application/json
required
object

Основной результат

required
object (ObjMeta)

Метаданные ответа

Response samples

Content type
application/json
{
  • "result": {
    • "items": [
      ],
    • "search_attributes": {
      },
    • "total": 1
    },
  • "meta": {
    • "issue_date": "string",
    • "code": 200,
    • "api_version": "dev"
    }
}