ArcMap

距離商圏内占有率レポート (Distance Decay Report)

Business Analyst ライセンスで利用できます。

概要

店舗周辺の複数のリングまたは到達圏ポリゴンの市場占有率を計算します。

使用法

  • [市場総数の計算方法] を決定する際、[区画レベルを使用して計算] オプションを使用すると、解析レイヤー設定ユーティリティを使用して設定された任意のポリゴン レイヤーを選択できます。

  • [市場総数の計算方法] パラメーターで [レイヤー内のフィールドを使用] オプションを選択した場合、[市場総数フィールド] パラメーターが利用できます。

  • 基本的に、距離商圏は、単純な重み付けされたエリアと違いはありません。Business Analyst の距離減衰機能には、店舗への距離が増すにつれて店舗へ訪れる傾向が減るという距離減衰の地理的な原則に基づいて、これらのエリアを作成する機能が備わっています。

  • 距離商圏は、店舗周辺の複数のリングまたは到達圏ポリゴンの市場占有率を計算します。

  • [距離商圏内占有率レポート (Distance Decay Report)] は、顧客が店舗を訪れる距離を人口などの基準値と比較した結果を表示します。

  • 顧客の割り当てがすでに生成されている店舗レイヤーおよび顧客レイヤーを用意する必要があります。

構文

arcpy.ba.DistanceDecayReport(InputFeatureLayer, IDField, All_Or_Single_Or_Selected, RingsType, RingsCollection, {MeasureUnits}, CustomerLayer, MarketPenetrationTMCType, ReportTitle, MarketPenetrationReportDirectory, {ByID_Or_ByName}, {Single_Site}, {Donut}, {RemoveOverlap}, {BorderShape}, IN_MP_STORE_ID, {UseSelectedCustomers}, {CustomerWeightField}, {IN_CL_STORE_ID}, MarketPenetrationTMCField, InputGeographyLevel, MarketPenetrationTMCSummarization, {ReportFormats}, {CreateReport}, {BarrierFeatureClasses})
パラメーター説明データ タイプ
InputFeatureLayer

レポートで使用する中心点を含む入力フィーチャクラス。多くの場合、これは、Business Analyst の店舗レイヤーになります。

Feature Layer
IDField

店舗レイヤー内の [個別値] フィールド。

Field
All_Or_Single_Or_Selected

入力フィーチャ レイヤー内のポイントに対して商圏を作成します。

  • ALL —すべてのポイントに対して商圏を作成します。
  • SINGLE —単一のポイントに対して商圏を作成します。
  • SELECTED —ArcMap で選択したポイントに対して商圏を作成します。
String
RingsType

商圏の生成方法を決定します。

  • Simple Ring Areas —店舗レイヤーの中心点に基づいた 1 つまたは複数のリング商圏を生成します。
  • Drive Time Areas —店舗レイヤーの中心点に基づいた 1 つまたは複数の到達圏ポリゴンを生成します。
String
RingsCollection
[RingsCollection,...]

入力フィーチャ周辺の商圏の作成に使用される距離をサイズの昇順で指定します。

Double
MeasureUnits
(オプション)

距離の値として使用される単位。デフォルトでは、Business Analyst の初期設定で定義された単位が選択されます。

  • Decimal Degrees
  • Feet
  • Kilometers
  • Meters
  • Miles —これがデフォルトです。
  • Nautical Miles
  • Yards
String
CustomerLayer

顧客分布に使用されるポイントを含む入力フィーチャクラス。ほとんどの場合、Business Analyst の顧客レイヤーになります。

Feature Layer
MarketPenetrationTMCType

市場数の計算に使用する場所を決定します。

  • In the layer attribute table —標準でない区画に基づいて市場占有率を計算します。
  • Calculate using Geography Level —標準の区画レイヤーに基づいて市場占有率を計算します。
  • Calculate Using Business Analyst Online Data —Business Analyst Online データに基づいて市場占有率を計算します。
String
ReportTitle

レポートのタイトル。

String
MarketPenetrationReportDirectory

レポートが保存される出力ディレクトリ。

Folder
ByID_Or_ByName
(オプション)

単一のポイントの選択に使用されるフィールド。

  • ID —店舗 ID フィールドを使用して単一のポイントを選択します。
  • Name —店舗名フィールドを使用して単一のポイントを選択します。
String
Single_Site
(オプション)

単一のポイントとして使用される店舗の ID または名前。

String
Donut
(オプション)

重なりがない同心リングまたはドーナツを作成します。

  • True —同心リングを作成します。これがデフォルトのオプションです。
  • False —ドーナツ リングである出力ポリゴンを作成します。たとえば、3 つの半径 (1、2、および 3 マイル) を入力すると、0 ～ 1、1 ～ 3、および 3 ～ 5 マイルの 3 つの出力リングが作成されます。
Boolean
RemoveOverlap
(オプション)

2 つの隣接するポリゴン間に等距離のラインを描画するティーセン アプローチを使用して、オーバーラップを除去します。

  • True —商圏間のオーバーラップを除去します。
  • False —商圏間のオーバーラップを除去しません。これがデフォルトです。
Boolean
BorderShape
(オプション)

運転中に到達できないエリアを無視する詳細な境界を作成します。

  • True —商圏周辺の詳細な境界を生成します。
  • False —商圏周辺の詳細な境界を生成しません。これがデフォルトです。
Boolean
IN_MP_STORE_ID

市場占有率の計算に使用するレイヤーに基づく一意な ID フィールド。この店舗 ID は市場占有率レイヤーに含まれるフィールドです。

Field
UseSelectedCustomers
(オプション)

選択されたフィーチャを使用して、距離商圏内占有率レポートを生成します。

  • True —選択されたフィーチャに関する距離商圏内占有率レポートを生成します。
  • False —すべてのフィーチャに関する距離商圏内占有率レポートを生成します。これがデフォルトです。
Boolean
CustomerWeightField
(オプション)

商圏の重み付けに使用される顧客レイヤーの属性を定義します。

Field
IN_CL_STORE_ID
(オプション)

各店舗に関連付けられる顧客の識別に使用する店舗 ID フィールド。この店舗 ID は顧客レイヤーに含まれるフィールドです。

Field
MarketPenetrationTMCField

市場占有率の計算に使用される市場占有率レイヤーのベースとなる市場総数を含むフィールド。

String
InputGeographyLevel

市場総数を含む区画レベルを選択します。

Feature Layer
MarketPenetrationTMCSummarization

区画レベルから選択された市場総数で使用される変数を含む属性フィールド。

String
ReportFormats
[ReportFormats,...]
(オプション)

目的のレポート出力形式を選択します。

  • Simple XML
  • PDF
  • HTML
  • CSV
  • ZIP
  • XLSX
  • Stripped XLSX
String
CreateReport
(オプション)

レポートを生成します。

  • True —ポイント集計レポート (Summarize Points Report) を生成します。これがデフォルトです。
  • False —ポイント集計レポート (Summarize Points Report) を生成しません。
Boolean
BarrierFeatureClasses
[BarrierFeatureClasses,...]
(オプション)

距離の計算に道路時間または道路距離が使用される場合に使用するポイント バリア、ライン バリア、またはポリゴン バリア。

Feature Layer

コードのサンプル

DistanceDecayReport (距離商圏内占有率レポート) の例 (スタンドアロン スクリプト)

# 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(r"C:\Program Files (x86)\ArcGIS\Desktop10.8\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_2022/Data/Demographic Data/BlockGroups_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")

環境

このツールは、ジオプロセシング環境を使用しません。

ライセンス情報

  • Basic: 次のものが必要 Business Analyst
  • Standard: 次のものが必要 Business Analyst
  • Advanced: 次のものが必要 Business Analyst

関連トピック