概要
入力レイヤーのフィーチャから指定された距離内にあるフィーチャを検索します。
距離は、直線距離または指定した移動モードで計測できます。統計情報は、次のように、近接フィーチャに対して計算されます。
- 提案されている新しい店舗の場所から運転時間が 5 分以内の総人口を計算する。
- 店舗へのアクセス性の尺度として使用するために、提案された新しい店舗の場所からの走行距離が 1 マイル以内にある高速道路の出入り口の数を計算する。
図
使用法
[近接範囲内での集計] ツールには、距離計測の起点となるレイヤーと集計に使用するレイヤーの 2 つの入力レイヤーが必要です。どちらのレイヤーも、ポイント、ライン、またはエリアにすることができます。最初の入力レイヤーに格納できるフィーチャの数は最大 1,000 です。
近接距離は、1 つの直線距離に基づいて算出するか、時間または距離を計測単位とする複数の異なる移動モードに基づいて算出することができます。移動モードを有効化できるのは、最初の入力レイヤーにポイント フィーチャが含まれている場合に限ります。複数の出力エリアを作成するには、複数の距離または時間を入力します。
一部の移動モードには、交通量を使用するためのオプションがあります。交通量を使用する際、リアルタイムの交通量または指定した曜日および時間の一般的な交通量を使用することができます。リアルタイムの交通量は、現在時刻から最大 12 時間をオフセットすることができます。一般的な交通量の時間は、丸一日を 15 分間隔で設定することができます。
移動モードは、組織の管理者が構成することができます。また、管理者は、新しい移動モードを追加したり、組織に必要のない移動モードを削除したりすることができます。デフォルトの距離計測単位は、マイルまたはキロメートルです。これは、プロファイル内の units の設定によって異なります。
構文
arcpy.sfa.SummarizeNearby(sumNearbyLayer, summaryLayer, outputName, nearType, {distances}, {units}, {timeOfDay}, {timeZoneForTimeOfDay}, {returnBoundaries}, {sumShape}, {shapeUnits}, {summaryFields}, {groupByField}, {minorityMajority}, {percentShape})| パラメーター | 説明 | データ タイプ |
sumNearbyLayer | 入力集計レイヤーでフィーチャまでの距離を計測する際の始点となるポイント、ライン、またはポリゴン フィーチャです。 | Feature Set |
summaryLayer | ポイント、ライン、またはポリゴン フィーチャ。このレイヤー内で、入力近接レイヤーのフィーチャから指定された距離内にあるフィーチャが集計されます。 | Feature Set |
outputName | ポータルに作成する出力レイヤーの名前。 | String |
nearType | 直線距離を使用するか、または移動モードとも呼ばれるさまざまなモードの交通機関を使用した道路ネットワーク沿いの移動時間または移動距離を計測することにより、使用する距離測定方法を定義します。
| String |
distances [distances,...] (オプション) | 検索距離 (直線距離および距離に基づく移動モード) または検索時間 (時間に基づく移動モード) を定義する倍精度小数値のリスト。1 つまたは複数の距離の値を入力できます。入力した距離以内にあるフィーチャが集計されます。距離値の units は、units パラメーターによって提供されます。 | Double |
units (オプション) | 近接タイプが直線または距離ベースの移動モードの場合は、距離で指定された距離値とともに使用される距離単位です。有効なオプションには、メートル、キロメートル、フィート、ヤード、およびマイルがあります。 近接タイプが時間ベースの移動モードの場合は、秒、分、および時間があります。
| String |
timeOfDay (オプション) | 移動時間の計測で交通状況を考慮するかどうかを指定します。解析で交通量を使用する場合は、近接タイプを移動時間ベースのモードに設定する必要があります。時刻の値は、入力ポイントからの移動開始時間または出発時間を表します。 標準またはリアルタイムの 2 種類の交通量がサポートされています。標準の交通量は、1 週間にわたり 5 分間隔で計測した移動速度の履歴上の平均値を参照します。リアルタイム交通量は、実際の移動速度および近い将来の予測速度を記録するために、電話調査の記録、センサー、およびその他のデータ ソースを処理する交通量フィードから、速度を取得します。 タスクが、標準の交通量を使用可能な場所では必ずそれを使用するようにするには、週の時間および曜日を、次の 1990 年の日付のいずれかに設定します。
リアルタイムの交通量が使用可能な時と場所でそれを使用するには、現在の時刻から 12 時間以内の日時を選択します。 過去 12 時間のライブ交通状況データが保存され、未来へ 12 時間延長した予測データが参照されます。指定した日時がこの 24 時間の範囲に含まれない場合や、解析の移動時間が予測データの範囲を超え続ける場合、タスクは標準走行速度の使用に戻ります。 | Date |
timeZoneForTimeOfDay (オプション) | 選択した時刻のタイム ゾーンを 1 つまたは複数指定します。[ローカル時間] (デフォルト) と [UTC] の 2 つのオプションがあります。
| String |
returnBoundaries (オプション) | 入力ジオメトリが返されるか、直線または移動モードのバッファー ジオメトリが返されるかを指定します。
| Boolean |
sumShape (オプション) | 入力集計レイヤーの各ポリゴン内の集計フィーチャのラインの長さやポリゴンの面積など、入力集計フィーチャのシェープに基づいて統計情報を計算します。
| Boolean |
shapeUnits (オプション) | 近傍フィーチャの形状を集計する場合、集計属性の単位を指定します。 入力集計フィーチャがポリゴンの場合、有効なオプションはエーカー、ヘクタール、平方メートル、平方キロメートル、平方フィート、平方ヤード、および平方マイルです。 入力集計フィーチャがラインの場合、有効なオプションはメートル、キロメートル、フィート、ヤード、およびマイルです。
| String |
summaryFields [[Field, Statistic],...] (オプション) | 各ポリゴン内のすべてのポイントについて計算するフィールド名および集計する統計の種類。各ポリゴン内のポイント数が常に返されます。サポートされている統計情報タイプとしては、次のものがあります。
| Value Table |
groupByField (オプション) | これは、一意の属性値ごとに統計情報を個別に計算するために使用できる入力集計フィーチャのフィールドです。たとえば、入力集計フィーチャに危険物を保管している会社の位置ポイントを含み、フィールドの 1 つが、保管されている危険物のタイプを記述したコードを含む HazardClass であるとします。HazardClass の一意の値のそれぞれについて集計を計算するには、そのフィールドをグループ化フィールドとして使用します。 | Field |
minorityMajority (オプション) | これは、[フィールドでグループ化] の使用時のみ適用されます。ADD_MIN_MAJ を指定すると、各境界内の各グループ フィールドの最少頻値属性 (最も少ない値) または最頻値属性 (最も多い値) が計算されます。Majority_ と Minority_ の接頭辞を持つ 2 つの新しいフィールドが出力レイヤーに追加されます。
| Boolean |
percentShape (オプション) | これは、[フィールドでグループ化] の使用時のみ適用されます。オンにすると、各入力近接フィーチャについて、一意の各グループ値のパーセンテージが計算されます。
| Boolean |
派生した出力
| 名前 | 説明 | データ タイプ |
| resultLayer | 出力された集計済みレイヤー。 | フィーチャ セット |
| groupBySummary | [フィールドでグループ化] が指定されると、ツールは、一意のグループごとに計算された統計情報を含むテーブルを出力します。 | レコード セット |
環境
ライセンス情報
- Basic: 次のものが必要 ArcGIS Enterprise のアカウントで [解析の実行] 権限を設定
- Standard: 次のものが必要 ArcGIS Enterprise のアカウントで [解析の実行] 権限を設定
- Advanced: 次のものが必要 ArcGIS Enterprise のアカウントで [解析の実行] 権限を設定