getAddress

Request according to specified parameters displays objects of administrative layers.

Request's scheme

Parameters

Parameter	Description
<authority>	contains unique identifier that allows to perform this inquiry.
<database>	database name to which inquiry is made.
<filter>	package containing set of filters due to which searching is performed.
<semantic>	parameters that are necessary to carry out searching by name. If there are a number of similar objects, logical operation will be concluded.
<layer>	name or alias of the level where searching is made.
<name>	initial letters of objects names. The searching is made only by first letters of the word.
<response>	contains set of layers whereof response shall be selected. If there are several responses, the system will try to create response-tree.

Examples

• Example 1
• Example 2
• Example 3
• Example 4
• Example 5
• Example 6

Request

<?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> 

Response

 <?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>