Business Analyst ライセンスで利用できます。
概要
顧客の数または各顧客の数値情報属性に基づいて、店舗の周囲に商圏を作成します。
図
使用法
出力フィーチャクラスの空間参照は、店舗レイヤーと同じになります。
店舗レイヤーおよび顧客レイヤーは、両方ともポイント フィーチャである必要があります。
ほとんどの場合、店舗レイヤーのエリア入力フィーチャ レイヤーは Business Analyst の店舗レイヤーになります。
顧客分布商圏の値を定義する際は、有効な数値を使用する必要があります。負の値は使用できません。
[使用するサイト] パラメーターの [すべてのフィーチャ] を選択すると、店舗レイヤーの各ポイント フィーチャに対して商圏が作成されます。
中抜きのリングにより、バンド形状の出力ポリゴンが作成されます。
店舗の顧客の重心を商圏の中心として使用することは、店舗が顧客エリアの外側にあり、中心点周辺の顧客の密度を表す顧客商圏を確認したい場合に役立ちます。
ArcMap では、有効な分析範囲 (解析範囲) に含まれるフィーチャに対してのみ商圏が作成されます。
構文
arcpy.ba.CustomerDerivedTA(AnalysisType, InputFeatureLayer, IDField, All_Or_Single_Or_Selected, CustomerLayer, LinkField, CustomerWeightField, RingsCollection, OutputFeatureClass, {ByID_Or_ByName}, {Single_Site}, {UseSelectedFeatures}, {ExcludeOutlyingCustomers}, {CutoffDistance}, {MeasureUnits}, {Donut}, {UseCentroids})| パラメーター | 説明 | データ タイプ |
AnalysisType | 生成される顧客分布商圏のタイプ。
| String |
InputFeatureLayer | 商圏の中心点を含む入力フィーチャクラス。多くの場合、これは、Business Analyst の店舗レイヤーになります。 | Feature Layer |
IDField | 商圏の中心 (店舗) レイヤーの一意な ID フィールド。 | String |
All_Or_Single_Or_Selected | 商圏の作成に使用される入力フィーチャ レイヤー内のポイント。
| String |
CustomerLayer | 商圏の生成に必要なポイントおよび属性を含む入力フィーチャクラス。ほとんどの場合、Business Analyst の顧客レイヤーになります。 | Feature Layer |
LinkField | 各顧客に関連付けられた店舗を識別する ID。 | Field |
CustomerWeightField | 商圏の計算に使用されるフィールド。このフィールドは、顧客数、または各顧客に割り当てられた計算済みのウェイト値のいずれかに基づきます。 | Field |
RingsCollection [RingsCollection,...] | 店舗周辺の顧客分布商圏の作成に使用される顧客 (または重み付け) の割合。たとえば、各店舗の顧客の 40%、60%、80% を表す顧客分布商圏を作成できます。 | Double |
OutputFeatureClass | 顧客分布商圏フィーチャが格納されるフィーチャクラス。 | Feature Class |
ByID_Or_ByName (オプション) | 単一のポイントの選択に使用されるフィールド。
| String |
Single_Site (オプション) | 単一のポイントとして使用される店舗の ID または名前。 | String |
UseSelectedFeatures (オプション) | 顧客分布商圏の生成に使用される店舗フィーチャ。
| Boolean |
ExcludeOutlyingCustomers (オプション) | 商圏の計算に使用される顧客のうち、指定した距離を超える顧客を識別します。
| Boolean |
CutoffDistance (オプション) | 各商圏の割合の計算において、顧客を含める各店舗からの距離の決定に使用される数値の距離。 | Double |
MeasureUnits (オプション) | 距離の値として使用される単位。デフォルトでは、Business Analyst の初期設定で定義された単位が選択されます。
| String |
Donut (オプション) | オーバーラップしない複数の同心リング、つまり中抜きのリングを作成します。
| Boolean |
UseCentroids (オプション) | 顧客エリアの中心を特定し、この中心点から外向きに商圏を計算します。
| Boolean |
コードのサンプル
CustomerDerivedTradeAreas (顧客分布商圏) の例 (スタンドアロン スクリプト)
# Name: CustomerDerivedTA.py
# Description: Creates simple polygon based trade areas around San Francisco-based stores based on sales associated with customer data.
# 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")
# Acquire extension license
arcpy.CheckOutExtension("Business")
# Define input and output parameters for the Customer Derived Trade Areas tool
AnalysisType = "DETAILED WITH SMOOTHING"
InputFeatureLayer = "C:/temp/sf_stores.shp"
IDField = "STORE_ID"
All_Or_Single_Or_Selected = "ALL"
CustomerLayer = "C:/temp/sf_cust.shp"
LinkField = "STORE_ID"
CustomerWeightField = "SALES"
RingsCollection = "40;60;80"
OutputFeatureClass = "C:/temp/RingOutput.shp"
#Optional parameters omitted from the function call:
ByID_Or_ByName = "",
Single_Site = "",
UseSelectedFeatures = "false",
ExcludeOutlyingCustomers = "false",
CutoffDistance = "",
MeasureUnits = "Miles",
Donut = "false",
UseCentroids = "false"
# Create detailed customer derived trade areas
arcpy.CustomerDerivedTA_ba(AnalysisType,
InputFeatureLayer,
IDField,
All_Or_Single_Or_Selected,
CustomerLayer,
LinkField,
CustomerWeightField,
RingsCollection,
OutputFeatureClass)
# Release extension license
arcpy.CheckInExtension("Business")
環境
このツールは、ジオプロセシング環境を使用しません。
ライセンス情報
- Basic: 次のものが必要 Business Analyst
- Standard: 次のものが必要 Business Analyst
- Advanced: 次のものが必要 Business Analyst