Generate Trade Area Rings (Business Analyst)

获得 Business Analyst 许可后可用。

摘要

Creates rings around point locations.

插图

Generate Trade Area Rings

使用情况

  • Valid numeric distances must be used when defining distance values. Negative distances cannot be used for rings.

  • The Remove Overlap parameter uses Thiessen polygons to remove overlap between output ring polygons.

参数

标注说明数据类型
Input Features

The input features containing the center points for the rings.

Feature Layer
Output Feature Class

The feature class that will contain the output ring features.

Feature Class
Distances
(可选)

The distances, in ascending size, used to create rings around the input features.

Double
Distance Units
(可选)

The linear unit to be used with the distance values.

String
ID Field
(可选)

A unique ID field in the ring center layer.

Field
Remove Overlap
(可选)

Creates overlapping concentric rings or removes overlap.

  • Checked—Thiessen polygons are used to remove overlap between output ring polygons.
  • Unchecked—Output ring features are created with overlap. This is the default.
Boolean
Dissolve Option
(可选)

Specifies whether overlapping or nonoverlapping service areas for a single location will be used when multiple distances are specified.

  • OverlapEach polygon will include the area reachable from the facility up to the distance value. This is the default.
  • SplitEach polygon will include only the area between consecutive distance values.
String
Input Method
(可选)

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

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

A fields-based expression to calculate the radii.

SQL Expression

arcpy.ba.GenerateTradeAreaRings(in_features, out_feature_class, {radii}, {units}, {id_field}, {remove_overlap}, {dissolve_option}, {input_method}, {expression})
名称说明数据类型
in_features

The input features containing the center points for the rings.

Feature Layer
out_feature_class

The feature class that will contain the output ring features.

Feature Class
radii
[radii,...]
(可选)

The distances, in ascending size, used to create rings around the input features.

Double
units
(可选)

The linear unit to be used with the distance values.

String
id_field
(可选)

A unique ID field in the ring center layer.

Field
remove_overlap
(可选)

Creates overlapping concentric rings or removes overlap.

  • REMOVE_OVERLAPThiessen polygons are used to remove overlap between output ring polygons.
  • KEEP_OVERLAPOutput ring features are created with overlap. This is the default.
Boolean
dissolve_option
(可选)

Specifies whether overlapping or nonoverlapping service areas for a single location will be used when multiple distances are specified.

  • OVERLAPEach polygon will include the area reachable from the facility up to the distance value. This is the default.
  • SPLITEach polygon will include only the area between consecutive distance values.
String
input_method
(可选)

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

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

A fields-based expression to calculate the radii.

SQL Expression

代码示例

GenerateTradeAreaRings example (Python window)

The following Python window script demonstrates how to use the GenerateTradeAreaRings tool.

import arcpy
arcpy.ba.GenerateTradeAreaRings("sales_locations.shp",r"sales_locations_GenerateTrad.shp", [1, 3, 5],"MILES", "ID", "KEEP_OVERLAP", Values, None)

环境

特殊情况

许可信息

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

相关主题