PostGIS

CreateTopology

Prev

8.5. Topology Constructors

Next

Name

CreateTopology — Creates a new topology schema and registers it in the topology.topology table.

Synopsis

integer +`*`+CreateTopology*(`varchar `topology_schema_name`)`;

integer +`*`+CreateTopology*(`varchar `topology_schema_name, integer srid`)`;

integer +`*`+CreateTopology*(`varchar `topology_schema_name, integer srid, double precision prec`)`;

integer +`*`+CreateTopology*(`varchar `topology_schema_name, integer srid, double precision prec, boolean hasz`)`;

Description

Creates a new topology schema with name topology_name and registers it in the topology.topology table. Topologies must be uniquely named. The topology tables (edge_data, face, node,and relation are created in the schema. It returns the id of the topology.

The srid is the spatial reference system SRID for the topology.

The tolerance prec is measured in the units of the spatial reference system. The tolerance defaults to 0.

hasz defaults to false if not specified.

This is similar to the SQL/MM ST_InitTopoGeo but has more functionality.

Availability: 1.1

Enhanced: 2.0 added the signature accepting hasZ

Examples

Create a topology schema called ma_topo that stores edges and nodes in Massachusetts State Plane-meters (SRID = 26986). The tolerance represents 0.5 meters since the spatial reference system is meter-based.

SELECT topology.CreateTopology('ma_topo', 26986, 0.5);

Create a topology for Rhode Island called ri_topo in spatial reference system State Plane-feet (SRID = 3438)

SELECT topology.CreateTopology('ri_topo', 3438) AS topoid;
topoid
------
2