English

How To: Add city aliases to the address locator style

Summary

This article describes how to modify the USAddress.lot.xml file to add aliases for cities to the CityAliases section of the grammar. This example adds Hollywood, which may be recognized as a neighborhood rather than a city, to the Los Angeles city alias.

Aliases provide a mechanism to support word substitution beyond what is provided by spelling substitution. Whichever alias form is found in the reference or input data is treated as equivalent. The aliases are words commonly used in city names, where colloquial usage often includes abbreviations and misspellings.

The instructions below can also be used to add new aliases to the CityAliases section of the grammar. The entries for the primary city name should be in alphabetic order in the alias list.

Note:
This workflow allows for the use of domain coded values as city aliases if the code is stored in the reference data or is part of the input address.

Procedure

Warning:
Make a copy of the USAddress.lot.xml prior to modifying the file.
Make sure to have write permissions to the Locators folder where the address locator templates are stored.
Note:
Notepad++ is an example of a text editor that can be used to modify the XML file.
Note:
It may necessary to copy the USAddress.lot.xml file to a different folder to edit it, and copy it back into the original location due to Windows Dynamic Access Control settings.
  1. Open the USAddress.lot.xml in a text or XML editor. This file is found in the following location:
    C:\Program Files (x86)\ArcGIS\Desktop10.x\Locators
    Note:
    Substitute '10.x' in the address above to match the version of ArcMap in use.
    Note:
    The path for ArcGIS Pro is:
    
    C:\Program Files\ArcGIS\Pro\Resources\Locators
  2. Search for CityAliases.
  3. Scroll down to the following line:
    Code:
    <alt>los angeles</alt>
  4. Insert an entry in the Los Angeles list for Hollywood.
    Before
    Code:
    <alias_def>
    	<alt>los angeles</alt>
    	<alt>la</alt>
    	<alt>la-la land</alt>
    	<alt>l a</alt>
    	<alt>ls angls</alt>
    </alias_def>
    After
    Code:
    <alias_def>
    	<alt>los angeles</alt>
    	<alt>la</alt>
    	<alt>la-la land</alt>
    	<alt>l a</alt>
    	<alt>ls angls</alt>
            <alt>hollywood</alt>
    </alias_def>
  5. Save the edits.
  6. Create a new address locator using any of the US Address locator styles and the resulting address locator allows searching for an address using any entry in the alias list for the city.

Related Information