ArcGIS Desktop

  • ArcGIS Pro
  • ArcMap

  • My Profile
  • ヘルプ
  • Sign Out
ArcGIS Desktop

ArcGIS Online

組織のマッピング プラットフォーム

ArcGIS Desktop

完全なプロ仕様の GIS

ArcGIS Enterprise

エンタープライズ GIS

ArcGIS Developers

位置情報利用アプリの開発ツール

ArcGIS Solutions

各種業界向けの無料のテンプレート マップおよびテンプレート アプリケーション

ArcGIS Marketplace

組織で使えるアプリとデータを取得

  • ドキュメント
  • サポート
Esri
  • サイン イン
user
  • マイ プロフィール
  • サイン アウト

ArcMap

  • ホーム
  • はじめに
  • マップ
  • 解析
  • データ管理
  • ツール
  • エクステンション

OD コスト マトリックスの生成 (Generate Origin Destination Cost Matrix)

  • 概要
  • 使用法
  • 構文
  • コードのサンプル
  • 環境
  • ライセンス情報

概要

複数の起点と終点 (Origin と Destination) の間のコスト マトリックスを作成できます。OD コスト マトリックスは、各起点から各終点への移動時間と移動距離を含むテーブルです。また、各起点から各終点への移動に要する最小の時間または距離に基づいて、その起点に対する各終点を昇順にランク付けします。道路網の最適なパスは起点と終点のペアごとに検出され、移動時間と移動距離は出力ラインの属性として格納されます。パフォーマンス上の理由でラインが直線であっても、直線距離ではなく道路網に沿った移動時間または移動距離が常に格納されます。

[OD コスト マトリックスの生成 (Generate Origin Destination Cost Matrix)] の出力の詳細

使用法

  • 複数の起点から複数の終点までのネットワークに沿った最小コスト パスを検出して計測します。

  • このツール ダイアログ ボックスの各種オプション パラメーターは、管理しやすいように次の 6 つのカテゴリに分類されています。

    • 高度な解析
    • バリア
    • カスタム移動モード
    • ネットワーク データセット
    • ネットワーク ロケーション
    • 出力
    • サービスのケーパビリティ

構文

arcpy.na.GenerateOriginDestinationCostMatrix(Origins, Destinations, Network_Dataset, Output_Geodatabase, Output_Origin_Destination_Lines_Name, Output_Origins_Name, Output_Destinations_Name, {Travel_Mode}, {Time_Units}, {Distance_Units}, {Number_of_Destinations_to_Find}, {Cutoff}, {Time_of_Day}, {Time_Zone_for_Time_of_Day}, {Point_Barriers}, {Line_Barriers}, {Polygon_Barriers}, {Impedance_Attribute}, {Impedance_Attribute_Units}, {Time_Attribute}, {Time_Attribute_Units}, {Distance_Attribute}, {Distance_Attribute_Units}, {UTurn_Policy}, {Use_Hierarchy_in_Analysis}, {Restrictions}, {Attribute_Parameter_Values}, {Accumulate_Attributes}, {Maximum_Snap_Tolerance}, {Feature_Locator_WHERE_Clause}, {Origin_Destination_Line_Shape}, {Maximum_Features_Affected_by_Point_Barriers}, {Maximum_Features_Affected_by_Line_Barriers}, {Maximum_Features_Affected_by_Polygon_Barriers}, Maximum_Origins, Maximum_Destinations, {Force_Hierarchy_Beyond_Distance}, {Save_Output_Network_Analysis_Layer}, {Overrides})
パラメーター説明データ タイプ
Origins

終点までのパスの生成で開始点として機能する位置を指定します。最大 200 の起点を追加できます。

起点を指定する際は、属性を使用して起点ごとにプロパティ (名前や起点から検索する終点の数) を設定できます。起点には次の属性を指定できます。

Name - 起点の名前。名前は起点の一意の識別子です。名前は、出力行 (OriginName フィールド) と出力起点 (Name フィールド) に含まれ、ツールの出力からの追加情報を起点の属性に結合するために使用できます。

名前を指定しない場合は、出力起点において接頭辞 Location が付いた一意な名前が自動的に生成されます。自動生成された起点名は、出力行には含まれません。

TargetDestinationCount - 起点に対して検索する必要のある終点の最大数。値を指定しない場合、[検出する終点の数] パラメーターの値が使用されます。

Cutoff - 起点から終点の検索を中止する移動時間または移動距離の値を指定します。カットオフ値を超える終点は対象になりません。

値は、移動モードのインピーダンス属性が時間ベースの場合は [時間単位] で指定した単位、移動モードのインピーダンス属性が距離ベースの場合は [距離単位] で指定した単位にする必要があります。値を指定しない場合、[カットオフ] パラメーターの値が使用されます。

CurbApproach - 車両が起点から出発する方向を指定します。このフィールド値は、次のいずれかの整数として指定されます (括弧で囲まれた名前ではなく、数値コードを使用します)。

  • 0 (車両の両側) - 車両は起点に対してどちらの方向にも出発できます。したがって、起点での U ターンは許可されます。この設定は、車両が起点で方向転換することが可能かつ現実的である場合に選択できます。これは、道路の幅と交通量に基づいて決定されたり、起点に車両が進入して方向転換できる駐車場があるかどうかに応じて決定されたりします。
  • 1 (車両の右側) - 車両が起点から出発するときに、起点が車両の右側にある必要があります。U ターンは許可されません。これは、通常、バス停が右側にある状態で出発する必要があるバスなどの車両に使用されます。
  • 2 (車両の左側) - 車両が起点から出発するときに、アプローチを車両の左側に制限します。U ターンは許可されません。これは、通常、バス停が左側にある状態で出発する必要があるバスなどの車両に使用されます。
  • 3 (U ターンを許可しない) - このツールでは、[U ターンを許可しない] (3) の値は [車両の両側] と同様に機能します。

CurbApproach プロパティは、米国の右側通行の標準と英国の左側通行の標準の両方に対応するように設計されています。まず、ストップが車両の左側にあるとします。これは、車両が移動するのが道路の左側であるか右側であるかに関係なく、常に左側にあります。右側通行か左側通行かに応じて異なるのは、2 つの方向のうちどちらからストップに到着するかです。つまり、結局のところ車両の右側または左側になります。たとえば、ストップに到着するときに、車両とストップの間に交通レーンがないほうがいい場合は、米国では [車両の右側] (1) を選択し、英国では [車両の左側] (2) を選択します。

Feature Set
Destinations

起点からのパスの生成で終了点として機能する位置を指定します。最大 200 の終点を追加できます。

終点を指定する際は、属性を使用して終点ごとにプロパティ (名前) を設定できます。終点には次の属性を指定できます。

Name - 終点の名前。名前は終点の一意の識別子です。名前は、出力行 (DestinationName フィールド) と出力終点 (Name フィールド) に含まれ、ツールの出力からの追加情報を終点の属性に結合するために使用できます。

名前を指定しない場合は、出力終点において接頭辞 Location が付いた一意な名前が自動的に生成されます。自動生成された終点名は、出力行には含まれません。

CurbApproach - 車両が終点に到着する方向を指定します。このフィールド値は、次のいずれかの整数として指定されます (括弧で囲まれた名前ではなく、数値コードを使用します)。

  • 0 (車両の両側) - 車両は終点に対してどちらの方向にも到着できます。したがって、終点での U ターンは許可されます。この設定は、車両が終点で方向転換することが可能かつ現実的である場合に選択できます。これは、道路の幅と交通量に基づいて決定されたり、終点に車両が進入して方向転換できる駐車場があるかどうかに応じて決定されたりします。
  • 1 (車両の右側) - 車両が終点に到着するときに、終点が車両の右側にある必要があります。U ターンは許可されません。これは、通常、バス停が右側にある状態で到着する必要があるバスなどの車両に使用されます。
  • 2 (車両の左側) - 車両が終点に到着するときに、アプローチが車両の左側にある必要があります。U ターンは許可されません。これは、通常、バス停が左側にある状態で到着する必要があるバスなどの車両に使用されます。
  • 3 (U ターンを許可しない) - このツールでは、[U ターンを許可しない] (3) の値は [車両の両側] と同様に機能します。

CurbApproach プロパティは、米国の右側通行の標準と英国の左側通行の標準の両方に対応するように設計されています。まず、ストップが車両の左側にあるとします。これは、車両が移動するのが道路の左側であるか右側であるかに関係なく、常に左側にあります。右側通行か左側通行かに応じて異なるのは、2 つの方向のうちどちらからストップに到着するかです。つまり、結局のところ車両の右側または左側になります。たとえば、ストップに到着するときに、車両とストップの間に交通レーンがないほうがいい場合は、米国では [車両の右側] (1) を選択し、英国では [車両の左側] (2) を選択します。

Feature Set
Network_Dataset

解析が実行されるネットワーク データセット。ほとんどの場合、ネットワーク データセットは道路ネットワークを表しますが、他の種類の交通ネットワークを表すこともあります。ネットワーク データセットには、少なくとも 1 つの時間ベースのコスト属性と 1 つの距離ベースのコスト属性が必要です。

Network Dataset Layer
Output_Geodatabase

出力ワークスペースです。このワークスペースはすでに存在している必要があります。

Workspace
Output_Origin_Destination_Lines_Name

起点と終点を結ぶラインを格納する出力フィーチャクラスの名前。

「OD コスト マトリックスの生成 (Generate Origin Destination Cost Matrix) における出力」に、この出力フィーチャクラスのスキーマが説明されています。

String
Output_Origins_Name

起点を含む出力フィーチャクラスの名前。

「OD コスト マトリックスの生成 (Generate Origin Destination Cost Matrix) における出力」に、この出力フィーチャクラスのスキーマが説明されています。

String
Output_Destinations_Name

終点を含む出力フィーチャクラスの名前。

「OD コスト マトリックスの生成 (Generate Origin Destination Cost Matrix) における出力」に、この出力フィーチャクラスのスキーマが説明されています。

String
Travel_Mode
(オプション)

解析する交通モードを選択します。CUSTOM は、常に選択肢に含まれています。その他の移動モード名を表示するには、それらが、Network_Dataset パラメーターで指定したネットワーク データセットに存在している必要があります (arcpy.na.GetTravelModes 関数はネットワーク データセットで構成された移動モード オブジェクトの辞書を提供し、name プロパティは移動モード オブジェクトの名前を返します)。

移動モードは、ネットワーク データセットで定義され、車、トラック、歩行などの移動モードをモデリングする一連のパラメーターをオーバーライドする値を提供します。ここで移動モードを選択することによって、以下のパラメーターの値を指定する必要がなくなります。これらのパラメーターは、ネットワーク データセットで指定した値でオーバーライドされます。

  • UTurn_Policy

  • Time_Attribute

  • Time_Attribute_Units

  • Distance_Attribute

  • Distance_Attribute_Units

  • Use_Hierarchy_in_Analysis

  • Restrictions

  • Attribute_Parameter_Values

  • Route_Line_Simplification_Tolerance

  • CUSTOM —特定の要件に合わせて移動モードを定義します。CUSTOM を選択した場合、上に示された移動モードのパラメーターはオーバーライドされません。これがデフォルトです。
String
Time_Units
(オプション)

起点と終点の各ペアの合計移動時間を計測およびレポートするときに使用される単位を指定します。これには次の選択肢があります。

  • 秒
  • 分
  • 時間
  • 日

String
Distance_Units
(オプション)

起点と終点の各ペアの合計移動距離を計測およびレポートするときに使用される単位を指定します。

これには次の選択肢があります。

  • マイル
  • キロメートル
  • メートル
  • フィート
  • ヤード
  • 海里

String
Number_of_Destinations_to_Find
(オプション)

起点ごとに検索を実行する終点の最大数を指定します。このパラメーターに値が指定されていない場合、出力マトリックスには、各起点からすべての終点までの移動コストが含まれます。個々の起点は、[検出する終点の数] パラメーターの値を無効化する独自の値を持つことができます (TargetDestinationCount フィールドで指定します)。

Long
Cutoff
(オプション)

所定の起点に対して終点の検索を中止する移動時間または移動距離の値を指定します。カットオフ値を超える終点は対象になりません。個々の起点は、[カットオフ] パラメーターの値を無効化する独自の値を持つことができます (Cutoff フィールドで指定します)。

値は、移動モードのインピーダンス属性が時間ベースの場合は [時間単位] で指定した単位、移動モードのインピーダンス属性が距離ベースの場合は [距離単位] で指定した単位にする必要があります。値を指定しない場合、ツールは終点の検索時に、移動時間または移動距離の制限を強制しません。

Double
Time_of_Day
(オプション)

ルートの開始の日時を指定します。

ネットワーク データセットにライブまたは履歴交通量データが含まれている場合、時刻を指定すると、その日時の交通状況における移動時間が解析されるため、ストップ間の移動時間の評価が正確になります。

[時刻のタイム ゾーン] パラメーターは、この日時が UTC を参照するか、ストップの場所のタイム ゾーンを参照するかを指定します。

[使用する単位] が時間ベース単位に設定されていない場合、このパラメーターは無視されます。

Date
Time_Zone_for_Time_of_Day
(オプション)

[時刻] パラメーターのタイム ゾーンを指定します。

  • GEO_LOCAL —[時刻] パラメーターが、ルートの最初のストップがある場所のタイム ゾーンを表します。多くのルートを生成していて、それらが複数のタイム ゾーンで開始される場合、それぞれの開始時間は世界協定時 (UTC) でずれが発生します。たとえば、1 月 2 日の [時刻] の値が 10:00 a.m. の場合、 東部標準時ゾーンで開始されるルートは 開始時間が東部標準時の 10:00 a.m. (3:00 p.m. UTC)、 中央標準時ゾーンで開始されるルートは 開始時間が中央標準時の 10:00 a.m. (4:00 p.m. UTC) になります。開始時間が UTC では 1 時間異なります。出力ストップ フィーチャクラスに記録される到着日時と出発日時は、各ルートの最初のストップがある場所のタイム ゾーンです。
  • UTC —[時刻] パラメーターが、UTC (協定世界時) を参照します。特定の時刻 (たとえば今) におけるルートを生成する場合で、最初のストップがある場所のタイム ゾーンがわからない場合、このオプションを選択します。多くのルートを生成していて、それらが複数のタイム ゾーンにまたがっている場合、UTC での開始時間は同時です。たとえば、1 月 2 日の [時刻] の値が 10:00 a.m. の場合、 東部標準時ゾーンで開始されるルートは開始時間が東部標準時の 5:00 a.m. (UTC-5:00)、 中央標準時ゾーンで開始されるルートは開始時間が中央標準時の 4:00 a.m. (UTC-6:00) になります。どちらのルートも 10:00 a.m. UTC に 開始されます。出力ストップ フィーチャクラスに記録される到着日時と出発日時は UTC です。
String
Point_Barriers
(オプション)

ポイント バリアを指定します。ポイント バリアは、通行不可と追加コストの 2 種類に分かれています。これらは、一時的にネットワーク上のポイントの通行を規制したり、ポイントにインピーダンスを追加したりします。ポイント バリアはフィーチャ セットで定義されます。ポイント フィーチャに指定した属性値によって、ポイント バリアが通行不可バリアなのか、追加コスト バリアなのかが決まります。属性テーブルの各フィールドとその説明を以下に示します。

ObjectID:

システムで管理される ID フィールド。

Shape:

ネットワーク解析オブジェクトの地理的な位置を示すジオメトリ フィールド。

Name:

バリアの名前。

BarrierType:

バリアの通過を完全に規制するのか、バリアを通過する際のコストを追加するのかを指定します。次の 2 つのオプションがあります。

  • [通過不可] (0) - バリアを通過できません。これがデフォルトです。
  • [追加コスト](2) - バリアを通過するたびに、Additional_Time フィールドと Additional_Distance フィールドで指定した値だけネットワーク コストが加算されます。

[規制] の場合は 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) - ScaledCostFactor プロパティの値を乗算して、対象エッジのインピーダンスを増減します。エッジの一部だけがバリアの対象になっている場合は、インピーダンスが比率に応じて乗算されます。

[規制] の場合は 0 の値、[コスト係数指定] の場合は 1 の値を使用します。

ScaledTimeFactor:

これは、バリアが交差している道路の移動時間に乗算する係数です。このフィールドは、コスト係数指定バリアにのみ適用され、計測単位が時間ベースである場合に限られます。このフィールドには 0 より大きい値を指定する必要があります。

ScaledDistanceFactor:

これは、バリアが交差している道路の距離に乗算する係数です。この属性は、コスト係数指定バリアにのみ適用され、計測単位が距離ベースである場合に限られます。この属性には 0 より大きい値を指定する必要があります。

Feature Set
Impedance_Attribute
(オプション)

解析でインピーダンスとして使用されるコスト属性。

String
Impedance_Attribute_Units
(オプション)

[インピーダンス属性] パラメーターで指定したネットワーク インピーダンス属性の単位。

これは、単に情報パラメーターであるため、ネットワーク データセットを直接編集しなければ、変更することはできません。計測単位とコスト属性の間の単位変換は自動的に実施されるため、変更する必要はありません。

このパラメーターの値は、[移動モード] を [カスタム] 以外の値に設定した場合、オーバーライドされます。

String
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
UTurn_Policy
(オプション)

ジャンクションでの U ターン ポリシー。U ターンを許可するということは、解析においてジャンクションで方向転換し、同じ道路を引き返すことができるということを意味します。 ジャンクションが道路の交差と行き止まりを表すことを前提に、さまざまな車両が、一部のジャンクションでは方向転換でき、他のジャンクションでは方向転換できない、というように設定できます。これは、ジャンクションが交差と行き止まりのどちらを表すかによって変わります。これに対応するには、ジャンクションに接続するエッジや道路の数 (ジャンクションでのノードへの接続数) によって、暗黙的に U ターン ポリシーを指定します。以下では、このパラメーターで選択できる値と、ジャンクションので接続におけるそれぞれの意味について示します。

  • ALLOW_UTURNS —任意の数の接続されたエッジまたは道路を持つジャンクションで U ターンを許可します。これがデフォルト値です。
  • NO_UTURNS —ジャンクションの接続にかかわらず、すべてのジャンクションで U ターンを禁止します。
  • ALLOW_DEAD_ENDS_ONLY —1 つの隣接エッジを持つジャンクション (行き止まり) を除くすべてのジャンクションでの U ターンを禁止します。
  • ALLOW_DEAD_ENDS_AND_INTERSECTIONS_ONLY —2 つの隣接するエッジが接するジャンクションでの U ターンを禁止します。ただし、交差点 (3 つ以上の隣接エッジを持つジャンクション) および行き止まり (1 つの隣接エッジを持つジャンクション) では U ターンを許可します。道路をモデリングするネットワークには、道路セグメントの中間に無関係のジャンクションが存在する場合があります。このオプションは、これらの場所で車両が U ターンすることを防ぎます。

このパラメーターの値は、[移動モード](Python では Travel_Mode) をカスタム以外の値に設定した場合、オーバーライドされます。

String
Use_Hierarchy_in_Analysis
(オプション)

ポイント間の最短ルートを検索するときに階層を使用するかどうかを指定します。

  • USE_HIERARCHY — ルートの検索時に階層を使用します。階層を使用すると、ツールは順位の低い道路 (生活道路など) よりも順位の高い道路 (高速道路など) を優先します。これを使用して、移動距離が長くなっても、生活道路よりも高速道路を優先してシミュレーションできます。これは特に、遠くの施設へのルートを検出する場合に効果的です。なぜなら、長距離移動の運転者は、ストップ、交差点、およびターンを避けることができる高速道路での移動を好む傾向にあるためです。階層を使用すると、このツールは比較的小さい道路サブセットから最適ルートを選択する必要があるため、特に長距離ルートの場合に計算が速くなります。
  • NO_HIERARCHY — ルートの検索時に階層を使用しません。階層を使用しない場合は、ルート検索時にすべての道路が検討に入れられ、上位レベルの道路が優先されません。これは、多くの場合、市内の短距離ルートを検出する場合に使用されます。

解析を実行するネットワーク データセットに使用する階層属性が定義されていない場合、パラメーターは使用されません。この場合、「#」をパラメーター値として使用します。

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
Origin_Destination_Line_Shape
(オプション)

結果として得られる OD コスト マトリックスのラインは、直線ジオメトリまたはジオメトリなしのどちらかで表現できます。どちらの場合も、起点と終点間の直線距離を使うのではなく、移動時間または移動距離を最小化する道路網に沿ったルートが常に計算されます。

  • STRAIGHT_LINES — 起点と終点が直線で結ばれます。
  • NO_LINES — 起点と終点を結ぶラインの形状は返されません。これは、起点と終点の数が多く、OD コスト マトリックス テーブルだけが必要 (出力ライン形状は不要) な場合に便利です。
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_Origins

起点と終点のコスト マトリックス解析に追加できる起点の数を制限します。

このパラメーターは、解析時に発生する処理量の管理に役立ちます。たとえば、作成中の無料版のサービスに対してはこのパラメーターに小さい値を割り当て、有料サブスクリプション版のサービスには大きい値を割り当てるというようにできます。

NULL 値は、制限がないことを示します。

Long
Maximum_Destinations

起点と終点のコスト マトリックス解析に追加できる終点の数を制限します。

このパラメーターは、解析時に発生する処理量の管理に役立ちます。たとえば、作成中の無料版のサービスに対してはこのパラメーターに小さい値を割り当て、有料サブスクリプション版のサービスには大きい値を割り当てるというようにできます。

NULL 値は、制限がないことを示します。

Long
Force_Hierarchy_Beyond_Distance
(オプション)

階層が有効化されていない場合であっても、ルートの検索時に階層の適用を開始する最低値となる距離を指定します。このパラメーターの単位は、[距離属性の単位] パラメーターに指定されている単位と同じです。

広範囲でストップ間のルートを検索する場合は、ネットワークの階層を使用して解析するほうが、階層を使用せずに解析する場合よりも処理を大幅に削減できる傾向があります。このパラメーターは、解析時に発生する処理量を管理することに役立ちます。

NULL 値を指定すると、階層は強制されません。[解析に階層を使用] パラメーターの値を指定すると、常に階層が使用されます。入力ネットワーク データセットが階層をサポートしていない場合にこのパラメーターの値を指定すると、エラーが発生します。その場合は、NULL 値を使用してください。

このパラメーターは、ネットワーク データセットに階層属性が含まれていない限り無効です。

Double
Save_Output_Network_Analysis_Layer
(オプション)
  • NO_SAVE_OUTPUT_LAYER —ネットワーク解析レイヤーを出力に含めません。
  • SAVE_OUTPUT_LAYER —出力に、ネットワーク解析レイヤーの結果を含めます。

いずれの場合も、結果が格納されたフィーチャクラスが返されます。ただし、サーバー管理者は、このツールのセットアップと結果を ArcGIS Desktop 環境の Network Analyst コントロールでデバッグできるように、ネットワーク解析レイヤーの出力を選択することもあります。これによって、デバッグ処理が非常に簡単になります。

ArcGIS Desktop では、ネットワーク解析レイヤーのデフォルトの出力場所は、scratch フォルダーになります。scratch フォルダーの場所は、arcpy.env.scratchFolder ジオプロセシング環境の値を評価することで確認できます。出力されたネットワーク解析レイヤーは、「_ags_gpna」に英数字の GUID を付け加えた名前の LYR ファイルとして保存されます。

Boolean
Overrides
(オプション)

ネットワーク解析問題の解決法を見つける場合に、解析の動作に影響を与えることができる追加設定を指定します。

JSON (JavaScript Object Notation) で、このパラメーターの値を指定する必要があります。たとえば、有効な値は {"overrideSetting1" : "value1", "overrideSetting2" : "value2"} という形式です。オーバーライド設定名は、必ず二重引用符で囲みます。値は、数値、ブール型、または文字列のいずれかにすることができます。

このパラメーターのデフォルト値は、値なしであり、解析の設定を上書きしません。

オーバーライドは、設定を適用する前後で得られた結果を慎重に分析した後にのみ使用する必要のある高度な設定です。解析ごとにサポートされているオーバーライド設定の一覧およびそれらの許容される値については、Esri テクニカル サポートにお問い合わせください。

string

派生した出力

名前説明データ タイプ
Solve_Succeeded

サービスが起点と終点のコスト マトリックスを正常に生成できたかどうかを特定します。

ブール型
Output_Origin_Destination_Lines

起点から終点まで生成されたルート。

フィーチャ セット
Output_Origins

解析に含まれた起点。

フィーチャ セット
Output_Destinations

解析に含まれた終点。

フィーチャ セット
Output_Network_Analysis_Layer

ツール パラメーターで構成されたプロパティを含み、マップ内の詳細な解析やデバッグに使用できるネットワーク解析レイヤー。

ファイル

コードのサンプル

GenerateOriginDestinationCostMatrix (OD コスト マトリックスの生成) の例 1 (Python ウィンドウ)

必須パラメーターを使用してツールを実行します。

origins = arcpy.FeatureSet()
origins.load("Warehouses")

destinations = arcpy.FeatureSet()
destinations.load("Stores")

arcpy.na.GenerateOriginDestinationCostMAtrix(origins, destinations, "ParisMultimodal_ND")
GenerateOriginDestinationCostMatrix (OD コスト マトリックスの生成) の例 2 (スタンドアロン スクリプト)

次の Python スクリプトは、スタンドアロン スクリプトでこのツールを使用する方法を示しています。

# Name: GenerateOriginDestinationCostMatrix_Workflow.py
# Description: Find and measure the least-cost paths along the network from multiple
#              origins to multiple destinations.
# 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 = 'C:/arcgis/ArcTutor/Network Analyst/Tutorial/Paris.gdb'
    env.overwriteOutput = True

    #Set local variables
    inOrigins = 'Analysis/Warehouses'
    inDestinations = 'Analysis/Stores'
    inNetworkDataset = 'Transportation/ParisMultimodal_ND'
    outGeodatabase = 'C:/arcgis/ArcTutor/Network Analyst/Tutorial/Output.gdb'
    
    # Run GenerateODCostMatrix
    arcpy.na.GenerateOriginDestinationCostMatrix(inOrigins, inDestinations, inNetworkDataset, outGeodatabase,
                                                 Cutoff=10, Origin_Destination_Line_Shape='STRAIGHT_LINES')
    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

関連トピック

  • OD コスト マトリックス レイヤーの作成 (Make OD Cost Matrix Layer)
  • OD コスト マトリックス解析
  • OD コスト マトリックスの生成 (Generate Origin Destination Cost Matrix) の出力

ArcGIS Desktop

  • ホーム
  • ドキュメント
  • サポート

ArcGIS

  • ArcGIS Online
  • ArcGIS Desktop
  • ArcGIS Enterprise
  • ArcGIS
  • ArcGIS Developer
  • ArcGIS Solutions
  • ArcGIS Marketplace

Esri について

  • 会社概要
  • 採用情報
  • Esri ブログ
  • ユーザ カンファレンス
  • デベロッパ サミット
Esri
ご意見・ご感想をお寄せください。
Copyright © 2021 Esri. | プライバシー | リーガル