ラインに沿ってポイントを生成 (Generate Points Along Lines) (データ管理)

サマリー

固定間隔またはフィーチャの長さのパーセンテージ基準でラインまたはポリゴンに沿ってポイント フィーチャを作成します。

使用法

• 入力フィーチャの属性は、出力フィーチャクラス内に保持されます。その出力フィーチャクラスに追加された新しいフィールド ORIG_FID は、入力フィーチャ ID に設定されます。

パラメーター

ダイアログ

ラベル	説明	データ タイプ
入力フィーチャ	ポイントに変換されるラインまたはポリゴン フィーチャ。	Feature Layer
出力フィーチャクラス	入力フィーチャから作成されるポイント フィーチャクラス。	Feature Class
ポイントの配置	ポイントの作成に使用する方法を指定します。 パーセンテージによる指定—[パーセンテージ] パラメーター値を使用して、パーセントを基準にフィーチャに沿ってポイントを配置します。 距離による指定—[距離] パラメーター値を使用して、一定の間隔でラインに沿ってポイントを配置します。 これがデフォルトです。	String
距離 (オプション)	フィーチャの始点からの間隔。指定した間隔に基づいてポイントが配置されます。	Linear Unit
パーセンテージ (オプション)	フィーチャの始点からのパーセンテージ。指定したパーセンテージに基づいてポイントが配置されます。 たとえば、パーセンテージを 40 にすると、フィーチャの距離全体の 40 パーセントと 80 パーセントの位置にポイントが配置されます。	Double
端点を含める (オプション)	フィーチャの始点と終点に追加ポイントを含めるかどうかを指定します。 オン - フィーチャの始点と終点に追加ポイントを含めます。 オフ - フィーチャの始点と終点に追加ポイントを含めません。 これがデフォルトです。	Boolean

Python

arcpy.management.GeneratePointsAlongLines(Input_Features, Output_Feature_Class, Point_Placement, {Distance}, {Percentage}, {Include_End_Points})

名前	説明	データ タイプ
Input_Features	ポイントに変換されるラインまたはポリゴン フィーチャ。	Feature Layer
Output_Feature_Class	入力フィーチャから作成されるポイント フィーチャクラス。	Feature Class
Point_Placement	ポイントの作成に使用する方法を指定します。 PERCENTAGE—Percentage パラメーター値を使用して、パーセントを基準にフィーチャに沿ってポイントを配置します。 DISTANCE—Distance パラメーター値を使用して、一定の間隔でラインに沿ってポイントを配置します。 これがデフォルトです。	String
Distance (オプション)	フィーチャの始点からの間隔。指定した間隔に基づいてポイントが配置されます。	Linear Unit
Percentage (オプション)	フィーチャの始点からのパーセンテージ。指定したパーセンテージに基づいてポイントが配置されます。 たとえば、パーセンテージを 40 にすると、フィーチャの距離全体の 40 パーセントと 80 パーセントの位置にポイントが配置されます。	Double
Include_End_Points (オプション)	フィーチャの始点と終点に追加ポイントを含めるかどうかを指定します。 END_POINTS—フィーチャの始点と終点に追加ポイントを含めます。 NO_END_POINTS—フィーチャの始点と終点に追加ポイントを含めません。 これがデフォルトです。	Boolean

コードのサンプル

GeneratePointsAlongLinese (ラインに沿ってポイントを生成) の例 1 (Python ウィンドウ)

次の Python ウィンドウ スクリプトは、イミディエイト モードで GeneratePointsAlongLines 関数を使用する方法を示しています。

import arcpy
arcpy.env.workspace = 'C:/data/base.gdb'
arcpy.GeneratePointsAlongLines_management('rivers', 'distance_intervals', 'DISTANCE', Distance='500 meters')
arcpy.GeneratePointsAlongLines_management('rivers', 'percentage_intervals', 'PERCENTAGE', Percentage=10)

GeneratePointsAlongLines (ラインに沿ってポイントを生成) の例 2 (スタンドアロン スクリプト)

次のスタンドアロン スクリプトは、GeneratePointsAlongLines の使用方法を示しています。

# Description: Convert point features to line features

import arcpy

# Set environment settings
arcpy.env.workspace = 'C:/data/base.gdb'

# Set local variables
in_features = 'rivers'
out_fc_1 = 'distance_intervals'
out_fc_2 = 'percentage_intervals'

# Execute GeneratePointsAlongLines by distance
arcpy.GeneratePointsAlongLines_management(in_features, out_fc_1, 'DISTANCE',
                                          Distance='500 meters')

# Execute GeneratePointsAlongLines by percentage
arcpy.GeneratePointsAlongLines_management(in_features, out_fc_2, 'PERCENTAGE',
                                          Percentage=10,
                                          Include_End_Points='END_POINTS')

環境

現在のワークスペース, 出力データのコンフィグレーション キーワード, 出力に M 値がある, 出力に Z 値がある

特殊なケース

ライセンス情報

• Basic: Yes
• Standard: Yes
• Advanced: Yes