GEOcoding of addresses

GEOcoding of adresses are chargeable and work only with a credits/package in the user account!

Base url:
The base url for the lookup is: http://maps1.locr.com/?request_type=geocode

Authorization:
Authorization for a lookup works the same way as authorization for a map request.

Parameters to specify the address:

Either one or more of the parameters country, city, postal, street and house must be specified.

country:
The country parameter can be either a 2-digit iso-3166 alpha-2 code, or a 3-digit iso-3166 alpha-3 code or the name of the country, different languages are possible (e.g.: country=usa).

city:
The name of the city is defined here.

postal:
Specifies the postal code of the address, this must be specified in the appropriate country format.

street:
In the street parameter, the street including the house number can be passed.

house:
Separate specification of the house number, only if the street does not already contain the value!

Parameter to specify the tolerance:
min_accuracy
tolerance

min_accuracy [MA]:

This parameter can be used to specify the minimum accuracy that a result should have.

Explanation:
If you have a street with a house number in the query, but the lookup only finds the street and not the corresponding house number, the address will be positioned if the paramter "min_accuracy=street" (or "min_accuracy=6") is specified.

Definition:

Accuracy-Level:

tolerance [TO]:
With this parameter you can set the spelling error tolerance.

postal accuracy [PA]:

With this parameter you can set the accuracy of the postal code.   

Default = all transferred digits of the zip code must be correct.

Exp.:

https://maps1.locr.com/?request_type=geocode&country=DE&postal=38106&city=braunschweig&street=bültenweg&house=73


Return

As return of the lookup request comes so far only a XML back, a successful lookup request looks approximately as follows:

<?xml version="1.0" encoding="utf-8"?>
<lookup>   
<request country="DEU" city="Braunschweig" street="Rebenring" house="33" free_form_address="Braunschweig, Bültenweg 73"/>     
<response>            <status code="200" request="geocode"/>       
<results>           
<result>               
<country>DEU</country>               
<state>NIEDERSACHSEN</state>                
<county>BRAUNSCHWEIG</county>               
<city>BRAUNSCHWEIG</city>               
<postal>38106</postal>               
<street>BÜLTENWEG</street>
         <house>73</house>        <latitude>52.276337</latitude>                
<longitude>10.533924</longitude>            
</result>         
</results>     </response></lookup>

Return if no address could be found:

<?xml version="1.0" encoding="utf-8"?><lookup>     <request city="no_city"/>    <response>         <status code="404" request="geocode"/>    </response></lookup>

Return if no parameters are passed:

<?xml version="1.0" encoding="utf-8"?><lookup>     <response>         <status code="400" message="necessary parameters missing" request="geocode"/>     </response></lookup>

Return if the user is not authorized:

<?xml version="1.0" encoding="utf-8"?><lookup>     <response>         <status code="401" message="unauthorized" request="geocode"/>    </response></lookup>

Return if another internal server error has occurred:

<?xml version="1.0" encoding="utf-8"?><lookup>     <response>        <status code="500" message="internal server error" request="geocode"/>    </response></lookup>