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
             radius="50"
         lat="50.455189"
         lng="30.511414"/>
        <layer type="alias">Адреса</layer>
    </parameters>
</request> 

Ответ

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>        
<response>            
    <object>        
        <name>27</name>        
        <description>Киев, Большая Житомирская ул.</description>    
        <id>8556180808785228</id>        
        <distance>22.02741831</distance>        
    </object>        
    <object>        
        <name>25/2</name>        
        <description>Киев, Большая Житомирская ул.</description>    
        <id>8556180821302594</id>        
        <distance>26.28067149</distance>        
    </object>            
    <object>            
        <name>26А</name>        
        <description>Киев, Большая Житомирская ул.</description>    
        <id>8556180808716902</id>        
        <distance>30.33590786</distance>        
    </object>            
</response>