Create Trade Area From Geography Levels (Business Analyst)

摘要

Generates trade areas based on standard geographic units.

Learn more about how Create Trade Area From Geography Levels works

用法

• The spatial reference of the output feature class will be the same as the input geography boundary layer.

• Use the Append Fields From Geography Boundary to Output option to include the demographic data of an ESRI dataset in the output trade areas.

• The Table Containing Matching Geography Fields must be in a format compatible with ArcMap. Your tabular data can be in the form of a database file format (.dbf) file, a comma- or tab-delimited text (.txt) file, or a relational database management system (RDBMS).

• All nonmatching ZIP Codes will be excluded in the output trade area.

• Nonmatching ZIP Codes are ZIP Code records in the Table Containing Matching Geography IDs that are not valid and do not have a corresponding feature in the input geography boundary layer.

• If you want to select from a list of available geographic features to create a study area, you can use the Trade Area wizard in ArcMap. Selecting geographic features is not available as a geoprocessing tool.

• In ArcMap, trade areas will only be created for features that are within the active study area or analysis extent.

语法

CreateTAFromGeographyLevels_ba ({Dissolve}, InputGeographyLevelLayer, InputGeographyLevelIdField, InputGeographyUnitsTable, InputGeographyUnitsIdField, {InputGeographyUnitsStoreIdField}, InputHandleDuplicateBehavior, OutputFeatureClass, {InputAppendVisibleFields})

参数	说明	数据类型
Dissolve (可选)	This option dissolves the output based on the selected Store ID. TRUE —Dissolves boundaries based on selected Store ID. FALSE —Does not dissolves boundaries. This is the default.	Boolean
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
InputGeographyUnitsStoreIdField (可选)	This field assigns the same standard geography units to several stores.	Field
InputHandleDuplicateBehavior	Allows you to filter duplicate fields in the table containing matching geographic IDs. SUMMARIZE_FIELD —If 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 FEATURE —If 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 (可选)	Appends the fields from the geography boundary to the output feature class. TRUE —Appends fields to the output feature class. FALSE —Does not append fields to the output feature class. This is the default.	Boolean

代码实例

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

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

  arcpy.AddToolbox("C:\Program Files (x86)\ArcGIS\Desktop10.2\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")
 
# Define input and output parameters for the Create Trade Area From Geography Levels tool
  InputGeo = "C:/ArcGIS/Business Analyst/US_2013/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)

环境

此工具不使用任何地理处理环境

许可信息

ArcGIS for Desktop Basic: 需要 Business Analyst

ArcGIS for Desktop Standard: 需要 Business Analyst

ArcGIS for Desktop Advanced: 需要 Business Analyst