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>World_ru</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>
        <description>Киев, Большая Житомирская ул.</description>
        <id>8556180821302594</id>
        <distance>26.28067149</distance>
    </object>
</response>