Generate Approximate Drive Times (Business Analyst)

获得 Business Analyst 许可后可用。

描述

Creates trade areas that approximate the size, shape, and area of existing polygons using available routes from the selected distance type.

使用方法

• The Output Feature Class attribute table contains a field that lists the distance or travel time of each polygon from centroid to boundary.

• If the Store Layer parameter is specified, its locations will be used as the starting point for creating network service areas, instead of the input centroids.

• The Iterations Limit parameter allows you to reduce credit consumption for online data by restricting the number of times networks can be traversed. A low Iterations Limit value may impact how closely the drive time trade areas align with the input polygons.

语法

arcpy.ba.GenerateApproximateDriveTimes(in_features, out_feature_class, distance_type, {units}, {in_stores_layer}, {store_id_field}, {link_field}, {iterations_limit}, {minimum_step}, {target_percent_diff}, {travel_direction}, {time_of_day}, {time_zone}, {search_tolerance}, {polygon_detail})

参数	说明	数据类型
in_features	The input polygon feature layer.	Feature Layer
out_feature_class	The output feature class containing the drive time polygons.	Feature Class
distance_type	The method of travel used to create the output polygons.	String
units （可选）	The distance units to be used with the threshold values.	String
in_stores_layer （可选）	A point layer that will be used as the starting point for creating network service areas.	Feature Layer
store_id_field （可选）	The ID that uniquely identifies each in_stores_layer point.	Field
link_field （可选）	The ID that uniquely identifies each in_features point.	Field
iterations_limit （可选）	The maximum number of drive times that can be used to find the optimal threshold limit.	Long
minimum_step （可选）	The minimum increment distance or time—for example, 1 mile or 1 min, used between iterations to expand until the threshold is reached.	Double
target_percent_diff （可选）	The maximum difference between the target value and threshold value when determining the threshold drive time—for example, 5%. The default value is 5.	Double
travel_direction （可选）	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 （可选）	The time and date that will be used when calculating distance.	Date
time_zone （可选）	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 （可选）	The maximum distance that input points can be from the network. The default value is 5000 meters.	Linear Unit
polygon_detail （可选）	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

代码示例

GenerateApproximateDriveTimes example (Python window)

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

import arcpy
arcpy.ba.GenerateApproximateDriveTimes("SF_TradeArea",r"C:\Project1.gdb\SF_Stores_GenerateApproximateDriveTimes", "Driving Time", "MINUTES",r"C:\Project1.gdb\sf_stores_Geocoded", "INPUT_AREA_ID", "STORES_AREA_ID", 10, None, 5, "TOWARD_STORES", None, "TIME_ZONE_AT_LOCATION", None, "STANDARD")

环境

当前工作空间, 数据源, 网络源

许可信息

• Basic: 需要 Business Analyst
• Standard: 需要 Business Analyst
• Advanced: 需要 Business Analyst