Consolidate Locator

Summary

Consolidate a locator or composite locator by copying all locators into a single folder.

Illustration

The output folder structures of a locator and a composite locator that have been consolidated.

Usage

• This tool is located in the Geocoding toolbox. For convenience, a copy of this tool also resides in the Data Management toolbox Package toolset.

• A warning is issued when this tool encounters an invalid locator. The invalid locator will not be packaged.

• If the locator to be consolidated or packaged is a composite locator and the Composite locator only: copy participating locators in Enterprise Geodatabase instead of referencing them option is checked

  • The composite locator and all its participating locators, including locators in an enterprise geodatabase, will be copied to the consolidated folder.
  • Each locator will be copied to a unique folder created in the consolidated folder.

• If the locator to be consolidated or packaged is a composite locator and the Composite locator only: copy participating locators in Enterprise Geodatabase instead of referencing them option is unchecked

  • The composite locator and its participating locators that are not stored in an enterprise geodatabase will be copied to the consolidated folder.
  • The participating locators in an enterprise geodatabase will not be copied to the consolidated folder, but the composite locator will preserve the connection information of the participating locators that are stored in the enterprise geodatabase.

Syntax

ConsolidateLocator_management (in_locator, output_folder, {copy_arcsde_locator})

Parameter	Explanation	Data Type
in_locator	The input locator or composite locator that will be consolidated.	Locator
output_folder	The output folder that will contain the locator or composite locator with its participating locators.	Folder
copy_arcsde_locator (Optional)	Specifies whether participating locators will be copied or their connection information will be preserved in the composite locator. This option only applies to composite locators. COPY_ARCSDE —All participating locators, including locators in an enterprise geodatabase, will be copied to the consolidated folder or package. This is the default. PRESERVE_ARCSDE — Connection information of the participating locators that are stored in an enterprise geodatabase will be preserved in the composite locator.	Boolean

Code sample

ConsolidateLocator example 1 (Python window)

The following Python script demonstrates how to use the ConsolidateLocator tool from the Python window:

import arcpy
arcpy.env.workspace = "C:/MyData/Locators" 
arcpy.ConsolidateLocator_Geocoding('Atlanta_composite', 'Consolidate_folder', "COPY_ARCSDE")

ConsolidateLocator example 2 (stand-alone script)

Finds and creates individual consolidated folders for all the locators that reside in a specified folder.

# Name: ConsolidateLocator.py
# Description:  Find all the locators that reside in a specified folder and create a consolidated folder for each locator.

# import system modules
import os
import arcpy

# Set environment settings
arcpy.env.overwriteOutput = True
arcpy.env.workspace = "C:/MyData/Locators"

# Loop through the workspace, find all the loc and create a consolidated folder using the same 
# name as the original locator
for loc in arcpy.ListFiles("*.loc"):
    print("Consolidating " + loc)
    arcpy.ConsolidateLocator_geocoding(loc, os.path.splitext(loc)[0], "COPY_ARCSDE")

Environments

• Current Workspace

Licensing information

• ArcGIS for Desktop Basic: Yes
• ArcGIS for Desktop Standard: Yes
• ArcGIS for Desktop Advanced: Yes