Forms: Address Lookup Field

Overview

The Address Lookup field lets a user search for a location and select a matching suggestion. App designers can limit the lookup to as many as five countries and choose the type of locations the search should return. If no country is selected, the lookup searches all available countries.

Prerequisites

Before configuring an Address Lookup field, make sure you have:

• App Designer access to the application
• A form open in the Form Editor
• The countries that should be included in the lookup, up to a maximum of five
• A decision about the type of locations users should find, such as addresses, establishments, regions, or cities

Configuring the Address Lookup Field

Select the Address Lookup field on the form canvas, then configure its properties.

1. On the Basic tab, enter the Display Name that users should see.
2. Select the Options tab.
3. Expand Lookup Options if the section is collapsed.
4. Open Countries to show in the lookup.
5. Select each country that should be included. The menu uses checkboxes and allows a maximum of five countries.
6. To search all available countries, leave the country list empty.

7. Open Search depth and select the result category that matches the field’s purpose.
8. Save the form after completing the remaining standard field settings.

Configuration Reference

Lookup Options

Field	Description
Countries to show in the lookup	Select as many as five countries to make them available in the lookup. If no country is selected, the lookup searches all available countries.
Search depth	Controls the category of locations returned by the lookup. Available choices are Geocode, Address, Establishment, Regions, and Cities.

Search Depth Choices

Field	Description
Geocode	Returns geocoding results rather than business results. Use this search depth to disambiguate results when the specified location may be indeterminate.
Address	Returns geocoding results with a precise address. Use this search depth when users will search for a fully specified address.
Establishment	Returns business results only.
Regions	Returns regions only, such as countries, states, and sublocalities.
Cities	Returns cities only.

Note: The exact suggestions and their ordering depend on the entered text, selected countries, selected search depth, and the lookup data available to GW Apps.

Using the Address Lookup Field

1. Open the form that contains the Address Lookup field.
2. Select the field and begin typing a location.
3. Wait for the suggestion list to appear. Each suggestion displays a location name and its country or region information.
4. Select the intended suggestion from the list.
5. Confirm that the selected location is displayed in the field.
6. To remove the selected value, select the X at the right side of the field, then search again if needed.