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>