ロケーション フィールドの計算（Calculate Locations） (Network Analyst)
サマリ
フィーチャのネットワーク ロケーションが含まれている入力フィーチャにフィールドを追加します。このツールは、フィーチャをネットワーク解析レイヤの入力としてすばやく読み込むために、ネットワーク ロケーション情報をフィーチャ属性として格納するのに使用されます。
使用法
-
このツールは [ロケーションの追加（Add Locations）] ツールへの入力となるロケーション フィールドを計算するために使用します。ネットワーク解析レイヤの入力として複数回使用されるフィーチャに使用します。一度ロケーションが計算されると、フィーチャをネットワーク ロケーションとしてすばやく読み込むために [ロケーションの追加（Add Locations）] の [ジオメトリの代わりにネットワーク ロケーション フィールドを使用する] パラメータを使用することができます。
-
このツールではさまざまな検索オプションを使用して、ネットワーク解析レイヤで未配置のネットワーク ロケーションの再計算にも使用することができます。たとえば、最初に 500 メートルの検索許容値でルート ネットワーク解析レイヤ上にストップが追加され、いくつかのストップが未配置である場合、たとえば [属性検索（Select Layer By Attribute）] ツールを使用して、検索許容値を広げた形で [入力フィーチャ] にストップのサブレイヤを指定して、このツールを再実行します。
-
ネットワーク データセットのネットワーク ソースとして使用されるフィーチャクラスが有効かつ最新の空間インデックスを保持している場合、このツールは非常に高速に実行されます。
構文
| パラメータ | 説明 | データ タイプ |
in_point_features |
ネットワーク ロケーションを計算する対象となる入力フィーチャ。 ラインおよびポリゴン フィーチャは、ネットワーク ロケーション情報が BLOB フィールド（[Locations] 範囲フィールド パラメータで指定される）に保存されているため、ジオデータベース フィーチャクラスのみでサポートされています。 | Table View |
in_network_dataset |
ロケーションを計算するために使用するネットワーク データセット。 入力フィーチャに、ネットワーク解析レイヤのサブレイヤを指定した場合、ネットワーク解析レイヤが参照するネットワーク データセットのパラメータが設定されます。 | Network Dataset Layer |
search_tolerance |
入力フィーチャをネットワークに配置する際の検索許容値。検索許容値の外側にあるフィーチャは配置されません。パラメータには許容値の値と単位が含まれます。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメータは使用しません。この場合、「#」をパラメータ値として使用します。 | Linear unit |
search_criteria [[Source, SnapType],...] |
ロケーション検索時に検索するネットワーク データセットのソースと、使用するジオメトリの部分（スナップ タイプとも呼ばれます）を指定します。 パラメータ値は、ネストされたリストとともにリストとして指定されます。ネストしたリストは各ネットワーク ソースの名前とスナップ タイプを示す 2 つの値で構成されます。スナップ タイプは SHAPE、MIDDLE、END、NONE キーワードを使用して指定されます。
1 つのネットワーク ソースに複数のスナップ タイプを指定するには、アンダースコアで区切ったスナップ タイプ キーワードの組み合わせを使用します。たとえば、MIDDLE_END はロケーションがネットワーク ソースの中間または端点にスナップされることを示します。 ジオデータベースのネットワーク データセットでは、ネットワーク ソースの各サブタイプにスナップ タイプを指定することができます。 ラインまたはポリゴン フィーチャのロケーションを計算する際、他のスナップタイプが指定されていても形状スナップタイプのみが使用されます。 このリストに入っていないネットワーク ソースでは、デフォルト スナップ タイプが使用されます。すべてのネットワーク ソースをリストに入れ、ネットワーク ソースごとにスナップ タイプを明示的に設定することが最も安全な方法です。 | Value Table |
match_type (オプション) |
ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメータは使用しません。この場合、「#」をパラメータ値として使用します。 | Boolean |
source_ID_field (オプション) |
計算されたネットワーク ロケーションのソース ID を新規作成または更新するフィールド名。「SourceID」という名前のフィールドがデフォルトで作成または更新されます。SourceID という名前のフィールドがデフォルトで作成または更新されます。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメータは使用しません。この場合、「#」をパラメータ値として使用します。 | Field |
source_OID_field (オプション) |
計算されたネットワーク ロケーションの割合を新規作成または更新するフィールド名。SourceOID という名前のフィールドがデフォルトで作成または更新されます。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメータは使用しません。この場合、「#」をパラメータ値として使用します。 | Field |
position_field (オプション) |
計算されたネットワーク ロケーションのパーセンテージによって作成または更新されるフィールド名。PosAlong という名前のフィールドがデフォルトで作成または更新されます。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメータは使用しません。この場合、「#」をパラメータ値として使用します。 | Field |
side_field (オプション) |
ポイント フィーチャが計算されたネットワーク ロケーションのエッジのどちら側に位置しているかを新規作成または更新するフィールド名。SideOfEdge という名前のフィールドがデフォルトで作成または更新されます。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメータは使用しません。この場合、「#」をパラメータ値として使用します。 | Field |
snap_X_field (オプション) |
計算されたネットワーク ロケーションの X 座標を新規作成または更新するフィールド名。SnapX という名前のフィールドがデフォルトで作成または更新されます。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメータは使用しません。この場合、「#」をパラメータ値として使用します。 | Field |
snap_Y_field (オプション) |
計算されたネットワーク ロケーションの Y 座標を新規作成または更新するフィールド名。SnapY という名前のフィールドがデフォルトで作成または更新されます。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメータは使用しません。この場合、「#」をパラメータ値として使用します。 | Field |
distance_field (オプション) |
計算されたネットワーク ロケーションからのポイント フィーチャの距離を作成または更新するフィールド名。Distance という名前のフィールドがデフォルトで作成または更新されます。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメータは使用しません。この場合、「#」をパラメータ値として使用します。 | Field |
snap_Z_field (オプション) |
計算されたネットワーク ロケーションの Z 座標を新規作成または更新するフィールド名。SnapZ という名前のフィールドがデフォルトで作成または更新されます。 ラインまたはポリゴン フィーチャのロケーションを計算する際には、パラメータは使用しません。この場合、「#」をパラメータ値として使用します。 ポイント フィーチャのロケーションを計算する際、パラメータは入力データセットがネットワーク ソースの Z 座標値に基づいた接続性をサポートするときにのみ使用されます。その他の場合はすべて、「#」をパラメータ値として使用します。 | Field |
location_field (オプション) |
ラインまたはポリゴン フィーチャの計算されたネットワーク ロケーションにおけるロケーション範囲を新規作成または更新するフィールド名。Locations という名前のフィールドがデフォルトで作成または更新されます。 パラメータは、ラインまたはポリゴン フィーチャのロケーションを計算するときのみ使用されます。入力ポイント フィーチャには、「#」をパラメータ値として使用します。 | Field |
exclude_restricted_elements (オプション) |
このパラメータは、入力フィーチャがネットワーク解析レイヤのサブレイヤに属し、バリア オブジェクトでないときにのみ適用されます。その他の場合はすべて、「#」をパラメータ値として使用します。
| Boolean |
search_query [[Source, Expression],...] (オプション) |
検索をソース フィーチャクラス内のフィーチャのサブセットに制限するクエリを定義します。この機能は、ネットワーク ロケーションとして適切でないフィーチャを検索したくない場合に有用です。たとえば、ポリゴンの重心を読み込む場合に、生活道路に配置したくない場合は、一般道路のみを検索するクエリを定義できます。 パラメータ値は、ネストされたリストとともにリストとして指定されます。ネストしたリストはすべてのネットワーク ソースの名前と SQL 式を示す 2 つの値で構成されます。SQL 式の構文はネットワーク ソース フィーチャクラスのタイプによって少し異なります。たとえば、クエリ対象がファイル ジオデータベース、ArcSDE ジオデータベース、シェープファイル、または SDC に格納されたソース フィーチャクラスの場合は、フィールド名を二重引用符で囲みます（「"CFCC"」）。クエリ対象がパーソナル ジオデータベースの場合は、フィールドを角括弧で囲みます（「[CFCC]」）。 特定のソースに対してクエリを定義したくない場合、SQL 式に値として「"#"」を入力するか、またはパラメータ値からソース名と SQL 式を除外します。すべてのネットワーク ソースに対してクエリを定義したくない場合、パラメータ値として「"#"」を入力します。 たとえば、パラメータ値「[["Streets","\"CFCC\" = 'A15'"], ["Streets_ND_Junctions",""]]」では、Streets ソース フィーチャクラスに対する SQL 式を定義し、Streets_ND_Junctions ソース フィーチャクラスには SQL 式を定義しません。フィールド名 CFCC を囲むために使用される二重引用符は、Python インタープリタで構文解析エラーが発生しないようにバック スラッシュ文字でエスケープされます。 | Value Table |
コードのサンプル
必須パラメータのみを使用して、ポイント フィーチャのロケーション フィールドを計算します。
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Network Analyst/Tutorial/SanFrancisco.gdb"
arcpy.na.CalculateLocations("Analysis/Stores","Transportation/Streets_ND",
"5000 Meters",[["Streets","SHAPE"],
["Streets_ND_Junctions","NONE"]])
ネットワーク ソースのサブタイプ上のポイント フィーチャのロケーション フィールドを計算します。
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Network Analyst/Tutorial/Paris.gdb"
arcpy.na.CalculateLocations(
"Analysis/Warehouses","Transportation/ParisNet","5000 Meters",
[["Streets : Highways","NONE"],["Streets : Major Roads","NONE"],
["Streets : Local Streets","SHAPE"],["ParisNet_Junctions", "NONE"]],
"MATCH_TO_CLOSEST","SID","SOID","PA","SOE","SnapX","SnapY","Distance",
"","","","")
ポリゴン フィーチャのロケーション フィールドを計算します。
import arcpy
arcpy.env.workspace = "C:/ArcTutor/Network Analyst/Tutorial/SanFrancisco.gdb"
arcpy.na.CalculateLocations("Basemap/Parks","Transportation/Streets_ND","",
[["Streets","SHAPE"],
["Streets_ND_Junctions","NONE"]],
location_field="Locations")
次の Python スクリプトは、スタンドアロン スクリプトで CalculateLocations（ロケーション フィールドを計算）ツールを使用する方法を示しています。
# Name: CalculateLocations_ex04.py
# Description: Calculate network locations for fire stations. Make sure that the
# fire stations are not located on the freeways.
# Requirements: Network Analyst Extension
#Import system modules
import arcpy
from arcpy import env
#Check out the Network Analyst extension license
arcpy.CheckOutExtension("Network")
#Set environment settings
env.workspace = "C:/data/SanFrancisco.gdb"
#Set local variables
inFeatures = "Analysis/FireStations"
inNetworkDataset = "Transportation/Streets_ND"
searchTolerance = "2000 Meters"
searchCriteria = [["Streets","SHAPE"],["Streets_ND_Junctions","NONE"]]
searchQuery = [["Streets",'"FREEWAY" = 0'],["Streets_ND_Junctions",""]]
#Calculate network locations and store them in defaut field names
arcpy.na.CalculateLocations(inFeatures,inNetworkDataset,searchTolerance,
searchCriteria,"MATCH_TO_CLOSEST",
exclude_restricted_elements="EXCLUDE",
search_query=searchQuery)
print "Script completed successfully."