mapSurfer -rest — geocoding

mapSurfer GS / Руководство разработчика REST / Геокодирование

Геокодирование

Запрос геокодирования

POST /geocoding

Структура запроса:


POST /geocoding?token=bw3ty3h46yth

token: ключ доступа

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


{
    "layersId":[
        "10",
        "12",
        "26"
    ],
    "query":"Казань",
    "point":{
        "lon":50.69091796875,
        "lat":55.33851784425634
    }
}



// массив id слоев, где также надо осуществлять поиск




// строка запроса
// центр карты, объект
// долгота точки, число с плавающей точкой
// широта точки, число с плавающей точкой

Ответ:

Статус: 200 — успешное выполнение

Формат: json


{
    "layers": [
        {
            "layer": "Улицы",
            "wmsName": "world:k2_ulitsy_l",
            "layerId": null,
            "items": [
                {
                    "pkid": 162815,
                    "label": "Республика Татарстан, Казань, Ледяная",
                    "zoom": 16,
                    "point": {
                        "lon": 49.28956419647526,
                        "lat": 55.75372719479096
                    }
                }
            ]
        }
    ]
}



// массив слоев, где найдены объекты
// объект слоя
// русское название, строка
// английское название, строка
// null - слой, для поиска по умолчанию, иначе id из массива
// массив найденных объектов
// найденный объект
// первичный ключ, строка
// заголовок, строка
// зум для отображения, целое число
// точка, объект
// долгота точки, число с плавающей точкой
// широта точки, число с плавающей точкой

Статус: 500 — ошибка на сервере

Формат: text/plain

Содержит описание ошибки

GET /geocoding

Структура запроса:


POST /geocoding?query=Казань&lon=55.45&lat=49.67&layersId=12,23,345,56&token=bw3ty3h46yth

query: строка запроса

lon: долгота центра карты, число с плавающей точкой

lat: широта центра карты, число с плавающей точкой

layersId: id слоев, где также надо осуществлять поиск, через запятую