ArcMap

Spatial Overlay (Online)

Available with Business Analyst license.

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

  • The input layer must be properly formatted using the Analysis Layer Setup tool in Business Analyst with appropriate apportionment values applied.

  • The input layer contains the underlying data you want to extract.

  • Data is added to the overlay layer. Data is extracted from the input layer and aggregated into the overlay layer.

  • You can aggregate from a point- or polygon-based input layer.

  • A file called Ratios Table.dbf will be created and added in the same directory of the output overlay layer. This ratios table contains the percentage of intersection and weights used to execute the overlay.

  • Do not run a spatial overlay analysis if ArcMap is still redrawing your map. This may cause a problem with ArcMap and result in ArcMap crashing.

Syntax

arcpy.ba.SpatialOverlayOnline(OverlayLayer, SelectedSummarizations, OutputFeatureClass, {SpatialOverlayAppendData}, {UseSelectedFeatures}, {SelectedDCs})
ParameterExplanationData Type
OverlayLayer

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

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

The overlay layer that inherits the data.

String
OutputFeatureClass

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

Feature Class
SpatialOverlayAppendData
(Optional)

The feature class that will contain the overlay features.

  • TRUE —Generates a spatial overlay on selected boundaries.
  • FALSE —Generates a spatial overlay on all boundaries. This is the default.
Boolean
UseSelectedFeatures
(Optional)

The selected variables that will be appended to the overlay feature.

  • TRUE — Appends data to layer.
  • FALSE —Will not append data to layer. This is the default.
Boolean
SelectedDCs
[SelectedDCs,...,...]
(Optional)

The online feature service from which you will append variables.

String

Code sample

SpatialOverlayOnline example (stand-alone script)

# Name: SpatialOverlayOnline.py
# Description: Appends total population and total households to a trade area.
# Author: Esri

# Import system modules
import arcview
import arcpy

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

try:
# Acquire extension license
  arcpy.CheckOutExtension("Business") 
 
# Define input and output parameters for the Spatial Overlay Online tool
  OverlayLayer = "C:/temp/sf_cust.shp"
  SelectedSummarizations = "TOTHH_CY.Households"
  OutputFeatureClass = "C:/temp/Spatial_Overlay_Online.shp"
 
# Create Mean Store Center output file
  arcpy.SpatialOverlayOnline_ba(OverlayLayer, 
	SelectedSummarizations, 
	OutputFeatureClass)
 
# Release extension license 
arcpy.CheckInExtension("Business")

Environments

This tool does not use any geoprocessing environments.

Licensing information

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

Related topics