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 Closest Stores Location

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

Summary

Assigns customers to stores by closest location using a straight-line distance method.

Learn more about how Assign by Closest Location works

Usage

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

  • Customers are assigned to the closest store location.

  • Assignments are based on a straight-line Euclidean distance calculation.

  • Use the Assign By Trade Area tool if you do not want to assign customers using a straight-line distance. The Assign By Trade Area tool can be used with drive-time polygons.

  • If a customer is at an equal distance from two or more stores, the customer will be assigned to the first store in the attribute table.

Syntax

AssignCustomersByLocation_ba (InputFeatureLayer, IdField, CustomerLayer, LinkField, {UseSelectedFeatures}, {WayToDefineLinkField}, {CreateNewFeatureClass}, {OutputFeatureClass})
ParameterExplanationData Type
InputFeatureLayer

The store layer to which to assign customers.

Feature Layer
IdField

The unique identifier of each store.

Field
CustomerLayer

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

Feature Layer
LinkField

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

Field
UseSelectedFeatures
(Optional)

Customers are assigned by selected features of the customer layer.

  • True —Assigns selected customers to stores.
  • False —Assigns all customers to stores.
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 assigned features.

Feature Class

Code Sample

AssignCustomersByLocation Example (Stand-alone Script)
# Name: AssignCustomersByLocation.py
# Description: Assigns customers in the San Francisco area to their designated stores by closest location using a straight-line distance metho
# Author: Esri

# Import system modules

import arview
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 Closest Stores Location tool
  StorePath = "C:/temp/sf_stores.shp"
  CustPath = "C:/temp/sf_cust.shp"
  StoreId = "STORE_ID"
  StoreLink = "STORE_ID"
 
# Assigns by Closest Stores Location
  arcpy.AssignCustomersByLocation_ba(StorePath, StoreId, CustPath, StoreLink, "false")
 
# 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