Geospatial functions
Geospatial functions manipulate complex two-dimensional spatial objects and store them in a database according to the Open Geospatial Consortium (OGC) standards.
Function naming conventions
The geospatial functions use the following naming conventions:
-
Most ST_
function-name
functions are compliant with the latest OGC standard OGC SFA-SQL version 1.2.1 (reference. number is OGC 06-104r4, date: 2010-08-04). Currently, some ST_function-name
functions may not support all data types. Each function page contains details about the supported data types.Note
Some functions, such as ST_GeomFromText, are based on previous versions of the standard. -
The STV_
function-name
functions are unique to Vertica and not compliant with OGC standards. Each function page explains its functionality in detail.
Verifying spatial objects validity
Many spatial functions do not validate their parameters. If you pass an invalid spatial object to an ST_ or STV_ function, the function might return an error or produce incorrect results.
To avoid this issue, Vertica recommends that you first run ST_IsValid on all spatial objects to validate the parameters. If your object is not valid, run STV_IsValidReason to get information about the location of the invalidity.
In this section
- ST_Area
- ST_AsBinary
- ST_AsText
- ST_Boundary
- ST_Buffer
- ST_Centroid
- ST_Contains
- ST_ConvexHull
- ST_Crosses
- ST_Difference
- ST_Disjoint
- ST_Distance
- ST_Envelope
- ST_Equals
- ST_GeographyFromText
- ST_GeographyFromWKB
- ST_GeoHash
- ST_GeometryN
- ST_GeometryType
- ST_GeomFromGeoHash
- ST_GeomFromGeoJSON
- ST_GeomFromText
- ST_GeomFromWKB
- ST_Intersection
- ST_Intersects
- ST_IsEmpty
- ST_IsSimple
- ST_IsValid
- ST_Length
- ST_NumGeometries
- ST_NumPoints
- ST_Overlaps
- ST_PointFromGeoHash
- ST_PointN
- ST_Relate
- ST_SRID
- ST_SymDifference
- ST_Touches
- ST_Transform
- ST_Union
- ST_Within
- ST_X
- ST_XMax
- ST_XMin
- ST_Y
- ST_YMax
- ST_YMin
- STV_AsGeoJSON
- STV_Create_Index
- STV_Describe_Index
- STV_Drop_Index
- STV_DWithin
- STV_Export2Shapefile
- STV_Extent
- STV_ForceLHR
- STV_Geography
- STV_GeographyPoint
- STV_Geometry
- STV_GeometryPoint
- STV_GetExportShapefileDirectory
- STV_Intersect scalar function
- STV_Intersect transform function
- STV_IsValidReason
- STV_LineStringPoint
- STV_MemSize
- STV_NN
- STV_PolygonPoint
- STV_Refresh_Index
- STV_Rename_Index
- STV_Reverse
- STV_SetExportShapefileDirectory
- STV_ShpCreateTable
- STV_ShpSource and STV_ShpParser