Reverse Geocoding Addresses
With the reverseGeocodeAddresses operation it is possible to search for surrounding map objects from the input of a single coordinate. Depending on the accuracy of the input coordinate and the underlying map data, even a correct postal address can be returned.
The following listing shows the general structure of the operation in the WSDL file of the Map24 Geocoder 5.1 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="Map24Geocoder51PortType" >
<operation name="reverseGeocodeAddresses" >
<input message="tns:reverseGeocodeAddressesRequest" />
<output message="tns:reverseGeocodeAddressesResponse" />
</operation>
...
</portType>
...
Request
ReverseGeocodeAddressesRequest contains the parameters of a reverseGeocodeAddresses operation.
Fields:
| Field |
Description
|
Coordinates
|
The coordinates to search the corresponding addresses for. The Coordinate element has two subelements Longitude and Latitude.
Note: The values of the Longitude and Latitude elements must comply to the WGS 84 format. They are specified in decimal degrees and minutes. |
| SynchronizeClient |
If TRUE, the coordinates are shown in the mapping client, represented by a logo. |
Response
GeocodeAddressesResponse contains the response of a reverseGeocodeAddresses request in the GeocodedAddresses array.
The GeocodedAddresses array contains a GeocodedAddress element for each coordinate that was specified in the request.
A GeocodedAddress element provides the following information:
- The ID field is empty.
- The HouseNo, Street, ZIP, etc. fields contain some address data for the given coordinate. The HouseNo field does not contain the house number. Instead, the house number is provided in the Alternatives array (if available).
- The Alternatives array contains exactly one reverse gecoded address that matches the given coordinate. The address is provided in an instance of GeocodedAddress.Alternative.
Fields of a GeocodeAddress.Alternative element:
| Field |
Description
|
ID
|
This field is empty. |
| HouseNo |
The house number that matches the given coordinate (if available). |
Street
|
The street that matches the given coordinate. |
ZIP
|
The ZIP code that matches the given coordinate. |
City
|
The city that matches the given coordinate. |
District
|
The district that matches the given coordinate. |
County
|
The county.
|
State
|
The state.
|
Country
|
The country in which the given coordinate is located.
|
Quality
|
The quality of the result. The following quality levels are defined:
- Exact: The result matches the input coordinates exactly.
- Street: The result matches the input coordinates on street level.
- ZIP: The result matches the input coordinates on ZIP code level.
- District: The result matches the input coordinates on city district level.
- City: The result matches the input coordinates on city level.
- Mismatch: No address could be found for the given coordinates.
|
Similarity
|
The similarity between the result and the given input address in a scale from "0.00" (mismatch) to "1.00" (direct hit). Besides the Quality element, this field provides information on the accuracy of the result. |
Coordinate
|
The coordinate (latitude and longitude) that was given in the request. |
Examples
An example request is provided here.
|
