Обзор | 2GIS Documentation
Geocoder API

Geocoder API

Geocoder API позволяет определять координаты и получать сведения об объекте на карте по его адресу (прямое геокодирование) и наоборот, определять адрес объекта на карте по его координатам (обратное геокодирование).

Запросы осуществляются методом GET, все необходимые параметры передаются в строке запроса. Ответы формируются только в формате JSON.


Щёлкните по карте, чтобы узнать адрес.

Если в запросе указать адрес объекта, то Geocoder API вернёт его географические координаты.

И наоборот, если в запросе указать географические координаты объекта, то Geocoder API вернёт его адрес.

Click on the map to see the URL of the API request

Вы также можете поработать с Geocoder API в песочнице внутри личного кабинета (авторизация не требуется).


Используется для определения координат по названию объекта или его адресу. Например: пользователь указывает адрес, адрес преобразуется в координаты.

Используется для определения адреса объекта по его координатам. Например: можно выбрать ближайший к точке на карте дом и получить его адрес.


Пример запроса прямого геокодирования:

https://catalog.api.2gis.com/3.0/items/geocode?q=Москва, Садовническая, 25&fields=items.point&key=YOUR_KEY

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

  • q=Москва, Садовническая, 25 — адрес здания, координаты которого требуется получить;
  • key=YOUR_KEY — ваш ключ API.

Ответ включает в себя искомый объект и его координаты.

Пример ответа в формате JSON:

{
    "meta": {
        "api_version": "3.0.426762",
        "code": 200,
        "issue_date": "20200506"
    },
    "result": {
        "items": [
            {
                "address_name": "Садовническая, 25",
                "full_name": "Москва, Садовническая, 25",
                "id": "4504235282713264_byBBk7792J2H4609HHH1twkm2H3I62G4163B3843vgfpq72C45J4I1JJ2IH8d4ukD178B744355374H2HJJHGJ268",
                "name": "Садовническая, 25",
                "point": {
                    "lat": 55.746397,
                    "lon": 37.634369
                },
                "purpose_name": "Жилой дом с административными помещениями",
                "type": "building"
            }
        ],
        "total": 1
    }
}

Пример запроса обратного геокодирования:

https://catalog.api.2gis.com/3.0/items/geocode?lat=55.751508&lon=37.615666&fields=items.point&key=YOUR_KEY

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

  • lat=55.75150 — широта точки;
  • lon=37.615666 — долгота точки;
  • key=YOUR_KEY — ваш ключ API.

Ответ включает в себя объект в точке и его координаты.

Пример ответа в формате JSON:

{
    "meta": {
        "api_version": "3.0.427735",
        "code": 200,
        "issue_date": "20200506"
    },
    "result": {
        "items": [
            {
                "address_name": "Кремль, 1х",
                "building_name": "Государственный Кремлёвский Дворец",
                "full_name": "Москва, Государственный Кремлёвский Дворец",
                "id": "4504235282815753_mA8z1A239J66052JH1HHs43phH3I63G74BHB26A5ogfpq7473CJ1I0JJI5AGps16E17941372854H0H2HJJH24d",
                "name": "Государственный Кремлёвский Дворец",
                "point": {
                    "lat": 55.75142,
                    "lon": 37.615606
                },
                "purpose_name": "Культурное учреждение",
                "type": "building"
            }
        ],
        "total": 1
    }
}

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

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

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

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

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