The Lookup search type is designed to enable the user to enter a key search term to produce the correct address. This search type is only available for use with certain datasets that contain a logical reverse search key.
The user enters the search key and the service returns the address that matches the search key. If the search key matches multiple addresses, a list of suggested addresses is returned, from which the user can select the required one. When the user has entered the search key, they should start the search manually.
Lookup normally requires minimal user interaction, as in most cases the search key only matches a single address. However, in some cases it is possible that the search key matches more than one address, in which case a flattened list of suggestions is returned.
This is a two-step process involving two endpoint methods:
The recommended workflow (as demonstrated by our sample code) is:
The relevant address components can be stored in your database if required.