Spatial Overlay (Online) (Business Analyst)

License Level:BasicStandardAdvanced

Summary

Aggregates data from one layer to another. For example, you can summarize block group demographic data for a set of trade areas.

How Spatial Overlay works

Illustration

Spatial Overlay apportionment

Usage

Syntax

SpatialOverlayOnline_ba (InputFeatureLayer, OverlayLayer, SelectedSummarizations, OutputFeatureClass, {SpatialOverlayAppendData}, {UseSelectedFeatures})
ParameterExplanationData Type
InputFeatureLayer

The input feature layer that contains the data to be extracted.

Feature Layer
OverlayLayer

The overlay layer that inherits the data.

Feature Layer
SelectedSummarizations
[SelectedSummarization,...,...]

The variable from the input layer on which to run the spatial overlay.

String
OutputFeatureClass

The feature class that will contain the overlay features.

Feature Class
SpatialOverlayAppendData
(Optional)

The selected variables can be appended to the overlay layer.

  • TRUEAppends data to layer.
  • FALSEWill not append data to layer. This is the default.
Boolean
UseSelectedFeatures
(Optional)

The boundaries used to generate the spatial overlay.

  • TRUEGenerates a spatial overlay on selected boundaries.
  • FALSEGenerates a spatial overlay on all boundaries. This is the default.
Boolean

Code Sample

SpatialOverlay Example (Stand-alone Script)
# Name: SpatialOverlay.py
# Description: Appends total population and total households to a trade area. 
# Author: Esri

# Import system modules
import arcview
import arcpy

arcpy.ImportToolbox("C:\Program Files (x86)\ArcGIS\Desktop10.2\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")

try:
# Acquire extension license
  arcpy.CheckOutExtension("Business") 
 
# Define input and output parameters for the Spatial Overlay tool
  InputPath = "C:/ArcGIS/Business Analyst/US_2013/Data/BDS/esri_bg.bds"
  InputOverlay = "C:/temp/TradeArea.shp"
  OutPath = "C:/temp/overlayoutput.shp"
  Sum = "TOTPOP_CY;HHPOP_CY"
 
# Create Spatial Overlay output file
  arcpy.SpatialOverlay_ba(InputOverlay, Sum, "false")
 
# Release extension license 
  arcpy.CheckInExtension("Business") 
 
except:
  print arcpy.GetMessages(2)

Environments

This tool does not use any geoprocessing environments

Related Topics

Licensing Information

ArcGIS for Desktop Basic: Requires Business Analyst
ArcGIS for Desktop Standard: Requires Business Analyst
ArcGIS for Desktop Advanced: Requires Business Analyst
3/3/2014