getAddress

Запит по заданим параметрам повертає об'єкти з адміністративних шарів.

Схема запиту

Параметри

Параметр	Опис
<authority>	містить унікальний ідентифікатор, який дозволяє виконання даного запиту.
<database>	і'мя бази даних, до якої відбувається запит.
<filter>	контейнер, який містить набір фільтрів по яким відбувається пошук.
<semantic>	містить параметри необхідні для виконання пошуку по назві. Якщо присутні декілька таких вузлів, то між ними виконується логічна операція І.
<layer>	і'мя або «аліас» шару у якому відбувається пошук.
<name>	букви з початку слів назви об'єктів. Пошук виконується тільки по початку слова.
<response>	містить набір шарів з яких оберається відповідь. якщо присутні декілька — система намагається побудувати дерево відповіді.

Приклади

• Приклад 1
• Приклад 2
• Приклад 3
• Приклад 4
• Приклад 5
• Приклад 6

Запит

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<request>
    <authority key="AUTHORITYKEY"/>
    <method name="getAddress"/>
    <parameters>
        <database>World_ru</database>
        <filter>
            <semantic>
                <layer type="name">Settlements</layer>
                <name>Кие</name>
            </semantic>
            <semantic>
                <layer type="name">STR</layer>
                <name>Житом</name>
            </semantic>
            <semantic>
                <layer type="name">ADR</layer>
                <name>2</name>
            </semantic>
        </filter>
        <response>
            <layer type="name">Settlements</layer>
            <layer type="name">STR</layer>
            <layer type="name">ADR</layer>
        </response>
    </parameters>
</request> 

Відповідь

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>                            
<response>                            
    <settlements>                            
        <settlement>                        
            <name>Киев</name>                    
            <description>Столица</description>                    
            <id>8556180790695808</id>                    
            <streets>                    
                <street>                
                    <name>Большая Житомирская ул.</name>            
                    <id>8556180811470129</id>                
                    <addresses>                
                        <address>            
                            <name>2</name>        
                            <id>8556180821301154</id>        
                        </address>            
                        <address>            
                            <name>2</name>        
                            <id>8556180821301166</id>        
                        </address>            
                        <address>            
                            <name>20</name>        
                            <id>8556180821301171</id>        
                        </address>            
                        <address>            
                            <name>20А</name>        
                            <id>8556180821300748</id>        
                        </address>                        
                    </addresses>                
                </street>                    
                <street>                    
                    <name>Житомирское шоссе</name>                
                    <id>8556180811078462</id>                
                    <addresses>                
                        <address>            
                            <name>21 КМ</name>        
                            <id>8556180813635379</id>        
                        </address>            
                    </addresses>                
                </street>                    
                <street>                    
                    <name>Малая Житомирская ул.</name>            
                    <id>8556180811471245</id>                
                    <addresses>                
                        <address>            
                            <name>20</name>        
                            <id>8556180821300979</id>        
                        </address>            
                        <address>            
                            <name>20А</name>            
                            <id>8556180821300980</id>            
                        </address>            
                        <address>            
                            <name>20Б</name>            
                            <id>8556180821300985</id>            
                        </address>                            
                    </addresses>                
                </street>                    
            </streets>                        
        </settlement>                        
    </settlements>                            
</response>