Assign By Trade Area (Business Analyst)

License Level:BasicStandardAdvanced

Summary

Assigns customers to stores by using existing trade areas.

Learn more about how Assign By Trade Area works

Usage

Syntax

AssignCustomersByTA_ba (InputFeatureLayer, IDField, CustomerLayer, LinkField, {UseSelectedFeatures}, {WayToDefineLinkField}, {CreateNewFeatureClass}, {OutputFeatureClass})
ParameterExplanationData Type
InputFeatureLayer

The trade area layer that will be used to assign customers to a store.

Feature Layer
IDField

The store ID field with which to assign customers.

Field
CustomerLayer

The customer layer used to make the customer assigments to each store.

Feature Layer
LinkField

The field that will be populated with the associated store ID.

String
UseSelectedFeatures
(Optional)

Customers are assigned by selected features of the customer layer.

  • TrueAssigns selected customers to the trade area.
  • FalseAssigns all customers to the trade area.
Boolean
WayToDefineLinkField
(Optional)

Selects an existing store ID field or creates a new field.

  • USE_EXISTINGUses an existing store ID field.
  • CREATE_NEWCreates a new store ID field.
Boolean
CreateNewFeatureClass
(Optional)

Generates a new feature class based on the existing layer or uses the existing layer.

  • TrueCreates a new feature class.
  • FalseDoes not create a new feature class. The original layer will be used.
Boolean
OutputFeatureClass
(Optional)

The feature class that will contain the customer features.

Feature Class

Code Sample

AssignCustomersByTA Example (Stand-alone Script)
# Name: AssignCustomersByTA.py
# Description: Assign customers located in trade areas generated in San Francisco County to select stores.
# 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") 
 
# Defines the parameters for the Assign by Trade Area tool
  TAPath = "C:/temp/TradeArea.shp"
  CustPath = "C:/temp/sf_cust.shp"
  StoreId = "STORE_ID"
  StoreLink = "STORE_ID"
 
# Create output file for Assign by Trade Area tool
  arcpy.AssignCustomersByTA_ba (TAPath, StoreId, CustPath, StoreLink)
 
# 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