Searching for Map Objects in Specified Map Layers
The reverseGeocodePoints operation searches for map objects in specified map layers. The search can be performed in base map layers and DMap layers. Base map layers are defined in the LayerSpecifier element. DMap layers are defined in the CustomerLayerSpecifier element.
In a layer specifier you can define
- In which layer the search is performed. It is possible to specify further layers that are alternatively taken into account.
- The radius around the given map coordinates in which the search is performed.
- The maximum number of map objects to be returned.
The following listing shows the general structure of the operation in the WSDL file of the Map24 ReverseGeocoder Service:
...
<message name="reverseGeocodePointsRequest">
<part name="RequestHeader" type="tns:RequestHeader"/>
<part name="ReverseGeocodePointsRequest" type="tns:ReverseGeocodePointsRequest"/>
</message>
<message name="reverseGeocodePointsResponse">
<part name="ReverseGeocodePointsResponse" type="tns:ReverseGeocodePointsResponse"/>
</message>
<portType name="Map24ReverseGeocoderPortType">
<operation name="reverseGeocodePoints">
<input message="tns:reverseGeocodePointsRequest"/>
<output message="tns:reverseGeocodePointsResponse"/>
</operation>
...
</portType>
...
Request
ReverseGeocodePointsRequest contains the parameters for a reverseGeocodePoints operation.
.png)
The operation is called reverseGeocodePoint for HTTP GET requests (action=reverseGeocodePoint).
| Field |
Description |
HTTP GET Parameter |
| Coordinates |
Mandatory field for specifying the geographic position of the points to be reverse geocoded. Coordinates may contain multiple Coordinate elements.
|
coordinates=<coordinate:0>&....&<coordinate:n>
For each coordinate, you must specify the longitude and latitude as follows:
coordinate:i=longitudei=<double>&latitudei=<double> |
| LayerSpecifiers |
Mandatory field for settting the search attributes for each layer. These attributes are stored in an array of LayerSpecifier elements.
|
See LayerSpecifier. |
| SearchStrategy |
Optional fields that specifies which search results are returned. If "NONE", all search results are returned. If "Neighbourhood", only the search results that are closest to each other are returned. This functionality is useful to exclude unreasonable results, if the input coordinates are not very far away from each other. |
Not supported.
|
| SearchHints |
Optional field that contains an array of elements of type ReverseGeocodeSearchHint. If a ReverseGeocodeSearchHint element is set to "IgnoreResultsWithoutName", the response will not contain streets or other map objects that do not have a name, for example farm tracks. |
Not supported. |
| SynchronizeClient |
If TRUE, the map in the Map24 Web Service demo pages will show the result. |
Not supported.
|
| CustomerLayers |
An array of CustomerLayerSpecifier elements used for specifying the DMap layers to search in.
|
See CustomerLayerSpecifier. |
Note: If you are hosting your own MapTP server system, the ReverseGeocodePointsRequest contains an additional field, the SMID field. See Requirements for Self Hosting.
SOAP Response
ReverseGeocodePointsResponse is the response of the reverseGeocodePoints operation.
ReverseGeocodedPoints contains the responses for all points that were specified in the request in an array of ReverseGeocodedPoint elements.
HTTP Response
The structure of the response to a HTTP GET reverseGeocodePoints request is provided here.
SOAP Examples
|
