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:

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.

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).

The name of the city is defined here.

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

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

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

Parameter to specify the tolerance:

min_accuracy [MA]:

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

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.



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.



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"?>
<request country="DEU" city="Braunschweig" street="Rebenring" house="33" free_form_address="Braunschweig, Bültenweg 73"/>     
<response>            <status code="200" request="geocode"/>       
         <house>73</house>        <latitude>52.276337</latitude>                
</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>