Free Search
The searchFree operation allows single field input where the parts of the text string can be in any order. You can set additional properties to limit the result set to a certain map area, to an address type (city, street, POI, etc.), or even to a POI of a certain type (gas station, restaurant, etc).
The search result set also includes POIs and landmarks that have similarities in the name or address with the input text.
The following listing shows the general structure of the operation in the WSDL file of the Map24 Geocoder 5.1 Service:
...
<message name="searchFreeRequest" >
<part name="RequestHeader" type="tns:RequestHeader" />
<part name="MapSearchFreeRequest" type="tns:MapSearchFreeRequest" />
</message>
<message name="searchFreeResponse" >
<part name="MapSearchResponse" type="tns:MapSearchResponse" />
</message>
...
<portType name="Map24Geocoder51PortType" >
<operation name="searchFree" >
<input message="tns:searchFreeRequest" />
<output message="tns:searchFreeResponse" />
</operation>
...
</portType>
...
Request
MapSearchFreeRequest contains the parameters for the searchFree operation.
| Field |
Description |
| MaxNoOfAlternatives |
The maximum number of returned geocoding results for the given address. |
| ResponseStyle |
Not used. |
| SearchText |
Input string for defining the address to be geocoded. The parts of the text string can be in any order. |
| Options |
Optional parameter that can be used for specifying if housenumbers or crossings of the street should be returned in the result. Possible values are "Crossings" and "Housenumbers". |
| Database |
For future use. |
| Properties |
Optional properties for the search. For example, the properties allow you to limit the result set to a certain map area, to an address type (city, street, POI, etc.), or even to a POI of a certain type (gas station, restaurant, etc). In addition you can set the desired language of the result. |
Response
Information on the result of a searchFree operation is provided here.
Examples
An example request is provided here.
|
