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:

    • country

    • city

    • postal

    • street

    • house

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:

    • country

    • city

    • postal

    • street

    • address

Accuracy-Level:

  • 1: country

  • 2: state

  • 3: county

  • 4: city

  • 5: postal

  • 6: street

  • 7: crossstreet

  • 8: address

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

  • none (necessary spelling corrections like ß => ss, str => strasse, Bgm. => Bürgermeister, I./II./III./IV./V. => Erste, Zweite..., St. => Sankt, Frankfurt => Frankfurt am Main (with corresponding postal code))

  • normal (simple spelling corrections like street/road/venue written together or apart, alternative street names: ...straße => ...weg)

  • high1 (name similarities)

postal accuracy [PA]:

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

  • 0 is ignored if wrong

  • 1 digit of the postal code must be correct

  • 2 digit 1 and 2 of the postal code must be correct

  • 3 digit 1 to 3 of the zip code must be correct

  • 4 digit 1 to 4 of the zip code must be correct

  • 5 Digits 1 to 5 of the zip code must be correct

  • 6 Digits 1 to 6 of the zip code must be correct

  • 7 Digits 1 to 7 of the zip code must be correct

  • 8 Digits 1 to 8 of the zip code must be correct

  • 9 Digits 1 to 9 of the zip code must be correct

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>