ArcGIS for Desktop

  • Documentation
  • Pricing
  • Support

  • My Profile
  • Help
  • Sign Out
ArcGIS for Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS for Desktop

A complete professional GIS

ArcGIS for Server

GIS in your enterprise

ArcGIS for Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Pricing
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

Help

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • More...

Monitor Trade Area Change

  • Summary
  • Illustration
  • Usage
  • Syntax
  • Code Sample
  • Environments
  • Licensing Information

Summary

Creates a new feature class and report that analyze how trade areas have changed over time

Learn more about how Monitor Trade Area Change works

Illustration

Measure Trade Area Change Wide

Usage

  • The spatial reference of the output feature class will be the same as the first trade area layer.

  • Both trade area layers must be polygon feature classes.

  • This tool is primarily used to track changes in trade areas over time.

  • This tool is most often used with customer-derived trade areas that have been created with customer data captured at two different time periods or for different product groups.

  • In most cases, the trade area layers will be trade areas created with ESRI Business Analyst.

  • Only overlapping trade areas are valid inputs for this tool.

  • If no store layer is defined, the geographic center of the trade area will be used to calculate the index of similarity.

Syntax

MonitorTradeAreaChange_ba (InputLayerParameterName1, IDFieldParameterName1, NameFieldParameterName1, InputLayerParameterName2, IDFieldParameterName2, NameFieldParameterName2, ReportNameParameterName, ReportTitleParameterName, ReportOutputDirectoryParameterName, OutputFeatureClass, {StoreLayerParameterName}, {StoreIDFieldParameterName}, {TAStoreIDFieldParameterName}, {ReportFormats})
ParameterExplanationData Type
InputLayerParameterName1

The first trade area used in the Monitor Trade Area Change tool. This trade area will be compared to the second trade area to determine the amount of overlap.

Feature Layer
IDFieldParameterName1

The unique ID for the first trade area.

Field
NameFieldParameterName1

The unique name for the first trade area.

Field
InputLayerParameterName2

The second trade area used in the Monitor Trade Area Change tool. This trade area will be compared to the first trade area to determine the amount of overlap.

Field
IDFieldParameterName2

The unique ID for the second trade area.

Feature Layer
NameFieldParameterName2

The unique name for the second trade area.

Field
ReportNameParameterName

Name of the report.

String
ReportTitleParameterName

Title of the report.

String
ReportOutputDirectoryParameterName

Report is created in this output folder.

Folder
OutputFeatureClass

The output feature class that will contain the trade area overlap features.

Feature Class
StoreLayerParameterName
(Optional)

The layer used for each trade area to calculate an index of similarity. In most cases, this will be a Business Analyst store layer.

Feature Layer
StoreIDFieldParameterName
(Optional)

The unique ID for the store layer.

Field
TAStoreIDFieldParameterName
(Optional)

The ID field that associates the store layer with the trade area layer.

Field
ReportFormats
[ReportFormats,...]
(Optional)

Select the desired report output format

  • Simple XML
  • PDF
  • HTML
  • CSV
  • ZIP
  • XLSV
  • Stripped XLSX
String

Code Sample

MonitorTradeAreaChange Example (Stand-alone Script)
# Name: MonitorTradeAreaChange.py
# Description: Calculates the percent change between two overlapping trade areas.
# Author: Esri

# Import system modules
import arcview
import arcpy

arcpy.AddToolbox("C:\Program Files (x86)\ArcGIS\Desktop10.3\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")
 
try:
# Acquire extension license 
  arcpy.CheckOutExtension("Business") 

# Define input and output parameters for the Monitor Trade Area Change tool    
  TradeArea1 = "C:/temp/TradeArea1.shp"
  ID1 = "AREA_ID"
  Name1 = "NAME"
  TradeArea2 = "C:/temp/TradeArea2.shp"
  ID2 = "AREA_ID"
  Name2 = "NAME"
  RptName = "Monitor TA Report Name"
  RptTitle = "Monitor TA Report Title"
  RptPath = "C:/temp/Reports"
  Output = "C:/temp/Output_TAChange.shp"
 
# Create a Monitor Trade Area output
  arcpy.MonitorTradeAreaChange_ba(TradeArea1, ID1, Name1, TradeArea2, ID2, Name2, RptName, RptTitle, RptPath, Output)
 
# Release extension license 
  arcpy.CheckInExtension("Business") 
 
except:
  print arcpy.GetMessages(2)

Environments

This tool does not use any geoprocessing environments

Licensing Information

  • ArcGIS for Desktop Basic: Requires Business Analyst
  • ArcGIS for Desktop Standard: Requires Business Analyst
  • ArcGIS for Desktop Advanced: Requires Business Analyst

Related Topics

  • An overview of the Trade Areas toolset
Feedback on this topic?

ArcGIS for Desktop

  • Home
  • Documentation
  • Pricing
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS for Desktop
  • ArcGIS for Server
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Insiders Blog
  • User Conference
  • Developer Summit
Esri
© Copyright 2016 Environmental Systems Research Institute, Inc. | Privacy | Legal