Reverse Geocoding Addresses
The reverseGeocodeAddresses operation allows to search for surrounding map objects. At first the given coordinates are passed to the Map24 ReverseGeocoder Service for performing a search in the country, city, street and postal code layers. With the returned names for the address fields a "common" geocodeAddresses operation is performed. This operation is often used for retrieving textual descriptions for a location on the map.
Note: The Map24 ReverseGeocoder does not return house numbers. Use the revereseGeocodeAddresses operation of the Map24 Geocoder 5.1 for getting complete address data with house numbers.
The following listing shows the general structure of the operation in the WSDL file of the Map24 ReverseGeocoder Service:
...
<message name="reverseGeocodeAddressesRequest" >
<part name="RequestHeader" type="tns:RequestHeader" />
<part name="ReverseGeocodeAddressesRequest"
type="tns:ReverseGeocodeAddressesRequest" />
</message>
<message name="reverseGeocodeAddressesResponse" >
<part name="GeocodeAddressesResponse" type="tns:GeocodeAddressesResponse" />
</message>
...
<portType name="Map24ReverseGeocoderPortType" >
<operation name="reverseGeocodeAddresses" >
<input message="tns:reverseGeocodeAddressesRequest" />
<output message="tns:reverseGeocodeAddressesResponse" />
</operation>
...
</portType>
...
Request
The ReverseGeocodeAddressesRequest accepts one or several coordinates as input.
.png)
Fields:
| Field |
Description
|
| Coordinate |
Specifies the geographic position of a point on the map. The given Coordinates must have a Longitude and a Latidude which must be WGS 84 compliant.
|
| SynchronizeClient |
If TRUE, the map in the Map24 Web Service demo pages will show the result. |
Note: If you are hosting your own MapTP server system, the ReverseGeocodePointsRequest contains an additional field, the SMID field. See Requirements for Self Hosting.
Response
The response of a reverseGeocodeAddresses operation is provided in a GeocodeAddressesResponse element.
The GeocodeAddressesResponse element contains an arbitrary number of reverse geocoded adresses of type GeocodedAddress as result. The result of the reverseGeocodeAddresses operation is provided in the Alternatives array. In addition, the GeocodedAddresses element contains the address data that was given in the request (HouseNo, Street, ZIP, City, etc.).
The size of the Alternatives array is restricted by the request's MaxNoOfAlternatives value. The entries of the Alternatives array are sorted depending on their qualities: The alternative with the best ranking is shown as the top-most element and the alternative with the worst ranking is shown last. The default size of the array is 1.
An Alternative is a Map24 ReverseGeocoder's result to a given coordinate. Its entries always refer to the geocoder's database. Thus the elements values need not necessarily be identical to the fields of a given Address (spelling mistakes get solved!). The field Similarity describes the exactness of accordance between the input and resulted addresses as percentage ratio.
The field Quality describes on which level the resulting address matches the given input address. Possible quality levels, sorted from highest to lowest:
| Quality Level |
Description
|
| Exact |
The addresses match up to house number level. |
| Street |
The addresses' street center point match. |
| ZIP |
The addresses match on zip code level. |
| District |
The addresses' district without zip code or pseudo zip code match. |
| City |
The addresses match on city level (without zip code or pseudo zip code). |
| State |
The addresses match on state level. |
| Country |
The addresses match on country level. |
| Mismatch |
The addresses do not match at all. |
Example Request
An example request is provided here.
|
