Business Analyst ライセンスで利用できます。
概要
顧客の数または各顧客の数値情報属性に基づいて、店舗の周囲に商圏を作成します。
図
使用法
出力フィーチャクラスの空間参照は、店舗レイヤーと同じになります。
[店舗] および [顧客] は、両方ともポイント フィーチャである必要があります。
加重値として使用する数値情報フィールドを特定するときは、有効な数値を使用する必要があります。
ユーザーが指定した顧客数または集計され重み付けされた数値 (売上高など) に達するまで外側に展開するように商圏境界を設定できます。
店舗と顧客の割り当ては、セットアップ時に設定した共通のユーザー指定の ID によって制御されます。
構文
arcpy.ba.CustomerDerivedTA(in_stores_layer, store_id_field, in_customers_layer, link_field, out_feature_class, method, rings, customer_aggregation_type, {customer_weight_field}, {exclude_outlying_customers}, {cutoff_distance}, {dissolve_option}, {use_customer_centroids}, {distance_type}, {units}, {travel_direction}, {time_of_day}, {time_zone}, {search_tolerance}, {polygon_detail}, {iterations_limit}, {minimum_step}, {target_percent_diff})
パラメーター | 説明 | データ タイプ |
in_stores_layer | 店舗または施設のロケーションを表す入力ポイント レイヤー。 | Feature Layer |
store_id_field | 店舗または施設のロケーションを表す一意の ID。 | Field |
in_customers_layer | 顧客または利用者を表す入力ポイント レイヤー。 | Feature Layer |
link_field | 個別の顧客を店舗に割り当てるために使用される ID。 | Field |
out_feature_class | 出力商圏フィーチャクラス。 | Feature Class |
method | 生成する顧客分布商圏のタイプを指定します。
| String |
rings [rings,...] | 各店舗に割り当てられた顧客 (たとえば、総数) または顧客属性 (たとえば、総売上高) の割合を表す 1 つまたは複数の値。各値は 1 つの商圏ポリゴンを表します。 | Double |
customer_aggregation_type | 集計のタイプを指定します。
| String |
customer_weight_field (オプション) | 商圏の計算に使用されるフィールド。このフィールドは、顧客数、または各顧客に割り当てられた計算済みの加重値のいずれかに基づきます。 | Field |
exclude_outlying_customers (オプション) | 指定範囲外の顧客を商圏作成処理から除外するかどうかを指定します。
| Boolean |
cutoff_distance (オプション) | 範囲外と見なされたため、顧客が商圏作成時に検討から除外される距離。 | Linear Unit |
dissolve_option (オプション) | エリア全体のポリゴンを作成するか、ポリゴンを個別のフィーチャに分割するかを指定します。
| String |
use_customer_centroids (オプション) | 顧客エリアの中心を指定し、その点から外向きに商圏を計算します。
| Boolean |
distance_type (オプション) | 移動方法に基づく距離の計算方法を指定します。 | String |
units (オプション) | 距離の値に使用される単位。 | String |
travel_direction (オプション) | 店舗と顧客の間で使用される移動方向を指定します。
| String |
time_of_day (オプション) | 距離を計算するときに使用される日時。 | Date |
time_zone (オプション) | [時刻] パラメーターに使用されるタイム ゾーンを指定します。
| String |
search_tolerance (オプション) | 入力ポイントが存在する可能性があるネットワークからの最大距離。検索許容値を超える位置にあるポイントは、処理から除外されます。 このパラメーターには、許容値の距離値と単位が必要です。 | Linear Unit |
polygon_detail (オプション) | 出力到達圏ポリゴンに使用される詳細レベルを指定します。
| String |
iterations_limit (オプション) | 最適な限界値制限を見つけるために使用される到達圏の数を制限します。 | Long |
minimum_step (オプション) | 閾値に達するまで展開するために反復の間に使用される最小増加距離または時間で、たとえば 1 マイルまたは 1 分です。 | Double |
target_percent_diff (オプション) | 限界値到達圏を決定する際の目標値と閾値の最大誤差で、たとえば 5% です。デフォルト値は 5 です。 | Double |
コードのサンプル
次の Python ウィンドウ スクリプトは、CustomerDerivedTAツールの使用方法を示しています。
import arcpy
arcpy.ba.CustomerDerivedTA("Facilities", "ID", "Customers", "ID",r"C:\Temp\Output.gdb\TradeArea75pct","DETAILED_WITH_SMOOTHING", [75], "COUNT", None,"ALL_POINTS", None, "OVERLAP", "USE_STORES", '', '',"TOWARD_STORES", None, "TIME_ZONE_AT_LOCATION", None,"STANDARD", 10, None, 5)
ライセンス情報
- Basic: 次のものが必要 Business Analyst
- Standard: 次のものが必要 Business Analyst
- Advanced: 次のものが必要 Business Analyst