PostGIS
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