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