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:

Return if no address could be found:

Return if no parameters are passed:

Return if the user is not authorized:

Return if another internal server error has occurred: