区画レベルから商圏を作成 (Create Trade Area From Geography Levels) (Business Analyst)—ArcMap

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

概要
使用法
構文
コードのサンプル
環境
ライセンス情報

概要

標準の区画単位に基づいて商圏を作成します。

[区画レベルから商圏を作成 (Create Trade Area From Geography Levels)] の詳細

使用法

出力フィーチャクラスの空間参照は、入力区画境界レイヤーと同じになります。
[出力フィーチャクラスにテーブル属性を追加します] オプションを使用して、Esri データセットの人口統計データを商圏の出力に含めます。
[一致する区画 ID を含むテーブル] は、ArcMap と互換性のある形式にする必要があります。表形式データは、データベースファイル (*.dbf)、カンマ区切りまたはタブ区切りのテキストファイル (*.txt)、またはリレーショナルデータベース管理システム (RDBMS) の形式にすることができます。
一致しない境界は、商圏の出力からすべて除外されます。
一致しない境界とは、照合する区画 ID が格納されたテーブル内の無効な境界レコードであり、入力区画境界レイヤー内に対応するフィーチャが存在しないものです。
使用可能な地理フィーチャのリストから選択して分析範囲を作成する場合、ArcMap の [商圏] ウィザードを使用できます。地理フィーチャの選択は、ジオプロセシングツールとしては使用できません。
ArcMap では、有効な分析範囲 (解析範囲) に含まれるフィーチャに対してのみ商圏が作成されます。

構文

arcpy.ba.CreateTAFromGeographyLevels(InputGeographyLevelLayer, InputGeographyLevelIdField, InputGeographyUnitsTable, InputGeographyUnitsIdField, InputHandleDuplicateBehavior, OutputFeatureClass, {InputAppendVisibleFields}, {InputGeographyUnitsStoreIdField}, {Dissolve})

パラメーター	説明	データタイプ
InputGeographyLevelLayer	商圏の抽出に使用される入力フィーチャクラス。	Feature Layer
InputGeographyLevelIdField	入力区画レイヤーの一意の ID。	Field
InputGeographyUnitsTable	商圏を定義する標準の地理単位の選択に使用される入力テーブル。	Table View
InputGeographyUnitsIdField	入力区画境界レイヤーからの区画単位の選択に使用される、関連する区画 ID フィールド。	Field
InputHandleDuplicateBehavior	テーブル内の、照合する区画 ID が格納されたテーブル内の重複するフィールドを、フィルタリングできます。 "SUMMARIZE_FIELD" —区画境界のフィールドを出力フィーチャクラスに追加するオプションを選択して、このオプションを指定すると、重複するレコードが存在する場合に、重複するフィールドが集約されます。 "USE_FIRST_FEATURE" —このオプションを指定すると、重複するレコードが存在する場合に、テーブル内の最初のレコードが選択されます。そのレコードに関連付けられた任意の表形式データを、出力フィーチャクラスに追加できます。このオプションを指定すると、最初のレコードのデータのみが追加され、それ以外のレコードはすべて無視されます。	String
OutputFeatureClass	商圏フィーチャが格納されるフィーチャクラス。	Feature Class
InputAppendVisibleFields (オプション)	区画境界のフィールドを出力フィーチャクラスに追加します。 TRUE —フィールドを出力フィーチャクラスに追加します。 FALSE —フィールドを出力フィーチャクラスに追加しません。これがデフォルトです。	Boolean
InputGeographyUnitsStoreIdField (オプション)	このフィールドによって、同じ標準の区画単位を複数の店舗に割り当てます。	Field
Dissolve (オプション)	このオプションは、選択した店舗 ID に基づいて出力をディゾルブします。 TRUE —選択した店舗 ID に基づいて境界をディゾルブします。 FALSE —境界をディゾルブしません。これがデフォルトです。	Boolean

コードのサンプル

CreateTAFromGeographyLevels (区画レベルから商圏を作成) の例 (スタンドアロンスクリプト)

# Name: CreateTAFromGeographyLevels.py
# Description: The following stand-alone script demonstrates how to use the CreateTAFromGeographyLevels 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 Geography Levels tool.
# Please note that your paths may be different. 
InputGeographyLevelLayer="C:/ArcGIS/Business Analyst/US_2022/Data/Demographic Data/USA_ESRI_2018.gdb/ZIPCodes_zp" 
InputGeographyLevelIdField="ID"
InputGeographyUnitsTable="C:/ArcGIS/Business Analyst/US_2022/Datasets/Tutorial/sf_custs.dbf"
InputGeographyUnitsIdField="ZIP"
InputHandleDuplicateBehavior="USE_FIRST_FEATURE"
OutputFeatureClass= "C:/temp/CreateTA.shp", 
InputAppendVisibleFields="true"
InputGeographyUnitsStoreIdField="STORE_ID", 
Dissolve="TRUE"

# Create standard geography based trade areas
arcpy.CreateTAFromGeographyLevels_ba(InputGeographyLevelLayer,
						InputGeographyLevelIdField,
						InputGeographyUnitsTable,
						InputGeographyUnitsIdField,
						OutputFeatureClass,
						InputAppendVisibleFields,
						InputGeographyUnitsStoreIdField,
						Dissolve)
    
# Release extension license 
arcpy.CheckInExtension("Business")

環境

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

ライセンス情報

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

概要

使用法

構文

コードのサンプル

環境

ライセンス情報

関連トピック