Generate Drive Time Trade Areas (Business Analyst)—ArcGIS Pro

Available with Business Analyst license.

Summary

Creates a feature class of trade areas around point features based on travel time and distance.

Illustration

Usage

This tool requires a locally stored dataset or a portal connection, such as ArcGIS Online.
You can create drive time rings that don't overlap using various travel modes.
The Time of Day parameter is used to model output polygons based on historical traffic data at the specified day and time.
The ID Field parameter is used to create an attribute in the output that uniquely identifies each polygon and respective input point.

Parameters

Label	Explanation	Data Type
Input Features	The input point feature layer.	Feature Layer
Output Feature Class	The output feature class containing the drive time polygons.	Feature Class
Distance Type	The method of travel that will be used for drive time calculation.	String
Distances	The distances that will be used for drive time calculations.	Double
Distance Units (Optional)	The units that will be used for the distance values. The default value is miles.	String
ID Field (Optional)	A unique ID field for existing facilities.	Field
Dissolve Option (Optional)	Specifies whether overlapping or nonoverlapping service areas for a single location will be used when multiple distances are specified. Overlap— Each polygon will include the area reachable from the facility up to the distance value. This is the default. Split— Each polygon will include only the area between consecutive distance values.	String
Remove Overlap (Optional)	Specifies whether overlapping concentric rings will be created or overlap will be removed from multiple locations in relation to one another. Checked—Polygons will be split and the overlap between output features will be removed. Unchecked—Output features will be created with overlap. This is the default.	Boolean
Travel Direction (Optional)	Specifies the direction of travel toward or away from stores. Toward stores— The direction of travel will be toward stores. This is the default. Away from stores— The direction of travel will be away from stores.	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. Points located beyond the search tolerance will be excluded from processing. This parameter requires a distance value and units for the tolerance. 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
Input Method (Optional)	Specifies the type of value that will be used for each drive time. Values—A constant value will be used (all trade areas will be the same size). This is the default. Expression— The values from a field or an expression will be used (trade areas can be different sizes).	String
Distance Expression (Optional)	A fields-based expression used to calculate drive time.	SQL Expression

arcpy.ba.GenerateDriveTimeTradeArea(in_features, out_feature_class, distance_type, distances, {units}, {id_field}, {dissolve_option}, {remove_overlap}, {travel_direction}, {time_of_day}, {time_zone}, {search_tolerance}, {polygon_detail}, {input_method}, {expression})

Name	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
distance_type	The method of travel that will be used for drive time calculation.	String
distances [distances,...]	The distances that will be used for drive time calculations.	Double
units (Optional)	The units that will be used for the distance values. The default value is miles.	String
id_field (Optional)	A unique ID field for existing facilities.	Field
dissolve_option (Optional)	Specifies whether overlapping or nonoverlapping service areas for a single location will be used when multiple distances are specified. OVERLAP— Each polygon will include the area reachable from the facility up to the distance value. This is the default. SPLIT— Each polygon will include only the area between consecutive distance values.	String
remove_overlap (Optional)	Specifies whether overlapping concentric rings will be created or overlap will be removed from multiple locations in relation to one another. REMOVE_OVERLAP—Polygons will be split and the overlap between output features will be removed. KEEP_OVERLAP—Output features will be created with overlap. This is the default.	Boolean
travel_direction (Optional)	Specifies the direction of travel toward or away from stores. TOWARD_STORES— The direction of travel will be toward stores. This is the default. AWAY_FROM_STORES— The direction of travel will be away from stores.	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. Points located beyond the search tolerance will be excluded from processing. This parameter requires a distance value and units for the tolerance. 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
input_method (Optional)	Specifies the type of value that will be used for each drive time. VALUES—A constant value will be used (all trade areas will be the same size). This is the default. EXPRESSION— The values from a field or an expression will be used (trade areas can be different sizes).	String
expression (Optional)	A fields-based expression used to calculate drive time.	SQL Expression

Code sample

GenerateDriveTimeTradeArea example (Python window)

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

import arcpy
arcpy.ba.GenerateDriveTimeTradeArea(r"C:\Project1.gdb\DriveTime.gdb\Starbucks","\Documents\ArcGIS\Projects\Project1.gdb\Starbucks_GenerateDriveTimeTradeArea","Driving
Distance", 1.3, "MILES", None,"OVERLAP", "KEEP_OVERLAP",
"TOWARD_STORES",None, "TIME_ZONE_AT_LOCATION", None,"STANDARD", Values,
None)

Environments

Current Workspace, Data Source, Network Source, Geographic Transformations

Licensing information

Basic: Requires Business Analyst, ArcGIS Network Analyst extension
Standard: Requires Business Analyst, ArcGIS Network Analyst extension
Advanced: Requires Business Analyst, ArcGIS Network Analyst extension