Name
TopoGeo_AddLineString — Adds a linestring to an existing topology using a tolerance and possibly splitting existing edges/faces.
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)
|
|
|
Updating statistics about topologies being loaded via this function is up to caller, see maintaining statistics during topology editing and population. |
Availability: 2.0.0
Enhanced: 3.2.0 added support for returning signed identifier.
Enhanced: 3.7.0 added support for limiting the number of new edges created in the topology.