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...

Assign By Trade Area

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

Summary

Assigns customers to stores by using existing trade areas.

Learn more about how Assign By Trade Area works

Usage

  • You cannot undo the assignment of customers to stores in an existing field.

  • Any customers that do not fall inside a trade area will not be assigned to a store.

  • If any of the trade areas are overlapping, you can remove trade area overlap before executing this tool.

  • You can remove trade area overlap using the Remove Trade Area Overlap tool.

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.

  • True —Assigns selected customers to the trade area.
  • False —Assigns all customers to the trade area.
Boolean
WayToDefineLinkField
(Optional)

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

  • USE_EXISTING —Uses an existing store ID field.
  • CREATE_NEW —Creates a new store ID field.
Boolean
CreateNewFeatureClass
(Optional)

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

  • True —Creates a new feature class.
  • False —Does 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.3\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

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 Customer Setup 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