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

Поиск регионов по ключевым словам

Спецификация OpenAPI
API docs by Redocly

Справочник регионов (2.0)

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

Регионы

Поиск регионов

Регион — это агломерация, включающая крупный город и ближайшие населённые пункты. Теперь можно реализовать выбор города, как это сделано в Онлайн-версии 2ГИС, являющейся партнёром API.

query Parameters
key
required
string

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

q
required
string [ 1 .. 400 ] characters

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

lang
string
Default: "ru"

Язык регионов.

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 — арабский (Марокко);
  • mn_MN — монгольский (Монголия);
  • en_MN — английский (Монголия);
  • en_AE — английский (ОАЭ);
  • ar_AE — арабский (ОАЭ);
  • en_OM — английский (Оман);
  • ar_OM — арабский (Оман);
  • en_RU — английский (Россия);
  • ar_RU — арабский (Россия);
  • es_RU — испанский (Россия);
  • it_RU — итальянский (Россия);
  • ru_RU — русский (Россия);
  • cs_RU — чешский (Россия);
  • en_SA — английский (Саудовская Аравия);
  • ar_SA — арабский (Саудовская Аравия);
  • ru_TJ — русский (Таджикистан);
  • tg_TJ — таджикский (Таджикистан);
  • ru_UZ — русский (Узбекистан);
  • uz_UZ — узбекский (Узбекистан);
  • cs_CZ — чешский (Чехия).

country_code_filter
Array of strings
Example: country_code_filter=ru

Список кодов страны через запятую, по которым нужно фильтровать.

page
integer
Default: 1

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

page_size
integer [ 1 .. 2000 ]
Default: 1000

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

locale_filter
Array of strings
Example: locale_filter=ru_RU

Список локалей через запятую, по которым нужно фильтровать.

fields
Array of strings

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

  • items.name_grammatical_cases — cклонение названия региона;
  • items.domain — значение домена;
  • items.locales — список локалей, на которых возможен поиск для данного региона;
  • items.time_zone — часовой пояс;
  • items.bounds — геометрия границ проекта в формате WKT;
  • items.statistics — статистика по региону;
  • items.locale — текущая локаль для региона;
  • items.settlements — список городов-спутников;
  • items.satellites — список городов-спутников в виде объектов;
  • items.online_languages — допустимые языки интерфейса в Онлайн-версии 2ГИС для проекта;
  • items.zoom_level — уровень масштаба;
  • items.seo — дополнительные поля для SEO;
  • items.code — код региона;
  • items.uri_code — код региона, который будет отображаться в домене;
  • items.uri_aliases — набор алиасов региона;
  • items.allow_for_indexing — список языков проекта, на которых разрешено индексировать;
  • items.weights_time — время последнего обновления рекламных весов в формате Unix timestamp;
  • items.hidden — флаг, является ли проект скрытым;
  • items.country_code — код страны;
  • items.flags — признаки наличия определённой информации в регионе;
  • items.default_pos — позиция по умолчанию для отображения проекта;
  • items.extras_tips_languages — допустимые языки.

type
string
Default: "region"
Examples:
  • type=region,segment - Пример нескольких типов
  • type=region - Пример единичного типа

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

  • region — регион;
  • segment — сегмент;
  • universe — universe.

Responses

Response Schema:
required
object (ObjMeta)

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

required
object

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

Response samples

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