Skip To Content

Generate Trade Area Rings

Available with Business Analyst license.

Summary

Creates rings around point locations.

Illustration

Generate trade area rings

Usage

  • 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.

Syntax

GenerateTradeAreaRings_ba (in_features, out_feature_class, radii, {units}, {id_field}, {remove_overlap})
ParameterExplanationData Type
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
(Optional)

The linear unit to be used with the distance values.

  • MILESThe distance unit is miles. This is the default.
  • YARDSThe distance unit is yards.
  • FEETThe distance unit is feet.
  • KILOMETERSThe distance unit is kilometers.
  • METERSThe distance unit is meters.
String
id_field
(Optional)

A unique ID field in the ring center layer.

Field
remove_overlap
(Optional)

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

Code sample

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")

Environments

Licensing information

  • Basic: Requires Business Analyst
  • Standard: Requires Business Analyst
  • Advanced: Requires Business Analyst

Related topics