Generate Threshold Drive Times (Business Analyst)

获得 Business Analyst 许可后可用。

描述

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

使用方法

  • The size of output polygons is determined by the Threshold Values parameter value provided for a selected Threshold Variable parameter value 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.

语法

arcpy.ba.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}, {minimum_step}, {target_percent_diff}, {input_method}, {expression})
参数说明数据类型
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
(可选)

The distance units to be used with the threshold values.

String
id_field
(可选)

The ID that uniquely identifies each input point and is included in the output as an attribute.

Field
travel_direction
(可选)

Specifies the direction of travel for output polygon creation.

  • TOWARD_STORESThe direction of travel will be from customers to stores. This is the default.
  • AWAY_FROM_STORESThe 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_LOCATIONThe time zone in which the territories are located will be used. This is the default.
  • UTCCoordinated 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.

  • STANDARDPolygons with a standard level of detail will be created. This is the default.
  • GENERALIZEDGeneralized polygons will be created using the hierarchy present in the network data source to produce results quickly.
  • HIGHPolygons with a high level of detail will be created for applications in which precise results are important.
String
iterations_limit
(可选)

Restricts the number of drive times used to find the optimal threshold limit.

Long
minimum_step
(可选)

The minimum increment distance or time—for example, 1 mile or 1 minute—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 percent. The default value is 5.

Double
input_method
(可选)

Specifies the type of value that will be used for each drive time.

  • VALUESA constant value will be used (all trade areas will be the same size). This is the default.
  • EXPRESSIONThe values from a field or an expression will be used (trade areas can be a different size).
String
expression
(可选)

A fields-based expression to calculate drive time.

SQL Expression

代码示例

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, None, 5, Values, None)

许可信息

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

相关主题