概要
移動時間、距離、または他のコストに基づいてインシデントに最も近い 1 つまたは複数の施設を検出し、インシデントと施設の間の最適ルート、選択された施設、およびルート案内を出力します。たとえば、このツールを使用して、事故現場に最も近い病院、事件現場に最も近いパトカー、または顧客の住所に最も近い店舗を検出できます。
最寄施設を検出するときに、施設の検出件数と、移動方向を施設に向かう方向にするか、施設から向かう方向にするかを指定できます。ネットワーク データセットが交通量をサポートしている場合は、時刻を指定して、その日時の移動時間を検出することもできます。たとえば、このツールを使用して、所定の時刻に事故現場から 15 分以内の運転で到着できる病院を検索できます。交通状況に基づいて運転時間が 15 分を超えてしまう病院は、結果に含まれません。
使用法
このツール ダイアログ ボックスの各種オプション パラメーターは、管理しやすいように次の 6 つのカテゴリに分類されています。
- 高度な解析
- バリア
- カスタム移動モード
- ネットワーク データセット
- ネットワーク ロケーション
- 出力
- サービスのケーパビリティ
構文
arcpy.na.FindClosestFacilities(Incidents, Facilities, Measurement_Units, Network_Dataset, Output_Geodatabase, Output_Routes_Name, Output_Directions_Name, Output_Closest_Facilities_Name, {Number_of_Facilities_to_Find}, {Default_Cutoff}, {Travel_Direction}, {Time_of_Day}, {Time_of_Day_Usage}, {Time_Zone_for_Time_of_Day}, {UTurn_Policy}, {Point_Barriers}, {Line_Barriers}, {Polygon_Barriers}, {Time_Attribute}, {Time_Attribute_Units}, {Distance_Attribute}, {Distance_Attribute_Units}, {Use_Hierarchy_in_Analysis}, {Restrictions}, {Attribute_Parameter_Values}, {Accumulate_Attributes}, {Maximum_Snap_Tolerance}, {Feature_Locator_WHERE_Clause}, {Route_Shape}, {Route_Line_Simplification_Tolerance}, {Populate_Directions}, {Directions_Language}, {Directions_Distance_Units}, {Directions_Style_Name}, {Maximum_Features_Affected_by_Point_Barriers}, {Maximum_Features_Affected_by_Line_Barriers}, {Maximum_Features_Affected_by_Polygon_Barriers}, {Maximum_Facilities}, {Maximum_Facilities_to_Find}, {Maximum_Incidents}, {Force_Hierarchy_Beyond_Distance}, {Save_Output_Network_Analysis_Layer}, {Travel_Mode}, {Overrides}, {Save_Route_Data})| パラメーター | 説明 | データ タイプ |
Incidents | このツールはインシデントに最も近い施設を特定し、このパラメーターはそのインシデントを指定します。解析を実行するには、少なくとも 1 つのインシデントが必要です。 インシデントを指定する場合は、属性を使用して、各インシデントのプロパティ (インシデントの名前やサービス時間など) を設定できます。インシデントには次の属性を指定できます。 OBJECTID - システムで管理される ID フィールド。 SHAPE - インシデントの地理的位置を示すジオメトリ フィールド。 Name - インシデントの名前。この名前は、ルート案内に使用されます。名前を指定しない場合は、出力ルートおよび出力ルート案内において接頭辞 Location が付いた一意な名前が自動的に生成されます。 ID - インシデントの一意な ID。この ID は、出力ルートに (IncidentID フィールドとして) 含まれ、出力ルートからの追加情報 (合計移動時間や合計距離など) をインシデントから属性にまたはその逆に結合するために役立ちます。この ID が指定されていない場合は、各インシデントの一意な ID が自動的に生成されます。 AdditionalTime - インシデントで費やされる時間の長さ。これは、ルートの合計時間に追加されます。この属性値の単位は、[計測単位] パラメーターで指定されます。計測単位が時間ベースである場合に限り、この属性値が解析に含められます。デフォルト値は 0 です。 火災現場から最も近い消防署を検出して応答時間を推定する場合、AdditionalTime 属性に消防士が消火を開始する前に火災現場で消火用具を準備する時間を格納できます。 AdditionalDistance - インシデントで移動する追加の距離。これは、ルートの合計距離に追加されます。この属性値の単位は、[計測単位] パラメーターで指定されます。計測単位が距離ベースである場合に限り、この属性値が解析に含められます。デフォルト値は 0 です。 通常、インシデントの場所 (家など) は厳密には道路に接していません。道路から多少離れて配置されています。インシデントの実際の場所と道路に接した場所の間の距離を合計移動距離に含めることが重要である場合は、この属性値を使用してその距離をモデル化できます。 CurbApproach - 車両がインシデントに到着する方向およびインシデントから出発する方向を指定します。このフィールド値は、次のいずれかの整数として指定されます (括弧で囲まれた名前ではなく、数値コードを使用します)。
CurbApproach プロパティは、右側通行 (米国標準) と左側通行 (英国標準) の両方に対応するように設計されています。まず、インシデントが車両の左側にあるとします。これは、車両が移動するのが道路の左側であるか右側であるかに関係なく、常に左側にあります。右側通行か左側通行かに応じて異なるのは、2 つの方向のうちどちらからインシデントに到着するかです。つまり、結局のところ車両の右側または左側になります。たとえば、インシデントに到着するときに、車両とインシデントの間に交通レーンがないほうがいい場合は、米国では [車両の右側] (1) を選択し、英国では [車両の左側] (2) を選択します。 | Feature Set |
Facilities | このツールはインシデントに最も近い施設を検出し、このパラメーターはその施設を指定します。解析を実行するには、少なくとも 1 つの施設が必要です。 施設を指定する場合は、属性を使用して、各施設のプロパティ (施設の名前やサービス時間など) を設定できます。施設には、次の属性を指定できます。 Name - 施設の名前。この名前は、ルート案内に使用されます。名前を指定しない場合は、出力ルートおよび出力ルート案内において接頭辞 Location が付いた一意な名前が自動的に生成されます。 ID - 施設の一意な ID。この ID は、出力ルートに (FacilityID フィールドとして) 含まれ、出力最寄り施設に FacilityID フィールドとして含まれます。FacilityID フィールドを使用して、出力ルートからの追加情報 (合計移動時間や合計距離など) を施設から属性に結合することができます。この ID が指定されていない場合は、各施設の一意な ID が自動的に生成されます。 AdditionalTime - 施設で費やされる時間の長さ。これは、ルートの合計時間に追加されます。この属性値の単位は、[計測単位] パラメーターで指定されます。計測単位が時間ベースである場合に限り、この属性値が解析に含められます。デフォルト値は 0 です。 火災現場に最も近い消防署を検出する場合、AdditionalTime に消防署の職員が適切な防護装置を身に付けて消防署を出発するまでの時間を格納できます。 AdditionalDistance - 施設で移動する追加の距離。これは、ルートの合計距離に追加されます。この属性値の単位は、[計測単位] パラメーターで指定されます。計測単位が距離ベースである場合に限り、この属性値が解析に含められます。デフォルト値は 0 です。 通常、施設の場所 (消防署など) は厳密には道路に接していません。道路から多少離れて配置されています。施設の実際の場所と道路に接した場所の間の距離を合計移動距離に含めることが重要である場合は、AdditionalDistance でこの距離をモデル化できます。 CurbApproach - 車両が施設に到着する方向および施設から出発する方向を指定します。このフィールド値は、次のいずれかの整数として指定されます (括弧で囲まれた名前ではなく、数値コードを使用します)。
CurbApproach プロパティは、右側通行 (米国標準) と左側通行 (英国標準) の両方に対応するように設計されています。まず、施設が車両の左側にあるとします。これは、車両が移動するのが道路の左側であるか右側であるかに関係なく、常に左側にあります。右側通行か左側通行かに応じて異なるのは、2 つの方向のうちどちらから施設に到着するかです。つまり、結局のところ車両の右側または左側になります。たとえば、施設に到着するときに、車両と施設の間に交通レーンがないほうがいい場合は、米国では [車両の右側] (1) を選択し、英国では [車両の左側] (2) を選択します。 | Feature Set |
Measurement_Units | 出力ルートの合計移動時間または合計距離を計測およびレポートするときに使用される単位を指定します。道路に沿って移動時間または移動距離を計測することにより、最寄り施設が検出されます。 このパラメーターで選択する単位によって、最寄りのものを検出するときに運転距離が計測されるか、運転時間が計測されるかが決まります。運転時間を測定する場合は、時間の単位を選択します。走行距離を測定する場合は、距離の単位を選択します。結果にレポートされる運転時間または運転距離の合計の単位も、この選択によって決まります。これには次の選択肢があります。
このツールでは、選択した計測単位が時間ベースか距離ベースかに応じて、[時間属性] パラメーターに指定したネットワーク コスト属性を使用するか、[距離属性] パラメーターに指定したネットワーク コスト属性を使用するかが選択されます。 対応する時間または距離のコスト属性の単位と [計測単位] の値が異なる場合は、ツールによって必要な単位変換が実行されます。 | String |
Network_Dataset | 解析が実行されるネットワーク データセット。ほとんどの場合、ネットワーク データセットは道路ネットワークを表しますが、他の種類の交通ネットワークを表すこともあります。ネットワーク データセットには、少なくとも 1 つの時間ベースのコスト属性と 1 つの距離ベースのコスト属性が必要です。 | Network Dataset Layer |
Output_Geodatabase | 出力ワークスペースです。このワークスペースはすでに存在している必要があります。デフォルトの出力ワークスペースは、in_memory です。 | Workspace |
Output_Routes_Name | インシデントを最寄り施設に接続するルートまたはラインを含む出力フィーチャクラスの名前。このフィーチャクラスには、インシデントとその最寄り施設の間の移動総コストも属性として含まれます。 ヘルプの「最寄り施設の検出 (Find Closest Facilities) における出力」のトピックでは、この出力フィーチャクラスのスキーマが説明されています。 | String |
Output_Directions_Name | ルート案内を含む出力フィーチャクラスの名前。 ヘルプの「最寄り施設の検出 (Find Closest Facilities) における出力」のトピックでは、この出力フィーチャクラスのスキーマが説明されています。 | String |
Output_Closest_Facilities_Name | 最寄り施設を含む出力フィーチャクラスの名前。 ヘルプの「最寄り施設の検出 (Find Closest Facilities) における出力」のトピックでは、この出力フィーチャクラスのスキーマが説明されています。 | String |
Number_of_Facilities_to_Find (オプション) | インシデントごとに検出する最寄り施設の数を指定します。これは、複数の消防署から多くの消防車が必要となる火災などの状況で便利です。たとえば、火災現場に最も近い 3 つの消防署を検出するように指定できます。 このツールからサービスを設定するときに、サーバー上の処理時間など、リソース使用を制限したい場合は、[検出する最大施設数] パラメーターを使用して、ユーザーが [検出する施設の数] に入力できる施設の最大数を制限します。 | Long |
Default_Cutoff (オプション) | 所定のインシデントに対して施設の検索を中止する移動時間または移動距離の値を指定します。たとえば、事故現場から最も近い病院を検出するときに 15 分間のカットオフ値が設定されている場合は、インシデントから 15 分以内の距離にある、最も近い病院が検索されます。最も近い病院が 17 分の距離にある場合、出力ルートで返されるルートはありません。カットオフ値は、複数の施設を検索する場合に特に便利です。 このパラメーターの単位は、[計測単位] パラメーターで指定されます。 | Double |
Travel_Direction (オプション) | 最寄り施設をインシデントから施設への方向で計測して検出するのか、施設からインシデントへの方向で計測して検出するのかを指定します。
これらのパラメーター値のどちらを使用するかによって、検出される施設が異なることがあります。なぜなら、一部の道路では、移動する方向や一方通行規制に基づいて移動時間が変わることがあるためです。たとえば、インシデントから施設に向かった場合に要する時間が 10 分間であったとしても、施設からインシデントに向かった場合は方向が異なるために、15 分間を要する場合があります。また、[時刻] の値を設定すると、交通量が原因で、[施設からインシデントへ] オプションと [インシデントから施設へ] オプションで異なる結果が返されることがあります。 | String |
Time_of_Day (オプション) | ルートの開始または終了の日時を指定します。この値は、[時刻による使用状況] パラメーターの値に応じて、ルートの開始時間または終了時間として使用されます。このパラメーターの値として現在の日時を指定すると、ライブ交通状況を使用して最寄り施設が検出され、合計移動時間は交通状況に基づくものとなります。 ネットワーク データセットにライブまたは履歴交通量データが含まれている場合は、時刻を指定すると、インシデントと施設の間の移動時間の推定がより正確になります。これは、移動時間において、その日時に該当する交通状況が考慮されるためです。 [時刻のタイムゾーン] パラメーターは、この日時が UTC を参照するか、施設またはインシデントの場所のタイム ゾーンを参照するかを指定します。 [Time Zone for Time of Day] の設定に関係なく、施設およびインシデントが複数のタイム ゾーンにある場合は、次の規則が適用されます。
| Date |
Time_of_Day_Usage (オプション) | [時刻] パラメーターの値がルートの到着時間と出発時間のどちらを表すかを示します。
| String |
Time_Zone_for_Time_of_Day (オプション) | [時刻] パラメーターのタイム ゾーンを指定します。
[Time Zone for Time of Day] の設定に関係なく、施設およびインシデントが複数のタイム ゾーンにある場合は、次の規則が適用されます。
| String |
UTurn_Policy (オプション) | ジャンクションでの U ターン ポリシー。U ターンを許可するということは、解析においてジャンクションで方向転換し、同じ道路を引き返すことができるということを意味します。 ジャンクションが道路の交差と行き止まりを表すことを前提に、さまざまな車両が、一部のジャンクションでは方向転換でき、他のジャンクションでは方向転換できない、というように設定できます。これは、ジャンクションが交差と行き止まりのどちらを表すかによって変わります。これに対応するには、ジャンクションに接続するエッジの数 (ジャンクションでのノードへの接続数) によって、暗黙的に U ターン ポリシーを指定します。以下では、このパラメーターで選択できる値と、ジャンクションので接続におけるそれぞれの意味について示します。
このパラメーターの値は、[移動モード](Python では Travel_Mode) をカスタム以外の値に設定した場合、オーバーライドされます。 | String |
Point_Barriers (オプション) | ポイント バリアを指定します。ポイント バリアは、通行不可と追加コストの 2 種類に分かれています。これらは、一時的にネットワーク上のポイントの通行を規制したり、ポイントにインピーダンスを追加したりします。ポイント バリアはフィーチャ セットで定義されます。ポイント フィーチャに指定した属性値によって、ポイント バリアが通行不可バリアなのか、追加コスト バリアなのかが決まります。属性テーブルの各フィールドとその説明を以下に示します。 ObjectID: システムで管理される ID フィールド。 Shape: ネットワーク解析オブジェクトの地理的な位置を示すジオメトリ フィールド。 Name: バリアの名前。 BarrierType: バリアの通過を完全に規制するのか、バリアを通過する際のコストを追加するのかを指定します。次の 2 つのオプションがあります。
[規制] の場合は 0 の値、[追加コスト] の場合は 2 の値を使用します。 Additional_Time: バリアを通過するときに追加される移動時間の値を指定します。このフィールドは、追加コスト バリアにのみ適用され、計測単位が時間ベースである場合に限られます。このフィールドには 0 以上の値を指定する必要があります。単位は計測単位パラメーターで指定した単位と同じです。 Additional_Distance: バリアを通過するときに追加される距離の値を指定します。このフィールドは、追加コスト バリアにのみ適用され、計測単位が距離ベースである場合に限られます。このフィールドには 0 以上の値を指定する必要があります。単位は計測単位パラメーターで指定した単位と同じです。 | Feature Set |
Line_Barriers (オプション) | 一時的にラインの横断を規制するライン バリアを指定します。ライン バリアは、フィーチャ セットで定義されます。属性テーブルの各フィールドとその説明を以下に示します。 ObjectID: システムで管理される ID フィールド。 Shape: ネットワーク解析オブジェクトの地理的な位置を示すジオメトリ フィールド。 Name: バリアの名前。 | Feature Set |
Polygon_Barriers (オプション) | ポリゴン バリアを指定します。ポリゴン バリアは、通行不可とコスト係数指定の 2 種類に分かれています。これらは、ポリゴン バリアに含まれるネットワークの一部に対して、一時的に通行を規制したり、インピーダンスを増減したりします。ポリゴン バリアはフィーチャ セットで定義されます。ポリゴン フィーチャに指定した属性値によって、ポリゴン バリアが通行不可バリアなのか、コスト係数指 バリアなのかが決まります。属性テーブルの各フィールドとその説明を以下に示します。 ObjectID: システムで管理される ID フィールド。 Shape: ネットワーク解析オブジェクトの地理的な位置を示すジオメトリ フィールド。 Name: バリアの名前。 BarrierType: バリアの通過を完全に禁止するか、バリアを通過する際のコストを係数に基づいて計算するかを指定します。次の 2 つのオプションがあります。
[規制] の場合は 0 の値、[コスト係数指定] の場合は 1 の値を使用します。 ScaledTimeFactor: これは、バリアが交差している道路の移動時間に乗算する係数です。このフィールドは、コスト係数指定バリアにのみ適用され、計測単位が時間ベースである場合に限られます。このフィールドには 0 より大きい値を指定する必要があります。 ScaledDistanceFactor: これは、バリアが交差している道路の距離に乗算する係数です。この属性は、コスト係数指定バリアにのみ適用され、計測単位が距離ベースである場合に限られます。この属性には 0 より大きい値を指定する必要があります。 | Feature Set |
Time_Attribute (オプション) | [使用する単位] の値が時間単位である場合に使用するネットワーク コスト属性を定義します。 [使用する単位] の値がここに定義されているコスト属性の単位と異なる場合は、ツールによって必要な時間単位の変換がなされます。つまり、デフォルトのカットオフの時間単位とネットワーク コスト属性が同じである必要はありません。 このパラメーターの値は、[移動モード](Python では Travel_Mode) を [カスタム] 以外の値に設定した場合、オーバーライドされます。 | String |
Time_Attribute_Units (オプション) | 時間属性の単位。時間属性の単位を明示的に設定できますが、何も指定しないか、"#" を指定して、解析によって単位が決定されるようにすることをお勧めします。 このパラメーターの値は、Travel_Mode を CUSTOM 以外の値に設定した場合、オーバーライドされます。 | String |
Distance_Attribute (オプション) | [使用する単位] の値が距離単位である場合に使用するネットワーク コスト属性を定義します。 [使用する単位] の値がここに定義されているコスト属性の単位と異なる場合は、ツールによって必要な距離単位の変換がなされます。つまり、計測単位とネットワーク コスト属性の距離単位が同じである必要はありません。 このパラメーターの値は、[移動モード](Python では Travel_Mode) を [カスタム] 以外の値に設定した場合、オーバーライドされます。 | String |
Distance_Attribute_Units (オプション) | 距離属性の単位。距離属性の単位を明示的に設定できますが、何も指定しないか、"#" を指定して、解析によって単位が決定されるようにすることをお勧めします。 このパラメーターの値は、Travel_Mode が CUSTOM 以外の値に設定されているとオーバーライドされます。 | String |
Use_Hierarchy_in_Analysis (オプション) | ポイント間の最短ルートを検索するときに階層を使用するかどうかを指定します。
解析を実行するネットワーク データセットに使用する階層属性が定義されていない場合、パラメーターは使用されません。この場合、「#」をパラメーター値として使用します。 Force_Hierarchy_Beyond_Distance パラメーターを使用すると、Use_Hierarchy_in_Analysis が False に設定されていても、解析での階層の使用を強制することができます。 このパラメーターは、Travel_Mode を CUSTOM に設定しなければ、無視されます。カスタム歩行モードをモデリングする場合、階層が動力付き車両用に設計されているため、階層をオフにすることをお勧めします。 | Boolean |
Restrictions [restriction,...] (オプション) | 解析時にどのネットワーク規制属性を考慮するかを指定します。 このパラメーターの値は、[移動モード](Python では Travel_Mode) をカスタム以外の値に設定した場合、オーバーライドされます。 | String |
Attribute_Parameter_Values (オプション) | パラメーターを持つネットワーク属性のパラメーター値を指定します。レコード セットには、パラメーターを一意に特定するために一緒に使用される 2 つの列と、パラメーター値を指定する別の列が含まれています。 このパラメーターの値は、[移動モード](Python では Travel_Mode) をカスタム以外の値に設定した場合、オーバーライドされます。 属性パラメーター値 レコード セットには、属性が関連付けられています。属性テーブルの各フィールドとその説明を以下に示します。 ObjectID: システムで管理される ID フィールド。 AttributeName: テーブル行で設定される属性パラメーターを持つネットワーク属性の名前。 ParameterName: テーブル行で設定される値を持つ属性パラメーターの名前。(オブジェクト タイプ パラメーターは、このツールを使用して更新できません。) ParameterValue: 属性パラメーターに設定する値。値が指定されない場合、属性パラメーターは NULL に設定されます。 | Record Set |
Accumulate_Attributes [attribute,...] (オプション) | 解析中に累積されるコスト属性のリスト。これらの累積属性は、参考情報としてのみ使用されます。解析では、[時間属性](Python では Time_Attribute) パラメーターまたは [距離属性](Python では Distance_Attribute) パラメーターで指定されているコスト属性のみを使用して最短経路を計算します。 累積されるコスト属性ごとに、解析で出力されたルートに Total_[属性] フィールドが追加されます。 | String |
Maximum_Snap_Tolerance (オプション) | 最大スナップ許容値とは、Network Analyst がネットワーク上でポイントの配置や再配置を行う場合に検索できる最大距離のことです。検索によって適切なエッジまたはジャンクションを見つけ、そのうちで最も近い場所にポイントをスナップします。最大スナップ許容値内で適切な場所が見つからなかった場合、そのオブジェクトには未配置のマークが付けられます。 | Linear Unit |
Feature_Locator_WHERE_Clause (オプション) | 施設を配置できるネットワーク エレメントを制限するソース フィーチャ サブセットの選択に使用する SQL 式。このパラメーターの構文は、ソース フィーチャクラス名 (後に半角スペースが入ります) と SQL 構文の 2 つの部分で構成されます。2 つ以上のソース フィーチャクラスを含む SQL 式を記述するには、それらをセミコロンで区切ります。 通行が規制されている高速道路に施設を配置しないようにするために、たとえば、次のように SQL 式を記述してそれらのソース フィーチャを除外します。「Streets" "FUNC_CLASS not in('1', '2')」。 読み込み時に、バリアはフィーチャのロケーター WHERE 句を無視します。 | String |
Route_Shape (オプション) | ツールによって出力されるルート フィーチャのタイプを指定します。このパラメーターは、次のいずれかの値を使用して指定できます。
[ルート形状] パラメーターが [正確な形状] に設定されている場合は、[ルートの単純化許容値] パラメーターの適切な値を使用して、ルートの形状の一般化をさらに制御できます。 [ルート形状] パラメーターにどのような値を選択しても、最適ルートは常に、インシデントと施設の間の直線距離を使用するのではなく、移動時間または移動距離を最小限にすることで決定されます。つまり、ルート形状が異なるだけで、ルート検索時に対象となる道路は同じであることを意味します。 | String |
Route_Line_Simplification_Tolerance (オプション) | ルート ジオメトリをどの程度単純化するかを指定します。 Route_Shape パラメーターが TRUE_LINES_WITH_MEASURES または TRUE_LINES_WITHOUT_MEASURES に設定されていない場合、このパラメーターは無視されます。 単純化によって、ルートの基本的な形状を定義する重要ポイント (交差点でのターンなど) は維持され、その他のポイントは削除されます。ここで指定する単純化の距離は、単純化されたラインの元のラインからの逸脱として認められる、最大許容オフセットです。ラインの単純化では、ルート ジオメトリを構成する頂点の数が削減されます。これにより、ツールの実行時間が短縮されます。 このパラメーターの値は、[移動モード](Python では Travel_Mode) をカスタム以外の値に設定した場合、オーバーライドされます。 | Linear Unit |
Populate_Directions (オプション) | 各ルートに対してルート案内を生成するかどうかを指定します。
| Boolean |
Directions_Language (オプション) | ルート案内を生成する際に使用する言語を指定します。 このパラメーターは、[ルート案内の設定] パラメーターがオンであるか、True に設定されている場合にのみ使用されます。 コンピューターにインストールされている ArcGIS 言語パックに応じて使用できるルート案内の言語。2 文字または 5 文字の言語コードで値を入力します (たとえば、英語の場合は en、簡体字中国語の場合は zh-CN)。 サポートされていない言語コードを指定すると、デフォルトの言語である英語を使用するルート案内が返されます。 | String |
Directions_Distance_Units (オプション) | ルート案内で移動距離を表示する単位を指定します。このパラメーターは、[ルート案内の設定] パラメーターがオンであるか、True に設定されている場合にのみ使用されます。
| String |
Directions_Style_Name (オプション) | ルート案内の書式スタイルの名前を指定します。このパラメーターは、[ルート案内の設定] パラメーターがオンであるか、True に設定されている場合にのみ使用されます。パラメーターには、次のいずれかの値を指定できます。
| String |
Maximum_Features_Affected_by_Point_Barriers (オプション) | ポイント バリアが影響を与えることのできるフィーチャの数を制限します。 このパラメーターは、解析時に発生する処理量の管理に役立ちます。たとえば、作成中の無料版のサービスに対してはこのパラメーターに小さい値を割り当て、有料サブスクリプション版のサービスには大きい値を割り当てるというようにできます。 NULL 値は、制限がないことを示します。 | Long |
Maximum_Features_Affected_by_Line_Barriers (オプション) | ライン バリアが影響を与えることのできるフィーチャの数を制限します。 このパラメーターは、解析時に発生する処理量の管理に役立ちます。たとえば、作成中の無料版のサービスに対してはこのパラメーターに小さい値を割り当て、有料サブスクリプション版のサービスには大きい値を割り当てるというようにできます。 NULL 値は、制限がないことを示します。 | Long |
Maximum_Features_Affected_by_Polygon_Barriers (オプション) | ポリゴン バリアが影響を与えることのできるフィーチャの数を制限します。 このパラメーターは、解析時に発生する処理量の管理に役立ちます。たとえば、作成中の無料版のサービスに対してはこのパラメーターに小さい値を割り当て、有料サブスクリプション版のサービスには大きい値を割り当てるというようにできます。 NULL 値は、制限がないことを示します。 | Long |
Maximum_Facilities (オプション) | 最寄り施設解析に追加できる施設の数を制限します。 このパラメーターは、解析時に発生する処理量の管理に役立ちます。たとえば、作成中の無料版のサービスに対してはこのパラメーターに小さい値を割り当て、有料サブスクリプション版のサービスには大きい値を割り当てるというようにできます。 NULL 値は、制限がないことを示します。 | Long |
Maximum_Facilities_to_Find (オプション) | サービスに検出するよう依頼できる施設の数を制限します。 このパラメーターは、解析時に発生する処理量の管理に役立ちます。たとえば、作成中の無料版のサービスに対してはこのパラメーターに小さい値を割り当て、有料サブスクリプション版のサービスには大きい値を割り当てるというようにできます。 NULL 値は、制限がないことを示します。 | Long |
Maximum_Incidents (オプション) | 最寄り施設解析に追加できるインシデントの数を制限します。 このパラメーターは、解析時に発生する処理量の管理に役立ちます。たとえば、作成中の無料版のサービスに対してはこのパラメーターに小さい値を割り当て、有料サブスクリプション版のサービスには大きい値を割り当てるというようにできます。 NULL 値は、制限がないことを示します。 | Long |
Force_Hierarchy_Beyond_Distance (オプション) | 階層が有効化されていない場合であっても、最寄り施設の検出時に階層の適用を開始する最低値となる距離を指定します。このパラメーターの単位は、[距離属性の単位] パラメーターに指定されている単位と同じです。 広範囲で最寄り施設を検出する場合は、ネットワークの階層を使用して検出するほうが、階層を使用せずに検出する場合よりも処理を大幅に削減できる傾向があります。このパラメーターは、解析時に発生する処理量を管理することに役立ちます。 NULL 値を指定すると、階層は強制されません。[解析に階層を使用] パラメーターの値を指定すると、常に階層が使用されます。入力ネットワーク データセットが階層をサポートしていない場合にこのパラメーターの値を指定すると、エラーが発生します。その場合は、NULL 値を使用してください。 | Double |
Save_Output_Network_Analysis_Layer (オプション) |
どちらの場合も、ルートとルート案内を含むフィーチャクラスが返されます。ただし、サーバー管理者は、このツールのセットアップと結果を ArcGIS Desktop 環境の Network Analyst コントロールでデバッグできるように、ネットワーク解析レイヤーの出力を選択することもあります。これによって、デバッグ処理が非常に簡単になります。 ArcGIS Desktop では、ネットワーク解析レイヤーのデフォルトの出力場所は、scratch フォルダーになります。scratch フォルダーの場所は、arcpy.env.scratchFolder ジオプロセシング環境の値を評価することで確認できます。出力されたネットワーク解析レイヤーは、「_ags_gpna」に英数字の GUID を付け加えた名前の LYR ファイルとして保存されます。 | Boolean |
Travel_Mode (オプション) | 解析する交通モードを選択します。CUSTOM は、常に選択肢に含まれています。その他の移動モード名を表示するには、それらが、Network_Dataset パラメーターで指定したネットワーク データセットに存在している必要があります (arcpy.na.GetTravelModes 関数はネットワーク データセットで構成された移動モード オブジェクトの辞書を提供し、name プロパティは移動モード オブジェクトの名前を返します)。 移動モードは、ネットワーク データセットで定義され、車、トラック、歩行などの移動モードをモデリングする一連のパラメーターをオーバーライドする値を提供します。ここで移動モードを選択することによって、以下のパラメーターの値を指定する必要がなくなります。これらのパラメーターは、ネットワーク データセットで指定した値でオーバーライドされます。
| String |
Overrides (オプション) | ネットワーク解析問題の解決法を見つける場合に、解析の動作に影響を与えることができる追加設定を指定します。 JSON (JavaScript Object Notation) で、このパラメーターの値を指定する必要があります。たとえば、有効な値は {"overrideSetting1" : "value1", "overrideSetting2" : "value2"} という形式です。オーバーライド設定名は、必ず二重引用符で囲みます。値は、数値、ブール型、または文字列のいずれかにすることができます。 このパラメーターのデフォルト値は、値なしであり、解析の設定を上書きしません。 オーバーライドは、設定を適用する前後で得られた結果を慎重に分析した後にのみ使用する必要のある高度な設定です。解析ごとにサポートされているオーバーライド設定の一覧およびそれらの許容される値については、Esri テクニカル サポートにお問い合わせください。 | String |
Save_Route_Data (オプション) | ルート レイヤーをオンラインまたはポータルで共有するのに使用できる形式で、解析の入力と出力を保持するファイル ジオデータベースを含む ZIP ファイルを出力に含めるかどうかを選択します。 ArcGIS Desktop では、出力ファイルのデフォルトの出力場所は、scratch フォルダーになります。scratch フォルダーの場所は、arcpy.env.scratchFolder ジオプロセシング環境の値を評価することで確認できます。
| Boolean |
派生した出力
| 名前 | 説明 | データ タイプ |
| Output_Routes | 施設とインシデントの間に生成されたルート。 | フィーチャ セット |
| Output_Directions | 施設とインシデントの間に生成された各ルートのターンごとのルート案内。 | フィーチャ セット |
| Solve_Succeeded | 最寄り施設の検出解析が成功したかどうかを示します。 | ブール型 |
| Output_Closest_Facilities | インシデントに最も近かった施設。 | フィーチャ セット |
| Output_Network_Analysis_layer | ツールのパラメーターで構成されているとおりにプロパティが指定されたネットワーク解析レイヤー。これはマップ内でさらに詳細な解析やデバッグ用に使用できます。 | ファイル |
| Output_Route_Data | 特定のルートに関するすべての情報を含む zip ファイル。 | ファイル |
コードのサンプル
FindClosestFacilities (最寄り施設の検出) の例 1 (Python ウィンドウ)
必須パラメーターを使用して FindClosestFacilities ツールを実行します。
import arcpy
incidents = arcpy.FeatureSet()
incidents.load("Stores")
facilities = arcpy.FeatureSet()
facilities.load("Warehouses")
arcpy.na.FindClosestFacilities(incidents, facilities, "Minutes",
"Streets_ND", "in_memory", "Routes",
"Directions", "CLosestFacilities",
Number_of_Facilities_to_Find=1)
FindClosestFacilities (最寄り施設の検出) の例 2 (スタンドアロン スクリプト)
次のスタンドアロン Python スクリプトは、FindClosestFacilities によって倉庫に最も近い店舗を特定する方法を示しています。他の入力を使用するようにこのスクリプトを変更すると、事故現場に最も近い救急車や停電した電線に最も近い作業員などを検出できます。
# Name: FindClosestFacilities_Workflow.py
# Description: For each store, find the closest warehouse. The output will show
# the routes between stores and warehouses, driving directions,
# and the subset of warehouses that were closest to stores.
# Requirements: Network Analyst Extension
#Import system modules
import arcpy
from arcpy import env
try:
#Check out the Network Analyst extension license
arcpy.CheckOutExtension("Network")
#Set environment settings
env.workspace = r'C:\arcgis\ArcTutor\Network Analyst\Tutorial\Paris.gdb'
env.overwriteOutput = True
#Set local variables
inNetworkDataset = r'Transportation\ParisMultimodal_ND'
inIncidents = r'Analysis\Stores'
inFacilities = r'Analysis\Warehouses'
outGeodatabase = r'C:\arcgis\ArcTutor\Network Analyst\Tutorial\Output.gdb'
outRoutes = "Routes"
outDirections = "Directions"
outClosestFacilities = "ClosestFacilities"
measurement_units = "Minutes"
# Run FindClosestFacilities. Choose to find only the closest facility.
arcpy.na.FindClosestFacilities(inIncidents, inFacilities, measurement_units,
inNetworkDataset, outGeodatabase, outRoutes,
outDirections, outClosestFacilities,
Number_of_Facilities_to_Find=1)
print "Script completed successfully"
except Exception as e:
# If an error occurred, print line number and error message
import traceback, sys
tb = sys.exc_info()[2]
print "An error occured on line %i" % tb.tb_lineno
print str(e)
環境
ライセンス情報
- Basic: 次のものが必要 Network Analyst
- Standard: 次のものが必要 Network Analyst
- Advanced: 次のものが必要 Network Analyst