レイヤーへの情報付加 (解析ツール)

サマリー

データの位置の周囲または内部にある人々や場所に関する人口統計および地勢要素を追加して、データに情報を付加します。出力は入力を複製したもので、新しい属性フィールドがテーブルに追加されています。このツールには ArcGIS Online 組織アカウントが必要で、クレジットが消費されます。

レガシー:

これは非推奨のツールです。この機能は、情報付加 ツールに置き換えられました。

図

レイヤーへの情報付加ツールの図

使用法

ライセンス:

レイヤーへの情報付加 ツールを使用するには、ArcGIS Online 組織アカウントにログインする必要があります。このツールが正常に実行されるたびに、使用したサービスとサービスから返される結果に基づき、サブスクリプションからサービスクレジットが消費されます。このツールにより消費されるサービスクレジットの推定については、ArcGIS Online のクレジット見積もりツールをご参照ください。

入力フィーチャがポイントやラインのとき、フィーチャの周囲に直線バッファー、運転時間、または歩行時間の領域を設定して、フィーチャに情報を付加するため、情報を付加するエリアの定義 オプション (Python では「buffer_type」オプション) を指定する必要があります。出力フィーチャクラスは入力と同じジオメトリーですが、指定された領域の情報が付加された特性を表します。たとえば、入力がポイントの場合、出力もポイントになりますが、Median household income のような情報付加された出力フィールドは、その特定のポイントの値ではなく、それらのポイントの周囲にある領域を表します。
ツールダイアログボックスから レイヤーへの情報付加 を使用する場合、国、データコレクション、変数のパラメーターを順に入力する必要があります。データコレクションを見るには国を選択する必要があり、変数を見るにはデータコレクションを選択する必要があります。
複数のデータコレクションから変数を選択するには、まず 1 つのコレクションから変数の組を選択します。次に、別のデータコレクションを選択し、新しいコレクションから別の変数の組を選択します。
データコレクションのみ指定し、変数が選択されていない状態でツールを実行すると、コレクション内のすべての変数を取得できます。
このツールは、入力のコピーに新しい属性が追加された、新しい出力フィーチャクラスを作成します。既存のフィーチャのジオメトリーや、属性フィールドおよび値は変更されません。

ラベル	説明	データタイプ
入力フィーチャ	新しいデータを付加するフィーチャ。	Feature Layer
出力フィーチャクラス	出力フィーチャクラスは、入力フィーチャのコピーに新しい属性フィールドが追加されたものです。	Feature Class
国	入力への情報付加に使用するデータコレクションおよび変数が属する国。グローバルの国コードを使用すると、世界中のどこからでも情報付加のデータを取得できます。複数の国に属する入力フィーチャがある場合も、グローバルを使用できます。	String
データコレクション	入力への情報付加に使用するデータのコレクション。変数を選択せずにデータコレクションを指定すると、そのコレクションに含まれるすべての変数を使用してデータに情報を付加できます。グローバル国コードには、KeyGlobalFacts という 1 つのデータコレクションのみが含まれています。	String
変数 (オプション)	入力への情報付加に使用する特定の変数。変数は 1 つまたは複数のデータコレクションから指定できます。	String
情報を付加するエリアの定義 (オプション)	入力フィーチャがポイントの場合は、情報を付加するそれらのポイントの周囲のエリアを次の 7 つのタイプのいずれかから定義する必要があります。入力フィーチャがラインの場合、有効なオプションは直線 (ユークリッド距離) のみです。直線 (ユークリッド距離)—距離の計測方法として、直線またはユークリッド距離が使用されます。運転時間—運転時間が距離測定値として使用されます。運転時間は、現在の道路標識の速度制限、一方通行道路、およびターン規制の影響を受けます。運転距離—運転距離が距離測定値として使用されます。運転距離は、一方通行道路とターン規制の影響を受けます。トラック輸送時間—トラック輸送時間が距離測定値として使用されます。トラック輸送時間は、現在の道路標識の速度制限、一方通行道路、およびターン規制の影響を受けます。このオプションは運転時間と似ていますが、移動はトラックに適した道路でのみ行われます。トラック輸送距離—トラック輸送距離が距離測定値として使用されます。トラック輸送距離は、一方通行道路とターン規制の影響を受けます。このオプションは運転距離と似ていますが、移動はトラックに適した道路でのみ行われます。歩行時間—歩行時間が距離測定値として使用されます。歩行速度 5 KPH (3.1 MPH) を使用して計測が行われます。移動は、山道など、歩行者が通行できる場所で許可されますが、自動車専用道路では許可されません。歩行距離—歩行距離が距離測定値として使用されます。移動は、山道など、歩行者が通行できる場所で許可されますが、自動車専用道路では許可されません。	String
距離または時間 (オプション)	情報を付加するエリアについて、入力フィーチャの周囲の直線距離または運転時間を決定する値。距離または時間の単位を単位パラメーターに指定する必要があります。	Double
ユニット (オプション)	距離または時間パラメーター値に単位を指定します。マイル—マイルヤード—ヤードフィート—フィートキロメートル—キロメートルメートル—メートル時間—時間分—分秒—秒	String

派生した出力

ラベル	説明	データタイプ
ツールの実行に使用する一時データ	ツールの実行に使用する一時データ。	String

arcpy.analysis.EnrichLayer(in_features, out_feature_class, country, data_collection, {variables}, {buffer_type}, {distance}, {unit})

名前	説明	データタイプ
in_features	新しいデータを付加するフィーチャ。	Feature Layer
out_feature_class	出力フィーチャクラスは、入力フィーチャのコピーに新しい属性フィールドが追加されたものです。	Feature Class
country	入力への情報付加に使用するデータコレクションおよび変数が属する国。グローバルの国コードを使用すると、世界中のどこからでも情報付加のデータを取得できます。複数の国に属する入力フィーチャがある場合も、グローバルを使用できます。ツールダイアログボックスで使用される値を指定する (カナダ (CA) など)、または CA など 2 文字の国コードを使うこともできます。	String
data_collection	入力への情報付加に使用するデータのコレクション。変数を選択せずにデータコレクションを指定すると、そのコレクションに含まれるすべての変数を使用してデータに情報を付加できます。グローバル国コードには、KeyGlobalFacts という 1 つのデータコレクションのみが含まれています。医療とパーソナルケア (HealthPersonalCare)などの値を使うことも、コレクション名 HealthPersonalCare を使うこともできます。データコレクションと、その変数の詳細については、Esri Demographics サイトをご参照ください。	String
variables [variables,...] (オプション)	入力への情報付加に使用する特定の変数。変数は 1 つまたは複数のデータコレクションから指定できます。変数は Python リストに入力します。 2013 Total$: 医療 (HealthPersonalCare.THS148) のような値を使うことも、コレクション名と変数名 HealthPersonalCare.THS148 を使うこともできます。データコレクションと、その変数の詳細については、Esri Demographics サイトをご参照ください。	String
buffer_type (オプション)	入力フィーチャがポイントの場合は、情報を付加するそれらのポイントの周囲のエリアを次の 7 つのタイプのいずれかから定義する必要があります。入力フィーチャがラインの場合、有効なオプションは `STRAIGHT_LINE` のみです。 `STRAIGHT_LINE`—距離の計測方法として、直線またはユークリッド距離が使用されます。 `DRIVE_TIME`—運転時間が距離測定値として使用されます。運転時間は、現在の道路標識の速度制限、一方通行道路、およびターン規制の影響を受けます。 `DRIVING_DISTANCE`—運転距離が距離測定値として使用されます。運転距離は、一方通行道路とターン規制の影響を受けます。 `TRUCKING_TIME`—トラック輸送時間が距離測定値として使用されます。トラック輸送時間は、現在の道路標識の速度制限、一方通行道路、およびターン規制の影響を受けます。このオプションは運転時間と似ていますが、移動はトラックに適した道路でのみ行われます。 `TRUCKING_DISTANCE`—トラック輸送距離が距離測定値として使用されます。トラック輸送距離は、一方通行道路とターン規制の影響を受けます。このオプションは運転距離と似ていますが、移動はトラックに適した道路でのみ行われます。 `WALKING_TIME`—歩行時間が距離測定値として使用されます。歩行速度 5 KPH (3.1 MPH) を使用して計測が行われます。移動は、山道など、歩行者が通行できる場所で許可されますが、自動車専用道路では許可されません。 `WALKING_DISTANCE`—歩行距離が距離測定値として使用されます。移動は、山道など、歩行者が通行できる場所で許可されますが、自動車専用道路では許可されません。	String
distance (オプション)	情報を付加するエリアについて、入力フィーチャの周囲の直線距離または運転時間を決定する値。距離または時間の単位を `unit` パラメーターに指定する必要があります。	Double
unit (オプション)	`distance` パラメーター値に単位を指定します。 `MILES`—マイル `YARDS`—ヤード `FEET`—フィート `KILOMETERS`—キロメートル `METERS`—メートル `HOURS`—時間 `MINUTES`—分 `SECONDS`—秒	String

派生した出力

名前	説明	データタイプ
CollectionMemory	ツールの実行に使用する一時データ。	String

コードのサンプル

EnrichLayer の例 1 (Python ウィンドウ)

次の Python ウィンドウスクリプトは、指定されたデータコレクションのみで EnrichLayer 関数を使用する方法を示しています。

import arcpy
arcpy.analysis.EnrichLayer("Cities.shp", "C:/output/Cities_enriched.shp", "US",
                           "Age", "", "STRAIGHT_LINE", "3", "MILES")

EnrichLayer の例 2 (Python ウィンドウ)

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

import arcpy
arcpy.analysis.EnrichLayer("Cities.shp", "C:/output/Cities_enriched.shp", "US",
                           "Age", ["Age.FEM20", "Age.FEM25"], "DRIVE_TIME",
                           "30", "MINUTES")

EnrichLayer の例 3 (スタンドアロンスクリプト)

提案された多くの複合用途開発地から、運転時間で 10 分の範囲内の人口を調べます。

import arcpy

# Set environments
arcpy.env.workspace = "c:/data"

# Select a vacant site that is within 0.5 miles of existing restaurants and bars
businesses = "City_businesses.shp"
vacantSites = "Vacant.shp"
arcpy.management.MakeFeatureLayer(businesses, "Restaurants_layer")
arcpy.management.MakeFeatureLayer(vacantSites, "Vacant_Sites_layer")

whereClause = "'SIC2' In (56,57,58)"
arcpy.management.SelectLayerByAttribute("Restaurants_layer", "NEW_SELECTION",
                                        whereClause)

arcpy.management.SelectLayerByLocation("Vacant_Sites_layer", "WITHIN_A_DISTANCE",
                                       "Restaurants_layer", "0.5 Miles")

# Get the population within 10 minutes to determine which site to pick
arcpy.analysis.EnrichLayer("Vacant_Sites_layer", "Enriched_Vacant_Sites.shp",
                           "US", "KeyUSFacts", ["KeyUSFacts.TOTPOP_CY"],
                           "DRIVE_TIME", "10", "MINUTES")

環境

範囲, 出力座標系, 現在のワークスペース, スクラッチワークスペース, 出力データに Z 値を含む, 出力データのデフォルト Z 値, 地理座標系変換, 出力データの XY ドメイン, 出力データの Z ドメイン, XY 座標精度, XY 許容値, Z 座標精度, Z 許容値

ライセンス情報

Basic: はい
Standard: はい
Advanced: はい