PostGIS 1.5.

1 Manual
277 / 315

ST_NumInteriorRing - Return the number of interior rings of the first polygon in the geometry. Synonym to ST_NumInteriorRings.
This method implements the SQL/MM specification. SQL-MM 3: 8.2.5
ST_NumInteriorRings - Return the number of interior rings of the first polygon in the geometry. This will work with both
POLYGON and MULTIPOLYGON types but only looks at the first polygon. Return NULL if there is no polygon in the
geometry. This method implements the SQL/MM specification. SQL-MM 3: 8.2.5
ST_NumPoints - Return the number of points in an ST_LineString or ST_CircularString value. This method implements the
SQL/MM specification. SQL-MM 3: 7.2.4
ST_OrderingEquals - Returns true if the given geometries represent the same geometry and points are in the same directional
order. This method implements the SQL/MM specification. SQL-MM 3: 5.1.43
ST_Overlaps - Returns TRUE if the Geometries share space, are of the same dimension, but are not completely contained by
each other. This method implements the SQL/MM specification. SQL-MM 3: 5.1.32
ST_Perimeter - Return the length measurement of the boundary of an ST_Surface or ST_MultiSurface value. (Polygon,
Multipolygon) This method implements the SQL/MM specification. SQL-MM 3: 8.1.3, 9.5.4
ST_Point - Returns an ST_Point with the given coordinate values. OGC alias for ST_MakePoint. This method implements the
SQL/MM specification. SQL-MM 3: 6.1.2
ST_PointFromText - Makes a point Geometry from WKT with the given SRID. If SRID is not given, it defaults to unknown.
This method implements the SQL/MM specification. SQL-MM 3: 6.1.8
ST_PointFromWKB - Makes a geometry from WKB with the given SRID This method implements the SQL/MM specification.
SQL-MM 3: 6.1.9
ST_PointN - Return the Nth point in the first linestring or circular linestring in the geometry. Return NULL if there is no
linestring in the geometry. This method implements the SQL/MM specification. SQL-MM 3: 7.2.5, 7.3.5
ST_PointOnSurface - Returns a POINT guaranteed to lie on the surface. This method implements the SQL/MM specification. SQL-MM 3: 8.1.5, 9.5.6. According to the specs, ST_PointOnSurface works for surface geometries (POLYGONs,
MULTIPOLYGONS, CURVED POLYGONS). So PostGIS seems to be extending what the spec allows here. Most databases
Oracle,DB II, ESRI SDE seem to only support this function for surfaces. SQL Server 2008 like PostGIS supports for all
common geometries.
ST_Polygon - Returns a polygon built from the specified linestring and SRID. This method implements the SQL/MM specification. SQL-MM 3: 8.3.2
ST_PolygonFromText - Makes a Geometry from WKT with the given SRID. If SRID is not give, it defaults to -1. This method
implements the SQL/MM specification. SQL-MM 3: 8.3.6
ST_Relate - Returns true if this Geometry is spatially related to anotherGeometry, by testing for intersections between the
Interior, Boundary and Exterior of the two geometries as specified by the values in the intersectionMatrixPattern. If no intersectionMatrixPattern is passed in, then returns the maximum intersectionMatrixPattern that relates the 2 geometries. This
method implements the SQL/MM specification. SQL-MM 3: 5.1.25
ST_SRID - Returns the spatial reference identifier for the ST_Geometry as defined in spatial_ref_sys table. This method
implements the SQL/MM specification. SQL-MM 3: 5.1.5
ST_StartPoint - Returns the first point of a LINESTRING geometry as a POINT. This method implements the SQL/MM
specification. SQL-MM 3: 7.1.3
ST_SymDifference - Returns a geometry that represents the portions of A and B that do not intersect. It is called a symmetric
difference because ST_SymDifference(A,B) = ST_SymDifference(B,A). This method implements the SQL/MM specification.
SQL-MM 3: 5.1.21
ST_Touches - Returns TRUE if the geometries have at least one point in common, but their interiors do not intersect. This
method implements the SQL/MM specification. SQL-MM 3: 5.1.28
ST_Transform - Returns a new geometry with its coordinates transformed to the SRID referenced by the integer parameter.
This method implements the SQL/MM specification. SQL-MM 3: 5.1.6

PostGIS 1.5.1 Manual

278 / 315

ST_Union - Returns a geometry that represents the point set union of the Geometries. This method implements the SQL/MM
specification. SQL-MM 3: 5.1.19 the z-index (elevation) when polygons are involved.
ST_WKBToSQL - Return a specified ST_Geometry value from Well-Known Binary representation (WKB). This is an alias
name for ST_GeomFromWKB that takes no srid This method implements the SQL/MM specification. SQL-MM 3: 5.1.36
ST_WKTToSQL - Return a specified ST_Geometry value from Well-Known Text representation (WKT). This is an alias name
for ST_GeomFromText This method implements the SQL/MM specification. SQL-MM 3: 5.1.34
ST_Within - Returns true if the geometry A is completely inside geometry B This method implements the SQL/MM specification. SQL-MM 3: 5.1.30
ST_X - Return the X coordinate of the point, or NULL if not available. Input must be a point. This method implements the
SQL/MM specification. SQL-MM 3: 6.1.3
ST_Y - Return the Y coordinate of the point, or NULL if not available. Input must be a point. This method implements the
SQL/MM specification. SQL-MM 3: 6.1.4
ST_Z - Return the Z coordinate of the point, or NULL if not available. Input must be a point. This method implements the
SQL/MM specification.

8.3 PostGIS Geography Support Functions

The functions and operators given below are PostGIS functions/operators that take as input or return as output a geography data
type object.
Note
Functions with a (T) are not native geodetic functions, and use a ST_Transform call to and from geometry to do the
operation. As a result, they may not behave as expected when going over dateline, poles, and for large geometries or
geometry pairs that cover more than one UTM zone. Basic tranform - (favoring UTM, Lambert Azimuthal (North/South),
and falling back on mercator in worst case scenario)

ST_Area - Returns the area of the surface if it is a polygon or multi-polygon. For "geometry" type area is in SRID units. For
"geography" area is in square meters.
ST_AsBinary - Return the Well-Known Binary (WKB) representation of the geometry/geography without SRID meta data.
ST_AsGML - Return the geometry as a GML version 2 or 3 element.
ST_AsGeoJSON - Return the geometry as a GeoJSON element.
ST_AsKML - Return the geometry as a KML element. Several variants. Default version=2, default precision=15
ST_AsSVG - Returns a Geometry in SVG path data given a geometry or geography object.
ST_AsText - Return the Well-Known Text (WKT) representation of the geometry/geography without SRID metadata.
ST_Buffer - (T) For geometry: Returns a geometry that represents all points whose distance from this Geometry is less than
or equal to distance. Calculations are in the Spatial Reference System of this Geometry. For geography: Uses a planar
transform wrapper. Introduced in 1.5 support for different end cap and mitre settings to control shape. buffer_style options:
quad_segs=#,endcap=round|flat|square,join=round|mitre|bevel,mitre_limit=#.#
ST_CoveredBy - Returns 1 (TRUE) if no point in Geometry/Geography A is outside Geometry/Geography B
ST_Covers - Returns 1 (TRUE) if no point in Geometry B is outside Geometry A
ST_DWithin - Returns true if the geometries are within the specified distance of one another. For geometry units are in those
of spatial reference and For geography units are in meters and measurement is defaulted to use_spheroid=true (measure around
spheroid), for faster check, use_spheroid=false to measure along sphere.