Chapter 14. PostGIS Special Functions Index

Table of Contents

14.1. PostGIS Aggregate Functions
14.2. PostGIS Window Functions
14.3. PostGIS SQL-MM Compliant Functions
14.4. PostGIS Geography Support Functions
14.5. PostGIS Raster Support Functions
14.6. PostGIS Geometry / Geography / Raster Dump Functions
14.7. PostGIS Box Functions
14.8. PostGIS Functions that support 3D
14.9. PostGIS Curved Geometry Support Functions
14.10. PostGIS Polyhedral Surface Support Functions
14.11. PostGIS Function Support Matrix
14.12. New, Enhanced or changed PostGIS Functions
14.12.1. PostGIS Functions new or enhanced in 2.3
14.12.2. PostGIS Functions new or enhanced in 2.2
14.12.3. PostGIS functions breaking changes in 2.2
14.12.4. PostGIS Functions new or enhanced in 2.1
14.12.5. PostGIS functions breaking changes in 2.1
14.12.6. PostGIS Functions new, behavior changed, or enhanced in 2.0
14.12.7. PostGIS Functions changed behavior in 2.0
14.12.8. PostGIS Functions new, behavior changed, or enhanced in 1.5
14.12.9. PostGIS Functions new, behavior changed, or enhanced in 1.4
14.12.10. PostGIS Functions new in 1.3

14.1. PostGIS Aggregate Functions

The functions given below are spatial aggregate functions provided with PostGIS that can be used just like any other sql aggregate function such as sum, average.

  • ST_3DExtent - ジオメトリのbox3Dバウンディングボックスを返す集約関数です。
  • ST_Accum - 集約関数です。ジオメトリの配列を生成します。
  • ST_ClusterIntersecting - Aggregate. Returns an array with the connected components of a set of geometries
  • ST_ClusterWithin - Aggregate. Returns an array of GeometryCollections, where each GeometryCollection represents a set of geometries separated by no more than the specified distance.
  • ST_Collect - 他のジオメトリのコレクションから、指定したST_Geometry値を返します。
  • ST_Extent - ジオメトリのバウンディングボックスを返す集約関数です。
  • ST_MakeLine - Creates a Linestring from point, multipoint, or line geometries.
  • ST_MemUnion - ST_Unionと同じですが、メモリフレンドリ (少ないメモリ使用、多いCPU時間)です。
  • ST_Polygonize - 集約関数。ジオメトリの集合のラインから形成されうるポリゴンを含むジオメトリコレクションを生成します。
  • ST_SameAlignment - ラスタが同じスキュー、スケール、空間参照系、オフセットを持つ (ピクセルが分割されることなく同じグリッドに置かれている)場合にTRUEを返し、そうでない場合は問題を詳述する通知とともにFALSEを返します。
  • ST_Union - ジオメトリの結合の点集合を表現するジオメトリを返します。
  • TopoElementArray_Agg - element_idとタイプの配列 (topoelements)からなるtopoelementarrayを返します。

14.2. PostGIS Window Functions

The functions given below are spatial window functions provided with PostGIS that can be used just like any other sql window function such as row_numer(), lead(), lag(). All these require an SQL OVER() clause.

  • ST_ClusterDBSCAN - Windowing function that returns integer id for the cluster each input geometry is in based on 2D implementation of Density-based spatial clustering of applications with noise (DBSCAN) algorithm.
  • ST_ClusterKMeans - Windowing function that returns integer id for the cluster each input geometry is in.

14.3. PostGIS SQL-MM Compliant Functions

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

[Note]

SQL-MM defines the default SRID of all geometry constructors as 0. PostGIS uses a default SRID of -1.

  • ST_3DDWithin - 3次元 (XYZ)ジオメトリ型について、二つのジオメトリの3次元距離が指定した数の内にある場合にtrueを返します。 This method implements the SQL/MM specification. SQL-MM ?
  • ST_3DDistance - ジオメトリ型について、二つのジオメトリの、3次元の最小デカルト距離 (空間参照系に基づきます)を、投影法の単位で返します。 This method implements the SQL/MM specification. SQL-MM ?
  • ST_3DIntersects - ジオメトリが3次元で「空間的にインタセクトする」場合にTRUEを返します。ポイント、ラインストリング、ポリゴン、多面体サーフェス (面)のみ対応します。SFCGALバックエンドによってTINも対応します。 This method implements the SQL/MM specification. SQL-MM 3: ?
  • ST_AddEdgeModFace - 新しいエッジを追加します。新しいエッジがフェイスを分割する場合には、もとのフェイスを編集し、一つのフェイスを追加します。 This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.13
  • ST_AddEdgeNewFaces - 新しいエッジを追加します。新しいエッジがフェイスを分割する場合には、もとのフェイスを削除して、分割した二つのフェイスに置き換えます。 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で定義される孤立エッジを追加し、新しいエッジの識別番号を返します。 This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.4
  • ST_AddIsoNode - フェイスに孤立ノードを追加し、新しいノードの識別番号を返します。フェイスがNULLの場合でもノードは生成されます。 This method implements the SQL/MM specification. SQL-MM: Topo-Net Routines: X+1.3.1
  • ST_Area - ポリゴンまたはマルチポリゴンの場合にはサーフェスの面積を返します。ジオメトリ型の面積はSRIDに基づく単位です。ジオグラフィ型の面積は曲面上で計算され、単位は平方メートルです。 This method implements the SQL/MM specification. SQL-MM 3: 8.1.2, 9.5.3
  • ST_AsBinary - ジオメトリ/ジオグラフィのSRIDメタデータのないWell-Known Binary (WKB)表現を返します This method implements the SQL/MM specification. SQL-MM 3: 5.1.37
  • ST_AsText - ジオメトリ/ジオグラフィのSRIDメタデータのないWell-Known Text (WKT)表現を返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.25
  • ST_Boundary - ジオメトリの組み合わせ境界の閉包を返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.14
  • ST_Buffer - (T) Returns a geometry covering all points within a given distance from the input geometry. This method implements the SQL/MM specification. SQL-MM 3: 5.1.17
  • ST_Centroid - ジオメトリの幾何学的重心を返します。 This method implements the SQL/MM specification. SQL-MM 3: 8.1.4, 9.5.5
  • ST_ChangeEdgeGeom - トポロジ構造に影響を与えることなくエッジの形状を変更します。 This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details X.3.6
  • ST_Contains - Bの点がAの外部に無く、かつBの内部の少なくとも一つの点がAの内部にある場合に限って、TRUEを返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.31
  • ST_ConvexHull - 凸包は与えられた集合の全てのジオメトリを含む最小の閉じた凸ジオメトリです。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.16
  • ST_CoordDim - ST_Geometry値の座標次元を返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.3
  • ST_CreateTopoGeo - 空のトポロジにジオメトリのコレクションを追加し、成否を示すメッセージを返します。 This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details -- X.3.18
  • ST_Crosses - 与えられたジオメトリが共通の内部の点を持ち、かつそうでない点を持つ場合に、TRUEを返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.29
  • ST_CurveToLine - Converts a CIRCULARSTRING/CURVEPOLYGON to a LINESTRING/POLYGON This method implements the SQL/MM specification. SQL-MM 3: 7.1.7
  • ST_Difference - ジオメトリBにインタセクトしないジオメトリAの部分を表現するジオメトリを返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.20
  • ST_Dimension - ジオメトリの固有次元を返します。ジオメトリは座標次元以下でなければなりません。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.2
  • ST_Disjoint - ジオメトリが「空間的にインタセクトし」ていない、すなわち、空間を共有していない場合に、TRUEを返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.26
  • ST_Distance - ジオメトリ型については、二つのジオメトリの、2次元の最小デカルト距離 (空間参照系に基づきます)を、投影法の単位で返します。ジオグラフィ型については、デフォルトでは、二つのジオメトリ間の測地距離をメートル単位で返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.23
  • ST_EndPoint - LINESTRINGの最後のポイントをPOINTで返します。 This method implements the SQL/MM specification. SQL-MM 3: 7.1.4
  • ST_Envelope - ジオメトリの浮動小数点数 (float8)バウンディングボックスを表現するジオメトリを返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.15
  • ST_Equals - 与えられたジオメトリ表現が同じ場合にTRUEを返します。方向は無視されます。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.24
  • ST_ExteriorRing - POLYGONの外環を表現するラインストリングを返します。ジオメトリがポリゴンでない場合はNULLを返します。マルチポリゴンでは動作しません。 This method implements the SQL/MM specification. SQL-MM 3: 8.2.3, 8.3.3
  • ST_GMLToSQL - GML表現から指定したST_Geometry値を返します。これはST_GeomFromGMLの別名です。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.50 (曲線対応を除く)
  • ST_GeomCollFromText - WKTのコレクションと与えられたSRIDからジオメトリのコレクションを生成します。SRIDが与えられていない場合は0とします。 This method implements the SQL/MM specification.
  • ST_GeomFromText - Well-Known Text表現 (WKT)から指定したST_Geometryを返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.40
  • ST_GeomFromWKB - Well-Knwon Binaryジオメトリ表現 (WKB)と任意パラメタのSRIDからジオメトリインスタンスを生成します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.41
  • ST_GeometryFromText - Well-Knwon Text表現 (WKT)から指定したST_Geometry値を返します。これはST_GeomFromTextの別名です。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.40
  • ST_GeometryN - GEOMETRYCOLLECTION, (MULTI)POINT, (MULTI)LINESTRING, MULTICURVE, (MULTI)POLYGON, POLYHEDRALSURFACEの場合には、1始まりでN番目のジオメトリを返します。それ以外の場合にはNULLを返します。 This method implements the SQL/MM specification. SQL-MM 3: 9.1.5
  • ST_GeometryType - ST_Geometry値のジオメトリ型を返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.4
  • ST_GetFaceEdges - 順序番号を含む、afaceの境界となる、整列したエッジの集合を返します。 This method implements the SQL/MM specification. SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.5
  • ST_GetFaceGeometry - 指定されたトポロジの中の、フェイス識別番号で指定されたポリゴンを返します。 This method implements the SQL/MM specification. SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.16
  • ST_InitTopoGeo - 新しいトポロジスキーマを生成し、topology.topologyテーブルに新しいスキーマを登録し、処理の概要を表示します。 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が範囲外の場合はNULLを返します。 This method implements the SQL/MM specification. SQL-MM 3: 8.2.6, 8.3.5
  • ST_Intersection - (T) Returns a geometry that represents the shared portion of geomA and geomB. This method implements the SQL/MM specification. SQL-MM 3: 5.1.18
  • ST_Intersects - ジオメトリ/ジオグラフィが「2次元空間で空間的にインタセクトする」 (空間に共有部分がある)場合にTRUEを返します。そうでない (非接続)場合はFALSEを返します。ジオグラフィについては、許容量は0.00001メートルです (近い点はインタセクトと考えられてしまいます)。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.27
  • ST_IsClosed - LINESTRINGの始点と終点が一致する場合にTRUEを返します。多面体サーフェスの場合は閉じているかどうか (ボリュームであるかどうか)を返します。 This method implements the SQL/MM specification. SQL-MM 3: 7.1.5, 9.3.3
  • ST_IsEmpty - ジオメトリが、空のジオメトリコレクション、ポリゴン、ポイント等の場合に、trueを返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.7
  • ST_IsRing - LINESTRINGが閉じていて、かつ単純である場合にTRUEを返します。 This method implements the SQL/MM specification. SQL-MM 3: 7.1.6
  • ST_IsSimple - ジオメトリが自己インタセクションや自己接触のような異常な幾何学ポイントを持っていない場合にTRUEを返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.8
  • ST_IsValid - ST_Geometryが整形されている場合には、trueを返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.9
  • ST_Length - ジオメトリがLINESTRINGまたはMULTILINESTRINGの場合には、それらの2次元長を返します。ジオメトリでは、単位は空間参照系の単位です。ジオグラフィでは、メートル単位です (回転楕円体がデフォルトです)。 This method implements the SQL/MM specification. SQL-MM 3: 7.1.2, 9.3.4
  • ST_LineFromText - WKT表現と与えられたSRIDからジオメトリを生成します。SRIDが与えられていない場合は0 (不明)となります。 This method implements the SQL/MM specification. SQL-MM 3: 7.2.8
  • ST_LineFromWKB - WKB表現と与えられたSRIDからLINESTRINGを生成します。 This method implements the SQL/MM specification. SQL-MM 3: 7.2.9
  • ST_LinestringFromWKB - WKB表現と与えられたSRIDからジオメトリを生成します。 This method implements the SQL/MM specification. SQL-MM 3: 7.2.9
  • ST_M - ポイントのM座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。 This method implements the SQL/MM specification.
  • ST_MLineFromText - WKT表現から指定したST_MultiLineString値を返します。 This method implements the SQL/MM specification.SQL-MM 3: 9.4.4
  • ST_MPointFromText - Well-Known Text (WKT)表現と与えられたSRIDからジオメトリを生成します。SRIDを与えない場合は0 (不明)となります。 This method implements the SQL/MM specification. SQL-MM 3: 9.2.4
  • ST_MPolyFromText - Well-Known Text (WKT)表現と与えられたSRIDからマルチポリゴンを生成します。SRIDを与えない場合は0 (不明)となります。 This method implements the SQL/MM specification. SQL-MM 3: 9.6.4
  • ST_ModEdgeHeal - 二つのエッジについて、接続しているノードを削除して修復します。1番目のエッジを編集して、2番目のエッジを削除します。削除されたノードの識別番号を返します。 This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.9
  • ST_ModEdgeSplit - 既存のエッジに沿って新しいノードを生成してエッジを分割します。もとのエッジは変更され、新しいエッジが一つ追加されます。 This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.9
  • ST_MoveIsoNode - トポロジ内の孤立ノードを別の位置に移動させます。新しいapointジオメトリがノードとして存在しているなら、エラーが投げられます。移動に関する記述を返します。 This method implements the SQL/MM specification. SQL-MM: Topo-Net Routines: X.3.2
  • ST_NewEdgeHeal - 二つのエッジについて、接続しているノードを削除して修復します。両方のエッジを削除し、1番目のエッジと同じ方向のエッジに置き換えます。 This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.9
  • ST_NewEdgesSplit - 新しいノードを既存のエッジに沿って作成して、エッジを分割します。もとのエッジは削除され、二つのエッジに置き換えられます。二つの新しいエッジに接続する新しいノードの識別番号を返します。 This method implements the SQL/MM specification. SQL-MM: Topo-Net Routines: X.3.8
  • ST_NumGeometries - ジオメトリがジオメトリコレクションまたはマルチ系の場合はジオメトリの数を、単一のジオメトリの場合は1を返し、それ以外の場合はNULLを返します。 This method implements the SQL/MM specification. SQL-MM 3: 9.1.4
  • ST_NumInteriorRings - Return the number of interior rings of a polygon geometry. This method implements the SQL/MM specification. SQL-MM 3: 8.2.5
  • ST_NumPatches - 多面体サーフェスのフェイス数を返します。多面体でないジオメトリの場合にはNULLを返します。 This method implements the SQL/MM specification. SQL-MM 3: ?
  • ST_NumPoints - ST_LineStringまたはST_CircularStringのポイント数を返します。 This method implements the SQL/MM specification. SQL-MM 3: 7.2.4
  • ST_OrderingEquals - 与えられたジオメトリが同じジオメトリを示し、ポイントの順序が同じである場合にTRUEを返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.43
  • ST_Overlaps - ジオメトリが共有空間を持ち、同じ次元で、かつ完全には一方に含まれていない場合にTRUEを返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.32
  • ST_PatchN - ジオメトリがPOLYHEDRALSURFACEかPOLYHEDRALSURFACEMの場合には、1始まりでN番目のジオメトリ (フェイス)を返します。それ以外の場合には、NULLを返します。 This method implements the SQL/MM specification. SQL-MM 3: ?
  • ST_Perimeter - ST_SrrfaceまたはST_MultiSurface (POLYGONまたはMULTIPOLYGON)の境界の長さの計測値を返します。ジオメトリでは単位は空間参照系によります。ジオグラフィではメートル単位になります。 This method implements the SQL/MM specification. SQL-MM 3: 8.1.3, 9.5.4
  • ST_Point - 与えられた座標値のST_Pointを返します。ST_MakePointのOGC別名です。 This method implements the SQL/MM specification. SQL-MM 3: 6.1.2
  • ST_PointFromText - WKTと与えられたSRIDからポイントジオメトリを生成します。SRIDが与えられていない場合は0 (不明)とします。 This method implements the SQL/MM specification. SQL-MM 3: 6.1.8
  • ST_PointFromWKB - WKBと与えられたSRIDからジオメトリを生成します。 This method implements the SQL/MM specification. SQL-MM 3: 6.1.9
  • ST_PointN - Return the Nth point in the first LineString or circular LineString in the geometry. Negative values are counted backwards from the end of the LineString. Returns NULL if there is no linestring in the geometry. This method implements the SQL/MM specification. SQL-MM 3: 7.2.5, 7.3.5
  • ST_PointOnSurface - サーフェス上にあることを保障されたPOINTを返します。 This method implements the SQL/MM specification. SQL-MM 3: 8.1.5, 9.5.6. 仕様によると、ST_PointOnSurfaceは面ジオメトリ (POLYGON, MULTIPOLYGON, 曲線ポリゴン)で動作します。PostGISは、仕様で許される以上に拡張しているように見えます。Oracle, DB II, ESRI SDEといったほとんどのデータベースでは、面ジオメトリにのみ対応しているように見えます。SQL Server 2008は、PostGISのように全ての一般的なジオメトリに対応しています。
  • ST_Polygon - 指定されたラインストリングとSRIDからポリゴンを生成します。 This method implements the SQL/MM specification. SQL-MM 3: 8.3.2
  • ST_PolygonFromText - Well-Known Text (WKT)表現と与えられたSRIDからジオメトリを生成します。SRIDを与えない場合は0 (不明)となります。 This method implements the SQL/MM specification. SQL-MM 3: 8.3.6
  • ST_Relate - intersectionMatrixPatternの値について、二つのジオメトリの内部、境界、外部のインタセクションを見て、指定したジオメトリがもうひとつのジオメトリと空間的に関係している場合に、TRUEを返します。intersectionMatrixPatternが無い場合には、二つのジオメトリについての最大のintersectionMatrixPatternを返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.25
  • ST_RemEdgeModFace - エッジを削除し、削除対象エッジでフェイスが二つに分割されているなら、両方の空間をとるため、一つを削除して、もう一つを編集します。 This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.15
  • ST_RemEdgeNewFace - エッジを削除し、消去対象エッジでフェイスが二つに分割されているなら元の二つのフェイスを削除し、一つの新しいフェイスに置き換えます。 This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.14
  • ST_RemoveIsoNode - 孤立ノードを削除し、実行結果が返されます。ノードが孤立していない (エッジの始端または終端である)場合には、例外が投げられます。 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 the ST_Geometry as defined in spatial_ref_sys table. This method implements the SQL/MM specification. SQL-MM 3: 5.1.5
  • ST_StartPoint - LINESTRINGの最初のポイントをPOINTとして返します。 This method implements the SQL/MM specification. SQL-MM 3: 7.1.3
  • ST_SymDifference - AとBの、インタセクトしていない部分を表現するジオメトリを返します。対称と呼ばれるのは、ST_SymDifference(A,B) = ST_SymDifference(B,A) となるからです。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.21
  • ST_Touches - ジオメトリが共通のポイントを少なくとも一つ持ち、かつ内部でインタセクトしない場合に、TRUEを返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.28
  • ST_Transform - Return a new geometry with its coordinates transformed to a different spatial reference. This method implements the SQL/MM specification. SQL-MM 3: 5.1.6
  • ST_Union - ジオメトリの結合の点集合を表現するジオメトリを返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.19 ポリゴンが含まれる時、Z値 (標高)を持ちます。
  • ST_WKBToSQL - Well-Known Binary表現 (WKB)からST_Geometry値を生成します。これはSRIDを取らないST_GeomFromWKBの別名です。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.36
  • ST_WKTToSQL - Well-Knwon Text表現 (WKT)から指定したST_Geometry値を返します。これはST_GeomFromTextの別名です。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.34
  • ST_Within - ジオメトリAが完全にジオメトリBの内側にある場合にTRUEを返します。 This method implements the SQL/MM specification. SQL-MM 3: 5.1.30
  • ST_X - ポイントのX座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。 This method implements the SQL/MM specification. SQL-MM 3: 6.1.3
  • ST_Y - ポイントのY座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。 This method implements the SQL/MM specification. SQL-MM 3: 6.1.4
  • ST_Z - ポイントのZ座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。 This method implements the SQL/MM specification.

14.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 - ポリゴンまたはマルチポリゴンの場合にはサーフェスの面積を返します。ジオメトリ型の面積はSRIDに基づく単位です。ジオグラフィ型の面積は曲面上で計算され、単位は平方メートルです。
  • ST_AsBinary - ジオメトリ/ジオグラフィのSRIDメタデータのないWell-Known Binary (WKB)表現を返します
  • ST_AsEWKT - ジオメトリのSRIDメタデータが付いたWell-Known Text (WKT)表現を返します。
  • ST_AsGML - GML第2版または第3版としてジオメトリを返します。
  • ST_AsGeoJSON - GeoJSON要素としてジオメトリを返します。
  • ST_AsKML - ジオメトリをKML要素で返します。いくつかの形式があります。デフォルトはversion=2, precision=15です。
  • ST_AsSVG - ジオメトリまたはジオグラフィで与えられたSVGパスデータによるジオメトリを返します。
  • ST_AsText - ジオメトリ/ジオグラフィのSRIDメタデータのないWell-Known Text (WKT)表現を返します。
  • ST_Azimuth - pointAの鉛直線からPointBへの右回りの方位を北を基準にしたラジアン単位で返します。
  • ST_Buffer - (T) Returns a geometry covering all points within a given distance from the input geometry.
  • ST_CoveredBy - ジオメトリ/ジオグラフィAの点がジオメトリ/ジオグラフィBの外に無い場合に、1 (TRUE)を返します。
  • ST_Covers - ジオメトリBにジオメトリAの外となるポイントが無い場合には、1 (TRUE)を返します。
  • ST_DWithin - ジオメトリが指定したジオメトリから指定した距離内にある場合にTRUEを返します。ジオメトリについては、距離は空間参照系で定義されている単位になります。ジオグラフィについては、メートル単位で、デフォルトではuse_spheroid=true (回転楕円体を使った計算)となり、速いチェックをするにはuse_spheroid=falseとして球面を使って計算します。
  • ST_Distance - ジオメトリ型については、二つのジオメトリの、2次元の最小デカルト距離 (空間参照系に基づきます)を、投影法の単位で返します。ジオグラフィ型については、デフォルトでは、二つのジオメトリ間の測地距離をメートル単位で返します。
  • ST_GeogFromText - Well-Known Text表現または拡張WKTから指定したジオグラフィ値を返します。
  • ST_GeogFromWKB - Well-Known Binaryジオメトリ表現(WKB)または拡張WKB(EWKB)からジオグラフィインスタンスを生成します。
  • ST_GeographyFromText - Well-Known Text表現または拡張WKTから指定したジオグラフィ値を返します。
  • = - AのバウンディングボックスがBのバウンディングボックスと同じ場合にTRUEを返します。倍精度浮動小数点数のバウンディングボックスを使います。
  • ST_Intersection - (T) Returns a geometry that represents the shared portion of geomA and geomB.
  • ST_Intersects - ジオメトリ/ジオグラフィが「2次元空間で空間的にインタセクトする」 (空間に共有部分がある)場合にTRUEを返します。そうでない (非接続)場合はFALSEを返します。ジオグラフィについては、許容量は0.00001メートルです (近い点はインタセクトと考えられてしまいます)。
  • ST_Length - ジオメトリがLINESTRINGまたはMULTILINESTRINGの場合には、それらの2次元長を返します。ジオメトリでは、単位は空間参照系の単位です。ジオグラフィでは、メートル単位です (回転楕円体がデフォルトです)。
  • ST_Perimeter - ST_SrrfaceまたはST_MultiSurface (POLYGONまたはMULTIPOLYGON)の境界の長さの計測値を返します。ジオメトリでは単位は空間参照系によります。ジオグラフィではメートル単位になります。
  • ST_Project - メートル単位の距離とラジアン単位の方位とを使って始点から算出されたPOINTを返します。
  • ST_Segmentize - Return a modified geometry/geography having no segment longer than the given distance.
  • ST_Summary - ジオメトリについての要約文を返します。
  • <-> - AとBの2次元距離を返します。
  • && - Aの2次元バウンディングボックスがBの2次元バウンディングボックスとインタセクトする場合にTRUEを返します。

14.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表現を返します。
  • @ - AのバウンディングボックスがBのバウンディングボックスに含まれる場合にTRUEを返します。倍精度浮動小数点数のバウンディングボックスを使います。
  • ~ - AのバウンディングボックスがBのバウンディングボックスを含む場合にTRUEを返します。倍精度浮動小数点数のバウンディングボックスを使います。
  • = - AのバウンディングボックスがBのバウンディングボックスと同じ場合にTRUEを返します。倍精度浮動小数点数のバウンディングボックスを使います。
  • && - AのバウンディングボックスがBのバウンディングボックスとインタセクトする場合にTRUEを返します。
  • &< - AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの左にある場合にTRUEを返します。
  • &> - AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの右にある場合に TRUE を返します。
  • ~= - AのバウンディングボックスがBのバウンディングボックスと同じ場合にTRUEを返します。
  • ST_Retile - 任意のタイル化されたラスタカバレッジから構成されたタイルの集合を返します。
  • ST_AddBand - 与えられたタイプで、与えられた初期値にした新しいバンドを、与えられたインデクス位置に追加したラスタを返します。インデクス位置を指定していない場合には、バンドは末尾に追加されます。
  • ST_AsBinary - SRIDメタデータを持たないラスタのWell-Known Binary (WKB)表現を返します。
  • ST_AsGDALRaster - 指定されたGDALラスタ書式でラスタタイルを返します。ラスタ書式はコンパイルしたライブラリが対応するものです。ライブラリが対応する書式の一覧を得るにはST_GDALRasters()を使います。
  • ST_AsJPEG - ラスタの選択されたバンドを、単一のJoint Photographic Exports Group (JPEG)画像としてバイト配列で返します。バンドを指定せず、1バンドか3より多いバンドがある場合には、1番バンドを使用します。3バンドのみ指定した場合には、3バンドを使用し、RGBに対応付けます。
  • ST_AsPNG - ラスタの選択されたバンドを、単一のportable network graphics (PNG)画像としてバイト配列で返します。バンドを指定せず、1バンドか3バンドか4バンドある場合には、全てのバンドを使用します。バンドを指定せず、2バンドか4より多いバンドがある場合には、1番バンドを使用します。対象バンドはRGBまたはRGBAに対応付けられます。
  • ST_AsRaster - PostGISジオメトリをPostGISラスタに変換します。
  • ST_AsTIFF - ラスタの選択されたバンドを、単一のTIFF画像 (バイト配列)として返します。バンドを指定しない場合には、全てのバンドの使用を試みます。
  • ST_Aspect - 標高ラスタバンドの傾斜方向 (デフォルトの単位は度)を返します。地形解析に使えます。
  • ST_Band - 既存のラスタの、一つ以上のバンドを新しいラスタとして返します。既存のラスタから新しいラスタを構築する際に使えます。
  • ST_BandIsNoData - 指定したバンドがNODATA値だけで満たされている場合には、TRUEを返します。
  • ST_BandMetaData - 指定したラスタバンドの基本的なメタデータを返します。バンド番号を指定しない場合には、1番と仮定します。
  • ST_BandNoDataValue - 指定されたバンドについてデータが無いことを表現する値を返します。バンド番号を指定しない場合には、1番と仮定します。
  • ST_BandPath - ファイルシステムに格納されているバンドのシステムファイルパスを返します。バンド番号が指定されていない場合には、1番と仮定します。
  • ST_BandPixelType - 指定したバンドのピクセルタイプを返します。バンド番号が指定されていない場合には、1番と仮定します。
  • ST_Clip - 入力ジオメトリで切り取ったラスタを返します。バンドが指定されていない場合には、全てのバンドが返されます。cropが指定されていない場合には、TRUEと仮定され、出力ラスタをクロップします。
  • ST_ColorMap - 元のラスタと指定したバンドから4個までの8BUIバンド (grayscale, RGB, RGBA)からなる新しいラスタを生成します。
  • ST_Contains - rastAの外にrastBの点が無く、rastAの内部にrastBの内部の点が一つ以上ある場合にTRUEを返します。
  • ST_ContainsProperly - rastBがrastAの内部でインタセクトし、かつrastAの境界とも外部ともインタセクトしない場合にTRUEを返します。
  • ST_ConvexHull - BandNoDataValueと等しいピクセル値を含むラスタの凸包ジオメトリを返します。一般的な形状でスキューのないラスタでは、ST_Envelopeと同じ結果になります。不規則な形状をしているか回転しているラスタでのみ使います。
  • ST_Count - ラスタまたはラスタカバレッジの指定したバンドのピクセル数を返します。バンドを指定しない場合には、1番と仮定します。exclude_nodata_valueをTRUEに設定している場合には、NODATA値と等しくないピクセルのみを数えます。
  • ST_CountAgg - 集約関数です。ラスタ集合の与えられたバンドのピクセル数を返します。バンドが指定されていない場合には、1番と仮定します。exclude_nodata_valueをTRUEに設定している場合には、NODATA値と等しくないピクセルのみを数えます。
  • ST_CoveredBy - rastAがrastBの外部に点を持たない場合にTRUEを返します。
  • ST_Covers - rastBがrastAの外部に点を持たない場合にTRUEを返します。
  • ST_DFullyWithin - rastAとrastBが指定した距離内に完全に収まる場合にTRUEを返します。
  • ST_DWithin - rastAとrastBが指定した距離内にある場合にTRUEを返します。
  • ST_Disjoint - rastAがrastBとインタセクトしない場合にTRUEを返します。
  • ST_DumpAsPolygons - 指定されたラスタバンドからgeomval (geom,val)行の集合を返します。バンドを指定しない場合のデフォルトは1です。
  • ST_DumpValues - 指定したバンドの値を2次元で得ます。
  • ST_Envelope - ラスタの範囲のポリゴン表現を返します。
  • ST_FromGDALRaster - 対応するGDALラスタファイルからラスタを返します。
  • ST_GeoReference - GDAL書式または一般的にワールドファイルでみられるESRI書式の地理参照メタデータを返します。デフォルトはGDALです。
  • ST_HasNoBand - 指定したバンド番号のバンドが無い場合には、TRUEを返します。バンド番号を指定していない場合には、1番と仮定します。
  • ST_Height - ラスタの高さをピクセル単位で返します。
  • ST_HillShade - 与えられた方位、高度、明度、スケールの入力を使って標高ラスタバンドの仮想照明を返します。
  • ST_Histogram - ラスタまたはラスタカバレッジのビン範囲で分割したデータ分布をまとめるヒストグラムの集合を返します。ビン数を指定しない場合には自動計算されます。
  • ST_Intersection - 二つのラスタの共有部分またはベクタ化したラスタとジオメトリとのインタセクトした部分を表現する、ラスタまたはジオメトリとピクセル値の組の集合を返します。
  • ST_Intersects - rastAがrastBとインタセクトする場合にTRUEを返します。
  • ST_IsEmpty - ラスタが空 (幅が0で高さが0)の場合にはTRUEを返します。他の場合には、FALSEを返します。
  • ST_MakeEmptyRaster - 与えられたピクセル範囲 (width & height)、左上のX,Y、ピクセルサイズ、回転 (scalex, scaley, skewx, skewy)と空間参照系 (srid)が指定された空ラスタ (バンドを持たないラスタ)を返します。ラスタが渡されると、新しいラスタは渡されたラスタと同じサイズ、アラインメント、SRIDになります。SRIDが指定されていない場合には、空間参照系は不明 (0)とされます。
  • ST_MapAlgebra - コールバック関数版 - 一つ以上の入力ラスタ、バンドインデクスと一つのユーザ定義コールバック関数から、一つのバンドからなるラスタを返します。
  • ST_MapAlgebraExpr - 1バンド版: 入力バンドに対する妥当なPostgreSQL代数演算で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、1番を仮定します。
  • ST_MapAlgebraExpr - 2バンド版: 二つの入力バンドに対する妥当なPostgreSQL代数演算で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、どちらも1番と仮定します。結果ラスタは、一つ目のラスタのアラインメント (スケール、スキュー、ピクセル角位置)にあわされます。範囲は"extenttype"引数で定義されます。取りうる"extenttype"の値はINTERSECTION, UNION, FIRST, SECONDです。
  • ST_MapAlgebraFct - 1バンド版 - 入力バンドに対する妥当なPostgreSQL関数で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、1番と仮定します。
  • ST_MapAlgebraFct - 2バンド版 - 二つの入力バンドに対する妥当なPostgreSQL関数で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、1番と仮定します。"extenttype"のデフォルトはINTERSECTIONです。
  • ST_MapAlgebraFctNgb - 1バンド版: ユーザ定義PostgreSQL関数を使用する最近傍地図代数関数です。入力ラスタバンドの近傍の値を与えたPL/pgSQLユーザ定義関数の結果からなるラスタを返します。
  • ST_MapAlgebra - 数式版 - 一つか二つの入力ラスタ、バンド番号、一つ以上のユーザ定義SQL式から一つのバンドを持つラスタを返します。
  • ST_MemSize - ラスタが取る領域の合計をバイト単位で返します。
  • ST_MetaData - ピクセル数、回転 (スキュー)、左上隅位置等のラスタオブジェクトに関する基本的なメタデータを返します。
  • ST_MinConvexHull - NODATA値を除いたラスタの凸包ジオメトリを返します。
  • ST_NearestValue - 与えられたバンドの、columnxとrowyで指定されるか、またはラスタと同じ空間参照系で表現されたポイントで指定されたピクセルに最も近いNODATAでない値を返します。
  • ST_Neighborhood - 与えられたバンドのcolumnX, columnYか、ラスタと同じ空間参照系のジオメトリポイントで指定されたピクセルの周囲にある、NODATAでない2次元倍精度浮動小数点数配列を返します。
  • ST_NotSameAlignmentReason - ラスタが同じアラインメントを持つかどうか、また、持たない場合にはその理由を示す文字列を返します。
  • ST_NumBands - ラスタオブジェクトのバンド数を返します。
  • ST_Overlaps - rastAとrastBがインタセクトして、かつ一方がもう一方に完全には包含されない場合にはTRUEを返します。
  • 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値でないピクセル値を持つピクセルの結合で形成されるマルチポリゴンジオメトリを返します。バンドを指定しない場合のデフォルトは1です。
  • ST_Quantile - ラスタまたはラスタテーブルカバレッジのサンプルまたは母集団の分位数を計算します。値がラスタの25%,50%,75%にあるかを調べることができます。
  • ST_RasterToWorldCoord - ラスタの指定した列と行における左上隅の地理座標X値とY値 (経度と緯度)を返します。列と行の番号は1始まりです。
  • ST_RasterToWorldCoordX - ラスタの指定した列と行における左上隅の地理座標のX値を返します。列と行の番号は1始まりです。
  • ST_RasterToWorldCoordY - ラスタの指定した列と行における左上隅の地理座標のY値を返します。列と行の番号は1始まりです。
  • ST_Reclass - 元のラスタから再分類したバンドタイプからなるラスタを生成します。nbandは変更するバンドです。nbandが指定されていない場合には、1と仮定します。他の全てのバンドは変更せずに返します。可視画像の書式としてより単純な描画を行うために、16BUIバンドを8BUIバンドに変換する、等のために使います。
  • ST_Resample - 指定したリサンプリングアルゴリズム、新しいピクセル範囲、グリッドの隅、定義するか他のラスタから借りてきた地理参照属性を使ってリサンプリングを行います。
  • ST_Rescale - スケール (ピクセルサイズ)だけを調整するリサンプリングを行います。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最近傍補間です。
  • ST_Resize - ラスタを新しい幅、高さにサイズ再設定を行います。
  • ST_Reskew - キュー (回転パラメタ)だけを調整するリサンプリングを行います。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最近傍補間です。
  • ST_Rotation - ラスタの回転をラジアンで返します。
  • ST_Roughness - DEMの「粗度」を計算したラスタを返します。
  • ST_SRID - ラスタのspatial_ref_sysテーブルで定義されている空間参照系識別番号を返します。
  • ST_SameAlignment - ラスタが同じスキュー、スケール、空間参照系、オフセットを持つ (ピクセルが分割されることなく同じグリッドに置かれている)場合にTRUEを返し、そうでない場合は問題を詳述する通知とともにFALSEを返します。
  • ST_ScaleX - 空間参照系の地理的な単位でのピクセル幅のX成分を返します。
  • ST_ScaleY - 空間参照系の地理的な単位でのピクセル幅のY成分を返します。
  • ST_SetBandIsNoData - バンドのisnodataフラグをTRUEにします。
  • ST_SetBandNoDataValue - 指定したバンドにNODATAを表現する値を設定します。バンドを指定しない場合には、1番と仮定します。NODATA値を持たないようにするには、nodatavalueにNULLを指定します。
  • ST_SetGeoReference - 地理参照6パラメタを一度に設定します。数値は空白で区切ります。GDALまたはESRI書式の入力を受け付けます。デフォルトはGDALです。
  • ST_SetRotation - ラスタの回転をラジアン単位で設定します。
  • ST_SetSRID - スタのSRIDをspatial_ref_sysに定義されている特定の整数値に設定します。
  • ST_SetScale - ピクセルサイズのX値とY値を空間参照系の単位で設定します。数値は単位/ピクセルの幅または高さです。
  • ST_SetSkew - 地理参照のスキュー (回転パラメタ)のX値とY値を設定します。一つだけ渡した場合には、X値とY値は同じ値に設定されます。
  • ST_SetUpperLeft - ラスタの左上隅の投影座標系のX値とY値を設定します。
  • ST_SetValue - 与えられたバンドのcolumnX, columnYか、ラスタと同じ空間参照系のジオメトリポイントで指定されたピクセルの値または指定したジオメトリとインタセクトするピクセル群の値を設定することから得られる、変更されたラスタを返します。バンド番号は1始まりで、指定しない場合には、1番と仮定します。
  • ST_SetValues - 与えられたバンドに複数の値を設定して、変更されたラスタを返します。
  • ST_SkewX - 空間参照のXスキュー (回転パラメータ)を返します。
  • ST_SkewY - 空間参照のYスキュー (回転パラメータ)を返します。
  • ST_Slope - 標高ラスタバンドの傾斜角 (デフォルトでは度単位)を返します。地形解析に使えます。
  • ST_SnapToGrid - グリッドにスナップすることでラスタをリサンプリングします。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間('Lanczos')を用います。デフォルトは最近傍補間です。
  • ST_Summary - ラスタの中身の概要が文字列で返されます。
  • ST_SummaryStats - ラスタまたはラスタカバレッジの指定したバンドについて、ピクセル数、合計値、平均値、標準偏差、最小値、最大値からなる統計情報の概要を返します。バンドを指定しない場合には、1番と仮定します。
  • ST_SummaryStatsAgg - 集約関数です。ラスタ集合の指定したバンドについて、ピクセル数、合計値、平均値、標準偏差、最小値、最大値からなる統計情報の概要を返します。バンドを指定しない場合には、1番と仮定します。
  • ST_TPI - 地形的位置指数を計算したラスタを返します。
  • ST_TRI - 起伏指標を計算したラスタを返します。
  • ST_Tile - 求められた出力ラスタのピクセル数に基づいて入力ラスタを分割した結果のラスタ集合を返します。
  • ST_Touches - rastAとrastBが少なくとも一つの共通の点を持ち、かつ二つのラスタの内部同士がインタセクトしない場合にTRUEを返します。
  • ST_Transform - ラスタを既知の空間参照系から他の既知の空間参照系に、指定したリサンプリングアルゴリズムで投影変換します。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最近傍補間です。
  • ST_Union - ラスタタイルの集合を結合して1以上のバンドからなる単一ラスタを返します。
  • ST_UpperLeftX - 適用されている空間参照系でのラスタの左上隅のX座標値を返します。
  • ST_UpperLeftY - 適用されている空間参照系でのラスタの左上隅のY座標値を返します。
  • ST_Value - 指定したバンドにおけるcolumnx, rowyで指定したピクセルまたは指定したジオメトリポイントに対応するピクセルの値を返します。 バンド番号は1始まりで、指定しない場合には、1番と仮定します。exclude_nodata_valueがFALSEに設定された場合には、NODATAピクセルを含む全てのピクセルがインタセクトするかが考慮され、値を返します。exclude_nodata_valueを渡さない場合には、ラスタのメタデータから読みます。
  • ST_ValueCount - ラスタ (またはラスタカバレッジ)の指定されたバンドで、指定した値を持つピクセルを対象として、ピクセルバンド値とピクセル数からなるレコードの集合を返します。バンドを指定しない場合には、1番と仮定します。デフォルトではNODATA値のピクセルは数えられず、ピクセルの他の値は出力され、ピクセルバンド値は最も近い整数に丸められます。
  • ST_Width - ラスタの幅をピクセル単位で返します。
  • ST_Within - rastAがrastBの外部に点を持たず、rastAの内部の少なくとも一つの点がrastBの内部にある場合にTRUEを返します。
  • ST_WorldToRasterCoord - ラスタの空間参照系による地理座標のX値とY値 (経度と緯度)またはポイントジオメトリに対応するピクセルの左上隅を返します。
  • ST_WorldToRasterCoordX - ラスタの空間参照系に基づくポイントジオメトリ (pt)またはX,Y座標値 (xw,yw)に対応するラスタの列を返します。
  • ST_WorldToRasterCoordY - ラスタの空間参照系に基づくポイントジオメトリ (pt)またはX,Y座標値 (xw,yw)に対応するラスタの行を返します。
  • UpdateRasterSRID - ユーザが指定したカラムとテーブルにあるラスタの全てについてSRIDを変更します。

14.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 - 二つのラスタの共有部分またはベクタ化したラスタとジオメトリとのインタセクトした部分を表現する、ラスタまたはジオメトリとピクセル値の組の集合を返します。
  • ST_Dump - ジオメトリg1から作られたgeometry_dump(geom, path)行の集合を返します。
  • ST_DumpPoints - ジオメトリを作る全ての点のgometry_dump(geom,path)行の集合を返します。
  • ST_DumpRings - ポリゴンの外環と内環を表すgeometry_dump行の集合を返します。

14.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 - ジオメトリの最大範囲を表すBOX2Dを返します。
  • Box3D - ジオメトリの最大範囲を表すBOX3Dを返します。
  • Box3D - ラスタを囲むボックスのbox3d表現を返します。
  • ST_3DExtent - ジオメトリのbox3Dバウンディングボックスを返す集約関数です。
  • ST_3DMakeBox - 与えられた3次元ポイントジオメトリから定義されるBOX3Dを生成します。
  • ST_AsTWKB - TWKB (Tiny Well-Known Binary)としてジオメトリを出力します。
  • ST_Box2dFromGeoHash - GeoHash文字列からBOX2Dを返します。
  • ST_ClipByBox2D - 長方形内に落ちるジオメトリの一部を返します。
  • ST_EstimatedExtent - Return the 'estimated' extent of the given spatial table. The estimated is taken from the geometry column's statistics. The current schema will be used if not specified.
  • ST_Expand - 入力ジオメトリのバウンディングボックスから全ての方向に拡張されたバウンディングボックスを返します。倍精度浮動小数点数を使います。
  • ST_Extent - ジオメトリのバウンディングボックスを返す集約関数です。
  • ST_MakeBox2D - 与えられたポイントジオメトリから定義されるBOX2Dを生成します。
  • ST_XMax - 2次元、3次元バウンディングボックスまたはジオメトリにおけるXの最大値を返します。
  • ST_XMin - 2次元、3次元バウンディングボックスまたはジオメトリにおけるXの最小値を返します。
  • ST_YMax - 2次元、3次元バウンディングボックスまたはジオメトリにおけるYの最大値を返します。
  • ST_YMin - 2次元、3次元バウンディングボックスまたはジオメトリにおけるYの最小値を返します。
  • ST_ZMax - 2次元、3次元バウンディングボックスまたはジオメトリにおけるZの最大値を返します。
  • ST_ZMin - 2次元、3次元バウンディングボックスまたはジオメトリにおけるZの最大値を返します。
  • ~(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).

14.8. PostGIS Functions that support 3D

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

  • AddGeometryColumn - ジオメトリカラムを既存の属性テーブルに追加します。デフォルトでは、制約の定義でなく型の変更を使います。use_typmodにfalseを渡すと制約ベースの古い挙動で動作します。
  • Box3D - ジオメトリの最大範囲を表すBOX3Dを返します。
  • DropGeometryColumn - ジオメトリカラムを空間テーブルから除去します。
  • GeometryType - ジオメトリ型を'LINESTRING', 'POLYGON', 'MULTIPOINT'などの文字列で返します。
  • ST_3DArea - 3次元の面ジオメトリの面積を計算します。立体の場合は0を返します。
  • ST_3DClosestPoint - g1上の、g2に最も近い3次元ポイントを返します。3次元最短線の一つ目のポイントです。
  • ST_3DDFullyWithin - 3次元ジオメトリが他のジオメトリとの距離が指定した範囲内ならtrueを返します。
  • ST_3DDWithin - 3次元 (XYZ)ジオメトリ型について、二つのジオメトリの3次元距離が指定した数の内にある場合にtrueを返します。
  • ST_3DDifference - 3次元の差分を計算します。
  • ST_3DDistance - ジオメトリ型について、二つのジオメトリの、3次元の最小デカルト距離 (空間参照系に基づきます)を、投影法の単位で返します。
  • ST_3DExtent - ジオメトリのbox3Dバウンディングボックスを返す集約関数です。
  • ST_3DIntersection - 3次元のインタセクトした (共有する)部分を計算します。
  • ST_3DIntersects - ジオメトリが3次元で「空間的にインタセクトする」場合にTRUEを返します。ポイント、ラインストリング、ポリゴン、多面体サーフェス (面)のみ対応します。SFCGALバックエンドによってTINも対応します。
  • ST_3DLength - LINESTRINGまたはMULTILINESTRINGに対して、ジオメトリの3次元長または2次元長を返します。
  • ST_3DLongestLine - 二つのジオメトリの3次元長が最長となるラインを返します。
  • ST_3DMaxDistance - ジオメトリ型について、二つのジオメトリの、3次元の最大デカルト距離 (空間参照系に基づきます)を、投影法の単位で返します。
  • ST_3DPerimeter - POLYGONまたはMULTIPOLYGONジオメトリの場合には、3次元周囲長を返します。
  • ST_3DShortestLine - 二つのジオメトリの3次元長が最短となるラインを返します。
  • ST_3DUnion - 3次元の結合を計算します。
  • ST_Accum - 集約関数です。ジオメトリの配列を生成します。
  • ST_AddMeasure - 始点と終点の間を線型補完した、M値を持つ派生ジオメトリを返します。
  • ST_AddPoint - Add a point to a LineString.
  • ST_Affine - Apply a 3d affine transformation to a geometry.
  • ST_ApproximateMedialAxis - 面ジオメトリの近似的な中心軸を計算します。
  • ST_AsBinary - ジオメトリ/ジオグラフィのSRIDメタデータのないWell-Known Binary (WKB)表現を返します
  • ST_AsEWKB - ジオメトリのSRIDメタデータが付いたWell-Known Binary (WKB)表現を返します。
  • ST_AsEWKT - ジオメトリのSRIDメタデータが付いたWell-Known Text (WKT)表現を返します。
  • ST_AsGML - GML第2版または第3版としてジオメトリを返します。
  • ST_AsGeoJSON - GeoJSON要素としてジオメトリを返します。
  • ST_AsHEXEWKB - ジオメトリのHEXEWKB表現を (文字列として)返します。リトルエンディアン (NDR)またはビッグエンディアン (XDR)のどちらかのエンコーディングを使います。
  • ST_AsKML - ジオメトリをKML要素で返します。いくつかの形式があります。デフォルトはversion=2, precision=15です。
  • ST_AsX3D - ジオメトリをX3Dノード要素書式 (ISO-IEC-19776-1.2-X3DEncodings-XML)で返します。
  • ST_Boundary - ジオメトリの組み合わせ境界の閉包を返します。
  • ST_BoundingDiagonal - 与えられたジオメトリのバウンディングボックスの対角線を返します。
  • ST_CPAWithin - トラジェクトリの最接近点が空間的な距離内にある場合にはTRUEを返します。
  • ST_ClosestPointOfApproach - 二つのラインの最も近くなる内挿補間点のM値を返します。
  • ST_Collect - 他のジオメトリのコレクションから、指定したST_Geometry値を返します。
  • ST_ConvexHull - 凸包は与えられた集合の全てのジオメトリを含む最小の閉じた凸ジオメトリです。
  • ST_CoordDim - ST_Geometry値の座標次元を返します。
  • ST_CurveToLine - Converts a CIRCULARSTRING/CURVEPOLYGON to a LINESTRING/POLYGON
  • ST_DelaunayTriangles - 与えられたポイントの周りのドロネー三角形を返します。
  • ST_Difference - ジオメトリBにインタセクトしないジオメトリAの部分を表現するジオメトリを返します。
  • ST_DistanceCPA - 二つのトラジェクトリの最接近時の距離を返します。
  • ST_Dump - ジオメトリg1から作られたgeometry_dump(geom, path)行の集合を返します。
  • ST_DumpPoints - ジオメトリを作る全ての点のgometry_dump(geom,path)行の集合を返します。
  • ST_DumpRings - ポリゴンの外環と内環を表すgeometry_dump行の集合を返します。
  • ST_EndPoint - LINESTRINGの最後のポイントをPOINTで返します。
  • ST_ExteriorRing - POLYGONの外環を表現するラインストリングを返します。ジオメトリがポリゴンでない場合はNULLを返します。マルチポリゴンでは動作しません。
  • ST_Extrude - 関連するボリュームにサーフェスを押し出します。
  • ST_FlipCoordinates - 与えられたジオメトリのX軸とY軸とを入れ替えたものを返します。緯度/経度のフィーチャーを構築して、これを訂正したい場合に使えます。
  • ST_Force2D - Force the geometries into a "2-dimensional mode".
  • ST_ForceCurve - Upcast a geometry into its curved type, if applicable.
  • ST_ForceLHR - LHR (Left Hand Rule)方向に強制します。
  • ST_ForceRHR - Force the orientation of the vertices in a polygon to follow the Right-Hand-Rule.
  • ST_ForceSFS - Force the geometries to use SFS 1.1 geometry types only.
  • ST_Force_3D - Force the geometries into XYZ mode. This is an alias for ST_Force3DZ.
  • ST_Force_3DZ - Force the geometries into XYZ mode.
  • ST_Force_4D - Force the geometries into XYZM mode.
  • ST_Force_Collection - Convert the geometry into a GEOMETRYCOLLECTION.
  • ST_GeomFromEWKB - 拡張Well-Known Binary表現 (EWKB)から指定したST_Geometry値を返します。
  • ST_GeomFromEWKT - 拡張Well-Known Text表現 (EWKT)から指定されたST_Geometry値を返します。
  • ST_GeomFromGML - GML表現からPostGISジオメトリオブジェクトを出力します。
  • ST_GeomFromGeoJSON - ジオメトリのGeoJSON表現を入力として、PostGISジオメトリオブジェクトを出力します。
  • ST_GeomFromKML - ジオメトリのKML表現の入力をとり、PostGISジオメトリオブジェクトを出力します。
  • ST_GeometricMedian - Returns the geometric median of a MultiPoint.
  • ST_GeometryN - GEOMETRYCOLLECTION, (MULTI)POINT, (MULTI)LINESTRING, MULTICURVE, (MULTI)POLYGON, POLYHEDRALSURFACEの場合には、1始まりでN番目のジオメトリを返します。それ以外の場合にはNULLを返します。
  • ST_GeometryType - ST_Geometry値のジオメトリ型を返します。
  • ST_HasArc - ジオメトリまたはジオメトリコレクションが曲線ストリングを含む場合にTRUEを返します。
  • ST_InteriorRingN - ポリゴンのN番目の内環を返します。ジオメトリがポリゴンでないかNが範囲外の場合はNULLを返します。
  • ST_InterpolatePoint - ジオメトリの、指定したポイントに近いポイントにおけるM値を返します。
  • ST_IsClosed - LINESTRINGの始点と終点が一致する場合にTRUEを返します。多面体サーフェスの場合は閉じているかどうか (ボリュームであるかどうか)を返します。
  • ST_IsCollection - 引数がコレクション(MULTI*, GEOMETRYCOLLECTION, ...)の場合にTRUEを返します。
  • ST_IsPlanar - サーフェスが平面であるかないかをチェックします。
  • ST_IsSimple - ジオメトリが自己インタセクションや自己接触のような異常な幾何学ポイントを持っていない場合にTRUEを返します。
  • ST_IsSolid - ジオメトリが立体であるかどうかをテストします。妥当性チェックは行いません。
  • ST_IsValidTrajectory - ジオメトリが妥当なトラジェクトリの場合にはtrueを返します。
  • ST_Length_Spheroid - Calculates the 2D or 3D length/perimeter of a geometry on an ellipsoid. This is useful if the coordinates of the geometry are in longitude/latitude and a length is desired without reprojection.
  • ST_LineFromMultiPoint - マルチポイントジオメトリからラインストリングを生成します。
  • ST_LineInterpolatePoint - 線に沿った内挿点を返します。第2引数はfloat8で0から1の区間で、そのポイントが位置するラインストリングの総延長についての割合です。
  • ST_LineSubstring - 次元長に対する割合で示された開始位置と終了位置で切り取られた部分ラインストリングを返します。第2引数と第3引数は、float8で0から1の区間です。
  • ST_LineToCurve - Converts a LINESTRING/POLYGON to a CIRCULARSTRING, CURVEPOLYGON
  • ST_LocateBetweenElevations - 指定したZ値の範囲内にある要素からなる、派生ジオメトリ (コレクション)値を返します。3次元、4次元のLINESTRINGSとMULTILINESTRINGSのみに対応しています。
  • ST_M - ポイントのM座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。
  • ST_MakeLine - Creates a Linestring from point, multipoint, or line geometries.
  • ST_MakePoint - Creates a 2D,3DZ or 4D point geometry.
  • ST_MakePolygon - 与えられた外環で形成されるポリゴンを生成します。入力ジオメトリは閉じたラインストリングでなければなりません。
  • ST_MakeSolid - ジオメトリを立体にキャストします。チェックはしません。妥当な立体を得るには、入力ジオメトリは閉じた多面体サーフェスか閉じたTINでなければなりません。
  • ST_MakeValid - 頂点を失うことなしに不正なジオメトリを妥当なジオメトリにしようと試みます。
  • ST_MemSize - ジオメトリが取る容量 (バイト単位)を返します。
  • ST_MemUnion - ST_Unionと同じですが、メモリフレンドリ (少ないメモリ使用、多いCPU時間)です。
  • ST_NDims - ジオメトリの座標次元をsmall intで返します。値は2, 3, 4のいずれかです。
  • ST_NPoints - ジオメトリのポイント (頂点)数を返します。
  • ST_NRings - ジオメトリがポリゴンまたはマルチポリゴンの場合、リング数を返します。
  • ST_Node - ラインストリングの集合にノードを作成します。
  • ST_NumGeometries - ジオメトリがジオメトリコレクションまたはマルチ系の場合はジオメトリの数を、単一のジオメトリの場合は1を返し、それ以外の場合はNULLを返します。
  • ST_NumPatches - 多面体サーフェスのフェイス数を返します。多面体でないジオメトリの場合にはNULLを返します。
  • ST_Orientation - サーフェスの方向を判定します。
  • ST_PatchN - ジオメトリがPOLYHEDRALSURFACEかPOLYHEDRALSURFACEMの場合には、1始まりでN番目のジオメトリ (フェイス)を返します。それ以外の場合には、NULLを返します。
  • ST_PointFromWKB - WKBと与えられたSRIDからジオメトリを生成します。
  • ST_PointN - Return the Nth point in the first LineString or circular LineString in the geometry. Negative values are counted backwards from the end of the LineString. Returns NULL if there is no linestring in the geometry.
  • ST_PointOnSurface - サーフェス上にあることを保障されたPOINTを返します。
  • ST_Points - Returns a MultiPoint containing all of the coordinates of a geometry.
  • ST_Polygon - 指定されたラインストリングとSRIDからポリゴンを生成します。
  • ST_RemovePoint - Remove point from a linestring.
  • ST_RemoveRepeatedPoints - 入力ジオメトリから重複ポイントを除いたものを返します。
  • ST_Rotate - ジオメトリを、原点について反時計回りにrotRadiasnぶん回転させます。
  • ST_RotateX - ジオメトリをX軸についてrotRadiansぶん回転させます。
  • ST_RotateY - ジオメトリgeomAをY軸についてrotRadiansぶん回転させます。
  • ST_RotateZ - ジオメトリをZ軸についてrotRadiansぶん回転させます。
  • ST_Scale - Scale a geometry by given factors.
  • ST_SetPoint - Replace point of a linestring with a given point.
  • ST_Shift_Longitude - Toggle geometry coordinates between -180..180 and 0..360 ranges.
  • ST_SnapToGrid - 入力ジオメトリの全ての点を規則的なグリッドにスナップします。
  • ST_StartPoint - LINESTRINGの最初のポイントをPOINTとして返します。
  • ST_StraightSkeleton - ジオメトリからストレートスケルトンを計算します。
  • ST_SwapOrdinates - 与えられたジオメトリにおいて与えられた座標の値を入れ替えたジオメトリを返します。
  • ST_SymDifference - AとBの、インタセクトしていない部分を表現するジオメトリを返します。対称と呼ばれるのは、ST_SymDifference(A,B) = ST_SymDifference(B,A) となるからです。
  • ST_Tesselate - ポリゴンまたは多面体サーフェスのテッセレーションを計算し、TINまたはTINコレクションを返します。
  • ST_TransScale - Translate a geometry by given factors and offsets.
  • ST_Translate - Translate a geometry by given offsets.
  • ST_UnaryUnion - ST_Unionに似ていますが、ジオメトリ要素レベルで動作します。
  • ST_Volume - 3次元立体の体積を計算します。面ジオメトリは (閉じていても)0を返します。
  • ST_WrapX - Wrap a geometry around an X value.
  • ST_X - ポイントのX座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。
  • ST_XMax - 2次元、3次元バウンディングボックスまたはジオメトリにおけるXの最大値を返します。
  • ST_XMin - 2次元、3次元バウンディングボックスまたはジオメトリにおけるXの最小値を返します。
  • ST_Y - ポイントのY座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。
  • ST_YMax - 2次元、3次元バウンディングボックスまたはジオメトリにおけるYの最大値を返します。
  • ST_YMin - 2次元、3次元バウンディングボックスまたはジオメトリにおけるYの最小値を返します。
  • ST_Z - ポイントのZ座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。
  • ST_ZMax - 2次元、3次元バウンディングボックスまたはジオメトリにおけるZの最大値を返します。
  • ST_ZMin - 2次元、3次元バウンディングボックスまたはジオメトリにおけるZの最大値を返します。
  • ST_Zmflag - ポイントのZM (次元の意味)フラグをsmall intで返します。値は 0=XY, 1=XYM, 2=XYZ, 3=XYZMとなります。
  • TG_Equals - 二つのTopoGeometryが同じトポロジプリミティブで成っている場合にtrueを返します。
  • TG_Intersects - 二つのTopoGeometryからのプリミティブの組がインタセクトする場合にtrueを返します。
  • UpdateGeometrySRID - ジオメトリカラムの全てのフィーチャーのSRID、geometry_columnsメタデータとSRIDテーブル制約を更新します。制約付きの場合には、制約が新しいSRID制約に更新されます。型定義付きの場合は、型定義が変更されます。
  • 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_version - 使用しているSFCGALの版を返します

14.9. PostGIS Curved Geometry Support Functions

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

  • AddGeometryColumn - ジオメトリカラムを既存の属性テーブルに追加します。デフォルトでは、制約の定義でなく型の変更を使います。use_typmodにfalseを渡すと制約ベースの古い挙動で動作します。
  • Box2D - ジオメトリの最大範囲を表すBOX2Dを返します。
  • Box3D - ジオメトリの最大範囲を表すBOX3Dを返します。
  • DropGeometryColumn - ジオメトリカラムを空間テーブルから除去します。
  • GeometryType - ジオメトリ型を'LINESTRING', 'POLYGON', 'MULTIPOINT'などの文字列で返します。
  • PostGIS_AddBBox - ジオメトリにバウンディングボックスを追加します。
  • PostGIS_DropBBox - ジオメトリからバウンディングボックスのキャッシュを削除します。
  • PostGIS_HasBBox - ジオメトリのバウンディングボックスがキャッシュされている場合にはTRUEを返し、他の場合にはFALSEを返します。
  • ST_3DExtent - ジオメトリのbox3Dバウンディングボックスを返す集約関数です。
  • ST_Accum - 集約関数です。ジオメトリの配列を生成します。
  • ST_Affine - Apply a 3d affine transformation to a geometry.
  • ST_AsBinary - ジオメトリ/ジオグラフィのSRIDメタデータのないWell-Known Binary (WKB)表現を返します
  • ST_AsEWKB - ジオメトリのSRIDメタデータが付いたWell-Known Binary (WKB)表現を返します。
  • ST_AsEWKT - ジオメトリのSRIDメタデータが付いたWell-Known Text (WKT)表現を返します。
  • ST_AsHEXEWKB - ジオメトリのHEXEWKB表現を (文字列として)返します。リトルエンディアン (NDR)またはビッグエンディアン (XDR)のどちらかのエンコーディングを使います。
  • ST_AsText - ジオメトリ/ジオグラフィのSRIDメタデータのないWell-Known Text (WKT)表現を返します。
  • ST_Collect - 他のジオメトリのコレクションから、指定したST_Geometry値を返します。
  • ST_CoordDim - ST_Geometry値の座標次元を返します。
  • ST_CurveToLine - Converts a CIRCULARSTRING/CURVEPOLYGON to a LINESTRING/POLYGON
  • ST_Distance - ジオメトリ型については、二つのジオメトリの、2次元の最小デカルト距離 (空間参照系に基づきます)を、投影法の単位で返します。ジオグラフィ型については、デフォルトでは、二つのジオメトリ間の測地距離をメートル単位で返します。
  • ST_Dump - ジオメトリg1から作られたgeometry_dump(geom, path)行の集合を返します。
  • ST_DumpPoints - ジオメトリを作る全ての点のgometry_dump(geom,path)行の集合を返します。
  • ST_EndPoint - LINESTRINGの最後のポイントをPOINTで返します。
  • ST_EstimatedExtent - Return the 'estimated' extent of the given spatial table. The estimated is taken from the geometry column's statistics. The current schema will be used if not specified.
  • ST_FlipCoordinates - 与えられたジオメトリのX軸とY軸とを入れ替えたものを返します。緯度/経度のフィーチャーを構築して、これを訂正したい場合に使えます。
  • ST_Force2D - Force the geometries into a "2-dimensional mode".
  • ST_ForceCurve - Upcast a geometry into its curved type, if applicable.
  • ST_ForceSFS - Force the geometries to use SFS 1.1 geometry types only.
  • ST_Force3D - Force the geometries into XYZ mode. This is an alias for ST_Force3DZ.
  • ST_Force3DM - Force the geometries into XYM mode.
  • ST_Force3DZ - Force the geometries into XYZ mode.
  • ST_Force4D - Force the geometries into XYZM mode.
  • ST_ForceCollection - Convert the geometry into a GEOMETRYCOLLECTION.
  • ST_GeoHash - ジオメトリのGeoHash表現を返します。
  • ST_GeogFromWKB - Well-Known Binaryジオメトリ表現(WKB)または拡張WKB(EWKB)からジオグラフィインスタンスを生成します。
  • ST_GeomFromEWKB - 拡張Well-Known Binary表現 (EWKB)から指定したST_Geometry値を返します。
  • ST_GeomFromEWKT - 拡張Well-Known Text表現 (EWKT)から指定されたST_Geometry値を返します。
  • ST_GeomFromText - Well-Known Text表現 (WKT)から指定したST_Geometryを返します。
  • ST_GeomFromWKB - Well-Knwon Binaryジオメトリ表現 (WKB)と任意パラメタのSRIDからジオメトリインスタンスを生成します。
  • ST_GeometryN - GEOMETRYCOLLECTION, (MULTI)POINT, (MULTI)LINESTRING, MULTICURVE, (MULTI)POLYGON, POLYHEDRALSURFACEの場合には、1始まりでN番目のジオメトリを返します。それ以外の場合にはNULLを返します。
  • = - AのバウンディングボックスがBのバウンディングボックスと同じ場合にTRUEを返します。倍精度浮動小数点数のバウンディングボックスを使います。
  • &<| - AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの下にある場合にTRUEを返します。
  • ST_HasArc - ジオメトリまたはジオメトリコレクションが曲線ストリングを含む場合にTRUEを返します。
  • ST_IsClosed - LINESTRINGの始点と終点が一致する場合にTRUEを返します。多面体サーフェスの場合は閉じているかどうか (ボリュームであるかどうか)を返します。
  • ST_IsCollection - 引数がコレクション(MULTI*, GEOMETRYCOLLECTION, ...)の場合にTRUEを返します。
  • ST_IsEmpty - ジオメトリが、空のジオメトリコレクション、ポリゴン、ポイント等の場合に、trueを返します。
  • ST_LineToCurve - Converts a LINESTRING/POLYGON to a CIRCULARSTRING, CURVEPOLYGON
  • ST_MemSize - ジオメトリが取る容量 (バイト単位)を返します。
  • ST_NPoints - ジオメトリのポイント (頂点)数を返します。
  • ST_NRings - ジオメトリがポリゴンまたはマルチポリゴンの場合、リング数を返します。
  • ST_PointFromWKB - WKBと与えられたSRIDからジオメトリを生成します。
  • ST_PointN - Return the Nth point in the first LineString or circular LineString in the geometry. Negative values are counted backwards from the end of the LineString. Returns NULL if there is no linestring in the geometry.
  • ST_Points - Returns a MultiPoint containing all of the coordinates of a geometry.
  • ST_Rotate - ジオメトリを、原点について反時計回りにrotRadiasnぶん回転させます。
  • ST_RotateZ - ジオメトリをZ軸についてrotRadiansぶん回転させます。
  • ST_SRID - Returns the spatial reference identifier for the ST_Geometry as defined in spatial_ref_sys table.
  • ST_Scale - Scale a geometry by given factors.
  • ST_SetSRID - Set the SRID on a geometry to a particular integer value.
  • ST_StartPoint - LINESTRINGの最初のポイントをPOINTとして返します。
  • ST_Summary - ジオメトリについての要約文を返します。
  • ST_SwapOrdinates - 与えられたジオメトリにおいて与えられた座標の値を入れ替えたジオメトリを返します。
  • ST_TransScale - Translate a geometry by given factors and offsets.
  • ST_Transform - Return a new geometry with its coordinates transformed to a different spatial reference.
  • ST_Translate - Translate a geometry by given offsets.
  • ST_XMax - 2次元、3次元バウンディングボックスまたはジオメトリにおけるXの最大値を返します。
  • ST_XMin - 2次元、3次元バウンディングボックスまたはジオメトリにおけるXの最小値を返します。
  • ST_YMax - 2次元、3次元バウンディングボックスまたはジオメトリにおけるYの最大値を返します。
  • ST_YMin - 2次元、3次元バウンディングボックスまたはジオメトリにおけるYの最小値を返します。
  • ST_ZMax - 2次元、3次元バウンディングボックスまたはジオメトリにおけるZの最大値を返します。
  • ST_ZMin - 2次元、3次元バウンディングボックスまたはジオメトリにおけるZの最大値を返します。
  • ST_Zmflag - ポイントのZM (次元の意味)フラグをsmall intで返します。値は 0=XY, 1=XYM, 2=XYZ, 3=XYZMとなります。
  • UpdateGeometrySRID - ジオメトリカラムの全てのフィーチャーのSRID、geometry_columnsメタデータとSRIDテーブル制約を更新します。制約付きの場合には、制約が新しいSRID制約に更新されます。型定義付きの場合は、型定義が変更されます。
  • ~(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の2次元バウンディングボックスがBの2次元バウンディングボックスとインタセクトする場合に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.

14.10. PostGIS Polyhedral Surface Support Functions

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

  • Box2D - ジオメトリの最大範囲を表すBOX2Dを返します。
  • Box3D - ジオメトリの最大範囲を表すBOX3Dを返します。
  • GeometryType - ジオメトリ型を'LINESTRING', 'POLYGON', 'MULTIPOINT'などの文字列で返します。
  • ST_3DArea - 3次元の面ジオメトリの面積を計算します。立体の場合は0を返します。
  • ST_3DClosestPoint - g1上の、g2に最も近い3次元ポイントを返します。3次元最短線の一つ目のポイントです。
  • ST_3DDFullyWithin - 3次元ジオメトリが他のジオメトリとの距離が指定した範囲内ならtrueを返します。
  • ST_3DDWithin - 3次元 (XYZ)ジオメトリ型について、二つのジオメトリの3次元距離が指定した数の内にある場合にtrueを返します。
  • ST_3DDifference - 3次元の差分を計算します。
  • ST_3DDistance - ジオメトリ型について、二つのジオメトリの、3次元の最小デカルト距離 (空間参照系に基づきます)を、投影法の単位で返します。
  • ST_3DExtent - ジオメトリのbox3Dバウンディングボックスを返す集約関数です。
  • ST_3DIntersection - 3次元のインタセクトした (共有する)部分を計算します。
  • ST_3DIntersects - ジオメトリが3次元で「空間的にインタセクトする」場合にTRUEを返します。ポイント、ラインストリング、ポリゴン、多面体サーフェス (面)のみ対応します。SFCGALバックエンドによってTINも対応します。
  • ST_3DLongestLine - 二つのジオメトリの3次元長が最長となるラインを返します。
  • ST_3DMaxDistance - ジオメトリ型について、二つのジオメトリの、3次元の最大デカルト距離 (空間参照系に基づきます)を、投影法の単位で返します。
  • ST_3DShortestLine - 二つのジオメトリの3次元長が最短となるラインを返します。
  • ST_3DUnion - 3次元の結合を計算します。
  • ST_Accum - 集約関数です。ジオメトリの配列を生成します。
  • ST_Affine - Apply a 3d affine transformation to a geometry.
  • ST_ApproximateMedialAxis - 面ジオメトリの近似的な中心軸を計算します。
  • ST_Area - ポリゴンまたはマルチポリゴンの場合にはサーフェスの面積を返します。ジオメトリ型の面積はSRIDに基づく単位です。ジオグラフィ型の面積は曲面上で計算され、単位は平方メートルです。
  • ST_AsBinary - ジオメトリ/ジオグラフィのSRIDメタデータのないWell-Known Binary (WKB)表現を返します
  • ST_AsEWKB - ジオメトリのSRIDメタデータが付いたWell-Known Binary (WKB)表現を返します。
  • ST_AsEWKT - ジオメトリのSRIDメタデータが付いたWell-Known Text (WKT)表現を返します。
  • ST_AsGML - GML第2版または第3版としてジオメトリを返します。
  • ST_AsX3D - ジオメトリをX3Dノード要素書式 (ISO-IEC-19776-1.2-X3DEncodings-XML)で返します。
  • ST_CoordDim - ST_Geometry値の座標次元を返します。
  • ST_Dimension - ジオメトリの固有次元を返します。ジオメトリは座標次元以下でなければなりません。
  • ST_Dump - ジオメトリg1から作られたgeometry_dump(geom, path)行の集合を返します。
  • ST_DumpPoints - ジオメトリを作る全ての点のgometry_dump(geom,path)行の集合を返します。
  • ST_Expand - 入力ジオメトリのバウンディングボックスから全ての方向に拡張されたバウンディングボックスを返します。倍精度浮動小数点数を使います。
  • ST_Extent - ジオメトリのバウンディングボックスを返す集約関数です。
  • ST_Extrude - 関連するボリュームにサーフェスを押し出します。
  • ST_FlipCoordinates - 与えられたジオメトリのX軸とY軸とを入れ替えたものを返します。緯度/経度のフィーチャーを構築して、これを訂正したい場合に使えます。
  • ST_Force2D - Force the geometries into a "2-dimensional mode".
  • ST_ForceLHR - LHR (Left Hand Rule)方向に強制します。
  • ST_ForceRHR - Force the orientation of the vertices in a polygon to follow the Right-Hand-Rule.
  • ST_ForceSFS - Force the geometries to use SFS 1.1 geometry types only.
  • ST_Force3D - Force the geometries into XYZ mode. This is an alias for ST_Force3DZ.
  • ST_Force3DZ - Force the geometries into XYZ mode.
  • ST_ForceCollection - Convert the geometry into a GEOMETRYCOLLECTION.
  • ST_GeomFromEWKB - 拡張Well-Known Binary表現 (EWKB)から指定したST_Geometry値を返します。
  • ST_GeomFromEWKT - 拡張Well-Known Text表現 (EWKT)から指定されたST_Geometry値を返します。
  • ST_GeomFromGML - GML表現からPostGISジオメトリオブジェクトを出力します。
  • ST_GeometryN - GEOMETRYCOLLECTION, (MULTI)POINT, (MULTI)LINESTRING, MULTICURVE, (MULTI)POLYGON, POLYHEDRALSURFACEの場合には、1始まりでN番目のジオメトリを返します。それ以外の場合にはNULLを返します。
  • ST_GeometryType - ST_Geometry値のジオメトリ型を返します。
  • = - AのバウンディングボックスがBのバウンディングボックスと同じ場合にTRUEを返します。倍精度浮動小数点数のバウンディングボックスを使います。
  • &<| - AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの下にある場合にTRUEを返します。
  • ~= - AのバウンディングボックスがBのバウンディングボックスと同じ場合にTRUEを返します。
  • ST_IsClosed - LINESTRINGの始点と終点が一致する場合にTRUEを返します。多面体サーフェスの場合は閉じているかどうか (ボリュームであるかどうか)を返します。
  • ST_IsPlanar - サーフェスが平面であるかないかをチェックします。
  • ST_IsSolid - ジオメトリが立体であるかどうかをテストします。妥当性チェックは行いません。
  • ST_MakeSolid - ジオメトリを立体にキャストします。チェックはしません。妥当な立体を得るには、入力ジオメトリは閉じた多面体サーフェスか閉じたTINでなければなりません。
  • ST_MemSize - ジオメトリが取る容量 (バイト単位)を返します。
  • ST_NPoints - ジオメトリのポイント (頂点)数を返します。
  • ST_NumGeometries - ジオメトリがジオメトリコレクションまたはマルチ系の場合はジオメトリの数を、単一のジオメトリの場合は1を返し、それ以外の場合はNULLを返します。
  • ST_NumPatches - 多面体サーフェスのフェイス数を返します。多面体でないジオメトリの場合にはNULLを返します。
  • ST_PatchN - ジオメトリがPOLYHEDRALSURFACEかPOLYHEDRALSURFACEMの場合には、1始まりでN番目のジオメトリ (フェイス)を返します。それ以外の場合には、NULLを返します。
  • ST_RemoveRepeatedPoints - 入力ジオメトリから重複ポイントを除いたものを返します。
  • ST_Rotate - ジオメトリを、原点について反時計回りにrotRadiasnぶん回転させます。
  • ST_RotateX - ジオメトリをX軸についてrotRadiansぶん回転させます。
  • ST_RotateY - ジオメトリgeomAをY軸についてrotRadiansぶん回転させます。
  • ST_RotateZ - ジオメトリをZ軸についてrotRadiansぶん回転させます。
  • ST_Scale - Scale a geometry by given factors.
  • ST_ShiftLongitude - Toggle geometry coordinates between -180..180 and 0..360 ranges.
  • ST_StraightSkeleton - ジオメトリからストレートスケルトンを計算します。
  • ST_Summary - ジオメトリについての要約文を返します。
  • ST_SwapOrdinates - 与えられたジオメトリにおいて与えられた座標の値を入れ替えたジオメトリを返します。
  • ST_Tesselate - ポリゴンまたは多面体サーフェスのテッセレーションを計算し、TINまたはTINコレクションを返します。
  • ST_Transform - Return a new geometry with its coordinates transformed to a different spatial reference.
  • ST_Volume - 3次元立体の体積を計算します。面ジオメトリは (閉じていても)0を返します。
  • ~(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の2次元バウンディングボックスがBの2次元バウンディングボックスとインタセクトする場合に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.
  • postgis_sfcgal_version - 使用しているSFCGALの版を返します

14.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   
Find_SRID        
GeometryType   
ST_3DArea    
ST_3DClosestPoint     
ST_3DDFullyWithin     
ST_3DDWithin    
ST_3DDifference    
ST_3DDistance    
ST_3DExtent   
ST_3DIntersection    
ST_3DIntersects   
ST_3DLength      
ST_3DLongestLine     
ST_3DMakeBox       
ST_3DMaxDistance     
ST_3DPerimeter      
ST_3DShortestLine     
ST_3DUnion    
ST_Accum   
ST_AddMeasure      
ST_AddPoint      
ST_Affine   
ST_ApproximateMedialAxis    
ST_Area    
ST_AsBinary
ST_AsEWKB   
ST_AsEWKT  
ST_AsEncodedPolyline       
ST_AsGML   
ST_AsGeoJSON     
ST_AsHEXEWKB     
ST_AsKML     
ST_AsLatLonText       
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_ClipByBox2D       
ST_ClosestPoint       
ST_ClosestPointOfApproach      
ST_ClusterDBSCAN       
ST_ClusterIntersecting       
ST_ClusterKMeans       
ST_ClusterWithin       
ST_Collect     
ST_CollectionExtract       
ST_CollectionHomogenize       
ST_ConcaveHull       
ST_Contains      
ST_ContainsProperly       
ST_ConvexHull     
ST_CoordDim  
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_EndPoint    
ST_Envelope      
ST_Equals      
ST_EstimatedExtent      
ST_Expand     
ST_Extent     
ST_ExteriorRing     
ST_Extrude    
ST_FlipCoordinates   
ST_Force2D    
ST_ForceCurve     
ST_ForceLHR    
ST_ForceRHR     
ST_ForceSFS   
ST_Force3D    
ST_Force3DM      
ST_Force3DZ    
ST_Force4D     
ST_ForceCollection    
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_GeomFromTWKB       
ST_GeomFromText     
ST_GeomFromWKB     
ST_GeometricMedian      
ST_GeometryFromText      
ST_GeometryN  
ST_GeometryType    
|>>       
<<|       
~       
@       
=    
<<       
|&>       
&<|     
&<       
&>       
>>       
~=      
ST_HasArc     
ST_HausdorffDistance       
ST_InteriorRingN     
ST_InterpolatePoint      
ST_Intersection     
ST_Intersects     
ST_IsClosed   
ST_IsCollection     
ST_IsEmpty     
ST_IsPlanar    
ST_IsRing      
ST_IsSimple     
ST_IsSolid    
ST_IsValid      
ST_IsValidDetail       
ST_IsValidReason       
ST_IsValidTrajectory      
ST_Length     
ST_Length2D       
ST_Length2D_Spheroid       
ST_LengthSpheroid      
ST_LineCrossingDirection       
ST_LineFromEncodedPolyline       
ST_LineFromMultiPoint      
ST_LineFromText      
ST_LineFromWKB      
ST_LineInterpolatePoint      
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_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_OrderingEquals      
ST_Orientation      
ST_Overlaps      
ST_PatchN    
ST_Perimeter     
ST_Perimeter2D       
ST_Point      
ST_PointFromGeoHash        
ST_PointFromText      
ST_PointFromWKB    
ST_PointN    
ST_PointOnSurface     
ST_PointInsideCircle       
ST_Points     
ST_Polygon     
ST_PolygonFromText      
ST_Polygonize       
ST_Project       
ST_Relate      
ST_RelateMatch        
ST_RemovePoint      
ST_RemoveRepeatedPoints     
ST_Reverse       
ST_Rotate   
ST_RotateX    
ST_RotateY    
ST_RotateZ   
ST_SRID     
ST_Scale   
ST_Segmentize      
ST_SetEffectiveArea       
ST_SetPoint      
ST_SetSRID      
ST_SharedPaths       
ST_ShiftLongitude    
ST_ShortestLine       
ST_Simplify       
ST_SimplifyPreserveTopology       
ST_SimplifyVW       
ST_Snap       
ST_SnapToGrid      
ST_Split       
ST_StartPoint    
ST_StraightSkeleton    
ST_Subdivide       
ST_Summary   
ST_SwapOrdinates   
ST_SymDifference     
ST_Tesselate    
ST_Touches      
ST_TransScale     
ST_Transform    
ST_Translate     
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_sfcgal_version     

14.12. New, Enhanced or changed PostGIS Functions

[Note]

PostGIS 2.3.0: PostgreSQL 9.6+ support for parallel queries.

[Note]

PostGIS 2.3.0: PostgreSQL 9.4+ support for BRIN indexes. Refer to Section 4.6.2, “BRIN Indexes”.

[Note]

PostGIS 2.3.0: Tiger Geocoder upgraded to work with TIGER 2016 data.

14.12.1. 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).
  • Populate_Topology_Layer - Availability: 2.3.0 Adds missing entries to topology.layer table by reading metadata from topo tables.
  • ST_ClusterDBSCAN - Availability: 2.3.0 - requires GEOS Windowing function that returns integer id for the cluster each input geometry is in based on 2D implementation of Density-based spatial clustering of applications with noise (DBSCAN) algorithm.
  • ST_ClusterKMeans - Availability: 2.3.0 - requires GEOS Windowing function that returns integer id for the cluster each input geometry is in.
  • ST_GeneratePoints - Availability: 2.3.0 Converts a polygon or multi-polygon into a multi-point composed of randomly location points within the original areas.
  • ST_GeometricMedian - Availability: 2.3.0 Returns the geometric median of a MultiPoint.
  • ST_MakeLine - Availability: 2.3.0 - Support for multipoint input elements was introduced Creates a Linestring from point, multipoint, or line geometries.
  • ST_MinimumClearance - Availability: 2.3.0 - requires GEOS >= 3.6.0 Returns the minimum clearance of a geometry, a measure of a geometry's robustness.
  • ST_MinimumClearanceLine - Availability: 2.3.0 - requires GEOS >= 3.6.0 Returns the two-point LineString spanning a geometry's minimum clearance.
  • ST_Points - Availability: 2.3.0 Returns a MultiPoint containing all of the coordinates of a geometry.
  • ST_VoronoiLines - Availability: 2.3.0 - requires GEOS >= 3.5.0. Returns the boundaries between the cells of the Voronoi diagram constructed from the vertices of a geometry.
  • ST_VoronoiPolygons - Availability: 2.3.0 - requires GEOS >= 3.5.0. Returns the cells of the Voronoi diagram constructed from the vertices of a geometry.
  • ST_WrapX - Availability: 2.3.0 Wrap a geometry around an X value.
  • TopoGeom_addElement - Availability: 2.3 Add an element to the definition of a TopoGeometry
  • TopoGeom_remElement - Availability: 2.3 Remove an element from the definition of a TopoGeometry
  • ~(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).

The functions given below are PostGIS functions that are 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.
  • 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.
  • ST_Expand - Enhanced: 2.3.0 support was added to expand a box by different amounts in different dimensions.
  • 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.
  • ST_Segmentize - Enhanced: 2.3.0 Segmentize geography now uses equal length segments
  • ST_Transform - Enhanced: 2.3.0 support for direct PROJ.4 text was introduced.
  • 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.

14.12.2. PostGIS Functions new or enhanced in 2.2

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

[Note]

postgis_sfcgal now can be installed as an extension using CREATE EXTENSION postgis_sfcgal;

[Note]

PostGIS 2.2.0: Tiger Geocoder upgraded to work with TIGER 2015 data.

[Note]

address_standardizer, address_standardizer_data_us extensions for standardizing address data refer to Chapter 12, Address Standardizer for details.

[Note]

Many functions in topology rewritten as C functions for increased performance.

Functions new in PostGIS 2.2

  • ST_3DDifference - Availability: 2.2.0 3次元の差分を計算します。
  • ST_3DUnion - Availability: 2.2.0 3次元の結合を計算します。
  • ST_ApproximateMedialAxis - Availability: 2.2.0 面ジオメトリの近似的な中心軸を計算します。
  • ST_AsEncodedPolyline - Availability: 2.2.0 ラインストリングジオメトリから符号化したポリラインを返します。
  • ST_AsTWKB - Availability: 2.2.0 TWKB (Tiny Well-Known Binary)としてジオメトリを出力します。
  • ST_BoundingDiagonal - Availability: 2.2.0 与えられたジオメトリのバウンディングボックスの対角線を返します。
  • ST_ClipByBox2D - Availability: 2.2.0 - GEOS 3.5.0以上が必要です。 長方形内に落ちるジオメトリの一部を返します。
  • ST_ClusterIntersecting - Availability: 2.2.0 - requires GEOS Aggregate. Returns an array with the connected components of a set of geometries
  • ST_ClusterWithin - Availability: 2.2.0 - requires GEOS Aggregate. Returns an array of GeometryCollections, where each GeometryCollection represents a set of geometries separated by no more than the specified distance.
  • ST_CountAgg - Availability: 2.2.0 集約関数です。ラスタ集合の与えられたバンドのピクセル数を返します。バンドが指定されていない場合には、1番と仮定します。exclude_nodata_valueをTRUEに設定している場合には、NODATA値と等しくないピクセルのみを数えます。
  • ST_CreateOverview - Availability: 2.2.0 与えられたラスタカバレッジから解像度を落としたものを生成します。
  • ST_ForceCurve - Availability: 2.2.0 Upcast a geometry into its curved type, if applicable.
  • ST_IsPlanar - Availability: 2.2.0: これは2.1.0のマニュアルに記述されていましたが、2.1版では偶然に外れてしまいました。 サーフェスが平面であるかないかをチェックします。
  • ST_IsSolid - Availability: 2.2.0 ジオメトリが立体であるかどうかをテストします。妥当性チェックは行いません。
  • ST_LineFromEncodedPolyline - Availability: 2.2.0 エンコード化ポリラインからラインストリングを生成します。
  • ST_MakeSolid - Availability: 2.2.0 ジオメトリを立体にキャストします。チェックはしません。妥当な立体を得るには、入力ジオメトリは閉じた多面体サーフェスか閉じたTINでなければなりません。
  • ST_MapAlgebra - Availability: 2.2.0: Ability to add a mask コールバック関数版 - 一つ以上の入力ラスタ、バンドインデクスと一つのユーザ定義コールバック関数から、一つのバンドからなるラスタを返します。
  • ST_MemSize - Availability: 2.2.0 ラスタが取る領域の合計をバイト単位で返します。
  • ST_RemoveRepeatedPoints - Availability: 2.2.0 入力ジオメトリから重複ポイントを除いたものを返します。
  • ST_Retile - Availability: 2.2.0 任意のタイル化されたラスタカバレッジから構成されたタイルの集合を返します。
  • ST_SetEffectiveArea - Availability: 2.2.0 Sets the effective area for each vertex, storing the value in the M ordinate. A simplified geometry can then be generated by filtering on the M ordinate.
  • ST_SimplifyVW - Availability: 2.2.0 Visvalingam-Whyattアルゴリズムを用いて、入力ジオメトリを「簡略化」したジオメトリを返します。
  • ST_Subdivide - Availability: 2.2.0 GEOS 3.5.0以上が必要です。 指定した数より多い頂点を持たないジオメトリの集合を返します。
  • ST_SummaryStatsAgg - Availability: 2.2.0 集約関数です。ラスタ集合の指定したバンドについて、ピクセル数、合計値、平均値、標準偏差、最小値、最大値からなる統計情報の概要を返します。バンドを指定しない場合には、1番と仮定します。
  • ST_SwapOrdinates - Availability: 2.2.0 与えられたジオメトリにおいて与えられた座標の値を入れ替えたジオメトリを返します。
  • ST_Volume - Availability: 2.2.0 3次元立体の体積を計算します。面ジオメトリは (閉じていても)0を返します。
  • postgis.enable_outdb_rasters - Availability: 2.2.0 データベース外ラスタのバンドにアクセスできるようにする、真偽型のコンフィギュレーションオプション。
  • postgis.gdal_datapath - Availability: 2.2.0 GDALのGDAL_DATAオプションの値を設定するためのコンフィギュレーションオプションです。設定しない場合には、GDAL_DATA環境変数が使われます。
  • postgis.gdal_enabled_drivers - Availability: 2.2.0 PostGIS環境でGDALドライバを有効にするコンフィギュレーションオプションです。GDALコンフィギュレーション変数GDAL_SKIPに影響を与えます。

The functions given below are PostGIS functions that are enhanced in PostGIS 2.2.

  • AsTopoJSON - Enhanced: 2.2.1 added support for puntal inputs
  • ST_Area - Enhanced: 2.2.0 - measurement on spheroid performed with GeographicLib for improved accuracy and robustness. Requires Proj >= 4.9.0 to take advantage of the new feature.
  • ST_AsX3D - Enhanced: 2.2.0: GeoCoordinatesと軸 (x/y, 経度/緯度)の反転に対応しました。詳細はoptionsを見て下さい。
  • ST_Azimuth - Enhanced: 2.2.0 measurement on spheroid performed with GeographicLib for improved accuracy and robustness. Requires Proj >= 4.9.0 to take advantage of the new feature.
  • ST_Distance - Enhanced: 2.2.0 - measurement on spheroid performed with GeographicLib for improved accuracy and robustness. Requires Proj >= 4.9.0 to take advantage of the new feature.
  • ST_Scale - Enhanced: 2.2.0 全ての次元の拡大縮小の対応 (ジオメトリによる引数指定)を導入しました
  • ST_Summary - Enhanced: 2.2.0 Added support for TIN and Curves
  • <-> - Enhanced: 2.2.0 ジオメトリとジオグラフィとのKNN (k近傍法)の動作が本当のものになりました。ジオグラフィのKNNは回転楕円体面上でなく球面上の計算となることに注意して下さい。PostgreSQL 9.4以下では、ジオグラフィに対応していますが、バウンディングボックスの重心に対応するだけです。

14.12.3. PostGIS functions breaking changes in 2.2

The functions given below are PostGIS functions that have possibly breaking changes in PostGIS 2.2. If you use any of these, you may need to check your existing code.

  • Get_Geocode_Setting - Changed: 2.2.0 : default settings are now kept in a table called geocode_settings_default. Use customized settingsa are in geocode_settings and only contain those that have been set by user.
  • ST_3DClosestPoint - Changed: 2.2.0 - if 2 2D geometries are input, a 2D point is returned (instead of old behavior assuming 0 for missing Z). In case of 2D and 3D, Z is no longer assumed to be 0 for missing Z.
  • ST_3DDistance - Changed: 2.2.0 - In case of 2D and 3D, Z is no longer assumed to be 0 for missing Z.
  • ST_3DLongestLine - Changed: 2.2.0 - if 2 2D geometries are input, a 2D point is returned (instead of old behavior assuming 0 for missing Z). In case of 2D and 3D, Z is no longer assumed to be 0 for missing Z.
  • ST_3DMaxDistance - Changed: 2.2.0 - In case of 2D and 3D, Z is no longer assumed to be 0 for missing Z.
  • ST_3DShortestLine - Changed: 2.2.0 - if 2 2D geometries are input, a 2D point is returned (instead of old behavior assuming 0 for missing Z). In case of 2D and 3D, Z is no longer assumed to be 0 for missing Z.
  • ST_DistanceSphere - Changed: 2.2.0 前の版ではこの関数はST_Distance_Sphereと呼ばれていました。
  • ST_DistanceSpheroid - Changed: 2.2.0 前の版ではST_Distance_Spheroidと呼ばれていました。
  • ST_Equals - Changed: 2.2.0 Returns true even for invalid geometries if they are binary equal
  • ST_LengthSpheroid - Changed: 2.2.0 前の版ではST_Length_Spheroidと呼ばれていました。また、ST_3DLength_Spheroidの別名でした。
  • ST_MemSize - Changed: 2.2.0 命名規則に従うためにST_MemSizeに変更しました。以前の版では、この関数はST_Mem_Sizeと呼ばれていました。古い名前は非推奨ですが現在のところは有効です。
  • ST_PointInsideCircle - Changed: 2.2.0 以前の版ではST_Point_Inside_Circleと呼ばれていました。
  • ST_Split - Changed: 2.2.0 MULTILINESTRING,MULTIPOINT, (MULTI)POLYGONの境界によるラインの分割に対応しました。
  • ValidateTopology - Changed: 2.2.0 エラーの記述と矛盾しないように'edge crosses node'のid1とid2の値が入れ替わっています。
  • <-> - Changed: 2.2.0 PostgreSQL 9.5では、古いハイブリッド書式は遅くなりる可能性があります。そのため、PostGIS 2.2以上かつPostgreSQL 9.5以上においてのみ動作させる場合には、そのやり方をり除きたくなるでしょう。

14.12.4. PostGIS Functions new or enhanced in 2.1

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

[Note]

More Topology performance Improvements. Please refer to Chapter 11, トポロジ for more details.

[Note]

Bug fixes (particularly with handling of out-of-band rasters), many new functions (often shortening code you have to write to accomplish a common task) and massive speed improvements to raster functionality. Refer to Chapter 9, ラスタ リファレンス for more details.

[Note]

PostGIS 2.1.0: Tiger Geocoder upgraded to work with TIGER 2012 census data. geocode_settings added for debugging and tweaking rating preferences, loader made less greedy, now only downloads tables to be loaded. PostGIS 2.1.1: Tiger Geocoder upgraded to work with TIGER 2013 data. Please refer to Section 13.1, “Tiger Geocoder” for more details.

Functions new in PostGIS 2.1

  • = - Availability: 2.1.0 AのバウンディングボックスがBのバウンディングボックスと同じ場合にTRUEを返します。倍精度浮動小数点数のバウンディングボックスを使います。
  • AsTopoJSON - Availability: 2.1.0 opoGeometryのTopoJSON表現を返します。
  • ST_3DArea - Availability: 2.1.0 3次元の面ジオメトリの面積を計算します。立体の場合は0を返します。
  • ST_3DIntersection - Availability: 2.1.0 3次元のインタセクトした (共有する)部分を計算します。
  • ST_Box2dFromGeoHash - Availability: 2.1.0 GeoHash文字列からBOX2Dを返します。
  • ST_ColorMap - Availability: 2.1.0 元のラスタと指定したバンドから4個までの8BUIバンド (grayscale, RGB, RGBA)からなる新しいラスタを生成します。
  • ST_Contains - Availability: 2.1.0 rastAの外にrastBの点が無く、rastAの内部にrastBの内部の点が一つ以上ある場合にTRUEを返します。
  • ST_ContainsProperly - Availability: 2.1.0 rastBがrastAの内部でインタセクトし、かつrastAの境界とも外部ともインタセクトしない場合にTRUEを返します。
  • ST_CoveredBy - Availability: 2.1.0 rastAがrastBの外部に点を持たない場合にTRUEを返します。
  • ST_Covers - Availability: 2.1.0 rastBがrastAの外部に点を持たない場合にTRUEを返します。
  • ST_DFullyWithin - Availability: 2.1.0 rastAとrastBが指定した距離内に完全に収まる場合にTRUEを返します。
  • ST_DWithin - Availability: 2.1.0 rastAとrastBが指定した距離内にある場合にTRUEを返します。
  • ST_DelaunayTriangles - Availability: 2.1.0 - GEOS 3.4.0以上が必要です。 与えられたポイントの周りのドロネー三角形を返します。
  • ST_Disjoint - Availability: 2.1.0 rastAがrastBとインタセクトしない場合にTRUEを返します。
  • ST_DumpValues - Availability: 2.1.0 指定したバンドの値を2次元で得ます。
  • ST_Extrude - Availability: 2.1.0 関連するボリュームにサーフェスを押し出します。
  • ST_ForceLHR - Availability: 2.1.0 LHR (Left Hand Rule)方向に強制します。
  • ST_FromGDALRaster - Availability: 2.1.0 対応するGDALラスタファイルからラスタを返します。
  • ST_GeomFromGeoHash - Availability: 2.1.0 GeoHash文字列からジオメトリを返します。
  • ST_InvDistWeight4ma - Availability: 2.1.0 近隣のピクセル値の内挿補間を行うラスタ処理関数です。
  • ST_MapAlgebra - Availability: 2.1.0 コールバック関数版 - 一つ以上の入力ラスタ、バンドインデクスと一つのユーザ定義コールバック関数から、一つのバンドからなるラスタを返します。
  • ST_MapAlgebra - Availability: 2.1.0 数式版 - 一つか二つの入力ラスタ、バンド番号、一つ以上のユーザ定義SQL式から一つのバンドを持つラスタを返します。
  • ST_MinConvexHull - Availability: 2.1.0 NODATA値を除いたラスタの凸包ジオメトリを返します。
  • ST_MinDist4ma - Availability: 2.1.0 対象ピクセルと値を持つ近隣ピクセルとの最短距離をピクセル単位で返すラスタ処理関数です。
  • ST_MinkowskiSum - Availability: 2.1.0 ミンコフスキー和を求めます。
  • ST_NearestValue - Availability: 2.1.0 与えられたバンドの、columnxとrowyで指定されるか、またはラスタと同じ空間参照系で表現されたポイントで指定されたピクセルに最も近いNODATAでない値を返します。
  • ST_Neighborhood - Availability: 2.1.0 与えられたバンドのcolumnX, columnYか、ラスタと同じ空間参照系のジオメトリポイントで指定されたピクセルの周囲にある、NODATAでない2次元倍精度浮動小数点数配列を返します。
  • ST_NotSameAlignmentReason - Availability: 2.1.0 ラスタが同じアラインメントを持つかどうか、また、持たない場合にはその理由を示す文字列を返します。
  • ST_Orientation - Availability: 2.1.0 サーフェスの方向を判定します。
  • ST_Overlaps - Availability: 2.1.0 rastAとrastBがインタセクトして、かつ一方がもう一方に完全には包含されない場合にはTRUEを返します。
  • ST_PixelAsCentroid - Availability: 2.1.0 ピクセルで表現される面の重心 (ポイントジオメトリ)を返します。
  • ST_PixelAsCentroids - Availability: 2.1.0 全てのピクセルについて重心 (ポイントジオメト)リを、ピクセルごとのピクセル値とラスタ座標系のXとYとを付けて返します。ポイントジオメトリの座標はピクセルで表現される面の重心です。
  • ST_PixelAsPoint - Availability: 2.1.0 ピクセルの左上隅のポイントジオメトリを返します。
  • ST_PixelAsPoints - Availability: 2.1.0 全てのピクセルについてポイントジオメトリを、ピクセルごとのピクセル値とラスタ座標系のXとYとを付けて返します。ポイントジオメトリの座標はピクセルの左上隅です。
  • ST_PixelOfValue - Availability: 2.1.0 検索値と同じ値を持つピクセルのcolumnx, rowyピクセル座標を得ます。
  • ST_PointFromGeoHash - Availability: 2.1.0 GeoHash文字列からポイントを返します。
  • ST_RasterToWorldCoord - Availability: 2.1.0 ラスタの指定した列と行における左上隅の地理座標X値とY値 (経度と緯度)を返します。列と行の番号は1始まりです。
  • ST_Resize - Availability: 2.1.0 GDAL 1.6.1以上が必要です。 ラスタを新しい幅、高さにサイズ再設定を行います。
  • ST_Roughness - Availability: 2.1.0 DEMの「粗度」を計算したラスタを返します。
  • ST_SetValues - Availability: 2.1.0 与えられたバンドに複数の値を設定して、変更されたラスタを返します。
  • ST_Simplify - Availability: 2.1.0 与えたTopoGeometryを「シンプル化した」ジオメトリを返します。ダグラス-ポーカーのアルゴリズムを使います。
  • ST_StraightSkeleton - Availability: 2.1.0 ジオメトリからストレートスケルトンを計算します。
  • ST_Summary - Availability: 2.1.0 ラスタの中身の概要が文字列で返されます。
  • ST_TPI - Availability: 2.1.0 地形的位置指数を計算したラスタを返します。
  • ST_TRI - Availability: 2.1.0 起伏指標を計算したラスタを返します。
  • ST_Tesselate - Availability: 2.1.0 ポリゴンまたは多面体サーフェスのテッセレーションを計算し、TINまたはTINコレクションを返します。
  • ST_Tile - Availability: 2.1.0 求められた出力ラスタのピクセル数に基づいて入力ラスタを分割した結果のラスタ集合を返します。
  • ST_Touches - Availability: 2.1.0 rastAとrastBが少なくとも一つの共通の点を持ち、かつ二つのラスタの内部同士がインタセクトしない場合にTRUEを返します。
  • ST_Union - Availability: 2.1.0 ST_Union(rast, unionarg)の形式が導入されました。 ラスタタイルの集合を結合して1以上のバンドからなる単一ラスタを返します。
  • ST_Within - Availability: 2.1.0 rastAがrastBの外部に点を持たず、rastAの内部の少なくとも一つの点がrastBの内部にある場合にTRUEを返します。
  • ST_WorldToRasterCoord - Availability: 2.1.0 ラスタの空間参照系による地理座標のX値とY値 (経度と緯度)またはポイントジオメトリに対応するピクセルの左上隅を返します。
  • UpdateRasterSRID - Availability: 2.1.0 ユーザが指定したカラムとテーブルにあるラスタの全てについてSRIDを変更します。
  • clearTopoGeom - Availability: 2.1 TopoGeometryの中身を消去します。
  • postgis.backend - Availability: 2.1.0 GEOSとSFCGALで重複する関数を提供するバックエンドです。GEOSまたはSFCGALを選択します。デフォルトはGEOSです。
  • postgis_sfcgal_version - Availability: 2.1.0 使用しているSFCGALの版を返します

The functions given below are PostGIS functions that are enhanced in PostGIS 2.1.

  • ST_AddBand - Enhanced: 2.1.0 addbandarg対応が追加されました。
  • ST_AddBand - Enhanced: 2.1.0 out-dbバンドが追加されました。
  • ST_AsBinary - Enhanced: 2.1.0 outasinの追加
  • ST_Aspect - Enhanced: 2.1.0 ST_MapAlgebra()を使用するようにし、interpolate_nodata任意引数を追加しました。
  • ST_Clip - Enhanced: 2.1.0 C言語で記述されました
  • ST_Distinct4ma - Enhanced: 2.1.0 二つ目の形式の追加
  • ST_HillShade - Enhanced: 2.1.0 ST_MapAlgebra()を使用するようにし、interpolate_nodata任意引数を追加しました。
  • ST_Max4ma - Enhanced: 2.1.0 二つ目の形式の追加
  • ST_Mean4ma - Enhanced: 2.1.0 二つ目の形式の追加
  • ST_Min4ma - Enhanced: 2.1.0 二つ目の形式の追加
  • ST_PixelAsPolygons - Enhanced: 2.1.0 任意引数exclude_nodata_valueが追加されました。
  • ST_Polygon - Enhanced: 2.1.0 速度を改善し (完全にC言語で記述しました)、確実に妥当なマルチポリゴンを返すようにしました。
  • ST_Range4ma - Enhanced: 2.1.0 二つ目の形式の追加
  • ST_SameAlignment - Enhanced: 2.1.0 集約関数版の追加
  • ST_SetGeoReference - Enhanced: 2.1.0 ST_SetGeoReference(raster, double precision, ...)形式を追加しました。
  • ST_SetValue - Enhanced: 2.1.0 ST_SetValueでジオメトリを用いる形式が、ポイントだけでなくあらゆるジオメトリタイプに対応するようになりました。ジオメトリを用いる形式はST_SetValuesのgeomval[]を用いる形式をラップしたものです。
  • ST_Slope - Enhanced: 2.1.0 ST_MapAlgebra()を使用するようにし、units, scale, interpolate_nodata任意引数を追加しました。
  • ST_StdDev4ma - Enhanced: 2.1.0 二つ目の形式の追加
  • ST_Sum4ma - Enhanced: 2.1.0 二つ目の形式の追加
  • ST_Transform - Enhanced: 2.1.0 ST_Tranfrorm(rast, alignto)の形式を追加しました。
  • ST_Union - Enhanced: 2.1.0 速度が改善されました (完全にC言語で記述しました)
  • ST_Union - Enhanced: 2.1.0 ST_Union(rast) (一つ目の形式)で、全ての入力ラスタの全てのバンドを結合するようになりました。以前の版のPostGISでは、一つ目のバンドと仮定していました。
  • ST_Union - Enhanced: 2.1.0 ST_Union(rast, uniontype) (四つ目の形式)で、全ての入力ラスタの全てのバンドを結合するようになりました。
  • ST_AsGML - Enhanced: 2.1.0 GML 3用にidが導入されました。
  • ST_Boundary - Enhanced: 2.1.0で三角対応が導入されました。
  • ST_DWithin - Enhanced: 2.1.0で、ジオグラフィでの速度が向上しました。詳細についてはMaking Geography fasterを参照して下さい。
  • ST_DWithin - Enhanced: 2.1.0 曲線ジオメトリ対応が導入されました。
  • ST_Distance - Enhanced: 2.1.0 ジオグラフィでの速度が改善されました。詳細はMaking Geography fasterをご覧ください。
  • ST_Distance - Enhanced: 2.1.0 - 曲線ジオメトリ対応が導入されました。
  • ST_DumpPoints - Enhanced: 2.1.0 速度向上しました。C言語で実装しなおしました。
  • ST_MakeValid - Enhanced: 2.1.0 GEOMETRYCOLLECTIONとMULTIPOINTに対応するようになりました。
  • ST_Segmentize - Enhanced: 2.1.0 ジオグラフィ対応が導入されました。
  • ST_Summary - Enhanced: 2.1.0 空間参照系を持つかを示すSフラグが追加されました。
  • toTopoGeom - Enhanced: 2.1.0版では、既存のTopoGeometryを取る形式が追加されました。

14.12.5. PostGIS functions breaking changes in 2.1

The functions given below are PostGIS functions that have possibly breaking changes in PostGIS 2.1. If you use any of these, you may need to check your existing code.

  • ST_Aspect - Changed: 2.1.0 以前の版では、返り値はラジアン単位でした。現在は、デフォルトでは度で返します。
  • ST_HillShade - Changed: 2.1.0 以前の版ではazimuthとaltitudeはラジアン単位で表現しました。現在はazimuthとaltitudeは度単位で表現します。
  • ST_Intersects - Changed: 2.1.0 ST_Intersects(raster, geometry)形式の挙動が ST_Intersects(geometry, raster)とあうように変更されました。
  • ST_PixelAsCentroids - Changed: 2.1.1 exclude_nodata_valueの挙動を変更しました。
  • ST_PixelAsPoints - Changed: 2.1.1 exclude_nodata_valueの挙動を変更しました。
  • ST_PixelAsPolygons - Changed: 2.1.1 exclude_nodata_valueの挙動を変更しました。
  • ST_Polygon - Changed: 2.1.0 以前の版では、時々ポリゴンを返しましたが、常にマルチポリゴンを返すように変更しました。
  • ST_RasterToWorldCoordX - Changed: 2.1.0 以前の版ではST_Raster2WorldCoordXと呼ばれていました。
  • ST_RasterToWorldCoordY - Changed: 2.1.0 以前の版ではST_Raster2WorldCoordYと呼ばれていました。
  • ST_Resample - Changed: 2.1.0 srid引数を削除しました。参照ラスタを使う形式では、もはや参照ラスタのSRIDを適用しません。ラスタの投影変換にはST_Transform()を使います。SRIDなしで動作します。
  • ST_Rescale - Changed: 2.1.0 SRIDなしのラスタで動作するようになりました。
  • ST_Reskew - Changed: 2.1.0 SRIDなしのラスタで動作するようになりました。
  • ST_Slope - Changed: 2.1.0 以前の版では、返り値はラジアン単位でした。現在は、デフォルトでは度で返します。
  • ST_SnapToGrid - Changed: 2.1.0 SRIDなしのラスタで動作するようになりました。
  • ST_WorldToRasterCoordX - Changed: 2.1.0 以前の版ではST_World2RasterCoordXと呼ばれていました。
  • ST_WorldToRasterCoordY - Changed: 2.1.0 以前の版ではST_World2RasterCoordYと呼ばれていました。
  • ST_EstimatedExtent - Changed: 2.1.0 2.0.xまではST_Estimated_Extentと呼ばれていました。
  • ST_Force2D - Changed: 2.1.0 2.0.xの間はST_Force_2Dと呼ばれていました。
  • ST_Force3D - Changed: 2.1.0 2.0.xの間はST_Force_3Dと呼ばれていました。
  • ST_Force3DM - Changed: 2.1.0 2.0.xの間はST_Force_3DMと呼ばれていました。
  • ST_Force3DZ - Changed: 2.1.0 2.0.xの間はST_Force_3DZと呼ばれていました。
  • ST_Force4D - Changed: 2.1.0 2.0.xの間はST_Force_4Dと呼ばれていました。
  • ST_ForceCollection - Changed: 2.1.0 2.0.xの間はST_Force_Collectionと呼ばれていました。
  • ST_LineInterpolatePoint - Changed: 2.1.0 2.0.xまでではST_Line_Interpolate_Pointと呼んでいました。
  • ST_LineLocatePoint - Changed: 2.1.0 2.0.xまでではST_Line_Locate_Pointと呼んでいました。
  • ST_LineSubstring - Changed: 2.1.0 2.0.xではST_Line_Substringと呼ばれていました。
  • ST_Segmentize - Changed: 2.1.0 ジオグラフィ対応導入の結果として、SELECT ST_Segmentize('LINESTRING(1 2, 3 4)',0.5);では、あいまいな関数呼び出しエラーとなります。確実にタイプを指定したオブジェクトを持たせる必要があります。たとえば、ジオメトリ/ジオグラフィカラムであったり、ST_GeomFromText, ST_GeogFromTextを使ったり、SELECT ST_Segmentize('LINESTRING(1 2, 3 4)'::geometry,0.5);としたりします。

14.12.6. PostGIS Functions new, behavior changed, or enhanced in 2.0

The functions given below are PostGIS functions that were added, enhanced, or have Section 14.12.7, “PostGIS Functions changed behavior in 2.0” breaking changes in 2.0 releases.

New geometry types: TIN and Polyhedral surfaces was introduced in 2.0

[Note]

Greatly improved support for Topology. Please refer to Chapter 11, トポロジ for more details.

[Note]

In PostGIS 2.0, raster type and raster functionality has been integrated. There are way too many new raster functions to list here and all are new so please refer to Chapter 9, ラスタ リファレンス for more details of the raster functions available. Earlier pre-2.0 versions had raster_columns/raster_overviews as real tables. These were changed to views before release. Functions such as ST_AddRasterColumn were removed and replaced with AddRasterConstraints, DropRasterConstraints as a result some apps that created raster tables may need changing.

[Note]

Tiger Geocoder upgraded to work with TIGER 2010 census data and now included in the core PostGIS documentation. A reverse geocoder function was also added. Please refer to Section 13.1, “Tiger Geocoder” for more details.

  • && - Availability: 2.0.0 AのバウンディングボックスがBのバウンディングボックスとインタセクトする場合にTRUEを返します。
  • &&& - Availability: 2.0.0 Aのn次元バウンディングボックスがBのn次元バウンディングボックスとインタセクトする場合にTRUEを返します。
  • <#> - Availability: 2.0.0 PostgreSQL 9.1以上でのみ有効です。 AのバウンディングボックスとBのバウンディングボックスの2次元距離を返します。
  • <-> - Availability: 2.0.0 弱いKNNによって、実際の距離の代わりにジオメトリの重心による近傍が得られます。ポイントは確実な結果を得て、他のタイプは全て不確実な結果を得ます。PostgreSQL 9.1以上で有効です。 AとBの2次元距離を返します。
  • <<#>> - Availability: 2.0.0 KNNはPostgreSQL 9.1以上でのみ有効です。 AのバウンディングボックスとBのバウンディングボックスのn次元距離を返します。
  • <<->> - Availability: 2.0.0 KNNはPostgreSQL 9.1以上でのみ有効です。 AのバウンディングボックスとBのバウンディングボックスのn次元距離を返します。
  • @ - Availability: 2.0.0 raster @ raster, raster @ geometry が導入されました。 AのバウンディングボックスがBのバウンディングボックスに含まれる場合にTRUEを返します。倍精度浮動小数点数のバウンディングボックスを使います。
  • @ - Availability: 2.0.5 geometry @ raster が導入されました。 AのバウンディングボックスがBのバウンディングボックスに含まれる場合にTRUEを返します。倍精度浮動小数点数のバウンディングボックスを使います。
  • AddEdge - Availability: 2.0.0 GEOS 3.3.0以降が必要です。 指定したラインストリングジオメトリを使って、ラインストリングエッジをエッジテーブルに追加し、指定したトポロジスキーマの始点終点をポイントノードテーブルに追加し、新しい (または既存の)エッジの識別番号を返します。
  • AddFace - Availability: 2.0.0 フェイスプリミティブをトポロジに登録し、その識別番号を得ます。
  • AddNode - Availability: 2.0.0 指定したトポロジスキーマのノードテーブルにポイントノードを追加し、新しいノードの識別番号を返します。指定したポイントに既にノードがある場合は既存のノード識別番号を返します。
  • AddOverviewConstraints - Availability: 2.0.0 ラスタカラムに対して、他のオーバビューであることをタグ付けします。
  • AddRasterConstraints - Availability: 2.0.0 ロードされたラスタテーブルの特定のカラムにラスタ制約を追加します。制約には空間参照系、スケール、ブロックサイズ、アラインメント、バンド数、バンド型、ラスタカラムが規則正しいブロックかどうかを示すフラグがあります。テーブルは制約が推論されるためのデータがロードされなければなりません。制約の設定が完了するとtrueを返し、問題があると通知を返します。
  • AsGML - Availability: 2.0.0 TopoGeometryのGML表現を返します。
  • CopyTopology - Availability: 2.0.0 トポロジ構造 (ノード、エッジ、フェイス、レイヤ、TopoGeometry)を複写します。
  • DropOverviewConstraints - Availability: 2.0.0 ラスタカラムに対して他のオーバビューであることをタグ付けしているのを解除します。
  • DropRasterConstraints - Availability: 2.0.0 ラスタテーブルカラムを参照するPostGISラスタ制約を削除します。データの再読み込みやラスタカラムデータの更新の際に使えます。
  • GetEdgeByPoint - Availability: 2.0.0 - GEOS 3.3.0以上が必要 与えられたポイントにインタセクトするエッジの識別番号を探索します。
  • GetFaceByPoint - Availability: 2.0.0 - GEOS 3.3.0以上が必要 与えられたポイントにインタセクトするフェイスの識別番号を探索します。
  • GetNodeByPoint - Availability: 2.0.0 - GEOS 3.3.0以上が必要 ポイント位置にあるノードの識別番号を探索します。
  • GetNodeEdges - Availability: 2.0 与えられたノードに付随するエッジの集合を整列して返します。
  • GetRingEdges - Availability: 2.0.0 与えられた側を歩いて得られた、正負符号付きエッジ識別番号の集合を、順序通りに返します。
  • GetTopoGeomElements - Availability: 2.0.0 与えられたTopoGeometry (プリミティブ要素)の、トポロジのelement_idとelement_typeを含むtopoelementオブジェクトの集合を返します。
  • GetTopologySRID - Availability: 2.0.0 トポロジ名からtopology.topologyテーブル内にあるトポロジのSRIDを返します。
  • Loader_Generate_Script - Availability: 2.0.0 to support Tiger 2010 structured data and load census tract (tract), block groups (bg), and blocks (tabblocks) tables . Generates a shell script for the specified platform for the specified states that will download Tiger data, stage and load into tiger_data schema. Each state script is returned as a separate record. Latest version supports Tiger 2010 structural changes and also loads census tract, block groups, and blocks tables.
  • Polygonize - Availability: 2.0.0 トポロジエッジで定義される全てのフェイスを探索し、追加します。
  • ST_3DClosestPoint - Availability: 2.0.0 g1上の、g2に最も近い3次元ポイントを返します。3次元最短線の一つ目のポイントです。
  • ST_3DDFullyWithin - Availability: 2.0.0 3次元ジオメトリが他のジオメトリとの距離が指定した範囲内ならtrueを返します。
  • ST_3DDWithin - Availability: 2.0.0 3次元 (XYZ)ジオメトリ型について、二つのジオメトリの3次元距離が指定した数の内にある場合にtrueを返します。
  • ST_3DDistance - Availability: 2.0.0 ジオメトリ型について、二つのジオメトリの、3次元の最小デカルト距離 (空間参照系に基づきます)を、投影法の単位で返します。
  • ST_3DIntersects - Availability: 2.0.0 ジオメトリが3次元で「空間的にインタセクトする」場合にTRUEを返します。ポイント、ラインストリング、ポリゴン、多面体サーフェス (面)のみ対応します。SFCGALバックエンドによってTINも対応します。
  • ST_3DLongestLine - Availability: 2.0.0 二つのジオメトリの3次元長が最長となるラインを返します。
  • ST_3DMaxDistance - Availability: 2.0.0 ジオメトリ型について、二つのジオメトリの、3次元の最大デカルト距離 (空間参照系に基づきます)を、投影法の単位で返します。
  • ST_3DShortestLine - Availability: 2.0.0 二つのジオメトリの3次元長が最短となるラインを返します。
  • ST_AddEdgeModFace - Availability: 2.0 新しいエッジを追加します。新しいエッジがフェイスを分割する場合には、もとのフェイスを編集し、一つのフェイスを追加します。
  • ST_AddEdgeNewFaces - Availability: 2.0 新しいエッジを追加します。新しいエッジがフェイスを分割する場合には、もとのフェイスを削除して、分割した二つのフェイスに置き換えます。
  • ST_AsGDALRaster - Availability: 2.0.0 - GDAL 1.6.0以上が必要です。 指定されたGDALラスタ書式でラスタタイルを返します。ラスタ書式はコンパイルしたライブラリが対応するものです。ライブラリが対応する書式の一覧を得るにはST_GDALRasters()を使います。
  • ST_AsJPEG - Availability: 2.0.0 - GDAL 1.6.0以上が必要です。 ラスタの選択されたバンドを、単一のJoint Photographic Exports Group (JPEG)画像としてバイト配列で返します。バンドを指定せず、1バンドか3より多いバンドがある場合には、1番バンドを使用します。3バンドのみ指定した場合には、3バンドを使用し、RGBに対応付けます。
  • ST_AsLatLonText - Availability: 2.0 与えられたポイントの度・分・秒表現を返します。
  • ST_AsPNG - Availability: 2.0.0 - GDAL 1.6.0以上が必要です。 ラスタの選択されたバンドを、単一のportable network graphics (PNG)画像としてバイト配列で返します。バンドを指定せず、1バンドか3バンドか4バンドある場合には、全てのバンドを使用します。バンドを指定せず、2バンドか4より多いバンドがある場合には、1番バンドを使用します。対象バンドはRGBまたはRGBAに対応付けられます。
  • ST_AsRaster - Availability: 2.0.0 - GDAL 1.6.0以上が必要です。 PostGISジオメトリをPostGISラスタに変換します。
  • ST_AsTIFF - Availability: 2.0.0 - GDAL 1.6.0以上が必要です。 ラスタの選択されたバンドを、単一のTIFF画像 (バイト配列)として返します。バンドを指定しない場合には、全てのバンドの使用を試みます。
  • ST_AsX3D - Availability: 2.0.0: ISO-IEC-19776-1.2-X3DEncodings-XML ジオメトリをX3Dノード要素書式 (ISO-IEC-19776-1.2-X3DEncodings-XML)で返します。
  • ST_Aspect - Availability: 2.0.0 標高ラスタバンドの傾斜方向 (デフォルトの単位は度)を返します。地形解析に使えます。
  • ST_Band - Availability: 2.0.0 既存のラスタの、一つ以上のバンドを新しいラスタとして返します。既存のラスタから新しいラスタを構築する際に使えます。
  • ST_BandIsNoData - Availability: 2.0.0 指定したバンドがNODATA値だけで満たされている場合には、TRUEを返します。
  • ST_Clip - Availability: 2.0.0 入力ジオメトリで切り取ったラスタを返します。バンドが指定されていない場合には、全てのバンドが返されます。cropが指定されていない場合には、TRUEと仮定され、出力ラスタをクロップします。
  • ST_CollectionHomogenize - Availability: 2.0.0 Given a geometry collection, return the "simplest" representation of the contents.
  • ST_ConcaveHull - Availability: 2.0.0 凹包は、集合の範囲内におけるすべてのジオメトリーを囲む、できる限り凹となるジオメトリを表現するものです。収縮包装とみることができます。
  • ST_Count - Availability: 2.0.0 ラスタまたはラスタカバレッジの指定したバンドのピクセル数を返します。バンドを指定しない場合には、1番と仮定します。exclude_nodata_valueをTRUEに設定している場合には、NODATA値と等しくないピクセルのみを数えます。
  • ST_CreateTopoGeo - Availability: 2.0 空のトポロジにジオメトリのコレクションを追加し、成否を示すメッセージを返します。
  • ST_Distinct4ma - Availability: 2.0.0 近隣のピクセル値のうち一意となるものを数えるラスタ処理関数です。
  • ST_FlipCoordinates - Availability: 2.0.0 与えられたジオメトリのX軸とY軸とを入れ替えたものを返します。緯度/経度のフィーチャーを構築して、これを訂正したい場合に使えます。
  • ST_GDALDrivers - Availability: 2.0.0 - GDAL 1.6.0以上が必要です。 使用しているGDALライブラリが対応するラスタ書式の一覧を返します。ST_AsGDALRasterを使って出力できるラスタの書式です。
  • ST_GeomFromGeoJSON - Availability: 2.0.0 JSON-C 0.9以上が必要です。 ジオメトリのGeoJSON表現を入力として、PostGISジオメトリオブジェクトを出力します。
  • ST_GetFaceEdges - Availability: 2.0 順序番号を含む、afaceの境界となる、整列したエッジの集合を返します。
  • ST_HasNoBand - Availability: 2.0.0 指定したバンド番号のバンドが無い場合には、TRUEを返します。バンド番号を指定していない場合には、1番と仮定します。
  • ST_HillShade - Availability: 2.0.0 与えられた方位、高度、明度、スケールの入力を使って標高ラスタバンドの仮想照明を返します。
  • ST_Histogram - Availability: 2.0.0 ラスタまたはラスタカバレッジのビン範囲で分割したデータ分布をまとめるヒストグラムの集合を返します。ビン数を指定しない場合には自動計算されます。
  • ST_InterpolatePoint - Availability: 2.0.0 ジオメトリの、指定したポイントに近いポイントにおけるM値を返します。
  • ST_IsEmpty - Availability: 2.0.0 ラスタが空 (幅が0で高さが0)の場合にはTRUEを返します。他の場合には、FALSEを返します。
  • ST_IsValidDetail - Availability: 2.0.0 - GEOS 3.3.0以上が必要 ジオメトリが妥当か否かを示すvalid_detail (valid,reason,location)行を返します。不正である場合には、理由と位置を示します。
  • ST_IsValidReason - Availability: 2.0 - flagsを受け付ける形式はGEOS 3.3.0以上が必要です。 ジオメトリが妥当か否かを示す文字列を返し、不正な場合は理由を返します。
  • ST_MakeLine - Availability: 2.0.0 - ラインストリング入力要素が導入されました。 Creates a Linestring from point, multipoint, or line geometries.
  • ST_MakeValid - Availability: 2.0.0, GEOS 3.3.0以上が必要です。 頂点を失うことなしに不正なジオメトリを妥当なジオメトリにしようと試みます。
  • ST_MapAlgebraExpr - Availability: 2.0.0 1バンド版: 入力バンドに対する妥当なPostgreSQL代数演算で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、1番を仮定します。
  • ST_MapAlgebraExpr - Availability: 2.0.0 2バンド版: 二つの入力バンドに対する妥当なPostgreSQL代数演算で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、どちらも1番と仮定します。結果ラスタは、一つ目のラスタのアラインメント (スケール、スキュー、ピクセル角位置)にあわされます。範囲は"extenttype"引数で定義されます。取りうる"extenttype"の値はINTERSECTION, UNION, FIRST, SECONDです。
  • ST_MapAlgebraFct - Availability: 2.0.0 1バンド版 - 入力バンドに対する妥当なPostgreSQL関数で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、1番と仮定します。
  • ST_MapAlgebraFct - Availability: 2.0.0 2バンド版 - 二つの入力バンドに対する妥当なPostgreSQL関数で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、1番と仮定します。"extenttype"のデフォルトはINTERSECTIONです。
  • ST_MapAlgebraFctNgb - Availability: 2.0.0 1バンド版: ユーザ定義PostgreSQL関数を使用する最近傍地図代数関数です。入力ラスタバンドの近傍の値を与えたPL/pgSQLユーザ定義関数の結果からなるラスタを返します。
  • ST_Max4ma - Availability: 2.0.0 近隣のピクセル値の最大値を計算するラスタ処理関数です。
  • ST_Mean4ma - Availability: 2.0.0 近隣のピクセル値の平均値を計算するラスタ処理関数です。
  • ST_Min4ma - Availability: 2.0.0 近隣のピクセル値の最小値を計算するラスタ処理関数です。
  • ST_ModEdgeHeal - Availability: 2.0 二つのエッジについて、接続しているノードを削除して修復します。1番目のエッジを編集して、2番目のエッジを削除します。削除されたノードの識別番号を返します。
  • ST_NewEdgeHeal - Availability: 2.0 二つのエッジについて、接続しているノードを削除して修復します。両方のエッジを削除し、1番目のエッジと同じ方向のエッジに置き換えます。
  • ST_Node - Availability: 2.0.0 - GEOS 3.3.0以上が必要 ラインストリングの集合にノードを作成します。
  • ST_NumPatches - Availability: 2.0.0 多面体サーフェスのフェイス数を返します。多面体でないジオメトリの場合にはNULLを返します。
  • ST_OffsetCurve - Availability: 2.0 - GEOS 3.2以上、GEOS 3.3以上で改善されました。 与えられた距離と方面に入力ラインをずらしたラインを返します。中心線と平行する線を引く際に使えます。
  • ST_PatchN - Availability: 2.0.0 ジオメトリがPOLYHEDRALSURFACEかPOLYHEDRALSURFACEMの場合には、1始まりでN番目のジオメトリ (フェイス)を返します。それ以外の場合には、NULLを返します。
  • ST_Perimeter - Availability: 2.0.0 ジオグラフィ対応が導入されました。 ST_SrrfaceまたはST_MultiSurface (POLYGONまたはMULTIPOLYGON)の境界の長さの計測値を返します。ジオメトリでは単位は空間参照系によります。ジオグラフィではメートル単位になります。
  • ST_PixelAsPolygon - Availability: 2.0.0 指定した行と列のピクセルの境界となるジオメトリを返します。
  • ST_PixelAsPolygons - Availability: 2.0.0 全てのピクセルについて境界となるジオメトリを、ピクセルごとのピクセル値とラスタ座標系のXとYとを付けて返します。
  • ST_Project - Availability: 2.0.0 メートル単位の距離とラジアン単位の方位とを使って始点から算出されたPOINTを返します。
  • ST_Quantile - Availability: 2.0.0 ラスタまたはラスタテーブルカバレッジのサンプルまたは母集団の分位数を計算します。値がラスタの25%,50%,75%にあるかを調べることができます。
  • ST_Range4ma - Availability: 2.0.0 近隣のピクセル値の範囲を計算するラスタ処理関数です。
  • ST_Reclass - Availability: 2.0.0 元のラスタから再分類したバンドタイプからなるラスタを生成します。nbandは変更するバンドです。nbandが指定されていない場合には、1と仮定します。他の全てのバンドは変更せずに返します。可視画像の書式としてより単純な描画を行うために、16BUIバンドを8BUIバンドに変換する、等のために使います。
  • ST_RelateMatch - Availability: 2.0.0 - GEOS 3.3.0以上が必要 intersectionMattrixPattern1がintersectionMatrixPattern2を含む場合にTRUEを返します。
  • ST_RemEdgeModFace - Availability: 2.0 エッジを削除し、削除対象エッジでフェイスが二つに分割されているなら、両方の空間をとるため、一つを削除して、もう一つを編集します。
  • ST_RemEdgeNewFace - Availability: 2.0 エッジを削除し、消去対象エッジでフェイスが二つに分割されているなら元の二つのフェイスを削除し、一つの新しいフェイスに置き換えます。
  • ST_Resample - Availability: 2.0.0 GDAL 1.6.1以上が必要です。 指定したリサンプリングアルゴリズム、新しいピクセル範囲、グリッドの隅、定義するか他のラスタから借りてきた地理参照属性を使ってリサンプリングを行います。
  • ST_Rescale - Availability: 2.0.0 GDAL 1.6.1以上が必要です。 スケール (ピクセルサイズ)だけを調整するリサンプリングを行います。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最近傍補間です。
  • ST_Reskew - Availability: 2.0.0 GDAL 1.6.1以上が必要です。 キュー (回転パラメタ)だけを調整するリサンプリングを行います。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最近傍補間です。
  • ST_SameAlignment - Availability: 2.0.0 ラスタが同じスキュー、スケール、空間参照系、オフセットを持つ (ピクセルが分割されることなく同じグリッドに置かれている)場合にTRUEを返し、そうでない場合は問題を詳述する通知とともにFALSEを返します。
  • ST_SetBandIsNoData - Availability: 2.0.0 バンドのisnodataフラグをTRUEにします。
  • ST_SharedPaths - Availability: 2.0.0 GEOS 3.3.0以降が必要です。 二つのLINESTRING/MULTILINESTRINGの入力が共有するパスのコレクションを返します。
  • ST_Slope - Availability: 2.0.0 標高ラスタバンドの傾斜角 (デフォルトでは度単位)を返します。地形解析に使えます。
  • ST_Snap - Availability: 2.0.0 GEOS 3.3.0以降が必要です。 入力ジオメトリの辺と頂点を参照ジオメトリの頂点にスナップします。
  • ST_SnapToGrid - Availability: 2.0.0 GDAL 1.6.1以上が必要です。 グリッドにスナップすることでラスタをリサンプリングします。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間('Lanczos')を用います。デフォルトは最近傍補間です。
  • ST_Split - Availability: 2.0.0 ジオメトリを分割したジオメトリのコレクションを返します。
  • ST_StdDev4ma - Availability: 2.0.0 近隣のピクセル値の標準偏差を計算するラスタ処理関数です。
  • ST_Sum4ma - Availability: 2.0.0 近隣のピクセル値の合計を計算するラスタ処理関数です。
  • ST_SummaryStats - Availability: 2.0.0 ラスタまたはラスタカバレッジの指定したバンドについて、ピクセル数、合計値、平均値、標準偏差、最小値、最大値からなる統計情報の概要を返します。バンドを指定しない場合には、1番と仮定します。
  • ST_Transform - Availability: 2.0.0 GDAL 1.6.1以上が必要です。 ラスタを既知の空間参照系から他の既知の空間参照系に、指定したリサンプリングアルゴリズムで投影変換します。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最近傍補間です。
  • ST_UnaryUnion - Availability: 2.0.0 - GEOS 3.3.0以上が必要 ST_Unionに似ていますが、ジオメトリ要素レベルで動作します。
  • ST_Union - Availability: 2.0.0 ラスタタイルの集合を結合して1以上のバンドからなる単一ラスタを返します。
  • ST_ValueCount - Availability: 2.0.0 ラスタ (またはラスタカバレッジ)の指定されたバンドで、指定した値を持つピクセルを対象として、ピクセルバンド値とピクセル数からなるレコードの集合を返します。バンドを指定しない場合には、1番と仮定します。デフォルトではNODATA値のピクセルは数えられず、ピクセルの他の値は出力され、ピクセルバンド値は最も近い整数に丸められます。
  • TopoElementArray_Agg - Availability: 2.0.0 element_idとタイプの配列 (topoelements)からなるtopoelementarrayを返します。
  • TopoGeo_AddLineString - Availability: 2.0.0 許容差を使って既存のトポロジにラインストリングを追加し、可能ならエッジ/フェイスを分割します。
  • TopoGeo_AddPoint - Availability: 2.0.0 許容差を使って既存のトポロジにポイントを追加し、可能ならエッジを分割します。
  • TopoGeo_AddPolygon - Availability: 2.0.0 許容差を使って既存のトポロジにポリゴンを追加し、可能ならエッジ/フェイスを分割します。
  • TopologySummary - Availability: 2.0.0 トポロジ名を取り、トポロジ内のオブジェクトの型に関する概要の全体を提供します。
  • toTopoGeom - Availability: 2.0 単純なジオメトリからTopoGeometryを生成します。
  • ~ - Availability: 2.0.0 AのバウンディングボックスがBのバウンディングボックスを含む場合にTRUEを返します。倍精度浮動小数点数のバウンディングボックスを使います。
  • ~= - Availability: 2.0.0 AのバウンディングボックスがBのバウンディングボックスと同じ場合にTRUEを返します。

The functions given below are PostGIS functions that are enhanced in PostGIS 2.0.

  • AddGeometryColumn - Enhanced: 2.0.0 use_typmod引数が導入されました。デフォルトでは制約を基にしたものでなくtypmodジオメトリカラムが生成されます。
  • Box2D - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • Box3D - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • Geocode - Enhanced: 2.0.0 to support Tiger 2010 structured data and revised some logic to improve speed, accuracy of geocoding, and to offset point from centerline to side of street address is located on. The new parameter max_results useful for specifying number of best results or just returning the best result.
  • GeometryType - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • Populate_Geometry_Columns - Enhanced: 2.0.0 use_typmod任意引数が導入されました。カラムが型修飾子で生成されるか制約チェックで作られるかの制御ができます。
  • ST_Intersection - Enhanced: 2.0.0 - ラスタ空間のインタセクションが導入されました。2.0.0より前の版では、ベクタ空間でのインタセクションの計算のみに対応していました。
  • ST_Intersects - Enhanced: 2.0.0 ラスタ/ラスタのインタセクト対応が導入されました。
  • ST_Value - Enhanced: 2.0.0 任意引数exclude_nodata_valueが追加されました。
  • ST_3DExtent - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • ST_Accum - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • ST_Affine - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • ST_Area - Enhanced: 2.0.0 - 2次元多面体サーフェス対応が導入されました。
  • ST_AsBinary - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • ST_AsBinary - Enhanced: 2.0.0 高次元が導入されました。
  • ST_AsBinary - Enhanced: 2.0.0 ジオグラフィでのエンディアン指定が導入されました。
  • ST_AsEWKB - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • ST_AsEWKT - Enhanced: 2.0.0 ジオグラフィ対応、多面体サーフェス対応、三角形対応、TIN対応が導入されました。
  • ST_AsGML - Enhanced: 2.0.0 プレフィクスが導入されました。 GML 3用であるoptionsの4は、曲線のかわりにラインストリングを使えるようにするためのものです。GML 3の多面体サーフェスとTINが導入されました。optionsの32はボックスを出力するために導入されました。
  • ST_AsKML - Enhanced: 2.0.0 - プレフィクス名前空間を追加しました。デフォルトではプリフィクス無しです。
  • ST_Azimuth - Enhanced: 2.0.0 ジオグラフィ対応が導入されました。
  • ST_ChangeEdgeGeom - Enhanced: 2.0.0版で、トポロジ整合性の強制を追加しました。
  • ST_Dimension - Enhanced: 2.0.0 多面体サーフェス対応とTIN対応が導入されました。空ジオメトリを与えた場合に例外を投げなくなりました。
  • ST_Dump - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • ST_DumpPoints - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • ST_Expand - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • ST_Extent - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • ST_Force2D - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。
  • ST_ForceRHR - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。
  • ST_Force3D - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。
  • ST_Force3DZ - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。
  • ST_ForceCollection - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。
  • ST_GMLToSQL - Enhanced: 2.0.0 多面体サーフェス対応とTIN対応が導入されました。
  • ST_GMLToSQL - Enhanced: 2.0.0 SRID任意引数が追加されました。
  • ST_GeomFromEWKB - Enhanced: 2.0.0 多面体サーフェス対応とTIN対応が導入されました。
  • ST_GeomFromEWKT - Enhanced: 2.0.0 多面体サーフェス対応とTIN対応が導入されました。
  • ST_GeomFromGML - Enhanced: 2.0.0 多面体サーフェス対応とTIN対応が導入されました。
  • ST_GeomFromGML - Enhanced: 2.0.0 SRID任意引数が追加されました。
  • ST_GeometryN - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • ST_GeometryType - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。
  • ST_IsClosed - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。
  • ST_MakeEnvelope - Enhanced: 2.0 SRID指定なしでエンベロープを指定できるようになりました。
  • ST_MakeValid - Enhanced: 2.0.1 速度向上しました。GEOS 3.3.4が必要です。
  • ST_NPoints - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。
  • ST_NumGeometries - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • ST_Relate - Enhanced: 2.0.0 - 境界ノード規則が追加されました (GEOS 3.0以上が必要です)。
  • ST_Rotate - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • ST_Rotate - Enhanced: 2.0.0 回転の原点を指定するパラメタを追加しました。
  • ST_RotateX - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • ST_RotateY - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • ST_RotateZ - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • ST_Scale - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。
  • ST_ShiftLongitude - Enhanced: 2.0.0 多面体サーフェス対応とTIN対応が導入されました。
  • ST_Summary - Enhanced: 2.0.0でジオグラフィ対応が追加されました。
  • ST_Transform - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。
  • ValidateTopology - Enhanced: 2.0.0では、より効果的なエッジ交差検出が可能になり、以前の版で残っていた偽陽性を解決しています。
  • && - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。

14.12.7. PostGIS Functions changed behavior in 2.0

The functions given below are PostGIS functions that have changed behavior in PostGIS 2.0 and may require application changes.

[Note]

Most deprecated functions have been removed. These are functions that haven't been documented since 1.2 or some internal functions that were never documented. If you are using a function that you don't see documented, it's probably deprecated, about to be deprecated, or internal and should be avoided. If you have applications or tools that rely on deprecated functions, please refer to Q: 3.2 for more details.

[Note]

Bounding boxes of geometries have been changed from float4 to double precision (float8). This has an impact on answers you get using bounding box operators and casting of bounding boxes to geometries. E.g ST_SetSRID(abbox) will often return a different more accurate answer in PostGIS 2.0+ than it did in prior versions which may very well slightly change answers to view port queries.

[Note]

The arguments hasnodata was replaced with exclude_nodata_value which has the same meaning as the older hasnodata but clearer in purpose.

  • AddGeometryColumn - Changed: 2.0.0 geometry_columnsがシステムカタログを読むビューになったため、geometry_columnsを更新しないようになりました。デフォルトでは制約を生成せず、PostgreSQLの型修飾子を使います。この関数によるWGS 84のPOINTカラムの構築とALTER TABLE some_table ADD COLUMN geom geometry(Point,4326);とは等価です。
  • AddGeometryColumn - Changed: 2.0.0 制約を使う必要がある場合には、use_typmodをFALSEにします。
  • AddGeometryColumn - Changed: 2.0.0 ビューについては、geometry_columnsへの手動登録はできなくなりました。しかし、typmodテーブルジオメトリに対して構築されていて、かつラッパ関数が無いビューは、親テーブルカラムのtypmodの挙動を継承するので、正しく登録されます。他のジオメトリを出力するジオメトリ関数を使うビューについては、ビューのジオメトリカラムが正しく登録されるようにするため、typmodジオメトリへのキャストが必要です。を参照して下さい。
  • DropGeometryColumn - Changed: 2.0.0 この関数は後方互換のためのものです。geometry_columnsは現在はシステムカタログに対するビューですので、他のテーブルのカラムと同じようにALTER TABLEを使った削除が可能です。
  • DropGeometryTable - Changed: 2.0.0で この関数は後方互換のためのものです。geometry_columnsは現在はシステムカタログに対するビューですので、他のテーブルのカラムと同じようにDROP TABLEを使った削除が可能です。
  • Populate_Geometry_Columns - Changed: 2.0.0 デフォルトでは、ジオメトリタイプの制限について、制約を確認する代わりに型修飾子を使います。新しいuse_typmodをFALSEに設定して使うことで、制約確認を使用することができます。
  • Box3D - Changed: 2.0.0 以前の版では、box3dでなくbox2dを使っていました。box2dは非推奨型となり、box3dに変更しました。
  • ST_GDALDrivers - Changed: 2.0.6, 2.1.3 - GUC (訳注: Grand Unified Configurationの略で、動的に変更できるPostgreSQLパラメータ)または環境変数gdal_enabled_driversが設定されていないデフォルトではドライバが全て無効になりました。
  • ST_ScaleX - Changed: 2.0.0. WKTRaster版ではST_PixelSizeXと呼ばれていました。
  • ST_ScaleY - Changed: 2.0.0. WKTRaster版ではST_PixelSizeYと呼ばれていました。
  • ST_SetScale - Changed: 2.0.0 WKTRaster版では、ST_SetPixelSizeと呼ばれていました。2.0.0で変更されました。
  • ST_3DExtent - Changed: 2.0.0 以前の版ではST_Extent3Dと呼ばれていました。
  • ST_3DLength - Changed: 2.0.0 以前の版ではST_Length3Dと呼ばれていました。
  • ST_3DMakeBox - Changed: 2.0.0以前の版ではST_MakeBox3Dと呼ばれていました。
  • ST_3DPerimeter - Changed: 2.0.0 以前の版ではST_Perimeter3Dと呼ばれていました。
  • ST_AsBinary - Changed: 2.0.0 この関数への入力は不明な型にすることができなくなり、必ずジオメトリでなければなりません。ST_AsBinary('POINT(1 2)')といった構築ではもはや妥当ではなく、n st_asbinary(unknown) is not unique errorが得られます。このようなコードはST_AsBinary('POINT(1 2)'::geometry);に変更する必要があります。これが不可能な場合にはlegacy.sqlをインストールして下さい。
  • ST_AsGML - Changed: 2.0.0 デフォルトの名前付き引数を使います。
  • ST_AsGeoJSON - Changed: 2.0.0 デフォルト引数と名前付き引数に対応しました。
  • ST_AsKML - Changed: 2.0.0 - デフォルト引数と名前付き引数に対応しました。
  • ST_AsSVG - Changed: 2.0.0 - デフォルト引数と名前付き引数に対応しました。
  • ST_EndPoint - Changed: 2.0.0では単一ジオメトリのMULTILINESTRINGで動作しなくなりました。単一のラインストリングからなるMULTILINESTRINGについては幸運にも動いていて、最初のポイントを返していました。2.0.0では他のMULTILINESTRINGと同様にNULLを返すようになりました。古い挙動は記載されていませんでしたが、LINESTRINGとして格納されているデータを持っていると思われる人々は2.0でNULLが返って来ることを経験することでしょう。
  • ST_GeomFromText - Changed: 2.0.0 前の版ではST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)')が許されていました。SQL/MM標準への適合のためPostGIS 2.0.0では不正とされます。今はST_GeomFromText('GEOMETRYCOLLECTION EMPTY')となります。
  • ST_GeometryN - Changed: 2.0.0 以前の版では非マルチのジオメトリではNULLが返りました。ST_GeometryN(..,1)の場合にはジオメトリを返すよう変更されました。
  • = - Changed: 2.0.0 ジオメトリのバウンディングボックスをfloat4使用から倍精度使用に変更しました。ほんの少し違う位置にある特定のポイントについて、float4でのバウンディングボックスなら同じになるのにfloat8 (倍精度)でのバウンディングボックスでは異なるため、以前の版ではtrueが返ったのが2.0以上ではfalseが返る、という副作用があります。
  • ST_IsEmpty - Changed: 2.0.0 以前の版のPostGISではST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)')を許しました。PostGIS 2.0.0では、SQL/MM標準により準拠させるため、これは不正となります。
  • ST_Length - Changed: 2.0.0 大幅な変更 -- 以前の版ではジオグラフィのPOLYGONやMULTIPOLYGONへの適用によってPOLYGONやMULTIPOLYGONの周囲長を返しました。2.0.0版ではジオメトリの挙動に従うため0を返すように変更しました。ポリゴンの周囲長を求める場合は、ST_Perimeterを使います。
  • ST_LocateAlong - Changed: 2.0.0 以前の版ではST_Locate_Along_Measureと呼ばれていましたが、古い名前は非推奨となり、将来的には削除しますが現時点では有効です。
  • ST_LocateBetween - Changed: 2.0.0 以前の版でST_Locate_Between_Measuresと呼ばれていましたが、古い名前は非推奨となり、将来的には削除しますが現時点では後方互換のため有効になっています。
  • ST_ModEdgeSplit - Changed: 2.0 - 以前の版では名前を間違えてST_ModEdgesSplitになっていました。
  • ST_NumGeometries - Changed: 2.0.0 前の版では、ジオメトリがコレクション/マルチ系でない場合にはNULLを返しました。2.0.0以上では、POLYGON, LINESTRING, POINTといった単一ジオメトリについては1を返します。
  • ST_NumInteriorRings - Changed: 2.0.0 - in prior versions it would allow passing a MULTIPOLYGON, returning the number of interior rings of first POLYGON.
  • ST_PointN - Changed: 2.0.0 単一ジオメトリのMULTILINESTRINGで動作しなくなりました。単一のラインストリングからなるMULTILINESTRINGについては幸運にも動いていて、最初のポイントを返していました。2.0.0では他のMULTILINESTRINGと同様にNULLを返すようになりました。
  • ST_StartPoint - Changed: 2.0.0では単一ジオメトリのMULTILINESTRINGで動作しなくなりました。単一のラインストリングからなるMULTILINESTRINGについては幸運にも動いていて、最初のポイントを返していました。2.0.0では他のMULTILINESTRINGと同様にNULLを返すようになりました。古い挙動は記載されていませんでしたが、LINESTRINGとして格納されているデータを持っていると思われる人々は2.0でNULLが返って来ることを経験することでしょう。

14.12.8. PostGIS Functions new, behavior changed, or enhanced in 1.5

The functions given below are PostGIS functions that were introduced or enhanced in this minor release.

  • PostGIS_LibXML_Version - Availability: 1.5 LibXML2ライブラリのバージョン番号を返します。
  • ST_AddMeasure - Availability: 1.5.0 始点と終点の間を線型補完した、M値を持つ派生ジオメトリを返します。
  • ST_AsBinary - Availability: 1.5.0 ジオグラフィが導入されました。 ジオメトリ/ジオグラフィのSRIDメタデータのないWell-Known Binary (WKB)表現を返します
  • ST_AsGML - Availability: 1.5.0 ジオグラフィが導入されました。 GML第2版または第3版としてジオメトリを返します。
  • ST_AsGeoJSON - Availability: 1.5.0 ジオグラフィが導入されました。 GeoJSON要素としてジオメトリを返します。
  • ST_AsText - Availability: 1.5 - ジオグラフィ対応が導入されました。 ジオメトリ/ジオグラフィのSRIDメタデータのないWell-Known Text (WKT)表現を返します。
  • ST_Buffer - Availability: 1.5 - ST_Bufferが異なる終端と継ぎ目の型に対応するよう強化されました。たとえば、道路ラインストリングを、丸の代わりに平坦や四角形の終端を持つ道路ポリゴンに変換するのに使います。ジオグラフィ用の薄いラッパが追加されました。最新のジオメトリ機能の利点を得るにはGEOS 3.2以上が必要です。 (T) Returns a geometry covering all points within a given distance from the input geometry.
  • ST_ClosestPoint - Availability: 1.5.0 g2に最も接近するg1上の2次元のポイントを返します。これは最短線の最初のポイントです。
  • ST_CollectionExtract - Availability: 1.5.0 Given a (multi)geometry, return a (multi)geometry consisting only of elements of the specified type.
  • ST_Covers - Availability: 1.5 - ジオグラフィ対応が導入されました。 ジオメトリBにジオメトリAの外となるポイントが無い場合には、1 (TRUE)を返します。
  • ST_DFullyWithin - Availability: 1.5.0 全てのジオメトリが指定したジオメトリから指定した距離内にある場合にTRUEを返します。
  • ST_DWithin - Availability: 1.5.0 ジオグラフィが導入されました。 ジオメトリが指定したジオメトリから指定した距離内にある場合にTRUEを返します。ジオメトリについては、距離は空間参照系で定義されている単位になります。ジオグラフィについては、メートル単位で、デフォルトではuse_spheroid=true (回転楕円体を使った計算)となり、速いチェックをするにはuse_spheroid=falseとして球面を使って計算します。
  • ST_Distance - Availability: 1.5.0 1.5でジオグラフィ対応が導入されました。大きいジオメトリや頂点の多いジオメトリについての速度が改善しました。 ジオメトリ型については、二つのジオメトリの、2次元の最小デカルト距離 (空間参照系に基づきます)を、投影法の単位で返します。ジオグラフィ型については、デフォルトでは、二つのジオメトリ間の測地距離をメートル単位で返します。
  • ST_DistanceSphere - Availability: 1.5 - ポイント以外のジオメトリが導入されました。以前の版ではポイントでのみ動作しました。 二つの経度緯度ジオメトリの間の最短距離をメートル単位で返します。SRIDで定義された回転楕円体に由来する半径となる球面を使います。より高速ですが、精度が悪くなります。PostGISの1.5より前の版ではポイント間の計測のみ実装していました。
  • ST_DistanceSpheroid - Availability: 1.5 - ポイント以外のジオメトリが導入されました。以前の版ではポイントでのみ動作しました。 指定した回転楕円体による、二つの経度緯度ジオメトリ間の最小距離を返します。PostGIS 1.5より前ではポイント間の計測のみ対応していました。
  • ST_DumpPoints - Availability: 1.5.0 ジオメトリを作る全ての点のgometry_dump(geom,path)行の集合を返します。
  • ST_Envelope - Availability: 1.5.0 挙動が変更され出力がfloat4からfloat8になりました。 ジオメトリの浮動小数点数 (float8)バウンディングボックスを表現するジオメトリを返します。
  • ST_GMLToSQL - Availability: 1.5 libxml2 1.6+が必要です。 GML表現から指定したST_Geometry値を返します。これはST_GeomFromGMLの別名です。
  • ST_GeomFromGML - Availability: 1.5 libxml2 1.6+が必要です。 GML表現からPostGISジオメトリオブジェクトを出力します。
  • ST_GeomFromKML - Availability: 1.5 libxml2 2.6以上が必要です。 ジオメトリのKML表現の入力をとり、PostGISジオメトリオブジェクトを出力します。
  • ~= - Availability: 1.5.0 挙動が変更されました AのバウンディングボックスがBのバウンディングボックスと同じ場合にTRUEを返します。
  • ST_HausdorffDistance - Availability: 1.5.0 - GEOS 3.2.0以上が必要です。 二つのジオメトリ間のハウスドルフ距離を返します。基本的にジオメトリが似ているかどうかを計測するものです。単位はジオメトリの空間参照系の単位です。
  • ST_Intersection - Availability: 1.5 ジオグラフィ型が導入されました。 (T) Returns a geometry that represents the shared portion of geomA and geomB.
  • ST_Intersects - Availability: 1.5 ジオグラフィ対応が導入されました。 ジオメトリ/ジオグラフィが「2次元空間で空間的にインタセクトする」 (空間に共有部分がある)場合にTRUEを返します。そうでない (非接続)場合はFALSEを返します。ジオグラフィについては、許容量は0.00001メートルです (近い点はインタセクトと考えられてしまいます)。
  • ST_Length - Availability: 1.5.0 ジオグラフィt対応が導入されました。 ジオメトリがLINESTRINGまたはMULTILINESTRINGの場合には、それらの2次元長を返します。ジオメトリでは、単位は空間参照系の単位です。ジオグラフィでは、メートル単位です (回転楕円体がデフォルトです)。
  • ST_LongestLine - Availability: 1.5.0 二つのジオメトリの2次元長が最長となるラインを返します。見つかったラインが複数ある場合は、最初のもののみ返します。返されるラインは常にg1側を始点、g2側を終点とします。この関数が返すラインの長さは、常に始点をg1に終点をg2にそれぞれ指定した場合のST_MaxDistanceが返す値と同じになります。
  • ST_MakeEnvelope - Availability: 1.5 与えられた最小値と最大値から長方形ポリゴンを生成します。入力値はSRIDで指定された空間参照系でなければなりません。
  • ST_MaxDistance - Availability: 1.5.0 二つのジオメトリ間の2次元距離の最大値を、投影法の単位で返します。
  • ST_ShortestLine - Availability: 1.5.0 二つのジオメトリの2次元長が最短となるラインを返します。
  • && - Availability: 1.5.0 ジオグラフィ対応が導入されました。 Aの2次元バウンディングボックスがBの2次元バウンディングボックスとインタセクトする場合にTRUEを返します。

14.12.9. PostGIS Functions new, behavior changed, or enhanced in 1.4

The functions given below are PostGIS functions that were introduced or enhanced in the 1.4 release.

  • Populate_Geometry_Columns - ジオメトリカラムが型修飾子で定義されるか、適切な制約を持つことを確実にします。ジオメトリカラムがgeometry_columnsに正しく登録されることを確実にします。デフォルトでは、型修飾子によらないジオメトリカラムを型修飾子によるジオメトリカラムに変換します。以前の挙動にするにはuse_typmod=falseとします。 Availability: 1.4.0
  • ST_AsSVG - ジオメトリまたはジオグラフィで与えられたSVGパスデータによるジオメトリを返します。 Availability: 1.2.2. Availability: 1.4.0 PostGIS 1.4.0でhttp://www.w3.org/TR/SVG/paths.html#PathDataBNFに従うため、絶対パスにLコマンドが入りました。
  • ST_Collect - 他のジオメトリのコレクションから、指定したST_Geometry値を返します。 Availability: 1.4.0 - ST_Collect(geometry)が導入されました。ST_Collectがより多くのジオメトリをより早く扱えるよう強化されました。
  • ST_ContainsProperly - BがAの内部にインタセクトするが境界 (または外部)にインタセクトしない場合に、TRUEを返します。Aは自身には、ContainsProperlyではありませんが、Containsです。 Availability: 1.4.0 - GEOS 3.1.0以上が必要です。
  • ST_Extent - ジオメトリのバウンディングボックスを返す集約関数です。 Availability: 1.4.0
  • ST_GeoHash - ジオメトリのGeoHash表現を返します。 Availability: 1.4.0
  • ST_IsValidReason - ジオメトリが妥当か否かを示す文字列を返し、不正な場合は理由を返します。 Availability: 1.4 - GEOS 3.1.0以上が必要です
  • ST_LineCrossingDirection - 与えられた二つのラインストリングに関するクロスの種類を-3から3の区間の数で返します。0の場合はクロスしていません Availability: 1.4
  • ST_LocateBetweenElevations - 指定したZ値の範囲内にある要素からなる、派生ジオメトリ (コレクション)値を返します。3次元、4次元のLINESTRINGSとMULTILINESTRINGSのみに対応しています。 Availability: 1.4.0
  • ST_MakeLine - Creates a Linestring from point, multipoint, or line geometries. Availability: 1.4.0 - ST_MakeLine(geomarray)が導入されました。ST_MakeLine集約関数はより多くのポイントをより早く扱うための強化が施されています。
  • ST_MinimumBoundingCircle - ジオメトリを完全に含む最小の円ポリゴンを返します。デフォルトでは、4分の1円に対して48区分を使用します。 Availability: 1.4.0 - GEOSが必要です。
  • ST_Union - ジオメトリの結合の点集合を表現するジオメトリを返します。 Availability: 1.4.0 - ST_Unionが強化されました。ST_Union(geomarray)が導入され、また、PostgreSQL内での集計が速くなりました。GEOS 3.1.0以上を使用している場合は、ST_Unionは、http://blog.cleverelephant.ca/2009/01/must-faster-unions-in-postgis-14.htmlに記述がある、Cascaded Unionアルゴリズムを使います。

14.12.10. PostGIS Functions new in 1.3

The functions given below are PostGIS functions that were introduced in the 1.3 release.

  • ST_AsGML - GML第2版または第3版としてジオメトリを返します。 Availability: 1.3.2
  • ST_AsGeoJSON - GeoJSON要素としてジオメトリを返します。 Availability: 1.3.4
  • ST_SimplifyPreserveTopology - 与えられたジオメトリを「簡略化」したものを返します。Douglas-Peukerアルゴリズムを使用します。不正な派生ジオメトリ (特にポリゴン)の生成を回避します。 Availability: 1.3.3