Add Territory Level (Territory Design)—ArcGIS Pro

Available with Business Analyst license.

Summary

Creates a new empty feature class to represent a level.

Specify an existing territory solution.
A new level is created above the base level. Base features are aggregated to the new level.
The %Number% variable determines where the integer number is placed, either after or before the territory name—for example, Territory %Number% produces Territory 1, Territory 2, and so forth, whereas %Number% Territory produces 1 Territory, 2 Territory, and so forth.
The default primary feature class for a base level with polygon features is Base Boundaries.
The default primary feature class for a base level with point features is Base Centers.

arcpy.td.AddTerritoryLevel(in_territory_solution, level_name, {default_territory_name}, {primary_feature_class})

Parameter	Explanation	Data Type
in_territory_solution	The input territory solution.	Group Layer; Feature Dataset; String
level_name	The name of the new territory level.	String
default_territory_name (Optional)	The name to be used as a prefix for new territories that will be created.	String
primary_feature_class (Optional)	Specifies the class level that will be used for storing level attributes. TERRITORY_BOUNDARIES —Polygon features that represent the territory boundaries. TERRITORY_CENTERS — Point features that represent the territory centers. BASE_BOUNDARIES —Polygon features that represent the base-level feature boundaries. BASE_CENTERS —Point features that represent the base-level feature centers.	String

Name	Explanation	Data Type
out_territory_solution	The updated territory solution.	Group Layer

AddTerritoryLevel example (Python window)

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

import arcpy
arcpy.td.AddTerritoryLevel("Territory Solution", "Level1", "Territory", "BASE_BOUNDARIES")