getPOI

Поиск объектов инфрастуктуры. Метод поддерживает как пространственные так и запросы по названию.

Схема запроса

Параметры

Параметр	Описание
<authority>	содержит уникальный идентификатор, который разрешает выполнение данного запроса.
<database>	имя базы данных, к которой осуществляется запрос.
<filter>	контейнер, содержащий набор фильтров по которым осуществляется поиск.
<semantic>	содержит параметры необходимые для выполнения поиска по названию.
<layer>	имя либо «алиас» слоя в котором выполняется поиск.
<name>	буквы из начала слов названий объектов. Поиск выполняется только по началу слова. Если отсутствует то выполняется среди всех объектов заданного слоя.
<nearest>	содержит гео-примитив в буферной зоне которого необходимо выполнить поиск.
<point>	параметр указывает точку, от которой начинается поиск, значение атрибута radius указывает область в которой выполняется поиск задается в метрах. Если атрибут отсутствует возвращается ближайший объект. Ответ сортируется по мере удаленности от указанной точки.
<rectangle>	рамка пределами которой ограничевается результат.

Существует ограничение на количество возвращаемых результатов. Даже если существуют результаты, который удовлетворяют условиям поиска, но превышают предельное значение, то эти результаты в ответ не войдут. Ориентировочно 250. Ограничение по радиусу буферной зоны 25 км.

Примеры

• Пример 1
• Пример 2
• Пример 3
• Пример 4

Запрос

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<request>
    <authority key="AUTHORITYKEY"/>
    <method name="getPOI"/>
    <parameters>
        <database>World_ru</database>
        <filter>
            <semantic>
                <layer type="name">0314</layer>
            </semantic>
            <nearest>
                <point
             lat="50.455189"
             lng="30.511414"
             radius="200"/>
            </nearest>
            <rectangle
            max_lat="50.4559"
            max_lng="30.5166"
            min_lat="50.4522"
            min_lng="30.5070"/>
        </filter>
    </parameters>
</request> 

Ответ

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>                        
<response>                            
    <POI>                        
        <name>Укргазбанк. Банкомат</name>                    
        <description>Киев. Большая Житомирская ул., 24</description>                    
        <id>8556181132270173</id>                        
        <distance>59.47674088</distance>                        
    </POI>                        
    <POI>                        
        <name>Индэкс-банк. Банкомат</name>                    
        <description>Киев. Большая Житомирская ул., 30А</description>                    
        <id>8556181132399685</id>                        
        <distance>104.52954357</distance>                        
    </POI>                        
    <POI>                        
        <name>Credit Europe Bank. Банкомат</name>                    
        <description>Киев. Большая Житомирская ул., 31</description>                    
        <id>8556181132399405</id>                        
        <distance>105.04742212</distance>                        
    </POI>                                        
</response>