ArcMap

構成する区画レイヤーから商圏を作成 (Create Trade Area From Sub-geography Layer)

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

概要

定義された境界レイヤーと交差する入力ポリゴン レイヤーのフィーチャから商圏を生成します。

[構成する区画レイヤーから商圏を作成 (Create Trade Area From Sub-geography Layer)] の詳細

使用法

  • 出力フィーチャクラスの空間参照は、境界レイヤーと同じになります。

  • 出力フィーチャクラスは、ポリゴン同士の選択に基づき、境界レイヤーの交差部分を計算します。

  • 区画レイヤーが境界レイヤーと交差しない場合、出力フィーチャクラスは作成されません。

  • 重複の割合を表すフィールドが出力フィーチャクラスに含まれます。このフィールドは、区画レイヤーのフィーチャと境界レイヤーが交差している度合いを表します。

  • ほとんどの場合、境界レイヤーは Business Analyst の商圏になります。このツールを使用して、商圏と交差する郵便番号 (または他の区画レイヤー) を決定できます。

  • ArcMap では、有効な分析範囲 (解析範囲) に含まれるフィーチャに対してのみ商圏が作成されます。

  • [比率を計算] オプションでは、区画と境界レイヤーが交差している割合を付加できます。このツールは、レポート作成用に Business Analyst が商圏へのデータの集計に使用しているのと同じ方法を使用します。

    一般的に、[比率を計算] オプションは、区画が商圏と交差している度合いを決定する必要がある場合に使用されます。これらの割合を取得して、同様の区画を持つ外部データベースに適用することで、商圏内に存在する外部データベースのデータ量を計算できます。たとえば、郵便番号区画別の顧客の数値情報のデータベースを所有しており、これらの顧客のうち 5 分の到達圏内にどれだけの顧客が存在するかを求める必要があるが、このデータベースを Business Analyst の外部で保持しなければならない場合のために、このオプションが用意されています。Business Analyst 内で選択した区画 ID が外部データベースと一致している必要があります。たとえば、郵便番号を区画レイヤーとして選択した場合、外部データベースには正確にデータベースとリンクしている 5 桁の郵便番号 ID が存在する必要があります。

    比率には、以下の 3 つのオプションがあります。

    • すべての比率 - 計算される値には、人口、住戸、世帯、および目標物ポイントの割合が含まれています。
    • 面積のみ - 区画が境界レイヤーと交差している面積の割合のみが計算されます。
    • なし - 割合は計算されません。

構文

arcpy.ba.CreateTAFromSubgeography(InputBoundaryLayer, InputBoundaryLayerIdFieldName, All_Or_Single_Or_Selected, InputSubgeographyLayer, InputSubgeographyLayerIdFieldName, InputSubgeographyLayerNameFieldName, OutputFeatureClass, InputSubgeographyCalcRatiosOption, InputSubgeographySpatialRshipOption, {ByID_Or_ByName}, {Single_Site})
パラメーター説明データ タイプ
InputBoundaryLayer

抽出する区画の定義に使用する入力区画境界レイヤー。

Feature Layer
InputBoundaryLayerIdFieldName

境界レイヤーの一意な ID。

Field
All_Or_Single_Or_Selected

境界レイヤー内のフィーチャに対して商圏を作成します。

  • All —すべてのフィーチャに対して商圏を作成します。
  • Single —単一のフィーチャに対して商圏を作成します。
  • Selected —ArcMap で選択されたすべてのフィーチャに対して商圏を作成します。
String
InputSubgeographyLayer

商圏として抽出するフィーチャを含むレイヤー。ほとんどの場合、Business Analyst のデータ レイヤー (町丁・字等など) になります。

Feature Layer
InputSubgeographyLayerIdFieldName

区画レイヤーの一意な ID フィールド。

Field
InputSubgeographyLayerNameFieldName

区画レイヤーの名前フィールド。

Field
OutputFeatureClass

商圏フィーチャが格納されるフィーチャクラス。

Feature Class
InputSubgeographyCalcRatiosOption

各区画が境界レイヤーと交差している度合いに基づいて割合を生成し、これらの値を区画レイヤーに追加します。

  • All Ratios —計算される値には、人口、住戸、世帯、および目標物ポイントの割合が含まれています。
  • Area Only —区画が境界レイヤーと交差している面積の割合のみが計算されます。
  • None —割合は計算されません。
String
InputSubgeographySpatialRshipOption

境界レイヤーから区画を選択する方法を決定します。

  • Intersect —境界レイヤーと接しているか、交差している区画フィーチャがある場合、これらが出力レイヤーに格納されます。
  • Centroid Within —境界レイヤー内に重心が含まれる区画フィーチャがある場合、これらが出力レイヤーに格納されます。
  • Completely Within —境界レイヤー内に完全に含まれる区画レイヤーのフィーチャのみが出力レイヤーに格納されます。
String
ByID_Or_ByName
(オプション)

単一のフィーチャの選択に使用されるフィールド。

  • ID —ID フィールドを使用して、単一のフィーチャを選択します。
  • Name —名前フィールドを使用して、単一のフィーチャを選択します。
String
Single_Site
(オプション)

単一のフィーチャの選択に使用されるフィーチャの ID または名前。

String

コードのサンプル

CreateTAFromSubgeography (構成する区画レイヤーから商圏を作成) の例 (スタンドアロン スクリプト)

# Name: CreateTAFromSubgeography.py
# Description: The following stand-alone script demonstrates how to use the CreateTAFromSubgeography tool.
# 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 Create Trade Area From Subgeography Layer tool.
# Please note that your paths may be different. 
InputBoundaryLayer = "C:/temp/TradeArea.shp"
InputSubgeographyLayer = "C:/ArcGIS/Business Analyst/US_2022/Data/Demographic Data/BlockGroups_bg.bds"
OutputFeatureClass = "C:/temp/Output_Geography.shp"
InputBoundaryLayerIdFieldName = ""
InputSubgeographyLayerIdFieldName = "" 
InputSubgeographyLayerNameFieldName = ""

# Create Subgeography based trade areas
arcpy.CreateTAFromSubgeography_ba(InputBoundaryLayer,
						InputSubgeographyLayer,
						OutputFeatureClass,
						InputBoundaryLayerIdFieldName,
						InputSubgeographyLayerIdFieldName,
						InputSubgeographyLayerNameFieldName)
    
# Release extension license 
arcpy.CheckInExtension("Business")

環境

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

ライセンス情報

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

関連トピック