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]

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.