Create Territory Solution (Territory Design)

Available with Business Analyst license.

Summary

Creates a new territory solution with two levels and loads input features into the base level.

Usage

  • Input features for the base level can be a point feature layer or a polygon feature layer.

  • The type of input layer will determine how the base level is displayed—for example, points or polygons.

  • Additional geometries can be created to display either boundary centers or polygon boundaries.

  • Additional layers can be created to display the base level—for example, centers of polygons or boundaries of points.

  • The ID Field and the Name Field parameters are optional and are used to uniquely identify the features in the base layer. Examples are ZIP Code or census tract names. If no ID field is provided, a unique ID will be generated automatically.

  • By default, all of the fields in the input layer will be added to the territory solution. You can turn off field visibility by right-clicking the column header and clicking Hide Field if you do not want the field to be added to the territory solution.

  • 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.

  • A mask layer is only supported for a point-based territory solution.

Parameters

LabelExplanationData Type
Input Features

The geometry or data features that will be used as the base level of the created solution. The level will have the same name as the input features.

Feature Layer
Territory Solution Name

The name of the territory solution to be created.

String
ID Field
(Optional)

The field that contains ID values for objects in the level.

Field
Name Field
(Optional)

The field that contains name values for objects in the level.

Field
Territory Level Name
(Optional)

The name of the territory level—for example, level 2.

String
Default Territory Name
(Optional)

The prefix for the names of the new territories that will be created—for example, Territory 1, Territory 2, and Territory 3 or District 1, District 2, and District 3.

String
Boundary Mask
(Optional)

The layer that is used as a mask to limit the growth of point-based layers.

Feature Layer

Derived Output

LabelExplanationData Type
Output Territory Solution

The output territory solution.

Group Layer

arcpy.td.CreateTerritorySolution(in_features, solution_name, {id_field}, {name_field}, {territory_level_name}, {default_territory_name}, {in_boundary_mask})
NameExplanationData Type
in_features

The geometry or data features that will be used as the base level of the created solution. The level will have the same name as the input features.

Feature Layer
solution_name

The name of the territory solution to be created.

String
id_field
(Optional)

The field that contains ID values for objects in the level.

Field
name_field
(Optional)

The field that contains name values for objects in the level.

Field
territory_level_name
(Optional)

The name of the territory level—for example, level 2.

String
default_territory_name
(Optional)

The prefix for the names of the new territories that will be created—for example, Territory 1, Territory 2, and Territory 3 or District 1, District 2, and District 3.

String
in_boundary_mask
(Optional)

The layer that is used as a mask to limit the growth of point-based layers.

Feature Layer

Derived Output

NameExplanationData Type
out_territory_solution

The output territory solution.

Group Layer

Code sample

CreateTerritorySolution example (Python window)

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

import arcpy
arcpy.td.CreateTerritorySolution("CensusTacts", "Territory Solution", "CensusID", "TractName", "Territories", "Territory", None)

Environments

Licensing information

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

Related topics