Name

TopoGeo_AddLineString — 許容差を使って既存のトポロジにラインストリングを追加し、可能ならエッジ/フェイスを分割します。

Synopsis

SETOF bigint TopoGeo_AddLineString(varchar atopology, geometry aline, float8 tolerance, int max_edges);

説明

ラインストリングを既存のトポロジーに追加して、整列させた符号付エッジ識別番号を返します (負数は入力ラインストリングと逆方向であることを示します)。

与えられたラインは与えられた許容値内にある既存のノードまたはエッジにスナップします。既存のエッジとフェイスはラインで分割される場合があります。新規エッジ追加に加えて、新しいノードとフェイスが追加される場合があります。

返されるエッジ識別番号は、入力ラインを可能な限り忠実になるような表現を完全に行うために、既存のエッジまたは新規生成されるエッジのいずれかの番号になります。

新規生成されるエッジ (及んでいなかった範囲の空間に及ぶか、既存エッジの分割から得られた結果)の数は max_edgesパラメータで制限されます。

[Note]

When adding many lines, the load order can have a large impact on performance because each call checks the line against topology elements already loaded. In bulk workflows, adding large closed or enclosing lines before smaller contained lines can avoid expensive later splits. For loading a collection in one call, see TopoGeo_LoadGeometry.

[Note]

この関数を介してロードされたトポロジの統計情報の更新は呼び出し元次第です。maintaining statistics during topology editing and populationをご覧下さい。

Availability: 2.0.0

Enhanced: 3.2.0 符号付き識別子を返す機能が追加されました。

Enhanced: 3.7.0 トポロジー内で生成されるエッジ数の制限機能の追加。