Обзор | 2GIS Documentation
Regions API

Regions API


Regions API используется для выбора региона, в границах которого выполняется поиск организаций, зданий и мест.

Регионом (region_id) в рамках Поисковых API называется агломерация, включающая крупный город и ближайшие населённые пункты, а также города-спутники. Это территории с повышенной детализацией карты и подробным набором данных и атрибутов справочника. Территории за границами региона — населенные пункты, область в целом, край, республика и т. д. — называются сегментами (segment_id).

Обратите внимание, что регионы и сегменты отвечают только внутреннему формату хранения данных в 2ГИС и в общем случае никак не связаны с субъектами Российской Федерации.

Этот API предназначен в основном для внутреннего использования.

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


В данном разделе приведён пример запроса

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

В запросе используются следующие параметры:

  • q=Москва — поиск выполняется по запросу «Москва»;
  • key=YOUR_KEY — ваш ключ API.

Ответ на запрос возвращается в формате JSON:

{
    "meta": {
        "api_version": "2.0.448950",
        "code": 200,
        "issue_date": "20200629"
    },
    "result": {
        "items": [
            {
                "id": "32",
                "name": "Москва",
                "type": "region"
            }
        ],
        "total": 1
    }
}

Ниже представлен пример работы с Regions API.

https://catalog.api.2gis.com/2.0/region/search?q=Москва&key=YOUR_KEY
https://catalog.api.2gis.com/2.0/catalog/rubric/search?q=кафе&region_id=32&key=YOUR_KEY
https://catalog.api.2gis.com/3.0/items?rubric_id=162&sort_point=37.622161%2C55.751597&key=YOUR_KEY

  1. Получите ключ:

    1. Зарегистрируйтесь в личном кабинете Platform Manager.
    2. Создайте демо-ключ (если вы еще не пользовались продуктами 2ГИС) или запросите боевой ключ по ссылке для связи с менеджером на вкладке Ключи API.

    В личном кабинете вы также можете:

    • Просматривать информацию по своим уже созданным ключам: какие сервисы подключены, какой лимит задан по каждому из них, когда ключ будет деактивирован.
    • Задавать ограничения на ключ по HTTP-заголовкам или по IP и подсетям.
    • Изучать статистику распределения запросов по каждому ключу.
  2. Изучите формат запроса и формат ответа.

  3. Изучите примеры запросов к Regions API.