Skip To Content

Set Territory Distance Parameters

Available with Business Analyst license.

Summary

Defines the type of distance calculation or distance constraints to use when creating territories.

Usage

  • Maximum Territory Radius specifies the maximum size of the territory. Adjacent territories can be smaller than the radius specified if the boundaries between territories overlap. Territories will expand until the radius value is reached.

    Maximum Territory Radius

  • Territory Buffer Distance specifies the buffer size around each territory that cannot be encroached. Territories will be constrained by the adjacent territory buffer.

    Territory Buffer Distance

  • When setting Minimum Distance Between Centers, the distance between centers can be greater than the minimum distance.

    Minimum Distance Between Centers

Syntax

SetTerritoryDistanceParameters_td (in_territory_solution, level, {distance_type}, {units}, {max_radius}, {buffer_distance}, {min_distance})
ParameterExplanationData Type
in_territory_solution

The Territory Design solution layer that will be used in the analysis.

Group Layer; Feature Dataset; String
level

The level to which the distance parameters will be applied.

String
distance_type
(Optional)

Specifies how distance is calculated based on method of travel.

  • STRAIGHT_LINEStraight-line, or Euclidean distance, is used as the distance measure. This is the default.
String
units
(Optional)

Specifies the type of distance measuring units that will be used.

  • METERSThe distance unit is meters.
  • MILESThe distance unit is miles.
  • NAUTICAL_MILESThe distance unit is nautical miles.
  • KILOMETERSThe distance unit is kilometers.
  • YARDSThe distance unit is yards.
  • FEETThe distance unit is feet.
  • INCHESThe distance unit is inches.
  • DECIMETERSThe distance unit is decimeters.
  • CENTIMETERSThe distance unit is centimeters.
  • MILLIMETERSThe distance unit is millimeters.
  • DECIMAL_DEGREESThe distance unit is decimal degrees.
String
max_radius
(Optional)

The maximum radius of the territory.

Double
buffer_distance
(Optional)

The radius of the territory buffer.

Double
min_distance
(Optional)

The minimum distance between territory centers.

Double

Derived Output

NameExplanationData Type
out_territory_solution

The updated territory solution.

Group Layer

Code sample

SetTerritoryDistanceParameters example (Python window)

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

import arcpy
arcpy.td.SetTerritoryDistanceParameters("TerritorySolution", "Territories[1]", "STRAIGHT_LINE", "MILES", 5, 1, 3)

Environments

Licensing information

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

Related topics