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">3905</layer>
                <name>Ки</name>
            </semantic>
        </filter>
    </parameters>
</request> 

Ответ

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>                
<response>                    
    <POI>                
        <name>Мир. Кинотеатр</name>            
        <description>Вышгород. Шевченко ул., 08.10.09 Тел.: (04496)51144</description>        
        <id>8556181133713013</id>            
    </POI>                
    <POI>                
        <name>Киноконцертный зал им. Довженко. Кинотеатр</name>        
        <description>Запорожье. Ленина просп., 145. Тел.: (061)2209396</description>        
        <id>8556181133709977</id>            
    </POI>                
    <POI>                
        <name>Днепроспецсталь. Кинотеатр</name>            
        <description>Запорожье. Шевченко бульв., 01.10.09 Тел.: (0612)345722</description>        
        <id>8556181133710053</id>            
    </POI>                            
</response>