距離商圏内占有率レポート（Distance Decay Report） (Business Analyst)
サマリ
店舗周辺の複数のリングまたは到達圏ポリゴンの市場占有率を計算します。
使用法
-
[市場総数の計算方法] を決定する際、[区画レベルを使用して計算] オプションを使用すると、解析レイヤ設定ユーティリティを使用して設定された任意のポリゴン レイヤを選択できます。
-
[市場総数の計算方法] パラメータで [レイヤ内のフィールドを使用] オプションを選択した場合、[市場総数フィールド] パラメータが利用できます。
-
基本的に、距離商圏は、単純な重み付けされたエリアと違いはありません。Business Analyst の [距離商圏内占有率] 機能には、店舗までの距離が長くなるにつれて、店舗を訪れる傾向が低くなるという地理的原理に基づいて商圏を作成するメカニズムが組み込まれています。
-
距離商圏は、店舗周辺の複数のリングまたは到達圏ポリゴンの市場占有率を計算します。
-
[距離商圏内占有率レポート（Distance Decay Report）] は、顧客が店舗を訪れる距離を人口などの基準値と比較した結果を表示します。
-
顧客の割り当てがすでに生成されている店舗レイヤおよび顧客レイヤを用意する必要があります。
構文
| パラメータ | 説明 | データ タイプ |
InputFeatureLayer |
レポートで使用する中心点を含む入力フィーチャクラス。多くの場合、これは、Business Analyst の店舗レイヤになります。 | Feature Layer |
IDField |
店舗レイヤ内の [個別値] フィールド。 | Field |
All_Or_Single_Or_Selected |
入力フィーチャ レイヤ内のポイントに対して商圏を作成します。
| String |
RingsType |
商圏の生成方法を決定します。
| String |
RingsCollection [RingsCollection,...] |
入力フィーチャ周辺の商圏の作成に使用される距離をサイズの昇順で指定します。 | Double |
MeasureUnits (オプション) |
距離値で使用される単位。デフォルトでは、Business Analyst の初期設定で指定された単位が選択されます。
| String |
CustomerLayer |
顧客分布に使用されるポイントを含む入力フィーチャクラス。ほとんどの場合、Business Analyst の顧客レイヤになります。 | Feature Layer |
MarketPenetrationTMCType |
市場数の計算に使用する場所を決定します。
| String |
MarketPenetrationTMCField |
市場占有率の計算に使用される市場占有率レイヤのベースとなる市場総数を含むフィールド。 | String |
InputGeographyLevel |
市場総数を含む区画レベルを選択します。 | Feature Layer |
MarketPenetrationTMCSummarization |
区画レベルから選択された市場総数で使用される変数を含む属性フィールド。 | String |
ReportTitle |
レポートのタイトル。 | String |
MarketPenetrationReportDirectory |
レポートが保存される出力ディレクトリ。 | Folder |
ByID_Or_ByName (オプション) |
単一のポイントの選択に使用されるフィールド。
| String |
Single_Site (オプション) |
単一のポイントとして使用される店舗の ID または名前。 | String |
Donut (オプション) |
重なりがない同心リングまたはドーナツを作成します。
| Boolean |
RemoveOverlap (オプション) |
2 つの隣接するポリゴン間に等距離のラインを描画するティーセン アプローチを使用して、オーバーラップを除去します。
| Boolean |
BorderShape (オプション) |
運転中に到達できないエリアを無視する詳細な境界を作成します。
| Boolean |
IN_MP_STORE_ID |
市場占有率の計算に使用するレイヤに基づく一意な ID フィールド。この店舗 ID は市場占有率レイヤに含まれるフィールドです。 | Field |
UseSelectedCustomers (オプション) |
選択されたフィーチャを使用して、距離商圏内占有率レポートを生成します。
| Boolean |
CustomerWeightField (オプション) |
商圏の重み付けに使用される顧客レイヤの属性を定義します。 | Field |
IN_CL_STORE_ID (オプション) |
各店舗に関連付けられる顧客の識別に使用する店舗 ID フィールド。この店舗 ID は顧客レイヤに含まれるフィールドです。 | Field |
ReportFormats;ReportFormats... [ReportFormats;ReportFormats...,...] (オプション) |
目的のレポート出力形式を選択します。
| String |
BarrierFeatureClasses [BarrierFeatureClasses,...] (オプション) |
距離の計算に道路時間または道路距離が使用される場合に使用するポイント バリア、ライン バリア、またはポリゴン バリア。 | Feature Layer |
コードのサンプル
# Name: DistanceDecayReport.py
# Description: Calculates the market penetration in San Francisco based on a series of simple ring trade areas comparing the sales in each ring to the total population.
# 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")
# Define input and output parameters for the Distance Decay Report tool
Store = "C:/temp/sf_stores.shp"
Cust = "C:/temp/sf_cust.shp"
Id = "STORE_ID"
MarketPen = "C:/Temp/Decay/MpLayer.shp"
Method = "Calculate using Geography Level"
Weight = "SALES"
Data = "C:/ArcGIS/Business Analyst/US_2013/Data/BDS/esri_bg.bds"
Var = "TOTPOP_CY"
Output = "C:/temp/DecayReport2"
# Create Distance Decay reports
arcpy.DistanceDecayReport_ba(Store, Id, "ALL", 'Simple Ring Areas', "1;2;3", "Miles", Cust, Method, Weight, Data, Var, "Ring Penetration", Output, "#", "#", "false", "false","false", "#", "false", "#", "#",sMarketPen)
# Release extension license
arcpy.CheckInExtension("Business")
except:
print arcpy.GetMessages(2)