ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • ArcGIS Pro
  • ArcMap
ArcGIS Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS Desktop

A complete professional GIS

ArcGIS Enterprise

GIS in your enterprise

ArcGIS 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

  • ArcGIS Pro
  • ArcMap
Esri
English
  • English
  • Deutsch
  • Español
  • Français
  • 日本語
  • Русский
  • 简体中文
  • Sign In
user
  • My Profile
  • Sign Out

ArcMap

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • Extensions
  • Tools
  • Tool reference
  • Business Analyst toolbox
  • Customer Setup toolset
  • Back to Top
  • An overview of the Business Analyst toolbox
  • Business Analyst toolbox licensing
  • Analysis toolset

    • An overview of the Business Analyst Analysis toolset
    • Customer Profiling
    • Customer Prospecting By Demographic Data
    • Customer Prospecting By Using PCA
    • Desire Lines
    • Find Similar
    • Mean Store Center
    • Spatial Overlay
    • Spatial Overlay (Online)
    • Analysis toolset concepts

    Customer Setup toolset

    • An overview of the Customer Setup toolset
    • Assign by Closest Stores Location
    • Assign By Trade Area
    • Assign Customers By ID
    • Assign Customers by SOLAP Data
    • Create a Customer Layer With Address data
    • Create An Empty Customer Layer
    • Setup Customers Using Existing Data
    • Setup Customers Using Tabular Data
    • Setup Customers Using XY Data
    • Customer Setup toolset concepts

    Modeling toolset

    • An overview of the Business Analyst Modeling toolset
    • Advanced Huff Model
    • Huff Model Calibration By Real Data
    • Huff Model Calibration By Survey Data
    • Original Huff Model
    • Modeling toolset concepts

    Reports toolset

    • An overview of the Business Analyst Reports toolset
    • Average Drive-Time Report
    • Batch Reports
    • Benchmark Report
    • Business Point Reports
    • Customer Demographic Comparison Report
    • Customer Geographic Summary Report
    • Distance Decay Report
    • Export Reports
    • Locator Report
    • Map Layout Report
    • Map Series Report
    • Market Ranking Report
    • Quick Reports
    • Summarize Points Report
    • Wind Rose Report
    • Reports toolset concepts

    Segmentation Analysis toolset

    • An overview of the Segmentation Analysis toolset
    • Core and Developmental Segments Segmentation Report
    • Customer Demographic Profile Report
    • Game Plan Chart
    • Game Plan Map
    • Gap Analysis Report
    • Market Potential Report
    • Market Potential Volume Report
    • Match Level Summary Report
    • MRI Segmentation Report
    • Understanding Market Report
    • Profile Segmentation Report
    • Tapestry Profile with Volume
    • Segmentation Charts
    • Segmentation Penetration Map
    • Target Map
    • Segmentation Analysis toolset concepts

    Segmentation Profiles toolset

    • An overview of the Segmentation Profiles toolset
    • Create Profile by Area Summation
    • Create Profile by Customer Layer
    • Create Profile by Import From Table
    • Create Profile by Table Geocoding
    • Create Profile From Segmentation Coded Table
    • Create Target Group
    • Segmentation Profiles toolset concepts

    Store Setup toolset

    • An overview of the Store Setup toolset
    • Create a Store Layer with Address Data
    • Create An Empty Store Layer
    • Setup Store Using Existing Data
    • Setup Store Using Tabular Data
    • Setup Store Using XY Data
    • Store Setup toolset concepts

    Thematic Maps toolset

    • An overview of the Business Analyst Thematic Maps toolset
    • Symbolize by Chart
    • Symbolize by Dot Density
    • Symbolize by Line Thickness
    • Symbolize by Non-numeric Field
    • Symbolize by Numeric Field
    • Symbolize by Point Size
    • Thematic Maps toolset concepts

    Trade Areas toolset

    • An overview of the Trade Areas toolset
    • Create Trade Area From Geography Levels
    • Create Trade Area From Online Geography Levels
    • Create Trade Area From Sub-geography Layer
    • Customer Derived Trade Areas
    • Data Driven Rings
    • Dissolve By Attribute Range
    • Drive Time
    • Grids
    • Huff's Equal Probability Trade Areas
    • Market Penetration
    • Measure Cannibalization
    • Monitor Trade Area Change
    • Remove Trade Area Overlap
    • Static Rings
    • Thiessen Polygons
    • Threshold Data Driven Ring
    • Threshold Trade Areas
    • Trade Areas toolset concepts

    Setup Customers Using XY Data

    ArcMap 10.8
    |
    Help archive
    ArcGIS Desktop is in mature support and will be retired March 1, 2026. There are no plans for future releases of ArcGIS Desktop, and it is recommended that you migrate to ArcGIS Pro. See Migrate from ArcMap to ArcGIS Pro for more information.

    Available with Business Analyst license.

    • Summary
    • Usage
    • Syntax
    • Code sample
    • Environments
    • Licensing information

    Summary

    Transforms x,y (latitude-longitude) coordinate data into a customer layer.

    Usage

    • This tool allows you to create a customer layer based on x and y columns from an input table.

    • To add a table of x,y coordinates to your map, the table must contain two fields: x-coordinates (longitude) and y-coordinates (latitude).

    • Latitude and longitude coordinates that are in degrees, minutes, seconds (DMS) format must be converted to decimal degrees before using this tool.

    • If using latitude and longitude coordinates, verify that the latitude is a positive integer and the longitude is a negative integer.

    • Many forms of GPS-collected data will contain x,y coordinates. You can use this tool to convert GPS-collected data into customers.

    • If your x,y data is stored in a relational database such as Access, it can be accessed through this tool using the Database Connections wizard in ArcCatalog.

    • This setup tool does not generate a feature class; it generates an x,y event layer.

    Syntax

    arcpy.ba.SetupCustomersByXYData(Table, LatitudeField, LongitudeField, NameField, LinkField, OutputFeatureClass)
    ParameterExplanationData Type
    Table

    The input table used for setting up your customer layer.

    Table View
    LatitudeField

    The field containing your latitude coordinates (Y field).

    Field
    LongitudeField

    The field containing your longitude coordinates (X field).

    Field
    NameField

    The unique identifier for the customer data (commonly the customer name).

    Field
    LinkField

    Unique ID linking the customer file with the store file.

    Field
    OutputFeatureClass

    The feature class that will contain the customer features.

    Feature Class

    Code sample

    SetupCustomersByXYData example (stand-alone script)

    # Name: SetupCustomersByXYData.py
    # Description: Creates a customer layer from latitude longitude coordinates. 
    # 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 the parameters for the Setup Customers Using XY Data tool
      CustPath = "C:/temp/sf_cust.dbf"
      NewFC = "C:/temp/sf_customer.shp"
      Lat = "Latitude"
      Long = "Longitude"
      CustName = "NAME"
      StoreId = "STORE_ID"
     
    # Sets up a new customer layer based on XY data
      arcpy.SetupCustomersByXYData_ba(CustPath,
    	  NewFC,
    	  Lat,
    	  Long,
    	  CustName,
    	  StoreId)
     
    # 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

    • An overview of the Customer Setup toolset

    ArcGIS Desktop

    • Home
    • ArcGIS Pro
    • ArcMap
    • Documentation
    • Support

    ArcGIS

    • ArcGIS Online
    • ArcGIS Desktop
    • ArcGIS Enterprise
    • ArcGIS
    • ArcGIS Developer
    • ArcGIS Solutions
    • ArcGIS Marketplace

    About Esri

    • About Us
    • Careers
    • Esri Blog
    • User Conference
    • Developer Summit
    Esri
    Tell us what you think.
    Copyright © 2022 Esri. | Privacy | Legal