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>
                <name>Приват</name>
            </semantic>
            <nearest>
                <point
             lat="50.455189"
             lng="30.511414"
             radius="500"/>
            </nearest>
        </filter>
    </parameters>
</request> 

Ответ

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>            
<response>            
    <POI>            
        <name>Приватбанк. Банкомат</name>        
        <description>Киев. Львовская пл., 8</description>    
        <id>8556181132203561</id>        
        <distance>397.32913008</distance>        
    </POI>            
    <POI>            
        <name>Приватбанк. Банкомат</name>        
        <description>Киев. Ярославов Вал ул., 37/1</description>    
        <id>8556181132270133</id>        
        <distance>410.11515997</distance>        
    </POI>            
    <POI>            
        <name>Приватбанк. Банкомат</name>        
        <description>Киев. Нестеровский пер., 13/19</description>    
        <id>8556181132335661</id>        
        <distance>538.52843557</distance>        
    </POI>                    
</response>