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 if you want 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 have moved your reference data to another location since the last time the locator was created. You can repair the locator by updating the locations of the reference data. 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

LabelExplanationData Type
Input Address Locator

The address locator to rebuild.

Address Locator

Derived Output

LabelExplanationData Type
Rebuilt Address Locator

The rebuilt address locator.

Address Locator

arcpy.geocoding.RebuildAddressLocator(in_address_locator)
NameExplanationData Type
in_address_locator

The address locator to rebuild.

Address Locator

Derived Output

NameExplanationData 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.

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

Related topics