Generate Threshold Drive Times (Business Analyst)

Available with Business Analyst license.

Summary

Creates a feature class of network distance trade areas that expand around point features until criteria is reached.

Usage

• The size of output polygons is determined by Threshold Values entered for a selected Threshold Variable from the Business Analyst dataset.

• Multiple threshold drive time polygons can be created around each input by typing individual values into separate threshold value text boxes.

• The ID Field parameter uniquely identifies the point location around which threshold drive time polygons are created.

Syntax

GenerateThresholdDriveTimeTradeArea(in_features, out_feature_class, threshold_variable, threshold_values, distance_type, {units}, {id_field}, {travel_direction}, {time_of_day}, {time_zone}, {search_tolerance}, {polygon_detail}, {iterations_limit})

Parameter	Explanation	Data Type
in_features	The input point feature layer.	Feature Layer
out_feature_class	The output feature class containing the drive time polygons.	Feature Class
threshold_variable	The selected Business Analyst dataset variable to which the threshold value will be applied.	String
threshold_values [threshold_values,...]	The threshold variable value that determines the size of the output rings. The rings will expand until they contain the threshold value of the selected variable.	Double
distance_type	The method of travel used to create the output polygons.	String
units (Optional)	The distance units to be used with the threshold values.	String
id_field (Optional)	The ID that uniquely identifies each input point and is included in the output as an attribute.	Field
travel_direction (Optional)	Specifies the direction of travel for output polygon creation. TOWARD_STORES —The direction of travel will be from customers to stores. This is the default. AWAY_FROM_STORES —The direction of travel will be from stores to customers.	String
time_of_day (Optional)	The time and date that will be used when calculating distance.	Date
time_zone (Optional)	Specifies the time zone that will be used for the Time of Day parameter. TIME_ZONE_AT_LOCATION —The time zone in which the territories are located will be used. This is the default. UTC —Coordinated universal time (UTC) will be used.	String
search_tolerance (Optional)	The maximum distance that input points can be from the network. The default value is 5000 meters.	Linear Unit
polygon_detail (Optional)	Specifies the level of detail that will be used for the output drive time polygons. STANDARD — Polygons with a standard level of detail will be created. This is the default. GENERALIZED —Generalized polygons will be created using the hierarchy present in the network data source to produce results quickly. HIGH — Polygons with a high level of detail will be created for applications in which precise results are important.	String
iterations_limit (Optional)	Restrict the number of drive times used to find the optimal threshold limit.	Long

Code sample

GenerateThresholdDriveTimeTradeArea example (Python window)

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

import arcpy
arcpy.ba.GenerateThresholdDriveTimeTradeArea("SF_Custs",
                                             r"C:\ Project1\Project1.gdb\SF_Custs_GenerateThresholdDriveTimeTradeArea",
                                             "populationtotals.totpop_cy",
                                             [25000, 50000], "Driving Time",
                                             "MINUTES", "CUST_ID", None,
                                             "TOWARD_STORES", None,
                                             "TIME_ZONE_AT_LOCATION", None,
                                             "STANDARD", 10)

Environments

Current Workspace, Data Source

Licensing information

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