Geocoding API | 2GIS Documentation

Geocoder API

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


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

Кликни на карту, чтобы увидеть URL запроса к API

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

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

Ответ геокодера может быть сформирован только в формате JSON.


В примере в запрос передаются широта «55.75150» и долгота «37.615666».

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

Не забудьте заменить YOUR_KEY на ваш ключ API (см. Как начать работать с 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
    }
}

Чтобы получить координаты здания по адресу "Москва, Садовническая, 25", выполните следующий запрос:

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

Не забудьте заменить YOUR_KEY на ваш ключ API (см. Как начать работать с 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
    }
}

  1. Получите ключ. Для этого заполните анкету.
  2. Изучите формат запроса и формат ответа.