Available with Business Analyst license.
Summary
Creates trade areas based on predefined named statistical areas. This tool does not consume credits.
Illustration
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})
Parameter | Explanation | Data 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.
| 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.
| 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.
| Boolean |
Code sample
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")
Environments
Licensing information
- Basic: Requires Business Analyst
- Standard: Requires Business Analyst
- Advanced: Requires Business Analyst