Generate Standard Geography Trade Areas (Business Analyst)

Available with Business Analyst license.

Summary

Creates trade areas based on predefined named statistical areas. This tool does not consume credits.

Illustration

Standard geography trade area

Usage

  • Standard geographies are trade areas based on standardized administrative boundaries. In the United States, this includes layers such as states, counties, ZIP Codes, block groups, census tracts, core-based statistical areas (CBSA), designated market areas (DMA), or places. Each country dataset offers administrative boundaries that can vary. Individual trade areas are created for each unique geography—for example, each state, or each ZIP Code that you select.

  • One layer can contain several trade areas—for example, one whole layer containing a collection of counties.

  • The list of IDs must be in a table or list format.

  • The table can be in any format supported by ArcGIS Pro—for example, a comma- or tab-delimited text (.txt) file or Excel file.

  • For the list format, the list of IDs must separated by commas.

  • The geography ID for the entire country trade area is 01.

  • When the Input Type parameter is set to Table, the associated Geography Key Field parameter must be a text field.

Syntax

arcpy.ba.StandardGeographyTA(geography_level, out_feature_class, {input_type}, {in_ids_table}, {geography_key_field}, {ids_list}, {summarize_duplicates}, {group_field}, {dissolve_output})
ParameterExplanationData Type
geography_level

Geography level that will be used to define your trade area.

String
out_feature_class

Output feature containing your trade area.

Feature Class
input_type
(Optional)

Specifies a list or table of geography IDs.

  • TABLE Input IDs from a table.
  • LIST Input IDs from a list. This is the default.
String
in_ids_table
(Optional)

Input table with IDs used to select geographies that will define your trade area.

Table View
geography_key_field
(Optional)

Field within Geography IDs Table that identifies records to include in the output.

Field
ids_list
(Optional)

List of comma-separated geography IDs.

String
summarize_duplicates
(Optional)

Specifies how to handle duplicate fields in the table containing matching geography IDs.

  • SUMMARIZE_DUPLICATESSummarizes the numeric fields for all duplicate records.
  • USE_FIRSTAppends the data of the first record and ignores any others. This is the default.
Boolean
group_field
(Optional)

The field that is used to perform a group by operation.

Field
dissolve_output
(Optional)

Dissolves the output based on the selected group_field.

  • DISSOLVEDissolves the output.
  • DONT_DISSOLVEDoes not dissolve the output. This is the default.
Boolean

Code sample

StandardGeographyTA example (Python window)

The following Python window script demonstrates how to use the StandardGeographyTA tool.

import arcpy
arcpy.ba.StandardGeographyTA("US.ZIP5", r"C:\Temp\Output.gdb\StdGeogTradeAreas",
                             None, None, "92111,92117,92122", "USE_FIRST", None,
                             "DISSOLVE")

Licensing information

  • Basic: Requires Business Analyst
  • Standard: Requires Business Analyst
  • Advanced: Requires Business Analyst

Related topics