ArcGIS Help 10.1 - ロケーションフィールドの計算（Calculate Locations） (Network Analyst)

サマリ

フィーチャのネットワークロケーションが含まれている入力フィーチャにフィールドを追加します。このツールは、フィーチャをネットワーク解析レイヤの入力としてすばやく読み込むために、ネットワークロケーション情報をフィーチャ属性として格納するのに使用されます。

使用法

このツールは [ロケーションの追加（Add Locations）] ツールへの入力となるロケーションフィールドを計算するために使用します。ネットワーク解析レイヤの入力として複数回使用されるフィーチャに使用します。一度ロケーションが計算されると、フィーチャをネットワークロケーションとしてすばやく読み込むために [ロケーションの追加（Add Locations）] の [ジオメトリの代わりにネットワークロケーションフィールドを使用する] パラメータを使用することができます。
このツールではさまざまな検索オプションを使用して、ネットワーク解析レイヤで未配置のネットワークロケーションの再計算にも使用することができます。たとえば、最初に 500 メートルの検索許容値でルートネットワーク解析レイヤ上にストップが追加され、いくつかのストップが未配置である場合、たとえば [属性検索（Select Layer By Attribute）] ツールを使用して、検索許容値を広げた形で [入力フィーチャ] にストップのサブレイヤを指定して、このツールを再実行します。
ネットワークデータセットのネットワークソースとして使用されるフィーチャクラスが有効かつ最新の空間インデックスを保持している場合、このツールは非常に高速に実行されます。

構文

CalculateLocations_na (in_point_features, in_network_dataset, search_tolerance, search_criteria, {match_type}, {source_ID_field}, {source_OID_field}, {position_field}, {side_field}, {snap_X_field}, {snap_Y_field}, {distance_field}, {snap_Z_field}, {location_field}, {exclude_restricted_elements}, {search_query})

パラメータ	説明	データタイプ
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 キーワードを使用して指定されます。たとえば、ロケーション検索時には、パラメータ値「[["Streets","SHAPE"],["Streets_ND_Junctions","NONE"]]」は、Streets_ND_Junctions ソースでなく Streets ソースの形状に基づいた検索が可能であることを示します。 1 つのネットワークソースに複数のスナップタイプを指定するには、アンダースコアで区切ったスナップタイプキーワードの組み合わせを使用します。たとえば、MIDDLE_END はロケーションがネットワークソースの中間または端点にスナップされることを示します。ジオデータベースのネットワークデータセットでは、ネットワークソースの各サブタイプにスナップタイプを指定することができます。ラインまたはポリゴンフィーチャのロケーションを計算する際、他のスナップタイプが指定されていても形状スナップタイプのみが使用されます。	Value Table
match_type (オプション)	MATCH_TO_CLOSEST（最寄りと照合） —検索条件に指定されたスナップタイプを保持するすべてのソースの中から最寄りのネットワークソースを新しいネットワークロケーションと照合します。これがデフォルトです。 PRIORITY（優先度） —検索条件に指定されたスナップタイプを保持する最初のネットワークソースを新しいネットワークロケーションと照合します。ロケーションが検索許容値内で検出される場合、ソースは優先度順に検索しているストップの中から検索されます。ラインまたはポリゴンフィーチャのロケーションを計算する際には、パラメータは使用しません。この場合、「#」をパラメータ値として使用します。	Boolean
source_ID_field (オプション)	計算されたネットワークロケーションのソース ID を新規作成または更新するフィールド名。「SourceID」という名前のフィールドがデフォルトで作成または更新されます。SourceOID という名前のフィールドがデフォルトで作成または更新されます。ラインまたはポリゴンフィーチャのロケーションを計算する際には、パラメータは使用しません。この場合、「#」をパラメータ値として使用します。	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 (オプション)	このパラメータは、入力フィーチャがネットワーク解析レイヤのサブレイヤに属し、バリアオブジェクトでないときにのみ適用されます。その他の場合はすべて、「#」をパラメータ値として使用します。 EXCLUDE —ネットワークロケーションがネットワークの通過可能な部分にのみ配置されるように指定します。これにより、規制またはバリアが原因で到達できないエレメントにネットワークロケーションが配置されなくなります。このオプションを使用してネットワークロケーションを再配置する前に、期待している結果を得るためにすべての規制バリアをネットワーク解析レイヤにすでに追加していることを確認してください。 INCLUDE —ネットワークロケーションがネットワークのすべてのエレメントに配置されるように指定します。このオプションで再配置されるネットワークロケーションは、規制が適用されたエレメント上に位置している場合、解析プロセスにおいて到達不能になる可能性があります。	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

コードのサンプル

CalculateLocations（ロケーションフィールドを計算）の例 1（Python ウィンドウ）

必須パラメータのみを使用して、ポイントフィーチャのロケーションフィールドを計算します。

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"]])

CalculateLocations（ロケーションフィールドを計算）の例 2（Python ウィンドウ）

ネットワークソースのサブタイプ上のポイントフィーチャのロケーションフィールドを計算します。

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",
    "","","","")

CalculateLocations（ロケーションフィールドを計算）の例 3（Python ウィンドウ）

ポリゴンフィーチャのロケーションフィールドを計算します。

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")

CalculateLocations（ロケーションフィールドを計算）の例 4（スタンドアロン Python スクリプト）

次の 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."

環境

現在のワークスペース

ライセンス情報

ArcGIS for Desktop Basic: ○

ArcGIS for Desktop Standard: ○

ArcGIS for Desktop Advanced: ○

9/14/2013

ロケーション フィールドの計算（Calculate Locations） (Network Analyst)

サマリ

使用法

構文

コードのサンプル

環境

関連トピック

ライセンス情報

ロケーションフィールドの計算（Calculate Locations） (Network Analyst)