ストリートをポイントに割り当て (Assign Streets To Points) (ジオコーティング)

サマリー

番地やストリート名などの住所情報や距離を使用して、ポイント アドレスをストリート フィーチャにリンクして、ポイントに最適なストリート フィーチャ候補を見つけます。 住所情報が、距離よりも優先されます。

このツールを使用して、ポイント住所をストリート データにリンクできます。 リンクは、ポイント フィーチャとストリート フィーチャの住所情報、およびそれらのフィーチャ間の距離を比較することによって確立されます。 最適な候補は、名前間の類似性が最も高くなりますが、近接しているとも予想されます。 リンクが確立されると、ポイント住所について、ストリート オブジェクト ID、ストリートの側、ストリート近くの新しいポイントが生成されます。 その他の属性も、ストリートからポイント住所に転送されます。 このツールの使用例には、ストリートからポイント住所またはその逆方向への属性の追加、同じ指定ストリートに隣接するポイントの生成 (生成後、ルート検索位置として使用可能)、ポイント住所とそれに関連するストリート フィーチャの関係性を示すフィッシュボーン ダイアグラムの生成が含まれます。

詳細については、「ストリート名と近接性に基づいてストリートをポイントに割り当て」をご参照ください。

ストリートをポイントに割り当てツールの図
ストリートをポイントに割り当てツールは、ポイント フィーチャとストリート フィーチャのストリート名、およびそれらのフィーチャ間の距離を比較することによってポイント住所をストリート フィーチャにリンクします。

使用法

  • このツールでは、入力としてシングルパートのポイント フィーチャクラスとライン フィーチャクラスを使用できます。

  • このツールは、両データセットが代替のストリート名テーブルにリンクする結合 ID が同じになるように、ストリート参照データからポイント参照データに代替名の結合 ID を割り当てるのに役立ちます。

  • このツールは、入力ポイント フィーチャクラスと入力ライン フィーチャクラスがジオデータベースに格納され、出力がジオデータベースに保存される場合に最高のパフォーマンスを発揮します。

  • [ポイント フィールドのマッピング] パラメーター値と [ストリート フィールドのマッピング] パラメーター値の場合、両データセットで [住所をコンポーネントに分割 (Split Address Into Components)] ツールを実行し、そのツールの出力結果を [ストリートをポイントに割り当て (Assign Streets To Points)][入力ポイント フィーチャ] パラメーター値と [ストリート フィーチャ] パラメーター値に使用します。

  • 品質向上のため、ストリート名コンポーネントとストリート住所コンポーネントのスペルと書式が入力ポイント フィーチャクラスとストリート フィーチャクラスの間で一貫していることを確認してください。

  • 入力ポイント フィーチャ ジオメトリが屋根またはパーセルの重心にある場合、このツールを使用して、ストリート上で対応するポイントの座標を保存し、ロケーターの優先位置プロパティを操作します。

  • ルート検索のワークフローに役立てるため、出力では、ポイントが配置されているストリートの側のインジケーターが提供されます。 ロケーターを構築するときにこのインジケーターを使用すると、インジケーターにストリートの正しい側に結果を表示できるようになります。

  • 出力は、リンクされたストリートからポイントに追加された [ストリート フィールド] パラメーター値で指定されたフィールドの属性を含む入力ポイント フィーチャからのすべてのフィーチャと属性のコピーです。 これには、入力ポイント フィーチャクラスのストリート ID フィールドが含まれます。

  • 出力には、デフォルトで次のフィールドが含まれます。

    • Street_ObjectID- 入力ポイントにリンクされた [ストリート フィーチャ] パラメーター値からのストリート セグメントのオブジェクト ID。
      注意:

      入力ストリート フィーチャクラスにストリート ID を含むフィールドが含まれている場合、結果の確認に使用できる [ストリート フィールド] パラメーター値としてこのフィールドを選択します。

    • InputPoint_X- ポイント フィーチャクラスの空間参照で [入力ポイント フィーチャ] パラメーター値の X 座標。
    • InputPoint_Y- ポイント フィーチャクラスの空間参照で [入力ポイント レイヤー] パラメーター値の Y 座標。
    • Street_X- ポイント フィーチャクラスの空間参照で [ストリート フィーチャ] パラメーター値の、リンクされたストリート上の入力ポイント位置の X 座標。
    • Street_Y- ポイント フィーチャクラスの空間参照で [ストリート フィーチャ] パラメーター値の、リンクされたストリート上の入力ポイント位置の Y 座標。
    • Street_Side- 入力ポイントがフィーチャのデジタイズの方向を基準にしている場合のストリートの側面。 この値は、ストリートの移動方向を基準にはしていません。 この属性は、以下の値のいずれかを取ります。
      • L - ポイントはストリートの左側にリンクされます。
      • R - ポイントはストリートの右側にリンクされます。
      • NULL - ポイントはリンクされません。
    • Street_MatchReason- ツールの実行後に [入力ポイント フィーチャ] の値が [ストリート フィーチャ] の値にどのようにリンクまたは一致されたかを示します。 属性は、以下の値のいずれかを取ります。
      • Match_FullStAddr_AddNum - すべてのストリート住所コンポーネントを使用して、ポイントがストリートに一致され、番地範囲がリンクされたストリートの番地範囲内でした。
      • Match_FullStAddr - すべてのストリート住所コンポーネントを使用して、ポイントがストリートに一致されました。
      • Match_StName_AddNum - ストリート名コンポーネントだけを使用して、ポイントがストリートにリンクされ、番地範囲がリンクされたストリートの番地範囲内でした。
      • Match_StName - ストリート名コンポーネントだけを使用して、ポイントがストリートにリンクされました。
      • Match_Distance_AddNum - ポイントとストリートとの間のストリート名コンポーネントが一致しないため、距離を使用してポイントがストリートにリンクされましたが、番地範囲がリンクされたストリートの番地範囲内でした。
      • Match_Distance - ポイントとストリートとの間のストリート名の値が一致しないため、距離を使用してポイントがストリートにリンクされました。
      • Unmatched - 距離またはストリート住所コンポーネントに基づき、ポイントはストリートに一致しませんでした。
        注意:

        ポイントがストリートに一致しない場合、デフォルトの出力フィールドと選択したストリート フィールドの属性は NULL になりますが、InputPoint_X フィールドと InputPoint_Y フィールドには入力ポイント フィーチャクラスの座標が設定されます。

  • Street_MatchReason フィールドの値が Match_Distance_AddNumMatch_Distance、または Unmatched の場合は、[出力ポイント] パラメーター値の結果を確認してください。 マップでポイントがストリートにどのようにリンクされているかを視覚化すると、結果を確認しやすくなります。

  • このツールは、並列処理をサポートしています。 並列処理ファクター環境が設定されていない場合 (デフォルト)、テーブルのサイズと論理コアの数に基づいて並列処理がスケーリングされます。 50 行未満のデータセットでは 1 つのプロセスしか使用されません。

パラメーター

ラベル説明データ タイプ
入力ポイント フィーチャ

入力ポイント フィーチャクラスまたはレイヤー。

Feature Layer
ポイント フィールドのマッピング

ポイントのリンク先のストリート セグメントを計算するために、完全なストリート名と [ストリート フィーチャ] パラメーター値の完全なストリート名との比較に使用されるポイント フィーチャのストリート住所コンポーネント フィールドのマッピング。

ストリートへのポイントのリンクに使用される [入力ポイント フィーチャ] パラメーター値から住所コンポーネントを選択するには、以下を実行します。

  • [フィールド名] 列のドロップダウン リストから住所コンポーネントを選択します。
  • [データ フィールド] 列の下で、ドロップダウン リストから、対応する住所コンポーネントを含むポイント フィーチャクラスのフィールドを選択します。

使用できる住所コンポーネント フィールドは次のとおりです。

  • [ストリート方向の接頭辞] - ストリート名の前に付ける方向 (例: W. Redlands Blvd. の W)
  • [ストリートの接頭辞タイプ] - ストリート名の前に付けるストリートの種類 (例: Avenue B の Avenue)
  • [ストリート名] - ストリートの名前 (例: Cherry Rd. の Cherry)
  • [ストリート タイプ] - ストリート名の後に続くストリートの種類 (例: New York St. の St.)
  • [ストリート方向] - ストリート名の後に続く方位 (例: Bridge St. NW の NW)
  • [完全なストリート名] - 住所の完全なストリート名 (例: S. Orange St.)
  • [番地] - 住所に関連付けられた番地 (例: 380 New York St. の 380)
Value Table
ストリート フィーチャ

[入力ポイント フィーチャ] パラメーター値に属性が割り当てられる入力ストリート フィーチャクラスまたはレイヤー。

Feature Layer
ストリート フィールドのマッピング

ポイントのリンク先のストリート セグメントを計算するために、完全なストリート名と [入力ポイント フィーチャ] パラメーター値の完全なストリート名との比較に使用されるストリート フィーチャのストリート住所コンポーネント フィールドのマッピング。

ストリートへのポイントのリンクに使用される [ストリート フィーチャ] パラメーター値から住所コンポーネントを選択するには、以下を実行します。

  • [フィールド名] 列のドロップダウン リストから住所コンポーネントを選択します。
  • [データ フィールド] 列の下で、ドロップダウン リストから、対応する住所コンポーネントを含むストリート フィーチャクラスのフィールドを選択します。

[データ フィールド] ドロップダウン リストのストリート フィーチャクラスから、[フィールド名] 列にリストされているストリート住所に対応するフィールドを選択します。 使用できる住所コンポーネント フィールドは次のとおりです。

  • [ストリート方向の接頭辞] - ストリート名の前に付ける方向 (例: W. Redlands Blvd. の W)
  • [ストリートの接頭辞タイプ] - ストリート名の前に付けるストリートの種類 (例: Avenue B の Avenue)
  • [ストリート名] - ストリートの名前 (例: Cherry Rd. の Cherry)
  • [ストリート タイプ] - ストリート名の後に続くストリートの種類 (例: New York St. の St.)
  • [ストリート方向] - ストリート名の後に続く方位 (例: Bridge St. NW の NW)
  • [完全なストリート名] - 住所の完全なストリート名 (例: S. Orange St.)
  • [左側の開始番地] - ストリートの左側にある番地範囲の開始番号を表す値。
  • [左側の終了番地] - ストリートの左側にある番地範囲の終了番号を表す値。
  • [右側の開始番地] - ストリートの右側にある番地範囲の開始番号を表す値。
  • [右側の終了番地] - ストリートの右側にある番地範囲の終了番号を表す値。
Value Table
出力ポイント

ポイントに割り当てられたストリート フィールドを含む出力ポイント フィーチャクラス。

Feature Class
ストリート フィールド
(オプション)

[出力ポイント] パラメーター値に割り当てられる [ストリート フィーチャ] パラメーター値のフィールド。 リンクされたポイント フィーチャに割り当てる属性を含む入力ストリート フィーチャからフィールドを選択します (例: ストリート ID 値を含むフィールド)。 選択したフィールドは [出力ポイント] パラメーター値に追加されます。

Field
距離
(オプション)

ポイント フィーチャに最も近いストリート フィーチャの検出に使用される距離。 距離制限を高くするほど、ツールの実行に時間がかかりますが、一致の品質が向上します。 デフォルト値は 70 メートルです。

Double
出力ジオメトリ
(オプション)

出力ポイント フィーチャクラスに含めるジオメトリを指定します。

  • 入力ポイント ジオメトリ元の入力ポイント フィーチャクラスのジオメトリは出力ポイント フィーチャクラスに含められます。
  • ストリート ポイント ジオメトリリンクされたポイントのストリート位置のジオメトリは出力ポイント フィーチャクラスに含められます。
String

arcpy.geocoding.AssignStreetsToPoints(in_point_features, point_field_mapping, in_street_features, street_field_mapping, out_points, {street_fields}, {distance}, {output_geometry})
名前説明データ タイプ
in_point_features

入力ポイント フィーチャクラスまたはレイヤー。

Feature Layer
point_field_mapping
[point_field_mapping,...]

ポイントのリンク先のストリート セグメントを計算するために、完全なストリート名と in_street_features パラメーター値の完全なストリート名との比較に使用されるポイント フィーチャのストリート住所コンポーネント フィールドのマッピング。

次の使用可能な住所コンポーネントを使用して in_point_features パラメーター値のストリート住所コンポーネント フィールド名とデータ フィールド名を指定します。

  • STREET_PREFIX_DIR - ストリート名の前に付ける方向 (例: W. Redlands Blvd. の W)
  • STREET_PREFIX_TYPE - ストリート名の前に付けるストリートの種類 (例: Avenue B の Avenue)
  • STREET_NAME - ストリートの名前 (例: Cherry Rd. の Cherry)
  • STREET_SUFFIX_TYPE - ストリート名の後に続くストリートの種類 (例: New York St. の St.)
  • STREET_SUFFIX_DIR - ストリート名の後に続く方位 (例: Bridge St. NW の NW)
  • STREET_FULL_NAME - 住所の完全なストリート名 (例: S. Orange St.)
  • HOUSE_NUMBER - 住所に関連付けられた番地 (例: 380 New York St. の 380)

Value Table
in_street_features

in_point_features パラメーター値に属性が割り当てられる入力ストリート フィーチャクラスまたはレイヤー。

Feature Layer
street_field_mapping
[street_field_mapping,...]

ポイントのリンク先のストリート セグメントを計算するために、完全なストリート名と in_point_features パラメーター値の完全なストリート名との比較に使用されるストリート フィーチャのストリート住所コンポーネント フィールドのマッピング。

次の使用可能な住所コンポーネントを使用して in_street_features パラメーター値のストリート住所コンポーネント フィールド名とデータ フィールド名を指定します。

  • STREET_PREFIX_DIR - ストリート名の前に付ける方向 (例: W. Redlands Blvd. の W)
  • STREET_PREFIX_TYPE - ストリート名の前に付けるストリートの種類 (例: Avenue B の Avenue)
  • STREET_NAME - ストリートの名前 (例: Cherry Rd. の Cherry)
  • STREET_SUFFIX_TYPE - ストリート名の後に続くストリートの種類 (例: New York St. の St.)
  • STREET_SUFFIX_DIR - ストリート名の後に続く方位 (例: Bridge St. NW の NW)
  • STREET_FULL_NAME - 住所の完全なストリート名 (例: S. Orange St.)
  • HOUSE_NUMBER_FROM_LEFT - ストリートの左側にある番地範囲の開始番号を表す値。
  • HOUSE_NUMBER_TO_LEFT - ストリートの左側にある番地範囲の終了番号を表す値。
  • HOUSE_NUMBER_FROM_RIGHT - ストリートの右側にある番地範囲の開始番号を表す値。
  • HOUSE_NUMBER_TO_RIGHT - ストリートの右側にある番地範囲の終了番号を表す値。
Value Table
out_points

ポイントに割り当てられたストリート フィールドを含む出力ポイント フィーチャクラス。

Feature Class
street_fields
[street_fields,...]
(オプション)

out_points パラメーター値に割り当てられる in_street_features パラメーター値のフィールド。 リンクされたポイント フィーチャに割り当てる属性を含む入力ストリート フィーチャからフィールドを指定します (例: ストリート ID 値を含むフィールド)。 フィールドは out_points パラメーター値に追加されます。

Field
distance
(オプション)

ポイント フィーチャに最も近いストリート フィーチャの検出に使用される距離。 距離制限を高くするほど、ツールの実行に時間がかかりますが、一致の品質が向上します。 デフォルト値は 70 メートルです。

Double
output_geometry
(オプション)

出力ポイント フィーチャクラスに含めるジオメトリを指定します。

  • INPUT_POINT_GEOMETRY元の入力ポイント フィーチャクラスのジオメトリは出力ポイント フィーチャクラスに含められます。
  • STREET_POINT_GEOMETRYリンクされたポイントのストリート位置のジオメトリは出力ポイント フィーチャクラスに含められます。
String

コードのサンプル

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

次の Python スクリプトは、AssignStreetsToPoints 関数の使用方法を示しています。

import arcpy

# Point Address Data from Tutorial Data
in_point_features = r"C:\Data\SanMarcos.gdb\Address_Points"
point_field_mapping = "STREET_FULL_NAME ADDRESS"

# Street Address Data from Tutorial Data
in_street_features = r"C:\Data\SanMarcos.gdb\Address_Lines"
street_field_mapping = "HOUSE_NUMBER_FROM_LEFT L_ADDNUM_FROM;HOUSE_NUMBER_TO_LEFT L_ADDNUM_TO;HOUSE_NUMBER_FROM_RIGHT R_ADDNUM_FROM;HOUSE_NUMBER_TO_RIGHT R_ADDNUM_TO;STREET_PREFIX_DIR STPREDIR;STREET_NAME STNAME;STREET_SUFFIX_TYPE STSUFFIX;STREET_SUFFIX_DIR STPOSTDIR"

output_data_path = r"C:\Data\SanMarcos.gdb\Street_Points"

arcpy.geocoding.AssignStreetsToPoints(
    in_point_features,
    point_field_mapping,
    in_street_features,
    street_field_mapping,
    output_data_path,
    street_fields=None,
    distance=70,
    output_geometry="STREET_POINT_GEOMETRY"
)