Knowhow SingleField Search / searchByText (xLocate 1)

[Bernd Welter]

Here's an interesting description of some basics of xLocate 1's single field search... taken from the "gpGeocoder Documentation"

Single Field Search
What is it?

• If the profile and map are configured accordingly, the gpGeocoder performs a single field search.
• There are two flavours of singlefieldsearch, one with delimiters, and one without.
• When active, all input is expected in one input field named Address.
• However, also input in the fields country and state are considered. All other fields are ignored.

How to configure the gpGeocoder for singlefieldsearch?

• Use a map that supports Town searches
• Use a profile that supports town searches (Town.Active = 1)
• Set profile parameter AddressInputMode to 3 (without delimiter) or 4 (with delimiters)

The single field search without delimiters.

• In this mode all words in the singlefield input field Address are searched in all the fields (Postcode, Town, Street, Housenumber).
• If a country is given in the seperate Country field, this is used as the country.
• If no country is given, the first word in the Address field is also tried as a country.
• If no such country is found, all countries are allowed, and the word is used as a postcode, town, street or housenumber.
• The same rules are used for the State field.

The single field search with delimiters.

• In this mode, the input string falls into several pieces separated by delimiters.
• The delimiters can be configured in the Profile.
• If there is no delimiter, all words are searched in the Postcode and Town fields.
• If there is at least one delimiter, the words before the first delimiter are searched in the Postcode and Town fields.
• If there is only one delimiter, the words after the delimiter are searched in the Street and house number fields.
• If there are two or more delimiters, the words between first and second delimiter are searched in the Street field and the words after the second delimiter are searched in the house number field.
• If a country is given in the seperate Country field, this is used as the country.
• If no country is given, the first word in the Address field is also tried as a country.
• If no such country is found, all countries are allowed, and the words in the first piece are only used as a Postcode or Town.
• The same rules are used for the State field.