ラベル | 説明 | データ タイプ |
入力ポイント フィーチャ | 入力ポイント フィーチャクラスまたはレイヤー。 | Feature Layer |
ポイント フィールドのマッピング | ポイントのリンク先のストリート セグメントを計算するために、完全なストリート名と [ストリート フィーチャ] パラメーター値の完全なストリート名との比較に使用されるポイント フィーチャのストリート住所コンポーネント フィールドのマッピング。 ストリートへのポイントのリンクに使用される [入力ポイント フィーチャ] パラメーター値から住所コンポーネントを選択するには、以下を実行します。
使用できる住所コンポーネント フィールドは次のとおりです。
| Value Table |
ストリート フィーチャ | [入力ポイント フィーチャ] パラメーター値に属性が割り当てられる入力ストリート フィーチャクラスまたはレイヤー。 | Feature Layer |
ストリート フィールドのマッピング | ポイントのリンク先のストリート セグメントを計算するために、完全なストリート名と [入力ポイント フィーチャ] パラメーター値の完全なストリート名との比較に使用されるストリート フィーチャのストリート住所コンポーネント フィールドのマッピング。 ストリートへのポイントのリンクに使用される [ストリート フィーチャ] パラメーター値から住所コンポーネントを選択するには、以下を実行します。
[データ フィールド] ドロップダウン リストのストリート フィーチャクラスから、[フィールド名] 列にリストされているストリート住所に対応するフィールドを選択します。 使用できる住所コンポーネント フィールドは次のとおりです。
| Value Table |
出力ポイント | ポイントに割り当てられたストリート フィールドを含む出力ポイント フィーチャクラス。 | Feature Class |
ストリート フィールド (オプション) | [出力ポイント] パラメーター値に割り当てられる [ストリート フィーチャ] パラメーター値のフィールド。 リンクされたポイント フィーチャに割り当てる属性を含む入力ストリート フィーチャからフィールドを選択します (例: ストリート ID 値を含むフィールド)。 選択したフィールドは [出力ポイント] パラメーター値に追加されます。 | Field |
距離 (オプション) | ポイント フィーチャに最も近いストリート フィーチャの検出に使用される距離。 距離制限を高くするほど、ツールの実行に時間がかかりますが、一致の品質が向上します。 デフォルト値は 70 メートルです。 | Double |
出力ジオメトリ (オプション) | 出力ポイント フィーチャクラスに含めるジオメトリを指定します。
| String |
サマリー
番地やストリート名などの住所情報や距離を使用して、ポイント アドレスをストリート フィーチャにリンクして、ポイントに最適なストリート フィーチャ候補を見つけます。 住所情報が、距離よりも優先されます。
このツールを使用して、ポイント住所をストリート データにリンクできます。 リンクは、ポイント フィーチャとストリート フィーチャの住所情報、およびそれらのフィーチャ間の距離を比較することによって確立されます。 最適な候補は、名前間の類似性が最も高くなりますが、近接しているとも予想されます。 リンクが確立されると、ポイント住所について、ストリート オブジェクト 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_ObjectID- 入力ポイントにリンクされた [ストリート フィーチャ] パラメーター値からのストリート セグメントのオブジェクト ID。
Street_MatchReason フィールドの値が Match_Distance_AddNum、Match_Distance、または Unmatched の場合は、[出力ポイント] パラメーター値の結果を確認してください。 マップでポイントがストリートにどのようにリンクされているかを視覚化すると、結果を確認しやすくなります。
このツールは、並列処理をサポートしています。 並列処理ファクター環境が設定されていない場合 (デフォルト)、テーブルのサイズと論理コアの数に基づいて並列処理がスケーリングされます。 50 行未満のデータセットでは 1 つのプロセスしか使用されません。
パラメーター
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 パラメーター値のストリート住所コンポーネント フィールド名とデータ フィールド名を指定します。
| Value Table |
in_street_features | in_point_features パラメーター値に属性が割り当てられる入力ストリート フィーチャクラスまたはレイヤー。 | Feature Layer |
street_field_mapping [street_field_mapping,...] | ポイントのリンク先のストリート セグメントを計算するために、完全なストリート名と in_point_features パラメーター値の完全なストリート名との比較に使用されるストリート フィーチャのストリート住所コンポーネント フィールドのマッピング。 次の使用可能な住所コンポーネントを使用して in_street_features パラメーター値のストリート住所コンポーネント フィールド名とデータ フィールド名を指定します。
| Value Table |
out_points | ポイントに割り当てられたストリート フィールドを含む出力ポイント フィーチャクラス。 | Feature Class |
street_fields [street_fields,...] (オプション) | out_points パラメーター値に割り当てられる in_street_features パラメーター値のフィールド。 リンクされたポイント フィーチャに割り当てる属性を含む入力ストリート フィーチャからフィールドを指定します (例: ストリート ID 値を含むフィールド)。 フィールドは out_points パラメーター値に追加されます。 | Field |
distance (オプション) | ポイント フィーチャに最も近いストリート フィーチャの検出に使用される距離。 距離制限を高くするほど、ツールの実行に時間がかかりますが、一致の品質が向上します。 デフォルト値は 70 メートルです。 | Double |
output_geometry (オプション) | 出力ポイント フィーチャクラスに含めるジオメトリを指定します。
| String |
コードのサンプル
次の 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"
)