Rebuild Address Locator (Geocoding)

Summary

Rebuilds an address locator to update the locator with the current reference data. Because a locator contains a snapshot of the reference data when it was created, it will not geocode addresses with the updated data when the geometry and attributes of the reference data are changed. To geocode addresses with the current version of the reference data, the locator must be rebuilt to update the changes in the locator.

Usage

• You must have write privileges to the address locator to use this tool.

• To rebuild a locator, all the referenced feature classes and tables must exist. Rebuilding the locator will fail if you moved the reference data to another location since the last time the locator was created. Alternatively, a locator can be re-created using the Create Locator tool.

• Locators based on a versioned geodatabase will be rebuilt with the same version used when the locator was created.

• Composite locators cannot be rebuilt using this tool. The best practice for managing composite locators is to create a composite locator using the Create Composite Address Locator tool in a geoprocessing model. In ModelBuilder, this tool can be chained with the Create Locator tool to use its outputs as the inputs to the composite locator and manage the entire process of creating or updating a composite locator.

Parameters

Dialog

Label	Explanation	Data Type
Input Address Locator	The address locator that will be rebuilt.	Address Locator

Derived Output

Label	Explanation	Data Type
Rebuilt Address Locator	The rebuilt address locator.	Address Locator

Python

arcpy.geocoding.RebuildAddressLocator(in_address_locator)

Name	Explanation	Data Type
in_address_locator	The address locator that will be rebuilt.	Address Locator

Derived Output

Name	Explanation	Data Type
out_address_locator	The rebuilt address locator.	Address Locator

Code sample

RebuildAddressLocator example (Python window)

The following Python window script demonstrates how to use the RebuildAddressLocator function in immediate mode.

# Import system modules
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Geocoding/atlanta" 

# Set local variables:
address_locator = "Atlanta_AddressLocator"

arcpy.geocoding.RebuildAddressLocator(address_locator)

Environments

This tool does not use any geoprocessing environments.