Namespace for the OGR Driver Implementation of TerraLib. More...

Classes
class	DataSet
	Implementation of a DataSet for OGR data provider. More...

class	DataSource
	The OGR data source provider. More...

class	Globals
	An static class with global definitions. More...

class	SQLVisitor
	A visitor for building an SQL statement from a given Query hierarchy - OGR Driver. More...

class	Transactor

Functions
te::da::DataSource *	Build (const te::core::URI &uri)

TEOGREXPORT OGREnvelope *	Convert2OGR (const te::gm::Envelope *env)
	It converts the TerraLib Envelope to OGR Envelope.

TEOGREXPORT OGRGeometry *	Convert2OGR (const te::gm::Geometry *teGeom)
	It converts the TerraLib Geometry to OGR Geometry.

TEOGREXPORT OGRGeometry *	Convert2OGR (const te::gm::Geometry teGeom, OGRSpatialReference srs)
	It converts the TerraLib Geometry to OGR Geometry.

TEOGREXPORT OGRFeatureDefn *	Convert2OGR (te::da::DataSetType *dt)
	It converts the TerraLib DataSet Type to OGR Feature Definition.

TEOGREXPORT OGRFieldDefn *	Convert2OGR (te::dt::Property *p)
	It converts the TerraLib Property Type to OGR Field Definition.

TEOGREXPORT OGRwkbGeometryType	Convert2OGR (te::gm::GeomType geomType)
	It converts the TerraLib Geometry Type element to OGR Geometry Type.

TEOGREXPORT OGRGeomFieldDefn *	Convert2OGRGeom (te::dt::Property *p)
	It converts the TerraLib Geometric Property Type to OGR Geometric Field Definition.

TEOGREXPORT OGRSpatialReference *	Convert2OGRProjection (int srid)
	It converts the TerraLib Projection to OGR Projection.

TEOGREXPORT te::gm::Envelope *	Convert2TerraLib (const OGREnvelope *env)
	It converts the OGR Envelope to TerraLib Envelope.

TEOGREXPORT te::da::DataSetType *	Convert2TerraLib (OGRFeatureDefn *featDef, const std::string &geometryPropertyName, int srs=TE_UNKNOWN_SRS)
	It converts the OGR Feature Definition to TerraLib DataSet Type.

TEOGREXPORT void	Convert2TerraLib (OGRFeatureDefn featDef, te::da::DataSetType dt, const std::string &geometryPropertyName, int srs=TE_UNKNOWN_SRS)
	It inserts a OGR Feature Definition to TerraLib DataSet Type.

TEOGREXPORT te::dt::Property *	Convert2TerraLib (OGRFieldDefn *fieldDef)
	It converts the OGR Field Definition to TerraLib Property Type.

TEOGREXPORT te::gm::Geometry *	Convert2TerraLib (OGRGeometry *ogrGeom)
	It converts the OGR Geometry to TerraLib Geometry.

TEOGREXPORT te::gm::GeomType	Convert2TerraLib (OGRwkbGeometryType ogrGeomType)
	It converts the OGR Geometry Type element to TerraLib Geometry Type.

TEOGREXPORT int	Convert2TerraLibProjection (const OGRSpatialReference &osrs)
	It converts the OGR Projection to TerraLib Projection.

TEOGREXPORT int	Convert2TerraLibProjection (OGRSpatialReference *osrs)
	It converts the OGR Projection to TerraLib Projection.

TEOGREXPORT GDALDataset *	CreateGDALDataSet (const std::string &pszFilename, unsigned int nOpenFlags)
	Creates a GDALDataSet based on the given fileName and open flags. The main purpose of this function is to ensure that known files with extensions will be open if the correct drivers.

TEOGREXPORT OGRLayer *	ExecuteSQL (GDALDataset *gdalDataSet, const std::string &query)
	Executes the given query in the given dataSet. Throws exception in case of error. It also handles FID for specific drivers.

TEOGREXPORT te::da::DataSetType *	GetDataSetType (GDALDataset gdalDataSet, OGRLayer ogrLayer, int srs=TE_UNKNOWN_SRS)
	It converts the OGR Feature Definition to TerraLib DataSet Type. It also handles FID and Geometry property issues.

std::string	GetDriverName (const std::string &path)
	It tries extract the driver name used by OGR Library based on the given path.

TEOGREXPORT std::string	GetOGRConnectionInfo (const std::map< std::string, std::string > &connInfo)

TEOGREXPORT std::vector< std::string >	GetOGRDrivers (bool filterCreate=false)
	It returns the list of OGR Drivers available.

TEOGREXPORT boost::mutex &	getStaticMutex ()
	Returns a reference to a static mutex initialized when this module is initialized.

bool	InitValidator (te::da::FieldNameValidator &validator, OGRFeatureDefn *ogrFeatureDefinition)

void	OGRErrorHandler (CPLErr eErrClass, int errNo, const char *msg)

TEOGREXPORT std::string	RemoveSpatialSql (const std::string &sql)

Detailed Description

Namespace for the OGR Driver Implementation of TerraLib.

Function Documentation

◆ Build()

te::da::DataSource * te::ogr::Build ( const te::core::URI & uri )

◆ Convert2OGR() [1/6]

TEOGREXPORT OGREnvelope * te::ogr::Convert2OGR ( const te::gm::Envelope * env )

It converts the TerraLib Envelope to OGR Envelope.

Parameters

env	A valid TerraLib Envelope.

Returns: A valid OGR Envelope.

Note: The caller of this function will take the ownership of the returned OGR Envelope.

◆ Convert2OGR() [2/6]

TEOGREXPORT OGRGeometry * te::ogr::Convert2OGR ( const te::gm::Geometry * teGeom )

It converts the TerraLib Geometry to OGR Geometry.

Parameters

teGeom A valid TerraLib Geometry.

Returns: A valid TerraLib geometry.

Exceptions

Exception It throws an exception if the TerraLib geometry can not be converted.

Note: It uses the WKB to create the TerraLib Geometry; The caller of this function will take the ownership of the returned OGR Geometry.

◆ Convert2OGR() [3/6]

TEOGREXPORT OGRGeometry * te::ogr::Convert2OGR	(	const te::gm::Geometry *	teGeom,
		OGRSpatialReference *	srs
	)

It converts the TerraLib Geometry to OGR Geometry.

Parameters

teGeom	A valid TerraLib Geometry.
srs	OGR srs information. It must not be const so it can be shared with the created geometry without the need of copying it.

Returns: A valid TerraLib geometry.

Exceptions

Exception It throws an exception if the TerraLib geometry can not be converted.

Note: It uses the WKB to create the TerraLib Geometry; The caller of this function will take the ownership of the returned OGR Geometry.

◆ Convert2OGR() [4/6]

TEOGREXPORT OGRFeatureDefn * te::ogr::Convert2OGR ( te::da::DataSetType * dt )

It converts the TerraLib DataSet Type to OGR Feature Definition.

Parameters

dt	A valid TerraLib DataSet Type.

Returns: A valid OGR Feature Definition.

Exceptions

Exception It throws an exception if the data set type can not be converted.

Note: It uses the method that converts a TerraLib Property Type to OGR Field Definition.; The caller of this function will take the ownership of the returned OGR Feature Definition.

◆ Convert2OGR() [5/6]

TEOGREXPORT OGRFieldDefn * te::ogr::Convert2OGR ( te::dt::Property * p )

It converts the TerraLib Property Type to OGR Field Definition.

Parameters

pt	A valid TerraLib Property Type.

Returns: A valid OGR Field Definition.

Exceptions

Exception It throws an exception if the data type is not supported by OGR.

◆ Convert2OGR() [6/6]

TEOGREXPORT OGRwkbGeometryType te::ogr::Convert2OGR ( te::gm::GeomType geomType )

It converts the TerraLib Geometry Type element to OGR Geometry Type.

Parameters

geomType A valid TerraLib Geometry Type.

Returns: A valid OGR Geometry Type element

Exceptions

Exception It throws an exception if the geometry type is not supported by OGR.

◆ Convert2OGRGeom()

TEOGREXPORT OGRGeomFieldDefn * te::ogr::Convert2OGRGeom ( te::dt::Property * p )

It converts the TerraLib Geometric Property Type to OGR Geometric Field Definition.

Parameters

pt	A valid TerraLib Geometric Property Type.

Returns: A valid OGR Geometric Field Definition.

Exceptions

Exception It throws an exception if the data type is not supported by OGR.

◆ Convert2OGRProjection()

TEOGREXPORT OGRSpatialReference * te::ogr::Convert2OGRProjection ( int srid )

It converts the TerraLib Projection to OGR Projection.

Parameters

srid	A valid TerraLib Projection id.

Returns: A valid OGR Spatial Reference System.

Exceptions

Exception It throws an exception if the SRS can not be imported using OGR.

Note: The caller of this function will take the ownership of the returned OGR Spatial Reference System.

◆ Convert2TerraLib() [1/6]

TEOGREXPORT te::gm::Envelope * te::ogr::Convert2TerraLib ( const OGREnvelope * env )

It converts the OGR Envelope to TerraLib Envelope.

Parameters

env	A valid OGR Envelope.

Returns: A valid TerraLib Envelope.

Note: The caller of this function will take the ownership of the returned TerraLib Envelope.

◆ Convert2TerraLib() [2/6]

TEOGREXPORT te::da::DataSetType * te::ogr::Convert2TerraLib	(	OGRFeatureDefn *	featDef,
		const std::string &	geometryPropertyName,
		int	srs = `TE_UNKNOWN_SRS`
	)

It converts the OGR Feature Definition to TerraLib DataSet Type.

Parameters

featDef	A valid OGR Feature Definition.
srs	Optional parameter to set the SRS of geometry fields.
geometryPropertyName	A geomtry property name to force or an empty string to automatically find this value.

Returns: A valid TerraLib DataSet Type.

Exceptions

Exception It throws an exception if the feature definition can not be converted.

Note: It uses the method that converts a OGR Field Definition to TerraLib Property Type.; It uses the method that converts a OGR Geometry Type to TerraLib Geometry Type.; The caller of this function will take the ownership of the returned TerraLib DataSet Type.

◆ Convert2TerraLib() [3/6]

TEOGREXPORT void te::ogr::Convert2TerraLib	(	OGRFeatureDefn *	featDef,
		te::da::DataSetType *	dt,
		const std::string &	geometryPropertyName,
		int	srs = `TE_UNKNOWN_SRS`
	)

It inserts a OGR Feature Definition to TerraLib DataSet Type.

Parameters

featDef	A valid OGR Feature Definition.
dt	Pointer to a TerraLib dataset type previously created. Do not pass NULL.
srs	Optional parameter to set the SRS of geometry fields.
geometryPropertyName	A geomtry property name to force or an empty string to automatically find this value.

Exceptions

Exception It throws an exception if the feature definition can not be converted.

Note: It uses the method that converts a OGR Field Definition to TerraLib Property Type.; It uses the method that converts a OGR Geometry Type to TerraLib Geometry Type.

◆ Convert2TerraLib() [4/6]

TEOGREXPORT te::dt::Property * te::ogr::Convert2TerraLib ( OGRFieldDefn * fieldDef )

It converts the OGR Field Definition to TerraLib Property Type.

Parameters

fieldDef A valid OGR Field Definition.

Returns: A valid TerraLib Property Type.

Exceptions

Exception It throws an exception if the data type is not supported by TerraLib.

Note: The caller of this function will take the ownership of the returned TerraLib Property Type.

◆ Convert2TerraLib() [5/6]

TEOGREXPORT te::gm::Geometry * te::ogr::Convert2TerraLib ( OGRGeometry * ogrGeom )

It converts the OGR Geometry to TerraLib Geometry.

Parameters

ogrGeom A valid OGR Geometry.

Returns: A valid TerraLib Geometry.

Exceptions

Exception It throws an exception if the OGR geometry can not be converted.

Note: It uses the WKB to create the TerraLib Geometry; The caller of this function will take the ownership of the returned TerraLib Geometry.

◆ Convert2TerraLib() [6/6]

TEOGREXPORT te::gm::GeomType te::ogr::Convert2TerraLib ( OGRwkbGeometryType ogrGeomType )

It converts the OGR Geometry Type element to TerraLib Geometry Type.

Parameters

ogrGeomType A valid OGR Geometry Type element.

Returns: A valid TerraLib Geometry Type

◆ Convert2TerraLibProjection() [1/2]

TEOGREXPORT int te::ogr::Convert2TerraLibProjection ( const OGRSpatialReference & osrs )

It converts the OGR Projection to TerraLib Projection.

Parameters

osrs	A valid OGR Projection.

Returns: An SRS id recognized by TerraLib or an indication of unknown SRS (TE_UNKNOWN_SRS)

◆ Convert2TerraLibProjection() [2/2]

TEOGREXPORT int te::ogr::Convert2TerraLibProjection ( OGRSpatialReference * osrs )

It converts the OGR Projection to TerraLib Projection.

Parameters

osrs	A valid OGR Projection.

Returns: An SRS id recognized by TerraLib or an indication of unknown SRS (TE_UNKNOWN_SRS)

◆ CreateGDALDataSet()

TEOGREXPORT GDALDataset * te::ogr::CreateGDALDataSet	(	const std::string &	pszFilename,
		unsigned int	nOpenFlags
	)

Creates a GDALDataSet based on the given fileName and open flags. The main purpose of this function is to ensure that known files with extensions will be open if the correct drivers.

◆ ExecuteSQL()

TEOGREXPORT OGRLayer * te::ogr::ExecuteSQL	(	GDALDataset *	gdalDataSet,
		const std::string &	query
	)

Executes the given query in the given dataSet. Throws exception in case of error. It also handles FID for specific drivers.

Initialized the validator from the given layer definition

◆ GetDataSetType()

TEOGREXPORT te::da::DataSetType * te::ogr::GetDataSetType	(	GDALDataset *	gdalDataSet,
		OGRLayer *	ogrLayer,
		int	srs = `TE_UNKNOWN_SRS`
	)

It converts the OGR Feature Definition to TerraLib DataSet Type. It also handles FID and Geometry property issues.

Parameters

ogrLayer	A valid OGR Layer.
srs	Optional parameter to set the SRS of geometry fields.

Returns: A valid TerraLib DataSet Type.

Exceptions

Exception It throws an exception if the feature definition can not be converted.

Note: It uses the method that converts a OGR Field Definition to TerraLib Property Type.; It uses the method that converts a OGR Geometry Type to TerraLib Geometry Type.; The caller of this function will take the ownership of the returned TerraLib DataSet Type.

◆ GetDriverName()

std::string te::ogr::GetDriverName ( const std::string & path )

It tries extract the driver name used by OGR Library based on the given path.

Parameters

path	The path that will be consulted.

Returns: The driver name used by OGR Library or an empty string if not possible extract the driver name.

◆ GetOGRConnectionInfo()

TEOGREXPORT std::string te::ogr::GetOGRConnectionInfo ( const std::map< std::string, std::string > & connInfo )

◆ GetOGRDrivers()

TEOGREXPORT std::vector< std::string > te::ogr::GetOGRDrivers ( bool filterCreate = false )

It returns the list of OGR Drivers available.

Parameters

filterCreate Set TRUE to indicate to retrieve only the drivers with the capacity to create datasources.

Returns: A list of OGR Drivers.

◆ getStaticMutex()

TEOGREXPORT boost::mutex & te::ogr::getStaticMutex ( )

Returns a reference to a static mutex initialized when this module is initialized.

Returns: Returns a reference to a static mutex initialized when this module is initialized.

◆ InitValidator()

bool te::ogr::InitValidator	(	te::da::FieldNameValidator &	validator,
		OGRFeatureDefn *	ogrFeatureDefinition
	)

◆ OGRErrorHandler()

void te::ogr::OGRErrorHandler	(	CPLErr	eErrClass,
		int	errNo,
		const char *	msg
	)

◆ RemoveSpatialSql()

TEOGREXPORT std::string te::ogr::RemoveSpatialSql ( const std::string & sql )

Classes

Functions

Detailed Description

Function Documentation

◆ Build()

◆ Convert2OGR() [1/6]

◆ Convert2OGR() [2/6]

◆ Convert2OGR() [3/6]

◆ Convert2OGR() [4/6]

◆ Convert2OGR() [5/6]

◆ Convert2OGR() [6/6]

◆ Convert2OGRGeom()

◆ Convert2OGRProjection()

◆ Convert2TerraLib() [1/6]

◆ Convert2TerraLib() [2/6]

◆ Convert2TerraLib() [3/6]

◆ Convert2TerraLib() [4/6]

◆ Convert2TerraLib() [5/6]

◆ Convert2TerraLib() [6/6]

◆ Convert2TerraLibProjection() [1/2]

◆ Convert2TerraLibProjection() [2/2]

◆ CreateGDALDataSet()

◆ ExecuteSQL()

◆ GetDataSetType()

◆ GetDriverName()

◆ GetOGRConnectionInfo()

◆ GetOGRDrivers()

◆ getStaticMutex()

◆ InitValidator()

◆ OGRErrorHandler()

◆ RemoveSpatialSql()