获得 Business Analyst 许可后可用。
描述
Defines the type of distance calculation or distance constraints to use when creating territories.
使用方法
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.
Territory Buffer Distance specifies the buffer size around each territory that cannot be encroached. Territories will be constrained by the adjacent territory buffer.
When setting Minimum Distance Between Centers, the distance between centers can be greater than the minimum distance.
If a network distance is specified, a Territory Network Index (TNI) will be created during the Solve tool execution.
If Network Parameters are set, a summary of network settings will be written, as messages at the bottom of the Geoprocessing pane, during the execution of the Solve tool.
Network Data Source must be set to a local network dataset. Online network solvers are not supported.
语法
arcpy.td.SetTerritoryDistanceParameters(in_territory_solution, level, {distance_type}, {units}, {max_radius}, {buffer_distance}, {min_distance}, {network_datasource}, {build_index}, {travel_direction}, {time_of_day}, {time_zone}, {search_tolerance})
参数 | 说明 | 数据类型 |
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 (可选) | Specifies how distance is calculated based on method of travel.
| String |
units (可选) | Specifies the type of measuring units that will be used.
| String |
max_radius (可选) | The maximum radius of the territory. | Double |
buffer_distance (可选) |
The radius of the territory buffer. | Double |
min_distance (可选) | The minimum distance between territory centers. | Double |
network_datasource (可选) | The network dataset on which the network distance calculation will be performed. | Network Dataset Layer |
build_index (可选) | Specifies whether or not to build an index. A network index will improve performance when solving the Territory Solution.
| Boolean |
travel_direction (可选) | Specifies the direction of travel between stores and customers.
| String |
time_of_day (可选) | Specifies the time and date when calculating distance. | Date |
time_zone (可选) | Specifies the time zone of the Time of Day parameter.
| String |
search_tolerance (可选) | The search tolerance for locating territories on the network. Territories that are outside the search tolerance are left unlocated. The parameter requires a distance value and units for the tolerance. The default value is 5000 Meters. | Linear Unit |
派生输出
名称 | 说明 | 数据类型 |
out_territory_solution | The updated territory solution. | Group Layer |
代码示例
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, "\Data\Streets Data\NorthAmerica.gdb\Routing\Routing_ND", "BUILD_INDEX", None, "5:30:00 PM", "TIME_ZONE_AT_LOCATION", "5000 Meters")
环境
许可信息
- Basic: 需要 Business Analyst
- Standard: 需要 Business Analyst
- Advanced: 需要 Business Analyst