Name
TopoGeo_AddLineString — Ajoute une ligne à une topologie existante en utilisant une tolérance et en divisant éventuellement les arêtes/faces existantes.
Synopsis
SETOF bigint TopoGeo_AddLineString(varchar atopology, geometry aline, float8 tolerance, int max_edges);
Description
Adds a linestring to an existing topology and returns a set of signed edge identifiers forming it up (negative identifies mean the edge goes in the opposite direction of the input linestring).
The given line will snap to existing nodes or edges within given tolerance. Existing edges and faces may be split by the line. New nodes and faces may be added, in addition to new edges.
The returned edge identifiers may be either existing edges or newly created edges as needed to fully represent the input line as closely as possible.
The number of newly created edges (either covering space previously uncovered or resulting from split of existing edges) may be limited by the max_edges parameter.
![[Note]](../images/note.png)
|
|
|
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. |
|
|
|
|
La mise à jour des statistiques sur les topologies chargées via cette fonction est du ressort de l'appelant, voir maintaining statistics during topology editing and population. |
Disponibilité : 2.0.0
Amélioration : la version 3.2.0 a ajouté la possibilité de renvoyer un identifiant signé.
Enhanced: 3.7.0 added support for limiting the number of new edges created in the topology.
Voir aussi
TopoGeo_AddPoint, TopoGeo_AddPolygon, TopoGeo_LoadGeometry, AddEdge, CreateTopology