getNearest
Поиск ближайших объектов, по заданным координатам.
Параметры
<authority> содержит уникальный идентификатор, который определяет уровень доступа, к сервису.
<database> имя базы данных, к которой осуществляется запрос.
<point> параметр указывает точку, от которой начинается поиск, значение атрибута radius указывает область в которой выполняется поиск задается в метрах. Если атрибут отсутствует возвращается ближайший объект. Ответ сортируется по мере удаленности от указанной точки.
<layer> слой в котором будет выполнятся поиск объектов. Список возможных слоев см. метод getLayers. Могут указываться как имена так и «алиасы» слоев.
Существует ограничение на количество возвращаемых результатов. Даже если существуют результаты, который удовлетворяют условиям поиска, но превышают предельное значение, то эти результаты в ответ не войдут. Ориентировочно 250. Ограничение по радиусу буферной зоны 25 км.
Примеры
- Пример 1
- Пример 2
Запрос
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <request> <authority key="AUTHORITYKEY"/> <method name="getNearest"/> <parameters> <database>ukraine_ua</database> <point lat="50.455189" lng="30.511414"/> <layer type="alias">Адреси</layer> </parameters> </request>
Ответ
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <response> <object> <name>Київ, Велика Житомирська вул., 25/2</name> <id>146240571224</id> <distance>0.110000</distance> </object> </response>