PostGIS 3.5.0dev 사용자 지침서

DEV (Thu 21 Sep 2023 07:23:39 AM UTC rev. 4395b1f )

PostGIS 개발 그룹

Abstract

PostGIS는 객체 관계형 데이터베이스 시스템인 PostgreSQL 의 확장 프로그램으로, 데이터베이스에 GIS(지리정보 시스템) 객체를 저장할 수 있게 해줍니다. PostGIS는 GiST 기반 R-Tree 공간 인덱스를 지원하며, GIS 객체의 분석 및 공간 처리를 위한 기능을 포함하고 있습니다.

이 문서는 3.5.0dev 버전의 사용자 지침서입니다.

이 저작물은 크리에이티브 커먼즈 저작자표시-동일조건변경허락 3.0 라이선스를 따릅니다. 사용자가 원하는 대로 이 문서를 사용할 수 있지만, 우리는 사용자가 PostGIS 프로젝트의 저작권을 명시하고 가능한 위치에 https://postgis.net으로 연결되는 링크를 삽입하도록 요구합니다.


Table of Contents
1. 소개
1.1. 프로젝트 운영 위원회
1.2. 핵심 공헌자 - 현재
1.3. 핵심 공헌자 - 과거
1.4. 기타 공헌자
2. PostGIS 설치
2.1. 짧은 설명
2.2. 소스를 컴파일하고 설치하기
2.2.1. 소스 획득
2.2.2. 설치 요구사항
2.2.3. 설정
2.2.4. 빌드
2.2.5. PostGIS Extensions 빌드 및 배포
2.2.6. 테스트
2.2.7. 설치
2.3. 주소 표준화 도구 설치 및 활용
2.4. Installing, Upgrading Tiger Geocoder, and loading data
2.4.1. Tiger Geocoder Enabling your PostGIS database
2.4.2. 주소 표준화 도구를 TIGER 지오코딩 도구와 함께 사용
2.4.3. Required tools for tiger data loading
2.4.4. Upgrading your Tiger Geocoder Install and Data
2.5. 설치 과정에서 흔히 발생하는 문제들
3. PostGIS Administration
3.1. Performance Tuning
3.1.1. Startup
3.1.2. Runtime
3.2. Configuring raster support
3.3. 공간 데이터베이스 생성
3.3.1. Spatially enable database using EXTENSION
3.3.2. Spatially enable database without using EXTENSION (discouraged)
3.4. Upgrading spatial databases
3.4.1. Soft upgrade
3.4.2. Hard upgrade
4. Data Management
4.1. GIS (벡터) 데이터 로드
4.1.1. OGC Geometry
4.1.2. SQL-MM Part 3
4.1.3. OpenGIS WKB 및 WKT
4.2. Geometry Data Type
4.2.1. OpenGIS WKB 및 WKT
4.3. PostGIS 지리형 유형
4.3.1. 공간 테이블 생성
4.3.2. PostGIS 지리형 유형
4.3.3. 도형 데이터 유형과 지리형 데이터 유형을 중첩해서 이용하는 경우
4.3.4. 지리형 고급 FAQ
4.4. Geometry Validation
4.4.1. Simple Geometry
4.4.2. Valid Geometry
4.4.3. Managing Validity
4.5. SPATIAL_REF_SYS 테이블과 공간 참조 시스템
4.5.1. SPATIAL_REF_SYS Table
4.5.2. SPATIAL_REF_SYS 테이블과 공간 참조 시스템
4.6. 공간 테이블 생성
4.6.1. 공간 테이블 생성
4.6.2. The GEOMETRY_COLUMNS VIEW
4.6.3. geometry_columns에 도형 열을 직접 등록하기
4.7. GIS (벡터) 데이터 로드
4.7.1. SQL을 이용해 데이터 가져오기
4.7.2. shp2pgsql: ESRI shapefile 로더 이용하기
4.8. 공간 테이블 생성
4.8.1. SQL을 이용해 데이터 가져오기
4.8.2. 덤퍼 이용하기
4.9. 인덱스 빌드 작업
4.9.1. GiST 인덱스
4.9.2. GiST 인덱스
4.9.3. GiST 인덱스
4.9.4. 인덱스 빌드 작업
5. Spatial Queries
5.1. Determining Spatial Relationships
5.1.1. Dimensionally Extended 9-Intersection Model
5.1.2. Named Spatial Relationships
5.1.3. General Spatial Relationships
5.2. Using Spatial Indexes
5.3. Examples of Spatial SQL
6. 성능 향상 비법
6.1. 대용량 도형을 담은 저용량 테이블
6.1.1. 문제점 설명
6.1.2. 해결 방법
6.2. 도형 인덱스에 대한 클러스터 작업
6.3. 차원 변환 피하기
7. PostGIS Reference
7.1. PostgreSQL PostGIS Geometry/Geography/Box 유형
box2d — The type representing a 2-dimensional bounding box.
box3d — The type representing a 3-dimensional bounding box.
geometry — geography는 지구곡면 좌표계에서 피처를 표현하는데 사용되는 공간 데이터 타입입니다.
geometry_dump — A composite type used to describe the parts of complex geometry.
geography — The type representing spatial features with geodetic (ellipsoidal) coordinate systems.
7.2. 관리 함수
AddGeometryColumn — 공간 테이블에서 지오메트리 컬럼을 제거합니다.
DropGeometryColumn — 공간 테이블에서 지오메트리 컬럼을 제거합니다.
DropGeometryTable — 테이블 및 geometry_columns의 모든 참조를 삭제합니다.
Find_SRID — Returns the SRID defined for a geometry column.
Populate_Geometry_Columns — Ensures geometry columns are defined with type modifiers or have appropriate spatial constraints.
UpdateGeometrySRID — Updates the SRID of all features in a geometry column, and the table metadata.
7.3. 도형 작성자(constructor)
ST_Collect — Creates a GeometryCollection or Multi* geometry from a set of geometries.
ST_LineFromMultiPoint — 멀티포인트 도형으로부터 라인스트링을 생성합니다.
ST_MakeEnvelope — 주어진 최소값과 최대값으로 형성된 직사각형 폴리곤을 생성합니다. 입력값이 SRID로 지정된 SRS를 가지고 있어야 합니다.
ST_MakeLine — 포인트, 멀티포인트 또는 라인 도형으로부터 라인스트링을 생성합니다.
ST_MakePoint — Creates a 2D, 3DZ or 4D Point.
ST_MakePointM — x, y 좌표 및 단위를 가진 포인트를 생성합니다.
ST_MakePolygon — Creates a Polygon from a shell and optional list of holes.
ST_Point — Creates a Point with X, Y and SRID values.
ST_PointZ — Creates a Point with X, Y, Z and SRID values.
ST_PointM — Creates a Point with X, Y, M and SRID values.
ST_PointZM — Creates a Point with X, Y, Z, M and SRID values.
ST_Polygon — Creates a Polygon from a LineString with a specified SRID.
ST_TileEnvelope — Creates a rectangular Polygon in Web Mercator (SRID:3857) using the XYZ tile system.
ST_HexagonGrid — Returns a set of hexagons and cell indices that completely cover the bounds of the geometry argument.
ST_Hexagon — Returns a single hexagon, using the provided edge size and cell coordinate within the hexagon grid space.
ST_SquareGrid — Returns a set of grid squares and cell indices that completely cover the bounds of the geometry argument.
ST_Square — Returns a single square, using the provided edge size and cell coordinate within the square grid space.
ST_Letters — Returns the input letters rendered as geometry with a default start position at the origin and default text height of 100.
7.4. 도형 접근자(accessor)
GeometryType — ST_Geometry 값의 도형 유형을 반환합니다.
ST_Boundary — 해당 도형의 결합된 범위의 닫힘 여부를 반환합니다.
ST_BoundingDiagonal — 주어진 도형의 경계 상자의 대각선을 반환합니다.
ST_CoordDim — ST_Geometry 값의 좌표 차원을 반환합니다.
ST_Dimension — ST_Geometry 값의 좌표 차원을 반환합니다.
ST_Dump — Returns a set of geometry_dump rows for the components of a geometry.
ST_DumpPoints — 도형의 내용을 요약한 텍스트를 반환합니다.
ST_DumpSegments — 도형의 내용을 요약한 텍스트를 반환합니다.
ST_DumpRings — Returns a set of geometry_dump rows for the exterior and interior rings of a Polygon.
ST_EndPoint — ST_LineString 또는 ST_CircularString 값에 있는 포인트의 개수를 반환합니다.
ST_Envelope — 주어진 도형의 이중 정밀도(double precision; float8) 경계 상자를 표현하는 도형을 반환합니다.
ST_ExteriorRing — 폴리곤 도형의 내곽 고리의 개수를 반환합니다.
ST_GeometryN — ST_Geometry 값의 도형 유형을 반환합니다.
ST_GeometryType — ST_Geometry 값의 도형 유형을 반환합니다.
ST_HasArc — Tests if a geometry contains a circular arc
ST_InteriorRingN — 폴리곤 도형의 내곽 고리의 개수를 반환합니다.
ST_IsClosedLINESTRING 의 시작점과 종단점이 일치하는 경우 TRUE 를 반환합니다. 다면체 표면이 닫혀 (부피를 가지고) 있는 경우 TRUE 를 반환합니다.
ST_IsCollection — 해당 도형이 텅 빈 도형 집합, 폴리곤, 포인트 등인 경우 TRUE 를 반환합니다.
ST_IsEmpty — Tests if a geometry is empty.
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_IsRing — Tests if a LineString is closed and simple.
ST_IsSimple — 해당 도형이 자체 교차하거나 자체 접촉하는 이례적인 도형 포인트를 가지고 있지 않을 경우 TRUE 를 반환합니다.
ST_M — Returns the M coordinate of a Point.
ST_MemSize — ST_Geometry 값의 도형 유형을 반환합니다.
ST_NDims — ST_Geometry 값의 좌표 차원을 반환합니다.
ST_NPoints — 도형이 가지고 있는 포인트(꼭짓점)의 개수를 반환합니다.
ST_NRings — 폴리곤 도형의 내곽 고리의 개수를 반환합니다.
ST_NumGeometries — 도형이 가지고 있는 포인트의 개수를 반환합니다. 모든 도형을 입력받을 수 있습니다.
ST_NumInteriorRings — 폴리곤 도형의 내곽 고리의 개수를 반환합니다.
ST_NumInteriorRing — 도형 안에 있는 폴리곤의 내곽 고리의 개수를 반환합니다. ST_NumInteriorRings 함수와 동일합니다.
ST_NumPatches — 다면체 표면 상에 있는 면의 개수를 반환합니다. 다면체 도형이 아닌 경우 NULL을 반환할 것입니다.
ST_NumPoints — ST_LineString 또는 ST_CircularString 값에 있는 포인트의 개수를 반환합니다.
ST_PatchN — ST_Geometry 값의 도형 유형을 반환합니다.
ST_PointN — ST_LineString 또는 ST_CircularString 값에 있는 포인트의 개수를 반환합니다.
ST_Points — 도형의 모든 좌표들을 담고 있는 멀티포인트를 반환합니다.
ST_StartPoint — Returns the first point of a LineString.
ST_Summary — 도형의 내용을 요약한 텍스트를 반환합니다.
ST_X — Returns the X coordinate of a Point.
ST_Y — Returns the Y coordinate of a Point.
ST_Z — Returns the Z coordinate of a Point.
ST_Zmflag — ST_Geometry 값의 좌표 차원을 반환합니다.
7.5. 도형 편집자(editor)
ST_AddPoint — 라인스트링에 포인트를 추가합니다.
ST_CollectionExtract — Given a geometry collection, returns a multi-geometry containing only elements of a specified type.
ST_CollectionHomogenize — Returns the simplest representation of a geometry collection.
ST_CurveToLine — Converts a geometry containing curves to a linear geometry.
ST_Scroll — Change start point of a closed LineString.
ST_FlipCoordinates — Returns a version of a geometry with X and Y axis flipped.
ST_Force2D — 도형을 "2차원 모드"로 강제합니다.
ST_Force3D — 도형을 XYZ 모드로 강제합니다. ST_Force3DZ라고도 합니다.
ST_Force3DZ — 도형을 XYZ 모드로 강제합니다.
ST_Force3DM — 도형을 XYM 모드로 강제합니다.
ST_Force4D — 도형을 XYZM 모드로 강제합니다.
ST_ForcePolygonCCW — Orients all exterior rings counter-clockwise and all interior rings clockwise.
ST_ForceCollection — 도형을 도형 집합으로 변환합니다.
ST_ForcePolygonCW — Orients all exterior rings clockwise and all interior rings counter-clockwise.
ST_ForceSFS — 도형이 SFS 1.1 도형 유형만을 쓰도록 강제합니다.
ST_ForceRHR — 폴리곤 안에 있는 꼭짓점들의 방향(orientation)이 오른손 법칙(Right-Hand Rule)을 따르도록 강제합니다.
ST_ForceCurve — 적용이 가능한 경우, 도형을 해당 도형의 만곡 유형으로 상위 형변환(upcast)합니다.
ST_LineToCurve — Converts a linear geometry to a curved geometry.
ST_Multi — 도형을 멀티 유형 도형으로 반환합니다.
ST_LineExtend — Returns a line with the last and first segments extended the specified distance(s).
ST_Normalize — 도형을 해당 도형의 기본형으로 반환합니다.
ST_Project — Returns a point projected from a start point by a distance and bearing (azimuth).
ST_QuantizeCoordinates — Sets least significant bits of coordinates to zero
ST_RemovePoint — Remove a point from a linestring.
ST_RemoveRepeatedPoints — Returns a version of a geometry with duplicate points removed.
ST_Reverse — 꼭짓점들의 순서가 반대인 도형을 반환합니다.
ST_Segmentize — Returns a modified geometry/geography having no segment longer than a given distance.
ST_SetPoint — 라인스트링의 포인트를 주어진 포인트로 대체합니다.
ST_ShiftLongitude — Shifts the longitude coordinates of a geometry between -180..180 and 0..360.
ST_WrapX — X값 근처에서 도형을 래핑합니다.
ST_SnapToGrid — 입력 도형의 모든 포인트를 정규 그리드로 스냅(snap)시킵니다.
ST_Snap — 입력 도형의 분절 구간과 꼭짓점을 참조 도형의 꼭짓점으로 스냅시킵니다.
ST_SwapOrdinates — 입력 도형을 좌표값을 뒤바꾼 상태로 반환합니다.
7.6. Geometry Validation
ST_IsValid — Tests if a geometry is well-formed in 2D.
ST_IsValidDetail — Returns a valid_detail row stating if a geometry is valid or if not a reason and a location.
ST_IsValidReason — Returns text stating if a geometry is valid, or a reason for invalidity.
ST_MakeValid — Attempts to make an invalid geometry valid without losing vertices.
7.7. Spatial Reference System Functions
ST_InverseTransformPipeline — Return a new geometry with coordinates transformed to a different spatial reference system using the inverse of a defined coordinate transformation pipeline.
ST_SetSRID — Set the SRID on a geometry.
ST_SRID — Returns the spatial reference identifier for a geometry.
ST_Transform — Return a new geometry with coordinates transformed to a different spatial reference system.
ST_TransformPipeline — Return a new geometry with coordinates transformed to a different spatial reference system using a defined coordinate transformation pipeline.
postgis_srs_codes — Return the list of SRS codes associated with the given authority.
postgis_srs — Return a metadata record for the requested authority and srid.
postgis_srs_all — Return metadata records for every spatial reference system in the underlying Proj database.
postgis_srs_search — Return metadata records for projected coordinate systems that have areas of useage that fully contain the bounds parameter.
7.8. Geometry Input
7.8.1. Well-Known Text (WKT)
7.8.2. Well-Known Binary (WKB)
7.8.3. Other Formats
7.9. Geometry Output
7.9.1. Well-Known Text (WKT)
7.9.2. Well-Known Binary (WKB)
7.9.3. Other Formats
7.10. 연산자(operator)
7.10.1. Bounding Box Operators
7.10.2. 연산자(operator)
7.11. Spatial Relationships
7.11.1. Topological Relationships
7.11.2. Distance Relationships
7.12. Measurement Functions
ST_Area — 도형의 기하학적 중심을 반환합니다.
ST_Azimuth — 두 도형 사이의 2차원 최단 라인을 반환합니다.
ST_Angle — 두 도형 사이의 3차원 최장(longest) 라인을 반환합니다.
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_3DClosestPoint — g2에 가장 가까운 g1 상에 있는 3차원 포인트를 반환합니다. 해당 포인트는 3D 최단 라인의 첫 번째 포인트입니다.
ST_Distance — 두 도형 사이의 3차원 최장(longest) 라인을 반환합니다.
ST_3DDistance — 도형 유형에 대해, 두 도형 사이의 (SRS에 기반한) 3차원 데카르트 최단 거리를 투영 단위로 반환합니다.
ST_DistanceSphere — 특정 회전타원체가 주어진 두 경위도 도형 사이의 최단 거리를 반환합니다. PostGIS 1.5 미만 버전은 포인트만 지원했습니다.
ST_DistanceSpheroid — 특정 회전타원체가 주어진 두 경위도 도형 사이의 최단 거리를 반환합니다. PostGIS 1.5 미만 버전은 포인트만 지원했습니다.
ST_FrechetDistance — 두 도형 사이의 3차원 최단(shortest) 라인을 반환합니다.
ST_HausdorffDistance — 두 도형 사이의 3차원 최단(shortest) 라인을 반환합니다.
ST_Length — 도형의 기하학적 중심을 반환합니다.
ST_Length2D — 도형이 라인스트링 또는 멀티라인스트링일 경우 도형의 2차원 길이를 반환합니다. 이 함수는 ST_Length 와 동일합니다.
ST_3DLength — 도형의 기하학적 중심을 반환합니다.
ST_LengthSpheroid — 도형의 기하학적 중심을 반환합니다.
ST_LongestLine — 두 도형 사이의 3차원 최장(longest) 라인을 반환합니다.
ST_3DLongestLine — 두 도형 사이의 3차원 최장(longest) 라인을 반환합니다.
ST_MaxDistance — 두 도형 사이의 2차원 최장 거리를 투영 단위로 반환합니다.
ST_3DMaxDistance — 도형 유형에 대해, 두 도형 사이의 (SRS에 기반한) 3차원 데카르트 최장 거리를 투영 단위로 반환합니다.
ST_MinimumClearance — 도형의 튼튼함(robustness)의 척도인 도형의 최소 여유(clearance)를 반환합니다.
ST_MinimumClearanceLine — 포인트 2개로 이루어진, 도형의 최소 여유를 나타내는 라인스트링을 반환합니다.
ST_Perimeter — Returns the length of the boundary of a polygonal geometry or geography.
ST_Perimeter2D — Returns the 2D perimeter of a polygonal geometry. Alias for ST_Perimeter.
ST_3DPerimeter — 도형의 기하학적 중심을 반환합니다.
ST_ShortestLine — 두 도형 사이의 2차원 최단 라인을 반환합니다.
ST_3DShortestLine — 두 도형 사이의 3차원 최단(shortest) 라인을 반환합니다.
7.13. Overlay Functions
ST_ClipByBox2D — Computes the portion of a geometry falling within a rectangle.
ST_Difference — Computes a geometry representing the part of geometry A that does not intersect geometry B.
ST_Intersection — Computes a geometry representing the shared portion of geometries A and B.
ST_MemUnion — Aggregate function which unions geometries in a memory-efficent but slower way
ST_Node — Nodes a collection of lines.
ST_Split — Returns a collection of geometries created by splitting a geometry by another geometry.
ST_Subdivide — Computes a rectilinear subdivision of a geometry.
ST_SymDifference — Computes a geometry representing the portions of geometries A and B that do not intersect.
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.
7.14. 도형 공간 처리
ST_Buffer — Computes a geometry covering all points within a given distance from a geometry.
ST_BuildArea — Creates a polygonal geometry formed by the linework of a geometry.
ST_Centroid — 도형의 기하학적 중심을 반환합니다.
ST_ChaikinSmoothing — Returns a smoothed version of a geometry, using the Chaikin algorithm
ST_ConcaveHull — Computes a possibly concave geometry that contains all input geometry vertices
ST_ConvexHull — Computes the convex hull of a geometry.
ST_DelaunayTriangles — Returns the Delaunay triangulation of the vertices of a geometry.
ST_FilterByM — Removes vertices based on their M value
ST_GeneratePoints — Generates a multipoint of random points contained in a Polygon or MultiPolygon.
ST_GeometricMedian — 멀티 포인트의 기하학적 중심값(median)을 반환합니다.
ST_LineMerge — Return the lines formed by sewing together a MultiLineString.
ST_MaximumInscribedCircle — 도형의 기하학적 중심을 반환합니다.
ST_LargestEmptyCircle — Computes the largest circle not overlapping a geometry.
ST_MinimumBoundingCircle — Returns the smallest circle polygon that contains a geometry.
ST_MinimumBoundingRadius — Returns the center point and radius of the smallest circle that contains a geometry.
ST_OrientedEnvelope — Returns a minimum-area rectangle containing a geometry.
ST_OffsetCurve — Returns an offset line at a given distance and side from an input line.
ST_PointOnSurface — Computes a point guaranteed to lie in a polygon, or on a geometry.
ST_Polygonize — Computes a collection of polygons formed from the linework of a set of geometries.
ST_ReducePrecision — Returns a valid geometry with points rounded to a grid tolerance.
ST_SharedPaths — 두 입력 라인스트링/멀티라인스트링이 공유하는 경로를 담고 있는 집합을 반환합니다.
ST_Simplify — Returns a simplified version of a geometry, using the Douglas-Peucker algorithm.
ST_SimplifyPreserveTopology — Returns a simplified and valid version of a geometry, using the Douglas-Peucker algorithm.
ST_SimplifyPolygonHull — Computes a simplifed topology-preserving outer or inner hull of a polygonal geometry.
ST_SimplifyVW — Returns a simplified version of a geometry, using the Visvalingam-Whyatt algorithm
ST_SetEffectiveArea — Sets the effective area for each vertex, using the Visvalingam-Whyatt algorithm.
ST_TriangulatePolygon — Computes the constrained Delaunay triangulation of polygons
ST_VoronoiLines — Returns the boundaries of the Voronoi diagram of the vertices of a geometry.
ST_VoronoiPolygons — Returns the cells of the Voronoi diagram of the vertices of a geometry.
7.15. Coverages
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.
ST_CoverageUnion — Computes the union of a set of polygons forming a coverage by removing shared edges.
7.16. Affine Transformations
ST_Affine — Apply a 3D affine transformation to a geometry.
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_Translate — Translates a geometry by given offsets.
ST_TransScale — Translates and scales a geometry by given offsets and factors.
7.17. Clustering Functions
ST_ClusterDBSCAN — Window function that returns a cluster id for each input geometry using the DBSCAN algorithm.
ST_ClusterIntersecting — Aggregate function that clusters input geometries into connected sets.
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_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.
7.18. Bounding Box Functions
Box2D — Returns a BOX2D representing the 2D extent of a geometry.
Box3D — Returns a BOX3D representing the 3D extent of a geometry.
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_3DExtent — Aggregate function that returns the 3D bounding box of geometries.
ST_MakeBox2D — Creates a BOX2D defined by two 2D point geometries.
ST_3DMakeBox — Creates a BOX3D defined by two 3D 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.
7.19. 선형 참조(Linear Referencing)
ST_LineInterpolatePoint — Returns a point interpolated along a line at a fractional location.
ST_3DLineInterpolatePoint — Returns a point interpolated along a 3D 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_LocateAlong — Returns the point(s) on a geometry that match a measure value.
ST_LocateBetween — Returns the portions of a geometry that match a measure range.
ST_LocateBetweenElevations — Returns the portions of a geometry that lie in an elevation (Z) range.
ST_InterpolatePoint — 입력 포인트에 가까운 포인트에서 도형의 척도 차원(M 차원)의 값을 반환합니다.
ST_AddMeasure — Interpolates measures along a linear geometry.
7.20. Trajectory Functions
ST_IsValidTrajectory — Tests if the geometry is a valid trajectory.
ST_ClosestPointOfApproach — Returns a measure at the closest point of approach of two trajectories.
ST_DistanceCPA — Returns the distance between the closest point of approach of two trajectories.
ST_CPAWithin — Tests if the closest point of approach of two trajectories is within the specified distance.
7.21. SFCGAL 함수
postgis_sfcgal_version — 실행중인 SFCGAL의 버전을 반환합니다.
postgis_sfcgal_full_version — Returns the full version of SFCGAL in use including CGAL and Boost versions
ST_3DArea — 3차원 표면 도형의 면적을 계산합니다. 입체일 경우 0을 반환할 것입니다.
ST_3DConvexHull — 면 도형의 근사 중심축을 계산합니다.
ST_3DIntersection — 3차원 교차를 수행합니다.
ST_3DDifference — 3차원 차이를 수행합니다.
ST_3DUnion — Perform 3D union.
ST_AlphaShape — Computes an Alpha-shape enclosing a geometry
ST_ApproximateMedialAxis — 면 도형의 근사 중심축을 계산합니다.
ST_ConstrainedDelaunayTriangles — Return a constrained Delaunay triangulation around the given input geometry.
ST_Extrude — 표면을 관련 입체로 돌출시킵니다.
ST_ForceLHR — LHR(Left Hand Reverse; 시계 방향) 방향을 강제합니다.
ST_IsPlanar — 표면이 평면인지 아닌지 확인합니다.
ST_IsSolid — 도형이 입체인지 테스트합니다. 어떤 유효성 검사도 수행하지 않습니다.
ST_MakeSolid — 도형을 입체로 지정합니다. 어떤 확인 작업도 수행하지 않습니다. 유효한 입체를 얻으려면, 입력 도형이 닫힌 다면체 표면 또는 닫힌 TIN이어야만 합니다.
ST_MinkowskiSum — 민코프스키 합계를 수행합니다.
ST_OptimalAlphaShape — Computes an Alpha-shape enclosing a geometry using an "optimal" alpha value.
ST_Orientation — 표면의 방향(orientation)을 결정합니다.
ST_StraightSkeleton — 도형으로부터 직선 골격(straight skeleton)을 계산합니다.
ST_Tesselate — 폴리곤 또는 다면체 표면의 표면 다듬기(tesselation) 작업을 수행한 다음 TIN 또는 TIN 집합으로 반환합니다.
ST_Volume — 3차원 입체의 부피를 계산합니다. 표면 도형을 입력하면 (닫힌 도형일지라도) 0을 반환할 것입니다.
7.22. 장기 실행 트랜잭션(Long Transaction) 지원
AddAuth — 현재 트랜잭션에 이용될 승인 토큰을 추가합니다.
CheckAuth — 승인 토큰을 바탕으로, 테이블에 대해 행들의 업데이트 및 삭제를 금지/허락하는 트리거를 생성합니다.
DisableLongTransactions — DisableLongTransactions
EnableLongTransactions — EnableLongTransactions
LockRow — 테이블 내부의 특정 행에 대한 잠금/승인을 설정합니다.
UnlockRows — Removes all locks held by an authorization token.
7.23. Version Functions
PostGIS_Extensions_Upgrade — Packages and upgrades PostGIS extensions (e.g. postgis_raster, postgis_topology, postgis_sfcgal) to given or latest version.
PostGIS_Full_Version — Reports full PostGIS version and build configuration infos.
PostGIS_GEOS_Version — Returns the version number of the GEOS library.
PostGIS_GEOS_Compiled_Version — Returns the version number of the GEOS library against which PostGIS was built.
PostGIS_Liblwgeom_Version — Returns the version number of the liblwgeom library. This should match the version of PostGIS.
PostGIS_LibXML_Version — Returns the version number of the libxml2 library.
PostGIS_Lib_Build_Date — Returns build date of the PostGIS library.
PostGIS_Lib_Version — Returns the version number of the PostGIS library.
PostGIS_PROJ_Version — Returns the version number of the PROJ4 library.
PostGIS_Wagyu_Version — Returns the version number of the internal Wagyu library.
PostGIS_Scripts_Build_Date — Returns build date of the PostGIS scripts.
PostGIS_Scripts_Installed — Returns version of the PostGIS scripts installed in this database.
PostGIS_Scripts_Released — Returns the version number of the postgis.sql script released with the installed PostGIS lib.
PostGIS_Version — Returns PostGIS version number and compile-time options.
7.24. PostGIS GUC(Grand Unified Custom Variable)
postgis.backend — GEOS와 SFCGAL 양쪽의 겹치는 함수를 서비스하는 백엔드입니다. geos 또는 sfcgal을 선택할 수 있는데, 기본값은 geos입니다.
postgis.gdal_datapath — GDAL의 GDAL_DATA 옵션의 값을 할당하는 설정 옵션입니다. 설정하지 않을 경우, 환경적으로 설정된 GDAL_DATA 변수를 사용합니다.
postgis.gdal_enabled_drivers — PostGIS 환경에서 사용할 수 있는 GDAL 드라이버를 설정하는 설정 옵션입니다. GDAL 설정 변수 GDAL_SKIP에 영향을 미칩니다.
postgis.enable_outdb_rasters — DB 외부 래스터 밴드에 접근할 수 있게 해주는 불 설정 옵션입니다.
postgis.gdal_config_options — DB 외부 래스터 밴드에 접근할 수 있게 해주는 불 설정 옵션입니다.
7.25. Troubleshooting Functions
PostGIS_AddBBox — 도형에 경계 상자를 추가합니다.
PostGIS_DropBBox — 도형으로부터 경계 상자 캐시를 삭제합니다.
PostGIS_HasBBox — 해당 도형의 경계 상자가 캐시화된 경우 참을 반환하고, 그렇지 않을 경우 거짓을 반환합니다.
8. 지형(topology)
8.1. 지형 유형
getfaceedges_returntype — A composite type that consists of a sequence number and an edge number.
TopoGeometry — A composite type representing a topologically defined geometry.
validatetopology_returntype — A composite type that consists of an error message and id1 and id2 to denote location of error. This is the return type for ValidateTopology.
8.2. 지형 도메인
TopoElement — 일반적으로 TopoGeometry 구성 요소를 식별하는 데 쓰이는 정수형 2개의 배열입니다.
TopoElementArray — An array of TopoElement objects.
8.3. 지형 및 TopoGeometry 관리
AddTopoGeometryColumn — 기존 테이블에 TopoGeometry 열을 추가하고, topology.layer에 이 새 열을 레이어로 추가하며, 새 layer_id를 반환합니다.
RenameTopoGeometryColumn — Renames a topogeometry column
DropTopology — 이용에 주의하십시오: 지형 스키마를 삭제하고 topology.topology 테이블에서 해당 참조를, 그리고 geometry_columns 테이블에서 해당 스키마에 있는 테이블의 참조를 삭제합니다.
RenameTopology — Renames a topology
DropTopoGeometryColumnschema_name 스키마 안의 table_name 명칭의 테이블에서 Topogeometry 열을 삭제하고 topology.layer 테이블에서 해당 열을 등록 해제합니다.
Populate_Topology_Layer — Adds missing entries to topology.layer table by reading metadata from topo tables.
TopologySummary — Takes a topology name and provides summary totals of types of objects in topology.
ValidateTopology — Returns a set of validatetopology_returntype objects detailing issues with topology.
ValidateTopologyRelation — Returns info about invalid topology relation records
FindTopology — Returns a topology record by different means.
FindLayer — Returns a topology.layer record by different means.
8.4. Topology Statistics Management
8.5. 지형 작성자
CreateTopology — Creates a new topology schema and registers it in the topology.topology table.
CopyTopology — Makes a copy of a topology (nodes, edges, faces, layers and TopoGeometries) into a new schema
ST_InitTopoGeo — Creates a new topology schema and registers it in the topology.topology table.
ST_CreateTopoGeo — 텅 빈 입력 지형에 도형들의 집합을 추가한 다음 작업 성공 여부를 상세하게 설명하는 메시지를 반환합니다.
TopoGeo_AddPoint — 허용 오차를 이용해서 그리고 기존 경계선을 분할(split)하기도 해서 기존 지형에 포인트를 추가합니다.
TopoGeo_AddLineString — Adds a linestring to an existing topology using a tolerance and possibly splitting existing edges/faces. Returns edge identifiers.
TopoGeo_AddPolygon — Adds a polygon to an existing topology using a tolerance and possibly splitting existing edges/faces. Returns face identifiers.
8.6. 지형 편집자
ST_AddIsoNode — 지형 안의 표면에 고립된(isolated) 노드를 추가하고 새 노드의 ID를 반환합니다. 표면이 NULL일 경우, 그래도 노드를 생성합니다.
ST_AddIsoEdge — 지형에 두 개의 고립된 기존 노드 anodeanothernode 를 연결하는 alinestring 도형이 정의하는 고립된 경계선을 추가하고 새 경계선의 ID를 반환합니다.
ST_AddEdgeNewFaces — 새 경계선을 추가하고, 그 과정에서 경계선이 표면을 분할할 경우, 원본 표면을 삭제하고 새 표면 2개로 교체합니다.
ST_AddEdgeModFace — 새 경계선을 추가하고, 그 과정에서 경계선이 표면을 분할할 경우, 원본 표면을 수정하고 새 표면을 추가합니다.
ST_RemEdgeNewFace — 경계선을 제거하고, 제거한 경계선이 두 표면을 분할하고 있을 경우, 원본 표면들을 삭제하고 새 표면 하나로 대체합니다.
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.
ST_ChangeEdgeGeom — 지형 구조를 건드리는 일 없이 경계선의 형상을 변경합니다.
ST_ModEdgeSplit — 기존 경계선을 따라 새 노드를 추가한 다음, 원본 경계선을 수정하고 새 경계선을 추가해서 경계선을 분할합니다.
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.
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.
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.
ST_NewEdgesSplit — 기존 경계선을 따라 새 노드를 추가한 다음, 원본 경계선을 삭제하고 새 경계선 2개로 교체해서 경계선을 분할합니다. 새 경계선들을 결합하는 새로 생성된 노드의 ID를 반환합니다.
ST_RemoveIsoNode — 고립된 노드를 제거하고 작업 내용을 설명하는 메시지를 반환합니다. 노드가 고립되지 않은 (경계선의 시작점이나 종단점인) 경우, 예외가 발생합니다.
ST_RemoveIsoEdge — Removes an isolated edge and returns description of action. If the edge is not isolated, then an exception is thrown.
8.7. 지형 접근자
GetEdgeByPoint — Finds the edge-id of an edge that intersects a given point.
GetFaceByPoint — Finds face intersecting a given point.
GetFaceContainingPoint — Finds the face containing a point.
GetNodeByPoint — Finds the node-id of a node at a point location.
GetTopologyID — 지형의 명칭을 입력받아 topology.topology 테이블에 있는 지형의 ID를 반환합니다.
GetTopologySRID — 지형의 명칭을 입력받아 topology.topology 테이블에 있는 지형의 SRID를 반환합니다.
GetTopologyName — 지형의 ID를 입력받아 지형(스키마)의 명칭을 반환합니다.
ST_GetFaceEdgesaface 의 경계를 이루는 정렬된 경계선들의 집합을 반환합니다.
ST_GetFaceGeometry — 입력 지형으로부터 설정된 표면 ID를 가진 폴리곤을 반환합니다.
GetRingEdges — 입력 경계선 쪽을 따라 탐색한 부호가 있는 경계선 식별자들의 정렬된 집합을 반환합니다.
GetNodeEdges — 입력 노드를 따르는 경계선들의 정렬된 집합을 반환합니다.
8.8. 지형 공간 처리
Polygonize — Finds and registers all faces defined by topology edges.
AddNode — 설정한 지형 스키마의 노드 테이블에 포인트 노드를 추가하고 새 노드의 노드 ID(nodeid)를 반환합니다. 새 포인트 위치에 이미 노드가 존재할 경우, 기존 노드 ID를 반환합니다.
AddEdge — 설정한 지형 스키마의 경계선 테이블에 라인스트링 경계선을 추가하고, 설정한 라인스트링 도형을 이용해서 포인트 노드 테이블에 경계선의 시작점 및 종단점을 추가한 다음 새 (또는 기존) 경계선의 경계선 ID(edgeid)를 반환합니다.
AddFace — 지형에 표면 원시형(face primitive)을 등록하고 그 식별자를 반환합니다.
ST_Simplify — 더글러스-패커(Douglas-Peucker) 알고리즘을 통해 입력 TopoGeometry 의 "단순화된" 도형 버전을 반환합니다.
RemoveUnusedPrimitives — Removes topology primitives which not needed to define existing TopoGeometry objects.
8.9. TopoGeometry 작성자
CreateTopoGeom — 지형 요소 배열로부터 새 지형 도형 객체를 생성합니다. tg_type은 1: [멀티]포인트, 2: [멀티]라인, 3: [멀티]폴리곤, 4: 도형 집합입니다.
toTopoGeom — Converts a simple Geometry into a topo geometry.
TopoElementArray_Agg — Returns a topoelementarray for a set of element_id, type arrays (topoelements).
TopoElement — Converts a topogeometry to a topoelement.
8.10. TopoGeometry 편집자
clearTopoGeom — Clears the content of a topo geometry.
TopoGeom_addElement — Adds an element to the definition of a TopoGeometry.
TopoGeom_remElement — Removes an element from the definition of a TopoGeometry.
TopoGeom_addTopoGeom — Adds element of a TopoGeometry to the definition of another TopoGeometry.
toTopoGeom — Adds a geometry shape to an existing topo geometry.
8.11. TopoGeometry 접근자
GetTopoGeomElementArray — Returns a topoelementarray (an array of topoelements) containing the topological elements and type of the given TopoGeometry (primitive elements).
GetTopoGeomElements — Returns a set of topoelement objects containing the topological element_id,element_type of the given TopoGeometry (primitive elements).
ST_SRID — Returns the spatial reference identifier for a topogeometry.
8.12. TopoGeometry 출력물
AsGML — TopoGeometry의 GML 표현식을 반환합니다.
AsTopoJSON — TopoGeometry의 TopoJSON 표현식을 반환합니다.
8.13. 지형 공간 관계성
Equals — 두 TopoGeometry가 동일한 지형 원시형으로 이루어졌을 경우 참을 반환합니다.
Intersects — 두 TopoGeometry에서 나온 원시형의 쌍 가운데 하나라도 교차할 경우 참을 반환합니다.
8.14. Importing and exporting Topologies
8.14.1. Using the Topology exporter
8.14.2. Using the Topology importer
9. 래스터 데이터의 관리, 쿼리 및 응용
9.1. 래스터 로드 및 생성
9.1.1. raster2pgsql을 이용해 래스터를 로드하기
9.1.2. PostGIS 래스터 함수를 이용해 래스터 생성하기
9.1.3. Using "out db" cloud rasters
9.2. 래스터 카탈로그
9.2.1. 래스터 열 카탈로그
9.2.2. 래스터 오버뷰
9.3. PostGIS 래스터를 이용하는 사용자 지정 응용 프로그램 빌드하기
9.3.1. 다른 래스터 함수와 함께 ST_AsPNG를 이용해서 PHP 예제를 출력하기
9.3.2. 다른 래스터 함수와 함께 ST_AsPNG를 이용해서 ASP.NET C# 예제를 출력하기
9.3.3. 래스터 쿼리를 이미지 파일로 출력하는 Java 콘솔 응용 프로그램
9.3.4. PLPython을 이용해서 SQL을 통해 이미지를 덤프하기
9.3.5. PSQL을 이용해서 래스터 출력하기
10. 래스트 참조문서
10.1. 래스터 지원 데이터형
geomval — (도형 객체를 담고 있는) geom과 (래스터 밴드의 이중 정밀도 픽셀값을 담고 있는) val, 두 개의 필드를 가진 공간 데이터형입니다.
addbandarg — 새로운 밴드의 속성 및 초기값을 정의하는 ST_AddBand 함수의 입력물로 이용되는 복합 데이터형입니다.
rastbandarg — 래스터 및 해당 래스터의 밴드 인덱스를 표현해야 할 경우 쓰이는 복합 데이터형입니다.
raster — 래스터 공간 데이터형입니다.
reclassarg — 재분류 작업의 습성을 정의하는 ST_Reclass 함수의 입력물로 쓰이는 복합 데이터형입니다.
summarystats — ST_SummaryStats 및 ST_SummaryStatsAgg 함수가 반환하는 복합 데이터형입니다.
unionarg — 공간 처리할 밴드들 및 UNION 연산의 습성을 정의하는 ST_Union 함수의 입력물로 쓰이는 복합 데이터형입니다.
10.2. 래스터 관리
AddRasterConstraints — Adds raster constraints to a loaded raster table for a specific column that constrains spatial ref, scaling, blocksize, alignment, bands, band type and a flag to denote if raster column is regularly blocked. The table must be loaded with data for the constraints to be inferred. Returns true if the constraint setting was accomplished and issues a notice otherwise.
DropRasterConstraints — 래스터 테이블 열을 참조하는 PostGIS 래스터 제약조건을 삭제합니다. 데이터를 다시 로드하거나 사용자 래스터 열 데이터를 업데이트해야 할 경우 유용합니다.
AddOverviewConstraints — 래스터 열을 또 다른 래스터 열의 미리보기(overview)로 태그합니다.
DropOverviewConstraints — 또 다른 래스터 열의 미리보기(overview)로서의 래스터 열을 태그 해제합니다.
PostGIS_GDAL_Version — PostGIS가 이용하고 있는 GDAL 라이브러리의 버전을 반환합니다.
PostGIS_Raster_Lib_Build_Date — 전체 래스터 라이브러리의 빌드 날짜를 반환합니다.
PostGIS_Raster_Lib_Version — 전체 래스터 버전 및 설정 정보를 반환합니다.
ST_GDALDrivers — Returns a list of raster formats supported by PostGIS through GDAL. Only those formats with can_write=True can be used by ST_AsGDALRaster
ST_Contour — Generates a set of vector contours from the provided raster band, using the GDAL contouring algorithm.
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.
UpdateRasterSRID — 사용자가 지정한 열 및 테이블에 있는 모든 래스터의 SRID를 변경합니다.
ST_CreateOverview — 입력 래스터 커버리지의 저해상도 버전을 생성합니다.
10.3. 래스터 작성자(constructor)
ST_AddBand — 입력 인덱스 위치에 입력 초기값으로 추가된 입력 유형의 새 밴드(들)을 가진 래스터를 반환합니다. 인덱스를 설정하지 않을 경우, 마지막 위치에 밴드를 추가합니다.
ST_AsRaster — PostGIS 도형을 PostGIS 래스터로 변환합니다.
ST_Band — 기존 래스터의 하나 이상의 밴드를 새 래스터로 반환합니다. 기존 래스터로부터 새 래스터를 빌드하는 데 유용합니다.
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_Tile — 출력 래스터에 원하는 차원을 바탕으로 입력 래스터를 분할해서 나온 래스터들의 집합을 반환합니다.
ST_Retile — 임의로 타일화된 래스터 커버리지로부터, 설정된 타일들의 집합을 반환합니다.
ST_FromGDALRaster — 지원 GDAL 래스터 파일로부터 래스터를 반환합니다.
10.4. 래스터 접근자(accessor)
ST_GeoReference — 월드(world) 파일에서 흔히 볼 수 있는 지리참조 메타데이터를 GDAL 또는 ESRI 형식으로 반환합니다. 기본값은 GDAL입니다.
ST_Height — 래스터의 높이를 픽셀 개수로 반환합니다.
ST_IsEmpty — 래스터가 비어 있을 경우 (width = 0, height = 0) 참을 반환합니다. 그렇지 않을 경우 거짓을 반환합니다.
ST_MemSize — 래스터가 차지하는 공간의 용량을 (바이트 단위로) 반환합니다.
ST_MetaData — 래스터 객체의 픽셀 크기, 회전(skew), 좌상단, 좌하단 등과 같은 기본 메타데이터를 반환합니다.
ST_NumBands — 래스터 객체 내부에 있는 밴드들의 개수를 반환합니다.
ST_PixelHeight — 픽셀 높이를 공간 참조 시스템의 기하 단위로 반환합니다.
ST_PixelWidth — 픽셀 너비를 공간 참조 시스템의 기하 단위로 반환합니다.
ST_ScaleX — 픽셀 너비의 X 요소를 좌표 참조 시스템의 단위로 반환합니다.
ST_ScaleY — 픽셀 높이의 Y 요소를 좌표 참조 시스템의 단위로 반환합니다.
ST_RasterToWorldCoord — 주어진 열과 행에 있는 래스터의 좌상단의 기하학적 X, Y(경도, 위도)를 으로 반환합니다. 열과 행은 1부터 시작합니다.
ST_RasterToWorldCoordX — 열과 행에 있는 래스터의 좌상단의 기하학적 X 좌표를 반환합니다. 열과 행의 번호는 1부터 시작합니다.
ST_RasterToWorldCoordY — 열과 행에 있는 래스터의 좌상단의 기하학적 Y 좌표를 반환합니다. 열과 행의 번호는 1부터 시작합니다.
ST_Rotation — 래스터의 회전각을 라디안으로 반환합니다.
ST_SkewX — 지리참조 X 기울기(skew)(또는 회전각 파라미터)를 반환합니다.
ST_SkewY — 지리참조 Y 기울기(또는 회전각 파라미터)를 반환합니다.
ST_SRID — spatial_ref_sys 테이블에 정의되어 있는, 래스터의 공간 참조 식별자를 반환합니다.
ST_Summary — 래스터의 내용을 요약한 텍스트를 반환합니다.
ST_UpperLeftX — 래스터의 좌상단 X 좌표를 투영된 공간 참조 단위로 반환합니다.
ST_UpperLeftY — 래스터의 좌상단 Y 좌표를 투영된 공간 참조 단위로 반환합니다.
ST_Width — 래스터의 너비를 픽셀 개수로 반환합니다.
ST_WorldToRasterCoord — 주어진 기하학적 X, Y(경도, 위도)의 좌상단을 열과 행으로 또는 래스터의 공간 참조 좌표 시스템 단위로 표현된 포인트 도형으로 반환합니다.
ST_WorldToRasterCoordX — 포인트 도형(pt)의 래스터 안의 열 또는 래스터의 월드 공간 참조 시스템 단위로 표현된 X, Y 월드 좌표(xw, yw)를 반환합니다.
ST_WorldToRasterCoordY — 포인트 도형(pt)의 래스터 안의 행 또는 래스터의 월드 공간 참조 시스템 단위로 표현된 X, Y 월드 좌표(xw, yw)를 반환합니다.
10.5. 래스터 밴드 접근자
ST_BandMetaData — 지정 래스터 밴드에 대한 기본 메타데이터를 반환합니다. 밴드를 지정하지 않을 경우 밴드 1번이라고 가정합니다.
ST_BandNoDataValue — 입력 밴드에서 NODATA를 나타내는 값을 반환합니다. 어떤 밴드도 지정하지 않을 경우 밴드 1로 가정합니다.
ST_BandIsNoData — 밴드가 NODATA 값만으로 채워져 있을 경우 참을 반환합니다.
ST_BandPath — 파일 시스템에 저장된 밴드를 가리키는 시스템 파일 경로를 반환합니다. bandnum을 설정하지 않을 경우 밴드 1로 가정합니다.
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_BandPixelType — 입력 밴드의 픽셀 유형을 반환합니다. bandnum을 설정하지 않을 경우 밴드 1로 가정합니다.
ST_MinPossibleValue — 래스터 객체 내부에 있는 밴드들의 개수를 반환합니다.
ST_HasNoBand — 입력된 밴드 번호에 밴드가 없을 경우 참을 반환합니다. 밴드 번호를 설정하지 않을 경우, 밴드 1로 가정합니다.
10.6. 래스터 픽셀 접근자 및 설정자(setter)
ST_PixelAsPolygon — 특정 행 및 열에 대한 픽셀의 경계를 이루는 폴리곤 도형을 반환합니다.
ST_PixelAsPolygons — 래스터 밴드의 모든 픽셀의 경계를 이루는 폴리곤 도형을 각 픽셀의 값과 X, Y 래스터 좌표와 함께 반환합니다.
ST_PixelAsPoint — 픽셀의 좌상단에 위치하는 포인트 도형을 반환합니다.
ST_PixelAsPoints — 래스터 밴드의 각 픽셀에 대한 포인트 도형을 각 픽셀의 값 및 X, Y 래스터 좌표와 함께 반환합니다. 포인트 도형의 좌표는 픽셀의 좌상단 좌표입니다.
ST_PixelAsCentroid — 픽셀 하나가 차지하는 면의 중심점(포인트 도형)을 반환합니다.
ST_PixelAsCentroids — 래스터 밴드의 각 픽셀에 대한 중심점(포인트 도형)을 각 픽셀의 값 및 X, Y 래스터 좌표와 함께 반환합니다. 포인트 도형은 픽셀이 차지하는 면의 중심점입니다.
ST_Value — 입력 columnx, rowy 픽셀의 입력 밴드의 값, 또는 특정 기하학적 포인트의 밴드의 값을 반환합니다. 밴드 번호는 1부터 시작하며, 따로 지정하지 않을 경우 1로 가정합니다. exclude_nodata_value 를 거짓으로 설정할 경우, nodata 픽셀을 포함한 모든 픽셀이 교차한다고 가정하고 값을 반환합니다. exclude_nodata_value 를 설정하지 않은 경우, 래스터의 메타데이터에서 값을 읽어 들입니다.
ST_NearestValue — columnx 및 rowy, 또는 래스터와 동일한 공간 참조 좌표 시스템 단위로 표현된 기하학적 포인트로 지정된 입력 밴드의 픽셀에 가장 가까운 NODATA 가 아닌 값을 반환합니다.
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_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_Neighborhood — columnx 및 rowy, 또는 래스터와 동일한 공간 참조 좌표 시스템 단위로 표현된 기하학적 포인트로 지정된 입력 밴드의 픽셀 주위의 NODATA 가 아닌 값들의 이중 정밀도 데이터형 2차원 배열을 반환합니다.
ST_SetValue — 입력한 columnx, rowy 픽셀 또는 특정 도형과 교차하는 픽셀들의 위치의 밴드 값을 설정해서 나온 수정된 래스터를 반환합니다. 밴드 번호는 1부터 시작하며, 따로 설정하지 않을 경우 1로 가정합니다.
ST_SetValues — 지정한 밴드의 값들을 설정해서 나온 수정된 래스터를 반환합니다.
ST_DumpValues — 지정된 밴드의 값들을 2차원 배열로 반환합니다.
ST_PixelOfValue — 검색 값과 일치하는 값을 가진 픽셀의 columnx, rowy 좌표를 반환합니다.
10.7. 래스터 편집자
ST_SetGeoReference — 단일 호출로 지리참조 파라미터 6개를 설정합니다. 숫자를 공백으로 구분해야 합니다. GDAL 또는 ESRI 서식의 입력물을 받아들입니다. 기본값은 GDAL입니다.
ST_SetRotation — 래스터의 회전각을 라디안으로 설정합니다.
ST_SetScale — X 및 Y 픽셀 크기를 좌표 참조 시스템의 단위로 설정합니다. 단위/픽셀 너비/픽셀 높이 순서입니다.
ST_SetSkew — 지리참조 X 및 Y 기울기(skew)(또는 회전각 파라미터)를 설정합니다. 값 하나만 입력할 경우, X와 Y를 동일한 값으로 설정합니다.
ST_SetSRID — 래스터의 SRID를 spatial_ref_sys 테이블에 정의된 특정 SRID의 정수값으로 설정합니다.
ST_SetUpperLeft — Sets the value of the upper left corner of the pixel of the raster to projected X and Y coordinates.
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_Reskew — 기울기(또는 회전각 파라미터)만 조정해서 래스터를 리샘플링합니다. NearestNeighbor(영국 또는 미국 철자), Bilinear, Cubic, CubicSpline 또는 Lanczos 리샘플링 알고리즘을 이용해서 새 픽셀 값을 계산합니다. 기본값은 NearestNeighbor입니다.
ST_SnapToGrid — 그리드에 래스터를 스냅시켜서 래스터를 리샘플링합니다. NearestNeighbor(영국 또는 미국 철자), Bilinear, Cubic, CubicSpline 또는 Lanczos 리샘플링 알고리즘을 이용해서 새 픽셀 값을 계산합니다. 기본값은 NearestNeighbor입니다.
ST_Resize — 래스터의 크기를 새 너비/높이로 조정합니다.
ST_Transform — 알려진 공간 참조 시스템의 래스터를 지정한 리샘플링 알고리즘을 통해 또 다른 알려진 공간 참조 시스템으로 재투영합니다. NearestNeighbor, Bilinear, Cubic, CubicSpline, Lanczos 알고리즘을 이용할 수 있습니다. 기본값은 NearestNeighbor입니다.
10.8. 래스터 밴드 편집자
ST_SetBandNoDataValue — NODATA를 나타내는 입력 밴드의 값을 설정합니다. 밴드를 따로 설정하지 않을 경우 밴드 1로 가정합니다. 밴드에 NODATA가 없다고 표시하려면, nodata value = NULL이라고 설정하십시오.
ST_SetBandIsNoData — 밴드의 isnodata 플래그를 참으로 설정합니다.
ST_SetBandPath — Update the external path and band number of an out-db band
ST_SetBandIndex — Update the external band number of an out-db band
10.9. 래스터 밴드 통계 및 분석
ST_Count — 래스터 또는 래스터 커버리지의 입력 밴드에 있는 픽셀 개수를 반환합니다. 밴드를 따로 설정하지 않을 경우 기본값은 밴드 1입니다. exclude_nodata_value를 참으로 설정할 경우, NODATA 값이 아닌 픽셀의 개수만 반환할 것입니다.
ST_CountAgg — 종합 함수입니다. 래스터 집합의 입력 밴드에 있는 픽셀 개수를 반환합니다. 밴드를 따로 설정하지 않을 경우 기본값은 밴드 1입니다. exclude_nodata_value를 참으로 설정할 경우, NODATA 값이 아닌 픽셀의 개수만 반환할 것입니다.
ST_Histogram — 빈(bin; 히스토그램 표시에서 수직 막대로 나타나는 단위) 범위로 구분된 래스터 또는 래스터 커버리지의 데이터 분포를 요약하는 레코드 집합을 반환합니다. 따로 설정하지 않을 경우 빈의 개수를 자동으로 계산합니다.
ST_Quantile — 샘플링 또는 채우기(population)라는 맥락에서 래스터 또는 래스터 테이블 커버리지의 사분위(quantile)를 계산합니다. 따라서, 래스터의 25%, 50%, 75% 백분위(percentile) 단계로 값을 확인할 수 있습니다.
ST_SummaryStats — 입력한 래스터 밴드 또는 래스터 또는 래스터 커버리지의 count, sum, mean, stddev, min, max로 이루어진 통계 요약을 반환합니다. 밴드를 따로 설정하지 않을 경우 밴드 1로 가정합니다.
ST_SummaryStatsAgg — 종합 함수입니다. 래스터 집합의 입력 래스터 밴드의 count, sum, mean, stddev, min, max로 이루어진 통계 요약을 반환합니다. 밴드를 따로 설정하지 않을 경우 밴드 1로 가정합니다.
ST_ValueCount — 설정한 값들의 집합을 가진 래스터(또는 래스터 커버리지)의 입력 밴드에 있는 픽셀 밴드 값 및 픽셀 개수의 집계를 담고 있는 레코드 집합을 반환합니다. 밴드를 따로 설정하지 않을 경우 기본값은 밴드 1입니다. 기본적으로 NODATA 값은 집계되지 않습니다. 픽셀의 다른 모든 값들을 출력하는데, 픽셀 밴드 값은 가장 가까운 정수로 반올림됩니다.
10.10. Raster Inputs
ST_RastFromWKB — Return a raster value from a Well-Known Binary (WKB) raster.
ST_RastFromHexWKB — Return a raster value from a Hex representation of Well-Known Binary (WKB) raster.
10.11. 래스터 출력
ST_AsBinary/ST_AsWKB — Return the Well-Known Binary (WKB) representation of the raster.
ST_AsHexWKB — Return the Well-Known Binary (WKB) in Hex 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_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_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.
10.12. 래스터 공간 처리
ST_Clip — 입력 도형으로 잘라낸 래스터를 반환합니다. 밴드 번호를 지정하지 않은 경우, 모든 밴드를 처리합니다. crop 을 설정하지 않거나 참으로 설정한 경우, 잘라낸 래스터를 출력합니다.
ST_ColorMap — 소스 래스터 및 설정한 밴드로부터 8BUI 밴드(grayscale, RGB, RGBA)를 4개까지 가지는 새 래스터를 생성합니다. 밴드를 따로 설정하지 않으면 밴드 1로 가정합니다.
ST_Grayscale — Creates a new one-8BUI band raster from the source raster and specified bands representing Red, Green and Blue
ST_Intersection — 두 래스터의 공유 부분을 표현하는, 또는 벡터화된 래스터와 도형의 기하학적 교차를 표현하는 래스터 또는 도형-픽셀값 쌍의 집합을 반환합니다.
ST_MapAlgebra (callback function version) — 콜백 함수 버전 - 래스터 1개 이상, 밴드 인덱스, 그리고 사용자 지정 콜백 함수 1개를 입력받아 밴드 1개를 가진 래스터를 반환합니다.
ST_MapAlgebra (expression version) — 표현식 버전 - 입력 래스터 1개 또는 2개, 밴드 인덱스, 그리고 사용자 지정 SQL 표현식 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_Reclass — 원본으로부터 재분류된 밴드 유형으로 이루어진 새 래스터를 생성합니다. nband 는 변경할 밴드를 가리킵니다. nband 를 따로 설정하지 않을 경우 밴드 1로 가정합니다. 다른 모든 밴드들은 변경 없이 반환됩니다. 실제 사례: 보기 좋은 형식으로 더 간단하게 렌더링하기 위해 16BUI 밴드를 8BUI 등등으로 변환하십시오.
ST_Union — 래스터 타일 집합을 1개 이상의 밴드로 이루어진 단일 래스터로 통합합니다.
10.13. 내장 맵 대수 콜백 함수
ST_Distinct4ma — 이웃에서 유일한 픽셀 값들의 개수를 계산하는 래스터 공간 처리 함수입니다.
ST_InvDistWeight4ma — 픽셀의 이웃으로부터 픽셀 값을 보간하는 래스터 공간 처리 함수입니다.
ST_Max4ma — 이웃에서 최대 픽셀 값을 계산하는 래스터 공간 처리 함수입니다.
ST_Mean4ma — 이웃에서 평균 픽셀 값을 계산하는 래스터 공간 처리 함수입니다.
ST_Min4ma — 이웃에서 최소 픽셀 값을 계산하는 래스터 공간 처리 함수입니다.
ST_MinDist4ma — 관심 픽셀과 값을 가지고 있는 이웃 픽셀 사이의 최소 거리를 (픽셀 개수로) 반환하는 래스터 공간 처리 함수입니다.
ST_Range4ma — 이웃에 있는 픽셀값들의 범위를 계산하는 래스터 공간 처리 함수입니다.
ST_StdDev4ma — 이웃에 있는 픽셀값들의 표준 편차를 계산하는 래스터 공간 처리 함수입니다.
ST_Sum4ma — 이웃에 있는 모든 픽셀값들의 합계를 계산하는 래스터 공간 처리 함수입니다.
10.14. 래스터 공간 처리
ST_Aspect — 표고 래스터 밴드의 향(기본 단위는 도)을 반환합니다. 지형을 분석하는 데 유용합니다.
ST_HillShade — 입력한 방위각, 고도각, 밝기 및 축척을 이용해서 표고 래스터 밴드의 가상적인 음영기복을 반환합니다.
ST_Roughness — DEM의 계산된 "거칠기(roughness)"와 함께 래스터를 반환합니다.
ST_Slope — 표고 래스터 밴드의 경사(기본 단위는 도)를 반환합니다. 지형을 분석하는 데 유용합니다.
ST_TPI — 계산된 지형위치지수(Topographic Position Index)와 함께 래스터를 반환합니다.
ST_TRI — 계산된 지형험준도지수(Terrain Ruggedness Index)와 함께 래스터를 반환합니다.
10.15. 래스터를 도형으로
Box3D — 래스터를 둘러싼 상자의 BOX3D 표현식을 반환합니다.
ST_ConvexHull — BandNoDataValue와 일치하는 픽셀 값을 포함한, 래스터의 볼록 껍질 도형을 반환합니다. 정규 형상 및 기울어지지 않은 래스터의 경우, ST_Envelope와 동일한 결과물을 출력하므로 비정규 형상 또는 기울어진 래스터에 대해서만 쓸모가 있습니다.
ST_DumpAsPolygons — 입력 래스터 밴드로부터 geomval(geom, val) 행들의 집합을 반환합니다. 밴드 번호를 설정하지 않을 경우 기본적으로 밴드 1로 가정합니다.
ST_Envelope — 래스터 범위의 폴리곤 표현식을 반환합니다.
ST_MinConvexHull — 래스터의 NODATA 픽셀을 제외한 볼록 껍질 도형을 반환합니다.
ST_Polygon — NODATA 값이 아닌 픽셀 값을 가진 픽셀들을 통합해서 형성된 멀티폴리곤 도형을 반환합니다.
10.16. 래스터 연산자
&& — A의 경계 상자와 B의 경계 상자가 교차하는 경우 TRUE 를 반환합니다.
&< — A의 경계 상자가 B의 경계 상자 왼쪽에 있을 경우 TRUE 를 반환합니다.
&> — A의 경계 상자가 B의 경계 상자 오른쪽에 있을 경우 TRUE 를 반환합니다.
= — A의 경계 상자와 B의 경계 상자가 동일할 경우 TRUE 를 반환합니다. 이중 정밀도 경계 상자를 이용합니다.
@ — B의 경계 상자가 A의 경계 상자를 담고 있을 경우 TRUE 를 반환합니다. 이중 정밀도 경계 상자를 이용합니다.
~= — A의 경계 상자와 B의 경계 상자가 동일할 경우 TRUE 를 반환합니다.
~ — A의 경계 상자가 B의 경계 상자를 담고 있을 경우 TRUE 를 반환합니다. 이중 정밀도 경계 상자를 이용합니다.
10.17. 래스터 및 래스터 밴드의 공간 관계성
ST_Contains — 래스터 rastA 외부에 놓인 래스터 rastB의 포인트가 하나도 없고, 적어도 rastB 내부의 포인트 하나가 rastA의 내부에 있는 경우 참을 반환합니다.
ST_ContainsProperly — rastB가 rastA의 내부와 교차하지만 rastA의 경계선 또는 외부와 교차하지는 않을 경우 참을 반환합니다.
ST_Covers — 래스터 rastB의 어떤 포인트도 래스터 rastA 외부에 없을 경우 참을 반환합니다.
ST_CoveredBy — 래스터 rastA의 어떤 포인트도 래스터 rastB 외부에 없을 경우 참을 반환합니다.
ST_Disjoint — 래스터 rastA와 래스터 rastB가 공간적으로 교차하지 않을 경우 참을 반환합니다.
ST_Intersects — 래스터 rastA와 래스터 rastB가 공간적으로 교차할 경우 참을 반환합니다.
ST_Overlaps — 래스터 rastA와 래스터 rastB가 교차하지만 어느 한 쪽이 다른 한 쪽을 완전히 담고 있지는 않을 경우 참을 반환합니다.
ST_Touches — 래스터 rastA와 래스터 rastB가 최소한 포인트 한 개를 공유하지만, 내부가 교차하지는 않을 경우 TRUE 를 반환합니다.
ST_SameAlignment — 래스터들이 동일한 기울기, 축척, 공간 참조 시스템, 그리고 오프셋을 가지고 있을 경우 (픽셀이 다른 픽셀을 침범하지 않고 동일한 그리드에 놓일 수 있을 경우) 참을 반환하고, 그렇지 않을 경우 문제점을 설명하는 안내문과 함께 거짓을 반환합니다.
ST_NotSameAlignmentReason — 래스터들이 정렬돼 있는지 아닌지, 그리고 정렬되지 않았다면 그 이유를 설명하는 텍스트를 반환합니다.
ST_Within — 래스터 rastB 외부에 놓인 래스터 rastA의 포인트가 하나도 없고, 적어도 rastA 내부의 포인트 하나가 rastB의 내부에 있는 경우 참을 반환합니다.
ST_DWithin — 래스터 rastA와 래스터 rastB가 서로 설정된 거리 안에 있을 경우 참을 반환합니다.
ST_DFullyWithin — 래스터 rastA와 래스터 rastB가 완전히 서로 설정된 거리 안에 있을 경우 참을 반환합니다.
10.18. Raster Tips
10.18.1. Out-DB Rasters
11. PostGIS Extras
11.1. 주소 표준화 도구
11.1.1. 파싱 도구의 작동 방식
11.1.2. 주소 표준화 도구 유형
11.1.3. 주소 표준화 도구 테이블
11.1.4. 주소 표준화 도구 함수
11.2. TIGER 지오코딩 도구
Drop_Indexes_Generate_Script — TIGER 스키마 및 사용자 지정 스키마에 있는 기본 키가 아닌 그리고 유일하지 않은 인덱스들을 모두 삭제하는 스크립트를 생성합니다. 스키마를 따로 지정하지 않을 경우 기본값인 tiger_data 스키마를 대상으로 합니다.
Drop_Nation_Tables_Generate_Script — 지정한 스키마에서 county_all, state_all 로 시작하는 테이블, 또는 뒤에 county, state 가 붙는 주(州) 코드를 모두 삭제하는 스크립트를 생성합니다.
Drop_State_Tables_Generate_Script — 지정한 스키마에서 주(州) 명칭의 약어가 접두사로 붙는 테이블을 모두 삭제하는 스크립트를 생성합니다. 스키마를 따로 지정하지 않을 경우 기본값인 tiger_data 스키마를 대상으로 합니다.
Geocode — 주소를 스트링(또는 다른 정규화된 주소)으로 입력받아 NAD83 경위도로 투영된 포인트 도형, 각 주소에 대한 정규화된 주소 및 순위를 포함하는 가능성 있는 위치들의 집합을 출력합니다. 순위가 낮을수록 주소와 위치가 일치할 가능성이 커집니다. 결과를 순위가 낮은 순서로 정렬합니다. 결과의 최대 개수(기본값 10) 및 restrict_region(기본값 NULL) 옵션 파라미터를 넘겨줄 수 있습니다.
Geocode_Intersection — 교차하는 도로 2개와 주, 시, 집코드를 입력받아 NAD83 경위도로 투영된 포인트 위치인 geomout, 각 위치에 대한 normalized_address (addy) 및 순위도 포함하는, 교차점에서 처음 가로지르는 도로에 있는 가능성 있는 위치들의 집합을 출력합니다. 순위가 낮을수록 주소와 위치가 일치할 가능성이 커집니다. 결과를 순위가 낮은 순서로 정렬합니다. 결과의 최대 개수(기본값 10) 옵션 파라미터를 넘겨줄 수 있습니다. TIGER 데이터(edge, face, addr) 및 PostgreSQL 퍼지 문자열 매칭(soundex, levenshtein)을 이용합니다.
Get_Geocode_Setting — tiger.geocode_settings 테이블에 저장된 특정 설정값을 반환합니다.
Get_Tract — 도형이 위치해 있는 구역(tract) 테이블로부터 인구조사 구역 또는 현장(field)을 반환합니다. 기본적으로 구역의 축약된 명칭을 반환합니다.
Install_Missing_Indexes — 지오코딩 도구의 결합(join)에 이용되는 키(key) 열을 가진 테이블을 모두 찾아서 해당 열에 쓰인 인덱스 가운데 없어진 것들에 대한 조건으로 필터링해서 없어진 인덱스들을 추가합니다.
Loader_Generate_Census_Script — 설정한 플랫폼에 대해 설정한 주(州)를 위한, TIGER 인구조사 주(州) 구역(tract), 블록 그룹(bg), 블록(tabblock) 데이터 테이블을 다운로드해서 tiger_data 스키마에 단계별로 로드하는 셸 스크립트를 생성합니다. 각 주(州)의 스크립트를 개별 레코드로 반환합니다.
Loader_Generate_Script — 설정한 플랫폼에 대해 설정한 주(州)를 위한, TIGER 데이터를 다운로드해서 tiger_data 스키마에 단계별로 로드하는 셸 스크립트를 생성합니다. 각 주(州)의 스크립트를 개별 레코드로 반환합니다. 최신 버전은 TIGER 2010 구조 변경 사항을 지원하며, 인구조사 구역, 블록 그룹, 블록 테이블도 로드합니다.
Loader_Generate_Nation_Script — 설정한 플랫폼에 대해, 군 및 주 색인 테이블을 로드하는 셸 스크립트를 생성합니다.
Missing_Indexes_Generate_Script — 지오코딩 도구의 결합(join)에 이용되는 키(key) 열을 가진 테이블 가운데 해당 열에서 없어진 인덱스를 모두 찾아서 해당 테이블에 대한 인덱스를 정의하는 SQL DDL을 출력합니다.
Normalize_Address — 문자형 도로 주소를 입력받아, 도로 접미사, 접두사 및 유형을 표준화하고 도로, 도로명 등을 개별 필드로 분해한 norm_addy 합성 유형을 반환합니다. 이 함수는 tiger_geocoder와 함께 패키징된 색인 데이터만 이용해서 (TIGER 인구조사 데이터는 필요없이) 작동할 것입니다.
Pagc_Normalize_Address — 문자형 도로 주소를 입력받아, 도로 접미사, 접두사 및 유형을 표준화하고 도로, 도로명 등을 개별 필드로 분해한 norm_addy 합성 유형을 반환합니다. 이 함수는 tiger_geocoder와 함께 패키징된 색인 데이터만 이용해서 (TIGER 인구조사 데이터는 필요없이) 작동할 것입니다. address_standardizer 확장 프로그램이 필요합니다.
Pprint_Addynorm_addy 복합 유형 객체를 입력받아, 해당 객체의 보기 좋은 인쇄용 표현을 반환합니다. 일반적으로 normalize_address 함수와 결합해서 쓰입니다.
Reverse_Geocode — 알려진 공간 참조 시스템으로 투영된 도형 포인트를 입력받아 이론적으로 가능한 주소들의 배열과 교차로의 배열을 담고 있는 레코드를 반환합니다. include_strnum_range = true일 경우, 교차로에 있는 도로 범위를 포함합니다.
Topology_Load_Tiger — PostGIS 지형에 TIGER 데이터의 정의된 지역을 로드하면서 TIGER 데이터를 지형의 공간 참조 시스템으로 변환하고 지형의 정확도 허용 오차에 스냅시킵니다.
Set_Geocode_Setting — 지오코딩 도구 함수들의 습성에 영향을 미치는 설정값을 설정합니다.
12. PostGIS Special Functions Index
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
13. Reporting Problems
13.1. Reporting Software Bugs
13.2. Reporting Documentation Issues
A. Appendix
A.1. PostGIS 3.4.0