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.
Syntax
arcpy.geocoding.RebuildAddressLocator(in_address_locator)
| Parameter | Explanation | Data Type |
in_address_locator | The address locator to rebuild. | Address Locator |
Derived Output
| Name | Explanation | Data Type |
| out_address_locator | The rebuilt address locator. | Address Locator |
Code sample
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.RebuildAddressLocator_geocoding(address_locator)Environments
Licensing information
- Basic: Yes
- Standard: Yes
- Advanced: Yes