Chapter 12. PostGIS Special Functions Index

Table of Contents
12.1. PostGIS Aggregate Functions
12.2. PostGIS Window Functions
12.3. PostGIS SQL-MM Compliant Functions
12.4. PostGIS Geography Support Functions
12.5. PostGIS Raster Support Functions
12.6. PostGIS Geometry / Geography / Raster Dump Functions
12.7. PostGIS Box Functions
12.8. PostGIS Functions that support 3D
12.9. PostGIS Curved Geometry Support Functions
12.10. PostGIS Polyhedral Surface Support Functions
12.11. PostGIS Function Support Matrix
12.12. New, Enhanced or changed PostGIS Functions
12.12.1. PostGIS Functions new or enhanced in 3.4
12.12.2. PostGIS Functions new or enhanced in 3.3
12.12.3. PostGIS Functions new or enhanced in 3.2
12.12.4. PostGIS Functions new or enhanced in 3.1
12.12.5. PostGIS Functions new or enhanced in 3.0
12.12.6. PostGIS Functions new or enhanced in 2.5
12.12.7. PostGIS Functions new or enhanced in 2.4
12.12.8. PostGIS Functions new or enhanced in 2.3
12.12.9. PostGIS Functions new or enhanced in 2.2
12.12.10. PostGIS Functions new or enhanced in 2.1
12.12.11. PostGIS Functions new or enhanced in 2.0
12.12.12. PostGIS Functions new or enhanced in 1.5
12.12.13. PostGIS Functions new or enhanced in 1.4
12.12.14. PostGIS Functions new or enhanced in 1.3

12.1. PostGIS Aggregate Functions

The functions below are spatial aggregate functions that are used in the same way as SQL aggregate function such as sum and average.

  • ST_3DExtent - Aggregate function that returns the 3D bounding box of geometries.
  • ST_3DUnion - Perform 3D union.
  • ST_AsFlatGeobuf - Return a FlatGeobuf representation of a set of rows.
  • ST_AsGeobuf - Return a Geobuf representation of a set of rows.
  • ST_AsMVT - Aggregate function returning a MVT representation of a set of rows.
  • ST_ClusterIntersecting - Aggregate function that clusters input geometries into connected sets.
  • ST_ClusterWithin - Aggregate function that clusters geometries by separation distance.
  • ST_Collect - Creates a GeometryCollection or Multi* geometry from a set of geometries.
  • ST_CoverageUnion - Computes the union of a set of polygons forming a coverage by removing shared edges.
  • ST_Extent - Aggregate function that returns the bounding box of geometries.
  • ST_MakeLine - 포인트, 멀티포인트 또는 라인 도형으로부터 라인스트링을 생성합니다.
  • ST_MemUnion - Aggregate function which unions geometries in a memory-efficent but slower way
  • ST_Polygonize - Computes a collection of polygons formed from the linework of a set of geometries.
  • ST_SameAlignment - 래스터들이 동일한 기울기, 축척, 공간 참조 시스템, 그리고 오프셋을 가지고 있을 경우 (픽셀이 다른 픽셀을 침범하지 않고 동일한 그리드에 놓일 수 있을 경우) 참을 반환하고, 그렇지 않을 경우 문제점을 설명하는 안내문과 함께 거짓을 반환합니다.
  • ST_Union - Computes a geometry representing the point-set union of the input geometries.
  • TopoElementArray_Agg - Returns a topoelementarray for a set of element_id, type arrays (topoelements).

12.2. PostGIS Window Functions

The functions below are spatial window functions that are used in the same way as SQL window functions such as row_number(), lead(), and lag(). They must be followed by an OVER() clause.

  • ST_ClusterDBSCAN - Window function that returns a cluster id for each input geometry using the DBSCAN algorithm.
  • ST_ClusterIntersectingWin - Window function that returns a cluster id for each input geometry, clustering input geometries into connected sets.
  • ST_ClusterKMeans - Window function that returns a cluster id for each input geometry using the K-means algorithm.
  • ST_ClusterWithinWin - Window function that returns a cluster id for each input geometry, clustering using separation distance.
  • ST_CoverageInvalidEdges - Window function that finds locations where polygons fail to form a valid coverage.
  • ST_CoverageSimplify - Window function that simplifies the edges of a polygonal coverage.

12.3. PostGIS SQL-MM Compliant Functions

The functions given below are PostGIS functions that conform to the SQL/MM 3 standard

  • ST_3DArea - 3차원 표면 도형의 면적을 계산합니다. 입체일 경우 0을 반환할 것입니다. 설명 2.1.0 버전부터 사용할 수 있습니다. This method needs SFCGAL backend. This method implements the SQL/MM specification. SQL-MM IEC 13249-3: 8.1, 10.5 This function supports 3d and will not drop the z-index. This function supports Polyhedral surfaces. This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
  • ST_3DDWithin - Tests if two 3D geometries are within a given 3D distance Description Returns true if the 3D distance between two geometry values is no larger than distance distance_of_srid. The distance is specified in units defined by the spatial reference system of the geometries. For this function to make sense the source geometries must be in the same coordinate system (have the same SRID). This function automatically includes a bounding box comparison that makes use of any spatial indexes that are available on the geometries. This function supports 3d and will not drop the z-index. This function supports Polyhedral surfaces. This method implements the SQL/MM specification. SQL-MM ? Availability: 2.0.0
  • ST_3DDifference - 3차원 차이를 수행합니다. 설명 geom2의 일부분이 아닌 geom1의 부분을 반환합니다. 2.2.0 버전부터 사용할 수 있습니다. This method needs SFCGAL backend. This method implements the SQL/MM specification. SQL-MM IEC 13249-3: 5.1 This function supports 3d and will not drop the z-index. This function supports Polyhedral surfaces. This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
  • ST_3DDistance - 도형 유형에 대해, 두 도형 사이의 (SRS에 기반한) 3차원 데카르트 최단 거리를 투영 단위로 반환합니다. 설명 도형 유형에 대해, 두 도형 사이의 3차원 데카르트 최단 거리를 두 도형의 투영 단위(SRS 단위)로 반환합니다. This function supports 3d and will not drop the z-index. This function supports Polyhedral surfaces. This method implements the SQL/MM specification. SQL-MM ISO/IEC 13249-3 2.0.0 버전부터 사용할 수 있습니다. 변경 사항: 2.2.0 버전부터, 2D 및 3D의 경우 더 이상 Z가 없을 때 Z를 0으로 가정하지 않습니다. Changed: 3.0.0 - SFCGAL version removed
  • ST_3DIntersection - 3차원 교차를 수행합니다. 설명 geom1과 geom2가 공유하는 부분을 도형으로 반환합니다. 2.1.0 버전부터 사용할 수 있습니다. This method needs SFCGAL backend. This method implements the SQL/MM specification. SQL-MM IEC 13249-3: 5.1 This function supports 3d and will not drop the z-index. This function supports Polyhedral surfaces. This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
  • ST_3DIntersects - Tests if two geometries spatially intersect in 3D - only for points, linestrings, polygons, polyhedral surface (area) Description Overlaps, Touches, Within all imply spatial intersection. If any of the aforementioned returns true, then the geometries also spatially intersect. Disjoint implies false for spatial intersection. This function automatically includes a bounding box comparison that makes use of any spatial indexes that are available on the geometries. Changed: 3.0.0 SFCGAL backend removed, GEOS backend supports TINs. Availability: 2.0.0 This function supports 3d and will not drop the z-index. This function supports Polyhedral surfaces. This function supports Triangles and Triangulated Irregular Network Surfaces (TIN). This method implements the SQL/MM specification. SQL-MM IEC 13249-3: 5.1
  • ST_3DLength - 도형의 기하학적 중심을 반환합니다. 설명 도형이 라인스트링 또는 멀티라인스트링일 경우 도형의 3차원 또는 2차원 길이를 반환합니다. 2차원 라인의 경우 2차원 길이만 반환할 것입니다(ST_Length 및 ST_Length2D와 동일합니다). This function supports 3d and will not drop the z-index. This method implements the SQL/MM specification. SQL-MM IEC 13249-3: 7.1, 10.3 변경 사항: 2.0.0 미만 버전에서는 ST_Length3D라는 명칭이었습니다.
  • ST_3DPerimeter - 도형의 기하학적 중심을 반환합니다. 설명 도형이 폴리곤 또는 멀티폴리곤일 경우 도형의 3차원 둘레를 반환합니다. 2차원 도형의 경우 2차원 둘레를 반환할 것입니다. This function supports 3d and will not drop the z-index. This method implements the SQL/MM specification. SQL-MM ISO/IEC 13249-3: 8.1, 10.5 변경 사항: 2.0.0 미만 버전에서는 ST_Perimeter3D라는 명칭이었습니다.
  • ST_3DUnion - Perform 3D union. 설명 2.2.0 버전부터 사용할 수 있습니다. Availability: 3.3.0 aggregate variant was added This method needs SFCGAL backend. This method implements the SQL/MM specification. SQL-MM IEC 13249-3: 5.1 This function supports 3d and will not drop the z-index. This function supports Polyhedral surfaces. This function supports Triangles and Triangulated Irregular Network Surfaces (TIN). Aggregate variant: returns a geometry that is the 3D union of a rowset of geometries. The ST_3DUnion() function is an "aggregate" function in the terminology of PostgreSQL. That means that it operates on rows of data, in the same way the SUM() and AVG() functions do and like most aggregates, it also ignores NULL geometries.
  • ST_AddEdgeModFace - 새 경계선을 추가하고, 그 과정에서 경계선이 표면을 분할할 경우, 원본 표면을 수정하고 새 표면을 추가합니다. 설명 새 경계선을 추가하고, 그 과정에서 경계선이 표면을 분할할 경우, 원본 표면을 수정하고 새 표면을 추가합니다. 가능한 경우, 새 경계선의 왼쪽에 새 표면을 생성할 것입니다. 왼쪽의 표면이 (무한한) 세계 표면(universe face)이어야 할 경우 이는 불가능할 것입니다. 새로 추가된 경계선의 ID를 반환합니다. 모든 기존의 결합된 경계선 및 관계성을 결과에 맞춰 업데이트합니다. 어떤 인수가 NULL일 경우, 주어진 노드들이 알려지지 않은 경우(노드가 이미 지형 스키마의 node 테이블에 존재해야 합니다), acurve 가 LINESTRING 이 아닐 경우, anode 와 anothernode 가 acurve 의 시작점 및 종단점이 아닐 경우 오류가 발생합니다. acurve 도형과 지형의 공간 참조 시스템(SRID)이 다를 경우 예외가 발생합니다. 2.0 버전부터 사용할 수 있습니다. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.13
  • ST_AddEdgeNewFaces - 새 경계선을 추가하고, 그 과정에서 경계선이 표면을 분할할 경우, 원본 표면을 삭제하고 새 표면 2개로 교체합니다. 설명 새 경계선을 추가하고, 그 과정에서 경계선이 표면을 분할할 경우, 원본 표면을 삭제하고 새 표면 2개로 교체합니다. 새로 추가된 경계선의 ID를 반환합니다. 모든 기존의 결합된 경계선 및 관계성을 결과에 맞춰 업데이트합니다. 어떤 인수가 NULL일 경우, 주어진 노드들이 알려지지 않은 경우(노드가 이미 지형 스키마의 node 테이블에 존재해야 합니다), acurve 가 LINESTRING 이 아닐 경우, anode 와 anothernode 가 acurve 의 시작점 및 종단점이 아닐 경우 오류가 발생합니다. acurve 도형과 지형의 공간 참조 시스템(SRID)이 다를 경우 예외가 발생합니다. 2.0 버전부터 사용할 수 있습니다. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.12
  • ST_AddIsoEdge - 지형에 두 개의 고립된 기존 노드 anode 와 anothernode 를 연결하는 alinestring 도형이 정의하는 고립된 경계선을 추가하고 새 경계선의 ID를 반환합니다. 설명 지형에 두 개의 고립된 기존 노드 anode 와 anothernode 를 연결하는 alinestring 도형이 정의하는 고립된 경계선을 추가하고 새 경계선의 ID(edgeid)를 반환합니다. alinestring 도형과 지형의 공간 참조 시스템(SRID)이 다를 경우, 입력 인수 가운데 하나라도 NULL일 경우, 하나 이상의 표면이 노드를 담고 있을 경우, 또는 노드가 기존 경계선의 시작 또는 종단 노드일 경우, 예외가 발생합니다. alinestring 이 anode 와 anothernode 가 속해 있는 표면 내부에 없을 경우, 예외가 발생합니다. anode 와 anothernode 가 alinestring 의 시작점 및 종단점이 아닐 경우 예외가 발생합니다. Availability: 1.1 This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.4
  • ST_AddIsoNode - 지형 안의 표면에 고립된(isolated) 노드를 추가하고 새 노드의 ID를 반환합니다. 표면이 NULL일 경우, 그래도 노드를 생성합니다. 설명 atopology 지형의 aface ID(faceid)를 가진 기존 표면에 포인트 위치가 apoint 인 고립된 노드를 추가하고 새 노드의 ID(nodeid)를 반환합니다. 포인트 도형과 지형의 공간 참조 시스템(SRID)이 다를 경우, apoint 가 포인트 도형이 아닐 경우, 포인트가 NULL일 경우, 또는 포인트가 기존 경계선과 (또는 외곽선일지라도) 교차하는 경우 예외가 발생합니다. 해당 포인트의 위치에 이미 노드가 존재할 경우에도 예외가 발생합니다. aface 가 NULL이 아닌데 apoint 가 표면 내부에 있지 않을 경우, 예외가 발생합니다. Availability: 1.1 This method implements the SQL/MM specification. SQL-MM: Topo-Net Routines: X+1.3.1
  • ST_Area - 도형의 기하학적 중심을 반환합니다. 설명 도형이 폴리곤이나 멀티폴리곤일 경우 표면의 면적을 - ST_Surface 또는 ST_MultiSurface 함수의 면적 측정값을 - 반환합니다. 도형 유형의 경우, SRID가 지정한 단위로 2차원 데카르트 면적을 구합니다. 지리형 유형의 경우, 평방미터 단위로 곡면(curved surface)의 면적을 구합니다. 구체의 면적에 대해 덜 정확하지만 더 빠르게 측정하려면, ST_Area(geog,false) 함수를 이용하십시오. 개선 사항: 2.0.0 버전부터 2차원 다면체 표면(polyhedral surface)을 지원합니다. 개선 사항: 2.2.0 버전부터 회전타원체 측정시 정확도와 강력함을 향상시키기 위해 GeographicLib을 이용합니다. 이 새 기능의 장점을 취하려면 Proj 4.9.0 이상 버전이 필요합니다. Changed: 3.0.0 - does not depend on SFCGAL anymore. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. This method implements the SQL/MM specification. SQL-MM 3: 8.1.2, 9.5.3 This function supports Polyhedral surfaces. 다면체 표면의 경우, (2.5차원이 아니라) 2차원 다면체 표면만 지원합니다. 2.5차원일 경우 0이 아닌(non-zero) 답을 내놓을 수도 있지만, XY 평면상에 완벽하게 놓이는 면들의 면적만 반환하는 것입니다.
  • ST_AsBinary - Return the OGC/ISO Well-Known Binary (WKB) representation of the geometry/geography without SRID meta data. 설명 Returns the OGC/ISO Well-Known Binary (WKB) representation of the geometry. The first function variant defaults to encoding using server machine endian. The second function variant takes a text argument specifying the endian encoding, either little-endian ('NDR') or big-endian ('XDR'). WKB format is useful to read geometry data from the database and maintaining full numeric precision. This avoids the precision rounding that can happen with text formats such as WKT. To perform the inverse conversion of WKB to PostGIS geometry use . The OGC/ISO WKB format does not include the SRID. To get the EWKB format which does include the SRID use The default behavior in PostgreSQL 9.0 has been changed to output bytea in hex encoding. If your GUI tools require the old behavior, then SET bytea_output='escape' in your database. 개선 사항: 2.0.0 버전부터 다면체 표면, 삼각형 및 TIN을 지원하기 시작했습니다. 개선 사항: 2.0.0 버전부터 더 높은 좌표 차원을 지원합니다. 개선 사항: 2.0.0 버전부터 지리형과 함께 엔디안을 설정하는 방식을 지원합니다. 1.5.0 버전부터 지리형을 지원합니다. 변경 사항: 2.0.0버전부터 이 함수에 알려지지 않은 유형을 입력할 수 없게 됐습니다. 반드시 도형을 입력해야 합니다. ST_AsBinary('POINT(1 2)') 같은 구조는 더 이상 유효하지 않아, n st_asbinary(unknown) is not unique error 오류가 발생합니다. 이런 코드는 ST_AsBinary('POINT(1 2)'::geometry); 로 변경돼야 합니다. 이렇게 변경할 수 없는 경우, legacy.sql 을 설치하십시오. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.1 This method implements the SQL/MM specification. SQL-MM 3: 5.1.37 This method supports Circular Strings and Curves. This function supports Polyhedral surfaces. This function supports Triangles and Triangulated Irregular Network Surfaces (TIN). This function supports 3d and will not drop the z-index.
  • ST_AsGML - 도형을 GML 2 또는 GML 3 버전 요소로 반환합니다. 설명 Return the geometry as a Geography Markup Language (GML) element. The version parameter, if specified, may be either 2 or 3. If no version parameter is specified then the default is assumed to be 2. The maxdecimaldigits argument may be used to reduce the maximum number of decimal places used in output (defaults to 15). Using the maxdecimaldigits parameter can cause output geometry to become invalid. To avoid this use with a suitable gridsize first. GML 2는 2.1.2 버전을, GML 3은 3.1.1 버전을 가리킵니다. '옵션' 인수는 비트필드(bitfield) 구조체입니다. CRS 출력 유형을 GML 출력으로 정의하고, 데이터를 위도/경도로 선언하는 데 쓸 수 있습니다. 0: GML Short CRS (예: EPSG:4326), 기본값 1: GML Long CRS (예: urn:ogc:def:crs:EPSG::4326) 2: GML 3에 한해, 출력물에서 srsDimension 속성을 제거합니다. 4: GML 3에 한해, 라인을 위해 <Curve> 보다 <LineString> 태그를 사용합니다. 16: 데이터가 위도/경도(예: srid=4326)라고 선언합니다. 기본적으로는 데이터가 평면 좌표라고 가정합니다. 이 옵션은 축의 순서(axis order)와 관련돼 있어, GML 3.1.1 출력물에 대해서만 쓸모가 있습니다. 따라서 이 옵션을 설정하면, 데이터베이스의 경도 위도 대신 위도 경도로 좌표의 순서를 바꿀 것입니다. 32: 도형을 둘러싼 상자(envelope)를 출력합니다. 사용자 지정 네임스페이스 접두사를 설정하거나 접두사를 사용하지 않도록 설정(비어 있는 경우)하는 데 '네임스페이스 접두사' 인수를 사용할 수도 있습니다. 이 인수가 NULL이거나 생략된 경우 'gml' 접두사를 씁니다. 1.3.2 버전부터 사용할 수 있습니다. 1.5.0 버전부터 지리형을 지원합니다. 개선 사항: 2.0.0 버전부터 접두사를 지원합니다. 라인에 대해 커브 대신 라인스트링 태그를 이용할 수 있도록 GML 3용 옵션 '4'가 등장했습니다. GML 3가 다면체 표면 및 TIN을 지원하기 시작했습니다. 상자를 출력하는 옵션 '32'도 새롭게 등장했습니다. 변경 사항: 2.0.0 버전부터 명명된 독립변수(named arg)를 기본값으로 씁니다. 개선 사항: 2.1.0 버전부터 GML 3를 위해 ID를 지원하기 시작했습니다. ST_AsGML 함수의 3 이상 버전만이 다면체 표면 및 TIN을 지원합니다. This method implements the SQL/MM specification. SQL-MM IEC 13249-3: 17.2 This function supports 3d and will not drop the z-index. This function supports Polyhedral surfaces. This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
  • ST_AsText - 도형/지리형의 WKT(Well-Known Text) 표현식을 SRID 메타데이터 없이 반환합니다. 설명 Returns the OGC Well-Known Text (WKT) representation of the geometry/geography. The optional maxdecimaldigits argument may be used to limit the number of digits after the decimal point in output ordinates (defaults to 15). To perform the inverse conversion of WKT representation to PostGIS geometry use . The standard OGC WKT representation does not include the SRID. To include the SRID as part of the output representation, use the non-standard PostGIS function The textual representation of numbers in WKT may not maintain full floating-point precision. To ensure full accuracy for data storage or transport it is best to use Well-Known Binary (WKB) format (see and maxdecimaldigits). Using the maxdecimaldigits parameter can cause output geometry to become invalid. To avoid this use with a suitable gridsize first. 1.5.0 버전부터 지리형을 지원합니다. Enhanced: 2.5 - optional parameter precision introduced. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.1 This method implements the SQL/MM specification. SQL-MM 3: 5.1.25 This method supports Circular Strings and Curves.
  • ST_Boundary - 해당 도형의 결합된 범위의 닫힘 여부를 반환합니다. 설명 해당 도형의 결합된 범위의 닫힘(closure) 여부를 반환합니다. 결합 범위(combinatorial boundary)는 OGC 사양서의 3.12.3.2 단원이 설명하는대로 정의됩니다. 이 함수의 결과가 닫힘이기 때문에, 즉 위상적(位相的)으로 폐쇄됐기 때문에, OGC 사양서 3.12.2 단원에서 설명한대로 표현적인 도형 원형(primitive)을 이용해서 결과 범위를 표현할 수 있습니다. GEOS 모듈로 실행 2.0.0 미만 버전에서 이 함수를 GEOMETRYCOLLECTION과 함께 사용하면 예외가 발생했습니다. 2.0.0 이후 버전은 대신 (입력을 지원하지 않는다는 의미의) NULL을 반환합니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. OGC SPEC s2.1.1.1 This method implements the SQL/MM specification. SQL-MM IEC 13249-3: 5.1.17 This function supports 3d and will not drop the z-index. 개선 사항: 2.1.0 버전부터 삼각형을 지원하기 시작했습니다. Changed: 3.2.0 support for TIN, does not use geos, does not linearize curves
  • ST_Buffer - Computes a geometry covering all points within a given distance from a geometry. 설명 Computes a POLYGON or MULTIPOLYGON that represents all points whose distance from a geometry/geography is less than or equal to a given distance. A negative distance shrinks the geometry rather than expanding it. A negative distance may shrink a polygon completely, in which case POLYGON EMPTY is returned. For points and lines negative distances always return empty results. For geometry, the distance is specified in the units of the Spatial Reference System of the geometry. For geography, the distance is specified in meters. The optional third parameter controls the buffer accuracy and style. The accuracy of circular arcs in the buffer is specified as the number of line segments used to approximate a quarter circle (default is 8). The buffer style can be specifed by providing a list of blank-separated key=value pairs as follows: 'quad_segs=#' : number of line segments used to approximate a quarter circle (default is 8). 'endcap=round|flat|square' : endcap style (defaults to "round"). 'butt' is accepted as a synonym for 'flat'. 'join=round|mitre|bevel' : join style (defaults to "round"). 'miter' is accepted as a synonym for 'mitre'. 'mitre_limit=#.#' : mitre ratio limit (only affects mitered join style). 'miter_limit' is accepted as a synonym for 'mitre_limit'. 'side=both|left|right' : 'left' or 'right' performs a single-sided buffer on the geometry, with the buffered side relative to the direction of the line. This is only applicable to LINESTRING geometry and does not affect POINT or POLYGON geometries. By default end caps are square. For geography this is a thin wrapper around the geometry implementation. It determines a planar spatial reference system that best fits the bounding box of the geography object (trying UTM, Lambert Azimuthal Equal Area (LAEA) North/South pole, and finally Mercator ). The buffer is computed in the planar space, and then transformed back to WGS84. This may not produce the desired behavior if the input object is much larger than a UTM zone or crosses the dateline Buffer output is always a valid polygonal geometry. Buffer can handle invalid inputs, so buffering by distance 0 is sometimes used as a way of repairing invalid polygons. can also be used for this purpose. Buffering is sometimes used to perform a within-distance search. For this use case it is more efficient to use . This function ignores the Z dimension. It always gives a 2D result even when used on a 3D geometry. Enhanced: 2.5.0 - ST_Buffer geometry support was enhanced to allow for side buffering specification side=both|left|right. Availability: 1.5 - ST_Buffer was enhanced to support different endcaps and join types. These are useful for example to convert road linestrings into polygon roads with flat or square edges instead of rounded edges. Thin wrapper for geography was added. GEOS 모듈로 실행 This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.3 This method implements the SQL/MM specification. SQL-MM IEC 13249-3: 5.1.30
  • ST_Centroid - 도형의 기하학적 중심을 반환합니다. 설명 Computes a point which is the geometric center of mass of a geometry. For [MULTI]POINTs, the centroid is the arithmetic mean of the input coordinates. For [MULTI]LINESTRINGs, the centroid is computed using the weighted length of each line segment. For [MULTI]POLYGONs, the centroid is computed in terms of area. If an empty geometry is supplied, an empty GEOMETRYCOLLECTION is returned. If NULL is supplied, NULL is returned. If CIRCULARSTRING or COMPOUNDCURVE are supplied, they are converted to linestring with CurveToLine first, then same than for LINESTRING For mixed-dimension input, the result is equal to the centroid of the component Geometries of highest dimension (since the lower-dimension geometries contribute zero "weight" to the centroid). Note that for polygonal geometries the centroid does not necessarily lie in the interior of the polygon. For example, see the diagram below of the centroid of a C-shaped polygon. To construct a point guaranteed to lie in the interior of a polygon use . New in 2.3.0 : supports CIRCULARSTRING and COMPOUNDCURVE (using CurveToLine) Availability: 2.4.0 support for geography was introduced. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. This method implements the SQL/MM specification. SQL-MM 3: 8.1.4, 9.5.5
  • ST_ChangeEdgeGeom - 지형 구조를 건드리는 일 없이 경계선의 형상을 변경합니다. 설명 지형 구조를 건드리는 일 없이 경계선의 형상을 변경합니다. If any arguments are null, the given edge does not exist in the edge table of the topology schema, the acurve is not a LINESTRING, or the modification would change the underlying topology then an error is thrown. acurve 도형과 지형의 공간 참조 시스템(SRID)이 다를 경우 예외가 발생합니다. 새 acurve 가 단순 도형이 아닐 경우, 오류가 발생합니다. 예전 위치에서 새 위치로 경계선을 이동시킬 때 장애물에 부딪히는 경우 오류가 발생합니다. 1.1.0 버전부터 사용할 수 있습니다. 개선 사항: 2.0.0버전부터 지형의 일관성을 강제합니다. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details X.3.6
  • ST_Contains - Tests if every point of B lies in A, and their interiors have a point in common Description Returns TRUE if geometry A contains geometry B. A contains B if and only if all points of B lie inside (i.e. in the interior or boundary of) A (or equivalently, no points of B lie in the exterior of A), and the interiors of A and B have at least one point in common. In mathematical terms: ST_Contains(A, B) ⇔ (A ⋂ B = B) ∧ (Int(A) ⋂ Int(B) ≠ ∅) The contains relationship is reflexive: every geometry contains itself. (In contrast, in the predicate a geometry does not properly contain itself.) The relationship is antisymmetric: if ST_Contains(A,B) = true and ST_Contains(B,A) = true, then the two geometries must be topologically equal (ST_Equals(A,B) = true). ST_Contains is the converse of . So, ST_Contains(A,B) = ST_Within(B,A). Because the interiors must have a common point, a subtlety of the definition is that polygons and lines do not contain lines and points lying fully in their boundary. For further details see Subtleties of OGC Covers, Contains, Within. The predicate provides a more inclusive relationship. This function automatically includes a bounding box comparison that makes use of any spatial indexes that are available on the geometries. To avoid index use, use the function _ST_Contains. Performed by the GEOS module Enhanced: 2.3.0 Enhancement to PIP short-circuit extended to support MultiPoints with few points. Prior versions only supported point in polygon. Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Do not use this function with invalid geometries. You will get unexpected results. NOTE: this is the "allowable" version that returns a boolean, not an integer. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.2 // s2.1.13.3 - same as within(geometry B, geometry A) This method implements the SQL/MM specification. SQL-MM 3: 5.1.31
  • ST_ConvexHull - Computes the convex hull of a geometry. 설명 Computes the convex hull of a geometry. The convex hull is the smallest convex geometry that encloses all geometries in the input. One can think of the convex hull as the geometry obtained by wrapping an rubber band around a set of geometries. This is different from a concave hull which is analogous to "shrink-wrapping" the geometries. A convex hull is often used to determine an affected area based on a set of point observations. In the general case the convex hull is a Polygon. The convex hull of two or more collinear points is a two-point LineString. The convex hull of one or more identical points is a Point. This is not an aggregate function. To compute the convex hull of a set of geometries, use to aggregate them into a geometry collection (e.g. ST_ConvexHull(ST_Collect(geom)). GEOS 모듈로 실행 This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.3 This method implements the SQL/MM specification. SQL-MM IEC 13249-3: 5.1.16 This function supports 3d and will not drop the z-index.
  • ST_CoordDim - ST_Geometry 값의 좌표 차원을 반환합니다. 설명 ST_Geometry 값의 좌표 차원을 반환합니다. 이 함수는 MM을 준수하는, 와 동일한 함수합니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. This method implements the SQL/MM specification. SQL-MM 3: 5.1.3 This method supports Circular Strings and Curves. This function supports 3d and will not drop the z-index. This function supports Polyhedral surfaces. This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
  • ST_CreateTopoGeo - 텅 빈 입력 지형에 도형들의 집합을 추가한 다음 작업 성공 여부를 상세하게 설명하는 메시지를 반환합니다. 설명 텅 빈 입력 지형에 도형들의 집합을 추가한 다음 작업 성공 여부를 상세하게 설명하는 메시지를 반환합니다. 텅 빈 지형을 채우는 데 유용합니다. 2.0 버전부터 사용할 수 있습니다. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details -- X.3.18
  • ST_Crosses - Tests if two geometries have some, but not all, interior points in common Description Compares two geometry objects and returns true if their intersection "spatially crosses"; that is, the geometries have some, but not all interior points in common. The intersection of the interiors of the geometries must be non-empty and must have dimension less than the maximum dimension of the two input geometries, and the intersection of the two geometries must not equal either geometry. Otherwise, it returns false. The crosses relation is symmetric and irreflexive. In mathematical terms: ST_Crosses(A, B) ⇔ (dim( Int(A) ⋂ Int(B) ) < max( dim( Int(A) ), dim( Int(B) ) )) ∧ (A ⋂ B ≠ A) ∧ (A ⋂ B ≠ B) Geometries cross if their DE-9IM Intersection Matrix matches: T*T****** for Point/Line, Point/Area, and Line/Area situations T*****T** for Line/Point, Area/Point, and Area/Line situations 0******** for Line/Line situations the result is false for Point/Point and Area/Area situations The OpenGIS Simple Features Specification defines this predicate only for Point/Line, Point/Area, Line/Line, and Line/Area situations. JTS / GEOS extends the definition to apply to Line/Point, Area/Point and Area/Line situations as well. This makes the relation symmetric. This function automatically includes a bounding box comparison that makes use of any spatial indexes that are available on the geometries. Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.13.3 This method implements the SQL/MM specification. SQL-MM 3: 5.1.29
  • ST_CurveToLine - Converts a geometry containing curves to a linear geometry. 설명 Converts a CIRCULAR STRING to regular LINESTRING or CURVEPOLYGON to POLYGON or MULTISURFACE to MULTIPOLYGON. Useful for outputting to devices that can't support CIRCULARSTRING geometry types Converts a given geometry to a linear geometry. Each curved geometry or segment is converted into a linear approximation using the given `tolerance` and options (32 segments per quadrant and no options by default). The 'tolerance_type' argument determines interpretation of the `tolerance` argument. It can take the following values: 0 (default): Tolerance is max segments per quadrant. 1: Tolerance is max-deviation of line from curve, in source units. 2: Tolerance is max-angle, in radians, between generating radii. The 'flags' argument is a bitfield. 0 by default. Supported bits are: 1: Symmetric (orientation idependent) output. 2: Retain angle, avoids reducing angles (segment lengths) when producing symmetric output. Has no effect when Symmetric flag is off. Availability: 1.3.0 Enhanced: 2.4.0 added support for max-deviation and max-angle tolerance, and for symmetric output. Enhanced: 3.0.0 implemented a minimum number of segments per linearized arc to prevent topological collapse. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. This method implements the SQL/MM specification. SQL-MM 3: 7.1.7 This function supports 3d and will not drop the z-index. This method supports Circular Strings and Curves.
  • ST_Difference - Computes a geometry representing the part of geometry A that does not intersect geometry B. Description Returns a geometry representing the part of geometry A that does not intersect geometry B. This is equivalent to A - ST_Intersection(A,B). If A is completely contained in B then an empty atomic geometry of appropriate type is returned. This is the only overlay function where input order matters. ST_Difference(A, B) always returns a portion of A. If the optional gridSize argument is provided, the inputs are snapped to a grid of the given size, and the result vertices are computed on that same grid. (Requires GEOS-3.9.0 or higher) Performed by the GEOS module Enhanced: 3.1.0 accept a gridSize parameter. Requires GEOS >= 3.9.0 to use the gridSize parameter. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.3 This method implements the SQL/MM specification. SQL-MM 3: 5.1.20 This function supports 3d and will not drop the z-index. However, the result is computed using XY only. The result Z values are copied, averaged or interpolated.
  • ST_Dimension - ST_Geometry 값의 좌표 차원을 반환합니다. 설명 좌표 차원과 동등하거나 낮아야 하는, 해당 도형 객체의 내재된 차원을 반환합니다. OGC 사양서 s2.1.1.1 단원을 보면 POINT 는 0, LINESTRING 은 1, POLYGON 은 2, 그리고 GEOMETRYCOLLECTION 의 경우 구성 요소 가운데 가장 높은 차원입니다. 알려지지 않은 (텅 빈) 도형인 경우 null을 반환합니다. This method implements the SQL/MM specification. SQL-MM 3: 5.1.2 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface) 및 TIN을 지원합니다. 빈 도형이 주어져도 더 이상 예외가 발생하지 않습니다. 2.0.0 미만 버전에서는 빈 도형에 대해 예외를 발생시켰습니다. This function supports Polyhedral surfaces. This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
  • ST_Disjoint - Tests if two geometries have no points in common Description Returns true if two geometries are disjoint. Geometries are disjoint if they have no point in common. If any other spatial relationship is true for a pair of geometries, they are not disjoint. Disjoint implies that is false. In mathematical terms: ST_Disjoint(A, B) ⇔ A ⋂ B = ∅ Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Performed by the GEOS module This function call does not use indexes. A negated predicate can be used as a more performant alternative that uses indexes: ST_Disjoint(A,B) = NOT ST_Intersects(A,B) NOTE: this is the "allowable" version that returns a boolean, not an integer. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.2 //s2.1.13.3 - a.Relate(b, 'FF*FF****') This method implements the SQL/MM specification. SQL-MM 3: 5.1.26
  • ST_Distance - 두 도형 사이의 3차원 최장(longest) 라인을 반환합니다. 설명 도형 유형에 대해, 두 도형 사이의 3차원 데카르트 최단 거리를 두 도형의 투영 단위(SRS 단위)로 반환합니다. For types defaults to return the minimum geodesic distance between two geographies in meters, compute on the spheroid determined by the SRID. If use_spheroid is false, a faster spherical calculation is used. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. This method implements the SQL/MM specification. SQL-MM 3: 5.1.23 This method supports Circular Strings and Curves. 1.5.0 버전부터 지리형을 지원합니다. 대용량 또는 수많은 꼭짓점을 가진 도형을 더 잘 처리하기 위해 평면에 대한 속도를 향상시켰습니다. 개선 사항: 2.1.0 버전부터 지리형에 대한 속도가 향상됐습니다. 자세한 내용은 Making Geography faster 를 참조하십시오. 개선 사항: 2.1.0 버전부터 만곡 도형을 지원하기 시작했습니다. 개선 사항: 2.2.0 버전부터 회전타원체 측정시 정확도와 강력함을 향상시키기 위해 GeographicLib을 이용합니다. 이 새 기능의 장점을 취하려면 Proj 4.9.0 이상 버전이 필요합니다. Changed: 3.0.0 - does not depend on SFCGAL anymore.
  • ST_EndPoint - ST_LineString 또는 ST_CircularString 값에 있는 포인트의 개수를 반환합니다. 설명 LINESTRING 또는 CIRCULARLINESTRING 도형의 첫 번째 포인트를 POINT로 반환합니다. 입력 파라미터가 LINESTRING 또는 CIRCULARLINESTRING 이 아닐 경우 NULL 을 반환합니다. This method implements the SQL/MM specification. SQL-MM 3: 7.1.4 This function supports 3d and will not drop the z-index. This method supports Circular Strings and Curves. 변경 사항: 2.0.0 버전부터 단일 도형 멀티라인스트링을 지원하지 않습니다. PostGIS 예전 버전이라면 단일 라인 멀티라인스트링을 입력받는 경우 시작점을 반환했을 겁니다. 2.0.0 버전은 다른 모든 멀티라인스트링처럼 NULL을 반환할 뿐입니다. 구식 습성은 문서화되지 않은 기능이지만, 사용자 데이터를 라인스트링으로 저장했다고 가정한 사용자의 경우 현재 2.0 버전에서 NULL이 반환될 수도 있습니다.
  • ST_Envelope - 주어진 도형의 이중 정밀도(double precision; float8) 경계 상자를 표현하는 도형을 반환합니다. 설명 주어진 도형에 대해 float8 형 최소치 경계 상자를 도형으로 반환합니다. 해당 폴리곤은 경계 상자의 꼭짓점 포인트들로 정의됩니다((MINX, MINY), (MINX, MAXY), (MAXX, MAXY), (MAXX, MINY), (MINX, MINY)). (PostGIS는 ZMIN/ZMAX 좌표도 추가할 것입니다.) 차원이 낮은 (수직 라인, 포인트) 경우 POLYGON 보다 낮은 차원의, 예를 들어 POINT 또는 LINESTRING 도형을 반환할 것입니다. 1.5.0 버전부터 사용할 수 있으며, float4 형 대신 이중 정밀도 형으로 출력하도록 변경되었습니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.1 This method implements the SQL/MM specification. SQL-MM 3: 5.1.19
  • ST_Equals - Tests if two geometries include the same set of points Description Returns true if the given geometries are "topologically equal". Use this for a 'better' answer than '='. Topological equality means that the geometries have the same dimension, and their point-sets occupy the same space. This means that the order of vertices may be different in topologically equal geometries. To verify the order of points is consistent use (it must be noted ST_OrderingEquals is a little more stringent than simply verifying order of points are the same). In mathematical terms: ST_Equals(A, B) ⇔ A = B The following relation holds: ST_Equals(A, B) ⇔ ST_Within(A,B) ∧ ST_Within(B,A) Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.2 This method implements the SQL/MM specification. SQL-MM 3: 5.1.24 Changed: 2.2.0 Returns true even for invalid geometries if they are binary equal
  • ST_ExteriorRing - 폴리곤 도형의 내곽 고리의 개수를 반환합니다. 설명 POLYGON 도형의 외곽 고리(exterior ring)를 표현하는 라인스트링을 반환합니다. 도형이 폴리곤이 아닌 경우 NULL을 반환합니다. 이 함수는 멀티폴리곤을 입력받지 못 합니다. 멀티폴리곤의 경우 ST_Dump 함수와 결합해서 이용하십시오. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. 2.1.5.1 This method implements the SQL/MM specification. SQL-MM 3: 8.2.3, 8.3.3 This function supports 3d and will not drop the z-index.
  • ST_GMLToSQL - GML로부터 지정된 ST_Geometry 값을 반환합니다. 이 함수는 ST_GeomFromGML 함수와 동일합니다. 설명 This method implements the SQL/MM specification. SQL-MM 3: 5.1.50 (만곡 도형 지원 제외) 1.5 버전부터 사용할 수 있습니다. LibXML2 1.6 이상 버전이 필요합니다. 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface) 및 TIN을 지원합니다. 개선 사항: 2.0.0 버전에서 선택적인 기본 SRID 파라미터가 추가됐습니다.
  • ST_GeomCollFromText - Makes a collection Geometry from collection WKT with the given SRID. If SRID is not given, it defaults to 0. 설명 Makes a collection Geometry from the Well-Known-Text (WKT) representation with the given SRID. If SRID is not given, it defaults to 0. OGC 사양 3.2.6.2 - 선택적인 SRID를 적합성 스위트(conformance suite)로부터 가져오십시오. WKT가 도형 집합(GEOMETRYCOLLECTION)이 아닌 경우 null을 반환합니다. 사용자 WKT 도형이 모두 집합이라고 확신한다면, 이 함수를 사용하지 마십시오. 이 함수는 추가적인 유효성 검사 단계를 거치므로 ST_GeomFromText보다 느립니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s3.2.6.2 This method implements the SQL/MM specification.
  • ST_GeomFromText - WKT 표현식으로부터 지정된 ST_Geometry 값을 반환합니다. 설명 OGC WKT(Well-Known Text) 표현식으로부터 PostGIS ST_Geometry 객체를 작성합니다. ST_GeomFromText 함수의 변종이 2개 있는데, 첫 번째는 SRID를 입력받지 않고 공간 참조 시스템이 정의되지 않은(SRID=0) 도형을 반환합니다. 두 번째는 SRID를 두 번째 인수로 입력받아 해당 SRID를 자체 메타데이터의 일부로 포함하는 도형을 반환합니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. 사양 3.2.6.2 - 선택적인 SRID를 적합성 스위트(conformance suite)로부터 가져오십시오. This method implements the SQL/MM specification. SQL-MM 3: 5.1.40 This method supports Circular Strings and Curves. While not OGC-compliant, is faster than ST_GeomFromText and ST_PointFromText. It is also easier to use for numeric coordinate values. is another option similar in speed to and is OGC-compliant, but doesn't support anything but 2D points. 변경 사항: PostGIS 2.0.0 미만 버전에서는 ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') 를 사용할 수 있었습니다. PostGIS 2.0.0 버전부터, SQL/MM 표준을 더 잘 준수하기 위해 이런 사용법은 금지됐습니다. 이제는 ST_GeomFromText('GEOMETRYCOLLECTION EMPTY') 라고 작성해야 합니다.
  • ST_GeomFromWKB - WKB(Well-Known Binary) 도형 표현식과 선택적인 SRID로부터 도형 인스턴스를 생성합니다. 설명 ST_GeogFromWKB 함수는 도형의 WKB 표현식과 SRID(공간 참조 시스템 ID)를 받아 적절한 도형 유형의 인스턴스를 생성합니다. 이 함수는 SQL에서 도형 공장(Geometry Factory) 역할을 합니다. 이 함수는 ST_WKBToSQL 함수를 대체할 수 있습니다. SRID를 설정하지 않은 경우, 기본값으로 0(unkown)을 씁니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s3.2.7.2 - 선택적인 SRID를 적합성 스위트(conformance suite)로부터 가져오십시오. This method implements the SQL/MM specification. SQL-MM 3: 5.1.41 This method supports Circular Strings and Curves.
  • ST_GeometryFromText - WKT(Well-Known Text)로부터 지정된 ST_Geometry 값을 반환합니다. 이 함수는 ST_GeomFromText 함수와 동일합니다. 설명 This method implements the OGC Simple Features Implementation Specification for SQL 1.1. This method implements the SQL/MM specification. SQL-MM 3: 5.1.40
  • ST_GeometryN - ST_Geometry 값의 도형 유형을 반환합니다. 설명 입력 도형이 도형 집합, (멀티)포인트, (멀티)라인스트링, 멀티커브(multicurve) 또는 (멀티)폴리곤이나 다면체 표면일 경우 1-기반 N번째 도형을 반환하며, 그 외의 경우 NULL을 반환합니다. 0.8.0 버전부터 인덱스는 OGC 사양을 따라 1-기반입니다. 예전 버전은 대신 0-기반 인덱스를 시행했습니다. 모든 도형들을 추출하고자 한다면 ST_Dump 함수가 더 효율적이며, 단일 도형에 대해서도 작동할 것입니다. 개선 사항: 2.0.0 버전부터 다면체 표면, 삼각형 및 TIN을 지원하기 시작했습니다. 변경 사항: 2.0.0 미만 버전은 단일 도형에 대해 NULL을 반환했을 겁니다. 2.0.0 버전부터 ST_GeometryN(..,1) 경우에 대한 도형을 반환하도록 변경됐습니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. This method implements the SQL/MM specification. SQL-MM 3: 9.1.5 This function supports 3d and will not drop the z-index. This method supports Circular Strings and Curves. This function supports Polyhedral surfaces. This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
  • ST_GeometryType - ST_Geometry 값의 도형 유형을 반환합니다. 설명 도형의 유형을 'ST_LineString', 'ST_Polygon', 'ST_MultiPolygon' 등과 같은 스트링으로 반환합니다. 이 함수는 도형의 단위가 설정돼 있는지 알려주지 않는 것은 물론, 반환된 결과물이 스트링이며 접두사 ST가 달린다는 점에서도 GeometryType(geometry) 함수와는 다릅니다. 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface)을 지원합니다. This method implements the SQL/MM specification. SQL-MM 3: 5.1.4 This function supports 3d and will not drop the z-index. This function supports Polyhedral surfaces.
  • ST_GetFaceEdges - aface 의 경계를 이루는 정렬된 경계선들의 집합을 반환합니다. 설명 aface 의 경계를 이루는 정렬된 경계선들의 집합을 반환합니다. 각 출력물은 순차(sequence) 및 경계선 ID(edgeid)로 이루어집니다. 순차 번호는 1부터 시작합니다. 각 고리의 경계선을 가장 작은 식별자를 가진 경계선부터 열거합니다. 경계선의 순서는 왼손 법칙을 따릅니다(각 경계선의 왼쪽 방향으로 표면의 경계선을 구성하게 됩니다). 2.0 버전부터 사용할 수 있습니다. This method implements the SQL/MM specification. SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.5
  • ST_GetFaceGeometry - 입력 지형으로부터 설정된 표면 ID를 가진 폴리곤을 반환합니다. 설명 입력 지형으로부터 설정된 표면 ID를 가진 폴리곤을 반환합니다. 표면을 구성하는 경계선들로부터 폴리곤을 빌드합니다. Availability: 1.1 This method implements the SQL/MM specification. SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.16
  • ST_InitTopoGeo - Creates a new topology schema and registers it in the topology.topology table. 설명 This is the SQL-MM equivalent of . It lacks options for spatial reference system and tolerance. it returns a text description of the topology creation, instead of the topology id. Availability: 1.1 This method implements the SQL/MM specification. SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.17
  • ST_InteriorRingN - 폴리곤 도형의 내곽 고리의 개수를 반환합니다. 설명 폴리곤 도형의 N번째 내곽 라인스트링 고리를 반환합니다. 도형이 폴리곤이 아니거나 주어진 N이 범위(range)를 벗어난 경우 NULL을 반환합니다. 이 함수는 멀티폴리곤을 입력받지 못 합니다. 멀티폴리곤의 경우 ST_Dump 함수와 결합해서 이용하십시오. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. This method implements the SQL/MM specification. SQL-MM 3: 8.2.6, 8.3.5 This function supports 3d and will not drop the z-index.
  • ST_Intersection - Computes a geometry representing the shared portion of geometries A and B. Description Returns a geometry representing the point-set intersection of two geometries. In other words, that portion of geometry A and geometry B that is shared between the two geometries. If the geometries have no points in common (i.e. are disjoint) then an empty atomic geometry of appropriate type is returned. If the optional gridSize argument is provided, the inputs are snapped to a grid of the given size, and the result vertices are computed on that same grid. (Requires GEOS-3.9.0 or higher) ST_Intersection in conjunction with is useful for clipping geometries such as in bounding box, buffer, or region queries where you only require the portion of a geometry that is inside a country or region of interest. For geography this is a thin wrapper around the geometry implementation. It first determines the best SRID that fits the bounding box of the 2 geography objects (if geography objects are within one half zone UTM but not same UTM will pick one of those) (favoring UTM or Lambert Azimuthal Equal Area (LAEA) north/south pole, and falling back on mercator in worst case scenario) and then intersection in that best fit planar spatial ref and retransforms back to WGS84 geography. This function will drop the M coordinate values if present. If working with 3D geometries, you may want to use SFGCAL based which does a proper 3D intersection for 3D geometries. Although this function works with Z-coordinate, it does an averaging of Z-Coordinate. Performed by the GEOS module Enhanced: 3.1.0 accept a gridSize parameter Requires GEOS >= 3.9.0 to use the gridSize parameter Changed: 3.0.0 does not depend on SFCGAL. Availability: 1.5 support for geography data type was introduced. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.3 This method implements the SQL/MM specification. SQL-MM 3: 5.1.18 This function supports 3d and will not drop the z-index. However, the result is computed using XY only. The result Z values are copied, averaged or interpolated.
  • ST_Intersects - Tests if two geometries intersect (they have at least one point in common) Description Returns true if two geometries intersect. Geometries intersect if they have any point in common. For geography, a distance tolerance of 0.00001 meters is used (so points that are very close are considered to intersect). In mathematical terms: ST_Intersects(A, B) ⇔ A ⋂ B ≠ ∅ Geometries intersect if their DE-9IM Intersection Matrix matches one of: T******** *T******* ***T***** ****T**** Spatial intersection is implied by all the other spatial relationship tests, except , which tests that geometries do NOT intersect. This function automatically includes a bounding box comparison that makes use of any spatial indexes that are available on the geometries. Changed: 3.0.0 SFCGAL version removed and native support for 2D TINS added. Enhanced: 2.5.0 Supports GEOMETRYCOLLECTION. Enhanced: 2.3.0 Enhancement to PIP short-circuit extended to support MultiPoints with few points. Prior versions only supported point in polygon. Performed by the GEOS module (for geometry), geography is native Availability: 1.5 support for geography was introduced. For geography, this function has a distance tolerance of about 0.00001 meters and uses the sphere rather than spheroid calculation. NOTE: this is the "allowable" version that returns a boolean, not an integer. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.2 //s2.1.13.3 - ST_Intersects(g1, g2 ) --> Not (ST_Disjoint(g1, g2 )) This method implements the SQL/MM specification. SQL-MM 3: 5.1.27 This method supports Circular Strings and Curves. This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
  • ST_IsClosed - LINESTRING 의 시작점과 종단점이 일치하는 경우 TRUE 를 반환합니다. 다면체 표면이 닫혀 (부피를 가지고) 있는 경우 TRUE 를 반환합니다. 설명 LINESTRING 의 시작점과 종단점이 일치하는 경우 TRUE 를 반환합니다. 다면체 표면의 경우, 다면체 표면이 면적(열림)을 가지고 있는지 부피(닫힘)를 가지고 있는지 알려줍니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. This method implements the SQL/MM specification. SQL-MM 3: 7.1.5, 9.3.3 SQL-MM은 ST_IsClosed(NULL) 의 결과를 0으로 정의하지만, PostGIS는 NULL 을 반환합니다. This function supports 3d and will not drop the z-index. This method supports Circular Strings and Curves. 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface)을 지원합니다. This function supports Polyhedral surfaces.
  • ST_IsEmpty - Tests if a geometry is empty. 설명 해당 도형이 텅 빈 도형인 경우 TRUE 를 반환합니다. TRUE 인 경우, 해당 도형이 텅 빈 도형 집합, 폴리곤, 포인트 등을 표현한다는 뜻입니다. SQL-MM은 ST_IsEmpty(NULL) 의 결과를 0으로 정의하지만, PostGIS는 NULL 을 반환합니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.1 This method implements the SQL/MM specification. SQL-MM 3: 5.1.7 This method supports Circular Strings and Curves. 변경 사항: PostGIS 2.0.0 미만 버전에서는 ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') 를 사용할 수 있었습니다. PostGIS 2.0.0 버전부터, SQL/MM 표준을 더 잘 준수하기 위해 이런 사용법은 금지됐습니다.
  • ST_IsRing - Tests if a LineString is closed and simple. 설명 해당 LINESTRING 이 (ST_StartPoint(g) ~= ST_Endpoint(g)) 인 동시에 인 (자체 교차하지 않는) 경우 TRUE 를 반환합니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. 2.1.5.1 This method implements the SQL/MM specification. SQL-MM 3: 7.1.6 SQL-MM은 ST_IsRing(NULL) 의 결과를 0으로 정의하지만, PostGIS는 NULL 을 반환합니다.
  • ST_IsSimple - 해당 도형이 자체 교차하거나 자체 접촉하는 이례적인 도형 포인트를 가지고 있지 않을 경우 TRUE 를 반환합니다. 설명 해당 도형이 자체 교차하거나 자체 접촉하는 이례적인 도형 포인트를 가지고 있지 않을 경우 TRUE 를 반환합니다. 도형 단순성 및 유효성에 대한 OGC의 정의를 더 자세히 알고 싶다면, "OpenGIS의 도형 준수성 확인(Ensuring OpenGIS compliancy of geometries)" 을 참조하십시오. SQL-MM은 ST_IsSimple(NULL) 의 결과를 0으로 정의하지만, PostGIS는 NULL 을 반환합니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.1 This method implements the SQL/MM specification. SQL-MM 3: 5.1.8 This function supports 3d and will not drop the z-index.
  • ST_IsValid - Tests if a geometry is well-formed in 2D. Description Tests if an ST_Geometry value is well-formed and valid in 2D according to the OGC rules. For geometries with 3 and 4 dimensions, the validity is still only tested in 2 dimensions. For geometries that are invalid, a PostgreSQL NOTICE is emitted providing details of why it is not valid. For the version with the flags parameter, supported values are documented in This version does not print a NOTICE explaining invalidity. For more information on the definition of geometry validity, refer to SQL-MM defines the result of ST_IsValid(NULL) to be 0, while PostGIS returns NULL. Performed by the GEOS module. The version accepting flags is available starting with 2.0.0. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. This method implements the SQL/MM specification. SQL-MM 3: 5.1.9 Neither OGC-SFS nor SQL-MM specifications include a flag argument for ST_IsValid. The flag is a PostGIS extension.
  • ST_Length - 도형의 기하학적 중심을 반환합니다. 설명 도형의 경우: 도형이 라인스트링, 멀티라인스트링, ST_Curve, ST_MultiCurve일 경우 도형의 2차원 데카르트 길이를 반환합니다. 면 도형의 경우 0을 반환합니다. 면 도형에 대해서는 를 이용하십시오. 도형 유형의 경우, 도형의 공간 참조 시스템이 해당 길이의 측정 단위를 설정합니다. For geography types: computation is performed using the inverse geodesic calculation. Units of length are in meters. If PostGIS is compiled with PROJ version 4.8.0 or later, the spheroid is specified by the SRID, otherwise it is exclusive to WGS84. If use_spheroid = false, then the calculation is based on a sphere instead of a spheroid. 도형의 경우 이 함수는 현재 ST_Length2D와 동일하지만, 향후 더 높은 차원을 지원하기 위해 변경될 수도 있습니다. 변경 사항: 2.0.0 버전에서 중요한 변경이 이루어졌습니다. 2.0.0 이전 버전에서 이 함수에 폴리곤/멀티폴리곤 유형의 지리형을 입력하면 폴리곤/멀티폴리곤의 둘레를 반환했을 겁니다. 2.0.0 버전부터 도형 습성과 맞추기 위해 0을 반환하도록 변경됐습니다. 폴리곤의 둘레를 원한다면 ST_Perimeter 함수를 이용하십시오. 지리형 측정시 기본값은 회전타원체 상의 측정입니다. 더 빠르지만 덜 정확한 구체를 이용하려면 ST_Length(gg,false); 를 쓰십시오. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.5.1 This method implements the SQL/MM specification. SQL-MM 3: 7.1.2, 9.3.4 1.5.0 버전부터 지리형을 지원합니다.
  • ST_LineFromText - 주어진 SRID와 함께 WKT 표현식으로부터 도형을 만듭니다. SRID가 주어지지 않은 경우, 기본값인 0을 씁니다. 설명 Makes a Geometry from WKT with the given SRID. If SRID is not given, it defaults to 0. If WKT passed in is not a LINESTRING, then null is returned. OGC 사양 3.2.6.2 - 선택적인 SRID를 적합성 스위트(conformance suite)로부터 가져오십시오. 사용자 도형이 모두 라인스트링이란 걸 알고 있다면, 그냥 ST_GeomFromText 함수를 쓰는 편이 더 효율적입니다. 이 함수는 ST_GeomFromText만 호출하고, 라인스트링을 반환한다는 유효성 검사를 추가합니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s3.2.6.2 This method implements the SQL/MM specification. SQL-MM 3: 7.2.8
  • ST_LineFromWKB - 주어진 SRID와 함께 WKB로부터 LINESTRING 을 만듭니다. 설명 ST_LineFromWKB 함수는 도형의 WKB 표현식과 SRID(공간 참조 시스템 ID)를 받아 적절한 도형 유형의 인스턴스 - 이 경우, LINESTRING 도형 - 를 생성합니다. 이 함수는 SQL에서 도형 공장(Geometry Factory) 역할을 합니다. SRID를 설정하지 않은 경우, 기본값인 0을 씁니다. 입력된 bytea가 라인스트링이 아닌 경우, NULL을 반환합니다. OGC 사양 3.2.6.2 - 선택적인 SRID를 적합성 스위트(conformance suite)로부터 가져오십시오. 사용자 도형이 모두 LINESTRING이란 걸 알고 있다면, 그냥 함수를 쓰는 편이 더 효율적입니다. 이 함수는 만 호출하고, 라인스트링을 반환한다는 유효성 검사를 추가합니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s3.2.6.2 This method implements the SQL/MM specification. SQL-MM 3: 7.2.9
  • ST_LinestringFromWKB - 주어진 SRID와 함께 WKB로부터 도형을 만듭니다. 설명 ST_LinestringFromWKB 함수는 도형의 WKB 표현식과 SRID(공간 참조 시스템 ID)를 받아 적절한 도형 유형의 인스턴스 - 이 경우, LINESTRING 도형 - 를 생성합니다. 이 함수는 SQL에서 도형 공장(Geometry Factory) 역할을 합니다. SRID를 설정하지 않은 경우, 기본값인 0을 씁니다. 입력된 bytea가 LINESTRING 도형이 아닌 경우, NULL을 반환합니다. OGC 사양 3.2.6.2 - 선택적인 SRID를 적합성 스위트(conformance suite)로부터 가져오십시오. 사용자 도형이 모두 LINESTRING이란 걸 알고 있다면, 그냥 함수를 쓰는 편이 더 효율적입니다. 이 함수는 만 호출하고, LINESTRING을 반환한다는 유효성 검사를 추가합니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s3.2.6.2 This method implements the SQL/MM specification. SQL-MM 3: 7.2.9
  • ST_LocateAlong - Returns the point(s) on a geometry that match a measure value. 설명 Returns the location(s) along a measured geometry that have the given measure values. The result is a Point or MultiPoint. Polygonal inputs are not supported. If offset is provided, the result is offset to the left or right of the input line by the specified distance. A positive offset will be to the left, and a negative one to the right. Use this function only for linear geometries with an M component The semantic is specified by the ISO/IEC 13249-3 SQL/MM Spatial standard. 1.1.0 버전부터 예전 명칭인 ST_Locate_Along_Measure로 사용할 수 있습니다. 변경 사항: 2.0.0 미만 버전에서는 ST_Locate_Along_Measure라는 명칭이었습니다. 예전 명칭은 더 지원되지 않고 곧 삭제될 예정이지만, 아직은 사용할 수 있습니다. This function supports M coordinates. This method implements the SQL/MM specification. SQL-MM IEC 13249-3: 5.1.13
  • ST_LocateBetween - Returns the portions of a geometry that match a measure range. 설명 설정한 척도와 일치하는 요소들을 가진 파생 도형 집합의 값을 반환합니다. 폴리곤 구성 요소는 지원되지 않습니다. 오프셋을 설정할 경우, 그 결과 입력 라인에서 설정한 단위 개수만큼 왼쪽 또는 오른쪽에 오프셋 도형 집합을 출력할 것입니다. 양의 오프셋은 왼쪽, 음의 오프셋은 오른쪽으로 출력할 것입니다. Clipping a non-convex POLYGON may produce invalid geometry. The semantic is specified by the ISO/IEC 13249-3 SQL/MM Spatial standard. 1.1.0 버전부터 예전 명칭인 ST_Locate_Between_Measures로 사용할 수 있습니다. 변경 사항: 2.0.0 미만 버전에서는 ST_Locate_Along_Measure라는 명칭이었습니다. 예전 명칭은 더 지원되지 않고 곧 삭제될 예정이지만, 아직은 사용할 수 있습니다. Enhanced: 3.0.0 - added support for POLYGON, TIN, TRIANGLE. This function supports M coordinates. This method implements the SQL/MM specification. SQL-MM IEC 13249-3: 5.1
  • ST_M - Returns the M coordinate of a Point. 설명 포인트의 M 좌표를 반환합니다. M 좌표가 없는 경우 NULL을 반환합니다. 포인트만 입력받을 수 있습니다. 이 함수는 (아직) OGC 사양에 들어가지 않지만, 포인트 좌표 추출자(extractor) 함수 목록을 완성하기 위해 이 문서에 작성됐습니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. This method implements the SQL/MM specification. This function supports 3d and will not drop the z-index.
  • ST_MLineFromText - WKT 표현식으로부터 지정된 ST_MultiLineString 값을 반환합니다. 설명 Makes a Geometry from Well-Known-Text (WKT) with the given SRID. If SRID is not given, it defaults to 0. OGC 사양 3.2.6.2 - 선택적인 SRID를 적합성 스위트(conformance suite)로부터 가져오십시오. WKT가 멀티라인스트링이 아닌 경우 null을 반환합니다. 사용자 WKT 도형이 모두 포인트라고 확신한다면, 이 함수를 사용하지 마십시오. 이 함수는 추가적인 유효성 검사 단계를 거치므로 ST_GeomFromText보다 느립니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s3.2.6.2 This method implements the SQL/MM specification. SQL-MM 3: 9.4.4
  • ST_MPointFromText - Makes a Geometry from WKT with the given SRID. If SRID is not given, it defaults to 0. 설명 Makes a Geometry from WKT with the given SRID. If SRID is not given, it defaults to 0. OGC 사양 3.2.6.2 - 선택적인 SRID를 적합성 스위트(conformance suite)로부터 가져오십시오. WKT가 멀티포인트가 아닌 경우 null을 반환합니다. 사용자 WKT 도형이 모두 포인트라고 확신한다면, 이 함수를 사용하지 마십시오. 이 함수는 추가적인 유효성 검사 단계를 거치므로 ST_GeomFromText보다 느립니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. 3.2.6.2 This method implements the SQL/MM specification. SQL-MM 3: 9.2.4
  • ST_MPolyFromText - Makes a MultiPolygon Geometry from WKT with the given SRID. If SRID is not given, it defaults to 0. 설명 Makes a MultiPolygon from WKT with the given SRID. If SRID is not given, it defaults to 0. OGC 사양 3.2.6.2 - 선택적인 SRID를 적합성 스위트(conformance suite)로부터 가져오십시오. WKT가 멀티폴리곤이 아닌 경우 오류가 발생합니다. 사용자 WKT 도형이 모두 멀티폴리곤이라고 확신한다면, 이 함수를 사용하지 마십시오. 이 함수는 추가적인 유효성 검사 단계를 거치므로 ST_GeomFromText보다 느립니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s3.2.6.2 This method implements the SQL/MM specification. SQL-MM 3: 9.6.4
  • ST_ModEdgeHeal - Heals two edges by deleting the node connecting them, modifying the first edge and deleting the second edge. Returns the id of the deleted node. 설명 Heals two edges by deleting the node connecting them, modifying the first edge and deleting the second edge. Returns the id of the deleted node. Updates all existing joined edges and relationships accordingly. 2.0 버전부터 사용할 수 있습니다. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.9
  • ST_ModEdgeSplit - 기존 경계선을 따라 새 노드를 추가한 다음, 원본 경계선을 수정하고 새 경계선을 추가해서 경계선을 분할합니다. 설명 기존 경계선을 따라 새 노드를 추가한 다음, 원본 경계선을 수정하고 새 경계선을 추가해서 경계선을 분할합니다. 기존의 모든 결합된 경계선들 및 관계성을 새로이 분할된 경계선들에 맞춰 업데이트합니다. 새로 추가된 노드의 식별자를 반환합니다. Availability: 1.1 변경 사항: 2.0 미만 버전에서, 이 함수는 ST_ModEdgesSplit이라는 잘못된 명칭이었습니다. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.9
  • ST_MoveIsoNode - Moves an isolated node in a topology from one point to another. If new apoint geometry exists as a node an error is thrown. Returns description of move. 설명 지형 안에 있는 고립된 노드를 어떤 위치에서 다른 위치로 이동합니다. 새 apoint 도형의 위치에 노드가 존재할 경우 오류가 발생합니다. If any arguments are null, the apoint is not a point, the existing node is not isolated (is a start or end point of an existing edge), new node location intersects an existing edge (even at the end points) or the new location is in a different face (since 3.2.0) then an exception is thrown. 포인트 도형과 지형의 공간 참조 시스템(SRID)이 다를 경우 예외가 발생합니다. 2.0.0 버전부터 사용할 수 있습니다. Enhanced: 3.2.0 ensures the nod cannot be moved in a different face This method implements the SQL/MM specification. SQL-MM: Topo-Net Routines: X.3.2
  • ST_NewEdgeHeal - Heals two edges by deleting the node connecting them, deleting both edges, and replacing them with an edge whose direction is the same as the first edge provided. 설명 Heals two edges by deleting the node connecting them, deleting both edges, and replacing them with an edge whose direction is the same as the first edge provided. Returns the id of the new edge replacing the healed ones. Updates all existing joined edges and relationships accordingly. 2.0 버전부터 사용할 수 있습니다. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.9
  • ST_NewEdgesSplit - 기존 경계선을 따라 새 노드를 추가한 다음, 원본 경계선을 삭제하고 새 경계선 2개로 교체해서 경계선을 분할합니다. 새 경계선들을 결합하는 새로 생성된 노드의 ID를 반환합니다. 설명 기존 경계선을 따라 apoint 포인트 위치에 새 노드를 생성한 다음, 다음, 원본 경계선을 삭제하고 새 경계선 2개로 교체해서 경계선 ID anedge 인 경계선을 분할합니다. 새 경계선들을 결합하는 새로 생성된 노드의 ID를 반환합니다. 기존의 모든 결합된 경계선들 및 관계성을 분할된 경계선에 맞춰 업데이트합니다. 포인트 도형과 지형의 공간 참조 시스템(SRID)이 다를 경우, apoint 가 포인트 도형이 아닐 경우, 포인트가 NULL일 경우, 해당 포인트의 위치에 이미 노드가 존재할 경우, 경계선이 기존 경계선과 일치하지 않을 경우, 또는 포인트가 경계선 안에 있지 않을 경우 예외가 발생합니다. Availability: 1.1 This method implements the SQL/MM specification. SQL-MM: Topo-Net Routines: X.3.8
  • ST_NumGeometries - 도형이 가지고 있는 포인트의 개수를 반환합니다. 모든 도형을 입력받을 수 있습니다. 설명 Returns the number of elements in a geometry collection (GEOMETRYCOLLECTION or MULTI*). For non-empty atomic geometries returns 1. For empty geometries returns 0. 개선 사항: 2.0.0 버전부터 다면체 표면, 삼각형 및 TIN을 지원하기 시작했습니다. 변경 사항: 2.0.0 미만 버전에서 도형이 집합이나 멀티 유형이 아닐 경우 NULL을 반환했습니다. 2.0.0 버전부터 폴리곤, 라인스트링, 포인트 같은 단일 도형에 대해 1을 반환합니다. This method implements the SQL/MM specification. SQL-MM 3: 9.1.4 This function supports 3d and will not drop the z-index. This function supports Polyhedral surfaces. This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
  • ST_NumInteriorRings - 폴리곤 도형의 내곽 고리의 개수를 반환합니다. 설명 폴리곤 도형의 내곽 고리의 개수를 반환합니다. 도형이 폴리곤이 아닐 경우 NULL을 반환합니다. This method implements the SQL/MM specification. SQL-MM 3: 8.2.5 변경 사항: 2.0.0 미만 버전에서는 멀티폴리곤을 입력하면 첫 번째 폴리곤의 내곽 고리의 개수를 반환받을 수 있었습니다.
  • ST_NumPatches - 다면체 표면 상에 있는 면의 개수를 반환합니다. 다면체 도형이 아닌 경우 NULL을 반환할 것입니다. 설명 다면체 표면 상에 있는 면의 개수를 반환합니다. 다면체 도형이 아닌 경우 NULL을 반환할 것입니다. 이 함수는 ST_NumGeometries와 동일하지만 MM 명명법을 지원합니다. MM 규약을 신경 쓰지 않는다면 ST_NumGeometries가 더 빠릅니다. 2.0.0 버전부터 사용할 수 있습니다. This function supports 3d and will not drop the z-index. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. This method implements the SQL/MM specification. SQL-MM ISO/IEC 13249-3: 8.5 This function supports Polyhedral surfaces.
  • ST_NumPoints - ST_LineString 또는 ST_CircularString 값에 있는 포인트의 개수를 반환합니다. 설명 ST_LineString 또는 ST_CircularString 값에 있는 포인트의 개수를 반환합니다. 1.4 미만 버전에서는 사양서대로 라인스트링만 입력받았습니다. 1.4 버전부터 이 함수는 단순히 라인스트링만이 아닌, 도형의 꼭짓점의 개수를 반환하는 ST_NPoints 함수와 비슷해졌습니다. 쿼리 목적이 다양하고 많은 도형 유형을 사용할 수 있는 ST_NPoints 함수를 대신 사용하는 편이 좋습니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. This method implements the SQL/MM specification. SQL-MM 3: 7.2.4
  • ST_OrderingEquals - Tests if two geometries represent the same geometry and have points in the same directional order Description ST_OrderingEquals compares two geometries and returns t (TRUE) if the geometries are equal and the coordinates are in the same order; otherwise it returns f (FALSE). This function is implemented as per the ArcSDE SQL specification rather than SQL-MM. http://edndoc.esri.com/arcsde/9.1/sql_api/sqlapi3.htm#ST_OrderingEquals This method implements the SQL/MM specification. SQL-MM 3: 5.1.43
  • ST_Overlaps - Tests if two geometries have the same dimension and intersect, but each has at least one point not in the other Description Returns TRUE if geometry A and B "spatially overlap". Two geometries overlap if they have the same dimension, their interiors intersect in that dimension. and each has at least one point inside the other (or equivalently, neither one covers the other). The overlaps relation is symmetric and irreflexive. In mathematical terms: ST_Overlaps(A, B) ⇔ ( dim(A) = dim(B) = dim( Int(A) ⋂ Int(B) )) ∧ (A ⋂ B ≠ A) ∧ (A ⋂ B ≠ B) This function automatically includes a bounding box comparison that makes use of any spatial indexes that are available on the geometries. To avoid index use, use the function _ST_Overlaps. Performed by the GEOS module Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION NOTE: this is the "allowable" version that returns a boolean, not an integer. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.2 // s2.1.13.3 This method implements the SQL/MM specification. SQL-MM 3: 5.1.32
  • ST_PatchN - ST_Geometry 값의 도형 유형을 반환합니다. 설명 도형이 POLYHEDRALSURFACE, POLYHEDRALSURFACEM 인 경우 1-기반 N번째 도형 (면)을 반환합니다. 그 외의 경우 NULL을 반환합니다. 이 함수는 다면체 표면에 대해 ST_GeometryN과 동일한 답을 반환합니다. ST_GeometryN을 이용하는 편이 더 빠릅니다. 인덱스는 1-기반입니다. 모든 도형들을 추출하고자 한다면 ST_Dump 함수가 더 효율적입니다. 2.0.0 버전부터 사용할 수 있습니다. This method implements the SQL/MM specification. SQL-MM ISO/IEC 13249-3: 8.5 This function supports 3d and will not drop the z-index. This function supports Polyhedral surfaces.
  • ST_Perimeter - Returns the length of the boundary of a polygonal geometry or geography. 설명 도형/지리형이 ST_Surface, ST_MultiSurface(폴리곤, 멀티폴리곤)일 경우 도형/지리형의 2차원 둘레를 반환합니다. 면이 없는 도형의 경우 0을 반환합니다. 선형 도형의 경우 를 이용하십시오. 도형 유형의 경우, 도형의 공간 참조 시스템이 해당 둘레의 측정 단위를 설정합니다. For geography types, the calculations are performed using the inverse geodesic problem, where perimeter units are in meters. If PostGIS is compiled with PROJ version 4.8.0 or later, the spheroid is specified by the SRID, otherwise it is exclusive to WGS84. If use_spheroid = false, then calculations will approximate a sphere instead of a spheroid. 이 함수는 현재 ST_Perimeter2D와 동일하지만, 향후 더 높은 차원을 지원하기 위해 변경될 수도 있습니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.5.1 This method implements the SQL/MM specification. SQL-MM 3: 8.1.3, 9.5.4 개선 사항: 2.0.0 버전부터 지리형을 지원합니다.
  • ST_Point - Creates a Point with X, Y and SRID values. 설명 Returns a Point with the given X and Y coordinate values. This is the SQL-MM equivalent for that takes just X and Y. For geodetic coordinates, X is longitude and Y is latitude Enhanced: 3.2.0 srid as an extra optional argument was added. Older installs require combining with ST_SetSRID to mark the srid on the geometry. This method implements the SQL/MM specification. SQL-MM 3: 6.1.2
  • ST_PointFromText - 주어진 SRID와 함께 WKT 표현식으로부터 포인트 도형을 만듭니다. SRID가 주어지지 않은 경우, 기본값인 0을 씁니다. 설명 Constructs a PostGIS ST_Geometry point object from the OGC Well-Known text representation. If SRID is not given, it defaults to unknown (currently 0). If geometry is not a WKT point representation, returns null. If completely invalid WKT, then throws an error. ST_PointFromText 함수의 변종이 2개 있는데, 첫 번째는 SRID를 입력받지 않고 공간 참조 시스템이 정의되지 않은 도형을 반환합니다. 두 번째는 SRID를 두 번째 인수로 입력받아 자체 메타데이터의 일부로 해당 SRID를 포함하는 ST_Geometry를 반환합니다. spatial_ref_sys 테이블에 정의되어 있는 SRID여야 합니다. 사용자 WKT 도형이 모두 포인트라고 확신한다면, 이 함수를 사용하지 마십시오. 이 함수는 추가적인 유효성 검사 단계를 거치므로 ST_GeomFromText보다 느립니다. 사용자가 경위도 좌표로부터 포인트를 빌드하고 OGC 준수 여부보다 성능 및 정확도에 더 관심이 있다면, 또는 OGC를 준수하는 동일한 함수를 이용하십시오. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. 사양 3.2.6.2 - 선택적인 SRID를 적합성 스위트(conformance suite)로부터 가져오십시오. This method implements the SQL/MM specification. SQL-MM 3: 6.1.8
  • ST_PointFromWKB - 주어진 SRID와 함께 WKB로부터 도형을 만듭니다. 설명 ST_PointFromWKB 함수는 도형의 WKB 표현식과 SRID(공간 참조 시스템 ID)를 받아 적절한 도형 유형의 인스턴스 - 이 경우, POINT 도형 - 를 생성합니다. 이 함수는 SQL에서 도형 공장(Geometry Factory) 역할을 합니다. SRID를 설정하지 않은 경우, 기본값인 0을 씁니다. 입력된 bytea가 포인트가 아닌 경우, NULL을 반환합니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s3.2.7.2 This method implements the SQL/MM specification. SQL-MM 3: 6.1.9 This function supports 3d and will not drop the z-index. This method supports Circular Strings and Curves.
  • ST_PointN - ST_LineString 또는 ST_CircularString 값에 있는 포인트의 개수를 반환합니다. 설명 도형 안에 있는 단일 라인스트링 또는 원형 라인스트링의 N번째 포인트를 반환합니다. 음수 값은 라인스트링의 종단점으로부터 반대로 집계되므로, -1이 마지막 포인트입니다. 도형 안에 라인스트링이 없는 경우 NULL을 반환합니다. 0.8.0 버전부터 인덱스는 OGC 사양을 따라 1-기반입니다. OGC는 반대 방향 인덱스(음수 인덱스)를 지원하지 않습니다. 예전 버전은 대신 0-기반 인덱스를 도입했습니다. 멀티라인스트링 안에 있는 각 라인스트링의 N번째 포인트를 얻고자 할 경우, 이 함수를 ST_Dump 함수와 연결해서 이용하십시오. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. This method implements the SQL/MM specification. SQL-MM 3: 7.2.5, 7.3.5 This function supports 3d and will not drop the z-index. This method supports Circular Strings and Curves. 변경 사항: 2.0.0 버전부터 단일 도형 멀티라인스트링을 지원하지 않습니다. PostGIS 예전 버전이라면 단일 라인 멀티라인스트링을 입력받는 경우 시작점을 반환했을 겁니다. 2.0.0 버전은 다른 모든 멀티라인스트링처럼 NULL을 반환할 뿐입니다. 변경 사항: 2.3.0 버전부터 음수 인덱스(-1이 마지막 포인트)를 이용할 수 있습니다.
  • ST_PointOnSurface - Computes a point guaranteed to lie in a polygon, or on a geometry. 설명 Returns a POINT which is guaranteed to lie in the interior of a surface (POLYGON, MULTIPOLYGON, and CURVED POLYGON). In PostGIS this function also works on line and point geometries. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s3.2.14.2 // s3.2.18.2 This method implements the SQL/MM specification. SQL-MM 3: 8.1.5, 9.5.6. The specifications define ST_PointOnSurface for surface geometries only. PostGIS extends the function to support all common geometry types. Other databases (Oracle, DB2, ArcSDE) seem to support this function only for surfaces. SQL Server 2008 supports all common geometry types. This function supports 3d and will not drop the z-index.
  • ST_Polygon - Creates a Polygon from a LineString with a specified SRID. 설명 Returns a polygon built from the given LineString and sets the spatial reference system from the srid. ST_Polygon is similar to Variant 1 with the addition of setting the SRID. , , 이 함수에 멀티라인스트링을 입력할 수는 없습니다. 라인스트링을 생성하려면 또는 를 이용하십시오. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. This method implements the SQL/MM specification. SQL-MM 3: 8.3.2 This function supports 3d and will not drop the z-index.
  • ST_PolygonFromText - Makes a Geometry from WKT with the given SRID. If SRID is not given, it defaults to 0. 설명 Makes a Geometry from WKT with the given SRID. If SRID is not given, it defaults to 0. Returns null if WKT is not a polygon. OGC 사양 3.2.6.2 - 선택적인 SRID를 적합성 스위트(conformance suite)로부터 가져오십시오. 사용자 WKT 도형이 모두 폴리곤이라고 확신한다면, 이 함수를 사용하지 마십시오. 이 함수는 추가적인 유효성 검사 단계를 거치므로 ST_GeomFromText보다 느립니다. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s3.2.6.2 This method implements the SQL/MM specification. SQL-MM 3: 8.3.6
  • ST_Relate - Tests if two geometries have a topological relationship matching an Intersection Matrix pattern, or computes their Intersection Matrix Description These functions allow testing and evaluating the spatial (topological) relationship between two geometries, as defined by the Dimensionally Extended 9-Intersection Model (DE-9IM). The DE-9IM is specified as a 9-element matrix indicating the dimension of the intersections between the Interior, Boundary and Exterior of two geometries. It is represented by a 9-character text string using the symbols 'F', '0', '1', '2' (e.g. 'FF1FF0102'). A specific kind of spatial relationship can be tested by matching the intersection matrix to an intersection matrix pattern. Patterns can include the additional symbols 'T' (meaning "intersection is non-empty") and '*' (meaning "any value"). Common spatial relationships are provided by the named functions , , , , , , , , , , and . Using an explicit pattern allows testing multiple conditions of intersects, crosses, etc in one step. It also allows testing spatial relationships which do not have a named spatial relationship function. For example, the relationship "Interior-Intersects" has the DE-9IM pattern T********, which is not evaluated by any named predicate. For more information refer to . Variant 1: Tests if two geometries are spatially related according to the given intersectionMatrixPattern. Unlike most of the named spatial relationship predicates, this does NOT automatically include an index call. The reason is that some relationships are true for geometries which do NOT intersect (e.g. Disjoint). If you are using a relationship pattern that requires intersection, then include the && index call. It is better to use a named relationship function if available, since they automatically use a spatial index where one exists. Also, they may implement performance optimizations which are not available with full relate evalation. Variant 2: Returns the DE-9IM matrix string for the spatial relationship between the two input geometries. The matrix string can be tested for matching a DE-9IM pattern using . Variant 3: Like variant 2, but allows specifying a Boundary Node Rule. A boundary node rule allows finer control over whether the endpoints of MultiLineStrings are considered to lie in the DE-9IM Interior or Boundary. The boundaryNodeRule values are: 1: OGC-Mod2 - line endpoints are in the Boundary if they occur an odd number of times. This is the rule defined by the OGC SFS standard, and is the default for ST_Relate. 2: Endpoint - all endpoints are in the Boundary. 3: MultivalentEndpoint - endpoints are in the Boundary if they occur more than once. In other words, the boundary is all the "attached" or "inner" endpoints (but not the "unattached/outer" ones). 4: MonovalentEndpoint - endpoints are in the Boundary if they occur only once. In other words, the boundary is all the "unattached" or "outer" endpoints. This function is not in the OGC spec, but is implied. see s2.1.13.2 This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.2 // s2.1.13.3 This method implements the SQL/MM specification. SQL-MM 3: 5.1.25 Performed by the GEOS module Enhanced: 2.0.0 - added support for specifying boundary node rule. Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION
  • ST_RemEdgeModFace - Removes an edge, and if the edge separates two faces deletes one face and modifies the other face to cover the space of both. 설명 Removes an edge, and if the removed edge separates two faces deletes one face and modifies the other face to cover the space of both. Preferentially keeps the face on the right, to be consistent with . Returns the id of the face which is preserved. 모든 기존의 결합된 경계선 및 관계성을 결과에 맞춰 업데이트합니다. Refuses to remove an edge participating in the definition of an existing TopoGeometry. Refuses to heal two faces if any TopoGeometry is defined by only one of them (and not the other). 어떤 인수가 NULL일 경우, 주어진 경계선이 알려지지 않은 경우(경계선이 이미 지형 스키마의 edge 테이블에 존재해야 합니다), 지형 명칭이 유효하지 않은 경우 오류가 발생합니다. 2.0 버전부터 사용할 수 있습니다. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.15
  • ST_RemEdgeNewFace - 경계선을 제거하고, 제거한 경계선이 두 표면을 분할하고 있을 경우, 원본 표면들을 삭제하고 새 표면 하나로 대체합니다. 설명 경계선을 제거하고, 제거한 경계선이 두 표면을 분할하고 있을 경우, 원본 표면들을 삭제하고 새 표면 하나로 대체합니다. 새로 생성된 표면의 ID를 반환하거나, 또는 새 표면이 생성되지 않은 경우 NULL을 반환합니다. 제거한 경계선이 세계 표면에 매달려 있거나, 고립돼 있거나, 또는 (세계 표면이 다른 쪽의 표면을 침범하게 할 수 있게) 갇혀 있을 경우 새 표면을 생성할 수 없습니다. 모든 기존의 결합된 경계선 및 관계성을 결과에 맞춰 업데이트합니다. Refuses to remove an edge participating in the definition of an existing TopoGeometry. Refuses to heal two faces if any TopoGeometry is defined by only one of them (and not the other). 어떤 인수가 NULL일 경우, 주어진 경계선이 알려지지 않은 경우(경계선이 이미 지형 스키마의 edge 테이블에 존재해야 합니다), 지형 명칭이 유효하지 않은 경우 오류가 발생합니다. 2.0 버전부터 사용할 수 있습니다. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.14
  • ST_RemoveIsoEdge - Removes an isolated edge and returns description of action. If the edge is not isolated, then an exception is thrown. 설명 Removes an isolated edge and returns description of action. If the edge is not isolated, then an exception is thrown. Availability: 1.1 This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X+1.3.3
  • ST_RemoveIsoNode - 고립된 노드를 제거하고 작업 내용을 설명하는 메시지를 반환합니다. 노드가 고립되지 않은 (경계선의 시작점이나 종단점인) 경우, 예외가 발생합니다. 설명 고립된 노드를 제거하고 작업 내용을 설명하는 메시지를 반환합니다. 노드가 고립되지 않은 (경계선의 시작점이나 종단점인) 경우, 예외가 발생합니다. Availability: 1.1 This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X+1.3.3
  • ST_SRID - Returns the spatial reference identifier for a geometry. Description Returns the spatial reference identifier for the ST_Geometry as defined in spatial_ref_sys table. spatial_ref_sys table is a table that catalogs all spatial reference systems known to PostGIS and is used for transformations from one spatial reference system to another. So verifying you have the right spatial reference system identifier is important if you plan to ever transform your geometries. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.1 This method implements the SQL/MM specification. SQL-MM 3: 5.1.5 This method supports Circular Strings and Curves.
  • ST_StartPoint - Returns the first point of a LineString. 설명 LINESTRING 또는 CIRCULARLINESTRING 도형의 첫 번째 포인트를 POINT로 반환합니다. 입력 파라미터가 LINESTRING 또는 CIRCULARLINESTRING 이 아닐 경우 NULL 을 반환합니다. This method implements the SQL/MM specification. SQL-MM 3: 7.1.3 This function supports 3d and will not drop the z-index. This method supports Circular Strings and Curves. Enhanced: 3.2.0 returns a point for all geometries. Prior behavior returns NULLs if input was not a LineString. 변경 사항: 2.0.0 버전부터 단일 도형 멀티라인스트링을 지원하지 않습니다. PostGIS 예전 버전이라면 단일 라인 멀티라인스트링을 입력받는 경우 시작점을 반환했을 겁니다. 2.0.0 버전은 다른 모든 멀티라인스트링처럼 NULL을 반환할 뿐입니다. 구식 습성은 문서화되지 않은 기능이지만, 사용자 데이터를 라인스트링으로 저장했다고 가정한 사용자의 경우 현재 2.0 버전에서 NULL이 반환될 수도 있습니다.
  • ST_SymDifference - Computes a geometry representing the portions of geometries A and B that do not intersect. Description Returns a geometry representing the portions of geonetries A and B that do not intersect. This is equivalent to ST_Union(A,B) - ST_Intersection(A,B). It is called a symmetric difference because ST_SymDifference(A,B) = ST_SymDifference(B,A). If the optional gridSize argument is provided, the inputs are snapped to a grid of the given size, and the result vertices are computed on that same grid. (Requires GEOS-3.9.0 or higher) Performed by the GEOS module Enhanced: 3.1.0 accept a gridSize parameter. Requires GEOS >= 3.9.0 to use the gridSize parameter This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.3 This method implements the SQL/MM specification. SQL-MM 3: 5.1.21 This function supports 3d and will not drop the z-index. However, the result is computed using XY only. The result Z values are copied, averaged or interpolated.
  • ST_Touches - Tests if two geometries have at least one point in common, but their interiors do not intersect Description Returns TRUE if A and B intersect, but their interiors do not intersect. Equivalently, A and B have at least one point in common, and the common points lie in at least one boundary. For Point/Point inputs the relationship is always FALSE, since points do not have a boundary. In mathematical terms: ST_Touches(A, B) ⇔ (Int(A) ⋂ Int(B) ≠ ∅) ∧ (A ⋂ B ≠ ∅) This relationship holds if the DE-9IM Intersection Matrix for the two geometries matches one of: FT******* F**T***** F***T**** This function automatically includes a bounding box comparison that makes use of any spatial indexes that are available on the geometries. To avoid using an index, use _ST_Touches instead. Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.2 // s2.1.13.3 This method implements the SQL/MM specification. SQL-MM 3: 5.1.28
  • ST_Transform - Return a new geometry with coordinates transformed to a different spatial reference system. Description Returns a new geometry with its coordinates transformed to a different spatial reference system. The destination spatial reference to_srid may be identified by a valid SRID integer parameter (i.e. it must exist in the spatial_ref_sys table). Alternatively, a spatial reference defined as a PROJ.4 string can be used for to_proj and/or from_proj, however these methods are not optimized. If the destination spatial reference system is expressed with a PROJ.4 string instead of an SRID, the SRID of the output geometry will be set to zero. With the exception of functions with from_proj, input geometries must have a defined SRID. ST_Transform is often confused with . ST_Transform actually changes the coordinates of a geometry from one spatial reference system to another, while ST_SetSRID() simply changes the SRID identifier of the geometry. ST_Transform automatically selects a suitable conversion pipeline given the source and target spatial reference systems. To use a specific conversion method, use . Requires PostGIS be compiled with PROJ support. Use to confirm you have PROJ support compiled in. If using more than one transformation, it is useful to have a functional index on the commonly used transformations to take advantage of index usage. Prior to 1.3.4, this function crashes if used with geometries that contain CURVES. This is fixed in 1.3.4+ Enhanced: 2.0.0 support for Polyhedral surfaces was introduced. Enhanced: 2.3.0 support for direct PROJ.4 text was introduced. This method implements the SQL/MM specification. SQL-MM 3: 5.1.6 This method supports Circular Strings and Curves. This function supports Polyhedral surfaces.
  • ST_Union - Computes a geometry representing the point-set union of the input geometries. Description Unions the input geometries, merging geometry to produce a result geometry with no overlaps. The output may be an atomic geometry, a MultiGeometry, or a Geometry Collection. Comes in several variants: Two-input variant: returns a geometry that is the union of two input geometries. If either input is NULL, then NULL is returned. Array variant: returns a geometry that is the union of an array of geometries. Aggregate variant: returns a geometry that is the union of a rowset of geometries. The ST_Union() function is an "aggregate" function in the terminology of PostgreSQL. That means that it operates on rows of data, in the same way the SUM() and AVG() functions do and like most aggregates, it also ignores NULL geometries. See for a non-aggregate, single-input variant. The ST_Union array and set variants use the fast Cascaded Union algorithm described in http://blog.cleverelephant.ca/2009/01/must-faster-unions-in-postgis-14.html A gridSize can be specified to work in fixed-precision space. The inputs are snapped to a grid of the given size, and the result vertices are computed on that same grid. (Requires GEOS-3.9.0 or higher) may sometimes be used in place of ST_Union, if the result is not required to be non-overlapping. ST_Collect is usually faster than ST_Union because it performs no processing on the collected geometries. Performed by the GEOS module. ST_Union creates MultiLineString and does not sew LineStrings into a single LineString. Use to sew LineStrings. NOTE: this function was formerly called GeomUnion(), which was renamed from "Union" because UNION is an SQL reserved word. Enhanced: 3.1.0 accept a gridSize parameter. Requires GEOS >= 3.9.0 to use the gridSize parameter Changed: 3.0.0 does not depend on SFCGAL. Availability: 1.4.0 - ST_Union was enhanced. ST_Union(geomarray) was introduced and also faster aggregate collection in PostgreSQL. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.3 Aggregate version is not explicitly defined in OGC SPEC. This method implements the SQL/MM specification. SQL-MM 3: 5.1.19 the z-index (elevation) when polygons are involved. This function supports 3d and will not drop the z-index. However, the result is computed using XY only. The result Z values are copied, averaged or interpolated.
  • ST_Volume - 3차원 입체의 부피를 계산합니다. 표면 도형을 입력하면 (닫힌 도형일지라도) 0을 반환할 것입니다. 설명 2.2.0 버전부터 사용할 수 있습니다. This method needs SFCGAL backend. This function supports 3d and will not drop the z-index. This function supports Polyhedral surfaces. This function supports Triangles and Triangulated Irregular Network Surfaces (TIN). This method implements the SQL/MM specification. SQL-MM IEC 13249-3: 9.1 (same as ST_3DVolume)
  • ST_WKBToSQL - WKB(Well-Known Binary) 표현식으로부터 지정된 ST_Geometry 값을 반환합니다. 이 함수는 SRID를 입력받지 않는 ST_GeomFromWKB 함수와 동일합니다. 설명 This method implements the SQL/MM specification. SQL-MM 3: 5.1.36
  • ST_WKTToSQL - WKT(Well-Known Text)로부터 지정된 ST_Geometry 값을 반환합니다. 이 함수는 ST_GeomFromText 함수와 동일합니다. 설명 This method implements the SQL/MM specification. SQL-MM 3: 5.1.34
  • ST_Within - Tests if every point of A lies in B, and their interiors have a point in common Description Returns TRUE if geometry A is within geometry B. A is within B if and only if all points of A lie inside (i.e. in the interior or boundary of) B (or equivalently, no points of A lie in the exterior of B), and the interiors of A and B have at least one point in common. For this function to make sense, the source geometries must both be of the same coordinate projection, having the same SRID. In mathematical terms: ST_Within(A, B) ⇔ (A ⋂ B = A) ∧ (Int(A) ⋂ Int(B) ≠ ∅) The within relation is reflexive: every geometry is within itself. The relation is antisymmetric: if ST_Within(A,B) = true and ST_Within(B,A) = true, then the two geometries must be topologically equal (ST_Equals(A,B) = true). ST_Within is the converse of . So, ST_Within(A,B) = ST_Contains(B,A). Because the interiors must have a common point, a subtlety of the definition is that lines and points lying fully in the boundary of polygons or lines are not within the geometry. For further details see Subtleties of OGC Covers, Contains, Within. The predicate provides a more inclusive relationship. This function automatically includes a bounding box comparison that makes use of any spatial indexes that are available on the geometries. To avoid index use, use the function _ST_Within. Performed by the GEOS module Enhanced: 2.3.0 Enhancement to PIP short-circuit for geometry extended to support MultiPoints with few points. Prior versions only supported point in polygon. Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Do not use this function with invalid geometries. You will get unexpected results. NOTE: this is the "allowable" version that returns a boolean, not an integer. This method implements the OGC Simple Features Implementation Specification for SQL 1.1. s2.1.1.2 // s2.1.13.3 - a.Relate(b, 'T*F**F***') This method implements the SQL/MM specification. SQL-MM 3: 5.1.30
  • ST_X - Returns the X coordinate of a Point. 설명 포인트의 X 좌표를 반환합니다. X 좌표가 없는 경우 NULL을 반환합니다. 포인트만 입력받을 수 있습니다. To get the minimum and maximum X value of geometry coordinates use the functions and . This method implements the SQL/MM specification. SQL-MM 3: 6.1.3 This function supports 3d and will not drop the z-index.
  • ST_Y - Returns the Y coordinate of a Point. 설명 포인트의 Y 좌표를 반환합니다. Y 좌표가 없는 경우 NULL을 반환합니다. 포인트만 입력받을 수 있습니다. To get the minimum and maximum Y value of geometry coordinates use the functions and . This method implements the OGC Simple Features Implementation Specification for SQL 1.1. This method implements the SQL/MM specification. SQL-MM 3: 6.1.4 This function supports 3d and will not drop the z-index.
  • ST_Z - Returns the Z coordinate of a Point. 설명 포인트의 Z 좌표를 반환합니다. Z 좌표가 없는 경우 NULL을 반환합니다. 포인트만 입력받을 수 있습니다. To get the minimum and maximum Z value of geometry coordinates use the functions and . This method implements the SQL/MM specification. This function supports 3d and will not drop the z-index.
  • TG_ST_SRID - Returns the spatial reference identifier for a topogeometry. 설명 Returns the spatial reference identifier for the ST_Geometry as defined in spatial_ref_sys table. spatial_ref_sys table is a table that catalogs all spatial reference systems known to PostGIS and is used for transformations from one spatial reference system to another. So verifying you have the right spatial reference system identifier is important if you plan to ever transform your geometries. Availability: 3.2.0 This method implements the SQL/MM specification. SQL-MM 3: 14.1.5

12.4. 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 transform - (favoring UTM, Lambert Azimuthal (North/South), and falling back on mercator in worst case scenario)

  • ST_Area - 도형의 기하학적 중심을 반환합니다.
  • ST_AsBinary - Return the OGC/ISO Well-Known Binary (WKB) representation of the geometry/geography without SRID meta data.
  • ST_AsEWKT - 도형의 WKT(Well-Known Text) 표현식을 SRID 메타데이터와 함께 반환합니다.
  • ST_AsGML - 도형을 GML 2 또는 GML 3 버전 요소로 반환합니다.
  • ST_AsGeoJSON - Return a geometry as a GeoJSON element.
  • ST_AsKML - 도형을 GML 2 또는 GML 3 버전 요소로 반환합니다.
  • ST_AsSVG - Returns SVG path data for a geometry.
  • ST_AsText - 도형/지리형의 WKT(Well-Known Text) 표현식을 SRID 메타데이터 없이 반환합니다.
  • ST_Azimuth - 두 도형 사이의 2차원 최단 라인을 반환합니다.
  • ST_Buffer - Computes a geometry covering all points within a given distance from a geometry.
  • ST_Centroid - 도형의 기하학적 중심을 반환합니다.
  • ST_ClosestPoint - Returns the 2D point on g1 that is closest to g2. This is the first point of the shortest line from one geometry to the other.
  • ST_CoveredBy - Tests if every point of A lies in B
  • ST_Covers - Tests if every point of B lies in A
  • ST_DWithin - Tests if two geometries are within a given distance
  • ST_Distance - 두 도형 사이의 3차원 최장(longest) 라인을 반환합니다.
  • ST_GeogFromText - WKT (확장) 표현식으로부터 지정된 지리형 값을 반환합니다.
  • ST_GeogFromWKB - WKB 도형 표현식 또는 EWKB(확장 WKB)로부터 지리형 인스턴스를 생성합니다.
  • ST_GeographyFromText - WKT (확장) 표현식으로부터 지정된 지리형 값을 반환합니다.
  • = - Returns TRUE if the coordinates and coordinate order geometry/geography A are the same as the coordinates and coordinate order of geometry/geography B.
  • ST_Intersection - Computes a geometry representing the shared portion of geometries A and B.
  • ST_Intersects - Tests if two geometries intersect (they have at least one point in common)
  • ST_Length - 도형의 기하학적 중심을 반환합니다.
  • ST_LineInterpolatePoint - Returns a point interpolated along a line at a fractional location.
  • ST_LineInterpolatePoints - Returns points interpolated along a line at a fractional interval.
  • ST_LineLocatePoint - Returns the fractional location of the closest point on a line to a point.
  • ST_LineSubstring - Returns the part of a line between two fractional locations.
  • ST_Perimeter - Returns the length of the boundary of a polygonal geometry or geography.
  • ST_Project - Returns a point projected from a start point by a distance and bearing (azimuth).
  • ST_Segmentize - Returns a modified geometry/geography having no segment longer than a given distance.
  • ST_ShortestLine - 두 도형 사이의 2차원 최단 라인을 반환합니다.
  • ST_Summary - 도형의 내용을 요약한 텍스트를 반환합니다.
  • <-> - A와 B 사이의 2차원 거리를 반환합니다.
  • && - A의 2D 경계 상자와 B의 2D 경계 상자가 교차하는 경우 TRUE 를 반환합니다.

12.5. PostGIS Raster Support Functions

The functions and operators given below are PostGIS functions/operators that take as input or return as output a raster data type object. Listed in alphabetical order.

  • Box3D - 래스터를 둘러싼 상자의 BOX3D 표현식을 반환합니다.
  • @ - B의 경계 상자가 A의 경계 상자를 담고 있을 경우 TRUE 를 반환합니다. 이중 정밀도 경계 상자를 이용합니다.
  • ~ - A의 경계 상자가 B의 경계 상자를 담고 있을 경우 TRUE 를 반환합니다. 이중 정밀도 경계 상자를 이용합니다.
  • = - A의 경계 상자와 B의 경계 상자가 동일할 경우 TRUE 를 반환합니다. 이중 정밀도 경계 상자를 이용합니다.
  • && - A의 경계 상자와 B의 경계 상자가 교차하는 경우 TRUE 를 반환합니다.
  • &< - A의 경계 상자가 B의 경계 상자 왼쪽에 있을 경우 TRUE 를 반환합니다.
  • &> - A의 경계 상자가 B의 경계 상자 오른쪽에 있을 경우 TRUE 를 반환합니다.
  • ~= - A의 경계 상자와 B의 경계 상자가 동일할 경우 TRUE 를 반환합니다.
  • ST_Retile - 임의로 타일화된 래스터 커버리지로부터, 설정된 타일들의 집합을 반환합니다.
  • ST_AddBand - 입력 인덱스 위치에 입력 초기값으로 추가된 입력 유형의 새 밴드(들)을 가진 래스터를 반환합니다. 인덱스를 설정하지 않을 경우, 마지막 위치에 밴드를 추가합니다.
  • ST_AsBinary/ST_AsWKB - Return the Well-Known Binary (WKB) representation of the raster.
  • ST_AsGDALRaster - Return the raster tile in the designated GDAL Raster format. Raster formats are one of those supported by your compiled library. Use ST_GDALDrivers() to get a list of formats supported by your library.
  • ST_AsHexWKB - Return the Well-Known Binary (WKB) in Hex representation of the raster.
  • ST_AsJPEG - 래스터 타일에서 선택한 밴드들을 단일 JPEG(Joint Photographic Exports Group) 이미지(바이트 배열)로 반환합니다. 밴드를 따로 설정하지 않거나, 밴드가 1개거나 또는 3개를 초과할 경우 첫 번째 밴드를 씁니다. 밴드가 3개뿐일 경우 밴드 3개를 모두 써서 RGB에 매핑시킵니다.
  • ST_AsPNG - 래스터 타일에서 선택한 밴드들을 단일 PNG(Portable Network Graphics) 이미지(바이트 배열)로 반환합니다. 래스터의 밴드가 1개, 3개, 또는 4개이거나 따로 설정하지 않을 경우 모든 밴드를 씁니다. 밴드가 2개 또는 4개를 초과하며 따로 설정하지 않을 경우, 밴드 1만 씁니다. 밴드를 RGB 또는 RGBA 스페이스에 매핑합니다.
  • ST_AsRaster - PostGIS 도형을 PostGIS 래스터로 변환합니다.
  • ST_AsTIFF - Return the raster selected bands as a single TIFF image (byte array). If no band is specified or any of specified bands does not exist in the raster, then will try to use all bands.
  • ST_Aspect - 표고 래스터 밴드의 향(기본 단위는 도)을 반환합니다. 지형을 분석하는 데 유용합니다.
  • ST_Band - 기존 래스터의 하나 이상의 밴드를 새 래스터로 반환합니다. 기존 래스터로부터 새 래스터를 빌드하는 데 유용합니다.
  • ST_BandFileSize - Returns the file size of a band stored in file system. If no bandnum specified, 1 is assumed.
  • ST_BandFileTimestamp - Returns the file timestamp of a band stored in file system. If no bandnum specified, 1 is assumed.
  • ST_BandIsNoData - 밴드가 NODATA 값만으로 채워져 있을 경우 참을 반환합니다.
  • ST_BandMetaData - 지정 래스터 밴드에 대한 기본 메타데이터를 반환합니다. 밴드를 지정하지 않을 경우 밴드 1번이라고 가정합니다.
  • ST_BandNoDataValue - 입력 밴드에서 NODATA를 나타내는 값을 반환합니다. 어떤 밴드도 지정하지 않을 경우 밴드 1로 가정합니다.
  • ST_BandPath - 파일 시스템에 저장된 밴드를 가리키는 시스템 파일 경로를 반환합니다. bandnum을 설정하지 않을 경우 밴드 1로 가정합니다.
  • ST_BandPixelType - 입력 밴드의 픽셀 유형을 반환합니다. bandnum을 설정하지 않을 경우 밴드 1로 가정합니다.
  • ST_Clip - 입력 도형으로 잘라낸 래스터를 반환합니다. 밴드 번호를 지정하지 않은 경우, 모든 밴드를 처리합니다. crop 을 설정하지 않거나 참으로 설정한 경우, 잘라낸 래스터를 출력합니다.
  • ST_ColorMap - 소스 래스터 및 설정한 밴드로부터 8BUI 밴드(grayscale, RGB, RGBA)를 4개까지 가지는 새 래스터를 생성합니다. 밴드를 따로 설정하지 않으면 밴드 1로 가정합니다.
  • ST_Contains - 래스터 rastA 외부에 놓인 래스터 rastB의 포인트가 하나도 없고, 적어도 rastB 내부의 포인트 하나가 rastA의 내부에 있는 경우 참을 반환합니다.
  • ST_ContainsProperly - rastB가 rastA의 내부와 교차하지만 rastA의 경계선 또는 외부와 교차하지는 않을 경우 참을 반환합니다.
  • ST_Contour - Generates a set of vector contours from the provided raster band, using the GDAL contouring algorithm.
  • ST_ConvexHull - BandNoDataValue와 일치하는 픽셀 값을 포함한, 래스터의 볼록 껍질 도형을 반환합니다. 정규 형상 및 기울어지지 않은 래스터의 경우, ST_Envelope와 동일한 결과물을 출력하므로 비정규 형상 또는 기울어진 래스터에 대해서만 쓸모가 있습니다.
  • ST_Count - 래스터 또는 래스터 커버리지의 입력 밴드에 있는 픽셀 개수를 반환합니다. 밴드를 따로 설정하지 않을 경우 기본값은 밴드 1입니다. exclude_nodata_value를 참으로 설정할 경우, NODATA 값이 아닌 픽셀의 개수만 반환할 것입니다.
  • ST_CountAgg - 종합 함수입니다. 래스터 집합의 입력 밴드에 있는 픽셀 개수를 반환합니다. 밴드를 따로 설정하지 않을 경우 기본값은 밴드 1입니다. exclude_nodata_value를 참으로 설정할 경우, NODATA 값이 아닌 픽셀의 개수만 반환할 것입니다.
  • ST_CoveredBy - 래스터 rastA의 어떤 포인트도 래스터 rastB 외부에 없을 경우 참을 반환합니다.
  • ST_Covers - 래스터 rastB의 어떤 포인트도 래스터 rastA 외부에 없을 경우 참을 반환합니다.
  • ST_DFullyWithin - 래스터 rastA와 래스터 rastB가 완전히 서로 설정된 거리 안에 있을 경우 참을 반환합니다.
  • ST_DWithin - 래스터 rastA와 래스터 rastB가 서로 설정된 거리 안에 있을 경우 참을 반환합니다.
  • ST_Disjoint - 래스터 rastA와 래스터 rastB가 공간적으로 교차하지 않을 경우 참을 반환합니다.
  • ST_DumpAsPolygons - 입력 래스터 밴드로부터 geomval(geom, val) 행들의 집합을 반환합니다. 밴드 번호를 설정하지 않을 경우 기본적으로 밴드 1로 가정합니다.
  • ST_DumpValues - 지정된 밴드의 값들을 2차원 배열로 반환합니다.
  • ST_Envelope - 래스터 범위의 폴리곤 표현식을 반환합니다.
  • ST_FromGDALRaster - 지원 GDAL 래스터 파일로부터 래스터를 반환합니다.
  • ST_GeoReference - 월드(world) 파일에서 흔히 볼 수 있는 지리참조 메타데이터를 GDAL 또는 ESRI 형식으로 반환합니다. 기본값은 GDAL입니다.
  • ST_Grayscale - Creates a new one-8BUI band raster from the source raster and specified bands representing Red, Green and Blue
  • ST_HasNoBand - 입력된 밴드 번호에 밴드가 없을 경우 참을 반환합니다. 밴드 번호를 설정하지 않을 경우, 밴드 1로 가정합니다.
  • ST_Height - 래스터의 높이를 픽셀 개수로 반환합니다.
  • ST_HillShade - 입력한 방위각, 고도각, 밝기 및 축척을 이용해서 표고 래스터 밴드의 가상적인 음영기복을 반환합니다.
  • ST_Histogram - 빈(bin; 히스토그램 표시에서 수직 막대로 나타나는 단위) 범위로 구분된 래스터 또는 래스터 커버리지의 데이터 분포를 요약하는 레코드 집합을 반환합니다. 따로 설정하지 않을 경우 빈의 개수를 자동으로 계산합니다.
  • ST_InterpolateRaster - Interpolates a gridded surface based on an input set of 3-d points, using the X- and Y-values to position the points on the grid and the Z-value of the points as the surface elevation.
  • ST_Intersection - 두 래스터의 공유 부분을 표현하는, 또는 벡터화된 래스터와 도형의 기하학적 교차를 표현하는 래스터 또는 도형-픽셀값 쌍의 집합을 반환합니다.
  • ST_Intersects - 래스터 rastA와 래스터 rastB가 공간적으로 교차할 경우 참을 반환합니다.
  • ST_IsEmpty - 래스터가 비어 있을 경우 (width = 0, height = 0) 참을 반환합니다. 그렇지 않을 경우 거짓을 반환합니다.
  • ST_MakeEmptyCoverage - Cover georeferenced area with a grid of empty raster tiles.
  • ST_MakeEmptyRaster - 설정된 차원(너비 & 높이), 좌상단 X 및 Y, 픽셀 크기, 회전(scalex, scaley, skewx & skewy) 그리고 공간 참조 시스템(SRID)를 가진 텅 빈 (밴드가 없는) 래스터를 반환합니다. 래스터를 입력할 경우, 동일한 크기, 정렬 방향 및 SRID를 가진 새 래스터를 반환합니다. SRID를 생략할 경우, 공간 참조 시스템을 0(unknown)으로 설정합니다.
  • ST_MapAlgebra (callback function version) - 콜백 함수 버전 - 래스터 1개 이상, 밴드 인덱스, 그리고 사용자 지정 콜백 함수 1개를 입력받아 밴드 1개를 가진 래스터를 반환합니다.
  • ST_MapAlgebraExpr - 래스터 밴드 1개 버전: 입력 래스터에 대해 유효한 PostgreSQL 대수 연산을 적용해서 형성되고, 설정한 픽셀 유형을 가진, 밴드 1개를 가진 새 래스터를 생성합니다. 따로 밴드를 설정하지 않을 경우, 밴드 1로 가정합니다.
  • ST_MapAlgebraExpr - 래스터 밴드 2개 버전: 입력 래스터 2개에 대해 유효한 PostgreSQL 대수 연산을 적용해서 형성되고, 설정한 픽셀 유형을 가진, 밴드 1개를 가진 새 래스터를 생성합니다. 따로 밴드를 설정하지 않을 경우, 각 래스터의 밴드 1로 가정합니다. 출력 래스터는 첫 번째 래스터가 정의하는 그리드 상에 (축척, 기울기 및 픽셀 모서리가) 정렬될 것입니다. extenttype 파라미터가 출력 래스터의 범위를 정의할 것입니다. extenttype 의 값은 INTERSECTION, UNION, FIRST, SECOND가 될 수 있습니다.
  • ST_MapAlgebraFct - 래스터 밴드 1개 버전: 입력 래스터에 대해 유효한 PostgreSQL 대수 연산을 적용해서 형성되고, 설정한 픽셀 유형을 가진, 밴드 1개를 가진 새 래스터를 생성합니다. 따로 밴드를 설정하지 않을 경우, 밴드 1로 가정합니다.
  • ST_MapAlgebraFct - 래스터 밴드 2개 버전: 입력 래스터 2개에 대해 유효한 PostgreSQL 함수를 적용해서 형성되고, 설정한 픽셀 유형을 가진, 밴드 1개를 가진 새 래스터를 생성합니다. 따로 밴드를 설정하지 않을 경우, 밴드 1로 가정합니다. 범위 유형을 따로 설정하지 않을 경우 기본값은 INTERSECTION입니다.
  • ST_MapAlgebraFctNgb - 래스터 밴드 1개 버전: 사용자 지정 PostgreSQL 함수를 이용하는 맵 대수 최근접 이웃(Map Algebra Nearest Neighbor)입니다. 입력 래스터 밴드의 값의 이웃(neighborhood)이 관련된 PostgreSQL 사용자 함수가 출력하는 값을 가진 래스터를 반환합니다.
  • ST_MapAlgebra (expression version) - 표현식 버전 - 입력 래스터 1개 또는 2개, 밴드 인덱스, 그리고 사용자 지정 SQL 표현식 1개 이상을 입력받아 밴드 1개를 가진 래스터를 반환합니다.
  • ST_MemSize - 래스터가 차지하는 공간의 용량을 (바이트 단위로) 반환합니다.
  • ST_MetaData - 래스터 객체의 픽셀 크기, 회전(skew), 좌상단, 좌하단 등과 같은 기본 메타데이터를 반환합니다.
  • ST_MinConvexHull - 래스터의 NODATA 픽셀을 제외한 볼록 껍질 도형을 반환합니다.
  • ST_NearestValue - columnx 및 rowy, 또는 래스터와 동일한 공간 참조 좌표 시스템 단위로 표현된 기하학적 포인트로 지정된 입력 밴드의 픽셀에 가장 가까운 NODATA 가 아닌 값을 반환합니다.
  • ST_Neighborhood - columnx 및 rowy, 또는 래스터와 동일한 공간 참조 좌표 시스템 단위로 표현된 기하학적 포인트로 지정된 입력 밴드의 픽셀 주위의 NODATA 가 아닌 값들의 이중 정밀도 데이터형 2차원 배열을 반환합니다.
  • ST_NotSameAlignmentReason - 래스터들이 정렬돼 있는지 아닌지, 그리고 정렬되지 않았다면 그 이유를 설명하는 텍스트를 반환합니다.
  • ST_NumBands - 래스터 객체 내부에 있는 밴드들의 개수를 반환합니다.
  • ST_Overlaps - 래스터 rastA와 래스터 rastB가 교차하지만 어느 한 쪽이 다른 한 쪽을 완전히 담고 있지는 않을 경우 참을 반환합니다.
  • ST_PixelAsCentroid - 픽셀 하나가 차지하는 면의 중심점(포인트 도형)을 반환합니다.
  • ST_PixelAsCentroids - 래스터 밴드의 각 픽셀에 대한 중심점(포인트 도형)을 각 픽셀의 값 및 X, Y 래스터 좌표와 함께 반환합니다. 포인트 도형은 픽셀이 차지하는 면의 중심점입니다.
  • ST_PixelAsPoint - 픽셀의 좌상단에 위치하는 포인트 도형을 반환합니다.
  • ST_PixelAsPoints - 래스터 밴드의 각 픽셀에 대한 포인트 도형을 각 픽셀의 값 및 X, Y 래스터 좌표와 함께 반환합니다. 포인트 도형의 좌표는 픽셀의 좌상단 좌표입니다.
  • ST_PixelAsPolygon - 특정 행 및 열에 대한 픽셀의 경계를 이루는 폴리곤 도형을 반환합니다.
  • ST_PixelAsPolygons - 래스터 밴드의 모든 픽셀의 경계를 이루는 폴리곤 도형을 각 픽셀의 값과 X, Y 래스터 좌표와 함께 반환합니다.
  • ST_PixelHeight - 픽셀 높이를 공간 참조 시스템의 기하 단위로 반환합니다.
  • ST_PixelOfValue - 검색 값과 일치하는 값을 가진 픽셀의 columnx, rowy 좌표를 반환합니다.
  • ST_PixelWidth - 픽셀 너비를 공간 참조 시스템의 기하 단위로 반환합니다.
  • ST_Polygon - NODATA 값이 아닌 픽셀 값을 가진 픽셀들을 통합해서 형성된 멀티폴리곤 도형을 반환합니다.
  • ST_Quantile - 샘플링 또는 채우기(population)라는 맥락에서 래스터 또는 래스터 테이블 커버리지의 사분위(quantile)를 계산합니다. 따라서, 래스터의 25%, 50%, 75% 백분위(percentile) 단계로 값을 확인할 수 있습니다.
  • ST_RastFromHexWKB - Return a raster value from a Hex representation of Well-Known Binary (WKB) raster.
  • ST_RastFromWKB - Return a raster value from a Well-Known Binary (WKB) raster.
  • ST_RasterToWorldCoord - 주어진 열과 행에 있는 래스터의 좌상단의 기하학적 X, Y(경도, 위도)를 으로 반환합니다. 열과 행은 1부터 시작합니다.
  • ST_RasterToWorldCoordX - 열과 행에 있는 래스터의 좌상단의 기하학적 X 좌표를 반환합니다. 열과 행의 번호는 1부터 시작합니다.
  • ST_RasterToWorldCoordY - 열과 행에 있는 래스터의 좌상단의 기하학적 Y 좌표를 반환합니다. 열과 행의 번호는 1부터 시작합니다.
  • ST_Reclass - 원본으로부터 재분류된 밴드 유형으로 이루어진 새 래스터를 생성합니다. nband 는 변경할 밴드를 가리킵니다. nband 를 따로 설정하지 않을 경우 밴드 1로 가정합니다. 다른 모든 밴드들은 변경 없이 반환됩니다. 실제 사례: 보기 좋은 형식으로 더 간단하게 렌더링하기 위해 16BUI 밴드를 8BUI 등등으로 변환하십시오.
  • ST_Resample - 특정 리샘플링 알고리즘, 새로운 차원, 임의의 그리드 모서리, 그리고 또 다른 래스터에서 정의되거나 빌려온 래스터 지리참조 속성들의 집합을 이용해서 래스터를 리샘플링합니다.
  • ST_Rescale - Resample a raster by adjusting only its scale (or pixel size). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline, Lanczos, Max or Min resampling algorithm. Default is NearestNeighbor.
  • ST_Resize - 래스터의 크기를 새 너비/높이로 조정합니다.
  • ST_Reskew - 기울기(또는 회전각 파라미터)만 조정해서 래스터를 리샘플링합니다. NearestNeighbor(영국 또는 미국 철자), Bilinear, Cubic, CubicSpline 또는 Lanczos 리샘플링 알고리즘을 이용해서 새 픽셀 값을 계산합니다. 기본값은 NearestNeighbor입니다.
  • ST_Rotation - 래스터의 회전각을 라디안으로 반환합니다.
  • ST_Roughness - DEM의 계산된 "거칠기(roughness)"와 함께 래스터를 반환합니다.
  • ST_SRID - spatial_ref_sys 테이블에 정의되어 있는, 래스터의 공간 참조 식별자를 반환합니다.
  • ST_SameAlignment - 래스터들이 동일한 기울기, 축척, 공간 참조 시스템, 그리고 오프셋을 가지고 있을 경우 (픽셀이 다른 픽셀을 침범하지 않고 동일한 그리드에 놓일 수 있을 경우) 참을 반환하고, 그렇지 않을 경우 문제점을 설명하는 안내문과 함께 거짓을 반환합니다.
  • ST_ScaleX - 픽셀 너비의 X 요소를 좌표 참조 시스템의 단위로 반환합니다.
  • ST_ScaleY - 픽셀 높이의 Y 요소를 좌표 참조 시스템의 단위로 반환합니다.
  • ST_SetBandIndex - Update the external band number of an out-db band
  • ST_SetBandIsNoData - 밴드의 isnodata 플래그를 참으로 설정합니다.
  • ST_SetBandNoDataValue - NODATA를 나타내는 입력 밴드의 값을 설정합니다. 밴드를 따로 설정하지 않을 경우 밴드 1로 가정합니다. 밴드에 NODATA가 없다고 표시하려면, nodata value = NULL이라고 설정하십시오.
  • ST_SetBandPath - Update the external path and band number of an out-db band
  • ST_SetGeoReference - 단일 호출로 지리참조 파라미터 6개를 설정합니다. 숫자를 공백으로 구분해야 합니다. GDAL 또는 ESRI 서식의 입력물을 받아들입니다. 기본값은 GDAL입니다.
  • ST_SetM - Returns a geometry with the same X/Y coordinates as the input geometry, and values from the raster copied into the M dimension using the requested resample algorithm.
  • ST_SetRotation - 래스터의 회전각을 라디안으로 설정합니다.
  • ST_SetSRID - 래스터의 SRID를 spatial_ref_sys 테이블에 정의된 특정 SRID의 정수값으로 설정합니다.
  • ST_SetScale - X 및 Y 픽셀 크기를 좌표 참조 시스템의 단위로 설정합니다. 단위/픽셀 너비/픽셀 높이 순서입니다.
  • ST_SetSkew - 지리참조 X 및 Y 기울기(skew)(또는 회전각 파라미터)를 설정합니다. 값 하나만 입력할 경우, X와 Y를 동일한 값으로 설정합니다.
  • ST_SetUpperLeft - Sets the value of the upper left corner of the pixel of the raster to projected X and Y coordinates.
  • ST_SetValue - 입력한 columnx, rowy 픽셀 또는 특정 도형과 교차하는 픽셀들의 위치의 밴드 값을 설정해서 나온 수정된 래스터를 반환합니다. 밴드 번호는 1부터 시작하며, 따로 설정하지 않을 경우 1로 가정합니다.
  • ST_SetValues - 지정한 밴드의 값들을 설정해서 나온 수정된 래스터를 반환합니다.
  • ST_SetZ - Returns a geometry with the same X/Y coordinates as the input geometry, and values from the raster copied into the Z dimension using the requested resample algorithm.
  • ST_SkewX - 지리참조 X 기울기(skew)(또는 회전각 파라미터)를 반환합니다.
  • ST_SkewY - 지리참조 Y 기울기(또는 회전각 파라미터)를 반환합니다.
  • ST_Slope - 표고 래스터 밴드의 경사(기본 단위는 도)를 반환합니다. 지형을 분석하는 데 유용합니다.
  • ST_SnapToGrid - 그리드에 래스터를 스냅시켜서 래스터를 리샘플링합니다. NearestNeighbor(영국 또는 미국 철자), Bilinear, Cubic, CubicSpline 또는 Lanczos 리샘플링 알고리즘을 이용해서 새 픽셀 값을 계산합니다. 기본값은 NearestNeighbor입니다.
  • ST_Summary - 래스터의 내용을 요약한 텍스트를 반환합니다.
  • ST_SummaryStats - 입력한 래스터 밴드 또는 래스터 또는 래스터 커버리지의 count, sum, mean, stddev, min, max로 이루어진 통계 요약을 반환합니다. 밴드를 따로 설정하지 않을 경우 밴드 1로 가정합니다.
  • ST_SummaryStatsAgg - 종합 함수입니다. 래스터 집합의 입력 래스터 밴드의 count, sum, mean, stddev, min, max로 이루어진 통계 요약을 반환합니다. 밴드를 따로 설정하지 않을 경우 밴드 1로 가정합니다.
  • ST_TPI - 계산된 지형위치지수(Topographic Position Index)와 함께 래스터를 반환합니다.
  • ST_TRI - 계산된 지형험준도지수(Terrain Ruggedness Index)와 함께 래스터를 반환합니다.
  • ST_Tile - 출력 래스터에 원하는 차원을 바탕으로 입력 래스터를 분할해서 나온 래스터들의 집합을 반환합니다.
  • ST_Touches - 래스터 rastA와 래스터 rastB가 최소한 포인트 한 개를 공유하지만, 내부가 교차하지는 않을 경우 TRUE 를 반환합니다.
  • ST_Transform - 알려진 공간 참조 시스템의 래스터를 지정한 리샘플링 알고리즘을 통해 또 다른 알려진 공간 참조 시스템으로 재투영합니다. NearestNeighbor, Bilinear, Cubic, CubicSpline, Lanczos 알고리즘을 이용할 수 있습니다. 기본값은 NearestNeighbor입니다.
  • ST_Union - 래스터 타일 집합을 1개 이상의 밴드로 이루어진 단일 래스터로 통합합니다.
  • ST_UpperLeftX - 래스터의 좌상단 X 좌표를 투영된 공간 참조 단위로 반환합니다.
  • ST_UpperLeftY - 래스터의 좌상단 Y 좌표를 투영된 공간 참조 단위로 반환합니다.
  • ST_Value - 입력 columnx, rowy 픽셀의 입력 밴드의 값, 또는 특정 기하학적 포인트의 밴드의 값을 반환합니다. 밴드 번호는 1부터 시작하며, 따로 지정하지 않을 경우 1로 가정합니다. exclude_nodata_value 를 거짓으로 설정할 경우, nodata 픽셀을 포함한 모든 픽셀이 교차한다고 가정하고 값을 반환합니다. exclude_nodata_value 를 설정하지 않은 경우, 래스터의 메타데이터에서 값을 읽어 들입니다.
  • ST_ValueCount - 설정한 값들의 집합을 가진 래스터(또는 래스터 커버리지)의 입력 밴드에 있는 픽셀 밴드 값 및 픽셀 개수의 집계를 담고 있는 레코드 집합을 반환합니다. 밴드를 따로 설정하지 않을 경우 기본값은 밴드 1입니다. 기본적으로 NODATA 값은 집계되지 않습니다. 픽셀의 다른 모든 값들을 출력하는데, 픽셀 밴드 값은 가장 가까운 정수로 반올림됩니다.
  • ST_Width - 래스터의 너비를 픽셀 개수로 반환합니다.
  • ST_Within - 래스터 rastB 외부에 놓인 래스터 rastA의 포인트가 하나도 없고, 적어도 rastA 내부의 포인트 하나가 rastB의 내부에 있는 경우 참을 반환합니다.
  • ST_WorldToRasterCoord - 주어진 기하학적 X, Y(경도, 위도)의 좌상단을 열과 행으로 또는 래스터의 공간 참조 좌표 시스템 단위로 표현된 포인트 도형으로 반환합니다.
  • ST_WorldToRasterCoordX - 포인트 도형(pt)의 래스터 안의 열 또는 래스터의 월드 공간 참조 시스템 단위로 표현된 X, Y 월드 좌표(xw, yw)를 반환합니다.
  • ST_WorldToRasterCoordY - 포인트 도형(pt)의 래스터 안의 행 또는 래스터의 월드 공간 참조 시스템 단위로 표현된 X, Y 월드 좌표(xw, yw)를 반환합니다.
  • UpdateRasterSRID - 사용자가 지정한 열 및 테이블에 있는 모든 래스터의 SRID를 변경합니다.
  • ST_MinPossibleValue - 래스터 객체 내부에 있는 밴드들의 개수를 반환합니다.

12.6. PostGIS Geometry / Geography / Raster Dump Functions

The functions given below are PostGIS functions that take as input or return as output a set of or single geometry_dump or geomval data type object.

  • ST_DumpAsPolygons - 입력 래스터 밴드로부터 geomval(geom, val) 행들의 집합을 반환합니다. 밴드 번호를 설정하지 않을 경우 기본적으로 밴드 1로 가정합니다.
  • ST_Intersection - 두 래스터의 공유 부분을 표현하는, 또는 벡터화된 래스터와 도형의 기하학적 교차를 표현하는 래스터 또는 도형-픽셀값 쌍의 집합을 반환합니다.

12.7. PostGIS Box Functions

The functions given below are PostGIS functions that take as input or return as output the box* family of PostGIS spatial types. The box family of types consists of box2d, and box3d

  • Box2D - Returns a BOX2D representing the 2D extent of a geometry.
  • Box3D - Returns a BOX3D representing the 3D extent of a geometry.
  • Box3D - 래스터를 둘러싼 상자의 BOX3D 표현식을 반환합니다.
  • ST_3DExtent - Aggregate function that returns the 3D bounding box of geometries.
  • ST_3DMakeBox - Creates a BOX3D defined by two 3D point geometries.
  • ST_AsMVTGeom - Transforms a geometry into the coordinate space of a MVT tile.
  • ST_AsTWKB - 도형을 TWKB(Tiny Well-Known Binary)로 반환합니다.
  • ST_Box2dFromGeoHash - GeoHash 스트링으로부터 BOX2D를 반환합니다.
  • ST_ClipByBox2D - Computes the portion of a geometry falling within a rectangle.
  • ST_EstimatedExtent - Returns the estimated extent of a spatial table.
  • ST_Expand - Returns a bounding box expanded from another bounding box or a geometry.
  • ST_Extent - Aggregate function that returns the bounding box of geometries.
  • ST_MakeBox2D - Creates a BOX2D defined by two 2D point geometries.
  • ST_XMax - Returns the X maxima of a 2D or 3D bounding box or a geometry.
  • ST_XMin - Returns the X minima of a 2D or 3D bounding box or a geometry.
  • ST_YMax - Returns the Y maxima of a 2D or 3D bounding box or a geometry.
  • ST_YMin - Returns the Y minima of a 2D or 3D bounding box or a geometry.
  • ST_ZMax - Returns the Z maxima of a 2D or 3D bounding box or a geometry.
  • ST_ZMin - Returns the Z minima of a 2D or 3D bounding box or a geometry.
  • RemoveUnusedPrimitives - Removes topology primitives which not needed to define existing TopoGeometry objects.
  • ValidateTopology - Returns a set of validatetopology_returntype objects detailing issues with topology.
  • ~(box2df,box2df) - Returns TRUE if a 2D float precision bounding box (BOX2DF) contains another 2D float precision bounding box (BOX2DF).
  • ~(box2df,geometry) - Returns TRUE if a 2D float precision bounding box (BOX2DF) contains a geometry's 2D bonding box.
  • ~(geometry,box2df) - Returns TRUE if a geometry's 2D bonding box contains a 2D float precision bounding box (GIDX).
  • @(box2df,box2df) - Returns TRUE if a 2D float precision bounding box (BOX2DF) is contained into another 2D float precision bounding box.
  • @(box2df,geometry) - Returns TRUE if a 2D float precision bounding box (BOX2DF) is contained into a geometry's 2D bounding box.
  • @(geometry,box2df) - Returns TRUE if a geometry's 2D bounding box is contained into a 2D float precision bounding box (BOX2DF).
  • &&(box2df,box2df) - Returns TRUE if two 2D float precision bounding boxes (BOX2DF) intersect each other.
  • &&(box2df,geometry) - Returns TRUE if a 2D float precision bounding box (BOX2DF) intersects a geometry's (cached) 2D bounding box.
  • &&(geometry,box2df) - Returns TRUE if a geometry's (cached) 2D bounding box intersects a 2D float precision bounding box (BOX2DF).

12.8. PostGIS Functions that support 3D

The functions given below are PostGIS functions that do not throw away the Z-Index.

  • AddGeometryColumn - 공간 테이블에서 지오메트리 컬럼을 제거합니다.
  • Box3D - Returns a BOX3D representing the 3D extent of a geometry.
  • DropGeometryColumn - 공간 테이블에서 지오메트리 컬럼을 제거합니다.
  • GeometryType - ST_Geometry 값의 도형 유형을 반환합니다.
  • ST_3DArea - 3차원 표면 도형의 면적을 계산합니다. 입체일 경우 0을 반환할 것입니다.
  • ST_3DClosestPoint - g2에 가장 가까운 g1 상에 있는 3차원 포인트를 반환합니다. 해당 포인트는 3D 최단 라인의 첫 번째 포인트입니다.
  • ST_3DConvexHull - 면 도형의 근사 중심축을 계산합니다.
  • ST_3DDFullyWithin - Tests if two 3D geometries are entirely within a given 3D distance
  • ST_3DDWithin - Tests if two 3D geometries are within a given 3D distance
  • ST_3DDifference - 3차원 차이를 수행합니다.
  • ST_3DDistance - 도형 유형에 대해, 두 도형 사이의 (SRS에 기반한) 3차원 데카르트 최단 거리를 투영 단위로 반환합니다.
  • ST_3DExtent - Aggregate function that returns the 3D bounding box of geometries.
  • ST_3DIntersection - 3차원 교차를 수행합니다.
  • ST_3DIntersects - Tests if two geometries spatially intersect in 3D - only for points, linestrings, polygons, polyhedral surface (area)
  • ST_3DLength - 도형의 기하학적 중심을 반환합니다.
  • ST_3DLineInterpolatePoint - Returns a point interpolated along a 3D line at a fractional location.
  • ST_3DLongestLine - 두 도형 사이의 3차원 최장(longest) 라인을 반환합니다.
  • ST_3DMaxDistance - 도형 유형에 대해, 두 도형 사이의 (SRS에 기반한) 3차원 데카르트 최장 거리를 투영 단위로 반환합니다.
  • ST_3DPerimeter - 도형의 기하학적 중심을 반환합니다.
  • ST_3DShortestLine - 두 도형 사이의 3차원 최단(shortest) 라인을 반환합니다.
  • ST_3DUnion - Perform 3D union.
  • ST_AddMeasure - Interpolates measures along a linear geometry.
  • ST_AddPoint - 라인스트링에 포인트를 추가합니다.
  • ST_Affine - Apply a 3D affine transformation to a geometry.
  • ST_ApproximateMedialAxis - 면 도형의 근사 중심축을 계산합니다.
  • ST_AsBinary - Return the OGC/ISO Well-Known Binary (WKB) representation of the geometry/geography without SRID meta data.
  • ST_AsEWKB - Return the Extended Well-Known Binary (EWKB) representation of the geometry with SRID meta data.
  • ST_AsEWKT - 도형의 WKT(Well-Known Text) 표현식을 SRID 메타데이터와 함께 반환합니다.
  • ST_AsGML - 도형을 GML 2 또는 GML 3 버전 요소로 반환합니다.
  • ST_AsGeoJSON - Return a geometry as a GeoJSON element.
  • ST_AsHEXEWKB - 도형을 소 엔디안(NDR) 또는 대 엔디안(XDR) 인코딩을 통해 HEXEWKB (텍스트) 형식으로 반환합니다.
  • ST_AsKML - 도형을 GML 2 또는 GML 3 버전 요소로 반환합니다.
  • ST_AsX3D - 도형을 X3D XML 노드 요소 형식: ISO-IEC-19776-1.2-X3DEncodings-XML로 반환합니다.
  • ST_Boundary - 해당 도형의 결합된 범위의 닫힘 여부를 반환합니다.
  • ST_BoundingDiagonal - 주어진 도형의 경계 상자의 대각선을 반환합니다.
  • ST_CPAWithin - Tests if the closest point of approach of two trajectories is within the specified distance.
  • ST_ChaikinSmoothing - Returns a smoothed version of a geometry, using the Chaikin algorithm
  • ST_ClosestPointOfApproach - Returns a measure at the closest point of approach of two trajectories.
  • ST_Collect - Creates a GeometryCollection or Multi* geometry from a set of geometries.
  • ST_ConstrainedDelaunayTriangles - Return a constrained Delaunay triangulation around the given input geometry.
  • ST_ConvexHull - Computes the convex hull of a geometry.
  • ST_CoordDim - ST_Geometry 값의 좌표 차원을 반환합니다.
  • ST_CurveToLine - Converts a geometry containing curves to a linear geometry.
  • ST_DelaunayTriangles - Returns the Delaunay triangulation of the vertices of a geometry.
  • ST_Difference - Computes a geometry representing the part of geometry A that does not intersect geometry B.
  • ST_DistanceCPA - Returns the distance between the closest point of approach of two trajectories.
  • ST_Dump - Returns a set of geometry_dump rows for the components of a geometry.
  • ST_DumpPoints - 도형의 내용을 요약한 텍스트를 반환합니다.
  • ST_DumpRings - Returns a set of geometry_dump rows for the exterior and interior rings of a Polygon.
  • ST_DumpSegments - 도형의 내용을 요약한 텍스트를 반환합니다.
  • ST_EndPoint - ST_LineString 또는 ST_CircularString 값에 있는 포인트의 개수를 반환합니다.
  • ST_ExteriorRing - 폴리곤 도형의 내곽 고리의 개수를 반환합니다.
  • ST_Extrude - 표면을 관련 입체로 돌출시킵니다.
  • ST_FlipCoordinates - Returns a version of a geometry with X and Y axis flipped.
  • ST_Force2D - 도형을 "2차원 모드"로 강제합니다.
  • ST_ForceCurve - 적용이 가능한 경우, 도형을 해당 도형의 만곡 유형으로 상위 형변환(upcast)합니다.
  • ST_ForceLHR - LHR(Left Hand Reverse; 시계 방향) 방향을 강제합니다.
  • ST_ForcePolygonCCW - Orients all exterior rings counter-clockwise and all interior rings clockwise.
  • ST_ForcePolygonCW - Orients all exterior rings clockwise and all interior rings counter-clockwise.
  • ST_ForceRHR - 폴리곤 안에 있는 꼭짓점들의 방향(orientation)이 오른손 법칙(Right-Hand Rule)을 따르도록 강제합니다.
  • ST_ForceSFS - 도형이 SFS 1.1 도형 유형만을 쓰도록 강제합니다.
  • ST_Force_3D - 도형을 XYZ 모드로 강제합니다. ST_Force3DZ라고도 합니다.
  • ST_Force_3DZ - 도형을 XYZ 모드로 강제합니다.
  • ST_Force_4D - 도형을 XYZM 모드로 강제합니다.
  • ST_Force_Collection - 도형을 도형 집합으로 변환합니다.
  • ST_GeomFromEWKB - EWKB(Extended Well-Known Binary)로부터 지정된 ST_Geometry 값을 반환합니다.
  • ST_GeomFromEWKT - EWKT(Extended Well-Known Text)로부터 지정된 ST_Geometry 값을 반환합니다.
  • ST_GeomFromGML - 도형의 GML 표현식을 입력받아 PostGIS 도형 객체를 출력합니다.
  • ST_GeomFromGeoJSON - GeoJSON 표현식을 입력받아 PostGIS 도형 객체를 출력합니다.
  • ST_GeomFromKML - 도형의 KML 표현식을 입력받아 PostGIS 도형 객체를 출력합니다.
  • ST_GeometricMedian - 멀티 포인트의 기하학적 중심값(median)을 반환합니다.
  • ST_GeometryN - ST_Geometry 값의 도형 유형을 반환합니다.
  • ST_GeometryType - ST_Geometry 값의 도형 유형을 반환합니다.
  • ST_HasArc - Tests if a geometry contains a circular arc
  • ST_InteriorRingN - 폴리곤 도형의 내곽 고리의 개수를 반환합니다.
  • ST_InterpolatePoint - 입력 포인트에 가까운 포인트에서 도형의 척도 차원(M 차원)의 값을 반환합니다.
  • ST_Intersection - Computes a geometry representing the shared portion of geometries A and B.
  • ST_IsClosed - LINESTRING 의 시작점과 종단점이 일치하는 경우 TRUE 를 반환합니다. 다면체 표면이 닫혀 (부피를 가지고) 있는 경우 TRUE 를 반환합니다.
  • ST_IsCollection - 해당 도형이 텅 빈 도형 집합, 폴리곤, 포인트 등인 경우 TRUE 를 반환합니다.
  • ST_IsPlanar - 표면이 평면인지 아닌지 확인합니다.
  • ST_IsPolygonCCW - Tests if Polygons have exterior rings oriented counter-clockwise and interior rings oriented clockwise.
  • ST_IsPolygonCW - Tests if Polygons have exterior rings oriented clockwise and interior rings oriented counter-clockwise.
  • ST_IsSimple - 해당 도형이 자체 교차하거나 자체 접촉하는 이례적인 도형 포인트를 가지고 있지 않을 경우 TRUE 를 반환합니다.
  • ST_IsSolid - 도형이 입체인지 테스트합니다. 어떤 유효성 검사도 수행하지 않습니다.
  • ST_IsValidTrajectory - Tests if the geometry is a valid trajectory.
  • ST_Length_Spheroid - 도형의 기하학적 중심을 반환합니다.
  • ST_LineFromMultiPoint - 멀티포인트 도형으로부터 라인스트링을 생성합니다.
  • ST_LineInterpolatePoint - Returns a point interpolated along a line at a fractional location.
  • ST_LineInterpolatePoints - Returns points interpolated along a line at a fractional interval.
  • ST_LineSubstring - Returns the part of a line between two fractional locations.
  • ST_LineToCurve - Converts a linear geometry to a curved geometry.
  • ST_LocateBetweenElevations - Returns the portions of a geometry that lie in an elevation (Z) range.
  • ST_M - Returns the M coordinate of a Point.
  • ST_MakeLine - 포인트, 멀티포인트 또는 라인 도형으로부터 라인스트링을 생성합니다.
  • ST_MakePoint - Creates a 2D, 3DZ or 4D Point.
  • ST_MakePolygon - Creates a Polygon from a shell and optional list of holes.
  • ST_MakeSolid - 도형을 입체로 지정합니다. 어떤 확인 작업도 수행하지 않습니다. 유효한 입체를 얻으려면, 입력 도형이 닫힌 다면체 표면 또는 닫힌 TIN이어야만 합니다.
  • ST_MakeValid - Attempts to make an invalid geometry valid without losing vertices.
  • ST_MemSize - ST_Geometry 값의 도형 유형을 반환합니다.
  • ST_MemUnion - Aggregate function which unions geometries in a memory-efficent but slower way
  • ST_NDims - ST_Geometry 값의 좌표 차원을 반환합니다.
  • ST_NPoints - 도형이 가지고 있는 포인트(꼭짓점)의 개수를 반환합니다.
  • ST_NRings - 폴리곤 도형의 내곽 고리의 개수를 반환합니다.
  • ST_Node - Nodes a collection of lines.
  • ST_NumGeometries - 도형이 가지고 있는 포인트의 개수를 반환합니다. 모든 도형을 입력받을 수 있습니다.
  • ST_NumPatches - 다면체 표면 상에 있는 면의 개수를 반환합니다. 다면체 도형이 아닌 경우 NULL을 반환할 것입니다.
  • ST_Orientation - 표면의 방향(orientation)을 결정합니다.
  • ST_PatchN - ST_Geometry 값의 도형 유형을 반환합니다.
  • ST_PointFromWKB - 주어진 SRID와 함께 WKB로부터 도형을 만듭니다.
  • ST_PointN - ST_LineString 또는 ST_CircularString 값에 있는 포인트의 개수를 반환합니다.
  • ST_PointOnSurface - Computes a point guaranteed to lie in a polygon, or on a geometry.
  • ST_Points - 도형의 모든 좌표들을 담고 있는 멀티포인트를 반환합니다.
  • ST_Polygon - Creates a Polygon from a LineString with a specified SRID.
  • ST_RemovePoint - Remove a point from a linestring.
  • ST_RemoveRepeatedPoints - Returns a version of a geometry with duplicate points removed.
  • ST_Reverse - 꼭짓점들의 순서가 반대인 도형을 반환합니다.
  • ST_Rotate - Rotates a geometry about an origin point.
  • ST_RotateX - Rotates a geometry about the X axis.
  • ST_RotateY - Rotates a geometry about the Y axis.
  • ST_RotateZ - Rotates a geometry about the Z axis.
  • ST_Scale - Scales a geometry by given factors.
  • ST_Scroll - Change start point of a closed LineString.
  • ST_SetPoint - 라인스트링의 포인트를 주어진 포인트로 대체합니다.
  • ST_ShiftLongitude - Shifts the longitude coordinates of a geometry between -180..180 and 0..360.
  • ST_SnapToGrid - 입력 도형의 모든 포인트를 정규 그리드로 스냅(snap)시킵니다.
  • ST_StartPoint - Returns the first point of a LineString.
  • ST_StraightSkeleton - 도형으로부터 직선 골격(straight skeleton)을 계산합니다.
  • ST_SwapOrdinates - 입력 도형을 좌표값을 뒤바꾼 상태로 반환합니다.
  • ST_SymDifference - Computes a geometry representing the portions of geometries A and B that do not intersect.
  • ST_Tesselate - 폴리곤 또는 다면체 표면의 표면 다듬기(tesselation) 작업을 수행한 다음 TIN 또는 TIN 집합으로 반환합니다.
  • ST_TransScale - Translates and scales a geometry by given offsets and factors.
  • ST_Translate - Translates a geometry by given offsets.
  • ST_UnaryUnion - Computes the union of the components of a single geometry.
  • ST_Union - Computes a geometry representing the point-set union of the input geometries.
  • ST_Volume - 3차원 입체의 부피를 계산합니다. 표면 도형을 입력하면 (닫힌 도형일지라도) 0을 반환할 것입니다.
  • ST_WrapX - X값 근처에서 도형을 래핑합니다.
  • ST_X - Returns the X coordinate of a Point.
  • ST_XMax - Returns the X maxima of a 2D or 3D bounding box or a geometry.
  • ST_XMin - Returns the X minima of a 2D or 3D bounding box or a geometry.
  • ST_Y - Returns the Y coordinate of a Point.
  • ST_YMax - Returns the Y maxima of a 2D or 3D bounding box or a geometry.
  • ST_YMin - Returns the Y minima of a 2D or 3D bounding box or a geometry.
  • ST_Z - Returns the Z coordinate of a Point.
  • ST_ZMax - Returns the Z maxima of a 2D or 3D bounding box or a geometry.
  • ST_ZMin - Returns the Z minima of a 2D or 3D bounding box or a geometry.
  • ST_Zmflag - ST_Geometry 값의 좌표 차원을 반환합니다.
  • TG_Equals - 두 TopoGeometry가 동일한 지형 원시형으로 이루어졌을 경우 참을 반환합니다.
  • TG_Intersects - 두 TopoGeometry에서 나온 원시형의 쌍 가운데 하나라도 교차할 경우 참을 반환합니다.
  • UpdateGeometrySRID - Updates the SRID of all features in a geometry column, and the table metadata.
  • geometry_overlaps_nd - A의 n차원 경계 상자와 B의 n차원 경계 상자가 교차하는 경우 TRUE 를 반환합니다.
  • overlaps_nd_geometry_gidx - Returns TRUE if a geometry's (cached) n-D bounding box intersects a n-D float precision bounding box (GIDX).
  • overlaps_nd_gidx_geometry - Returns TRUE if a n-D float precision bounding box (GIDX) intersects a geometry's (cached) n-D bounding box.
  • overlaps_nd_gidx_gidx - Returns TRUE if two n-D float precision bounding boxes (GIDX) intersect each other.
  • postgis_sfcgal_full_version - Returns the full version of SFCGAL in use including CGAL and Boost versions
  • postgis_sfcgal_version - 실행중인 SFCGAL의 버전을 반환합니다.

12.9. PostGIS Curved Geometry Support Functions

The functions given below are PostGIS functions that can use CIRCULARSTRING, CURVEPOLYGON, and other curved geometry types

  • AddGeometryColumn - 공간 테이블에서 지오메트리 컬럼을 제거합니다.
  • Box2D - Returns a BOX2D representing the 2D extent of a geometry.
  • Box3D - Returns a BOX3D representing the 3D extent of a geometry.
  • DropGeometryColumn - 공간 테이블에서 지오메트리 컬럼을 제거합니다.
  • GeometryType - ST_Geometry 값의 도형 유형을 반환합니다.
  • PostGIS_AddBBox - Add bounding box to the geometry.
  • PostGIS_DropBBox - Drop the bounding box cache from the geometry.
  • PostGIS_HasBBox - Returns TRUE if the bbox of this geometry is cached, FALSE otherwise.
  • ST_3DExtent - Aggregate function that returns the 3D bounding box of geometries.
  • ST_Affine - Apply a 3D affine transformation to a geometry.
  • ST_AsBinary - Return the OGC/ISO Well-Known Binary (WKB) representation of the geometry/geography without SRID meta data.
  • ST_AsEWKB - Return the Extended Well-Known Binary (EWKB) representation of the geometry with SRID meta data.
  • ST_AsEWKT - 도형의 WKT(Well-Known Text) 표현식을 SRID 메타데이터와 함께 반환합니다.
  • ST_AsHEXEWKB - 도형을 소 엔디안(NDR) 또는 대 엔디안(XDR) 인코딩을 통해 HEXEWKB (텍스트) 형식으로 반환합니다.
  • ST_AsSVG - Returns SVG path data for a geometry.
  • ST_AsText - 도형/지리형의 WKT(Well-Known Text) 표현식을 SRID 메타데이터 없이 반환합니다.
  • ST_ClusterDBSCAN - Window function that returns a cluster id for each input geometry using the DBSCAN algorithm.
  • ST_ClusterWithin - Aggregate function that clusters geometries by separation distance.
  • ST_ClusterWithinWin - Window function that returns a cluster id for each input geometry, clustering using separation distance.
  • ST_Collect - Creates a GeometryCollection or Multi* geometry from a set of geometries.
  • ST_CoordDim - ST_Geometry 값의 좌표 차원을 반환합니다.
  • ST_CurveToLine - Converts a geometry containing curves to a linear geometry.
  • ST_Distance - 두 도형 사이의 3차원 최장(longest) 라인을 반환합니다.
  • ST_Dump - Returns a set of geometry_dump rows for the components of a geometry.
  • ST_DumpPoints - 도형의 내용을 요약한 텍스트를 반환합니다.
  • ST_EndPoint - ST_LineString 또는 ST_CircularString 값에 있는 포인트의 개수를 반환합니다.
  • ST_EstimatedExtent - Returns the estimated extent of a spatial table.
  • ST_FlipCoordinates - Returns a version of a geometry with X and Y axis flipped.
  • ST_Force2D - 도형을 "2차원 모드"로 강제합니다.
  • ST_ForceCurve - 적용이 가능한 경우, 도형을 해당 도형의 만곡 유형으로 상위 형변환(upcast)합니다.
  • ST_ForceSFS - 도형이 SFS 1.1 도형 유형만을 쓰도록 강제합니다.
  • ST_Force3D - 도형을 XYZ 모드로 강제합니다. ST_Force3DZ라고도 합니다.
  • ST_Force3DM - 도형을 XYM 모드로 강제합니다.
  • ST_Force3DZ - 도형을 XYZ 모드로 강제합니다.
  • ST_Force4D - 도형을 XYZM 모드로 강제합니다.
  • ST_ForceCollection - 도형을 도형 집합으로 변환합니다.
  • ST_GeoHash - 도형의 GeoHash 표현식을 반환합니다.
  • ST_GeogFromWKB - WKB 도형 표현식 또는 EWKB(확장 WKB)로부터 지리형 인스턴스를 생성합니다.
  • ST_GeomFromEWKB - EWKB(Extended Well-Known Binary)로부터 지정된 ST_Geometry 값을 반환합니다.
  • ST_GeomFromEWKT - EWKT(Extended Well-Known Text)로부터 지정된 ST_Geometry 값을 반환합니다.
  • ST_GeomFromText - WKT 표현식으로부터 지정된 ST_Geometry 값을 반환합니다.
  • ST_GeomFromWKB - WKB(Well-Known Binary) 도형 표현식과 선택적인 SRID로부터 도형 인스턴스를 생성합니다.
  • ST_GeometryN - ST_Geometry 값의 도형 유형을 반환합니다.
  • = - Returns TRUE if the coordinates and coordinate order geometry/geography A are the same as the coordinates and coordinate order of geometry/geography B.
  • &<| - A의 경계 상자가 B의 경계 상자와 겹치거나 그 아래에 있을 경우 TRUE 를 반환합니다.
  • ST_HasArc - Tests if a geometry contains a circular arc
  • ST_Intersects - Tests if two geometries intersect (they have at least one point in common)
  • ST_IsClosed - LINESTRING 의 시작점과 종단점이 일치하는 경우 TRUE 를 반환합니다. 다면체 표면이 닫혀 (부피를 가지고) 있는 경우 TRUE 를 반환합니다.
  • ST_IsCollection - 해당 도형이 텅 빈 도형 집합, 폴리곤, 포인트 등인 경우 TRUE 를 반환합니다.
  • ST_IsEmpty - Tests if a geometry is empty.
  • ST_LineToCurve - Converts a linear geometry to a curved geometry.
  • ST_MemSize - ST_Geometry 값의 도형 유형을 반환합니다.
  • ST_NPoints - 도형이 가지고 있는 포인트(꼭짓점)의 개수를 반환합니다.
  • ST_NRings - 폴리곤 도형의 내곽 고리의 개수를 반환합니다.
  • ST_PointFromWKB - 주어진 SRID와 함께 WKB로부터 도형을 만듭니다.
  • ST_PointN - ST_LineString 또는 ST_CircularString 값에 있는 포인트의 개수를 반환합니다.
  • ST_Points - 도형의 모든 좌표들을 담고 있는 멀티포인트를 반환합니다.
  • ST_Rotate - Rotates a geometry about an origin point.
  • ST_RotateZ - Rotates a geometry about the Z axis.
  • ST_SRID - Returns the spatial reference identifier for a geometry.
  • ST_Scale - Scales a geometry by given factors.
  • ST_SetSRID - Set the SRID on a geometry.
  • ST_StartPoint - Returns the first point of a LineString.
  • ST_Summary - 도형의 내용을 요약한 텍스트를 반환합니다.
  • ST_SwapOrdinates - 입력 도형을 좌표값을 뒤바꾼 상태로 반환합니다.
  • ST_TransScale - Translates and scales a geometry by given offsets and factors.
  • ST_Transform - Return a new geometry with coordinates transformed to a different spatial reference system.
  • ST_Translate - Translates a geometry by given offsets.
  • ST_XMax - Returns the X maxima of a 2D or 3D bounding box or a geometry.
  • ST_XMin - Returns the X minima of a 2D or 3D bounding box or a geometry.
  • ST_YMax - Returns the Y maxima of a 2D or 3D bounding box or a geometry.
  • ST_YMin - Returns the Y minima of a 2D or 3D bounding box or a geometry.
  • ST_ZMax - Returns the Z maxima of a 2D or 3D bounding box or a geometry.
  • ST_ZMin - Returns the Z minima of a 2D or 3D bounding box or a geometry.
  • ST_Zmflag - ST_Geometry 값의 좌표 차원을 반환합니다.
  • UpdateGeometrySRID - Updates the SRID of all features in a geometry column, and the table metadata.
  • ~(box2df,box2df) - Returns TRUE if a 2D float precision bounding box (BOX2DF) contains another 2D float precision bounding box (BOX2DF).
  • ~(box2df,geometry) - Returns TRUE if a 2D float precision bounding box (BOX2DF) contains a geometry's 2D bonding box.
  • ~(geometry,box2df) - Returns TRUE if a geometry's 2D bonding box contains a 2D float precision bounding box (GIDX).
  • && - A의 2D 경계 상자와 B의 2D 경계 상자가 교차하는 경우 TRUE 를 반환합니다.
  • &&& - A의 n차원 경계 상자와 B의 n차원 경계 상자가 교차하는 경우 TRUE 를 반환합니다.
  • @(box2df,box2df) - Returns TRUE if a 2D float precision bounding box (BOX2DF) is contained into another 2D float precision bounding box.
  • @(box2df,geometry) - Returns TRUE if a 2D float precision bounding box (BOX2DF) is contained into a geometry's 2D bounding box.
  • @(geometry,box2df) - Returns TRUE if a geometry's 2D bounding box is contained into a 2D float precision bounding box (BOX2DF).
  • &&(box2df,box2df) - Returns TRUE if two 2D float precision bounding boxes (BOX2DF) intersect each other.
  • &&(box2df,geometry) - Returns TRUE if a 2D float precision bounding box (BOX2DF) intersects a geometry's (cached) 2D bounding box.
  • &&(geometry,box2df) - Returns TRUE if a geometry's (cached) 2D bounding box intersects a 2D float precision bounding box (BOX2DF).
  • &&&(geometry,gidx) - Returns TRUE if a geometry's (cached) n-D bounding box intersects a n-D float precision bounding box (GIDX).
  • &&&(gidx,geometry) - Returns TRUE if a n-D float precision bounding box (GIDX) intersects a geometry's (cached) n-D bounding box.
  • &&&(gidx,gidx) - Returns TRUE if two n-D float precision bounding boxes (GIDX) intersect each other.

12.10. PostGIS Polyhedral Surface Support Functions

The functions given below are PostGIS functions that can use POLYHEDRALSURFACE, POLYHEDRALSURFACEM geometries

  • AddGeometryColumn - 공간 테이블에서 지오메트리 컬럼을 제거합니다.
  • Box2D - Returns a BOX2D representing the 2D extent of a geometry.
  • Box3D - Returns a BOX3D representing the 3D extent of a geometry.
  • DropGeometryColumn - 공간 테이블에서 지오메트리 컬럼을 제거합니다.
  • GeometryType - ST_Geometry 값의 도형 유형을 반환합니다.
  • PostGIS_AddBBox - Add bounding box to the geometry.
  • PostGIS_DropBBox - Drop the bounding box cache from the geometry.
  • PostGIS_HasBBox - Returns TRUE if the bbox of this geometry is cached, FALSE otherwise.
  • ST_3DExtent - Aggregate function that returns the 3D bounding box of geometries.
  • ST_Affine - Apply a 3D affine transformation to a geometry.
  • ST_AsBinary - Return the OGC/ISO Well-Known Binary (WKB) representation of the geometry/geography without SRID meta data.
  • ST_AsEWKB - Return the Extended Well-Known Binary (EWKB) representation of the geometry with SRID meta data.
  • ST_AsEWKT - 도형의 WKT(Well-Known Text) 표현식을 SRID 메타데이터와 함께 반환합니다.
  • ST_AsHEXEWKB - 도형을 소 엔디안(NDR) 또는 대 엔디안(XDR) 인코딩을 통해 HEXEWKB (텍스트) 형식으로 반환합니다.
  • ST_AsSVG - Returns SVG path data for a geometry.
  • ST_AsText - 도형/지리형의 WKT(Well-Known Text) 표현식을 SRID 메타데이터 없이 반환합니다.
  • ST_ClusterDBSCAN - Window function that returns a cluster id for each input geometry using the DBSCAN algorithm.
  • ST_ClusterWithin - Aggregate function that clusters geometries by separation distance.
  • ST_ClusterWithinWin - Window function that returns a cluster id for each input geometry, clustering using separation distance.
  • ST_Collect - Creates a GeometryCollection or Multi* geometry from a set of geometries.
  • ST_CoordDim - ST_Geometry 값의 좌표 차원을 반환합니다.
  • ST_CurveToLine - Converts a geometry containing curves to a linear geometry.
  • ST_Distance - 두 도형 사이의 3차원 최장(longest) 라인을 반환합니다.
  • ST_Dump - Returns a set of geometry_dump rows for the components of a geometry.
  • ST_DumpPoints - 도형의 내용을 요약한 텍스트를 반환합니다.
  • ST_EndPoint - ST_LineString 또는 ST_CircularString 값에 있는 포인트의 개수를 반환합니다.
  • ST_EstimatedExtent - Returns the estimated extent of a spatial table.
  • ST_FlipCoordinates - Returns a version of a geometry with X and Y axis flipped.
  • ST_Force2D - 도형을 "2차원 모드"로 강제합니다.
  • ST_ForceCurve - 적용이 가능한 경우, 도형을 해당 도형의 만곡 유형으로 상위 형변환(upcast)합니다.
  • ST_ForceSFS - 도형이 SFS 1.1 도형 유형만을 쓰도록 강제합니다.
  • ST_Force3D - 도형을 XYZ 모드로 강제합니다. ST_Force3DZ라고도 합니다.
  • ST_Force3DM - 도형을 XYM 모드로 강제합니다.
  • ST_Force3DZ - 도형을 XYZ 모드로 강제합니다.
  • ST_Force4D - 도형을 XYZM 모드로 강제합니다.
  • ST_ForceCollection - 도형을 도형 집합으로 변환합니다.
  • ST_GeoHash - 도형의 GeoHash 표현식을 반환합니다.
  • ST_GeogFromWKB - WKB 도형 표현식 또는 EWKB(확장 WKB)로부터 지리형 인스턴스를 생성합니다.
  • ST_GeomFromEWKB - EWKB(Extended Well-Known Binary)로부터 지정된 ST_Geometry 값을 반환합니다.
  • ST_GeomFromEWKT - EWKT(Extended Well-Known Text)로부터 지정된 ST_Geometry 값을 반환합니다.
  • ST_GeomFromText - WKT 표현식으로부터 지정된 ST_Geometry 값을 반환합니다.
  • ST_GeomFromWKB - WKB(Well-Known Binary) 도형 표현식과 선택적인 SRID로부터 도형 인스턴스를 생성합니다.
  • ST_GeometryN - ST_Geometry 값의 도형 유형을 반환합니다.
  • = - Returns TRUE if the coordinates and coordinate order geometry/geography A are the same as the coordinates and coordinate order of geometry/geography B.
  • &<| - A의 경계 상자가 B의 경계 상자와 겹치거나 그 아래에 있을 경우 TRUE 를 반환합니다.
  • ST_HasArc - Tests if a geometry contains a circular arc
  • ST_Intersects - Tests if two geometries intersect (they have at least one point in common)
  • ST_IsClosed - LINESTRING 의 시작점과 종단점이 일치하는 경우 TRUE 를 반환합니다. 다면체 표면이 닫혀 (부피를 가지고) 있는 경우 TRUE 를 반환합니다.
  • ST_IsCollection - 해당 도형이 텅 빈 도형 집합, 폴리곤, 포인트 등인 경우 TRUE 를 반환합니다.
  • ST_IsEmpty - Tests if a geometry is empty.
  • ST_LineToCurve - Converts a linear geometry to a curved geometry.
  • ST_MemSize - ST_Geometry 값의 도형 유형을 반환합니다.
  • ST_NPoints - 도형이 가지고 있는 포인트(꼭짓점)의 개수를 반환합니다.
  • ST_NRings - 폴리곤 도형의 내곽 고리의 개수를 반환합니다.
  • ST_PointFromWKB - 주어진 SRID와 함께 WKB로부터 도형을 만듭니다.
  • ST_PointN - ST_LineString 또는 ST_CircularString 값에 있는 포인트의 개수를 반환합니다.
  • ST_Points - 도형의 모든 좌표들을 담고 있는 멀티포인트를 반환합니다.
  • ST_Rotate - Rotates a geometry about an origin point.
  • ST_RotateZ - Rotates a geometry about the Z axis.
  • ST_SRID - Returns the spatial reference identifier for a geometry.
  • ST_Scale - Scales a geometry by given factors.
  • ST_SetSRID - Set the SRID on a geometry.
  • ST_StartPoint - Returns the first point of a LineString.
  • ST_Summary - 도형의 내용을 요약한 텍스트를 반환합니다.
  • ST_SwapOrdinates - 입력 도형을 좌표값을 뒤바꾼 상태로 반환합니다.
  • ST_TransScale - Translates and scales a geometry by given offsets and factors.
  • ST_Transform - Return a new geometry with coordinates transformed to a different spatial reference system.
  • ST_Translate - Translates a geometry by given offsets.
  • ST_XMax - Returns the X maxima of a 2D or 3D bounding box or a geometry.
  • ST_XMin - Returns the X minima of a 2D or 3D bounding box or a geometry.
  • ST_YMax - Returns the Y maxima of a 2D or 3D bounding box or a geometry.
  • ST_YMin - Returns the Y minima of a 2D or 3D bounding box or a geometry.
  • ST_ZMax - Returns the Z maxima of a 2D or 3D bounding box or a geometry.
  • ST_ZMin - Returns the Z minima of a 2D or 3D bounding box or a geometry.
  • ST_Zmflag - ST_Geometry 값의 좌표 차원을 반환합니다.
  • UpdateGeometrySRID - Updates the SRID of all features in a geometry column, and the table metadata.
  • ~(box2df,box2df) - Returns TRUE if a 2D float precision bounding box (BOX2DF) contains another 2D float precision bounding box (BOX2DF).
  • ~(box2df,geometry) - Returns TRUE if a 2D float precision bounding box (BOX2DF) contains a geometry's 2D bonding box.
  • ~(geometry,box2df) - Returns TRUE if a geometry's 2D bonding box contains a 2D float precision bounding box (GIDX).
  • && - A의 2D 경계 상자와 B의 2D 경계 상자가 교차하는 경우 TRUE 를 반환합니다.
  • &&& - A의 n차원 경계 상자와 B의 n차원 경계 상자가 교차하는 경우 TRUE 를 반환합니다.
  • @(box2df,box2df) - Returns TRUE if a 2D float precision bounding box (BOX2DF) is contained into another 2D float precision bounding box.
  • @(box2df,geometry) - Returns TRUE if a 2D float precision bounding box (BOX2DF) is contained into a geometry's 2D bounding box.
  • @(geometry,box2df) - Returns TRUE if a geometry's 2D bounding box is contained into a 2D float precision bounding box (BOX2DF).
  • &&(box2df,box2df) - Returns TRUE if two 2D float precision bounding boxes (BOX2DF) intersect each other.
  • &&(box2df,geometry) - Returns TRUE if a 2D float precision bounding box (BOX2DF) intersects a geometry's (cached) 2D bounding box.
  • &&(geometry,box2df) - Returns TRUE if a geometry's (cached) 2D bounding box intersects a 2D float precision bounding box (BOX2DF).
  • &&&(geometry,gidx) - Returns TRUE if a geometry's (cached) n-D bounding box intersects a n-D float precision bounding box (GIDX).
  • &&&(gidx,geometry) - Returns TRUE if a n-D float precision bounding box (GIDX) intersects a geometry's (cached) n-D bounding box.
  • &&&(gidx,gidx) - Returns TRUE if two n-D float precision bounding boxes (GIDX) intersect each other.

12.11. PostGIS Function Support Matrix

Below is an alphabetical listing of spatial specific functions in PostGIS and the kinds of spatial types they work with or OGC/SQL compliance they try to conform to.

  • A means the function works with the type or subtype natively.
  • A means it works but with a transform cast built-in using cast to geometry, transform to a "best srid" spatial ref and then cast back. Results may not be as expected for large areas or areas at poles and may accumulate floating point junk.
  • A means the function works with the type because of a auto-cast to another such as to box3d rather than direct type support.
  • A means the function only available if PostGIS compiled with SFCGAL support.
  • A means the function support is provided by SFCGAL if PostGIS compiled with SFCGAL support, otherwise GEOS/built-in support.
  • geom - Basic 2D geometry support (x,y).
  • geog - Basic 2D geography support (x,y).
  • 2.5D - basic 2D geometries in 3 D/4D space (has Z or M coord).
  • PS - Polyhedral surfaces
  • T - Triangles and Triangulated Irregular Network surfaces (TIN)

Functiongeomgeog2.5DCurvesSQL MMPST
Box2D     
Box3D    
GeometryType    
PostGIS_AddBBox       
PostGIS_DropBBox       
PostGIS_HasBBox       
ST_3DArea    
ST_3DClosestPoint       
ST_3DConvexHull     
ST_3DDFullyWithin       
ST_3DDWithin      
ST_3DDifference    
ST_3DDistance      
ST_3DExtent    
ST_3DIntersection    
ST_3DIntersects    
ST_3DLength       
ST_3DLineInterpolatePoint       
ST_3DLongestLine       
ST_3DMakeBox       
ST_3DMaxDistance       
ST_3DPerimeter       
ST_3DShortestLine       
ST_3DUnion    
ST_AddMeasure       
ST_AddPoint       
ST_Affine    
ST_AlphaShape       
ST_Angle       
ST_ApproximateMedialAxis     
ST_Area     
ST_AsBinary
ST_AsEWKB    
ST_AsEWKT  
ST_AsEncodedPolyline       
ST_AsFlatGeobuf       
ST_AsGML  
ST_AsGeoJSON     
ST_AsGeobuf       
ST_AsHEXEWKB      
ST_AsKML     
ST_AsLatLonText       
ST_AsMARC21       
ST_AsMVT       
ST_AsMVTGeom       
ST_AsSVG      
ST_AsTWKB       
ST_AsText     
ST_AsX3D     
ST_Azimuth      
ST_BdMPolyFromText       
ST_BdPolyFromText       
ST_Boundary       
ST_BoundingDiagonal       
ST_Box2dFromGeoHash       
ST_Buffer      
ST_BuildArea       
ST_CPAWithin       
ST_Centroid      
ST_ChaikinSmoothing       
ST_ClipByBox2D       
ST_ClosestPoint      
ST_ClosestPointOfApproach       
ST_ClusterDBSCAN       
ST_ClusterIntersecting       
ST_ClusterIntersectingWin       
ST_ClusterKMeans       
ST_ClusterWithin       
ST_ClusterWithinWin       
ST_Collect      
ST_CollectionExtract       
ST_CollectionHomogenize       
ST_ConcaveHull       
ST_ConstrainedDelaunayTriangles       
ST_Contains       
ST_ContainsProperly       
ST_ConvexHull       
ST_CoordDim  
ST_CoverageInvalidEdges       
ST_CoverageSimplify       
ST_CoverageUnion       
ST_CoveredBy      
ST_Covers      
ST_Crosses       
ST_CurveToLine     
ST_DFullyWithin       
ST_DWithin      
ST_DelaunayTriangles      
ST_Difference       
ST_Dimension    
ST_Disjoint       
ST_Distance     
ST_DistanceCPA       
ST_DistanceSphere       
ST_DistanceSpheroid       
ST_Dump    
ST_DumpPoints    
ST_DumpRings       
ST_DumpSegments      
ST_EndPoint     
ST_Envelope       
ST_Equals       
ST_EstimatedExtent       
ST_Expand     
ST_Extent     
ST_ExteriorRing       
ST_Extrude     
ST_FilterByM       
ST_FlipCoordinates    
ST_Force2D      
ST_ForceCurve      
ST_ForceLHR     
ST_ForcePolygonCCW       
ST_ForcePolygonCW       
ST_ForceRHR       
ST_ForceSFS    
ST_Force3D      
ST_Force3DM       
ST_Force3DZ      
ST_Force4D      
ST_ForceCollection      
ST_FrechetDistance       
ST_FromFlatGeobuf        
ST_FromFlatGeobufToTable       
ST_GMLToSQL       
ST_GeneratePoints       
ST_GeoHash       
ST_GeogFromText        
ST_GeogFromWKB        
ST_GeographyFromText        
ST_GeomCollFromText       
ST_GeomFromEWKB    
ST_GeomFromEWKT    
ST_GeomFromGML     
ST_GeomFromGeoHash       
ST_GeomFromGeoJSON       
ST_GeomFromKML       
ST_GeomFromMARC21       
ST_GeomFromTWKB       
ST_GeomFromText      
ST_GeomFromWKB      
ST_GeometricMedian       
ST_GeometryFromText       
ST_GeometryN  
ST_GeometryType      
|>>       
<<|       
~       
@       
=      
<<       
|&>       
&<|       
&<       
&>       
>>       
~=       
ST_HasArc      
ST_HausdorffDistance       
ST_Hexagon       
ST_HexagonGrid       
ST_InteriorRingN       
ST_InterpolatePoint       
ST_Intersection     
ST_Intersects    
ST_InverseTransformPipeline       
ST_IsClosed    
ST_IsCollection      
ST_IsEmpty      
ST_IsPlanar     
ST_IsPolygonCCW       
ST_IsPolygonCW       
ST_IsRing       
ST_IsSimple       
ST_IsSolid     
ST_IsValid       
ST_IsValidDetail       
ST_IsValidReason       
ST_IsValidTrajectory       
ST_LargestEmptyCircle       
ST_Length      
ST_Length2D       
ST_LengthSpheroid       
ST_Letters       
ST_LineCrossingDirection       
ST_LineExtend       
ST_LineFromEncodedPolyline       
ST_LineFromMultiPoint       
ST_LineFromText       
ST_LineFromWKB       
ST_LineInterpolatePoint     
ST_LineInterpolatePoints     
ST_LineLocatePoint      
ST_LineMerge       
ST_LineSubstring     
ST_LineToCurve      
ST_LinestringFromWKB       
ST_LocateAlong       
ST_LocateBetween       
ST_LocateBetweenElevations       
ST_LongestLine       
ST_M       
ST_MLineFromText       
ST_MPointFromText       
ST_MPolyFromText       
ST_MakeBox2D       
ST_MakeEnvelope       
ST_MakeLine       
ST_MakePoint       
ST_MakePointM       
ST_MakePolygon       
ST_MakeSolid     
ST_MakeValid       
ST_MaxDistance       
ST_MaximumInscribedCircle       
ST_MemSize    
ST_MemUnion       
ST_MinimumBoundingCircle       
ST_MinimumBoundingRadius       
ST_MinimumClearance       
ST_MinimumClearanceLine       
ST_MinkowskiSum       
ST_Multi       
ST_NDims       
ST_NPoints      
ST_NRings      
ST_Node       
ST_Normalize       
ST_NumGeometries    
ST_NumInteriorRing       
ST_NumInteriorRings       
ST_NumPatches      
ST_NumPoints       
ST_OffsetCurve       
ST_OptimalAlphaShape       
ST_OrderingEquals       
ST_Orientation       
ST_OrientedEnvelope       
ST_Overlaps       
ST_PatchN      
ST_Perimeter      
ST_Perimeter2D       
ST_Point       
ST_PointFromGeoHash        
ST_PointFromText       
ST_PointFromWKB     
ST_PointInsideCircle       
ST_PointM       
ST_PointN     
ST_PointOnSurface       
ST_PointZ       
ST_PointZM       
ST_Points      
ST_Polygon       
ST_PolygonFromText       
ST_Polygonize       
ST_Project      
ST_QuantizeCoordinates       
ST_ReducePrecision       
ST_Relate       
ST_RelateMatch        
ST_RemovePoint       
ST_RemoveRepeatedPoints       
ST_Reverse       
ST_Rotate    
ST_RotateX     
ST_RotateY     
ST_RotateZ    
ST_SRID      
ST_Scale    
ST_Scroll       
ST_Segmentize      
ST_SetEffectiveArea       
ST_SetPoint       
ST_SetSRID       
ST_SharedPaths       
ST_ShiftLongitude     
ST_ShortestLine      
ST_Simplify       
ST_SimplifyPolygonHull       
ST_SimplifyPreserveTopology       
ST_SimplifyVW       
ST_Snap       
ST_SnapToGrid       
ST_Split       
ST_Square       
ST_SquareGrid       
ST_StartPoint     
ST_StraightSkeleton     
ST_Subdivide       
ST_Summary    
ST_SwapOrdinates    
ST_SymDifference       
ST_Tesselate     
ST_TileEnvelope       
ST_Touches       
ST_TransScale      
ST_Transform     
ST_TransformPipeline       
ST_Translate      
ST_TriangulatePolygon       
ST_UnaryUnion       
ST_Union       
ST_Volume    
ST_VoronoiLines       
ST_VoronoiPolygons       
ST_WKBToSQL       
ST_WKTToSQL       
ST_Within       
ST_WrapX       
ST_X       
ST_XMax      
ST_XMin      
ST_Y       
ST_YMax      
ST_YMin      
ST_Z       
ST_ZMax      
ST_ZMin      
ST_Zmflag      
~(box2df,box2df)       
~(box2df,geometry)       
~(geometry,box2df)       
<#>       
<<#>>       
<<->>       
|=|       
<->      
&&      
&&&    
@(box2df,box2df)       
@(box2df,geometry)       
@(geometry,box2df)       
&&(box2df,box2df)       
&&(box2df,geometry)       
&&(geometry,box2df)       
&&&(geometry,gidx)    
&&&(gidx,geometry)    
&&&(gidx,gidx)     
postgis.backend        
postgis.enable_outdb_rasters        
postgis.gdal_datapath        
postgis.gdal_enabled_drivers        
postgis.gdal_vsi_options        
postgis_sfcgal_full_version      
postgis_sfcgal_version      
postgis_srs        
postgis_srs_all        
postgis_srs_codes        
postgis_srs_search       

12.12. New, Enhanced or changed PostGIS Functions

12.12.1. PostGIS Functions new or enhanced in 3.4

The functions given below are PostGIS functions that were added or enhanced.

Functions new in PostGIS 3.4

  • PostGIS_GEOS_Compiled_Version - Availability: 3.4.0 Returns the version number of the GEOS library against which PostGIS was built.
  • ST_ClusterIntersectingWin - Availability: 3.4.0 Window function that returns a cluster id for each input geometry, clustering input geometries into connected sets.
  • ST_ClusterWithinWin - Availability: 3.4.0 Window function that returns a cluster id for each input geometry, clustering using separation distance.
  • ST_CoverageInvalidEdges - Availability: 3.4.0 Window function that finds locations where polygons fail to form a valid coverage.
  • ST_CoverageSimplify - Availability: 3.4.0 Window function that simplifies the edges of a polygonal coverage.
  • ST_CoverageUnion - Availability: 3.4.0 - requires GEOS >= 3.8.0 Computes the union of a set of polygons forming a coverage by removing shared edges.
  • ST_InverseTransformPipeline - Availability: 3.4.0 Return a new geometry with coordinates transformed to a different spatial reference system using the inverse of a defined coordinate transformation pipeline.
  • ST_LargestEmptyCircle - Availability: 3.4.0. Computes the largest circle not overlapping a geometry.
  • ST_LineExtend - Availability: 3.4.0 Returns a line with the last and first segments extended the specified distance(s).
  • ST_TransformPipeline - Availability: 3.4.0 Return a new geometry with coordinates transformed to a different spatial reference system using a defined coordinate transformation pipeline.
  • postgis_srs - Availability: 3.4.0 Return a metadata record for the requested authority and srid.
  • postgis_srs_all - Availability: 3.4.0 Return metadata records for every spatial reference system in the underlying Proj database.
  • postgis_srs_codes - Availability: 3.4.0 Return the list of SRS codes associated with the given authority.
  • postgis_srs_search - Availability: 3.4.0 Return metadata records for projected coordinate systems that have areas of useage that fully contain the bounds parameter.

Functions enhanced in PostGIS 3.4

  • PostGIS_Full_Version - Enhanced: 3.4.0 now includes extra PROJ configurations NETWORK_ENABLED, URL_ENDPOINT and DATABASE_PATH of proj.db location Reports full PostGIS version and build configuration infos.
  • PostGIS_PROJ_Version - Enhanced: 3.4.0 now includes NETWORK_ENABLED, URL_ENDPOINT and DATABASE_PATH of proj.db location Returns the version number of the PROJ4 library.
  • ST_AsSVG - Enhanced: 3.4.0 to support all curve types Returns SVG path data for a geometry.
  • ST_ClosestPoint - Enhanced: 3.4.0 - Support for geography. Returns the 2D point on g1 that is closest to g2. This is the first point of the shortest line from one geometry to the other.
  • ST_LineSubstring - Enhanced: 3.4.0 - Support for geography was introduced. Returns the part of a line between two fractional locations.
  • ST_Project - Enhanced: 3.4.0 Allow geometry arguments and two-point form omitting azimuth. Returns a point projected from a start point by a distance and bearing (azimuth).
  • ST_ShortestLine - Enhanced: 3.4.0 - support for geography. 두 도형 사이의 2차원 최단 라인을 반환합니다.

Functions changed in PostGIS 3.4

  • PostGIS_Extensions_Upgrade - Changed: 3.4.0 to add target_version argument. Packages and upgrades PostGIS extensions (e.g. postgis_raster, postgis_topology, postgis_sfcgal) to given or latest version.

12.12.2. PostGIS Functions new or enhanced in 3.3

The functions given below are PostGIS functions that were added or enhanced.

Functions new in PostGIS 3.3

  • ST_3DConvexHull - 2.1.0 버전부터 사용할 수 있습니다. 면 도형의 근사 중심축을 계산합니다.
  • ST_3DUnion - Availability: 3.3.0 aggregate variant was added Perform 3D union.
  • ST_AlphaShape - Availability: 3.3.0 - requires SFCGAL >= 1.4.1. Computes an Alpha-shape enclosing a geometry
  • ST_AsMARC21 - Availability: 3.3.0 Returns geometry as a MARC21/XML record with a geographic datafield (034).
  • ST_GeomFromMARC21 - Availability: 3.3.0, requires libxml2 2.6+ Takes MARC21/XML geographic data as input and returns a PostGIS geometry object.
  • ST_Letters - 2.1.0 버전부터 사용할 수 있습니다. Returns the input letters rendered as geometry with a default start position at the origin and default text height of 100.
  • ST_OptimalAlphaShape - Availability: 3.3.0 - requires SFCGAL >= 1.4.1. Computes an Alpha-shape enclosing a geometry using an "optimal" alpha value.
  • ST_SimplifyPolygonHull - Availability: 3.3.0. Computes a simplifed topology-preserving outer or inner hull of a polygonal geometry.
  • ST_TriangulatePolygon - Availability: 3.3.0. Computes the constrained Delaunay triangulation of polygons
  • postgis_sfcgal_full_version - 2.1.0 버전부터 사용할 수 있습니다. Returns the full version of SFCGAL in use including CGAL and Boost versions

Functions enhanced in PostGIS 3.3

  • ST_ConcaveHull - Enhanced: 3.3.0, GEOS native implementation enabled for GEOS 3.11+ Computes a possibly concave geometry that contains all input geometry vertices
  • ST_LineMerge - Enhanced: 3.3.0 accept a directed parameter. Return the lines formed by sewing together a MultiLineString.

Functions changed in PostGIS 3.3

  • PostGIS_Extensions_Upgrade - Changed: 3.3.0 support for upgrades from any PostGIS version. Does not work on all systems. Packages and upgrades PostGIS extensions (e.g. postgis_raster, postgis_topology, postgis_sfcgal) to given or latest version.

12.12.3. PostGIS Functions new or enhanced in 3.2

The functions given below are PostGIS functions that were added or enhanced.

Functions new in PostGIS 3.2

  • ST_AsFlatGeobuf - Availability: 3.2.0 Return a FlatGeobuf representation of a set of rows.
  • ST_DumpSegments - 2.2.0 버전부터 사용할 수 있습니다. 도형의 내용을 요약한 텍스트를 반환합니다.
  • ST_FromFlatGeobuf - Availability: 3.2.0 Reads FlatGeobuf data.
  • ST_FromFlatGeobufToTable - Availability: 3.2.0 Creates a table based on the structure of FlatGeobuf data.
  • ST_Scroll - Availability: 3.2.0 Change start point of a closed LineString.
  • postgis.gdal_vsi_options - 2.2.0 버전부터 사용할 수 있습니다. DB 외부 래스터 밴드에 접근할 수 있게 해주는 불 설정 옵션입니다.

Functions enhanced in PostGIS 3.2

  • ST_ClusterKMeans - Enhanced: 3.2.0 Support for max_radius Window function that returns a cluster id for each input geometry using the K-means algorithm.
  • ST_MakeValid - Enhanced: 3.2.0, added algorithm options, 'linework' and 'structure' which requires GEOS >= 3.10.0. Attempts to make an invalid geometry valid without losing vertices.
  • ST_Point - Enhanced: 3.2.0 srid as an extra optional argument was added. Older installs require combining with ST_SetSRID to mark the srid on the geometry. Creates a Point with X, Y and SRID values.
  • ST_PointM - Enhanced: 3.2.0 srid as an extra optional argument was added. Older installs require combining with ST_SetSRID to mark the srid on the geometry. Creates a Point with X, Y, M and SRID values.
  • ST_PointZ - Enhanced: 3.2.0 srid as an extra optional argument was added. Older installs require combining with ST_SetSRID to mark the srid on the geometry. Creates a Point with X, Y, Z and SRID values.
  • ST_PointZM - Enhanced: 3.2.0 srid as an extra optional argument was added. Older installs require combining with ST_SetSRID to mark the srid on the geometry. Creates a Point with X, Y, Z, M and SRID values.
  • ST_RemovePoint - Enhanced: 3.2.0 Remove a point from a linestring.
  • ST_RemoveRepeatedPoints - Enhanced: 3.2.0 Returns a version of a geometry with duplicate points removed.
  • ST_StartPoint - Enhanced: 3.2.0 returns a point for all geometries. Prior behavior returns NULLs if input was not a LineString. Returns the first point of a LineString.

Functions changed in PostGIS 3.2

  • ST_Boundary - Changed: 3.2.0 support for TIN, does not use geos, does not linearize curves 해당 도형의 결합된 범위의 닫힘 여부를 반환합니다.

12.12.4. PostGIS Functions new or enhanced in 3.1

The functions given below are PostGIS functions that were added or enhanced.

Functions new in PostGIS 3.1

  • ST_Hexagon - 2.1.0 버전부터 사용할 수 있습니다. Returns a single hexagon, using the provided edge size and cell coordinate within the hexagon grid space.
  • ST_HexagonGrid - 2.1.0 버전부터 사용할 수 있습니다. Returns a set of hexagons and cell indices that completely cover the bounds of the geometry argument.
  • ST_MaximumInscribedCircle - Availability: 3.1.0. 도형의 기하학적 중심을 반환합니다.
  • ST_ReducePrecision - Availability: 3.1.0. Returns a valid geometry with points rounded to a grid tolerance.
  • ST_Square - 2.1.0 버전부터 사용할 수 있습니다. Returns a single square, using the provided edge size and cell coordinate within the square grid space.
  • ST_SquareGrid - 2.1.0 버전부터 사용할 수 있습니다. Returns a set of grid squares and cell indices that completely cover the bounds of the geometry argument.

Functions enhanced in PostGIS 3.1

  • ST_AsEWKT - Enhanced: 3.1.0 support for optional precision parameter. 도형의 WKT(Well-Known Text) 표현식을 SRID 메타데이터와 함께 반환합니다.
  • ST_ClusterKMeans - Enhanced: 3.1.0 Support for 3D geometries and weights Window function that returns a cluster id for each input geometry using the K-means algorithm.
  • ST_Difference - Enhanced: 3.1.0 accept a gridSize parameter. Computes a geometry representing the part of geometry A that does not intersect geometry B.
  • ST_Intersection - Enhanced: 3.1.0 accept a gridSize parameter Computes a geometry representing the shared portion of geometries A and B.
  • ST_MakeValid - Enhanced: 3.1.0, added removal of Coordinates with NaN values. Attempts to make an invalid geometry valid without losing vertices.
  • ST_Subdivide - Enhanced: 3.1.0 accept a gridSize parameter. Computes a rectilinear subdivision of a geometry.
  • ST_SymDifference - Enhanced: 3.1.0 accept a gridSize parameter. Computes a geometry representing the portions of geometries A and B that do not intersect.
  • ST_TileEnvelope - 개선 사항: 2.0.0 버전에서 선택적인 기본 SRID 파라미터가 추가됐습니다. Creates a rectangular Polygon in Web Mercator (SRID:3857) using the XYZ tile system.
  • ST_UnaryUnion - Enhanced: 3.1.0 accept a gridSize parameter. Computes the union of the components of a single geometry.
  • ST_Union - Enhanced: 3.1.0 accept a gridSize parameter. Computes a geometry representing the point-set union of the input geometries.

Functions changed in PostGIS 3.1

  • ST_Force3D - Changed: 3.1.0. Added support for supplying a non-zero Z value. 도형을 XYZ 모드로 강제합니다. ST_Force3DZ라고도 합니다.
  • ST_Force3DM - Changed: 3.1.0. Added support for supplying a non-zero M value. 도형을 XYM 모드로 강제합니다.
  • ST_Force3DZ - Changed: 3.1.0. Added support for supplying a non-zero Z value. 도형을 XYZ 모드로 강제합니다.
  • ST_Force4D - Changed: 3.1.0. Added support for supplying non-zero Z and M values. 도형을 XYZM 모드로 강제합니다.

12.12.5. PostGIS Functions new or enhanced in 3.0

The functions given below are PostGIS functions that were added or enhanced.

Functions new in PostGIS 3.0

  • ST_3DLineInterpolatePoint - 2.0.0 버전부터 사용할 수 있습니다. Returns a point interpolated along a 3D line at a fractional location.
  • ST_ConstrainedDelaunayTriangles - 2.1.0 버전부터 사용할 수 있습니다. Return a constrained Delaunay triangulation around the given input geometry.
  • ST_TileEnvelope - 2.1.0 버전부터 사용할 수 있습니다. Creates a rectangular Polygon in Web Mercator (SRID:3857) using the XYZ tile system.

Functions enhanced in PostGIS 3.0

  • ST_AsMVT - Enhanced: 3.0 - added support for Feature ID. Aggregate function returning a MVT representation of a set of rows.
  • ST_Contains - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Tests if every point of B lies in A, and their interiors have a point in common
  • ST_ContainsProperly - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Tests if every point of B lies in the interior of A
  • ST_CoveredBy - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Tests if every point of A lies in B
  • ST_Covers - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Tests if every point of B lies in A
  • ST_Crosses - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Tests if two geometries have some, but not all, interior points in common
  • ST_CurveToLine - Enhanced: 3.0.0 implemented a minimum number of segments per linearized arc to prevent topological collapse. Converts a geometry containing curves to a linear geometry.
  • ST_Disjoint - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Tests if two geometries have no points in common
  • ST_Equals - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Tests if two geometries include the same set of points
  • ST_GeneratePoints - Enhanced: 3.0.0, added seed parameter Generates random points contained in a Polygon or MultiPolygon.
  • ST_GeomFromGeoJSON - Enhanced: 3.0.0 parsed geometry defaults to SRID=4326 if not specified otherwise. GeoJSON 표현식을 입력받아 PostGIS 도형 객체를 출력합니다.
  • ST_LocateBetween - Enhanced: 3.0.0 - added support for POLYGON, TIN, TRIANGLE. Returns the portions of a geometry that match a measure range.
  • ST_LocateBetweenElevations - Enhanced: 3.0.0 - added support for POLYGON, TIN, TRIANGLE. Returns the portions of a geometry that lie in an elevation (Z) range.
  • ST_Overlaps - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Tests if two geometries have the same dimension and intersect, but each has at least one point not in the other
  • ST_Relate - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Tests if two geometries have a topological relationship matching an Intersection Matrix pattern, or computes their Intersection Matrix
  • ST_Segmentize - Enhanced: 3.0.0 Segmentize geometry now produces equal-length subsegments Returns a modified geometry/geography having no segment longer than a given distance.
  • ST_Touches - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Tests if two geometries have at least one point in common, but their interiors do not intersect
  • ST_Within - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Tests if every point of A lies in B, and their interiors have a point in common

Functions changed in PostGIS 3.0

  • PostGIS_Extensions_Upgrade - Changed: 3.0.0 to repackage loose extensions and support postgis_raster. Packages and upgrades PostGIS extensions (e.g. postgis_raster, postgis_topology, postgis_sfcgal) to given or latest version.
  • ST_3DDistance - Changed: 3.0.0 - SFCGAL version removed 도형 유형에 대해, 두 도형 사이의 (SRS에 기반한) 3차원 데카르트 최단 거리를 투영 단위로 반환합니다.
  • ST_3DIntersects - Changed: 3.0.0 SFCGAL backend removed, GEOS backend supports TINs. Tests if two geometries spatially intersect in 3D - only for points, linestrings, polygons, polyhedral surface (area)
  • ST_Area - Changed: 3.0.0 - does not depend on SFCGAL anymore. 도형의 기하학적 중심을 반환합니다.
  • ST_AsGeoJSON - Changed: 3.0.0 support records as input Return a geometry as a GeoJSON element.
  • ST_AsGeoJSON - Changed: 3.0.0 output SRID if not EPSG:4326. Return a geometry as a GeoJSON element.
  • ST_AsKML - Changed: 3.0.0 - Removed the "versioned" variant signature 도형을 GML 2 또는 GML 3 버전 요소로 반환합니다.
  • ST_Distance - Changed: 3.0.0 - does not depend on SFCGAL anymore. 두 도형 사이의 3차원 최장(longest) 라인을 반환합니다.
  • ST_Intersection - Changed: 3.0.0 does not depend on SFCGAL. Computes a geometry representing the shared portion of geometries A and B.
  • ST_Intersects - Changed: 3.0.0 SFCGAL version removed and native support for 2D TINS added. Tests if two geometries intersect (they have at least one point in common)
  • ST_Union - Changed: 3.0.0 does not depend on SFCGAL. Computes a geometry representing the point-set union of the input geometries.

12.12.6. PostGIS Functions new or enhanced in 2.5

The functions given below are PostGIS functions that were added or enhanced.

Functions new in PostGIS 2.5

  • PostGIS_Extensions_Upgrade - Availability: 2.5.0 Packages and upgrades PostGIS extensions (e.g. postgis_raster, postgis_topology, postgis_sfcgal) to given or latest version.
  • ST_Angle - Availability: 2.5.0 두 도형 사이의 3차원 최장(longest) 라인을 반환합니다.
  • ST_ChaikinSmoothing - Availability: 2.5.0 Returns a smoothed version of a geometry, using the Chaikin algorithm
  • ST_FilterByM - Availability: 2.5.0 Removes vertices based on their M value
  • ST_LineInterpolatePoints - Availability: 2.5.0 Returns points interpolated along a line at a fractional interval.
  • ST_OrientedEnvelope - Availability: 2.5.0. Returns a minimum-area rectangle containing a geometry.
  • ST_QuantizeCoordinates - Availability: 2.5.0 Sets least significant bits of coordinates to zero

Functions enhanced in PostGIS 2.5

  • ST_AsMVT - Enhanced: 2.5.0 - added support parallel query. Aggregate function returning a MVT representation of a set of rows.
  • ST_AsText - Enhanced: 2.5 - optional parameter precision introduced. 도형/지리형의 WKT(Well-Known Text) 표현식을 SRID 메타데이터 없이 반환합니다.
  • ST_Buffer - Enhanced: 2.5.0 - ST_Buffer geometry support was enhanced to allow for side buffering specification side=both|left|right. Computes a geometry covering all points within a given distance from a geometry.
  • ST_GeomFromGeoJSON - Enhanced: 2.5.0 can now accept json and jsonb as inputs. GeoJSON 표현식을 입력받아 PostGIS 도형 객체를 출력합니다.
  • ST_GeometricMedian - Enhanced: 2.5.0 Added support for M as weight of points. 멀티 포인트의 기하학적 중심값(median)을 반환합니다.
  • ST_Intersects - Enhanced: 2.5.0 Supports GEOMETRYCOLLECTION. Tests if two geometries intersect (they have at least one point in common)
  • ST_OffsetCurve - Enhanced: 2.5 - added support for GEOMETRYCOLLECTION and MULTILINESTRING Returns an offset line at a given distance and side from an input line.
  • ST_Scale - Enhanced: 2.5.0 support for scaling relative to a local origin (origin parameter) was introduced. Scales a geometry by given factors.
  • ST_Split - Enhanced: 2.5.0 support for splitting a polygon by a multiline was introduced. Returns a collection of geometries created by splitting a geometry by another geometry.
  • ST_Subdivide - Enhanced: 2.5.0 reuses existing points on polygon split, vertex count is lowered from 8 to 5. Computes a rectilinear subdivision of a geometry.

12.12.7. PostGIS Functions new or enhanced in 2.4

The functions given below are PostGIS functions that were added or enhanced.

Functions new in PostGIS 2.4

  • ST_AsGeobuf - Availability: 2.4.0 Return a Geobuf representation of a set of rows.
  • ST_AsMVT - Availability: 2.4.0 Aggregate function returning a MVT representation of a set of rows.
  • ST_AsMVTGeom - Availability: 2.4.0 Transforms a geometry into the coordinate space of a MVT tile.
  • ST_Centroid - Availability: 2.4.0 support for geography was introduced. 도형의 기하학적 중심을 반환합니다.
  • ST_ForcePolygonCCW - Availability: 2.4.0 Orients all exterior rings counter-clockwise and all interior rings clockwise.
  • ST_ForcePolygonCW - Availability: 2.4.0 Orients all exterior rings clockwise and all interior rings counter-clockwise.
  • ST_FrechetDistance - Availability: 2.4.0 - requires GEOS >= 3.7.0 두 도형 사이의 3차원 최단(shortest) 라인을 반환합니다.
  • ST_IsPolygonCCW - 2.2.0 버전부터 사용할 수 있습니다. Tests if Polygons have exterior rings oriented counter-clockwise and interior rings oriented clockwise.
  • ST_IsPolygonCW - 2.2.0 버전부터 사용할 수 있습니다. Tests if Polygons have exterior rings oriented clockwise and interior rings oriented counter-clockwise.

Functions enhanced in PostGIS 2.4

  • ST_AsTWKB - Enhanced: 2.4.0 memory and speed improvements. 도형을 TWKB(Tiny Well-Known Binary)로 반환합니다.
  • ST_Covers - Enhanced: 2.4.0 Support for polygon in polygon and line in polygon added for geography type Tests if every point of B lies in A
  • ST_CurveToLine - Enhanced: 2.4.0 added support for max-deviation and max-angle tolerance, and for symmetric output. Converts a geometry containing curves to a linear geometry.
  • ST_Project - Enhanced: 2.4.0 Allow negative distance and non-normalized azimuth. Returns a point projected from a start point by a distance and bearing (azimuth).
  • ST_Reverse - Enhanced: 2.4.0 support for curves was introduced. 꼭짓점들의 순서가 반대인 도형을 반환합니다.

Functions changed in PostGIS 2.4

  • = - Changed: 2.4.0, in prior versions this was bounding box equality not a geometric equality. If you need bounding box equality, use instead. Returns TRUE if the coordinates and coordinate order geometry/geography A are the same as the coordinates and coordinate order of geometry/geography B.
  • ST_Node - Changed: 2.4.0 this function uses GEOSNode internally instead of GEOSUnaryUnion. This may cause the resulting linestrings to have a different order and direction compared to PostGIS < 2.4. Nodes a collection of lines.

12.12.8. PostGIS Functions new or enhanced in 2.3

The functions given below are PostGIS functions that were added or enhanced.

Functions new in PostGIS 2.3

  • &&&(geometry,gidx) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a geometry's (cached) n-D bounding box intersects a n-D float precision bounding box (GIDX).
  • &&&(gidx,geometry) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a n-D float precision bounding box (GIDX) intersects a geometry's (cached) n-D bounding box.
  • &&&(gidx,gidx) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if two n-D float precision bounding boxes (GIDX) intersect each other.
  • &&(box2df,box2df) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if two 2D float precision bounding boxes (BOX2DF) intersect each other.
  • &&(box2df,geometry) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a 2D float precision bounding box (BOX2DF) intersects a geometry's (cached) 2D bounding box.
  • &&(geometry,box2df) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a geometry's (cached) 2D bounding box intersects a 2D float precision bounding box (BOX2DF).
  • @(box2df,box2df) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a 2D float precision bounding box (BOX2DF) is contained into another 2D float precision bounding box.
  • @(box2df,geometry) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a 2D float precision bounding box (BOX2DF) is contained into a geometry's 2D bounding box.
  • @(geometry,box2df) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a geometry's 2D bounding box is contained into a 2D float precision bounding box (BOX2DF).
  • ST_ClusterDBSCAN - Availability: 2.3.0 Window function that returns a cluster id for each input geometry using the DBSCAN algorithm.
  • ST_ClusterKMeans - Availability: 2.3.0 Window function that returns a cluster id for each input geometry using the K-means algorithm.
  • ST_GeneratePoints - 2.3.0 버전부터 사용할 수 있습니다. Generates random points contained in a Polygon or MultiPolygon.
  • ST_GeometricMedian - 2.3.0 버전부터 사용할 수 있습니다. 멀티 포인트의 기하학적 중심값(median)을 반환합니다.
  • ST_MakeLine - 2.0.0 버전부터 라인스트링 구성 요소 입력을 지원하기 시작했습니다. 포인트, 멀티포인트 또는 라인 도형으로부터 라인스트링을 생성합니다.
  • ST_MinimumBoundingRadius - 2.3.0 버전부터 사용할 수 있습니다. Returns the center point and radius of the smallest circle that contains a geometry.
  • ST_MinimumClearance - 2.3.0 버전부터 사용할 수 있습니다. 도형의 튼튼함(robustness)의 척도인 도형의 최소 여유(clearance)를 반환합니다.
  • ST_MinimumClearanceLine - 2.3.0 버전부터 사용할 수 있습니다. GEOS 3.6.0 이상 버전이 필요합니다. 포인트 2개로 이루어진, 도형의 최소 여유를 나타내는 라인스트링을 반환합니다.
  • ST_Normalize - 2.3.0 버전부터 사용할 수 있습니다. 도형을 해당 도형의 기본형으로 반환합니다.
  • ST_Points - 2.3.0 버전부터 사용할 수 있습니다. 도형의 모든 좌표들을 담고 있는 멀티포인트를 반환합니다.
  • ST_VoronoiLines - 2.3.0 버전부터 사용할 수 있습니다. Returns the boundaries of the Voronoi diagram of the vertices of a geometry.
  • ST_VoronoiPolygons - 2.3.0 버전부터 사용할 수 있습니다. Returns the cells of the Voronoi diagram of the vertices of a geometry.
  • ST_WrapX - Availability: 2.3.0 requires GEOS X값 근처에서 도형을 래핑합니다.
  • ~(box2df,box2df) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a 2D float precision bounding box (BOX2DF) contains another 2D float precision bounding box (BOX2DF).
  • ~(box2df,geometry) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a 2D float precision bounding box (BOX2DF) contains a geometry's 2D bonding box.
  • ~(geometry,box2df) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a geometry's 2D bonding box contains a 2D float precision bounding box (GIDX).

Functions enhanced in PostGIS 2.3

  • ST_Contains - Enhanced: 2.3.0 Enhancement to PIP short-circuit extended to support MultiPoints with few points. Prior versions only supported point in polygon. Tests if every point of B lies in A, and their interiors have a point in common
  • ST_Covers - Enhanced: 2.3.0 Enhancement to PIP short-circuit for geometry extended to support MultiPoints with few points. Prior versions only supported point in polygon. Tests if every point of B lies in A
  • ST_Expand - Enhanced: 2.3.0 support was added to expand a box by different amounts in different dimensions. Returns a bounding box expanded from another bounding box or a geometry.
  • ST_Intersects - Enhanced: 2.3.0 Enhancement to PIP short-circuit extended to support MultiPoints with few points. Prior versions only supported point in polygon. Tests if two geometries intersect (they have at least one point in common)
  • ST_Segmentize - Enhanced: 2.3.0 Segmentize geography now produces equal-length subsegments Returns a modified geometry/geography having no segment longer than a given distance.
  • ST_Transform - Enhanced: 2.3.0 support for direct PROJ.4 text was introduced. Return a new geometry with coordinates transformed to a different spatial reference system.
  • ST_Within - Enhanced: 2.3.0 Enhancement to PIP short-circuit for geometry extended to support MultiPoints with few points. Prior versions only supported point in polygon. Tests if every point of A lies in B, and their interiors have a point in common

Functions changed in PostGIS 2.3

  • ST_PointN - 변경 사항: 2.3.0 버전부터 음수 인덱스(-1이 마지막 포인트)를 이용할 수 있습니다. ST_LineString 또는 ST_CircularString 값에 있는 포인트의 개수를 반환합니다.

12.12.9. PostGIS Functions new or enhanced in 2.2

The functions given below are PostGIS functions that were added or enhanced.

Functions new in PostGIS 2.2

  • <<#>> - 2.2.0 버전부터 사용할 수 있습니다. PostgreSQL 9.1 이상 버전에서만 KNN을 쓸 수 있습니다. A와 B의 경계 상자 사이의 N차원 거리를 반환합니다.
  • <<->> - 2.2.0 버전부터 사용할 수 있습니다. PostgreSQL 9.1 이상 버전에서만 KNN을 쓸 수 있습니다. A 경계 상자와 B의 경계 상자의 중심점 사이의 N차원 거리를 반환합니다.
  • ST_3DDifference - 2.2.0 버전부터 사용할 수 있습니다. 3차원 차이를 수행합니다.
  • ST_3DUnion - 2.2.0 버전부터 사용할 수 있습니다. Perform 3D union.
  • ST_ApproximateMedialAxis - 2.2.0 버전부터 사용할 수 있습니다. 면 도형의 근사 중심축을 계산합니다.
  • ST_AsEncodedPolyline - 2.2.0 버전부터 사용할 수 있습니다. 라인스트링 도형으로부터 인코딩된 폴리라인을 반환합니다.
  • ST_AsTWKB - 2.2.0 버전부터 사용할 수 있습니다. 도형을 TWKB(Tiny Well-Known Binary)로 반환합니다.
  • ST_BoundingDiagonal - 2.2.0 버전부터 사용할 수 있습니다. 주어진 도형의 경계 상자의 대각선을 반환합니다.
  • ST_CPAWithin - Availability: 2.2.0 Tests if the closest point of approach of two trajectories is within the specified distance.
  • ST_ClipByBox2D - Availability: 2.2.0 Computes the portion of a geometry falling within a rectangle.
  • ST_ClosestPointOfApproach - Availability: 2.2.0 Returns a measure at the closest point of approach of two trajectories.
  • ST_ClusterIntersecting - Availability: 2.2.0 Aggregate function that clusters input geometries into connected sets.
  • ST_ClusterWithin - Availability: 2.2.0 Aggregate function that clusters geometries by separation distance.
  • ST_DistanceCPA - Availability: 2.2.0 Returns the distance between the closest point of approach of two trajectories.
  • ST_ForceCurve - 2.2.0 버전부터 사용할 수 있습니다. 적용이 가능한 경우, 도형을 해당 도형의 만곡 유형으로 상위 형변환(upcast)합니다.
  • ST_IsPlanar - 2.2.0 버전부터 사용할 수 있습니다. 원래 2.1.0 버전에 문서화됐지만 2.1 배포판에서는 실수로 빠졌습니다. 표면이 평면인지 아닌지 확인합니다.
  • ST_IsSolid - 2.2.0 버전부터 사용할 수 있습니다. 도형이 입체인지 테스트합니다. 어떤 유효성 검사도 수행하지 않습니다.
  • ST_IsValidTrajectory - Availability: 2.2.0 Tests if the geometry is a valid trajectory.
  • ST_LineFromEncodedPolyline - 2.2.0 버전부터 사용할 수 있습니다. 인코딩된 폴리라인(polyline)으로부터 라인스트링을 생성합니다.
  • ST_MakeSolid - 2.2.0 버전부터 사용할 수 있습니다. 도형을 입체로 지정합니다. 어떤 확인 작업도 수행하지 않습니다. 유효한 입체를 얻으려면, 입력 도형이 닫힌 다면체 표면 또는 닫힌 TIN이어야만 합니다.
  • ST_RemoveRepeatedPoints - 2.2.0 버전부터 사용할 수 있습니다. Returns a version of a geometry with duplicate points removed.
  • ST_SetEffectiveArea - 2.2.0 버전부터 사용할 수 있습니다. Sets the effective area for each vertex, using the Visvalingam-Whyatt algorithm.
  • ST_SimplifyVW - 2.2.0 버전부터 사용할 수 있습니다. Returns a simplified version of a geometry, using the Visvalingam-Whyatt algorithm
  • ST_Subdivide - Availability: 2.2.0 Computes a rectilinear subdivision of a geometry.
  • ST_SwapOrdinates - 2.2.0 버전부터 사용할 수 있습니다. 입력 도형을 좌표값을 뒤바꾼 상태로 반환합니다.
  • ST_Volume - 2.2.0 버전부터 사용할 수 있습니다. 3차원 입체의 부피를 계산합니다. 표면 도형을 입력하면 (닫힌 도형일지라도) 0을 반환할 것입니다.
  • postgis.enable_outdb_rasters - 2.2.0 버전부터 사용할 수 있습니다. DB 외부 래스터 밴드에 접근할 수 있게 해주는 불 설정 옵션입니다.
  • postgis.gdal_datapath - 2.2.0 버전부터 사용할 수 있습니다. GDAL의 GDAL_DATA 옵션의 값을 할당하는 설정 옵션입니다. 설정하지 않을 경우, 환경적으로 설정된 GDAL_DATA 변수를 사용합니다.
  • postgis.gdal_enabled_drivers - 2.2.0 버전부터 사용할 수 있습니다. PostGIS 환경에서 사용할 수 있는 GDAL 드라이버를 설정하는 설정 옵션입니다. GDAL 설정 변수 GDAL_SKIP에 영향을 미칩니다.
  • |=| - 2.2.0 버전부터 사용할 수 있습니다. PostgreSQL 9.5 이상 버전에서만 인덱스 지원형(index-supported)을 사용할 수 있습니다. A와 B 사이의 최근접점(closest point of approach)을 잇는 궤도(trajectory)의 거리를 반환합니다.

Functions enhanced in PostGIS 2.2

  • <-> - 개선 사항: 2.2.0 버전 -- PostgreSQL 9.5 이상 버전에서 도형 및 지리형에 대해 진정한 KNN("K nearest neighbor") 습성을 도입했습니다. 지리형 KNN이 타원체가 아니라 구체를 기반으로 한다는 점에 주의하십시오. PostgreSQL 9.4 이하 버전에서 지리형을 쓸 수 있긴 하지만, 중심점 상자만 지원합니다. A와 B 사이의 2차원 거리를 반환합니다.
  • ST_Area - 개선 사항: 2.2.0 버전부터 회전타원체 측정시 정확도와 강력함을 향상시키기 위해 GeographicLib을 이용합니다. 이 새 기능의 장점을 취하려면 Proj 4.9.0 이상 버전이 필요합니다. 도형의 기하학적 중심을 반환합니다.
  • ST_AsX3D - 개선 사항: 2.2.0 버전부터 지리좌표 및 축(x/y, 경도/위도) 뒤집기를 지원합니다. 자세한 내용은 옵션을 살펴보십시오. 도형을 X3D XML 노드 요소 형식: ISO-IEC-19776-1.2-X3DEncodings-XML로 반환합니다.
  • ST_Azimuth - 개선 사항: 2.2.0 버전부터 회전타원체 측정시 정확도와 강력함을 향상시키기 위해 GeographicLib을 이용합니다. 이 새 기능의 장점을 취하려면 Proj 4.9.0 이상 버전이 필요합니다. 두 도형 사이의 2차원 최단 라인을 반환합니다.
  • ST_Distance - 개선 사항: 2.2.0 버전부터 회전타원체 측정시 정확도와 강력함을 향상시키기 위해 GeographicLib을 이용합니다. 이 새 기능의 장점을 취하려면 Proj 4.9.0 이상 버전이 필요합니다. 두 도형 사이의 3차원 최장(longest) 라인을 반환합니다.
  • ST_Scale - Enhanced: 2.2.0 support for scaling all dimension (factor parameter) was introduced. Scales a geometry by given factors.
  • ST_Split - Enhanced: 2.2.0 support for splitting a line by a multiline, a multipoint or (multi)polygon boundary was introduced. Returns a collection of geometries created by splitting a geometry by another geometry.
  • ST_Summary - 개선 사항: 2.2.0 버전부터 TIN 및 만곡 도형(curve)을 지원하기 시작했습니다. 도형의 내용을 요약한 텍스트를 반환합니다.

Functions changed in PostGIS 2.2

  • <-> - 변경 사항: 2.2.0 버전 -- PostgreSQL 9.5 버전 사용자의 경우, 예전의 하이브리드 문법(Hybrid syntax)이 느릴 수도 있기 때문에 PostGIS 2.2 이상, PostgreSQL 9.5 이상 버전에서만 사용자 코드를 실행하는 경우 이 꼼수를 제거하는 편이 좋을 수도 있습니다. 다음 예시를 참조하세요. A와 B 사이의 2차원 거리를 반환합니다.
  • ST_3DClosestPoint - 변경 사항: 2.2.0 버전부터 2D 도형 두 개를 입력할 경우, (존재하지 않는 Z을 0으로 가정하는 예전 습성 대신) 2D 포인트를 반환합니다. 2D 및 3D의 경우, 더 이상 Z가 없을 때 Z를 0으로 가정하지 않습니다. g2에 가장 가까운 g1 상에 있는 3차원 포인트를 반환합니다. 해당 포인트는 3D 최단 라인의 첫 번째 포인트입니다.
  • ST_3DDistance - 변경 사항: 2.2.0 버전부터, 2D 및 3D의 경우 더 이상 Z가 없을 때 Z를 0으로 가정하지 않습니다. 도형 유형에 대해, 두 도형 사이의 (SRS에 기반한) 3차원 데카르트 최단 거리를 투영 단위로 반환합니다.
  • ST_3DLongestLine - 변경 사항: 2.2.0 버전부터 2D 도형 두 개를 입력할 경우, (존재하지 않는 Z을 0으로 가정하는 예전 습성 대신) 2D 포인트를 반환합니다. 2D 및 3D의 경우, 더 이상 Z가 없을 때 Z를 0으로 가정하지 않습니다. 두 도형 사이의 3차원 최장(longest) 라인을 반환합니다.
  • ST_3DMaxDistance - 변경 사항: 2.2.0 버전부터, 2D 및 3D의 경우 더 이상 Z가 없을 때 Z를 0으로 가정하지 않습니다. 도형 유형에 대해, 두 도형 사이의 (SRS에 기반한) 3차원 데카르트 최장 거리를 투영 단위로 반환합니다.
  • ST_3DShortestLine - 변경 사항: 2.2.0 버전부터 2D 도형 두 개를 입력할 경우, (존재하지 않는 Z을 0으로 가정하는 예전 습성 대신) 2D 포인트를 반환합니다. 2D 및 3D의 경우, 더 이상 Z가 없을 때 Z를 0으로 가정하지 않습니다. 두 도형 사이의 3차원 최단(shortest) 라인을 반환합니다.
  • ST_DistanceSphere - 변경 사항: 2.2.0 미만 버전에서는 ST_Distance_Sphere라는 명칭이었습니다. 특정 회전타원체가 주어진 두 경위도 도형 사이의 최단 거리를 반환합니다. PostGIS 1.5 미만 버전은 포인트만 지원했습니다.
  • ST_DistanceSpheroid - 변경 사항: 2.2.0 미만 버전에서는 ST_Distance_Spheroid라는 명칭이었습니다. 특정 회전타원체가 주어진 두 경위도 도형 사이의 최단 거리를 반환합니다. PostGIS 1.5 미만 버전은 포인트만 지원했습니다.
  • ST_Equals - Changed: 2.2.0 Returns true even for invalid geometries if they are binary equal Tests if two geometries include the same set of points
  • ST_LengthSpheroid - 변경 사항: 2.2.0 미만 버전에서는 ST_Length_Spheroid라는 명칭이었으며, ST_3DLength_Spheroid라는 동일 함수가 있었습니다. 도형의 기하학적 중심을 반환합니다.
  • ST_MemSize - Changed: 2.2.0 name changed to ST_MemSize to follow naming convention. ST_Geometry 값의 도형 유형을 반환합니다.
  • ST_PointInsideCircle - Changed: 2.2.0 In prior versions this was called ST_Point_Inside_Circle Tests if a point geometry is inside a circle defined by a center and radius

12.12.10. PostGIS Functions new or enhanced in 2.1

The functions given below are PostGIS functions that were added or enhanced.

Functions new in PostGIS 2.1

  • ST_3DArea - 2.1.0 버전부터 사용할 수 있습니다. 3차원 표면 도형의 면적을 계산합니다. 입체일 경우 0을 반환할 것입니다.
  • ST_3DIntersection - 2.1.0 버전부터 사용할 수 있습니다. 3차원 교차를 수행합니다.
  • ST_Box2dFromGeoHash - 2.1.0 버전부터 사용할 수 있습니다. GeoHash 스트링으로부터 BOX2D를 반환합니다.
  • ST_DelaunayTriangles - 2.1.0 버전부터 사용할 수 있습니다. Returns the Delaunay triangulation of the vertices of a geometry.
  • ST_Extrude - 2.1.0 버전부터 사용할 수 있습니다. 표면을 관련 입체로 돌출시킵니다.
  • ST_ForceLHR - 2.1.0 버전부터 사용할 수 있습니다. LHR(Left Hand Reverse; 시계 방향) 방향을 강제합니다.
  • ST_GeomFromGeoHash - 2.1.0 버전부터 사용할 수 있습니다. GeoHash 스트링으로부터 도형을 반환합니다.
  • ST_MinkowskiSum - 2.1.0 버전부터 사용할 수 있습니다. 민코프스키 합계를 수행합니다.
  • ST_Orientation - 2.1.0 버전부터 사용할 수 있습니다. 표면의 방향(orientation)을 결정합니다.
  • ST_PointFromGeoHash - 2.1.0 버전부터 사용할 수 있습니다. GeoHash 스트링으로부터 포인트를 반환합니다.
  • ST_StraightSkeleton - 2.1.0 버전부터 사용할 수 있습니다. 도형으로부터 직선 골격(straight skeleton)을 계산합니다.
  • ST_Tesselate - 2.1.0 버전부터 사용할 수 있습니다. 폴리곤 또는 다면체 표면의 표면 다듬기(tesselation) 작업을 수행한 다음 TIN 또는 TIN 집합으로 반환합니다.
  • postgis.backend - 2.1.0 버전부터 사용할 수 있습니다. GEOS와 SFCGAL 양쪽의 겹치는 함수를 서비스하는 백엔드입니다. geos 또는 sfcgal을 선택할 수 있는데, 기본값은 geos입니다.
  • postgis_sfcgal_version - 2.1.0 버전부터 사용할 수 있습니다. 실행중인 SFCGAL의 버전을 반환합니다.

Functions enhanced in PostGIS 2.1

  • ST_AsGML - 개선 사항: 2.1.0 버전부터 GML 3를 위해 ID를 지원하기 시작했습니다. 도형을 GML 2 또는 GML 3 버전 요소로 반환합니다.
  • ST_Boundary - 개선 사항: 2.1.0 버전부터 삼각형을 지원하기 시작했습니다. 해당 도형의 결합된 범위의 닫힘 여부를 반환합니다.
  • ST_DWithin - Enhanced: 2.1.0 improved speed for geography. See Making Geography faster for details. Tests if two geometries are within a given distance
  • ST_DWithin - Enhanced: 2.1.0 support for curved geometries was introduced. Tests if two geometries are within a given distance
  • ST_Distance - 개선 사항: 2.1.0 버전부터 지리형에 대한 속도가 향상됐습니다. 자세한 내용은 Making Geography faster 를 참조하십시오. 두 도형 사이의 3차원 최장(longest) 라인을 반환합니다.
  • ST_Distance - 개선 사항: 2.1.0 버전부터 만곡 도형을 지원하기 시작했습니다. 두 도형 사이의 3차원 최장(longest) 라인을 반환합니다.
  • ST_DumpPoints - Enhanced: 2.1.0 Faster speed. Reimplemented as native-C. 도형의 내용을 요약한 텍스트를 반환합니다.
  • ST_MakeValid - Enhanced: 2.1.0, added support for GEOMETRYCOLLECTION and MULTIPOINT. Attempts to make an invalid geometry valid without losing vertices.
  • ST_Segmentize - 개선 사항: 2.1.0 버전부터 지리형을 지원하기 시작했습니다. Returns a modified geometry/geography having no segment longer than a given distance.
  • ST_Summary - 개선 사항: 2.1.0 버전. 알려진 공간 참조 시스템을 가진 경우를 나타내는 S 플래그가 추가됐습니다. 도형의 내용을 요약한 텍스트를 반환합니다.

Functions changed in PostGIS 2.1

  • ST_EstimatedExtent - Changed: 2.1.0. Up to 2.0.x this was called ST_Estimated_Extent. Returns the estimated extent of a spatial table.
  • ST_Force2D - 변경 사항: 2.1.0 미만 버전, 즉 2.0.x 버전까지 이 함수의 명칭은 ST_Force_2D였습니다. 도형을 "2차원 모드"로 강제합니다.
  • ST_Force3D - 변경 사항: 2.1.0 미만 버전, 즉 2.0.x 버전까지 이 함수의 명칭은 ST_Force_3D였습니다. 도형을 XYZ 모드로 강제합니다. ST_Force3DZ라고도 합니다.
  • ST_Force3DM - 변경 사항: 2.1.0 미만 버전, 즉 2.0.x 버전까지 이 함수의 명칭은 ST_Force_3DM이었습니다. 도형을 XYM 모드로 강제합니다.
  • ST_Force3DZ - 변경 사항: 2.1.0 미만 버전, 즉 2.0.x 버전까지 이 함수의 명칭은 ST_Force_3DZ였습니다. 도형을 XYZ 모드로 강제합니다.
  • ST_Force4D - 변경 사항: 2.1.0 미만 버전, 즉 2.0.x 버전까지 이 함수의 명칭은 ST_Force_4D였습니다. 도형을 XYZM 모드로 강제합니다.
  • ST_ForceCollection - 변경 사항: 2.1.0 미만 버전, 즉 2.0.x 버전까지 이 함수의 명칭은 ST_Force_Collection이었습니다. 도형을 도형 집합으로 변환합니다.
  • ST_LineInterpolatePoint - 변경 사항: 2.1.0 미만 버전, 즉 2.0.x 버전까지 이 함수의 명칭은 ST_Line_Interpolate_Point였습니다. Returns a point interpolated along a line at a fractional location.
  • ST_LineLocatePoint - 변경 사항: 2.1.0 미만 버전, 즉 2.0.x 버전까지 이 함수의 명칭은 ST_Line_Locate_Point였습니다. Returns the fractional location of the closest point on a line to a point.
  • ST_LineSubstring - 변경 사항: 2.1.0 미만 버전, 즉 2.0.x 버전까지 이 함수의 명칭은 ST_Line_Substring이었습니다. Returns the part of a line between two fractional locations.
  • ST_Segmentize - Changed: 2.1.0 As a result of the introduction of geography support, the usage ST_Segmentize('LINESTRING(1 2, 3 4)', 0.5) causes an ambiguous function error. The input needs to be properly typed as a geometry or geography. Use ST_GeomFromText, ST_GeogFromText or a cast to the required type (e.g. ST_Segmentize('LINESTRING(1 2, 3 4)'::geometry, 0.5) ) Returns a modified geometry/geography having no segment longer than a given distance.

12.12.11. PostGIS Functions new or enhanced in 2.0

The functions given below are PostGIS functions that were added or enhanced.

Functions new in PostGIS 2.0

  • &&& - 2.0.0 버전부터 사용할 수 있습니다. A의 n차원 경계 상자와 B의 n차원 경계 상자가 교차하는 경우 TRUE 를 반환합니다.
  • <#> - 2.0.0 버전부터 사용할 수 있습니다. PostgreSQL 9.1 이상 버전에서만 KNN을 쓸 수 있습니다. A와 B의 경계 상자 사이의 2차원 거리를 반환합니다.
  • <-> - 2.0.0 버전부터 사용할 수 있습니다. 약한 KNN이 실제 거리 대신 도형 중심점 거리에 기반한 최근접 탐색을 제공합니다. 포인트의 경우 정확한 결과를 출력하지만, 다른 모든 유형에 대해서는 부정확한 결과를 냅니다. PostgreSQL 9.1 이상 버전에서 이용할 수 있습니다. A와 B 사이의 2차원 거리를 반환합니다.
  • ST_3DClosestPoint - 2.0.0 버전부터 사용할 수 있습니다. g2에 가장 가까운 g1 상에 있는 3차원 포인트를 반환합니다. 해당 포인트는 3D 최단 라인의 첫 번째 포인트입니다.
  • ST_3DDFullyWithin - Availability: 2.0.0 Tests if two 3D geometries are entirely within a given 3D distance
  • ST_3DDWithin - Availability: 2.0.0 Tests if two 3D geometries are within a given 3D distance
  • ST_3DDistance - 2.0.0 버전부터 사용할 수 있습니다. 도형 유형에 대해, 두 도형 사이의 (SRS에 기반한) 3차원 데카르트 최단 거리를 투영 단위로 반환합니다.
  • ST_3DIntersects - Availability: 2.0.0 Tests if two geometries spatially intersect in 3D - only for points, linestrings, polygons, polyhedral surface (area)
  • ST_3DLongestLine - 2.0.0 버전부터 사용할 수 있습니다. 두 도형 사이의 3차원 최장(longest) 라인을 반환합니다.
  • ST_3DMaxDistance - 2.0.0 버전부터 사용할 수 있습니다. 도형 유형에 대해, 두 도형 사이의 (SRS에 기반한) 3차원 데카르트 최장 거리를 투영 단위로 반환합니다.
  • ST_3DShortestLine - 2.0.0 버전부터 사용할 수 있습니다. 두 도형 사이의 3차원 최단(shortest) 라인을 반환합니다.
  • ST_AsLatLonText - 2.0 버전부터 사용할 수 있습니다. 주어진 포인트의 도, 분, 초 표현식을 반환합니다.
  • ST_AsX3D - 2.0.0 버전부터 ISO-IEC-19776-1.2-X3DEncodings-XML을 이용할 수 있습니다. 도형을 X3D XML 노드 요소 형식: ISO-IEC-19776-1.2-X3DEncodings-XML로 반환합니다.
  • ST_CollectionHomogenize - 2.0.0 버전부터 사용할 수 있습니다. Returns the simplest representation of a geometry collection.
  • ST_ConcaveHull - 2.0.0 버전부터 사용할 수 있습니다. Computes a possibly concave geometry that contains all input geometry vertices
  • ST_FlipCoordinates - 2.0.0 버전부터 사용할 수 있습니다. Returns a version of a geometry with X and Y axis flipped.
  • ST_GeomFromGeoJSON - 2.0.0 버전부터 사용할 수 있습니다. JSON-C 0.9 이상 버전이 필요합니다. GeoJSON 표현식을 입력받아 PostGIS 도형 객체를 출력합니다.
  • ST_InterpolatePoint - 2.0.0 버전부터 사용할 수 있습니다. 입력 포인트에 가까운 포인트에서 도형의 척도 차원(M 차원)의 값을 반환합니다.
  • ST_IsValidDetail - Availability: 2.0.0 Returns a valid_detail row stating if a geometry is valid or if not a reason and a location.
  • ST_IsValidReason - Availability: 2.0 version taking flags. Returns text stating if a geometry is valid, or a reason for invalidity.
  • ST_MakeLine - 2.0.0 버전부터 라인스트링 구성 요소 입력을 지원하기 시작했습니다. 포인트, 멀티포인트 또는 라인 도형으로부터 라인스트링을 생성합니다.
  • ST_MakeValid - Availability: 2.0.0 Attempts to make an invalid geometry valid without losing vertices.
  • ST_Node - Availability: 2.0.0 Nodes a collection of lines.
  • ST_NumPatches - 2.0.0 버전부터 사용할 수 있습니다. 다면체 표면 상에 있는 면의 개수를 반환합니다. 다면체 도형이 아닌 경우 NULL을 반환할 것입니다.
  • ST_OffsetCurve - 2.0 버전부터 사용할 수 있습니다. Returns an offset line at a given distance and side from an input line.
  • ST_PatchN - 2.0.0 버전부터 사용할 수 있습니다. ST_Geometry 값의 도형 유형을 반환합니다.
  • ST_Perimeter - 개선 사항: 2.0.0 버전부터 지리형을 지원합니다. Returns the length of the boundary of a polygonal geometry or geography.
  • ST_Project - 2.0.0 버전부터 사용할 수 있습니다. Returns a point projected from a start point by a distance and bearing (azimuth).
  • ST_RelateMatch - Availability: 2.0.0 Tests if a DE-9IM Intersection Matrix matches an Intersection Matrix pattern
  • ST_SharedPaths - 2.0.0 버전부터 사용할 수 있습니다. 두 입력 라인스트링/멀티라인스트링이 공유하는 경로를 담고 있는 집합을 반환합니다.
  • ST_Snap - 2.0.0 버전부터 사용할 수 있습니다. 입력 도형의 분절 구간과 꼭짓점을 참조 도형의 꼭짓점으로 스냅시킵니다.
  • ST_Split - Availability: 2.0.0 requires GEOS Returns a collection of geometries created by splitting a geometry by another geometry.
  • ST_UnaryUnion - Availability: 2.0.0 Computes the union of the components of a single geometry.

Functions enhanced in PostGIS 2.0

  • && - 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface)을 지원합니다. A의 2D 경계 상자와 B의 2D 경계 상자가 교차하는 경우 TRUE 를 반환합니다.
  • AddGeometryColumn - 개선 사항: 2.0.0 버전. use_typmod 인자가 추가됐습니다. 제약조건 기반 도형 열 대신 기본적으로 typmod 도형 열을 생성합니다. 공간 테이블에서 지오메트리 컬럼을 제거합니다.
  • Box2D - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced. Returns a BOX2D representing the 2D extent of a geometry.
  • Box3D - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced. Returns a BOX3D representing the 3D extent of a geometry.
  • GeometryType - 개선 사항: 2.0.0 버전부터 다면체 표면, 삼각형 및 TIN을 지원하기 시작했습니다. ST_Geometry 값의 도형 유형을 반환합니다.
  • Populate_Geometry_Columns - 개선 사항: 2.0.0 버전. 열 생성시 유형 변경자와 함께, 또는 확인 제약조건과 함께 생성할지 통제할 수 있는 use_typmod 의 선택적 인자가 추가됐습니다. Ensures geometry columns are defined with type modifiers or have appropriate spatial constraints.
  • ST_3DExtent - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced. Aggregate function that returns the 3D bounding box of geometries.
  • ST_Affine - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced. Apply a 3D affine transformation to a geometry.
  • ST_Area - 개선 사항: 2.0.0 버전부터 2차원 다면체 표면(polyhedral surface)을 지원합니다. 도형의 기하학적 중심을 반환합니다.
  • ST_AsBinary - 개선 사항: 2.0.0 버전부터 다면체 표면, 삼각형 및 TIN을 지원하기 시작했습니다. Return the OGC/ISO Well-Known Binary (WKB) representation of the geometry/geography without SRID meta data.
  • ST_AsBinary - 개선 사항: 2.0.0 버전부터 더 높은 좌표 차원을 지원합니다. Return the OGC/ISO Well-Known Binary (WKB) representation of the geometry/geography without SRID meta data.
  • ST_AsBinary - 개선 사항: 2.0.0 버전부터 지리형과 함께 엔디안을 설정하는 방식을 지원합니다. Return the OGC/ISO Well-Known Binary (WKB) representation of the geometry/geography without SRID meta data.
  • ST_AsEWKB - 개선 사항: 2.0.0 버전부터 다면체 표면, 삼각형 및 TIN을 지원하기 시작했습니다. Return the Extended Well-Known Binary (EWKB) representation of the geometry with SRID meta data.
  • ST_AsEWKT - 개선 사항: 2.0.0 버전부터 지리형, 다면체 표면, 삼각형 및 TIN을 지원하기 시작했습니다. 도형의 WKT(Well-Known Text) 표현식을 SRID 메타데이터와 함께 반환합니다.
  • ST_AsGML - 개선 사항: 2.0.0 버전부터 접두사를 지원합니다. 라인에 대해 커브 대신 라인스트링 태그를 이용할 수 있도록 GML 3용 옵션 '4'가 등장했습니다. GML 3가 다면체 표면 및 TIN을 지원하기 시작했습니다. 상자를 출력하는 옵션 '32'도 새롭게 등장했습니다. 도형을 GML 2 또는 GML 3 버전 요소로 반환합니다.
  • ST_AsKML - 개선 사항: 2.0.0 버전부터 네임스페이스에 접두사를 추가할 수 있습니다. 기본값은 접두사를 쓰지 않는 것입니다. 도형을 GML 2 또는 GML 3 버전 요소로 반환합니다.
  • ST_Azimuth - 개선 사항: 2.0.0 버전부터 지리형을 지원합니다. 두 도형 사이의 2차원 최단 라인을 반환합니다.
  • ST_Dimension - 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface) 및 TIN을 지원합니다. 빈 도형이 주어져도 더 이상 예외가 발생하지 않습니다. ST_Geometry 값의 좌표 차원을 반환합니다.
  • ST_Dump - 개선 사항: 2.0.0 버전부터 다면체 표면, 삼각형 및 TIN을 지원하기 시작했습니다. Returns a set of geometry_dump rows for the components of a geometry.
  • ST_DumpPoints - 개선 사항: 2.0.0 버전부터 다면체 표면, 삼각형 및 TIN을 지원하기 시작했습니다. 도형의 내용을 요약한 텍스트를 반환합니다.
  • ST_Expand - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced. Returns a bounding box expanded from another bounding box or a geometry.
  • ST_Extent - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced. Aggregate function that returns the bounding box of geometries.
  • ST_Force2D - 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface)을 지원합니다. 도형을 "2차원 모드"로 강제합니다.
  • ST_Force3D - 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface)을 지원합니다. 도형을 XYZ 모드로 강제합니다. ST_Force3DZ라고도 합니다.
  • ST_Force3DZ - 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface)을 지원합니다. 도형을 XYZ 모드로 강제합니다.
  • ST_ForceCollection - 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface)을 지원합니다. 도형을 도형 집합으로 변환합니다.
  • ST_ForceRHR - 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface)을 지원합니다. 폴리곤 안에 있는 꼭짓점들의 방향(orientation)이 오른손 법칙(Right-Hand Rule)을 따르도록 강제합니다.
  • ST_GMLToSQL - 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface) 및 TIN을 지원합니다. GML로부터 지정된 ST_Geometry 값을 반환합니다. 이 함수는 ST_GeomFromGML 함수와 동일합니다.
  • ST_GMLToSQL - 개선 사항: 2.0.0 버전에서 선택적인 기본 SRID 파라미터가 추가됐습니다. GML로부터 지정된 ST_Geometry 값을 반환합니다. 이 함수는 ST_GeomFromGML 함수와 동일합니다.
  • ST_GeomFromEWKB - 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface) 및 TIN을 지원합니다. EWKB(Extended Well-Known Binary)로부터 지정된 ST_Geometry 값을 반환합니다.
  • ST_GeomFromEWKT - 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface) 및 TIN을 지원합니다. EWKT(Extended Well-Known Text)로부터 지정된 ST_Geometry 값을 반환합니다.
  • ST_GeomFromGML - 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface) 및 TIN을 지원합니다. 도형의 GML 표현식을 입력받아 PostGIS 도형 객체를 출력합니다.
  • ST_GeomFromGML - 개선 사항: 2.0.0 버전에서 선택적인 기본 SRID 파라미터가 추가됐습니다. 도형의 GML 표현식을 입력받아 PostGIS 도형 객체를 출력합니다.
  • ST_GeometryN - 개선 사항: 2.0.0 버전부터 다면체 표면, 삼각형 및 TIN을 지원하기 시작했습니다. ST_Geometry 값의 도형 유형을 반환합니다.
  • ST_GeometryType - 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface)을 지원합니다. ST_Geometry 값의 도형 유형을 반환합니다.
  • ST_IsClosed - 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface)을 지원합니다. LINESTRING 의 시작점과 종단점이 일치하는 경우 TRUE 를 반환합니다. 다면체 표면이 닫혀 (부피를 가지고) 있는 경우 TRUE 를 반환합니다.
  • ST_MakeEnvelope - 개선 사항: 2.0 버전부터 SRID를 지정하지 않고도 직사각형(envelope)을 설정할 수 있는 기능이 추가됐습니다. 주어진 최소값과 최대값으로 형성된 직사각형 폴리곤을 생성합니다. 입력값이 SRID로 지정된 SRS를 가지고 있어야 합니다.
  • ST_MakeValid - Enhanced: 2.0.1, speed improvements Attempts to make an invalid geometry valid without losing vertices.
  • ST_NPoints - 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface)을 지원합니다. 도형이 가지고 있는 포인트(꼭짓점)의 개수를 반환합니다.
  • ST_NumGeometries - 개선 사항: 2.0.0 버전부터 다면체 표면, 삼각형 및 TIN을 지원하기 시작했습니다. 도형이 가지고 있는 포인트의 개수를 반환합니다. 모든 도형을 입력받을 수 있습니다.
  • ST_Relate - Enhanced: 2.0.0 - added support for specifying boundary node rule. Tests if two geometries have a topological relationship matching an Intersection Matrix pattern, or computes their Intersection Matrix
  • ST_Rotate - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced. Rotates a geometry about an origin point.
  • ST_Rotate - Enhanced: 2.0.0 additional parameters for specifying the origin of rotation were added. Rotates a geometry about an origin point.
  • ST_RotateX - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced. Rotates a geometry about the X axis.
  • ST_RotateY - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced. Rotates a geometry about the Y axis.
  • ST_RotateZ - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced. Rotates a geometry about the Z axis.
  • ST_Scale - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced. Scales a geometry by given factors.
  • ST_ShiftLongitude - 개선 사항: 2.0.0 버전부터 다면체 표면(polyhedral surface) 및 TIN을 지원합니다. Shifts the longitude coordinates of a geometry between -180..180 and 0..360.
  • ST_Summary - 개선 사항: 2.0.0 버전부터 지리형을 지원하기 시작했습니다. 도형의 내용을 요약한 텍스트를 반환합니다.
  • ST_Transform - Enhanced: 2.0.0 support for Polyhedral surfaces was introduced. Return a new geometry with coordinates transformed to a different spatial reference system.

Functions changed in PostGIS 2.0

  • AddGeometryColumn - 변경사항: 2.0.0 이 함수는 geometry_columns이 시스템 카테고리에서 읽히는 뷰인 동안 더 이상 geometry_columns을 업데이트 하지 않습니다. 이것은 기본적으로 컨스트레인트를 만들지 않지만, 대신에 PostgreSQL의 내장된 타입 변경 동작이 대신합니다. 그래서 예를 들어 WGS84 POINT 컬럼을 이 함수로 만든다면 이 함수는 다음과 동등합니다: ALTER TABLE some_table ADD COLUMN geom geometry(Point,4326); 공간 테이블에서 지오메트리 컬럼을 제거합니다.
  • AddGeometryColumn - 변경 사항: 2.0.0 버전. 제약조건의 구식 습성이 필요할 경우, 기본값인 use_typmod 를 이용하되, 거짓으로 설정하십시오. 공간 테이블에서 지오메트리 컬럼을 제거합니다.
  • AddGeometryColumn - 변경 사항: 2.0.0 버전. 더 이상 뷰를 직접 geometry_columns에 등록시킬 수는 없지만, 도형 typmod 테이블 도형을 기반으로 빌드된 , 그리고 래퍼 함수 없이 사용되는 뷰는 자신의 페어런트 테이블 열의 typmod 습성을 상속하기 때문에 스스로를 정확히 등록시킵니다. 이런 뷰 도형 열을 geometry_columns에 정확히 등록시키려면, 다른 도형을 출력하는 도형 함수를 이용하는 뷰를 typmod 도형으로 형변환시켜야 할 것입니다. 을 참조하십시오. 공간 테이블에서 지오메트리 컬럼을 제거합니다.
  • DropGeometryColumn - 변경 사항: 2.0.0 버전. 하위 호환성을 위해 이 함수를 제공합니다. 이제는 geometry_columns이 시스템 카탈로그를 기반으로 하는 뷰이기 때문에, 다른 어떤 테이블 열과도 마찬가지로 도형 열도 ALTER TABLE 을 이용해서 삭제할 수 있습니다. 공간 테이블에서 지오메트리 컬럼을 제거합니다.
  • DropGeometryTable - 변경 사항: 2.0.0 버전. 하위 호환성을 위해 이 함수를 제공합니다. 이제는 geometry_columns이 시스템 카탈로그를 기반으로 하는 뷰이기 때문에, 다른 어떤 테이블과도 마찬가지로 도형 열을 가진 테이블도 DROP TABLE 을 이용해서 삭제할 수 있습니다. 테이블 및 geometry_columns의 모든 참조를 삭제합니다.
  • Populate_Geometry_Columns - 변경 사항: 2.0.0 버전. 이제 도형 유형을 제한하기 위해 확인 제약조건 대신 유형 변경자를 이용합니다. 새 use_typmod 를 거짓으로 설정하면, 확인 제약조건 습성을 계속 쓸 수 있습니다. Ensures geometry columns are defined with type modifiers or have appropriate spatial constraints.
  • ST_3DExtent - Changed: 2.0.0 In prior versions this used to be called ST_Extent3D Aggregate function that returns the 3D bounding box of geometries.
  • ST_3DLength - 변경 사항: 2.0.0 미만 버전에서는 ST_Length3D라는 명칭이었습니다. 도형의 기하학적 중심을 반환합니다.
  • ST_3DMakeBox - Changed: 2.0.0 In prior versions this used to be called ST_MakeBox3D Creates a BOX3D defined by two 3D point geometries.
  • ST_3DPerimeter - 변경 사항: 2.0.0 미만 버전에서는 ST_Perimeter3D라는 명칭이었습니다. 도형의 기하학적 중심을 반환합니다.
  • ST_AsBinary - 변경 사항: 2.0.0버전부터 이 함수에 알려지지 않은 유형을 입력할 수 없게 됐습니다. 반드시 도형을 입력해야 합니다. ST_AsBinary('POINT(1 2)') 같은 구조는 더 이상 유효하지 않아, n st_asbinary(unknown) is not unique error 오류가 발생합니다. 이런 코드는 ST_AsBinary('POINT(1 2)'::geometry); 로 변경돼야 합니다. 이렇게 변경할 수 없는 경우, legacy.sql 을 설치하십시오. Return the OGC/ISO Well-Known Binary (WKB) representation of the geometry/geography without SRID meta data.
  • ST_AsGML - 변경 사항: 2.0.0 버전부터 명명된 독립변수(named arg)를 기본값으로 씁니다. 도형을 GML 2 또는 GML 3 버전 요소로 반환합니다.
  • ST_AsGeoJSON - 변경 사항: 2.0.0 버전부터 기본 독립 변수(default arg) 및 명명된 독립 변수(named arg)를 지원합니다. Return a geometry as a GeoJSON element.
  • ST_AsSVG - 변경 사항: 2.0.0 버전부터 기본 독립 변수(default arg)를 사용하고 명명된 독립 변수(named arg)를 지원합니다. Returns SVG path data for a geometry.
  • ST_EndPoint - 변경 사항: 2.0.0 버전부터 단일 도형 멀티라인스트링을 지원하지 않습니다. PostGIS 예전 버전이라면 단일 라인 멀티라인스트링을 입력받는 경우 시작점을 반환했을 겁니다. 2.0.0 버전은 다른 모든 멀티라인스트링처럼 NULL을 반환할 뿐입니다. 구식 습성은 문서화되지 않은 기능이지만, 사용자 데이터를 라인스트링으로 저장했다고 가정한 사용자의 경우 현재 2.0 버전에서 NULL이 반환될 수도 있습니다. ST_LineString 또는 ST_CircularString 값에 있는 포인트의 개수를 반환합니다.
  • ST_GeomFromText - 변경 사항: PostGIS 2.0.0 미만 버전에서는 ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') 를 사용할 수 있었습니다. PostGIS 2.0.0 버전부터, SQL/MM 표준을 더 잘 준수하기 위해 이런 사용법은 금지됐습니다. 이제는 ST_GeomFromText('GEOMETRYCOLLECTION EMPTY') 라고 작성해야 합니다. WKT 표현식으로부터 지정된 ST_Geometry 값을 반환합니다.
  • ST_GeometryN - 변경 사항: 2.0.0 미만 버전은 단일 도형에 대해 NULL을 반환했을 겁니다. 2.0.0 버전부터 ST_GeometryN(..,1) 경우에 대한 도형을 반환하도록 변경됐습니다. ST_Geometry 값의 도형 유형을 반환합니다.
  • ST_IsEmpty - 변경 사항: PostGIS 2.0.0 미만 버전에서는 ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') 를 사용할 수 있었습니다. PostGIS 2.0.0 버전부터, SQL/MM 표준을 더 잘 준수하기 위해 이런 사용법은 금지됐습니다. Tests if a geometry is empty.
  • ST_Length - 변경 사항: 2.0.0 버전에서 중요한 변경이 이루어졌습니다. 2.0.0 이전 버전에서 이 함수에 폴리곤/멀티폴리곤 유형의 지리형을 입력하면 폴리곤/멀티폴리곤의 둘레를 반환했을 겁니다. 2.0.0 버전부터 도형 습성과 맞추기 위해 0을 반환하도록 변경됐습니다. 폴리곤의 둘레를 원한다면 ST_Perimeter 함수를 이용하십시오. 도형의 기하학적 중심을 반환합니다.
  • ST_LocateAlong - 변경 사항: 2.0.0 미만 버전에서는 ST_Locate_Along_Measure라는 명칭이었습니다. 예전 명칭은 더 지원되지 않고 곧 삭제될 예정이지만, 아직은 사용할 수 있습니다. Returns the point(s) on a geometry that match a measure value.
  • ST_LocateBetween - 변경 사항: 2.0.0 미만 버전에서는 ST_Locate_Along_Measure라는 명칭이었습니다. 예전 명칭은 더 지원되지 않고 곧 삭제될 예정이지만, 아직은 사용할 수 있습니다. Returns the portions of a geometry that match a measure range.
  • ST_NumGeometries - 변경 사항: 2.0.0 미만 버전에서 도형이 집합이나 멀티 유형이 아닐 경우 NULL을 반환했습니다. 2.0.0 버전부터 폴리곤, 라인스트링, 포인트 같은 단일 도형에 대해 1을 반환합니다. 도형이 가지고 있는 포인트의 개수를 반환합니다. 모든 도형을 입력받을 수 있습니다.
  • ST_NumInteriorRings - 변경 사항: 2.0.0 미만 버전에서는 멀티폴리곤을 입력하면 첫 번째 폴리곤의 내곽 고리의 개수를 반환받을 수 있었습니다. 폴리곤 도형의 내곽 고리의 개수를 반환합니다.
  • ST_PointN - 변경 사항: 2.0.0 버전부터 단일 도형 멀티라인스트링을 지원하지 않습니다. PostGIS 예전 버전이라면 단일 라인 멀티라인스트링을 입력받는 경우 시작점을 반환했을 겁니다. 2.0.0 버전은 다른 모든 멀티라인스트링처럼 NULL을 반환할 뿐입니다. ST_LineString 또는 ST_CircularString 값에 있는 포인트의 개수를 반환합니다.
  • ST_StartPoint - 변경 사항: 2.0.0 버전부터 단일 도형 멀티라인스트링을 지원하지 않습니다. PostGIS 예전 버전이라면 단일 라인 멀티라인스트링을 입력받는 경우 시작점을 반환했을 겁니다. 2.0.0 버전은 다른 모든 멀티라인스트링처럼 NULL을 반환할 뿐입니다. 구식 습성은 문서화되지 않은 기능이지만, 사용자 데이터를 라인스트링으로 저장했다고 가정한 사용자의 경우 현재 2.0 버전에서 NULL이 반환될 수도 있습니다. Returns the first point of a LineString.

12.12.12. PostGIS Functions new or enhanced in 1.5

The functions given below are PostGIS functions that were added or enhanced.

Functions new in PostGIS 1.5

  • && - 1.5.0 버전부터 지리형을 지원합니다. A의 2D 경계 상자와 B의 2D 경계 상자가 교차하는 경우 TRUE 를 반환합니다.
  • PostGIS_LibXML_Version - Availability: 1.5 Returns the version number of the libxml2 library.
  • ST_AddMeasure - 1.5.0 버전부터 사용할 수 있습니다. Interpolates measures along a linear geometry.
  • ST_AsBinary - 1.5.0 버전부터 지리형을 지원합니다. Return the OGC/ISO Well-Known Binary (WKB) representation of the geometry/geography without SRID meta data.
  • ST_AsGML - 1.5.0 버전부터 지리형을 지원합니다. 도형을 GML 2 또는 GML 3 버전 요소로 반환합니다.
  • ST_AsGeoJSON - 1.5.0 버전부터 지리형을 지원합니다. Return a geometry as a GeoJSON element.
  • ST_AsText - 1.5.0 버전부터 지리형을 지원합니다. 도형/지리형의 WKT(Well-Known Text) 표현식을 SRID 메타데이터 없이 반환합니다.
  • ST_Buffer - Availability: 1.5 - ST_Buffer was enhanced to support different endcaps and join types. These are useful for example to convert road linestrings into polygon roads with flat or square edges instead of rounded edges. Thin wrapper for geography was added. Computes a geometry covering all points within a given distance from a geometry.
  • ST_ClosestPoint - 1.5.0 버전부터 사용할 수 있습니다. Returns the 2D point on g1 that is closest to g2. This is the first point of the shortest line from one geometry to the other.
  • ST_CollectionExtract - 1.5.0 버전부터 사용할 수 있습니다. Given a geometry collection, returns a multi-geometry containing only elements of a specified type.
  • ST_Covers - Availability: 1.5 - support for geography was introduced. Tests if every point of B lies in A
  • ST_DFullyWithin - Availability: 1.5.0 Tests if two geometries are entirely within a given distance
  • ST_DWithin - Availability: 1.5.0 support for geography was introduced Tests if two geometries are within a given distance
  • ST_Distance - 1.5.0 버전부터 지리형을 지원합니다. 대용량 또는 수많은 꼭짓점을 가진 도형을 더 잘 처리하기 위해 평면에 대한 속도를 향상시켰습니다. 두 도형 사이의 3차원 최장(longest) 라인을 반환합니다.
  • ST_DistanceSphere - 1.5 버전부터 포인트가 아닌 다른 도형 유형을 지원하기 시작했습니다. 1.5 미만 버전에서는 포인트에 대해서만 구현돼 있었습니다. 특정 회전타원체가 주어진 두 경위도 도형 사이의 최단 거리를 반환합니다. PostGIS 1.5 미만 버전은 포인트만 지원했습니다.
  • ST_DistanceSpheroid - 1.5 버전부터 포인트가 아닌 다른 도형 유형을 지원하기 시작했습니다. 1.5 미만 버전에서는 포인트에 대해서만 구현돼 있었습니다. 특정 회전타원체가 주어진 두 경위도 도형 사이의 최단 거리를 반환합니다. PostGIS 1.5 미만 버전은 포인트만 지원했습니다.
  • ST_DumpPoints - 1.2.2 버전부터 사용할 수 있습니다. 도형의 내용을 요약한 텍스트를 반환합니다.
  • ST_Envelope - 1.5.0 버전부터 사용할 수 있으며, float4 형 대신 이중 정밀도 형으로 출력하도록 변경되었습니다. 주어진 도형의 이중 정밀도(double precision; float8) 경계 상자를 표현하는 도형을 반환합니다.
  • ST_Expand - Availability: 1.5.0 behavior changed to output double precision instead of float4 coordinates. Returns a bounding box expanded from another bounding box or a geometry.
  • ST_GMLToSQL - 1.5 버전부터 사용할 수 있습니다. LibXML2 1.6 이상 버전이 필요합니다. GML로부터 지정된 ST_Geometry 값을 반환합니다. 이 함수는 ST_GeomFromGML 함수와 동일합니다.
  • ST_GeomFromGML - 1.5 버전부터 사용할 수 있습니다. LibXML2 1.6 이상 버전이 필요합니다. 도형의 GML 표현식을 입력받아 PostGIS 도형 객체를 출력합니다.
  • ST_GeomFromKML - Availability: 1.5, requires libxml2 2.6+ 도형의 KML 표현식을 입력받아 PostGIS 도형 객체를 출력합니다.
  • ST_HausdorffDistance - 1.5.0 버전부터 사용할 수 있습니다. 두 도형 사이의 3차원 최단(shortest) 라인을 반환합니다.
  • ST_Intersection - Availability: 1.5 support for geography data type was introduced. Computes a geometry representing the shared portion of geometries A and B.
  • ST_Intersects - Availability: 1.5 support for geography was introduced. Tests if two geometries intersect (they have at least one point in common)
  • ST_Length - 1.5.0 버전부터 지리형을 지원합니다. 도형의 기하학적 중심을 반환합니다.
  • ST_LongestLine - 1.5.0 버전부터 사용할 수 있습니다. 두 도형 사이의 3차원 최장(longest) 라인을 반환합니다.
  • ST_MakeEnvelope - 1.5 버전부터 사용할 수 있습니다. 주어진 최소값과 최대값으로 형성된 직사각형 폴리곤을 생성합니다. 입력값이 SRID로 지정된 SRS를 가지고 있어야 합니다.
  • ST_MaxDistance - 1.5.0 버전부터 사용할 수 있습니다. 두 도형 사이의 2차원 최장 거리를 투영 단위로 반환합니다.
  • ST_ShortestLine - 1.5.0 버전부터 사용할 수 있습니다. 두 도형 사이의 2차원 최단 라인을 반환합니다.
  • ~= - 1.5.0 버전에서 습성이 변경됐습니다. A의 경계 상자와 B의 경계 상자가 동일할 경우 TRUE 를 반환합니다.

12.12.13. PostGIS Functions new or enhanced in 1.4

The functions given below are PostGIS functions that were added or enhanced.

Functions new in PostGIS 1.4

  • Populate_Geometry_Columns - 유효버전: 1.4.0 Ensures geometry columns are defined with type modifiers or have appropriate spatial constraints.
  • ST_Collect - 1.4.0 버전부터 사용할 수 있습니다. 이 버전부터 ST_MakeLine가 도형 배열을 입력받을 수 있습니다. 더 많은 포인트를 더 빨리 처리하기 위해 ST_MakeLine 합산 함수를 개선했습니다. Creates a GeometryCollection or Multi* geometry from a set of geometries.
  • ST_ContainsProperly - Availability: 1.4.0 Tests if every point of B lies in the interior of A
  • ST_GeoHash - 1.4.0 버전부터 사용할 수 있습니다. 도형의 GeoHash 표현식을 반환합니다.
  • ST_IsValidReason - Availability: 1.4 Returns text stating if a geometry is valid, or a reason for invalidity.
  • ST_LineCrossingDirection - Availability: 1.4 Returns a number indicating the crossing behavior of two LineStrings
  • ST_LocateBetweenElevations - 1.4.0 버전부터 사용할 수 있습니다. Returns the portions of a geometry that lie in an elevation (Z) range.
  • ST_MakeLine - 1.4.0 버전부터 사용할 수 있습니다. 이 버전부터 ST_MakeLine가 도형 배열을 입력받을 수 있습니다. 더 많은 포인트를 더 빨리 처리하기 위해 ST_MakeLine 합산 함수를 개선했습니다. 포인트, 멀티포인트 또는 라인 도형으로부터 라인스트링을 생성합니다.
  • ST_MinimumBoundingCircle - 유효버전: 1.4.0 Returns the smallest circle polygon that contains a geometry.
  • ST_Union - Availability: 1.4.0 - ST_Union was enhanced. ST_Union(geomarray) was introduced and also faster aggregate collection in PostgreSQL. Computes a geometry representing the point-set union of the input geometries.

12.12.14. PostGIS Functions new or enhanced in 1.3

The functions given below are PostGIS functions that were added or enhanced.

Functions new in PostGIS 1.3

  • ST_AsGML - 1.3.2 버전부터 사용할 수 있습니다. 도형을 GML 2 또는 GML 3 버전 요소로 반환합니다.
  • ST_AsGeoJSON - 1.3.4 버전부터 사용할 수 있습니다. Return a geometry as a GeoJSON element.
  • ST_CurveToLine - Availability: 1.3.0 Converts a geometry containing curves to a linear geometry.
  • ST_LineToCurve - Availability: 1.3.0 Converts a linear geometry to a curved geometry.
  • ST_SimplifyPreserveTopology - 1.3.3 버전부터 사용할 수 있습니다. Returns a simplified and valid version of a geometry, using the Douglas-Peucker algorithm.