Create a locator that supports both local city and postal city names

The Create Locator tool allows you to build a locator that supports local city names and postal city names when both names are assigned to the same postal code. This can be achieved by building a multirole locator with data that includes the Point Address, Parcel, Street Address, or POI roles where each feature in the primary reference data has a postal code, postal join ID, and a primary city name that the postal code is within, as well as postal codes represented in a polygon feature class that contains a postal join ID and another city name associated with the postal code that will use the Postal locator role. Create this type of locator when there are multiple city names associated with the same postal code, which can occur when there is a legal city or municipality name, an unincorporated city name, a locally known city name, or a postal city name that is assigned to a community by the US Postal Service.

When city name values are included with the postal codes in the reference data for the Postal role, the city values are stored as postal city values when building a locator. In some countries, including the United States, the postal city is returned by default when geocoding. This affects results returned by multirole locators that include Point Address, Parcel, Street Address, or POI roles. You can change which value to return in the locator to the local city or the city that was matched by changing the default value for Preferred city name on the Locator Properties dialog box.

Build the locator

To create a multirole locator using Point Address and Postal role linking the two roles using the Zip Join ID role field that supports both postal city and local city complete the following steps:

1. Launch the Create Locator geoprocessing tool from the Geoprocessing pane.
2. In the Create Locator tool, click the Role drop-down list, and choose the Point Address role.
3. Click the Browse button next to the Primary Table(s) text box.
4. Browse to the points layer that contains the local city name.
5. In the Field Mapping portion of the tool, select the appropriate field from the Alias Name drop-down menu for each relevant field name in the Role: Point Address section to map the fields.
   1. Assign the field from the point reference data that contains the join ID for ZIP code to Zip Join ID.
6. Click the Role drop-down list, and choose the Zip role.
7. Click the Browse button next to the Primary Table(s) text box.
8. Browse to the ZIP code polygon layer that contains the postal city name.
9. In the Field Mapping portion of the tool, select the appropriate field from the Alias Name drop-down menu for each relevant field name in the Role: Zip section to map the fields.
   1. Assign the field from the postal polygon reference data that contains the join ID for the ZIP code to Zip Join ID.
   2. Assign the field from the reference data that contains the ZIP code to Zip.
   3. Assign the field from the reference data that contains the postal city to City.
10. Specify a name for the locator in the Output Locator parameter.
11. Select English from the Language Code drop-down menu.
12. Click Run.
13. Open the Locator Properties dialog box of the newly created locator.
14. On the Geocoding Options page, expand Display Options.
15. Select Postal city name as the Preferred city name option if you want to return the postal city name label in the geocode result when you enter the local city name as part of the input address.

    In the image below, the local city name in the data for the Point Address role is San Buenaventura, and the postal city name in the data in the ZIP role is Ventura. When you search for 3700 Dean Dr, San Buenaventura, CA 93003 in the Locate pane, the result returned by the locator contains the postal city name Ventura. The postal city name is also included in the suggestions.

    

16. Open the Locator Properties dialog box for the locator.
17. On the Geocoding Options page, expand Display options.
18. Select Local City as the Preferred city name option if you want to return the local city name when the postal city name is part of the input address.

    Now when you search for 3700 Dean Dr, Ventura, CA 93003 in the Locate pane, the result returned by the locator contains the local city name San Buenaventura.