Qualified Search
The searchQualified operation gets a qualified address as input. This means that you must specify the country, city, street, etc. of an address in separate fields. The search fields are defined in the SearchProperties field of a MapSearchQualifiedRequest.
With the qualified search you can often achieve results of higher quality than with the free search. Example: An input address might contain a street name that is also used as city name in the same country (e.g. "Moos"). By specifying that the given data refers to a street in a searchQualified request, ambiguities are avoided which leads to a better result than with the free search.
In general, you can achieve results of high quality with the qualified search by
- Specifying the complete name of the city, street, POI, etc. in the language of the country in which the address or POI is located. There are a few exceptions from this rule. For example, the country (Ctry field) must be specified with a two-letter ISO code. These exceptions are described in Tabelle 2.2: Search fields of a MapSearchQualifiedRequest.
- Including enough search criteria. Besides the country (Ctry field) the Map24 Geocoder 5.1 requires you to specify either a city, street, POI, or brand name. However, it might be necessary to specify more than two search fields for achieving a high quality result. Example: A request for Ctry="gb" and Street="Main Road" will return addresses all over Great Britain. In this case more information such as the city name should be included in the input data.
The following listing shows the general structure of the operation in the WSDL file of the Map24 Geocoder 5.1 Service:
...
<message name="searchQualifiedRequest" >
<part name="RequestHeader" type="tns:RequestHeader" />
<part name="MapSearchQualifiedRequest" type="tns:MapSearchQualifiedRequest" />
</message>
<message name="searchQualifiedResponse" >
<part name="MapSearchResponse" type="tns:MapSearchResponse" />
</message>
...
<portType name="Map24Geocoder51PortType" >
<operation name="searchQualified" >
<input message="tns:searchQualifiedRequest" />
<output message="tns:searchQualifiedResponse" />
</operation>
...
</portType>
...
Request
MapSearchQualifiedRequest contains the parameters for the searchQualified operation.
| Field |
Description |
| MaxNoOfAlternatives |
The maximum number of results (Alternative elements) to be retrieved for the given address. |
| ResponseStyle |
Not used. |
| SearchProperties |
Key value pairs that specify the properties for the search. |
| Options |
Optional parameter that can be used for specifying if the search should only be performed on crossings or house numbers. Possible values are "Crossings" and "Housenumbers". |
| Database |
For future use. |
Response
Information on the result of a searchQualified operation is provided here.
Examples
An example request is provided here.
|
