限界値到達圏の生成 (Generate Threshold Drive Times) (Business Analyst)

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

サマリー

基準に達するまでポイント フィーチャの周囲に拡大するネットワーク距離商圏のフィーチャクラスを作成します。

使用法

  • 出力ポリゴンのサイズは、Business Analyst データセットの選択済みの [限界値変数] パラメーター値に入力された [限界値] パラメーター値で決定されます。

  • 個々の値を別々の限界値テキスト ボックスに入力して、それぞれの入力の周囲に複数の限界値到達圏ポリゴンを作成できます。

  • [ID フィールド] パラメーターは、周囲に限界値到達圏ポリゴンが作成されるポイント位置を一意に識別します。

パラメーター

ラベル説明データ タイプ
入力フィーチャ

入力ポイント フィーチャ レイヤー。

Feature Layer
出力フィーチャクラス

到達圏ポリゴンが格納される出力フィーチャクラス。

Feature Class
限界値変数

限界値が適用される選択済みの Business Analyst データセット変数。

String
限界値

出力リングのサイズを決定する限界値変数の値。 このリングは、選択された変数の限界値が含まれるまで拡大します。

Double
距離タイプ

出力ポリゴンの作成に使用される移動方法。

String
距離単位
(オプション)

限界値で使用される距離単位。

String
ID フィールド
(オプション)

各入力ポイントを一意に識別し、属性として出力に表示される ID。

Field
移動方向
(オプション)

出力ポリゴンの作成に使用される移動方向を指定します。

  • 店舗へ —移動方向は、顧客から店舗に向けられます。 これがデフォルトです。
  • 店舗から —移動方向は、店舗から顧客に向けられます。
String
時刻
(オプション)

距離を計算するときに使用される日時。

Date
タイム ゾーン
(オプション)

[時刻] パラメーターに使用されるタイム ゾーンを指定します。

  • 位置のタイム ゾーン —テリトリーが含まれているタイム ゾーンが使用されます。 これがデフォルトです。
  • UTC —協定世界時 (UTC) が使用されます。
String
検索許容値
(オプション)

入力ポイントが存在する可能性があるネットワークからの最大距離。

デフォルト値は 5000 メートルです。

Linear Unit
ポリゴンの詳細
(オプション)

出力到達圏ポリゴンに使用される詳細レベルを指定します。

  • 標準 —標準的な詳細レベルのポリゴンを作成します。 これがデフォルトです。
  • 単純化 —結果を早く作成するために、ネットワーク データ ソース内にある階層を使用して、単純化ポリゴンを作成します。
  • 高精度 —正確な結果が重要となるアプリケーションのために、高い詳細レベルのポリゴンを作成します。
String
反復制限
(オプション)

最適な閾値制限を見つけるために使用できる到達圏の数を制限します。

Long
最小ステップ
(オプション)

モデルとなる 1 つの限界値商圏候補とその次の候補の最小距離は、無限の繰り返しを回避するために限界値に近づきます。

Double
限界値パーセント誤差
(オプション)

限界値到達圏を決定する際に使用される目標値と閾値の最大パーセント誤差 (たとえば 5%)。 デフォルト値は 5 です。

Double
入力方法
(オプション)

各到達圏に使用される値のタイプを指定します。

  • 値 —一定の値が使用されます (すべての商圏が同じ大きさになります)。 これがデフォルトです。
  • 式 —フィールドまたは式からの値が使用されます (商圏は異なる大きさにすることができます)。
String
(オプション)

到達圏の計算に使用するフィールドベースの式。

SQL Expression

arcpy.ba.GenerateThresholdDriveTimeTradeArea(in_features, out_feature_class, threshold_variable, threshold_values, distance_type, {units}, {id_field}, {travel_direction}, {time_of_day}, {time_zone}, {search_tolerance}, {polygon_detail}, {iterations_limit}, {minimum_step}, {target_percent_diff}, {input_method}, {expression})
名前説明データ タイプ
in_features

入力ポイント フィーチャ レイヤー。

Feature Layer
out_feature_class

到達圏ポリゴンが格納される出力フィーチャクラス。

Feature Class
threshold_variable

限界値が適用される選択済みの Business Analyst データセット変数。

String
threshold_values
[threshold_values,...]

出力リングのサイズを決定する限界値変数の値。 このリングは、選択された変数の限界値が含まれるまで拡大します。

Double
distance_type

出力ポリゴンの作成に使用される移動方法。

String
units
(オプション)

限界値で使用される距離単位。

String
id_field
(オプション)

各入力ポイントを一意に識別し、属性として出力に表示される ID。

Field
travel_direction
(オプション)

出力ポリゴンの作成に使用される移動方向を指定します。

  • TOWARD_STORES移動方向は、顧客から店舗に向けられます。 これがデフォルトです。
  • AWAY_FROM_STORES移動方向は、店舗から顧客に向けられます。
String
time_of_day
(オプション)

距離を計算するときに使用される日時。

Date
time_zone
(オプション)

[時刻] パラメーターに使用されるタイム ゾーンを指定します。

  • TIME_ZONE_AT_LOCATIONテリトリーが含まれているタイム ゾーンが使用されます。 これがデフォルトです。
  • UTC協定世界時 (UTC) が使用されます。
String
search_tolerance
(オプション)

入力ポイントが存在する可能性があるネットワークからの最大距離。

デフォルト値は 5000 メートルです。

Linear Unit
polygon_detail
(オプション)

出力到達圏ポリゴンに使用される詳細レベルを指定します。

  • STANDARD標準的な詳細レベルのポリゴンを作成します。 これがデフォルトです。
  • GENERALIZED結果を早く作成するために、ネットワーク データ ソース内にある階層を使用して、単純化ポリゴンを作成します。
  • HIGH正確な結果が重要となるアプリケーションのために、高い詳細レベルのポリゴンを作成します。
String
iterations_limit
(オプション)

最適な閾値制限を見つけるために使用できる到達圏の数を制限します。

Long
minimum_step
(オプション)

モデルとなる 1 つの限界値商圏候補とその次の候補の最小距離は、無限の繰り返しを回避するために限界値に近づきます。

Double
target_percent_diff
(オプション)

限界値到達圏を決定する際に使用される目標値と閾値の最大パーセント誤差 (たとえば 5%)。 デフォルト値は 5 です。

Double
input_method
(オプション)

各到達圏に使用される値のタイプを指定します。

  • VALUES一定の値が使用されます (すべての商圏が同じ大きさになります)。 これがデフォルトです。
  • EXPRESSIONフィールドまたは式からの値が使用されます (商圏は異なる大きさにすることができます)。
String
expression
(オプション)

到達圏の計算に使用するフィールドベースの式。

SQL Expression

コードのサンプル

GenerateThresholdDriveTimeTradeArea (限界値到達圏の生成) の例 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、GenerateThresholdDriveTimeTradeArea 関数の使用方法を示しています。

import arcpy
arcpy.ba.GenerateThresholdDriveTimeTradeArea("SF_Custs",r"C:\ Project1\Project1.gdb\SF_Custs_GenerateThresholdDriveTimeTradeArea","populationtotals.totpop_cy",[25000, 50000], "Driving Time","MINUTES", "CUST_ID", None,"TOWARD_STORES", None,"TIME_ZONE_AT_LOCATION", None,"STANDARD", 10, None, 5, Values, None)

関連トピック