Generate Geographies From Overlay (Business Analyst)

获得 Business Analyst 许可后可用。

摘要

Generates trade areas from the features of an input standard geography level that has a specified spatial relationship with the input.

使用情况

  • The tool finds the component geography of the given input layer and, for each component geography, calculates how much of its area, population, number of households, and so on, intersect the input feature.

  • The Input Features parameter value is used to define which features of the standard geography level layer will be included in the output.

  • The Input Features parameter value can be a point or polygon feature type.

  • The layer output is based on a polygon-to-polygon selection and is computed by a geometric relationship of the features in both polygon-based layers.

  • The All ratios option for the Ratio parameter is not available when using online data.

  • This tool will consume credits under certain circumstances, for example, if one or more Ratios value variables are selected and are connected to ArcGIS Online, there will be a credit consumption similar to the Enrich Layer tool. Credit consumption also depends on the number of partial intersections between the Input Features and Geography Level inputs.

参数

标注说明数据类型
Geography Level

The geography level that will be used to define the trade area.

String
Input Features

The features that will be used to extract the standard geography level features by the specified spatial relationship. It can be either all features from the layer or only those selected once a selection is available.

Feature Layer
ID Field

The field that will be used to identify the Input Features parameter value—for example, the IDs of drive time polygons.

Field
Output Feature Class

The output feature containing the trade area.

Feature Class
Relationship
(可选)

Specifies how the subgeography will be selected from the boundary layer.

  • IntersectIf any of the subgeography features touch or intersect the boundary layer, they will be included in the output layer. This is the default.
  • Have their center inIf the centroids of any of the subgeography features are contained within the boundary layer, they will be included in the output layer.
  • Completely withinOnly the features of the subgeography layer that are completely contained within the boundary layer will be included in the output layer.
String
Ratios
(可选)

Specifies the ratios that will be calculated.

  • No ratiosNo ratios will be calculated. This is the default.
  • Area onlyOnly the ratios within the portion (area) of the standard geography level that intersects an input feature will be calculated.
  • All ratiosAll available ratios will be calculated. This option is not available when using online data.
String

arcpy.ba.GenerateGeographiesFromOverlay(geography_level, in_features, id_field, out_feature_class, {overlap_type}, {ratios})
名称说明数据类型
geography_level

The geography level that will be used to define the trade area.

String
in_features

The features that will be used to extract the standard geography level features by the specified spatial relationship. It can be either all features from the layer or only those selected once a selection is available.

Feature Layer
id_field

The field that will be used to identify the in_features parameter value—for example, the IDs of drive time polygons.

Field
out_feature_class

The output feature containing the trade area.

Feature Class
overlap_type
(可选)

Specifies how the subgeography will be selected from the boundary layer.

  • INTERSECTIf any of the subgeography features touch or intersect the boundary layer, they will be included in the output layer. This is the default.
  • CENTROID_WITHINIf the centroids of any of the subgeography features are contained within the boundary layer, they will be included in the output layer.
  • COMPLETELY_WITHINOnly the features of the subgeography layer that are completely contained within the boundary layer will be included in the output layer.
String
ratios
(可选)

Specifies the ratios that will be calculated.

  • NO_RATIOSNo ratios will be calculated. This is the default.
  • AREA_ONLYOnly the ratios within the portion (area) of the standard geography level that intersects an input feature will be calculated.
  • ALL_RATIOSAll available ratios will be calculated. This option is not available when using online data.
String

代码示例

GenerateGeographiesFromOverlay example (Python window)

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

import arcpy
arcpy.ba.GenerateGeographiesFromOverlay("US.ZIP5", "TradeArea", "ID",
                                        r"C:\Temp\Output.gdb\OverlayTradeAreas")

许可信息

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

相关主题