Solve Territories (Territory Design)

Available with Business Analyst license.

Summary

Creates and balances territories on the specified territory level provided the balancing variables are set.

Usage

• The number of territories needs to be specified manually for the User Defined option.

• Calculation of the optimal number of territories requires constraints to be set. Constraints can be based on a numeric value or a distance.

Syntax

SolveTerritories(in_territory_solution, level, method, {number_territories}, {quality})

Parameter	Explanation	Data Type
in_territory_solution	Territory solution used to solve territories.	Group Layer; Feature Dataset; String
level	Level used to solve territories.	String
method	Specifies the method used when calculating the number of territories. USER_DEFINED —Number of territories is user specified. This is the default. OPTIMAL —Number of territories is calculated automatically.	String
number_territories (Optional)	Number of territories to be specified.	Long
quality (Optional)	An integer between 1 and 200 that determines the performance of a solve operation. A lower value will provide better performance but quality may be lower. The default value is 100.	Integer

Derived Output

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

Code sample

SolveTerritories example (Python window)

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

import arcpy
arcpy.td.SolveTerritories("MyProject.gdb\Solution", "Territories[1]", "USER_DEFINED", 7, 100)

Environments

Current Workspace

Licensing information

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