Create Trade Area From Geography Levels (Business Analyst)

Summary

Generates trade areas based on standard geographic units.

Learn more about how Create Trade Area From Geography Levels works

Usage

Syntax

CreateTAFromGeographyLevels_ba (InputGeographyLevelLayer, InputGeographyLevelIdField, InputGeographyUnitsTable, InputGeographyUnitsIdField, InputHandleDuplicateBehavior, OutputFeatureClass, {InputAppendVisibleFields})
ParameterExplanationData Type
InputGeographyLevelLayer

The input feature class used to extract the trade area.

Feature Layer
InputGeographyLevelIdField

The unique identifier for the input geography layer.

Field
InputGeographyUnitsTable

The input table used to select the standard geography units that will define the trade area.

Table View
InputGeographyUnitsIdField

The associated geography ID field used to select the geographic units from the input geography boundary layer.

Field
InputHandleDuplicateBehavior

Allows you to filter duplicate fields in the table containing matching geographic IDs.

  • SUMMARIZE_FIELDIf a duplicate record exists, this option will summarize the duplicate fields if the Append Fields From Geography Boundary To Output Feature Class option is selected.
  • USE FIRST FEATUREIf a duplicate record exists, this option will choose the first record in the table. Any tabular data associated with that record can be appended to the output feature class. This option only appends the data of the first record and ignores any others.
String
OutputFeatureClass

The feature class that will contain the trade area features.

Feature Class
InputAppendVisibleFields
(Optional)

Appends the fields from the geography boundary to the output feature class.

  • TRUEAppends fields to the output feature class.
  • FALSEDoes not append fields to the output feature class. This is the default.
Boolean

Code Sample

CreateTAFromGeographyLevels Example (Stand-alone Script)
# Name: CreateTAFromGeographyLevels.py
# Description: Automatically selects a set of ZIP Codes in San Francisco County from a list.
# Author: ESRI

i# Import system modules
import arcview
import arcpy
 
try:
# Acquire extension license 
arcpy.CheckOutExtension("Business") 

arcpy.AddToolbox("C:\Program Files\ArcGIS\Desktop10.0\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")
 
# Define input and output parameters for the Create Trade Area From Geography Levels tool
InputGeo = "C:/Program Files/ArcGIS/Business Analyst/Data/BDS/esri_zip5.bds"
InputIds = "C:/temp/sf_custs.dbf"
GeoId = "ID"
Id = "ZIP"
OutPath = "C:/temp/Output_Geography.shp"
 
# Create standard geography based trade areas
arcpy.CreateTAFromGeographyLevels_ba(InputGeo, GeoId, InputIds, Id, "USE_FIRST_FEATURE", OutPath)
 
# Release extension license 
arcpy.CheckInExtension("Business") 
 
except:
  print arcpy.GetMessages(2)

Environments

This tool does not use any geoprocessing environments

Related Topics

Licensing Information

ArcView: Requires Business Analyst
ArcEditor: Requires Business Analyst
ArcInfo: Requires Business Analyst

11/8/2010