API геокодинга

Прямой геокодинг

Не больше 1 запроса в секунду, запрос с аналогичными параметрами кешируется на сутки. Только РФ.

Endpoint: /geocoder

Метод: GET

Параметры:

• query - строка с адресом (обязательно) или:

• city (string) - город (обязательно)

• street (string) - улица (не обязательно)

• house (string) - номер дома (не обязательно)

Примеры запросов

GET /api/v1/geocoder?query=%D0%A3%D0%BB%D1%8C%D1%8F%D0%BD%D0%BE%D0%B2%D1%81%D0%BA%2C+%D0%A0%D1%8F%D0%B1%D0%B8%D0%BA%D0%BE%D0%B2%D0%B0%2C+20 

GET /api/v1/geocoder?city=%D0%A3%D0%BB%D1%8C%D1%8F%D0%BD%D0%BE%D0%B2%D1%81%D0%BA&street=%D0%A0%D1%8F%D0%B1%D0%B8%D0%BA%D0%BE%D0%B2%D0%B0&house=20 

Пример ответа

{
    "addresstype": "building",
    "boundingbox": [
        "54.2874669",
        "54.2881022",
        "48.3009337",
        "48.3022795"
    ],
    "class": "building",
    "display_name": "20, улица Рябикова, Засвияжский район, Ульяновск, городской округ Ульяновск, Ульяновская область, Приволжский федеральный округ, 432042, Россия",
    "importance": 6.0672159914503966e-05,
    "lat": "54.2877798",
    "licence": "Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org/copyright",
    "lon": "48.3015961",
    "name": "",
    "osm_id": 106083217,
    "osm_type": "way",
    "place_id": 186470788,
    "place_rank": 30,
    "type": "apartments"
}

Обратный геокодинг

Не больше 1 запроса в секунду, запрос с аналогичными параметрами кешируется на сутки. Только РФ.

Endpoint: /geocoder/reverse

Метод: GET

Параметры:

• lat - широта (обязательно)

• lon - долгота (обязательно)

Пример запроса

GET /api/v1/geocoder/reverse?lat=54.2877798&lon=48.3015961 

Пример ответа

{
    "address": {
        "ISO3166-2-lvl4": "RU-ULY",
        "city": "Ульяновск",
        "city_district": "Засвияжский район",
        "country": "Россия",
        "country_code": "ru",
        "county": "городской округ Ульяновск",
        "house_number": "20",
        "postcode": "432042",
        "region": "Приволжский федеральный округ",
        "road": "улица Рябикова",
        "state": "Ульяновская область"
    },
    "addresstype": "building",
    "boundingbox": [
        "54.2874669",
        "54.2881022",
        "48.3009337",
        "48.3022795"
    ],
    "class": "building",
    "display_name": "20, улица Рябикова, Засвияжский район, Ульяновск, городской округ Ульяновск, Ульяновская область, Приволжский федеральный округ, 432042, Россия",
    "importance": 6.0672159914503966e-05,
    "lat": "54.2877798",
    "licence": "Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org/copyright",
    "lon": "48.3015961",
    "name": "",
    "osm_id": 106083217,
    "osm_type": "way",
    "place_id": 185743160,
    "place_rank": 30,
    "type": "apartments"
}

Поиск адреса по объекту OSM

Не больше 1 запроса в секунду, запрос с аналогичными параметрами кешируется на сутки. Только РФ.

Поддержка node(N), way(W) и relation(R) объектов, перечисление в запросе через запятую. Максимальное количество объектов - 50.

Endpoint: /geocoder/lookup

Метод: GET

Параметры:

• query - строка с объектами через запятую (обязательно)

Пример запроса

GET /api/v1/geocoder/lookup?query=R146656%2CW104393803 

Пример ответа

[
    {
        "address": {
            "ISO3166-2-lvl4": "GB-ENG",
            "ISO3166-2-lvl8": "GB-MAN",
            "city": "Manchester",
            "country": "United Kingdom",
            "country_code": "gb",
            "state": "England",
            "state_district": "Greater Manchester"
        },
        "addresstype": "city",
        "boundingbox": [
            "53.3401044",
            "53.5445923",
            "-2.3199185",
            "-2.1468288"
        ],
        "class": "boundary",
        "display_name": "Manchester, Greater Manchester, England, United Kingdom",
        "importance": 0.7302810816515201,
        "lat": "53.4794892",
        "licence": "Data © OpenStreetMap contributors, ODbL 1.0. http://osm.org/copyright",
        "lon": "-2.2451148",
        "name": "Manchester",
        "osm_id": 146656,
        "osm_type": "relation",
        "place_id": 255797756,
        "place_rank": 16,
        "type": "administrative"
    }
]

Получение geojson по place_id OSM

Не больше 1 запроса в секунду, запрос с аналогичными параметрами кешируется на сутки. Только РФ.

Endpoint: /geocoder/place/[place_id]

Метод: GET

Пример запроса

GET /api/v1/geocoder/place/186470788 

Пример ответа

{
    "addresstags": {
        "city": "Ульяновск",
        "housenumber": "20",
        "street": "улица Рябикова"
    },
    "admin_level": 15,
    "calculated_importance": 6.0672159914503966e-05,
    "calculated_postcode": "432042",
    "category": "building",
    "centroid": {
        "coordinates": [
            48.30159606497413,
            54.28777985
        ],
        "type": "Point"
    },
    "country_code": "ru",
    "extratags": {
        "building:levels": "5",
        "roof:shape": "flat",
        "start_date": "1968"
    },
    "geometry": {
        "coordinates": [
            [
                [
                    48.3009337,
                    54.287561
                ],
                [
                    48.3010559,
                    54.2874669
                ],
                [
                    48.3022795,
                    54.288008
                ],
                [
                    48.3021572,
                    54.2881022
                ],
                [
                    48.3020205,
                    54.2880418
                ],
                [
                    48.3017892,
                    54.2879394
                ],
                [
                    48.3015451,
                    54.2878314
                ],
                [
                    48.301312,
                    54.2877283
                ],
                [
                    48.3010778,
                    54.2876247
                ],
                [
                    48.3009337,
                    54.287561
                ]
            ]
        ],
        "type": "Polygon"
    },
    "housenumber": "20",
    "importance": 6.0672159914503966e-05,
    "indexed_date": "2024-11-05T23:54:56.204742+00:00",
    "isarea": true,
    "localname": "",
    "names": [],
    "osm_id": 106083217,
    "osm_type": "W",
    "parent_place_id": 187793756,
    "place_id": 186470788,
    "rank_address": 30,
    "rank_search": 30,
    "type": "apartments"
}