Skip To Content

Generate Standard Geography Trade Areas

Available with Business Analyst license.

Summary

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

Standard geographies are trade areas based on standardized administrative boundaries. In the United States this includes layers such as states, counties, tracts, 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, each ZIP Code) that you select. One layer can contain several trade areas, such as one whole layer containing a collection of counties.

Usage

  • 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, comma- or tab-delimited text [.txt] file, Excel file).

  • In list format the list of IDs must separated by commas.

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

Syntax

StandardGeographyTA_ba (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)

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)

Associated field that contains the IDs that will be matched to the IDs in the table.

Field
ids_list
(Optional)

List of comma separated geography IDs.

String
summarize_duplicates
(Optional)

Defines how to handle duplicate fields in the table containing matching geographic 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)

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

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

Related topics