User's Guide and Reference

GeometryFromShape

GeometryFromShape takes a shape and a spatial reference system identity to return a geometry object.

Syntax

db2gse.GeometryFromShape(ShapeGeometry Blob(1M), cr db2gse.coordref)

Return type

db2gse.ST_Geometry

Examples

The following C code fragment contains ODBC functions embedded with DB2 Spatial Extender SQL functions that insert data into the LOTS table.

The LOTS table was created with two columns: the LOT_ID column, which uniquely identifies each lot, and the LOT polygon column, which contains the geometry of each lot.

CREATE TABLE LOTS ( lot_id  integer,
                    lot     db2gse.ST_MultiPolygon);

The GeometryFromShape function converts shapes into DB2 Spatial Extender geometry. The entire INSERT statement is copied into shp_sql. The INSERT statement contains parameter markers to accept the LOT_ID data and the LOT data dynamically.

/* Create the SQL insert statement to populate the lot id and the
  lot multipolygon. The question marks are parameter markers that
  indicate the lot_id and lot values that will be retrieved at
  runtime. */
strcpy (shp_sql,"insert into LOTS (lot_id, lot) values (?, db2gse.GeometryFromShape
(cast(? as blob(1m)), db2gse.coordref()..srid(0)))");
 
/* Allocate memory for the SQL statement handle and associate the
   statement handle with the connection handle. */
rc = SQLAllocStmt (handle, &hstmt);
 
/* Prepare the SQL statement for execution. */
rc = SQLPrepare (hstmt, (unsigned char *)shp_sql, SQL_NTS);
 
/* Bind the integer key value to the first parameter. */
pcbvalue1 = 0;
rc = SQLBindParameter (hstmt, 1, SQL_PARAM_INPUT, SQL_C_SLONG,
     SQL_INTEGER, 0, 0, &lot_id, 0, &pcbvalue1);
 
/* Bind the shape to the second parameter. */
pcbvalue2 = blob_len;
rc = SQLBindParameter (hstmt, 2, SQL_PARAM_INPUT, SQL_C_BINARY,
     SQL_BLOB, blob_len, 0, shape_blob, blob_len, &pcbvalue2);
 
/* Execute the insert statement. */
rc = SQLExecute (hstmt);
 


[ Top of Page | Previous Page | Next Page ]