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.
| 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.
| Boolean |
Travel Direction
(Optional) | Specifies the direction of travel that will be used between stores and 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.
| 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.
| String |
Input Method
(Optional) | Specifies the type of value that will be used for each drive time.
| String |
Distance Expression
(Optional) | A fields-based expression used to calculate drive time. | SQL Expression |
Available with Business Analyst license.
Summary
Creates a feature class of trade areas around point features based on travel time and distance.
Illustration
Usage
You must be signed in to ArcGIS Online or have Business Analyst Data installed.
You can create drive time rings that are nonoverlapping 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
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.
| 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.
| Boolean |
travel_direction (Optional) | Specifies the direction of travel that will be used between stores and 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.
| 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.
| String |
input_method (Optional) | Specifies the type of value that will be used for each drive time.
| String |
expression (Optional) | A fields-based expression used to calculate drive time. | SQL Expression |
Code sample
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
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