ヘルプ

限界値商圏 (Threshold Trade Areas)

サマリ

店舗の周辺にリングを作成します。リングが条件を満たすようになるまで、店舗位置からリングを拡大する方法で、リングの半径を決定します。

図

[限界値商圏 (Threshold Trade Areas)] ツールの例

使用法

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

  • 店舗レイヤーの入力フィーチャクラスは、ポイント フィーチャである必要があります。

  • 多くの場合、店舗レイヤーの入力フィーチャは、Business Analyst の店舗レイヤーになります。

  • 半径の値を定義するときは、有効な数値単位を使用する必要があります。リングの半径として負の値を使用することはできません。

  • すべての店舗を選択すると、リング中心 (店舗) の入力フィーチャクラスの各ポイント フィーチャに対応するリングが作成されます。

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

  • 限界値レイヤーはポイント フィーチャクラスまたはポリゴン フィーチャクラスであること、および Business Analyst データセット (BDS) として設定することが必要です。多くの場合、町丁・字等または基本単位区レイヤーを選択する必要があります。

構文

ThresholdStaticRing_ba (InputFeatureLayer, IDField, All_Or_Single_Or_Selected, ThresholdFeatureLayer, ThresholdPopulationField, {MeasureUnits}, RingsCollection, OutputFeatureClass, {ByID_Or_ByName}, {Single_Site}, {UsedAlghoritm}, {Donut}, {BarrierFeatureClasses}, {UseOnlineData})
パラメータ説明データ タイプ
InputFeatureLayer

リングの中心点を格納する入力フィーチャクラス。多くの場合、これは、Business Analyst の店舗レイヤーになります。

Feature Layer
IDField

リング中心 (店舗) レイヤーの個別値フィールド。

Field
All_Or_Single_Or_Selected

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

  • All —すべてのポイントに対してリングを作成します。
  • Single —単一のポイントに対してリングを作成します。
  • Selected —ArcMap で選択したすべてのポイントに対してリングを作成します。
String
ThresholdFeatureLayer

半径を決定する限界値データを格納する入力フィーチャクラス。

Feature Layer
ThresholdPopulationField

限界値レイヤー内に格納される限界値フィールド。

Field
MeasureUnits
[MeasureUnits,...]
(オプション)

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

  • Minutes
  • Feet
  • Kilometers
  • Meters
  • Miles
  • Nautical Miles
  • Yards
String
RingsCollection
RingsCollection;RingsCollection...

半径の数、および各リングの限界値。

Double
OutputFeatureClass

リング フィーチャが含まれるフィーチャクラス。

Feature Class
ByID_Or_ByName
(オプション)

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

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

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

String
UsedAlghoritm
(オプション)

限界値商圏を生成するために使用される方法。

  • Use Standard Threshold Rings —リング商圏に基づいて限界値商圏を生成します。
  • Use Threshold Drive Times —到達圏商圏に基づいて限界値商圏を生成します。
String
Donut
(オプション)

オーバーラップしない複数の同心リング、つまりドーナツを作成するかどうかを定義します。

  • TRUE —ドーナツ リングである出力ポリゴンを作成します。たとえば、3 つの半径 (1、2、3 マイル) を入力する場合は、0 ～ 1、1 ～ 3、3 ～ 5 マイルのリングを使用して、3 つの出力リングが作成されます。これがデフォルトです。
  • FALSE —同心リングを作成します。
Boolean
BarrierFeatureClasses
[BarrierFeatureClasses,...]
(オプション)

距離の計算に道路時間または道路距離のアルゴリズムを使用するときに、ポイント バリア、ライン バリア、またはポリゴン バリアを配置できます。

Feature Layer
UseOnlineData
(オプション)

オンラインの Business Analyst データにアクセスして解析で使用します。

  • オン - オンラインの Business Analyst データにアクセスできます。
  • オフ - アクセスできるのは、ローカルに保存された Business Analyst データのみです。

オンラインの Business Analyst データにアクセスして、分析に使用します。

  • True —オンラインの Business Analyst データにアクセスできます。
  • False —オフ - アクセスできるのは、ローカルに保存された Business Analyst データのみです。これがデフォルトです。
Boolean

コードのサンプル

ThresholdStaticRing (限界値リング商圏)
# Name: ThresholdStaticRing.py
# Description: Creates 3 thresholds rings around selected stores based on total population.
# Author: Esri

# Import system modules
import arcview
import arcpy

arcpy.AddToolbox("C:\Program Files (x86)\ArcGIS\Desktop10.3\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")
 
try:
# Acquire extension license 
  arcpy.CheckOutExtension("Business") 
   
# Define input and output parameters for the Threshold Trade Areas tool
  StorePath = "C:/temp/sf_stores.shp"
  IdFld = "FID"
  ThresholdLayer = "C:/ArcGIS/Business Analyst/US_2014/Data/Demographic Data/esri_bg.bds"
  FieldThreshold = "TOTPOP_CY"
  OutPath = "C:/temp/ThresholdStaticRings.shp"
   
# Create Threshold Trade Areas
  arcpy.ThresholdStaticRing_ba(StorePath, IdFld, "ALL", ThresholdLayer, FieldThreshold, "100000;200000;300000", OutPath)
 
# Release extension license 
  arcpy.CheckInExtension("Business")
 
except:
  print arcpy.GetMessages(2)

環境

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

ライセンス情報

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

関連トピック

このトピックへのフィードバック