Add Territory Seed Points (Territory Design Tools)

Summary

Creates a point feature that is used to determine the starting point for creating territories.

Seed points can be point locations from franchise addresses, sales offices, or distribution centers and are a common method for creating territories.
Seed points are used as the starting point for creating territories but do not necessarily represent the center of the territories.

Pins represents seed points. Squares represents territory centers.

Label	Explanation	Data type
Input Territory Solution	The Territory Design solution dataset.	Group Layer; Feature Dataset; String
Level	The target territory level for which the seed points feature will be created.	String
Input Seed Point Features	The points feature layer that represents seed points for territories.	Feature Layer
Field Map (Optional)	Specifies the attributes and fields that will be used for the seed point properties. The field value associated with the Type attribute can only be Required or Candidate. Value table columns: Attribute—The attributes that will be used for the seed point properties. Name—The name for a seed point feature ID—The ID for a seed point feature Type—The seed point type Field—The fields that will be used for the seed point properties.	Value Table
Append to Existing Seed Points (Optional)	Specifies whether the data will be appended or replaced. Checked—The data will be appended. Unchecked—The data will be replaced. This is the default.	Boolean

Label	Explanation	Data type
Updated Territory Solution	The updated territory solution.	Group Layer

arcpy.td.AddTerritorySeedPoints(in_territory_solution, level, in_seed_points, {field_map}, {append_data})

Name	Explanation	Data type
in_territory_solution	The Territory Design solution dataset.	Group Layer; Feature Dataset; String
level	The target territory level for which the seed points feature will be created.	String
in_seed_points	The points feature layer that represents seed points for territories.	Feature Layer
field_map [[name, id, type],...] (Optional)	Specifies the attributes and fields that will be used for the seed point properties. The field value associated with the `Type` attribute can only be Required or Candidate. Value table columns: `Attribute`—The attributes that will be used for the seed point properties. `NAME`—The name for a seed point feature `ID`—The ID for a seed point feature `TYPE`—The seed point type `Field`—The fields that will be used for the seed point properties.	Value Table
append_data (Optional)	Specifies whether the data will be appended or replaced. `APPEND`—The data will be appended. `REPLACE`—The data will be replaced. This is the default.	Boolean

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

AddTerritorySeedPoints example (Python window)

The following Python window script demonstrates how to use the AddTerritorySeedPoints function.

import arcpy
arcpy.td.AddTerritorySeedPoints("TerritorySolution", "Territories[1]", r"atl_centers\shoppingctrs", None, "REPLACE")