PostGIS 3.4.0dev マニュアル

DEV (Fri 14 Jul 2023 07:05:08 AM UTC rev. ab511bf )

PostGIS開発グループ

Abstract

PostGISは、オブジェクトRDBであるPostgreSQLの拡張で、GIS (地理情報システム)オブジェクトを格納することができます。PostGISは、GiSTベースのR木空間インデクスをサポートし、GISオブジェクトの解析および処理を行う機能を持ちます。

本マニュアルは、3.4.0dev版のマニュアルです。

PostGIS 3.4.0dev マニュアル この作品はクリエイティブ・コモンズ 表示 - 継承 3.0 非移植 ライセンスの下に提供されています。好きなようにこの材料を使うことができますが、PostGIS Project のクレジット提示を求めます。また可能な限りhttp://postgis.netへのリンクを求めます。

Chapter 1. 導入

PostGISは、PostgreSQLリレーショナルデータベースの空間拡張です。Refractions Research Incが、空間データベース技術の研究プロジェクトとして作成しました。Refractionsはカナダ・ブリティッシュコロンビア州・ビクトリアにある、データインテグレーションとカスタムソフトウェア開発に特化した、GISとデータベースのコンサルティング会社です。

PostGISは、現在ではOSGeo財団のプロジェクトです。多数のFOSS4G開発者とPostGISの機能と多彩さから大きな利益を得る世界中の企業が、PostGISの開発と資金提供を行っています。

PostGISプロジェクトの開発グループは、PostGISが、OGCとSQL/MM空間標準の領域における重要なGIS機能、高度なトポロジ構築 (カバレッジ、サーフェス、ネットワーク)、GISデータの表示と編集を行うデスクトップユーザインタフェースツールのデータソース、およびウェブベースのアクセスツールのためのデータソースに、より良く対応するよう、サポートと機能強化を行う予定です。

プロジェクト運営委員会

PostGISプロジェクト運営委員会 (PostGIS Project Steering Committee, PSC)は、総合的な指示、リリースサイクル、ドキュメンテーション、支援活動に関する調整を行っています。また、委員会は、全体的なユーザサポート、PostGISコミュニティからのパッチの受け付けと適用、 開発者のコミットのアクセス、新しい委員、APIの重要な変更といった、PostGISを含む雑多な問題に関する投票を行っています。

Raúl Marín Rodríguez

MVT機能、誤り修正、パフォーマンスと安定性の向上、GitHubキュレーション、PostGISとPostgreSQLのリリースの調整

Regina Obe

Buildbotのメンテナンス、Windows版と試験版のビルド、ドキュメンテーション、PostgreSQLとの調整、X3D対応、Tiger Geocoder機能、関数管理。

Darafei Praliaskouski

インデックス改善、誤り修正とジオメトリ/ジオグラフィ関数の改善、SFCGAL、ラスタ、GitHubキュレーション、Botのメンテナンス。

Paul Ramsey (委員長)

PostGISプロジェクトの副創始者。総合的なバグフィクス、ジオグラフィ機能、ジオグラフィとジオメトリのインデックス機能 (2次元,、3次元、n次元インデクスとあらゆる空間インデクス)、ジオメトリ内部構造、GEOS機能の統合とGEOSリリースとの調整、PostgreSQLのリリースとの調整、ローダ/ダンパ、シェープファイルGUIローダ。

Sandro Santilli

誤り修正とメンテナンス、ビルドボットのメンテナンス、gitミラーの管理、関数管理、GEOSの新機能の統合、GEOSリリースとの調整、トポロジ機能、ラスタフレームワークと低水準API関数。

現在の中核貢献者

Nicklas Avén

距離関数の強化 (3次元距離、関係関数を含む)と追加、Tiny WKB出力書式（TWKB）と一般的なユーザサポート。

Dan Baston

ジオメトリクラスタリング関数の追加、他のジオメトリアルゴリズムの強化、GEOSの強化、および全体のユーザ対応

Martin Davis

GEOS機能強化と文書

Björn Harrtell

MapBox Vector Tile関数とGeoBuf関数、Gogsの試験とGitLabの実験。

Aliaksandr Kalenik

ジオメトリ処理、PostgreSQL GiST、共通部の誤り修正

過去の中核貢献者

Bborie Park

以前のPSCメンバ。ラスタ開あｈ津、GDALとの統合、ラスタローダ、ユーザ対応、共通部の誤り修正、様々なOS (Slackware、Mac、Windows等多数)での試験

Mark Cave-Ayland

以前のPSCメンバ。誤り修正とメンテナンスの活動、空間インデックス選択性とバインディング、ローダ/ダンパ、およびシェープファイルGUIローダの調整、新機能の統合と強化。

Jorge Arévalo

ラスタ開発、GDALドライバ機能、ローダ。

Olivier Courtin

(名誉) XML (KML, GML)/GeoJSON入出力関数と3次元対応と誤り修正。

Chris Hodgson

以前のPSCメンバ。一般的な開発、サイトとBuildbotのメンテナンス、OSGeoインキュベーション管理。

Mateusz Loskot

CMakeのPostGISへの対応、Python版のオリジナルのラスタローダと低級ラスタAPI関数の構築。

Kevin Neufeld

以前のPSCメンバ。文書と文書補助ツール、Buildbotのメンテナンス、PostGISニュースグループでの高度なユーザサポート、PostGISメンテナンス機能の強化。

Dave Blasby

PostGISのオリジナルの開発/副創始者。サーバサイドのオブジェクト、インデクスのバインディングや多数のサーバサイドの解析機能を記述。

Jeff Lounsbury

シェープファイルのローダ/ダンパのオリジナル開発者。

Mark Leslie

中核機能の、継続的なメンテナンスと開発。曲線機能の強化。シェープファイルGUIローダ。

Pierre Racine

PostGISラスタ実装の設計。ラスタ全体のアーキテクチャ、プロトタイプ作成、プログラミング補助

David Zwarg

ラスタ開発 (ほとんど地図代数解析関数)。

他の貢献者

個人

Alex Bodnaru | Gino Lucrezi | Matthias Bay
Alex Mayrhofer | Greg Troxel | Maxime Guillaud
Andrea Peri | Guillaume Lelarge | Maxime van Noppen
Andreas Forø Tollefsen | Giuseppe Broccolo | Michael Fuhr
Andreas Neumann | Han Wang | Mike Toews
Andrew Gierth | Haribabu Kommi | Nathan Wagner
Anne Ghisla | Havard Tveite | Nathaniel Clay
Antoine Bajolet | IIDA Tetsushi | Nikita Shulga
Arthur Lesuisse | Ingvild Nystuen | Norman Vine
Artur Zakirov | Jackie Leng | Patricia Tozer
Barbara Phillipot | James Marca | Rafal Magda
Ben Jubb | Jan Katins | Ralph Mason
Bernhard Reiter | Jason Smith | Rémi Cura
Björn Esser | Jeff Adams | Richard Greenwood
Brian Hamlin | Jim Jones | Robert Coup
Bruce Rindahl | Joe Conway | Roger Crew
Bruno Wolff III | Jonne Savolainen | Ron Mayer
Bryce L. Nordgren | Jose Carlos Martinez Llari | Sebastiaan Couwenberg
Carl Anderson | Jörg Habenicht | Sergei Shoulbakov
Charlie Savage | Julien Rouhaud | Sergey Fedoseev
Christian Schroeder | Kashif Rasul | Shinichi Sugiyama
Christoph Berg | Klaus Foerster | Shoaib Burq
Christoph Moench-Tegeder | Kris Jurka | Silvio Grosso
Dane Springmeyer | Laurenz Albe | Stefan Corneliu Petrea
Daryl Herzmann | Lars Roessiger | Steffen Macke
Dave Fuhry | Leo Hsu | Stepan Kuzmin
David Garnier | Loïc Bartoletti | Stephen Frost
David Skea | Loic Dachary | Steven Ottens
David Techer | Luca S. Percich | Talha Rizwan
Dmitry Vasilyev | Lucas C. Villa Real | Tom Glancy
Eduin Carrillo | Maria Arias de Reyna | Tom van Tilburg
Eugene Antimirov | Marc Ducobu | Victor Collod
Even Rouault | Mark Sondheim | Vincent Mora
Florian Weimer | Markus Schaber | Vincent Picavet
Frank Warmerdam | Markus Wanner | Volf Tomáš
George Silva | Matt Amos |
Gerald Fenoy | Matt Bretl |

企業

これらは、PostGISプロジェクトに開発者の時間、ホスティング、または直接の資金提供のいずれかの貢献をした企業です。アルファベット順:

Aiven

Arrival 3D

Associazione Italiana per l'Informazione Geografica Libera (GFOSS.it)

AusVet

Avencia

Azavea

Boundless

Cadcorp

Camptocamp

Carto

Crunchy Data

ボストン市 (近隣地区開発局)

ヘルシンキ市

Clever Elephant Solutions

Cooperativa Alveo

Deimos Space

Faunalia

Geographic Data BC

Hunter Systems Group

ISciences, LLC

Kontur

Lidwala Consulting Engineers

LISAsoft

Logical Tracking & Tracing International AG

Maponics

ミシガン工科大学研究所

カナダ天然資源省

ノルウェー森林景観研究所

ノルウェー生物経済研究所 (NIBIO)

OSGeo財団

Oslandia

Palantir Technologies

Paragon Corporation

R3 GIS

Refractions Research

トスカナ州- SITA

Safe Software

Sirius Corporation plc

ウスター市

カリフォルニア大デービス校節足動媒介感染症センター

ラヴァル大学

米国国務省 (人道情報部門)

Zonar Systems

クラウドファンディングキャンペーン

クラウドファンディングキャンペーンは、PostGIS開発チームが走らせているキャンペーンです。欲しくて仕方ない機能に資金を与えて、多数の人々にサービスを提供できるようにするためのものです。それぞれのキャンペーンでは、特定の機能または機能の集合に焦点があてられます。それぞれのスポンサーは、必要な資金提供のうち少しだけを提供し、十分な人/組織の寄付で、たくさんの助けになる作業に支払う基金を持ちます。他の多くの人が寄付に協力してくれそうな機能に関するアイデアがありましたら、PostGIS newsgroupに、その考えを投稿して下さい。一緒に実現できます。

PostGIS 2.0.0はこの戦略を実施する最初のリリースです。PledgeBankを使い、2件のキャンペーンが成功しました。

postgistopology - 10以上のスポンサーがTopoGeometry機能の構築と2.0.0でのトポロジ対応強化とのために、それぞれ250米ドルを寄付しました。

postgis64windows - 20のスポンサーが、Windows上でのPostGIS 64ビット版に必要な作業のために、それぞれ100米ドルを寄付しました。

重要なサポートライブラリ

ジオメトリ演算ライブラ GEOS

地理空間データ抽象化ライブラリGDALは、PostGIS 2で導入されたラスタ機能の多くに使われています。また、GDALのPostGIS対応に必要な改善でGDALプロジェクトに貢献しています。

地図投影ライブラリPROJ

最後ですがおろそかにできないのがPostgreSQLです。PostGISはこの巨人に立っています。PostGISの速度と柔軟性は、PostgreSQLが提供する拡張性、優れたクエリプランナ、GiSTインデックス、多数のSQL機能があって初めて成り立ちます。

Chapter 2. PostGISインストール

本章では、PostGISのインストールに必要な手順について説明します。

簡略版

全ての依存がパスに入っているとする場合、次のようにコンパイルします。

tar -xvfz postgis-3.4.0dev.tar.gz
cd postgis-3.4.0dev
./configure
make
make install

PostGISをインストールした後は、利用したいデータベース個々内で利用可能にする (the section called “空間データベースの作成”)か、アップグレード (the section called “空間データベースのアップグレード”)する必要があります。

ソースからのコンパイルとインストール

Note

多くのOSで、ビルドされたPostgreSQL/PostGISパッケージがあります。多くの場合、コンパイルが必要なのは、最もひどい最先端の版が欲しい場合やパッケージメンテナンスを行う人ぐらいです。

本節では、一般的なコンパイル手順を示します。Windows用や他のOS用等にコンパイルするなら、PostGIS User contributed compile guidesやPostGIS Dev Wikiで、より詳細な助けが見つかるかも知れません。

多くのOS用のビルド済みパッケージの一覧はPostGIS Pre-built Packagesにあります。

Windowsユーザの場合は、スタックビルダか、PostGIS Windows download siteから安定版を得ることができます。また、週に1回か2回のビルドと刺激的なことがあった時の随時ビルドとを行っているvery bleeding-edge windows experimental buildsもあります。これらはPostGISの進行中のリリースでの試験に使用します。

PostGISモジュールは、PostgreSQLバックエンドサーバの拡張です。PostGIS 3.4.0devでは、コンパイルのために、完全なPostgreSQLサーバヘッダが必要です。PostgreSQL 12 - 16の間でビルドできます。古い版のPostgreSQLはサポートされません。

PostgreSQLをインストールしていないならPostgreSQLインストールガイドを参照して下さい。http://www.postgresql.org/にあります。

Note

GEOS機能を有効にするために、PostgreSQLをインストール時に明示的に標準C++ライブラリに対する明示的なリンクが必要になる場合があります。

LDFLAGS=-lstdc++ ./configure [コンフィギュアオプション]

これは、古い開発ツールとインチキC++例外との対話のための応急処置です。怪しい問題 (望んでいないのにバックエンドが閉じたりそれに近い挙動を起こす)を経験したなら、このトリックを試してみて下さい。もちろん、これを行うにはPostgreSQLをはじめからコンパイルし直す必要があります。

次のステップでは、PostGISソースのコンフィギュレーションとコンパイルに概要を記述します。これらは、Linuxユーザ用に書いてありますので、WindowsやMacでは動作しません。

ソースの取得

ダウンロードサイト http://postgis.net/stuff/postgis-3.4.0dev.tar.gz からソースのアーカイブを入手します。

wget http://postgis.net/stuff/postgis-3.4.0dev.tar.gz
tar -xvzf postgis-3.4.0dev.tar.gz
cd postgis-3.4.0dev

これで、カレントディレクトリの下にpostgis-3.4.0devができます。

もしくは git レポジトリ https://git.osgeo.org/gitea/postgis/postgis/ からチェックアウトします。

git clone https://git.osgeo.org/gitea/postgis/postgis.git postgis
cd postgis
sh autogen.sh

新しく作られたpostgisディレクトトリに移動して、インストールを続けます。

./configure

インストール要件

PostGISのビルドと利用のために、次のものが必要です。

必須

PostgreSQL 12 - 16。PostgreSQLの完全なインストール (サーバヘッダを含む)が必要です。PostgreSQLは http://www.postgresql.org/にあります。

完全なPosgreSQL/PostGIS対応表とPostGIS/GEOS対応表についてはhttp://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGISをご覧ください。

GNU Cコンパイラ (gcc)。ANSI Cコンパイラの中には、PostGISをコンパイルできるものもありますが、gccでコンパイルするのが最も問題が少ないと見ています。

GNU Make (gmakeまたはmake)。多くのシステムで、GNU makeがデフォルトのmakeになっています。make -vを実行して版を確認して下さい。他版のmakeでは、PostGISのMakefileを完全に処理しきれないかもしれません。

投影変換ライブラリProj。Proj 6.1以上が必要です。Projライブラリは、PostGISの座標系投影変換機能に使われます。Projは https://proj.org/ からダウンロードできます。

ジオメトリライブラリ GEOS、3.6以上が必要ですが、全ての関数と機能の利点を完全に得るにはGEOS 3.11以上が必要です。GEOSは https://libgeos.org からダウンロードできます。

LibXML2, 2.5.x以上。現在は、LibXML2はインポート関数 (ST_GeomFromGMLとST_GeomFromKML)で使われています。LibXML2はhttps://gitlab.gnome.org/GNOME/libxml2/-/releasesからダウンロードできます。

JSON-C 0.9以上。JSON-Cは現在、ST_GeomFromGeoJsonによるGeoJSONの取り込みに使われます。JSON-Cはhttps://github.com/json-c/json-c/releases/からダウンロード可能です。

GDAL, version 2以上が必要で以上が好ましいです。ラスタ機能に必要です。https://gdal.org/download.html。

PostgreSQL+JITでコンパイルする場合には、LLVM 6版以上が必要です。https://trac.osgeo.org/postgis/ticket/4125を参照して下さい。

オプション

GDAL (擬似的任意)。ラスタが必要ない場合に限り不要です。the section called “ラスタ機能の設定”の説明に従って使用したいドライバを有効にしてください。

GTK (GTK+2.0, 2.8+が必要)。シェープファイルのローダであるshp2pgsql-guiのコンパイル用です。http://www.gtk.org/にあります。

SFCGL 1.3.1 (以上)、1.4.1以上が推奨で、全ての機能を使うに必要です。SFCGALはthe section called “SFCGAL関数”に示すような追加的な2次元や3次元の高度な解析関数をPostGISに与えることができます。GEOSと両方のバックエンドから提供される2次元関数 (ST_IntersectionやST_Areaなど)で、SFCGALを使用することもできます。SFCGALがインストールされている場合には、PostgreSQLコンフィギュレーション変数postgis.backendを使ってエンドユーザがどちらのバックエンドを使うか選択できます (デフォルトはGEOS)。ご注意: SFCGAL 1.2は少なくともCGAL 4.3とBooset 1.54が必要です (https://oslandia.gitlab.io/SFCGAL/dev.html) https://gitlab.com/Oslandia/SFCGAL/。

the section called “住所標準化”をビルドするには、PCRE http://www.pcre.org (通常はnixシステムにはインストールされています)も必要です。PCREライブラリを検出したらthe section called “住所標準化”は自動でビルドされます。もしくは、コンフィギュアの際に有効な--with-pcre-dir=/path/to/pcreを指定します。

ST_AsMVTを有効にするには、protobuf-cライブラリ (実行時)とprotoc-cコンパイラ (ビルド時)が必要です。protobuf-cの正しい最小版を確認するには、pkg-configが必要です。protobuf-cをご覧下さい。デフォルトでは、PostGISは、MVTポリゴンを高速に評価するためにWagyuを使用していますが、C++11コンパイラが必要です。CXXFLAGSを使って、PostgreSQLインストールに使ったのと同じコンパイラを使います。これを無効化してGEOSを代わりに使う場合には、コンフィギュレーション時に--without-wagyuを指定します。

CUnit (CUnit)。レグレッションテストに必要です。http://cunit.sourceforge.net/にあります。

DocBook (xsltproc)。文書のビルドに必要です。http://www.docbook.org/にあります。

DBLatex (dblatex)。文書をPDFでビルドするのに必要です。http://dblatex.sourcforge.net/にあります。

ImageMagick (convert)。文書で使う画像を生成するのに必要です。http://www.imagemagick.org/にあります。

コンフィギュレーション

ほとんどのLinuxのインストールと同様に、最初のステップでは、ソースコードのビルドに使われるMakefileを生成します。これは、シェルスクリプトが行います。

./configure

パラメータを付けない場合には、このコマンドは自動で、PostGISのソースコードのビルドを行うのに必要なコンポーネントやライブラリをシステム上で探します。./configureとするのが一般的な使い方ですが、標準的でない位置に必要なライブラリやプログラムを置いてある場合のために、いくつかのパラメータを受け付けます。

次のリストで、共通して使われるパラメータを示します。 完全なリストについては、--helpまたは--help=shortパラメータを使って下さい。

--with-library-minor-version

PostGIS 3.0以降では、デフォルトではライブラリファイルのファイル名にマイナーバージョンが入らなくなりました。PostGIS 3のライブラリはpostgis-3で終わります。pg_upgradeを簡単にするために実施された変更ですが、サーバにPostGIS 3シリーズは一つのマイナーバージョンのものだけしかインストールできません。postgis-3.0といったようにマイナーバージョンをファイル名に含む古い振る舞いにしたいなら、コンフィギュレーション実行の際に次のスイッチを追加します。

--prefix=PREFIX

PostGISライブラリとSQLスクリプトのインストール先を指定します。デフォルトでは、検出されたPostgreSQLのインストール先と同じになります。

Caution

このパラメータは現在のところ壊れていて、PostgreSQLのインストール先にしかインストールされません。このバグのトラックについてはhttp://trac.osgeo.org/postgis/ticket/635をご覧ください。

--with-pgconfig=FILE

PostgreSQLは、PostGISなどの拡張に対してPostgreSQLのインストール先ディレクトリを伝えるpg_configというユーティリティを持っています。PostGISの対象とする特定のPostgreSQLのインストール先を手動で指定する場合に、このパラメータ(--with-pgconfig=/path/to/pg_config)を使います。

--with-gdalconfig=FILE

必須ライブラリであるGDALは、ラスタ機能に必要な機能を提供します。GDALには、インストール先ディレクトリをインストールスクリプトに伝えるgdal-configがあります。PostGISのビルドに使う特定のGDALを手動で指定する場合に、このパラメータ (--with-gdalconfig=/path/to/gdal-config)を使います。

--with-geosconfig=FILE

必須のジオメトリライブラリであるGEOSには、ソフトウェアのインストール時にGEOSのインストール先ディレクトリを伝えるgeos-configというユーティリティがあります。PostGISのビルドに使う特定のGEOSを手動で指定する場合に、このパラメータ (--with-geosconfig=/path/to/geos-config)を使います。

--with-xml2config=FILE

LibXMLはGeomFromKML/GML処理を行うのに必須のライブラリです。通常はlibxmlをインストールしているなら発見されますが、発見できない場合や特定の版を使用したい場合は、xml2-configを指定してインストールスクリプトにLibXMLのインストール先ディレクトリを伝えます。PostGISのビルドに使う特定のLibXMLを手動で指定する場合に、このパラメータ ( >--with-xml2config=/path/to/xml2-config)を使います。

--with-projdir=DIR

ProjはPostGISに必須の投影変換ライブラリです。PostGISのビルドに使う特定のProjのインストールディレクトリを手動で指定する場合は、このパラメータ (--with-projdir=/path/to/projdir)を使います。

--with-libiconv=DIR

iconvのインストール先ディレクトリを指定します。

--with-jsondir=DIR

JSON-Cは、MITライセンスのJSONライブラリで、PostGISのST_GeomFromJSONに必須です。PostGISのビルドに使う特定のJSON-Cを手動で指定する場合に、このパラメータ (--with-jsondir=/path/to/jsondir)を使います。

--with-pcredir=DIR

PCREは、BSDライセンスのPerl互換正規表現ライブラリです。住所標準化エクステンションに必須です。PostGISのビルド対象としている特定のPCREを手動で指定する場合に、このパラメータ (--with-pcredir=/path/to/pcredir)を使います。

--with-gui

データインポートGUI (GTK+2.0が必要)をコンパイルします。このパラメータによって、shp2pgsql-guiという、shp2pgsqlのグラフィカルユーザインタフェースが作成されます。

--without-raster

ラスタ機能なしでコンパイルします。

--without-topology

トポロジ対応を無くしてコンパイルします。トポロジに必要なロジックは全てpostgis-3.4.0devライブラリ内に作られるので、関連ライブラリはありません。

--with-gettext=no

デフォルトでは、gettextの検出とこれを用いたコンパイルを試みますが、ローダ破損を引き起こす非互換性問題のもとで実行する場合には、このコマンドで無効にできます。これを使ったコンフィギュレーションによって解決する問題の例はhttp://trac.osgeo.org/postgis/ticket/748にあります。ご注意: これを切ることで多くの機能がなくなるわけではありません。まだ文書化されていなくて試験段階であるGUIローダにおける内部のヘルプ/ラベル機能に使われています。

--with-sfcgal=PATH

デフォルトでは、このスイッチなしではSFCGAL対応でインストールされません。PATHは、sfcgal-configへのパスを指定することができる追加的な引数です。

--without-phony-revision

Gitレポジトリの現在のHEADに一致するように、postgis_revision.hの更新を無効にします。

Note

PostGISをコードレポジトリから得る場合には、はじめに次のスクリプトを実行します。

./autogen.sh

このスクリプトによってconfigureスクリプトが生成されます。これはPostGISのインストールに関するカスタマイズに使われます。

PostGISをアーカイブファイルで入手する場合には、configureが既に生成されているので./autogen.shは不要です。

ビルド

Makefileが生成されたら、PostGISのビルドは、次のコマンドを実行するだけです。

make

出力の最後の行に"PostGIS was built successfully. Ready to install."と出れば終わりです。

PostGIS 1.4.0版からは、全ての関数に文書から生成されるコメントが付きます。これらのコメントを後からインストールするには、次のコマンドを実行しますが、docbookが必要です。アーカイブファイルからインストールする場合は、postgis_comments.sql, raster_comments.sql, topology_comments.sqlは、docフォルダにあるので、コメントを作成する必要はありません。コメントはCREATE EXTENSIONによるインストールの一部として取り込まれます。

make comments

PostGIS 2.0で導入されました。早見表にも、また学習中の方のハンドアウトにも適しているHTMLチートシートを生成します。xsltprocが必要で、topology_cheatsheet.html, tiger_geocoder_cheatsheet.html, raster_cheatsheet.html, postgis_cheatsheet.htmlの4ファイルが生成されます。

HTMLとPDFのビルド済みのものはPostGIS / PostgreSQL Study Guidesにあります。

make cheatsheets

PostGISエクステンションのビルドとデプロイ

PostgreSQL 9.1以上を使用している場合は、PostGISエクステンションが自動的にビルド、インストールされます。

ソースレポジトリからビルドしている場合は、関数の記述を最初にビルドする必要があります。これらは、docbookがインストールされている時にビルドされます。手動でインストールするには次のようにします。

make comments

アーカイブファイルからのビルドの場合は、ビルド済みのものがあるので、コメントのビルドは必須ではありません。

PostgreSQL 9.1を対象にビルドしている場合は、エクステンションは自動的にmake install処理の一部としてビルドするべきです。必要ならextensionsフォルダからビルドできますし、他のサーバで必要ならファイルの複製ができます。

cd extensions
cd postgis
make clean
make
export PGUSER=postgres # psql変数の上書き
make check #to test before install
make install
# extensionsのテスト
make check RUNTESTFLAGS=--extension

Note

make checkは、テスト実行のためにpsqlを使用し、psql環境変数を使用します。一般的なpsql環境変数で上書きすると便利なのが PGUSER,PGPORT, and PGHOSTです。環境変数を参照して下さい。

エクステンションファイルは、常に、OSに関係なく同じ版のPostGISでは同じです。PostGISバイナリを既にインストールしている限りは、エクステンションファイルをあるOSから別のものに複写して大丈夫です。

開発用と異なる別のサーバでエクステンションを手動でインストールしたい場合は、サーバにない時に必要となる通常のPostGISのバイナリだけでなく、次のファイルをextensionsフォルダからPostgreSQLインストール先のPostgreSQL / share / extensionフォルダに複写します。

指定されていない場合のインストールするエクステンションの版等の情報を示す制御ファイpostgis.control, postgis_topology.control。

エクステンションごとの/sqlフォルダにあるファイル全て。extensions/postgis/sql/*.sql, extensions/postgis_topology/sql/*.sqlはPostgreSQL share/extensionフォルダの最上位に複写する必要があることに注意して下さい。

以上を実行すると、PgAdmin -> extensionでpostgis, postgis_topologyが有効なエクステンションとして見えます。

psqlを使う場合は、次のクエリを実行してエクステンションがインストールされていることを確認できます。

SELECT name, default_version,installed_version
FROM pg_available_extensions WHERE name LIKE 'postgis%' or name LIKE 'address%';

             name             | default_version | installed_version
------------------------------+-----------------+-------------------
 address_standardizer         | 3.4.0dev         | 3.4.0dev
 address_standardizer_data_us | 3.4.0dev         | 3.4.0dev
 postgis                      | 3.4.0dev         | 3.4.0dev
 postgis_raster               | 3.4.0dev         | 3.4.0dev
 postgis_sfcgal               | 3.4.0dev         |
 postgis_tiger_geocoder       | 3.4.0dev         | 3.4.0dev
 postgis_topology             | 3.4.0dev         |
(6 rows)

クエリを行ったデータベースにエクステンションがインストールされている場合は、installed_versionカラムに記載が見えます。レコードが返ってこない場合は、PostGIS EXTENSIONがインストールされていないことになります。PgAdmin III 1.14以上では、データベースブラウザツリーのextensionsセクションで提供されていて、右クリックでアップグレードまたアンインストールできます。

有効なエクステンションがある場合、pgAdminエクステンションインタフェースまたは次のSQLの実行によって、選択したデータベースにPostGISエクステンションをインストールできます。

CREATE EXTENSION postgis;
CREATE EXTENSION postgis_raster;
CREATE EXTENSION postgis_sfcgal;
CREATE EXTENSION fuzzystrmatch; -- postgis_tiger_geocoderに必要
-- postgis_tiger_geocoderで使用されるか単独で使われます
CREATE EXTENSION address_standardizer;
CREATE EXTENSION address_standardizer_data_us;
CREATE EXTENSION postgis_tiger_geocoder;
CREATE EXTENSION postgis_topology;

psqlでは、どの版が、どのスキーマにインストールされているかを見ることができます。

\connect mygisdb
\x
\dx postgis*

List of installed extensions
-[ RECORD 1 ]-------------------------------------------------
Name        | postgis
Version     | 3.4.0dev
Schema      | public
Description | PostGIS geometry, geography, and raster spat..
-[ RECORD 2 ]-------------------------------------------------
Name        | postgis_raster
Version     | 3.0.0dev
Schema      | public
Description | PostGIS raster types and functions
-[ RECORD 3 ]-------------------------------------------------
Name        | postgis_tiger_geocoder
Version     | 3.4.0dev
Schema      | tiger
Description | PostGIS tiger geocoder and reverse geocoder
-[ RECORD 4 ]-------------------------------------------------
Name        | postgis_topology
Version     | 3.4.0dev
Schema      | topology
Description | PostGIS topology spatial types and functions

Warning

エクステンションのテーブルspatial_ref_sys, layer, topologyは、明示的にバックアップできません。それぞれのpostgisまたはpostgis_topologyエクステンションがバックアップされる時のみバックアップできます。これは、データベース全体のバックアップの時のみ行われます。PostGIS 2.0.1の時点では、データベースがバックアップされる際に、PostGISでパッケージ化されていないsridレコードのみバックアップされます。パッケージに入っているsridの変更は巡回せず、変更はそこにあるものと期待されます。PostGIS 2.0.1の時点では、データベースがバックアップされるときにPostGISに入っていないsridのレコードだけがバックアップされます。PostGISに入っていて後に変更されたsridの変更については巡回しません。問題が見られたら、チケットを発行して下さい。エクステンションテーブルの構造はCREATE EXTENSIONで生成されるので、バックアップを行いません。エクステンションの与えられた版と同じものであると仮定されます。この挙動は現在のPostgreSQL エクステンションモデルに組み込まれているため、これについては何もできません。

素晴らしいエクステンション機構を使わずに3.4.0devをインストールした場合には、それぞれのエクステンションが持つ関数をパッケージするためのコマンドを実行して、エクステンションに基づくように変更できます。PostgreSQL 13では、パッケージしない方法でのインストールは削除されましたので、PostgreSQL 13にアップグレードする前にエクステンションをビルドするように変更するべきです。

CREATE EXTENSION postgis FROM unpackaged;
CREATE EXTENSION postgis_raster FROM unpackaged;
CREATE EXTENSION postgis_topology FROM unpackaged;
CREATE EXTENSION postgis_tiger_geocoder FROM unpackaged;

テスト

PostGISのテストを行うには、次のコマンドを実行します。

make check

このコマンドで、実際のPostgreSQLデータベースに対して生成したライブラリを使用した、様々なチェックとレグレッションテストを行います。

Note

PostgreSQL, GEOS または Proj を標準の位置にインストールしていない場合には、環境変数LD_LIBRARY_PATHに、ライブラリの位置を追加する必要があるかも知れません。

Caution

現在のところmake checkは、チェックを行う際に 環境変数PATHとPGPORTによっています。コンフィギュレーションパラメータ--with-pgconfigを使って特定したPostgreSQLではありません。PATHを編集して、コンフィギュレーションの際に検出したPostgreSQLと一致するようにして下さい。もしくは、間もなく襲ってくる頭痛の準備をしておいて下さい。

成功したなら、make checkで約500個のテストを生成します。結果は次のようなかんじになります (かなりの行を省略しています)。

CUnit - A unit testing framework for C - Version 2.1-3
     http://cunit.sourceforge.net/

        .
        .
        .

Run Summary:    Type  Total    Ran Passed Failed Inactive
              suites     44     44    n/a      0        0
               tests    300    300    300      0        0
             asserts   4215   4215   4215      0      n/a
Elapsed time =    0.229 seconds

        .
        .
        .

Running tests

        .
        .
        .

Run tests: 134
Failed: 0

-- if you build with SFCGAL

        .
        .
        .

Running tests

        .
        .
        .

Run tests: 13
Failed: 0

-- if you built with raster support

        .
        .
        .

Run Summary:    Type  Total    Ran Passed Failed Inactive
              suites     12     12    n/a      0        0
               tests     65     65     65      0        0
             asserts  45896  45896  45896      0      n/a

        .
        .
        .

Running tests

        .
        .
        .

Run tests: 101
Failed: 0

-- topology regress

.
.
.

Running tests

        .
        .
        .

Run tests: 51
Failed: 0

-- if you built --with-gui, you should see this too

     CUnit - A unit testing framework for C - Version 2.1-2
     http://cunit.sourceforge.net/

        .
        .
        .

Run Summary:    Type  Total    Ran Passed Failed Inactive
              suites      2      2    n/a      0        0
               tests      4      4      4      0        0
             asserts      4      4      4      0      n/a

postgis_tiger_geocoderとaddress_standardizerエクステンションは、現在は、標準的なPostgreSQLインストールチェックにのみ対応しています。これらをテストするには、次のようにします。ご注意: PostGISコードフォルダのルートでmake installを既に行っている場合には、make installは重要ではありません。

address_standardizer用:

cd extensions/address_standardizer
make install
make installcheck

出力は次のようなかんじになります。

============== dropping database "contrib_regression" ==============
DROP DATABASE
============== creating database "contrib_regression" ==============
CREATE DATABASE
ALTER DATABASE
============== running regression test queries        ==============
test test-init-extensions     ... ok
test test-parseaddress        ... ok
test test-standardize_address_1 ... ok
test test-standardize_address_2 ... ok

=====================
 All 4 tests passed.
=====================

Tiger Geocodeを使う場合には、使用するPostgreSQLインスタンス内にPostGISとfuzzystrmatchのエクステンションが必要です。PostGISをaddress_standardizer機能付きでビルドした場合は、address_standardizerのテストも行います。

cd extensions/postgis_tiger_geocoder
make install
make installcheck

出力は次のようなかんじになります。

============== dropping database "contrib_regression" ==============
DROP DATABASE
============== creating database "contrib_regression" ==============
CREATE DATABASE
ALTER DATABASE
============== installing fuzzystrmatch               ==============
CREATE EXTENSION
============== installing postgis                     ==============
CREATE EXTENSION
============== installing postgis_tiger_geocoder      ==============
CREATE EXTENSION
============== installing address_standardizer        ==============
CREATE EXTENSION
============== running regression test queries        ==============
test test-normalize_address   ... ok
test test-pagc_normalize_address ... ok

=====================
All 2 tests passed.
=====================

インストール

PostGISをインストールするには、次のコマンドを実行します。

make install

これにより、PostGISのインストールファイルが、--prefixパラメータで指定した、適切なサブディレクトリに複写されます。次に特筆すべきサブディレクトリを示します。

ローダとダンパのバイナリのインストール先は[prefix]/binです。

postgis.sqlなどのSQLファイルのインストール先は[prefix]/share/contribです。

PostGISライブラリのインストール先は[prefix]/libです。

先にmake commentsを実行してpostgis_comments.sql, raster_comments.sqlを生成していた場合は、次のコマンドを実行すると、これらのSQLファイルがインストールされます。

make comments-install

Note

postgis_comments.sql, raster_comments.sql, topology_comments.sqlは、xsltprocの外部依存ができたので、通常のビルドとインストールから切り離されました。

PAGC住所標準化ツールのインストールと使用

address_standardizerエクステンションは、別途ダウンロードする必要がある別パッケージとしていました。PostGIS 2.2からは同梱されています。address_standardizeの追加情報、できること、および、コンフィギュレーション方法については、the section called “住所標準化”をご覧下さい。

標準化エクステンションは、Normalize_Addressの後継で、PostGISに入っているTigerジオコーダエクステンションに使うことができます。この場合の使い方についてはthe section called “TigerジオコーダをPostGISデータベースで有効にする: エクステンションを使用”を参照して下さい。また、ユーザ自身がつくるジオコーダの要素として使用したり、住所の比較を簡単にするために住所を標準化するために使うことができます。

住所標準化エクステンションはPCREに依存しています。PCREは多くのUNIX系システムにインストールされていますが、http://www.pcre.orgから最新版をダウンロードできます。the section called “コンフィギュレーション”の際にPCREを発見すると、住所標準化エクステンションが自動的にビルドされます。使用したいPCREのインストールが独自なものである場合は、configureに--with-pcredir=/path/to/pcreを渡します。/path/to/pcreは、PCREのincludeとlibのあるルートフォルダです。

Windowsでは、PostGIS 2.1以上に住所標準化エクステンションが同梱されているので、コンパイルを行わずに、すぐにCREATE EXTENSIONに行くことができます。

インストールしたら、対象データベースに接続して次のSQLが実行できます。

CREATE EXTENSION address_standardizer;

次のテストでは、rules, gaz, lexテーブルは必要ありません。

SELECT num, street, city, state, zip
 FROM parse_address('1 Devonshire Place PH301, Boston, MA 02109');

出力は次のようになります。

num |         street         |  city  | state |  zip
-----+------------------------+--------+-------+-------
 1   | Devonshire Place PH301 | Boston | MA    | 02109

Tigerジオコーダのインストールとアップグレードとデータロード

Tigerジオコーダのような拡張機能はPostGISディストリビューションに同梱されていません。Tigerジオコーダエクステンションが無かったり、インストールしているものより新しい版のものが欲しい場合には、Windows Unreleased VersionsでPostgreSQLの版に合ったパッケージにあるshare/extension/postgis_tiger_geocoder.*ファイルを使います。これらのパッケージはWindows用ですが、postgis_tige_geocoderエクステンションファイルは、SQLとPL/pgSQLだけですので、他のOSでも動作します。

TigerジオコーダをPostGISデータベースで有効にする

ここの説明では、お手持ちのPostgreSQLにpostgis_tiger_geocoderエクステンションがインストールされていると仮定します。

psql、pgAdminまたは他のツールでデータベースに接続して、次のSQLコマンドを実行します。既にPostGISを持っているデータベースにインストールする場合は、一つ目の手順は不要です。fuzzystrmatchエクステンションが既にインストールされている場合は、二つ目の手順は不要です。

CREATE EXTENSION postgis;
CREATE EXTENSION fuzzystrmatch;
CREATE EXTENSION postgis_tiger_geocoder;
-- 規則を基にした住所標準化 (pagc_normalize_address)を使いたい場合の任意実行
CREATE EXTENSION address_standardizer;

既にpostgis_tiger_geocoderエクステンションをインストールしていて、最新版に更新するだけの場合には、次を実行します。

ALTER EXTENSION postgis UPDATE;
ALTER EXTENSION postgis_tiger_geocoder UPDATE;

独自のエントリを生成した場合や、tiger.loader_platformとtiger.loader_variablesに変更を加えた場合には、これらをアップデートしなければならないことがあります。

正しくインストールされたかを確認するために、インストール対象データベース内で次のSQLを実行します。

SELECT na.address, na.streetname,na.streettypeabbrev, na.zip
        FROM normalize_address('1 Devonshire Place, Boston, MA 02109') AS na;

出力は次のようになります。

address | streetname | streettypeabbrev |  zip
---------+------------+------------------+-------
           1 | Devonshire | Pl               | 02109

tiger.loader_platformテーブルの、実行ファイルやサーバのパスを持つ新しいレコードを生成します。

shコンベンションのあとにdebbieというプロファイルを生成する例として、次のコマンドを実行します。

INSERT INTO tiger.loader_platform(os, declare_sect, pgbin, wget, unzip_command, psql, path_sep,
                   loader, environ_set_command, county_process_command)
SELECT 'debbie', declare_sect, pgbin, wget, unzip_command, psql, path_sep,
           loader, environ_set_command, county_process_command
  FROM tiger.loader_platform
  WHERE os = 'sh';

それから、declare_sectカラム内のパスを編集して、Debbieのpg, unzip, shp2pgsql, psql他のパス位置に適応するようにします。

loader_platformテーブルを編集しない場合は、一般的なアイテムの位置を持っているので、スクリプトが生成された後で、スクリプトを編集しなければなりません。

PostGIS 2.4.1からは、ZTCA5 (Zip Code 5 digit Tabulation Area)のロード手順が変更され、有効になった時にLoader_Generate_Nation_Scriptの一部として現在のZCTA5データをロードするようになりました。デフォルトでは切られています。ロードにかなりの時間 (20から60分)が取られ、かなりのディスクスペースを占有するのに、そんなに頻繁には使わないためです。

有効にするには、次のようにします。

UPDATE tiger.loader_lookuptables SET load = true WHERE table_name = 'zcta520';

境界のフィルタが追加され、ちょうど境界内のZIPに制限された場合に、Geocode関数は、ZCTA5が存在するなら使います。Reverse_Geocode関数は、返された住所にZIPコードが無い場合に (しばしば高速道路での逆ジオコーディングで発生します)、これを使います。

サーバまたはローカル (サーバへのネットワーク接続が早い場合)のルートにgisdataというフォルダを作成します。このフォルダはTigerファイルがダウンロードされ、処理される場所です。サーバのルートにフォルダを作ると不幸になる場合や、単に他のフォルダに移したい場合には、tiger.loader_variablesテーブルのstaging_foldフィールドを編集します。

gisdataフォルダ内にtempというフォルダを作成します。もしくは、staging_foldで示されたフォルダを作成します。ローダがダウンロードしたTigerデータを展開する場所です。

そして、SQL関数Loader_Generate_Nation_Scriptを実行して、独自のプロファイルの名前を使うか確認し、.shまたは.batファイルにスクリプトを複写します。たとえば、新しいプロファイルで国のロードを行う場合には、次のようにします。

psql -c "SELECT Loader_Generate_Nation_Script('debbie')" -d geocoder -tA
> /gisdata/nation_script_load.sh

生成された国データをロードするコマンドラインスクリプトを実行します。

cd /gisdata
sh nation_script_load.sh

国スクリプトを実行した後、tiger_dataスキーマに三つのテーブルが作られ、データが格納されています。次のクエリをpsqlかpgAdminから実行して、確認します。

SELECT count(*) FROM tiger_data.county_all;

count
-------
  3235
(1 row)

SELECT count(*) FROM tiger_data.state_all;

count
-------
    56
(1 row)

デフォルトではbg, tract, tabblock20に対応するテーブルはロードされません。ジオコーダはこれらのテーブルを使いませんが、一般に、人口統計に使います。州データのロードの一部としてロードするには、次の手続きを実行して有効にします。

UPDATE tiger.loader_lookuptables SET load = true WHERE load = false AND lookup_name IN('tract', 'bg', 'tabblock20');

もしくは、Loader_Generate_Census_Scriptを使って州のデータをロードした後に、これらのテーブルだけをロードできます。

データをロードしたい州ごとに、Loader_Generate_Scriptで州スクリプトを作ります。

Warning

国データのロードを完了する前に*州スクリプトを作ってはなりません*。州スクリプトは国スクリプトでロードされる国リストを利用するためです。

psql -c "SELECT Loader_Generate_Script(ARRAY['MA'], 'debbie')" -d geocoder -tA
> /gisdata/ma_load.sh

生成されたコマンドラインスクリプトを実行します。

cd /gisdata
sh ma_load.sh

全てのデータのロードが完了するか中断ポイントに達した後に、全てのtigerテーブルに対してanalyzeを実行して、(継承されたものも含めて)状態を更新するのは良いことです。

SELECT install_missing_indexes();
vacuum (analyze, verbose) tiger.addr;
vacuum (analyze, verbose) tiger.edges;
vacuum (analyze, verbose) tiger.faces;
vacuum (analyze, verbose) tiger.featnames;
vacuum (analyze, verbose) tiger.place;
vacuum (analyze, verbose) tiger.cousub;
vacuum (analyze, verbose) tiger.county;
vacuum (analyze, verbose) tiger.state;
vacuum (analyze, verbose) tiger.zip_lookup_base;
vacuum (analyze, verbose) tiger.zip_state;
vacuum (analyze, verbose) tiger.zip_state_loc;

TigerジオコーダをPostGISデータベースで有効にする: エクステンションを使用

皆さんが問題と思われるの多くのことのひとつに、ジオコーディング前の準備に住所を正規化する関数Normalize_Addressがあります。住所正規化は万全と言うにはほど遠く、パッチをあてようとすると膨大な資源を費やします。よって、より良い住所標準化エンジンを持つ他のプロジェクトに統合しました。この新しい住所標準化を使うには、the section called “PAGC住所標準化ツールのインストールと使用”で記述するようにエクステンションをコンパイルし、使用するデータベースにインストールします。

このエクステンションをpostgis_tiger_geocoderをインストールしているデータベースにインストールすると、Pagc_Normalize_Addressを、Normalize_Addressの代わりに使うことができます。このエクステンションはTigerジオコーダからは見えないので、国際的な住所といった他のデータソースでも使えます。Tigerジオコーダエクステンションは、その版の規則テーブル (tiger.pagc_rules), gaz table (tiger.pagc_gaz), lexテーブル (tiger.pagc_lex)を同梱しています。これらは、必要に応じて標準化の改善のために追加や更新ができます。

Tigerデータのロードに必要なツール

ロードプロセスによって、米センサスウェブサイトから個々の国ファイル、リクエストされた州のデータをダウンロードし、ファイルを展開し、個別の州をそれぞれの州テーブルの集合にロードします。各州のテーブルは、tigerスキーマで定義されたテーブルを継承しているので、これらのテーブルに対して全てのデータにアクセスするためのクエリを出すことができますし、州の再読み込みが必要となったり、州が必要ない場合には、Drop_State_Tables_Generate_Scriptで、いつでも州テーブルの集合を削除するクエリを出すことができます。

データのロードを可能にするためには次のツールが必要です。

センサスウェブサイトから取得するZIPファイルを展開するツール。

Unix系システムでは、unzip実行ファイルです。通常は、ほとんどのUnix系プラットフォームで既にインストールされています。

Windowsでは7-zipです。http://www.7-zip.org/からダウンロードできる無償の圧縮解凍ツールです。

shp2pgsqlコマンド。PostGISインストール時にデフォルトでインストールされます。

wgetコマンド。通常はほとんどのUnix/Linuxシステムにインストールされている、ウェブ取得ツールです。

Windows用については、コンパイル済みのバイナリをhttp://gnuwin32.sourceforge.net/packages/wget.htmから取得できます。

tiger_2010からアップグレードする場合には、最初にDrop_Nation_Tables_Generate_Scriptを生成、実行する必要があります。どの州データもロードする前に、Loader_Generate_Nation_Scriptで全国的なデータをロードする必要があります。これによりローダスクリプトが生成されます。(以前の年のTiger国勢調査データからの)アップグレードや新規インストールで行うLoader_Generate_Nation_Scriptの回数は1回です。

州データをロードするには、Loader_Generate_Scriptを参照して、手持ちのプラットフォームで動作する、求める州データをロードするデータロードスクリプトを生成します。州データはひとつずつダウンロードできることに注意して下さい。一度に必要な州の全てについてデータをロードする必要はありません。必要なだけダウンロードできます。

求める州データをロードした後は、Install_Missing_Indexesに示すように、

SELECT install_missing_indexes();

を実行するようにして下さい。

行うべきことができたかをテストするために、Geocodeを使用する州の中の住所についてジオコーダを実行してみます。

Tigerジオコーダとデータのアップグレード

まずpostgis_tiger_geocoderエクステンションを次のようにアップグレードします。

ALTER EXTENSION postgis_tiger_geocoder UPDATE;

次に、全ての国テーブルを削除し、新しい国テーブルをロードします。Drop_Nation_Tables_Generate_Scriptに詳細がある通り、このSQLステートメントを使った削除スクリプトを生成します。

SELECT drop_nation_tables_generate_script();

生成した削除SQLステートメントを実行します。

Loader_Generate_Nation_Scriptに詳細がある通り、このSELECTステートメントを使った削除スクリプトを生成します。

Windows向け

SELECT loader_generate_nation_script('windows');

Unix/Linux向け

SELECT loader_generate_nation_script('sh');

生成スクリプトの実行方法に関する説明は、the section called “TigerジオコーダをPostGISデータベースで有効にする”を参照して下さい。これは一度だけ実行する必要があります。

Note

州テーブルで複数年分が混ざっていてもよく、また州ごとに分割してアップグレードできます。一つの州をアップグレードする前に、Drop_State_Tables_Generate_Scriptを使って、以前の年の州テーブルを削除する必要があります。

共通の問題

インストールやアップグレードが思うようにいかない時にチェックすることがいくつかあります。

PostgreSQL 12以上をインストールしているか、実行中のPostgreSQLと同じ版のソースでコンパイルしているか、をチェックします。(Linuxの)ディストリビューションによって既にPostgreSQLがインストールされている時や、 PostgreSQLを以前にインストールして忘れた場合に、 混乱が発生することがあります。PostGISはPostgreSQL 12以上で動作します。古い版のものを使った場合には、おかしな予想外のエラーメッセージが表示されます。実行中のPostgreSQLの版をチェックするには、psqlを使ってデータベースを接続して、次のクエリを実行して下さい。

SELECT version();

RPMベースのディストリビューションを実行している場合、 プリインストールされたパッケージが存在するかのチェックは、rpm コマンドを使ってrpm -qa | grep postgresqlでチェックできます。

アップグレードに失敗する場合、既にPostGISがインストールされているデータベースにリストアしているか確認して下さい。

SELECT postgis_full_version();

また、コンフィギュアが正しくPostgreSQL、Proj4ライブラリ、GEOSライブラリのインストール先を検出したかチェックして下さい。

コンフィギュアからの出力でpostgis_config.hファイルが作られます。POSTGIS_PGSQL_VERSION、POSTGIS_PROJ_VERSIONおよびPOSTGIS_GEOS_VERSION変数が正しくセットされたかをチェックして下さい。

Chapter 3. PostGIS管理

パフォーマンスチューニング

PostGISの調整はPostgreSQLの作業量の調整と非常に似ています。ジオメトリとラスタは重く、メモリ関連の最適化は他のPostgreSQLクエリと比べて影響が大きい点だけは留意して下さい。

PostgreSQLの最適化に関する一般的な詳細は、 Tuning your PostgreSQL Serverをご覧ください。

PostgreSQL 9.4以上では、ALTER SYSTEMを使うことで、postgresql.confやpostgresql.auto.confを触ることなくサーバレベルで設定できます。

ALTER SYSTEM SET work_mem = '256MB';
-- 起動時設定でない設定を強制します。新規接続に影響を与えます。
SELECT pg_reload_conf();
-- 現在の設定値を表示
-- 全ての設定を見るにはSHOW ALLを使います
SHOW work_mem;

PostgreSQLの設定に加えて、PostGISには the section called “Grand Unified Custom変数 (GUC)”で挙げる独自設定があります。

起動時

次に示す設定はpostgresql.confにあります。

constraint_exclusion

デフォルト: partition

一般的にテーブルのパーティショニングに使われます。デフォルトとして"partition"に設定されています。継承階層内にあり、プランナにペナルティ以外を払わないなら、クエリプランナにテーブルの制約条件の解析だけを行わせるので、PostgreSQL 8.4以上ではこれが理想的です。

shared_buffers

デフォルト: PostgreSQL 9.6では128MB以下

利用可能なRAMの25%から40%を設定します。Windowsでは高く設定することができないかも知れません。

max_worker_processes これは、PostgreSQL 9.4以上で有効です。PostgreSQL 9.6以上では、パラレルクエリ処理に使うプロセス数の最大値の制御で、さらに重要なものとなっています。

デフォルト: 8

システムが対応できるバックグラウンドプロセスの最大値を設定します。このパラメータはサーバ起動時のみ設定できます。

実行時

work_mem - 並べ替えや複雑なクエリに使われるメモリのサイズの設定

デフォルト: 1-4MB

大きなデータベースの場合や、複雑なクエリの場合、RAMが多い場合は値を大きくするように調整します。

同時接続ユーザ数が多い場合や、RAMが少ない場合には値を小さくするように調整します。

たくさんのRAMを持ち、少数の開発者しかいない場合は次のようにします。

SET work_mem TO '256MB';

maintenance_work_mem - VACUUM, CREATE INDEX等で使われるメモリのサイズ

デフォルト: 16-64MB

一般的には低すぎます - メモリスワップの間、入出力が拘束され、オブジェクトがロックされます。

たくさんのRAMを持つ本番サーバでは32MBから1GBが推奨ですが、同時接続ユーザ数に依存します。たくさんのRAMを持ち、少数の開発者しかいない場合は次のようにします。

SET maintenance_work_mem TO '1GB';

max_parallel_workers_per_gather

この設定はPostgreSQL 9.6以上で使用でき、並列クエリに対応しているPostGIS 2.3以上に影響は限られます。0より大きい値に設定すると、ST_Intersectsといった関係関数を含むクエリで、複数プロセッサが使われるようにできます。その時、2倍を超える速度が出る可能性があります。予備のプロセッサが多数ある場合には、この値をプロセッサ数に変更するべきです。また、max_worker_processesをこの値と同じにするようにします。

デフォルト: 0

単一のGatherノードが開始できるワーカの最大数を設定します。並列ワーカは、max_worker_processesで確立されたプロセスのプールから取得されます。要求したワーカ数は、実際には実行可能になっていない場合があることに注意して下さい。これが発生する場合には、想定より少ないワーカでプランが実行され、非効率になります。これの値を0 (デフォルト値)にすると、パラレルクエリ実行が無効になります。

ラスタ機能の設定

ラスタ機能を有効にしたら、下に示す確実な設定方法を読んだ方がいいです。

PostGIS 2.1.3以降では、データベース外ラスタと全てのラスタドライバは、デフォルトでは無効になっています。これらを有効にするには、サーバ上で、環境変数 POSTGIS_GDAL_ENABLED_DRIVERSとPOSTGIS_ENABLE_OUTDB_RASTERSを設定します。PostGIS 2.2では、the section called “Grand Unified Custom変数 (GUC)”に従って設定する、クロスプラットフォームな手法があります。

データベース外ラスタを有効にするには次のようにします。

POSTGIS_ENABLE_OUTDB_RASTERS=1

他の値を入れたり、値を入れない場合には、データベース外ラスタは無効になります。

インストールしたGDALのドライバを有効にするには、次の環境変数を設定します。

POSTGIS_GDAL_ENABLED_DRIVERS=ENABLE_ALL

一部のドライバのみ有効にしたい場合には、環境変数を次のように設定します。

POSTGIS_GDAL_ENABLED_DRIVERS="GTiff PNG JPEG GIF XYZ"

Note

Windows上の場合は、ドライバリストに引用符をつけないで下さい。

環境変数の設定はOSによって異なります。UbuntuまたはDebian上でapt-postgresqlを経由したPostgreSQLのインストールについては、/etc/postgresql/10/main/environmentを編集するのが好ましい方法です。 ここで、10はPostgreSQLのバージョンを指し、mainはクラスタを指します。

Windowsでサービスとして実行している場合には、システム変数で設定します。Windows 7では、コンピュータを右クリックしてプロパティをクリックするか、エクスプローラの検索バーにコントロール パネル\すべてのコントロール パネル項目\システムを指定します。 システムの詳細設定 -> 詳細設定 -> 環境変数 を順にクリックして、新しいシステム環境変数を追加します。

環境変数を設定した後は、設定を反映させるために、PostgreSQLサービスの再起動が必要です。

空間データベースの作成

エクステンションを使って空間データベースを有効にする

PostgreSQL 9.1以上を使っていて、エクステンションのPostGISモジュールをコンパイル、インストールしている場合には、エクステンションというメカニズムを使用して、データベースを空間データベースに切り替えることができます。

中核となるPostGISエクステンションには、ジオメトリ、ジオグラフィ、spatial_ref_sysおよび全ての関数とコメントが含まれています。ラスタとトポロジは別のエクステンションになっています。

空間データベースにしたいデータベース上で次のSQLを実行します。

CREATE EXTENSION IF NOT EXISTS plpgsql;
      CREATE EXTENSION postgis;
      CREATE EXTENSION postgis_raster; -- OPTIONAL
      CREATE EXTENSION postgis_topology; -- OPTIONAL

エクステンションを使わずに空間データベースを有効にする (お勧めできません)

Note

これは、通常はPostgreSQLのエクステンションのディレクトリ内にPostGISをインストールできないか、したくない場合 (たとえばテスト中や開発中、または制限のある環境内)にのみ必要となります。

ビルドの際に指定した[prefix]/share/contrib内にある様々なSQLファイルをロードしてPostGISオブジェクトと関数の定義をデータベースに追加します。

中核のPostGISオブジェクト (ジオメトリ型とジオグラフィ型、これらに対応する関数)はpostgis.sqlスクリプトにあります。ラスタオブジェクトはrtpostgis.sqlスクリプトにあります。トポロジオブジェクトはtopology.sqlスクリプトにあります。

完全なEPSG座標系定義IDセットについては、spatial_ref_sys.sql定義ファイルをロードしてspatial_ref_sysテーブルを生成して下さい。これによりジオメトリ関数ST_Transform()が実行できるようになります。

PostGIS関数にコメントを追加したい場合には、postgis_comments.sqlスクリプト内のコメントが見つかると思います。コメントはpsqlのターミナルウィンドウから単に\dd [関数名]と打ち込むだけで見ることができます。

ターミナルで次のシェルコマンドを実行します。

DB=[データベース名]
    SCRIPTSDIR=`pg_config --sharedir`/contrib/postgis-3.1/

    # 中核
    psql -d ${DB} -f ${SCRIPTSDIR}/postgis.sql
    psql -d ${DB} -f ${SCRIPTSDIR}/spatial_ref_sys.sql
    psql -d ${DB} -f ${SCRIPTSDIR}/postgis_comments.sql # 任意

    # ラスタ機能 (任意)
    psql -d ${DB} -f ${SCRIPTSDIR}/rtpostgis.sql
    psql -d ${DB} -f ${SCRIPTSDIR}/raster_comments.sql # 任意

    # トポロジ機能 (任意)
    psql -d ${DB} -f ${SCRIPTSDIR}/topology.sql
    psql -d ${DB} -f ${SCRIPTSDIR}/topology_comments.sql # 任意

空間データベースのアップグレード

既存の空間データベースのアップグレードは、新しいPostGISオブジェクト定義の置き換えや導入を必要とするとき、慎重を要することがあります。

不幸なことに、定義の全てが実行中のデータベース内で簡単には置き換えられるわけではないので、ダンプ/リロードが最善策となることがあります。

PostGISには、マイナーバージョンアップやバグフィクスリリースの場合に使うソフトアップグレードと、メジャーアップグレードで使うハードアップグレードが用意されています。

PostGISをアップグレードしようとする前にデータのバックアップを取ることは、常に価値のあるものです。pg_dumpで -Fc フラグを使うと、ハードアップグレードによってダンプを常にリストアすることができます。

ソフトアップグレード

エクステンションを使ってデータベースをインストールした場合には、エクステンションモデルでアップグレードしなければなりません。 古いSQLスクリプトを使ってインストールした場合には、SQLスクリプトは既にサポートされていませんので、エクステンションに切り替えるべきです。

9.1以上でエクステンションを使ったソフトアップグレード

エクステンションを使ってPostGISをインストールした場合には、エクステンションを使ってアップグレードする必要があります。エクステンションを使ったマイナーアップグレードはかなり楽です。

PostGIS 3以上を実行している場合には、PostGIS_Extensions_Upgrade関数を使ってインストールしているもののうち最新の版にアップグレードすべきです。

SELECT postgis_extensions_upgrade();

PostGIS 2.5以前を実行している場合には、次のようにします。

ALTER EXTENSION postgis UPDATE;
SELECT postgis_extensions_upgrade();
-- 二回目の実行はpostgis_rasterエクステンションの再構築に必要です。
SELECT postgis_extensions_upgrade();

インストールされたPostGISに複数のバージョンがあり、最新版にアップグレードしたくない場合には、明示的なバージョンの指定ができます。次のようにします。

ALTER EXTENSION postgis UPDATE TO "3.4.0dev";
ALTER EXTENSION postgis_topology UPDATE TO "3.4.0dev";

次のようなエラー通知が表示されることがあります。

No migration path defined for … to 3.4.0dev

この場合は、データベースをバックアップして、 the section called “エクステンションを使って空間データベースを有効にする” に記述されているように新しいデータベースを生成し、バックアップを新しいデータベースにリストアしなければなりません。

次のようなメッセージを得ることがあります。

Version "3.4.0dev" of extension "postgis" is already installed

この場合は、全てアップデートされていて、安全に無視できます。SVN版から次版 (新しい版番号を得ていないもの)にアップグレードしようとしない限り、"next"を版文字列に追加できます。ただし、次回に"next"を削除する必要があります。

ALTER EXTENSION postgis UPDATE TO "3.4.0devnext";
ALTER EXTENSION postgis_topology UPDATE TO "3.4.0devnext";

Note

PostGISをバージョン指定なしにインストールした場合には、 しばしば再格納の前のPostGIS EXTENSIONの再インストールをとばすことができます。 バックアップはCREATE EXTENSION postgisだけで、リストアの間に最新版になります。

Note

PostGISエクステンションを3.0.0より前からアップグレードする場合には、ラスタ機能が不要なら、安全に削除できる新しい postgis_rasterエクステンションを持つことになります。次のようにします。

DROP EXTENSION postgis_raster;

9.1より前またはエクステンションを使わないソフトアップグレード

PostGISをエクステンションを使わずにインストールした人向けです。エクステンションを使っていてこの方法を使うと、次のようなメッセージが現れます。

can't drop ... because postgis extension depends on it

ご注意: PostGIS 1.*またはr7429以前のPostGIS 2.*へ移行する場合には、この手続きを使うことができませんが、ハードアップグレードを実行する必要があります。

コンパイルとインストール (make install)の実行後に、インストール先フォルダ内にある*_upgrade.sqlのファイルの集合を見つけておくべきです。次のコマンドで一覧を得られます。

ls `pg_config --sharedir`/contrib/postgis-3.4.0dev/*_upgrade.sql

postgis_upgrade.sqlから順番に全てをロードします。

psql -f postgis_upgrade.sql -d [データベース名]

同じ手続きをラスタ、トポロジ、SFCGALエクステンションに適用します。それぞれのファイル名はrtpostgis_upgrade.sql, topology_upgrade.sql, sfcgal_upgrade.sqlになります。次のように実行します。

psql -f rtpostgis_upgrade.sql -d [データベース名]

psql -f topology_upgrade.sql -d [データベース名]

psql -f sfcgal_upgrade.sql -d [データベース名]

エクステンションによるインストールに変更した方が良いです。次のようにします。

psql -c "SELECT postgis_extensions_upgrade();"

Note

求める版へのアップグレードに使う特定のpostgis_upgrade.sqlが発見できない場合には、ソフトアップグレードを実行するにはあまりに前の版を使っています。ハードアップグレードが必要です。

PostGIS_Full_Version関数の"procs need upgrade"というメッセージで、この種のアップグレードを実行する必要性についての情報が得られます。

ハードアップグレード

ハードアップグレードとは、PostGISで利用可能なデータの完全なダンプ/リロードを意味します。PostGISオブジェクトの内部格納状態が変更される場合や、ソフトアップグレードができない場合に、ハードアップグレードが必要です。付録のリリースノートに、版ごとについて、ダンプ/リロード (ハードアップグレード)の要否を記載しています。

ダンプ/リロード作業はpostgis_restore.plスクリプトが補助します。このスクリプトは、PostGIS (古いものを含む)に属する定義を全て飛ばすように注意します。また、重複シンボルエラーや非推奨オブジェクトを持越すことなく、スキーマとデータをPostGISをインストールしたデータベースにリストアできます 。

Windows用に関する追加情報は Windows Hard upgradeにあります。

手続きは次の通りです。

アップグレードしたデータベース (olddbと呼ぶことにしましょう)の「カスタム書式」のダンプを、バイナリBLOBデータを含めたダンプを指定して (-b)、verboseモード (-v)で生成します。ユーザはデータベースのオーナーになることができ、PostgreSQLのスーパーユーザである必要はありません。

pg_dump -h localhost -p 5432 -U postgres -Fc -b -v -f "/somepath/olddb.backup" olddb

新しいデータベースにPostGISを、PostGISが無い状態からインストールします。このデータベースをnewdbと呼ぶことにします。この作業に関する説明についてはthe section called “エクステンションを使わずに空間データベースを有効にする (お勧めできません)”とthe section called “エクステンションを使って空間データベースを有効にする”とを参照して下さい。

ダンプにあるspatial_ref_sysは、リストアされますが、既にあるspatial_ref_sysを上書きしません。リストア対象のデータベースに公式データセットの訂正が確実に伝わるようにするためです。標準のエントリを上書きしたい場合は、newdbを生成する際にspaltial_ref_sys.sqlファイルをロードしないだけです。

データベースが本当に古く、ビューや関数に、長く非推奨になっている関数があるような場合には、関数やビューを使えるようにするlegacy.sqlをロードする必要があるでしょう。ただし、本当に必要な場合に限ります。可能なら、ビューや関数をダンプせずにアップグレードすることを検討して下さい。非推奨関数は、uninstall_legacy.sqlで後から削除することができます。

バックアップを新しいnewdbデータベースにリストアするには、postgis_restore.plを使います。psqlが予期せぬエラーを標準エラー出力に出すことがあります。これらのログを保存しておいて下さい。

perl utils/postgis_restore.pl "/somepath/olddb.backup" | psql -h localhost -p 5432 -U postgres newdb 2
> errors.txt

エラーは次の場合に起こりえます。

ビューまたは関数の中に非推奨のPostGISオブジェクトを使っているものがある場合。これの訂正には、リストア前にlegacy.sqlスクリプトのロードを試してみることができます。非推奨オブジェクトをまだ持っている版のPostGISにリストアして、コードを作り替えた後に再び移動させることもできます。legacy.sqlを利用する場合は、非推奨関数を使うのをやめたコードに訂正して、uninstall_legacy.sqlをロードするのを忘れないでください。

ダンプファイル内のspatial_ref_sysにあるカスタムレコードが不正なSRIDになっていることがあります。妥当なSRID値は0より大きく999000より小さくなります。999000から999999の間は内部利用のための予約領域ですが、999999より大きい値は一切使用できません。全ての不正なSRIDを持つ独自レコードは、予約領域に移動しても保持されます。しかし、spatial_ref_sysテーブルから、値が保持されるように設定されているチェック制約が外れます。場合によっては (複数の不正なSRIDが同じ予約領域のSRID値に変換されるとき)、主キーも外れます。

これを修正するために、独自のSRSを妥当な値 (910000..910999の範囲)のSRIDに複写し、全てのテーブルを新しいSRIDに変更 (UpdateGeometrySRID参照)し、spatial_ref_sysから不正なエントリを削除します。そして、次のようにチェック制約を再構築します。

ALTER TABLE spatial_ref_sys ADD CONSTRAINT spatial_ref_sys_srid_check check (srid > 0 AND srid < 999000 );

ALTER TABLE spatial_ref_sys ADD PRIMARY KEY(srid));

フランス IGN 地図を含む古いデータベースをアップグレードする場合には、おそらくSRIDが範囲外になり、データベースのインポート時に次のような問題に遭遇します。

 WARNING: SRID 310642222 converted to 999175 (in reserved zone)

この場合には、次のステップを試すことができます。最初にpostgis_restore.plから出たIGNをSQLから完全に破棄します。そのために次のコマンドを実行します。

perl utils/postgis_restore.pl "/somepath/olddb.backup"
> olddb.sql

さらに、次のコマンドを実行します。

grep -v IGNF olddb.sql
> olddb-without-IGN.sql

その後、新しいデータベースを生成し、必要なPostGISエクステンションを有効化して、 このスクリプト で確実にフランスIGNの系を挿入します。これらの処理の後、次のようにデータのインポートを行います。

psql -h localhost -p 5432 -U postgres -d newdb -f olddb-without-IGN.sql  2
> errors.txt

Chapter 4. データ管理

空間データ モデル

OGC ジオメトリ

Open Geospatial Consortium (OGC)は、地理空間データのモデルを提供するためにSimple Features Access (SFA)標準を開発しました。これは、ジオメトリ (Geometry)の基本的な空間タイプを、空間解析処理実行のための操作や変換といった演算に沿って定義します。PostGISは空間解析タスクを実現するためにOGCジオメトリモデル値をPostgreSQLデータ型のgeometry、geographyとして実装しています。

ジオメトリは抽象的なタイプです。ジオメトリ値は複数ある具体的なサブタイプの一つに属します。サブタイプは様々な種類の様々な次元のジオメトリの形状を表現するものです。これらには原子的なタイプであるポイント (Point)、ラインストリング (LineString)、リニアリング (LinearRing)、ポリゴン (Polygon)があります。また、コレクション (collection) (訳注: 「マルチ系」と書いている場合があります)タイプのマルチポイント (MultiPoint)、マルチラインストリング (MultiLineString)、マルチポリゴン (MultiPolygon)、ジオメトリコレクション (GeometryCollection)があります。 Simple Features Access - Part 1: Common architecture v1.2.1では多面体サーフェス (PolyhedralSurface)、三角形 (Triangle)、TINが追加されています。

ジオメトリは2次元デカルト平面上の形状をモデル化しています。多面体サーフェス、三角形、TINは3次元空間内の形状を表現することもできます。形状のサイズと位置は座標によって指定されます。それぞれの座標は、平面上で位置を判定するXとYの座標軸値を持っています。形状はポイントと線分から構築され、ポイントは単一の座標で定められ、線分は二つの座標値から定められます。

座標は任意軸ZとMを持つことができます。Z軸はしばしば標高を示すために使われます。M軸は計測値が入りますが、計測値は時間であったり距離であったりします。Z値またはM値はジオメトリ値の中にあり、ジオメトリの各ポイントで定義されているものです。ジオメトリがZ値またはM値を持っている場合には座標次元は三次元です。Z値とM値の両方を持っている場合には四次元です。

ジオメトリ値は、そのジオメトリが組み込まれている座標系を示す空間参照系に関連付けられます。空間参照系はジオメトリのSRID番号で識別されます。X軸とY軸の単位は空間参照系によって決まります。平面参照系では伝統的にX座標値とY座標値が東、北をそれぞれ示します。地理参照系では、経度と緯度を表現しています。SRIDが0の場合には、軸の単位が無い、無限の直交平面を表します。the section called “空間参照系”を参照して下さい。

ジオメトリの次元は、ジオメトリタイプのプロパティです。ポイントタイプは0次元、ラインタイプは1次元、ポリゴンタイプは2次元、コレクションは要素の次元の最大値、となります。

ジオメトリ値はemptyになることがあります。空値とは、非マルチ系ジオメトリの場合は頂点を持っていないという意味で、コレクションでは要素を持っていないという意味です。

ジオメトリ値の重要なプロパティは範囲 (extent)またはバウンディングボックス (bounding box)です。OGCモデルではエンベロープ (envelope)と呼ばれています。これは、ジオメトリの座標を囲む2次元または3次元のボックスです。ジオメトリの座標空間内の範囲を表現するための、また、二つのジオメトリの相互関係をチェックするための、効率の良い方法です。

ジオメトリモデルでは、the section called “Dimensionally Extended 9-Intersection Model”に示されている通り、トポロジ空間関係を評価することができます。これに対応するために、内部 (interior)、境界 (boundary)、外部 (exterior)の概念が、ジオメトリタイプ毎に定義されます。ジオメトリはトポロジ的に閉じていて、常に境界を持っています。境界の次元はジオメトリの次元より1小さくなります。

OGCジオメトリモデルは、ジオメトリタイプ毎に妥当性規則が定義されています。これらの規則によって、ジオメトリ値が現実的な状況を示すようになります (たとえば、外部に穴を持つポリゴンを指定できますが、ジオメトリ的に無意味であり、よって不正とします)。PostGISは不正なジオメトリ値を格納、操作することができます。これによって、必要なら修正できることになります。the section called “ジオメトリ検証”を参照して下さい。

ポイント (Point)

ポイントは、座標空間内の一つの位置を表現する0次元ジオメトリです。

POINT (1 2)
POINT Z (1 2 3)
POINT ZM (1 2 3 4)

ラインストリング (LineString)

ラインストリングは連続する一連の線分で形成される1次元のラインです。線分はそれぞれ2点で定義付けられ、ある線分の終点は次の線分の始点を形成します。OGC妥当なラインストリングには、0または2以上のポイントがあります。ただしPostGISはラインストリングの一つのポイントを許容します。ラインストリングは、自身とクロスする場合があります (自己交差)。始端と終端とが同じ場合にはラインストリングは閉じたことになります。自己交差しない場合には、ラインストリングは単純です。

LINESTRING (1 2, 3 4, 5 6)

リニアリング (LinearRing)

リニアリングは閉じていて、かつ単純なラインスリングです。始端と終端は同じでなければなりませんし、ラインは自己交差してはなりません。

LINEARRING (0 0 0, 4 0 0, 4 4 0, 0 4 0, 0 0 0)

ポリゴン (Polygon)

ポリゴンは2次元平面領域です。一つの外側の境界 (殻)と0個以上の内の境界 (穴)とで区切られています。それぞれの境界はリニアリングです。

POLYGON ((0 0 0,4 0 0,4 4 0,0 4 0,0 0 0),(1 1 0,2 1 0,2 2 0,1 2 0,1 1 0))

マルチポイント (MultiPoint)

マルチポイントはポイントのコレクションです。

MULTIPOINT ( (0 0), (1 2) )

マルチラインストリング (MultiLineString)

マルチラインストリングはラインストリングのコレクションです。各要素が閉じている場合には、そのマルチラインストリングは閉じています。

MULTILINESTRING ( (0 0,1 1,1 2), (2 3,3 2,5 4) )

マルチポリゴン (MultiPolygon)

マルチポリゴンは相互にオーバラップも隣接もしていないポリゴンのコレクションです。コレクション内のポリゴンの接触は有限数のポイントでのみ可能です。

MULTIPOLYGON (((1 5, 5 5, 5 1, 1 1, 1 5)), ((6 5, 9 1, 6 1, 6 5)))

ジオメトリコレクション (GeometryCollection)

ジオメトリコレクションは、ジオメトリの異種 (混合)のコレクションです。

GEOMETRYCOLLECTION ( POINT(2 3), LINESTRING(2 3, 3 4))

多面体サーフェス (PolyhedralSurface)

多角形はサーフェスは、パッチまたはエッジを共有する面の隣接するコレクションです。それぞれのパッチは平面ポリゴンです。ポリゴンがZ値を持つ場合には、サーフェスは3次元になります。

POLYHEDRALSURFACE Z (
  ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
  ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)),
  ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
  ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
  ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)),
  ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )

三角形 (Triangle)

三角形は三つの異なる非共線頂点で定義されるポリゴンです。三角形はポリゴンですので、四つの座標で指定され、一つ目と四つ目は同じです。

TRIANGLE ((0 0, 0 9, 9 0, 0 0))

TIN

TINはTriangulated Irregular Networkを表現する、オーバラップしない三角形のコレクションです。

TIN Z ( ((0 0 0, 0 0 1, 0 1 0, 0 0 0)), ((0 0 0, 0 1 0, 1 1 0, 0 0 0)) )

SQL/MM Part 3 - 曲線

ISO/IEC 13249-3 SQL Multimedia - Spatial標準 (SQL/MM) は、OGC SFAを拡張して、曲線ジオメトリを含むサブタイプを定義しています。SQL/MMタイプはXYM, XYZ, XYZMに対応します。

Note

SQL-MM実装での全ての浮動小数点数の比較では、所定の丸め誤差があります。現在は1E-8です。

曲線ストリング (CircularStringCircularString)

曲線ストリングは、基本的な曲線タイプです。線形の世界のラインストリングに似ています。単一の円弧線分は、始点、終点 (1番目と3番目)、弧の他の点の三つの点で定義されます。閉じた円を指定するには、開始点と終了点を同じにし、中間点を対称点 (円弧の中心)に置きます。連続する円弧では、前の円弧の終端と次の円弧の始端とが同じです。よって曲線ストリングは1以上の奇数個のポイントを持つことになります。

CIRCULARSTRING(0 0, 1 1, 1 0)

CIRCULARSTRING(0 0, 4 0, 4 4, 0 4, 0 0)

複合曲線 (CompoundCurve)

複合曲線は、曲線区間と直線区間の両方を含むことができる単一の連続した曲線です。このことは、整形された要素を持つことに加えて、全ての要素の最後のポイントは次の要素の最初のポイントでなければならないことを意味します。

COMPOUNDCURVE( CIRCULARSTRING(0 0, 1 1, 1 0),(1 0, 0 1))

曲線ポリゴン (CurvePolygon)

曲線ポリゴンは、外側の輪がひとつで0以上の内側のリングがある点はポリゴンに似ています。違いは、ポリゴンのリングはラインストリングですが曲線ポリゴンのリングは曲線ストリングまたは複合ストリングである点です。

PostGIS 1.4から、PostGISで曲線ポリゴンで複合曲線をサポートするようになりました。

CURVEPOLYGON(
  CIRCULARSTRING(0 0, 4 0, 4 4, 0 4, 0 0),
  (1 1, 3 3, 3 1, 1 1) )

例: CIRCULARSTRINGとLINESTRINGからなるCOMPOUNDCURVEで定義される外殻を持ち、CIRCULARSTRINGで定義される穴を持つCURVEPOLYGON

CURVEPOLYGON(
  COMPOUNDCURVE( CIRCULARSTRING(0 0,2 0, 2 1, 2 3, 4 3),
                 (4 3, 4 5, 1 4, 0 0)),
  CIRCULARSTRING(1.7 1, 1.4 0.4, 1.6 0.4, 1.6 0.5, 1.7 1) )

マルチ曲線 (Multicurve)

マルチ曲線は曲線のコレクションで、ラインストリング、曲線ストリング、複合曲線を含むことができます。

MULTICURVE( (0 0, 5 5), CIRCULARSTRING(4 0, 4 4, 8 4))

マルチサーフェス (MultiSurface)

マルチサーフェスはサーフェスのコレクションです。サーフェスは(線形)ポリゴンまたは曲線ポリゴンとなることができます。

MULTISURFACE(
  CURVEPOLYGON(
    CIRCULARSTRING( 0 0, 4 0, 4 4, 0 4, 0 0),
    (1 1, 3 3, 3 1, 1 1)),
  ((10 10, 14 12, 11 10, 10 10), (11 11, 11.5 11, 11 11.5, 11 11)))

WKTとWKB

OGC SFA仕様では、ジオメトリ値を外部で使用するための表現として二つの標準書式が定義されています。Well-Known Text (WKT)とWell-Known Binary (WKB)です。WKTとWKBは両方ともそのオブジェクトを定義するタイプと座標に関する情報を含んでいます。

Well-Known Text (WKT)で空間データの標準的な文字表現が可能です。空間オブジェクトのWKT表現の例を次に挙げます。

POINT(0 0)

POINT Z (0 0 0)

POINT ZM (0 0 0 0)

POINT EMPTY

LINESTRING(0 0,1 1,1 2)

LINESTRING EMPTY

POLYGON((0 0,4 0,4 4,0 4,0 0),(1 1, 2 1, 2 2, 1 2,1 1))

MULTIPOINT((0 0),(1 2))

MULTIPOINT Z ((0 0 0),(1 2 3))

MULTIPOINT EMPTY

MULTILINESTRING((0 0,1 1,1 2),(2 3,3 2,5 4))

MULTIPOLYGON(((0 0,4 0,4 4,0 4,0 0),(1 1,2 1,2 2,1 2,1 1)), ((-1 -1,-1 -2,-2 -2,-2 -1,-1 -1)))

GEOMETRYCOLLECTION(POINT(2 3),LINESTRING(2 3,3 4))

GEOMETRYCOLLECTION EMPTY

WKTの入出力は関数ST_AsTextとST_GeomFromTextによって提供されます。

text WKT = ST_AsText(geometry);
geometry = ST_GeomFromText(text WKT, SRID);

例えば、WKTとSRIDからの空間オブジェクトの生成と挿入のステートメントは次の通りです。

INSERT INTO geotable ( geom, name )
  VALUES ( ST_GeomFromText('POINT(-126.4 45.32)', 312), 'A Place');

Well-Known Binary (WKB)は、空間データのバイナリデータ (バイト列)で、移植可能かつ正確な表現です。空間オブジェクトのWKB表現を次に挙げます。

WKT: POINT(1 1)

WKB: 0101000000000000000000F03F000000000000F03

WKT: LINESTRING (2 2, 9 9)

WKB: 0102000000020000000000000000000040000000000000004000000000000022400000000000002240

WKBの入出力は関数ST_AsBinaryとST_GeomFromWKBが提供されています。次のように使います。

bytea WKB = ST_AsBinary(geometry);
geometry = ST_GeomFromWKB(bytea WKB, SRID);

たとえば、WKBから空間オブジェクトの生成、挿入は次のようにします。

INSERT INTO geotable ( geom, name )
  VALUES ( ST_GeomFromWKB('\x0101000000000000000000f03f000000000000f03f', 312), 'A Place');

ジオメトリデータタイプ

PostGISは、geometryというPostgreSQIデータ型を定義して、OGC Simple Features model を実装しています。これで、内部タイプコード (GeometryTypeとST_GeometryType参照)で全てのジオメトリのサブタイプを表現します。これにより、カラム型で定義されたテーブルの行として、空間地物をモデリングすることが可能となります。

geometryデータ型は透過です。ジオメトリ値に関する関数から全てにアクセスできることを意味します。関数によって、ジオメトリオブジェクトの生成、全ての内部フィールドへのアクセスと更新、新しいジオメトリ値の計算が可能です。PostGISは、OGC Simple feature access - Part 2: SQL option (SFS)仕様で定義されている全ての関数に、他の多数の関数とあわせて対応しています。関数の完全な一覧はChapter 7, PostGISリファレンスをご覧下さい。

Note

PostGISは、空間関数にプリフィクス"ST_"を付けて、SFA標準に従っています。これは、"Spatial and Temporal (空間と時間)"を示していますが、標準の時間の部分はまだ開発していません。その代わりに"Spatial Type (空間タイプ)"と解釈できます。

SFA標準は、空間オブジェクトは空間参照系識別子 (SRID)を含むと規程しています。SRIDは、空間オブジェクトをデータベースに挿入するために生成した時に求められます (デフォルトとして0になるかも知れません)。ST_SRIDとthe section called “空間参照系”をご覧下さい。

ジオメトリのクエリを効率的にするため、PostGISでは様々な種類の空間インデクスを定義しています。詳細についてはthe section called “空間インデックス”とthe section called “空間インデックスを使う”をご覧下さい。

PostGIS EWKBとEWKT

OGC SFA仕様は、まず2次元ジオメトリのみに対応しました。また、入出力表現にジオメトリのSRIDは取り入れていまません。OGC SFA仕様 1.2.1 (ISO 19125標準に準拠)では3次元 (XYZ)とM値 (XYMとXYZM)座標に対応するようになりましたが、SIRD値の取り込みは依然行われていません。

これらの制限のため、PostGISでは拡張書式であるEWKBとEWKTを定義しました。3次元 (XYZ, XYM)と4次元 (XYZN)座標系に対応し、SRID情報を取り込めるようにしました。すべてのジオメトリ情報を含めたので、PostGISはEWKBを格納用書式 (DUMPファイル等)として使えるようになりました。

PostGISデータオブジェクトの「カノニカルな形式」のためにEWKBとEWKTを使います。入力では、バイナリデータのカノニカルな形式はEWKB、テキストデータについてはEWKBかEWKTが受け付けられます。これにより、HEXEWKBまたはEWKTのテキスト値から::geometryを使用してキャストを行い、ジオメトリ値が生成できるようになりました。出力では、バイナリのカノニカルな形式はEWKBで、テキストはHEXEWKB (HEXエンコードを施したEWKB)です。

たとえば、この手続きでは、EWKTテキスト値からのキャストでジオメトリを生成して、HEXWKBのカノニカルな形式を使った出力を行います。

SELECT 'SRID=4;POINT(0 0)'::geometry;
  geometry
  ----------------------------------------------------
  01010000200400000000000000000000000000000000000000

PostGIS EWKT出力はOGC WKTと次の通り相違点があります。

XYZジオメトリでZ修飾子が省略されます。

OGC: POINT Z (1 2 3)

EWKT: POINT (1 2 3)

M値を含むXYMジオメトリ:

OGC: POINT M (1 2 3)

EWKT: POINTM (1 2 3)

4次元ジオメトリでZM修飾子を省略:

OGC: POINT ZM (1 2 3 4)

EWKT: POINT (1 2 3 4)

EWKTは、次のようにOGC/ISO書式で発生しうる過剰次元と不整合を回避しています。

POINT ZM (1 1)

POINT ZM (1 1 1)

POINT (1 1 1 1)

Caution

PostGISの拡張書式はOGC書式の上位互換であり、全ての妥当なOGC WKB/WKTは妥当なEWKB/EWKTでもあります。しかし、OGCがPostGISの定義と衝突する方法で書式を拡張した場合には、将来的に書式を変更する可能性があります。ゆえに、この互換性に*頼るべきではありません*!

空間オブジェクトのEWKTテキスト表現の例:

POINT(0 0 0) -- XYZ

SRID=32632;POINT(0 0) -- SRID付きXY

POINTM(0 0 0) -- XYM

POINT(0 0 0 0) -- XYZM

SRID=4326;MULTIPOINTM(0 0 0,1 2 1) -- SRID付きXYM

MULTILINESTRING((0 0 0,1 1 0,1 2 1),(2 3 1,3 2 1,5 4 1))

POLYGON((0 0 0,4 0 0,4 4 0,0 4 0,0 0 0),(1 1 0,2 1 0,2 2 0,1 2 0,1 1 0))

MULTIPOLYGON(((0 0 0,4 0 0,4 4 0,0 4 0,0 0 0),(1 1 0,2 1 0,2 2 0,1 2 0,1 1 0)),((-1 -1 0,-1 -2 0,-2 -2 0,-2 -1 0,-1 -1 0)))

GEOMETRYCOLLECTIONM( POINTM(2 3 9), LINESTRINGM(2 3 4, 3 4 5) )

MULTICURVE( (0 0, 5 5), CIRCULARSTRING(4 0, 4 4, 8 4) )

POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)), ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)), ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )

TRIANGLE ((0 0, 0 10, 10 0, 0 0))

TIN( ((0 0 0, 0 0 1, 0 1 0, 0 0 0)), ((0 0 0, 0 1 0, 1 1 0, 0 0 0)) )

これらの書式を使う入出力は次の関数を使うと有効です。

バイト配列 EWKB = ST_AsEWKB(geometry);
テキスト EWKT = ST_AsEWKT(geometry);
ジオメトリ = ST_GeomFromEWKB(bytea EWKB);
ジオメトリ = ST_GeomFromEWKT(text EWKT);

たとえば、EWKTを使ってPostGISの空間オブジェクトを作成し挿入するステートメントは次の通りです。

INSERT INTO geotable ( geom, name )
  VALUES ( ST_GeomFromEWKT('SRID=312;POINTM(-126.4 45.32 15)'), 'A Place' )

ジオグラフィデータタイプ

geographyデータタイプによって地理座標 ("geographic", "geodetic", "lat/lon", "lon/lat"など)上の空間地物表現にネイティブに対応できます。地理座標系は角度 (度)単位で表現される球面座標系です。

PostGISジオメトリ型の基礎は平面です。平面上の2点間の最短経路は直線です。ジオメトリに関する関数 (面積、距離、長さ、インタセクション等)は直線ベクトルとデカルト平面を使って計算しています。これで実装が簡単になり実行速度も上がりますが、地球の球面の上にあるデータについては不正確になります。

PostGISジオグラフィというデータ型は球面モデルに基づいています。球面上の2点の最短経路は大円の弧にあたります。ジオグラフィの関数 (面積、距離、長さ、インタセクション等)は球面上の弧を使います。球面上の世界の形状を考慮に入れるので、より正確な結果が得られます。

基礎となる数学はより複雑になるため、ジオグラフィ型で定義された関数はジオメトリ型で定義された関数よりも少なくなります。時間が経つにつれて新しいアルゴリズムが追加されて、ジオグラフィの機能が拡大していきます。回避策として、ジオメトリ型とジオグラフィ型との相互変換が可能です。

ジオグラフィ型は、ジオメトリ型のように、空間参照系識別子 (SRID)を介して空間参照系と関連付けられます。spatial_ref_sysテーブルで定義されているあらゆる地理空間参照系 (経度/緯度を使う)が使えます (PostGIS 2.2より前ではジオグラフィ型はWGS 84地理座標系 (SRID:4326)にのみ対応していました)。the section called “ユーザ定義空間参照系”に書いている通り、独自の空間参照系を追加することもできます。

計測関数 (例 ST_Distance、ST_Length、ST_Perimeter、ST_Area)によって返されるものの単位と、ST_DWithinの引数で与えられる距離との、空間参照系の単位は、メートルです。

ジオグラフィテーブルの生成

ジオグラフィデータを格納するテーブルは、SQLステートメントCREATE TABLEにgeography型のカラムを付けることで生成することができます。2次元ラインストリングをWGS84地理座標系 (SRID 4326)で保存するジオグラフィカラムを持つテーブルを生成する例を次に示します。

CREATE TABLE global_points (
    id SERIAL PRIMARY KEY,
    name VARCHAR(64),
    location geography(POINT,4326)
  );

二つの任意の型修飾子に対応するジオグラフィ型:

空間の型修飾子は、カラム内で許される形状の種類や次元を規制します。値によって空間型はPOINT、LINESTRING、POLYGON、MULTIPOINT、MULTILINESTRING、MULTIPOLYGON、GEOMETRYCOLLECTIONが可能です。ジオグラフィ型は曲線や三角形、多面体サーフェスに対応していません。型修飾子に後置詞Z、M、ZMを付けることで、座標次元の制約に対応しています。たとえば、'LINESTRINGM'は、3次元で3番目の軸はMであるラインストリングのみを許します。同様に'POINTZM'では4次元 (XYZM)データが求められます。

SRID修飾子は空間参照系(SRID)を特定の数値になるよう制約します。省略した場合には、デフォルトは4326 (WGS84地理座標系)となり、全ての計算はWGS84を使ったものになります。

ジオグラフィカラムを持つテーブルの生成の例を次に挙げます。

SRIDがデフォルトの4326 (WGS84 経度/緯度)である2次元ポイントジオグラフィを持つテーブルの生成:

CREATE TABLE ptgeogwgs(gid serial PRIMARY KEY, geog geography(POINT) );

NAD83緯度/経度の2次元ポイントジオグラフィを持つテーブルの生成:

CREATE TABLE ptgeognad83(gid serial PRIMARY KEY, geog geography(POINT,4269) );

SRIDを4326で明示した3次元 (XYZ)ポイントジオグラフィを持つテーブルの生成:

CREATE TABLE ptzgeogwgs84(gid serial PRIMARY KEY, geog geography(POINTZ,4326) );

SRIDがデフォルトの4326である2次元ラインストリングジオグラフィを持つテーブルの生成:

CREATE TABLE lgeog(gid serial PRIMARY KEY, geog geography(LINESTRING) );

SRIDがデ4326 (NAD 1927 経度/緯度)である2次元ポリゴンジオグラフィを持つテーブルの生成:

CREATE TABLE lgeognad27(gid serial PRIMARY KEY, geog geography(POLYGON,4267) );

ジオグラフィカラムはgeography_columnsシステムビューに登録されます。geography_columnsビューにクエリを出してテーブルを見るには、次の通りにします。

SELECT * FROM geography_columns;

空間インデックスはジオメトリカラムと同じように機能します。PostGISは、カラム型がジオグラフィであると通知したうえで、ジオメトリに使う通常の平面用インデックスでなく、球面を基にした適切なインデックスを生成します。

-- testテーブルに球面インデックスを作成
CREATE INDEX global_points_gix ON global_points USING GIST ( location );

ジオグラフィテーブルの使用

ジオメトリと同じ方法でジオグラフィテーブルにデータを挿入できます。ジオメトリデータは、SRID 4326の場合には、ジオグラフィ型に自動キャストされます。EWKTとEWKB書式はジオグラフィ値を指定するために使うことができます。

-- testテーブルにデータを追加する
INSERT INTO global_points (name, location) VALUES ('Town', 'SRID=4326;POINT(-110 30)');
INSERT INTO global_points (name, location) VALUES ('Forest', 'SRID=4326;POINT(-109 29)');
INSERT INTO global_points (name, location) VALUES ('London', 'SRID=4326;POINT(0 49)');

spatial_ref_sysテーブルにある地理 (経度/緯度)参照系は、ジオグラフィのSRIDとして指定することができます。非地理座標系を使うとエラーが発生します。

-- NAD 83 経度/緯度
SELECT 'SRID=4269;POINT(-123 34)'::geography;
                    geography
----------------------------------------------------
 0101000020AD1000000000000000C05EC00000000000004140

-- NAD27 経度/緯度
SELECT 'SRID=4267;POINT(-123 34)'::geography;
                    geography
----------------------------------------------------
 0101000020AB1000000000000000C05EC00000000000004140

-- NAD83 UTM zone メートル単位 - メートル単位の平面投影法なのでエラーが発生します
SELECT 'SRID=26910;POINT(-123 34)'::geography;

ERROR:  Only lon/lat coordinate systems are supported in geography.

クエリと計測関数はメートル単位となります。そのため距離パラメータはメートル (面積の場合は平方メートル)単位となります。

-- 1000km範囲の距離に関するクエリ
SELECT name FROM global_points WHERE ST_DWithin(location, 'SRID=4326;POINT(-110 29)'::geography, 1000000);

シアトルからロンドンへの (LINESTRING(-122.33 47.606, 0.0 51.5))大円航路を行く航空機がレイキャビク (POINT(-21.96 64.15)) にどれだけ近づくかを計算することで、ジオグラフィの力を見ことができます (航路の地図表示)。

ジオグラフィ型は、レイキャビクとシアトル－ロンドン間の大円航路との距離について、球面上で122.235 kmという本当の最短距離を計算します。

-- GEOGRAPHYを使った距離計算
SELECT ST_Distance('LINESTRING(-122.33 47.606, 0.0 51.5)'::geography, 'POINT(-21.96 64.15)'::geography);
   st_distance
-----------------
 122235.23815667

ジオメトリ型では、平面の世界地図上で見て、レイキャビクとシアトル－ロンドン間の直線とのデカルト距離が計算され、意味がありません。計算結果の名目上の単位は「度」ですが、点間の本当の角度差に応じるものではなく、「度」と呼ぶこと自体が不正確です。

-- GEOMETRYを使った距離計算
SELECT ST_Distance('LINESTRING(-122.33 47.606, 0.0 51.5)'::geometry, 'POINT(-21.96 64.15)'::geometry);
      st_distance
--------------------
 13.342271221453624

ジオグラフィ型を使用すべき時

ジオグラフィ型によって、経度緯度座標でデータを格納できるようになりましたが、ジオグラフィで定義されている関数が、ジオメトリより少ないのと、実行にCPU時間がかかる、というところが犠牲になっています。

選択した型が、期待する領域から出ないことを、ジオメトリ型にして使用する条件とすべきです。使用するデータは地球全体か、大陸か、州か、自治体か?

データが小さいエリア内におさまるなら、適切な投影を選択してジオメトリを使うのが、効率面でも機能面でも最も良い方法です。

データが地球全体か大陸なら、ジオグラフィで投影法の細かい問題を気にせずにシステムを構築できるでしょう。経度/緯度のデータを保存して、ジオグラフィで定義された関数使います。

投影法を理解していなくて、学習したくもなくて、かつ、ジオグラフィで使える関数が限られていることを受け入れるのなら、ジオグラフィを使った方が簡単です。単純にデータを経度/緯度でロードして、そこから進めて下さい。

ジオグラフィとジオメトリ間のサポート状況の比較についてはthe section called “PostGIS関数対応マトリクス”をご覧下さい。ジオグラフィ関数の簡潔なリストと説明についてはthe section called “PostGISジオグラフィ対応関数”をご覧下さい。

ジオグラフィに関する高度なよくある質問

1.

球または回転楕円体のどちらで計算するのでしょうか?

デフォルトでは、全ての距離と面積の計算は回転楕円体で行います。局所的なエリアでの計算結果と良好な投影を施した平面での結果と比較して下さい。大きなエリアの場合は、回転楕円体計算は、投影平面上でのどの計算よりも精度が高くなります。

全てのジオグラフィ関数には、最後の真偽パラメータを'FALSE'にすると球面を使った計算を行うというオプションがあります。これは、特にジオメトリが非常に単純である場合に計算を速くするためのものです。

2.

日付変更線や極に関してはどうなっていますか?

全ての計算に日付変更線や極の概念がありません。座標は球 (経度/緯度)であるので、日付変更線とクロスする形状は、計算の観点からは、他のものと変わりありません。

3.

処理できる最も長い弧はどうなりますか?

大圏の弧を2点の「補完線」として使用しています。任意の2点は、実際には2方向につながっていて、どちらの方向に行くかに依存します。PostGISの全てのコードは、大圏コースの2コースのうち*短い*方でつながっていると仮定しています。結果として、180度以上の弧を持つ形状は正しくモデル化されません。

4.

なぜヨーロッパやロシアといった大きな範囲の面積計算はとても遅いのですか?

ポリゴンがとんでもなく大きいからです。二つの理由から、大きなエリアは悪いです。一つは、バウンダリボックスが大きいため、どのようなクエリを走らせても、インデックスがフィーチャーを引っ張ってくる傾向にあるためです。もう一つは、頂点数が巨大で、テスト (距離、包含)関数では、少なくとも1回、通常はN (Nは、もう一方のフィーチャーの頂点数)回、頂点を横断しなければならないためです。

ジオメトリでは、大きなポリゴンを持っているけれども小さな範囲のクエリを実行する時、ジオメトリデータ情報を小片に「非正規化」します。これにより、インデックスが効果的にオブジェクトの一部を問い合わせるようになり、またクエリが常にオブジェクト全体を引っ張りこむようなことがないようになります。ST_Subdivideを参照して下さい。ヨーロッパ全体を一つのポリゴンに*格納できる*からといって、*そうすべき*だというわけではありません。

ジオメトリ検証

PostGISはOpen Geospatial Consortium (OGC)のSimple Feature Specificationに準拠しています。この標準では、単純なジオメトリと妥当なジオメトリの概念が定義されています。これらの定義によって、Simple Featureのジオメトリモデルが一貫性があって、かつ明確な方法で空間オブジェクトを表現することができ、効率的な計算を助けます (OGC Simple FeatureとSQL/MMとにおいては、単純性と妥当性について同じ定義です)。

単純ジオメトリ

単純なジオメトリは、自己交差や自己接触といった異常な幾何学上のポイントを持たないジオメトリです。

POINTは0次元ジオメトリオブジェクトとして常に単純です。

MULTIPOINTは、任意の二つの座標値 (POINT)が同じでないなら単純です。

LINESTRINGは、同じポイントを二回通過しないものが単純です。単純なラインストリングの端点が同一の場合には、閉じているとされ、線形リングと呼ばれます。

(a)と(c)は単純なLINESTRINGです。(b)と(d)は単純ではありません。(c)は閉じた線形リングです。

(a)

(b)

(c)

(d)

MULTILINESTRINGは、要素が全て単純で、かつ、全ての要素同士のインタセクションが要素の境界上でのみ出現する場合には、単純です。

(e)と(f)は単純なMULTILINESTRINGです。(g)は単純ではありません。

(e)

(f)

(g)

POLYGONは線形リングから形成されるので、妥当なポリゴンジオメトリは常に単純です。

ジオメトリが単純かどうかを試すにはST_IsSimple関数を使います。次のようにします。

SELECT
   ST_IsSimple('LINESTRING(0 0, 100 100)') AS straight,
   ST_IsSimple('LINESTRING(0 0, 100 100, 100 0, 0 100)') AS crossing;

 straight | crossing
----------+----------
 t        | f

一般的にPostGIS関数は引数ジオメトリの単純性を求めていません。単純性は主にジオメトリの妥当性を定義するための基礎として用いられます。空間データモデルによっては要件としていることもあります (たとえば、線形ネットワークはしばしばクロスを認めません)。マルチポイントと線形ジオメトリはST_UnaryUnionを使って単純にできます。

妥当なジオメトリ

ジオメトリの妥当性は主に2次元ジオメトリ (POLYGONとMULTIPOLYGON)に適用されます。妥当性はポリゴンジオメトリが平面領域を明確にモデル化できる規則によって定義されます。

POLYGONは次の条件では妥当です。

ポリゴン境界リング (外側の殻リングと内側の穴リング)が単純 (交差も自己接触もしていない)であること。これによりポリゴンは切断線、トゲ、循環を持つことができなくなります。これは、ポリゴンの穴を外側のリングの自己接触 (いわゆる "inverted hole" (逆穴))でなく、内側のリングとして表現されなけれならないことを意味します。

境界リングがクロスしないこと

境界リングは点で接触したとしても接点として接触すること (線上にあってはなりません)

内側リングは外側リング内にあること

ポリゴン内部は単純に接続されていること (リングはポリゴンを複数に分割するように接触してはなりません)

(h)と(i)は妥当なPOLYGONです。(j-m)は不正です。(j)は妥当なMULTIPOLYGONとして表すことができます。

(h)

(i)

(j)

(k)

(l)

(m)

MULTIPOLYGONは次の条件では妥当です。

要素となるPOLYGONが妥当であること

要素がオーバラップしない (内部同士がインタセクトしない)こと

要素同士の接触が点でけである (線に沿って接触しない)こと

(n)は妥当なMULTIPOLYGONです。(o)と(p)は不正です。

(n)

(o)

(p)

これらの規則は妥当なポリゴンジオメトリも単純であることも示しています。

線ジオメトリについては、LINESTRINGが少なくとも二つのポイントを持ち、長さが0でない (少なくとも二つの異なるポイントを持つことと同じ)、というのが唯一の妥当性規則です。単純でない (自己交差がある)ラインは妥当です。

SELECT
   ST_IsValid('LINESTRING(0 0, 1 1)') AS len_nonzero,
   ST_IsValid('LINESTRING(0 0, 0 0, 0 0)') AS len_zero,
   ST_IsValid('LINESTRING(10 10, 150 150, 180 50, 20 130)') AS self_int;

 len_nonzero | len_zero | self_int
-------------+----------+----------
 t           | f        | t

POINTとMULTIPOINTは妥当性規則を持っていません。

妥当性の管理

PostGISは妥当なジオメトリも不正なジオメトリも、生成も格納もできます。このため、不正なジオメトリを検出し、フラグを付け、訂正することができます。OGC妥当性規則が求める規則 (長さが0のラインストリングや逆穴を持つポリゴン等)よりも厳格であることもあります。

PostGISが提供する関数の多くは、引数ジオメトリが妥当であるとの仮定によっています。たとえば、ポリゴンの外部に穴があるポリゴンの面積を計算しても意味がありませんし、単純でない境界線からポリゴンを形成するのも意味がありません。妥当なジオメトリ入力を仮定することで、トポロジ的に正しいことを確認する必要がなくなるので、関数がより効率的に動作することができます (例外として、長さ0のラインと反転したポリゴンは一般的に正しく取り扱われます)。また、ほとんどのPostGIS関数は、入力ジオメトリが妥当な場合には、妥当なジオメトリ出力を生成します。これにより、PostGIS関数を安全に連鎖させられます。

PostGIS関数を呼ぶときに予期しないエラーメッセージ ("GEOS Intersection() threw an error!"等)に遭遇する場合には、まず関数の引数が妥当かどうかを確認します。妥当でないなら、次に示す方法のいずれかによる、処理中のデータの妥当性の確認を検討して下さい。

Note

関数が妥当な入力でエラーを報告する場合には、PostGISまたは使用しているライブラリの一つの中にエラーがあるのを発見することがありますが、その際はPostGISプロジェクトに報告して下さい。PostGIS関数が妥当な入力から不正なジオメトリを返す場合も同様です。

ジオメトリが妥当かをテストするにはST_IsValid関数を使います。次のようにします。

SELECT ST_IsValid('POLYGON ((20 180, 180 180, 180 20, 20 20, 20 180))');
-----------------
 t

ジオメトリの不正性の性質と位置に関する情報はST_IsValidDetail関数で得られます。次のようにします。

SELECT valid, reason, ST_AsText(location) AS location
    FROM ST_IsValidDetail('POLYGON ((20 20, 120 190, 50 190, 170 50, 20 20))') AS t;

 valid |      reason       |                  location
-------+-------------------+---------------------------------------------
 f     | Self-intersection | POINT(91.51162790697674 141.56976744186045)

不正なジオメトリを自動的に訂正することが望ましいような状況があります。その際はST_MakeValid関数を使います (ST_MakeValidは不正な入力を許す特別な関数です)。

複雑なジオメトリの不正性テストには多大なCPU時間を取ることになるため、デフォルトでは、ジオメトリのロード時にPostGISは妥当性の確認をしません。データソースが信用できない場合には、チェック制約を使って、テーブル上で妥当性を強制的に確認することができます。次のようにします。

ALTER TABLE mytable
  ADD CONSTRAINT geometry_valid_check
        CHECK (ST_IsValid(geom));

空間参照系

空間参照系 (Spatial Reference System, SRS) (座標参照系、Coordinate Reference System, CRSとも呼ばれます)は、ジオメトリが地表上の位置をどのように参照するかを定義しています。SRSには次の通り三種あります。

測地 (geodetic) 空間参照系は、地表に直接対応付けられる極座標系 (経度と緯度)を使います。

投影 (projected)空間参照系は、回転楕円体面を「平面にする」ための数学的な投影変換を使います。距離、面積、角度といった量を直接計測することが可能な位置座標系です。この座標系はデカルト座標系ですので、原点と二つの直交軸 (通常は来北と東方向)が定義されています。個々の投影座標系は、定まった距離単位 (通常はメートルかフィート)を使います。投影座標系は、歪みを避けて定義された座標範囲に納めるために、適応範囲を制限してもいいことになっています。

局所 (local)座標系は、地表への参照がないデカルト座標系です。PostGISではSRID値を0に指定します。

使用されている空間参照系には多数の相違点があります。一般的空間参照系は欧州石油調査グループ (European Petroleum Survey Group)のEPSG databaseで標準化されています。利便性向上のためPostGIS (と多くの空間系)はSRIDと呼ぶ整数を使って空間参照系の定義を参照します。

ジオメトリは、SRID値で空間参照系に関連付けられています。SRID値の取得にはST_SRIDを使います。ジオメトリのSRIDの設定にはST_SetSRIDを使います。ジオメトリ構築関数の中には、SRIDを与えられるものもあります (ST_PointやST_MakeEnvelope等)。EWKT書式はSRID=n;を前置することでSRIDに対応できます。

二つのジオメトリを処理する空間関数 (オーバレイ関数 、関係関数など)の入力ジオメトリは、同じ空間参照系である (同じSRIDを持つ)必要があります。ST_TransformやST_TransformPipelineを使うことで、ジオメトリデータを異なる空間参照系に変換できます。関数から返されるジオメトリは、入力ジオメトリと同じ空間参照系になります。

SPATIAL_REF_SYSテーブル

PostGISが使用するSPATIAL_REF_SYSテーブルは利用可能な空間参照系を定義するOGC準拠のデータベーステーブルです。このテーブルは、数値でSRIDを持ち、文字列で座標系の記述を持っています。

spatial_ref_sysの定義は次の通りです。

CREATE TABLE spatial_ref_sys (
  srid       INTEGER NOT NULL PRIMARY KEY,
  auth_name  VARCHAR(256),
  auth_srid  INTEGER,
  srtext     VARCHAR(2048),
  proj4text  VARCHAR(2048)
)

カラムは次の通りです。

srid

データベース内のSpatial Reference System (SRS, 空間参照系)で一意に識別される整数コードです。

auth_name

この参照系に引用されている標準の名前もしくは標準そのものです。たとえば「EPSG」は妥当なauth_nameです。

auth_srid

空間参照系のIDはauth_nameに引用される機関によって定義されます。ここがEPSGの場合には、これはEPSGコードです。

srtext

空間参照系のWell-Knownテキスト表現です。たとえば、WKT SRSの表現は、次のようになります。

PROJCS["NAD83 / UTM Zone 10N",
  GEOGCS["NAD83",
        DATUM["North_American_Datum_1983",
          SPHEROID["GRS 1980",6378137,298.257222101]
        ],
        PRIMEM["Greenwich",0],
        UNIT["degree",0.0174532925199433]
  ],
  PROJECTION["Transverse_Mercator"],
  PARAMETER["latitude_of_origin",0],
  PARAMETER["central_meridian",-123],
  PARAMETER["scale_factor",0.9996],
  PARAMETER["false_easting",500000],
  PARAMETER["false_northing",0],
  UNIT["metre",1]
]

SRS WKTの詳細については、OGC標準のWell-known text representation of coordinate reference systemsをご覧下さい。

proj4text

PostGISは座標変換機能を提供するためにProj4ライブラリを用いています。 proj4textカラムには、特定のSRIDを示すProj4座標定義文字列が入ります。たとえば次のようになります。

+proj=utm +zone=10 +ellps=clrk66 +datum=NAD27 +units=m

詳細情報についてはPROJウェブサイトをご覧下さい。spatial_ref_sys.sqlファイルには、全てのEPSG投影について、srtextとproj4textの定義があります。

投影変換で空間参照系の定義を使用する場合には、次の戦略を取ります。

auth_nameとauth_sridがある (NULLでない)場合には、これに基づいてPROJSRSを使います (存在する場合)。

srtextがある場合には、可能ならそれを使用してSRSを生成します。

proj4textがある場合には、可能ならこれを使用してSRSを生成します。

ユーザ定義空間参照系

PostGISspatial_ref_sysテーブルにはPROJ投影ライブラリで処理される最も一般的な空間参照系定義3000件以上があります。しかし、そこに無い多くの座標系があります。空間参照系に関する必要な情報がある場合は、SRS定義をテーブルに追加できます。PROJに詳しいなら独自の空間参照系を定義することもできます。ほとんどの空間参照系は地域的なものであり、目的の範囲外で使用する場合は意味を持たない点に注意してください。

PostGISのコアセットに入っていない空間参照系を探すための素晴らしい資料がhttp://spatialreference.org/にあります。

一般的に使用される空間参照系には4326 - WGS 84経度緯度、4269 - NAD 83 経度緯度、3395 - WGS 84 メルカトル、2163 - 米国ナショナルアトラス正積図法、60個のWGS84 UTMゾーンがあります。UTMゾーンは計測に最適ですが、6度 (訳注: 経度)の領域のみをカバーします (対象地域に使用するUTMゾーンを決定するにはutmzone PostGIS plpgsql helper functionを参照してください)。

米国の州では、州平面空間参照系 (メートルまたはフィート単位)を使用します。この空間参照系は州ごとに一つか二つ存在します。ほとんどのメートル単位のものはコアのセットに存在しますが、フィート単位の多数のものやESRIが作成したものはspatialreference.orgからロードする必要があります。

地球外の座標系でさえも定義することができます。たとえばMars 2000です。この火星の座標系は非平面 (回転楕円体の度)ですが、geography型で、度でなくメートル単位で長さや近接測定値を取得することができます。

割当外のSRIDとPROJ定義を使って米国中央のランベルト正角円錐図法の独自座標系をロードする例を次に示します。

INSERT INTO spatial_ref_sys (srid, proj4text)
VALUES ( 990000,
  '+proj=lcc  +lon_0=-95 +lat_0=25 +lat_1=25 +lat_2=25 +x_0=0 +y_0=0 +datum=WGS84 +units=m +no_defs'
);

空間テーブル

空間テーブルを作る

geometry型のカラムを付けたCREATE TABLE SQLステートメントでジオメトリデータを保存するテーブルを生成することができます。次の例では、BC-アルベルス座標系 (SRID 3005)の2次元 (XY)ラインストリングを保存するジオメトリカラムを持つテーブルを生成します。

CREATE TABLE roads (
    id SERIAL PRIMARY KEY,
    name VARCHAR(64),
    geom geometry(LINESTRING,3005)
  );

geometry型は、次の通り、二つの任意指定型修飾子に対応しています。

空間タイプ修飾子はカラムで許される形状と次元の種類を制約するものです。値は、対応しているジオメトリタイプ (POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON, GEOMETRYCOLLECTION等)なら全て可能です。空間タイプ修飾子は、後置詞 Z, M, ZMを付け加えることで座標次元の制約に対応します。例えば、`LINESTRINGM`修飾子では、3次元で3番目がM軸となるラインストリングだけを許します。同様に、'POINTZM'では4次元 (XYZM)データが求められます。

SRID修飾子は空間参照系のSRIDを特定の数値に制約します。省略した場合には、デフォルトは0となります。

ジオグラフィカラムを持つテーブルの生成の例を次に挙げます。

デフォルトSRIDであらゆる種類のジオメトリを保持するテーブルの生成:

CREATE TABLE geoms(gid serial PRIMARY KEY, geom geometry );

2次元ポイントでSRIDがデフォルトのテーブル作成:

CREATE TABLE pts(gid serial PRIMARY KEY, geom geometry(POINT) );

3次元 (XYZ)ポイントでSRIDが3005のテーブル作成:

CREATE TABLE pts(gid serial PRIMARY KEY, geom geometry(POINTZ,3005) );

4次元 (XYZM)ラインストリングでSRIDがデフォルトのテーブル作成:

CREATE TABLE lines(gid serial PRIMARY KEY, geom geometry(LINESTRINGZM) );

2次元ポリゴンでSRIDが4276 (NAD 1927地理座標系)のテーブル作成:

CREATE TABLE polys(gid serial PRIMARY KEY, geom geometry(POLYGON,4267) );

一つのテーブルが一つ以上のジオメトリカラムを持つことができます。テーブル生成時に指定するか、ALTER TABLE SQLステートメントを使って追加するかで実現できます。次に3次元ラインストリングを格納するカラムを追加する例を示します。

ALTER TABLE roads ADD COLUMN geom2 geometry(LINESTRINGZ,4326);

GEOMETRY_COLUMNSビュー

OGC Simple Features Specification for SQLは、ジオメトリテーブル構造を記述するためのGEOMETRY_COLUMNSメタデータテーブルを定義しています。PostGISではgeometry_columnsは、データベースのシステムカタログテーブルから読み取るビューです。これによって、空間メタデータ情報が常に現在定義されているテーブルやビューと矛盾しなくなります。

\d geometry_columns

View "public.geometry_columns"
      Column       |          Type          | Modifiers
-------------------+------------------------+-----------
 f_table_catalog   | character varying(256) |
 f_table_schema    | character varying(256) |
 f_table_name      | character varying(256) |
 f_geometry_column | character varying(256) |
 coord_dimension   | integer                |
 srid              | integer                |
 type              | character varying(30)  |

カラムは次の通りです。

f_table_catalog, f_table_schema, f_table_name

ジオメトリカラムを持っている地物テーブルの完全修飾名。PostgreSQLには"catalog"の類似カラムが無いので、このカラムは空白のままです。"schema"についてはPostgreSQLスキーマ名が使われます (デフォルトはpublicです)。

f_geometry_column

フィーチャーテーブル内のジオメトリカラムの名前。

coord_dimension

カラムの座標次元 (2, 3, 4)。

srid

このテーブルのジオメトリの座標系として使用される座標系空間参照系のIDです。spatial_ref_sysテーブルを参照する外部キーです (the section called “SPATIAL_REF_SYSテーブル”を参照して下さい)。

type

空間オブジェクトの型。空間カラムを単一型に制限するには、POINT、LINESTRING、POLYGON、MULTIPOINT、MULTILINESTRING、MULTIPOLYGON、GEOMETRYCOLLECTIONのうちのいずれかを、また、XYMで使う場合には、LINESTRINGM、POLYGONM、MULTIPOINTM、MULTILINESTRINGM、MULTIPOLYGONM、GEOMETRYCOLLECTIONMのうちのいずれかを使います。複数の型が混合するコレクションの場合は"GEOMETRY"を型とすることができます。

手動でジオメトリカラムをgeometry_columnsに登録する

これが必要になる事例に、SQLビューとバルクインサートの二つがあります。バルクインサートの場合には、カラムに制約を与えるか、ALTER TABLEを実行することで、geometry_columnsテーブル内の登録を訂正することができます。ビューの場合には、CAST演算を使用します。カラムが型修飾子に基づく場合には、生成処理によって正しく登録されるので、何も行う必要がありません。ジオメトリに適用する空間関数を持たないビューも、基礎となるテーブルのジオメトリカラムと同じように登録されます。

-- 次のようなビューがあるとします
CREATE VIEW public.vwmytablemercator AS
        SELECT gid, ST_Transform(geom, 3395) As geom, f_name
        FROM public.mytable;

-- 正しく登録するには、
-- ジオメトリをキャストします。
--
DROP VIEW public.vwmytablemercator;
CREATE VIEW  public.vwmytablemercator AS
        SELECT gid, ST_Transform(geom, 3395)::geometry(Geometry, 3395) As geom, f_name
        FROM public.mytable;

-- ジオメトリタイプが確実に2次元ポリゴンだと知っているなら
-- 次のようにできます。
DROP VIEW public.vwmytablemercator;
CREATE VIEW  public.vwmytablemercator AS
        SELECT gid, ST_Transform(geom,3395)::geometry(Polygon, 3395) As geom, f_name
        FROM public.mytable;

-- 次のように、バルクインサートで派生テーブルを生成したとしましょう
SELECT poi.gid, poi.geom, citybounds.city_name
INTO myschema.my_special_pois
FROM poi INNER JOIN citybounds ON ST_Intersects(citybounds.geom, poi.geom);

-- 新しいテーブルに2次元インデックスを作ります
CREATE INDEX idx_myschema_myspecialpois_geom_gist
  ON myschema.my_special_pois USING gist(geom);

-- ポイントが3次元ポイントであったり、XYMポイントであったりした場合には、
-- 次のように、2次元インデックスでなくN次元インデックスを作ることになるかも
-- 知れません。
CREATE INDEX my_special_pois_geom_gist_nd
        ON my_special_pois USING gist(geom gist_geometry_ops_nd);

-- 新しいテーブルのジオメトリカラムをgeometry_columnsに手動登録するには、
-- 次のようにします。
-- カラムを型修飾子ベースにするために、基礎となるテーブル構造も変更することに
-- 注意して下さい。
SELECT populate_geometry_columns('myschema.my_special_pois'::regclass);

-- PostGIS 2.0を使っていて、何らかの理由で古い制約をもとにした定義を行う
-- (派生テーブルが同じタイプやSRIDを持たないといった場合)ことが必要な場合には、
-- 新しい任意変数use_typemodをfalseにします。
SELECT populate_geometry_columns('myschema.my_special_pois'::regclass, false);

古い制約を基にした手法は現在も対応していますが、制約を基にしたジオメトリカラムで直接的にビューで使われている場合は、型修飾子のようには正しくgeometry_columnsに登録されません。次の例では、型修飾子を使ったカラム定義と、制約に基づくカラムの定義とを行っています。

CREATE TABLE pois_ny(gid SERIAL PRIMARY KEY, poi_name text, cat text, geom geometry(POINT,4326));
SELECT AddGeometryColumn('pois_ny', 'geom_2160', 2160, 'POINT', 2, false);

psqlで次を実行します。

\d pois_ny;

型修飾子と制約に基づくのとでは異なった定義になっているのが見えます。

Table "public.pois_ny"
  Column   |         Type          |                       Modifiers

-----------+-----------------------+------------------------------------------------------
 gid       | integer               | not null default nextval('pois_ny_gid_seq'::regclass)
 poi_name  | text                  |
 cat       | character varying(20) |
 geom      | geometry(Point,4326)  |
 geom_2160 | geometry              |
Indexes:
    "pois_ny_pkey" PRIMARY KEY, btree (gid)
Check constraints:
    "enforce_dims_geom_2160" CHECK (st_ndims(geom_2160) = 2)
    "enforce_geotype_geom_2160" CHECK (geometrytype(geom_2160) = 'POINT'::text
        OR geom_2160 IS NULL)
    "enforce_srid_geom_2160" CHECK (st_srid(geom_2160) = 2160)

geometry_columnsでは、両方とも正しく登録されています。

SELECT f_table_name, f_geometry_column, srid, type
        FROM geometry_columns
        WHERE f_table_name = 'pois_ny';

f_table_name | f_geometry_column | srid | type
-------------+-------------------+------+-------
pois_ny      | geom              | 4326 | POINT
pois_ny      | geom_2160         | 2160 | POINT

しかし、次のようにビューを作ろうとします。

CREATE VIEW vw_pois_ny_parks AS
SELECT *
  FROM pois_ny
  WHERE cat='park';

SELECT f_table_name, f_geometry_column, srid, type
        FROM geometry_columns
        WHERE f_table_name = 'vw_pois_ny_parks';

型修飾子によるgeomのビューカラムは正しく登録されますが、制約に基づくものは正しく登録されません。

f_table_name   | f_geometry_column | srid |   type
------------------+-------------------+------+----------
 vw_pois_ny_parks | geom              | 4326 | POINT
 vw_pois_ny_parks | geom_2160         |    0 | GEOMETRY

これは、将来的にPostGISの版で変更されるかもしれませんが、今のところは、制約に基づくビューカラムを正しく登録させるには、次のようにします。

DROP VIEW vw_pois_ny_parks;
CREATE VIEW vw_pois_ny_parks AS
SELECT gid, poi_name, cat,
  geom,
  geom_2160::geometry(POINT,2160) As geom_2160
  FROM pois_ny
  WHERE cat = 'park';
SELECT f_table_name, f_geometry_column, srid, type
        FROM geometry_columns
        WHERE f_table_name = 'vw_pois_ny_parks';

f_table_name   | f_geometry_column | srid | type
------------------+-------------------+------+-------
 vw_pois_ny_parks | geom              | 4326 | POINT
 vw_pois_ny_parks | geom_2160         | 2160 | POINT

空間データのロード

空間テーブルを作成したら、これでGISデータをデータベースにアップロードする準備ができたことになります。現在、PostGIS/PostgreSQLデータベースにデータをロードするには、SQLステートメントを使う、またはシェープファイルのローダ/ダンパを使う、という二つの方法があります。

SQLを使ってロードする

空間データを文字表現 (WKTかWKB)に変換できたら、SQLを使うのがPostGISにデータを持たせる最も簡単です。SQLユーティリティのpsqlを使用して、SQLのINSERTステートメントのテキストファイルをロードすると、データをPostGIS/PostgreSQLに一括読み込みできます。

データアップロードファイル (たとえばroads.sql)は次のようになるでしょう。

BEGIN;
INSERT INTO roads (road_id, roads_geom, road_name)
  VALUES (1,'LINESTRING(191232 243118,191108 243242)','Jeff Rd');
INSERT INTO roads (road_id, roads_geom, road_name)
  VALUES (2,'LINESTRING(189141 244158,189265 244817)','Geordie Rd');
INSERT INTO roads (road_id, roads_geom, road_name)
  VALUES (3,'LINESTRING(192783 228138,192612 229814)','Paul St');
INSERT INTO roads (road_id, roads_geom, road_name)
  VALUES (4,'LINESTRING(189412 252431,189631 259122)','Graeme Ave');
INSERT INTO roads (road_id, roads_geom, road_name)
  VALUES (5,'LINESTRING(190131 224148,190871 228134)','Phil Tce');
INSERT INTO roads (road_id, roads_geom, road_name)
  VALUES (6,'LINESTRING(198231 263418,198213 268322)','Dave Cres');
COMMIT;

SQLファイルのPostgreSQLへのロードはpsqlを使います。次のようにします。

psql -d [データベース名] -f roads.sql

シェープファイルローダを使う

shp2pgsqlデータローダは、ESRIシェープファイルをPostGIS/PostgreSQLデータベースに、ジオメトリまたはジオグラフィとして挿入するための適切なSQLに変換します。ローダには、次に示すコマンドラインフラグによって区別される、いくつかの操作モードがあります。

グラフィカルユーザインタフェースを持つshp2pgsql-guiもあります。コマンドラインローダのオプションのほとんどが使えます。これは、スクリプト化されていない1回限りのロードの場合や、PostGIS初心者がロードする場合に、簡単に使用できます。PgAdminIIIのプラグインとすることもできます。

(c|a|d|p) 相互に排他的なオプションです。

-c

新しいテーブルの作成とシェープファイルからのデータの読み込みを行います。これがデフォルトモードです。

-a

シェープファイルからデータベーステーブルにデータを追加します。複数のファイルをロードするためにこのオプションを使う場合は、これらのファイルは同じ属性と同じデータ型を持つ必要があります。

-d

シェープファイルにあるデータを持つ新しいテーブルを作成する前にデータベーステーブルを削除します。

-p

テーブル作成のSQLコードを生成するだけで、実際のデータは追加しません。このモードは、テーブル作成とデータロードとを完全に分けたい場合に使用します。

-?

ヘルプ画面を表示します。

-D

出力データにPostgreSQLのダンプ書式を用います。このモードは-a, -c, -dと組み合わせて利用します。デフォルトの"insert"によるSQL書式よりも、大変早くロードできます。大きなデータセットではこちらを使用して下さい。

-s [<FROM_SRID>:]<SRID>

指定したSRIDを持つジオメトリテーブルの生成や追加を行います。FROM_SRIDが与えられた場合には、入力シェープファイルに、これを使います 。この場合には、ジオメトリは変更先SRIDに投影変換します。

-k

識別子 (カラム、スキーマおよび属性)の大文字小文字を保持します。シェープファイルの属性は全て大文字であることに注意して下さい。

-i

全ての整数を標準の32ビット整数に強制します。DBFヘッダではそれが正当であったとしても、64ビットのbigintを生成しません。

-I

ジオメトリカラムにGiSTインデックスを生成します。

-m

-m a_file_nameで、長いカラム名を10文字のDBFカラム名に対応付けるファイルを指定します。ファイルは、1以上の行を持ちます。各行は空白区切りで二つの名前を持ち、行頭行末に空白を入れません。例を次に示します。

COLUMNNAME DBFFIELD1
AVERYLONGCOLUMNNAME DBFFIELD2

-S

マルチ系ジオメトリの替りに単一ジオメトリを生成します。全てのジオメトリが実際に単一である (たとえば単一の外環でなるMULTIPOLYGONや単一の頂点でなるMULTIPOINT)場合にのみ成功します。

-t <次元>

出力ジオメトリが特定の次元を持つよう強制します。次元は、2D, 3DZ, 3DM, 4Dの文字列を使います。

入力の次元が出力より小さい場合には、出力では0が入ります。入力の次元が大きい場合には、外されます。

-w

出力書式をWKBでなくWKTにします。精度が低下して、座標変動が発生しうることに注意が必要です。

-e

トランザクションを使わずに、ステートメントごとに実行するようにします。エラーの元となる不良なジオメトリがいくつか含んでいる時に、大半の良好なデータのロードが可能にするものです。ダンプ書式ではトランザクションを常に使うので、-Dフラグを指定している場合には使えません。

-W <エンコーディング>

入力データ (dbfファイル)のエンコーディングを指定します。全てのdbfの属性は指定されたエンコーディングからUTF8に変換されます。SQL出力結果には SET CLIENT_ENCODING to UTF8が含まれるようになり、バックエンドはUTF-8からデータベースが内部利用のために設定したエンコーディングに再変換できます。

-N <方針>

NULLジオメトリ操作方針(insert*=挿入, skip=スキップ, abort=強制終了)を選択します。

-n

DBFファイルのみインポートします。対応するシェープファイルを持っていない場合、 自動的にこのモードになり、DBFファイルのみロードします。 このフラグは、完全なシェープファイル群を持っていて、属性データだけが欲しくてジオメトリが欲しくない時のみ使用します。

-G

ジオメトリ型のかわりに、ジオグラフィ型で、WGS84経度緯度 (SRID=4326)を使用します (経度緯度データが必要です)。

-T <tablespace>

新しいテーブルのテーブル空間を指定します。 -Xパラメータが使われない場合には、インデックスはデフォルトのテーブル空間を使用します。PostgreSQL文書には、テーブル空間を用いるべき時に関する良い文書があります。

-X <tablespace>

新しいテーブルのインデックスで使われるテーブル空間を指定します。 主キーインデックスに適用され、-Iが合わせて使われている場合にはGiST空間インデックスにも適用されます。

-Z

このフラグをこれを使う時、ANALYZE手続きの生成を防ぎます。-Zフラグが無い (デフォルトの振る舞い)場合には、ANALYZE手続きが生成されます。

ローダを使って入力ファイルを生成してアップロードするセッション例は次の通りです。

# shp2pgsql -c -D -s 4269 -i -I shaperoads.shp myschema.roadstable > roads.sql
# psql -d roadsdb -f roads.sql

変換とアップロードはUNIXのパイプを使うと一回で実行できます。

# shp2pgsql shaperoads.shp myschema.roadstable | psql -d roadsdb

空間データの抽出

空間データはSQLかシェープファイルダンパを使うと抽出できます。SQLの節では空間テーブルで比較とクエリに使用できる関数を示します。

SQLを使ってデータを抽出する

データベース外へのデータ抽出の最も簡単な方法は、抽出するデータセットを定義し、SELECT問い合わせを使って、結果カラムを解析可能なテキストファイルにダンプすることです。

db=# SELECT road_id, ST_AsText(road_geom) AS geom, road_name FROM roads;

road_id | geom                                    | road_name
--------+-----------------------------------------+-----------
          1 | LINESTRING(191232 243118,191108 243242) | Jeff Rd
          2 | LINESTRING(189141 244158,189265 244817) | Geordie Rd
          3 | LINESTRING(192783 228138,192612 229814) | Paul St
          4 | LINESTRING(189412 252431,189631 259122) | Graeme Ave
          5 | LINESTRING(190131 224148,190871 228134) | Phil Tce
          6 | LINESTRING(198231 263418,198213 268322) | Dave Cres
          7 | LINESTRING(218421 284121,224123 241231) | Chris Way
(6 rows)

返されるレコードの数を減らすためにある種の制限が必要になる場合があります。属性ベースで制限をかける場合には、非空間テーブルで使うのと同じSQL文を使います。空間に制限をかけるには次の関数を使います。

ST_Intersects

この関数は、二つのジオメトリが空間を共有しているかどうかをテストします。

=

この関数で、二つのジオメトリが幾何的に同一であるかを見ることができます。たとえば、'POLYGON((0 0,1 1,1 0,0 0))' は 'POLYGON((0 0,1 1,1 0,0 0))' と同じかを見ることができます (これは同じとなります)。

次に、これらの演算子をクエリで使うことができます。SQLコマンドラインからジオメトリとボックスの指定を行うときは、明示的に文字列表現をジオメトリに変換しなければならないことに注意して下さい。たとえば、次のようになります。ただし312は架空の空間参照系番号で、ここでのデータに合致しています。

SELECT road_id, road_name
  FROM roads
  WHERE roads_geom='SRID=312;LINESTRING(191232 243118,191108 243242)'::geometry;

上のクエリは"ROADS_GEOM"テーブルから、その値と等価である単一のレコードを返します。

道路がポリゴンで定義した面を通過するかどうかをチェックするには次のようにします。

SELECT road_id, road_name
FROM roads
WHERE ST_Intersects(roads_geom, 'SRID=312;POLYGON((...))');

最も一般的な空間クエリは「フレームベース」のクエリでしょう。これは、表示するためのデータの価値のある「マップフレーム」を取得するために、データブラウザやウェブマッパのようなクライアントソフトウェアに使われます。

"&&"演算子を使うとき、比較フィーチャーをBOX3DかGEOMETRYかに指定することができます。ただし、GEOMETRYを指定すると、それのバウンディングボックスが比較に使われます。

次に示すクエリのように、フレームにBOX3Dオブジェクトを使います。

SELECT ST_AsText(roads_geom) AS geom
FROM roads
WHERE
  roads_geom && ST_MakeEnvelope(191232, 243117,191232, 243119,312);

エンベロープの投影を指定するためにSRID 312を使っていることに注意して下さい。

ダンパを使う

pgsql2shpテーブルダンパは、データベースに直接接続して、テーブル (あるいはクエリによって定義されたもの)をシェープファイルに変換するものです。基本的な文は次の通りです。

pgsql2shp [<オプション>] <database> [<スキーマ>.]<table>

pgsql2shp [<オプション>] <データベース> <クエリ>

コマンドラインオプションは次の通りです。

-f <ファイル名>

特定のファイル名に出力を書きこみます。

-h <ホスト>

接続先データベースのホスト名。

-p <ポート>

接続先データベースのポート。

-P <パスワード>

データベースに接続するためのパスワード。

-u <ユーザ名>

データベースに接続する際のユーザ名。

-g <ジオメトリカラム>

複数のジオメトリカラムを持つテーブルの場合の、シェープファイルの出力に使用するジオメトリカラム。

-b

バイナリカーソルを使います。これは、実行時間を短くしますが、テーブルの非ジオメトリ属性がテキストへのキャストを持っていない場合には、動作しません。

-r

Rawモード。gidフィールドを落としたり、カラム名をエスケープしてはいけません。

-m ファイル名

識別名を10文字名に再割り当てします。 ファイルの中身は、一つの空白で区切られ、前と後に空白が無い二つのシンボルの行からなります。VERYLONGSYMBOL SHORTONE ANOTHERVERYLONGSYMBOL SHORTER等となります。

空間インデックス

インデックスによって巨大データセットの空間データベースの使用が可能となります。インデックス無しでは、地物の検索を行う際に、データベースの全てのレコードに対するシーケンシャルスキャンが必要となります。インデックスによって、レコード探索のために早く移動できる構造を構築するので、検索速度が向上します。

一般的に属性データに使われるインデックス手法でありB木は、空間データではあまり有用ではありません。1次元データの格納とクエリにだけしか対応していないためです。ジオメトリのような2次元以上の次元を持つデータでは、全ての次元の範囲を指定できるインデックス手法が求められます。PostgreSQLの空間データ処理に関する主要な利点の一つに、多次元データで上手く動作するGiST、BRIN、SP-GiSTの複数のインデックス手法を提供していることです。

GiST (Generalized Search Tree)インデックスは、データを「一方にあるもの」「オーバラップするもの」「内部にあるもの」に分解するもので、GISデータを含む幅広い範囲で使えます。PostGISはGiSTインデックス空間データをR木インデックス実装のベースにています。GiSTは最も一般的に使われ、多目的なインデックス手法で、非常に良好な問い合わせ効率を提供しています。

BRIN (Block Range Index)インデックスは、空間範囲を集計することで動作します。探索は範囲のスキャンを通して行われます。BRINは一部の種類 (空間的にソートされ、更新がほぼ無いか全く無い)のデータだけに適切です。しかし、インデックス生成時間は非所に早く、インデックスサイズは非常に小さくなります。

SP-GiST (Space-Partitioned Generalized Search Tree)は4分木、kd木、基数木 (トライ木)のような部分木探索に対応する一般的なインデックス手法です。

空間インデックスはジオメトリのバウンディングボックスだけを格納します。空間クエリはインデックスは初期フィルタとして使用して、クエリ条件に一致する可能性のあるジオメトリを早く求めます。ほとんどの空間クエリでは、空間述語関数を使って特定の空間条件をテストする二次フィルタが必要です。空間述語関数を使ったクエリの詳細情報についてはthe section called “空間インデックスを使う”をご覧下さい。

また、PostGIS Workshop section on spatial indexesとPostgreSQL manualもご覧下さい。

GiSTインデックス

GiSTは「汎用検索木 (Generalized Search Tree)」の意味で、多次元データのインデックスの一般化された形式です。PostGISはGiST上で実装しているR木インデックスをを空間データのインデックスに使用しています。GiSTは最も一般的に使われ、多目的なインデックス手法で、クエリ能率を非常に良くします。他のGiSTの実装は、通常のB木インデックスに従わない全ての種類の不規則なデータ構造 (整数配列, スペクトラルデータ等)の検索速度を向上させるために使います。詳細情報についてはPostgreSQL manualをご覧ください。

GISデータテーブルが数千行を超えたら、空間検索の速度向上のためインデックスを構築したくなるでしょう (これは属性検索でない場合です。属性でしたら通常のインデックスを属性フィールドに追加します)。

GiSTインデックスをジオメトリカラムに追加するための文は次の通りです。

CREATE INDEX [インデックス名] ON [テーブル名] USING GIST ( [ジオメトリカラム名] );

上の文では常に2次元インデックスを構築します。n次元インデックスをジオメトリ型で使うには、次の文でインデックスを生成できます。

CREATE INDEX [インデックス名] ON [テーブル名] USING GIST ( [ジオメトリカラム名] gist_geometry_ops_nd);

空間インデックスの構築は、計算量を集中させて行われます。また、この時には、テーブルへの書き込みアクセスがブロックされます。そのため、本番システムではより遅いCONCURRENTLYを選択するかも知れません。次のようにします。

CREATE INDEX CONCURRENTLY [インデックス名] ON [テーブル名] USING GIST ( [ジオメトリカラム名] );

インデックス構築後に、時々PostgreSQLにテーブルの統計情報を集めさせると助かります。クエリプランの最適化に使われます。

VACUUM ANALYZE [テーブル名] [(カラム名)];

BRINインデックス

BRINは"Block Range Index"の略です。PostgreSQL 9.5で導入された汎用インデックス手法です。BRINは不可逆インデックス手法であり、レコードが与えた検索条件に合致することを確認する二番目のチェックが必要であることを意味しています (全ての空間インデックスで言えます)。非常に速いインデックス作成、非常に小さいインデックスサイズで、合理的な読み込み効率を持ちます。主目的は、非常に大きいテーブルのテーブル内の物理位置と関係があるカラムにインデックスを作ることに対応するためです。空間インデックスに加えて、BRINは様々な種類の属性データ構造 (整数、配列等)で速度向上させることができます。詳細情報についてはPostgreSQL manualをご覧ください。

空間テーブルが、ひとたび数千行を超えると、データの空間検索の速度向上にインデックスが必要と感じることになります。GiSTインデックスは、サイズがデータベースで使えるRAM容量を超えず、インデックスのストレージサイズに余裕があり、書き込み時のインデックス更新コストにも余裕があるなら、非常に高いパフォーマンスを発揮します。そうでない場合には、非常に大きなテーブルにおいては、BRINインデックスを代替に考えることができます。

BRINインデックスは、連続するテーブルブロックの集合 (ブロック範囲と言います)の全てのジオメトリを囲むバウンディングボックスを格納します。インデックスを使用した問い合わせを実行する時に、問い合わせ範囲とインタセクトするブロック範囲を見つけるためにスキャンします。これは、データが物理的に整列していて、ブロック範囲のバウンディングボックスのオーバラップが最小である (理想的には相互に排他的である)場合に限って効率的です。結果インデックスは非常に小さいサイズですが、通常、読み込み効率は、同じデータにおけるGiSTインデックスより悪くなります。

BRINインデックスの構築は、はGiSTインデックスと比べて、CPU集中を非常に減らします。BRINインデックスはGiSTインデックスよりも、同じデータに対して10倍速く構築するのが普通です。BRINインデックスはテーブルブロックの範囲ごとに一つのバウンディングボックスしか格納しないので、GiSTインデックスと比べて、ディスクスペースを1000倍少なくできます。

レンジ内で要約するブロック数を選択できます。この数字を減らすと、インデックスは大きくなりますが、効率向上の助けになる可能性があります。

BRINを効果的にするには、テーブルデータをブロック範囲のオーバラップの量を最小にするような物理的オーダーで格納します。データが既に適切に並び替えられているかも知れません (たとえば、既に空間オーダーで並び替えられているデータセットを他のデータベースからロードする場合)。そうでない場合には、一つの空間キーによるデータの並べ替えで実現できます。一つの方法として、ジオメトリ値で並べ替えた新しいテーブルを生成することです (最近のPostGISのバージョンで効果的なヒルベルト曲線オーダーが使われています)。

CREATE TABLE table_sorted AS
   SELECT * FROM table  ORDER BY geom;

もしくは、データは、ジオハッシュを (一時的な)インデックスに使い、そのインデックスでクラスタリングを行うことによって適切に並べ替えることができます。

CREATE INDEX idx_temp_geohash ON table
    USING btree (ST_GeoHash( ST_Transform( geom, 4326 ), 20));
CLUSTER table USING idx_temp_geohash;

BRINインデックスをジオメトリカラムに追加するための文は次の通りです。

CREATE INDEX [インデックス名] ON [テーブル名] USING BRIN ( [ジオメトリカラム名] );

上の文で2次元インデックスを構築します。3次元インデックスをビルドするには、この文を使います。

CREATE INDEX [インデックス名] ON [テーブル名]
    USING BRIN ( [ジオメトリカラム名] brin_geometry_inclusion_ops_3d);

また、4次元演算子クラスを使う4次元インデックスを使うこともできます。

CREATE INDEX [インデックス名] ON [テーブル名]
    USING BRIN ( [ジオメトリカラム名] brin_geometry_inclusion_ops_4d);

上記のコマンドでは、範囲のブロック数はデフォルトの128を使用しています。集計で範囲のブロック数を指定するには、この文を使います。

CREATE INDEX [インデックス名] ON [テーブル名]
    USING BRIN ( [ジオメトリカラム名] ) WITH (pages_per_range = [数字]);

また、BRINインデックスは、多数の行で一つのインデックス値を格納することを心に留めておいて下さい。テーブルに違う次元のジオメトリを格納する場合には、インデックスの効率が悪くなります。この効率欠落を回避するには、格納したジオメトリの次元数の最小値となる演算子クラスを選択します。

「ジオグラフィ」型もまたBRINインデックスに対応しています。BRINインデックスを「ジオグラフィ」カラムに構築するための文は次の通りです。

CREATE INDEX [インデックス名] ON [テーブル名] USING BRIN ( [ジオメトリカラム名] );

上の文では常に回転楕円体面上の地理空間オブジェクトの2次元インデックスを構築します。

現在のところは「包括対応」だけをここで考えています。これは、&&, ~, @の演算子だけが2次元で使われることを意味します (ジオメトリとジオグラフィの両方)。 &&&演算子は3次元ジオメトリで使えます。しばらくはKNN検索に対応しません。

BRINと他のインデックスとの重要な違いは、データベースがインデックスを動的に保守しないことです。テーブルの空間データを変更すると、単純にインデックスの末尾に追加しています。このためインデックス探索の能率が時間とともに低下します。インデックスはVACUUMか空間関数brin_summarize_new_values(regclass)を実行することで更新できます。このため、BRINは読み込み専用か、書き込みがほとんど発生しないよなデータでの利用では最も適切になりえます。詳細情報については、manualをご覧下さい。

空間データにBRINを使用して集計するには:

インデックス構築時間は非常に速く、インデックスサイズは非常に小さいです。

インデックスのクエリ時間はGiSTより遅いですが、十分許容できます。

テーブルデータを空間順序で並べ替える必要があります。

手動でインデックスの保守をする必要があります。

巨大なテーブルであって、オーバラップが少ないか無く (ポイントなど)、かつ静的か頻繁には変更しないようなものに、最も適しています。

比較的多数のデータレコードを返すクエリでの使用が、より効果的です。

SP-GiSTインデックス

SP-GiSTは、「空間分割された一般探索木」を表します。四分木、k次元木、基数木 (トライ木)のような分割探索木に対応するインデックスの総称的な形式です。このデータ構造の一般的な機能は、検索空間を反復して分割することですが、分割は等しいサイズである必要はありません。SP-GiSTは、GISインデックスだけでなく、電話回線のルーティングや、IPルーティング、部分文字列検索等といった、様々な種類のデータを探索する速度の向上に使われます。詳細情報についてはPostgreSQL manualをご覧下さい。

GiSTインデックスを利用しているので、空間オブジェクトを覆うバウンディングボックスを保存するという意味で、SP-GiSTインデックスは不可逆です。SP-GiSTインデックスは、GiSTインデックスの代替と考えることができます。

一度GISデータテーブルが数千行を超えると、データの空間探索の速度向上にSP-GiSTインデックスを使うと良いかも知れません。「ジオメトリ」カラムにSP-GiSTインデックスを構築するための文は次の通りです。

CREATE INDEX [インデックス名] ON [テーブル名] USING SPGIST ( [ジオメトリカラム] );

上の文では、2次元インデックスを構築します。ジオメトリ型の3次元インデックスは、次のように、3次元演算子クラスを使用して生成します。

CREATE INDEX [インデックス名] ON [テーブル名] USING SPGIST ([ジオメトリカラム] spgist_geometry_ops_3d);

空間インデックスの構築は、計算量を集中させて行われます。また、この時には、テーブルへの書き込みアクセスがブロックされます。そのため、本番システムでは、より遅いCONCURRENTLYを選択するかも知れません。次のようにします。

CREATE INDEX CONCURRENTLY [インデックス名] ON [テーブル名] USING SPGIST ( [ジオメトリカラム] );

インデックス構築後に、時々PostgreSQLにテーブルの統計情報を集めさせると助かります。クエリプランの最適化に使われます。

VACUUM ANALYZE [テーブル名] [(カラム名)];

SP-GiSTインデックスは次の演算子を含むクエリの実行速度を向上させられます。

2次元インデックスについては <<, &<, &>, >>, <<|, &<|, |&>, |>>, &&, @>, <@, ~=です。

3次元インデックスについては &/&, ~==, @>>, and <<@ 。

現時点ではkNN探索に対応していません。

インデックス使用のチューニング

通常、インデックスは知らないうちにデータアクセスの速度を向上します。ひとたびインデックスを構築すれば、PostgreSQLクエリプランナは自動的にクエリの能率を向上させるために使うべきかどうかを決定します。しかし、プランナが既存のインデックスを選択せず、遅いシーケンシャルスキャンを使い続ける場合があります。

空間インデックスが使われていないのが分かった場合には、少しの行えることがあります。

クエリプランの試験とクエリの確認で、必要なものを計算できます。誤ったJOINや忘れ去られたテーブルや間違ったテーブルでは、予期しないテーブルレコード検索が複数回行われることがありえます。クエリプランを得るにはクエリの先頭にEXPLAINを付けて実行します。

テーブル内の値の数量と分布に関する統計情報を収集するとともに、クエリプランナにインデックス使用にかかる意思決定のための、より良い情報を与えるようにします。VACUUM ANALYZEは両方を計算します。

データベースに対する定期的なvacuumは常に実行するべきです。多くのPostgreSQLデータベースエージェントは、閑散時のcronジョブとして定期的にVACUUMを実行します。

VACUUMが役に立たない場合には、SET ENABLE_SEQSCAN TO OFF;コマンドを使用して、一時的にプランナにインデックス情報の使用を強制することができます。この方法で、プランナがインデックス使用を多くしたクエリプランを生成できるかどうかを確認できます。このコマンドはデバッグにのみ使用してください。一般的に言えば、プランナはインデックスを使用するタイミングをよく知っています。クエリを実行したらSET ENABLE_SEQSCAN TO ON;を実行して、他のクエリでは通常操作にすることを忘れないでください。

SET ENABLE_SEQSCAN TO OFF;でクエリ速度が向上する場合には、PostgreSQLのハードウェア関連のチューンが行われていないのかも知れません。プランナがシーケンシャル対インデックスのコストが誤っている場合には、postgresql.conf内にあるRANDOM_PAGE_COSTの値を変更してみて下さい。SET RANDOM_PAGE_COST TO 1.1;とします。RANDOM_PAGE_COSTのデフォルト値は4.0です。1.1 (SSDの場合)または2.0 (高速磁気ディスクの場合)を試してみて下さい。値を小さくするほど、プランナがインデックススキャンをしやすくなります。

SET ENABLE_SEQSCAN TO OFF;がクエリの助けにならないなら、クエリはPostgreSQLプランナがまだ最適化できないSQL構成なのかも知れません。プランナが処理できるようにクエリを再記述できるかもしれません。例えば、インラインSELECTを持つ副問い合わせがあると、効果的なプランを作らないことがあり、LATERAL JOINを使うように書き換えることができます。

詳細情報についてはPostgreSQLマニュアルの問い合わせ計画節をご覧下さい。

Chapter 5. 空間クエリ

空間データベースのレゾンデートルは、通常ならデスクトップGISの機能が必要なクエリをデータベース内で実行することです。PostGISを使うには、使用可能な空間関数は何かを知り、またクエリ内でどう使うかを知って、適切なインデックスで能率を向上させることが求められます。

空間関係の決定

空間関係は、二つのジオメトリについて、一方がもう一方にどのような相互関係になっているかを示すものです。ジオメトリのクエリにおける基本的な機能です。

Dimensionally Extended 9-Intersection Model

OpenGIS Simple Features Implementation Specification for SQLによると「二つのジオメトリの比較の基本的なアプローチは、二つのジオメトリの内部、境界、外部のインタセクションの比較と、『インタセクション行列』の要素に基づく2ジオメトリの関係の分類です」。

点集合トポロジでは、2次元空間に埋め込まれたジオメトリの中にあるポイントは、次に示す三つの集合に分類されます。

境界

ジオメトリの境界は、一次元低いジオメトリです。POINTでは、次元が0になり、境界は空集合です。LINESTRINGの境界は二つの端点です。POLYGONの境界は、外環と内環の線です。

内部 (Interior)

ジオメトリの内部は、ジオメトリの境界以外のポイントです。POINTでは、内部はポイント自体です。LINESTRINGの内部は端点の間のポイントの集合です。POLYGONの内部は、ポリゴン内部の面です。

外部 (Exterior)

ジオメトリの外部はジオメトリが組み込まれた空間の残りです。言い換えると、ジオメトリの内部にも境界にもない点の全てです。これは2次元の閉じていない面になります。

Dimensionally Extended 9-Intersection Model (DE-9IM)は、二つのジオメトリの空間関係を九つの交差の次元を指定することで記述します。交差次元は3×3の交差行列で正式に表現することができます。

ジオメトリgに対する内部、境界、外部はI(g)、B(g)、E(g)と表記します。また、dim(s)はsの集合を{0,1,2,F}の値で示すます。

0 => 点

1 => 線

2 => 面

F => 空集合

この表記法を使うと、二つのジオメトリaとbの交差行列は次の通りです。

| 内部 (Interior) | 境界 (Boundary) | 外部 (Exterior)
内部 (Interior) | dim( I(a) ∩ I(b) ) | dim( I(a) ∩ B(b) ) | dim( I(a) ∩ E(b) )
境界 (Boundary) | dim( B(a) ∩ I(b) ) | dim( B(a) ∩ B(b) ) | dim( B(a) ∩ E(b) )
外部 (Exterior) | dim( E(a) ∩ I(b) ) | dim( E(a) ∩ B(b) ) | dim( E(a) ∩ E(b) )

二つのオーバラップするポリゴンについて可視化すると、次のようになります。

内部 (Interior)
境界 (Boundary)
外部 (Exterior)

内部 (Interior)

dim( I(a) ∩ I(b) ) = 2

dim( I(a) ∩ B(b) = 1

dim( I(a) ∩ E(b) ) = 2

境界 (Boundary)

dim( B(a) ∩ I(b) ) = 1

dim( B(a) ∩ B(b) ) = 0

dim( B(a) ∩ E(b) ) = 1

外部 (Exterior)

dim( E(a) ∩ I(b) ) = 2

dim( E(a) ∩ B(b) ) = 1

dim( E(a) ∩ E(b) = 2

左から右に、上から下に読みます。交差行列の文字列表現は'212101212'です。

詳細情報については次をご覧下さい。

OpenGIS Simple Features Implementation Specification for SQL (1.1版, 2.1.13.2節)

Wikipedia: Dimensionally Extended Nine-Intersection Model (DE-9IM)

GeoTools: Point Set Theory and the DE-9IM Matrix

名前付き空間関係

共通の空間関係を簡単に決定できるように、PGC SFSは名前付き空間関係述語の集合を定義しています。PostGISではST_Contains、ST_Crosses、ST_Disjoint、ST_Equals、ST_Intersects、ST_Overlaps、ST_Touches、ST_Withinが提供されています。非標準の空間関係述語ST_Covers、ST_CoveredBy、ST_ContainsProperlyも定義されています。

空間述語は通常SQLのWHERE節やJOIN節内で条件に使用されます。名前付き空間述語は、インデックスが有効なら自動的に空間インデックスを使うので、バウンディングボックス演算子&&を使う必要はありません。例えば次のようになります。

SELECT city.name, state.name, city.geom
FROM city JOIN state ON ST_Intersects(city.geom, state.geom);

詳細や図についてはPostGIS Workshopをご覧下さい。

一般的な空間関係

名前付き空間関係が求める空間フィルタ条件を与えるのに不十分となる場合があります。

例えば、道路ネットワークを表現する線データセットを考えてみます。点でなく線で交差する全ての道路の辺を識別しなければならないことがあります (ビジネスルールの検証のためならありえます)。この場合、ST_Crossesでは、点で交差する場合しかtrueを返さないので、必要な空間フィルタになりません。

2ステップ解決法を示します。まず、空間的にインタセクトしている同路線の二本を抜き出し (ST_Intersects)、実際にインタセクトしている部分を計算 (ST_Intersection)します。次いで、インタセクトしている部分のST_GeometryTypeがLINESTRING' かどうかを確認します ([MULTI]POINT、[MULTI]LINESTRING等のGEOMETRYCOLLECTIONを返す場合に適切に処理します)。

明らかに、より単純でより速い解法が望ましいです。

二つ目の例では、湖の境界とインタセクトし、かつ終端が岸に上がっている波止場を見つけます。言い換えると、波止場が湖に含まれるが完全には含まれず、湖の境界線とインタセクトして、波止場の終端が確実に湖内または境界にある場合を指します。空間述語を併用すると求める地物を見つけることができます。

ST_Contains(lake, wharf) = TRUE

ST_ContainsProperly(lake, wharf) = FALSE

ST_GeometryType(ST_Intersection(wharf, lake)) = 'LINESTRING'

ST_NumGeometries(ST_Multi(ST_Intersection(ST_Boundary(wharf), ST_Boundary(lake)))) = 1

… 言うまでもないですが非常に複雑ですね。

この要件は完全なDE-9IM交差行列の計算で満たすことができます。PostGISは、これを行うST_Relate関数を提供しています。次のようにします。

SELECT ST_Relate( 'LINESTRING (1 1, 5 5)',
                  'POLYGON ((3 3, 3 7, 7 7, 7 3, 3 3))' );
st_relate
-----------
1010F0212

特定の空間関係をテストするには、交差行列パターンを使います。これは、追加シンボル{T,*}で拡張された行列表現です。

T => インタセクションの次元は空ではないという意味です。すなわち{0,1,2}のいずれかです。

* => 何でも良い

交差行列パターンを使って、特定の空間関係の評価がより簡潔な方法で可能です。交差行列パターンのテストにST_RelateとST_RelateMatchを使うことができます。上に挙げた一つ目の例では、二つのラインがライン内部でインタセクトする交差行列パターンは'1*1***1**'となります。

-- ライン内でインタセクトする道路区間を見つける
SELECT a.id
FROM roads a, roads b
WHERE a.id != b.id
      AND a.geom && b.geom
      AND ST_Relate(a.geom, b.geom, '1*1***1**');

二つ目の例です。一本のラインが部分的にポリゴン内部とポリゴン外部とにある場合の交差行列パターンは '102101FF2'となります。

-- 一部が湖の水涯線上にある波止場を見つける
SELECT a.lake_id, b.wharf_id
FROM lakes a, wharfs b
WHERE a.geom && b.geom
      AND ST_Relate(a.geom, b.geom, '102101FF2');

空間インデックスを使う

空間条件を使用するクエリを構築する時、最良の効果を得るには、空間インデックスが存在する場合に (the section called “空間インデックス”参照)これを確実に使用することが重要です。そのためには、WHERE節やON節で、空間演算子またはインデックス対応関数を使用しなければなりません。

空間演算子には、バウンディングボックス演算子 (最もよく使われるのは&&です。the section called “バウンディングボックス演算子”参照)、および近傍クエリで使用される距離演算子 (最もよく使われるのは<->です。the section called “距離演算子”参照)が含まれます。

インデックス対応関数は、自動的にバウンディングボックス演算子を空間条件に追加します。インデックス対応関数は空間関係述語を含みます。空間関係述語には、ST_Contains, ST_ContainsProperly, ST_CoveredBy, ST_Covers, ST_Crosses, ST_Intersects, ST_Overlaps, ST_Touches, ST_Within, ST_Within, ST_3DIntersectsがあり、距離述語にはST_DWithin, ST_DFullyWithin, ST_3DDFullyWithin, ST_3DDWithin があります。

ST_Distanceといった関数は、演算の最適化のためにはインデックスを使用しません。例えば、次のクエリは、大きなテーブルでは非常に遅くなります。

SELECT geom
FROM geom_table
WHERE ST_Distance( geom, 'SRID=312;POINT(100000 200000)' ) < 100

このクエリはgeom_tableテーブル内の、(100000, 200000)のポイントから100単位内にある全てのジオメトリを選択します。テーブル内の個々のポイントと指定したポイントとの距離を計算しているため、非常に遅くなります。すなわち、1回のST_Distance()の計算で、テーブルの全ての行について計算することになります。

インデックス対応関数ST_DWithinを使用すると、処理行数を実質的に減らすことができます。次のようにします。

SELECT geom
FROM geom_table
WHERE ST_DWithin( geom, 'SRID=312;POINT(100000 200000)', 100 )

このクエリは、同じジオメトリを選択しますが、より効率的な方法を取ります。 ST_DWithin()が内部で&&演算子をクエリジオメトリのバウンディングボックスを拡大したボックスで使うことによって可能となります。geom上に空間インデックスが存在するなら、クエリプランナは距離計算の前に対象行数を減らすためにインデックスを使えることを認識します。空間インデックスによって、バウンディングボックスが拡張された範囲とオーバラップするジオメトリだけを検索して、そのため、求めようとする距離内にあるかも知れないジオメトリを検索することができます。その後で、結果集合内のレコードを含めるかどうかを確認するための実際の距離計算が行われます。

詳細情報と例についてはPostGIS Workshopをご覧下さい。

空間SQLの例

本節の例では、線の道路のテーブルとポリゴンの市区町村境界テーブルとを使います。bc_roadsテーブルの定義は次の通りです。

Column    | Type              | Description
----------+-------------------+-------------------
gid       | integer           | Unique ID
name      | character varying | Road Name
geom      | geometry          | Location Geometry (Linestring)

bc_municipalityテーブルの定義は次の通りです。

Column   | Type              | Description
---------+-------------------+-------------------
gid      | integer           | Unique ID
code     | integer           | Unique ID
name     | character varying | City / Town Name
geom     | geometry          | Location Geometry (Polygon)

1.

道路の総延長はkm表記でいくらになるでしょう?

この問題は、次のようなとても単純なSQLで答えを得ることができます。

SELECT sum(ST_Length(geom))/1000 AS km_roads FROM bc_roads;

km_roads
------------------
70842.1243039643

2.

プリンスジョージ市の大きさはha表記でいくらになるでしょう?

このクエリでは、属性条件 (municipality name, 自治体名)に (ポリゴン面積の)空間計算を併用しています。

SELECT
  ST_Area(geom)/10000 AS hectares
FROM bc_municipality
WHERE name = 'PRINCE GEORGE';

hectares
------------------
32657.9103824927

3.

県内で最も大きな面積となる自治体はどこでしょう?

このクエリでは、順序付けの値に空間計測関数を使っています。この問題に対しては複数の方法がありますが、最も効果的な方法は次の通りです。

SELECT
  name,
  ST_Area(geom)/10000 AS hectares
FROM bc_municipality
ORDER BY hectares DESC
LIMIT 1;

name           | hectares
---------------+-----------------
TUMBLER RIDGE  | 155020.02556131

このクエリの答えを出すためには、全てのポリゴンの面積を求める必要があることに注意して下さい。このクエリを多く実行する場合、性能向上のためにテーブルにareaカラムを追加して、別のインデックスを追加することができるようにするのは、意義のあることです。結果を距離について降順に並べ替え、PostgreSQLの"LIMIT"コマンドを用いることで、max()のような集約関数を使わずに、簡単に最も大きい値を集約関数を得ることができます。

4.

各自治体内に含まれる道路の総延長はいくらでしょう?

これは、二つのテーブルからデータを持ち込んで (結合して)いるので「空間結合」の例です。しかし、結合の条件として共通キーの上で接続するという普通のリレーションのやり方でなく空間インタラクション条件 (「含む」)を使っています。

SELECT
  m.name,
  sum(ST_Length(r.geom))/1000 as roads_km
FROM bc_roads AS r
JOIN bc_municipality AS m
  ON ST_Contains(m.geom, r.geom)
GROUP BY m.name
ORDER BY roads_km;

name                        | roads_km
----------------------------+------------------
SURREY                      | 1539.47553551242
VANCOUVER                   | 1450.33093486576
LANGLEY DISTRICT            | 833.793392535662
BURNABY                     | 773.769091404338
PRINCE GEORGE               | 694.37554369147
...

このクエリは、テーブル内の全ての道路の合計を最終結果 (この例での話ですが約250Kmの道です)にまとめられるので、少し時間がかかります。より小さいオーバレイ (数百の道路で数千のレコード)の場合、応答はもっと早くなりえます。

5.

プリンスジョージ市内の全ての道路からなるテーブルを作ります。

これは「オーバレイ」の例です。つまり、二つのテーブルを取得して、空間的に切り取られた結果からなる新しいテーブルを出力します。上で示した「空間結合」と違い、このクエリは実際に新しいジオメトリを生成します。生成されたオーバレイはターボのかかった空間結合みたいなもので、より確かな解析作業に便利です。

CREATE TABLE pg_roads as
SELECT
  ST_Intersection(r.geom, m.geom) AS intersection_geom,
  ST_Length(r.geom) AS rd_orig_length,
  r.*
FROM bc_roads AS r
JOIN bc_municipality AS m
  ON ST_Intersects(r.geom, m.geom)
WHERE
  m.name = 'PRINCE GEORGE';

6.

ビクトリア州の「ダグラス通り」の長さはkm表記でいくらになるでしょう?

SELECT
  sum(ST_Length(r.geom))/1000 AS kilometers
FROM bc_roads r
JOIN bc_municipality m
  ON ST_Intersects(m.geom, r.geom
WHERE
  r.name = 'Douglas St'
  AND m.name = 'VICTORIA';

kilometers
------------------
4.89151904172838

7.

穴を持つ自治体ポリゴンのうち最も大きいのはどれでしょう?

SELECT gid, name, ST_Area(geom) AS area
FROM bc_municipality
WHERE ST_NRings(geom) > 1
ORDER BY area DESC LIMIT 1;

gid  | name         | area
-----+--------------+------------------
12   | SPALLUMCHEEN | 257374619.430216

Chapter 6. 性能向上に関する技法

大きなジオメトリを持つ小さなテーブル

問題の説明

現版のPostgreSQL (9.6を含む)では、TOASTテーブルに従うクエリオプティマイザの弱さに苦しみます。 TOASTテーブルは、(長いテキスト、イメージ、多数の頂点を持つ複合ジオメトリといった)通常のデータページに適合しない、(データサイズという意味では)巨大な値を納めるための「拡張部屋」の一種です。詳細情報は the PostgreSQL Documentation for TOASTをご覧ください。

(高解像度で全てのヨーロッパの国の境界を含むテーブルのような)大きなジオメトリがあるうえ、行がそう多くないテーブルを持つようになると、この問題が出てきます。テーブル自体は小さいのですが、多くのTOASTスペースを使います。例として、テーブル自体は概ね80行で3データページしか使わなくてもTOASTテーブルで8225ページを使うとします。

ここで、ジオメトリ演算子の&&を使って、ほとんどマッチしないようなバウンダリボックスを検索するクエリを出してみます。クエリオプティマイザにはテーブルは3ページ80行しかないように見えます。オプティマイザは、小さなテーブルを順に走査する方がインデックスを使うよりも早いと見積もります。そして、GiSTインデックスは無視すると決めます。通常なら、この見積もりは正しいです。しかし、この場合は&&演算子が全てのジオメトリをディスクから呼び出してバウンディングボックスと比較しなければならなくなり、ゆえに、全てのTOASTページもまた呼び出す必要があります。

この問題に苦しむかどうかを見るには、PostgreSQLの"EXPLAIN ANALYZE"コマンドを使います。詳細情報と技術情報については、PostgreSQL性能メーリングリストのスレッドhttp://archives.postgresql.org/pgsql-performance/2005-02/msg00030.phpをご覧下さい。

また、PostGISの新しいスレッドhttps://lists.osgeo.org/pipermail/postgis-devel/2017-June/026209.htmlもご覧下さい。

応急処置

PostgreSQLコミュニティでは、TOASTを意識したクエリ見積もりを作ることで、この問題を解決しようとしています。今のところは、二つの応急処置があります。

一つは、クエリプランナにインデックスの使用を強制することです。クエリを発行する前に"SET enable_seqscan TO off;"をサーバに送信します。これは基本的にクエリプランナに対して可能な限り順に走査することを避けるよう強制します。そのためGiSTインデックスを通常使うようになります。しかし、このフラグは接続するたびに設定しなければならず、他のケースにおいてはクエリプランナに誤った見積もりをさせることになるので、 "SET enable_seqscan TO on;"をクエリの後に送信すべきです。

もう一つは、順に走査することをクエリプランナが考える程度に早くすることです。これは、バウンダリボックスの「キャッシュ」を行う追加カラムを作成し、このカラムにマッチさせるようにすることで達成することができます。ここでの例では次のようになります。

SELECT AddGeometryColumn('myschema','mytable','bbox','4326','GEOMETRY','2');
UPDATE mytable SET bbox = ST_Envelope(ST_Force2D(geom));

そして、次のように、&&演算子をgeom_columnに対して行っていたものをbboxに変更します。

SELECT geom_column
FROM mytable
WHERE bbox && ST_SetSRID('BOX3D(0 0,1 1)'::box3d,4326);

もちろん、mytableの行を変更または追加したら、bboxを「同期」するようにしなければなりません。最もすっきりした方法はトリガです。もしくは、アプリケーションを変更してbboxカラムの現状を保持するか、テーブル更新後にいつもUPDATEクエリを実行するかでも対応できます。

ジオメトリインデックスでCLUSTERを実行する

読み込むことがほとんどで、かつほとんどのクエリでひとつのインデックスを使うようなテーブルのために、PostgreSQLはCLUSTERコマンドを提供しています。このコマンドは、全てのデータ行を、インデックス基準にあわせて物理的に再整理するので、二つの性能の利点を生みます。一つは、インデックスの範囲走査のために、データテーブルのシーク回数が劇的に減少することです。もう一つは、いくつかの小さなインデックス間隔に集中する場合には、データ行が分布するデータページがより少なくなることで、より効率的なキャッシュを持つことです (この点は、PostgreSQLマニュアルのCLUSTERコマンドのドキュメントを読むように仕向けられていると感じて下さい)。

しかし、GiSTインデックスは単純にNULL値を無視するため現在のところPostGISのGiSTインデックスのクラスタリングはできず、次のようなエラーメッセージを得ます。

lwgeom=# CLUSTER my_geom_index ON my_table;
ERROR: cannot cluster when index access method does not handle null values
(エラー: インデックスアクセスメソッドがNULL値を扱わない場合クラスタ化できません)
HINT: You may be able to work around this by marking column "geom" NOT NULL.
(ヒント: 列"the_geom"をNOT NULLとすることで、これを回避できるかもしれません)

ヒントメッセージにある通り、テーブルに"not null"制限を追加することで、この欠陥にとりあえず対応できます。例を示します。

lwgeom=# ALTER TABLE my_table ALTER COLUMN geom SET not null;
ALTER TABLE

もちろん、ジオメトリカラムで実際にNULL値が必要な場合、この対応はできません。さらには、制限を追加するには上の方法を使わなければならず、"ALTER TABLE blubb ADD CHECK (geometry is not null);"のようなCHECK制限は使えません。

次元変換の回避

ときどき、テーブルで3次元、4次元のデータを持つのに、常にOpenGIS準拠のST_AsText()またはST_AsBinary()関数を使ってアクセスして 2次元ジオメトリを出力させるようなことが起きます。内部でST_Force_2d()関数を呼んでいるために発生しますが、これは、大きなジオメトリでは重大なオーバヘッドを誘引することになります。このオーバヘッドを回避するには、一度追加された次元を前もって落とし、かつこれを永続化するのが適当かも知れません。

UPDATE mytable SET geom = ST_Force2D(geom);
VACUUM FULL ANALYZE mytable;

AddGeometryColumn()を使ってジオメトリカラムを追加した場合、ジオメトリの次元に関する制限があることに注意してください。この制限を迂回するには、制限の削除が必要になります。geometry_columnsテーブル内のエントリを更新して、その後で制限を再作成することを忘れないで下さい。

大きなテーブルの場合、WHERE節、およびプライマリキー若しくは他の適切な基準によってテーブルの一部へのUPDATEを制限させて、UPDATEの実行の間に単に"VACUUM;"と実行することで、UPDATEをより小さい塊に分割するのが賢いやり方かもしれません。これにより、テンポラリディスクスペースが劇的に減少します。さらに、次元混合のジオメトリを持つ場合、"WHERE dimension(the_geom)>2"によってUPDATEを制限することで、2次元で書かれているジオメトリの再書き込みをスキップさせることができます。

Chapter 7. PostGISリファレンス

ここで示す関数はPostGISユーザが必要とすると思われる関数です。この他に、一般的なユーザが使わないPostGISオブジェクトに対して求められるサポート関数があります。

Note

PostGISは、既存の名前付け方針からSQL-MM中心の方針への切り替えを開始しています。結果として、ユーザが知っていて愛用している関数の多くが標準空間型 (ST) プレフィクスを使うように名前変更されました。以前の関数はまだ有効ですが、更新された等価な関数があるものについては、この文書の一覧から外しています (訳注: 非推奨関数はPostGIS 2.0では基本的に外れています)。これらの関数は非推奨であり、将来のリリースでは削除されますので、*使わないでください*。

PostGIS Geometry/Geography/Box データ型

Abstract

このセクションでは、空間データを表現するためにPostGISとともにインストールされたカスタムPostgreSQLデータ型の一覧を示します。

データ型ごとに、型キャストのふるまいが記述されています。型キャストによって、あるデータ型の値が他のデータ型に変換されます。PostgreSQLでは、型を変換するために使われる関数に加えて、ユーザ定義型のキャストのふるまいの定義が可能です。キャストは自動的なふるまいを持つことができ、それによって、関数の引数をその関数が対応する型に自動的に変換できます。

キャストには明示的なふるまいがあります。このふるまいは、キャストはCAST(myval As sometype)またはmyval::sometypeという書式で指定されます。与えられた型に対応していないオーバロード関数を使うときに発生するあいまいなキャストの問題は、明示的なキャストによって回避できます。例えば、関数はbox2dまたはbox3dを受け付けるがジオメトリを受け付けない場合です。ジオメトリはボックス型の両方への自動キャストが可能なため、「あいまいな関数」エラーが発生します。このエラーを防ぐには、求められるボックス型への明示的なキャストを使用します。

全てのデータ型はtextにキャストできます。このため、明示的に指定する必要はありません。

テーブル管理関数

Abstract

これらの関数は、ジオメトリカラムを含むテーブルの定義を支援します。

Name

AddGeometryColumn — ジオメトリカラムを既存のテーブルに追加します。

Synopsis

text AddGeometryColumn( | table_name, |
| column_name, |
| srid, |
| type, |
| dimension, |
| use_typmod=true); |

varchar table_name;
varchar column_name;
integer srid;
varchar type;
integer dimension;
boolean use_typmod=true;

text AddGeometryColumn( | schema_name, |
| table_name, |
| column_name, |
| srid, |
| type, |
| dimension, |
| use_typmod=true); |

varchar schema_name;
varchar table_name;
varchar column_name;
integer srid;
varchar type;
integer dimension;
boolean use_typmod=true;

text AddGeometryColumn( | catalog_name, |
| schema_name, |
| table_name, |
| column_name, |
| srid, |
| type, |
| dimension, |
| use_typmod=true); |

varchar catalog_name;
varchar schema_name;
varchar table_name;
varchar column_name;
integer srid;
varchar type;
integer dimension;
boolean use_typmod=true;

説明

ジオメトリカラムを既存の属性テーブルに追加します。schema_nameはスキーマ名です。sridはSPATIAL_REF_SYSテーブルのエントリを参照する整数でなければなりません。typeは'POLYGON'や'MULTILINESTRING'といった、ジオメトリタイプを示す文字でなければなりません。指定したスキーマが存在しない (または現在のsearch_pathからは見えない)場合、または指定したSRID、ジオメトリタイプもしくは次元が不正である場合はエラーが投げられます。

Note

Changed: 2.0.0 geometry_columnsがシステムカタログを読むビューになったため、geometry_columnsを更新しないようになりました。デフォルトでは制約を生成せず、PostgreSQLの型修飾子を使います。この関数によるWGS 84のPOINTカラムの構築とALTER TABLE some_table ADD COLUMN geom geometry(Point,4326);とは等価です。

Changed: 2.0.0 制約を使う必要がある場合には、use_typmodをFALSEにします。

Note

Changed: 2.0.0 ビューについては、geometry_columnsへの手動登録はできなくなりました。しかし、typmodテーブルジオメトリに対して構築されていて、かつラッパ関数が無いビューは、親テーブルカラムのtypmodの挙動を継承するので、正しく登録されます。他のジオメトリを出力するジオメトリ関数を使うビューについては、ビューのジオメトリカラムが正しく登録されるようにするため、typmodジオメトリへのキャストが必要です。the section called “手動でジオメトリカラムをgeometry_columnsに登録する”を参照して下さい。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

Enhanced: 2.0.0 use_typmod引数が導入されました。デフォルトでは制約を基にしたものでなくtypmodジオメトリカラムが生成されます。

例

-- データを保持するスキーマの生成
CREATE SCHEMA my_schema;
-- 新しい単純なPostgreSQLテーブルの生成
CREATE TABLE my_schema.my_spatial_table (id serial);

-- "id"カラムのみを持つ単純なテーブルの説明
postgis=# \d my_schema.my_spatial_table
                                                         Table "my_schema.my_spatial_table"
 Column |  Type   |                                Modifiers
--------+---------+-------------------------------------------------------------------------
 id     | integer | not null default nextval('my_schema.my_spatial_table_id_seq'::regclass)

-- テーブルにジオメトリカラムを追加\
SELECT AddGeometryColumn ('my_schema','my_spatial_table','geom',4326,'POINT',2);

-- 制約を基にした古い方法でPOINTカラムを追加
SELECT AddGeometryColumn ('my_schema','my_spatial_table','geom_c',4326,'POINT',2, false);

-- 制約を基にした古い方法でCURVEPOLYGONカラムを追加
SELECT AddGeometryColumn ('my_schema','my_spatial_table','geomcp_c',4326,'CURVEPOLYGON',2, false);

-- 再度説明を表示し、新しいジオメトリカラムの追加を明らかにする
\d my_schema.my_spatial_table
                            addgeometrycolumn
-------------------------------------------------------------------------
 my_schema.my_spatial_table.geomcp_c SRID:4326 TYPE:CURVEPOLYGON DIMS:2
(1 row)

                                    Table "my_schema.my_spatial_table"
  Column  |         Type         |                                Modifiers
----------+----------------------+-------------------------------------------------------------------------
 id       | integer              | not null default nextval('my_schema.my_spatial_table_id_seq'::regclass)
 geom     | geometry(Point,4326) |
 geom_c   | geometry             |
 geomcp_c | geometry             |
Check constraints:
    "enforce_dims_geom_c" CHECK (st_ndims(geom_c) = 2)
    "enforce_dims_geomcp_c" CHECK (st_ndims(geomcp_c) = 2)
    "enforce_geotype_geom_c" CHECK (geometrytype(geom_c) = 'POINT'::text OR geom_c IS NULL)
    "enforce_geotype_geomcp_c" CHECK (geometrytype(geomcp_c) = 'CURVEPOLYGON'::text OR geomcp_c IS NULL)
    "enforce_srid_geom_c" CHECK (st_srid(geom_c) = 4326)
    "enforce_srid_geomcp_c" CHECK (st_srid(geomcp_c) = 4326)

-- geometry_columnsビューにも新しいカラムが登録されています --
SELECT f_geometry_column As col_name, type, srid, coord_dimension As ndims
    FROM geometry_columns
    WHERE f_table_name = 'my_spatial_table' AND f_table_schema = 'my_schema';

 col_name |     type     | srid | ndims
----------+--------------+------+-------
 geom     | Point        | 4326 |     2
 geom_c   | Point        | 4326 |     2
 geomcp_c | CurvePolygon | 4326 |     2

関連情報

DropGeometryColumn, DropGeometryTable, the section called “GEOMETRY_COLUMNSビュー”, the section called “手動でジオメトリカラムをgeometry_columnsに登録する”

Name

DropGeometryColumn — ジオメトリカラムを空間テーブルから除去します。

Synopsis

text DropGeometryColumn( | table_name, |
| column_name); |

varchar table_name;
varchar column_name;

text DropGeometryColumn( | schema_name, |
| table_name, |
| column_name); |

varchar schema_name;
varchar table_name;
varchar column_name;

text DropGeometryColumn( | catalog_name, |
| schema_name, |
| table_name, |
| column_name); |

varchar catalog_name;
varchar schema_name;
varchar table_name;
varchar column_name;

説明

ジオメトリカラムを空間テーブルから除去します。schema_nameはgeometry_columnsテーブルの該当行のf_table_schemaフィールドと一致しなければならないことにご注意ください。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

Note

Changed: 2.0.0 この関数は後方互換のためのものです。geometry_columnsは現在はシステムカタログに対するビューですので、他のテーブルのカラムと同じようにALTER TABLEを使った削除が可能です。

例

SELECT DropGeometryColumn ('my_schema','my_spatial_table','geom');
                        ---- 結果出力 ----
                                          dropgeometrycolumn
------------------------------------------------------
 my_schema.my_spatial_table.geom effectively removed.

-- PostGIS 2.0以上では標準的なALTER TABLEと上の例とは等価です
-- 両方ともgeometry_columnsの登録を抹消します
ALTER TABLE my_schema.my_spatial_table DROP column geom;

関連情報

AddGeometryColumn, DropGeometryTable, the section called “GEOMETRY_COLUMNSビュー”

Name

DropGeometryTable — テーブルとgeometry_columnsの当該テーブルへの参照の全てを削除します。

Synopsis

boolean DropGeometryTable(
table_name);

varchar table_name;

boolean DropGeometryTable( | schema_name, |
| table_name); |

varchar schema_name;
varchar table_name;

boolean DropGeometryTable( | catalog_name, |
| schema_name, |
| table_name); |

varchar catalog_name;
varchar schema_name;
varchar table_name;

説明

テーブルとgeometry_columnsの当該テーブルへの参照の全てを削除します。スキーマ対応版PostgreSQLではスキーマが与えられない場合はcurrent_schema()を使います。

Note

Changed: 2.0.0で この関数は後方互換のためのものです。geometry_columnsは現在はシステムカタログに対するビューですので、他のテーブルのカラムと同じようにDROP TABLEを使った削除が可能です。

例

SELECT DropGeometryTable ('my_schema','my_spatial_table');
---- 結果出力 ----
my_schema.my_spatial_table dropped.

-- 上の例は次の例と等価です --
DROP TABLE my_schema.my_spatial_table;

関連情報

AddGeometryColumn, DropGeometryColumn, the section called “GEOMETRY_COLUMNSビュー”

Name

Find_SRID — ジオメトリカラムで定義されているSRIDを返します。

Synopsis

integer Find_SRID( | a_schema_name, |
| a_table_name, |
| a_geomfield_name); |

varchar a_schema_name;
varchar a_table_name;
varchar a_geomfield_name;

説明

指定したジオメトリカラムSRID整数値をGEOMETRY_COLUMNSテーブルの探索によって返します。ジオメトリカラムが正しく追加されていない (例: AddGeometryColumn関数)場合には、この関数は動作しません。

例

SELECT Find_SRID('public', 'tiger_us_state_2007', 'geom_4269');
find_srid
----------
4269

関連情報

ST_SRID

Name

Populate_Geometry_Columns — ジオメトリカラムが型修飾子で定義されるか、適切な空間制約を持つようにします。

Synopsis

text Populate_Geometry_Columns(
use_typmod=true);

boolean use_typmod=true;

int Populate_Geometry_Columns( | relation_oid, |
| use_typmod=true); |

oid relation_oid;
boolean use_typmod=true;

説明

ジオメトリカラムが適切な型修飾子を持つか、geometry_columnsビュー内で正しく登録されていることを確実にするために空間制約を持つようにします。デフォルトでは、型修飾子を持たないすべてのジオメトリカラムを型修飾子を持つカラムに変換します。

後方互換のためと、それぞれの子テーブルが異なるジオメトリタイプを持つテーブル継承といった空間テーブルにとって必要があるためとの二つの理由から、古いCHECK制約の挙動がなお有効になっています。古い挙動が必要な場合には、新しいオプション引数でuse_typmod=falseを渡す必要があります。これが実行されると、型修飾子なしのジオメトリカラムが生成され、三つの制約が定義されます。特に、これは、テーブルに属するすべてのジオメトリカラムが少なくとも三つの制約を持つことを意味します。

enforce_dims_the_geom - あらゆるジオメトリが同じ次元を持つことを確実にします (ST_NDimsをご覧下さい)

enforce_geotype_the_geom - あらゆるジオメトリが同じ型を持つことを確実にします (GeometryTypeをご覧下さい)

enforce_srid_the_geom - あらゆるジオメトリが同じ投影法になることを確実にします (ST_SRIDをご覧下さい)

テーブルにoidがある場合には、この関数はテーブルのジオメトリカラム全てについて、SRIDと次元とジオメトリタイプを判定して、必要に応じて制約を追加しようとします。 成功した場合には、geometry_columnsに適切な行が追加され、その他の場合には、例外が捕まえられ、問題を記述したエラーが通知されます。

ビューのoidがある場合、テーブルの場合と同じで、SIRDと次元とジオメトリタイプを判定して、適切なエントリをgeometry_columnsテーブルに挿入しますが、制約の追加はされません。

パラメタの無い形式は、geometry_columnsの行を削除したうえで、全ての空間テーブルと空間ビューについて再挿入し、適切な空間制約をテーブルに追加する、パラメタ付きの形式の単純なラッパです。パラメタが無い形式は、検出したジオメトリカラムの数の要約とgeometry_columnsに挿入された行の数とを返します。パラメタ付きの形式は単純にgeometry_columnsに挿入された行の数を返します。

Availability: 1.4.0

Changed: 2.0.0 デフォルトでは、ジオメトリタイプの制限について、制約を確認する代わりに型修飾子を使います。新しいuse_typmodをFALSEに設定して使うことで、制約確認を使用することができます。

Enhanced: 2.0.0 use_typmod任意引数が導入されました。カラムが型修飾子で生成されるか制約チェックで作られるかの制御ができます。

例

CREATE TABLE public.myspatial_table(gid serial, geom geometry);
INSERT INTO myspatial_table(geom) VALUES(ST_GeomFromText('LINESTRING(1 2, 3 4)',4326) );
-- 型修飾子を使います
-- 動作するにはデータが存在していなければなりません
SELECT Populate_Geometry_Columns('public.myspatial_table'::regclass);

populate_geometry_columns
--------------------------
                        1

\d myspatial_table

                                   Table "public.myspatial_table"
 Column |           Type            |                           Modifiers
--------+---------------------------+---------------------------------------------------------------
 gid    | integer                   | not null default nextval('myspatial_table_gid_seq'::regclass)
 geom   | geometry(LineString,4326) |

-- カラムが型修飾子でないか、既に制約が存在している場合には制約を使います
-- 動作するにはデータが存在していなければなりません
CREATE TABLE public.myspatial_table_cs(gid serial, geom geometry);
INSERT INTO myspatial_table_cs(geom) VALUES(ST_GeomFromText('LINESTRING(1 2, 3 4)',4326) );
SELECT Populate_Geometry_Columns('public.myspatial_table_cs'::regclass, false);
populate_geometry_columns
--------------------------
                        1
\d myspatial_table_cs

                          Table "public.myspatial_table_cs"
 Column |   Type   |                            Modifiers
--------+----------+------------------------------------------------------------------
 gid    | integer  | not null default nextval('myspatial_table_cs_gid_seq'::regclass)
 geom   | geometry |
Check constraints:
    "enforce_dims_geom" CHECK (st_ndims(geom) = 2)
    "enforce_geotype_geom" CHECK (geometrytype(geom) = 'LINESTRING'::text OR geom IS NULL)
    "enforce_srid_geom" CHECK (st_srid(geom) = 4326)

Name

UpdateGeometrySRID — ジオメトリカラム内の全ての地物のSRIDを更新し、テーブルのメタデータを更新します。

Synopsis

text UpdateGeometrySRID( | table_name, |
| column_name, |
| srid); |

varchar table_name;
varchar column_name;
integer srid;

text UpdateGeometrySRID( | schema_name, |
| table_name, |
| column_name, |
| srid); |

varchar schema_name;
varchar table_name;
varchar column_name;
integer srid;

text UpdateGeometrySRID( | catalog_name, |
| schema_name, |
| table_name, |
| column_name, |
| srid); |

varchar catalog_name;
varchar schema_name;
varchar table_name;
varchar column_name;
integer srid;

説明

ジオメトリカラム内の全ての地物のSRIDを更新し、制約を更新し、geometry_columnsの参照を更新します。カラムが型定義で強制されているなら、型定義は変更されます。ご注意: スキーマ対応版PostgreSQLでは、スキーマが提供されていない場合には、current_schema()を使用します。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

ジオメトリを、EWKT書式を使って、SRIDを持つ道路テーブルに挿入します。

COPY roads (geom) FROM STDIN;
SRID=4326;LINESTRING(0 0, 10 10)
SRID=4326;LINESTRING(10 10, 15 0)
\.

これにより道路テーブルが、以前がどんなSRIDであっても、4326に変更されます。

SELECT UpdateGeometrySRID('roads','geom',4326);

上述の例と、次のDDL手続き (訳注: DDLはData Definition Languageの略で、データ構造の操作を行う言語を指し、この場合は CREATE TABLEやALTER TABLE等が該当します)とは同じです。

ALTER TABLE roads
  ALTER COLUMN geom TYPE geometry(MULTILINESTRING, 4326)
    USING ST_SetSRID(geom,4326);

ロードしたデータの変換座標系が誤りである (またはunknownになっている)けれどもWebメルカトルに一度の処理で変換したい場合、DDLで実行可能ですが、PostGIS管理関数では一度の処理ですむ等価なものはありません。

ALTER TABLE roads
 ALTER COLUMN geom TYPE geometry(MULTILINESTRING, 3857) USING ST_Transform(ST_SetSRID(geom,4326),3857) ;

関連情報

UpdateRasterSRID, ST_SetSRID, ST_Transform, ST_GeomFromEWKT

ジオメトリ コンストラクタ

Name

ST_Collect — ジオメトリの集合からジオメトリコレクションまたはマルチ系ジオメトリを生成します。

Synopsis

geometry ST_Collect( | g1, |
| g2); |

geometry g1;
geometry g2;

geometry ST_Collect(
g1_array);

geometry[] g1_array;

geometry ST_Collect(
g1field);

geometry set g1field;

説明

ジオメトリを集めてジオメトリコレクションにします。結果はマルチ系ジオメトリかジオメトリコレクションかのいずれかで、この差は、入力ジオメトリのタイプが同じか異なるか(均質か不均質か)で決まります。入力ジオメトリはコレクション内で変更されることはありません。

1番目の形式: 二つの入力ジオメトリを受け付ける。

2番目の形式: ジオメトリの配列を受け付ける。

3番目の形式: ジオメトリの行集合を受け付ける集約関数。

Note

入力ジオメトリのいずれかがコレクション (マルチ系ジオメトリまたはジオメトリコレクション)の場合には、ST_Collectはジオメトリコレクションを返します (入れ子になったコレクションを含む唯一のタイプであるため)。これを避けるには、サブクエリでST_Dump を使い、入力コレクションを分解できない要素にまで分解します (下に例があります)。

Note

ST_CollectとST_Unionは似ているように見えますが、実際には全く異なる処理を行います。ST_Collectは入力ジオメトリを変更せずにコレクションにする集約関数です。ST_Unionは、オーバラップしている時は幾何学的に併合し、インタセクトするところでラインストリングを分割します。境界をディゾルブするときには単一のジオメトリを返す可能性があります。

Availability: 1.4.0 - ST_Collect(geometry)が導入されました。ST_Collectがより多くのジオメトリをより早く扱えるよう強化されました。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例 - 二つ入力を引数に取る形式

2次元ポイントを収集します。

SELECT ST_AsText( ST_Collect( ST_GeomFromText('POINT(1 2)'),
        ST_GeomFromText('POINT(-2 3)') ));

st_astext
----------
MULTIPOINT((1 2),(-2 3))

2次元ポイントの収集

SELECT ST_AsEWKT( ST_Collect( ST_GeomFromEWKT('POINT(1 2 3)'),
                ST_GeomFromEWKT('POINT(1 2 4)') ) );

                st_asewkt
-------------------------
 MULTIPOINT(1 2 3,1 2 4)

曲線を収集します。

SELECT ST_AsText( ST_Collect( 'CIRCULARSTRING(220268 150415,220227 150505,220227 150406)',
                'CIRCULARSTRING(220227 150406,2220227 150407,220227 150406)'));

                st_astext
------------------------------------------------------------------------------------
MULTICURVE(CIRCULARSTRING(220268 150415,220227 150505,220227 150406),
 CIRCULARSTRING(220227 150406,2220227 150407,220227 150406))

例 - 配列を引数に取る形式

サブクエリから配列を生成するコンストラクタの使用。

SELECT ST_Collect( ARRAY( SELECT geom FROM sometable ) );

値から配列を生成するコンストラクタの使用。

SELECT ST_AsText(  ST_Collect(
                ARRAY[ ST_GeomFromText('LINESTRING(1 2, 3 4)'),
                        ST_GeomFromText('LINESTRING(3 4, 4 5)') ] )) As wktcollect;

--wkt collect --
MULTILINESTRING((1 2,3 4),(3 4,4 5))

例 - 集約関数の形式

テーブル内のジオメトリのグループ化による複数コレクションを生成します。

SELECT stusps, ST_Collect(f.geom) as geom
         FROM (SELECT stusps, (ST_Dump(geom)).geom As geom
                                FROM
                                somestatetable ) As f
        GROUP BY stusps

関連情報

ST_Dump, ST_Union

Name

ST_LineFromMultiPoint — マルチポイントジオメトリからラインストリングを生成します。

Synopsis

geometry ST_LineFromMultiPoint(
aMultiPoint);

geometry aMultiPoint;

説明

マルチポイントジオメトリからラインストリングを生成します。

ポイントまたはラインストリングの入力からラインを生成するにはST_MakeLineを使います。

説明この関数は3次元に対応し、Z値を削除しません。

例

マルチポイントジオメトリからラインストリングを生成します。

SELECT ST_AsEWKT(  ST_LineFromMultiPoint('MULTIPOINT(1 2 3, 4 5 6, 7 8 9)')  ));

-- 結果 --
LINESTRING(1 2 3,4 5 6,7 8 9)

関連情報

ST_AsEWKT, ST_MakeLine

Name

ST_MakeEnvelope — 座標値の最小値と最大値から矩形ポリゴンを生成します。

Synopsis

geometry ST_MakeEnvelope( | xmin, |
| ymin, |
| xmax, |
| ymax, |
| srid=unknown); |

float xmin;
float ymin;
float xmax;
float ymax;
integer srid=unknown;

説明

XとYの最小値と最大値から矩形ポリゴンを生成します。入力値はSRIDで指定された空間参照系に合わせなければなりません。SRIDが指定されていない場合には、不明な空間参照系 (SRID 0)が使われます。

Availability: 1.5

Enhanced: 2.0 SRID指定なしでエンベロープを指定できるようになりました。

例: バウンディングボックスポリゴンの生成

SELECT ST_AsText( ST_MakeEnvelope(10, 10, 11, 11, 4326) );

st_asewkt
-----------
POLYGON((10 10, 10 11, 11 11, 11 10, 10 10))

関連情報

ST_MakePoint, ST_MakeLine, ST_MakePolygon, ST_TileEnvelope

Name

ST_MakeLine — POINT、MULTIPOINT、LINESTRINGからLINESTRINGを生成します。

Synopsis

geometry ST_MakeLine( | geom1, |
| geom2); |

geometry geom1;
geometry geom2;

geometry ST_MakeLine(
geoms_array);

geometry[] geoms_array;

geometry ST_MakeLine(
geoms);

geometry set geoms;

説明

ポイント、マルチポイントまたはラインストリングのジオメトリの点を含むラインストリングを生成します。他のジオメトリではエラーが発生します。

1番目の形式: 二つの入力ジオメトリを受け付ける。

2番目の形式: ジオメトリの配列を受け付ける。

形式3: ジオメトリの行集合を受け付ける約関数。入力ジオメトリの順序を確実にするには、関数呼び出しでORDER BYを使うか、ORDER BY節を持つサブクエリを使います。

入力ラインストリングの開始位置で重複するノードは単一のポイントに減らされます。ポイントとマルチポイントの入力での重複するポイントは減らされません。出力ラインストリングから重複ポイントを削除するにはST_RemoveRepeatedPointsが使えます。

説明この関数は3次元に対応し、Z値を削除しません。

Availability: 2.3.0 - MULTIPOINT入力要素への対応が導入されました

Availability: 2.0.0 - LINESTRING入力要素への対応が導入されました

Availability: 1.4.0 - ST_MakeLine(geomarray)が導入されました。ST_MakeLine集約関数はより多くのポイントをより早く扱うための強化が施されています。

例: 二つ入力を引数に取る形式

二つのポイントで構成されるラインを生成します。

SELECT ST_AsText( ST_MakeLine(ST_Point(1,2), ST_Point(3,4)) );

          st_astext
---------------------
 LINESTRING(1 2,3 4)

二つの3次元ポイントから3次元ラインを生成します。

SELECT ST_AsEWKT( ST_MakeLine(ST_MakePoint(1,2,3), ST_MakePoint(3,4,5) ));

                st_asewkt
-------------------------
 LINESTRING(1 2 3,3 4 5)

二つの接続されていないラインストリングからラインを生成します。

select ST_AsText( ST_MakeLine( 'LINESTRING(0 0, 1 1)', 'LINESTRING(2 2, 3 3)' ) );

          st_astext
-----------------------------
 LINESTRING(0 0,1 1,2 2,3 3)

例: 配列を引数に取る形式

並べ替えを伴うサブクエリで作られた配列からラインを生成します。

SELECT ST_MakeLine( ARRAY( SELECT ST_Centroid(geom) FROM visit_locations ORDER BY visit_time) );

3次元ポイントの配列から3次元ラインを生成します。

SELECT ST_AsEWKT( ST_MakeLine(
          ARRAY[ ST_MakePoint(1,2,3), ST_MakePoint(3,4,5), ST_MakePoint(6,6,6) ]  ));

                st_asewkt
-------------------------
LINESTRING(1 2 3,3 4 5,6 6 6)

例: 集約関数の形式

この例ではGPSトラックの集合からポイントの時間ベースのシーケンスを問い合わせています。結果ジオメトリは、GPSトラックの移動順ポイントで構成されるラインストリングです。

ORDER BY節を使うことで、正しい順序のLINESTRINGが生成できます。

SELECT gps.track_id, ST_MakeLine(gps.geom ORDER BY gps_time) As geom
        FROM gps_points As gps
        GROUP BY track_id;

PostgreSQL 9より前の版では、サブクエリでの順序付けを使うことができます。ただし、クエリプランでサブクエリの並び順が尊重されない場合があります。

SELECT gps.track_id, ST_MakeLine(gps.geom) As geom
        FROM ( SELECT track_id, gps_time, geom
                        FROM gps_points ORDER BY track_id, gps_time ) As gps
        GROUP BY track_id;

関連情報

ST_RemoveRepeatedPoints, ST_AsEWKT, ST_AsText, ST_GeomFromText, ST_MakePoint, ST_Point

Name

ST_MakePoint — 2次元、3次元 (XYZ)、4次元のポイントを生成します。

Synopsis

geometry ST_MakePoint( | x, |
| y); |

float x;
float y;

geometry ST_MakePoint( | x, |
| y, |
| z); |

float x;
float y;
float z;

geometry ST_MakePoint( | x, |
| y, |
| z, |
| m); |

float x;
float y;
float z;
float m;

説明

2次元、3次元 (XYZ)、4次元 (XYZM)のポイントを生成します。

XYM座標を持つポイントを作るにはST_MakePointMを使います。

OGC準拠ではありませんが、ST_MakePointはST_GeomFromTextやST_PointFromTextより高速かつ正確です。また、簡単に数値の座標値を使用できます。

Note

地理座標系について、Xは経度で、Yは緯度です。

説明この関数は3次元に対応し、Z値を削除しません。

例

-- SRID不明のポイントを返します
SELECT ST_MakePoint(-71.1043443253471, 42.3150676015829);

-- WGS 84経度緯度とするポイントを返します。
SELECT ST_SetSRID(ST_MakePoint(-71.1043443253471, 42.3150676015829),4326);

-- 3次元ポイント (たとえば標高を持つ)を返します
SELECT ST_MakePoint(1, 2,1.5);

-- ポイントのZ値を得ます
SELECT ST_Z(ST_MakePoint(1, 2,1.5));
result
-------
1.5

関連情報

ST_GeomFromText, ST_PointFromText, ST_SetSRID, ST_MakePointM

Name

ST_MakePointM — X, Y, M値からポイントを生成します。

Synopsis

geometry ST_MakePointM( | x, |
| y, |
| m); |

float x;
float y;
float m;

説明

X, Y, M (Measure) 値からポイントを生成します。

XY, XYZ, XYZM座標のポイントを作るにはST_MakePointを使います。

Note

地理座標系について、Xは経度で、Yは緯度です。

例

Note

ST_AsEWKT は文字列出力のために使います。ST_AsTextがM値に対応していないためです。

不明なSRIDでのポイントを生成します。

SELECT ST_AsEWKT(  ST_MakePointM(-71.1043443253471, 42.3150676015829, 10)  );

                                   st_asewkt
-----------------------------------------------
 POINTM(-71.1043443253471 42.3150676015829 10)

WGS 84地理座標系のM値を持つポイントの生成。

SELECT ST_AsEWKT( ST_SetSRID(  ST_MakePointM(-71.104, 42.315, 10),  4326));

                                                st_asewkt
---------------------------------------------------------
SRID=4326;POINTM(-71.104 42.315 10)

生成したポイントのM値を取得します。

SELECT ST_M(  ST_MakePointM(-71.104, 42.315, 10)  );

result
-------
10

関連情報

ST_AsEWKT, ST_MakePoint, ST_SetSRID

Name

ST_MakePolygon — 外殻と穴のリストからポリゴンを生成します。

Synopsis

geometry ST_MakePolygon(
linestring);

geometry linestring;

geometry ST_MakePolygon( | outerlinestring, |
| interiorlinestrings); |

geometry outerlinestring;
geometry[] interiorlinestrings;

説明

与えられた外殻と任意指定の穴の配列で掲載されるポリゴンを生成します。入力ジオメトリは閉じたラインストリング (リング)でなければなりません。

形式1: 一つの外殻のラインストリングを受け付けます。

形式2: 外殻のラインストリングと内部 (穴)のラインストリングの配列とを受け付けます。ジオメトリ配列はPostgreSQLのarray_agg(), ARRAY[], ARRAY()コンストラクタを使います。

Note

この関数はマルチラインストリングを受け付けません。ラインストリングの生成にはST_LineMergeを使用します。また、ラインストリングを抽出するにはST_Dumpを使用します。

説明この関数は3次元に対応し、Z値を削除しません。

例: 単一入力の形式

2次元ラインストリングからポリゴンを生成します。

SELECT ST_MakePolygon( ST_GeomFromText('LINESTRING(75 29,77 29,77 29, 75 29)'));

開いたラインストリングを閉じるためにST_StartPointとST_AddPointを使用したうえでポリゴンを生成します。

SELECT ST_MakePolygon( ST_AddPoint(foo.open_line, ST_StartPoint(foo.open_line)) )
FROM (
  SELECT ST_GeomFromText('LINESTRING(75 29,77 29,77 29, 75 29)') As open_line) As foo;

3次元ラインストリングからポリゴンを生成します。

SELECT ST_AsEWKT( ST_MakePolygon( 'LINESTRING(75.15 29.53 1,77 29 1,77.6 29.5 1, 75.15 29.53 1)'));

st_asewkt
-----------
POLYGON((75.15 29.53 1,77 29 1,77.6 29.5 1,75.15 29.53 1))

M値を持つラインストリングからポリゴンを生成します。

SELECT ST_AsEWKT( ST_MakePolygon( 'LINESTRINGM(75.15 29.53 1,77 29 1,77.6 29.5 2, 75.15 29.53 2)' ));

st_asewkt
----------
POLYGONM((75.15 29.53 1,77 29 1,77.6 29.5 2,75.15 29.53 2))

例: 内部の穴を持つ外殻の形式

余分な穴を持つドーナツポリゴンを生成します。

SELECT ST_MakePolygon( ST_ExteriorRing( ST_Buffer(ring.line,10)),
        ARRAY[  ST_Translate(ring.line, 1, 1),
                ST_ExteriorRing(ST_Buffer(ST_Point(20,20),1)) ]
        )
FROM (SELECT ST_ExteriorRing(
        ST_Buffer(ST_Point(10,10),10,10)) AS line ) AS ring;

湖を表現する穴を持つ県の境界の集合を生成します。入力は県ポリゴン/マルチポリゴンのテーブルと水涯線のラインストリングのテーブルです。湖を構成するラインはST_IsClosedで判定します。県を示すラインはST_Boundaryで抽出します。ST_MakePolygonが必要ですので、境界をST_LineMergeで単一のLINESTRINGに強制します(県が二つ以上の領域を持つか島を持つ場合には、不正なポリゴンを生成します)。LEFT JOINを使って、湖の無い県を含む全ての県が返ることを保証しています。

Note

NULL配列をST_MakePolygonに渡すとNULLが返るので、CASE式を使っています。

SELECT p.gid, p.province_name,
        CASE WHEN array_agg(w.geom) IS NULL
        THEN p.geom
        ELSE  ST_MakePolygon( ST_LineMerge(ST_Boundary(p.geom)),
                        array_agg(w.geom)) END
FROM
        provinces p LEFT JOIN waterlines w
                ON (ST_Within(w.geom, p.geom) AND ST_IsClosed(w.geom))
GROUP BY p.gid, p.province_name, p.geom;

他には、相関サブクエリと行集合を配列に変換するARRAY()コンストラクタとを使う手法があります。

SELECT p.gid,  p.province_name,
    CASE WHEN EXISTS( SELECT w.geom
        FROM waterlines w
        WHERE ST_Within(w.geom, p.geom)
        AND ST_IsClosed(w.geom))
    THEN ST_MakePolygon(
        ST_LineMerge(ST_Boundary(p.geom)),
        ARRAY( SELECT w.geom
            FROM waterlines w
            WHERE ST_Within(w.geom, p.geom)
            AND ST_IsClosed(w.geom)))
    ELSE p.geom
    END AS geom
FROM provinces p;

関連情報

ST_BuildArea ST_Polygon

Name

ST_Point — X, YとSRIDの値からポイントを生成します。

Synopsis

geometry ST_Point( | x, |
| y); |

float x;
float y;

geometry ST_Point( | x, |
| y, |
| srid=unknown); |

float x;
float y;
integer srid=unknown;

説明

与えられたXとYの座標値からポイントを返します。これは、XとYを取るSQL-MMのST_MakePointと同等です。

Note

地理座標系について、Xは経度で、Yは緯度です。

Enhanced: 3.2.0 SRID任意引数が追加されました。古いバージョンでは、ジオメトリにSRIDを与えるにはST_SetSRIDを併用しなければなりませんでした。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 6.1.2

例: ジオメトリ

SELECT ST_Point( -71.104, 42.315);

SELECT ST_SetSRID(ST_Point( -71.104, 42.315),4326);

New in 3.2.0: SRIDが指定できます

SELECT ST_Point( -71.104, 42.315, 4326);

例: ジオグラフィ

PostGIS 3.2より前の構文

SELECT CAST( ST_SetSRID(ST_Point( -71.104, 42.315), 4326) AS geography);

3.2ではSRIDを含むことができます

SELECT CAST( ST_Point( -71.104, 42.315, 4326) AS geography);

PostgreSQLはキャストの簡略表記として::を提供しています

SELECT ST_Point( -71.104, 42.315, 4326)::geography;

ポイントの座標が地理座標系 (WGS84等)でない場合には、ジオグラフィにキャストする前に座標系変換を行う必要があります。この例では、ペンシルバニア州平面フィート (SRID 2273)上のポイントをWGS84 (SRID 4326)に座標系変換を行っています。

SELECT ST_Transform(ST_SetSRID( ST_Point( 3637510, 3014852 ), 2273), 4326)::geography;

関連情報

the section called “ジオグラフィデータタイプ”, ST_MakePoint, ST_SetSRID, ST_Transform, ST_PointZ, ST_PointM, ST_PointZM

Name

ST_PointZ — X, Y, ZとSRIDの値からポイントを生成します。

Synopsis

geometry ST_PointZ( | x, |
| y, |
| z, |
| srid=unknown); |

float x;
float y;
float z;
integer srid=unknown;

説明

与えたX,Y,Z座標値を持ち、与えた場合はSRID値も持つポイントを生成します。

Enhanced: 3.2.0 SRID任意引数が追加されました。古いバージョンでは、ジオメトリにSRIDを与えるにはST_SetSRIDを併用しなければなりませんでした。

例

SELECT ST_PointZ(-71.104, 42.315, 3.4, 4326)

SELECT ST_PointZ(-71.104, 42.315, 3.4, srid =
> 4326)

SELECT ST_PointZ(-71.104, 42.315, 3.4)

関連情報

ST_MakePoint, ST_Point, ST_PointM, ST_PointZM

Name

ST_PointM — X, Y, MとSRIDの値からポイントを生成します。

Synopsis

geometry ST_PointM( | x, |
| y, |
| m, |
| srid=unknown); |

float x;
float y;
float m;
integer srid=unknown;

説明

与えたX,Y,M座標値を持ち、与えた場合はSRID値も持つポイントを生成します。

Enhanced: 3.2.0 SRID任意引数が追加されました。古いバージョンでは、ジオメトリにSRIDを与えるにはST_SetSRIDを併用しなければなりませんでした。

例

SELECT ST_PointM(-71.104, 42.315, 3.4, 4326)

SELECT ST_PointM(-71.104, 42.315, 3.4, srid =
> 4326)

SELECT ST_PointM(-71.104, 42.315, 3.4)

関連情報

ST_MakePoint, ST_Point, ST_PointZ, ST_PointZM

Name

ST_PointZM — X, Y, Z, MとSRIDの値からポイントを生成します。

Synopsis

geometry ST_PointZM( | x, |
| y, |
| z, |
| m, |
| srid=unknown); |

float x;
float y;
float z;
float m;
integer srid=unknown;

説明

与えたX,Y,Z,M座標値を持ち、与えた場合はSRID値も持つポイントを生成します。

Enhanced: 3.2.0 SRID任意引数が追加されました。古いバージョンでは、ジオメトリにSRIDを与えるにはST_SetSRIDを併用しなければなりませんでした。

例

SELECT ST_PointZM(-71.104, 42.315, 3.4, 4.5, 4326)

SELECT ST_PointZM(-71.104, 42.315, 3.4, 4.5, srid =
> 4326)

SELECT ST_PointZM(-71.104, 42.315, 3.4, 4.5)

関連情報

ST_MakePoint, ST_Point, ST_PointM, ST_PointZ, ST_SetSRID

Name

ST_Polygon — ラインストリングから指定したSRIDを持つポリゴンを生成します。

Synopsis

geometry ST_Polygon( | lineString, |
| srid); |

geometry lineString;
integer srid;

説明

与えられたラインストリングから構築し、sridから空間参照系を指定したポリゴンを返します。

ST_PolygonはST_MakePolygonの形式1の、SRIDの設定を追加したものに似ています。

穴を持つポリゴンを生成するには、ST_MakePolygonの形式2を使い、ST_SetSRIDを使います。

Note

この関数はマルチラインストリングを受け付けません。ラインストリングの生成にはST_LineMergeを使用します。また、ラインストリングを抽出するにはST_Dumpを使用します。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 8.3.2

説明この関数は3次元に対応し、Z値を削除しません。

例

2次元ポリゴンを生成します。

SELECT ST_AsText( ST_Polygon('LINESTRING(75 29, 77 29, 77 29, 75 29)'::geometry, 4326) );

-- 結果 --
POLYGON((75 29, 77 29, 77 29, 75 29))

3次元ポリゴンを生成します。

SELECT ST_AsEWKT( ST_Polygon( ST_GeomFromEWKT('LINESTRING(75 29 1, 77 29 2, 77 29 3, 75 29 1)'), 4326) );

-- 結果 --
SRID=4326;POLYGON((75 29 1, 77 29 2, 77 29 3, 75 29 1))

関連情報

ST_AsEWKT, ST_AsText, ST_GeomFromEWKT, ST_GeomFromText, ST_LineMerge, ST_MakePolygon

Name

ST_TileEnvelope — Webメルカトル (SRID:3857)上で XYZタイルを使った矩形ポリゴンを生成します。

Synopsis

geometry ST_TileEnvelope( | tileZoom, |
| tileX, |
| tileY, |
| bounds=SRID=3857;LINESTRING(-20037508.342789 -20037508.342789,20037508.342789 20037508.342789), |
| margin=0.0); |

integer tileZoom;
integer tileX;
integer tileY;
geometry bounds=SRID=3857;LINESTRING(-20037508.342789 -20037508.342789,20037508.342789 20037508.342789);
float margin=0.0;

説明

XYZ tile systemでのタイルの範囲を示す長方形ポリゴンを生成します。タイルはズームレベルを示すZと、そのレベルでのタイルインデックスを示すX, Yで指定します。ST_AsMVTGeomでジオメトリをMVTタイルの座標空間に変換のために必要なタイル境界を定義するために使います。

デフォルトでは、タイルエンベロープの座標系はWeb Mercator (SRID: 3857)で、標準的なウェブメルカトルの範囲 (-20037508.342789, 20037508.342789)を取ります。これがMVTタイルで使用される最も標準的な座標系です。任意パラメータboundsを使うと、あらゆる座標系のタイルを生成することができます。SRIDを持ち、ズームレベル0の時の、ジオメトリのXYZタイルシステムが内側に存在する矩形を示すジオメトリを与えます。

任意パラメータmarginは、タイルを与えられた割合だけ拡張するために使います。たとえばmargin=0.125と指定すると、12.5%拡張します。これは、ST_AsMVTGeomで使われている、タイルサイズが4096の時にbuffer=512と指定するのと等価です。タイル表示領域の外側にバッファを生成するために使いますが、この範囲はタイル描画に影響を与えます。たとえば、市名 (ポイント)を一つのタイルの端付近にあっても、そのラベルが二つのタイルで描画されるべきです。拡張したタイルをクエリで使うと、両方のタイルに市名のポイントが含まれることになります。負数を指定すると反対に縮小します。-0.5より小さい値は、タイルを完全に消すことになるので、許可されません。ST_AsMVTGeomと併用する時はマージンを指定しないでください。ST_AsMVTの例をご覧下さい。

Enhanced: 3.1.0 marginパラメータが追加されました。

Availability: 3.0.0

例: タイルエンベロープの構築

SELECT ST_AsText( ST_TileEnvelope(2, 1, 1) );

 st_astext
------------------------------
 POLYGON((-10018754.1713945 0,-10018754.1713945 10018754.1713945,0 10018754.1713945,0 0,-10018754.1713945 0))

SELECT ST_AsText( ST_TileEnvelope(3, 1, 1, ST_MakeEnvelope(-180, -90, 180, 90, 4326) ) );

                      st_astext
------------------------------------------------------
 POLYGON((-135 45,-135 67.5,-90 67.5,-90 45,-135 45))

関連情報

ST_MakeEnvelope

Name

ST_HexagonGrid — 引数ジオメトリの境界を完全にカバーする六角形とセルインデックスを返します。

Synopsis

setof record ST_HexagonGrid( | size, |
| bounds); |

float8 size;
geometry bounds;

説明

平面の六角形タイルの概念から始まります。(地球の六角形タイルではなくH3タイルスキーマではありません)。平面 SRS とエッジサイズを与えると、SRS の原点から始まり、平面の一意な六角形のタイル、すなわち Tiling(SRS, Size)が一つ存在します。この関数は、指定されたTiling(SRS, Size)内の六角形が指定された境界を覆っているかどうかという質問に答えます。

出力六角形のSRSは境界ジオメトリのSRSです。

六角形の辺の長さを2倍または3倍にすることで、元のタイルに適合する新しい親タイルが生成されます。残念ながら子タイルが完全に親タイルの中に入るような親六角形タイルを生成することはできません。

Availability: 3.1.0

例: 六角形の中の点を数え上げる

六角形タイリングに対してポイントをまとめるには、ポイントの範囲を境界として使って六角形グリッドを生成し、グリッドに空間的に結合します。

SELECT COUNT(*), hexes.geom
FROM
    ST_HexagonGrid(
        10000,
        ST_SetSRID(ST_EstimatedExtent('pointtable', 'geom'), 3857)
    ) AS hexes
    INNER JOIN
    pointtable AS pts
    ON ST_Intersects(pts.geom, hexes.geom)
GROUP BY hexes.geom;

例: ポリゴンの六角形カバレッジの生成

ポリゴン境界ごとに六角形の集合を生成し、六角形とインタセクトしないものを除外すると、ポリゴンごとのタイルとなります。

州のタイルは、それぞれの州の六角形のカバレッジとなり、複数の六角形が州境界で重なります。

Note

LATERALキーワードは、FROMリスト内の、対象より前のテーブルを参照する時は、集合を返す関数に暗黙的に含まれます。 CROSS JOIN LATERAL、CROSS JOIN、指定なし、は、この例の同じ構成要素です。

SELECT admin1.gid, hex.geom
FROM
    admin1
    CROSS JOIN
    ST_HexagonGrid(100000, admin1.geom) AS hex
WHERE
    adm0_a3 = 'USA'
    AND
    ST_Intersects(admin1.geom, hex.geom)

関連情報

ST_EstimatedExtent, ST_SetSRID, ST_SquareGrid, ST_TileEnvelope

Name

ST_Hexagon — 与えられたエッジサイズと六角形グリッド空間内のセル座標を使って単一の六角形を返します。

Synopsis

geometry ST_Hexagon( | size, |
| cell_i, |
| cell_j, |
| origin); |

float8 size;
integer cell_i;
integer cell_j;
geometry origin;

説明

ST_HexagonGridと同じ六角形タイルの概念を使いますが、求めるセルの座標に一つだけの六角形を生成します。任意でタイルの原点の座標を調整できます。デフォルトの原点座標は0,0です。

六角形はSRIDの設定なしで生成されるので、SRIDを期待する値に設定するためにST_SetSRIDを使います。

Availability: 3.1.0

例: 原点で六角形の生成

SELECT ST_AsText(ST_SetSRID(ST_Hexagon(1.0, 0, 0), 3857));

POLYGON((-1 0,-0.5
         -0.866025403784439,0.5
         -0.866025403784439,1
         0,0.5
         0.866025403784439,-0.5
         0.866025403784439,-1 0))

関連情報

ST_TileEnvelope, ST_HexagonGrid, ST_Square

Name

ST_SquareGrid — 引数ジオメトリの境界を完全にカバーするグリッド正方形とセルインデックスを返します。

Synopsis

setof record ST_SquareGrid( | size, |
| bounds); |

float8 size;
geometry bounds;

説明

平面の正方形タイルの概念から始まります。与えられた平面SRSとエッジサイズに対して、SRS原点から始まり、一意の平面の正方形タイル(SRS, Size)が一つ存在します。この関数は、与えられたタイル(SRS, Size)内のグリッド内のどのタイルが与えられた境界とオーバラップするかという問題に答えを出します。

出力正方形のSRSは境界ジオメトリのSRSです。

正方形の2倍またはエッジサイズによって、新しい親タイルが生成されます。親タイルは完全に元のタイルに適合します。標準のウェブマップにおけるメルカトルのタイルは、メルカトル平面の2の累乗での正方形です。

Availability: 3.1.0

例: 国の1度グリッドの生成

グリッドは国の境界全体を埋めます。国に接触する四角形が欲しい場合には、ST_Intersects後にフィルタリングする必要があります。

WITH grid AS (
SELECT (ST_SquareGrid(1, ST_Transform(geom,4326))).*
FROM admin0 WHERE name = 'Canada'
)
  SELEcT ST_AsText(geom)
  FROM grid

例: 正方形内のポイントの数え上げ (細かくした単一のグリッドを使用)

正方形タイルのポイントのサマリを行うには、境界としてポイントの拡張を使った正方形グリッドを生成し、グリッドに空間的に結合します。推定範囲は実際の範囲と異なる場合があるのでご注意下さい。慎重に取り扱うようにし、最低でも確実にテーブルを解析して下さい。

SELECT COUNT(*), squares.geom
    FROM
    pointtable AS pts
    INNER JOIN
    ST_SquareGrid(
        1000,
        ST_SetSRID(ST_EstimatedExtent('pointtable', 'geom'), 3857)
    ) AS squares
    ON ST_Intersects(pts.geom, squares.geom)
    GROUP BY squares.geom

例: ポイントごとのグリッドの集合を使った正方形内のポイント数え上げ

これは最初の例と同じ結果になりますが、ポイント数が多くなると遅くなります。

SELECT COUNT(*), squares.geom
    FROM
    pointtable AS pts
    INNER JOIN
    ST_SquareGrid(
        1000,
       pts.geom
    ) AS squares
    ON ST_Intersects(pts.geom, squares.geom)
    GROUP BY squares.geom

関連情報

ST_TileEnvelope, ST_HexagonGrid , ST_EstimatedExtent , ST_SetSRID

Name

ST_Square — 与えられたエッジサイズと六角形グリッド空間内のセル座標を使って単一の正方形を返します。

Synopsis

geometry ST_Square( | size, |
| cell_i, |
| cell_j, |
| origin); |

float8 size;
integer cell_i;
integer cell_j;
geometry origin;

説明

ST_SquareGridと同じ正方形タイルの概念を使っていますが、求めるセルの座標に一つだけの正方形を生成します。任意でタイルの原点の座標を調整できます。デフォルトの原点座標は0,0です。

四角形はSRIDの設定なしで生成されるので、SRIDを期待する値に設定するためにST_SetSRIDを使います。

Availability: 3.1.0

例: 原点で四角形の生成

SELECT ST_AsText(ST_SetSRID(ST_Square(1.0, 0, 0), 3857));

 POLYGON((0 0,0 1,1 1,1 0,0 0))

関連情報

ST_TileEnvelope, ST_SquareGrid, ST_Hexagon

Name

ST_Letters — デフォルトの開始位置を原点とし、デフォルトの高さを100とする、ジオメトリとして描画された文字を返します。

Synopsis

geometry ST_Letters( | letters, |
| font); |

text letters;
json font;

説明

組込みフォントを使って、出力文字列をマルチポリゴンとして描画します。ディセンダからキャピタルまでの文字高さは100.0です。デフォルトのベースラインの開始位置は原点に置かれます。フォントのオーバライドは文字をキーとしたJSONマッピングと、ディセンダからキャピタルまでの1000単位の高さを持つフォント形状のTWKBをbase64エンコードしたものを渡します。

テキストは、デフォルトでは原点に生成されるので、テキストの位置変更とサイズ変更とを行います。最初にST_Scale関数を適用し、その後ST_Translate関数を適用します。

Availability: 3.3.0

例: 単語'Yo'の生成

SELECT ST_AsText(ST_Letters('Yo'), 1);

ST_Letterで生成した文字

例: 単語の拡大と移動

SELECT ST_Translate(ST_Scale(ST_Letters('Yo'), 10, 10), 100,100);

関連情報

ST_AsTWKB, ST_Scale, ST_Translate

ジオメトリアクセサ

Name

GeometryType — ジオメトリのタイプを文字列で返します。

Synopsis

text GeometryType(
geomA);

geometry geomA;

説明

ジオメトリ型を'LINESTRING', 'POLYGON', 'MULTIPOINT'などの文字列で返します。

OGC SPEC s2.1.1.1 - このジオメトリインスタンスがメンバーになっているジオメトリのインスタンス化可能な派生タイプの名前を返します。インスタンス化可能な派生タイプの名前は、文字列として返されます。

Note

この関数は、'POINTM'等が返るので、ジオメトリがM値を持っているかどうかも示します。

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

SELECT GeometryType(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)'));
 geometrytype
--------------
 LINESTRING

SELECT ST_GeometryType(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
                ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
                ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
                ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'));
                        -- 結果 --
                        POLYHEDRALSURFACE

SELECT GeometryType(geom) as result
  FROM
    (SELECT
       ST_GeomFromEWKT('TIN (((
                0 0 0,
                0 0 1,
                0 1 0,
                0 0 0
            )), ((
                0 0 0,
                0 1 0,
                1 1 0,
                0 0 0
            ))
            )')  AS geom
    ) AS g;
 result
--------
 TIN

関連情報

ST_GeometryType

Name

ST_Boundary — ジオメトリの境界を返します。

Synopsis

geometry ST_Boundary(
geomA);

geometry geomA;

説明

ジオメトリの組み合わせ境界の閉包を返します (訳注: ラインストリングは端点、ポリゴンはエッジ、複合オブジェクトは境界のうち奇数番)。組み合わせ境界はOGC仕様の3.12.3.2節に記述されています。結果として出てくる境界は、OGC SPEC 3.12.2で議論されているように、ジオメトリプリミティブを使って表現できます。

GEOSモジュールで実現しています。

Note

2.0.0より前の版では、この関数はGEOMETRYCOLLECTION.を与えると例外を投げました。2.0.0以上では代わりにNULLが返ります (非対応入力)。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 OGC SPEC s2.1.1.1

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 5.1.17

説明この関数は3次元に対応し、Z値を削除しません。

Enhanced: 2.1.0 三角対応が導入されました。

Changed: 3.2.0 TINに対応しました。GEOSを使いません。曲線を線形化しません。

例

境界ポイントを重ねたラインストリング

SELECT ST_Boundary(geom)
FROM (SELECT 'LINESTRING(100 150,50 60, 70 80, 160 170)'::geometry As geom) As f;

ST_AsText output

MULTIPOINT((100 150),(160 170))

境界マルチラインストリングを重ねたポリゴンの穴

SELECT ST_Boundary(geom)
FROM (SELECT
'POLYGON (( 10 130, 50 190, 110 190, 140 150, 150 80, 100 10, 20 40, 10 130 ),
        ( 70 40, 100 50, 120 80, 80 110, 50 90, 70 40 ))'::geometry As geom) As f;

ST_AsText output

MULTILINESTRING((10 130,50 190,110 190,140 150,150 80,100 10,20 40,10 130),
        (70 40,100 50,120 80,80 110,50 90,70 40))

SELECT ST_AsText(ST_Boundary(ST_GeomFromText('LINESTRING(1 1,0 0, -1 1)')));
st_astext
-----------
MULTIPOINT((1 1),(-1 1))

SELECT ST_AsText(ST_Boundary(ST_GeomFromText('POLYGON((1 1,0 0, -1 1, 1 1))')));
st_astext
----------
LINESTRING(1 1,0 0,-1 1,1 1)

-- 3次元ポリゴンの使用
SELECT ST_AsEWKT(ST_Boundary(ST_GeomFromEWKT('POLYGON((1 1 1,0 0 1, -1 1 1, 1 1 1))')));

st_asewkt
-----------------------------------
LINESTRING(1 1 1,0 0 1,-1 1 1,1 1 1)

-- 3次元ラインストリングの使用
SELECT ST_AsEWKT(ST_Boundary(ST_GeomFromEWKT('MULTILINESTRING((1 1 1,0 0 0.5, -1 1 1),(1 1 0.5,0 0 0.5, -1 1 0.5, 1 1 0.5) )')));

st_asewkt
----------
MULTIPOINT((-1 1 1),(1 1 0.75))

関連情報

ST_AsText, ST_ExteriorRing, ST_MakePolygon

Name

ST_BoundingDiagonal — ジオメトリのバウンディングボックスの対角線を返します。

Synopsis

geometry ST_BoundingDiagonal( | geom, |
| fits=false); |

geometry geom;
boolean fits=false;

説明

与えられたジオメトリのバウンディングボックスの対角線をラインストリングで返します。最小値のポイントを始点とし、最大値のポイントを終点とする、二つのポイントからなるラインストリングになります。入力ジオメトリが空の場合には、対角線はLINESTRING EMPTYとなります。

fitsパラメータは、最良適合が必要かどうかを指定するものです。FALSEの場合には、幾分大きめなバウンディングボックスの対角線を受け付けることができます (多数の頂点からなるジオメトリの取得が早くなります)。いずれにしても返された対角線のバウンディングボックスは常に入力ジオメトリを含みます。

返されるラインストリングは常に、入力ジオメトリのSRIDと次元 (ZとMがあること)を維持します。

Note

縮退した (入力の頂点が一つ)場合、返されるラインストリングは形式的に不正です (内部が無い)。トポロジ的には妥当です。

Availability: 2.2.0

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数はM値に対応します。

例

-- ポイントまわりのバッファのXの最小値を得ます
SELECT ST_X(ST_StartPoint(ST_BoundingDiagonal(
  ST_Buffer(ST_Point(0,0),10)
)));
 st_x
------
  -10

関連情報

ST_StartPoint, ST_EndPoint, ST_X, ST_Y, ST_Z, ST_M, ST_Envelope

Name

ST_CoordDim — ジオメトリの座標次元を返します。

Synopsis

integer ST_CoordDim(
geomA);

geometry geomA;

説明

ST_Geometry値の座標次元を返します。

この関数はST_NDimsのMM対応の別名です。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.3

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

SELECT ST_CoordDim('CIRCULARSTRING(1 2 3, 1 3 4, 5 6 7, 8 9 10, 11 12 13)');
                        -- 結果 --
                                3

                                SELECT ST_CoordDim(ST_Point(1,2));
                        -- 結果 --
                                2

関連情報

ST_NDims

Name

ST_Dimension — ST_Geometry値の座標次元を返します。

Synopsis

integer ST_Dimension(
g);

geometry g;

説明

ジオメトリの固有次元を返します。ジオメトリは座標次元以下でなければなりません。OGC SPEC s2.1.1.1 - 0ならPOINT、1ならLINESTRING、2ならPOLYGONで、GEOMETRYCOLLECTIONの場合は要素ごとの次元の最大値です。不明なジオメトリ (空のGEOMETRYCOLLECTION等)の場合はNULLが返ります。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.2

Enhanced: 2.0.0 多面体サーフェス対応とTIN対応が導入されました。空ジオメトリを与えた場合に例外を投げなくなりました。

Note

2.0.0より前では、空ジオメトリを与えると例外を投げていました。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

SELECT ST_Dimension('GEOMETRYCOLLECTION(LINESTRING(1 1,0 0),POINT(0 0))');
ST_Dimension
-----------
1

関連情報

ST_NDims

Name

ST_Dump — ジオメトリの要素となるgeometry_dump行の集合を返します。

Synopsis

geometry_dump[] ST_Dump(
g1);

geometry g1;

説明

ジオメトリ要素を抽出する、集合を返す関数 (SRF=Set-Returning Function)です。ジオメトリ (geomフィールド)と整数配列 (pathフィールド)からなるgeometry_dump行の集合を返します。

非マルチ系ジオメトリタイプ (POINT,LINESTRING,POLYGON)では、path配列が空でgeomが入力ジオメトリと同じになる単一の行が返ります。コレクションまたはマルチ系ジオメトリでは、個々の要素と、コレクションの要素位置を示すpathとからなる行を返します。

ST_Dumpはジオメトリを展開するのに使います。ST_Collect/GROUP BYの逆で、この関数の中で新行を作成します。たとえば、MULTIPOLYGONをPOLYGONに展開するために使います。

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。

Availability: PostGIS 1.0.0RC1。PostgreSQL 7.3以上が必要です。

Note

1.3.4より前では、曲線を含むジオメトリで使用すると、この関数はクラッシュします。これは1.3.4以上で訂正されています。

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

標準的な例

SELECT sometable.field1, sometable.field1,
      (ST_Dump(sometable.geom)).geom AS geom
FROM sometable;

-- 複合曲線をラインストリングと曲線ストリングに分解
SELECT ST_AsEWKT(a.geom), ST_HasArc(a.geom)
  FROM ( SELECT (ST_Dump(p_geom)).geom AS geom
         FROM (SELECT ST_GeomFromEWKT('COMPOUNDCURVE(CIRCULARSTRING(0 0, 1 1, 1 0),(1 0, 0 1))') AS p_geom) AS b
        ) AS a;
          st_asewkt          | st_hasarc
-----------------------------+----------
 CIRCULARSTRING(0 0,1 1,1 0) | t
 LINESTRING(1 0,0 1)         | f
(2 rows)

多面体サーフェス、TIN、三角形の例

-- 多面体サーフェスの例
-- 多面体サーフェスをフェイスに分解します。
SELECT (a.p_geom).path[1] As path, ST_AsEWKT((a.p_geom).geom) As geom_ewkt
  FROM (SELECT ST_Dump(ST_GeomFromEWKT('POLYHEDRALSURFACE(
((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),  ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)),  ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1))
)') ) AS p_geom )  AS a;

 path |                geom_ewkt
------+------------------------------------------
    1 | POLYGON((0 0 0,0 0 1,0 1 1,0 1 0,0 0 0))
    2 | POLYGON((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0))
    3 | POLYGON((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0))
    4 | POLYGON((1 1 0,1 1 1,1 0 1,1 0 0,1 1 0))
    5 | POLYGON((0 1 0,0 1 1,1 1 1,1 1 0,0 1 0))
    6 | POLYGON((0 0 1,1 0 1,1 1 1,0 1 1,0 0 1))

-- TIN --
SELECT (g.gdump).path, ST_AsEWKT((g.gdump).geom) as wkt
  FROM
    (SELECT
       ST_Dump( ST_GeomFromEWKT('TIN (((
                0 0 0,
                0 0 1,
                0 1 0,
                0 0 0
            )), ((
                0 0 0,
                0 1 0,
                1 1 0,
                0 0 0
            ))
            )') ) AS gdump
    ) AS g;
-- result --
 path |                 wkt
------+-------------------------------------
 {1}  | TRIANGLE((0 0 0,0 0 1,0 1 0,0 0 0))
 {2}  | TRIANGLE((0 0 0,0 1 0,1 1 0,0 0 0))

関連情報

geometry_dump, the section called “PostGISジオメトリ/ジオグラフィ/ラスタのダンプ関数”, ST_Collect, ST_GeometryN

Name

ST_DumpPoints — ジオメトリ内の座標の行であるgeometry_dump行の集合を返します。

Synopsis

geometry_dump[] ST_DumpPoints(
geom);

geometry geom;

説明

ジオメトリの座標 (頂点)を抽出する、集合を返す関数 (SRF=Set-Returning Function)です。ジオメトリ (geomフィールド)と整数配列 (pathフィールド)からなるgeometry_dump行の集合を返します。

geomフィールドには、与えられたジオメトリの座標を表現するPOINTが入ります。

pathフィールド (integer[])は、与えられたジオメトリの要素内の座標位置を列挙するインデックスです。インデックスは1始まりです。たとえば、LINESTRINGに対しては、LINESTRINGのn番目の座標をiとすると、{i}となります。POLYGONに対しては、iを環番号 (1が外環、続いて内環)、jを環の座標位置とすると、{i,j}となります。

座業を含む単一ジオメトリを取得するにはST_Pointsを使います。

Enhanced: 2.1.0 速度向上しました。C言語で実装しなおしました。

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。

Availability: 1.5.0

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

ラインストリングのテーブルのノードへの古典的な分割

SELECT edge_id, (dp).path[1] As index, ST_AsText((dp).geom) As wktnode
FROM (SELECT 1 As edge_id
        , ST_DumpPoints(ST_GeomFromText('LINESTRING(1 2, 3 4, 10 10)')) AS dp
     UNION ALL
     SELECT 2 As edge_id
        , ST_DumpPoints(ST_GeomFromText('LINESTRING(3 5, 5 6, 9 10)')) AS dp
   ) As foo;
 edge_id | index |    wktnode
---------+-------+--------------
       1 |     1 | POINT(1 2)
       1 |     2 | POINT(3 4)
       1 |     3 | POINT(10 10)
       2 |     1 | POINT(3 5)
       2 |     2 | POINT(5 6)
       2 |     3 | POINT(9 10)

標準的な例

SELECT path, ST_AsText(geom)
FROM (
  SELECT (ST_DumpPoints(g.geom)).*
  FROM
    (SELECT
       'GEOMETRYCOLLECTION(
          POINT ( 0 1 ),
          LINESTRING ( 0 3, 3 4 ),
          POLYGON (( 2 0, 2 3, 0 2, 2 0 )),
          POLYGON (( 3 0, 3 3, 6 3, 6 0, 3 0 ),
                   ( 5 1, 4 2, 5 2, 5 1 )),
          MULTIPOLYGON (
                  (( 0 5, 0 8, 4 8, 4 5, 0 5 ),
                   ( 1 6, 3 6, 2 7, 1 6 )),
                  (( 5 4, 5 8, 6 7, 5 4 ))
          )
        )'::geometry AS geom
    ) AS g
  ) j;

   path    | st_astext
-----------+------------
 {1,1}     | POINT(0 1)
 {2,1}     | POINT(0 3)
 {2,2}     | POINT(3 4)
 {3,1,1}   | POINT(2 0)
 {3,1,2}   | POINT(2 3)
 {3,1,3}   | POINT(0 2)
 {3,1,4}   | POINT(2 0)
 {4,1,1}   | POINT(3 0)
 {4,1,2}   | POINT(3 3)
 {4,1,3}   | POINT(6 3)
 {4,1,4}   | POINT(6 0)
 {4,1,5}   | POINT(3 0)
 {4,2,1}   | POINT(5 1)
 {4,2,2}   | POINT(4 2)
 {4,2,3}   | POINT(5 2)
 {4,2,4}   | POINT(5 1)
 {5,1,1,1} | POINT(0 5)
 {5,1,1,2} | POINT(0 8)
 {5,1,1,3} | POINT(4 8)
 {5,1,1,4} | POINT(4 5)
 {5,1,1,5} | POINT(0 5)
 {5,1,2,1} | POINT(1 6)
 {5,1,2,2} | POINT(3 6)
 {5,1,2,3} | POINT(2 7)
 {5,1,2,4} | POINT(1 6)
 {5,2,1,1} | POINT(5 4)
 {5,2,1,2} | POINT(5 8)
 {5,2,1,3} | POINT(6 7)
 {5,2,1,4} | POINT(5 4)
(29 rows)

多面体サーフェス、TIN、三角形の例

-- 多面体サーフェスの立方体 --
SELECT (g.gdump).path, ST_AsEWKT((g.gdump).geom) as wkt
  FROM
    (SELECT
       ST_DumpPoints(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )') ) AS gdump
    ) AS g;
-- 結果 --
  path   |     wkt
---------+--------------
 {1,1,1} | POINT(0 0 0)
 {1,1,2} | POINT(0 0 1)
 {1,1,3} | POINT(0 1 1)
 {1,1,4} | POINT(0 1 0)
 {1,1,5} | POINT(0 0 0)
 {2,1,1} | POINT(0 0 0)
 {2,1,2} | POINT(0 1 0)
 {2,1,3} | POINT(1 1 0)
 {2,1,4} | POINT(1 0 0)
 {2,1,5} | POINT(0 0 0)
 {3,1,1} | POINT(0 0 0)
 {3,1,2} | POINT(1 0 0)
 {3,1,3} | POINT(1 0 1)
 {3,1,4} | POINT(0 0 1)
 {3,1,5} | POINT(0 0 0)
 {4,1,1} | POINT(1 1 0)
 {4,1,2} | POINT(1 1 1)
 {4,1,3} | POINT(1 0 1)
 {4,1,4} | POINT(1 0 0)
 {4,1,5} | POINT(1 1 0)
 {5,1,1} | POINT(0 1 0)
 {5,1,2} | POINT(0 1 1)
 {5,1,3} | POINT(1 1 1)
 {5,1,4} | POINT(1 1 0)
 {5,1,5} | POINT(0 1 0)
 {6,1,1} | POINT(0 0 1)
 {6,1,2} | POINT(1 0 1)
 {6,1,3} | POINT(1 1 1)
 {6,1,4} | POINT(0 1 1)
 {6,1,5} | POINT(0 0 1)
(30 rows)

-- Triangle --
SELECT (g.gdump).path, ST_AsText((g.gdump).geom) as wkt
  FROM
    (SELECT
       ST_DumpPoints( ST_GeomFromEWKT('TRIANGLE ((
                0 0,
                0 9,
                9 0,
                0 0
            ))') ) AS gdump
    ) AS g;
-- 結果 --
 path |    wkt
------+------------
 {1}  | POINT(0 0)
 {2}  | POINT(0 9)
 {3}  | POINT(9 0)
 {4}  | POINT(0 0)

-- TIN --
SELECT (g.gdump).path, ST_AsEWKT((g.gdump).geom) as wkt
  FROM
    (SELECT
       ST_DumpPoints( ST_GeomFromEWKT('TIN (((
                0 0 0,
                0 0 1,
                0 1 0,
                0 0 0
            )), ((
                0 0 0,
                0 1 0,
                1 1 0,
                0 0 0
            ))
            )') ) AS gdump
    ) AS g;
-- 結果 --
  path   |     wkt
---------+--------------
 {1,1,1} | POINT(0 0 0)
 {1,1,2} | POINT(0 0 1)
 {1,1,3} | POINT(0 1 0)
 {1,1,4} | POINT(0 0 0)
 {2,1,1} | POINT(0 0 0)
 {2,1,2} | POINT(0 1 0)
 {2,1,3} | POINT(1 1 0)
 {2,1,4} | POINT(0 0 0)
(8 rows)

関連情報

geometry_dump, the section called “PostGISジオメトリ/ジオグラフィ/ラスタのダンプ関数”, ST_Dump, ST_DumpRings, ST_Points

Name

ST_DumpSegments — ジオメトリ内の辺の行であるgeometry_dump行の集合を返します。

Synopsis

geometry_dump[] ST_DumpSegments(
geom);

geometry geom;

説明

ジオメトリの辺を抽出する、集合を返す関数 (SRF=Set-Returning Function)です。ジオメトリ (geomフィールド)と整数配列 (pathフィールド)からなるgeometry_dump行の集合を返します。

geomフィールドには、与えられたジオメトリの辺を表現するLINESTRINGが入ります。

pathフィールド (integer[])は、与えられたジオメトリの要素内の辺の始点位置を列挙するインデックスです。インデックスは1始まりです。たとえば、LINESTRINGに対しては、LINESTRINGのn番目の辺をiとすると、{i}となります。POLYGONに対しては、iを環番号 (1が外環、続いて内環)、jを環の辺の始点位置とすると、{i,j}となります。

Availability: 3.2.0

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

標準的な例

SELECT path, ST_AsText(geom)
FROM (
    SELECT (ST_DumpSegments(g.geom)).*
    FROM (SELECT 'GEOMETRYCOLLECTION(
    LINESTRING(1 1, 3 3, 4 4),
    POLYGON((5 5, 6 6, 7 7, 5 5))
)'::geometry AS geom
        ) AS g
) j;

  path   │      st_astext
---------------------------------
 {1,1}   │ LINESTRING(1 1,3 3)
 {1,2}   │ LINESTRING(3 3,4 4)
 {2,1,1} │ LINESTRING(5 5,6 6)
 {2,1,2} │ LINESTRING(6 6,7 7)
 {2,1,3} │ LINESTRING(7 7,5 5)
(5 rows)

TIN、三角形の例

-- 三角形 --
SELECT path, ST_AsText(geom)
FROM (
    SELECT (ST_DumpSegments(g.geom)).*
    FROM (SELECT 'TRIANGLE((
        0 0,
        0 9,
        9 0,
        0 0
    ))'::geometry AS geom
        ) AS g
) j;

 path  │      st_astext
 ---------------------------------
 {1,1} │ LINESTRING(0 0,0 9)
 {1,2} │ LINESTRING(0 9,9 0)
 {1,3} │ LINESTRING(9 0,0 0)
(3 rows)

-- TIN --
SELECT path, ST_AsEWKT(geom)
FROM (
    SELECT (ST_DumpSegments(g.geom)).*
    FROM (SELECT 'TIN(((
        0 0 0,
        0 0 1,
        0 1 0,
        0 0 0
    )), ((
        0 0 0,
        0 1 0,
        1 1 0,
        0 0 0
    ))
    )'::geometry AS geom
        ) AS g
) j;

  path   │        st_asewkt
  ---------------------------------
 {1,1,1} │ LINESTRING(0 0 0,0 0 1)
 {1,1,2} │ LINESTRING(0 0 1,0 1 0)
 {1,1,3} │ LINESTRING(0 1 0,0 0 0)
 {2,1,1} │ LINESTRING(0 0 0,0 1 0)
 {2,1,2} │ LINESTRING(0 1 0,1 1 0)
 {2,1,3} │ LINESTRING(1 1 0,0 0 0)
(6 rows)

関連情報

geometry_dump, the section called “PostGISジオメトリ/ジオグラフィ/ラスタのダンプ関数”, ST_Dump, ST_DumpRings

Name

ST_DumpRings — ポリゴンのリングごとのgeometry_dump行の集合を返します。

Synopsis

geometry_dump[] ST_DumpRings(
a_polygon);

geometry a_polygon;

説明

ジオメトリ要素を抽出する、集合を返す関数 (SRF=Set-Returning Function)です。ジオメトリ (geomフィールド)と整数配列 (pathフィールド)からなるgeometry_dump行の集合を返します。

ジオメトリ要素を抽出する、集合を返す関数 (SRF=Set-Returning Function)です。ジオメトリ (geomフィールド)と整数配列 (pathフィールド)からなるgeometry_dump行の集合を返します。

Note

POLYGONジオメトリでのみ動作します。MULTIPOLYGONでは動作しません。

Availability: PostGIS 1.1.3 PostgreSQL 7.3以上が必要です。

説明この関数は3次元に対応し、Z値を削除しません。

例

クエリの一般的な形式。

SELECT polyTable.field1, polyTable.field1,
          (ST_DumpRings(polyTable.geom)).geom As geom
FROM polyTable;

単一の穴を持つポリゴン

SELECT path, ST_AsEWKT(geom) As geom
        FROM ST_DumpRings(
                ST_GeomFromEWKT('POLYGON((-8149064 5133092 1,-8149064 5132986 1,-8148996 5132839 1,-8148972 5132767 1,-8148958 5132508 1,-8148941 5132466 1,-8148924 5132394 1,
                -8148903 5132210 1,-8148930 5131967 1,-8148992 5131978 1,-8149237 5132093 1,-8149404 5132211 1,-8149647 5132310 1,-8149757 5132394 1,
                -8150305 5132788 1,-8149064 5133092 1),
                (-8149362 5132394 1,-8149446 5132501 1,-8149548 5132597 1,-8149695 5132675 1,-8149362 5132394 1))')
                )  as foo;
 path |                                            geom
----------------------------------------------------------------------------------------------------------------
  {0} | POLYGON((-8149064 5133092 1,-8149064 5132986 1,-8148996 5132839 1,-8148972 5132767 1,-8148958 5132508 1,
          |          -8148941 5132466 1,-8148924 5132394 1,
          |          -8148903 5132210 1,-8148930 5131967 1,
          |          -8148992 5131978 1,-8149237 5132093 1,
          |          -8149404 5132211 1,-8149647 5132310 1,-8149757 5132394 1,-8150305 5132788 1,-8149064 5133092 1))
  {1} | POLYGON((-8149362 5132394 1,-8149446 5132501 1,
          |          -8149548 5132597 1,-8149695 5132675 1,-8149362 5132394 1))

関連情報

geometry_dump, the section called “PostGISジオメトリ/ジオグラフィ/ラスタのダンプ関数”, ST_Dump, ST_ExteriorRing, ST_InteriorRingN

Name

ST_EndPoint — LINESTRINGまたはCIRCULARLINESTRINGの終端のポイントを返します。

Synopsis

geometry ST_EndPoint(
g);

geometry g;

説明

LINESTRINGまたはCIRCULARLINESTRINGジオメトリの、最後のポイントをPOINTで返します。入力パラメータがLINESTRINGでもCIRCULARLINESTRINGでもない場合には、NULLを返します。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.1.4

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

Note

Changed: 2.0.0 一つのジオメトリマルチラインストリングで動作しなくなりました。PostGIS の古いバージョンでは、この関数は一つのマルチラインストリングで動作し、終端ポイントを返します。2.0.0では、他のマルチラインストリングと同様にNULLを返します。古い動作は文書化されていない機能でしたが、データをLINESTRINGとして格納していると思われるユーザーは、2.0.0 でNULLが返されることを経験するかも知れません。

例

ラインストリングの終端ポイント

postgis=# SELECT ST_AsText(ST_EndPoint('LINESTRING(1 1, 2 2, 3 3)'::geometry));
 st_astext
------------
 POINT(3 3)

ラインストリング以外の終端ポイントはNULL

SELECT ST_EndPoint('POINT(1 1)'::geometry) IS NULL AS is_null;
  is_null
----------
 t

3次元ラインストリングの終端ポイント

-- 3次元終端ポイント
SELECT ST_AsEWKT(ST_EndPoint('LINESTRING(1 1 2, 1 2 3, 0 0 5)'));
  st_asewkt
--------------
 POINT(0 0 5)

CIRCULARSTRINGの終端ポイント

SELECT ST_AsText(ST_EndPoint('CIRCULARSTRING(5 2,-3 1.999999, -2 1, -4 2, 6 3)'::geometry));
 st_astext
------------
 POINT(6 3)

関連情報

ST_PointN, ST_StartPoint

Name

ST_Envelope — ジオメトリのバウンディングボックスを表現するジオメトリを返します。

Synopsis

geometry ST_Envelope(
g1);

geometry g1;

説明

与えられたジオメトリの倍精度浮動小数点数 (float8)の最小バウンディングボックスをジオメトリで返します。ポリゴンはバウンディングボックスの角のポイントで定義されます ((MINX, MINY), (MINX, MAXY), (MAXX, MAXY), (MAXX, MINY), (MINX, MINY))。(PostGISはZMIN/ZMAXも追加します).

縮退する場合 (縦のライン、ポイント)はPOLYGONより低い次元のジオメトリ、すなわちPOINTまたはLINESTRINGを返します。

Availability: 1.5.0 挙動が変更され出力がfloat4からfloat8になりました。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.1

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.19

例

SELECT ST_AsText(ST_Envelope('POINT(1 3)'::geometry));
 st_astext
------------
 POINT(1 3)
(1 row)

SELECT ST_AsText(ST_Envelope('LINESTRING(0 0, 1 3)'::geometry));
                   st_astext
--------------------------------
 POLYGON((0 0,0 3,1 3,1 0,0 0))
(1 row)

SELECT ST_AsText(ST_Envelope('POLYGON((0 0, 0 1, 1.0000001 1, 1.0000001 0, 0 0))'::geometry));
                                                  st_astext
--------------------------------------------------------------
 POLYGON((0 0,0 1,1.00000011920929 1,1.00000011920929 0,0 0))
(1 row)
SELECT ST_AsText(ST_Envelope('POLYGON((0 0, 0 1, 1.0000000001 1, 1.0000000001 0, 0 0))'::geometry));
                                                  st_astext
--------------------------------------------------------------
 POLYGON((0 0,0 1,1.00000011920929 1,1.00000011920929 0,0 0))
(1 row)

SELECT Box3D(geom), Box2D(geom), ST_AsText(ST_Envelope(geom)) As envelopewkt
        FROM (SELECT 'POLYGON((0 0, 0 1000012333334.34545678, 1.0000001 1, 1.0000001 0, 0 0))'::geometry As geom) As foo;

ポイントとラインストリングの最小バウンディングボックス

SELECT ST_AsText(ST_Envelope(
                ST_Collect(
                        ST_GeomFromText('LINESTRING(55 75,125 150)'),
                                ST_Point(20, 80))
                                )) As wktenv;
wktenv
-----------
POLYGON((20 75,20 150,125 150,125 75,20 75))

関連情報

Box2D, Box3D, ST_OrientedEnvelope

Name

ST_ExteriorRing — ポリゴンの外環を表現するラインストリングを返します。

Synopsis

geometry ST_ExteriorRing(
a_polygon);

geometry a_polygon;

説明

POLYGONの外環を表現するLINESTRINGを返します。ジオメトリがポリゴンでない場合はNULLを返します。

Note

この関数はマルチポリゴンでは動作しません。マルチポリゴンに対してはST_GeometryNまたはST_Dumpを併用して下さい。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 2.1.5.1

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 8.2.3, 8.3.3

説明この関数は3次元に対応し、Z値を削除しません。

例

-- ポリゴンのテーブルを持っているとします
SELECT gid, ST_ExteriorRing(geom) AS ering
FROM sometable;

-- マルチポリゴンのテーブルを持っていて、
-- それぞれのポリゴンの外環からなるマルチラインストリングを返させたいとします。
SELECT gid, ST_Collect(ST_ExteriorRing(geom)) AS erings
        FROM (SELECT gid, (ST_Dump(geom)).geom As geom
                        FROM sometable) As foo
GROUP BY gid;

-- 3次元の例
SELECT ST_AsEWKT(
        ST_ExteriorRing(
        ST_GeomFromEWKT('POLYGON((0 0 1, 1 1 1, 1 2 1, 1 1 1, 0 0 1))')
        )
);

st_asewkt
---------
LINESTRING(0 0 1,1 1 1,1 2 1,1 1 1,0 0 1)

関連情報

ST_InteriorRingN, ST_Boundary, ST_NumInteriorRings

Name

ST_GeometryN — ジオメトリコレクションの要素を一つ返します。

Synopsis

geometry ST_GeometryN( | geomA, |
| n); |

geometry geomA;
integer n;

説明

GEOMETRYCOLLECTION, MULTIPOINT, MULTILINESTRING, MULTICURVE, MULTIPOLYGON, POLYHEDRALSURFACEの入力ジオメトリの、1始まりでN番目の要素を返します。他の場合にはNULLを返します。

Note

OGC仕様のため0.8.0版からインデクスを1始まりにしています。これより前の版では0始まりになっています。

Note

ジオメトリの全ての要素を抽出するにはST_Dumpの方が効率的ですし、単一ジオメトリでも動作します。

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。

Changed: 2.0.0 以前の版では非マルチのジオメトリではNULLが返りました。ST_GeometryN(..,1)の場合にはジオメトリを返すよう変更されました。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 9.1.5

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

標準的な例

-- 3次元マルチポイントから部分集合を抽出
SELECT n, ST_AsEWKT(ST_GeometryN(the_geom, n)) As geomewkt
FROM (
VALUES (ST_GeomFromEWKT('MULTIPOINT(1 2 7, 3 4 7, 5 6 7, 8 9 10)') ),
( ST_GeomFromEWKT('MULTICURVE(CIRCULARSTRING(2.5 2.5,4.5 2.5, 3.5 3.5), (10 11, 12 11))') )
        )As foo(the_geom)
        CROSS JOIN generate_series(1,100) n
WHERE n <= ST_NumGeometries(the_geom);

 n |               geomewkt
---+-----------------------------------------
 1 | POINT(1 2 7)
 2 | POINT(3 4 7)
 3 | POINT(5 6 7)
 4 | POINT(8 9 10)
 1 | CIRCULARSTRING(2.5 2.5,4.5 2.5,3.5 3.5)
 2 | LINESTRING(10 11,12 11)

-- 全てのジオメトリを抽出(idを付けたい場合に便利です)
SELECT gid, n, ST_GeometryN(the_geom, n)
FROM sometable CROSS JOIN generate_series(1,100) n
WHERE n <= ST_NumGeometries(the_geom);

多面体サーフェス、TIN、三角形の例

-- 多面体サーフェスの例
-- 多面体サーフェスをフェイスに分解します。
SELECT ST_AsEWKT(ST_GeometryN(p_geom,3)) As geom_ewkt
  FROM (SELECT ST_GeomFromEWKT('POLYHEDRALSURFACE(
((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)),
((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)),
((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1))
)')  AS p_geom )  AS a;

                geom_ewkt
------------------------------------------
 POLYGON((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0))

-- TIN --
SELECT ST_AsEWKT(ST_GeometryN(geom,2)) as wkt
  FROM
    (SELECT
       ST_GeomFromEWKT('TIN (((
                0 0 0,
                0 0 1,
                0 1 0,
                0 0 0
            )), ((
                0 0 0,
                0 1 0,
                1 1 0,
                0 0 0
            ))
            )')  AS geom
    ) AS g;
-- 結果--
                 wkt
-------------------------------------
 TRIANGLE((0 0 0,0 1 0,1 1 0,0 0 0))

関連情報

ST_Dump, ST_NumGeometries

Name

ST_GeometryType — ジオメトリのSQL-MM型を文字列で返します。

Synopsis

text ST_GeometryType(
g1);

geometry g1;

説明

ジオメトリ型を'ST_LineString', 'ST_Polygon', 'ST_MultiPolygon'等の文字列で返します。この関数はGeometryType(geometry)とは異なり、先頭に'ST'が付き、M値を持っているかを示しません。

Enhanced: 2.0.0 多面体サーフェス対応が導入されました。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.4

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

例

SELECT ST_GeometryType(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)'));
                        -- 結果
                        ST_LineString

SELECT ST_GeometryType(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
                ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
                ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
                ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'));
                        --結果 --
                        ST_PolyhedralSurface

SELECT ST_GeometryType(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
                ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
                ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
                ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'));
                        --結果 --
                        ST_PolyhedralSurface

SELECT ST_GeometryType(geom) as result
  FROM
    (SELECT
       ST_GeomFromEWKT('TIN (((
                0 0 0,
                0 0 1,
                0 1 0,
                0 0 0
            )), ((
                0 0 0,
                0 1 0,
                1 1 0,
                0 0 0
            ))
            )')  AS geom
    ) AS g;
 result
--------
 ST_Tin

関連情報

GeometryType

Name

ST_HasArc — ジオメトリに円弧が含まれているかどうかテストします。

Synopsis

boolean ST_HasArc(
geomA);

geometry geomA;

説明

ジオメトリまたはジオメトリコレクションに曲線ラインストリングが含まれている場合にTRUEを返します。

Availability: 1.2.3?

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

SELECT ST_HasArc(ST_Collect('LINESTRING(1 2, 3 4, 5 6)', 'CIRCULARSTRING(1 1, 2 3, 4 5, 6 7, 5 6)'));
                st_hasarc
                --------
                t

関連情報

ST_CurveToLine, ST_LineToCurve

Name

ST_InteriorRingN — ポリゴンのN番目の内環 (穴)を返します。

Synopsis

geometry ST_InteriorRingN( | a_polygon, |
| n); |

geometry a_polygon;
integer n;

説明

ポリゴンのN番目の内環を返します。ジオメトリがポリゴンでないかNが範囲外の場合はNULLを返します。

Note

この関数はマルチポリゴンでは動作しません。マルチポリゴンに対してはST_GeometryNまたはST_Dumpを併用して下さい。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 8.2.6, 8.3.5

説明この関数は3次元に対応し、Z値を削除しません。

例

SELECT ST_AsText(ST_InteriorRingN(geom, 1)) As geom
FROM (SELECT ST_BuildArea(
                ST_Collect(ST_Buffer(ST_Point(1,2), 20,3),
                        ST_Buffer(ST_Point(1, 2), 10,3))) As geom
                )  as foo;

関連情報

ST_ExteriorRing, ST_BuildArea, ST_Collect, ST_Dump, ST_NumInteriorRing, ST_NumInteriorRings

Name

ST_IsClosed — ラインストリングの始点と終点が一致しているかをテストします。多面体サーフェスについては閉じているか (立体であるか)をテストします。

Synopsis

boolean ST_IsClosed(
g);

geometry g;

説明

LINESTRINGの始点と終点が一致する場合にTRUEを返します。多面体サーフェスについては、サーフェスが面 (開いている)か立体 (閉じている)かをテストします。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.1.5, 9.3.3

Note

SQL-MMではST_IsClosed(NULL)は0を返しますが、PostGISではNULLを返します。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

Enhanced: 2.0.0 多面体サーフェス対応が導入されました。

説明この関数は多面体サーフェスに対応しています。

ラインストリングとポイントの例

postgis=# SELECT ST_IsClosed('LINESTRING(0 0, 1 1)'::geometry);
 st_isclosed
-------------
 f
(1 row)

postgis=# SELECT ST_IsClosed('LINESTRING(0 0, 0 1, 1 1, 0 0)'::geometry);
 st_isclosed
-------------
 t
(1 row)

postgis=# SELECT ST_IsClosed('MULTILINESTRING((0 0, 0 1, 1 1, 0 0),(0 0, 1 1))'::geometry);
 st_isclosed
-------------
 f
(1 row)

postgis=# SELECT ST_IsClosed('POINT(0 0)'::geometry);
 st_isclosed
-------------
 t
(1 row)

postgis=# SELECT ST_IsClosed('MULTIPOINT((0 0), (1 1))'::geometry);
 st_isclosed
-------------
 t
(1 row)

多面体サーフェスの例

-- 立方体 --
                SELECT ST_IsClosed(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
                ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
                ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
                ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'));

 st_isclosed
-------------
 t

 -- 立方体のようなものだけれども側面が一つ無いもの--
 SELECT ST_IsClosed(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
                ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
                ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
                ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)) )'));

 st_isclosed
-------------
 f

関連情報

ST_IsRing

Name

ST_IsCollection — ジオメトリのタイプがジオメトリコレクションかをテストします。

Synopsis

boolean ST_IsCollection(
g);

geometry g;

説明

ジオメトリのタイプがジオメトリコレクションである場合にTRUEを返します。コレクションは次の通りです。

ジオメトリコレクション

マルチポイント、マルチポリゴン、マルチラインストリング、マルチ曲線、マルチサーフェス

複合曲線

Note

この関数はジオメトリのタイプを解析します。これは、空のコレクションである場合、または一つのエレメントを持つコレクションである場合にはTRUEを返すことを意味します。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

postgis=# SELECT ST_IsCollection('LINESTRING(0 0, 1 1)'::geometry);
 st_iscollection
-------------
 f
(1 row)

postgis=# SELECT ST_IsCollection('MULTIPOINT EMPTY'::geometry);
 st_iscollection
-------------
 t
(1 row)

postgis=# SELECT ST_IsCollection('MULTIPOINT((0 0))'::geometry);
 st_iscollection
-------------
 t
(1 row)

postgis=# SELECT ST_IsCollection('MULTIPOINT((0 0), (42 42))'::geometry);
 st_iscollection
-------------
 t
(1 row)

postgis=# SELECT ST_IsCollection('GEOMETRYCOLLECTION(POINT(0 0))'::geometry);
 st_iscollection
-------------
 t
(1 row)

関連情報

ST_NumGeometries

Name

ST_IsEmpty — ジオメトリが空かをテストします。

Synopsis

boolean ST_IsEmpty(
geomA);

geometry geomA;

説明

ジオメトリが空ジオメトリの場合にtrueを返します。 trueの場合には、このジオメトリは、空のジオメトリコレクション、ポリゴン、ポイント等です。

Note

SQL-MMでは、ST_IsEmpty(NULL)は0を返しますが、PostGISではNULLを返します。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.1

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.7

説明このメソッドは曲線ストリングと曲線に対応しています。

Warning

Changed: 2.0.0 以前の版のPostGISではST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)')を許しました。PostGIS 2.0.0では、SQL/MM標準により準拠させるため、これは不正となります。

例

SELECT ST_IsEmpty(ST_GeomFromText('GEOMETRYCOLLECTION EMPTY'));
 st_isempty
------------
 t
(1 row)

 SELECT ST_IsEmpty(ST_GeomFromText('POLYGON EMPTY'));
 st_isempty
------------
 t
(1 row)

SELECT ST_IsEmpty(ST_GeomFromText('POLYGON((1 2, 3 4, 5 6, 1 2))'));

 st_isempty
------------
 f
(1 row)

 SELECT ST_IsEmpty(ST_GeomFromText('POLYGON((1 2, 3 4, 5 6, 1 2))')) = false;
 ?column?
----------
 t
(1 row)

 SELECT ST_IsEmpty(ST_GeomFromText('CIRCULARSTRING EMPTY'));
  st_isempty
------------
 t
(1 row)

Name

ST_IsPolygonCCW — ポリゴンが反時計回りの外環を持っていて、時計回りの内環を持っているかをテストします。

Synopsis

boolean ST_IsPolygonCCW (
geom);

geometry geom ;

説明

入力ジオメトリの全てのポリゴン要素の外環については反時計回りで、全ての内環については時計回りである場合には、TRUEを返します。

ジオメトリがポリゴン要素を持っていない場合にはTRUEを返します。

Note

閉じたラインストリングはポリゴン要素とみなされません。単一の閉じたラインストリングを渡すと、右回り左回りにかかわらずTRUEが得られます。

Note

ポリゴン要素の内環が逆回りになっていない (すなわち外環と同じ方向で回る内環が1個以上ある)場合には、ST_IsPolygonCWとST_IsPolygonCCW の両方ともにFALSEを返します。

Availability: 2.4.0

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数はM値に対応します。

関連情報

ST_ForcePolygonCW , ST_ForcePolygonCCW , ST_IsPolygonCW

Name

ST_IsPolygonCW — ポリゴンが時計回りの外環を持っていて、反時計回りの内環を持っているかをテストします。

Synopsis

boolean ST_IsPolygonCW (
geom);

geometry geom ;

説明

入力ジオメトリの全てのポリゴン要素の外環については時計回りで、全ての内環については反時計回りである場合には、TRUEを返します。

ジオメトリがポリゴン要素を持っていない場合にはTRUEを返します。

Note

閉じたラインストリングはポリゴン要素とみなされません。単一の閉じたラインストリングを渡すと、右回り左回りにかかわらずTRUEが得られます。

Note

ポリゴン要素の内環が逆回りになっていない (すなわち外環と同じ方向で回る内環が1個以上ある)場合には、ST_IsPolygonCWとST_IsPolygonCCW の両方ともにFALSEを返します。

Availability: 2.4.0

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数はM値に対応します。

関連情報

ST_ForcePolygonCW , ST_ForcePolygonCCW , ST_IsPolygonCW

Name

ST_IsRing — ラインストリングが閉じていてかつ単純であるかをテストします。

Synopsis

boolean ST_IsRing(
g);

geometry g;

説明

LINESTRINGがST_IsClosed (ST_StartPoint(g) ~= ST_Endpoint(g))で、かつST_IsSimple (自己インタセクションが無い)場合にTRUEを返します。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 2.1.5.1

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.1.6

Note

SQL-MMでは、ST_IsRing(NULL)は0を返しますが、PostGISではNULLを返します。

例

SELECT ST_IsRing(geom), ST_IsClosed(geom), ST_IsSimple(geom)
FROM (SELECT 'LINESTRING(0 0, 0 1, 1 1, 1 0, 0 0)'::geometry AS geom) AS foo;
 st_isring | st_isclosed | st_issimple
-----------+-------------+-------------
 t         | t           | t
(1 row)

SELECT ST_IsRing(geom), ST_IsClosed(geom), ST_IsSimple(geom)
FROM (SELECT 'LINESTRING(0 0, 0 1, 1 0, 1 1, 0 0)'::geometry AS geom) AS foo;
 st_isring | st_isclosed | st_issimple
-----------+-------------+-------------
 f         | t           | f
(1 row)

関連情報

ST_IsClosed, ST_IsSimple, ST_StartPoint, ST_EndPoint

Name

ST_IsSimple — ジオメトリが自己インタセクトまたは自己接触となるポイントが無いかをテストします。

Synopsis

boolean ST_IsSimple(
geomA);

geometry geomA;

説明

ジオメトリが自己インタセクションや自己接触のような異常な幾何学ポイントを持っていない場合にTRUEを返します。OGCのジオメトリ単純性と妥当性の定義に関する詳細情報については「ジオメトリのOpenGIS準拠を確実にする」をご覧ください。

Note

SQL-MMでは、ST_IsSimple(NULL)は0を返しますが、PostGISではNULLを返します。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.1

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.8

説明この関数は3次元に対応し、Z値を削除しません。

例

SELECT ST_IsSimple(ST_GeomFromText('POLYGON((1 2, 3 4, 5 6, 1 2))'));
 st_issimple
-------------
 t
(1 row)

 SELECT ST_IsSimple(ST_GeomFromText('LINESTRING(1 1,2 2,2 3.5,1 3,1 2,2 1)'));
 st_issimple
-------------
 f
(1 row)

関連情報

ST_IsValid

Name

ST_M — ポイントのM値を返します。

Synopsis

float ST_M(
a_point);

geometry a_point;

説明

ポイントのM座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。

Note

これは (いまだに)OGC仕様に入っていませんが、ポイント座標抽出関数のリストを完全にするために挙げています。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明このメソッドはSQL/MM仕様の実装です。

説明この関数は3次元に対応し、Z値を削除しません。

例

SELECT ST_M(ST_GeomFromEWKT('POINT(1 2 3 4)'));
 st_m
------
        4
(1 row)

関連情報

ST_GeomFromEWKT, ST_X, ST_Y, ST_Z

Name

ST_MemSize — ジオメトリが取るメモリ空間の合計を返します。

Synopsis

integer ST_MemSize(
geomA);

geometry geomA;

説明

ジオメトリが取るメモリ空間の合計をバイト単位で返します。

この関数は、PostgreSQLビルトインデータベースオブジェクト管理関数のpg_column_size, pg_size_pretty, pg_relation_size, pg_total_relation_sizeを補完します。

Note

テーブルのバイト単位のサイズを与えるpg_relation_sizeはST_Mem_Sizeより小さいバイト数が返ります。これはpg_relation_sizeがTOAST化されたテーブルの寄与を追加せず、TOASTテーブルに格納された大きなジオメトリを加えないためです。

pg_total_relation_size - テーブル、TOASTテーブル、インデクスを含みます。

pg_column_sizeは、ジオメトリがカラム内で取る領域がどれだけかを、圧縮を考慮して返します。そのため、ST_MemSizeより小さくなることがあります。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

Changed: 2.2.0 命名規則に従うためにST_MemSizeに変更しました。

例

-- マサチューセッツのデータセットでボストンが占めるバイト単位の容量を返します
SELECT pg_size_pretty(SUM(ST_MemSize(geom))) as totgeomsum,
pg_size_pretty(SUM(CASE WHEN town = 'BOSTON' THEN ST_MemSize(geom) ELSE 0 END)) As bossum,
CAST(SUM(CASE WHEN town = 'BOSTON' THEN ST_MemSize(geom) ELSE 0 END)*1.00 /
                SUM(ST_MemSize(geom))*100 As numeric(10,2)) As perbos
FROM towns;

totgeomsum        bossum        perbos
----------        ------        ------
1522 kB                30 kB        1.99

SELECT ST_MemSize(ST_GeomFromText('CIRCULARSTRING(220268 150415,220227 150505,220227 150406)'));

---
73

-- ジオメトリがテーブルに占める割合
SELECT pg_total_relation_size('public.neighborhoods') As fulltable_size, sum(ST_MemSize(geom)) As geomsize,
sum(ST_MemSize(geom))*1.00/pg_total_relation_size('public.neighborhoods')*100 As pergeom
FROM neighborhoods;
fulltable_size geomsize  pergeom
------------------------------------------------
262144         96238         36.71188354492187500000

Name

ST_NDims — ST_Geometry値の座標次元を返します。

Synopsis

integer ST_NDims(
g1);

geometry g1;

説明

ジオメトリの座標次元返します。PostGISでは、2 - (X,Y), 3 - (X,Y,Z), (X,Y,M), 4 - (X,Y,Z,M)に対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

例

SELECT ST_NDims(ST_GeomFromText('POINT(1 1)')) As d2point,
        ST_NDims(ST_GeomFromEWKT('POINT(1 1 2)')) As d3point,
        ST_NDims(ST_GeomFromEWKT('POINTM(1 1 0.5)')) As d2pointm;

         d2point | d3point | d2pointm
---------+---------+----------
           2 |       3 |        3

関連情報

ST_CoordDim, ST_Dimension, ST_GeomFromEWKT

Name

ST_NPoints — ジオメトリのポイント (頂点)の数を返します。

Synopsis

integer ST_NPoints(
g1);

geometry g1;

説明

ジオメトリのポイントの数を返します。全てのジオメトリに対して動作します。

Enhanced: 2.0.0 多面体サーフェス対応が導入されました。

Note

1.3.4より前では、曲線を含むジオメトリで使用すると、この関数はクラッシュします。これは1.3.4以上で訂正されています。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は多面体サーフェスに対応しています。

例

SELECT ST_NPoints(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)'));
-- 結果
4

-- 3次元空間上のポリゴン
SELECT ST_NPoints(ST_GeomFromEWKT('LINESTRING(77.29 29.07 1,77.42 29.26 0,77.27 29.31 -1,77.29 29.07 3)'))
-- 結果
4

関連情報

ST_NumPoints

Name

ST_NRings — ポリゴンジオメトリのリング数を返します。

Synopsis

integer ST_NRings(
geomA);

geometry geomA;

説明

ジオメトリがポリゴンまたはマルチポリゴンの場合、リング数を返します。NumInteriorRingsと違い、外環も数えます。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

SELECT ST_NRings(geom) As Nrings, ST_NumInteriorRings(geom) As ninterrings
                                        FROM (SELECT ST_GeomFromText('POLYGON((1 2, 3 4, 5 6, 1 2))') As geom) As foo;
         nrings | ninterrings
--------+-------------
          1 |           0
(1 row)

関連情報

ST_NumInteriorRings

Name

ST_NumGeometries — ジオメトリコレクションの要素数を返します。

Synopsis

integer ST_NumGeometries(
geom);

geometry geom;

説明

ジオメトリの数を返します。ジオメトリがジオメトリコレクションまたはマルチ系の場合は、ジオメトリの数を返し、単一のジオメトリの場合は1を返し、それ以外の場合はNULLを返します。

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。

Changed: 2.0.0 前の版では、ジオメトリがコレクション/マルチ系でない場合にはNULLを返しました。2.0.0以上では、POLYGON, LINESTRING, POINTといった単一ジオメトリについては1を返します。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 9.1.4

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

-- 以前の版ではNULLが返りました
-- 2.0.0から1が返ります
SELECT ST_NumGeometries(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)'));
-- 結果
1

-- ジオメトリコレクションの例
-- - マルチ系はコレクションで一つのジオメトリと数えます。
SELECT ST_NumGeometries(ST_GeomFromEWKT('GEOMETRYCOLLECTION(MULTIPOINT(-2 3 , -2 2),
LINESTRING(5 5 ,10 10),
POLYGON((-7 4.2,-7.1 5,-7.1 4.3,-7 4.2)))'));
-- 結果
3

関連情報

ST_GeometryN, ST_Multi

Name

ST_NumInteriorRings — ポリゴンの内環 (穴)の数を返します。

Synopsis

integer ST_NumInteriorRings(
a_polygon);

geometry a_polygon;

説明

ポリゴンジオメトリの内環の数を返します。ジオメトリがポリゴンでない場合には、NULLを返します。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 8.2.5

Changed: 2.0.0 - 以前の版では、MULTIPOLYGONを渡して最初のPOLYGONの内環の数を返すことができました。

例

-- 通常のポリゴンの場合
SELECT gid, field1, field2, ST_NumInteriorRings(geom) AS numholes
FROM sometable;

-- マルチポリゴンの内側リングの総数を知りたい場合
SELECT gid, field1, field2, SUM(ST_NumInteriorRings(geom)) AS numholes
FROM (SELECT gid, field1, field2, (ST_Dump(geom)).geom As geom
        FROM sometable) As foo
GROUP BY gid, field1,field2;

関連情報

ST_NumInteriorRing, ST_InteriorRingN

Name

ST_NumInteriorRing — ポリゴンの内環 (穴)の数を返します。ST_NumInteriorRingsの別名です。

Synopsis

integer ST_NumInteriorRing(
a_polygon);

geometry a_polygon;

関連情報

ST_NumInteriorRings, ST_InteriorRingN

Name

ST_NumPatches — 多面体サーフェスのフェイス数を返します。多面体でないジオメトリの場合にはNULLを返します。

Synopsis

integer ST_NumPatches(
g1);

geometry g1;

説明

多面体サーフェスのフェイス数を返します。多面体でないジオメトリの場合にはNULLを返します。ST_NumGeometriesの別名で、MMの名前付けに対応するためのものです。MM規約を気にしない場合はST_NumGeometriesの方が速いです。

Availability: 2.0.0

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM ISO/IEC 13249-3: 8.5

説明この関数は多面体サーフェスに対応しています。

例

SELECT ST_NumPatches(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
                ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
                ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
                ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'));
                -- 結果 --
                6

関連情報

ST_GeomFromEWKT, ST_NumGeometries

Name

ST_NumPoints — ラインストリングまたは曲線ストリングのポイント数を返します。

Synopsis

integer ST_NumPoints(
g1);

geometry g1;

説明

ST_LineStringまたはST_CircularStringのポイント数を返します。1.4より前は仕様通りにラインストリングにのみ対応していました。1.4以上ではラインストリングだけでなく頂点数を返すST_NPointsの別名です。多目的で多数のジオメトリタイプで動作するST_NPointsを使うことを考えて下さい。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.2.4

例

SELECT ST_NumPoints(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)'));
                -- 結果
                4

関連情報

ST_NPoints

Name

ST_PatchN — 多面体サーフェスのN番目のジオメトリ (フェイス)を返します。

Synopsis

geometry ST_PatchN( | geomA, |
| n); |

geometry geomA;
integer n;

説明

ジオメトリがPOLYHEDRALSURFACEかPOLYHEDRALSURFACEMの場合には、1始まりでN番目のジオメトリ (フェイス)を返します。それ以外の場合には、NULLを返します。多面体サーフェスを引数にとるST_GeometryNと同じ答えが返ります。ST_GeometryNの方が速いです。

Note

インデクスは1始まりです。

Note

ジオメトリの全ての要素を抽出するにはST_Dumpが最も効率的です。

Availability: 2.0.0

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM ISO/IEC 13249-3: 8.5

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

例

-- 多面体サーフェスの2番目のフェイスを抽出
SELECT ST_AsEWKT(ST_PatchN(geom, 2)) As geomewkt
FROM (
VALUES (ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
        ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
        ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
        ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )')) ) As foo(geom);

              geomewkt
---+-----------------------------------------
 POLYGON((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0))

関連情報

ST_AsEWKT, ST_GeomFromEWKT, ST_Dump, ST_GeometryN, ST_NumGeometries

Name

ST_PointN — ジオメトリの最初のラインストリングまたは曲線ストリングのN番目のポイントを返します。

Synopsis

geometry ST_PointN( | a_linestring, |
| n); |

geometry a_linestring;
integer n;

説明

ラインストリングまたは曲線ストリングのN番目の点を返します。負数はラインストリングの終端から逆方向に遡って数えます。-1は終端を指します。ジオメトリにラインストリングが無い場合には、NULLを返します。

Note

OGC仕様のため0.8.0版からインデックスを1始まりにしています。これより前の版では0はじまりになっています。後方インデックス (負数インデックス)はOGC仕様ではありません。

Note

マルチラインストリング内のラインストリングのN番目のポイントを得るには、ST_Dumpを併用します。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.2.5, 7.3.5

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

Note

Changed: 2.0.0 単一ジオメトリのMULTILINESTRINGで動作しなくなりました。単一のラインストリングからなるMULTILINESTRINGについては幸運にも動いていて、最初のポイントを返していました。2.0.0では他のMULTILINESTRINGと同様にNULLを返すようになりました。

Changed: 2.3.0 : 負数インデックスが有効になりました (-1は終端を指します)

例

-- LINESTRINGから全てのPOINTを抽出
SELECT ST_AsText(
   ST_PointN(
          column1,
          generate_series(1, ST_NPoints(column1))
   ))
FROM ( VALUES ('LINESTRING(0 0, 1 1, 2 2)'::geometry) ) AS foo;

 st_astext
------------
 POINT(0 0)
 POINT(1 1)
 POINT(2 2)
(3 rows)

-- 曲線ストリングの例
SELECT ST_AsText(ST_PointN(ST_GeomFromText('CIRCULARSTRING(1 2, 3 2, 1 2)'), 2));

 st_astext
------------
 POINT(3 2)
(1 row)

SELECT ST_AsText(f)
FROM ST_GeomFromText('LINESTRING(0 0 0, 1 1 1, 2 2 2)') AS g
  ,ST_PointN(g, -2) AS f; -- 1 based index

    st_astext
-----------------
 POINT Z (1 1 1)
(1 row)

関連情報

ST_NPoints

Name

ST_Points — ジオメトリの全ての座標を含むマルチポイントを返します。

Synopsis

geometry ST_Points(
geom);

geometry geom ;

説明

ジオメトリの全ての座標を含むマルチポイントを返します。リングジオメトリの始点と終点を含む重複ポイントは保存されます (重複ポイントの削除が必要ならST_RemoveRepeatedPointsを呼ぶと削除した結果が得られます)。

親ジオメトリの個々の座標のポイントに関する情報を取得するにはST_DumpPointsを使います。

M値とZ値が存在する場合には保持されます。

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

Availability: 2.3.0

例

SELECT ST_AsText(ST_Points('POLYGON Z ((30 10 4,10 30 5,40 40 6, 30 10))'));

-- 結果 --
MULTIPOINT Z ((30 10 4),(10 30 5),(40 40 6),(30 10 4))

関連情報

ST_RemoveRepeatedPoints, ST_DumpPoints

Name

ST_StartPoint — ラインストリングの始点を返します。

Synopsis

geometry ST_StartPoint(
geomA);

geometry geomA;

説明

LINESTRINGまたはCIRCULARLINESTRINGジオメトリの、最初のポイントをPOINTで返します。入力パラメータがLINESTRINGでもCIRCULARLINESTRINGでもない場合には、NULLを返します。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.1.3

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

Note

Enhanced: 3.2.0 全てのジオメトリのポイントを返すようになりました。以前のバージョンではラインストリング以外ではNULLを返していました。

Changed: 2.0.0 一つのMULTILINESTRINGで動作しなくなりました。PostGIS の古いバージョンでは、この関数は、一つのラインストリングからなるMULTILINESTRINGについては幸運にも動いていて、始端ポイントを返していました。2.0.0では他のMULTILINESTRINGと同様にNULLを返すようになりました。古い動作は文書化されていない機能でしたが、データをLINESTRINGとして格納していると思われるユーザーは、2.0.0 でNULLが返されることを経験するかも知れません。

例

ラインストリングの始端ポイント

SELECT ST_AsText(ST_StartPoint('LINESTRING(0 1, 0 2)'::geometry));
 st_astext
------------
 POINT(0 1)

ラインストリングでないものの始端ポイントはNULL

SELECT ST_StartPoint('POINT(0 1)'::geometry) IS NULL AS is_null;
  is_null
----------
 t

3次元ラインストリングの始端ポイント

SELECT ST_AsEWKT(ST_StartPoint('LINESTRING(0 1 1, 0 2 2)'::geometry));
 st_asewkt
------------
 POINT(0 1 1)

CIRCULARSTRINGの始端ポイント

SELECT ST_AsText(ST_StartPoint('CIRCULARSTRING(5 2,-3 1.999999, -2 1, -4 2, 6 3)'::geometry));
 st_astext
------------
 POINT(5 2)

関連情報

ST_EndPoint, ST_PointN

Name

ST_Summary — ジオメトリについての要約文を返します。

Synopsis

text ST_Summary(
g);

geometry g;

text ST_Summary(
g);

geography g;

説明

ジオメトリについての要約文を返します。

ジオメトリ型の後の角括弧で示されたフラグには次の意味があります。

M: M軸を持ちます

Z: Z軸を持ちます

B: バウンディングボックスを持ちます

G: 測地座標系 (ジオグラフィ)です

S: 空間参照系を持ちます

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

Availability: 1.2.2

Enhanced: 2.0.0でジオグラフィ対応が追加されました。

Enhanced: 2.1.0 空間参照系を持つかを示すSフラグが追加されました。

Enhanced: 2.2.0 TINと曲線の対応が追加されました。

例

=# SELECT ST_Summary(ST_GeomFromText('LINESTRING(0 0, 1 1)')) as geom,
        ST_Summary(ST_GeogFromText('POLYGON((0 0, 1 1, 1 2, 1 1, 0 0))')) geog;
            geom             |          geog
-----------------------------+--------------------------
 LineString[B] with 2 points | Polygon[BGS] with 1 rings
                             | ring 0 has 5 points
                             :
(1 row)

=# SELECT ST_Summary(ST_GeogFromText('LINESTRING(0 0 1, 1 1 1)')) As geog_line,
        ST_Summary(ST_GeomFromText('SRID=4326;POLYGON((0 0 1, 1 1 2, 1 2 3, 1 1 1, 0 0 1))')) As geom_poly;
;
           geog_line             |        geom_poly
-------------------------------- +--------------------------
 LineString[ZBGS] with 2 points | Polygon[ZBS] with 1 rings
                                :    ring 0 has 5 points
                                :
(1 row)

関連情報

PostGIS_DropBBox, PostGIS_AddBBox, ST_Force3DM, ST_Force3DZ, ST_Force2D, geography

ST_IsValid, ST_IsValid, ST_IsValidReason, ST_IsValidDetail

Name

ST_X — ポイントのX値を返します。

Synopsis

float ST_X(
a_point);

geometry a_point;

説明

ポイントのX座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。

Note

ジオメトリのX値の最小値と最大値を得るにはST_XMinとST_XMaxを使います。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 6.1.3

説明この関数は3次元に対応し、Z値を削除しません。

例

SELECT ST_X(ST_GeomFromEWKT('POINT(1 2 3 4)'));
 st_x
------
        1
(1 row)

SELECT ST_Y(ST_Centroid(ST_GeomFromEWKT('LINESTRING(1 2 3 4, 1 1 1 1)')));
 st_y
------
  1.5
(1 row)

関連情報

ST_Centroid, ST_GeomFromEWKT, ST_M, ST_XMax, ST_XMin, ST_Y, ST_Z

Name

ST_Y — ポイントのY値を返します。

Synopsis

float ST_Y(
a_point);

geometry a_point;

説明

ポイントのY座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。

Note

ジオメトリの値の最小値と最大値を得るにはST_YMinとST_YMaxを使います。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 6.1.4

説明この関数は3次元に対応し、Z値を削除しません。

例

SELECT ST_Y(ST_GeomFromEWKT('POINT(1 2 3 4)'));
 st_y
------
        2
(1 row)

SELECT ST_Y(ST_Centroid(ST_GeomFromEWKT('LINESTRING(1 2 3 4, 1 1 1 1)')));
 st_y
------
  1.5
(1 row)

関連情報

ST_Centroid, ST_GeomFromEWKT, ST_M, ST_X, ST_YMax, ST_YMin, ST_Z

Name

ST_Z — ポイントのZ値を返します。

Synopsis

float ST_Z(
a_point);

geometry a_point;

説明

ポイントのZ座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。

Note

ジオメトリのZ値の最小値と最大値を得るにはST_ZMinとST_ZMaxを使います。

説明このメソッドはSQL/MM仕様の実装です。

説明この関数は3次元に対応し、Z値を削除しません。

例

SELECT ST_Z(ST_GeomFromEWKT('POINT(1 2 3 4)'));
 st_z
------
        3
(1 row)

関連情報

ST_GeomFromEWKT, ST_M, ST_X, ST_Y, ST_ZMax, ST_ZMin

Name

ST_Zmflag — ジオメトリのZM座標次元を示す符号を返します。

Synopsis

smallint ST_Zmflag(
geomA);

geometry geomA;

説明

ジオメトリのZM座標次元を示す符号を返します。

値は 0=XY, 1=XYM, 2=XYZ, 3=XYZMとなります。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

SELECT ST_Zmflag(ST_GeomFromEWKT('LINESTRING(1 2, 3 4)'));
 st_zmflag
-----------
                 0

SELECT ST_Zmflag(ST_GeomFromEWKT('LINESTRINGM(1 2 3, 3 4 3)'));
 st_zmflag
-----------
                 1

SELECT ST_Zmflag(ST_GeomFromEWKT('CIRCULARSTRING(1 2 3, 3 4 3, 5 6 3)'));
 st_zmflag
-----------
                 2
SELECT ST_Zmflag(ST_GeomFromEWKT('POINT(1 2 3 4)'));
 st_zmflag
-----------
                 3

関連情報

ST_CoordDim, ST_NDims, ST_Dimension

ジオメトリエディタ

Abstract

これらの関数は、タイプ、構造または頂点の変更によって編集されたジオメトリを生成します。

Name

ST_AddPoint — ラインストリングにポイントを追加します。

Synopsis

geometry ST_AddPoint( | linestring, |
| point); |

geometry linestring;
geometry point;

geometry ST_AddPoint( | linestring, |
| point, |
| position = -1); |

geometry linestring;
geometry point;
integer position = -1;

説明

LINESTRINGのpositionの位置 (0はじまり)の前にポイントを追加します。positionパラメータが省略されるか-1の場合には、LINESTRINGの末尾に追加されます。

Availability: 1.1.0

説明この関数は3次元に対応し、Z値を削除しません。

例

3次元ラインの末尾へのポイントの追加

SELECT ST_AsEWKT(ST_AddPoint('LINESTRING(0 0 1, 1 1 1)', ST_MakePoint(1, 2, 3)));

    st_asewkt
    ----------
    LINESTRING(0 0 1,1 1 1,1 2 3)

テーブル内の全てのラインについて、閉じていないラインにだけ始端を末尾に追加することで、閉じていることを保証します。

UPDATE sometable
SET geom = ST_AddPoint(geom, ST_StartPoint(geom))
FROM sometable
WHERE ST_IsClosed(geom) = false;

関連情報

ST_RemovePoint, ST_SetPoint

Name

ST_CollectionExtract — ジオメトリコレクションを与えると、指定されたタイプの要素だけからなるマルチジオメトリを返します。

Synopsis

geometry ST_CollectionExtract(
collection);

geometry collection;

geometry ST_CollectionExtract( | collection, |
| type); |

geometry collection;
integer type;

説明

ジオメトリコレクションを指定すると、要素のタイプが統一されたマルチジオメトリを返します。

typeが指定されていない場合には、最大次元のジオメトリだけを含むマルチジオメトリを返します。このため、ポリゴンはラインに優先され、ラインはポイントに優先されます。

typeが指定されている場合には、指定されたタイプだけを含むマルチジオメトリを返します。指定されたタイプの要素が無い場合には、EMPTYジオメトリを返します。ポイント、ライン、ポリゴンだけに対応しています。タイプの番号は次の通りです。

1 == POINT

2 == LINESTRING

3 == POLYGON

非マルチジオメトリの入力に対しては、ジオメトリのタイプと指定したタイプが合致している場合には変更せず返します。合致しない場合には、指定したタイプのEMPTYジオメトリを返します。ST_Multi"/>を使ってマルチ系ジオメトリに変換する必要があるならST_Multiを使います。

Warning

マルチポリゴンの結果は妥当性チェックを行いません。ポリゴン要素が隣接やオーバラップしている場合には、結果ジオメトリは不正となります (たとえば、この関数をST_Splitの結果に適用すると発生します)。この状況に陥っているかはST_IsValidで確認でき、ST_MakeValidで修復できます。

Availability: 1.5.0

Note

1.5.3より前のこの関数は非マルチジオメトリの入力に対して、指定タイプに関係なく変更せずに返しました。1.5.3で指定タイプに合致しない単一ジオメトリ入力に対してNULLを返すようになりました。2.0.0で、合致しないジオメトリに対して、指定タイプのEMPTYジオメトリを返すようになりました。

例

最大次元となるタイプの抽出:

SELECT ST_AsText(ST_CollectionExtract(
        'GEOMETRYCOLLECTION( POINT(0 0), LINESTRING(1 1, 2 2) )'));
    st_astext
    ---------------
    MULTILINESTRING((1 1, 2 2))

ポイントの抽出 (type 1 == POINT):

SELECT ST_AsText(ST_CollectionExtract(
        'GEOMETRYCOLLECTION(GEOMETRYCOLLECTION(POINT(0 0)))',
        1 ));
    st_astext
    ---------------
    MULTIPOINT(0 0)

ラインの抽出 (type 2 == LINESTRING):

SELECT ST_AsText(ST_CollectionExtract(
        'GEOMETRYCOLLECTION(GEOMETRYCOLLECTION(LINESTRING(0 0, 1 1)),LINESTRING(2 2, 3 3))',
        2 ));
    st_astext
    ---------------
    MULTILINESTRING((0 0, 1 1), (2 2, 3 3))

関連情報

ST_CollectionHomogenize, ST_Multi, ST_IsValid, ST_MakeValid

Name

ST_CollectionHomogenize — ジオメトリコレクションを与えると、最も単純な表現を返します。

Synopsis

geometry ST_CollectionHomogenize(
collection);

geometry collection;

説明

ジオメトリコレクションを与えると、「最も単純な」表現を返します。

同種の要素からなるコレクションが適切なマルチ系ジオメトリとして返されます。

タイプ混合のコレクションはフラットな単一のGEOMETRYCOLLECTIONに変換されます。

単一の非マルチジオメトリ要素からなるコレクションはその要素が返されます。

非マルチジオメトリは変更されずに返ります。マルチジオメトリへの変換が必要ならST_Multiを使います。

Warning

この関数は結果ジオメトリの妥当性を保証されず、隣接やオーバラップする複数ポリゴンからは不正なMULTIPOLYGONが生成されます。この状況に陥っているかはST_IsValidで確認でき、ST_MakeValidで修復できます。

Availability: 2.0.0

例

単一要素のコレクションから非マルチジオメトリへの変換

SELECT ST_AsText(ST_CollectionHomogenize('GEOMETRYCOLLECTION(POINT(0 0))'));

        st_astext
        ------------
        POINT(0 0)

ネスト下単一要素のコレクションから非マルチジオメトリへの変換:

SELECT ST_AsText(ST_CollectionHomogenize('GEOMETRYCOLLECTION(MULTIPOINT((0 0)))'));

        st_astext
        ------------
        POINT(0 0)

コレクションからマルチ系ジオメトリへの変換:

SELECT ST_AsText(ST_CollectionHomogenize('GEOMETRYCOLLECTION(POINT(0 0),POINT(1 1))'));

        st_astext
        ---------------------
        MULTIPOINT((0 0),(1 1))

ネストしたタイプ混合のコレクションからフラットなジオメトリコレクションへの変換:

SELECT ST_AsText(ST_CollectionHomogenize('GEOMETRYCOLLECTION(POINT(0 0), GEOMETRYCOLLECTION( LINESTRING(1 1, 2 2)))'));

        st_astext
        ---------------------
        GEOMETRYCOLLECTION(POINT(0 0),LINESTRING(1 1,2 2))

ポリゴンのコレクションから (不正な)マルチポリゴンへの変換:

SELECT ST_AsText(ST_CollectionHomogenize('GEOMETRYCOLLECTION (POLYGON ((10 50, 50 50, 50 10, 10 10, 10 50)), POLYGON ((90 50, 90 10, 50 10, 50 50, 90 50)))'));

        st_astext
        ---------------------
        MULTIPOLYGON(((10 50,50 50,50 10,10 10,10 50)),((90 50,90 10,50 10,50 50,90 50)))

関連情報

ST_CollectionExtract, ST_Multi, ST_IsValid, ST_MakeValid

Name

ST_CurveToLine — 曲線を含むジオメトリを線ジオメトリに変換します。

Synopsis

geometry ST_CurveToLine( | curveGeom, |
| tolerance, |
| tolerance_type, |
| flags); |

geometry curveGeom;
float tolerance;
integer tolerance_type;
integer flags;

説明

CIRCULARSTRINGをLINESTRINGに、CURVEPOLYGONをPOLYGONに、MULTISURFACEをMULTIPOLYGONに、それぞれ変換します。CIRCULARSTRINGジオメトリタイプに対応していないデバイスへの出力に使用します。

与えられたジオメトリを線型ジオメトリに変換します。それぞれの曲線ジオメトリまたは辺は、`tolerance` とオプションを使用して線形近似に変換します (デフォルトでは4分の1円ごとに32辺でオプションなしです)。

'tolerance_type'引数によって`tolerance`引数の解釈が決定されます。

0 (デフォルト): toleranceは4分の1円の最大辺数です。

1: toleranceは曲線からラインまでの最大差です。単位は入力ジオメトリの単位です。

2: toleranceは生成される半径がなす角度のラジアン単位の最大値です。

'flags'引数はビットフィールドです。デフォルトでは0です。次のビットに対応します。

1: 対称となる (方向独立)出力。

2: 角度維持。対称出力を生成する時に角度 (辺長)減少を避けます。対称フラグがOFFの時は何の効果もありません。

Availability: 1.3.0

Enhanced: 2.4.0 最大距離差による許容範囲と最大角度による許容範囲に対応し、対称出力に対応しました。

Enhanced: 3.0.0 線形化した弧ごとの最小線分数を実装しました。トポロジ的な崩壊を防ぐためです。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.1.7

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

SELECT ST_AsText(ST_CurveToLine(ST_GeomFromText('CIRCULARSTRING(220268 150415,220227 150505,220227 150406)')));

--Result --
 LINESTRING(220268 150415,220269.95064912 150416.539364228,220271.823415575 150418.17258804,220273.613787707 150419.895736857,
 220275.317452352 150421.704659462,220276.930305234 150423.594998003,220278.448460847 150425.562198489,
 220279.868261823 150427.60152176,220281.186287736 150429.708054909,220282.399363347 150431.876723113,
 220283.50456625 150434.10230186,220284.499233914 150436.379429536,220285.380970099 150438.702620341,220286.147650624 150441.066277505,
 220286.797428488 150443.464706771,220287.328738321 150445.892130112,220287.740300149 150448.342699654,
 220288.031122486 150450.810511759,220288.200504713 150453.289621251,220288.248038775 150455.77405574,
 220288.173610157 150458.257830005,220287.977398166 150460.734960415,220287.659875492 150463.199479347,
 220287.221807076 150465.64544956,220286.664248262 150468.066978495,220285.988542259 150470.458232479,220285.196316903 150472.81345077,
 220284.289480732 150475.126959442,220283.270218395 150477.39318505,220282.140985384 150479.606668057,
 220280.90450212 150481.762075989,220279.5637474 150483.85421628,220278.12195122 150485.87804878,
 220276.582586992 150487.828697901,220274.949363179 150489.701464356,220273.226214362 150491.491836488,
 220271.417291757 150493.195501133,220269.526953216 150494.808354014,220267.559752731 150496.326509628,
 220265.520429459 150497.746310603,220263.41389631 150499.064336517,220261.245228106 150500.277412127,
 220259.019649359 150501.38261503,220256.742521683 150502.377282695,220254.419330878 150503.259018879,
 220252.055673714 150504.025699404,220249.657244448 150504.675477269,220247.229821107 150505.206787101,
 220244.779251566 150505.61834893,220242.311439461 150505.909171266,220239.832329968 150506.078553494,
 220237.347895479 150506.126087555,220234.864121215 150506.051658938,220232.386990804 150505.855446946,
 220229.922471872 150505.537924272,220227.47650166 150505.099855856,220225.054972724 150504.542297043,
 220222.663718741 150503.86659104,220220.308500449 150503.074365683,
 220217.994991777 150502.167529512,220215.72876617 150501.148267175,
 220213.515283163 150500.019034164,220211.35987523 150498.7825509,
 220209.267734939 150497.441796181,220207.243902439 150496,
 220205.293253319 150494.460635772,220203.420486864 150492.82741196,220201.630114732 150491.104263143,
 220199.926450087 150489.295340538,220198.313597205 150487.405001997,220196.795441592 150485.437801511,
 220195.375640616 150483.39847824,220194.057614703 150481.291945091,220192.844539092 150479.123276887,220191.739336189 150476.89769814,
 220190.744668525 150474.620570464,220189.86293234 150472.297379659,220189.096251815 150469.933722495,
 220188.446473951 150467.535293229,220187.915164118 150465.107869888,220187.50360229 150462.657300346,
 220187.212779953 150460.189488241,220187.043397726 150457.710378749,220186.995863664 150455.22594426,
 220187.070292282 150452.742169995,220187.266504273 150450.265039585,220187.584026947 150447.800520653,
 220188.022095363 150445.35455044,220188.579654177 150442.933021505,220189.25536018 150440.541767521,
 220190.047585536 150438.18654923,220190.954421707 150435.873040558,220191.973684044 150433.60681495,
 220193.102917055 150431.393331943,220194.339400319 150429.237924011,220195.680155039 150427.14578372,220197.12195122 150425.12195122,
 220198.661315447 150423.171302099,220200.29453926 150421.298535644,220202.017688077 150419.508163512,220203.826610682 150417.804498867,
 220205.716949223 150416.191645986,220207.684149708 150414.673490372,220209.72347298 150413.253689397,220211.830006129 150411.935663483,
 220213.998674333 150410.722587873,220216.22425308 150409.61738497,220218.501380756 150408.622717305,220220.824571561 150407.740981121,
 220223.188228725 150406.974300596,220225.586657991 150406.324522731,220227 150406)

--3d example
SELECT ST_AsEWKT(ST_CurveToLine(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 150406 3)')));
Output
------
 LINESTRING(220268 150415 1,220269.95064912 150416.539364228 1.0181172856673,
 220271.823415575 150418.17258804 1.03623457133459,220273.613787707 150419.895736857 1.05435185700189,....AD INFINITUM ....
    220225.586657991 150406.324522731 1.32611114201132,220227 150406 3)

--use only 2 segments to approximate quarter circle
SELECT ST_AsText(ST_CurveToLine(ST_GeomFromText('CIRCULARSTRING(220268 150415,220227 150505,220227 150406)'),2));
st_astext
------------------------------
 LINESTRING(220268 150415,220287.740300149 150448.342699654,220278.12195122 150485.87804878,
 220244.779251566 150505.61834893,220207.243902439 150496,220187.50360229 150462.657300346,
 220197.12195122 150425.12195122,220227 150406)

-- Ensure approximated line is no further than 20 units away from
-- original curve, and make the result direction-neutral
SELECT ST_AsText(ST_CurveToLine(
 'CIRCULARSTRING(0 0,100 -100,200 0)'::geometry,
    20, -- Tolerance
    1, -- Above is max distance between curve and line
    1  -- Symmetric flag
));
st_astext
-------------------------------------------------------------------------------------------
 LINESTRING(0 0,50 -86.6025403784438,150 -86.6025403784439,200 -1.1331077795296e-13,200 0)

関連情報

ST_LineToCurve

Name

ST_Scroll — 閉じたLINESTRINGの開始点を変更する。

Synopsis

geometry ST_Scroll( | linestring, |
| point); |

geometry linestring;
geometry point;

説明

閉じたLINESTRINGの開始/終了点を pointで指定した頂点に変更します。

Availability: 3.2.0

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数はM値に対応します。

例

閉じたラインの3番目の頂点を開始点にする

SELECT ST_AsEWKT(ST_Scroll('SRID=4326;LINESTRING(0 0 0 1, 10 0 2 0, 5 5 4 2,0 0 0 1)', 'POINT(5 5 4 2)'));

st_asewkt
----------
SRID=4326;LINESTRING(5 5 4 2,0 0 0 1,10 0 2 0,5 5 4 2)

関連情報

ST_Normalize

Name

ST_FlipCoordinates — X値とY値を入れ替えたジオメトリを返します。

Synopsis

geometry ST_FlipCoordinates(
geom);

geometry geom;

説明

与えられたジオメトリのX値とY値を入れ替えたものを返します。緯度経度 (Y,X)で表現される座標値を持つジオメトリを修正するのに使います。

Availability: 2.0.0

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数はM値に対応します。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

SELECT ST_AsEWKT(ST_FlipCoordinates(GeomFromEWKT('POINT(1 2)')));
 st_asewkt
------------
POINT(2 1)

関連情報

ST_SwapOrdinates

Name

ST_Force2D — ジオメトリを2次元モードに強制します。

Synopsis

geometry ST_Force2D(
geomA);

geometry geomA;

説明

ジオメトリを「2次元モード」に強制させます。全ての出力表現はXY座標値のみを持つことになります。OGC準拠の出力 (OGCは2次元ジオメトリのみ策定しています)に強制するために使われます。

Enhanced: 2.0.0 多面体サーフェス対応が導入されました。

Changed: 2.1.0 2.0.xの間はST_Force_2Dと呼ばれていました。

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は多面体サーフェスに対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

例

SELECT ST_AsEWKT(ST_Force2D(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 5 2, 6 7 2, 5 6 2)')));
                st_asewkt
-------------------------------------
CIRCULARSTRING(1 1,2 3,4 5,6 7,5 6)

SELECT  ST_AsEWKT(ST_Force2D('POLYGON((0 0 2,0 5 2,5 0 2,0 0 2),(1 1 2,3 1 2,1 3 2,1 1 2))'));

                                  st_asewkt
----------------------------------------------
 POLYGON((0 0,0 5,5 0,0 0),(1 1,3 1,1 3,1 1))

関連情報

ST_Force3D

Name

ST_Force3D — ジオメトリをXYZモードに強制します。これはST_Force3DZの別名です。

Synopsis

geometry ST_Force3D( | geomA, |
| Zvalue = 0.0); |

geometry geomA;
float Zvalue = 0.0;

説明

ジオメトリをXYZモードに強制します。これはST_Force_3DZの別名です。ジオメトリがZ値を持っていない場合はZvalueのZ値を追加します。

Enhanced: 2.0.0 多面体サーフェス対応が導入されました。

Changed: 2.1.0 2.0.xの間はST_Force_3Dと呼ばれていました。

Changed: 3.1.0. 0でないZ値を指定できるようになりました。

説明この関数は多面体サーフェスに対応しています。

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

例

-- 既に3次元ジオメトリになっている場合は何も起きません
                SELECT ST_AsEWKT(ST_Force3D(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 5 2, 6 7 2, 5 6 2)')));
                                   st_asewkt
-----------------------------------------------
 CIRCULARSTRING(1 1 2,2 3 2,4 5 2,6 7 2,5 6 2)

SELECT  ST_AsEWKT(ST_Force3D('POLYGON((0 0,0 5,5 0,0 0),(1 1,3 1,1 3,1 1))'));

                                                 st_asewkt
--------------------------------------------------------------
 POLYGON((0 0 0,0 5 0,5 0 0,0 0 0),(1 1 0,3 1 0,1 3 0,1 1 0))

関連情報

ST_AsEWKT, ST_Force2D, ST_Force3DM, ST_Force3DZ

Name

ST_Force3DZ — ジオメトリをXYZモードに強制します。

Synopsis

geometry ST_Force3DZ( | geomA, |
| Zvalue = 0.0); |

geometry geomA;
float Zvalue = 0.0;

説明

ジオメトリをXYZモードに強制します。これはST_Force_3DZの別名です。ジオメトリがZ値を持っていない場合はZvalueのZ値を追加します。

Enhanced: 2.0.0 多面体サーフェス対応が導入されました。

Changed: 2.1.0 2.0.xの間はST_Force_3DZと呼ばれていました。

Changed: 3.1.0. 0でないZ値を指定できるようになりました。

説明この関数は多面体サーフェスに対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

-- 既に3次元ジオメトリになっている場合は何も起きません
SELECT ST_AsEWKT(ST_Force3DZ(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 5 2, 6 7 2, 5 6 2)')));
                                   st_asewkt
-----------------------------------------------
 CIRCULARSTRING(1 1 2,2 3 2,4 5 2,6 7 2,5 6 2)

SELECT  ST_AsEWKT(ST_Force3DZ('POLYGON((0 0,0 5,5 0,0 0),(1 1,3 1,1 3,1 1))'));

                                                 st_asewkt
--------------------------------------------------------------
 POLYGON((0 0 0,0 5 0,5 0 0,0 0 0),(1 1 0,3 1 0,1 3 0,1 1 0))

関連情報

ST_AsEWKT, ST_Force2D, ST_Force3DM, ST_Force3D

Name

ST_Force3DM — ジオメトリをXYMモードに強制します。

Synopsis

geometry ST_Force3DM( | geomA, |
| Mvalue = 0.0); |

geometry geomA;
float Mvalue = 0.0;

説明

ジオメトリをXYMモードに強制します。ジオメトリがM値を持っていない場合はMvalueのM値を追加します。Z値を持っている場合はZ値は除去されます。

Changed: 2.1.0 2.0.xの間はST_Force_3DMと呼ばれていました。

Changed: 3.1.0. 0でないM値を指定できるようになりました。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

-- 既に3次元ジオメトリになっている場合は何も起きません
SELECT ST_AsEWKT(ST_Force3DM(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 5 2, 6 7 2, 5 6 2)')));
                                   st_asewkt
------------------------------------------------
 CIRCULARSTRINGM(1 1 0,2 3 0,4 5 0,6 7 0,5 6 0)

SELECT  ST_AsEWKT(ST_Force3DM('POLYGON((0 0 1,0 5 1,5 0 1,0 0 1),(1 1 1,3 1 1,1 3 1,1 1 1))'));

                                                  st_asewkt
---------------------------------------------------------------
 POLYGONM((0 0 0,0 5 0,5 0 0,0 0 0),(1 1 0,3 1 0,1 3 0,1 1 0))

関連情報

ST_AsEWKT, ST_Force2D, ST_Force3DM, ST_Force3D, ST_GeomFromEWKT

Name

ST_Force4D — ジオメトリをXYZMモードに強制します。

Synopsis

geometry ST_Force4D( | geomA, |
| Zvalue = 0.0, |
| Mvalue = 0.0); |

geometry geomA;
float Zvalue = 0.0;
float Mvalue = 0.0;

説明

ジオメトリをXYZMモードに強制します。Z値やM値が無い場合はZvalueとMvalueを追加します。

Changed: 2.1.0 2.0.xの間はST_Force_4Dと呼ばれていました。

Changed: 3.1.0. 0でないZ値とM値を指定できるようになりました。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

-- 既に3次元ジオメトリになっている場合は何も起きません
SELECT ST_AsEWKT(ST_Force4D(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 5 2, 6 7 2, 5 6 2)')));
                                                st_asewkt
---------------------------------------------------------
 CIRCULARSTRING(1 1 2 0,2 3 2 0,4 5 2 0,6 7 2 0,5 6 2 0)

SELECT  ST_AsEWKT(ST_Force4D('MULTILINESTRINGM((0 0 1,0 5 2,5 0 3,0 0 4),(1 1 1,3 1 1,1 3 1,1 1 1))'));

                                                                          st_asewkt
--------------------------------------------------------------------------------------
 MULTILINESTRING((0 0 0 1,0 5 0 2,5 0 0 3,0 0 0 4),(1 1 0 1,3 1 0 1,1 3 0 1,1 1 0 1))

関連情報

ST_AsEWKT, ST_Force2D, ST_Force3DM, ST_Force3D

Name

ST_ForcePolygonCCW — 全ての外環を反時計回りに、全ての内環を時計回りに、それぞれ強制します。

Synopsis

geometry ST_ForcePolygonCCW (
geom);

geometry geom ;

説明

(マルチ)ポリゴンに対して、外環を反時計回りに、内環を時計回りに強制します。ポリゴンでないジオメトリは、変更されずに返されます。

Availability: 2.4.0

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数はM値に対応します。

関連情報

ST_ForcePolygonCW , ST_IsPolygonCCW , ST_IsPolygonCW

Name

ST_ForceCollection — ジオメトリをジオメトリコレクションに変換します。

Synopsis

geometry ST_ForceCollection(
geomA);

geometry geomA;

説明

ジオメトリをジオメトリコレクションに変換します。これはWKB表現を単純化するのに便利です。

Enhanced: 2.0.0 多面体サーフェス対応が導入されました。

Availability: 1.2.2 1.3.4より前は、曲線を含むジオメトリで使うとクラッシュしました。これは1.3.4以上では訂正されています。

Changed: 2.1.0 2.0.xの間はST_Force_Collectionと呼ばれていました。

説明この関数は多面体サーフェスに対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

SELECT  ST_AsEWKT(ST_ForceCollection('POLYGON((0 0 1,0 5 1,5 0 1,0 0 1),(1 1 1,3 1 1,1 3 1,1 1 1))'));

                                                                   st_asewkt
----------------------------------------------------------------------------------
 GEOMETRYCOLLECTION(POLYGON((0 0 1,0 5 1,5 0 1,0 0 1),(1 1 1,3 1 1,1 3 1,1 1 1)))

  SELECT ST_AsText(ST_ForceCollection('CIRCULARSTRING(220227 150406,2220227 150407,220227 150406)'));
                                                                   st_astext
--------------------------------------------------------------------------------
 GEOMETRYCOLLECTION(CIRCULARSTRING(220227 150406,2220227 150407,220227 150406))
(1 row)

-- 多面体の例 --
SELECT ST_AsEWKT(ST_ForceCollection('POLYHEDRALSURFACE(((0 0 0,0 0 1,0 1 1,0 1 0,0 0 0)),
 ((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0)),
 ((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0)),
 ((1 1 0,1 1 1,1 0 1,1 0 0,1 1 0)),
 ((0 1 0,0 1 1,1 1 1,1 1 0,0 1 0)),
 ((0 0 1,1 0 1,1 1 1,0 1 1,0 0 1)))'))

                                                                   st_asewkt
----------------------------------------------------------------------------------
GEOMETRYCOLLECTION(
  POLYGON((0 0 0,0 0 1,0 1 1,0 1 0,0 0 0)),
  POLYGON((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0)),
  POLYGON((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0)),
  POLYGON((1 1 0,1 1 1,1 0 1,1 0 0,1 1 0)),
  POLYGON((0 1 0,0 1 1,1 1 1,1 1 0,0 1 0)),
  POLYGON((0 0 1,1 0 1,1 1 1,0 1 1,0 0 1))
)

関連情報

ST_AsEWKT, ST_Force2D, ST_Force3DM, ST_Force3D, ST_GeomFromEWKT

Name

ST_ForcePolygonCW — 全ての外環を時計回りに、全ての内環を反時計回りに、それぞれ強制します。

Synopsis

geometry ST_ForcePolygonCW (
geom);

geometry geom ;

説明

(マルチ)ポリゴンに対して、外環を時計回りに、内環を反時計回りに強制します。ポリゴンでないジオメトリは、変更されずに返されます。

Availability: 2.4.0

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数はM値に対応します。

関連情報

ST_ForcePolygonCCW , ST_IsPolygonCCW , ST_IsPolygonCW

Name

ST_ForceSFS — SFS 1.1ジオメトリタイプのみ使うようジオメトリに強制します。

Synopsis

geometry ST_ForceSFS(
geomA);

geometry geomA;

geometry ST_ForceSFS( | geomA, |
| version); |

geometry geomA;
text version;

説明

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

Name

ST_ForceRHR — ポリゴンの頂点の方向を右回りに強制します。

Synopsis

geometry ST_ForceRHR(
g);

geometry g;

説明

ポリゴンの頂点の方向はRight-Hand-Ruleに従います。この際、ポリゴンの領域は、境界線の右側になります。特に、外環は時計回りに強制され、内環は反時計回りに強制されます。この関数はST_ForcePolygonCW の別名です。

Note

上のRHRの定義は、他の文脈で使われる場合の定義と矛盾します。これを解消するには、ST_ForcePolygonCWを使うことを推奨します。

Enhanced: 2.0.0 多面体サーフェス対応が導入されました。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

例

SELECT ST_AsEWKT(
  ST_ForceRHR(
        'POLYGON((0 0 2, 5 0 2, 0 5 2, 0 0 2),(1 1 2, 1 3 2, 3 1 2, 1 1 2))'
  )
);
                                                  st_asewkt
--------------------------------------------------------------
 POLYGON((0 0 2,0 5 2,5 0 2,0 0 2),(1 1 2,3 1 2,1 3 2,1 1 2))
(1 row)

関連情報

ST_ForcePolygonCCW , ST_ForcePolygonCW , ST_IsPolygonCCW , ST_IsPolygonCW , ST_BuildArea, ST_Polygonize, ST_Reverse

Name

ST_ForceCurve — 該当する場合は、ジオメトリを曲線タイプに変換します。

Synopsis

geometry ST_ForceCurve(
g);

geometry g;

説明

可能ならジオメトリを曲線表現に変更します。ラインは複合曲線になり、マルチラインはマルチ曲線になり、ポリゴンは曲線ポリゴンになり、マルチポリゴンはマルチサーフェスになります。入力ジオメトリが既に曲線表現であるなら、入力と同じ値が返されます。

Availability: 2.2.0

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

SELECT ST_AsText(
  ST_ForceCurve(
        'POLYGON((0 0 2, 5 0 2, 0 5 2, 0 0 2),(1 1 2, 1 3 2, 3 1 2, 1 1 2))'::geometry
  )
);
                              st_astext
----------------------------------------------------------------------
 CURVEPOLYGON Z ((0 0 2,5 0 2,0 5 2,0 0 2),(1 1 2,1 3 2,3 1 2,1 1 2))
(1 row)

関連情報

ST_LineToCurve

Name

ST_LineToCurve — 曲線を含むジオメトリを線ジオメトリに変換します。

Synopsis

geometry ST_LineToCurve(
geomANoncircular);

geometry geomANoncircular;

説明

LINESTRING/POLYGONをCIRCULARSTRINGと曲線ポリゴンに変換します。等価の曲線を記述するのに必要なポイントが少なくなります。

Note

入力ラインストリング/ポリゴンが、曲線をはっきりと表現するのには不十分な場合には、関数は入力ジオメトリと同じものを返します。

Availability: 1.3.0

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

--  2次元の例
SELECT ST_AsText(ST_LineToCurve(foo.geom)) As curvedastext,ST_AsText(foo.geom) As non_curvedastext
    FROM (SELECT ST_Buffer('POINT(1 3)'::geometry, 3) As geom) As foo;

curvedatext                                                            non_curvedastext
--------------------------------------------------------------------|-----------------------------------------------------------------
CURVEPOLYGON(CIRCULARSTRING(4 3,3.12132034355964 0.878679656440359, | POLYGON((4 3,3.94235584120969 2.41472903395162,3.77163859753386 1.85194970290473,
1 0,-1.12132034355965 5.12132034355963,4 3))                        |  3.49440883690764 1.33328930094119,3.12132034355964 0.878679656440359,
                                                                    |  2.66671069905881 0.505591163092366,2.14805029709527 0.228361402466141,
                                                                    |  1.58527096604839 0.0576441587903094,1 0,
                                                                    |  0.414729033951621 0.0576441587903077,-0.148050297095264 0.228361402466137,
                                                                    |  -0.666710699058802 0.505591163092361,-1.12132034355964 0.878679656440353,
                                                                    |  -1.49440883690763 1.33328930094119,-1.77163859753386 1.85194970290472
                                                                    |  --ETC-- ,3.94235584120969 3.58527096604839,4 3))

--3次元の例
SELECT ST_AsText(ST_LineToCurve(geom)) As curved, ST_AsText(geom) AS not_curved
FROM (SELECT ST_Translate(ST_Force3D(ST_Boundary(ST_Buffer(ST_Point(1,3), 2,2))),0,0,3) AS geom) AS foo;

                        curved                        |               not_curved
------------------------------------------------------+---------------------------------------------------------------------
 CIRCULARSTRING Z (3 3 3,-1 2.99999999999999 3,3 3 3) | LINESTRING Z (3 3 3,2.4142135623731 1.58578643762691 3,1 1 3,
                                                      | -0.414213562373092 1.5857864376269 3,-1 2.99999999999999 3,
                                                      | -0.414213562373101 4.41421356237309 3,
                                                      | 0.999999999999991 5 3,2.41421356237309 4.4142135623731 3,3 3 3)
(1 row)

関連情報

ST_CurveToLine

Name

ST_Multi — マルチ系ジオメトリを返します。

Synopsis

geometry ST_Multi(
geom);

geometry geom;

説明

マルチ系ジオメトリを返します。ジオメトリが既にマルチ系なら変更せずに返します。

例

SELECT ST_AsText(ST_Multi('POLYGON ((10 30, 30 30, 30 10, 10 10, 10 30))'));
                    st_astext
    -------------------------------------------------
    MULTIPOLYGON(((10 30,30 30,30 10,10 10,10 30)))

関連情報

ST_AsText

Name

ST_LineExtend — 最後の辺と最初の辺を指定した距離だけ延長されたラインを返します。

Synopsis

geometry ST_LineExtend( | line, |
| distance_forward, |
| distance_backward=0.0); |

geometry line;
float distance_forward;
float distance_backward=0.0;

説明

最後の辺と最初の辺を指定した距離だけ延長されたラインを返します。距離が0の時は延長されません。非負の距離だけが許されます。ラインの最初 (と最後)の二つの異なるポイントで延長する方向を決めます。重複するポイントは無視します。

Availability: 3.4.0

例: 100,000メートル、方位45度で計算されるポイント

SELECT ST_AsText(ST_Project('POINT(0 0)'::geography, 100000, radians(45.0)));
--------------------------------------------
 POINT(0.635231029125537 0.639472334729198)

関連情報

ST_LocateAlong, ST_Project

Name

ST_Normalize — 標準的な形式に変えたジオメトリを返します。

Synopsis

geometry ST_Normalize(
geom);

geometry geom;

説明

正規化/標準化された形式のジオメトリを返します。ポリゴンの環における頂点の順序、ポリゴンにおける環の順序、複合ジオメトリにおける要素の順序が変更されることがあります。

ほとんどの場合、試験目的 (期待した結果と実際に得た結果との比較)でのみ使用します。

Availability: 2.3.0

例

SELECT ST_AsText(ST_Normalize(ST_GeomFromText(
  'GEOMETRYCOLLECTION(
    POINT(2 3),
    MULTILINESTRING((0 0, 1 1),(2 2, 3 3)),
    POLYGON(
      (0 10,0 0,10 0,10 10,0 10),
      (4 2,2 2,2 4,4 4,4 2),
      (6 8,8 8,8 6,6 6,6 8)
    )
  )'
)));
                                                                     st_astext
----------------------------------------------------------------------------------------------------------------------------------------------------
 GEOMETRYCOLLECTION(POLYGON((0 0,0 10,10 10,10 0,0 0),(6 6,8 6,8 8,6 8,6 6),(2 2,4 2,4 4,2 4,2 2)),MULTILINESTRING((2 2,3 3),(0 0,1 1)),POINT(2 3))
(1 row)

関連情報

ST_Equals,

Name

ST_Project — 始点から距離と方位で算出されたポイントを返します。

Synopsis

geometry ST_Project( | g1, |
| distance, |
| azimuth); |

geometry g1;
float distance;
float azimuth;

geometry ST_Project( | g1, |
| g2, |
| distance); |

geometry g1;
geometry g2;
float distance;

geography ST_Project( | g1, |
| distance, |
| azimuth); |

geography g1;
float distance;
float azimuth;

geography ST_Project( | g1, |
| g2, |
| distance); |

geography g1;
geography g2;
float distance;

説明

始点から測地線に沿って与えられた距離と方位で算出されたポイントを返します。測地問題と言われるものです。

2ポイント版は、方位を黙示的に定義するために一つ目のポイントから二つ目のポイントに向かう線を使い、距離は以前と同様に使います。

距離はメートルで与えます。負数に対応しています。

方位はラジアンで与えます。真北 (方位 0)から時計回りに増えます。 真北から時計回りに数えます。

北は方位ゼロ (0度)です

東は方位 π/2 (90度)です

南は方位 π (180度)です

西は方位 3π/2 (270度)です

負の方位値と2π (360度)を超える値に対応しています。

Availability: 2.0.0

Enhanced: 2.4.0 負の距離と非正規化方位を許容するようになりました。

Enhanced: 3.4.0 ジオメトリ引数と、azimuthを省略した2ポイント形式を許します。

例: 100,000メートル、方位45度で計算されるポイント

SELECT ST_AsText(ST_Project('POINT(0 0)'::geography, 100000, radians(45.0)));
--------------------------------------------
 POINT(0.635231029125537 0.639472334729198)

関連情報

ST_Azimuth, ST_Distance, PostgreSQL function radians()

Name

ST_QuantizeCoordinates — 座標値の最下位ビットを0にします。

Synopsis

geometry ST_QuantizeCoordinates ( | g, |
| prec_x, |
| prec_y, |
| prec_z, |
| prec_m); |

geometry g ;
int prec_x ;
int prec_y ;
int prec_z ;
int prec_m ;

説明

ST_QuantizeCoordinatesは、指定した小数点以下の桁数での座標値表現に必要なビット数 (N)を決定し、最大の有効ビット数N以外を0にします。結果の座標値は元の値を丸めますが、圧縮性が改善されます。これにより、ジオメトリカラムが compressible storage typeを使って、ディスク使用を劇的に減少させることができます。この関数によって、小数点以下の桁数の異なる指定が可能になります。指定されていない次元はx次元の精度を持つものとします。負の桁数は、小数点以上の桁数の参照と解釈されます (例: prec_x=-2は100付近の座標値を保存します)。

ST_QuantizeCoordinatesが生成する座標は、これらの座標を含むジオメトリや、ジオメトリ内のこれらの相対的な位置から独立しています。結果として、ジオメトリ間に存在するトポロジ関係は、この関数の使用によって影響を受けることはありません。この関数は、ジオメトリの内在的な精度より低い桁数では不正なジオメトリを生成する可能性があります。

Availability: 2.5.0

技術背景

PostGIS はすべての座標値を倍精度浮動小数点数として格納し、15桁の有効桁数を確実に表すことができます。ただし、PostGISでは、本質的に15桁未満のデータの管理ができます。例としては、小数点以下6桁の精度の地理座標として提供されるTigerデータがあります (故に、必要な有効桁数は、経度は9桁、緯度は8桁です)。

有効桁数が15の時、多数のありえる9桁の表現があります。倍精度浮動小数点数は52の明示的なビット数を座標の仮数部に使っています。有効桁数9桁では仮数部は30ビットだけ必要で、22ビットは有効ではありません。これらの値を好きなものにすることができ、結局は入力値を丸める数字となります。例えば、100.123456という値は100.123456000000, 100.123456000001および100.123456432199に近い数として表現されます。全ては等しく妥当で、これらの入力ではST_AsText(geom, 6)は同じ結果を返します。これらのビット数をあらゆる値にセットすることができるので、ST_QuantizeCoordinatesは無効ビットとなる22ビットに0をセットします。長い座標値のビット列では、連続的な0のブロックから、PostgreSQLによって効率的に圧縮されたパターンを生成します。

Note

ジオメトリのディスク上のサイズだけがST_QuantizeCoordinatesの影響を潜在的に受けます。ジオメトリのメモリ利用を報告するST_MemSizeは、ジオメトリに使われるディスク上のサイズにかかわらず同じ値を返します。

例

SELECT ST_AsText(ST_QuantizeCoordinates('POINT (100.123456 0)'::geometry, 4));
st_astext
-------------------------
POINT(100.123455047607 0)

WITH test AS (SELECT 'POINT (123.456789123456 123.456789123456)'::geometry AS geom)
SELECT
  digits,
  encode(ST_QuantizeCoordinates(geom, digits), 'hex'),
  ST_AsText(ST_QuantizeCoordinates(geom, digits))
FROM test, generate_series(15, -15, -1) AS digits;

digits  |                   encode                   |                st_astext
--------+--------------------------------------------+------------------------------------------
15      | 01010000005f9a72083cdd5e405f9a72083cdd5e40 | POINT(123.456789123456 123.456789123456)
14      | 01010000005f9a72083cdd5e405f9a72083cdd5e40 | POINT(123.456789123456 123.456789123456)
13      | 01010000005f9a72083cdd5e405f9a72083cdd5e40 | POINT(123.456789123456 123.456789123456)
12      | 01010000005c9a72083cdd5e405c9a72083cdd5e40 | POINT(123.456789123456 123.456789123456)
11      | 0101000000409a72083cdd5e40409a72083cdd5e40 | POINT(123.456789123456 123.456789123456)
10      | 0101000000009a72083cdd5e40009a72083cdd5e40 | POINT(123.456789123455 123.456789123455)
9       | 0101000000009072083cdd5e40009072083cdd5e40 | POINT(123.456789123418 123.456789123418)
8       | 0101000000008072083cdd5e40008072083cdd5e40 | POINT(123.45678912336 123.45678912336)
7       | 0101000000000070083cdd5e40000070083cdd5e40 | POINT(123.456789121032 123.456789121032)
6       | 0101000000000040083cdd5e40000040083cdd5e40 | POINT(123.456789076328 123.456789076328)
5       | 0101000000000000083cdd5e40000000083cdd5e40 | POINT(123.456789016724 123.456789016724)
4       | 0101000000000000003cdd5e40000000003cdd5e40 | POINT(123.456787109375 123.456787109375)
3       | 0101000000000000003cdd5e40000000003cdd5e40 | POINT(123.456787109375 123.456787109375)
2       | 01010000000000000038dd5e400000000038dd5e40 | POINT(123.45654296875 123.45654296875)
1       | 01010000000000000000dd5e400000000000dd5e40 | POINT(123.453125 123.453125)
0       | 01010000000000000000dc5e400000000000dc5e40 | POINT(123.4375 123.4375)
-1      | 01010000000000000000c05e400000000000c05e40 | POINT(123 123)
-2      | 01010000000000000000005e400000000000005e40 | POINT(120 120)
-3      | 010100000000000000000058400000000000005840 | POINT(96 96)
-4      | 010100000000000000000058400000000000005840 | POINT(96 96)
-5      | 010100000000000000000058400000000000005840 | POINT(96 96)
-6      | 010100000000000000000058400000000000005840 | POINT(96 96)
-7      | 010100000000000000000058400000000000005840 | POINT(96 96)
-8      | 010100000000000000000058400000000000005840 | POINT(96 96)
-9      | 010100000000000000000058400000000000005840 | POINT(96 96)
-10     | 010100000000000000000058400000000000005840 | POINT(96 96)
-11     | 010100000000000000000058400000000000005840 | POINT(96 96)
-12     | 010100000000000000000058400000000000005840 | POINT(96 96)
-13     | 010100000000000000000058400000000000005840 | POINT(96 96)
-14     | 010100000000000000000058400000000000005840 | POINT(96 96)
-15     | 010100000000000000000058400000000000005840 | POINT(96 96)

関連情報

ST_SnapToGrid

Name

ST_RemovePoint — ラインストリングからポイントを削除します。

Synopsis

geometry ST_RemovePoint( | linestring, |
| offset); |

geometry linestring;
integer offset;

説明

ラインストリングからポイントを削除します。インデックスは0始まりです。閉じたリングを開いたラインストリングに変えるのに使います。

Enhanced: 3.2.0

Availability: 1.1.0

説明この関数は3次元に対応し、Z値を削除しません。

例

閉じたライン (リング)の終点を削除するとラインが閉じなくなることが保証されています。geomがLINESTRINGであると仮定するします。

UPDATE sometable
        SET geom = ST_RemovePoint(geom, ST_NPoints(geom) - 1)
        FROM sometable
        WHERE ST_IsClosed(geom);

関連情報

ST_AddPoint, ST_NPoints, ST_NumPoints

Name

ST_RemoveRepeatedPoints — 重複ポイントを除いたジオメトリを返します。

Synopsis

geometry ST_RemoveRepeatedPoints( | geom, |
| tolerance); |

geometry geom;
float8 tolerance;

説明

重複ポイントを除いたジオメトリを返します。この関数は(MULTI)LINESTRING、(MULTI)POLYGON、MULTIPOINTのみを処理しますが、全ての種類のジオメトリを与えることができます。GEOMETRYCOLLECTIONの要素は個別に処理されます。LINESTRINGの端点は保持されます。

toleranceを指定した場合には、他の頂点との距離が許容距離内にある頂点は重複しているとみなされます。

Enhanced: 3.2.0

Availability: 2.2.0

説明この関数は多面体サーフェスに対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

例

SELECT ST_AsText( ST_RemoveRepeatedPoints( 'MULTIPOINT ((1 1), (2 2), (3 3), (2 2))'));
-------------------------
 MULTIPOINT(1 1,2 2,3 3)

SELECT ST_AsText( ST_RemoveRepeatedPoints( 'LINESTRING (0 0, 0 0, 1 1, 0 0, 1 1, 2 2)'));
---------------------------------
 LINESTRING(0 0,1 1,0 0,1 1,2 2)

例: ジオメトリコレクションの要素は個別に処理されます。

SELECT ST_AsText( ST_RemoveRepeatedPoints( 'GEOMETRYCOLLECTION (LINESTRING (1 1, 2 2, 2 2, 3 3), POINT (4 4), POINT (4 4), POINT (5 5))'));
------------------------------------------------------------------------------
 GEOMETRYCOLLECTION(LINESTRING(1 1,2 2,3 3),POINT(4 4),POINT(4 4),POINT(5 5))

例: 許容距離内にある繰り返しポイントの削除。

SELECT ST_AsText( ST_RemoveRepeatedPoints( 'LINESTRING (0 0, 0 0, 1 1, 5 5, 1 1, 2 2)', 2));
-------------------------
 LINESTRING(0 0,5 5,2 2)

関連情報

ST_Simplify

Name

ST_Reverse — 頂点の順序を逆にしたジオメトリを返します。

Synopsis

geometry ST_Reverse(
g1);

geometry g1;

説明

どのジオメトリでも使用可能です。頂点の順序を逆にします。

Enhanced: 2.4.0 曲線対応が導入されました。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

例

SELECT ST_AsText(geom) as line, ST_AsText(ST_Reverse(geom)) As reverseline
FROM
(SELECT ST_MakeLine(ST_Point(1,2),
                ST_Point(1,10)) As geom) as foo;
-- 結果
                line         |     reverseline
---------------------+----------------------
LINESTRING(1 2,1 10) | LINESTRING(1 10,1 2)

Name

ST_Segmentize — 与えた長さを超える線分を持たないよう変更したジオメトリ/ジオグラフィを返します。

Synopsis

geometry ST_Segmentize( | geom, |
| max_segment_length); |

geometry geom;
float max_segment_length;

geography ST_Segmentize( | geog, |
| max_segment_length); |

geography geog;
float max_segment_length;

説明

max_segment_lengthを超える長さの線分を持たないよう変更したジオメトリ/ジオグラフィを返します。長さは2次元で計算されます。線分は常に等長の線分に分割されます。

ジオメトリについては、最大長の単位は空間参照系の単位です。

ジオグラフィについては、最大長の単位はメートルです。距離は球面で計算します。追加される頂点は、線分の端点間で定まる球面の大円弧に沿うように作られます。

Note

この関数は長い線分を短くするだけです。最大長より短い線分を長くすることはしません。

Warning

長い線分を含む入力では、比較的短い max_segment_length を指定すると、非常に多くの頂点が追加される可能性があります。これは、引数が最大長ではなく線分数として誤って指定された場合に、意図せずに発生する可能性があります。

Availability: 1.2.2

Enhanced: 3.0.0 ジオメトリの分割において、現在は、同じ長さに分割しています

Enhanced: 2.3.0 ジオグラフィの分割において、現在は、同じ長さに分割しています

Enhanced: 2.1.0 ジオグラフィ対応が導入されました。

Changed: 2.1.0 ジオグラフィ対応の導入の結果、ST_Segmentize('LINESTRING(1 2, 3 4)', 0.5)とすると、あいまい関数エラーが発生します。入力ではジオメトリかジオグラフィかを確実に指定する必要があります。ST_GeomFromText、ST_GeogFromText、使いたい型へのキャスト (例: ST_Segmentize('LINESTRING(1 2, 3 4)'::geometry, 0.5) )を行います

例

ラインの分割。長い線分は均等に分割され、短い線分は分割されません。

SELECT ST_AsText(ST_Segmentize(
    'MULTILINESTRING((0 0, 0 1, 0 9),(1 10, 1 18))'::geometry,
        5 ) );
---------------------------------------------------
MULTILINESTRING((0 0,0 1,0 5,0 9),(1 10,1 14,1 18))

ポリゴンの分割:

SELECT ST_AsText(
        ST_Segmentize(('POLYGON((0 0, 0 8, 30 0, 0 0))'::geometry), 10));
-------------------------------------------------------
POLYGON((0 0,0 8,7.5 6,15 4,22.5 2,30 0,20 0,10 0,0 0))

2000キロメートルの最大線分長を使ったジオグラフィのラインの分割。頂点は、端点間をつなぐ大円弧に沿って追加されます。

SELECT ST_AsText(
        ST_Segmentize(('LINESTRING (0 0, 60 60)'::geography), 2000000));
-------------------------------------------------------------
LINESTRING(0 0,4.252632294621186 8.43596525986862,8.69579947419404 16.824093489701564,13.550465473227048 25.107950473646188,19.1066053508691 33.21091076089908,25.779290201459894 41.01711439406505,34.188839517966954 48.337222885886,45.238153936612264 54.84733442373889,60 60)

大円弧に沿って細分化されたジオグラフィのライン

関連情報

ST_LineSubstring

Name

ST_SetPoint — ラインストリングのポイントを与えられたポイントに置き換えます。

Synopsis

geometry ST_SetPoint( | linestring, |
| zerobasedposition, |
| point); |

geometry linestring;
integer zerobasedposition;
geometry point;

説明

ラインストリングのN番目を与えられたポイントに置き換えます。インデクスは0はじまりです。負のインデックス値を与えると末尾から数えます。-1は末尾のポイントを指します。これは、頂点が一つ動いた時に接続のリレーションシップを維持しようとする場合のトリガに特に便利です。

Availability: 1.1.0

Updated 2.3.0 : 添え字の負数

説明この関数は3次元に対応し、Z値を削除しません。

例

-- 最初のポイントを -1 3 から -1 1 に変更
SELECT ST_AsText(ST_SetPoint('LINESTRING(-1 2,-1 3)', 0, 'POINT(-1 1)'));
           st_astext
-----------------------
 LINESTRING(-1 1,-1 3)

-- ラインストリングの最後のポイントを変更 (このクエリでは3次元ラインストリングでやってみましょう)
SELECT ST_AsEWKT(ST_SetPoint(foo.geom, ST_NumPoints(foo.geom) - 1, ST_GeomFromEWKT('POINT(-1 1 3)')))
FROM (SELECT ST_GeomFromEWKT('LINESTRING(-1 2 3,-1 3 4, 5 6 7)') As geom) As foo;
           st_asewkt
-----------------------
LINESTRING(-1 2 3,-1 3 4,-1 1 3)

SELECT ST_AsText(ST_SetPoint(g, -3, p))
FROM ST_GEomFromText('LINESTRING(0 0, 1 1, 2 2, 3 3, 4 4)') AS g
        , ST_PointN(g,1) as p;
           st_astext
-----------------------
LINESTRING(0 0,1 1,0 0,3 3,4 4)

関連情報

ST_AddPoint, ST_NPoints, ST_NumPoints, ST_PointN, ST_RemovePoint

Name

ST_ShiftLongitude — 経度座標値を-180度から180度の範囲と0度から360度の範囲との二つの範囲を行き来するようシフトします。

Synopsis

geometry ST_ShiftLongitude(
geom);

geometry geom;

説明

ジオメトリの全てのポイント/頂点を読み、経度値が-180度から0度の範囲にあるのを180度から360度の範囲にシフトして、180度から360度の範囲にあるのを-180度から0度の範囲にシフトします。この関数は対称となりますので、-180度から180度の範囲のデータを0度から360度の範囲の表現にし、0度から360度の範囲のデータを-180度から180度の範囲の表現にします。

Note

この関数は、SRID 436 (WGS84地理座標系)のような緯度経度の座標値を持つデータの場合に限って使います。

Warning

1.3.4より前ではMULTIPOINTでは動作しないバグがありました。1.3.4以上ではMULTIPOINTでも動作します。

説明この関数は3次元に対応し、Z値を削除しません。

Enhanced: 2.0.0 多面体サーフェス対応とTIN対応が導入されました。

ご注意: この関数は2.0.0で"ST_Shift_Longitude"から名称変更しました。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

-- 単一ポイントの前方への変換
SELECT ST_AsText(ST_ShiftLongitude('SRID=4326;POINT(270 0)'::geometry))

st_astext
----------
POINT(-90 0)

-- 単一ポイントの逆方向への変換
SELECT ST_AsText(ST_ShiftLongitude('SRID=4326;POINT(-90 0)'::geometry))

st_astext
----------
POINT(270 0)

-- ラインストリングでは十分な座標値にのみ影響を与えます
SELECT ST_AsText(ST_ShiftLongitude('SRID=4326;LINESTRING(174 12, 182 13)'::geometry))

st_astext
----------
LINESTRING(174 12,-178 13)

関連情報

ST_WrapX

Name

ST_WrapX — ジオメトリをX値で回り込ませます。

Synopsis

geometry ST_WrapX( | geom, |
| wrap, |
| move); |

geometry geom;
float8 wrap;
float8 move;

説明

入力ジオメトリを分割して、全ての結果要素が「回り込み ('wrap')」線から’move'パラメータで決められた方向、すなわち、右側 ('move'が負数)または左側 ('move'が正数)に全ての要素が落ちるように移動させ、最後に再結合します。

Note

経度緯度入力を「再センタリング」して、対象地物が一方からもう一方に飛ばないようにするのに使えます。

Availability: 2.3.0 GEOSが必要です。

説明この関数は3次元に対応し、Z値を削除しません。

例

-- 与えられたジオメトリのうち、
-- バウンディングボックスが完全にx=0の左側にあるもののについて
-- X値に360を足して移動させます。
select ST_WrapX(the_geom, 0, 360);

-- 与えられたジオメトリのうち、
-- バウンディングボックスが完全にx=-30の左側にあるもののについて
-- X値に360を足して移動させます。
select ST_WrapX(the_geom, -30, 360);

関連情報

ST_ShiftLongitude

Name

ST_SnapToGrid — 入力ジオメトリの全ての点を規則的なグリッドにスナップします。

Synopsis

geometry ST_SnapToGrid( | geomA, |
| originX, |
| originY, |
| sizeX, |
| sizeY); |

geometry geomA;
float originX;
float originY;
float sizeX;
float sizeY;

geometry ST_SnapToGrid( | geomA, |
| sizeX, |
| sizeY); |

geometry geomA;
float sizeX;
float sizeY;

geometry ST_SnapToGrid( | geomA, |
| size); |

geometry geomA;
float size;

geometry ST_SnapToGrid( | geomA, |
| pointOrigin, |
| sizeX, |
| sizeY, |
| sizeZ, |
| sizeM); |

geometry geomA;
geometry pointOrigin;
float sizeX;
float sizeY;
float sizeZ;
float sizeM;

説明

1, 2, 3番目の形式では、入力ジオメトリの全てのポイントを原点とセルサイズを定めたグリッドにスナップします。同じセルに落ちた、連続するポイントを削除します。引数ジオメトリのジオメトリタイプを定義できないポイントしか残らなかった場合は、NULLを返します。コレクション内で崩壊したジオメトリはそこから削除されます。精度を落とすのに使います。

4番目の形式は、1.1.0で導入されました。入力ジオメトリの全てのポイントを原点 (第2引数で指定するもので、ポイントでなければなりません)とセルサイズを定めたグリッドにスナップします。グリッドにスナップしたくない次元についてはサイズに0を指定します。

Note

返されるジオメトリは単純性が失われているかも知れません (ST_IsSimpleを参照してください)。

Note

1.1.0版より前では、この関数は常に2次元ジオメトリを返しました。1.1.0版からは、返されるジオメトリの次元数は、入力値のうちで手のつけられていない最大の次元と同じになります。全てのグリッドの次元を定義するには、第2引数にジオメトリを取る形式を使って下さい。

Availability: 1.0.0RC1

Availability: 1.1.0 - Z値とM値に対応しました

説明この関数は3次元に対応し、Z値を削除しません。

例

-- 10^-3の精度のグリッドにジオメトリをスナップ
UPDATE mytable
   SET geom = ST_SnapToGrid(geom, 0.001);

SELECT ST_AsText(ST_SnapToGrid(
                        ST_GeomFromText('LINESTRING(1.1115678 2.123, 4.111111 3.2374897, 4.11112 3.23748667)'),
                        0.001)
                );
                          st_astext
-------------------------------------
 LINESTRING(1.112 2.123,4.111 3.237)
 -- 4次元ジオメトリをスナップ
SELECT ST_AsEWKT(ST_SnapToGrid(
        ST_GeomFromEWKT('LINESTRING(-1.1115678 2.123 2.3456 1.11111,
                4.111111 3.2374897 3.1234 1.1111, -1.11111112 2.123 2.3456 1.1111112)'),
 ST_GeomFromEWKT('POINT(1.12 2.22 3.2 4.4444)'),
 0.1, 0.1, 0.1, 0.01) );
                                                                  st_asewkt
------------------------------------------------------------------------------
 LINESTRING(-1.08 2.12 2.3 1.1144,4.12 3.22 3.1 1.1144,-1.08 2.12 2.3 1.1144)

-- 4次元ジオメトリ - ST_SnapToGrid(geom,size)はX値とY値に触るだけで、M値とZ値はそのままです
SELECT ST_AsEWKT(ST_SnapToGrid(ST_GeomFromEWKT('LINESTRING(-1.1115678 2.123 3 2.3456,
                4.111111 3.2374897 3.1234 1.1111)'),
           0.01)      );
                                                st_asewkt
---------------------------------------------------------
 LINESTRING(-1.11 2.12 3 2.3456,4.11 3.24 3.1234 1.1111)

関連情報

ST_Snap, ST_AsEWKT, ST_AsText, ST_GeomFromText, ST_GeomFromEWKT, ST_Simplify

Name

ST_Snap — 入力ジオメトリの辺と頂点を参照ジオメトリの頂点にスナップします。

Synopsis

geometry ST_Snap( | input, |
| reference, |
| tolerance); |

geometry input;
geometry reference;
float tolerance;

説明

ジオメトリの頂点と辺を、もう一つのジオメトリの頂点にスナップします。スナップが実行される位置を制御するにはスナップ距離許容値を使います。結果ジオメトリはスナップされた頂点を持つ入力ジオメトリです。スナップが発生しなかった場合には、入力ジオメトリが変更されずに返されます。

一つのジオメトリからもう一つへの変換によって、近傍エッジ (ノード生成とインタセクション計算で問題を引き起こします)を除くことになり、オーバレイ演算のロバスト性が改善されます。

あまりに多数のスナップを行った場合には、生成されるトポロジが不正になる可能性があります。いつスナップが安全かを判定するために、ヒューリスティックにスナップされた頂点の数と位置が決めるしかありません。しかし、省略された潜在的なスナップになりえます。

Note

返されるジオメトリは単純性が失われているかも知れません (ST_IsSimpleを参照してください)し、妥当性が失われているかも知れません (ST_IsValidを参照して下さい)。

GEOSモジュールで実現しています。

Availability: 2.0.0

例

マルチポリゴンとラインストリング (スナップ前)

ラインストリングに1.01の許容距離でマルチポリゴンをスナップします。新しいマルチポリゴンはラインストリングにつながります。

SELECT ST_AsText(ST_Snap(poly,line, ST_Distance(poly,line)*1.01)) AS polysnapped
FROM (SELECT
   ST_GeomFromText('MULTIPOLYGON(
     ((26 125, 26 200, 126 200, 126 125, 26 125 ),
      ( 51 150, 101 150, 76 175, 51 150 )),
      (( 151 100, 151 200, 176 175, 151 100 )))') As poly,
       ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line
        ) As foo;

                             polysnapped
---------------------------------------------------------------------
 MULTIPOLYGON(((26 125,26 200,126 200,126 125,101 100,26 125),
 (51 150,101 150,76 175,51 150)),((151 100,151 200,176 175,151 100)))

マルチラインストリングに1.25の許容距離でマルチポリゴンをスナップします。新しいマルチポリゴンはラインストリングにつながります。

SELECT ST_AsText(
    ST_Snap(poly,line, ST_Distance(poly,line)*1.25)
  ) AS polysnapped
FROM (SELECT
  ST_GeomFromText('MULTIPOLYGON(
    (( 26 125, 26 200, 126 200, 126 125, 26 125 ),
      ( 51 150, 101 150, 76 175, 51 150 )),
      (( 151 100, 151 200, 176 175, 151 100 )))') As poly,
       ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line
        ) As foo;

                             polysnapped
---------------------------------------------------------------------
MULTIPOLYGON(((5 107,26 200,126 200,126 125,101 100,54 84,5 107),
(51 150,101 150,76 175,51 150)),((151 100,151 200,176 175,151 100)))

元のマルチポリゴンに1.01の許容距離でラインストリングをスナップします。新しいラインストリングはマルチポリゴンにつながります。

SELECT ST_AsText(
   ST_Snap(line, poly, ST_Distance(poly,line)*1.01)
  ) AS linesnapped
FROM (SELECT
  ST_GeomFromText('MULTIPOLYGON(
     ((26 125, 26 200, 126 200, 126 125, 26 125),
      (51 150, 101 150, 76 175, 51 150 )),
      ((151 100, 151 200, 176 175, 151 100)))') As poly,
       ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line
        ) As foo;

              linesnapped
----------------------------------------
 LINESTRING(5 107,26 125,54 84,101 100)

元のマルチポリゴンに1.25の許容距離でラインストリングをスナップします。新しいラインストリングはマルチポリゴンにつながります。

SELECT ST_AsText(
 ST_Snap(line, poly, ST_Distance(poly,line)*1.25)
  ) AS linesnapped
FROM (SELECT
  ST_GeomFromText('MULTIPOLYGON(
     (( 26 125, 26 200, 126 200, 126 125, 26 125 ),
      (51 150, 101 150, 76 175, 51 150 )),
      ((151 100, 151 200, 176 175, 151 100 )))') As poly,
       ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line
        ) As foo;
              linesnapped
---------------------------------------
LINESTRING(26 125,54 84,101 100)

関連情報

ST_SnapToGrid

Name

ST_SwapOrdinates — 与えられたジオメトリにおいて与えられた座標の値を入れ替えたジオメトリを返します。

Synopsis

geometry ST_SwapOrdinates( | geom, |
| ords); |

geometry geom;
cstring ords;

説明

与えられたジオメトリにおいて与えられた座標の値を入れ替えたジオメトリを返します。

ords引数は2文字の文字列で、入れ替える座標名を示します。座標名はx, y, z, mが有効です。

Availability: 2.2.0

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数はM値に対応します。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

-- M値を2倍にする
-- (訳注: M値の拡大縮小はST_Scaleだけではできません)
SELECT ST_AsText(
  ST_SwapOrdinates(
    ST_Scale(
      ST_SwapOrdinates(g,'xm'),
      2, 1
    ),
  'xm')
) FROM ( SELECT 'POINT ZM (0 0 0 2)'::geometry g ) foo;
     st_astext
--------------------
 POINT ZM (0 0 0 4)

関連情報

ST_FlipCoordinates

ジオメトリ検証

Abstract

これらの関数は、ジオメトリがOGC SFS標準として妥当かどうかをテストします。また、不正となった場合の種類と位置に関する情報の提供も行います。不正なジオメトリから妥当なジオメトリを生成する機能もあります。

Name

ST_IsValid — ジオメトリが2次元で整形されているかのテスト。

Synopsis

boolean ST_IsValid(
g);

geometry g;

boolean ST_IsValid( | g, |
| flags); |

geometry g;
integer flags;

説明

ST_Geometry値が整形式であり、2次元で妥当かどうかをOGC規則に沿ってテストします。3次元と4次元のジオメトリでは、評価は2次元で行います。ジオメトリが不正なら、PostgreSQL NOTICEが出力され、不正である理由の詳細が示されます。

flagsパラメータを持つ版が対応する値についてはST_IsValidDetailで説明しています。

ジオメトリ評価に関する詳細情報についてはthe section called “ジオメトリ検証”を参照してください。

Note

SQL-MMでは、ST_IsValid(NULL)は0を返しますが、PostGISではNULLを返します。

GEOSモジュールで実現しています。

フラグを受け付ける形式は、2.0.0から有効になりました。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.9

Note

OGC-SFSもSQL-MMもST_IsValidでフラグ引数を含む仕様になっていません。フラグはPostGIS独自拡張です。

例

SELECT ST_IsValid(ST_GeomFromText('LINESTRING(0 0, 1 1)')) As good_line,
        ST_IsValid(ST_GeomFromText('POLYGON((0 0, 1 1, 1 2, 1 1, 0 0))')) As bad_poly
-- 結果
NOTICE:  Self-intersection at or near point 0 0
 good_line | bad_poly
-----------+----------
 t         | f

関連情報

ST_IsSimple, ST_IsValidReason, ST_IsValidDetail,

Name

ST_IsValidDetail — ジオメトリが妥当か、妥当でないなら理由と位置をそれぞれ示すvalid_detail行を返します。

Synopsis

valid_detail ST_IsValidDetail( | geom, |
| flags); |

geometry geom;
integer flags;

説明

valid_detail行を返します。これには、ジオメトリが妥当かどうかを示す真偽値 (valid)、不正である理由を示す文字列 (reason)、不正である位置を指摘するジオメトリ (location)からなります。

不正ジオメトリの詳細報告の生成をするST_IsValidとST_IsValidReasonの組み合わせを改善するために使います。

任意パラメータflagsはビットフィールドです。次の値を持つことができます。

0: 通常のOGC SFS評価モデルを使用します。

1: ある種の自己接触リング (逆の外リングと逆の穴リング)を妥当とします。この評価モデルはこれらのツールで使われるため「ESRIフラグ」とも言われます。OGCモデルでは不正とされることに注意してください。

GEOSモジュールで実現しています。

Availability: 2.0.0

例

-- 成功する5個組の試験から3個が拒否
SELECT gid, reason(ST_IsValidDetail(geom)), ST_AsText(location(ST_IsValidDetail(geom))) as location
FROM
(SELECT ST_MakePolygon(ST_ExteriorRing(e.buff), array_agg(f.line)) As geom, gid
FROM (SELECT ST_Buffer(ST_Point(x1*10,y1), z1) As buff, x1*10 + y1*100 + z1*1000 As gid
        FROM generate_series(-4,6) x1
        CROSS JOIN generate_series(2,5) y1
        CROSS JOIN generate_series(1,8) z1
        WHERE x1 > y1*0.5 AND z1 < x1*y1) As e
        INNER JOIN (SELECT ST_Translate(ST_ExteriorRing(ST_Buffer(ST_Point(x1*10,y1), z1)),y1*1, z1*2) As line
        FROM generate_series(-3,6) x1
        CROSS JOIN generate_series(2,5) y1
        CROSS JOIN generate_series(1,10) z1
        WHERE x1 > y1*0.75 AND z1 < x1*y1) As f
ON (ST_Area(e.buff) > 78 AND ST_Contains(e.buff, f.line))
GROUP BY gid, e.buff) As quintuplet_experiment
WHERE ST_IsValid(geom) = false
ORDER BY gid
LIMIT 3;

 gid  |      reason       |  location
------+-------------------+-------------
 5330 | Self-intersection | POINT(32 5)
 5340 | Self-intersection | POINT(42 5)
 5350 | Self-intersection | POINT(52 5)

 -- 単純な例
SELECT * FROM ST_IsValidDetail('LINESTRING(220227 150406,2220227 150407,222020 150410)');

 valid | reason | location
-------+--------+----------
 t     |        |

関連情報

ST_IsValid, ST_IsValidReason

Name

ST_IsValidReason — ジオメトリが妥当か否かを示す文字列を返し、不正な場合は理由を返します。

Synopsis

text ST_IsValidReason(
geomA);

geometry geomA;

text ST_IsValidReason( | geomA, |
| flags); |

geometry geomA;
integer flags;

説明

ジオメトリが妥当かどうか、不正な場合はその理由を示す文字列を返します。

不正なジオメトリと理由の詳細報告を生成するのに、ST_IsValidと併用します。

許されるflagsは、 ST_IsValidDetailにあります。

GEOSモジュールで実現しています。

Availability: 1.4

Availability: 2.0 フラグを取る形式。

例

-- 不正な蝶ネクタイのポリゴン
SELECT ST_IsValidReason(
    'POLYGON ((100 200, 100 100, 200 200,
     200 100, 100 200))'::geometry) as validity_info;
validity_info
--------------------------
Self-intersection[150 150]

-- 成功のする個組の試験から最初の3個が拒否
SELECT gid, ST_IsValidReason(geom) as validity_info
FROM
(SELECT ST_MakePolygon(ST_ExteriorRing(e.buff), array_agg(f.line)) As geom, gid
FROM (SELECT ST_Buffer(ST_Point(x1*10,y1), z1) As buff, x1*10 + y1*100 + z1*1000 As gid
        FROM generate_series(-4,6) x1
        CROSS JOIN generate_series(2,5) y1
        CROSS JOIN generate_series(1,8) z1
        WHERE x1 > y1*0.5 AND z1 < x1*y1) As e
        INNER JOIN (SELECT ST_Translate(ST_ExteriorRing(ST_Buffer(ST_Point(x1*10,y1), z1)),y1*1, z1*2) As line
        FROM generate_series(-3,6) x1
        CROSS JOIN generate_series(2,5) y1
        CROSS JOIN generate_series(1,10) z1
        WHERE x1 > y1*0.75 AND z1 < x1*y1) As f
ON (ST_Area(e.buff) > 78 AND ST_Contains(e.buff, f.line))
GROUP BY gid, e.buff) As quintuplet_experiment
WHERE ST_IsValid(geom) = false
ORDER BY gid
LIMIT 3;

 gid  |      validity_info
------+--------------------------
 5330 | Self-intersection [32 5]
 5340 | Self-intersection [42 5]
 5350 | Self-intersection [52 5]

 -- 単純な例
SELECT ST_IsValidReason('LINESTRING(220227 150406,2220227 150407,222020 150410)');

 st_isvalidreason
------------------
 Valid Geometry

関連情報

ST_IsValid, ST_Summary

Name

ST_MakeValid — 頂点を失うことなしに不正なジオメトリを妥当なジオメトリにしようと試みます。

Synopsis

geometry ST_MakeValid(
input);

geometry input;

geometry ST_MakeValid( | input, |
| params); |

geometry input;
text params;

説明

与えられた不正なジオメトリを、入力ジオメトリの頂点を捨てずに、妥当な表現で生成しようとします。妥当なジオメトリは変更せずに返します。

対応する入力はPOINTS, MULTIPOINTS, LINESTRING, MULTILINESTRING, POLYGON, MULTIPOLYGON, GEOMETRYCOLLECTIONおよびそれらの混交したものです。

完全または部分的な次元崩壊の場合には、出力ジオメトリは、同次元まはた低い次元のジオメトリのコレクションか、低い次元のジオメトリコレクションになります。

単一ポリゴンは、自己インタセクトがある場合には、マルチポリゴンになります。

params引数は、妥当なジオメトリを構築するために使うメソッドを選択するための任意文字列を与えるのに使えます。任意文字列は"method=linework|structure keepcollapsed=true|false"という書式に従います。"params"引数が無い場合には、"linework"アルゴリズムがデフォルトとして使われます。

"method"キーに対して取り得る値は二つあります。

"linework"は従来のアルゴリズムです。はじめに全てのラインを抽出し、線画からノードを生成して、そこから妥当なジオメトリを構築します。

"structure"は、リングの内と外の間を識別して、外リングを結合し、全ての内リングとの差を取ることで新しいジオメトリを構築します。

"keepcollapsed"キーは"structure"アルゴリズムでのみ有効です。"true"または"false"を取ります。"false"が指定された場合には、1点のLINESTRING等のような低い次元に崩壊したジオメトリ要素が出てきます。

GEOSモジュールで実現しています。

Availability: 2.0.0

Enhanced: 2.0.1 速度の改善

Enhanced: 2.1.0 GEOMETRYCOLLECTIONとMULTIPOINTの対応の追加

Enhanced: 3.1.0 NaN値を持つ座標の削除が追加されました。

Enhanced: 3.2.0, アルゴリズムに関する任意パラメータ'linework'と'structure'が追加されました。GEOS 3.10.0以上が必要です。

説明この関数は3次元に対応し、Z値を削除しません。

例

before_geom: 二つのオーバラップしているポリゴンからなるマルチポリゴン

after_geom: 4 つのオーバーラップしないポリゴンのマルチポリゴン

after_geom_structure: 一つのオーバラップしないポリゴンからなるマルチポリゴン

SELECT f.geom AS before_geom, ST_MakeValid(f.geom) AS after_geom, ST_MakeValid(f.geom, 'method=structure') AS after_geom_structure
FROM (SELECT 'MULTIPOLYGON(((186 194,187 194,188 195,189 195,190 195,
191 195,192 195,193 194,194 194,194 193,195 192,195 191,
195 190,195 189,195 188,194 187,194 186,14 6,13 6,12 5,11 5,
10 5,9 5,8 5,7 6,6 6,6 7,5 8,5 9,5 10,5 11,5 12,6 13,6 14,186 194)),
((150 90,149 80,146 71,142 62,135 55,128 48,119 44,110 41,100 40,
90 41,81 44,72 48,65 55,58 62,54 71,51 80,50 90,51 100,
54 109,58 118,65 125,72 132,81 136,90 139,100 140,110 139,
119 136,128 132,135 125,142 118,146 109,149 100,150 90)))'::geometry AS geom) AS f;

before_geom: 六つのオーバラップしているポリゴンからなるマルチポリゴン

after_geom: 14個のオーバラップしていないポリゴンからなるマルチポリゴン

after_geom_structure: 一つのオーバラップしないポリゴンからなるマルチポリゴン

SELECT c.geom AS before_geom,
                    ST_MakeValid(c.geom) AS after_geom,
                    ST_MakeValid(c.geom, 'method=structure') AS after_geom_structure
        FROM (SELECT 'MULTIPOLYGON(((91 50,79 22,51 10,23 22,11 50,23 78,51 90,79 78,91 50)),
                  ((91 100,79 72,51 60,23 72,11 100,23 128,51 140,79 128,91 100)),
                  ((91 150,79 122,51 110,23 122,11 150,23 178,51 190,79 178,91 150)),
                  ((141 50,129 22,101 10,73 22,61 50,73 78,101 90,129 78,141 50)),
                  ((141 100,129 72,101 60,73 72,61 100,73 128,101 140,129 128,141 100)),
                  ((141 150,129 122,101 110,73 122,61 150,73 178,101 190,129 178,141 150)))'::geometry AS geom) AS c;

例

SELECT ST_AsText(ST_MakeValid(
    'LINESTRING(0 0, 0 0)',
    'method=structure keepcollapsed=true'
    ));

 st_astext
------------
 POINT(0 0)

SELECT ST_AsText(ST_MakeValid(
    'LINESTRING(0 0, 0 0)',
    'method=structure keepcollapsed=false'
    ));

    st_astext
------------------
 LINESTRING EMPTY

関連情報

ST_IsValid, ST_Collect, ST_CollectionExtract

空間参照系関数

Abstract

これらの関数はspatial_ref_sysテーブルで定義されているジオメトリの空間参照系と連携します。

Name

ST_InverseTransformPipeline — 定義した座標変換パイプラインの逆変換を使って、異なる空間参照系に座標値を変換した新しいジオメトリを返します。

Synopsis

geometry ST_InverseTransformPipeline( | geom, |
| pipeline, |
| to_srid); |

geometry geom;
text pipeline;
integer to_srid;

説明

定義した座標変換パイプラインの逆方向への変換を使って、異なる空間参照系に座標値を変換した新しいジオメトリを返します。

変換パイプラインの記述に関する詳細についてはST_TransformPipelineを参照して下さい。

Availability: 3.4.0

入力ジオメトリのSRIDは無視され、任意パラメータ to_srid から値が提供されていない場合には出力ジオメトリのSRIDは0に設定されます。ST_TransformPipelineを使うときには、パイプラインが順方向に実行されます。`ST_InverseTransformPipeline()`を使うと、パイプラインは逆方向に実行されます。

パイプラインを用いた変換はST_Transformの特別版です。ほとんどの場合、`ST_Transform`は、座標系間の変換において正しい演算子を選択します。こちらの方が推奨されます。

例

EPSG:16031変換を使ったWGS 84 経度緯度から UTM31Nへの変換

-- 逆方向
SELECT ST_AsText(ST_InverseTransformPipeline('POINT(426857.9877165967 5427937.523342293)'::geometry,
  'urn:ogc:def:coordinateOperation:EPSG::16031')) AS wgs_geom;

          wgs_geom
----------------------------
 POINT(2 48.99999999999999)
(1 row)

GDA2020の例。

-- 変換パイプラインの自動選択でST_Transformを使用します
SELECT ST_AsText(ST_Transform('SRID=4939;POINT(143.0 -37.0)'::geometry, 7844)) AS gda2020_auto;

                 gda2020_auto
-----------------------------------------------
 POINT(143.00000635638918 -36.999986706128176)
(1 row)

関連情報

ST_Transform, ST_TransformPipeline

Name

ST_SetSRID — ジオメトリにSRIDを設定します。

Synopsis

geometry ST_SetSRID( | geom, |
| srid); |

geometry geom;
integer srid;

説明

ジオメトリのSRIDを特定の整数値に設定します。クエリのためのバウンディングボックスを生成する際に使います。

Note

この関数はジオメトリを変換せず、ジオメトリが仮定する空間参照系を定義するメタデータを設定するだけです。ジオメトリを新しい投影法に変換したい場合はST_Transformを使います。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

-- ポイントをWGS84経度緯度に設定 --

SELECT ST_SetSRID(ST_Point(-123.365556, 48.428611),4326) As wgs84long_lat;
-- EWKT表現 (ST_AsEWKTでラップして表示します) --
SRID=4326;POINT(-123.365556 48.428611)

-- ポイントをWGS84経度緯度に設定したうえで、WEBメルカトル(球面メルカトル)に変換 --

SELECT ST_Transform(ST_SetSRID(ST_Point(-123.365556, 48.428611),4326),3785) As spere_merc;
-- EWKT表現 (ST_AsEWKTでラップします) --
SRID=3785;POINT(-13732990.8753491 6178458.96425423)

関連情報

the section called “空間参照系”, ST_SRID, ST_Transform, UpdateGeometrySRID

Name

ST_SRID — ジオメトリの空間参照系識別子を返します。

Synopsis

integer ST_SRID(
g1);

geometry g1;

説明

ST_Geometryのspatial_ref_sysテーブルで定義されている空間参照系の識別番号を返します。the section called “空間参照系”を参照して下さい。

Note

spatial_ref_sysテーブルはPostGISが知る参照系の全てのカタログを作っていて、ある空間参照系から他の空間参照系に変換するために使われます。ジオメトリの変換を予定している場合は正しい空間参照系の識別番号を持っているか確認することは重要です。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.1

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.5

説明このメソッドは曲線ストリングと曲線に対応しています。

例

SELECT ST_SRID(ST_GeomFromText('POINT(-71.1043 42.315)',4326));
    -- 結果 --
    4326

関連情報

the section called “空間参照系”, ST_SetSRID, ST_Transform, ST_SRID, ST_SRID

Name

ST_Transform — 異なる空間参照系に投影変換された新しいジオメトリを返します。

Synopsis

geometry ST_Transform( | g1, |
| srid); |

geometry g1;
integer srid;

geometry ST_Transform( | geom, |
| to_proj); |

geometry geom;
text to_proj;

geometry ST_Transform( | geom, |
| from_proj, |
| to_proj); |

geometry geom;
text from_proj;
text to_proj;

geometry ST_Transform( | geom, |
| from_proj, |
| to_srid); |

geometry geom;
text from_proj;
integer to_srid;

説明

異なる空間参照系に投影変換された新しいジオメトリを返します。変換先空間参照系であるto_sridは、妥当なSRID整数パラメータ (spatial_ref_sysにあるということ)です。他にも、to_projとfrom_projにPROJ.4文字列で定義された空間参照系を指定することができますが、最適化されません。変換先空間参照系がSRIDの代わりにPROJ.4文字列で表現されている場合には、出力ジオメトリのSRIDは0になります。from_projを使う場合には、入力ジオメトリは定義されたSRIDを持っていなければなりません。

ST_TransformはしばしばST_SetSRIDと混同されます。ST_Transformは実際にジオメトリの座標を、ある空間参照系から他のものに変換します。ST_SetSRIDは単にジオメトリのSRIDを変更するだけです。

ST_Transformは変換元空間参照系と変換先空間参照系に与える適切な変換パイプラインを自動的に選択します。特定の変換法を使用するにはST_TransformPipelineを使います。

Note

PostGISはPROJ対応でコンパイルする必要があります。PROJ対応でコンパイルしたかを確認するにはPostGIS_Full_Versionを使います。

Note

一つ以上の変換を行う場合は、インデクスの利点を得るために、使用する変換に関する関数インデクスを持つと便利です。

Note

1.3.4より前では、曲線を含むジオメトリで使用すると、この関数はクラッシュします。これは1.3.4以上で訂正されています。

Enhanced: 2.0.0 多面体サーフェス対応が導入されました。

Enhanced: 2.3.0 直接のPROJ.4文字列への対応が導入されました。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.6

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は多面体サーフェスに対応しています。

例

マサチューセッツ州平面座標系 (アメリカ測量フィート)をWGS84経度緯度に変更します。

SELECT ST_AsText(ST_Transform(ST_GeomFromText('POLYGON((743238 2967416,743238 2967450,
  743265 2967450,743265.625 2967416,743238 2967416))',2249),4326)) As wgs_geom;

 wgs_geom
---------------------------
 POLYGON((-71.1776848522251 42.3902896512902,-71.1776843766326 42.3903829478009,
-71.1775844305465 42.3903826677917,-71.1775825927231 42.3902893647987,-71.177684
8522251 42.3902896512902));
(1 row)

-- 3次元曲線ストリングの例
SELECT ST_AsEWKT(ST_Transform(ST_GeomFromEWKT('SRID=2249;CIRCULARSTRING(743238 2967416 1,743238 2967450 2,743265 2967450 3,743265.625 2967416 3,743238 2967416 4)'),4326));

         st_asewkt
--------------------------------------------------------------------------------------
 SRID=4326;CIRCULARSTRING(-71.1776848522251 42.3902896512902 1,-71.1776843766326 42.3903829478009 2,
 -71.1775844305465 42.3903826677917 3,
 -71.1775825927231 42.3902893647987 3,-71.1776848522251 42.3902896512902 4)

部分関数インデクスを作る例です。全てのジオメトリが入っているとは確信できないテーブルのためには、スペースの節約とインデクスを小さく効率的にするために、NULLジオメトリを無視する部分インデクスを使うのが最善です。

CREATE INDEX idx_geom_26986_parcels
  ON parcels
  USING gist
  (ST_Transform(geom, 26986))
  WHERE geom IS NOT NULL;

PROJ.4テキストを使って、独自の空間参照系に投影変換する例です。

-- 独自の心射方位図法を使って北極付近の二つのポリゴンのインタセクションを探します
-- http://boundlessgeo.com/2012/02/flattening-the-peel/ を参照して下さい。
 WITH data AS (
   SELECT
     ST_GeomFromText('POLYGON((170 50,170 72,-130 72,-130 50,170 50))', 4326) AS p1,
     ST_GeomFromText('POLYGON((-170 68,-170 90,-141 90,-141 68,-170 68))', 4326) AS p2,
     '+proj=gnom +ellps=WGS84 +lat_0=70 +lon_0=-160 +no_defs'::text AS gnom
 )
 SELECT ST_AsText(
   ST_Transform(
     ST_Intersection(ST_Transform(p1, gnom), ST_Transform(p2, gnom)),
   gnom, 4326))
 FROM data;
                                          st_astext
 --------------------------------------------------------------------------------
  POLYGON((-170 74.053793645338,-141 73.4268621378904,-141 68,-170 68,-170 74.053793645338))

変換の挙動の設定

グリッドシフトを含む座標変換は、ときどき失敗します。たとえば、PROJ.4にグリッドシフトファイルを付けてビルドされていなかった場合や、座標がグリッドシフト定義の範囲内に無い、といった場合です。デフォルトでは、PostGISはグリッドシフトファイルが無い場合はエラーを投げますが、この挙動は、PROJ.4 テキストのto_proj値の変更を試みたり、spatial_ref_sysテーブルのproj4text値を変更したりすることで、SRID毎の原則を設定することができます。

たとえば、proj4textパラメータ +datum=NAD87 は次に示す+nadgridsパラメータの短縮形です。

+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat

接頭辞@は、ファイルが無くてもエラー報告をしないという意味ですが、適切だった (発見されてオーバラップした)ファイルがないままリストの終わりに達した場合はエラーが出ます。

逆に、少なくとも標準的なファイルが確実にあって欲しいけれども、該当が無いまま全てのファイルが走査された場合に、NULL変換としたいなら、次が使えます。

+nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat,null

NULLグリッドシフトファイルは、世界全体をカバーして、シフトを行わない、妥当なグリッドシフトファイルです。 完全な例のために、正しい範囲にないSRID 4267への変換でエラーが投げられないようPostGISを変えたいなら、次のようにします。

UPDATE spatial_ref_sys SET proj4text = '+proj=longlat +ellps=clrk66 +nadgrids=@conus,@alaska,@ntv2_0.gsb,@ntv1_can.dat,null +no_defs' WHERE srid = 4267;

関連情報

the section called “空間参照系”, ST_SetSRID, ST_SRID, UpdateGeometrySRID, ST_TransformPipeline

Name

ST_TransformPipeline — 定義されている座標変換パイプラインを使用して異なる空間参照系に変換された新しいジオメトリを返します。

Synopsis

geometry ST_TransformPipeline( | g1, |
| pipeline, |
| to_srid); |

geometry g1;
text pipeline;
integer to_srid;

説明

定義されている座標変換パイプラインを使用して異なる空間参照系に変換された新しいジオメトリを返します。

変換パイプラインは次の文字列書式のいずれかをつかって定義されます。

urn:ogc:def:coordinateOperation:AUTHORITY::CODE。単純なEPSG:CODE文字列は座標操作を一意に識別できません。CRS定義に同じEPSGコードが使用できるためです。

PROJパイプライン文字列: +proj=pipeline ...。自動の軸正規化が適用されません。必要なら呼び出し元が追加のパイプライン段階を必要とします。もしくはaxisswap段階を削除する必要があります。

操作の連結: urn:ogc:def:coordinateOperation,coordinateOperation:EPSG::3895,coordinateOperation:EPSG::1618。

Availability: 3.4.0

入力ジオメトリのSRIDは無視され、任意パラメータ to_srid から値が提供されていない場合には出力ジオメトリのSRIDは0に設定されます。`ST_TransformPipeline()`を使うときには、パイプラインが順方向に実行されます。ST_InverseTransformPipelineを使うと、パイプラインは逆方向に実行されます。

パイプラインを用いた変換はST_Transformの特別版です。ほとんどの場合、`ST_Transform`は、座標系間の変換において正しい演算子を選択します。こちらの方が推奨されます。

例

EPSG:16031変換を使ったWGS 84 経度緯度から UTM31Nへの変換

-- 順方向
SELECT ST_AsText(ST_TransformPipeline('SRID=4326;POINT(2 49)'::geometry,
  'urn:ogc:def:coordinateOperation:EPSG::16031') AS utm_geom);

                  utm_geom
--------------------------------------------
 POINT(426857.9877165967 5427937.523342293)
(1 row)

-- 逆方向
SELECT ST_AsText(ST_InverseTransformPipeline('POINT(426857.9877165967 5427937.523342293)'::geometry,
  'urn:ogc:def:coordinateOperation:EPSG::16031')) AS wgs_geom;

          wgs_geom
----------------------------
 POINT(2 48.99999999999999)
(1 row)

GDA2020の例。

-- 変換パイプラインの自動選択を用いたST_Transform。
SELECT ST_AsText(ST_Transform('SRID=4939;POINT(143.0 -37.0)'::geometry, 7844)) AS gda2020_auto;

                 gda2020_auto
-----------------------------------------------
 POINT(143.00000635638918 -36.999986706128176)
(1 row)

-- 定義されている変換 (EPSG:8447)の使用
SELECT ST_AsText(ST_TransformPipeline('SRID=4939;POINT(143.0 -37.0)'::geometry,
  'urn:ogc:def:coordinateOperation:EPSG::8447')) AS gda2020_code;

                   gda2020_code
----------------------------------------------
 POINT(143.0000063280214 -36.999986718287545)
(1 row)

-- EPSG:8447に合致するPROJパイプライン定義を使って
-- 'projinfo -s EPSG:4939 -t EPSG:7844'から返されます。
-- ご注意: 'axisswap'段階は削除しなければなりません。
SELECT ST_AsText(ST_TransformPipeline('SRID=4939;POINT(143.0 -37.0)'::geometry,
  '+proj=pipeline
   +step +proj=unitconvert +xy_in=deg +xy_out=rad
   +step +proj=hgridshift +grids=au_icsm_GDA94_GDA2020_conformal_and_distortion.tif
   +step +proj=unitconvert +xy_in=rad +xy_out=deg')) AS gda2020_pipeline;

                   gda2020_pipeline
----------------------------------------------
 POINT(143.0000063280214 -36.999986718287545)
(1 row)

関連情報

ST_Transform, ST_InverseTransformPipeline

Name

postgis_srs_codes — 指定した機関に関連付けられたSRSコードの一覧を返します。

Synopsis

setof text postgis_srs_codes(
auth_name);

text auth_name;

説明

与えられたauth_nameに関する全てのauth_sridの集合を返します。

Availability: 3.4.0

Proj 6以上

例

EPSG機関に関連付けられているコードの最初の10件の一覧を得ます。

SELECT * FROM postgis_srs_codes('EPSG') LIMIT 10;

 postgis_srs_codes
-------------------
 2000
 20004
 20005
 20006
 20007
 20008
 20009
 2001
 20010
 20011

関連情報

postgis_srs, postgis_srs_all, postgis_srs_search

Name

postgis_srs — 求める機関と空間参照識別子に関するメタデータレコードを返します。

Synopsis

setof record postgis_srs( | auth_name, |
| auth_srid); |

text auth_name;
text auth_srid;

説明

指定したauth_nameに関して求めるauth_sridのメタデータレコードを貸します。レコードにはauth_name, auth_srid, srname, srtext, proj4textと適用範囲の隅を示すpoint_swとpoint_neが含まれます。

Availability: 3.4.0

Proj 6以上

例

EPSG:3005のメタデータを取得します。

SELECT * FROM postgis_srs('EPSG', '3005');

auth_name | EPSG
auth_srid | 3005
srname    | NAD83 / BC Albers
srtext    | PROJCS["NAD83 / BC Albers", ... ]]
proj4text | +proj=aea +lat_0=45 +lon_0=-126 +lat_1=50 +lat_2=58.5 +x_0=1000000 +y_0=0 +datum=NAD83 +units=m +no_defs +type=crs
point_sw  | 0101000020E6100000E17A14AE476161C00000000000204840
point_ne  | 0101000020E610000085EB51B81E855CC0E17A14AE47014E40

関連情報

postgis_srs_codes, postgis_srs_all, postgis_srs_search

Name

postgis_srs_all — Projデータベース内のあらゆる空間参照系のメタデータレコードを返します。

Synopsis

postgis_srs_allレコードの集合(
);

説明

Projデータベース内にある全てのメタデータレコードを返します。レコードにはauth_name, auth_srid, srname, srtext, proj4textと適用範囲の隅を示すpoint_swとpoint_neが含まれます。

Availability: 3.4.0

Proj 6以上

例

Projデータベースから最初の10件のメタデータレコードを得ます。

SELECT auth_name, auth_srid, srname FROM postgis_srs_all() LIMIT 10;

 auth_name | auth_srid |                  srname
-----------+-----------+------------------------------------------
 EPSG      | 2000      | Anguilla 1957 / British West Indies Grid
 EPSG      | 20004     | Pulkovo 1995 / Gauss-Kruger zone 4
 EPSG      | 20005     | Pulkovo 1995 / Gauss-Kruger zone 5
 EPSG      | 20006     | Pulkovo 1995 / Gauss-Kruger zone 6
 EPSG      | 20007     | Pulkovo 1995 / Gauss-Kruger zone 7
 EPSG      | 20008     | Pulkovo 1995 / Gauss-Kruger zone 8
 EPSG      | 20009     | Pulkovo 1995 / Gauss-Kruger zone 9
 EPSG      | 2001      | Antigua 1943 / British West Indies Grid
 EPSG      | 20010     | Pulkovo 1995 / Gauss-Kruger zone 10
 EPSG      | 20011     | Pulkovo 1995 / Gauss-Kruger zone 11

関連情報

postgis_srs_codes, postgis_srs, postgis_srs_search

Name

postgis_srs_search — boundsパラメータを完全に含む適用範囲を持つ投影座標系のメタデータレコードを返します。

Synopsis

setof record postgis_srs_search( | bounds, |
| auth_name=EPSG); |

geometry bounds;
text auth_name=EPSG;

説明

boundsパラメータを完全に含む適用範囲を持つ投影座標系のメタデータレコードを返します。レコードにはauth_name, auth_srid, srname, srtext, proj4textと適用範囲の隅を示すpoint_swとpoint_neが含まれます。

この検索では、投影座標系のみが対象となります。お持ちのデータの範囲で動作しうる座標系を探索することを目的としています。

Availability: 3.4.0

Proj 6以上

例

ルイジアナ州の投影座標系を探索します。

SELECT auth_name, auth_srid, srname,
  ST_AsText(point_sw) AS point_sw,
  ST_AsText(point_ne) AS point_ne
FROM postgis_srs_search('SRID=4326;LINESTRING(-90 30, -91 31)')
LIMIT 3;

 auth_name | auth_srid |                srname                |      point_sw       |      point_ne
-----------+-----------+--------------------------------------+---------------------+---------------------
 EPSG      | 2801      | NAD83(HARN) / Louisiana South        | POINT(-93.94 28.85) | POINT(-88.75 31.07)
 EPSG      | 3452      | NAD83 / Louisiana South (ftUS)       | POINT(-93.94 28.85) | POINT(-88.75 31.07)
 EPSG      | 3457      | NAD83(HARN) / Louisiana South (ftUS) | POINT(-93.94 28.85) | POINT(-88.75 31.07)

最大範囲を得るためにテーブルをスキャンして、適していると言えそうな投影座標系を見つけます。

WITH ext AS (
  SELECT ST_Extent(geom) AS geom, Max(ST_SRID(geom)) AS srid
  FROM foo
)
SELECT auth_name, auth_srid, srname,
  ST_AsText(point_sw) AS point_sw,
  ST_AsText(point_ne) AS point_ne
FROM ext
CROSS JOIN postgis_srs_search(ST_SetSRID(ext.geom, ext.srid))
LIMIT 3;

関連情報

postgis_srs_codes, postgis_srs_all, postgis_srs

ジオメトリ入力

Abstract

これらの関数によって、様々な文字列形式やバイナリ形式からジオメトリオブジェクトを生成できます。

Well-Known Text (WKT)

Well-Known Binary (WKB)

その他の書式

ジオメトリ出力

Abstract

これらの関数は、ジオメトリオブジェクトを様々な文字列形式やバイナリ形式に変換するものです。

Well-Known Text (WKT)

Well-Known Binary (WKB)

その他の書式

演算子

バウンディングボックス演算子

距離演算子

空間関係関数

Abstract

これらの関数は、ジオメトリ間の空間的な関係を判定します。

トポロジ関係関数

距離関係関数

計測関数

Abstract

この関数は、距離、面積、角度の測定値を計算します。測定値から決定されるジオメトリ値を計算する関数もあります。

Name

ST_Area — ポリゴンジオメトリの面積を返します。

Synopsis

float ST_Area(
g1);

geometry g1;

float ST_Area( | geog, |
| use_spheroid = true); |

geography geog;
boolean use_spheroid = true;

説明

ポリゴンジオメトリの面積を返します。ジオメトリ型では2次元のデカルト (平面)面積が、SRIDで指定した単位で計算されます。ジオグラフィ型では、デフォルトでは、面積は回転楕円体上にあるものとし、平方メートル単位で計算されます。より速いものの精度が落ちる計算のために、 ST_Area(geog,false)で球面モデルを使った計算ができます。

Enhanced: 2.0.0 - 2次元多面体サーフェス対応が導入されました。

Enhanced: 2.2.0 - 精度とロバスト性の向上のためにGeographicLibを使って回転楕円体面上での計測を行うようにしています。この新機能を使うには、Proj 4.9.0以上が必要です。

Changed: 3.0.0 - SFCGALに依存しなくなりました。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 8.1.2, 9.5.3

説明この関数は多面体サーフェスに対応しています。

Note

多面体サーフェスについて、2次元多面体サーフェスのみ対応します (2.5次元は対応しません)。2.5次元について、0でない答が与えられるかも知れませんが、完全にXY平面に付いているサーフェスのみです。

例

マサチューセッツのプロットから平方フィートの面積を返すものと、乗算で平方フィートから平方メートルに変換するものです。EPSG:2249はマサチューセッツ州フィート平面であるので、平方フィートで面積が出ることに注意して下さい。

select ST_Area(geom) sqft,
    ST_Area(geom) * 0.3048 ^ 2 sqm
from (
         select 'SRID=2249;POLYGON((743238 2967416,743238 2967450,
                                 743265 2967450,743265.625 2967416,743238 2967416))' :: geometry geom
     ) subquery;
┌─────────┬─────────────┐
│  sqft   │     sqm     │
├─────────┼─────────────┤
│ 928.625 │ 86.27208552 │
└─────────┴─────────────┘

平方フィートの面積を返すものと、マサチューセッツ州メートル平面 (EPSG:26986)に変換して平方メートルを得るものです。EPSG:2249はマサチューセッツ州フィート平面であり、EPSG:26986はマサチューセッツ州メートル平面であることに注意して下さい。

select ST_Area(geom) sqft,
    ST_Area(ST_Transform(geom, 26986)) As sqm
from (
         select
             'SRID=2249;POLYGON((743238 2967416,743238 2967450,
             743265 2967450,743265.625 2967416,743238 2967416))' :: geometry geom
     ) subquery;
┌─────────┬─────────────────┐
│  sqft   │       sqm       │
├─────────┼─────────────────┤
│ 928.625 │ 86.272430607008 │
└─────────┴─────────────────┘

ジオグラフィ型を使って平方フィートと平方メートルを返すものです。 ジオメトリをジオグラフィに変換することに注意して下さい (変換に先立ってジオメトリがWGS 84緯度経度のEPSG:4326であることを確認します)。ジオグラフィは常にメートルで計測されます。これは比較のためのデモンストレーションです。通常は、ジオグラフィ型が既に格納されているものです。

select ST_Area(geog) / 0.3048 ^ 2 sqft_spheroid,
    ST_Area(geog, false) / 0.3048 ^ 2 sqft_sphere,
    ST_Area(geog) sqm_spheroid
from (
         select ST_Transform(
                    'SRID=2249;POLYGON((743238 2967416,743238 2967450,743265 2967450,743265.625 2967416,743238 2967416))'::geometry,
                    4326
             ) :: geography geog
     ) as subquery;
┌──────────────────┬──────────────────┬──────────────────┐
│  sqft_spheroid   │   sqft_sphere    │   sqm_spheroid   │
├──────────────────┼──────────────────┼──────────────────┤
│ 928.684405784452 │ 927.049336105925 │ 86.2776044979692 │
└──────────────────┴──────────────────┴──────────────────┘

ジオグラフィのデータが既にある場合。

select ST_Area(geog) / 0.3048 ^ 2 sqft,
    ST_Area(the_geog) sqm
from somegeogtable;

関連情報

ST_3DArea, ST_GeomFromText, ST_GeographyFromText, ST_SetSRID, ST_Transform

Name

ST_Azimuth — 北を基準とした2点間の線の方位角を返します。

Synopsis

float ST_Azimuth( | origin, |
| target); |

geometry origin;
geometry target;

float ST_Azimuth( | origin, |
| target); |

geography origin;
geography target;

説明

原点から目標点に向いたラジアン単位の方位を返しますが、2点が一致する場合にはNULLを返します。方位角は、Y軸 (ジオメトリ)または子午線北向き (ジオグラフィ)から時計回りに増えていきます。すなわち、北は0、北東はπ/4、東はπ/2、南東は3π/4、南はπ、南西は5π/4、西は3π/2、北西は7π/4、となります。

ジオグラフィでは、方位角計算問題はinverse geodesic problemとして知られます。

方位角は参照ベクトルと一つのポイントとの間の角度と定義される数学的概念で、角度の単位はラジアンです。ラジアン単位の結果はPostgreSQL関数degrees()で度に変換できます。

方位角は、垂直軸に沿ってシフトさせるにはST_Translateと併用します。実装についてはPostGIS wiki内の関数upgis_lineshift()をご覧下さい。

Availability: 1.1.0

Enhanced: 2.0.0 ジオグラフィ対応が導入されました。

Enhanced: 2.2.0 - 精度とロバスト性の向上のためにGeographicLibを使って回転楕円体面上での計測を行うようにしています。この新機能を使うには、Proj 4.9.0以上が必要です。

例

度単位のジオメトリの方位

SELECT degrees(ST_Azimuth( ST_Point(25, 45),  ST_Point(75, 100))) AS degA_B,
       degrees(ST_Azimuth( ST_Point(75, 100), ST_Point(25, 45) )) AS degB_A;

      dega_b       |     degb_a
------------------+------------------
 42.2736890060937 | 222.273689006094

青: 原点 (25,45)、緑: 目標点 (75,100)、黄: Y軸または北、赤: 方位角

青: 原点 (75,100)、緑: 目標点 (25,45)、黄: Y軸または北、赤: 方位角

関連情報

ST_Angle, ST_Point, ST_Translate, ST_Project, PostgreSQL Math Functions

Name

ST_Angle — 3点もしくは4点、または2線で定義される二つのベクタ間の角度を返します。

Synopsis

float ST_Angle( | point1, |
| point2, |
| point3, |
| point4); |

geometry point1;
geometry point2;
geometry point3;
geometry point4;

float ST_Angle( | line1, |
| line2); |

geometry line1;
geometry line2;

説明

二つのベクタの時計回りの角度を計算します。

形式1:P1-P2-P3がなす角度を計算します。4番目のポイントが充てられた場合には、P1-P2とP3-P4がなす角度を計算します。

形式2: 入力ラインで定義される始端と終端ベクトルS1-E1とS2-E2の間の角度を計算します。

結果は正の角度で0と2πラジアンの間です。ラジアンはPostgreSQL関数degrees()で度に変換できます。

ST_Angle(P1,P2,P3) = ST_Angle(P2,P1,P2,P3)となることに注意して下さい。

Availability: 2.5.0

例

3点間の角度

SELECT degrees( ST_Angle('POINT(0 0)', 'POINT(10 10)', 'POINT(20 0)') );

 degrees
---------
     270

4点で定義されたベクタ間の角度

SELECT degrees( ST_Angle('POINT (10 10)', 'POINT (0 0)', 'POINT(90 90)', 'POINT (100 80)') );

      degrees
-------------------
 269.9999999999999

ラインの始端と終端で定義されるベクタ間の角度

SELECT degrees( ST_Angle('LINESTRING(0 0, 0.3 0.7, 1 1)', 'LINESTRING(0 0, 0.2 0.5, 1 0)') );

      degrees
--------------
           45

関連情報

ST_Azimuth

Name

ST_ClosestPoint — g1上にある、g2と最近傍となる2次元ポイントを返します。これは、あるジオメトリから他のジオメトリへの最短ラインの一つ目のポイントです。

Synopsis

geometry ST_ClosestPoint( | geom1, |
| geom2); |

geometry geom1;
geometry geom2;

geography ST_ClosestPoint( | geom1, |
| geom2, |
| repeat = true); |

geography geom1;
geography geom2;
boolean repeat = true;

説明

geom2と最近傍となるgeom1上の2次元ポイントを返します。これは、ジオメトリ間の最短ライン (ST_ShortestLineで生成されるものと同じです)の一つ目のポイントです。

Note

3次元ジオメトリの場合にはST_3DClosestPointの方が良いでしょう。

Availability: 1.5.0

例

ポイントとラインストリングの最近傍ポイントは引数で与えたポイントそのものです。ラインストリングとポイントの最近傍ポイントはラインストリング上のポイントです。

SELECT ST_AsText( ST_ClosestPoint(pt,line)) AS cp_pt_line,
       ST_AsText( ST_ClosestPoint(line,pt)) AS cp_line_pt
    FROM (SELECT 'POINT (160 40)'::geometry AS pt,
                 'LINESTRING (10 30, 50 50, 30 110, 70 90, 180 140, 130 190)'::geometry AS line ) AS t;

   cp_pt_line   |                cp_line_pt
----------------+------------------------------------------
 POINT(160 40)  | POINT(125.75342465753425 115.34246575342466)

ポリゴンA上のポリゴンBへの最近傍点

SELECT ST_AsText( ST_ClosestPoint(
                'POLYGON ((190 150, 20 10, 160 70, 190 150))',
                ST_Buffer('POINT(80 160)', 30)        )) As ptwkt;
------------------------------------------
 POINT(131.59149149528952 101.89887534906197)

関連情報

ST_3DClosestPoint, ST_Distance, ST_LongestLine, ST_ShortestLine, ST_MaxDistance

Name

ST_3DClosestPoint — g1上の、g2に最も近い3次元ポイントを返します。これは3次元の最短ラインの始点です。

Synopsis

geometry ST_3DClosestPoint( | g1, |
| g2); |

geometry g1;
geometry g2;

説明

g1上の、g2に最も近い3次元ポイントを返します。3次元最短線の一つ目のポイントです。3次元最短線の長さは、3次元距離と同じです。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

Availability: 2.0.0

Changed: 2.2.0 - 二つの2次元ジオメトリが入力である場合には、2次元ポイントが返ります (古い挙動では、存在しないZの値について0を仮定していました)。2次元と3次元の場合には、もはや、存在しないZの値について0を仮定しません。

例

ラインストリングとポイント -- 3次元と2次元の両方の最も近いポイント

SELECT ST_AsEWKT(ST_3DClosestPoint(line,pt)) AS cp3d_line_pt,
                ST_AsEWKT(ST_ClosestPoint(line,pt)) As cp2d_line_pt
        FROM (SELECT 'POINT(100 100 30)'::geometry As pt,
                        'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 1000)'::geometry As line
                ) As foo;

 cp3d_line_pt                                                |               cp2d_line_pt
-----------------------------------------------------------+------------------------------------------
 POINT(54.6993798867619 128.935022917228 11.5475869506606) | POINT(73.0769230769231 115.384615384615)

ラインストリングとマルチポイント -- 3次元と2次元の両方の最も近いポイント

SELECT ST_AsEWKT(ST_3DClosestPoint(line,pt)) AS cp3d_line_pt,
                ST_AsEWKT(ST_ClosestPoint(line,pt)) As cp2d_line_pt
        FROM (SELECT 'MULTIPOINT(100 100 30, 50 74 1000)'::geometry As pt,
                        'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 900)'::geometry As line
                ) As foo;

                       cp3d_line_pt                        | cp2d_line_pt
-----------------------------------------------------------+--------------
 POINT(54.6993798867619 128.935022917228 11.5475869506606) | POINT(50 75)

マルチラインストリングとポリゴン -- 3次元と2次元の両方の最も近いポイント

SELECT ST_AsEWKT(ST_3DClosestPoint(poly, mline)) As cp3d,
    ST_AsEWKT(ST_ClosestPoint(poly, mline)) As cp2d
        FROM (SELECT  ST_GeomFromEWKT('POLYGON((175 150 5, 20 40 5, 35 45 5, 50 60 5, 100 100 5, 175 150 5))') As poly,
                ST_GeomFromEWKT('MULTILINESTRING((175 155 2, 20 40 20, 50 60 -2, 125 100 1, 175 155 1),
                (1 10 2, 5 20 1))') As mline ) As foo;
                   cp3d                    |     cp2d
-------------------------------------------+--------------
 POINT(39.993580415989 54.1889925532825 5) | POINT(20 40)

関連情報

ST_AsEWKT, ST_ClosestPoint, ST_3DDistance, ST_3DShortestLine

Name

ST_Distance — 二つのジオメトリ値またはジオグラフィ値間の距離を返します。

Synopsis

float ST_Distance( | g1, |
| g2); |

geometry g1;
geometry g2;

float ST_Distance( | geog1, |
| geog2, |
| use_spheroid = true); |

geography geog1;
geography geog2;
boolean use_spheroid = true;

説明

geometry型では、二つのジオメトリ間の2次元のデカルト (平面)距離の最小値を返します。単位は投影の単位 (空間参照系の単位)です。

geography型では、二つのジオグラフィ間の最小の測地距離を、メートル単位で返します。SRIDで決定される回転楕円体で計算します。use_spheroidがFALSEの場合には、球面が計算に使われます。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.23

説明このメソッドは曲線ストリングと曲線に対応しています。

Availability: 1.5.0 1.5でジオグラフィ対応が導入されました。大きいジオメトリや頂点の多いジオメトリについての速度が改善しました。

Enhanced: 2.1.0 ジオグラフィでの速度が改善されました。詳細はMaking Geography fasterをご覧ください。

Enhanced: 2.1.0 - 曲線ジオメトリ対応が導入されました。

Enhanced: 2.2.0 - 精度とロバスト性の向上のためにGeographicLibを使って回転楕円体面上での計測を行うようにしています。この新機能を使うには、Proj 4.9.0以上が必要です。

Changed: 3.0.0 - SFCGALに依存しなくなりました。

ジオメトリの例

ジオメトリの例 - 平面の単位で4326はWGS84経度緯度なので、単位は度。

SELECT ST_Distance(
    'SRID=4326;POINT(-72.1235 42.3521)'::geometry,
    'SRID=4326;LINESTRING(-72.1260 42.45, -72.123 42.1546)'::geometry );
-----------------
0.00150567726382282

ジオメトリの例 - メートル単位 (SIRD: 3857, 一般的なWebマップのピクセルに比例)。値は正しくありませんが、近傍の比較は正しくでき、KNNやKMeansなどのアルゴリズムに適しています。

SELECT ST_Distance(
    ST_Transform('SRID=4326;POINT(-72.1235 42.3521)'::geometry, 3857),
    ST_Transform('SRID=4326;LINESTRING(-72.1260 42.45, -72.123 42.1546)'::geometry, 3857) );
-----------------
167.441410065196

ジオメトリの例 - メートル単位 (SRID:3857, 上と同じですが、歪みを考慮してcos(lat)で修正しています)

SELECT ST_Distance(
    ST_Transform('SRID=4326;POINT(-72.1235 42.3521)'::geometry, 3857),
    ST_Transform('SRID=4326;LINESTRING(-72.1260 42.45, -72.123 42.1546)'::geometry, 3857)
                ) * cosd(42.3521);
-----------------
123.742351254151

ジオメトリの例 - メートル単位 (SRID: 26986, マサチューセッツ州平面メートル) (マサチューセッツで最も精度が高い)

SELECT ST_Distance(
    ST_Transform('SRID=4326;POINT(-72.1235 42.3521)'::geometry, 26986),
    ST_Transform('SRID=4326;LINESTRING(-72.1260 42.45, -72.123 42.1546)'::geometry, 26986) );
-----------------
123.797937878454

ジオメトリの例 - メートル単位 (SRID: 2163, 米国ナショナルアトラス正積図法) (最も精度が低い)

SELECT ST_Distance(
    ST_Transform('SRID=4326;POINT(-72.1235 42.3521)'::geometry, 2163),
    ST_Transform('SRID=4326;LINESTRING(-72.1260 42.45, -72.123 42.1546)'::geometry, 2163) );
------------------
126.664256056812

ジオグラフィの例

ジオメトリの例と同じですが、メートル単位である点に注意して下さい - 球面の使用で、わずかな速度向上と低精度の計算を行います。

SELECT ST_Distance(gg1, gg2) As spheroid_dist, ST_Distance(gg1, gg2, false) As sphere_dist
FROM (SELECT
    'SRID=4326;POINT(-72.1235 42.3521)'::geography as gg1,
    'SRID=4326;LINESTRING(-72.1260 42.45, -72.123 42.1546)'::geography as gg2
        ) As foo  ;

  spheroid_dist   |   sphere_dist
------------------+------------------
 123.802076746848 | 123.475736916397

関連情報

ST_3DDistance, ST_DWithin, ST_DistanceSphere, ST_DistanceSpheroid, ST_MaxDistance, ST_HausdorffDistance, ST_FrechetDistance, ST_Transform

Name

ST_3DDistance — 投影座標系の単位で、二つのジオメトリ間の3次元デカルト距離の最小値を返します (空間参照系に基づきます)。

Synopsis

float ST_3DDistance( | g1, |
| g2); |

geometry g1;
geometry g2;

説明

投影座標系の単位で、二つのジオメトリ間の3次元デカルト距離の最小値を返します (空間参照系に基づきます)。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM ISO/IEC 13249-3

Availability: 2.0.0

Changed: 2.2.0 - 2次元と3次元の場合には、もはや、存在しないZの値について0を仮定しません。

Changed: 3.0.0 - SFCGAL版は削除されました

例

-- ジオメトリの例 - メートル単位 (SRID: 2163, 米国ナショナルアトラス正積図法) (2次元のポイントとラインと比較される3次元のポイントとライン)
-- ご注意: 現在は鉛直基準面に対応していません。Z値は変換されずに、最終の単位と同じ単位と推定されます。
SELECT ST_3DDistance(
                        ST_Transform('SRID=4326;POINT(-72.1235 42.3521 4)'::geometry,2163),
                        ST_Transform('SRID=4326;LINESTRING(-72.1260 42.45 15, -72.123 42.1546 20)'::geometry,2163)
                ) As dist_3d,
                ST_Distance(
                        ST_Transform('SRID=4326;POINT(-72.1235 42.3521)'::geometry,2163),
                        ST_Transform('SRID=4326;LINESTRING(-72.1260 42.45, -72.123 42.1546)'::geometry,2163)
                ) As dist_2d;

     dist_3d      |     dist_2d
------------------+-----------------
 127.295059324629 | 126.66425605671

-- マルチラインストリングとポリゴンの3次元距離と2次元距離
-- 3次元最近点の例と同じです
SELECT ST_3DDistance(poly, mline) As dist3d,
    ST_Distance(poly, mline) As dist2d
        FROM (SELECT  'POLYGON((175 150 5, 20 40 5, 35 45 5, 50 60 5, 100 100 5, 175 150 5))'::geometry as poly,
               'MULTILINESTRING((175 155 2, 20 40 20, 50 60 -2, 125 100 1, 175 155 1), (1 10 2, 5 20 1))'::geometry as mline) as foo;
      dist3d       | dist2d
-------------------+--------
 0.716635696066337 |      0

関連情報

ST_Distance, ST_3DClosestPoint, ST_3DDWithin, ST_3DMaxDistance, ST_3DShortestLine, ST_Transform

Name

ST_DistanceSphere — 球面の地球モデルを使って、二つの経度/緯度ジオメトリの最小距離をメートル単位で返します。

Synopsis

float ST_DistanceSphere( | geomlonlatA, |
| geomlonlatB, |
| radius=6371008); |

geometry geomlonlatA;
geometry geomlonlatB;
float8 radius=6371008;

説明

二つの経度緯度ジオメトリの間の最短距離をメートル単位で返します。SRIDで定義された回転楕円体に由来する半径となる球面を使います。ST_DistanceSpheroidより高速ですが、精度が悪くなります。PostGISの1.5より前の版ではポイント間の距離の計測だけを実装していました。

Availability: 1.5 - ポイント以外のジオメトリが導入されました。以前の版ではポイントでのみ動作しました。

Changed: 2.2.0 前の版ではこの関数はST_Distance_Sphereと呼ばれていました。

例

SELECT round(CAST(ST_DistanceSphere(ST_Centroid(geom), ST_GeomFromText('POINT(-118 38)',4326)) As numeric),2) As dist_meters,
round(CAST(ST_Distance(ST_Transform(ST_Centroid(geom),32611),
                ST_Transform(ST_GeomFromText('POINT(-118 38)', 4326),32611)) As numeric),2) As dist_utm11_meters,
round(CAST(ST_Distance(ST_Centroid(geom), ST_GeomFromText('POINT(-118 38)', 4326)) As numeric),5) As dist_degrees,
round(CAST(ST_Distance(ST_Transform(geom,32611),
                ST_Transform(ST_GeomFromText('POINT(-118 38)', 4326),32611)) As numeric),2) As min_dist_line_point_meters
FROM
        (SELECT ST_GeomFromText('LINESTRING(-118.584 38.374,-118.583 38.5)', 4326) As geom) as foo;
         dist_meters | dist_utm11_meters | dist_degrees | min_dist_line_point_meters
        -------------+-------------------+--------------+----------------------------
                70424.47 |          70438.00 |      0.72900 |                   65871.18

関連情報

ST_Distance, ST_DistanceSpheroid

Name

ST_DistanceSpheroid — 回転楕円体面の地球モデルを使って、二つの経度/緯度ジオメトリの最小距離を返します。

Synopsis

float ST_DistanceSpheroid( | geomlonlatA, |
| geomlonlatB, |
| measurement_spheroid=WGS84); |

geometry geomlonlatA;
geometry geomlonlatB;
spheroid measurement_spheroid=WGS84;

説明

与えられた回転楕円体面の、二つの経度/緯度ジオメトリの最小距離をメートル単位で返します。回転楕円体面の詳細についてはST_LengthSpheroidをご覧下さい。

Note

この関数はジオメトリのSRIDを見ません。ジオメトリの座標は与えられた回転楕円体に基づくものと仮定します。

Availability: 1.5 - ポイント以外のジオメトリが導入されました。以前の版ではポイントでのみ動作しました。

Changed: 2.2.0 前の版ではこの関数はST_Distance_Sphereと呼ばれていました。

例

SELECT round(CAST(
                ST_DistanceSpheroid(ST_Centroid(geom), ST_GeomFromText('POINT(-118 38)',4326), 'SPHEROID["WGS 84",6378137,298.257223563]')
                        As numeric),2) As dist_meters_spheroid,
                round(CAST(ST_DistanceSphere(ST_Centroid(geom), ST_GeomFromText('POINT(-118 38)',4326)) As numeric),2) As dist_meters_sphere,
round(CAST(ST_Distance(ST_Transform(ST_Centroid(geom),32611),
                ST_Transform(ST_GeomFromText('POINT(-118 38)', 4326),32611)) As numeric),2) As dist_utm11_meters
FROM
        (SELECT ST_GeomFromText('LINESTRING(-118.584 38.374,-118.583 38.5)', 4326) As geom) as foo;
 dist_meters_spheroid | dist_meters_sphere | dist_utm11_meters
----------------------+--------------------+-------------------
                         70454.92 |           70424.47 |          70438.00

関連情報

ST_Distance, ST_DistanceSphere

Name

ST_FrechetDistance — 二つのジオメトリのフレシェ距離を返します。

Synopsis

float ST_FrechetDistance( | g1, |
| g2, |
| densifyFrac = -1); |

geometry g1;
geometry g2;
float densifyFrac = -1;

説明

両方のジオメトリの離散点への制限を受けたフレシェ距離の計算アルゴリズムの実装はComputing Discrete Fréchet Distanceを基にしています。フレシェ距離は曲線の位置と点の並び順とを考慮に入れた曲線間の類似度を計測するものです。ハウスドルフ距離よりも良いことがしばしばあります。

任意引数densifyFracが指定されると、この関数は、離散フレシェ距離の計算の前に、辺密度を増加させます。densifyFracパラメータは辺の高密度化に使う比率を設定します。それぞれの辺は多数の等長の辺に分割され、分割辺長の合計長に対する比は与えた比率に近くなります。

単位はジオメトリの空間参照系の単位です。

Note

現在の実装では、離散位置は、頂点のみに対応しています。任意の密度でポイントを使用することができるよう拡張されています。

Note

densityFracに小さい値を指定すると、フレシェ距離の精度が増します。しかし、分割辺数の2乗に比例して計算時間とメモリ利用量が増大します。

GEOSモジュールで実現しています。

Availability: 2.4.0 - GEOS 3.7.0以上が必要です。

例

postgres=# SELECT st_frechetdistance('LINESTRING (0 0, 100 0)'::geometry, 'LINESTRING (0 0, 50 50, 100 0)'::geometry);
 st_frechetdistance
--------------------
   70.7106781186548
(1 row)

SELECT st_frechetdistance('LINESTRING (0 0, 100 0)'::geometry, 'LINESTRING (0 0, 50 50, 100 0)'::geometry, 0.5);
 st_frechetdistance
--------------------
                 50
(1 row)

関連情報

ST_HausdorffDistance

Name

ST_HausdorffDistance — 二つのジオメトリ間のハウスドルフ距離を返します。

Synopsis

float ST_HausdorffDistance( | g1, |
| g2); |

geometry g1;
geometry g2;

float ST_HausdorffDistance( | g1, |
| g2, |
| densifyFrac); |

geometry g1;
geometry g2;
float densifyFrac;

説明

二つのジオメトリ間のハウスドルフ距離を返します。ハウスドルフ距離は二つのジオメトリのどれぐらい似ているかを示す尺度です。

この関数は実際に「離散ハウスドルフ距離」を計算します。これはジオメトリの離散ポイントにおけるハウスドルフ距離の計算を行ったものです。densifyFracパラメータが指定された場合には、離散ハウスドルフ距離の計算の前に辺の密度を高くして、精度の高い結果が得られるようにします。個々の辺は、与えた割合に近い辺長で等分されます。

単位はジオメトリの空間参照系の単位です。

Note

このアルゴリズムは標準的なハウスドルフ距離と等価では*ありません*。しかし、使用可能な場面の大部分で正しくなる近似計算がなされています。重要なものに、それぞれが概ね平行で概ね等しい長さのラインストリングがあります。これはラインのマッチングに使える基準です。

Availability: 1.5.0

例

2線間のハウスドルフ距離 (赤)と距離 (黄)

SELECT ST_HausdorffDistance(geomA, geomB),
       ST_Distance(geomA, geomB)
    FROM (SELECT 'LINESTRING (20 70, 70 60, 110 70, 170 70)'::geometry AS geomA,
                 'LINESTRING (20 90, 130 90, 60 100, 190 100)'::geometry AS geomB) AS t;
 st_hausdorffdistance | st_distance
----------------------+-------------
    37.26206567625497 |          20

Example: 高密度化したうえで求めたハウスドルフ距離。

SELECT ST_HausdorffDistance(
            'LINESTRING (130 0, 0 0, 0 150)'::geometry,
            'LINESTRING (10 10, 10 150, 130 10)'::geometry,
            0.5);
 ----------------------
          70

例: 個々の建物について、最もよく表現する区画を見つけます。最初に建物ジオメトリとインタセクトする区画を求めます。DISTINCT ONで、個々の建物が一回ずつしかリストに挙がらないことが保障されます。ORDER BY .. ST_HausdorffDistanceで、最も建物に近い区画を選択します。

SELECT DISTINCT ON (buildings.gid) buildings.gid, parcels.parcel_id
   FROM buildings
       INNER JOIN parcels
       ON ST_Intersects(buildings.geom, parcels.geom)
   ORDER BY buildings.gid, ST_HausdorffDistance(buildings.geom, parcels.geom);

関連情報

ST_FrechetDistance

Name

ST_Length — 線系ジオメトリの2次元長を返します。

Synopsis

float ST_Length(
a_2dlinestring);

geometry a_2dlinestring;

float ST_Length( | geog, |
| use_spheroid = true); |

geography geog;
boolean use_spheroid = true;

説明

ジオメトリ型: LINESTRING, MULTILINESTRING, ST_Curve, ST_MultiCurveの場合には2次元デカルト距離を返します。面ジオメトリでは0を返すのでST_Perimeterを代わりに使います。長さの単位はジオメトリの空間参照系で決まります。

ジオグラフィ型: 計算は逆測地問題を用いています。長さの単位はメートルです。PROJ 4.8.0以上でPostGISをコンパイルしている場合には、回転楕円体面はSRIDで指定されたものとなり、それより前はWGS84となります。use_spheroid = falseとすると、計算は回転楕円体面でなく真球面で行います。

現在は、ジオメトリに対してはST_Length2Dの別名ですが、高次元対応に変更されるかも知れません。

Warning

Changed: 2.0.0 大幅な変更 -- 以前の版ではジオグラフィのPOLYGONやMULTIPOLYGONへの適用によってPOLYGONやMULTIPOLYGONの周囲長を返しました。2.0.0版ではジオメトリの挙動に従うため0を返すように変更しました。ポリゴンの周囲長を求める場合は、ST_Perimeterを使います。

Note

ジオグラフィでは計算は回転楕円体面モデルを使用します。計算が速い反面精度が低い球面計算を使うには、 ST_Length(gg,false)とします。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.5.1

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.1.2, 9.3.4

Availability: 1.5.0 ジオグラフィt対応が導入されました。

ジオメトリの例

ラインストリングのフィート単位の長さを返します。EPSG:2249はフィート単位のマサチューセッツ州平面なので、フィート単位になることに注意して下さい。

SELECT ST_Length(ST_GeomFromText('LINESTRING(743238 2967416,743238 2967450,743265 2967450,
743265.625 2967416,743238 2967416)',2249));

st_length
---------
 122.630744000095

-- WGS84ラインストリングをメートル単位のマサチューセッツ州平面に変換
SELECT ST_Length(
        ST_Transform(
                ST_GeomFromEWKT('SRID=4326;LINESTRING(-72.1260 42.45, -72.1240 42.45666, -72.123 42.1546)'),
                26986
        )
);

st_length
---------
34309.4563576191

ジオグラフィの例

WGS84ジオグラフィのラインの長さを返します。

-- デフォルトでは計算に回転楕円体面を使用
SELECT ST_Length(the_geog) As length_spheroid,  ST_Length(the_geog,false) As length_sphere
FROM (SELECT ST_GeographyFromText(
'SRID=4326;LINESTRING(-72.1260 42.45, -72.1240 42.45666, -72.123 42.1546)') As the_geog)
 As foo;

 length_spheroid  |  length_sphere
------------------+------------------
 34310.5703627288 | 34346.2060960742

関連情報

ST_GeographyFromText, ST_GeomFromEWKT, ST_LengthSpheroid, ST_Perimeter, ST_Transform

Name

ST_Length2D — LINESTRINGまたはMULTILINESTRINGに対して、ジオメトリの2次元長を返します。これはST_Lengthの別名です。

Synopsis

float ST_Length2D(
a_2dlinestring);

geometry a_2dlinestring;

説明

LINESTRINGまたはMULTILINESTRINGに対して、ジオメトリの2次元長を返します。これはST_Lengthの別名です。

関連情報

ST_Length, ST_3DLength

Name

ST_3DLength — 線ジオメトリの3次元長を返します。

Synopsis

float ST_3DLength(
a_3dlinestring);

geometry a_3dlinestring;

説明

LINESTRINGまたはMULTILINESTRINGの場合には、そのジオメトリの3次元長または2次元長を返します。2次元ラインでは2次元長を返します (ST_LengthとST_Length2Dと同じです)。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 7.1, 10.3

Changed: 2.0.0 以前の版ではST_Length3Dと呼ばれていました。

例

3次元ケーブルの長さをフィート単位で返します。EPSG:2249はフィート単位のマサチューセッツ州平面なので、フィート単位になることに注意して下さい。

SELECT ST_3DLength(ST_GeomFromText('LINESTRING(743238 2967416 1,743238 2967450 1,743265 2967450 3,
743265.625 2967416 3,743238 2967416 3)',2249));
ST_3DLength
-----------
122.704716741457

関連情報

ST_Length, ST_Length2D

Name

ST_LengthSpheroid — 回転楕円体面上の経度緯度のジオメトリの2次元または3次元の長さ/周長を返します。

Synopsis

float ST_LengthSpheroid( | a_geometry, |
| a_spheroid); |

geometry a_geometry;
spheroid a_spheroid;

説明

回転楕円体面上のジオメトリの周長を返します。この関数は、ジオメトリの座標が経度/緯度で、投影変換なしで長さを求めたい場合に使います。

SPHEROID[<名称>,<長軸半径>,<扁平率の逆数>]

例:

SPHEROID["GRS_1980",6378137,298.257222101]

Availability: 1.2.2

Changed: 2.2.0 これより前の版では、これはST_Length_Spheroidと呼ばれ、ST_3DLength_Spheroidという別名を持っていました。

説明この関数は3次元に対応し、Z値を削除しません。

例

SELECT ST_LengthSpheroid( geometry_column,
                          'SPHEROID["GRS_1980",6378137,298.257222101]' )
                          FROM geometry_table;

SELECT ST_LengthSpheroid( geom, sph_m ) As tot_len,
ST_LengthSpheroid(ST_GeometryN(geom,1), sph_m) As len_line1,
ST_LengthSpheroid(ST_GeometryN(geom,2), sph_m) As len_line2
                          FROM (SELECT ST_GeomFromText('MULTILINESTRING((-118.584 38.374,-118.583 38.5),
        (-71.05957 42.3589 , -71.061 43))') As geom,
CAST('SPHEROID["GRS_1980",6378137,298.257222101]' As spheroid) As sph_m)  as foo;
        tot_len      |    len_line1     |    len_line2
------------------+------------------+------------------
 85204.5207562955 | 13986.8725229309 | 71217.6482333646

 -- 3次元
SELECT ST_LengthSpheroid( geom, sph_m ) As tot_len,
ST_LengthSpheroid(ST_GeometryN(geom,1), sph_m) As len_line1,
ST_LengthSpheroid(ST_GeometryN(geom,2), sph_m) As len_line2
                          FROM (SELECT ST_GeomFromEWKT('MULTILINESTRING((-118.584 38.374 20,-118.583 38.5 30),
        (-71.05957 42.3589 75, -71.061 43 90))') As geom,
CAST('SPHEROID["GRS_1980",6378137,298.257222101]' As spheroid) As sph_m)  as foo;

         tot_len      |    len_line1    |    len_line2
------------------+-----------------+------------------
 85204.5259107402 | 13986.876097711 | 71217.6498130292

関連情報

ST_GeometryN, ST_Length

Name

ST_LongestLine — 二つのジオメトリ間の2次元最長ラインを返します。

Synopsis

geometry ST_LongestLine( | g1, |
| g2); |

geometry g1;
geometry g2;

説明

二つのジオメトリのポイントで作られる2次元の最長ラインを返します。ラインはg1上から始まり、g2上で終わります。

最長ラインは常に二つの頂点となります。一つ以上の最長ラインが発見された場合には、この関数は最初のものを返します。ラインの長さはST_MaxDistanceが返す距離と同じです。

g1とg2が同じジオメトリの場合には、ジオメトリで最も遠くに離れる2頂点を結ぶラインが返ります。このラインの端点はST_MinimumBoundingCircleで計算された円の上に存在します。

Availability: 1.5.0

例

ポイントとラインストリングの間の最長となるライン

SELECT ST_AsText( ST_LongestLine(
        'POINT (160 40)',
        'LINESTRING (10 30, 50 50, 30 110, 70 90, 180 140, 130 190)' )
        ) AS lline;
-----------------
LINESTRING(160 40,130 190)

二つのポリゴンの間の最長となるライン

SELECT ST_AsText( ST_LongestLine(
        'POLYGON ((190 150, 20 10, 160 70, 190 150))',
        ST_Buffer('POINT(80 160)', 30)
            ) ) AS llinewkt;
-----------------
LINESTRING(20 10,105.3073372946034 186.95518130045156)

一つのジオメトリを横切る最長のラインす。ラインの長さは最大距離と同じです。ラインの端点は最小境界円上に存在します。

SELECT ST_AsText( ST_LongestLine( geom, geom)) AS llinewkt,
                  ST_MaxDistance( geom, geom) AS max_dist,
                  ST_Length( ST_LongestLine(geom, geom)) AS lenll
FROM (SELECT 'POLYGON ((40 180, 110 160, 180 180, 180 120, 140 90, 160 40, 80 10, 70 40, 20 50, 40 180),
              (60 140, 99 77.5, 90 140, 60 140))'::geometry AS geom) AS t;

         llinewkt          |      max_dist      |       lenll
---------------------------+--------------------+--------------------
 LINESTRING(20 50,180 180) | 206.15528128088303 | 206.15528128088303

関連情報

ST_MaxDistance, ST_ShortestLine, ST_3DLongestLine, ST_MinimumBoundingCircle

Name

ST_3DLongestLine — 二つのジオメトリ間の3次元最長ラインを返します。

Synopsis

geometry ST_3DLongestLine( | g1, |
| g2); |

geometry g1;
geometry g2;

説明

二つのジオメトリ間の3次元最長ラインを返します。該当が複数ある場合には最初の最長ラインを返します。返されるラインは、g1から始まりg2で終わります。ラインの3次元長はST_3DMaxDistanceが返す距離と同じです。

Availability: 2.0.0

Changed: 2.2.0 - 二つの2次元ジオメトリが入力である場合には、2次元ポイントが返ります (古い挙動では、存在しないZの値について0を仮定していました)。2次元と3次元の場合には、もはや、存在しないZの値について0を仮定しません。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

例

ラインストリングとポイント -- 3次元と2次元の最長ライン

SELECT ST_AsEWKT(ST_3DLongestLine(line,pt)) AS lol3d_line_pt,
                ST_AsEWKT(ST_LongestLine(line,pt)) As lol2d_line_pt
        FROM (SELECT 'POINT(100 100 30)'::geometry As pt,
                        'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 1000)'::geometry As line
                ) As foo;

           lol3d_line_pt           |       lol2d_line_pt
-----------------------------------+----------------------------
 LINESTRING(50 75 1000,100 100 30) | LINESTRING(98 190,100 100)

ラインストリングとマルチポイント -- 3次元と2次元の最長ライン

SELECT ST_AsEWKT(ST_3DLongestLine(line,pt)) AS lol3d_line_pt,
                ST_AsEWKT(ST_LongestLine(line,pt)) As lol2d_line_pt
        FROM (SELECT 'MULTIPOINT(100 100 30, 50 74 1000)'::geometry As pt,
                        'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 900)'::geometry As line
                ) As foo;

          lol3d_line_pt          |      lol2d_line_pt
---------------------------------+--------------------------
 LINESTRING(98 190 1,50 74 1000) | LINESTRING(98 190,50 74)

マルチラインストリングとポリゴンの3次元と2次元の最長ライン

SELECT ST_AsEWKT(ST_3DLongestLine(poly, mline)) As lol3d,
    ST_AsEWKT(ST_LongestLine(poly, mline)) As lol2d
        FROM (SELECT  ST_GeomFromEWKT('POLYGON((175 150 5, 20 40 5, 35 45 5, 50 60 5, 100 100 5, 175 150 5))') As poly,
                ST_GeomFromEWKT('MULTILINESTRING((175 155 2, 20 40 20, 50 60 -2, 125 100 1, 175 155 1),
                (1 10 2, 5 20 1))') As mline ) As foo;
            lol3d             |          lol2d
------------------------------+--------------------------
 LINESTRING(175 150 5,1 10 2) | LINESTRING(175 150,1 10)

関連情報

ST_3DClosestPoint, ST_3DDistance, ST_LongestLine, ST_3DShortestLine, ST_3DMaxDistance

Name

ST_MaxDistance — 二つのジオメトリ間の2次元最長距離を空間参照系の単位で返します。

Synopsis

float ST_MaxDistance( | g1, |
| g2); |

geometry g1;
geometry g2;

説明

二つのジオメトリの2次元最長距離を空間参照系の単位で返します。最長距離は常に二つの頂点間で発生します。これはST_LongestLineが返すラインの長さと同じです。

g1とg2が同じジオメトリであった場合には、そのジオメトリ内の最も遠くなる二つの頂点間の距離を返します。

Availability: 1.5.0

例

ポイントとラインの最長距離。

SELECT ST_MaxDistance('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, 0 2 )'::geometry);
-----------------
 2

SELECT ST_MaxDistance('POINT(0 0)'::geometry, 'LINESTRING ( 2 2, 2 2 )'::geometry);
------------------
 2.82842712474619

一つのジオメトリ内の頂点間の最長距離。

SELECT ST_MaxDistance('POLYGON ((10 10, 10 0, 0 0, 10 10))'::geometry,
                      'POLYGON ((10 10, 10 0, 0 0, 10 10))'::geometry);
------------------
 14.142135623730951

関連情報

ST_Distance, ST_LongestLine, ST_DFullyWithin

Name

ST_3DMaxDistance — 二つのジオメトリ間の3次元最大デカルト距離 (空間参照系に基づく)を空間参照系の単位で返します。

Synopsis

float ST_3DMaxDistance( | g1, |
| g2); |

geometry g1;
geometry g2;

説明

二つのジオメトリ間の3次元の最大デカルト距離を空間参照系の単位で返します。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

Availability: 2.0.0

Changed: 2.2.0 - 2次元と3次元の場合には、もはや、存在しないZの値について0を仮定しません。

例

-- ジオメトリの例 - メートル単位(SRID: 2163 米国ナショナルアトラス正積図法)
-- (3次元ポイントとラインの距離と、2次元ポイントとラインの距離とを比較)
-- ご注意: 現在は垂直データムに対応していないので、Zは変換されずに、最終的に同じであると仮定されます。
SELECT ST_3DMaxDistance(
                        ST_Transform(ST_GeomFromEWKT('SRID=4326;POINT(-72.1235 42.3521 10000)'),2163),
                        ST_Transform(ST_GeomFromEWKT('SRID=4326;LINESTRING(-72.1260 42.45 15, -72.123 42.1546 20)'),2163)
                ) As dist_3d,
                ST_MaxDistance(
                        ST_Transform(ST_GeomFromEWKT('SRID=4326;POINT(-72.1235 42.3521 10000)'),2163),
                        ST_Transform(ST_GeomFromEWKT('SRID=4326;LINESTRING(-72.1260 42.45 15, -72.123 42.1546 20)'),2163)
                ) As dist_2d;

     dist_3d      |     dist_2d
------------------+------------------
 24383.7467488441 | 22247.8472107251

関連情報

ST_Distance, ST_3DDWithin, ST_3DMaxDistance, ST_Transform

Name

ST_MinimumClearance — ジオメトリのクリアランスの最小値を返します。この値はジオメトリのロバスト性を示すものです。

Synopsis

float ST_MinimumClearance(
g);

geometry g;

説明

ST_IsValid (ポリゴン)またはST_IsSimple (ライン)に従って、ジオメトリは妥当性基準を満たせますが、そのうちの一つの頂点が短い距離だけ移動すると不正になります。これは、テキスト書式 (WKT, KML, GML, GeoJSON等)に変換する際の精度の損失や、倍精度浮動小数点座標値を使わない書式 (MapInfo TAB等)で発生する可能性があります。

クリアランスの最小値は、座標精度を変更するためのジオメトリのロバスト性を定量的に計測したものです。ジオメトリの頂点が不正なジオメトリとなることなしに移動できる最大距離です。

ジオメトリがクリアランスの最小値eを持つ場合:

距離eより近くなるジオメトリ内の二つの個別の頂点はありません。

終端となる辺を除いて、辺との距離がeより近い頂点は存在しません。

ジオメトリのクリアランスの最小値が存在しない (単一POINT、要素が同じMULTIPOINT等)場合には、返り値はInfinityになります。

精度の損失による有効性の問題を回避するには、 ST_ReducePrecisionを使うと、ポリゴンジオメトリの妥当性を確実に維持しつつ座標値の精度を減らせられます。

Availability: 2.3.0

例

SELECT ST_MinimumClearance('POLYGON ((0 0, 1 0, 1 1, 0.5 3.2e-4, 0 0))');
 st_minimumclearance
---------------------
             0.00032

関連情報

ST_MinimumClearanceLine, ST_IsSimple, ST_IsValid, ST_ReducePrecision

Name

ST_MinimumClearanceLine — ジオメトリの最小クリアランスを示す、2点のラインストリングを返します。

Synopsis

Geometry ST_MinimumClearanceLine(
g);

geometry g;

説明

ジオメトリの最小クリアランスを示す、2点のラインストリングを返します。ジオメトリが最小クリアランスを持たない場合には、LINESTRING EMPTYが返ります。

GEOSモジュールで実現しています。

Availability: 2.3.0 - GEOS 3.6.0以上が必要です。

例

SELECT ST_AsText(ST_MinimumClearanceLine('POLYGON ((0 0, 1 0, 1 1, 0.5 3.2e-4, 0 0))'));
-------------------------------
LINESTRING(0.5 0.00032,0.5 0)

関連情報

ST_MinimumClearance

Name

ST_Perimeter — ポリゴンジオメトリまたはジオグラフィの境界の長さを返します。

Synopsis

float ST_Perimeter(
g1);

geometry g1;

float ST_Perimeter( | geog, |
| use_spheroid = true); |

geography geog;
boolean use_spheroid = true;

説明

ジオメトリ/ジオグラフィがST_SrrfaceまたはST_MultiSurface (POLYGONまたはMULTIPOLYGON)の場合に、2次元周囲長を返します。面ジオメトリでない場合には0を返します。ラインストリングについてはST_Lengthを使います。ジオメトリに対しては、周囲長の計測単位は空間参照系によります。

ジオグラフィに対しては、測地線の逆測地問題を使って計算し、長さの単位はメートルです。PostGISをPROJ 4.8.0以上でコンパイルしているなら、回転楕円体面はSRIDで指定されたものですが、そうでなければ、WGS84に限定されます。use_spheroid = falseとすると、回転楕円体面でなく近似する球面で計算します。

現在は、この関数はST_Perimeter2Dの別名ですが、高次元対応に変更されるかも知れません。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.5.1

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 8.1.3, 9.5.4

Availability: 2.0.0 ジオグラフィ対応が導入されました。

例: ジオメトリ

POLYGONとMULTIPOLYGONに対するフィート単位の周囲長を返します。EPSG:2249はフィート単位のマサチューセッツ平面なので、フィート単位です。

SELECT ST_Perimeter(ST_GeomFromText('POLYGON((743238 2967416,743238 2967450,743265 2967450,
743265.625 2967416,743238 2967416))', 2249));
st_perimeter
---------
 122.630744000095
(1 row)

SELECT ST_Perimeter(ST_GeomFromText('MULTIPOLYGON(((763104.471273676 2949418.44119003,
763104.477769673 2949418.42538203,
763104.189609677 2949418.22343004,763104.471273676 2949418.44119003)),
((763104.471273676 2949418.44119003,763095.804579742 2949436.33850239,
763086.132105649 2949451.46730207,763078.452329651 2949462.11549407,
763075.354136904 2949466.17407812,763064.362142565 2949477.64291974,
763059.953961626 2949481.28983009,762994.637609571 2949532.04103014,
762990.568508415 2949535.06640477,762986.710889563 2949539.61421415,
763117.237897679 2949709.50493431,763235.236617789 2949617.95619822,
763287.718121842 2949562.20592617,763111.553321674 2949423.91664605,
763104.471273676 2949418.44119003)))', 2249));
st_perimeter
---------
 845.227713366825
(1 row)

例: ジオグラフィ

ポリゴンとマルチポリゴンのメートル単位とフィート単位の周囲長を返します。ジオグラフィ (WGS 84経度緯度)であることに注意して下さい。

SELECT  ST_Perimeter(geog) As per_meters, ST_Perimeter(geog)/0.3048 As per_ft
FROM ST_GeogFromText('POLYGON((-71.1776848522251 42.3902896512902,-71.1776843766326 42.3903829478009,
-71.1775844305465 42.3903826677917,-71.1775825927231 42.3902893647987,-71.1776848522251 42.3902896512902))') As geog;

   per_meters    |      per_ft
-----------------+------------------
37.3790462565251 | 122.634666195949

-- MultiPolygon example --
SELECT  ST_Perimeter(geog) As per_meters, ST_Perimeter(geog,false) As per_sphere_meters,  ST_Perimeter(geog)/0.3048 As per_ft
FROM ST_GeogFromText('MULTIPOLYGON(((-71.1044543107478 42.340674480411,-71.1044542869917 42.3406744369506,
-71.1044553562977 42.340673886454,-71.1044543107478 42.340674480411)),
((-71.1044543107478 42.340674480411,-71.1044860600303 42.3407237015564,-71.1045215770124 42.3407653385914,
-71.1045498002983 42.3407946553165,-71.1045611902745 42.3408058316308,-71.1046016507427 42.340837442371,
-71.104617893173 42.3408475056957,-71.1048586153981 42.3409875993595,-71.1048736143677 42.3409959528211,
-71.1048878050242 42.3410084812078,-71.1044020965803 42.3414730072048,
-71.1039672113619 42.3412202916693,-71.1037740497748 42.3410666421308,
-71.1044280218456 42.3406894151355,-71.1044543107478 42.340674480411)))') As geog;

    per_meters    | per_sphere_meters |      per_ft
------------------+-------------------+------------------
 257.634283683311 |  257.412311446337 | 845.256836231335

関連情報

ST_GeogFromText, ST_GeomFromText, ST_Length

Name

ST_Perimeter2D — ポリゴンジオメトリの2次元周長を返します。ST_Perimeterの別名です。

Synopsis

float ST_Perimeter2D(
geomA);

geometry geomA;

説明

ポリゴンジオメトリの2次元周長を返します。

Note

これは、現在はST_Perimeterの別名です。将来的に、ST_Perimeterがジオメトリの最大次元の周囲長を返すようになるかも知れません。これは、まだ考慮中です。

関連情報

ST_Perimeter

Name

ST_3DPerimeter — ポリゴンジオメトリの3次元周長を返します。

Synopsis

float ST_3DPerimeter(
geomA);

geometry geomA;

説明

POLYGONまたはMULTIPOLYGONジオメトリの場合には、3次元周囲長を返します。ジオメトリが2次元の場合には、2次元周囲長を返します。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM ISO/IEC 13249-3: 8.1, 10.5

Changed: 2.0.0 以前の版ではST_Perimeter3Dと呼ばれていました。

例

フィート単位のマサチューセッツ州平面での、大気中にある、わずかに持ち上げられたポリゴンの周囲長です。

SELECT ST_3DPerimeter(geom), ST_Perimeter2d(geom), ST_Perimeter(geom) FROM
                        (SELECT ST_GeomFromEWKT('SRID=2249;POLYGON((743238 2967416 2,743238 2967450 1,
743265.625 2967416 1,743238 2967416 2))') As geom) As foo;

  ST_3DPerimeter  |  st_perimeter2d  |   st_perimeter
------------------+------------------+------------------
 105.465793597674 | 105.432997272188 | 105.432997272188

関連情報

ST_GeomFromEWKT, ST_Perimeter, ST_Perimeter2D

Name

ST_ShortestLine — 二つのジオメトリの3次元の最短ラインを返します。

Synopsis

geometry ST_ShortestLine( | geom1, |
| geom2); |

geometry geom1;
geometry geom2;

geography ST_ShortestLine( | geom1, |
| geom2, |
| use_spheroid = true); |

geography geom1;
geography geom2;
boolean use_spheroid = true;

説明

二つのジオメトリの間の2次元の最短ラインを返します。返されるラインはgeom1内から始まり、geom2内で終わります。geom1とgeom2がインタセクトしている場合には、結果はインタセクションするポイントを始点と終点にしたラインになります。ラインの長さはST_Distance でg1とg2を引数に取った時と同じになります。

Availability: 1.5.0

例

ポイントとラインストリングの最短ライン

SELECT ST_AsText(  ST_ShortestLine(
        'POINT (160 40)',
        'LINESTRING (10 30, 50 50, 30 110, 70 90, 180 140, 130 190)')
        ) As sline;
---------------------------------------------------------
 LINESTRING(160 40,125.75342465753425 115.34246575342466)

ポリゴン間の最短ライン

SELECT ST_AsText( ST_ShortestLine(
         'POLYGON ((190 150, 20 10, 160 70, 190 150))',
         ST_Buffer('POINT(80 160)', 30)
              ) ) AS llinewkt;
-----------------
LINESTRING(131.59149149528952 101.89887534906197,101.21320343559644 138.78679656440357)

関連情報

ST_ClosestPoint, ST_Distance, ST_LongestLine, ST_MaxDistance

Name

ST_3DShortestLine — 二つのジオメトリの3次元の最短ラインを返します。

Synopsis

geometry ST_3DShortestLine( | g1, |
| g2); |

geometry g1;
geometry g2;

説明

二つのジオメトリの3次元長が最短となるラインを返します。見つかった最短線が複数ある場合は、最初のもののみ返します。g1とg2が1点のみでインタセクトする場合は、インタセクション点を開始点と終了点とします。g1とg2が1点より多くインタセクトする場合は、同じ点を開始点と終了点としますが、その点は不定です。返されるラインは常にg1側を始点、g2側を終点とします。この関数が返すラインの長さは、常にg1とg2を指定した場合のST_3DDistanceが返す値と同じになります。

Availability: 2.0.0

Changed: 2.2.0 - 二つの2次元ジオメトリが入力である場合には、2次元ポイントが返ります (古い挙動では、存在しないZの値について0を仮定していました)。2次元と3次元の場合には、もはや、存在しないZの値について0を仮定しません。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

例

ラインストリングとポイント -- 3次元と2次元の最短ライン

SELECT ST_AsEWKT(ST_3DShortestLine(line,pt)) AS shl3d_line_pt,
                ST_AsEWKT(ST_ShortestLine(line,pt)) As shl2d_line_pt
        FROM (SELECT 'POINT(100 100 30)'::geometry As pt,
                        'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 1000)'::geometry As line
                ) As foo;

 shl3d_line_pt                                                                 |               shl2d_line_pt
----------------------------------------------------------------------------+------------------------------------------------------
 LINESTRING(54.6993798867619 128.935022917228 11.5475869506606,100 100 30)  | LINESTRING(73.0769230769231 115.384615384615,100 100)

ラインストリングとマルチポイント -- 3次元と2次元の最短ライン

SELECT ST_AsEWKT(ST_3DShortestLine(line,pt)) AS shl3d_line_pt,
                ST_AsEWKT(ST_ShortestLine(line,pt)) As shl2d_line_pt
        FROM (SELECT 'MULTIPOINT(100 100 30, 50 74 1000)'::geometry As pt,
                        'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 900)'::geometry As line
                ) As foo;

                       shl3d_line_pt                                       | shl2d_line_pt
---------------------------------------------------------------------------+------------------------
 LINESTRING(54.6993798867619 128.935022917228 11.5475869506606,100 100 30) | LINESTRING(50 75,50 74)

マルチラインストリングとポリゴンの3次元と2次元の最短ライン

SELECT ST_AsEWKT(ST_3DShortestLine(poly, mline)) As shl3d,
    ST_AsEWKT(ST_ShortestLine(poly, mline)) As shl2d
        FROM (SELECT  ST_GeomFromEWKT('POLYGON((175 150 5, 20 40 5, 35 45 5, 50 60 5, 100 100 5, 175 150 5))') As poly,
                ST_GeomFromEWKT('MULTILINESTRING((175 155 2, 20 40 20, 50 60 -2, 125 100 1, 175 155 1),
                (1 10 2, 5 20 1))') As mline ) As foo;
                   shl3d                                                                           |     shl2d
---------------------------------------------------------------------------------------------------+------------------------
 LINESTRING(39.993580415989 54.1889925532825 5,40.4078575708294 53.6052383805529 5.03423778139177) | LINESTRING(20 40,20 40)

関連情報

ST_3DClosestPoint, ST_3DDistance, ST_LongestLine, ST_ShortestLine, ST_3DMaxDistance

重ね合わせ関数

Abstract

これらの関数は、二つのジオメトリの重ね合わせから生まれる結果を計算するものです。ポイント集合理論の真偽値演算を行うものもあります。関連する関数もいくつか提供されています。

Name

ST_ClipByBox2D — 長方形内に落ちるジオメトリの一部を返します。

Synopsis

geometry ST_ClipByBox2D( | geom, |
| box); |

geometry geom;
box2d box;

説明

2次元ボックスでジオメトリを切り抜きます。高速ですが不正な方法になることもあります。トポロジ的に不正な入力ジオメトリでは例外が投げられ結果を返しません。出力ジオメトリの妥当性は保証されません (ポリゴンで自己インタセクションができるかも知れません)。

GEOSモジュールで実現しています。

Availability: 2.2.0

例

-- 第2引数はジオメトリからbox2dへの暗黙のキャストに依っています
SELECT ST_ClipByBox2D(the_geom, ST_MakeEnvelope(0,0,10,10)) FROM mytab;

関連情報

ST_Intersection, ST_MakeBox2D, ST_MakeEnvelope

Name

ST_Difference — ジオメトリBとインタセクトしていないジオメトリAの一部を表現するジオメトリを計算します。

Synopsis

geometry ST_Difference( | geomA, |
| geomB, |
| gridSize = -1); |

geometry geomA;
geometry geomB;
float8 gridSize = -1;

説明

ジオメトリBとインタセクトしていないジオメトリAの一部を表現するジオメトリを計算します。これはA - ST_Intersection(A,B)と同じです。Aが完全にBに包含されている場合には、適切なタイプの空のジオメトリが返されます。

Note

これは、重ね合わせ関数では唯一の入力順序を気にしなければならない関数です。ST_Difference(A, B)は常にAの一部を返します。

任意引数gridSizeが与えらえれた場合には、入力は与えられた大きさのグリッドにスナップされ、結果の￥頂点は同じグリッド上で計算されます (GEOS-3.9.0以上が必要)。

GEOSモジュールで実現しています。

Enhanced: 3.1.0 accept a gridSize parameter.

Requires GEOS >= 3.9.0 to use the gridSize parameter.

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.3

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.20

説明この関数は3次元に対応し、Z値を削除しません。ただし、結果はXYのみを使用して計算されます。結果のZ値は複写するか、平均値になるか、補間されます。

例

入力ラインストリング

二つのラインストリングの差

次では、2次元ラインストリングの差を求めます。

SELECT ST_AsText(
    ST_Difference(
            'LINESTRING(50 100, 50 200)'::geometry,
            'LINESTRING(50 50, 50 150)'::geometry
        )
    );

st_astext
---------
LINESTRING(50 150,50 200)

次では、3次元ラインストリングの差を求めます。

SELECT ST_AsEWKT( ST_Difference(
                   'MULTIPOINT(-118.58 38.38 5,-118.60 38.329 6,-118.614 38.281 7)' :: geometry,
                   'POINT(-118.614 38.281 5)' :: geometry
                  ) );

st_asewkt
---------
MULTIPOINT(-118.6 38.329 6,-118.58 38.38 5)

関連情報

ST_SymDifference, ST_Intersection, ST_Union

Name

ST_Intersection — ジオメトリAとジオメトリBの共通部分を表現するジオメトリを返します。

Synopsis

geometry ST_Intersection( | geomA, |
| geomB, |
| gridSize = -1); |

geometry geomA ;
geometry geomB ;
float8 gridSize = -1 ;

geography ST_Intersection( | geogA, |
| geogB); |

geography geogA ;
geography geogB ;

説明

二つのジオメトリのポイント集合の交差を表現するジオメトリを返します。言い換えると、ジオメトリAとジオメトリBの一部であって、二つのジオメトリで共有される部分を返します。

ジオメトリが共通するポイントを持っていない (つまり接続されていない)場合には、適切なタイプの空のジオメトリが返されます。

任意引数gridSizeが与えらえれた場合には、入力は与えられた大きさのグリッドにスナップされ、結果の￥頂点は同じグリッド上で計算されます (GEOS-3.9.0以上が必要)。

ST_Intersectsと併用するST_Intersectionは、バウンディングボックス、バッファや、対象の国や領域の内部にあるジオメトリの部分のみが必要な場合に使う領域クエリといったようなジオメトリの切り抜きに使えます。

Note

説明この関数のジオグラフィ版はジオメトリ実装にかぶせた薄いラッパです。最初に二つのジオグラフィ値のバウンディングボックスに適合する最適なSRIDを決定します (二つのジオグラフィ値がUTMゾーンの半分以内だけど同じUTMゾーンでない場合はどちらか一つを選びます) (UTMまたはランベルト正積方位図法の北極又は南極を優先し、最悪の場合にメルカトルに後退します)。次に、最適な平面空間参照系でインタセクトする領域を計算して、WGS84ジオグラフィに再変換します。

Warning

この関数はM値が存在している場合には削除します。

Warning

3次元ジオメトリで動作しますが、SFCGALベースのST_3DIntersectionは。3次元ジオメトリの確実な3次元インタセクトした領域を返すので、これを使った方がいいかも知れません。この関数はZ値があっても動作しますが、Z値は平均化されます。

GEOSモジュールで実現しています。

Enhanced: 3.1.0 accept a gridSize parameter

Requires GEOS >= 3.9.0 to use the gridSize parameter

Changed: 3.0.0 SFCGAL非依存になりました。

Availability: 1.5 ジオグラフィ型が導入されました。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.3

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.18

説明この関数は3次元に対応し、Z値を削除しません。ただし、結果はXYのみを使用して計算されます。結果のZ値は複写するか、平均値になるか、補間されます。

例

SELECT ST_AsText(ST_Intersection('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, 0 2 )'::geometry));
 st_astext
---------------
GEOMETRYCOLLECTION EMPTY

SELECT ST_AsText(ST_Intersection('POINT(0 0)'::geometry, 'LINESTRING ( 0 0, 0 2 )'::geometry));
 st_astext
---------------
POINT(0 0)

国別に全てのライン (trains)を切り抜きます。 国のジオメトリはPOLYGONまたはMULTIPOLYGONであると仮定します。ご注意: ポイントだけを共有するtrailsは気にしないので、LINESTRINGまたはMULTILINESTRINGの結果となるインタセクションだけを保持しています。ジオメトリコレクションを個々のマルチ系ジオメトリの要素に分解するためにダンプが必要です。下の例は非常に汎用的で、WHERE節を変更するだけでポリゴンでも動作します。

select clipped.gid, clipped.f_name, clipped_geom
from (
         select trails.gid, trails.f_name,
             (ST_Dump(ST_Intersection(country.geom, trails.geom))).geom clipped_geom
         from country
              inner join trails on ST_Intersects(country.geom, trails.geom)
     ) as clipped
where ST_Dimension(clipped.clipped_geom) = 1;

ランドマーク等のポリゴンに対しては、ポリゴンを除いたジオメトリを0.0でバッファを実行すると空ジオメトリコレクションが得られる、という速度向上のための技を使うことができます (それで、ポリゴン、ラインストリング、ポイントを含むジオメトリコレクションを0.0でバッファを実行すると、ポリゴンのみが残り、ジオメトリコレクションでなくなります)。

select poly.gid,
    ST_Multi(
        ST_Buffer(
            ST_Intersection(country.geom, poly.geom),
            0.0
        )
    ) clipped_geom
from country
     inner join poly on ST_Intersects(country.geom, poly.geom)
where not ST_IsEmpty(ST_Buffer(ST_Intersection(country.geom, poly.geom), 0.0));

例: 2.5次元的なもの

これは、本当のインタセクションではありません。ST_3DIntersectionの同じ例と比較して下さい。

select ST_AsText(ST_Intersection(linestring, polygon)) As wkt
from  ST_GeomFromText('LINESTRING Z (2 2 6,1.5 1.5 7,1 1 8,0.5 0.5 8,0 0 10)') AS linestring
 CROSS JOIN ST_GeomFromText('POLYGON((0 0 8, 0 1 8, 1 1 8, 1 0 8, 0 0 8))') AS polygon;

               st_astext
---------------------------------------
 LINESTRING Z (1 1 8,0.5 0.5 8,0 0 10)

関連情報

ST_3DIntersection, ST_Difference, ST_Union, ST_Dimension, ST_Dump, ST_Force2D, ST_SymDifference, ST_Intersects, ST_Multi

Name

ST_MemUnion — ジオメトリを結合する集約関数で、メモリを効率的に使いますが処理時間のかかるものです。

Synopsis

geometry ST_MemUnion(
geomfield);

geometry set geomfield;

説明

入力ジオメトリを結合してオーバラップをしない結果ジオメトリを生成する集約関数です。出力は単一ジオメトリ、マルチ系ジオメトリ、ジオメトリコレクションのいずれにかなる可能性があります。

Note

ST_Unionと同じ結果を生成しますが、メモリ使用が少なく、処理時間が長くなります。この集約関数はジオメトリの逐次加算的結合で動作しています。これは、最初に配列を蓄積して高速アルゴリズムで結合するST_Union集約関数と反対です。

説明この関数は3次元に対応し、Z値を削除しません。ただし、結果はXYのみを使用して計算されます。結果のZ値は複写するか、平均値になるか、補間されます。

例

SELECT id,
       ST_MemUnion(geom) as singlegeom
FROM sometable f
GROUP BY id;

関連情報

ST_Union

Name

ST_Node — ラインストリングの集合にノードを作成します。

Synopsis

geometry ST_Node(
geom);

geometry geom;

説明

ラインストリングのコレクションに完全にノードが加えられたものを表現する(マルチ)ラインストリングを返します。全ての入力ノードを保存したうえで、可能な最低の数だけノードを加えています。結果の線はディゾルブされています (重複線が削除されます)。

これはST_Polygonizeへの入力に適した、完全にノードを加えた線を生成する良い方法です。

ST_UnaryUnion も、ラインのノード追加とディゾルブに使うことができます。gridSizeを指定する任意引数を与えると、より単純かつよりロバストな出力が得られます。集約関数版についてはST_Unionをご覧下さい。

説明この関数は3次元に対応し、Z値を削除しません。

GEOSモジュールで実現しています。

Availability: 2.0.0

Changed: 2.4.0 この関数は内部でGEOSUnaryUnionの替わりにGEOSNodeを使用しています。ラインストリングの並び順と方向がPostGIS 2.4より前のものと違うことになるかも知れません。

例

自己交差する3次元ラインストリグにノードを加えます。

SELECT ST_AsText(
        ST_Node('LINESTRINGZ(0 0 0, 10 10 10, 0 10 5, 10 0 3)'::geometry)
    ) As  output;
output
-----------
MULTILINESTRING Z ((0 0 0,5 5 4.5),(5 5 4.5,10 10 10,0 10 5,5 5 4.5),(5 5 4.5,10 0 3))

線を共有する二つのラインストリングにノードを加えます。結果の線はディゾルブされます。

SELECT ST_AsText(
        ST_Node('MULTILINESTRING ((2 5, 2 1, 7 1), (6 1, 4 1, 2 3, 2 5))'::geometry)
    ) As  output;
output
-----------
MULTILINESTRING((2 5,2 3),(2 3,2 1,4 1),(4 1,2 3),(4 1,6 1),(6 1,7 1))

関連情報

ST_UnaryUnion, ST_Union

Name

ST_Split — ジオメトリを他のジオメトリで分割してできたジオメトリのコレクションを返します。

Synopsis

geometry ST_Split( | input, |
| blade); |

geometry input;
geometry blade;

説明

この関数は（MULTI)POINT、(MULTI)LINESTRING、(MULTI)POLYGONの境界によるLINESTRINGの分割と、LINESTRINGによる(MULTI)POLYGONの分割に対応します。(MULTI)POLYGONを刃として使うとき、線要素 (境界)は入力の分割に使われます。結果ジオメトリは常にコレクションです。

この関数はST_Unionの逆のようなものです。返されるコレクションにST_Unionを与えると、理論的には元のジオメトリが得られます (丸め誤差のために確実に同じになるものではありません)。

Note

入力と刃が数値の精度の問題でインタセクトしない場合には、入力が思ったように分割されない可能性があります。この状況を避けるには、先に、ST_Snapに小さい許容値を与えて、入力を刃にスナップする必要があるかも知れません。

Availability: 2.0.0 GEOSが必要です

Enhanced: 2.2.0 ライン分割をマルチライン、マルチポイントまたはポリゴンもしくはマルチポリゴンの境界で行えるようにしました。

Enhanced: 2.5.0 マルチラインによるポリゴンの分割に対応するようになりました。

例

ラインでポリゴンを分割します。

分割前

分割後

SELECT ST_AsText( ST_Split(
                ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50), -- circle
                ST_MakeLine(ST_Point(10, 10),ST_Point(190, 190)) -- line
    ));

-- 結果 --
 GEOMETRYCOLLECTION(
            POLYGON((150 90,149.039264020162 80.2454838991936,146.193976625564 70.8658283817455,..),
            POLYGON(..))
)

マルチラインストリングをポイントで分割しますが、ポイントは確実にラインストリングの要素の上に存在しています。

分割前

分割後

SELECT ST_AsText(ST_Split(
    'MULTILINESTRING((10 10, 190 191), (15 15, 30 30, 100 90))',
    ST_Point(30,30))) As split;

split
------
GEOMETRYCOLLECTION(
    LINESTRING(10 10,30 30),
    LINESTRING(30 30,190 190),
    LINESTRING(15 15,30 30),
    LINESTRING(30 30,100 90)
)

ラインストリングをライン上にないポイントで分割します。ST_Snapを使ってラインをポイントにスナップして分割できるようにしています。

WITH data AS (SELECT
  'LINESTRING(0 0, 100 100)'::geometry AS line,
  'POINT(51 50)':: geometry AS point
)
SELECT ST_AsText( ST_Split( ST_Snap(line, point, 1), point)) AS snapped_split,
       ST_AsText( ST_Split(line, point)) AS not_snapped_not_split
       FROM data;

                            snapped_split                            |            not_snapped_not_split
---------------------------------------------------------------------+---------------------------------------------
 GEOMETRYCOLLECTION(LINESTRING(0 0,51 50),LINESTRING(51 50,100 100)) | GEOMETRYCOLLECTION(LINESTRING(0 0,100 100))

関連情報

ST_Snap, ST_Union

Name

ST_Subdivide — ジオメトリの線の分割を計算します。

Synopsis

setof geometry ST_Subdivide( | geom, |
| max_vertices=256, |
| gridSize = -1); |

geometry geom;
integer max_vertices=256;
float8 gridSize = -1;

説明

geomを直線で分割したジオメトリの集合を返します。個々の部分はmax_vertices以下の頂点になります。

max_verticesは5以上でなければなりません。5点が閉じたボックスに必要だからです。gridSizeは固定精度空間での切り出しに指定できます (GEOS 3.9.0以上が必要)。

ポリゴン内のポイントと他の空間演算は、通常ではインデックスが付いた細分化されたデータセットの方が速くなります。通常は分割したジオメトリのバウンディングボックスは元ジオメトリのものよりも小さい領域になるので、インデックスのクエリで「当たり」となる場合が少なくなります。インデックスの再チェックによって実行される空間演算で処理されるポイント数が少なくなるので、「当たり」の場合は速度が速くなります。

Note

これは集合を返す関数 (SRF)です。単一ジオメトリ値を含む行の集合を返します。SELECTリストまたはFROM節で、結果ジオメトリごとに一つのレコードとなる結果集合を生成できます。

GEOSモジュールで実現しています。

Availability: 2.2.0

Enhanced: 2.5.0 ポリゴン分割で存在するポイントを再利用して頂点数の最小値を8から5に変更。

Enhanced: 3.1.0 accept a gridSize parameter.

Requires GEOS >= 3.9.0 to use the gridSize parameter

例

例: 個々のポリゴンが10頂点とならないようなポリゴンの分割と、個々に一意のIDの割り当て。

最大10頂点での分割

SELECT row_number() OVER() As rn, ST_AsText(geom) As wkt
    FROM (SELECT ST_SubDivide(
        'POLYGON((132 10,119 23,85 35,68 29,66 28,49 42,32 56,22 64,32 110,40 119,36 150,
        57 158,75 171,92 182,114 184,132 186,146 178,176 184,179 162,184 141,190 122,
        190 100,185 79,186 56,186 52,178 34,168 18,147 13,132 10))'::geometry,10))  AS f(geom);

rn │                                                      wkt
────┼────────────────────────────────────────────────────────────────────────────────────────────────────────────────
  1 │ POLYGON((119 23,85 35,68 29,66 28,32 56,22 64,29.8260869565217 100,119 100,119 23))
  2 │ POLYGON((132 10,119 23,119 56,186 56,186 52,178 34,168 18,147 13,132 10))
  3 │ POLYGON((119 56,119 100,190 100,185 79,186 56,119 56))
  4 │ POLYGON((29.8260869565217 100,32 110,40 119,36 150,57 158,75 171,92 182,114 184,114 100,29.8260869565217 100))
  5 │ POLYGON((114 184,132 186,146 178,176 184,179 162,184 141,190 122,190 100,114 100,114 184))

例: 長いジオグラフィのラインのST_Segmentize(geography, distance)による緻密化と、ST_Subdivideによるラインを8頂点の分割線への分割を行います。

ラインの緻密化と分割。

SELECT ST_AsText( ST_Subdivide(
            ST_Segmentize('LINESTRING(0 0, 85 85)'::geography,
                          1200000)::geometry,    8));

LINESTRING(0 0,0.487578359029357 5.57659056746196,0.984542144675897 11.1527721155093,1.50101059639722 16.7281035483571,1.94532113630331 21.25)
LINESTRING(1.94532113630331 21.25,2.04869538062779 22.3020741387339,2.64204641967673 27.8740533545155,3.29994062412787 33.443216802941,4.04836719489742 39.0084282520239,4.59890468420694 42.5)
LINESTRING(4.59890468420694 42.5,4.92498503922732 44.5680389206321,5.98737409390639 50.1195229244701,7.3290919767674 55.6587646879025,8.79638749938413 60.1969505994924)
LINESTRING(8.79638749938413 60.1969505994924,9.11375579533779 61.1785363177625,11.6558166691368 66.6648504160202,15.642041247655 72.0867690601745,22.8716627200212 77.3609628116894,24.6991785131552 77.8939011989848)
LINESTRING(24.6991785131552 77.8939011989848,39.4046096622744 82.1822848017636,44.7994523421035 82.5156766227011)
LINESTRING(44.7994523421035 82.5156766227011,85 85)

例: テーブルの適切な位置での複雑なジオメトリの分割。元のジオメトリのレコードはソーステーブルから削除され、分割された結果ジオメトリが代わりの新しいレコードになります。

WITH complex_areas_to_subdivide AS (
    DELETE from polygons_table
    WHERE ST_NPoints(geom)
> 255
    RETURNING id, column1, column2, column3, geom
)
INSERT INTO polygons_table (fid, column1, column2, column3, geom)
    SELECT fid, column1, column2, column3,
           ST_Subdivide(geom, 255) as geom
    FROM complex_areas_to_subdivide;

例: 分割されたジオメトリを持つ新しいテーブルを作ります。元のジオメトリのキーを保持して、新しいテーブルは元のテーブルと結合できます。ST_Subdivideは集合を返す関数で、行は単一の値を持つものですので、この構文で、結果の部分ごとに一つの行となるテーブルが自動的に生成されます。

CREATE TABLE subdivided_geoms AS
    SELECT pkey, ST_Subdivide(geom) AS geom
    FROM original_geoms;

関連情報

ST_ClipByBox2D, ST_Segmentize, ST_Split, ST_NPoints

Name

ST_SymDifference — ジオメトリAとジオメトリBがインタセクトしていない部分を表現するジオメトリを返します。

Synopsis

geometry ST_SymDifference( | geomA, |
| geomB, |
| gridSize = -1); |

geometry geomA;
geometry geomB;
float8 gridSize = -1;

説明

ジオメトリAとジオメトリBがインタセクトしていない部分を表現するジオメトリを返します。この関数は、ST_Union(A,B) - ST_Intersection(A,B)と同じです。SymDifference (対象差)と呼ばれるのはST_Union(A,B) - ST_Intersection(A,B)だからです。

任意引数gridSizeが与えらえれた場合には、入力は与えられた大きさのグリッドにスナップされ、結果の￥頂点は同じグリッド上で計算されます (GEOS-3.9.0以上が必要)。

GEOSモジュールで実現しています。

Enhanced: 3.1.0 accept a gridSize parameter.

Requires GEOS >= 3.9.0 to use the gridSize parameter

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.3

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.21

説明この関数は3次元に対応し、Z値を削除しません。ただし、結果はXYのみを使用して計算されます。結果のZ値は複写するか、平均値になるか、補間されます。

例

二つある元のラインストリングの両方

二つのラインストリングの対称差

-- 2次元では安全です - 二つのラインストリングの対称差
SELECT ST_AsText(
    ST_SymDifference(
        ST_GeomFromText('LINESTRING(50 100, 50 200)'),
        ST_GeomFromText('LINESTRING(50 50, 50 150)')
    )
);

st_astext
---------
MULTILINESTRING((50 150,50 200),(50 50,50 100))

-- 3次元で使用すると、完全には正しいものとはなりません
SELECT ST_AsEWKT(ST_SymDifference(ST_GeomFromEWKT('LINESTRING(1 2 1, 1 4 2)'),
    ST_GeomFromEWKT('LINESTRING(1 1 3, 1 3 4)')))

st_astext
------------
MULTILINESTRING((1 3 2.75,1 4 2),(1 1 3,1 2 2.25))

関連情報

ST_Difference, ST_Intersection, ST_Union

Name

ST_UnaryUnion — 単一のジオメトリの要素の結合を計算します。

Synopsis

geometry ST_UnaryUnion( | geom, |
| gridSize = -1); |

geometry geom;
float8 gridSize = -1;

説明

単一入力の形式のST_Unionです。入力は単一ジオメトリ、マルチ系ジオメトリ、ジオメトリコレクションが可能です。結合は、入力の個々のエレメントに適用されます。

この関数は要素間のオーバラップが原因で不正とされるマルチポリゴンを修正するのに使えます。しかしながら、入力の要素は妥当でなければなりません。蝶ネクタイポリゴンのような入力の個々の要素はエラーを引き起こすかも知れません。このためST_MakeValidを使う方が良いかも知れません。

この関数は、他に、クロスやオーバラップするラインストリングのコレクションを単純にするためのノード追加とディソルブに使われます (ST_Node も同様のことを行いますが、任意引数gridSizeを与えることができません。)

一度に結合するジオメトリの数量を調整するためにST_UnaryUnionとST_Collectとを混ぜることができます。メモリ使用と処理時間のトレードオフが可能になり、ST_UnionとST_MemUnionとのバランスが得られます。

任意引数gridSizeが与えらえれた場合には、入力は与えられた大きさのグリッドにスナップされ、結果の￥頂点は同じグリッド上で計算されます (GEOS-3.9.0以上が必要)。

説明この関数は3次元に対応し、Z値を削除しません。ただし、結果はXYのみを使用して計算されます。結果のZ値は複写するか、平均値になるか、補間されます。

Enhanced: 3.1.0 accept a gridSize parameter.

Requires GEOS >= 3.9.0 to use the gridSize parameter

Availability: 2.0.0

関連情報

ST_Union, ST_MemUnion, ST_MakeValid, ST_Collect, ST_Node

Name

ST_Union — 入力ジオメトリのポイント集合の結合を表現するジオメトリを返します。

Synopsis

geometry ST_Union( | g1, |
| g2); |

geometry g1;
geometry g2;

geometry ST_Union( | g1, |
| g2, |
| gridSize); |

geometry g1;
geometry g2;
float8 gridSize;

geometry ST_Union(
g1_array);

geometry[] g1_array;

geometry ST_Union(
g1field);

geometry set g1field;

geometry ST_Union( | g1field, |
| gridSize); |

geometry set g1field;
float8 gridSize;

説明

入力ジオメトリを結合してオーバラップをしない結果ジオメトリを生成します。出力は単一ジオメトリ、マルチ系ジオメトリ、ジオメトリコレクションのいずれにかなる可能性があります。次の通り複数の形式があります。

二入力形式: 二つの入力ジオメトリの結合のジオメトリを返します。いずれかの入力がNULLの場合にはNULLを返します。

配列形式: ジオメトリ配列を結合したジオメトリを返します。

集約関数形式: ジオメトリの集合を結合したジオメトリを返します。ST_Union()関数は、PostgreSQL用語で言うところの「集約関数」です。つまり、SUM()やMEAN()と同じ方法で複数のデータ行の操作を行い、他の集約関数と同じようにNULLジオメトリを無視します。

非集約関数で入力が一つの形式であるST_UnaryUnionも参照して下さい。

ST_Unionの配列形式と集合形式では、http://blog.cleverelephant.ca/2009/01/must-faster-unions-in-postgis-14.htmlで紹介されている早いカスケード結合アルゴリズムを使っています。

固定精度空間で動作するようgridSizeを指定できます。入力は与えられたグリッドにスナップされ、結果の頂点は同じグリッド上で計算されます (GEOS-3.9.0以上が必要です)。

Note

ST_Collect は、結果に重ね合わせが無いことを求めていない場合には、時々ST_Unionの代わりに用いられます。ST_Collectは、集めレれたジオメトリに処理を実行しないため、通常はST_Unionより早い動作速度になります。

GEOSモジュールで実現しています。

ST_UnionはMULTILINESTRINGを生成し、新しいLINESTRINGを単一のLINESTRINGに縫い付けません。LINESTRINGに縫い付けるにはST_LineMergeを使用します。

ご注意: この関数は以前は、"Union"から名称変更してGeomUnion()と呼ばれていました。UNIONはSQLの予約語であるためです。

Enhanced: 3.1.0 accept a gridSize parameter.

Requires GEOS >= 3.9.0 to use the gridSize parameter

Changed: 3.0.0 SFCGAL非依存になりました。

Availability: 1.4.0 - ST_Unionが機能強化されました。ST_Union(geomarray)が導入され、PostgreSQLの高速なコレクションの集約が導入されました。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.3

Note

集約関数版は、OGC仕様に明示的に定義されていません。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.19 ポリゴンが含まれる時、Z値 (標高)を持ちます。

説明この関数は3次元に対応し、Z値を削除しません。ただし、結果はXYのみを使用して計算されます。結果のZ値は複写するか、平均値になるか、補間されます。

例

集約関数版の例

SELECT id,
       ST_Union(geom) as singlegeom
FROM sometable f
GROUP BY id;

非集約関数の例

select ST_AsText(ST_Union('POINT(1 2)' :: geometry, 'POINT(-2 3)' :: geometry))

st_astext
----------
MULTIPOINT(-2 3,1 2)

select ST_AsText(ST_Union('POINT(1 2)' :: geometry, 'POINT(1 2)' :: geometry))

st_astext
----------
POINT(1 2)

3次元の例 - 3次元 (かつ混合次元)の種類

select ST_AsEWKT(ST_Union(geom))
from (
         select 'POLYGON((-7 4.2,-7.1 4.2,-7.1 4.3, -7 4.2))'::geometry geom
         union all
         select 'POINT(5 5 5)'::geometry geom
         union all
         select 'POINT(-2 3 1)'::geometry geom
         union all
         select 'LINESTRING(5 5 5, 10 10 10)'::geometry geom
     ) as foo;

st_asewkt
---------
GEOMETRYCOLLECTION(POINT(-2 3 1),LINESTRING(5 5 5,10 10 10),POLYGON((-7 4.2 5,-7.1 4.2 5,-7.1 4.3 5,-7 4.2 5)));

3次元の例 - 混合次元なし

select ST_AsEWKT(ST_Union(geom))
from (
         select 'POLYGON((-7 4.2 2,-7.1 4.2 3,-7.1 4.3 2, -7 4.2 2))'::geometry geom
         union all
         select 'POINT(5 5 5)'::geometry geom
         union all
         select 'POINT(-2 3 1)'::geometry geom
         union all
         select 'LINESTRING(5 5 5, 10 10 10)'::geometry geom
     ) as foo;

st_asewkt
---------
GEOMETRYCOLLECTION(POINT(-2 3 1),LINESTRING(5 5 5,10 10 10),POLYGON((-7 4.2 2,-7.1 4.2 3,-7.1 4.3 2,-7 4.2 2)))

-- 新しい配列コンストラクタを使った例 --
SELECT ST_Union(ARRAY(SELECT the_geom FROM sometable));

SELECT ST_AsText(ST_Union(ARRAY[ST_GeomFromText('LINESTRING(1 2, 3 4)'),
            ST_GeomFromText('LINESTRING(3 4, 4 5)')])) As wktunion;

--wktunion---
MULTILINESTRING((3 4,4 5),(1 2,3 4))

関連情報

ST_Collect, ST_UnaryUnion, ST_MemUnion, ST_Intersection, ST_Difference, ST_SymDifference

ジオメトリ処理関数

Abstract

これらの関数は幾何的構造の計算、すなわちジオメトリのサイズや形状を変更します。

Name

ST_Buffer — あるジオメトリからの距離が指定された距離以下となる点全ての集合となるジオメトリを返します。

Synopsis

geometry ST_Buffer( | g1, |
| radius_of_buffer, |
| buffer_style_parameters = ''); |

geometry g1;
float radius_of_buffer;
text buffer_style_parameters = '';

geometry ST_Buffer( | g1, |
| radius_of_buffer, |
| num_seg_quarter_circle); |

geometry g1;
float radius_of_buffer;
integer num_seg_quarter_circle;

geography ST_Buffer( | g1, |
| radius_of_buffer, |
| buffer_style_parameters); |

geography g1;
float radius_of_buffer;
text buffer_style_parameters;

geography ST_Buffer( | g1, |
| radius_of_buffer, |
| num_seg_quarter_circle); |

geography g1;
float radius_of_buffer;
integer num_seg_quarter_circle;

説明

ジオメトリ/ジオグラフィからの距離が与えられた距離より短くなる全ての点を表現するPOLYGONまたはMULTIPOLYGONを生成します。距離に負数を指定すると、ジオメトリは拡大されずに縮小されます。負の距離ではポリゴンを完全に縮小し切る可能性があり、その時はPOLYGON EMPTYを返します。ポイントとラインで負の距離を指定すると、常に空を返します。

ジオメトリの場合、指定される距離の単位は、ジオメトリの空間参照系の単位です。ジオグラフィの場合、指定される距離の単位はメートルです。

3番目のパラメータは任意で、バッファの精度とスタイルを扱います。バッファの円弧の精度は四分の一円の近似に使用される辺の数です (デフォルトは8)。バッファのスタイルは キー=値 のペアを空白区切りでリストにして指定します。キーは次の通りです。

'quad_segs=#' : 四分の一円近似に使う辺の数 (デフォルトは8)。

'endcap=round|flat|square' : 終端スタイル (デフォルトは "round")。'butt'は'flat'の同義語として受け付けます。

'join=round|mitre|bevel' : 接続スタイル (デフォルトは"round")。'miter'も'mitre'の同義語として受け付けます。

'mitre_limit=#.#' : マイター比 (訳注: 継ぎ目の内側と外側の距離と線幅との比)の最大値 (継ぎ目スタイルがmiterである場合のみ有効)。'miter_limit'は'mitre_limit'の同義語として受け付けます。

'side=both|left|right' : 'left'または'right'については、線の方向から見た相対的なサイドで、ジオメトリの片側バッファを実行します。これはLINESTRINGジオメトリにだけ関連して、POINTまたはPOLYGONジオメトリには影響がありません。デフォルトでは終端スタイルは四角形です。

Note

説明この関数のジオグラフィ版はジオメトリ実装にかぶせた薄いラッパです。ジオメトリのバウンディングボックスに最適な平面空間参照系を決定します (UTM、ランベルト正積方位図法の北極/南極、最後はメルカトルです)。バッファは平面空間で計算あｓれ、WGS84に戻されます。このため、入力がUTMゾーンと比べて非常に大きくなったり、日付変更線とクロスしたりする場合に、求める動作をしないことがあります

Note

バッファ出力は常に妥当なポリゴンジオメトリです。バッファは不正な入力を処理できるので、不正なポリゴンを修復する方法として、距離0のバッファリングが使われます。同じ目的の関数としてはST_MakeValidが使われます。

Note

バッファ作成は時々、距離内にある地物を検索する際に使われます。この使い方については、ST_DWithinの方が効率的です。

Note

この関数はZ値を無視します。この関数を3次元ジオメトリ上で使用したとしても、常に2次元の結果となります。

Enhanced: 2.5.0 - ST_Bufferのジオメトリ対応版が強化され、バッファを施す側をside=both|left|rightで指定できるようになりました。

Availability: 1.5 - ST_Bufferが強化され、様々な終端と継ぎ目に対応するようになりました。たとえば、道路ラインストリングを道路ポリゴンに変換する際に終端を丸でなく平面や四角で処理したい場合などに使えます。ジオグラフィ用の薄いラッパが追加されました。

GEOSモジュールで実現しています。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.3

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 5.1.30

例

quad_segs=8 (デフォルト)

SELECT ST_Buffer(
 ST_GeomFromText('POINT(100 90)'),
 50, 'quad_segs=8');

quad_segs=2 (不十分)

SELECT ST_Buffer(
 ST_GeomFromText('POINT(100 90)'),
 50, 'quad_segs=2');

endcap=round join=round (デフォルト)

SELECT ST_Buffer(
 ST_GeomFromText(
  'LINESTRING(50 50,150 150,150 50)'
 ), 10, 'endcap=round join=round');

endcap=square

SELECT ST_Buffer(
 ST_GeomFromText(
  'LINESTRING(50 50,150 150,150 50)'
 ), 10, 'endcap=square join=round');

endcap=flat

SELECT ST_Buffer(
 ST_GeomFromText(
  'LINESTRING(50 50,150 150,150 50)'
 ), 10, 'endcap=flat join=round');

join=bevel

SELECT ST_Buffer(
 ST_GeomFromText(
  'LINESTRING(50 50,150 150,150 50)'
 ), 10, 'join=bevel');

join=mitre mitre_limit=5.0 (デフォルトの最大マイター比)

SELECT ST_Buffer(
 ST_GeomFromText(
  'LINESTRING(50 50,150 150,150 50)'
 ), 10, 'join=mitre mitre_limit=5.0');

join=mitre mitre_limit=1

SELECT ST_Buffer(
 ST_GeomFromText(
  'LINESTRING(50 50,150 150,150 50)'
 ), 10, 'join=mitre mitre_limit=1.0');

side=left

SELECT ST_Buffer(
 ST_GeomFromText(
  'LINESTRING(50 50,150 150,150 50)'
 ), 10, 'side=left');

side=right

SELECT ST_Buffer(
 ST_GeomFromText(
  'LINESTRING(50 50,150 150,150 50)'
 ), 10, 'side=right');

side=left join=mitre

SELECT ST_Buffer(
 ST_GeomFromText(
  'LINESTRING(50 50,150 150,150 50)'
 ), 10, 'side=left join=mitre');

右回り、ポリゴン境界は左

SELECT ST_Buffer(
ST_ForceRHR(
ST_Boundary(
 ST_GeomFromText(
'POLYGON ((50 50, 50 150, 150 150, 150 50, 50 50))'))),
 ), 20, 'side=left');

右回り、ポリゴン境界は右

SELECT ST_Buffer(
ST_ForceRHR(
ST_Boundary(
 ST_GeomFromText(
'POLYGON ((50 50, 50 150, 150 150, 150 50, 50 50))'))
), 20,'side=right')

-- ポイントに対する近似円バッファ
-- 4分の1円を2点で近似するようポイントに施したバッファは8辺のポリゴンです。
-- (ダイアグラム参照)
SELECT ST_NPoints(ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50)) As promisingcircle_pcount,
ST_NPoints(ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50, 2)) As lamecircle_pcount;

promisingcircle_pcount | lamecircle_pcount
------------------------+-------------------
             33 |                9

-- 手軽だけれども不十分な円(4分の1円で2点だけの八角形)
-- 次に示すのは100メートルの八角形です。
-- 座標系は、元はNAD 83経度緯度で、
-- メートル単位マサチューセッツ州平面に変換してから、
-- メートルでバッファを取っています。
SELECT ST_AsText(ST_Buffer(
ST_Transform(
ST_SetSRID(ST_Point(-71.063526, 42.35785),4269), 26986)
,100,2)) As octagon;
----------------------
POLYGON((236057.59057465 900908.759918696,236028.301252769 900838.049240578,235
957.59057465 900808.759918696,235886.879896532 900838.049240578,235857.59057465
900908.759918696,235886.879896532 900979.470596815,235957.59057465 901008.759918
696,236028.301252769 900979.470596815,236057.59057465 900908.759918696))

関連情報

ST_Collect, ST_DWithin, ST_SetSRID, ST_Transform, ST_Union, ST_MakeValid

Name

ST_BuildArea — 与えられたジオメトリの構成ラインから面ジオメトリを生成します。

Synopsis

geometry ST_BuildArea(
geom);

geometry geom;

説明

与えられたジオメトリの構成ラインから面ジオメトリを生成します。入力としてLINESTRING, MULTILINESTRING, POLYGON, MULTIPOLYGON, GEOMETRYCOLLECTIONを取ることができます。返り値は、ポリゴンまたはマルチポリゴンで、どちらになるかは入力に依存します。入力構成ラインがポリゴンを形成しない場合はNULLを返します。

この関数は全ての内部ジオメトリが穴を表現すると仮定します。

Note

この関数が正しく動作するには、入力ラインに正しくノードが作成されている必要があります。

Availability: 1.1.0

例

ドーナツを生成します。

using polygons
SELECT ST_BuildArea(ST_Collect(smallc,bigc))
FROM (SELECT
    ST_Buffer(
      ST_GeomFromText('POINT(100 90)'), 25) As smallc,
    ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50) As bigc) As foo;

using linestrings
SELECT ST_BuildArea(ST_Collect(smallc,bigc))
FROM (SELECT
    ST_ExteriorRing(ST_Buffer(
      ST_GeomFromText('POINT(100 90)'), 25)) As smallc,
    ST_ExteriorRing(ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50)) As bigc) As foo;

関連情報

ST_Node, ST_MakePolygon, ST_MakeValid, ST_BdPolyFromText, ST_BdMPolyFromText (wrappers to this function with standard OGC interface)

Name

ST_Centroid — ジオメトリの幾何学的重心を返します。

Synopsis

geometry ST_Centroid(
g1);

geometry g1;

geography ST_Centroid( | g1, |
| use_spheroid = true); |

geography g1;
boolean use_spheroid = true;

説明

ジオメトリの幾何学的重心を計算します。[MULTI]POINTに対しては、入力座標の算術平均として計算されます。 [MULTI]LINESTRINGに対しては、各辺の重み付き長さとして計算されます。 [MULTI]POLYGONに対しては、面積から計算されます。空ジオメトリが与えられた場合には、空のGEOMETRYCOLLECTIONが返されます。NULLが与えられた場合には、NULLが返されます。CIRCULARSTRINGまたはCOMPOUNDCURVEが与えられた場合には、まずCurveToLineで直線に変換されてから、LINESTRINGと同じ計算を行います。

入力が混合次元の場合には、結果は最大次元のジオメトリの重心と同じになります (低次元ジオメトリは重心に0の「重み」を与えるためです)。

ポリゴンジオメトリに対しては、重心は必ずしもポリゴンの内部にあるわけではないことに注意して下さい。たとえば、下図のCの形のポリゴンの重心をご覧下さい。ポリゴン内部にポイントがあることを保障するにはST_PointOnSurfaceを使います。

New in 2.3.0 : CIRCULARSTRINGとCOMPOUNDCURVEに対応するようになりました (CurveToLineを使います)。

Availability: 2.4.0 ジオグラフィが導入されました。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 8.1.4, 9.5.5

例

次に示す図では、赤点が入力ジオメトリの重心です。

MULTIPOINTの重心

LINESTRINGの重心

POLYGONの重心

GEOMETRYCOLLECTIONの重心

SELECT ST_AsText(ST_Centroid('MULTIPOINT ( -1 0, -1 2, -1 3, -1 4, -1 7, 0 1, 0 3, 1 1, 2 0, 6 0, 7 8, 9 8, 10 6 )'));
                st_astext
------------------------------------------
 POINT(2.30769230769231 3.30769230769231)
(1 row)

SELECT ST_AsText(ST_centroid(g))
FROM  ST_GeomFromText('CIRCULARSTRING(0 2, -1 1,0 0, 0.5 0, 1 0, 2 1, 1 2, 0.5 2, 0 2)')  AS g ;
------------------------------------------
POINT(0.5 1)

SELECT ST_AsText(ST_centroid(g))
FROM  ST_GeomFromText('COMPOUNDCURVE(CIRCULARSTRING(0 2, -1 1,0 0),(0 0, 0.5 0, 1 0),CIRCULARSTRING( 1 0, 2 1, 1 2),(1 2, 0.5 2, 0 2))' ) AS g;
------------------------------------------
POINT(0.5 1)

関連情報

ST_PointOnSurface, ST_GeometricMedian

Name

ST_ChaikinSmoothing — チャイキンのアルゴリズムを使って、与えられたジオメトリの平滑化されたものを返します。

Synopsis

geometry ST_ChaikinSmoothing( | geom, |
| nIterations = 1, |
| preserveEndPoints = false); |

geometry geom;
integer nIterations = 1;
boolean preserveEndPoints = false;

説明

チャイキンのアルゴリズムを使ってラインまたはポリゴンのジオメトリの平滑化を行います。平滑化の度合いはnIterationsパラメータで制御します。繰り返しごとに、各々の内部の頂点は、頂点を挟む辺の上で、長さが1/4となる位置の二つの頂点に置き換えます。平滑化の合理的な度合いは3回反復です。最大値は5に制限されています。

preserveEndPointsがTRUEの場合には、ポリゴンの環の終端が平滑化されません。ラインストリングの終端は常に保存されます。

Note

頂点数は繰り返し回数の2倍です。結果ジオメトリは入力ジオメトリより多くのポイントを含むことになります。ポイント数を減らすには、結果に対して単純化関数を実行します (ST_Simplify, ST_SimplifyPreserveTopology, ST_SimplifyVWを参照して下さい)。

結果には、Z値とM値が存在する場合には、これらの補間値が入ります。

説明この関数は3次元に対応し、Z値を削除しません。

Availability: 2.5.0

例

三角形の平滑化:

SELECT ST_AsText(ST_ChaikinSmoothing(geom)) smoothed
FROM (SELECT  'POLYGON((0 0, 8 8, 0 16, 0 0))'::geometry geom) AS foo;

                 smoothed
───────────────────────────────────────────
 POLYGON((2 2,6 6,6 10,2 14,0 12,0 4,2 2))

1, 2, 3反復を使ったポリゴンの平滑化:

nIterations = 1

nIterations = 2

nIterations = 3

SELECT ST_ChaikinSmoothing(
            'POLYGON ((20 20, 60 90, 10 150, 100 190, 190 160, 130 120, 190 50, 140 70, 120 10, 90 60, 20 20))',
            generate_series(1, 3) );

1, 2, 3反復を使ったラインストリングの平滑化:

nIterations = 1

nIterations = 2

nIterations = 3

SELECT ST_ChaikinSmoothing(
            'LINESTRING (10 140, 80 130, 100 190, 190 150, 140 20, 120 120, 50 30, 30 100)',
            generate_series(1, 3) );

関連情報

ST_Simplify, ST_SimplifyPreserveTopology, ST_SimplifyVW

Name

ST_ConcaveHull — 全ての入力ジオメトリの頂点を含む凹ジオメトリを計算します。

Synopsis

geometry ST_ConcaveHull( | param_geom, |
| param_pctconvex, |
| param_allow_holes = false); |

geometry param_geom;
float param_pctconvex;
boolean param_allow_holes = false;

説明

凹包は (通常は)入力ジオメトリを包含する凹ジオメトリで、凹ジオメトリの頂点は入力頂点の部分集合です。一般的に凹包はポリゴンです。二つ以上の同一線上の点の凹包は2点のラインストリングです。一つ以上の同一点の凹包はポイントです。 param_allow_holes引数ににTRUEを与えない限りポリゴンは穴を持ちません。

凹包はジオメトリの集合を「真空パック」したジオメトリと考えることができます。輪ゴムで囲うのに似ている凸包と違います。凹包は一般的に面積が小さく、また入力ポイントからなる境界が自然になります。

param_pctconvexは計算される凹包の凹度を制御するためのものです。1では凸包になります。1から0に変化させると凹度が増加していきます。0では最大の凹度の凹包になります (ただし単一ポリゴンのままです)。適切な値は入力データ固有のものですが、多くの場合0.3と0.1の間が適正な結果となります。

Note

技術的にはparam_pctconvexは、入力ポイントのドロネー三角分割における最長エッジと最短エッジとの差の割合で示される長さを決定します。この長さより長いエッジは、三角分割で「浸食」されます。残りの三角形は凹包を形成します。

ポイントとラインの入力では、凹包は入力ポイントをポイントとラインの入力では、凹包は全ての入力ポイントを包みます。ポリゴン入力では、凹包は全ての入力ポイントを含み、なおかつ入力ポリゴンが及ぶ全ての面を含みます。ポリゴン入力でもポイントとして計算した凹包が欲しい場合には、ST_Pointsを使って、まずポイントに変換して下さい。

これは集約関数ではありません。ジオメトリ集合の凹包の計算にはST_Collectを使います (例 ST_ConcaveHull( ST_Collect( geom ), 0.80))。

Availability: 2.0.0

Enhanced: 3.3.0, GEOS 3.11からGEOSネイティブ実装が有効になりました

例

マルチポイントの凹包

SELECT ST_AsText( ST_ConcaveHull(
        'MULTIPOINT ((10 72), (53 76), (56 66), (63 58), (71 51), (81 48), (91 46), (101 45), (111 46), (121 47), (131 50), (140 55), (145 64), (144 74), (135 80), (125 83), (115 85), (105 87), (95 89), (85 91), (75 93), (65 95), (55 98), (45 102), (37 107), (29 114), (22 122), (19 132), (18 142), (21 151), (27 160), (35 167), (44 172), (54 175), (64 178), (74 180), (84 181), (94 181), (104 181), (114 181), (124 181), (134 179), (144 177), (153 173), (162 168), (171 162), (177 154), (182 145), (184 135), (139 132), (136 142), (128 149), (119 153), (109 155), (99 155), (89 155), (79 153), (69 150), (61 144), (63 134), (72 128), (82 125), (92 123), (102 121), (112 119), (122 118), (132 116), (142 113), (151 110), (161 106), (170 102), (178 96), (185 88), (189 78), (190 68), (189 58), (185 49), (179 41), (171 34), (162 29), (153 25), (143 23), (133 21), (123 19), (113 19), (102 19), (92 19), (82 19), (72 21), (62 22), (52 25), (43 29), (33 34), (25 41), (19 49), (14 58), (21 73), (31 74), (42 74), (173 134), (161 134), (150 133), (97 104), (52 117), (157 156), (94 171), (112 106), (169 73), (58 165), (149 40), (70 33), (147 157), (48 153), (140 96), (47 129), (173 55), (144 86), (159 67), (150 146), (38 136), (111 170), (124 94), (26 59), (60 41), (71 162), (41 64), (88 110), (122 34), (151 97), (157 56), (39 146), (88 33), (159 45), (47 56), (138 40), (129 165), (33 48), (106 31), (169 147), (37 122), (71 109), (163 89), (37 156), (82 170), (180 72), (29 142), (46 41), (59 155), (124 106), (157 80), (175 82), (56 50), (62 116), (113 95), (144 167))',
         0.1 ) );
---st_astext--
POLYGON ((18 142, 21 151, 27 160, 35 167, 44 172, 54 175, 64 178, 74 180, 84 181, 94 181, 104 181, 114 181, 124 181, 134 179, 144 177, 153 173, 162 168, 171 162, 177 154, 182 145, 184 135, 173 134, 161 134, 150 133, 139 132, 136 142, 128 149, 119 153, 109 155, 99 155, 89 155, 79 153, 69 150, 61 144, 63 134, 72 128, 82 125, 92 123, 102 121, 112 119, 122 118, 132 116, 142 113, 151 110, 161 106, 170 102, 178 96, 185 88, 189 78, 190 68, 189 58, 185 49, 179 41, 171 34, 162 29, 153 25, 143 23, 133 21, 123 19, 113 19, 102 19, 92 19, 82 19, 72 21, 62 22, 52 25, 43 29, 33 34, 25 41, 19 49, 14 58, 10 72, 21 73, 31 74, 42 74, 53 76, 56 66, 63 58, 71 51, 81 48, 91 46, 101 45, 111 46, 121 47, 131 50, 140 55, 145 64, 144 74, 135 80, 125 83, 115 85, 105 87, 95 89, 85 91, 75 93, 65 95, 55 98, 45 102, 37 107, 29 114, 22 122, 19 132, 18 142))

穴を作れるマルチポイントの凹包

SELECT ST_AsText( ST_ConcaveHull(
        'MULTIPOINT ((132 64), (114 64), (99 64), (81 64), (63 64), (57 49), (52 36), (46 20), (37 20), (26 20), (32 36), (39 55), (43 69), (50 84), (57 100), (63 118), (68 133), (74 149), (81 164), (88 180), (101 180), (112 180), (119 164), (126 149), (132 131), (139 113), (143 100), (150 84), (157 69), (163 51), (168 36), (174 20), (163 20), (150 20), (143 36), (139 49), (132 64), (99 151), (92 138), (88 124), (81 109), (74 93), (70 82), (83 82), (99 82), (112 82), (126 82), (121 96), (114 109), (110 122), (103 138), (99 151), (34 27), (43 31), (48 44), (46 58), (52 73), (63 73), (61 84), (72 71), (90 69), (101 76), (123 71), (141 62), (166 27), (150 33), (159 36), (146 44), (154 53), (152 62), (146 73), (134 76), (143 82), (141 91), (130 98), (126 104), (132 113), (128 127), (117 122), (112 133), (119 144), (108 147), (119 153), (110 171), (103 164), (92 171), (86 160), (88 142), (79 140), (72 124), (83 131), (79 118), (68 113), (63 102), (68 93), (35 45))',
         0.15, true ) );
---st_astext--
POLYGON ((43 69, 50 84, 57 100, 63 118, 68 133, 74 149, 81 164, 88 180, 101 180, 112 180, 119 164, 126 149, 132 131, 139 113, 143 100, 150 84, 157 69, 163 51, 168 36, 174 20, 163 20, 150 20, 143 36, 139 49, 132 64, 114 64, 99 64, 81 64, 63 64, 57 49, 52 36, 46 20, 37 20, 26 20, 32 36, 35 45, 39 55, 43 69), (88 124, 81 109, 74 93, 83 82, 99 82, 112 82, 121 96, 114 109, 110 122, 103 138, 92 138, 88 124))

polygon_hull

points_hull

ポリゴンの凹包と構成ポイントの凹包との比較。凹包はポリゴンの境界を考慮しますが、ポイントを基にした凹包では考慮されません。

WITH data(geom) AS (VALUES
   ('POLYGON ((10 90, 39 85, 61 79, 50 90, 80 80, 95 55, 25 60, 90 45, 70 16, 63 38, 60 10, 50 30, 43 27, 30 10, 20 20, 10 90))'::geometry)
)
SELECT  ST_ConcaveHull( geom,            0.1) AS polygon_hull,
        ST_ConcaveHull( ST_Points(geom), 0.1) AS points_hull
    FROM data;

ST_Collectの併用でジオメトリ集合の凹包の計算。

-- ポイントの観察に基づいた感染領域の見積もりの計算
SELECT disease_type,
    ST_ConcaveHull( ST_Collect(obs_pnt), 0.3 ) AS geom
  FROM disease_obs
  GROUP BY disease_type;

関連情報

ST_ConvexHull, ST_Collect, ST_AlphaShape, ST_OptimalAlphaShape

Name

ST_ConvexHull — ジオメトリの凸包を計算します。

Synopsis

geometry ST_ConvexHull(
geomA);

geometry geomA;

説明

ジオメトリの凸包を計算します。凸包は、入力ジオメトリのすべてを囲む最小の凸ジオメトリです。

凸包は、ジオメトリの集合に輪ゴムをかけて得られるジオメトリと見ることができます。これは「真空パック」に似ている凹包と異なります。凸包は観察ポイントの集合に基づいて、響を受けた領域を決定するために、しばしば使われます。

凸包は一般的にポリゴンです。二つ以上の同一線上のポイントの凸包は、2点のラインストリングになります。一つ以上の同一ポイントの凸包はポイントです。

集約関数ではありません。ジオメトリ集合の凸包を計算するには、ジオメトリ集合をジオメトリコレクションに集約するST_Collectを使います (ST_ConvexHull(ST_Collect(geom))等)。

GEOSモジュールで実現しています。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.3

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 5.1.16

説明この関数は3次元に対応し、Z値を削除しません。

例

マルチラインストリングとマルチポイントの凸包

SELECT ST_AsText(ST_ConvexHull(
    ST_Collect(
        ST_GeomFromText('MULTILINESTRING((100 190,10 8),(150 10, 20 30))'),
            ST_GeomFromText('MULTIPOINT(50 5, 150 30, 50 10, 10 10)')
            )) );
---st_astext--
POLYGON((50 5,10 8,10 10,100 190,150 30,150 10,50 5))

ST_Collectを使ってジオメトリ集合の凸包を計算します。

-- 観測ポイントに基づく感染面積の推定
SELECT d.disease_type,
    ST_ConvexHull(ST_Collect(d.geom)) As geom
    FROM disease_obs As d
    GROUP BY d.disease_type;

関連情報

ST_Collect, ST_ConcaveHull, ST_MinimumBoundingCircle

Name

ST_DelaunayTriangles — ジオメトリの頂点のドローネ三角形を返します。

Synopsis

geometry ST_DelaunayTriangles( | g1, |
| tolerance = 0.0, |
| flags = 0); |

geometry g1;
float tolerance = 0.0;
int4 flags = 0;

説明

入力ジオメトリの頂点のドロネー三角形を計算します。任意引数toleranceは、入力頂点が近いとスナップする際に使います。ロバスト性が増すことがあります。結果ジオメトリの境界は入力頂点の凸包と同じになります。結果ジオメトリの表現は、次に示すflagsコードによって変わります。

0 - 三角形のPOLYGONからなるGEOMETRYCOLLECTION (デフォルト)

1 - 三角形の辺のMULTILINESTRING

2 - 三角形のTIN

GEOSモジュールで実現しています。

Availability: 2.1.0

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

元のポリゴン

our original geometry
    ST_Union(ST_GeomFromText('POLYGON((175 150, 20 40,
            50 60, 125 100, 175 150))'),
        ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)
        )

二つのポリゴンのST_DelaunayTriangles: ポリゴンごとに異なる色をつけたドロネー三角形ポリゴン

geometries overlaid multilinestring triangles

SELECT
    ST_DelaunayTriangles(
        ST_Union(ST_GeomFromText('POLYGON((175 150, 20 40,
            50 60, 125 100, 175 150))'),
        ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)
        ))
     As  dtriag;

マルチラインストリングにしたドロネー三角形

SELECT
    ST_DelaunayTriangles(
        ST_Union(ST_GeomFromText('POLYGON((175 150, 20 40,
            50 60, 125 100, 175 150))'),
        ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)
        ),0.001,1)
     As  dtriag;

45個のポイントから生成した55個のドロネー三角形

this produces a table of 42 points that form an L shape

SELECT (ST_DumpPoints(ST_GeomFromText(
'MULTIPOINT(14 14,34 14,54 14,74 14,94 14,114 14,134 14,
150 14,154 14,154 6,134 6,114 6,94 6,74 6,54 6,34 6,
14 6,10 6,8 6,7 7,6 8,6 10,6 30,6 50,6 70,6 90,6 110,6 130,
6 150,6 170,6 190,6 194,14 194,14 174,14 154,14 134,14 114,
14 94,14 74,14 54,14 34,14 14)'))).geom
    INTO TABLE l_shape;

output as individual polygon triangles

SELECT ST_AsText((ST_Dump(geom)).geom) As wkt
FROM ( SELECT ST_DelaunayTriangles(ST_Collect(geom)) As geom
FROM l_shape) As foo;

wkt

POLYGON((6 194,6 190,14 194,6 194))
POLYGON((14 194,6 190,14 174,14 194))
POLYGON((14 194,14 174,154 14,14 194))
POLYGON((154 14,14 174,14 154,154 14))
POLYGON((154 14,14 154,150 14,154 14))
POLYGON((154 14,150 14,154 6,154 14))

Z値を持つ頂点を使う例。

3D multipoint

SELECT ST_AsText(ST_DelaunayTriangles(ST_GeomFromText(
         'MULTIPOINT Z(14 14 10, 150 14 100,34 6 25, 20 10 150)'))) As wkt;

wkt

GEOMETRYCOLLECTION Z (POLYGON Z ((14 14 10,20 10 150,34 6 25,14 14 10))
 ,POLYGON Z ((14 14 10,34 6 25,150 14 100,14 14 10)))

関連情報

ST_VoronoiPolygons, ST_TriangulatePolygon, ST_ConstrainedDelaunayTriangles, ST_VoronoiLines, ST_ConvexHull

Name

ST_FilterByM — M値に基づいて頂点を削除します。

Synopsis

geometry ST_FilterByM( | geom, |
| min, |
| max = null, |
| returnM = false); |

geometry geom;
double precision min;
double precision max = null;
boolean returnM = false;

説明

M値に基づいた頂点ポイントのフィルタリングを行います。返されるジオメトリは最小値(min値)以上かつ最大値(max値)以下のM値を持つポイントだけでできています。最大値の引数が指定されていない場合には、最小値のみ考慮されます。第4引数が指定されていない場合には、M値は結果ジオメトリに存在しません。結果ジオメトリの頂点ポイントの数が、ジオメトリを構成するに必要な数に達しない場合には、空ジオメトリが返されます。ジオメトリコレクション内の、十分なポイントを持たないジオメトリ要素は消えます。

この関数は主にST_SetEffectiveAreaとの併用を意図しています。ST_SetEffectiveAreaは頂点の有効面積をM値に設定します。ST_FilterByMによるフィルタリングだけで、他の計算なしに簡略化されたジオメトリを得られます。

Note

ポイント数が基準を満たすのに十分でない時のST_SimplifyVWの返り値とST_FilterByMの返り値とで違いがあります。ST_FilterByMは空ジオメトリを返し、ST_SimplifyVWは十分なポイントを持つジオメトリを返します。

Note

返されるジオメトリは不正である場合があることに注意して下さい。

Note

この関数は全ての次元を返し、Z値もM値も残ります。

Availability: 2.5.0

例

フィルタリングされたラインストリング

SELECT ST_AsText(ST_FilterByM(geom,30)) simplified
FROM (SELECT  ST_SetEffectiveArea('LINESTRING(5 2, 3 8, 6 20, 7 25, 10 10)'::geometry) geom) As foo;

result

         simplified
----------------------------
 LINESTRING(5 2,7 25,10 10)

関連情報

ST_SetEffectiveArea, ST_SimplifyVW

Name

ST_GeneratePoints — ポリゴン内やマルチポリゴン内にランダムなポイントを生成します。

Synopsis

geometry ST_GeneratePoints( | g, |
| npoints); |

g geometry ;
npoints integer ;

geometry ST_GeneratePoints( | g, |
| npoints, |
| seed = 0); |

geometry g ;
integer npoints ;
integer seed = 0 ;

説明

ST_GeneratePointsは、入力の面の内側に、与えられた数の疑似乱数によってポイントを生成します。決定的な点列を生成する場合には任意パラメータseedを使います。この際、0より大きい数を指定します。

Availability: 2.3.0

Enhanced: 3.0.0 seedパラメータの追加

例

乱数シード値に1996を使った元のポリゴンの上に重なった12個のポイント生成

SELECT ST_GeneratePoints(geom, 12, 1996)
FROM (
    SELECT ST_Buffer(
        ST_GeomFromText(
        'LINESTRING(50 50,150 150,150 50)'),
        10, 'endcap=round join=round') AS geom
) AS s;

Name

ST_GeometricMedian — マルチポイントの幾何学的中央値を返します。

Synopsis

geometry ST_GeometricMedian ( | geom, |
| tolerance = NULL, |
| max_iter = 10000, |
| fail_if_not_converged = false); |

geometry geom;
float8 tolerance = NULL;
int max_iter = 10000;
boolean fail_if_not_converged = false;

説明

マルチポイントジオメトリの幾何中央値の近似値を、Weiszfeldアルゴリズムを使って計算します。幾何中央値は、入力ポイントとの距離の合計を最小にするポイントです。幾何中央値によって、重心よりもはみ出しにくい中心測定ができます。

このアルゴリズムでは、成功した回次の間の距離の変化が、toleranceパラメータよりも小さくなるまで繰り返します。max_iterations回を超えた場合には、関数はfail_if_not_convergedをFALSEに指定している (デフォルト)場合を除いて、エラーを生成して終了します。

tolerance値が渡されていない場合には、デフォルトの許容値は、入力ジオメトリの範囲を基に計算されます。

存在する場合には、入力ポイントのM値は相対的な重みに解釈されます。

Availability: 2.3.0

Enhanced: 2.5.0 ポイントの重みとしてのM値の対応が追加されました。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数はM値に対応します。

例

マルチポイントの幾何的中央値 (赤)と重心 (青緑)との比較。

WITH test AS (
SELECT 'MULTIPOINT((10 10), (10 40), (40 10), (190 190))'::geometry geom)
SELECT
  ST_AsText(ST_Centroid(geom)) centroid,
  ST_AsText(ST_GeometricMedian(geom)) median
FROM test;

      centroid      |                 median
--------------------+----------------------------------------
   POINT(62.5 62.5) | POINT(25.01778421249728 25.01778421249728)
(1 row)

関連情報

ST_Centroid

Name

ST_LineMerge — MULTILINESTRINGを縫い合わせて形成したラインを返します。

Synopsis

geometry ST_LineMerge(
amultilinestring);

geometry amultilinestring;

geometry ST_LineMerge( | amultilinestring, |
| directed); |

geometry amultilinestring;
boolean directed;

説明

MULTILINESTRINGの要素を結合して形成されたLINESTRINGまたはMULTILINESTRINGを返します。ラインは2方向交点の終端で結合します。ラインは3方向以上の交点では結合しません。

directedがTRUEの場合には、ST_LineMergeはラインストリグ内のポイントの順序を変更しないため、反対方向のラインはマージされません。

Note

MULTILINESTRING/LINESTRINGでのみ使用します。他のジオメトリタイプでは空のGEMETRYCOLLECTIONを返します。

GEOSモジュールで実現しています。

Enhanced: 3.3.0 accept a directed parameter.

Requires GEOS >= 3.11.0 to use the directed parameter.

Availability: 1.1.0

Warning

この関数はM値を取り除きます。

例

異なる向きのラインのマージ。

SELECT ST_AsText(ST_LineMerge(
'MULTILINESTRING((10 160, 60 120), (120 140, 60 120), (120 140, 180 120))'
                ));
--------------------------------------------
 LINESTRING(10 160,60 120,120 140,180 120)

2本以上インタセクトしたポイントをまたぐラインはマージされません。

SELECT ST_AsText(ST_LineMerge(
'MULTILINESTRING((10 160, 60 120), (120 140, 60 120), (120 140, 180 120), (100 180, 120 140))'
                ));
--------------------------------------------
 MULTILINESTRING((10 160,60 120,120 140),(100 180,120 140),(120 140,180 120))

接触するラインが無くマージができない場合には、元のMULTILINESTRINGが返されます。

SELECT ST_AsText(ST_LineMerge(
'MULTILINESTRING((-29 -27,-30 -29.7,-36 -31,-45 -33),(-45.2 -33.2,-46 -32))'
));
----------------
MULTILINESTRING((-45.2 -33.2,-46 -32),(-29 -27,-30 -29.7,-36 -31,-45 -33))

directed = TRUEの場合には、対応方向のラインはマージされません。

SELECT ST_AsText(ST_LineMerge(
'MULTILINESTRING((60 30, 10 70), (120 50, 60 30), (120 50, 180 30))',
TRUE));
-------------------------------------------------------
 MULTILINESTRING((120 50,60 30,10 70),(120 50,180 30))

Z値処理を示す例。

SELECT ST_AsText(ST_LineMerge(
      'MULTILINESTRING((-29 -27 11,-30 -29.7 10,-36 -31 5,-45 -33 6), (-29 -27 12,-30 -29.7 5), (-45 -33 1,-46 -32 11))'
        ));
--------------------------------------------------------------------------------------------------
LINESTRING Z (-30 -29.7 5,-29 -27 11,-30 -29.7 10,-36 -31 5,-45 -33 1,-46 -32 11)

関連情報

ST_Segmentize, ST_LineSubstring

Name

ST_MaximumInscribedCircle — ジオメトリに含まれる最大の円を計算します。

Synopsis

(geometry, geometry, double precision) ST_MaximumInscribedCircle(
geom);

geometry geom;

説明

(MULTI)POLYGONに含まれるか、全てのラインとポイントをオーバラップしない最大の円を探します。返されるレコードには次のフィールドがあります。

center - 円の中心点

nearest - 中心に最も近い、ジオメトリ上のポイント

radius - 円の半径

ポリゴン系の入力の時は、内側のリングを境界として使用して、円は境界リングに内接します。ラインやポイントの入力の時は、入力ラインとポイントを境界に使用して、円は入力の凸包に内接します。

Availability: 3.1.0.

Requires GEOS >= 3.9.0.

例

ポリゴンの最大の内接円。中心点、最近傍点、半径が返ります。

SELECT radius, ST_AsText(center) AS center, ST_AsText(nearest) AS nearest
    FROM ST_MaximumInscribedCircle(
        'POLYGON ((40 180, 110 160, 180 180, 180 120, 140 90, 160 40, 80 10, 70 40, 20 50, 40 180),
        (60 140, 50 90, 90 140, 60 140))');

     radius      |           center           |    nearest
-----------------+----------------------------+---------------
 45.165845650018 | POINT(96.953125 76.328125) | POINT(140 90)

マルチラインストリングの最大の内接円。中心点、最近点と半径が返ります。

関連情報

ST_MinimumBoundingRadius, ST_LargestEmptyCircle

Name

ST_LargestEmptyCircle — ジオメトリとオーバラップ市内最大の円を計算します。

Synopsis

(geometry, geometry, double precision) ST_LargestEmptyCircle( | geom, |
| tolerance=0.0, |
| boundary=POINT EMPTY); |

geometry geom;
double precision tolerance=0.0;
geometry boundary=POINT EMPTY;

説明

障害物となるポイント集合またはライン集合に重ならない最大の円を探します (ポリゴンジオメトリは障害物として取り込まれますが、境界線しか使われません)。円の中心はポリゴン境界の内側に存在するという制約があります。ポリゴン境界は、デフォルトでは入力ジオメトリの凸包です。円の中心は、障害物から最も遠い距離を持つ境界の内部の点です。円自体は中心点と、円半径を決める障害物上にある点の最近傍点から決まります。

円の中心は、反復的なアルゴリズムを使って、距離許容値で指定された精度に決定されます。精度距離が指定されていな場合には、妥当なデフォルトが使われます。

次のフィールドを含むレコードを返します:

center - 円の中心点

nearest - 中心に最も近い、ジオメトリ上のポイント

radius - 円の半径

ポリゴン内部において最大の空の円を見つけるには、ST_MaximumInscribedCircleをご覧下さい。

Availability: 3.4.0.

Requires GEOS >= 3.9.0.

例

SELECT radius,
       ST_AsText(center) AS center,
       ST_AsText(nearest) AS nearest
  FROM ST_LargestEmptyCircle(
        'MULTILINESTRING (
          (10 100, 60 180, 130 150, 190 160),
          (20 50, 70 70, 90 20, 110 40),
          (160 30, 100 100, 180 100))');

ラインの集合の中で最大の空の円。

SELECT radius,
       ST_AsText(center) AS center,
       ST_AsText(nearest) AS nearest
  FROM ST_LargestEmptyCircle(
         St_Collect(
           'MULTIPOINT ((70 50), (60 130), (130 150), (80 90))',
           'POLYGON ((90 190, 10 100, 60 10, 190 40, 120 100, 190 180, 90 190))'),
         'POLYGON ((90 190, 10 100, 60 10, 190 40, 120 100, 190 180, 90 190))'
       );

ポリゴン内に存在する制約を課されたポイント集合内の最大の空の円。制約ポリゴンの境界は障害物として含めるとともに、円の中心の制約としても指定しなければなりません。

関連情報

ST_MinimumBoundingRadius

Name

ST_MinimumBoundingCircle — 入力ジオメトリを含む最小の円を返します。

Synopsis

geometry ST_MinimumBoundingCircle( | geomA, |
| num_segs_per_qt_circ=48); |

geometry geomA;
integer num_segs_per_qt_circ=48;

説明

入力ジオメトリを含む最小の円を返します。

Note

円はポリゴンで近似されます。デフォルトでは、1周の4分の1で48辺です。このポリゴンは円の最小バウンディングボックスの近似であるので、入力ジオメトリのいくつかの点はポリゴンに入らない可能性があります。この近似は辺の数を増やすことによって改善され、辺の数を増やすことで得られる不利益は小さいです。ポリゴン近似が適切でない場合のアプリケーションにおいては、ST_MinimumBoundingRadiusを使います。

ジオメトリの集合の最小境界円を得るにはST_Collectと併用します。

最小円 (最大対角線)上の二つのポイントを計算するにはST_MinimumBoundingCircleを使います。

ポリゴンの面積を最小包含円の面積で割った比率は、 Reock コンパクト度スコアと呼ばれます。

GEOSモジュールで実現しています。

Availability: 1.4.0

例

SELECT d.disease_type,
    ST_MinimumBoundingCircle(ST_Collect(d.geom)) As geom
    FROM disease_obs As d
    GROUP BY d.disease_type;

ポイントとラインストリングの最小包含円です。4分の1円の近似に8区分使用しています。

SELECT ST_AsText(ST_MinimumBoundingCircle(
        ST_Collect(
            ST_GeomFromText('LINESTRING(55 75,125 150)'),
                ST_Point(20, 80)), 8
                )) As wktmbc;
wktmbc
-----------
POLYGON((135.59714732062 115,134.384753327498 102.690357210921,130.79416296937 90.8537670908995,124.963360620072 79.9451031602111,117.116420743937 70.3835792560632,107.554896839789 62.5366393799277,96.6462329091006 56.70583703063,84.8096427890789 53.115246672502,72.5000000000001 51.9028526793802,60.1903572109213 53.1152466725019,48.3537670908996 56.7058370306299,37.4451031602112 62.5366393799276,27.8835792560632 70.383579256063,20.0366393799278 79.9451031602109,14.20583703063 90.8537670908993,10.615246672502 102.690357210921,9.40285267938019 115,10.6152466725019 127.309642789079,14.2058370306299 139.1462329091,20.0366393799275 150.054896839789,27.883579256063 159.616420743937,
37.4451031602108 167.463360620072,48.3537670908992 173.29416296937,60.190357210921 176.884753327498,
72.4999999999998 178.09714732062,84.8096427890786 176.884753327498,96.6462329091003 173.29416296937,107.554896839789 167.463360620072,
117.116420743937 159.616420743937,124.963360620072 150.054896839789,130.79416296937 139.146232909101,134.384753327498 127.309642789079,135.59714732062 115))

関連情報

ST_Collect, ST_MinimumBoundingRadius, ST_LargestEmptyCircle, ST_LongestLine

Name

ST_MinimumBoundingRadius — ジオメトリを完全に包含する最小円の中心ポイントと半径を返します。

Synopsis

(geometry, double precision) ST_MinimumBoundingRadius(
geom);

geometry geom;

説明

ジオメトリを含む最小円の中心点と半径を計算します。返されるレコードには次のフィールドがあります。

center - 円の中心点

radius - 円の半径

ジオメトリの集合の最小境界円を得るにはST_Collectと併用します。

最小円 (最大対角線)上の二つのポイントを計算するにはST_MinimumBoundingCircleを使います。

Availability: 2.3.0

例

SELECT ST_AsText(center), radius FROM ST_MinimumBoundingRadius('POLYGON((26426 65078,26531 65242,26075 65136,26096 65427,26426 65078))');

                st_astext                 |      radius
------------------------------------------+------------------
 POINT(26284.8418027133 65267.1145090825) | 247.436045591407

関連情報

ST_Collect, ST_MinimumBoundingCircle, ST_LongestLine

Name

ST_OrientedEnvelope — ジオメトリを囲む最小の回転四角形を返します。

Synopsis

geometry ST_OrientedEnvelope(
geom);

geometry geom ;

説明

ジオメトリを囲む最小の回転四角形を返します。最小回転四角形が複数個存在することがあるので注意して下さい。入力が退化している場合には、ポイントまたはラインストリングを返すことがあります。

Availability: 2.5.0.

Requires GEOS >= 3.6.0.

例

SELECT ST_AsText(ST_OrientedEnvelope('MULTIPOINT ((0 0), (-1 -1), (3 2))'));

                st_astext
                ------------------------------------------------
                POLYGON((3 2,2.88 2.16,-1.12 -0.84,-1 -1,3 2))

ポイントとラインストリングの回転したエンベロープ。

SELECT ST_AsText(ST_OrientedEnvelope(
        ST_Collect(
            ST_GeomFromText('LINESTRING(55 75,125 150)'),
                ST_Point(20, 80))
                )) As wktenv;
wktenv
-----------
POLYGON((19.9999999999997 79.9999999999999,33.0769230769229 60.3846153846152,138.076923076924 130.384615384616,125.000000000001 150.000000000001,19.9999999999997 79.9999999999999))

関連情報

ST_Envelope ST_MinimumBoundingCircle

Name

ST_OffsetCurve — 与えられた距離と方面に入力ラインをずらしたラインを返します。

Synopsis

geometry ST_OffsetCurve( | line, |
| signed_distance, |
| style_parameters=''); |

geometry line;
float signed_distance;
text style_parameters='';

説明

与えられた距離と方面に入力ラインをずらしたラインを返します。返されるジオメトリの全てのポイントは、入力ジオメトリより与えられた距離以上には離れません。中心線に対する平行線を計算するのに使用します。

距離が正の場合には、入力ラインの左側にずらして、方向が保持されます。負の場合には、右側にずらし、逆方向のラインになります。

距離の単位は空間参照系の単位です。

入力ジオメトリがジグソーパズルのような形状の場合には、出力がMULTILINESTRINGまたはEMPTYになることがあるので、注意して下さい。

任意指定の第3引数では、空白区切りのkey=valueペアの一覧を指定して、次のような操作をすることができます。

'quad_segs=#' : 4分の1円区分数に近づけるために使われる区分の数 (デフォルトは8)。

'join=round|mitre|bevel' : 接続スタイル (デフォルトは"round")。'miter'も'mitre'の同義語として受け付けます。

'mitre_limit=#.#' : マイターの割合制限 (接続スタイルがマイターである場合のみ影響が出ます)。'miter_limit'も'mitre_limit'の同義語として受け付けます。

GEOSモジュールで実現しています。

Availability: 2.0

Enhanced: 2.5 - GEOMETRYCOLLECTIONとULTILINESTRINGへの対応追加

Note

この関数はZ値を無視します。この関数を3次元ジオメトリ上で使用したとしても、常に2次元の結果となります。

例

道路の周りの開いたバッファの算出

SELECT ST_Union(
 ST_OffsetCurve(f.geom,  f.width/2, 'quad_segs=4 join=round'),
 ST_OffsetCurve(f.geom, -f.width/2, 'quad_segs=4 join=round')
) as track
FROM someroadstable;

15, 'quad_segs=4 join=round' 元のラインと15単位ずらしたライン。

SELECT ST_AsText(ST_OffsetCurve(ST_GeomFromText(
'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,
    44 16,24 16,20 16,18 16,17 17,
    16 18,16 20,16 40,16 60,16 80,16 100,
    16 120,16 140,16 160,16 180,16 195)'),
    15, 'quad_segs=4 join=round'));

output

LINESTRING(164 1,18 1,12.2597485145237 2.1418070123307,
    7.39339828220179 5.39339828220179,
    5.39339828220179 7.39339828220179,
    2.14180701233067 12.2597485145237,1 18,1 195)

-15, 'quad_segs=4 join=round' 元のラインと-15単位ずらしたライン。

SELECT ST_AsText(ST_OffsetCurve(geom,
    -15, 'quad_segs=4 join=round')) As notsocurvy
    FROM ST_GeomFromText(
'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,
    44 16,24 16,20 16,18 16,17 17,
    16 18,16 20,16 40,16 60,16 80,16 100,
    16 120,16 140,16 160,16 180,16 195)') As geom;

notsocurvy

LINESTRING(31 195,31 31,164 31)

二重にずらして曲線を得ます。1回目で逆方向にしていて、-30 + 15 = -15としています。

SELECT ST_AsText(ST_OffsetCurve(ST_OffsetCurve(geom,
    -30, 'quad_segs=4 join=round'), -15, 'quad_segs=4 join=round')) As morecurvy
    FROM ST_GeomFromText(
'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,
    44 16,24 16,20 16,18 16,17 17,
    16 18,16 20,16 40,16 60,16 80,16 100,
    16 120,16 140,16 160,16 180,16 195)') As geom;

morecurvy

LINESTRING(164 31,46 31,40.2597485145236 32.1418070123307,
35.3933982822018 35.3933982822018,
32.1418070123307 40.2597485145237,31 46,31 195)

二重にずらして曲線を得て、順方向に15ずらして平行線を得ます。元のラインを覆います。

SELECT ST_AsText(ST_Collect(
    ST_OffsetCurve(geom, 15, 'quad_segs=4 join=round'),
    ST_OffsetCurve(ST_OffsetCurve(geom,
    -30, 'quad_segs=4 join=round'), -15, 'quad_segs=4 join=round')
    )
) As parallel_curves
    FROM ST_GeomFromText(
'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,
    44 16,24 16,20 16,18 16,17 17,
    16 18,16 20,16 40,16 60,16 80,16 100,
    16 120,16 140,16 160,16 180,16 195)') As geom;

parallel curves

MULTILINESTRING((164 1,18 1,12.2597485145237 2.1418070123307,
7.39339828220179 5.39339828220179,5.39339828220179 7.39339828220179,
2.14180701233067 12.2597485145237,1 18,1 195),
(164 31,46 31,40.2597485145236 32.1418070123307,35.3933982822018 35.3933982822018,
32.1418070123307 40.2597485145237,31 46,31 195))

15, 'quad_segs=4 join=bevel' と元のライン

SELECT ST_AsText(ST_OffsetCurve(ST_GeomFromText(
'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,
    44 16,24 16,20 16,18 16,17 17,
    16 18,16 20,16 40,16 60,16 80,16 100,
    16 120,16 140,16 160,16 180,16 195)'),
        15, 'quad_segs=4 join=bevel'));

output

LINESTRING(164 1,18 1,7.39339828220179 5.39339828220179,
    5.39339828220179 7.39339828220179,1 18,1 195)

join=mitre mitre_limit=2.1で、15ずらしたものと-15ずらしたものとを集めたもの。

SELECT ST_AsText(ST_Collect(
    ST_OffsetCurve(geom, 15, 'quad_segs=4 join=mitre mitre_limit=2.2'),
    ST_OffsetCurve(geom, -15, 'quad_segs=4 join=mitre mitre_limit=2.2')
    ) )
    FROM ST_GeomFromText(
'LINESTRING(164 16,144 16,124 16,104 16,84 16,64 16,
    44 16,24 16,20 16,18 16,17 17,
    16 18,16 20,16 40,16 60,16 80,16 100,
    16 120,16 140,16 160,16 180,16 195)') As geom;

output

MULTILINESTRING((164 1,11.7867965644036 1,1 11.7867965644036,1 195),
    (31 195,31 31,164 31))

関連情報

ST_Buffer

Name

ST_PointOnSurface — ポリゴン内またはジオメトリ上にあるのが保証されたポイントを返します。

Synopsis

geometry ST_PointOnSurface(
g1);

geometry g1;

説明

サーフェス (POLYGON、MULTIPOLYGON、CURVED POLYGON)内部にあることが保証されたPOINTを返します。PostGISでは、この関数はラインジオメトリとポイントジオメトリ上でも動作します。

説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s3.2.14.2 // s3.2.18.2

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 8.1.5, 9.5.6. 仕様では、サーフェスジオメトリのみのST_PointOnSurfaceが定義されています。PostGISは、すべての一般的なジオメトリタイプに対応するよう拡張しています。他のデータベース (Oracle、DB2、ArcSDE)は、サーフェスに対してのみこの機能をサポートしているようです。SQL Server 2008では、すべての一般的なジオメトリタイプに対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

例

MULTIPOINTのPointOnSurface

LINESTRINGのPointOnSurface

POLYGONのPointOnSurface

GEOMETRYCOLLECTIONのPointOnSurface

SELECT ST_AsText(ST_PointOnSurface('POINT(0 5)'::geometry));
------------
 POINT(0 5)

SELECT ST_AsText(ST_PointOnSurface('LINESTRING(0 5, 0 10)'::geometry));
------------
 POINT(0 5)

SELECT ST_AsText(ST_PointOnSurface('POLYGON((0 0, 0 5, 5 5, 5 0, 0 0))'::geometry));
----------------
 POINT(2.5 2.5)

SELECT ST_AsEWKT(ST_PointOnSurface(ST_GeomFromEWKT('LINESTRING(0 5 1, 0 0 1, 0 10 2)')));
----------------
 POINT(0 0 1)

例: ST_Centroidで計算されたポイントはポリゴンの外になる場合があるのに対して、ST_PointOnSurfaceの結果はポリゴン内に存在することが保証されます。

赤: サーフェス上のポイント、緑: 重心

SELECT ST_AsText(ST_PointOnSurface(geom)) AS pt_on_surf,
       ST_AsText(ST_Centroid(geom)) AS centroid
    FROM (SELECT 'POLYGON ((130 120, 120 190, 30 140, 50 20, 190 20,
                      170 100, 90 60, 90 130, 130 120))'::geometry AS geom) AS t;

   pt_on_surf    |                  centroid
-----------------+---------------------------------------------
 POINT(62.5 110) | POINT(100.18264840182648 85.11415525114155)

関連情報

ST_Centroid, ST_MaximumInscribedCircle

Name

ST_Polygonize — ジオメトリ集合のラインから形成されるポリゴンのコレクションを計算します。

Synopsis

geometry ST_Polygonize(
geomfield);

geometry set geomfield;

geometry ST_Polygonize(
geom_array);

geometry[] geom_array;

説明

ジオメトリ集合の構成要素であるラインから形成されるポリゴンを含むジオメトリコレクションを計算します。この関数が確実に動作するために、入力ラインは正しいノードを持たなければなりません。

Note

入力が完全にノードを持っているようにするには、ポリゴン化の前に入力ジオメトリに対してST_Nodeを使います。

Note

ジオメトリコレクションは、サードパーティ製ツールでは、しばしば取り扱いが難しいとされることがあります。ポリゴン化の結果を個々のポリゴンに変換するにはST_Dumpを使います。

GEOSモジュールで実現しています。

Availability: 1.0.0RC1

例: 単一ラインストリングのポリゴン化

SELECT ST_AsEWKT(ST_Polygonize(geom_4269)) As geomtextrep
FROM (SELECT geom_4269 FROM ma.suffolk_edges ORDER BY tlid LIMIT 45) As foo;

geomtextrep
-------------------------------------
 SRID=4269;GEOMETRYCOLLECTION(POLYGON((-71.040878 42.285678,-71.040943 42.2856,-71.04096 42.285752,-71.040878 42.285678)),
 POLYGON((-71.17166 42.353675,-71.172026 42.354044,-71.17239 42.354358,-71.171794 42.354971,-71.170511 42.354855,
 -71.17112 42.354238,-71.17166 42.353675)))
(1 row)

-- ST_Dumpでポリゴン化されたジオメトリを個々のポリゴンにダンプします
SELECT ST_AsEWKT((ST_Dump(foofoo.polycoll)).geom) As geomtextrep
FROM (SELECT ST_Polygonize(geom_4269) As polycoll
    FROM (SELECT geom_4269 FROM ma.suffolk_edges
        ORDER BY tlid LIMIT 45) As foo) As foofoo;

geomtextrep
------------------------
 SRID=4269;POLYGON((-71.040878 42.285678,-71.040943 42.2856,-71.04096 42.285752,
-71.040878 42.285678))
 SRID=4269;POLYGON((-71.17166 42.353675,-71.172026 42.354044,-71.17239 42.354358
,-71.171794 42.354971,-71.170511 42.354855,-71.17112 42.354238,-71.17166 42.353675))
(2 rows)

関連情報

ST_Node, ST_Dump

Name

ST_ReducePrecision — 全ての与えられたグリッド許容値に丸められたポイントからなる妥当なジオメトリを返します。

Synopsis

geometry ST_ReducePrecision( | g, |
| gridsize); |

geometry g;
float8 gridsize;

説明

全ての与えられたグリッド許容値に丸められたポイントからなる妥当なジオメトリを返します。許容値より下の地物は削除されます。

ST_SnapToGridと違い、返されるジオメトリは妥当で、自己交差の環や崩壊した要素を伴いません。

精度提言は次の場合に使います。

座標精度をデータ精度に合わせる

ジオメトリを表現するのに必要な座標の数を減らす

低精度書式 (出力桁数が制限されるWKT, GeoJSON, KML等のテキスト書式)への出力ジオメトリの妥当性の確保。

妥当なジオメトリの低精度や制度制限のあるシステム (SDE, Oracle許容値等)へのエクスポート

Availability: 3.1.0.

Requires GEOS >= 3.9.0.

例

SELECT ST_AsText(ST_ReducePrecision('POINT(1.412 19.323)', 0.1));
    st_astext
-----------------
 POINT(1.4 19.3)

SELECT ST_AsText(ST_ReducePrecision('POINT(1.412 19.323)', 1.0));
  st_astext
-------------
 POINT(1 19)

SELECT ST_AsText(ST_ReducePrecision('POINT(1.412 19.323)', 10));
  st_astext
-------------
 POINT(0 20)

精度を落とすことで頂点数を減らすことができます。

SELECT ST_AsText(ST_ReducePrecision('LINESTRING (10 10, 19.6 30.1, 20 30, 20.3 30, 40 40)', 1));
  st_astext
-------------
 LINESTRING (10 10, 20 30, 40 40)

妥当性を確保するために必要な場合には、精度を落とす際にポリゴンを分割します。

SELECT ST_AsText(ST_ReducePrecision('POLYGON ((10 10, 60 60.1, 70 30, 40 40, 50 10, 10 10))', 10));
  st_astext
-------------
 MULTIPOLYGON (((60 60, 70 30, 40 40, 60 60)), ((40 40, 50 10, 10 10, 40 40)))

関連情報

ST_SnapToGrid, ST_Simplify, ST_SimplifyVW

Name

ST_SharedPaths — 二つのLINESTRING/MULTILINESTRINGの入力が共有するパスのコレクションを返します。

Synopsis

geometry ST_SharedPaths( | lineal1, |
| lineal2); |

geometry lineal1;
geometry lineal2;

説明

二つの入力ジオメトリが共有するパスのコレクションを返します。順方向に行くものはコレクションの一つ目の要素にあり、逆方向は二つ目の要素にあります。これらのパス自体は一つ目のジオメトリの方向をもとにします。

GEOSモジュールで実現しています。

Availability: 2.0.0

例: 共有パスの探索

マルチラインストリングとラインストリング

マルチラインストリングとラインストリングとの共有パスと元のジオメトリ。

SELECT ST_AsText(
  ST_SharedPaths(
    ST_GeomFromText('MULTILINESTRING((26 125,26 200,126 200,126 125,26 125),
       (51 150,101 150,76 175,51 150))'),
    ST_GeomFromText('LINESTRING(151 100,126 156.25,126 125,90 161, 76 175)')
    )
  ) As wkt

                                wkt
-------------------------------------------------------------
GEOMETRYCOLLECTION(MULTILINESTRING((126 156.25,126 125),
 (101 150,90 161),(90 161,76 175)),MULTILINESTRING EMPTY)

same example but linestring orientation flipped

SELECT ST_AsText(
  ST_SharedPaths(
   ST_GeomFromText('LINESTRING(76 175,90 161,126 125,126 156.25,151 100)'),
   ST_GeomFromText('MULTILINESTRING((26 125,26 200,126 200,126 125,26 125),
       (51 150,101 150,76 175,51 150))')
    )
  ) As wkt

                                wkt
-------------------------------------------------------------
GEOMETRYCOLLECTION(MULTILINESTRING EMPTY,
MULTILINESTRING((76 175,90 161),(90 161,101 150),(126 125,126 156.25)))

関連情報

ST_Dump, ST_GeometryN, ST_NumGeometries

Name

ST_Simplify — Douglas-Peukerアルゴリズムを使用して、与えられたジオメトリを簡略化したものを返します。

Synopsis

geometry ST_Simplify( | geomA, |
| tolerance); |

geometry geomA;
float tolerance;

geometry ST_Simplify( | geomA, |
| tolerance, |
| preserveCollapsed); |

geometry geomA;
float tolerance;
boolean preserveCollapsed;

説明

与えられたジオメトリを「簡略化」したものを返します。Douglas-Peukerアルゴリズムを使用します。(MULTI)LINEと(MULTI)POLYGONとで実際に動作をしますが、どのような種類のジオメトリでも安全に呼ぶことができます。簡略化はオブジェクトごとに行われるので、ジオメトリコレクションでこの関数を呼ぶことができます。

"preserve collapsed"フラグは、与えられた許容値としては小さ過ぎることになるオブジェクトを保持します。たとえば、1ｍのラインを許容値10mで単純化する場合などです。preserveCollapsed引数がTRUEに指定されている場合には、ラインは消滅しません。このフラグは、多数の隙間を残している地図を描画する際に、描画エンジンが多数の微細オブジェクトを消すことを避けるために使います。

Note

返されるジオメトリは単純性 (ST_IsSimple参照)を失うことがあります。

Note

トポロジは保存されているとは限らず、不正なジオメトリを返すことがあります。トポロジを保存するにはST_SimplifyPreserveTopologyを使います。

Availability: 1.2.2

例

簡略化をやりすぎて三角形になった円、八角形になった円です。

SELECT ST_Npoints(geom) AS np_before,
       ST_NPoints(ST_Simplify(geom,0.1)) AS np01_notbadcircle,
       ST_NPoints(ST_Simplify(geom,0.5)) AS np05_notquitecircle,
       ST_NPoints(ST_Simplify(geom,1)) AS np1_octagon,
       ST_NPoints(ST_Simplify(geom,10)) AS np10_triangle,
       (ST_Simplify(geom,100) is null) AS  np100_geometrygoesaway
  FROM
    (SELECT ST_Buffer('POINT(1 3)', 10,12) As geom) AS foo;

 np_before | np01_notbadcircle | np05_notquitecircle | np1_octagon | np10_triangle | np100_geometrygoesaway
-----------+-------------------+---------------------+-------------+---------------+------------------------
        49 |                33 |                  17 |           9 |             4 | t

関連情報

ST_IsSimple, ST_SimplifyPreserveTopology, ST_SimplifyVW, Topology ST_Simplify

Name

ST_SimplifyPreserveTopology — Douglas-Peukerアルゴリズムを使用して、与えられたジオメトリを簡略化したものを返します。

Synopsis

geometry ST_SimplifyPreserveTopology( | geomA, |
| tolerance); |

geometry geomA;
float tolerance;

説明

与えられたジオメトリを「簡略化」したものを返します。Douglas-Peukerアルゴリズムを使用します。不正な派生ジオメトリ (特にポリゴン)の生成を回避します。(MULTI)LINEと(MULTI)POLYGONとで実際に動作をしますが、どのような種類のジオメトリでも安全に呼ぶことができます。簡略化はオブジェクトごとに行われるので、ジオメトリコレクションでこの関数を呼ぶことができます。

GEOSモジュールで実現しています。

Availability: 1.3.3

例

Simplyfyと同じ例ですが、トポロジ保存で簡略化の行きすぎを阻止します。円は最低でも四角形になります。

SELECT ST_Npoints(geom) As np_before, ST_NPoints(ST_SimplifyPreserveTopology(geom,0.1)) As np01_notbadcircle, ST_NPoints(ST_SimplifyPreserveTopology(geom,0.5)) As np05_notquitecircle,
ST_NPoints(ST_SimplifyPreserveTopology(geom,1)) As np1_octagon, ST_NPoints(ST_SimplifyPreserveTopology(geom,10)) As np10_square,
ST_NPoints(ST_SimplifyPreserveTopology(geom,100)) As  np100_stillsquare
FROM (SELECT ST_Buffer('POINT(1 3)', 10,12) As geom) As foo;

-- 結果 --
 np_before | np01_notbadcircle | np05_notquitecircle | np1_octagon | np10_square | np100_stillsquare
-----------+-------------------+---------------------+-------------+---------------+-------------------
        49 |                33 |                  17 |           9 |             5 |                 5

関連情報

ST_Simplify

Name

ST_SimplifyPolygonHull — ポリゴンジオメトリに対してトポロジを保存した状態で簡略化した外側または内側の凹包を計算します。

Synopsis

geometry ST_SimplifyPolygonHull( | param_geom, |
| vertex_fraction, |
| is_outer = true); |

geometry param_geom;
float vertex_fraction;
boolean is_outer = true;

説明

ポリゴンジオメトリに対してトポロジを保存した状態で簡略化した外側または内側の凹包を計算します。外側の凹包は入力ジオメトリを完全に覆います。内側の凹包は完全に入力ジオメトリに覆われます。返される結果は、入力ポリゴンの頂点の部分集合から形成されるポリゴンジオメトリです。MULTIPOLUGONと穴は処理され、結果は入力ジオメトリと同じ構造になります。

頂点数の減少はvertex_fractionパラメータで制御できます。0から1の範囲を取ります。小さい値では簡略化が進み、頂点数が減り、凹性が下がります。外側の凹包も内側の凹包も、vertex_fraction値が1.0では、元のジオメトリが生成されます。0.0では、外側の凹包については凸包 (単一ポリゴンの場合)が生成され、内側の凹包については三角形が生成されます。

単純化処理では、頂点数が目標に達するまで、最も少ない面積を持つ凹の角を徐々に削除しています。これによりエッジがクロスするのを防ぎ、常に妥当なポリゴンジオメトリを返します。

相対的に辺が長いジオメトリでより良い結果を得るには、次のように、辺の分割を行います。

GEOSモジュールで実現しています。

Availability: 3.3.0.

Requires GEOS >= 3.11.0.

例

ポリゴンの外側の凹包

SELECT ST_SimplifyPolygonHull(
  'POLYGON ((131 158, 136 163, 161 165, 173 156, 179 148, 169 140, 186 144, 190 137, 185 131, 174 128, 174 124, 166 119, 158 121, 158 115, 165 107, 161 97, 166 88, 166 79, 158 57, 145 57, 112 53, 111 47, 93 43, 90 48, 88 40, 80 39, 68 32, 51 33, 40 31, 39 34, 49 38, 34 38, 25 34, 28 39, 36 40, 44 46, 24 41, 17 41, 14 46, 19 50, 33 54, 21 55, 13 52, 11 57, 22 60, 34 59, 41 68, 75 72, 62 77, 56 70, 46 72, 31 69, 46 76, 52 82, 47 84, 56 90, 66 90, 64 94, 56 91, 33 97, 36 100, 23 100, 22 107, 29 106, 31 112, 46 116, 36 118, 28 131, 53 132, 59 127, 62 131, 76 130, 80 135, 89 137, 87 143, 73 145, 80 150, 88 150, 85 157, 99 162, 116 158, 115 165, 123 165, 122 170, 134 164, 131 158))',
    0.3);

ポリゴンの内側の凹包

SELECT ST_SimplifyPolygonHull(
  'POLYGON ((131 158, 136 163, 161 165, 173 156, 179 148, 169 140, 186 144, 190 137, 185 131, 174 128, 174 124, 166 119, 158 121, 158 115, 165 107, 161 97, 166 88, 166 79, 158 57, 145 57, 112 53, 111 47, 93 43, 90 48, 88 40, 80 39, 68 32, 51 33, 40 31, 39 34, 49 38, 34 38, 25 34, 28 39, 36 40, 44 46, 24 41, 17 41, 14 46, 19 50, 33 54, 21 55, 13 52, 11 57, 22 60, 34 59, 41 68, 75 72, 62 77, 56 70, 46 72, 31 69, 46 76, 52 82, 47 84, 56 90, 66 90, 64 94, 56 91, 33 97, 36 100, 23 100, 22 107, 29 106, 31 112, 46 116, 36 118, 28 131, 53 132, 59 127, 62 131, 76 130, 80 135, 89 137, 87 143, 73 145, 80 150, 88 150, 85 157, 99 162, 116 158, 115 165, 123 165, 122 170, 134 164, 131 158))',
    0.3, false);

中間点を挿入したマルチポリゴンの外側の凹包による簡略化

SELECT ST_SimplifyPolygonHull(
  ST_Segmentize(ST_Letters('xt'), 2.0),
    0.1);

関連情報

ST_ConvexHull, ST_SimplifyVW, ST_ConcaveHull, ST_Segmentize

Name

ST_SimplifyVW — Visvalingam-Whyattアルゴリズムを使用して、入力ジオメトリを簡略化したジオメトリを返します。

Synopsis

geometry ST_SimplifyVW( | geomA, |
| tolerance); |

geometry geomA;
float tolerance;

説明

Visvalingam-Whyattアルゴリズムを用いて、入力ジオメトリを「簡略化」したジオメトリを返します。(マルチ)ラインと(マルチ)ポリゴンでのみ動作しますが、どの種類のジオメトリでも安全に呼ぶことができます。(MULTI)LINEと(MULTI)POLYGONとで実際に動作をしますが、どのような種類のジオメトリでも安全に呼ぶことができます。簡略化はオブジェクトごとに行われるので、ジオメトリコレクションでこの関数を呼ぶことができます。

Note

返されるジオメトリは単純性 (ST_IsSimple参照)を失うことがあります。

Note

トポロジは保存されているとは限らず、不正なジオメトリを返すことがあります。トポロジを保存するにはST_SimplifyPreserveTopologyを使います。

Note

この関数は3次元を扱います。第3次元は結果に影響を与えます。

Availability: 2.2.0

例

ラインストリングを最小範囲のしきい値を30で簡略化しています。

select ST_AsText(ST_SimplifyVW(geom,30)) simplified
FROM (SELECT  'LINESTRING(5 2, 3 8, 6 20, 7 25, 10 10)'::geometry geom) As foo;
-result
 simplified
------------------------------
LINESTRING(5 2,7 25,10 10)

関連情報

ST_SetEffectiveArea, ST_Simplify, ST_SimplifyPreserveTopology, Topology ST_Simplify

Name

ST_SetEffectiveArea — Visvalingam-Whyattアルゴリズムを使って有効範囲となる個々の頂点を置きます。

Synopsis

geometry ST_SetEffectiveArea( | geomA, |
| threshold = 0, |
| set_area = 1); |

geometry geomA;
float threshold = 0;
integer set_area = 1;

説明

Visvalingam-Whyattアルゴリズムから有効範囲となる個々の頂点を置きます。有効範囲はジオメトリのM値として格納されます。任意引数である第2引数を使うと、しきい値以上の有効範囲となる頂点だけで構築されるジオメトリを返します。

この関数は、しきい値を使うことでサーバサイド簡略化に使えます。もう一つの任意引数はしきい値を0にする際に使用します。この場合、完全なジオメトリを得ますが、クライアントが非常に高速に簡略化するために使うM値として格納している有効範囲を持っています。

(MULTI)LINEと(MULTI)POLYGONとで実際に動作をしますが、どのような種類のジオメトリでも安全に呼ぶことができます。簡略化はオブジェクトごとに行われるので、ジオメトリコレクションでこの関数を呼ぶことができます。

Note

返されるジオメトリは単純性 (ST_IsSimple参照)を失うことがあります。

Note

トポロジは保存されているとは限らず、不正なジオメトリを返すことがあります。トポロジを保存するにはST_SimplifyPreserveTopologyを使います。

Note

出力ジオメトリは、入力時に持っていたM値の情報の全てを失います。

Note

この関数は3次元を扱います。第3次元は結果に影響を与えます。

Availability: 2.2.0

例

ラインストリングの有効範囲の計算。しきい値を0にしているので、入力ジオメトリの全ての頂点が返ります。

select ST_AsText(ST_SetEffectiveArea(geom)) all_pts, ST_AsText(ST_SetEffectiveArea(geom,30) ) thrshld_30
FROM (SELECT  'LINESTRING(5 2, 3 8, 6 20, 7 25, 10 10)'::geometry geom) As foo;
-- 結果 --
 all_pts | thrshld_30
-----------+-------------------+
LINESTRING M (5 2 3.40282346638529e+38,3 8 29,6 20 1.5,7 25 49.5,10 10 3.40282346638529e+38) | LINESTRING M (5 2 3.40282346638529e+38,7 25 49.5,10 10 3.40282346638529e+38)

関連情報

ST_SimplifyVW

Name

ST_TriangulatePolygon — ポリゴンの制約付きドロネー三角分割を計算します。

Synopsis

geometry ST_TriangulatePolygon(
geom);

geometry geom;

説明

ポリゴンの制約付きドロネー三角分割を計算します。穴やMULTIPOLYGONに対応しています。

ポリゴンの「制約付きドロネー三角分割」は、ポリゴンの頂点から形成された三角形の集合で、ポリゴンを確実に覆い、内角和が考えられる三角分割の中で最大になります。この関数によって、ポリゴンの「最高品質」の三角分割が得られます。

Availability: 3.3.0.

Requires GEOS >= 3.11.0.

例

正方形の三角分割。

SELECT ST_AsText(
    ST_TriangulatePolygon('POLYGON((0 0, 0 1, 1 1, 1 0, 0 0))'));

                                 st_astext
---------------------------------------------------------------------------
 GEOMETRYCOLLECTION(POLYGON((0 0,0 1,1 1,0 0)),POLYGON((1 1,1 0,0 0,1 1)))

例

文字Pの三角分割。

SELECT ST_AsText(ST_TriangulatePolygon(
    'POLYGON ((26 17, 31 19, 34 21, 37 24, 38 29, 39 43, 39 161, 38 172, 36 176, 34 179, 30 181, 25 183, 10 185, 10 190, 100 190, 121 189, 139 187, 154 182, 167 177, 177 169, 184 161, 189 152, 190 141, 188 128, 186 123, 184 117, 180 113, 176 108, 170 104, 164 101, 151 96, 136 92, 119 89, 100 89, 86 89, 73 89, 73 39, 74 32, 75 27, 77 23, 79 20, 83 18, 89 17, 106 15, 106 10, 10 10, 10 15, 26 17), (152 147, 151 152, 149 157, 146 162, 142 166, 137 169, 132 172, 126 175, 118 177, 109 179, 99 180, 89 180, 80 179, 76 178, 74 176, 73 171, 73 100, 85 99, 91 99, 102 99, 112 100, 121 102, 128 104, 134 107, 139 110, 143 114, 147 118, 149 123, 151 128, 153 141, 152 147))'
    ));

ポリゴンの三角分割

関連情報

ST_DelaunayTriangles, ST_ConstrainedDelaunayTriangles, ST_Tesselate

Name

ST_VoronoiLines — ジオメトリの頂点からボロノイ図のセルを返します。

Synopsis

geometry ST_VoronoiLines( | geom, |
| tolerance = 0.0, |
| extend_to = NULL); |

geometry geom ;
float8 tolerance = 0.0 ;
geometry extend_to = NULL ;

説明

与えられたジオメトリの頂点から2次元ボロノイ図を生成し、ボロノイ図のサイト間の境界をMULTILIESTRINGで返します。入力ジオメトリがNULLの場合にはNULLを返します。入力ジオメトリの頂点が一つの場合には空ジオメトリを返します。extend_toで作られるエンベロープの面積が0の場合には空ジオメトリを返します。

任意パラメータ:

tolerance: 複数の頂点を同一のものと捉える距離。0でない値を許容距離として与えるとアルゴリズムのロバスト性が改善します (デフォルトは0.0)。

extend_to: これが与えられている場合には、与えられたジオメトリのエンベロープを覆うように図が拡張されます。デフォルト値以上でないと有効ではありません (デフォルトはNULLで、デフォルトのエンベロープは入力ジオメトリのバウンディングボックスから50%拡張したものです)。

GEOSモジュールで実現しています。

Availability: 2.3.0

例

30単位の許容距離を持つボロノイ図のライン

SELECT ST_VoronoiLines(
            'MULTIPOINT (50 30, 60 30, 100 100,10 150, 110 120)'::geometry,
            30) AS geom;

ST_AsText output
MULTILINESTRING((135.555555555556 270,36.8181818181818 92.2727272727273),(36.8181818181818 92.2727272727273,-110 43.3333333333333),(230 -45.7142857142858,36.8181818181818 92.2727272727273))

関連情報

ST_DelaunayTriangles, ST_VoronoiPolygons

Name

ST_VoronoiPolygons — ジオメトリの頂点からボロノイ図のセルを返します。

Synopsis

geometry ST_VoronoiPolygons( | geom, |
| tolerance = 0.0, |
| extend_to = NULL); |

geometry geom ;
float8 tolerance = 0.0 ;
geometry extend_to = NULL ;

説明

与えられたジオメトリの頂点から2次元ボロノイ図を生成します。結果はPOLYGONのGEOMETRYCOLLECTIONで、、入力の頂点の範囲以上のエンベロープを覆います。入力ジオメトリがNULLの場合にはNULLを返します。入力ジオメトリの頂点が一つの場合には空ジオメトリを返します。extend_toで作られるエンベロープの面積が0の場合には空ジオメトリを返します。

任意パラメータ:

tolerance: 複数の頂点を同一のものと捉える距離。0でない値を許容距離として与えるとアルゴリズムのロバスト性が改善します (デフォルトは0.0)。

extend_to: これが与えられている場合には、与えられたジオメトリのエンベロープを覆うように図が拡張されます。デフォルト値以上でないと有効ではありません (デフォルトはNULLで、デフォルトのエンベロープは入力ジオメトリのバウンディングボックスから50%拡張したものです)。

GEOSモジュールで実現しています。

Availability: 2.3.0

例

ボロノイ図の上にポイントを置いた図

SELECT ST_VoronoiPolygons(
                'MULTIPOINT (50 30, 60 30, 100 100,10 150, 110 120)'::geometry
            ) AS geom;

ST_AsText output
GEOMETRYCOLLECTION(POLYGON((-110 43.3333333333333,-110 270,100.5 270,59.3478260869565 132.826086956522,36.8181818181818 92.2727272727273,-110 43.3333333333333)),
POLYGON((55 -90,-110 -90,-110 43.3333333333333,36.8181818181818 92.2727272727273,55 79.2857142857143,55 -90)),
POLYGON((230 47.5,230 -20.7142857142857,55 79.2857142857143,36.8181818181818 92.2727272727273,59.3478260869565 132.826086956522,230 47.5)),POLYGON((230 -20.7142857142857,230 -90,55 -90,55 79.2857142857143,230 -20.7142857142857)),
POLYGON((100.5 270,230 270,230 47.5,59.3478260869565 132.826086956522,100.5 270)))

許容距離30単位のボロノイ図

SELECT ST_VoronoiPolygons(
            'MULTIPOINT (50 30, 60 30, 100 100,10 150, 110 120)'::geometry,
            30) AS geom;

ST_AsText output
GEOMETRYCOLLECTION(POLYGON((-110 43.3333333333333,-110 270,100.5 270,59.3478260869565 132.826086956522,36.8181818181818 92.2727272727273,-110 43.3333333333333)),
POLYGON((230 47.5,230 -45.7142857142858,36.8181818181818 92.2727272727273,59.3478260869565 132.826086956522,230 47.5)),POLYGON((230 -45.7142857142858,230 -90,-110 -90,-110 43.3333333333333,36.8181818181818 92.2727272727273,230 -45.7142857142858)),
POLYGON((100.5 270,230 270,230 47.5,59.3478260869565 132.826086956522,100.5 270)))

関連情報

ST_DelaunayTriangles, ST_VoronoiLines

カバレッジ

Abstract

これらの関数は「暗黙的なカバレッジ」を形成するポリゴンジオメトリの集合で動作します。妥当なカバレッジを形成するには、ポリゴンはオーバラップしてはいけませんし、隣接するエッジの頂点が確実に合致していなければいけません。カバレッジは処理が速く、かつ、エッジを変更してもウィンドウパーティション内のカバレッジのトポロジを保持するウィンドウ関数で操作できます。

Name

ST_CoverageInvalidEdges — ポリゴンが妥当なカバレッジの形成に失敗する位置を検索するウィンドウ関数。

Synopsis

geometry ST_CoverageInvalidEdges( | geom, |
| tolerance = 0); |

geometry winset geom;
float8 tolerance = 0;

説明

ウィンドウパーティション内のポリゴンが妥当なポリゴンカバレッジを形成するかどうかチェックするウィンドウ関数です。個々のポリゴン内の不正なエッジの位置 (あるなら)を示す線形インジケータを返します。

次の条件を満たすなら妥当なポリゴンの集合は妥当なカバレッジです:

オーバラップなし - ポリゴン同士がオーバラップしない (ポリゴンの内部でインタセクトしない)

エッジ一致 - 共有エッジに沿った頂点が同一

ウィンドウ関数として、入力ポリゴンごとに値が返されます。妥当性条件の一つ以上に違反するポリゴンについては返り値は、問題のあるエッジを含むMULTILINESTRINGです。カバレッジ妥当なポリゴンに対してはNULLを返します。非ポリゴンや空ジオメトリに対してもNULL値が返ります。

この条件では、周囲のポリゴンがエッジ一致になっている限りは、妥当なカバレッジは穴 (ポリゴン間の隙間)を含むことができます。しかしながら、非常に小さい隙間は、望まれないものとされることがしばしばあります。toleranceパラメタが0でない距離で指定されている場合には、小さい隙間を形成するエッジば不正なものとして返されます。

カバレッジ妥当性のチェックがなされたポリゴンも妥当なジオメトリです。ST_IsValidでチェックできます。

Availability: 3.4.0 - GEOS 3.12.0以上が必要です

例

オーバラップと頂点不一致により発生した不正エッジ

WITH coverage(id, geom) AS (VALUES
  (1, 'POLYGON ((10 190, 30 160, 40 110, 100 70, 120 10, 10 10, 10 190))'::geometry),
  (2, 'POLYGON ((100 190, 10 190, 30 160, 40 110, 50 80, 74 110.5, 100 130, 140 120, 140 160, 100 190))'::geometry),
  (3, 'POLYGON ((140 190, 190 190, 190 80, 140 80, 140 190))'::geometry),
  (4, 'POLYGON ((180 40, 120 10, 100 70, 140 80, 190 80, 180 40))'::geometry)
)
SELECT id, ST_AsText(ST_CoverageInvalidEdges(geom) OVER ())
  FROM coverage;

 id |               st_astext
----+---------------------------------------
  1 | LINESTRING (40 110, 100 70)
  2 | MULTILINESTRING ((100 130, 140 120, 140 160, 100 190), (40 110, 50 80, 74 110.5))
  3 | LINESTRING (140 80, 140 190)
  3 | null

-- Test entire table for coverage validity
SELECT true = ALL (
    SELECT ST_CoverageInvalidEdges(geom) OVER () IS NULL
    FROM coverage
    );

関連情報

ST_IsValid, ST_CoverageUnion, ST_CoverageSimplify

Name

ST_CoverageSimplify — ポリゴンカバレッジのエッジを単純化するウィンドウ関数。

Synopsis

geometry ST_CoverageSimplify( | geom, |
| tolerance, |
| simplifyBoundary = true); |

geometry winset geom;
float8 tolerance;
boolean simplifyBoundary = true;

説明

ポリゴンカバレッジ内でポリゴンのエッジを単純化するウィンドウ関数です。この単純化ではカバレッジのトポロジが保持されます。単純化した出力ポリゴンは共有するエッジに沿って構成され、妥当なカバレッジを形成します。

単純化ではVisvalingam–Whyatt algorithm版を使います。toleranceパラメータは距離の単位を持ち、単純化する三角形面積の平方根とだいたい同じです。

カバレッジの「内部の」エッジ (二つのポリゴンに共有されている)だけを単純化するには、simplifyBoundaryパラメタをFALSEに設定します。

Note

If the input is not a valid coverage there may be unexpected artifacts in the output (such as boundary intersections, or separated boundaries which appeared to be shared). Use ST_CoverageInvalidEdges to determine if a coverage is valid.

Availability: 3.4.0 - GEOS 3.12.0以上が必要です

例

入力カバレッジ

カバレッジの単純化

WITH coverage(id, geom) AS (VALUES
  (1, 'POLYGON ((160 150, 110 130, 90 100, 90 70, 60 60, 50 10, 30 30, 40 50, 25 40, 10 60, 30 100, 30 120, 20 170, 60 180, 90 190, 130 180, 130 160, 160 150), (40 160, 50 140, 66 125, 60 100, 80 140, 90 170, 60 160, 40 160))'::geometry),
  (2, 'POLYGON ((40 160, 60 160, 90 170, 80 140, 60 100, 66 125, 50 140, 40 160))'::geometry),
  (3, 'POLYGON ((110 130, 160 50, 140 50, 120 33, 90 30, 50 10, 60 60, 90 70, 90 100, 110 130))'::geometry),
  (4, 'POLYGON ((160 150, 150 120, 160 90, 160 50, 110 130, 160 150))'::geometry)
)
SELECT id, ST_AsText(ST_CoverageSimplify(geom, 30) OVER ())
  FROM coverage;

 id |               st_astext
----+---------------------------------------
  1 | POLYGON ((160 150, 110 130, 50 10, 10 60, 20 170, 90 190, 160 150), (40 160, 66 125, 90 170, 40 160))
  2 | POLYGON ((40 160, 66 125, 90 170, 40 160))
  3 | POLYGON ((110 130, 160 50, 50 10, 110 130))
  3 | POLYGON ((160 150, 160 50, 110 130, 160 150))

関連情報

ST_CoverageInvalidEdges

Name

ST_CoverageUnion — 共有しているエッジを除去することでカバレッジを形成するポリゴンの集合の結合を計算します。

Synopsis

geometry ST_CoverageUnion(
geom);

geometry set geom;

説明

ポリゴンカバレッジを形成するポリゴンの集合の結合を行う集約関数です。結果はカバレッジと同じ領域を覆うポリゴンジオメトリです。この関数はST_Unionと同じ結果を返しますが、高速に計算するためにカバレッジ構造を使用します。

Note

If the input is not a valid coverage there may be unexpected artifacts in the output (such as unmerged or overlapping polygons). Use ST_CoverageInvalidEdges to determine if a coverage is valid.

Availability: 3.4.0 - GEOS 3.8.0以上が必要です

例

入力カバレッジ

結合結果

WITH coverage(id, geom) AS (VALUES
  (1, 'POLYGON ((10 10, 10 150, 80 190, 110 150, 90 110, 40 110, 50 60, 10 10))'::geometry),
  (2, 'POLYGON ((120 10, 10 10, 50 60, 100 70, 120 10))'::geometry),
  (3, 'POLYGON ((140 80, 120 10, 100 70, 40 110, 90 110, 110 150, 140 80))'::geometry),
  (4, 'POLYGON ((140 190, 120 170, 140 130, 160 150, 140 190))'::geometry),
  (5, 'POLYGON ((180 160, 170 140, 140 130, 160 150, 140 190, 180 160))'::geometry)
)
SELECT ST_AsText(ST_CoverageUnion(geom))
  FROM coverage;

--------------------------------------
MULTIPOLYGON (((10 150, 80 190, 110 150, 140 80, 120 10, 10 10, 10 150), (50 60, 100 70, 40 110, 50 60)), ((120 170, 140 190, 180 160, 170 140, 140 130, 120 170)))

関連情報

ST_CoverageInvalidEdges, ST_Union

アフィン変換

Abstract

これらの関数はアフィン変換を使用してジオメトリの位置と形状を変更するものです。

Name

ST_Affine — ジオメトリに3次元アフィン変換を適用します。

Synopsis

geometry ST_Affine( | geomA, |
| a, |
| b, |
| c, |
| d, |
| e, |
| f, |
| g, |
| h, |
| i, |
| xoff, |
| yoff, |
| zoff); |

geometry geomA;
float a;
float b;
float c;
float d;
float e;
float f;
float g;
float h;
float i;
float xoff;
float yoff;
float zoff;

geometry ST_Affine( | geomA, |
| a, |
| b, |
| d, |
| e, |
| xoff, |
| yoff); |

geometry geomA;
float a;
float b;
float d;
float e;
float xoff;
float yoff;

説明

3次元アフィン変換をジオメトリに適用して移動、回転、拡大縮小を一度に行います。

一つ目の形式では、次のように関数を呼んでいます。

ST_Affine(geom, a, b, c, d, e, f, g, h, i, xoff, yoff, zoff)

これは次のような変換行列を表現しています。

/ a  b  c  xoff \
| d  e  f  yoff |
| g  h  i  zoff |
\ 0  0  0     1 /

次のようにも表現できます。

x' = a*x + b*y + c*z + xoff
y' = d*x + e*y + f*z + yoff
z' = g*x + h*y + i*z + zoff

全ての移動/拡大縮小関数はこのようなアフィン変換を経由しています。

二つ目の形式では、2次元アフィン変換をジオメトリに適用します。次のように関数を呼んでいます。

ST_Affine(geom, a, b, d, e, xoff, yoff)

これは次のような変換行列を表現しています。

/  a  b  0  xoff  \       /  a  b  xoff  \
|  d  e  0  yoff  | rsp.  |  d  e  yoff  |
|  0  0  1     0  |       \  0  0     1  /
\  0  0  0     1  /

頂点は次のように変換されます。

x' = a*x + b*y + xoff
y' = d*x + e*y + yoff
z' = z

このメソッドは上述の3次元メソッドの特異ケースです。

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。

Availability: 1.1.2 AffineからST_Affineに名称変更しました。

Note

1.3.4より前では、曲線を含むジオメトリで使用すると、この関数はクラッシュします。これは1.3.4以上で訂正されています。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

-- 3次元のラインをZ軸周りに180度回転。これはST_Rotate()を長くしたものです。
 SELECT ST_AsEWKT(ST_Affine(geom,  cos(pi()), -sin(pi()), 0,  sin(pi()), cos(pi()), 0,  0, 0, 1,  0, 0, 0)) As using_affine,
         ST_AsEWKT(ST_Rotate(geom, pi())) As using_rotate
        FROM (SELECT ST_GeomFromEWKT('LINESTRING(1 2 3, 1 4 3)') As geom) As foo;
        using_affine         |        using_rotate
-----------------------------+-----------------------------
 LINESTRING(-1 -2 3,-1 -4 3) | LINESTRING(-1 -2 3,-1 -4 3)
(1 row)

-- 3次元ラインをX軸周りとZ軸周りに180度ずつ回転
SELECT ST_AsEWKT(ST_Affine(geom, cos(pi()), -sin(pi()), 0, sin(pi()), cos(pi()), -sin(pi()), 0, sin(pi()), cos(pi()), 0, 0, 0))
        FROM (SELECT ST_GeomFromEWKT('LINESTRING(1 2 3, 1 4 3)') As geom) As foo;
           st_asewkt
-------------------------------
 LINESTRING(-1 -2 -3,-1 -4 -3)
(1 row)

関連情報

ST_Rotate, ST_Scale, ST_Translate, ST_TransScale

Name

ST_Rotate — ジオメトリを原点について回転させます。

Synopsis

geometry ST_Rotate( | geomA, |
| rotRadians); |

geometry geomA;
float rotRadians;

geometry ST_Rotate( | geomA, |
| rotRadians, |
| x0, |
| y0); |

geometry geomA;
float rotRadians;
float x0;
float y0;

geometry ST_Rotate( | geomA, |
| rotRadians, |
| pointOrigin); |

geometry geomA;
float rotRadians;
geometry pointOrigin;

説明

ジオメトリを原点について反時計回りにrotRadiasnぶん回転させます。原点はPOINTジオメトリか、xとyの座標値を指定します。原点を指定しない場合にはPOINT(0,0)について回転させます。

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。

Enhanced: 2.0.0 回転の原点を指定するパラメタを追加しました。

Availability: 1.1.2 RotateからST_Rotateに名称変更しました。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

-- 180度回転
SELECT ST_AsEWKT(ST_Rotate('LINESTRING (50 160, 50 50, 100 50)', pi()));
               st_asewkt
---------------------------------------
 LINESTRING(-50 -160,-50 -50,-100 -50)
(1 row)

-- x=50,y=160で反時計回りに30度回転
SELECT ST_AsEWKT(ST_Rotate('LINESTRING (50 160, 50 50, 100 50)', pi()/6, 50, 160));
                                 st_asewkt
---------------------------------------------------------------------------
 LINESTRING(50 160,105 64.7372055837117,148.301270189222 89.7372055837117)
(1 row)

-- 重心位置で時計回りに60度回転
SELECT ST_AsEWKT(ST_Rotate(geom, -pi()/3, ST_Centroid(geom)))
FROM (SELECT 'LINESTRING (50 160, 50 50, 100 50)'::geometry AS geom) AS foo;
                           st_asewkt
--------------------------------------------------------------
 LINESTRING(116.4225 130.6721,21.1597 75.6721,46.1597 32.3708)
(1 row)

関連情報

ST_Affine, ST_RotateX, ST_RotateY, ST_RotateZ

Name

ST_RotateX — ジオメトリをX軸について回転させます。

Synopsis

geometry ST_RotateX( | geomA, |
| rotRadians); |

geometry geomA;
float rotRadians;

説明

ジオメトリgeomAをX軸についてrotRadiansぶん回転させます。

Note

ST_RotateX(geomA, rotRadians)はST_Affine(geomA, 1, 0, 0, 0, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), cos(rotRadians), 0, 0, 0)の短縮版です。

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。

Availability: 1.1.2 1.2.2でRotateXからST_RotateXに名称変更しました。

説明この関数は多面体サーフェスに対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

-- ラインをX軸について90度回転
SELECT ST_AsEWKT(ST_RotateX(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), pi()/2));
                 st_asewkt
---------------------------
 LINESTRING(1 -3 2,1 -1 1)

関連情報

ST_Affine, ST_RotateY, ST_RotateZ

Name

ST_RotateY — ジオメトリをY軸について回転させます。

Synopsis

geometry ST_RotateY( | geomA, |
| rotRadians); |

geometry geomA;
float rotRadians;

説明

ジオメトリgeomAをY軸についてrotRadiansぶん回転させます。

Note

ST_RotateY(geomA, rotRadians)はST_Affine(geomA, cos(rotRadians), 0, sin(rotRadians), 0, 1, 0, -sin(rotRadians), 0, cos(rotRadians), 0, 0, 0)の省略形です。

Availability: 1.1.2 1.2.2でRotateYからST_RotateYに名称変更しました。

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。

説明この関数は多面体サーフェスに対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

-- ラインをY軸について90度回転
 SELECT ST_AsEWKT(ST_RotateY(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), pi()/2));
                 st_asewkt
---------------------------
 LINESTRING(3 2 -1,1 1 -1)

関連情報

ST_Affine, ST_RotateX, ST_RotateZ

Name

ST_RotateZ — ジオメトリをZ軸について回転させます。

Synopsis

geometry ST_RotateZ( | geomA, |
| rotRadians); |

geometry geomA;
float rotRadians;

説明

ジオメトリgeomAをZ軸についてrotRadiansぶん回転させます。

Note

この関数はST_Rotateと同じです。

Note

ST_RotateZ(geomA, rotRadians)はSELECT ST_Affine(geomA, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), cos(rotRadians), 0, 0, 0, 1, 0, 0, 0)の短縮版です。

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。

Availability: 1.1.2 1.2.2でRotateZからST_RotateZに名称変更しました。

Note

1.3.4より前では、曲線を含むジオメトリで使用すると、この関数はクラッシュします。これは1.3.4以上で訂正されています。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

-- ラインをZ軸について90度回転
SELECT ST_AsEWKT(ST_RotateZ(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), pi()/2));
                 st_asewkt
---------------------------
 LINESTRING(-2 1 3,-1 1 1)

-- 曲線化した円をZ軸について回転
SELECT ST_AsEWKT(ST_RotateZ(geom, pi()/2))
FROM (SELECT ST_LineToCurve(ST_Buffer(ST_GeomFromText('POINT(234 567)'), 3)) As geom) As foo;

                                                                                                           st_asewkt
----------------------------------------------------------------------------------------------------------------------------
 CURVEPOLYGON(CIRCULARSTRING(-567 237,-564.87867965644 236.12132034356,-564 234,-569.12132034356 231.87867965644,-567 237))

関連情報

ST_Affine, ST_RotateX, ST_RotateY

Name

ST_Scale — 与えた係数でジオメトリを拡大縮小します。

Synopsis

geometry ST_Scale( | geomA, |
| XFactor, |
| YFactor, |
| ZFactor); |

geometry geomA;
float XFactor;
float YFactor;
float ZFactor;

geometry ST_Scale( | geomA, |
| XFactor, |
| YFactor); |

geometry geomA;
float XFactor;
float YFactor;

geometry ST_Scale( | geom, |
| factor); |

geometry geom;
geometry factor;

geometry ST_Scale( | geom, |
| factor, |
| origin); |

geometry geom;
geometry factor;
geometry origin;

説明

対応するパラメータで軸を乗算してジオメトリを新しいサイズに拡大縮小します。

factorパラメータでジオメトリを取る形式では、2次元、3次元 (XYZ. XYM)、4次元のポイントで、全ての対応する次元のスケーリングの乗数を設定することができます。factorポイントの欠けた次元については、対応する次元は拡大縮小をしないのと等価になります。

三つのジオメトリを与える形式では、拡大縮小に「仮原点」を渡すことができます。これにより、たとえば、仮原点としてジオメトリの重心を使うといった、「適切な位置での拡大縮小」が可能となります。仮原点を使わない場合には、拡大縮小は実際の原点からの位置で行われるので、全ての座標は拡大縮小係数との積になります。

Note

1.3.4より前では、曲線を含むジオメトリで使用すると、この関数はクラッシュします。これは1.3.4以上で訂正されています。

Availability: 1.1.0

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。

Enhanced: 2.2.0 全ての次元の拡大縮小 (factorパラメータ)への対応が導入されました。

Enhanced: 2.5.0 局所原点 (originパラメータ)を使った拡大縮小への対応を導入しました。

説明この関数は多面体サーフェスに対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

説明この関数はM値に対応します。

例

-- 一つ目: X, Y, Zの拡大縮小
SELECT ST_AsEWKT(ST_Scale(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), 0.5, 0.75, 0.8));
                          st_asewkt
--------------------------------------
 LINESTRING(0.5 1.5 2.4,0.5 0.75 0.8)

-- 二つ目: X, Yの拡大縮小
 SELECT ST_AsEWKT(ST_Scale(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), 0.5, 0.75));
                        st_asewkt
----------------------------------
 LINESTRING(0.5 1.5 3,0.5 0.75 1)

-- 三つ目: X, Y, Z, Mの拡大縮小
 SELECT ST_AsEWKT(ST_Scale(ST_GeomFromEWKT('LINESTRING(1 2 3 4, 1 1 1 1)'),
   ST_MakePoint(0.5, 0.75, 2, -1)));
                               st_asewkt
----------------------------------------
 LINESTRING(0.5 1.5 6 -4,0.5 0.75 2 -1)

-- 四つ目: 仮原点を使ったX, Yの拡大縮小
SELECT ST_AsText(ST_Scale('LINESTRING(1 1, 2 2)', 'POINT(2 2)', 'POINT(1 1)'::geometry));
      st_astext
---------------------
 LINESTRING(1 1,3 3)

関連情報

ST_Affine, ST_TransScale

Name

ST_Translate — 与えられたオフセットでジオメトリを変換します。

Synopsis

geometry ST_Translate( | g1, |
| deltax, |
| deltay); |

geometry g1;
float deltax;
float deltay;

geometry ST_Translate( | g1, |
| deltax, |
| deltay, |
| deltaz); |

geometry g1;
float deltax;
float deltay;
float deltaz;

説明

deltax, deltay, deltazぶん移動した新しいジオメトリを返します。単位は、このジオメトリの空間参照系 (SRID)で定義された単位です。

Note

1.3.4より前では、曲線を含むジオメトリで使用すると、この関数はクラッシュします。これは1.3.4以上で訂正されています。

Availability: 1.2.2

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

ポイントを経度1度ぶん移動させます。

SELECT ST_AsText(ST_Translate(ST_GeomFromText('POINT(-71.01 42.37)',4326),1,0)) As wgs_transgeomtxt;

        wgs_transgeomtxt
        ---------------------
        POINT(-70.01 42.37)

ラインストリングを緯度1度ぶん、経度1/2度ぶん移動させます。

SELECT ST_AsText(ST_Translate(ST_GeomFromText('LINESTRING(-71.01 42.37,-71.11 42.38)',4326),1,0.5)) As wgs_transgeomtxt;
                   wgs_transgeomtxt
        ---------------------------------------
        LINESTRING(-70.01 42.87,-70.11 42.88)

3次元ポイントを移動させます。

SELECT ST_AsEWKT(ST_Translate(CAST('POINT(0 0 0)' As geometry), 5, 12,3));
        st_asewkt
        ---------
        POINT(5 12 3)

曲線とポイントを移動させます。

SELECT ST_AsText(ST_Translate(ST_Collect('CURVEPOLYGON(CIRCULARSTRING(4 3,3.12 0.878,1 0,-1.121 5.1213,6 7, 8 9,4 3))','POINT(1 3)'),1,2));
                                                                                                                 st_astext
------------------------------------------------------------------------------------------------------------
 GEOMETRYCOLLECTION(CURVEPOLYGON(CIRCULARSTRING(5 5,4.12 2.878,2 2,-0.121 7.1213,7 9,9 11,5 5)),POINT(2 5))

関連情報

ST_Affine, ST_AsText, ST_GeomFromText

Name

ST_TransScale — 与えられた係数とオフセットでジオメトリを変換します。

Synopsis

geometry ST_TransScale( | geomA, |
| deltaX, |
| deltaY, |
| XFactor, |
| YFactor); |

geometry geomA;
float deltaX;
float deltaY;
float XFactor;
float YFactor;

説明

deltaXとdeltaY引数を使ってジオメトリを移動させ、XFactor,YFactor引数で拡大縮小させます。2次元でのみ動作します。

Note

ST_TransScale(geomA, deltaX, deltaY, XFactor, YFactor)はST_Affine(geomA, XFactor, 0, 0, 0, YFactor, 0, 0, 0, 1, deltaX*XFactor, deltaY*YFactor, 0)の短縮版です。

Note

1.3.4より前では、曲線を含むジオメトリで使用すると、この関数はクラッシュします。これは1.3.4以上で訂正されています。

Availability: 1.1.0

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

SELECT ST_AsEWKT(ST_TransScale(ST_GeomFromEWKT('LINESTRING(1 2 3, 1 1 1)'), 0.5, 1, 1, 2));
                  st_asewkt
-----------------------------
 LINESTRING(1.5 6 3,1.5 4 1)

-- ポイントのバッファから得た近似円を曲線に変換したうえで
-- (1, 2)だけ移動させ、(3, 4)倍に拡大します
  SELECT ST_AsText(ST_Transscale(ST_LineToCurve(ST_Buffer('POINT(234 567)', 3)),1,2,3,4));
                                                                                                                  st_astext
------------------------------------------------------------------------------------------------------------------------------
 CURVEPOLYGON(CIRCULARSTRING(714 2276,711.363961030679 2267.51471862576,705 2264,698.636038969321 2284.48528137424,714 2276))

関連情報

ST_Affine, ST_Translate

クラスタリング関数

Abstract

これらの関数はジオメトリ集合に対するクラスタリングアルゴリズムを実装したものです。

Name

ST_ClusterDBSCAN — 入力ジオメトリごとにDBSCANアルゴリズムを使ってクラスタ番号を返すウィンドウ関数です。

Synopsis

integer ST_ClusterDBSCAN( | geom, |
| eps, |
| minpoints); |

geometry winset geom;
float8 eps;
integer minpoints;

説明

DBSCAN (ノイズ適用可能な密度に基づいた空間クラスタリング)アルゴリズムの2次元実装に基づいて、それぞれの入力ジオメトリが入るクラスタの整数識別子を返します。ST_ClusterKMeansと違って、クラスタ数の指定は求められず、所望する距離 (eps)と密度(minpoints)をクラスタを構築するためのパラメータとして使います。

入力ジオメトリは次の場合にクラスタに追加されます。

「核」ジオメトリは、入力ジオメトリ (自分を含む)のうち少なくともminpoints個がepsで指定した距離の範囲内にあるものです。

「境界」ジオメトリは、核ジオメトリからepsで指定した距離の範囲内にあるものです。

境界ジオメトリがeps以内に複数の核ジオメトリがあるかも知れないことに注意して下さい。この場合には、どちらに割り当てられても正しく、境界ジオメトリは、対象クラスタのうちの一つに任意に割り当てられます。これらの場合には、minpointsより少ないジオメトリで正しいクラスタを生成できます。境界ジオメトリの割り当てが曖昧な時、ウィンドウの定義にORDER BY句が含まれている場合には、ST_ClusterDBSCANは同じ結果を返しますが、クラスタの割り当ては同じアルゴリズムの他の実装と異なる可能性があります。

Note

どのクラスタの参加基準にも合わない入力ジオメトリは、番号をNULLとします。

Availability: 2.3.0

説明このメソッドは曲線ストリングと曲線に対応しています。

例

50メートル以内にある個々のポリゴンへのクラスタ番号の割り当て。少なくともクラスタには二つのポリゴンが求められます。

少なくともクラスタごとに二つ以上のポリゴンがある50メートル以内のクラスタ。一つだけならcidはNULL。

SELECT name, ST_ClusterDBSCAN(geom, eps := 50, minpoints := 2) over () AS cid
FROM boston_polys
WHERE name
> '' AND building
> ''
        AND ST_DWithin(geom,
        ST_Transform(
            ST_GeomFromText('POINT(-71.04054 42.35141)', 4326), 26986),
           500);

                name                 | bucket
-------------------------------------+--------
 Manulife Tower                      |      0
 Park Lane Seaport I                 |      0
 Park Lane Seaport II                |      0
 Renaissance Boston Waterfront Hotel |      0
 Seaport Boston Hotel                |      0
 Seaport Hotel & World Trade Center  |      0
 Waterside Place                     |      0
 World Trade Center East             |      0
 100 Northern Avenue                 |      1
 100 Pier 4                          |      1
 The Institute of Contemporary Art   |      1
 101 Seaport                         |      2
 District Hall                       |      2
 One Marina Park Drive               |      2
 Twenty Two Liberty                  |      2
 Vertex                              |      2
 Vertex                              |      2
 Watermark Seaport                   |      2
 Blue Hills Bank Pavilion            |   NULL
 World Trade Center West             |   NULL
(20 rows)

同じクラスタ番号の群を一つのジオメトリに統合します。名前付き引数を使用しています。

SELECT cid, ST_Collect(geom) AS cluster_geom, array_agg(parcel_id) AS ids_in_cluster FROM (
    SELECT parcel_id, ST_ClusterDBSCAN(geom, eps := 0.5, minpoints := 5) over () AS cid, geom
    FROM parcels) sq
GROUP BY cid;

関連情報

ST_DWithin, ST_ClusterKMeans, ST_ClusterIntersecting, ST_ClusterWithin ST_ClusterIntersectingWin

Name

ST_ClusterIntersectingWin — 入力ジオメトリごとに接続された集合にクラスタリングを行い、クラスタIDを返すウィンドウ関数です。

Synopsis

integer ST_ClusterIntersectingWin(
geom);

geometry winset geom;

説明

ST_ClusterIntersectingWinは、インタセクトするジオメトリの相互接続するクラスタを構築するウィンドウ関数です。クラスタを出ることなく全てのジオメトリを横断することができます。返り値は引数のジオメトリが関係するクラスタ番号か、入力がNULLの場合にはNULLかのいずれかです。

Availability: 3.4.0

例

WITH testdata AS (
  SELECT id, geom::geometry FROM (
  VALUES  (1, 'LINESTRING (0 0, 1 1)'),
          (2, 'LINESTRING (5 5, 4 4)'),
          (3, 'LINESTRING (6 6, 7 7)'),
          (4, 'LINESTRING (0 0, -1 -1)'),
          (5, 'POLYGON ((0 0, 4 0, 4 4, 0 4, 0 0))')) AS t(id, geom)
)
SELECT id,
  ST_AsText(geom),
  ST_ClusterIntersectingWin(geom) OVER () AS cluster
FROM testdata;

 id |           st_astext            | cluster
----+--------------------------------+---------
  1 | LINESTRING(0 0,1 1)            |       0
  2 | LINESTRING(5 5,4 4)            |       0
  3 | LINESTRING(6 6,7 7)            |       1
  4 | LINESTRING(0 0,-1 -1)          |       0
  5 | POLYGON((0 0,4 0,4 4,0 4,0 0)) |       0

関連情報

ST_ClusterDBSCAN, ST_ClusterKMeans, ST_ClusterWithinWin ST_ClusterWithin ST_ClusterIntersecting

Name

ST_ClusterIntersecting — 入力ジオメトリを接続関係にある集合にクラスタリングする集約関数です。

Synopsis

geometry[] ST_ClusterIntersecting(
g);

geometry set g;

説明

ST_ClusterIntersectingはジオメトリコレクションの配列を返す集約関数です。配列の要素は、相互接続されるジオメトリの集合を表現します。

Availability: 2.2.0

例

WITH testdata AS
  (SELECT unnest(ARRAY['LINESTRING (0 0, 1 1)'::geometry,
           'LINESTRING (5 5, 4 4)'::geometry,
           'LINESTRING (6 6, 7 7)'::geometry,
           'LINESTRING (0 0, -1 -1)'::geometry,
           'POLYGON ((0 0, 4 0, 4 4, 0 4, 0 0))'::geometry]) AS geom)

SELECT ST_AsText(unnest(ST_ClusterIntersecting(geom))) FROM testdata;

-- 結果 --

st_astext
---------
GEOMETRYCOLLECTION(LINESTRING(0 0,1 1),LINESTRING(5 5,4 4),LINESTRING(0 0,-1 -1),POLYGON((0 0,4 0,4 4,0 4,0 0)))
GEOMETRYCOLLECTION(LINESTRING(6 6,7 7))

関連情報

ST_ClusterDBSCAN, ST_ClusterKMeans, ST_ClusterWithinWin ST_ClusterWithin

Name

ST_ClusterKMeans — 入力ジオメトリごとにk平均法アルゴリズムを使ってクラスタ番号を返すウィンドウ関数です。

Synopsis

integer ST_ClusterKMeans( | geom, |
| number_of_clusters, |
| max_radius); |

geometry winset geom;
integer number_of_clusters;
float max_radius;

説明

入力ジオメトリごとのK平均法のクラスタ番号を返します。クラスタリングに使われる距離は、2次元ジオメトリでは重心間の距離、3次元ジオメトリではバウンディングボックスの中心点間の距離です。POINT入力では、M値は入力の重みとして扱われ、0より大きくなければなりません。

max_radiusが設定されている場合には、ST_ClusterKMeansは、出力クラスタがmax_radiusより半径が大きいクラスタを作らなくなるので、kより多いクラスタを生成します。到達可能性分析に使います。

Enhanced: 3.2.0 max_radiusパラメータに対応しました

Enhanced: 3.1.0 3次元ジオメトリと重みに対応するようになりました

Availability: 2.3.0

例

例としてダミーの区画の集合を生成します。

CREATE TABLE parcels AS
SELECT lpad((row_number() over())::text,3,'0') As parcel_id, geom,
('{residential, commercial}'::text[])[1 + mod(row_number()OVER(),2)] As type
FROM
    ST_Subdivide(ST_Buffer('SRID=3857;LINESTRING(40 100, 98 100, 100 150, 60 90)'::geometry,
    40, 'endcap=square'),12) As geom;

クラスタ番号 (cid)による色付けを施した区画

SELECT ST_ClusterKMeans(geom, 3) OVER() AS cid, parcel_id, geom
    FROM parcels;

cid | parcel_id |   geom
-----+-----------+---------------
   0 | 001       | 0103000000...
   0 | 002       | 0103000000...
   1 | 003       | 0103000000...
   0 | 004       | 0103000000...
   1 | 005       | 0103000000...
   2 | 006       | 0103000000...
   2 | 007       | 0103000000...

タイプ別による区画の分割

SELECT ST_ClusterKMeans(geom, 3) over (PARTITION BY type) AS cid, parcel_id, type
    FROM parcels;

cid | parcel_id |    type
-----+-----------+-------------
   1 | 005       | commercial
   1 | 003       | commercial
   2 | 007       | commercial
   0 | 001       | commercial
   1 | 004       | residential
   0 | 002       | residential
   2 | 006       | residential

例: 3次元クラスタリングと重み付けを使った、事前集計した地球規模の人口データセットのクラスタリング。Kontur Population Dataに基づいて、中心から3000km以下となる、少なくとも 20 の地域が識別されます。

create table kontur_population_3000km_clusters as
select
    geom,
    ST_ClusterKMeans(
        ST_Force4D(
            ST_Transform(ST_Force3D(geom), 4978), -- cluster in 3D XYZ CRS
            mvalue := population -- set clustering to be weighed by population
        ),
        20,                      -- aim to generate at least 20 clusters
        max_radius := 3000000    -- but generate more to make each under 3000 km radius
    ) over () as cid
from
    kontur_population;

世界人口を上記仕様でクラスタリングして、46のクラスタを得ました。人口集中地域 (ニューヨーク、モスクワ)にクラスタの中心が来ます。グリーンランドは一つのクラスタです。日付変更線をまたぐクラスタがあります。クラスタのエッジは地球の曲線に従います。

関連情報

ST_ClusterDBSCAN, ST_ClusterIntersectingWin, ST_ClusterWithinWin, ST_ClusterIntersecting, ST_ClusterWithin, ST_Subdivide, ST_Force3D, ST_Force4D,

Name

ST_ClusterWithin — 空間的な距離によって入力ジオメトリのクラスタリングを行う集約関数です。

Synopsis

geometry[] ST_ClusterWithin( | g, |
| distance); |

geometry set g;
float8 distance;

説明

ST_ClusterWithinはジオメトリコレクションの配列を返す集計関数です。それぞれのジオメトリコレクション要素は、指定した距離 (SRIDの単位によるデカルト距離)以内となるよう分けられたジオメトリの集合です。

Availability: 2.2.0

説明このメソッドは曲線ストリングと曲線に対応しています。

例

WITH testdata AS
  (SELECT unnest(ARRAY['LINESTRING (0 0, 1 1)'::geometry,
                       'LINESTRING (5 5, 4 4)'::geometry,
                       'LINESTRING (6 6, 7 7)'::geometry,
                       'LINESTRING (0 0, -1 -1)'::geometry,
                       'POLYGON ((0 0, 4 0, 4 4, 0 4, 0 0))'::geometry]) AS geom)

SELECT ST_AsText(unnest(ST_ClusterWithin(geom, 1.4))) FROM testdata;

-- 結果 --

st_astext
---------
GEOMETRYCOLLECTION(LINESTRING(0 0,1 1),LINESTRING(5 5,4 4),LINESTRING(0 0,-1 -1),POLYGON((0 0,4 0,4 4,0 4,0 0)))
GEOMETRYCOLLECTION(LINESTRING(6 6,7 7))

関連情報

ST_ClusterDBSCAN, ST_ClusterKMeans, ST_ClusterIntersectingWin, ST_ClusterWithinWin, ST_ClusterIntersecting

Name

ST_ClusterWithinWin — 入力ジオメトリごとに分離距離を使ったクラスタリングを行い、クラスタIDを返すウィンドウ関数です。

Synopsis

integer ST_ClusterWithinWin( | geom, |
| distance); |

geometry winset geom;
float8 distance;

説明

ST_ClusterWithinWinは、ジオメトリ毎に整数を返すウィンドウ関数です。この整数は、ジオメトリがメンバになっているクラスタの番号です。クラスタは指定距離以上でない入力ジオメトリの集合を表現します (距離はSRIDの単位のデカルト距離です。)

ST_ClusterWithinWinはST_ClusterDBSCANを、`minpoints`を0にして実行するのと同じです。

Availability: 3.4.0

説明このメソッドは曲線ストリングと曲線に対応しています。

例

WITH testdata AS (
  SELECT id, geom::geometry FROM (
  VALUES  (1, 'LINESTRING (0 0, 1 1)'),
          (2, 'LINESTRING (5 5, 4 4)'),
          (3, 'LINESTRING (6 6, 7 7)'),
          (4, 'LINESTRING (0 0, -1 -1)'),
          (5, 'POLYGON ((0 0, 4 0, 4 4, 0 4, 0 0))')) AS t(id, geom)
)
SELECT id,
  ST_AsText(geom),
  ST_ClusterWithinWin(geom, 1.4) OVER () AS cluster
FROM testdata;

 id |           st_astext            | cluster
----+--------------------------------+---------
  1 | LINESTRING(0 0,1 1)            |       0
  2 | LINESTRING(5 5,4 4)            |       0
  3 | LINESTRING(6 6,7 7)            |       1
  4 | LINESTRING(0 0,-1 -1)          |       0
  5 | POLYGON((0 0,4 0,4 4,0 4,0 0)) |       0

関連情報

ST_ClusterDBSCAN, ST_ClusterKMeans, ST_ClusterIntersectingWin, ST_ClusterWithin, ST_ClusterIntersecting

バウンディングボックス関数

Abstract

これらの関数は、バウンディングボックスを生成または操作します。自動キャストまたは明示的なキャストを使って、ジオメトリ値を提供し、受け付けます。

the section called “PostGISボックス関数”を参照して下さい。

Name

Box2D — ジオメトリの2次元範囲を表現するBOX2Dを返します。

Synopsis

box2d Box2D(
geom);

geometry geom;

説明

ジオメトリの2次元範囲を表現するbox2dを返します。

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

SELECT Box2D(ST_GeomFromText('LINESTRING(1 2, 3 4, 5 6)'));

box2d
---------
BOX(1 2,5 6)

SELECT Box2D(ST_GeomFromText('CIRCULARSTRING(220268 150415,220227 150505,220227 150406)'));

box2d
--------
BOX(220186.984375 150406,220288.25 150506.140625)

関連情報

Box3D, ST_GeomFromText

Name

Box3D — ジオメトリの3次元範囲を表現するBOX3Dを返します。

Synopsis

box3d Box3D(
geom);

geometry geom;

説明

ジオメトリの3次元範囲を表現するbox3dを返します。

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

説明この関数は3次元に対応し、Z値を削除しません。

例

SELECT Box3D(ST_GeomFromEWKT('LINESTRING(1 2 3, 3 4 5, 5 6 5)'));

Box3d
---------
BOX3D(1 2 3,5 6 5)

SELECT Box3D(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 1,220227 150406 1)'));

Box3d
--------
BOX3D(220227 150406 1,220268 150415 1)

関連情報

Box2D, ST_GeomFromEWKT

Name

ST_EstimatedExtent — 空間テーブルの推定範囲を返します。

Synopsis

box2d ST_EstimatedExtent( | schema_name, |
| table_name, |
| geocolumn_name, |
| parent_only); |

text schema_name;
text table_name;
text geocolumn_name;
boolean parent_only;

box2d ST_EstimatedExtent( | schema_name, |
| table_name, |
| geocolumn_name); |

text schema_name;
text table_name;
text geocolumn_name;

box2d ST_EstimatedExtent( | table_name, |
| geocolumn_name); |

text table_name;
text geocolumn_name;

説明

空間テーブルの推定範囲をbox2dで返します。スキーマが指定されていない場合には現在のスキーマが使われます。推定範囲はジオメトリカラムの統計情報から取得します。これは通常は、ST_ExtentまたはST_3DExtentを使ってテーブルの確定範囲を計算するより、ずっと早く計算できます。

指定が無い場合には、子テーブル (INHERITSを使って作られたテーブル)が存在するなら、そこから得られた統計情報も使用します。parent_onlyがTRUEの場合には、パラメータで与えられたテーブルの統計情報だけが使用され、子テーブルの統計情報は無視されます。

PostgreSQL 8.0.0以上ではVACUUM ANALYZEで統計情報を集め、結果として得られる範囲は実際の95%程度です。PostgreSQL 8.0.0より前の場合には、update_geometry_stats()で統計情報が集められ、結果の範囲は確定値です。

Note

統計情報が無い (空のテーブルまたはANALYZEを実行していない)場合には、この関数はNULLを返します。1.5.4より前では、代わりに例外が投げられていました。

Availability: 1.0.0

Changed: 2.1.0 2.0.xまではST_Estimated_Extentと呼ばれていました。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

SELECT ST_EstimatedExtent('ny', 'edges', 'geom');
-- 結果 --
BOX(-8877653 4912316,-8010225.5 5589284)

SELECT ST_EstimatedExtent('feature_poly', 'geom');
-- 結果 --
BOX(-124.659652709961 24.6830825805664,-67.7798080444336 49.0012092590332)

関連情報

ST_Extent, ST_3DExtent

Name

ST_Expand — 他のバウンディングボックスまたはジオメトリから拡張されたバウンディングボックスを返します。

Synopsis

geometry ST_Expand( | geom, |
| units_to_expand); |

geometry geom;
float units_to_expand;

geometry ST_Expand( | geom, |
| dx, |
| dy, |
| dz=0, |
| dm=0); |

geometry geom;
float dx;
float dy;
float dz=0;
float dm=0;

box2d ST_Expand( | box, |
| units_to_expand); |

box2d box;
float units_to_expand;

box2d ST_Expand( | box, |
| dx, |
| dy); |

box2d box;
float dx;
float dy;

box3d ST_Expand( | box, |
| units_to_expand); |

box3d box;
float units_to_expand;

box3d ST_Expand( | box, |
| dx, |
| dy, |
| dz=0); |

box3d box;
float dx;
float dy;
float dz=0;

説明

入力のバウンディングボックスから拡張したバウンディングボックスを返します。一つの距離を指定して全ての方向に拡張するものと、方向ごとに距離を指定して拡張するものとがあります。倍精度浮動小数点を使います。距離に関するクエリで使いますし、空間インデックスの利点を得るために行うクエリへのフィルタを追加するために使います。

ST_Expandは、ジオメトリを受け付けジオメトリを返す版だけでなく、box2dやbox3dのデータ型を受け付けて返す形式もあります。

距離の単位は入力の空間参照系の単位です。

ST_ExpandはST_Bufferと似ていますが、ST_Bufferではジオメトリを全ての方向に拡張するのに対して、ST_Expandはバウンディングボックスを各軸に沿って拡張する点が異なります。

Note

1.3より前の版では、インデックス化可能な距離クエリではST_ExpandとST_Distanceとが組み合わせて使われていました。たとえばgeom && ST_Expand('POINT(10 20)', 10) AND ST_Distance(geom, 'POINT(10 20)') < 10といったようになります。これはより単純でより効率的なST_DWithinに置き換わりました。

Availability: 1.5.0 出力をfloat4座標値から倍精度に変更しました。

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。

Enhanced: 2.3.0 異なる次元の異なる量によるボックスの拡張に対応するようになりました。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

Note

次に示す例では、メートル単位の投影法である米国ナショナルアトラス正積図法 (SRID=2163)を使っています。

-- ラインストリングのボックスを10メートル拡張したボックス
SELECT CAST(ST_Expand(ST_GeomFromText('LINESTRING(2312980 110676,2312923 110701,2312892 110714)', 2163),10) As box2d);
                                         st_expand
------------------------------------
 BOX(2312882 110666,2312990 110724)

-- 3次元ボックスを10メートル拡張した3次元ボックス
SELECT ST_Expand(CAST('BOX3D(778783 2951741 1,794875 2970042.61545891 10)' As box3d),10)
                                                          st_expand
-----------------------------------------------------
 BOX3D(778773 2951731 -9,794885 2970052.61545891 20)

 -- ポイントジオメトリまわりで10メートル拡張したジオメトリの文字列表現
 SELECT ST_AsEWKT(ST_Expand(ST_GeomFromEWKT('SRID=2163;POINT(2312980 110676)'),10));
                                                                                        st_asewkt
-------------------------------------------------------------------------------------------------
 SRID=2163;POLYGON((2312970 110666,2312970 110686,2312990 110686,2312990 110666,2312970 110666))

関連情報

ST_Buffer, ST_DWithin, ST_SRID

Name

ST_Extent — ジオメトリのバウンディングボックスを返す集約関数です。

Synopsis

box2d ST_Extent(
geomfield);

geometry set geomfield;

説明

ジオメトリの集合のbox2dバウンディングボックスを返す集約関数です。

バウンディングボックスの座標は、入力ジオメトリの空間参照系に従います。

ST_ExtentはOracle Spatial/LocatorのSDO_AGGR_MBRと似た発想のものです。

Note

ST_Extentは、3次元ジオメトリであってもX値とY値だけを持つボックスを返します。Z値も得たいならST_3DExtentを使います。

Note

返されたbox3d値はSRIDを含みません。ST_SetSRIDでSRIDメタデータを持つジオメトリに変換して下さい。SRIDは入力ジオメトリと同じです。

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

Note

次に示す例では、フィート単位のマサチューセッツ州平面 (SRID=2249)を使っています。

SELECT ST_Extent(geom) as bextent FROM sometable;
                                         st_bextent
------------------------------------
BOX(739651.875 2908247.25,794875.8125 2970042.75)

-- ジオメトリの各カテゴリの範囲を返します
SELECT ST_Extent(geom) as bextent
FROM sometable
GROUP BY category ORDER BY category;

                                          bextent                       |         name
----------------------------------------------------+----------------
 BOX(778783.5625 2951741.25,794875.8125 2970042.75) | A
 BOX(751315.8125 2919164.75,765202.6875 2935417.25) | B
 BOX(739651.875 2917394.75,756688.375 2935866)      | C

-- ジオメトリに強制的に戻し、ジオメトリのEWKT表現を表示します
SELECT ST_SetSRID(ST_Extent(geom),2249) as bextent FROM sometable;

                                bextent
--------------------------------------------------------------------------------
 SRID=2249;POLYGON((739651.875 2908247.25,739651.875 2970042.75,794875.8125 2970042.75,
 794875.8125 2908247.25,739651.875 2908247.25))

関連情報

ST_EstimatedExtent, ST_3DExtent, ST_SetSRID

Name

ST_3DExtent — ジオメトリの3次元バウンディングボックスを返す集約関数です。

Synopsis

box3d ST_3DExtent(
geomfield);

geometry set geomfield;

説明

ジオメトリ集合のbox3d (Z値を持つ)を返す集約関数です。

バウンディングボックスの座標は、入力ジオメトリの空間参照系に従います。

Note

返されたbox3d値はSRIDを含みません。ST_SetSRIDでSRIDメタデータを持つジオメトリに変換して下さい。SRIDは入力ジオメトリと同じです。

Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。

Changed: 2.0.0 以前の版ではST_Extent3Dと呼ばれていました。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

SELECT ST_3DExtent(foo.geom) As b3extent
FROM (SELECT ST_MakePoint(x,y,z) As geom
        FROM generate_series(1,3) As x
                CROSS JOIN generate_series(1,2) As y
                CROSS JOIN generate_series(0,2) As Z) As foo;
          b3extent
--------------------
 BOX3D(1 1 0,3 2 2)

-- さまざまな標高を与えた曲線ストリングの範囲を得る
SELECT ST_3DExtent(foo.geom) As b3extent
FROM (SELECT ST_Translate(ST_Force_3DZ(ST_LineToCurve(ST_Buffer(ST_Point(x,y),1))),0,0,z) As geom
        FROM generate_series(1,3) As x
                CROSS JOIN generate_series(1,2) As y
                CROSS JOIN generate_series(0,2) As Z) As foo;

        b3extent
--------------------
 BOX3D(1 0 0,4 2 2)

関連情報

ST_Extent, ST_Force3DZ, ST_SetSRID

Name

ST_MakeBox2D — 二つの2次元のポイントジオメトリで定義されるBOX2Dを生成します。

Synopsis

box2d ST_MakeBox2D( | pointLowLeft, |
| pointUpRight); |

geometry pointLowLeft;
geometry pointUpRight;

説明

二つのポイントジオメトリで定義されるbox2d を生成します。これは範囲のクエリを実行する時に便利です。

例

-- 米国ナショナルアトラス座標のバウンディングボックスに
-- 完全に属するか一部属するフィーチャーの全てを返します。
-- ここでは、ジオメトリはSRID = 2163 (米国ナショナルアトラス正積図法)
-- で保存していると仮定します。
SELECT feature_id, feature_name, geom
FROM features
WHERE geom && ST_SetSRID(ST_MakeBox2D(ST_Point(-989502.1875, 528439.5625),
        ST_Point(-987121.375 ,529933.1875)),2163)

関連情報

ST_Point, ST_SetSRID, ST_SRID

Name

ST_3DMakeBox — 二つの3次元のポイントジオメトリで定義されるBOX3Dを生成します。

Synopsis

box3d ST_3DMakeBox( | point3DLowLeftBottom, |
| point3DUpRightTop); |

geometry point3DLowLeftBottom;
geometry point3DUpRightTop;

説明

二つの3次元ポイントジオメトリで定義されるbox3dが生成されます。

説明 この関数は3次元に対応し、Z値を削除しません。

Changed: 2.0.0以前の版ではST_MakeBox3Dと呼ばれていました。

例

SELECT ST_3DMakeBox(ST_MakePoint(-989502.1875, 528439.5625, 10),
        ST_MakePoint(-987121.375 ,529933.1875, 10)) As abb3d

--bb3d--
--------
BOX3D(-989502.1875 528439.5625 10,-987121.375 529933.1875 10)

関連情報

ST_MakePoint, ST_SetSRID, ST_SRID

Name

ST_XMax — 2次元または3次元のバウンディングボックスまたはジオメトリのXの最大値を返します。

Synopsis

float ST_XMax(
aGeomorBox2DorBox3D);

box3d aGeomorBox2DorBox3D;

説明

2次元または3次元のバウンディングボックスまたはジオメトリのXの最大値を返します。

Note

この関数はbox3dだけをパラメータに取るよう定義されていますが、自動キャストを介してbox2dやジオメトリ値でも動作します。しかしながら、ジオメトリやbox2dの文字列表現は自動キャストを行わないため受け付けません。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

SELECT ST_XMax('BOX3D(1 2 3, 4 5 6)');
st_xmax
-------
4

SELECT ST_XMax(ST_GeomFromText('LINESTRING(1 3 4, 5 6 7)'));
st_xmax
-------
5

SELECT ST_XMax(CAST('BOX(-3 2, 3 4)' As box2d));
st_xmax
-------
3
-- *これが動作しない*ことを見てみます
-- 文字列表現をBOX3Dに自動キャストしようとするためです
SELECT ST_XMax('LINESTRING(1 3, 5 6)');

--ERROR:  BOX3D parser - doesn't start with BOX3D(

SELECT ST_XMax(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 150406 3)'));
st_xmax
--------
220288.248780547

関連情報

ST_XMin, ST_YMax, ST_YMin, ST_ZMax, ST_ZMin

Name

ST_XMin — 2次元または3次元のバウンディングボックスまたはジオメトリのXの最小値を返します。

Synopsis

float ST_XMin(
aGeomorBox2DorBox3D);

box3d aGeomorBox2DorBox3D;

説明

2次元または3次元のバウンディングボックスまたはジオメトリのXの最小値を返します。

Note

この関数はBOX3Dに対してのみ定義されていますが、自動キャストによってBOX2Dやジオメトリ値でも動作します。しかしながら、ジオメトリまたはBOX2Dの文字列表現は、自動キャストを行わないため、受け付けません。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

SELECT ST_XMin('BOX3D(1 2 3, 4 5 6)');
st_xmin
-------
1

SELECT ST_XMin(ST_GeomFromText('LINESTRING(1 3 4, 5 6 7)'));
st_xmin
-------
1

SELECT ST_XMin(CAST('BOX(-3 2, 3 4)' As box2d));
st_xmin
-------
-3
-- *これが動作しない*ことを見てみます
-- 文字列表現をBOX3Dに自動キャストしようとするためです
SELECT ST_XMin('LINESTRING(1 3, 5 6)');

--ERROR:  BOX3D parser - doesn't start with BOX3D(

SELECT ST_XMin(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 150406 3)'));
st_xmin
--------
220186.995121892

関連情報

ST_XMax, ST_YMax, ST_YMin, ST_ZMax, ST_ZMin

Name

ST_YMax — 2次元または3次元のバウンディングボックスまたはジオメトリのYの最大値を返します。

Synopsis

float ST_YMax(
aGeomorBox2DorBox3D);

box3d aGeomorBox2DorBox3D;

説明

2次元または3次元のバウンディングボックスまたはジオメトリのYの最大値を返します。

Note

この関数はBOX3Dに対してのみ定義されていますが、自動キャストによってBOX2Dやジオメトリ値でも動作します。しかしながら、ジオメトリまたはBOX2Dの文字列表現は、自動キャストを行わないため、受け付けません。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

SELECT ST_YMax('BOX3D(1 2 3, 4 5 6)');
st_ymax
-------
5

SELECT ST_YMax(ST_GeomFromText('LINESTRING(1 3 4, 5 6 7)'));
st_ymax
-------
6

SELECT ST_YMax(CAST('BOX(-3 2, 3 4)' As box2d));
st_ymax
-------
4
-- *これが動作しない*ことを見てみます
-- 文字列表現をBOX3Dに自動キャストしようとするためです
SELECT ST_YMax('LINESTRING(1 3, 5 6)');

--ERROR:  BOX3D parser - doesn't start with BOX3D(

SELECT ST_YMax(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 150406 3)'));
st_ymax
--------
150506.126829327

関連情報

ST_XMin, ST_XMax, ST_YMin, ST_ZMax, ST_ZMin

Name

ST_YMin — 2次元または3次元のバウンディングボックスまたはジオメトリのYの最小値を返します。

Synopsis

float ST_YMin(
aGeomorBox2DorBox3D);

box3d aGeomorBox2DorBox3D;

説明

2次元または3次元のバウンディングボックスまたはジオメトリのYの最小値を返します。

Note

この関数はBOX3Dに対してのみ定義されていますが、自動キャストによってBOX2Dやジオメトリ値でも動作します。しかしながら、ジオメトリまたはBOX2Dの文字列表現は、自動キャストを行わないため、受け付けません。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

SELECT ST_YMin('BOX3D(1 2 3, 4 5 6)');
st_ymin
-------
2

SELECT ST_YMin(ST_GeomFromText('LINESTRING(1 3 4, 5 6 7)'));
st_ymin
-------
3

SELECT ST_YMin(CAST('BOX(-3 2, 3 4)' As box2d));
st_ymin
-------
2
-- *これが動作しない*ことを見てみます
-- 文字列表現をBOX3Dに自動キャストしようとするためです
SELECT ST_YMin('LINESTRING(1 3, 5 6)');

--ERROR:  BOX3D parser - doesn't start with BOX3D(

SELECT ST_YMin(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 150406 3)'));
st_ymin
--------
150406

関連情報

ST_GeomFromEWKT, ST_XMin, ST_XMax, ST_YMax, ST_ZMax, ST_ZMin

Name

ST_ZMax — 2次元または3次元のバウンディングボックスまたはジオメトリのZの最大値を返します。

Synopsis

float ST_ZMax(
aGeomorBox2DorBox3D);

box3d aGeomorBox2DorBox3D;

説明

2次元または3次元のバウンディングボックスまたはジオメトリのZの最大値を返します。

Note

この関数はBOX3Dに対してのみ定義されていますが、自動キャストによってBOX2Dやジオメトリ値でも動作します。しかしながら、ジオメトリまたはBOX2Dの文字列表現は、自動キャストを行わないため、受け付けません。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

SELECT ST_ZMax('BOX3D(1 2 3, 4 5 6)');
st_zmax
-------
6

SELECT ST_ZMax(ST_GeomFromEWKT('LINESTRING(1 3 4, 5 6 7)'));
st_zmax
-------
7

SELECT ST_ZMax('BOX3D(-3 2 1, 3 4 1)' );
st_zmax
-------
1
-- *これが動作しない*ことを見てみます
-- 文字列表現をBOX3Dに自動キャストしようとするためです
SELECT ST_ZMax('LINESTRING(1 3 4, 5 6 7)');

--ERROR:  BOX3D parser - doesn't start with BOX3D(

SELECT ST_ZMax(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 150406 3)'));
st_zmax
--------
3

関連情報

ST_GeomFromEWKT, ST_XMin, ST_XMax, ST_YMax, ST_YMin, ST_ZMax

Name

ST_ZMin — 2次元または3次元のバウンディングボックスまたはジオメトリのZの最小値を返します。

Synopsis

float ST_ZMin(
aGeomorBox2DorBox3D);

box3d aGeomorBox2DorBox3D;

説明

2次元または3次元のバウンディングボックスまたはジオメトリのZの最小値を返します。

Note

この関数はBOX3Dに対してのみ定義されていますが、自動キャストによってBOX2Dやジオメトリ値でも動作します。しかしながら、ジオメトリまたはBOX2Dの文字列表現は、自動キャストを行わないため、受け付けません。

説明この関数は3次元に対応し、Z値を削除しません。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

SELECT ST_ZMin('BOX3D(1 2 3, 4 5 6)');
st_zmin
-------
3

SELECT ST_ZMin(ST_GeomFromEWKT('LINESTRING(1 3 4, 5 6 7)'));
st_zmin
-------
4

SELECT ST_ZMin('BOX3D(-3 2 1, 3 4 1)' );
st_zmin
-------
1
-- *これが動作しない*ことを見てみます
-- 文字列表現をBOX3Dに自動キャストしようとするためです
SELECT ST_ZMin('LINESTRING(1 3 4, 5 6 7)');

--ERROR:  BOX3D parser - doesn't start with BOX3D(

SELECT ST_ZMin(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 150406 3)'));
st_zmin
--------
1

関連情報

ST_GeomFromEWKT, ST_GeomFromText, ST_XMin, ST_XMax, ST_YMax, ST_YMin, ST_ZMax

線型参照

Name

ST_LineInterpolatePoint — ラインに沿って、割合で示された位置の補間ポイントを返します。

Synopsis

geometry ST_LineInterpolatePoint( | a_linestring, |
| a_fraction); |

geometry a_linestring;
float8 a_fraction;

geography ST_LineInterpolatePoint( | a_linestring, |
| a_fraction, |
| use_spheroid = true); |

geography a_linestring;
float8 a_fraction;
boolean use_spheroid = true;

説明

ラインに沿って、割合で示された位置の補間ポイントを返します。一つ目の引数はLINESTRINGです。二つ目の引数は0から1の間の浮動小数点数で、ライン長に対するポイントの位置の割合を表現します。Z値とM値が存在する場合には補間計算を行います。

ポイントに最も近いライン位置の計算についてはST_LineLocatePointを参照して下さい。

Note

この関数は2次元のポイントとして計算して、Z値とM値は補間値を計算します。ST_3DLineInterpolatePointは3次元のポイントとして計算して、M値のみ補間値を計算します。

Note

1.1.1から、この関数はM軸やZ軸の内挿点も (存在するなら)計算するようになりました。それより前の版では0.0となります。

Availability: 0.8.2 Z軸とM軸のサポートが1.1.1で追加されました。

Changed: 2.1.0 2.0.xまでではST_Line_Interpolate_Pointと呼んでいました。

説明この関数は3次元に対応し、Z値を削除しません。

例

ラインストリングの20% (0.20)位置の補完ポイント

-- ラインに沿った20%位置

SELECT ST_AsEWKT(  ST_LineInterpolatePoint(
        'LINESTRING(25 50, 100 125, 150 190)',
        0.2 ));
----------------
 POINT(51.5974135047432 76.5974135047432)

3次元ラインの中間点

SELECT ST_AsEWKT(  ST_LineInterpolatePoint('
        LINESTRING(1 2 3, 4 5 6, 6 7 8)',
        0.5 ));
--------------------
 POINT(3.5 4.5 5.5)

ライン上のポイントに最も近いポイント

SELECT ST_AsText( ST_LineInterpolatePoint( line.geom,
                      ST_LineLocatePoint( line.geom, 'POINT(4 3)')))
FROM (SELECT ST_GeomFromText('LINESTRING(1 2, 4 5, 6 7)') As geom) AS line;
------------
 POINT(3 4)

関連情報

ST_LineInterpolatePoints, ST_3DLineInterpolatePoint, ST_LineLocatePoint

Name

ST_3DLineInterpolatePoint — 3次元ラインに沿って、割合で示された位置の補間ポイントを返します。

Synopsis

geometry ST_3DLineInterpolatePoint( | a_linestring, |
| a_fraction); |

geometry a_linestring;
float8 a_fraction;

説明

3次元ラインに沿って、割合で示された位置の補間ポイントを返します。一つ目の引数はLINESTRINGです。二つ目の引数は0から1の間の浮動小数点数で、ライン長に対するポイントの位置の割合を表現します。M値が存在する場合には補間計算を行います。

Note

ST_LineInterpolatePoint 2次元ポイントの計算とZ値とM値の補間値を計算しますが、この関数は3次元ポイントを計算し、M値だけ補間計算を行います。

Availability: 3.0.0

説明この関数は3次元に対応し、Z値を削除しません。

例

3次元ラインに沿って20%のポイントを返します

SELECT ST_AsText(
    ST_3DLineInterpolatePoint('LINESTRING(25 50 70, 100 125 90, 150 190 200)',
        0.20));

   st_asetext
----------------
 POINT Z (59.0675892910822 84.0675892910822 79.0846904776219)

関連情報

ST_LineInterpolatePoint, ST_LineInterpolatePoints, ST_LineLocatePoint

Name

ST_LineInterpolatePoints — ラインに沿って、割合で示された複数の位置の補間ポイントを返します。

Synopsis

geometry ST_LineInterpolatePoints( | a_linestring, |
| a_fraction, |
| repeat); |

geometry a_linestring;
float8 a_fraction;
boolean repeat;

geography ST_LineInterpolatePoints( | a_linestring, |
| a_fraction, |
| use_spheroid = true, |
| repeat = true); |

geography a_linestring;
float8 a_fraction;
boolean use_spheroid = true;
boolean repeat = true;

説明

ラインに沿った割合による間隔にある一つ以上の補間ポイントを返します。一つ目の引数はLINESTRINGでなければなりません。二つ目の引数はfloat8型の0から1の間の値でなければなりません。この値はライン長に対するポイント間隔の割合を示します。三つ目の引数がFALSEの場合には、一つ以下のポイントが構築されます (ST_LineInterpolatePointと同じです)。

結果が0以上のポイントを持つ場合にはPOINTが返ります。二つ以上のポイントを持つ場合にはMULTIPOINTが返ります。

Availability: 2.5.0

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数はM値に対応します。

例

20%刻みで補間されたポイントを持つラインストリング

-- 2次元ラインに沿って20%ごとのポイントを返します
SELECT ST_AsText(ST_LineInterpolatePoints('LINESTRING(25 50, 100 125, 150 190)', 0.20))
----------------
 MULTIPOINT((51.5974135047432 76.5974135047432),(78.1948270094864 103.194827009486),(104.132163186446 130.37181214238),(127.066081593223 160.18590607119),(150 190))

関連情報

ST_LineInterpolatePoint, ST_LineLocatePoint

Name

ST_LineLocatePoint — ポイントに最も近いライン上のポイントの位置を割合で返します。

Synopsis

float8 ST_LineLocatePoint( | a_linestring, |
| a_point); |

geometry a_linestring;
geometry a_point;

float8 ST_LineLocatePoint( | a_linestring, |
| a_point, |
| use_spheroid = true); |

geography a_linestring;
geography a_point;
boolean use_spheroid = true;

説明

ラインストリング上の、与えたポイントへの最短点を、2次元ラインストリングの総延長に対する割合として0から1の区間で返します。

返された位置は、ポイント(ST_LineInterpolatePoint)または、部分ラインストリング(ST_LineSubstring)の抽出に使用することができます。

この関数は、住所番号に近づくのに使えます (訳注: 道路方式の住居表示の場合)。

Availability: 1.1.0

Changed: 2.1.0 2.0.xまでではST_Line_Locate_Pointと呼んでいました。

例

-- 特定の道路に沿った道路番号の探索にざっくりと似せたもの
-- foo全体は建物中心点や道路のように見える
-- ダミーデータを生成するためのものです
-- 道路上について探索するので
-- ST_DWithinを使って道路から遠くに離れた建物を除きます
SELECT ST_AsText(house_loc) As as_text_house_loc,
        startstreet_num +
                CAST( (endstreet_num - startstreet_num)
                        * ST_LineLocatePoint(street_line, house_loc) As integer) As street_num
FROM
(SELECT ST_GeomFromText('LINESTRING(1 2, 3 4)') As street_line,
        ST_Point(x*1.01,y*1.03) As house_loc, 10 As startstreet_num,
                20 As endstreet_num
FROM generate_series(1,3) x CROSS JOIN generate_series(2,4) As y)
As foo
WHERE ST_DWithin(street_line, house_loc, 0.2);

 as_text_house_loc | street_num
-------------------+------------
 POINT(1.01 2.06)  |         10
 POINT(2.02 3.09)  |         15
 POINT(3.03 4.12)  |         20

-- ライン上の、ポイントや他のジオメトリへの最も近い点を見つける
 SELECT ST_AsText(ST_LineInterpolatePoint(foo.the_line, ST_LineLocatePoint(foo.the_line, ST_GeomFromText('POINT(4 3)'))))
FROM (SELECT ST_GeomFromText('LINESTRING(1 2, 4 5, 6 7)') As the_line) As foo;
   st_astext
----------------
 POINT(3 4)

関連情報

ST_DWithin, ST_Length2D, ST_LineInterpolatePoint, ST_LineSubstring

Name

ST_LineSubstring — 二つの割合位置からラインの一部を返します。

Synopsis

geometry ST_LineSubstring( | a_linestring, |
| startfraction, |
| endfraction); |

geometry a_linestring;
float8 startfraction;
float8 endfraction;

geography ST_LineSubstring( | a_linestring, |
| startfraction, |
| endfraction); |

geography a_linestring;
float8 startfraction;
float8 endfraction;

説明

与えられた割合位置を開始点と終了点とした、入力ラインの一部を計算します。一つ目の引数はLINESTRINGでなければなりません。二つ目と三つ目の引数は[0, 1]の範囲内で、開始点と終了点の、ライン長に対する割合の位置です。Z値とM値が存在する場合には、追加された終了点に対して補間計算を行います。

startfractionとendfractionが同じ値である場合には、ST_LineInterpolatePointと同じになります。

Note

この関数はLINESTRINGに対してのみ動作します。連続するMULTILINESTRINGで使うには、先にST_LineMergeで結合させます。

Note

1.1.1リリースからは、この関数はM値とZ値を補間します。それより前のリリースでは、Z値とM値は不定値になります。

Availability: 1.1.0 Z軸とM軸のサポートが1.1.1で追加されました。

Changed: 2.1.0 2.0.xではST_Line_Substringと呼ばれていました。

説明この関数は3次元に対応し、Z値を削除しません。

例

中心の1/3区間 (0.333, 0.666)

SELECT ST_AsText(ST_LineSubstring( 'LINESTRING (20 180, 50 20, 90 80, 120 40, 180 150)', 0.333, 0.666));
------------------------------------------------------------------------------------------------
LINESTRING (45.17311810399485 45.74337011202746, 50 20, 90 80, 112.97593050157862 49.36542599789519)

開始点と終了点とが同じ場合には、結果はPOINTになります。

SELECT ST_AsText(ST_LineSubstring( 'LINESTRING(25 50, 100 125, 150 190)', 0.333, 0.333));
------------------------------------------
 POINT(69.2846934853974 94.2846934853974)

LINESTRINGを長さ100以下の断片に分解するクエリ。FORループと同等のものを生成するためにgenerate_series()とCROSS JOIN LATERALとを併用しています。

WITH data(id, geom) AS (VALUES
        ( 'A', 'LINESTRING( 0 0, 200 0)'::geometry ),
        ( 'B', 'LINESTRING( 0 100, 350 100)'::geometry ),
        ( 'C', 'LINESTRING( 0 200, 50 200)'::geometry )
    )
SELECT id, i,
       ST_AsText( ST_LineSubstring( geom, startfrac, LEAST( endfrac, 1 )) ) AS geom
FROM (
    SELECT id, geom, ST_Length(geom) len, 100 sublen FROM data
    ) AS d
CROSS JOIN LATERAL (
    SELECT i, (sublen * i) / len AS startfrac,
              (sublen * (i+1)) / len AS endfrac
    FROM generate_series(0, floor( len / sublen )::integer ) AS t(i)
    -- ライン長がsublenの整数倍なら最後のiを飛ばします
    WHERE (sublen * i) / len <> 1.0
    ) AS d2;

 id | i |            geom
----+---+-----------------------------
 A  | 0 | LINESTRING(0 0,100 0)
 A  | 1 | LINESTRING(100 0,200 0)
 B  | 0 | LINESTRING(0 100,100 100)
 B  | 1 | LINESTRING(100 100,200 100)
 B  | 2 | LINESTRING(200 100,300 100)
 B  | 3 | LINESTRING(300 100,350 100)
 C  | 0 | LINESTRING(0 200,50 200)

関連情報

ST_Length, ST_LineInterpolatePoint, ST_LineMerge

Name

ST_LocateAlong — M値に一致するジオメトリ上のポイントを返します。

Synopsis

geometry ST_LocateAlong( | geom_with_measure, |
| measure, |
| offset = 0); |

geometry geom_with_measure;
float8 measure;
float8 offset = 0;

説明

M値を持つジオメトリに沿った位置を返します。結果はポイントまたはマルチポイントです。ポリゴン系入力には対応していません。

offsetが与えられた場合には、結果は、入力ラインの左または右に、指定された距離だけ移動します。正のオフセット値で左に、負の値で右にそれぞれ移動します。

Note

この関数は、M要素を持つライン系ジオメトリでのみ使います。

ISO/IEC 13249-3 SQL/MM 空間標準で規定されているため、このような意味になります。

Availability: 1.1.0 それまではST_Locale_Along_Measureでした。

Changed: 2.0.0 以前の版ではST_Locate_Along_Measureと呼ばれていました。

説明この関数はM値に対応します。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 5.1.13

例

SELECT ST_AsText(
  ST_LocateAlong(
    'MULTILINESTRINGM((1 2 3, 3 4 2, 9 4 3),(1 2 3, 5 4 5))'::geometry,
    3 ));

----------------------------------
 MULTIPOINT M ((1 2 3),(9 4 3),(1 2 3))

関連情報

ST_LocateBetween, ST_LocateBetweenElevations, ST_InterpolatePoint

Name

ST_LocateBetween — M値の範囲に合致する部分ジオメトリを返します。

Synopsis

geometry ST_LocateBetween( | geom, |
| measure_start, |
| measure_end, |
| offset = 0); |

geometry geom;
float8 measure_start;
float8 measure_end;
float8 offset = 0;

説明

指定された範囲のM値を持つ入力ジオメトリの部分ジオメトリとなるジオメトリ (コレクション)を全て返します。

offsetが与えられた場合には、結果は、入力ラインの左または右に、指定された距離だけ移動します。正のオフセット値で左に、負の値で右にそれぞれ移動します。

凸でないPOLYGONを抜き出すと不正なジオメトリを返すことがあります。

ISO/IEC 13249-3 SQL/MM 空間標準で規定されているため、このような意味になります。

Availability: 1.1.0 それより前はST_Locate_Between_Measuresでした。

Changed: 2.0.0 以前の版ではST_Locate_Between_Measuresと呼ばれていました。

Enhanced: 3.0.0 - POLYGON, TIN, TRIANGLEへの対応が追加されました。

説明この関数はM値に対応します。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 5.1

例

SELECT ST_AsText(
  ST_LocateBetween(
       'MULTILINESTRING M ((1 2 3, 3 4 2, 9 4 3),(1 2 3, 5 4 5))':: geometry,
       1.5, 3 ));
------------------------------------------------------------------------
 GEOMETRYCOLLECTION M (LINESTRING M (1 2 3,3 4 2,9 4 3),POINT M (1 2 3))

M値が2と8の間になる辺を持ち左にずれたラインストリング

SELECT ST_AsText( ST_LocateBetween(
  ST_AddMeasure('LINESTRING (20 180, 50 20, 100 120, 180 20)', 0, 10),
  2, 8,
  20
));
------------------------------------------------------------------------
MULTILINESTRING((54.49835019899045 104.53426957938231,58.70056060327303 82.12248075654186,69.16695286779743 103.05526528559065,82.11145618000168 128.94427190999915,84.24893681714357 132.32493442618113,87.01636951231555 135.21267035596549,90.30307285299679 137.49198684843182,93.97759758337769 139.07172433557758,97.89298381958797 139.8887023914453,101.89263860095893 139.9102465862721,105.81659870902816 139.13549527600819,109.50792827749828 137.5954340631298,112.81899532549731 135.351656550512,115.6173761888606 132.49390095108848,145.31017306064817 95.37790486135405))

関連情報

ST_LocateAlong, ST_LocateBetweenElevations

Name

ST_LocateBetweenElevations — 標高 (Z値)範囲にある部分ジオメトリを返します。

Synopsis

geometry ST_LocateBetweenElevations( | geom, |
| elevation_start, |
| elevation_end); |

geometry geom;
float8 elevation_start;
float8 elevation_end;

説明

標高 (Z値)範囲にある部分ジオメトリとなるジオメトリ (コレクション)を返します。

凸でないPOLYGONを抜き出すと不正なジオメトリを返すことがあります。

Availability: 1.4.0

Enhanced: 3.0.0 - POLYGON, TIN, TRIANGLEへの対応が追加されました。

説明この関数は3次元に対応し、Z値を削除しません。

例

SELECT ST_AsText(
  ST_LocateBetweenElevations(
    'LINESTRING(1 2 3, 4 5 6)'::geometry,
    2, 4 ));

             st_astext
-----------------------------------
 MULTILINESTRING Z ((1 2 3,2 3 4))

SELECT ST_AsText(
    ST_LocateBetweenElevations(
      'LINESTRING(1 2 6, 4 5 -1, 7 8 9)',
      6, 9)) As ewelev;

                                ewelev
-----------------------------------------------------------------------
 GEOMETRYCOLLECTION Z (POINT Z (1 2 6),LINESTRING Z (6.1 7.1 6,7 8 9))

関連情報

ST_Dump, ST_LocateBetween

Name

ST_InterpolatePoint — ジオメトリのポイントに最も近いポイント上の補間M値を返します。

Synopsis

float8 ST_InterpolatePoint( | linear_geom_with_measure, |
| point); |

geometry linear_geom_with_measure;
geometry point;

説明

ライン系のM値を持つジオメトリについて、与えられたポイントに最も近い位置におけるM値の補間値を返します。

Note

この関数は、M要素を持つライン系ジオメトリでのみ使います。

Availability: 2.0.0

説明この関数は3次元に対応し、Z値を削除しません。

例

SELECT ST_InterpolatePoint('LINESTRING M (0 0 0, 10 0 20)', 'POINT(5 5)');
 ---------------------
         10

関連情報

ST_AddMeasure, ST_LocateAlong, ST_LocateBetween

Name

ST_AddMeasure — ラインに沿ったM値を補間します。

Synopsis

geometry ST_AddMeasure( | geom_mline, |
| measure_start, |
| measure_end); |

geometry geom_mline;
float8 measure_start;
float8 measure_end;

説明

開始点と終了点の間で線形補間したM値を持つ派生ジオメトリを返します。ジオメトリがM値を持たない場合にはM値が追加されます。ジオメトリがM値を持つ場合には新値に置き換えられます。LINESTRINGとMULTILINESTRINGだけに対応しています。

Availability: 1.5.0

説明この関数は3次元に対応し、Z値を削除しません。

例

SELECT ST_AsText(ST_AddMeasure(
ST_GeomFromEWKT('LINESTRING(1 0, 2 0, 4 0)'),1,4)) As ewelev;
           ewelev
--------------------------------
 LINESTRINGM(1 0 1,2 0 2,4 0 4)

SELECT ST_AsText(ST_AddMeasure(
ST_GeomFromEWKT('LINESTRING(1 0 4, 2 0 4, 4 0 4)'),10,40)) As ewelev;
                 ewelev
----------------------------------------
 LINESTRING(1 0 4 10,2 0 4 20,4 0 4 40)

SELECT ST_AsText(ST_AddMeasure(
ST_GeomFromEWKT('LINESTRINGM(1 0 4, 2 0 4, 4 0 4)'),10,40)) As ewelev;
                 ewelev
----------------------------------------
 LINESTRINGM(1 0 10,2 0 20,4 0 40)

SELECT ST_AsText(ST_AddMeasure(
ST_GeomFromEWKT('MULTILINESTRINGM((1 0 4, 2 0 4, 4 0 4),(1 0 4, 2 0 4, 4 0 4))'),10,70)) As ewelev;
                             ewelev
-----------------------------------------------------------------
 MULTILINESTRINGM((1 0 10,2 0 20,4 0 40),(1 0 40,2 0 50,4 0 70))

トラジェクトリ関数

Abstract

これらの関数はトラジェクトリで動作します。トラジェクトリは、M値が座標ごとに増加していく線形ジオメトリです。時空間データはM値を相対時間 (エポック等)としてモデル化できます。

Name

ST_IsValidTrajectory — ジオメトリが妥当なトラジェクトリであるかどうかをテストします。

Synopsis

boolean ST_IsValidTrajectory(
line);

geometry line;

説明

ジオメトリが妥当なトラジェクトリの符号化したものとなっているかをテストします。妥当なトラジェクトリは、M値 (Measure)を持つLINESTRINGで表現されます。M値は始点から順次増加していかなければなりません。

ST_ClosestPointOfApproach等の時空間関数は、妥当なトラジェクトリを入力値として期待します。

Availability: 2.2.0

説明この関数は3次元に対応し、Z値を削除しません。

例

-- 妥当なトラジェクトリ
SELECT ST_IsValidTrajectory(ST_MakeLine(
  ST_MakePointM(0,0,1),
  ST_MakePointM(0,1,2))
);
 t

-- 不正なトラジェクトリ
SELECT ST_IsValidTrajectory(ST_MakeLine(ST_MakePointM(0,0,1), ST_MakePointM(0,1,0)));
NOTICE:  Measure of vertex 1 (0) not bigger than measure of vertex 0 (1)
 st_isvalidtrajectory
----------------------
 f

関連情報

ST_ClosestPointOfApproach

Name

ST_ClosestPointOfApproach — 二つのトラジェクトリの最接近時の距離を返します。

Synopsis

float8 ST_ClosestPointOfApproach( | track1, |
| track2); |

geometry track1;
geometry track2;

説明

与えられたトラジェクトリに沿って補間された最小距離となる点のM値の最小値を返します。

妥当なトラジェクトリはST_IsValidTrajectoryで確認できます。トラジェクトリのM値の範囲が重ならない場合にはNULLが返ります。

与えられたM値における実際の点を得るにはST_LocateAlongを参照して下さい。

Availability: 2.2.0

説明この関数は3次元に対応し、Z値を削除しません。

例

-- 10:00から11:00まで移動する二つの物体の最接近する時刻を返します
WITH inp AS ( SELECT
  ST_AddMeasure('LINESTRING Z (0 0 0, 10 0 5)'::geometry,
    extract(epoch from '2015-05-26 10:00'::timestamptz),
    extract(epoch from '2015-05-26 11:00'::timestamptz)
  ) a,
  ST_AddMeasure('LINESTRING Z (0 2 10, 12 1 2)'::geometry,
    extract(epoch from '2015-05-26 10:00'::timestamptz),
    extract(epoch from '2015-05-26 11:00'::timestamptz)
  ) b
), cpa AS (
  SELECT ST_ClosestPointOfApproach(a,b) m FROM inp
), points AS (
  SELECT ST_Force3DZ(ST_GeometryN(ST_LocateAlong(a,m),1)) pa,
         ST_Force3DZ(ST_GeometryN(ST_LocateAlong(b,m),1)) pb
  FROM inp, cpa
)
SELECT to_timestamp(m) t,
       ST_Distance(pa,pb) distance
FROM points, cpa;

               t               |     distance
-------------------------------+------------------
 2015-05-26 10:45:31.034483+02 | 1.96036833151395

関連情報

ST_IsValidTrajectory, ST_DistanceCPA, ST_LocateAlong, ST_AddMeasure

Name

ST_DistanceCPA — 二つのトラジェクトリの最接近する時の距離を返します。

Synopsis

float8 ST_DistanceCPA( | track1, |
| track2); |

geometry track1;
geometry track2;

説明

二つの移動体の相手までの距離の最小値を返します。

妥当なトラジェクトリはST_IsValidTrajectoryで確認できます。トラジェクトリのM値の範囲が重ならない場合にはNULLが返ります。

Availability: 2.2.0

説明この関数は3次元に対応し、Z値を削除しません。

例

-- 10:00から11:00まで移動する二つの物体の最短距離を返します
WITH inp AS ( SELECT
  ST_AddMeasure('LINESTRING Z (0 0 0, 10 0 5)'::geometry,
    extract(epoch from '2015-05-26 10:00'::timestamptz),
    extract(epoch from '2015-05-26 11:00'::timestamptz)
  ) a,
  ST_AddMeasure('LINESTRING Z (0 2 10, 12 1 2)'::geometry,
    extract(epoch from '2015-05-26 10:00'::timestamptz),
    extract(epoch from '2015-05-26 11:00'::timestamptz)
  ) b
)
SELECT ST_DistanceCPA(a,b) distance FROM inp;

     distance
------------------
 1.96036833151395

関連情報

ST_IsValidTrajectory, ST_ClosestPointOfApproach, ST_AddMeasure, |=|

Name

ST_CPAWithin — 二つのトラジェクトリの最接近時の距離が指定距離内であるかどうかをテストします。

Synopsis

boolean ST_CPAWithin( | track1, |
| track2, |
| dist); |

geometry track1;
geometry track2;
float8 dist;

説明

二つの移動オブジェクトが指定距離より近づいているかどうかをテストします。

入力はST_IsValidTrajectoryで確認された妥当なトラジェクトリでなければなりません。トラジェクトリのM値の範囲が重ならない場合にはFALSEを返します。

Availability: 2.2.0

説明この関数は3次元に対応し、Z値を削除しません。

例

WITH inp AS ( SELECT
  ST_AddMeasure('LINESTRING Z (0 0 0, 10 0 5)'::geometry,
    extract(epoch from '2015-05-26 10:00'::timestamptz),
    extract(epoch from '2015-05-26 11:00'::timestamptz)
  ) a,
  ST_AddMeasure('LINESTRING Z (0 2 10, 12 1 2)'::geometry,
    extract(epoch from '2015-05-26 10:00'::timestamptz),
    extract(epoch from '2015-05-26 11:00'::timestamptz)
  ) b
)
SELECT ST_CPAWithin(a,b,2), ST_DistanceCPA(a,b) distance FROM inp;

 st_cpawithin |     distance
--------------+------------------
 t            | 1.96521473776207

関連情報

ST_IsValidTrajectory, ST_ClosestPointOfApproach, ST_DistanceCPA, |=|

SFCGAL関数

Abstract

SFCGALはCGALのC++ラッパライブラリです。CGALは高度な2次元と3次元の空間関数を提供します。堅牢性のためにジオメトリ座標は正確な有理数表現を持ちます。

このライブラリのインストール手順はSFCGALサイト (http://www.sfcgal.org)にあります。機能を有効にするにはcreate extension postgis_sfcgalとします。

Name

postgis_sfcgal_version — 使用しているSFCGALのバージョンを返します

Synopsis

text postgis_sfcgal_version(
);

説明

使用しているSFCGALのバージョンを返します

Availability: 2.1.0

説明このメソッドにはSFCGALバックエンドが必要です。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

関連情報

postgis_sfcgal_full_version

Name

postgis_sfcgal_full_version — CGALとBoostのバージョンを含む、使用しているSFCGALの完全なバージョンを返します

Synopsis

text postgis_sfcgal_full_version(
);

説明

CGALとBoostのバージョンを含む、使用しているSFCGALの完全なバージョンを返します

Availability: 3.3.0

説明このメソッドにはSFCGALバックエンドが必要です。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

関連情報

postgis_sfcgal_version

Name

ST_3DArea — 3次元の面ジオメトリの面積を計算します。立体の場合は0を返します。

Synopsis

floatST_3DArea(
geom1);

geometry geom1;

説明

Availability: 2.1.0

説明このメソッドにはSFCGALバックエンドが必要です。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 8.1, 10.5

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

ご注意: デフォルトでは、WKTから生成されたPolyhedralSurfaceは面ジオメトリで、立体ではありません。サーフェス面を持ちます。立体に変換すると、面を持ちません。

SELECT ST_3DArea(geom) As cube_surface_area,
        ST_3DArea(ST_MakeSolid(geom)) As solid_surface_area
  FROM (SELECT 'POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
    ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)),
    ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
    ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
    ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)),
    ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'::geometry) As f(geom);

 cube_surface_area | solid_surface_area
-------------------+--------------------
                 6 |                  0

関連情報

ST_Area, ST_MakeSolid, ST_IsSolid, ST_Area

Name

ST_3DConvexHull — ジオメトリの3次元の凸包を計算します。

Synopsis

geometry ST_3DConvexHull(
geom1);

geometry geom1;

説明

Availability: 3.3.0

説明このメソッドにはSFCGALバックエンドが必要です。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

SELECT ST_AsText(ST_3DConvexHull('LINESTRING Z(0 0 5, 1 5 3, 5 7 6, 9 5 3 , 5 7 5, 6 3 5)'::geometry));

POLYHEDRALSURFACE Z (((1 5 3,9 5 3,0 0 5,1 5 3)),((1 5 3,0 0 5,5 7 6,1 5 3)),((5 7 6,5 7 5,1 5 3,5 7 6)),((0 0 5,6 3 5,5 7 6,0 0 5)),((6 3 5,9 5 3,5 7 6,6 3 5)),((0 0 5,9 5 3,6 3 5,0 0 5)),((9 5 3,5 7 5,5 7 6,9 5 3)),((1 5 3,5 7 5,9 5 3,1 5 3)))

WITH f AS (SELECT i, ST_Extrude(geom, 0,0, i ) AS geom
FROM ST_Subdivide(ST_Letters('CH'),5) WITH ORDINALITY AS sd(geom,i)
      )
      SELECT ST_3DConvexHull(ST_Collect(f.geom) )
      FROM f;

3次元凸包をオーバレイした元のジオメトリ

関連情報

ST_Letters, ST_AsX3D

Name

ST_3DIntersection — 3次元のインタセクトした (共有する)部分を計算します。

Synopsis

geometry ST_3DIntersection( | geom1, |
| geom2); |

geometry geom1;
geometry geom2;

説明

geom1とgeom2の間で共有される部分のジオメトリを返します。

Availability: 2.1.0

説明このメソッドにはSFCGALバックエンドが必要です。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 5.1

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

PostGIS関数ST_AsX3Dを使って3次元イメージを生成し、X3Dom HTML Javascript redering libraryを使ってHTMLでの描画を行います。

SELECT ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),
 50, 'quad_segs=2'),0,0,30) AS geom1,
        ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(80 80)'),
 50, 'quad_segs=1'),0,0,30) AS geom2;

元の3次元ジオメトリを重ねたものでgeom2は半透明で表示

SELECT ST_3DIntersection(geom1,geom2)
FROM ( SELECT ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),
 50, 'quad_segs=2'),0,0,30) AS geom1,
        ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(80 80)'),
 50, 'quad_segs=1'),0,0,30) AS geom2 ) As t;

geom1とgeom2の共有部分

3次元ラインストリングとポリゴン

SELECT ST_AsText(ST_3DIntersection(linestring, polygon)) As wkt
FROM  ST_GeomFromText('LINESTRING Z (2 2 6,1.5 1.5 7,1 1 8,0.5 0.5 8,0 0 10)') AS linestring
 CROSS JOIN ST_GeomFromText('POLYGON((0 0 8, 0 1 8, 1 1 8, 1 0 8, 0 0 8))') AS polygon;

              wkt
--------------------------------
 LINESTRING Z (1 1 8,0.5 0.5 8)

立方体 (閉じた多面体サーフェス)と3次元ポリゴン

SELECT ST_AsText(ST_3DIntersection(
                ST_GeomFromText('POLYHEDRALSURFACE Z( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
        ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
        ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
        ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'),
        'POLYGON Z ((0 0 0, 0 0 0.5, 0 0.5 0.5, 0 0.5 0, 0 0 0))'::geometry))

TIN Z (((0 0 0,0 0 0.5,0 0.5 0.5,0 0 0)),((0 0.5 0,0 0 0,0 0.5 0.5,0 0.5 0)))

二つの立体の共通部分もまた立体です (ST_Dimensionで3を返します)

SELECT ST_AsText(ST_3DIntersection( ST_Extrude(ST_Buffer('POINT(10 20)'::geometry,10,1),0,0,30),
 ST_Extrude(ST_Buffer('POINT(10 20)'::geometry,10,1),2,0,10) ));

POLYHEDRALSURFACE Z (((13.3333333333333 13.3333333333333 10,20 20 0,20 20 10,13.3333333333333 13.3333333333333 10)),
        ((20 20 10,16.6666666666667 23.3333333333333 10,13.3333333333333 13.3333333333333 10,20 20 10)),
        ((20 20 0,16.6666666666667 23.3333333333333 10,20 20 10,20 20 0)),
        ((13.3333333333333 13.3333333333333 10,10 10 0,20 20 0,13.3333333333333 13.3333333333333 10)),
        ((16.6666666666667 23.3333333333333 10,12 28 10,13.3333333333333 13.3333333333333 10,16.6666666666667 23.3333333333333 10)),
        ((20 20 0,9.99999999999995 30 0,16.6666666666667 23.3333333333333 10,20 20 0)),
        ((10 10 0,9.99999999999995 30 0,20 20 0,10 10 0)),((13.3333333333333 13.3333333333333 10,12 12 10,10 10 0,13.3333333333333 13.3333333333333 10)),
        ((12 28 10,12 12 10,13.3333333333333 13.3333333333333 10,12 28 10)),
        ((16.6666666666667 23.3333333333333 10,9.99999999999995 30 0,12 28 10,16.6666666666667 23.3333333333333 10)),
        ((10 10 0,0 20 0,9.99999999999995 30 0,10 10 0)),
        ((12 12 10,11 11 10,10 10 0,12 12 10)),((12 28 10,11 11 10,12 12 10,12 28 10)),
        ((9.99999999999995 30 0,11 29 10,12 28 10,9.99999999999995 30 0)),((0 20 0,2 20 10,9.99999999999995 30 0,0 20 0)),
        ((10 10 0,2 20 10,0 20 0,10 10 0)),((11 11 10,2 20 10,10 10 0,11 11 10)),((12 28 10,11 29 10,11 11 10,12 28 10)),
        ((9.99999999999995 30 0,2 20 10,11 29 10,9.99999999999995 30 0)),((11 11 10,11 29 10,2 20 10,11 11 10)))

Name

ST_3DDifference — 3次元の差分を計算します。

Synopsis

geometry ST_3DDifference( | geom1, |
| geom2); |

geometry geom1;
geometry geom2;

説明

geom2に含まれないgeom1の一部を返します。

Availability: 2.2.0

説明このメソッドにはSFCGALバックエンドが必要です。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 5.1

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

PostGIS関数ST_AsX3Dを使って3次元イメージを生成し、X3Dom HTML Javascript redering libraryを使ってHTMLでの描画を行います。

SELECT ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),
 50, 'quad_segs=2'),0,0,30) AS geom1,
        ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(80 80)'),
 50, 'quad_segs=1'),0,0,30) AS geom2;

元の3次元ジオメトリを重ねたもの。geom2は削除部分にあたります。

SELECT ST_3DDifference(geom1,geom2)
FROM ( SELECT ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),
 50, 'quad_segs=2'),0,0,30) AS geom1,
        ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(80 80)'),
 50, 'quad_segs=1'),0,0,30) AS geom2 ) As t;

geom2を削除した後に残るもの

関連情報

ST_Extrude, ST_AsX3D, ST_3DIntersection ST_3DUnion

Name

ST_3DUnion — 3次元の結合を計算します。

Synopsis

geometry ST_3DUnion( | geom1, |
| geom2); |

geometry geom1;
geometry geom2;

geometry ST_3DUnion(
g1field);

geometry set g1field;

説明

Availability: 2.2.0

Availability: 3.3.0 集約関数の形式が追加されました

説明このメソッドにはSFCGALバックエンドが必要です。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 5.1

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

集約関数形式: ジオメトリの集合を3次元結合したジオメトリを返します。ST_3DUnion()関数は、PostgreSQL用語で言うところの「集約関数」です。つまり、SUM()やMEAN()と同じ方法で複数のデータ行の操作を行い、他の集約関数と同じようにNULLジオメトリを無視します。

例

PostGIS関数ST_AsX3Dを使って3次元イメージを生成し、X3Dom HTML Javascript redering libraryを使ってHTMLでの描画を行います。

SELECT ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),
 50, 'quad_segs=2'),0,0,30) AS geom1,
        ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(80 80)'),
 50, 'quad_segs=1'),0,0,30) AS geom2;

元の3次元ジオメトリを重ねたもの。geom2は半透明で示しています。

SELECT ST_3DUnion(geom1,geom2)
FROM ( SELECT ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),
 50, 'quad_segs=2'),0,0,30) AS geom1,
        ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(80 80)'),
 50, 'quad_segs=1'),0,0,30) AS geom2 ) As t;

geom1とgeom2の結合

関連情報

ST_Extrude, ST_AsX3D, ST_3DIntersection ST_3DDifference

Name

ST_AlphaShape — ジオメトリを囲むアルファシェイプを計算します。

Synopsis

geometry ST_AlphaShape( | geom, |
| alpha, |
| allow_holes = false); |

geometry geom;
float alpha;
boolean allow_holes = false;

説明

ジオメトリのポイントのアルファシェイプを計算します。アルファシェイプは (通常は)入力の頂点を全て含む凹ポリゴンジオメトリで、このジオメトリの頂点は入力頂点の部分集合です。アルファシェイプは入力ジオメトリのシェイプを凸包で生成されるシェイプよりも適合したものにします。

「適合度」はalphaパラメータで制御します。このパラメータは0から無限大の数を取ります。小さいα値では凹が増える結果になりますα値がデータ依存の値より大きいと入力の凸包が生成されます。

Note

CGAL実装に従うと、α値は、アルファシェイプアルゴリズムで、入力ジオメトリのドロネー三角形を侵食するために使われる円の半径の2乗です。詳細情報についてはCGAL Alpha-Shapesをご覧下さい。元のアルファシェイプの定義と違います。元はα値を侵食円の半径と定義しています。

計算されたシェイプはallow_holesをTRUEに設定しない限りは穴を持ちません。

この関数はジオメトリの凹包をST_ConcaveHullと似た方法で効率的に計算しますが、CGALや異なるアルゴリズムを使います。

Availability: 3.3.0 - SFCGAL >= 1.4.1 が必要です。

説明このメソッドにはSFCGALバックエンドが必要です。

例

マルチポイントのアルファシェイプ (ST_OptimalAlphaShapeと同じ)

SELECT ST_AsText(ST_AlphaShape('MULTIPOINT((63 84),(76 88),(68 73),(53 18),(91 50),(81 70),
                (88 29),(24 82),(32 51),(37 23),(27 54),(84 19),(75 87),(44 42),(77 67),(90 30),(36 61),(32 65),
                (81 47),(88 58),(68 73),(49 95),(81 60),(87 50),
                (78 16),(79 21),(30 22),(78 43),(26 85),(48 34),(35 35),(36 40),(31 79),(83 29),(27 84),(52 98),(72 95),(85 71),
                (75 84),(75 77),(81 29),(77 73),(41 42),(83 72),(23 36),(89 53),(27 57),(57 97),(27 77),(39 88),(60 81),
                (80 72),(54 32),(55 26),(62 22),(70 20),(76 27),(84 35),(87 42),(82 54),(83 64),(69 86),(60 90),(50 86),(43 80),(36 73),
                (36 68),(40 75),(24 67),(23 60),(26 44),(28 33),(40 32),(43 19),(65 16),(73 16),(38 46),(31 59),(34 86),(45 90),(64 97))'::geometry,80.2));

POLYGON((89 53,91 50,87 42,90 30,88 29,84 19,78 16,73 16,65 16,53 18,43 19,37 23,30 22,28 33,23 36,26 44,27 54,23 60,24 67,
          27 77,24 82,26 85,34 86,39 88,45 90,49 95,52 98,57 97,64 97,72 95,76 88,75 84,83 72,85 71,88 58,89 53))

マルチポイントのアルファシェイプで穴を許す (ST_OptimalAlphaShapeと同じ)

SELECT ST_AsText(ST_AlphaShape('MULTIPOINT((63 84),(76 88),(68 73),(53 18),(91 50),(81 70),(88 29),(24 82),(32 51),(37 23),(27 54),(84 19),(75 87),(44 42),(77 67),(90 30),(36 61),(32 65),(81 47),(88 58),(68 73),(49 95),(81 60),(87 50),
                (78 16),(79 21),(30 22),(78 43),(26 85),(48 34),(35 35),(36 40),(31 79),(83 29),(27 84),(52 98),(72 95),(85 71),
                (75 84),(75 77),(81 29),(77 73),(41 42),(83 72),(23 36),(89 53),(27 57),(57 97),(27 77),(39 88),(60 81),
                (80 72),(54 32),(55 26),(62 22),(70 20),(76 27),(84 35),(87 42),(82 54),(83 64),(69 86),(60 90),(50 86),(43 80),(36 73),
                (36 68),(40 75),(24 67),(23 60),(26 44),(28 33),(40 32),(43 19),(65 16),(73 16),(38 46),(31 59),(34 86),(45 90),(64 97))'::geometry, 100.1,true))

POLYGON((89 53,91 50,87 42,90 30,88 29,84 19,78 16,73 16,65 16,53 18,43 19,37 23,30 22,28 33,23 36,26 44,27 54,23 60,24 67,27 77,24 82,26 85,34 86,39 88,45 90,49 95,52 98,57 97,64 97,72 95,76 88,75 84,83 72,85 71,88 58,89 53),
              (36 61,36 68,40 75,43 80,50 86,60 81,68 73,77 67,81 60,82 54,81 47,78 43,76 27,62 22,54 32,48 34,44 42,38 46,36 61))

マルチポイントのアルファシェイプで穴を許す (ST_ConcaveHullと同じ)

SELECT ST_AlphaShape(
            'MULTIPOINT ((132 64), (114 64), (99 64), (81 64), (63 64), (57 49), (52 36), (46 20), (37 20), (26 20), (32 36), (39 55), (43 69), (50 84), (57 100), (63 118), (68 133), (74 149), (81 164), (88 180), (101 180), (112 180), (119 164), (126 149), (132 131), (139 113), (143 100), (150 84), (157 69), (163 51), (168 36), (174 20), (163 20), (150 20), (143 36), (139 49), (132 64), (99 151), (92 138), (88 124), (81 109), (74 93), (70 82), (83 82), (99 82), (112 82), (126 82), (121 96), (114 109), (110 122), (103 138), (99 151), (34 27), (43 31), (48 44), (46 58), (52 73), (63 73), (61 84), (72 71), (90 69), (101 76), (123 71), (141 62), (166 27), (150 33), (159 36), (146 44), (154 53), (152 62), (146 73), (134 76), (143 82), (141 91), (130 98), (126 104), (132 113), (128 127), (117 122), (112 133), (119 144), (108 147), (119 153), (110 171), (103 164), (92 171), (86 160), (88 142), (79 140), (72 124), (83 131), (79 118), (68 113), (63 102), (68 93), (35 45))'::geometry,102.2, true);

POLYGON((134 80,136 75,130 63,135 45,132 44,126 28,117 24,110 24,98 24,80 27,82 39,72 51,60 48,56 34,52 52,42 50,
                34 54,39 66,40 81,34 90,36 100,40 116,36 123,39 128,51 129,58 132,68 135,74 142,78 147,86 146,96 146,
                108 142,114 132,112 126,112 116,116 110,120 108,125 108,128 106,125 96,132 87,134 80))

関連情報

ST_ConcaveHull, ST_OptimalAlphaShape

Name

ST_ApproximateMedialAxis — 面ジオメトリの近似的な中心軸を計算します。

Synopsis

geometry ST_ApproximateMedialAxis(
geom);

geometry geom;

説明

ストレートスケルトンを基に、入力された面の近似的な中心軸を返します。可能な版 (1.2.0以上)でビルドすると、SFCGAL独自APIを使います。そうでない場合はST_StraightSkeleton (遅い)のラップとなります。

Availability: 2.2.0

説明このメソッドにはSFCGALバックエンドが必要です。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

SELECT ST_ApproximateMedialAxis(ST_GeomFromText('POLYGON (( 190 190, 10 190, 10 10, 190 10, 190 20, 160 30, 60 30, 60 130, 190 140, 190 190 ))'));

ポリゴンと近似的な中心軸

関連情報

ST_StraightSkeleton

Name

ST_ConstrainedDelaunayTriangles — 入力ジオメトリの周りの制約付きドロネー三角形を返します。

Synopsis

geometry ST_ConstrainedDelaunayTriangles(
g1);

geometry g1;

説明

入力ジオメトリの周りの制約付きドロネー三角形 (Constrained Delaunay triangulation)を返します。出力はTINです。

説明このメソッドにはSFCGALバックエンドが必要です。

Availability: 3.0.0

説明この関数は3次元に対応し、Z値を削除しません。

例

二つのポリゴンのST_ConstrainedDelaunayTriangles

select ST_ConstrainedDelaunayTriangles(
               ST_Union(
                       'POLYGON((175 150, 20 40, 50 60, 125 100, 175 150))'::geometry,
                       ST_Buffer('POINT(110 170)'::geometry, 20)
                   )
           );

ST_DelaunayTriangles 二つのポリゴン。三角形の辺はポリゴンの境界にクロスしています。

select ST_DelaunayTriangles(
               ST_Union(
                       'POLYGON((175 150, 20 40, 50 60, 125 100, 175 150))'::geometry,
                       ST_Buffer('POINT(110 170)'::geometry, 20)
                   )
           );

関連情報

ST_DelaunayTriangles, ST_TriangulatePolygon, ST_Tesselate, ST_ConcaveHull, ST_Dump

Name

ST_Extrude — 関連するボリュームにサーフェスを押し出します。

Synopsis

geometry ST_Extrude( | geom, |
| x, |
| y, |
| z); |

geometry geom;
float x;
float y;
float z;

説明

Availability: 2.1.0

説明このメソッドにはSFCGALバックエンドが必要です。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

PostGIS関数ST_AsX3Dを使って3次元イメージを生成し、X3Dom HTML Javascript redering libraryを使ってHTMLでの描画を行います。

SELECT ST_Buffer(ST_GeomFromText('POINT(100 90)'),
  50, 'quad_segs=2'),0,0,30);

ポイントのバッファから形成された元の八角形

ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),
 50, 'quad_segs=2'),0,0,30);

Z方向に30単位押し出して得たPolyhedralSurfaceZ

SELECT ST_GeomFromText('LINESTRING(50 50, 100 90, 95 150)')

元のラインストリング

SELECT ST_Extrude(
 ST_GeomFromText('LINESTRING(50 50, 100 90, 95 150)'),0,0,10));

ラインストリングをZ方向に押し出したPolyhedralSurfaceZ

関連情報

ST_AsX3D

Name

ST_ForceLHR — LHR (Left Hand Rule)方向に強制します。

Synopsis

geometry ST_ForceLHR(
geom);

geometry geom;

説明

Availability: 2.1.0

説明このメソッドにはSFCGALバックエンドが必要です。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

Name

ST_IsPlanar — サーフェスが平面であるかないかをチェックします。

Synopsis

boolean ST_IsPlanar(
geom);

geometry geom;

説明

Availability: 2.2.0: これは2.1.0のマニュアルに記述されていましたが、2.1版では偶然に外れてしまいました。

説明このメソッドにはSFCGALバックエンドが必要です。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

Name

ST_IsSolid — ジオメトリが立体であるかどうかをテストします。妥当性チェックは行いません。

Synopsis

boolean ST_IsSolid(
geom1);

geometry geom1;

説明

Availability: 2.2.0

説明このメソッドにはSFCGALバックエンドが必要です。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

Name

ST_MakeSolid — ジオメトリを立体にキャストします。チェックはしません。妥当な立体を得るには、入力ジオメトリは閉じた多面体サーフェスか閉じたTINでなければなりません。

Synopsis

geometry ST_MakeSolid(
geom1);

geometry geom1;

説明

Availability: 2.2.0

説明このメソッドにはSFCGALバックエンドが必要です。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

Name

ST_MinkowskiSum — ミンコフスキー和を求めます。

Synopsis

geometry ST_MinkowskiSum( | geom1, |
| geom2); |

geometry geom1;
geometry geom2;

説明

ポリゴンと、ポイント、ライン、ポリゴンのいずれかとの2次元のミンコフスキー和を計算します。

二つのジオメトリAとBのミンコフスキー和はAとBのあらゆるポイントの和の集合です。ミンコフスキー和は、しばしば動作計画とCADで使われます。より詳細な情報についてWikipedia Minkowski additionをご覧ください。

一つ目の引数は2次元ジオメトリ (ポイント、ラインストリング、ポリゴン)とすることができます。3次元ジオメトリを渡すと、Zを0とした2次元に強制され、この場合は無効と考えられます。二つ目の引数は2次元ポリゴンでなければなりません。

CGAL 2D Minkowskisumを利用して実装しています。

Availability: 2.1.0

説明このメソッドにはSFCGALバックエンドが必要です。

例

ラインストリングと円ポリゴンであって、ラインストリングがポリゴンを横切るミンコフスキー和

ミンコフスキー和を実行する前

ミンコフスキー和実行後

SELECT ST_MinkowskiSum(line, circle))
FROM (SELECT
    ST_MakeLine(ST_Point(10, 10),ST_Point(100, 100)) As line,
    ST_Buffer(ST_GeomFromText('POINT(50 50)'), 30) As circle) As foo;

-- wkt --
MULTIPOLYGON(((30 59.9999999999999,30.5764415879031 54.1472903395161,32.2836140246614 48.5194970290472,35.0559116309237 43.3328930094119,38.7867965644036 38.7867965644035,43.332893009412 35.0559116309236,48.5194970290474 32.2836140246614,54.1472903395162 30.5764415879031,60.0000000000001 30,65.8527096604839 30.5764415879031,71.4805029709527 32.2836140246614,76.6671069905881 35.0559116309237,81.2132034355964 38.7867965644036,171.213203435596 128.786796564404,174.944088369076 133.332893009412,177.716385975339 138.519497029047,179.423558412097 144.147290339516,180 150,179.423558412097 155.852709660484,177.716385975339 161.480502970953,174.944088369076 166.667106990588,171.213203435596 171.213203435596,166.667106990588 174.944088369076,
161.480502970953 177.716385975339,155.852709660484 179.423558412097,150 180,144.147290339516 179.423558412097,138.519497029047 177.716385975339,133.332893009412 174.944088369076,128.786796564403 171.213203435596,38.7867965644035 81.2132034355963,35.0559116309236 76.667106990588,32.2836140246614 71.4805029709526,30.5764415879031 65.8527096604838,30 59.9999999999999)))

ポリゴンとマルチポイントとのミンコフスキー和

ミンコフスキー和を実行する前

ミンコフスキー和実行後: 重複ポリゴンが生成されポイントの位置に移動

SELECT ST_MinkowskiSum(mp, poly)
FROM (SELECT 'MULTIPOINT(25 50,70 25)'::geometry As mp,
   'POLYGON((130 150, 20 40, 50 60, 125 100, 130 150))'::geometry As poly
    ) As foo

-- wkt --
MULTIPOLYGON(
    ((70 115,100 135,175 175,225 225,70 115)),
    ((120 65,150 85,225 125,275 175,120 65))
    )

Name

ST_OptimalAlphaShape — 「最適」アルファ値を使ってジオメトリを囲むアルファシェイプを計算します。

Synopsis

geometry ST_OptimalAlphaShape( | geom, |
| allow_holes = false, |
| nb_components = 1); |

geometry geom;
boolean allow_holes = false;
integer nb_components = 1;

説明

ジオメトリのポイントの「最適」のアルファシェイプを計算します。アルファシェイプは次に示す項目のようになるよう選択されたα値を使います:

ポリゴン要素数はnb_components以下になります (デフォルトは1です)

全ての入力ポイントはシェイプの中に含まれます

任意引数allow_holesにTRUEが設定されていない限りは、結果には穴が含まれません。

Availability: 3.3.0 - SFCGAL >= 1.4.1 が必要です。

説明このメソッドにはSFCGALバックエンドが必要です。

例

マルチポイントの最適アルファシェイプ (ST_AlphaShapeと同じ)

SELECT ST_AsText(ST_OptimalAlphaShape('MULTIPOINT((63 84),(76 88),(68 73),(53 18),(91 50),(81 70),
                (88 29),(24 82),(32 51),(37 23),(27 54),(84 19),(75 87),(44 42),(77 67),(90 30),(36 61),(32 65),
                (81 47),(88 58),(68 73),(49 95),(81 60),(87 50),
                (78 16),(79 21),(30 22),(78 43),(26 85),(48 34),(35 35),(36 40),(31 79),(83 29),(27 84),(52 98),(72 95),(85 71),
                (75 84),(75 77),(81 29),(77 73),(41 42),(83 72),(23 36),(89 53),(27 57),(57 97),(27 77),(39 88),(60 81),
                (80 72),(54 32),(55 26),(62 22),(70 20),(76 27),(84 35),(87 42),(82 54),(83 64),(69 86),(60 90),(50 86),(43 80),(36 73),
                (36 68),(40 75),(24 67),(23 60),(26 44),(28 33),(40 32),(43 19),(65 16),(73 16),(38 46),(31 59),(34 86),(45 90),(64 97))'::geometry));

POLYGON((89 53,91 50,87 42,90 30,88 29,84 19,78 16,73 16,65 16,53 18,43 19,37 23,30 22,28 33,23 36,
                26 44,27 54,23 60,24 67,27 77,24 82,26 85,34 86,39 88,45 90,49 95,52 98,57 97,64 97,72 95,76 88,75 84,75 77,83 72,85 71,83 64,88 58,89 53))

マルチポイントの最適アルファシェイプで穴を許す (ST_AlphaShapeと同じ)

SELECT ST_AsText(ST_OptimalAlphaShape('MULTIPOINT((63 84),(76 88),(68 73),(53 18),(91 50),(81 70),(88 29),(24 82),(32 51),(37 23),(27 54),(84 19),(75 87),(44 42),(77 67),(90 30),(36 61),(32 65),(81 47),(88 58),(68 73),(49 95),(81 60),(87 50),
                (78 16),(79 21),(30 22),(78 43),(26 85),(48 34),(35 35),(36 40),(31 79),(83 29),(27 84),(52 98),(72 95),(85 71),
                (75 84),(75 77),(81 29),(77 73),(41 42),(83 72),(23 36),(89 53),(27 57),(57 97),(27 77),(39 88),(60 81),
                (80 72),(54 32),(55 26),(62 22),(70 20),(76 27),(84 35),(87 42),(82 54),(83 64),(69 86),(60 90),(50 86),(43 80),(36 73),
                (36 68),(40 75),(24 67),(23 60),(26 44),(28 33),(40 32),(43 19),(65 16),(73 16),(38 46),(31 59),(34 86),(45 90),(64 97))'::geometry, allow_holes =
> true));

POLYGON((89 53,91 50,87 42,90 30,88 29,84 19,78 16,73 16,65 16,53 18,43 19,37 23,30 22,28 33,23 36,26 44,27 54,23 60,24 67,27 77,24 82,26 85,34 86,39 88,45 90,49 95,52 98,57 97,64 97,72 95,76 88,75 84,75 77,83 72,85 71,83 64,88 58,89 53),(36 61,36 68,40 75,43 80,50 86,60 81,68 73,77 67,81 60,82 54,81 47,78 43,81 29,76 27,70 20,62 22,55 26,54 32,48 34,44 42,38 46,36 61))

関連情報

ST_ConcaveHull, ST_AlphaShape

Name

ST_Orientation — サーフェスの方向を判定します。

Synopsis

integer ST_Orientation(
geom);

geometry geom;

説明

この関数はポリゴンのみ受け付けます。ポリゴンが反時計回りなら-1を返し、時計回りなら1を返します。

Availability: 2.1.0

説明このメソッドにはSFCGALバックエンドが必要です。

説明この関数は3次元に対応し、Z値を削除しません。

Name

ST_StraightSkeleton — ジオメトリからストレートスケルトンを計算します。

Synopsis

geometry ST_StraightSkeleton(
geom);

geometry geom;

説明

Availability: 2.1.0

説明このメソッドにはSFCGALバックエンドが必要です。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

SELECT ST_StraightSkeleton(ST_GeomFromText('POLYGON (( 190 190, 10 190, 10 10, 190 10, 190 20, 160 30, 60 30, 60 130, 190 140, 190 190 ))'));

元のポリゴン

ポリゴンのストレートスケルトン

Name

ST_Tesselate — ポリゴンまたは多面体サーフェスのテッセレーションを計算し、TINまたはTINコレクションを返します。

Synopsis

geometry ST_Tesselate(
geom);

geometry geom;

説明

(MULTI)POLYGONまたはPOLYHEDRALSURFACEのような面を入力に取り、三角形を使ったテッセレーション処理を通してTIN表現を返します。

Availability: 2.1.0

説明このメソッドにはSFCGALバックエンドが必要です。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

例

SELECT ST_GeomFromText('POLYHEDRALSURFACE Z( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
                ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
                ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
                ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )');

元の立方体

SELECT ST_Tesselate(ST_GeomFromText('POLYHEDRALSURFACE Z( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
        ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
        ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
        ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'));

ST_AsTextの出力:

TIN Z (((0 0 0,0 0 1,0 1 1,0 0 0)),((0 1 0,0 0 0,0 1 1,0 1 0)),
        ((0 0 0,0 1 0,1 1 0,0 0 0)),
        ((1 0 0,0 0 0,1 1 0,1 0 0)),((0 0 1,1 0 0,1 0 1,0 0 1)),
        ((0 0 1,0 0 0,1 0 0,0 0 1)),
        ((1 1 0,1 1 1,1 0 1,1 1 0)),((1 0 0,1 1 0,1 0 1,1 0 0)),
        ((0 1 0,0 1 1,1 1 1,0 1 0)),((1 1 0,0 1 0,1 1 1,1 1 0)),
        ((0 1 1,1 0 1,1 1 1,0 1 1)),((0 1 1,0 0 1,1 0 1,0 1 1)))

彩色した三角形によるテッセレーションを施した立方体

SELECT 'POLYGON (( 10 190, 10 70, 80 70, 80 130, 50 160, 120 160, 120 190, 10 190 ))'::geometry;

元のポリゴン

SELECT
        ST_Tesselate('POLYGON (( 10 190, 10 70, 80 70, 80 130, 50 160, 120 160, 120 190, 10 190 ))'::geometry);

ST_AsTextの出力:

TIN(((80 130,50 160,80 70,80 130)),((50 160,10 190,10 70,50 160)),
         ((80 70,50 160,10 70,80 70)),((120 160,120 190,50 160,120 160)),
 ((120 190,10 190,50 160,120 190)))

テッセレーションを施したポリゴン

関連情報

ST_ConstrainedDelaunayTriangles, ST_DelaunayTriangles

Name

ST_Volume — 3次元立体の体積を計算します。面ジオメトリは (閉じていても)0を返します。

Synopsis

float ST_Volume(
geom1);

geometry geom1;

説明

Availability: 2.2.0

説明このメソッドにはSFCGALバックエンドが必要です。

説明この関数は3次元に対応し、Z値を削除しません。

説明この関数は多面体サーフェスに対応しています。

説明この関数は三角形と不規則三角網 (TIN)に対応しています。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 9.1 (ST_3DVolumeと同じ)

例

WKTで閉じた面を生成した時、それは立体でなく面として扱われるます。立体にするにはST_MakeSolidを使います。面ジオメトリは堆積を持ちません。例を挙げます。

SELECT ST_Volume(geom) As cube_surface_vol,
        ST_Volume(ST_MakeSolid(geom)) As solid_surface_vol
  FROM (SELECT 'POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
    ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)),
    ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
    ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
    ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)),
    ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'::geometry) As f(geom);

 cube_surface_vol | solid_surface_vol
------------------+-------------------
                0 |                 1

関連情報

ST_3DArea, ST_MakeSolid, ST_IsSolid

ロングトランザクション機能

Abstract

これらの関数は、ロングトランザクション機能のために、行をロックする機構を実装しています。これらは主にWeb Feature Service仕様を実装する方のために提供されています。

Note

serializable transaction levelを使わなければなりません。さもなくばロック機構が壊れます。

Name

AddAuth — 現在のトランザクションで使用する認可トークンを追加します。

Synopsis

boolean AddAuth(
auth_token);

text auth_token;

説明

現在のトランザクションで使用する認可トークンを追加します。

現在のトランザクション識別子と認可トークンをtemp_lock_have_tableという一時テーブルに追加します。

Availability: 1.1.3

例

SELECT LockRow('towns', '353', 'priscilla');
                BEGIN TRANSACTION;
                        SELECT AddAuth('joey');
                        UPDATE towns SET geom = ST_Translate(geom,2,2) WHERE gid = 353;
                COMMIT;

                -- エラー --
                ERROR:  UPDATE where "gid" = '353' requires authorization 'priscilla'

関連情報

LockRow

Name

CheckAuth — 認可トークンを基に行の更新と削除とを禁止/許可するためにテーブル上にトリガを生成します。

Synopsis

integer CheckAuth( | a_schema_name, |
| a_table_name, |
| a_key_column_name); |

text a_schema_name;
text a_table_name;
text a_key_column_name;

integer CheckAuth( | a_table_name, |
| a_key_column_name); |

text a_table_name;
text a_key_column_name;

説明

認可トークンを基に行の更新と削除とを禁止/許可するためにテーブル上にトリガを生成します。<rowid_col>カラムを使って行を特定します。

a_schema_nameが渡されない場合には、現在のスキーマのテーブルを探索します。

Note

このテーブルに認証トリガが既に存在している場合には、エラーになります。

トランザクション機能が無い場合は、例外が投げられます。

Availability: 1.1.3

例

SELECT CheckAuth('public', 'towns', 'gid');
                        結果
                        ------
                        0

関連情報

EnableLongTransactions

Name

DisableLongTransactions — ロングトランザクション機能を無効にします。

Synopsis

text DisableLongTransactions(
);

;

説明

ロングトランザクション機能を無効にします。この関数によって、ロングトランザクション機能のためのメタデータテーブルが削除され、ロックチェックテーブルに付けられた全てのトリガが削除されます。

authorization_tableメタデータテーブル、authorized_tablesビュー、checkauthtriggerトリガの全てが削除されます。

Availability: 1.1.3

例

SELECT DisableLongTransactions();
-- 結果 --
Long transactions support disabled

関連情報

EnableLongTransactions

Name

EnableLongTransactions — ロングトランザクション機能を有効にします。

Synopsis

text EnableLongTransactions(
);

;

説明

ロングトランザクション機能を有効にします。この関数によって、必要なメタデータテーブルが生成されます。このセクションにある他の関数を呼ぶ前に、一度呼ぶ必要があります。二度呼んでも構いません。

authorization_tableメタデータテーブルauthorized_tablesビューが生成されます。

Availability: 1.1.3

例

SELECT EnableLongTransactions();
-- 結果 --
Long transactions support enabled

関連情報

DisableLongTransactions

Name

LockRow — テーブル内の行にロック/認可を設定します。

Synopsis

integer LockRow( | a_schema_name, |
| a_table_name, |
| a_row_key, |
| an_auth_token, |
| expire_dt); |

text a_schema_name;
text a_table_name;
text a_row_key;
text an_auth_token;
timestamp expire_dt;

integer LockRow( | a_table_name, |
| a_row_key, |
| an_auth_token, |
| expire_dt); |

text a_table_name;
text a_row_key;
text an_auth_token;
timestamp expire_dt;

integer LockRow( | a_table_name, |
| a_row_key, |
| an_auth_token); |

text a_table_name;
text a_row_key;
text an_auth_token;

説明

テーブル内の指定した行にロック/認可を設定します。an_auth_tokenはテキスト値です。expire_dtは now() + 1 時間をデフォルトとするタイムスタンプです。割り当てが行われたなら1が返り、他の場合 (例: 行が他の認可で既にロックされていた)には0が返ります。

Availability: 1.1.3

例

SELECT LockRow('public', 'towns', '2', 'joey');
LockRow
-------
1

-- Joeyは既にレコードをロックしていて
-- Priscillaはロックできなかっただけにラックが無かったと
SELECT LockRow('public', 'towns', '2', 'priscilla');
LockRow
-------
0

関連情報

UnlockRows

Name

UnlockRows — 認可トークンによって保持されているロックをすべて削除します。

Synopsis

integer UnlockRows(
auth_token);

text auth_token;

説明

指定した認証IDが保持するロックを全て削除します。解放されたロックの数が返されます。

Availability: 1.1.3

例

SELECT LockRow('towns', '353', 'priscilla');
                SELECT LockRow('towns', '2', 'priscilla');
                SELECT UnLockRows('priscilla');
                UnLockRows
                ------------
                2

関連情報

LockRow

バージョン関数

Abstract

これらの関数はPostGISのバージョンを報告したりアップグレードします。

Name

PostGIS_Extensions_Upgrade — PostGISエクステンション (例: postgis_raster, postgis_topology, postgis_sfcgal)について、指定したバージョンまたは最新版にパッケージ化し、アップグレードします。

Synopsis

text PostGIS_Extensions_Upgrade(
target_version=null);

text target_version=null;

説明

PostGISエクステンションについて、指定したバージョンまたは最新版にパッケージ化し、アップグレードします。データベースにインストールしたエクステンションだけがパッケージ化、アップグレードする必要があるなら、そのようにできます。完全なPostGISバージョンとビルド時のコンフィギュレーション情報とが後で報告されます。これは、PostGISエクステンションごとに、CREATE EXTENSION . FROMのパッケージの取消、ALTER EXTENSION ..とUPDATEとの複数回の実行の省略版です。現在はpostgis, postgis_raster, postgis_sfcgal, postgis_topology, postgis_tiger_geocoderだけのアップグレードを試みます。

Availability: 2.5.0

Note

Changed: 3.4.0 target_version引数が追加されました。

Changed: 3.3.0 どのPostGISのバージョンからでもアップグレードできるようになりました。ただし全てのシステムで動作するわけではありません。

Changed: 3.0.0 緩いエクステンションを再パッケージし、また、postgis_rasterに対応しました。

例

SELECT PostGIS_Extensions_Upgrade();

NOTICE:  Packaging extension postgis
NOTICE:  Packaging extension postgis_raster
NOTICE:  Packaging extension postgis_sfcgal
NOTICE:  Extension postgis_topology is not available or not packagable for some reason
NOTICE:  Extension postgis_tiger_geocoder is not available or not packagable for some reason

                    postgis_extensions_upgrade
-------------------------------------------------------------------
 Upgrade completed, run SELECT postgis_full_version(); for details
(1 row)

関連情報

the section called “空間データベースのアップグレード”, PostGIS_GEOS_Version, PostGIS_Lib_Version, PostGIS_LibXML_Version, PostGIS_PROJ_Version, PostGIS_Version

Name

PostGIS_Full_Version — 完全なPostGISのバージョン情報とコンフィギュレーション情報を報告します。

Synopsis

text PostGIS_Full_Version(
);

;

説明

完全なPostGISのバージョン情報とコンフィギュレーション情報を報告します。ライブラリとスクリプトとの間の同期について情報を提供して、必要に応じてアップグレードの提案に関する情報を提供します。

Enhanced: 3.4.0 現在、外部PROJ設定のNETWORK_ENABLED、URL_ENDPOINT、proj.db位置のDATABASE_PATHがあります

例

SELECT PostGIS_Full_Version();
                                                           postgis_full_version
----------------------------------------------------------------------------------
POSTGIS="3.4.0dev 3.3.0rc2-993-g61bdf43a7" [EXTENSION] PGSQL="160" GEOS="3.12.0dev-CAPI-1.18.0" SFCGAL="1.3.8" PROJ="7.2.1 NETWORK_ENABLED=OFF URL_ENDPOINT=https://cdn.proj.org USER_WRITABLE_DIRECTORY=/tmp/proj DATABASE_PATH=/usr/share/proj/proj.db" GDAL="GDAL 3.2.2, released 2021/03/05" LIBXML="2.9.10" LIBJSON="0.15" LIBPROTOBUF="1.3.3" WAGYU="0.5.0 (Internal)" TOPOLOGY RASTER
(1 row)

関連情報

the section called “空間データベースのアップグレード”, PostGIS_GEOS_Version, PostGIS_Lib_Version, PostGIS_LibXML_Version, PostGIS_PROJ_Version, PostGIS_Wagyu_Version, PostGIS_Version

Name

PostGIS_GEOS_Version — GEOSライブラリのバージョン番号を返します。

Synopsis

text PostGIS_GEOS_Version(
);

;

説明

GEOSライブラリのバージョン番号を返します。GEOS対応が有効でない場合はNULLを返します。

例

SELECT PostGIS_GEOS_Version();
 postgis_geos_version
----------------------
3.12.0dev-CAPI-1.18.0
(1 row)

関連情報

PostGIS_Full_Version, PostGIS_Lib_Version, PostGIS_LibXML_Version, PostGIS_PROJ_Version, PostGIS_Version

Name

PostGIS_GEOS_Compiled_Version — PostGISのビルドに使われたGEOSライブラリのバージョン番号を返します。

Synopsis

text PostGIS_GEOS_Compiled_Version(
);

;

説明

GEOSライブラリのバージョン番号、またはPostGISのビルドに使ったバージョン番号を返します。

Availability: 3.4.0

例

SELECT PostGIS_GEOS_Compiled_Version();
 postgis_geos_compiled_version
-------------------------------
 3.12.0
(1 row)

関連情報

PostGIS_GEOS_Version, PostGIS_Full_Version

Name

PostGIS_Liblwgeom_Version — liblwgeomライブラリのバージョン番号を返します。PostGISのバージョンと同じになるべきものです。

Synopsis

text PostGIS_Liblwgeom_Version(
);

;

説明

liblwgeomライブラリのバージョン番号を返します。

例

SELECT PostGIS_Liblwgeom_Version();
postgis_liblwgeom_version
--------------------------
3.4.0dev 3.3.0rc2-993-g61bdf43a7
(1 row)

関連情報

PostGIS_Full_Version, PostGIS_Lib_Version, PostGIS_LibXML_Version, PostGIS_PROJ_Version, PostGIS_Version

Name

PostGIS_LibXML_Version — LibXML2ライブラリのバージョン番号を返します。

Synopsis

text PostGIS_LibXML_Version(
);

;

説明

LibXML2ライブラリのバージョン番号を返します。

Availability: 1.5

例

SELECT PostGIS_LibXML_Version();
 postgis_libxml_version
----------------------
 2.9.10
(1 row)

関連情報

PostGIS_Full_Version, PostGIS_Lib_Version, PostGIS_PROJ_Version, PostGIS_GEOS_Version, PostGIS_Version

Name

PostGIS_Lib_Build_Date — PostGISライブラリのビルド日付を返します。

Synopsis

text PostGIS_Lib_Build_Date(
);

;

説明

PostGISライブラリのビルド日付を返します。

例

SELECT PostGIS_Lib_Build_Date();
 postgis_lib_build_date
------------------------
 2023-06-22 03:56:11
(1 row)

Name

PostGIS_Lib_Version — PostGISのバージョン番号を返します。

Synopsis

text PostGIS_Lib_Version(
);

;

説明

PostGISのバージョン番号を返します。

例

SELECT PostGIS_Lib_Version();
 postgis_lib_version
---------------------
 3.4.0dev
(1 row)

関連情報

PostGIS_Full_Version, PostGIS_GEOS_Version, PostGIS_LibXML_Version, PostGIS_PROJ_Version, PostGIS_Version

Name

PostGIS_PROJ_Version — PROJ4のバージョン番号を返します。

Synopsis

text PostGIS_PROJ_Version(
);

;

説明

PROJライブラリのバージョン番号とProjの設定オプションを返します。

Enhanced: 3.4.0 現在、NETWORK_ENABLED、URL_ENDPOINT、proj.db位置のDATABASE_PATHがあります

例

SELECT PostGIS_PROJ_Version();
  postgis_proj_version
-------------------------
7.2.1 NETWORK_ENABLED=OFF URL_ENDPOINT=https://cdn.proj.org USER_WRITABLE_DIRECTORY=/tmp/proj DATABASE_PATH=/usr/share/proj/proj.db
(1 row)

関連情報

PostGIS_Full_Version, PostGIS_GEOS_Version, PostGIS_Lib_Version, PostGIS_LibXML_Version, PostGIS_Version

Name

PostGIS_Wagyu_Version — 内部のWagyuライブラリのバージョン番号を返します。

Synopsis

text PostGIS_Wagyu_Version(
);

;

説明

内部のWagyuライブラリのバージョン番号を返します。Wagyu対応が有効でない場合にはNULLを返します。

例

SELECT PostGIS_Wagyu_Version();
 postgis_wagyu_version
-----------------------
 0.5.0 (Internal)
(1 row)

関連情報

PostGIS_Full_Version, PostGIS_GEOS_Version, PostGIS_PROJ_Version, PostGIS_Lib_Version, PostGIS_LibXML_Version, PostGIS_Version

Name

PostGIS_Scripts_Build_Date — PostGISスクリプトのビルド日付を返します。

Synopsis

text PostGIS_Scripts_Build_Date(
);

;

説明

PostGISスクリプトのビルド日付を返します。

Availability: 1.0.0RC1

例

SELECT PostGIS_Scripts_Build_Date();
  postgis_scripts_build_date
-------------------------
 2023-06-22 03:56:11
(1 row)

関連情報

PostGIS_Full_Version, PostGIS_GEOS_Version, PostGIS_Lib_Version, PostGIS_LibXML_Version, PostGIS_Version

Name

PostGIS_Scripts_Installed — このデータベースにインストールしたPostGISスクリプトのバージョンを返します。

Synopsis

text PostGIS_Scripts_Installed(
);

;

説明

このデータベースにインストールしたPostGISスクリプトのバージョンを返します。

Note

この関数の出力とPostGIS_Scripts_Releasedとが合わない場合、既存のデータベースの確実なアップグレードに失敗しているかも知れません。詳細情報についてはUpgradingをご覧ください。

Availability: 0.9.0

例

SELECT PostGIS_Scripts_Installed();
  postgis_scripts_installed
-------------------------
 3.4.0dev 3.3.0rc2-993-g61bdf43a7
(1 row)

関連情報

PostGIS_Full_Version, PostGIS_Scripts_Released, PostGIS_Version

Name

PostGIS_Scripts_Released — インストールしたPostGISライブラリとともにリリースされたpostgis.sqlスクリプトのバージョン番号を返します。

Synopsis

text PostGIS_Scripts_Released(
);

;

説明

インストールしたPostGISライブラリとともにリリースされたpostgis.sqlスクリプトのバージョン番号を返します。

Note

1.1.0からこの関数はPostGIS_Lib_Versionと同じ値を返すようになりました。後方互換のためです。

Availability: 0.9.0

例

SELECT PostGIS_Scripts_Released();
  postgis_scripts_released
-------------------------
 3.4.0dev 3.3.0rc2-993-g61bdf43a7
(1 row)

関連情報

PostGIS_Full_Version, PostGIS_Scripts_Installed, PostGIS_Lib_Version

Name

PostGIS_Version — PostGISバージョン番号とコンパイルオプションを返します。

Synopsis

text PostGIS_Version(
);

;

説明

PostGISバージョン番号とコンパイルオプションを返します。

例

SELECT PostGIS_Version();
                        postgis_version
---------------------------------------
 3.4 USE_GEOS=1 USE_PROJ=1 USE_STATS=1
(1 row)

関連情報

PostGIS_Full_Version, PostGIS_GEOS_Version, PostGIS_Lib_Version, PostGIS_LibXML_Version, PostGIS_PROJ_Version

Grand Unified Custom変数 (GUC)

Abstract

本節では、PostGIS GUC (Grand Unified Custom)変数の一覧を上げます。これらは、グローバル、データベースごと、セッションごと、またはトランザクションごとに設定できます。グローバルまたはデータベースごとの設定が最善です。

Name

postgis.backend — GEOSとSFCGALで重複する関数を提供するバックエンドです。GEOSまたはSFCGALを選択します。デフォルトはGEOSです。

説明

このGUCはSFCGALサポートでPostGISをコンパイルした場合にのみ適切なものとなります。デフォルトでは、geosバックエンドはGEOSとSFCGALが同じ名前の関数を持つ関数で使われます。この変数によって、SFCGALをリクエストを提供するバックエンドにすることができます。

Availability: 2.1.0

例

バックエンドを接続時にだけ設定します。

set postgis.backend = sfcgal;

データベースへの新規接続にバックエンドを設定します。

ALTER DATABASE mygisdb SET postgis.backend = sfcgal;

関連情報

the section called “SFCGAL関数”

Name

postgis.gdal_datapath — GDALのGDAL_DATAオプションの値を設定するためのコンフィギュレーションオプションです。設定しない場合には、GDAL_DATA環境変数が使われます。

説明

GDALのGDAL_DATAオプションの値の設定に使うPostgreSQL GUC変数です。postgis.gdal_datapath値は完全にGDALのデータファイルへの物理的なパスになるべきものです。

コンフィギュレーションオプションは、GDALのデータファイルパスがハードコーディングされていないWindowsプラットフォームのためにほとんど使われます。このオプションは、GDALのデータファイルがGDALの期待されているパスに無いときに設定します。

Note

このオプションは、PostgreSQLのコンフィギュレーションファイルpostgresql.confで設定できます。コネクションまたはトランザクションでも設定できます。

Availability: 2.2.0

Note

GDAL_DATAに関する追加情報報は、GDALのConfiguration Optionsにあります。

例

postgis.gdal_datapathの設定とリセット。

SET postgis.gdal_datapath TO '/usr/local/share/gdal.hidden';
SET postgis.gdal_datapath TO default;

Windows上における特定のデータベース上で設定する場合は次の通りです。

ALTER DATABASE gisdb
SET postgis.gdal_datapath = 'C:/Program Files/PostgreSQL/9.3/gdal-data';

関連情報

PostGIS_GDAL_Version, ST_Transform

Name

postgis.gdal_enabled_drivers — PostGIS環境でGDALドライバを有効にするコンフィギュレーションオプションです。GDALコンフィギュレーション変数GDAL_SKIPに影響を与えます。

説明

PostGIS環境でGDALドライバを有効にするコンフィギュレーションオプションです。GDALコンフィギュレーション変数GDAL_SKIPに影響を与えます。このオプションは、PostgreSQLのコンフィギュレーションファイルpostgresql.confで設定できます。コネクションまたはトランザクションでも設定できます。

postgis.gdal_enabled_driversの初期値は、PostgreSQL開始プロセスに渡される、有効とするドライバの一覧からなる環境変数POSTGIS_GDAL_ENABLED_DRIVERSによって設定されます。

有効にするGDALドライバは、ドライバの短縮名またはコードで指定します。ドライバの短縮名またはコードはGDAL Raster Formatsにあります。複数のドライバを指定するには、ドライバの間に一つの空白を置きます。

Note

postgis.gdal_enabled_driversには三つの特別なコードがあります。大文字小文字を区別します。

DISABLE_ALL 全てのGDALドライバを無効にします。DISABLE_ALLはpostgis.gdal_enabled_driversにある他の全ての値を上書きします。

ENABLE_ALL 全てのGDALドライバを有効にします。

VSICURL GDALの仮想ファイルシステム/vsicurl/を有効にします。

postgis.gdal_enabled_driversがDISABLE_ALLにっていされると、データベース外ラスタ, ST_FromGDALRaster(), ST_AsGDALRaster(), ST_AsTIFF(), ST_AsJPEG(), ST_AsPNG()を使おうとすると、エラーメッセージが返されます。

Note

標準的なPostGISのインストールでは、 postgis.gdal_enabled_driversはDISALBE_ALLに設定されます。

Note

GDAL_SKIPに関する追加情報は、GDALのConfiguration Optionsにあります。

Availability: 2.2.0

例

postgis.gdal_enabled_driversの設定とリセット。

データベースへの新規接続にバックエンドを設定します。

ALTER DATABASE mygisdb SET postgis.gdal_enabled_drivers TO 'GTiff PNG JPEG';

サーバへの全ての新規接続のための、有効なドライバのデフォルトを設定します。スーパーユーザ権限とPostgreSQL 9.4以上が必要です。データベース設定、セッション設定、ユーザ設定によって上書きされます。

ALTER SYSTEM SET postgis.gdal_enabled_drivers TO 'GTiff PNG JPEG';
SELECT pg_reload_conf();

SET postgis.gdal_enabled_drivers TO 'GTiff PNG JPEG';
SET postgis.gdal_enabled_drivers = default;

全てのGDALドライバを有効にします。

SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';

全てのGDALドライバを無効にします。

SET postgis.gdal_enabled_drivers = 'DISABLE_ALL';

関連情報

ST_FromGDALRaster, ST_AsGDALRaster, ST_AsTIFF, ST_AsPNG, ST_AsJPEG, postgis.enable_outdb_rasters

Name

postgis.enable_outdb_rasters — データベース外ラスタのバンドにアクセスできるようにする、真偽型のコンフィギュレーションオプション。

説明

データベース外ラスタのバンドにアクセスできるようにする、真偽型のコンフィギュレーションオプションです。このオプションは、PostgreSQLのコンフィギュレーションファイルpostgresql.confで設定できます。コネクションまたはトランザクションでも設定できます。

postgis.enable_outdb_rastersの初期値は、環境変数POSTGIS_ENABLE_OUTDB_RASTERSが0でない値で、PostgreSQL開始プロセスに渡されることでで設定されます。

Note

postgis.enable_outdb_rastersがTRUEであってでも、GUC postgis.gdal_enabled_driversは、アクセス可能なラスタ書式を判定します。

Note

標準的なPostGISのインストールでは、postgis.enable_outdb_rastersはFALSEに設定されています。

Availability: 2.2.0

例

現在のセッションでのpostgis.enable_outdb_rastersの設定とリセット。

SET postgis.enable_outdb_rasters TO True;
SET postgis.enable_outdb_rasters = default;
SET postgis.enable_outdb_rasters = True;
SET postgis.enable_outdb_rasters = False;

特定のデータベースに対する設定

ALTER DATABASE gisdb SET postgis.enable_outdb_rasters = true;

データベースクラスタ全体の設定。変更を有効にするには、データベースに再接続する必要があります。

-- postgres.auto.confへの書き込み
ALTER SYSTEM postgis.enable_outdb_rasters = true;
 --postgres confの再読み込み
SELECT pg_reload_conf();

関連情報

postgis.gdal_enabled_drivers postgis.gdal_config_options

Name

postgis.gdal_config_options — データベース外ラスタを操作する時に使用するオプションを設定するためのコンフィギュレーション。

説明

データベース外ラスタを操作する時に使用するオプションを設定するためのコンフィギュレーション。Configuration optionsによって、どれだけGDALがローカルデータキャッシュを確保するか、オーバビューを読むかどうか、リモートのデータベース外データソースを使う際のアクセスキー等を制御します。

Availability: 3.2.0

例

現在のセッションでのpostgis.gdal_vsi_optionsの設定:

SET postgis.gdal_config_options = 'AWS_ACCESS_KEY_ID=xxxxxxxxxxxxxxx AWS_SECRET_ACCESS_KEY=yyyyyyyyyyyyyyyyyyyyyyyyyy';

LOCALキーワードを使う現在のトランザクションのためのpostgis.gdal_vsi_optionsの設定:

SET LOCAL postgis.gdal_config_options = 'AWS_ACCESS_KEY_ID=xxxxxxxxxxxxxxx AWS_SECRET_ACCESS_KEY=yyyyyyyyyyyyyyyyyyyyyyyyyy';

関連情報

postgis.enable_outdb_rasters postgis.gdal_enabled_drivers

トラブルシューティング関数

Abstract

これらの関数はトラブルシューティングとジオメトリデータの修復を行うためのものです。ジオメトリデータが、通常の環境では発生しえない出来事によって破損している場合のみ有効です。

Name

PostGIS_AddBBox — ジオメトリにバウンディングボックスを追加します。

Synopsis

geometry PostGIS_AddBBox(
geomA);

geometry geomA;

説明

ジオメトリにバウンディングボックスを追加します。これにより、バウンディングボックスに基づく検索が早くなりますが、ジオメトリのサイズが大きくなります。

Note

バウンディングボックスは自動的にジオメトリに追加されるので、通常はこの関数は不要ですが、生成されたバウンディングボックスが何らかの理由で破損するか、バウンディングボックスを欠く古い版をインストールしている場合に使われます。古いものを削除し、再追加する必要があります。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

UPDATE sometable
 SET geom =  PostGIS_AddBBox(geom)
 WHERE PostGIS_HasBBox(geom) = false;

関連情報

PostGIS_DropBBox, PostGIS_HasBBox

Name

PostGIS_DropBBox — ジオメトリからバウンディングボックスのキャッシュを削除します。

Synopsis

geometry PostGIS_DropBBox(
geomA);

geometry geomA;

説明

ジオメトリからバウンディングボックスのキャッシュを削除します。これによりジオメトリのサイズは小さくなりますが、バウンディングボックスを基にした検索が遅くなります。破損したバウンディングボックスを削除する際にも使われます。ST_Intersectsや他の関係関数がジオメトリを正しくtrueを返すべきジオメトリを無視すると、それが、バウンディングボックスのキャッシュが破損したことを示す合図です。

Note

バウンディングボックスは自動的にジオメトリに追加されるので、通常はこの関数は不要ですが、生成されたバウンディングボックスが何らかの理由で破損するか、バウンディングボックスを欠く古い版をインストールしている場合に使われます。古いものを削除し、再追加する必要があります。この種類の破損は8.3-8.3.6で観察されました。ジオメトリが変更された際に常にキャッシュされたバウンディングボックスが再計算されておらず、ダンプと再読み込みを行わずに新しい版へのアップグレードを行うと、既に破損したバウンディングボックスが訂正されないためです。次に示すように手動で収集してバウンディングボックスを再追加するか、ダンプとリロードを使います。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

-- これは、バウンディングボックスのキャッシュが正しくないときに
-- バウンディングボックスを削除する例です。
-- Box2Dの適用でバウンディングボックスの再計算が強制される前に
-- ST_AsBinaryを実行して、
-- ジオメトリテーブルに適用されたBox2Dが
-- 常にバウンディングボックスのキャッシュを返すようにします。
                        UPDATE sometable
 SET geom =  PostGIS_DropBBox(geom)
 WHERE Not (Box2D(ST_AsBinary(geom)) = Box2D(geom));

        UPDATE sometable
 SET geom =  PostGIS_AddBBox(geom)
 WHERE Not PostGIS_HasBBOX(geom);

関連情報

PostGIS_AddBBox, PostGIS_HasBBox, Box2D

Name

PostGIS_HasBBox — ジオメトリのバウンディングボックスがキャッシュされている場合にはTRUEを返し、他の場合にはFALSEを返します。

Synopsis

boolean PostGIS_HasBBox(
geomA);

geometry geomA;

説明

ジオメトリのバウンディングボックスがキャッシュされている場合にはTRUEを返し、他の場合にはFALSEを返します。PostGIS_AddBBoxとPostGIS_DropBBoxでバウンディングボックスのキャッシュを制御します。

説明このメソッドは曲線ストリングと曲線に対応しています。

例

SELECT geom
FROM sometable WHERE PostGIS_HasBBox(geom) = false;

関連情報

PostGIS_AddBBox, PostGIS_DropBBox

Chapter 8. トポロジ

PostGISトポロジ型と関数は、フェイス、エッジ、ノード等のトロポジオブジェクトを管理するために使います。

PostGIS Day Paris 2011におけるSandro Santilliさんの講演が、PostGISトポロジの概略説明として良いです。Topology with PostGIS 2.0 slide deckにあります。

Vincent Picavetさんはトポロジとは何か、どのように使われるか、および、対応するFOSS4Gツールに関する良い概略説明を PostGIS Topology PGConf EU 2012で出しています。

トポロジベースのGISデータベースの例としてUS Census Topologically Integrated Geographic Encoding and Referencing System (TIGER)があります。PostGISトポロジの試験がしたくて、何らかのデータが必要ならTopology_Load_Tigerをご覧下さい。

PostGISトポロジモジュールは前の版にもありましたが、正式なPostGIS文書の中には入れていませんでした。PostGIS 2.0.0 では、全ての非推奨関数を無くし、知られていた使いやすさの問題を解決し、機能と関数の文書をより良くし、新しい関数を追加し、SQL-MM標準により準拠させるために、大整理を行っています。

このプロジェクトの詳細情報はPostGIS Topology Wikiにあります。

このモジュールに関する全ての関数とテーブルは、topologyスキーマにインストールされます。

SQL/MM標準で定義される関数はST_プリフィクスを持ち、PostGIS特有の関数はこのプリフィクスを持ちません。

PostGIS 2.0以降では、トポロジ機能はデフォルトでビルドされます。Chapter 2, PostGISインストールで説明されている通り、ビルド時のコンフィギュアオプション --without-topology を指定することで、無効にできます。

トポロジ型

Abstract

本節では、PostGISトポロジでインストールされるPostgreSQLデータ型の一覧を挙げます。独自に関数をデザインする際に特に重要となる、キャストでの挙動を記述していることにご注意ください。

トポロジドメイン

Abstract

本節では、PostGISトポロジでインストールされるPostgreSQLドメインの一覧を挙げます。ドメインは、オブジェクト型のように扱え、関数やテーブルカラムのオブジェクトを返します。ドメインは存在するチェック制約を持つ既存の型である点で、型とは違います。

Name

TopoElement — 二つの整数の配列で、通常TopoGeometry要素を識別するために使われます。

説明

二つの整数の配列で、単純または階層を持つTopoGeometryの一つのコンポーネントを表現するために使われます。

単純なTopoGeometryの場合は、配列の最初の要素がトポロジのプリミティブの識別を表現し、二つ目の要素がタイプ (1:ノード 2:エッジ, 3:フェイス)を表現します。階層的なTopoGeometryの場合は、一つ目の要素が子のTopoGeometryの識別子を表現し、二つ目の要素はレイヤ識別子を表現します。

Note

階層的なTopoGeometryについては、全ての子のTopoGeometry要素は同じ子レイヤから来ます。子レイヤは、定義されたTopoGeometryのレイヤのtopology.layerレコード内で指定されます。

例

SELECT te[1] AS id, te[2] AS type FROM
( SELECT ARRAY[1,2]::topology.topoelement AS te ) f;
 id | type
----+------
  1 |    2

SELECT ARRAY[1,2]::topology.topoelement;
  te
-------
 {1,2}

-- 3要素配列をtopoelementに使った際に発生するエラーの例
-- ご注意: topoelementは、必ず2要素を持ちます。次元チェックにひっかかります。
SELECT ARRAY[1,2,3]::topology.topoelement;
ERROR:  value for domain topology.topoelement violates check constraint "dimensions"

関連情報

GetTopoGeomElements, TopoElementArray, TopoGeometry, TopoGeom_addElement, TopoGeom_remElement

Name

TopoElementArray — TopoElementオブジェクトの配列。

説明

1以上のTopoElementオブジェクトの配列で、通常はTopoGeometryオブジェクトのコンポーネントを分配するために使われます。

例

SELECT '{{1,2},{4,3}}'::topology.topoelementarray As tea;
  tea
-------
{{1,2},{4,3}}

-- より長く書いた等価なもの --
SELECT ARRAY[ARRAY[1,2], ARRAY[4,3]]::topology.topoelementarray As tea;

  tea
-------
{{1,2},{4,3}}

-- トポロジに同梱されている配列集約関数 --
SELECT topology.TopoElementArray_Agg(ARRAY[e,t]) As tea
  FROM generate_series(1,4) As e CROSS JOIN generate_series(1,3) As t;
  tea
--------------------------------------------------------------------------
{{1,1},{1,2},{1,3},{2,1},{2,2},{2,3},{3,1},{3,2},{3,3},{4,1},{4,2},{4,3}}

SELECT '{{1,2,4},{3,4,5}}'::topology.topoelementarray As tea;
ERROR:  value for domain topology.topoelementarray violates check constraint "dimensions"

関連情報

TopoElement, GetTopoGeomElementArray, TopoElementArray_Agg

トポロジ管理とTopoGeometry管理

Abstract

本節では、新しいトポロジスキーマの構築、トポロジの評価、TopoGeometryカラムの管理のためのトポロジ関数の一覧を挙げます。

Name

AddTopoGeometryColumn — 既存のテーブルにTopoGeometryカラムを追加し、topology.layer内に新しいレイヤとして新しいカラムを登録して、新しい layer_id を返します。

Synopsis

integer AddTopoGeometryColumn( | topology_name, |
| schema_name, |
| table_name, |
| column_name, |
| feature_type); |

varchar topology_name;
varchar schema_name;
varchar table_name;
varchar column_name;
varchar feature_type;

integer AddTopoGeometryColumn( | topology_name, |
| schema_name, |
| table_name, |
| column_name, |
| feature_type, |
| child_layer); |

varchar topology_name;
varchar schema_name;
varchar table_name;
varchar column_name;
varchar feature_type;
integer child_layer;

説明

それぞれのTopoGeometryオブジェクトは、特定のトポロジの特定のレイヤに属します。TopoGeometryオブジェクト生成の前に、トポロジレイヤの生成が必要です。トポロジレイヤは地物テーブルとトポロジとで組織されます。また、タイプと階層の情報を持ちます。レイヤの生成にはAddTopoGeometryColumn()を使います。

この関数は、リクエストされたカラムをテーブルに追加し、topology.layerテーブルに、与えられた全ての情報のレコードを追加します。

[child_layer]を指定しない (またはNULLを指定する)場合、このレイヤは、基本的なTopoGeometry (プリミティブなトポロジ要素で構成)を含みます。指定する場合、このレイヤは階層的なTopoGeometry (child_layerからのTopoGeometryで構成)を持ちます。

レイヤが生成される (これの識別番号は、AddTopoGeometryColumn関数が返します)と、TopoGeometryオブジェクトをこの中に構築する準備ができます。

妥当なfeature_type: POINT, MULTIPOINT, LINE, MULTILINE, POLYGON, MULTIPOLYGON, COLLECTION

Availability: 1.1

例

-- この例では、topology_nameとshecma_nameが異なる場合には、
-- 異なるスキーマに作ることができましたが、
-- ma_topoスキーマに新しいテーブルを作ったことに注意して下さい。

CREATE SCHEMA ma;
CREATE TABLE ma.parcels(gid serial, parcel_id varchar(20) PRIMARY KEY, address text);
SELECT topology.AddTopoGeometryColumn('ma_topo', 'ma', 'parcels', 'topo', 'POLYGON');

CREATE SCHEMA ri;
CREATE TABLE ri.roads(gid serial PRIMARY KEY, road_name text);
SELECT topology.AddTopoGeometryColumn('ri_topo', 'ri', 'roads', 'topo', 'LINE');

関連情報

DropTopoGeometryColumn, toTopoGeom, CreateTopology, CreateTopoGeom

Name

RenameTopoGeometryColumn — TopoGeometryカラムの名前を変更します

Synopsis

topology.layer RenameTopoGeometryColumn( | layer_table, |
| feature_column, |
| new_name); |

regclass layer_table;
name feature_column;
name new_name;

説明

この関数は存在するTopoGeometryカラムの名前を変更します。この際、メタデータ情報が適切に更新されるようにします。

Availability: 3.4.0

例

SELECT topology.RenameTopoGeometryColumn('public.parcels', 'topogeom', 'tgeom');

関連情報

AddTopoGeometryColumn, RenameTopology

Name

DropTopology — 使用上の注意: この関数によって、トポロジスキーマが削除され、topology.topologyテーブルからの参照が削除され、geometry_columnsテーブルから削除対象スキーマ内のテーブルへの参照が削除されます。

Synopsis

integer DropTopology(
topology_schema_name);

varchar topology_schema_name;

説明

トポロジスキーマを削除し、topology.topologyテーブルからの参照を削除し、geometry_columnsテーブルから削除対象スキーマ内のテーブルへの参照を削除します。この関数は *十分に注意してご使用下さい*。残しておきたかったデータが破壊される可能性があります。スキーマが存在しない場合、スキーマへの参照に関するエントリの削除だけを行います。

Availability: 1.1

例

ma_topoスキーマをカスケード削除し、topology.topologyにある参照のうち関係するものを全て削除します。

SELECT topology.DropTopology('ma_topo');

関連情報

DropTopoGeometryColumn

Name

RenameTopology — トポロジ名を変更します

Synopsis

varchar RenameTopology( | old_name, |
| new_name); |

varchar old_name;
varchar new_name;

説明

トポロジスキーマの名前を変更し、topology.topologyテーブルに格納されているメタデータを更新します。

Availability: 3.4.0

例

topo_stageからtopo_prodにトポロジ名を変更します。

SELECT topology.RenameTopology('topo_stage', 'topo_prod');

関連情報

CopyTopology, RenameTopoGeometryColumn

Name

DropTopoGeometryColumn — schema_nameで指定されたスキーマ内にあるtable_nameで指定されたテーブルからTopoGeometryカラムを削除し、topology.layerテーブルにある登録を解除します。

Synopsis

text DropTopoGeometryColumn( | schema_name, |
| table_name, |
| column_name); |

varchar schema_name;
varchar table_name;
varchar column_name;

説明

schema_nameで指定されたスキーマ内にあるtable_nameで指定されたテーブルからTopoGeometryカラムを削除し、topology.layerテーブルにある登録を解除します。削除の概要報告を返します。ご注意: この関数は、参照整合性チェックをすり抜けるために、まずNULL値に上書きしてから削除します。

Availability: 1.1

例

SELECT topology.DropTopoGeometryColumn('ma_topo', 'parcel_topo', 'topo');

関連情報

AddTopoGeometryColumn

Name

Populate_Topology_Layer — テーブルからメタデータを読み、topology.layerテーブルに不足しているものを追加します。

Synopsis

setof record Populate_Topology_Layer(
);

;

説明

テーブルの制約を読み、topology.layerテーブルに不足しているものを追加します。トポロジデータをスキーマに格納した後に、トポロジカタログで抜けているものを訂正するのに使います。

生成されたもののリストを返します。返されるカラムは schema_name, table_name, feature_columnです。

Availability: 2.3.0

例

SELECT CreateTopology('strk_topo');
CREATE SCHEMA strk;
CREATE TABLE strk.parcels(gid serial, parcel_id varchar(20) PRIMARY KEY, address text);
SELECT topology.AddTopoGeometryColumn('strk_topo', 'strk', 'parcels', 'topo', 'POLYGON');
-- この地物はすでに登録されているので返されるレコードはありません
SELECT *
  FROM topology.Populate_Topology_Layer();

-- 再構築してみます
TRUNCATE TABLE topology.layer;

SELECT *
  FROM topology.Populate_Topology_Layer();

SELECT topology_id,layer_id, schema_name As sn, table_name As tn, feature_column As fc
FROM topology.layer;

schema_name | table_name | feature_column
-------------+------------+----------------
 strk        | parcels    | topo
(1 row)

 topology_id | layer_id |  sn  |   tn    |  fc
-------------+----------+------+---------+------
           2 |        2 | strk | parcels | topo
(1 row)

関連情報

AddTopoGeometryColumn

Name

TopologySummary — トポロジ名を取り、トポロジ内のオブジェクトの型に関する概要の全体を提供します。

Synopsis

text TopologySummary(
topology_schema_name);

varchar topology_schema_name;

説明

トポロジ名を取り、トポロジ内のオブジェクトの型に関する概要の全体を提供します。

Availability: 2.0.0

例

SELECT topology.topologysummary('city_data');
                    topologysummary
--------------------------------------------------------
 Topology city_data (329), SRID 4326, precision: 0
 22 nodes, 24 edges, 10 faces, 29 topogeoms in 5 layers
 Layer 1, type Polygonal (3), 9 topogeoms
  Deploy: features.land_parcels.feature
 Layer 2, type Puntal (1), 8 topogeoms
  Deploy: features.traffic_signs.feature
 Layer 3, type Lineal (2), 8 topogeoms
  Deploy: features.city_streets.feature
 Layer 4, type Polygonal (3), 3 topogeoms
  Hierarchy level 1, child layer 1
  Deploy: features.big_parcels.feature
 Layer 5, type Puntal (1), 1 topogeoms
  Hierarchy level 1, child layer 2
  Deploy: features.big_signs.feature

関連情報

Topology_Load_Tiger

Name

ValidateTopology — トポロジの問題についての詳細を示すvalidatetopology_returntypeの集合を返します。

Synopsis

setof validatetopology_returntype ValidateTopology( | toponame, |
| bbox); |

varchar toponame;
geometry bbox;

説明

トポロジの問題の詳細説明に関するvalidatetopology_returntypeオブジェクトを返します。任意にbboxパラメータで指定された範囲に確認を制限します。

エラーの一覧を示します。可能性のある、意味することろ、返されるid表現は次の通りです:

Error | id1 | id2 | 意味
coincident nodes (訳注: 重複ノード) | 最初のノードの識別子。 | 2番目のノードの識別子。 | 二つのノードは同じジオメトリを持ちます。
edge crosses node (訳注: エッジとノードのクロス) | エッジの識別子。 | ノードの識別子。 | エッジが内部にノードを持っています。ST_Relateを参照して下さい。
invalid edge (訳注: 不正なエッジ) | エッジの識別子。 |  | エッジジオメトリが不正です。ST_IsValidをご覧下さい。
edge not simple (訳注: 単純でないエッジ) | エッジの識別子。 |  | エッジジオメトリが自己交差しています。ST_IsSimpleを参照して下さい。
edge crosses edge (訳注: エッジとエッジのクロス) | 最初のエッジの識別子。 | 2番目のエッジの識別子。 | 二つのエッジが内部でインタセクトしています。ST_Relateをご覧下さい。
edge start node geometry mis-match (訳注: 開始ノードジオメトリの不整合) | エッジの識別子。 | 示された開始ノードの識別子。 | エッジの開始ノードとして示されたノードのジオメトリが、エッジジオメトリの最初のポイントと合致しません。ST_StartPointを参照して下さい。
edge end node geometry mis-match (訳注: 終了ノードジオメトリの不整合) | エッジの識別子。 | 示された終了ノードの識別子。 | エッジの終了ノードとして示されたノードのジオメトリがエッジジオメトリの最後のポイントと合致しません。ST_EndPointを参照して下さい。
face without edges (訳注: エッジのないフェイス) | 取り残されたフェイスの識別子。 |  | 既存のフェイスを左右いずれかの側に (left_face, right_faceとして)持つエッジが存在しません。
face has no rings (訳注: 環のないフェイス) | 部分的に定義されたフェイスの識別子。 |  | 環を形成しない側のフェイスを示すエッジ。
face has wrong mbr (訳注: 誤ったバウンディングボックスを持ったフェイス) | 不正なMBRキャッシュを持つフェイスの識別子。 |  | フェイスの最小バウンディング四角形が、サイド上のフェイスを示すエッジのコレクションの最小バウンディングボックスと合致しません。
hole not in advertised face (訳注: 穴がフェイス内に存在しない) | リングを識別する符号付きのエッジ識別子。GetRingEdgesを参照して下さい。 |  | エッジの環が、外環のフェイスが異なるフェイスに含まれているフェイスを示します。
not-isolated node has not- containing_face (訳注: 非孤立ノードが非孤立フェイスを持っています) | はっきりしないノードの識別子。 |  | 一つ以上のエッジの境界上にあると示された一つのノードが、そのノードを含んでいるフェイスを示しています。
isolated node has containing_face (訳注: 孤立ノードがcontaining_faceを持っています) | はっきりしないノードの識別子。 |  | どのエッジの境界上にもないと報告されるノードが、それを含むフェイスが無いことを示しています。
isolated node has wrong containing_face (訳注: この孤立ノードを含んでいるフェイスが不正) | 不正確なノードの識別子。 |  | どのエッジの境界上にもないと報告されるノードが、そのノードを実際に含むフェイスではないフェイスに含まれていることを示しています。GetFaceContainingPointを参照して下さい。
invalid next_right_edge (訳注: 不正なnext_right_edge) | 不正確なエッジの識別子。 | 符号付き識別子で次の右エッジを示します。 | エッジの右側を進んで遭遇する次のエッジが間違っていることを示しています。
invalid next_left_edge (訳注: 不正なnext_left_edge) | 不正確なエッジの識別子。 | 符号付き識別子で次の左エッジを示します。 | エッジの左側を進んで遭遇する次のエッジが間違っていることを示しています。
mixed face labeling in ring (訳注: リング内のフェイスのラベルの矛盾) | リングを識別する符号付きのエッジ識別子。GetRingEdgesを参照して下さい。 |  | リング内のエッジが、進む側にあるフェイスが矛盾していることを示しています。これは「サイドロケーションの矛盾」とも言われます。
non-closed ring (訳注: 閉じていないリング) | リングを識別する符号付きのエッジ識別子。GetRingEdgesを参照して下さい。 |  | 続くnext_left_edge/next_right_edge属性で形成されるエッジのリングの始点と終点が異なります。
face has multiple shells (訳注: 複数の外殻を持つフェイス) | 競合するフェイスの識別子。 | リングを識別する符号付きのエッジ識別子。GetRingEdgesを参照して下さい。 | 複数のエッジのリングがその内部で同じフェイスを示しています。

Availability: 1.0.0

Enhanced: 2.0.0では、より効果的なエッジ交差検出が可能になり、以前の版で残っていた偽陽性を解決しています。

Changed: 2.2.0 エラーの記述と矛盾しないように'edge crosses node'のid1とid2の値が入れ替わっています。

Changed: 3.2.0 任意パラメータbboxを追加し、フェイスラベルとエッジリンクのチェックを追加しました。

例

SELECT * FROM  topology.ValidateTopology('ma_topo');
      error        | id1 | id2
-------------------+-----+-----
face without edges |   1 |

関連情報

validatetopology_returntype, Topology_Load_Tiger

Name

ValidateTopologyRelation — 不正なトポロジ関係の行に関する情報を返します。

Synopsis

setof record ValidateTopologyRelation(
toponame);

varchar toponame;

説明

トポロジの関係テーブルの不正点に関する情報を提供するレコードの集合を返します。

Availability: 3.2.0

関連情報

ValidateTopology

Name

FindTopology — 異なる方法でトポロジ行を返します。

Synopsis

topology FindTopology(
topogeom);

TopoGeometry topogeom;

topology FindTopology( | layerTable, |
| layerColumn); |

regclass layerTable;
name layerColumn;

topology FindTopology( | layerSchema, |
| layerTable, |
| layerColumn); |

name layerSchema;
name layerTable;
name layerColumn;

topology FindTopology(
topoName);

text topoName;

topology FindTopology(
id);

int id;

説明

トポロジ識別子またはトポロジ関連オブジェクトの識別しを取り、topology.topologyレコードを返します。

Availability: 3.2.0

例

SELECT name(findTopology('features.land_parcels', 'feature'));
   name
-----------
 city_data
(1 row)

関連情報

FindLayer

Name

FindLayer — 様々な方法でtopology.layer行を返します。

Synopsis

topology.layer FindLayer(
tg);

TopoGeometry tg;

topology.layer FindLayer( | layer_table, |
| feature_column); |

regclass layer_table;
name feature_column;

topology.layer FindLayer( | schema_name, |
| table_name, |
| feature_column); |

name schema_name;
name table_name;
name feature_column;

topology.layer FindLayer( | topology_id, |
| layer_id); |

integer topology_id;
integer layer_id;

説明

トポロジ識別子またはトポロジ関連オブジェクトの識別子を取り、topology.topologyレコードを返します。

Availability: 3.2.0

例

SELECT layer_id(findLayer('features.land_parcels', 'feature'));
 layer_id
----------
        1
(1 row)

関連情報

FindTopology

トポロジ統計管理

Abstract

本節では、トポロジ構築時のデータベース統計の管理について説明します。

トポロジに要素を追加すると、そのトリガとして、分割されることになる既存のエッジを探索し、ノードを追加し、新しいラインでノードを作成するエッジを更新するために多数のデータベースクエリが発生します。このため、トポロジテーブル内のデータに関する統計情報が最新の状態になっているなら、統計情報を使うと便利です。

PostGISトポロジーの追加や編集の関数は、自動的に統計情報を更新することはありません。トポロジにおいて逐次変更していては、統計情報の更新が過剰になるためです。処理は呼び出し元の義務となっています。

Note

autovacuumで更新された統計情報は、autovacuumプロセス完了前に始まったトランザクションからは見えないので、更新した統計情報を使うには、実行時間の長いトランザクションではANALYZE自体を実行する必要があります。

トポロジコンストラクタ

Abstract

本節では、新しいトポロジを生成するトポロジ関数を挙げます。

Name

CreateTopology — 新しいトポロジスキーマを生成し、topology.topologyテーブルに登録します。

Synopsis

integer CreateTopology(
topology_schema_name);

varchar topology_schema_name;

integer CreateTopology( | topology_schema_name, |
| srid); |

varchar topology_schema_name;
integer srid;

integer CreateTopology( | topology_schema_name, |
| srid, |
| prec); |

varchar topology_schema_name;
integer srid;
double precision prec;

integer CreateTopology( | topology_schema_name, |
| srid, |
| prec, |
| hasz); |

varchar topology_schema_name;
integer srid;
double precision prec;
boolean hasz;

説明

topology_nameという名前でトポロジスキーマを新たに生成し、topology.topologyテーブルに登録します。トポロジ名は一意でなければなりません。トポロジテーブル (edge_data, face, node, relation)は、このスキーマ内に生成されます。トポロジのIDを返します。

sridは、このトポロジの空間参照系のSRIDです。

許容値precは空間参照系の単位で計測されます。許容値はデフォルトでは0.0です。

haszを指定しない場合のデフォルトはFALSEです。

これはSQL/MMのST_InitTopoGeoに似ていますが、より高機能です。

Availability: 1.1

Enhanched: 2.0 hasZを受け付ける形式の追加

例

ma_topoという名前のトポロジスキーマを生成します。これはマサチューセッツ州メートル平面 (SRID 26986)でエッジとノードを保存することとします。空間参照系の単位がメートルなので、許容値は0.5メートルとなります。

SELECT topology.CreateTopology('ma_topo', 26986, 0.5);

ri_topoという名前の、空間参照系をフィート平面 (SRID = 3438)としたロードアイランドのトポロジの生成

SELECT topology.CreateTopology('ri_topo', 3438) AS topoid;
topoid
------
2

関連情報

the section called “空間参照系”, ST_InitTopoGeo, Topology_Load_Tiger

Name

CopyTopology — トポロジ (ノード、エッジ、フェイス、レイヤとTopoGeometry)の新しいスキーマに複写します。

Synopsis

integer CopyTopology( | existing_topology_name, |
| new_name); |

varchar existing_topology_name;
varchar new_name;

説明

new_nameという名前のトポロジを作成しますが、SRIDと精度はexisting_topology_nameから複写します。existing_topology_nameのノード、エッジ、フェイスと、レイヤとそれに関連付けられたTopoGeometryは、新しいトポロジに複写されます。

Note

topology.layerテーブルの新しい行にはschema_name, table_name, feature_columnの値の合成値が含まれます。TopoGeometryオブジェクトは定義だけが存在するのであって、ユーザ定義テーブルで使用できる状態にないからです。

Availability: 2.0.0

例

ma_topoという名前のトポロジのバックアップを作成します。

SELECT topology.CopyTopology('ma_topo', 'ma_topo_backup');

関連情報

the section called “空間参照系”, CreateTopology, RenameTopology

Name

ST_InitTopoGeo — 新しいトポロジスキーマを生成し、topology.topologyテーブルに登録します。

Synopsis

text ST_InitTopoGeo(
topology_schema_name);

varchar topology_schema_name;

説明

CreateTopologyのSQL/MM相当の関数です。空間参照系と許容値の任意引数がありません。トポロジIDでなくトポロジ生成の文字列による説明が返されます。

Availability: 1.1

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.17

例

SELECT topology.ST_InitTopoGeo('topo_schema_to_create') AS topocreation;
                      astopocreation
------------------------------------------------------------
 Topology-Geometry 'topo_schema_to_create' (id:7) created.

関連情報

CreateTopology

Name

ST_CreateTopoGeo — 空のトポロジにジオメトリのコレクションを追加し、成否を示すメッセージを返します。

Synopsis

text ST_CreateTopoGeo( | atopology, |
| acollection); |

varchar atopology;
geometry acollection;

説明

空のトポロジにジオメトリのコレクションを追加し、成否を示すメッセージを返します。

空トポロジの追加に使えます。

Availability: 2.0

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.18

例

-- トポロジの投入 --
SELECT topology.ST_CreateTopoGeo('ri_topo',
 ST_GeomFromText('MULTILINESTRING((384744 236928,384750 236923,384769 236911,384799 236895,384811 236890,384833 236884,
  384844 236882,384866 236881,384879 236883,384954 236898,385087 236932,385117 236938,
  385167 236938,385203 236941,385224 236946,385233 236950,385241 236956,385254 236971,
  385260 236979,385268 236999,385273 237018,385273 237037,385271 237047,385267 237057,
  385225 237125,385210 237144,385192 237161,385167 237192,385162 237202,385159 237214,
  385159 237227,385162 237241,385166 237256,385196 237324,385209 237345,385234 237375,
  385237 237383,385238 237399,385236 237407,385227 237419,385213 237430,385193 237439,
  385174 237451,385170 237455,385169 237460,385171 237475,385181 237503,385190 237521,
  385200 237533,385206 237538,385213 237541,385221 237542,385235 237540,385242 237541,
  385249 237544,385260 237555,385270 237570,385289 237584,385292 237589,385291 237596,385284 237630))',3438)
  );

      st_createtopogeo
----------------------------
 Topology ri_topo populated

-- テーブルとTopoGeometryの生成--
CREATE TABLE ri.roads(gid serial PRIMARY KEY, road_name text);

SELECT topology.AddTopoGeometryColumn('ri_topo', 'ri', 'roads', 'topo', 'LINE');

関連情報

AddTopoGeometryColumn, CreateTopology, DropTopology

Name

TopoGeo_AddPoint — 許容差を使って既存のトポロジにポイントを追加し、可能ならエッジを分割します。

Synopsis

integer TopoGeo_AddPoint( | atopology, |
| apoint, |
| tolerance); |

varchar atopology;
geometry apoint;
float8 tolerance;

説明

既存のトポロジにポイントを追加し、その識別番号を返します。指定されたポイントは、許容差の範囲内で既存のノードまたはエッジにスナップします。既存のエッジはスナップされたポイントで分割されることがあります。

Availability: 2.0.0

関連情報

TopoGeo_AddLineString, TopoGeo_AddPolygon, AddNode, CreateTopology

Name

TopoGeo_AddLineString — 許容差を使って既存のトポロジにラインストリングを追加し、可能ならエッジ/フェイスを分割します。エッジ識別番号を返します。

Synopsis

SETOF integer TopoGeo_AddLineString( | atopology, |
| aline, |
| tolerance); |

varchar atopology;
geometry aline;
float8 tolerance;

説明

既存のトポロジにラインストリングを追加し、これを構成するエッジの識別番号の集合を返します。指定されたラインは、許容差の範囲内で既存のノードまたはエッジにスナップします。既存のエッジとフェイスはラインで分割されることがあります。

Note

この関数を介してロードされたトポロジの統計情報の更新は呼び出し元次第です。maintaining statistics during topology editing and populationをご覧下さい。

Availability: 2.0.0

関連情報

TopoGeo_AddPoint, TopoGeo_AddPolygon, AddEdge, CreateTopology

Name

TopoGeo_AddPolygon — 許容差を使って既存のトポロジにラインストリングを追加し、可能ならエッジ/フェイスを分割します。エッジ識別番号を返します。

Synopsis

SETOF integer TopoGeo_AddPolygon( | atopology, |
| apoly, |
| tolerance); |

varchar atopology;
geometry apoly;
float8 tolerance;

説明

既存のトポロジにポリゴンを追加し、これを構成するフェイスの識別番号の集合を返します。指定されたポリゴンの境界線は、許容差の範囲内で既存のノードまたはエッジにスナップします。既存のエッジとフェイスはポリゴンの境界線で分割されることがあります。

Note

この関数を介してロードされたトポロジの統計情報の更新は呼び出し元次第です。maintaining statistics during topology editing and populationをご覧下さい。

Availability: 2.0.0

関連情報

TopoGeo_AddPoint, TopoGeo_AddLineString, AddFace, CreateTopology

トポロジエディタ

Abstract

本節では、エッジ、フェイス、ノードの追加、移動、削除、分割に関する関数を挙げます。本節の関数はすべてISO SQL/MMで定義されています。

Name

ST_AddIsoNode — フェイスに孤立ノードを追加し、新しいノードの識別番号を返します。フェイスがNULLの場合でもノードは生成されます。

Synopsis

integer ST_AddIsoNode( | atopology, |
| aface, |
| apoint); |

varchar atopology;
integer aface;
geometry apoint;

説明

atopologyで指定されたトポロジのafaceの識別番号で示された既存のフェイスに対して、apointで示された位置に孤立ノードを追加します。

ポイントジオメトリの空間参照系 (SRID)がトポロジと同じでない場合、apointがポイントジオメトリでない場合、ポイントがNULLである場合、または、ポイントが既存のエッジ (境界も含む)とインタセクトする場合には、例外が投げられます。また、ポイントが既にノードとして存在する場合、例外が投げられます。

afaceがNULLでなく、かつapointがフェイス内に無い場合には、例外が投げられます。

Availability: 1.1

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X 3.1

例

関連情報

AddNode, CreateTopology, DropTopology, ST_Intersects

Name

ST_AddIsoEdge — anodeとanothernodeで指定される二つの既存孤立ノードを接続するトポロジに、ジオメトリalinestringで定義される孤立エッジを追加し、新しいエッジの識別番号を返します。

Synopsis

integer ST_AddIsoEdge( | atopology, |
| anode, |
| anothernode, |
| alinestring); |

varchar atopology;
integer anode;
integer anothernode;
geometry alinestring;

説明

anodeとanothernodeで指定される二つの既存孤立ノードを接続するトポロジに、ジオメトリalinestringで定義される孤立エッジを追加し、新しいエッジの識別番号を返します。

alinestringジオメトリとトポロジとで空間参照系 (SRID)が異なる場合、引数がNULLである場合、ノードが一つ以上のフェイスに含まれている場合には、二つのノードが既存エッジの始端または終端である場合には、例外が投げられます。

alinestringがanodeとanothernodeに属するフェイス内に無い場合には、例外が投げられます。

anodeとanothernodeが、alinestringの始端と終端でない場合には、例外が投げられます。

Availability: 1.1

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.4

例

関連情報

ST_AddIsoNode, ST_IsSimple, ST_Within

Name

ST_AddEdgeNewFaces — 新しいエッジを追加します。新しいエッジがフェイスを分割する場合には、もとのフェイスを削除して、分割した二つのフェイスに置き換えます。

Synopsis

integer ST_AddEdgeNewFaces( | atopology, |
| anode, |
| anothernode, |
| acurve); |

varchar atopology;
integer anode;
integer anothernode;
geometry acurve;

説明

新しいエッジを追加します。新しいエッジがフェイスを分割する場合には、もとのフェイスを削除して、分割した二つのフェイスに置き換えます。新しいエッジの識別番号を返します。

この関数によって、既存の接続されているエッジとリレーションシップが更新されます。

引数がNULLの場合、与えられたノードが不明な場合(トポロジスキーマのnodeテーブル内に既に存在していなければなりません)、acurveがLINESTRINGでない場合、anodeとanothernodeがacurveの始端、終端でない場合には、例外が投げられます。

acurveジオメトリの空間参照系 (SRID) がトポロジと同じでない場合、例外が投げられます。

Availability: 2.0

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.12

例

関連情報

ST_RemEdgeNewFace

ST_AddEdgeModFace

Name

ST_AddEdgeModFace — 新しいエッジを追加します。新しいエッジがフェイスを分割する場合には、もとのフェイスを編集し、一つのフェイスを追加します。

Synopsis

integer ST_AddEdgeModFace( | atopology, |
| anode, |
| anothernode, |
| acurve); |

varchar atopology;
integer anode;
integer anothernode;
geometry acurve;

説明

新しいエッジを追加します。新しいエッジがフェイスを分割する場合には、もとのフェイスを編集し、一つのフェイスを追加します。

Note

可能なら、新しいフェイスは新しいエッジの左側に作られます。左側のフェイスがユニバースフェイス (境界がない)でなければならない場合には、可能ではありません。

新しく追加されたエッジの識別番号を返します。

この関数によって、既存の接続されているエッジとリレーションシップが更新されます。

引数がNULLの場合、与えられたノードが不明な場合(トポロジスキーマのnodeテーブル内に既に存在していなければなりません)、acurveがLINESTRINGでない場合、anodeとanothernodeがacurveの始端、終端でない場合には、例外が投げられます。

acurveジオメトリの空間参照系 (SRID) がトポロジと同じでない場合、例外が投げられます。

Availability: 2.0

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.13

例

関連情報

ST_RemEdgeModFace

ST_AddEdgeNewFaces

Name

ST_RemEdgeNewFace — エッジを削除し、消去対象エッジでフェイスが二つに分割されているなら元の二つのフェイスを削除し、一つの新しいフェイスに置き換えます。

Synopsis

integer ST_RemEdgeNewFace( | atopology, |
| anedge); |

varchar atopology;
integer anedge;

説明

エッジを削除し、消去対象エッジでフェイスが二つに分割されているなら元の二つのフェイスを削除し、一つの新しいフェイスに置き換えます。

新しく作成されたフェイスの識別番号を返します。新しいフェイスが生成されない場合にはNULLを返します。削除対象エッジがダングルである (訳注: 「ぶらさがる」状態、すなわち一方の端が孤立ノードでなく、かつもう一方が孤立ノード)場合か、孤立している場合か、 ユニバースフェイスとの境界になっている (おそらく反対側のフェイスにユニバースが侵入します)場合には、フェイスは生成されません。

この関数によって、既存の接続されているエッジとリレーションシップが更新されます。

既存のTopoGeometryの定義に入り込んでいるエッジは削除を拒絶されます。TopoGeometryが二つのフェイスのうちひとつだけで定義されている (かつ他方は定義に使われていない)場合、二つのフェイスの修復は拒絶されます。

引数がNULLである場合、与えられたエッジが不明である場合 (トポロジスキーマのedgeテーブル内に既に存在していなければなりません)、トポロジ名が不正である場合、例外が投げられます。

Availability: 2.0

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.14

例

関連情報

ST_RemEdgeModFace

ST_AddEdgeNewFaces

Name

ST_RemEdgeModFace — エッジを削除します。削除されるエッジが二つのフェイスを分割していたなら、一方のフェイスを削除し、もう一方のフェイスを両方の空間を覆うように編集します。

Synopsis

integer ST_RemEdgeModFace( | atopology, |
| anedge); |

varchar atopology;
integer anedge;

説明

エッジを削除します。削除されるエッジが二つのフェイスを分割していたなら、一方のフェイスを削除し、もう一方のフェイスを両方の空間を覆うように編集します。右側のフェイスを優先的に保持します。これはST_AddEdgeModFaceと一致します。残ったフェイスのIDを返します。

この関数によって、既存の接続されているエッジとリレーションシップが更新されます。

既存のTopoGeometryの定義に入り込んでいるエッジは削除を拒絶されます。TopoGeometryが二つのフェイスのうちひとつだけで定義されている (かつ他方は定義に使われていない)場合、二つのフェイスの修復は拒絶されます。

引数がNULLである場合、与えられたエッジが不明である場合 (トポロジスキーマのedgeテーブル内に既に存在していなければなりません)、トポロジ名が不正である場合、例外が投げられます。

Availability: 2.0

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.15

例

関連情報

ST_AddEdgeModFace

ST_RemEdgeNewFace

Name

ST_ChangeEdgeGeom — トポロジ構造に影響を与えることなくエッジの形状を変更します。

Synopsis

integer ST_ChangeEdgeGeom( | atopology, |
| anedge, |
| acurve); |

varchar atopology;
integer anedge;
geometry acurve;

説明

トポロジ構造に影響を与えることなくエッジの形状を変更します。

全ての引数がNULLであるか、与えられたエッジがtopologyスキーマのedgeテーブルにないか、acurveがLINESTRINGでないか、変更で基になるトポロジが変わるか、のいずれかの場合には、エラーが投げられます。

acurveジオメトリの空間参照系 (SRID) がトポロジと同じでない場合、例外が投げられます。

新しいacurveが単純でない場合には、エラーが投げられます。

古い位置から新しい位置へのエッジ移動で障害物にあたった場合はエラーが投げられます。

Availability: 1.1.0

Enhanced: 2.0.0 トポロジ整合性の強制を追加しました。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.6

例

SELECT topology.ST_ChangeEdgeGeom('ma_topo', 1,
                ST_GeomFromText('LINESTRING(227591.9 893900.4,227622.6 893844.3,227641.6 893816.6, 227704.5 893778.5)', 26986) );
 ----
 Edge 1 changed

関連情報

ST_AddEdgeModFace

ST_RemEdgeModFace

ST_ModEdgeSplit

Name

ST_ModEdgeSplit — 既存のエッジに沿って新しいノードを生成してエッジを分割します。もとのエッジは変更され、新しいエッジが一つ追加されます。

Synopsis

integer ST_ModEdgeSplit( | atopology, |
| anedge, |
| apoint); |

varchar atopology;
integer anedge;
geometry apoint;

説明

既存のエッジに沿って新しいノードを生成してエッジを分割します。もとのエッジは変更され、新しいエッジが一つ追加されます。この関数によって、既存の接続されているエッジとリレーションシップが更新されます。新しく追加されたノードの識別番号が返ります。

Availability: 1.1

Changed: 2.0 - 以前の版では名前を間違えてST_ModEdgesSplitになっていました。

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.9

例

-- エッジの追加 --
 SELECT topology.AddEdge('ma_topo', ST_GeomFromText('LINESTRING(227592 893910, 227600 893910)', 26986) ) As edgeid;

-- edgeid --
3

-- エッジの分割 --
SELECT topology.ST_ModEdgeSplit('ma_topo',  3, ST_SetSRID(ST_Point(227594,893910),26986)  ) As node_id;
        node_id
-------------------------
7

関連情報

ST_NewEdgesSplit, ST_ModEdgeHeal, ST_NewEdgeHeal, AddEdge

Name

ST_ModEdgeHeal — 二つのエッジについて、接続しているノードを削除して修復します。1番目のエッジを編集して、2番目のエッジを削除します。削除されたノードの識別番号を返します。

Synopsis

int ST_ModEdgeHeal( | atopology, |
| anedge, |
| anotheredge); |

varchar atopology;
integer anedge;
integer anotheredge;

説明

二つのエッジについて、接続しているノードを削除して修復します。1番目のエッジを編集して、2番目のエッジを削除します。削除されたノードの識別番号を返します。この関数によって、既存の接続されているエッジとリレーションシップが更新されます。

Availability: 2.0

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.9

関連情報

ST_ModEdgeSplit ST_NewEdgesSplit

Name

ST_NewEdgeHeal — 二つのエッジについて、接続しているノードを削除して修復します。両方のエッジを削除し、1番目のエッジと同じ方向のエッジに置き換えます。

Synopsis

int ST_NewEdgeHeal( | atopology, |
| anedge, |
| anotheredge); |

varchar atopology;
integer anedge;
integer anotheredge;

説明

二つのエッジについて、接続しているノードを削除して修復します。両方のエッジを削除し、1番目のエッジと同じ方向のエッジに置き換えます。 修復されたエッジに置き換えられた新しいエッジの識別番号を返します。 この関数によって、既存の接続されているエッジとリレーションシップが更新されます。

Availability: 2.0

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.9

関連情報

ST_ModEdgeHeal ST_ModEdgeSplit ST_NewEdgesSplit

Name

ST_MoveIsoNode — トポロジ内の孤立ノードを別の位置に移動させます。新しいapointジオメトリがノードとして存在しているなら、エラーが投げられます。移動に関する説明を返します。

Synopsis

text ST_MoveIsoNode( | atopology, |
| anode, |
| apoint); |

varchar atopology;
integer anode;
geometry apoint;

説明

トポロジ内の孤立ノードを別の位置に移動させます。新しいapointジオメトリがノードとして存在しているなら、エラーが投げられます。

引数がNULLの場合、apointがポイントでない場合、既存のノードが孤立していない (既存のエッジの始端か終端になっている)場合、新しいノード位置が既存のエッジとインタセクトする場合 (終端であっても)、新しい位置が異なるフェイス内にある場合 (3.2.0以降)のいずれかの場合には、例外が投げられます。

ポイントジオメトリの空間参照系 (SRID)がトポロジと異なる場合には、例外が投げられます。

Availability: 2.0.0

Enhanced: 3.2.0 ノードが異なるフェイスに移動しないことを保証

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.2

例

-- フェイスの無い孤立ノードの追加 --
SELECT topology.ST_AddIsoNode('ma_topo',  NULL, ST_GeomFromText('POINT(227579 893916)', 26986) ) As nodeid;
 nodeid
--------
      7
-- 新しいノードの移動 --
SELECT topology.ST_MoveIsoNode('ma_topo', 7,  ST_GeomFromText('POINT(227579.5 893916.5)', 26986) ) As descrip;
                      descrip
----------------------------------------------------
Isolated Node 7 moved to location 227579.5,893916.5

関連情報

ST_AddIsoNode

Name

ST_NewEdgesSplit — 新しいノードを既存のエッジに沿って作成して、エッジを分割します。もとのエッジは削除され、二つのエッジに置き換えられます。二つの新しいエッジに接続する新しいノードの識別番号を返します。

Synopsis

integer ST_NewEdgesSplit( | atopology, |
| anedge, |
| apoint); |

varchar atopology;
integer anedge;
geometry apoint;

説明

anedgeで指定される既存のエッジに沿ったapointの位置に新しいノードを作成して、エッジを分割します。もとのエッジは削除され、二つつのエッジに置き換えられます。二つの新しいエッジに接続する新しいノードの識別番号を返します。この関数によって、既存の接続されているエッジとリレーションシップが更新されます。

ポイントジオメトリの空間参照系 (SRID)がトポロジと異なる場合、apointがポイントジオメトリでない場合、ポイントがNULLの場合、ポイントが既にノードとして存在する場合、エッジが既存のエッジと一致しない場合、ポイントがエッジ内にない場合、例外が投げられます。

Availability: 1.1

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.8

例

-- エッジの追加  --
SELECT topology.AddEdge('ma_topo', ST_GeomFromText('LINESTRING(227575 893917,227592 893900)', 26986) ) As edgeid;
-- 結果 --
edgeid
------
        2
-- 新しいエッジの分割 --
SELECT topology.ST_NewEdgesSplit('ma_topo', 2,  ST_GeomFromText('POINT(227578.5 893913.5)', 26986) ) As newnodeid;
 newnodeid
---------
       6

関連情報

ST_ModEdgeSplit ST_ModEdgeHeal ST_NewEdgeHeal AddEdge

Name

ST_RemoveIsoNode — 孤立ノードを削除し、実行結果が返されます。ノードが孤立していない (エッジの始端または終端である)場合には、例外が投げられます。

Synopsis

text ST_RemoveIsoNode( | atopology, |
| anode); |

varchar atopology;
integer anode;

説明

孤立ノードを削除し、実行結果が返されます。ノードが孤立していない (エッジの始端または終端である)場合には、例外が投げられます。

Availability: 1.1

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.3

例

-- フェイスの無い孤立ノードの削除 --
SELECT topology.ST_RemoveIsoNode('ma_topo',  7 ) As result;
         result
-------------------------
 Isolated node 7 removed

関連情報

ST_AddIsoNode

Name

ST_RemoveIsoEdge — 孤立エッジを削除し、実行結果の記述を返します。エッジが孤立していない場合には、例外が投げられます。

Synopsis

text ST_RemoveIsoEdge( | atopology, |
| anedge); |

varchar atopology;
integer anedge;

説明

孤立エッジを削除し、実行結果の記述を返します。エッジが孤立していない場合には、例外が投げられます。

Availability: 1.1

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.3

例

-- フェイスの無い孤立ノードの削除 --
SELECT topology.ST_RemoveIsoNode('ma_topo',  7 ) As result;
         result
-------------------------
 Isolated node 7 removed

関連情報

ST_AddIsoNode

トポロジアクセサ

Name

GetEdgeByPoint — 与えられたポイントにインタセクトするエッジの識別番号を探索します。

Synopsis

integer GetEdgeByPoint( | atopology, |
| apoint, |
| tol1); |

varchar atopology;
geometry apoint;
float8 tol1;

説明

与えられたポイントにインタセクトするエッジの識別番号を探索します。

この関数は、トポロジ、ポイント、許容差を引数にして、整数 (エッジの識別番号)を返します。許容差が0の場合、ポイントはエッジとインタセクトしていなければなりません。

apointがエッジとインタセクトしない場合には、0を返します。

許容差を0より大きくして、ポイント付近のエッジが一つより多い場合には、例外が投げられます。

Note

許容差が0の場合には、ST_Intersectsを使い、それ以外では、ST_DWinthinを使います。

GEOSモジュールで実現しています。

Availability: 2.0.0

例

本例ではAddEdgeで作ったエッジを使います。

SELECT topology.GetEdgeByPoint('ma_topo',geom, 1) As with1mtol, topology.GetEdgeByPoint('ma_topo',geom,0) As withnotol
FROM ST_GeomFromEWKT('SRID=26986;POINT(227622.6 893843)') As geom;
 with1mtol | withnotol
-----------+-----------
         2 |         0

SELECT topology.GetEdgeByPoint('ma_topo',geom, 1) As nearnode
FROM ST_GeomFromEWKT('SRID=26986;POINT(227591.9 893900.4)') As geom;

-- エラー発生 --
ERROR:  Two or more edges found

関連情報

AddEdge, GetNodeByPoint, GetFaceByPoint

Name

GetFaceByPoint — 与えたポイントとインタセクトするフェイスを見つけます。

Synopsis

integer GetFaceByPoint( | atopology, |
| apoint, |
| tol1); |

varchar atopology;
geometry apoint;
float8 tol1;

説明

ポイントと与えた許容値で参照されるフェイスを見つけます。

この関数は、ポイントを中心に持ち半径が許容値となる円とインタセクトするフェイスを効率的に探します。

与えられたクエリ位置とインタセクトするフェイスが無い場合には、0を返します (ユニバーサルフェイス)。

1以上のフェイスがクエリ位置とインタセクトする場合には例外が投げられます。

Availability: 2.0.0

Enhanced: 3.2.0 より効率的な実装とより明確な短縮、不正なトポロジでの動作停止。

例

SELECT topology.GetFaceByPoint('ma_topo',geom, 10) As with1mtol, topology.GetFaceByPoint('ma_topo',geom,0) As withnotol
        FROM ST_GeomFromEWKT('POINT(234604.6 899382.0)') As geom;

         with1mtol | withnotol
        -----------+-----------
                         1 |         0

SELECT topology.GetFaceByPoint('ma_topo',geom, 1) As nearnode
        FROM ST_GeomFromEWKT('POINT(227591.9 893900.4)') As geom;

-- エラー発生--
ERROR:  Two or more faces found

関連情報

GetFaceContainingPoint, AddFace, GetNodeByPoint, GetEdgeByPoint

Name

GetFaceContainingPoint — ポイントを含むフェイスを見つけます。

Synopsis

integer GetFaceContainingPoint( | atopology, |
| apoint); |

text atopology;
geometry apoint;

説明

ポイントを含むフェイスのIDを返します。

ポイントがフェイスの境界に落ちた場合には例外が投げられます。

Note

この関数は妥当なトポロジが前提であり、エッジリンクとフェイスラベルを使用して動作します。

Availability: 3.2.0

関連情報

ST_GetFaceGeometry

Name

GetNodeByPoint — ポイント位置にあるノードの識別番号を探索します。

Synopsis

integer GetNodeByPoint( | atopology, |
| apoint, |
| tol1); |

varchar atopology;
geometry apoint;
float8 tol1;

説明

ポイント位置にあるノードの識別番号を探索します。

トポロジ、POINT、許容値が与えられ、整数 (ノード識別番号)が返ります。tolerance = 0 の場合には、確実にインタセクトするノードを取得し、そうでない場合には、指定した間隔の中からノードを取得します。

apointがノードとインタセクトしない場合には、0を返します。

許容差を0より大きくして、ポイント付近のノードが一つより多い場合には、例外が投げられます。

Note

許容差が0の場合には、ST_Intersectsを使い、それ以外では、ST_DWinthinを使います。

GEOSモジュールで実現しています。

Availability: 2.0.0

例

本例ではAddEdgeで作ったエッジを使います。

SELECT topology.GetNodeByPoint('ma_topo',geom, 1) As nearnode
 FROM ST_GeomFromEWKT('SRID=26986;POINT(227591.9 893900.4)') As geom;
  nearnode
----------
        2

SELECT topology.GetNodeByPoint('ma_topo',geom, 1000) As too_much_tolerance
 FROM ST_GeomFromEWKT('SRID=26986;POINT(227591.9 893900.4)') As geom;

 -- エラー発生 --
 ERROR:  Two or more nodes found

関連情報

AddEdge, GetEdgeByPoint, GetFaceByPoint

Name

GetTopologyID — トポロジ名からtopology.topologyテーブル内にあるトポロジの識別番号を返します。

Synopsis

integer GetTopologyID(
toponame);

varchar toponame;

説明

トポロジ名からtopology.topologyテーブル内にあるトポロジの識別番号を返します。

Availability: 1.1

例

SELECT topology.GetTopologyID('ma_topo') As topo_id;
 topo_id
---------
       1

関連情報

CreateTopology, DropTopology, GetTopologyName, GetTopologySRID

Name

GetTopologySRID — トポロジ名からtopology.topologyテーブル内にあるトポロジのSRIDを返します。

Synopsis

integer GetTopologyID(
toponame);

varchar toponame;

説明

与えられたトポロジ名からtopology.topologyテーブル内のトポロジの空間参照系識別番号を返します。

Availability: 2.0.0

例

SELECT topology.GetTopologySRID('ma_topo') As SRID;
 SRID
-------
  4326

関連情報

CreateTopology, DropTopology, GetTopologyName, GetTopologyID

Name

GetTopologyName — 識別番号からトポロジ (スキーマ)の名前を返します。

Synopsis

varchar GetTopologyName(
topology_id);

integer topology_id;

説明

識別番号からトポロジ (スキーマ)の名前を返します。

Availability: 1.1

例

SELECT topology.GetTopologyName(1) As topo_name;
 topo_name
-----------
 ma_topo

関連情報

CreateTopology, DropTopology, GetTopologyID, GetTopologySRID

Name

ST_GetFaceEdges — 順序番号を含む、afaceの境界となる、整列したエッジの集合を返します。

Synopsis

getfaceedges_returntype ST_GetFaceEdges( | atopology, |
| aface); |

varchar atopology;
integer aface;

説明

順序番号を含む、afaceの境界となる、整列したエッジの集合を返します。それぞれの出力は、順序番号とエッジ識別番号からなります。順序番号は1から始まります。

環ごとのエッジの列挙は、識別番号が最も小さいものから始まります。エッジの順序は左手の法則に従います (境界フェイスは各有向辺の左側にあるようにします)。

Availability: 2.0

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.5

例

-- 1番フェイスの境界を返します。
SELECT (topology.ST_GetFaceEdges('tt', 1)).*;
-- 結果 --
 sequence | edge
----------+------
        1 |   -4
        2 |    5
        3 |    7
        4 |   -6
        5 |    1
        6 |    2
        7 |    3
(7 rows)

-- 1番フェイスの順序番号、エッジ識別番号とジオメトリを返します。
-- geomとseqが欲しいだけならST_GetFaceGeometryを使います。
SELECT t.seq, t.edge, geom
FROM topology.ST_GetFaceEdges('tt',1) As t(seq,edge)
        INNER JOIN tt.edge AS e ON abs(t.edge) = e.edge_id;

関連情報

GetRingEdges, AddFace, ST_GetFaceGeometry

Name

ST_GetFaceGeometry — 指定されたトポロジの中の、フェイス識別番号で指定されたポリゴンを返します。

Synopsis

geometry ST_GetFaceGeometry( | atopology, |
| aface); |

varchar atopology;
integer aface;

説明

指定されたトポロジの中の、フェイス識別番号で指定されたポリゴンを返します。フェイスを作るエッジからポリゴンを構築します。

Availability: 1.1

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.16

例

-- AddFaceで追加したポリゴンのWKTを返します。
SELECT ST_AsText(topology.ST_GetFaceGeometry('ma_topo', 1)) As facegeomwkt;
-- 結果 --
               facegeomwkt

--------------------------------------------------------------------------------
 POLYGON((234776.9 899563.7,234896.5 899456.7,234914 899436.4,234946.6 899356.9,
234872.5 899328.7,234891 899285.4,234992.5 899145,234890.6 899069,
234755.2 899255.4,234612.7 899379.4,234776.9 899563.7))

関連情報

AddFace

Name

GetRingEdges — 与えられた側を歩いて得られた、正負符号付きエッジ識別番号の集合を、順序通りに返します。

Synopsis

getfaceedges_returntype GetRingEdges( | atopology, |
| aring, |
| max_edges=null); |

varchar atopology;
integer aring;
integer max_edges=null;

説明

与えられた側を歩いて得られた、正負符号付きエッジ識別番号の集合を、順序通りに返します。出力は順序番号と正負符号付きエッジ識別番号からなります。順序番号は1始まりです。

正のエッジ識別番号を渡すと、対応するエッジの左側を歩き、エッジを順方向に進みます。負のエッジ識別番号を渡すと、右側を歩き、エッジを逆方向に進みます。

max_edgesがNULLでな場合には、返されるレコードを超えることはありません。これは、不正なトポロジを扱うときの安全確保のためのパラメータであることを意味します。

Note

この関数はメタデータとリンクするエッジ環を使います。

Availability: 2.0.0

関連情報

ST_GetFaceEdges, GetNodeEdges

Name

GetNodeEdges — 与えられたノードに付随するエッジの集合を整列して返します。

Synopsis

getfaceedges_returntype GetNodeEdges( | atopology, |
| anode); |

varchar atopology;
integer anode;

説明

与えられたノードに付随するエッジの集合を整列して返します。 出力は、連続する、正負符号を持つエッジ識別番号からなります。順序番号は1から始まります。 正のエッジは与えられたノードから始まるものです。 負のエッジは与えられたノードで終わるものです。 閉じたエッジは2回現れます (正と負になります)。 並び順は北側から時計回りになります。

Note

この関数は、並び順を計算していて、メタデータからのデータを使わないので、 連結しているエッジ環を構築するのに使えます。

Availability: 2.0

関連情報

getfaceedges_returntype, GetRingEdges, ST_Azimuth

トポロジ処理

Abstract

本節では、非標準の手法でのトポロジ処理の関数を挙げます。

Name

ポリゴン化 — トポロジエッジで定義される全てのフェイスを探索し、追加します。

Synopsis

text Polygonize(
toponame);

varchar toponame;

説明

トポロジエッジプリミティブで構築することができる全てのフェイスを登録します。

対象トポロジは自己インタセクトするエッジが無いと仮定しています。

Note

既に登録されているフェイスは認識されているので、同じトポロジに対してPolygonizeを複数回呼んでも問題ありません。

Note

この関数はエッジテーブルのnext_left_edgeとnext_right_edgeフィールドの読み書きを行いません。

Availability: 2.0.0

関連情報

AddFace, ST_Polygonize

Name

AddNode — 指定したトポロジスキーマのノードテーブルにポイントノードを追加し、新しいノードの識別番号を返します。指定したポイントに既にノードがある場合は既存のノード識別番号を返します。

Synopsis

integer AddNode( | toponame, |
| apoint, |
| allowEdgeSplitting=false, |
| computeContainingFace=false); |

varchar toponame;
geometry apoint;
boolean allowEdgeSplitting=false;
boolean computeContainingFace=false;

説明

指定したトポロジスキーマのノードテーブルにポイントノードを追加します。 AddEdge関数は、呼ばれると自動的にエッジの始端と終端のポイントを追加するので、明示的にエッジのノードを追加する必要はあまりありません。

ノードとクロスするエッジが発見された場合は、例外が発生するか、エッジが分割されます。allowEdgeSplittingパラメータの値に依存します。

computeContainingFaceがtrueの場合には、新しく追加されたノードによって、ノードを含む正しいフェイスが計算されます。

Note

apointジオメトリが既にノードとして存在する場合、ノードは追加されずに、既存ノードの識別番号を返します。

Availability: 2.0.0

例

SELECT topology.AddNode('ma_topo', ST_GeomFromText('POINT(227641.6 893816.5)', 26986) ) As nodeid;
-- 結果 --
nodeid
--------
 4

関連情報

AddEdge, CreateTopology

Name

AddEdge — 指定したラインストリングジオメトリを使って、ラインストリングエッジをエッジテーブルに追加し、指定したトポロジスキーマの始点終点をポイントノードテーブルに追加し、新しい (または既存の)エッジの識別番号を返します。

Synopsis

integer AddEdge( | toponame, |
| aline); |

varchar toponame;
geometry aline;

説明

指定したラインストリングジオメトリを使って、指定したtoponameスキーマのノードテーブルにノードを追加し、新しいまたは既存のレコードのエッジ識別番号を返します。ラインストリングエッジをエッジテーブルに追加し、指定したトポロジスキーマの始点終点をポイントノードテーブルに追加し、新規または既存のエッジの識別番号を返します。新しく追加されたエッジは両側にユニバースフェイスを持ち、自分自身にリンクしています。

Note

alineジオメトリが既存のエッジとクロスしたり、既存のエッジをオーバラップしたり、既存のエッジを包含したり、既存のエッジに包含されたりする場合には、エラーが投げられ、エッジは追加されません。

Note

alineのジオメトリはsridがトポロジで指定されたものと同じである必要があり、異なる場合には、不正な空間参照系エラーが投げられます。

GEOSモジュールで実現しています。

Availability: 2.0.0

例

SELECT topology.AddEdge('ma_topo', ST_GeomFromText('LINESTRING(227575.8 893917.2,227591.9 893900.4)', 26986) ) As edgeid;
-- 結果 --
edgeid
--------
 1

SELECT topology.AddEdge('ma_topo', ST_GeomFromText('LINESTRING(227591.9 893900.4,227622.6 893844.2,227641.6 893816.5,
 227704.5 893778.5)', 26986) ) As edgeid;
-- 結果 --
edgeid
--------
 2

 SELECT topology.AddEdge('ma_topo', ST_GeomFromText('LINESTRING(227591.2 893900, 227591.9 893900.4,
  227704.5 893778.5)', 26986) ) As edgeid;
 -- エラー発生 --
 ERROR:  Edge intersects (not on endpoints) with existing edge 1

関連情報

TopoGeo_AddLineString, CreateTopology, the section called “空間参照系”

Name

AddFace — フェイスプリミティブをトポロジに登録し、その識別番号を得ます。

Synopsis

integer AddFace( | toponame, |
| apolygon, |
| force_new=false); |

varchar toponame;
geometry apolygon;
boolean force_new=false;

説明

フェイスプリミティブをトポロジに登録し、その識別番号を得ます。

新しく追加されたフェイスのために、境界を形成するエッジとフェイスに含まれるエッジはleft_faceとright_faceフィールドに正しい値を持つよう更新されます。フェイスに含まれる孤立ノードも正しいcontaining_faceフィールド値を持つよう更新されます。

Note

この関数はエッジテーブルのnext_left_edgeとnext_right_edgeフィールドの読み書きを行いません。

対象トポロジは妥当 (自己インタセクトするエッジが無い)と仮定しています。ポリゴンの境界が既存のエッジでは完全には定義されない場合や、ポリゴンが既存のフェイスにオーバラップする場合には、例外が投げられます。

apolygonジオメトリがフェイスとして既に存在している場合には、force_newがFALSE (デフォルト)なら既存フェイスのフェイスIDを返し、force_new がTRUEなら新しいIDが新規登録されたフェイスに割り当てられます。

Note

既存フェイスの新規登録が実行される時(force_new=true)、そのエッジ内の既存のフェイスへの参照のダングルを解決しません。また、関連テーブルのノードと既存フェイスのレコードのMBR(訳注: 最小境界矩形)フィールドの更新も行いません。これに対応するのは、この関数を呼び出した側です。

Note

apolygonジオメトリはトポロジと同じsridである必要があり、異なる場合には、不正な空間参照系エラーが投げられます。

Availability: 2.0.0

例

-- 最初に、反復子にgenerate_seriesを使用してエッジを追加
-- (generate_seriesの最大値の関係上、
-- 頂点が10000個未満のポリゴンでのみ動作します)
SELECT topology.AddEdge('ma_topo', ST_MakeLine(ST_PointN(geom,i), ST_PointN(geom, i + 1) )) As edgeid
    FROM (SELECT  ST_NPoints(geom) AS npt, geom
            FROM
                (SELECT ST_Boundary(ST_GeomFromText('POLYGON((234896.5 899456.7,234914 899436.4,234946.6 899356.9,234872.5 899328.7,
                234891 899285.4,234992.5 899145, 234890.6 899069,234755.2 899255.4,
                234612.7 899379.4,234776.9 899563.7,234896.5 899456.7))', 26986) )  As geom
            )  As geoms) As facen CROSS JOIN generate_series(1,10000) As i
         WHERE i < npt;
-- result --
 edgeid
--------
      3
      4
      5
      6
      7
      8
      9
     10
     11
     12
(10 rows)
-- フェイスの追加

SELECT topology.AddFace('ma_topo',
    ST_GeomFromText('POLYGON((234896.5 899456.7,234914 899436.4,234946.6 899356.9,234872.5 899328.7,
    234891 899285.4,234992.5 899145, 234890.6 899069,234755.2 899255.4,
    234612.7 899379.4,234776.9 899563.7,234896.5 899456.7))', 26986) ) As faceid;
-- 結果 --
faceid
--------
 1

関連情報

AddEdge, CreateTopology, the section called “空間参照系”

Name

ST_Simplify — 与えたTopoGeometryを「シンプル化した」ジオメトリを返します。ダグラス-ポーカーのアルゴリズムを使います。

Synopsis

geometry ST_Simplify( | tg, |
| tolerance); |

TopoGeometry tg;
float8 tolerance;

説明

与えたTopoGeometryを「シンプル化した」ジオメトリを返します。個々の要素エッジに対してダグラス-ポーカーのアルゴリズムを使います。

Note

返されるジオメトリは単純でなかったり不正であったりする場合があります。

要素エッジの分割によって単純性/妥当性を維持することがあります。

GEOSモジュールで実現しています。

Availability: 2.1.0

関連情報

ST_Simplify (ジオメトリ), ST_IsSimple, ST_IsValid, ST_ModEdgeSplit

Name

RemoveUnusedPrimitives — 存在するTopoGeometryオブジェクトを定義するのに必要でないトポロジプリミティブを削除します。

Synopsis

int RemoveUnusedPrimitives( | topology_name, |
| bbox); |

text topology_name;
geometry bbox;

説明

存在するTopoGeometryオブジェクトを表現するのに厳密には必要でない全てのプリミティブ (nodes, edges, faces)を見つけ、これらを削除し、トポロジの妥当性 (エッジのリンク、フェイスのラベル)を維持します。

新しいプリミティブ識別子が作られませんが、既存のプリミティブはフェイスのマージ (エッジの削除のため)や修復されたエッジ (ノードの削除のため)を含むために拡張されます。

Availability: 3.3.0

関連情報

ST_ModEdgeHeal, ST_RemEdgeModFace

TopoGeometryコンストラクタ

Abstract

本節では、新しいTopoGeometryを生成するトポロジ関数を挙げます。

Name

CreateTopoGeom — 新しいTopoGeometryオブジェクトをtopoエレメント配列から生成します - tg_type: 1:[multi]point, 2:[multi]line, 3:[multi]poly, 4:collection

Synopsis

topogeometry CreateTopoGeom( | toponame, |
| tg_type, |
| layer_id, |
| tg_objs); |

varchar toponame;
integer tg_type;
integer layer_id;
topoelementarray tg_objs;

topogeometry CreateTopoGeom( | toponame, |
| tg_type, |
| layer_id); |

varchar toponame;
integer tg_type;
integer layer_id;

説明

layer_idで示されたレイヤでTopoGeometryオブジェクトを生成し、toponameスキーマの関連テーブルに登録します。

tg_typeは次の整数値とします: 1:[multi]point (点), 2:[multi]line (線), 3:[multi]poly (面), 4:collection。layer_idは、topology.layerテーブル内のレイヤ識別番号です。

点レイヤはノードの集合から形成され、線レイヤはエッジの集合から形成され、面レイヤはフェイスの集合から形成され、コレクションはノード、エッジ、フェイスの混合から形成されます。

要素の配列を省略した場合、空のTopoGeometryオブジェクトが生成されます。

Availability: 1.1

例: 既存エッジからの形成

ri_topoスキーマ内 (ST_CreateTopoGeoの例でロードしてあります)で、ラインタイプ (整数値で2)の、layer_idが2のレイヤ (ri_roads)の最初のエッジからTopoGeometryを生成します。

INSERT INTO ri.ri_roads(road_name, topo) VALUES('Unknown', topology.CreateTopoGeom('ri_topo',2,2,'{{1,2}}'::topology.topoelementarray);

例: 面ジオメトリから最善と推測されるTopoGeometryへの変換

フェイスのコレクションから形成されるジオメトリがあるとします。blockgroupsテーブルがあり、それぞれの区画群のTopoGeometryを知りたいとします。データが完全に整列しているなら、次のようにできます。

-- TopoGeometryカラムの生成 --
SELECT topology.AddTopoGeometryColumn(
        'topo_boston',
        'boston', 'blockgroups', 'topo', 'POLYGON');

-- addtopgeometrycolumn --
1

-- 全てが完全にエッジに沿っている前提での
-- カラムの更新
UPDATE boston.blockgroups AS bg
        SET topo = topology.CreateTopoGeom('topo_boston'
        ,3,1
        , foo.bfaces)
FROM (SELECT b.gid,  topology.TopoElementArray_Agg(ARRAY[f.face_id,3]) As bfaces
        FROM boston.blockgroups As b
            INNER JOIN topo_boston.face As f ON b.geom && f.mbr
        WHERE ST_Covers(b.geom, topology.ST_GetFaceGeometry('topo_boston', f.face_id))
            GROUP BY b.gid) As foo
WHERE foo.gid = bg.gid;

-- 世界が誤差を完璧に許容することは、ほぼありません。
-- 50%がblockgroupの境界の内側に落ちるフェイスを数えます。
UPDATE boston.blockgroups AS bg
        SET topo = topology.CreateTopoGeom('topo_boston'
        ,3,1
        , foo.bfaces)
FROM (SELECT b.gid,  topology.TopoElementArray_Agg(ARRAY[f.face_id,3]) As bfaces
        FROM boston.blockgroups As b
            INNER JOIN topo_boston.face As f ON b.geom && f.mbr
        WHERE ST_Covers(b.geom, topology.ST_GetFaceGeometry('topo_boston', f.face_id))
        OR
 (  ST_Intersects(b.geom, topology.ST_GetFaceGeometry('topo_boston', f.face_id))
            AND ST_Area(ST_Intersection(b.geom, topology.ST_GetFaceGeometry('topo_boston', f.face_id) ) ) >
                ST_Area(topology.ST_GetFaceGeometry('topo_boston', f.face_id))*0.5
                )
            GROUP BY b.gid) As foo
WHERE foo.gid = bg.gid;

-- TopoGeometryから
-- フェイスやエッジに沿うような正規化がなされていないジオメトリに
-- 戻すには、topoをジオメトリにキャストします。
-- 新しいジオメトリは、Tigerの道路中心線に沿っていて、とても素晴らしいです。
UPDATE boston.blockgroups SET new_geom = topo::geometry;

関連情報

AddTopoGeometryColumn, toTopoGeom ST_CreateTopoGeo, ST_GetFaceGeometry, TopoElementArray, TopoElementArray_Agg

Name

toTopoGeom — 単純なジオメトリからTopoGeometryを生成します。

Synopsis

topogeometry toTopoGeom( | geom, |
| toponame, |
| layer_id, |
| tolerance); |

geometry geom;
varchar toponame;
integer layer_id;
float8 tolerance;

topogeometry toTopoGeom( | geom, |
| topogeom, |
| tolerance); |

geometry geom;
topogeometry topogeom;
float8 tolerance;

説明

単純なジオメトリからTopoGeometryを生成します。

入力ジオメトリを表現するために必要なトポロジプリミティブが、下位にあるトポロジに追加されます。既存のものを分割することもあります。relationテーブル内のTopoGeometryの出力に紐づきます。

既存のTopoGeometryオブジェクトは形状を維持します (topogeomが与えられている場合には、それが例外となる可能性があります)。

toleranceは、与えられた場合には、入力ジオメトリを既存のプリミティブにスナップさせるために使われます。

1番目の形式では、新しいTopoGeometryは、与えられたトポロジ (toponame)の与えられたレイヤ (layer_id)に作られます。

2番目の形式では、変換結果のプリミティブが、既存のTopoGeometry (topogeom)に追加されます。また、最終の形状にスペースを追加することがあります。新しい形状を完全に持つには、古いものを入れ替えます。clearTopoGeomを参照して下さい。

Availability: 2.0

Enhanced: 2.1.0版では、既存のTopoGeometryを取る形式が追加されました。

例

これは完全に全て揃ったワークフローです。

-- トポロジのセットアップがまだ終わっていない場合に実行します。
-- 許容値を許可しません。
SELECT topology.CreateTopology('topo_boston_test', 2249);
-- 新しいテーブルの生成
CREATE TABLE nei_topo(gid serial primary key, nei varchar(30));
-- TopoGeometryカラムの追加
SELECT topology.AddTopoGeometryColumn('topo_boston_test', 'public', 'nei_topo', 'topo', 'MULTIPOLYGON') As new_layer_id;
new_layer_id
-----------
1

-- 新しいTopoGeometryカラムの投入に新しいレイヤIDを使います。
-- TopoGeometryを新しいレイヤに許容値0で追加します。
INSERT INTO nei_topo(nei, topo)
SELECT nei,  topology.toTopoGeom(geom, 'topo_boston_test', 1)
FROM neighborhoods
WHERE gid BETWEEN 1 and 15;

-- 何が発生したかの確認
SELECT * FROM
    topology.TopologySummary('topo_boston_test');

-- 結果--
Topology topo_boston_test (5), SRID 2249, precision 0
61 nodes, 87 edges, 35 faces, 15 topogeoms in 1 layers
Layer 1, type Polygonal (3), 15 topogeoms
 Deploy: public.nei_topo.topo

-- 全てのTopoGeometryポリゴンを10メートル縮小
UPDATE nei_topo SET topo = ST_Buffer(clearTopoGeom(topo), -10);

-- 上の操作で何も無いようになった土地の取得
-- GRASSでは"polygon0 layer"と呼ばれているものと思います
SELECT ST_GetFaceGeometry('topo_boston_test', f.face_id)
  FROM topo_boston_test.face f
  WHERE f.face_id
> 0 -- don't consider the universe face
  AND NOT EXISTS ( -- check that no TopoGeometry references the face
    SELECT * FROM topo_boston_test.relation
    WHERE layer_id = 1 AND element_id = f.face_id
  );

関連情報

CreateTopology, AddTopoGeometryColumn, CreateTopoGeom, TopologySummary, clearTopoGeom

Name

TopoElementArray_Agg — element_idとタイプの配列 (topoelements)からなるtopoelementarrayを返します。

Synopsis

topoelementarray TopoElementArray_Agg(
tefield);

topoelement set tefield;

説明

TopoElementArrayをTopoElementの集合から生成するために使います。

Availability: 2.0.0

例

SELECT topology.TopoElementArray_Agg(ARRAY[e,t]) As tea
  FROM generate_series(1,3) As e CROSS JOIN generate_series(1,4) As t;
  tea
--------------------------------------------------------------------------
{{1,1},{1,2},{1,3},{1,4},{2,1},{2,2},{2,3},{2,4},{3,1},{3,2},{3,3},{3,4}}

関連情報

TopoElement, TopoElementArray

Name

TopoElement — TopoGeometryをTopoElementに変換します。

Synopsis

topoelement TopoElement(
topo);

topogeometry topo;

説明

TopoGeometryをTopoElementに変換します。

Availability: 3.4.0

例

これは完全に全て揃ったワークフローです。

-- トポロジをセットアップしてえいない場合には次を実行します
-- 許容範囲を許さないトポロジを生成します
SELECT TopoElement(topo)
FROM neighborhoods;

-- キャストを使用
SELECT topology.TopoElementArray_Agg(topo::topoelement)
FROM neighborhoods
GROUP BY city;

関連情報

TopoElementArray_Agg, TopoGeometry, TopoElement

TopoGeometryエディタ

Abstract

本節では、既存のTopoGeometryを編集する関数を挙げます。

Name

clearTopoGeom — TopoGeometryの中身を消去します。

Synopsis

topogeometry clearTopoGeom(
topogeom);

topogeometry topogeom;

説明

TopoGeometryの中身を消去し、空にします。toTopoGeomと併用して、既存オブジェクトと上位にある依存オブジェクトの形状の置換に、だいたい便利です。

Availability: 2.1

例

-- 全てのTopoGeometryポリゴンを10メートル縮める
UPDATE nei_topo SET topo = ST_Buffer(clearTopoGeom(topo), -10);

関連情報

toTopoGeom

Name

TopoGeom_addElement — TopoGeometryの定義に要素を追加します。

Synopsis

topogeometry TopoGeom_addElement( | tg, |
| el); |

topogeometry tg;
topoelement el;

説明

TopoElementをTopoGeometryオブジェクトの定義に追加します。要素がすでに定義の一部になっていても、エラーは発生しません。

Availability: 2.3

例

-- 5番エッジをTopoGeometry tgに追加
UPDATE mylayer SET tg = TopoGeom_addElement(tg, '{5,2}');

関連情報

TopoGeom_remElement, CreateTopoGeom

Name

TopoGeom_remElement — TopoGeometryの定義から要素を削除します。

Synopsis

topogeometry TopoGeom_remElement( | tg, |
| el); |

topogeometry tg;
topoelement el;

説明

TopoGeometryオブジェクトの定義からTopoElementを削除します。

Availability: 2.3

例

-- TopoGeometry tgから43番フェイスを削除します
UPDATE mylayer SET tg = TopoGeom_remElement(tg, '{43,3}');

関連情報

TopoGeom_addElement, CreateTopoGeom

Name

TopoGeom_addTopoGeom — TopoGeometryの要素を他のTopoGeometryの定義に追加します。

Synopsis

topogeometry TopoGeom_addTopoGeom( | tgt, |
| src); |

topogeometry tgt;
topogeometry src;

説明

TopoGeometryの要素を他のTopoGeometryの定義に追加します。ソースオブジェクト内にすべての要素を保持する必要がある場合には、キャッシュされたタイプ (type属性)をコレクションに変更する可能性があります。

二つのTopoGeometryオブジェクトは*同じ*トポロジに対して定義されている必要があります。また、階層的な定義がある場合には、同じ子レイヤの要素で構成されている必要があります。

Availability: 3.2

例

-- 「全体的」なTopoGeometry値を
-- 指定したTopoGeometry値の全ての要素で構成する値に設定
UPDATE mylayer SET tg_overall = TopoGeom_addTopogeom(
    TopoGeom_addTopoGeom(
        clearTopoGeom(tg_overall),
        tg_specific1
    ),
    tg_specific2
);

関連情報

TopoGeom_addElement, clearTopoGeom, CreateTopoGeom

Name

toTopoGeom — ジオメトリの形状を既存のTopoGeometryに追加します。

説明

toTopoGeomを参照して下さい。

TopoGeometryアクセサ

Name

GetTopoGeomElementArray — 与えられたTopoGeometry (プリミティブ要素)のトポロジ要素とタイプを含むtopoelementarray (topoelementの配列)を返します。

Synopsis

topoelementarray GetTopoGeomElementArray( | toponame, |
| layer_id, |
| tg_id); |

varchar toponame;
integer layer_id;
integer tg_id;

topoelementarray GetTopoGeomElementArray(
tg);

topogeometry tg;

説明

トポロジ要素と与えられたTopoGeometry (プリミティブ要素)のタイプを含むTopoElementArrayを返します。GetTopoGeomElementsに近いですが、これは、要素群をデータセットでなく配列で返しています。

tg_idは、topology.layerテーブル内のlayer_idで指定されたレイヤのトポロジにおけるTopoGeometryオブジェクトの識別番号です。

Availability: 1.1

例

関連情報

GetTopoGeomElements, TopoElementArray

Name

GetTopoGeomElements — 与えられたTopoGeometry (プリミティブ要素)の、トポロジのelement_idとelement_typeを含むtopoelementオブジェクトの集合を返します。

Synopsis

setof topoelement GetTopoGeomElements( | toponame, |
| layer_id, |
| tg_id); |

varchar toponame;
integer layer_id;
integer tg_id;

setof topoelement GetTopoGeomElements(
tg);

topogeometry tg;

説明

toponameスキーマ内で与えられたTopoGeometryオブジェクトを形成するプリミティブなトポロジ要素 TopoElement (1:ノード、2:エッジ、3:フェイス)に対応したelement_id, element_type (topoelements)の集合を返します。

tg_idは、topology.layerテーブル内のlayer_idで指定されたレイヤのトポロジにおけるTopoGeometryオブジェクトの識別番号です。

Availability: 2.0.0

例

関連情報

GetTopoGeomElementArray, TopoElement, TopoGeom_addElement, TopoGeom_remElement

Name

ST_SRID — TopoGeometryの空間参照識別子を返します。

Synopsis

integer ST_SRID(
tg);

topogeometry tg;

説明

ST_Geometryのspatial_ref_sysテーブルで定義されている空間参照系の識別番号を返します。the section called “空間参照系”を参照して下さい。

Note

spatial_ref_sysテーブルはPostGISが知る参照系の全てのカタログを作っていて、ある空間参照系から他の空間参照系に変換するために使われます。ジオメトリの変換を予定している場合は正しい空間参照系の識別番号を持っているか確認することは重要です。

Availability: 3.2.0

説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 14.1.5

例

SELECT ST_SRID(ST_GeomFromText('POINT(-71.1043 42.315)',4326));
                -- 結果
                4326

関連情報

the section called “空間参照系”, ST_SetSRID, ST_Transform, ST_SRID

TopoGeometry出力

Name

AsGML — TopoGeometryのGML表現を返します。

Synopsis

text AsGML(
tg);

topogeometry tg;

text AsGML( | tg, |
| nsprefix_in); |

topogeometry tg;
text nsprefix_in;

text AsGML( | tg, |
| visitedTable); |

topogeometry tg;
regclass visitedTable;

text AsGML( | tg, |
| visitedTable, |
| nsprefix); |

topogeometry tg;
regclass visitedTable;
text nsprefix;

text AsGML( | tg, |
| nsprefix_in, |
| precision, |
| options); |

topogeometry tg;
text nsprefix_in;
integer precision;
integer options;

text AsGML( | tg, |
| nsprefix_in, |
| precision, |
| options, |
| visitedTable); |

topogeometry tg;
text nsprefix_in;
integer precision;
integer options;
regclass visitedTable;

text AsGML( | tg, |
| nsprefix_in, |
| precision, |
| options, |
| visitedTable, |
| idprefix); |

topogeometry tg;
text nsprefix_in;
integer precision;
integer options;
regclass visitedTable;
text idprefix;

text AsGML( | tg, |
| nsprefix_in, |
| precision, |
| options, |
| visitedTable, |
| idprefix, |
| gmlversion); |

topogeometry tg;
text nsprefix_in;
integer precision;
integer options;
regclass visitedTable;
text idprefix;
int gmlversion;

説明

GML3の書式でTopoGeometryのGML表現を返します。nsprefix_inが指定されていない場合には、gmlが使われます。非修飾名前空間を得るにはnsprefixに空文字列を渡します。精度 (デフォルトは15)とoptions (デフォルトは1)パラメタは、与えられた場合には、裏で呼んでいるST_AsGMLにそのまま渡します。

visitedTableパラメタは、与えられた場合には、訪問したノード要素とエッジ要素のトラックを保持するために使われ、重複定義になるところで相互参照 (xlink:xref)を使います。テーブルは 整数カラムである'element_type'と'element_id'とを持つことを期待されます。この関数を呼び出したユーザは、このテーブルへの読み込み権限と書き込み権限とが必要です。効率よくするには、 element_typeとelement_idに、この順序でインデックスを定義します。インデックスは一意制約をカラムに追加すると自動的に生成されます。例を示します。

CREATE TABLE visited (
  element_type integer, element_id integer,
  unique(element_type, element_id)
);

idprefixパラメタは、指定された場合には、Edgeタグ識別子とNodeタグ識別子の前に付きます。

gmlverパラメタは、指定された場合には、裏で呼んでいるST_AsGMLに渡されます。デフォルトは3です。

Availability: 2.0.0

例

ここではCreateTopoGeomで生成したTopoGeometryを使用しています。

SELECT topology.AsGML(topo) As rdgml
  FROM ri.roads
  WHERE road_name = 'Unknown';

-- rdgml--
<gml:TopoCurve>
    <gml:directedEdge>
        <gml:Edge gml:id="E1">
            <gml:directedNode orientation="-">
                <gml:Node gml:id="N1"/>
            </gml:directedNode>
            <gml:directedNode
></gml:directedNode>
            <gml:curveProperty>
                <gml:Curve srsName="urn:ogc:def:crs:EPSG::3438">
                    <gml:segments>
                        <gml:LineStringSegment>
                            <gml:posList srsDimension="2"
>384744 236928 384750 236923 384769 236911 384799 236895 384811 236890
                            384833 236884 384844 236882 384866 236881 384879 236883 384954 236898 385087 236932 385117 236938
                            385167 236938 385203 236941 385224 236946 385233 236950 385241 236956 385254 236971
                            385260 236979 385268 236999 385273 237018 385273 237037 385271 237047 385267 237057 385225 237125
                            385210 237144 385192 237161 385167 237192 385162 237202 385159 237214 385159 237227 385162 237241
                            385166 237256 385196 237324 385209 237345 385234 237375 385237 237383 385238 237399 385236 237407
                            385227 237419 385213 237430 385193 237439 385174 237451 385170 237455 385169 237460 385171 237475
                            385181 237503 385190 237521 385200 237533 385206 237538 385213 237541 385221 237542 385235 237540 385242 237541
                            385249 237544 385260 237555 385270 237570 385289 237584 385292 237589 385291 237596 385284 237630</gml:posList>
                        </gml:LineStringSegment>
                    </gml:segments>
                </gml:Curve>
            </gml:curveProperty>
        </gml:Edge>
    </gml:directedEdge>
</gml:TopoCurve
>

上の例から名前空間を取り除いた例です。

SELECT topology.AsGML(topo,'') As rdgml
  FROM ri.roads
  WHERE road_name = 'Unknown';

-- rdgml--
<TopoCurve>
    <directedEdge>
        <Edge id="E1">
            <directedNode orientation="-">
                <Node id="N1"/>
            </directedNode>
            <directedNode
></directedNode>
            <curveProperty>
                <Curve srsName="urn:ogc:def:crs:EPSG::3438">
                    <segments>
                        <LineStringSegment>
                            <posList srsDimension="2"
>384744 236928 384750 236923 384769 236911 384799 236895 384811 236890
                            384833 236884 384844 236882 384866 236881 384879 236883 384954 236898 385087 236932 385117 236938
                            385167 236938 385203 236941 385224 236946 385233 236950 385241 236956 385254 236971
                            385260 236979 385268 236999 385273 237018 385273 237037 385271 237047 385267 237057 385225 237125
                            385210 237144 385192 237161 385167 237192 385162 237202 385159 237214 385159 237227 385162 237241
                            385166 237256 385196 237324 385209 237345 385234 237375 385237 237383 385238 237399 385236 237407
                            385227 237419 385213 237430 385193 237439 385174 237451 385170 237455 385169 237460 385171 237475
                            385181 237503 385190 237521 385200 237533 385206 237538 385213 237541 385221 237542 385235 237540 385242 237541
                            385249 237544 385260 237555 385270 237570 385289 237584 385292 237589 385291 237596 385284 237630</posList>
                         </LineStringSegment>
                    </segments>
                </Curve>
            </curveProperty>
        </Edge>
    </directedEdge>
</TopoCurve
>

関連情報

CreateTopoGeom, ST_CreateTopoGeo

Name

AsTopoJSON — opoGeometryのTopoJSON表現を返します。

Synopsis

text AsTopoJSON( | tg, |
| edgeMapTable); |

topogeometry tg;
regclass edgeMapTable;

説明

TopoGeometryのTopoJSON表現を返します。edgeMapTableがNULLでない場合には、エッジ識別番号とアーク添え字のルックアップと格納のマッピングに使われます。これは、最終的な文書内のコンパクトな"arcs"配列ができるようにするためです。

このテーブルは、与えられた場合には、"serial"型の"arc_id"カラムと整数型の"edge_id"とを持つことが期待されます。関数はこのテーブルに"edge_id"を問い合わせるので、このカラムにインデクスを追加することが推奨されます。

Note

TopoJSONでのアークのインデックスは0始まりですが、"edgeMapTable"テーブルでは1始まりです。

完全なTopoJSON文書は、この関数が返すスニペットだけでなく、実際のarcsメンバと、いくつかのヘッダを含む必要があります。 TopoJSON specificationをご覧ください。

Availability: 2.1.0

Enhanced: 2.2.1 点入力に対応するようになりました

関連情報

ST_AsGeoJSON

例

CREATE TEMP TABLE edgemap(arc_id serial, edge_id int unique);

-- ヘッダ
SELECT '{ "type": "Topology", "transform": { "scale": [1,1], "translate": [0,0] }, "objects": {'

-- オブジェクトn
UNION ALL SELECT '"' || feature_name || '": ' || AsTopoJSON(feature, 'edgemap')
FROM features.big_parcels WHERE feature_name = 'P3P4';

-- アーク
WITH edges AS (
  SELECT m.arc_id, e.geom FROM edgemap m, city_data.edge e
  WHERE e.edge_id = m.edge_id
), points AS (
  SELECT arc_id, (st_dumppoints(geom)).* FROM edges
), compare AS (
  SELECT p2.arc_id,
         CASE WHEN p1.path IS NULL THEN p2.geom
              ELSE ST_Translate(p2.geom, -ST_X(p1.geom), -ST_Y(p1.geom))
         END AS geom
  FROM points p2 LEFT OUTER JOIN points p1
  ON ( p1.arc_id = p2.arc_id AND p2.path[1] = p1.path[1]+1 )
  ORDER BY arc_id, p2.path
), arcsdump AS (
  SELECT arc_id, (regexp_matches( ST_AsGeoJSON(geom), '\[.*\]'))[1] as t
  FROM compare
), arcs AS (
  SELECT arc_id, '[' || array_to_string(array_agg(t), ',') || ']' as a FROM arcsdump
  GROUP BY arc_id
  ORDER BY arc_id
)
SELECT '}, "arcs": [' UNION ALL
SELECT array_to_string(array_agg(a), E',\n') from arcs

-- フッタ
UNION ALL SELECT ']}'::text as t;

-- 結果 --
{ "type": "Topology", "transform": { "scale": [1,1], "translate": [0,0] }, "objects": {
"P3P4": { "type": "MultiPolygon", "arcs": [[[-1]],[[6,5,-5,-4,-3,1]]]}
}, "arcs": [
 [[25,30],[6,0],[0,10],[-14,0],[0,-10],[8,0]],
 [[35,6],[0,8]],
 [[35,6],[12,0]],
 [[47,6],[0,8]],
 [[47,14],[0,8]],
 [[35,22],[12,0]],
 [[35,14],[0,8]]
 ]}

トポロジ空間関係関数

Abstract

本節ではTopoGeometryとトポロジプリミティブとの間の関係を見るトポロジ関数の一覧を挙げます。

Name

Equals — 二つのTopoGeometryが同じトポロジプリミティブで成っている場合にtrueを返します。

Synopsis

boolean Equals( | tg1, |
| tg2); |

topogeometry tg1;
topogeometry tg2;

説明

二つTopoGeometryが同じトポロジプリミティブで成っている場合にtrueを返します。

Note

この関数はジオメトリコレクションのTopoGeometryに対応していません。異なるトポロジからなるTopoGeometryとの比較もできません。

Availability: 1.1.0

説明この関数は3次元に対応し、Z値を削除しません。

例

関連情報

GetTopoGeomElements, ST_Equals

Name

Intersects — 二つのTopoGeometryからのプリミティブの組がインタセクトする場合にtrueを返します。

Synopsis

boolean Intersects( | tg1, |
| tg2); |

topogeometry tg1;
topogeometry tg2;

説明

二つのTopoGeometryからのプリミティブがインタセクトする場合にtrueを返します。

Note

この関数はジオメトリコレクションのTopoGeometryに対応していません。異なるトポロジからなるTopoGeometryとの比較もできません。また、現在のところ、階層TopoGeometry (他のTopoGeometryからなるTopoGeometry)に対応していません。

Availability: 1.1.0

説明この関数は3次元に対応し、Z値を削除しません。

例

関連情報

ST_Intersects

トポロジのインポートとエクスポート

トポロジを生成したり、場合によってはトポロジレイヤに関連付けると、バックアップや他のデータベースへの転送のために、ファイルに出力するフォーマットでエクスポートした方がいいでしょう。

トポロジはテーブルの集合 (プリミティブで4テーブル、レイヤで任意数)と、メタデータテーブルのレコード (topology.topologyとtopology.layer)になっているため、PostgreSQLの標準的なダンプ/レストアのツールでは問題があります。さらに、トポロジの識別子はデータベース間で同じではないため、トポロジのパラメータはレストア時に変更する必要があります。

トポロジのエクスポート/レストアを簡単化するために、二つの実行可能ファイルが提供されています。pgtopo_exportとpgtopo_importです。使用例は次の通りです。

pgtopo_export dev_db topo1 | pgtopo_import topo1 | psql staging_db

トポロジエクスポータの使用

pgtopo_exportスクリプトはデータベース名とトポロジ名を取り、トポロジ (と関連するレイヤ)を新しいデータベースにインポートするために使うことができるダンプファイルを出力します。

デフォルトではpgtopo_exportはダンプファイルを標準出力に書くので、pgtopo_importにパイプで繋げたり、ファイルにリダイレクトする (端末への出力を止める)ことができます。出力ファイル名をコマンドラインスイッチ-fで指定することもできます。

デフォルトではpgtopo_exportは、指定されたトポロジに対して定義されたレイヤの全てのダンプが含まれます。これは、必要なデータより多い場合もありますし、動作しない場合もあり (レイヤテーブルが複雑な依存関係を持っている場合)、この場合には--skip-layersスイッチでレイヤをスキップし、別々に処理することができます。

pgtopo_exportを--help (または短縮の-h)スイッチで実行すると、常に短い使用法文字列を印字します。

ダンプファイルフォーマットは、少なくともフォーマットバージョン情報を持つpgtopo_dump_versionファイルを含むpgtopo_exportディレクトリの圧縮されたtarアーカイブです。バージョン1では、ディレクトリにはトポロジのプリミティブテーブル (node, edge_data, face, relation)と、プリミティブと関連付けられたトポロジとレイヤとを持つタブ区切りCSVファイルが含まれ、(--skip-layersが与えられない場合)与えられたトポロジのレイヤとして報告されたテーブルのPostgrfeSQLダンプのカスタムフォーマットも含まれます。

トポロジインポータの使用

pgtopo_importスクリプトはpgtopo_export書式のトポロジのダンプと、生成するトポロジに与える名前とを取り、そこからトポロジと関連するレイヤを再構築するSQLスクリプトを出力します。

生成されたSQLには、与えられた名前でトポロジを生成し、プリミティブなデータをロードし、格納して、TopoGeometry値を確実に正しいトポロジに関連付けることで全てのトポロジレイヤを登録する手続きが含まれます。

デフォルトではpgtopo_importは標準入力からダンプを読むので、pgtopo_exportをパイプで繋げて併用することができます。入力ファイル名をコマンドラインスイッチ-fで指定することもできます。

デフォルトではpgtopo_importのSQLファイル出力には、ダンプで発見された全てのレイヤを格納するためのコードが含まれます。

これらは、ダンプ内にあるテーブル名が既に対象データベース内のテーブル名で使われている場合には、望ましくないようになるか動作しない可能性があります。この場合には、レイヤをスキップする--skip-layersスイッチを使い、別に (または後で)処理することができます。

ロードして、レイヤを名前付きトポロジにリンクするSQLは--only-layersスイッチで生成できます。これは、名前の競合を解決した*後に*レイヤをロードしたり、異なるトポロジのレイヤ (開始トポロジで空間的に単純化されたもの等が挙げられます)にリンクするのに使えます。

Chapter 9. ラスタデータの管理、クエリ、アプリケーション

ラスタのロードと生成

raster2pgsqlラスタローダを使ってPostGISラスタを既存のラスタファイルからロードするのは、最もよく行われます。

raster2pgsqlを使ってラスタをロードする

raster2pgsqlは、GDALがサポートするラスタ書式をPostGISラスタテーブルにロードするのに適切なSQLにする実行ファイルです。ラスタのオーバビューの生成だけでなく、ラスタファイルのフォルダのロードも可能です。

かなり多くの場合、(ご自分のGDALライブラリをコンパイルしない限り) raster2pgsqlはPostGISの一部としてコンパイルされるので、実行ファイルがサポートするラスタタイプはGDALの依存ライブラリでコンパイルされたものと同じになります。お手持ちのraster2pgsqlがサポートするラスタタイプの一覧は、-Gスイッチで見ることができます。

Note

同じアラインメントを持つラスタの集合から特定の要素のオーバビューを生成する時、オーバビューが同じアラインメントを持たないことがあります。オーバビューが同じアラインメントを持たない例についてはhttp://trac.osgeo.org/postgis/ticket/1764をご覧下さい。

使用例

ローダを用いて入力ファイルを100x100のタイルで生成して、データベースにアップロードする例は、次の通りです。

# -s SRID 4326を使用します
# -I 空間インデックスを作ります
# -C 標準的なラスタ制約を使用します
# -M ロード後vacuum analyzeを実行します
# *.tif 該当する全てのファイルをロードします
# -F ラスタテーブルにfilenameカラムを入れます
# -t 100x100のタイル出力にします
# public.demelevation このテーブルにロードします
raster2pgsql -s 4326 -I -C -M -F -t 100x100 *.tif public.demelevation
> elev.sql

# -d このデータベースに接続します
# -f ロード後にこのファイルを読み込みます
psql -d gisdb -f elev.sql

Note

対象テーブル名の一部としてスキーマを指定しない場合には、テーブルはデータベースのデフォルトスキーマ内かユーザが接続しているスキーマ内に作られます。

変換とアップロードはUNIXのパイプを使うと一回で実行できます。

raster2pgsql -s 4326 -I -C -M *.tif -F -t 100x100 public.demelevation | psql -d gisdb

マサチューセッツ州平面のメートル単位の空中写真タイルをaerialという名前のスキーマにロードします。 元の画像と2, 4レベルのオーバビューのテーブルとを生成します。 データ格納にCOPYを使用し (データベースに仲介ファイルなくまっすぐ入ります)、-eでトランザクションを指定しないようにします (待たずにテーブルのデータを見たい場合には良いです)。ラスタを128x128ピクセルのタイルに分解してラスタ制約を適用します。INSERTモードでなくCOPYモードを使用します。-Fで、カラム名をタイル切り出し元ファイルのファイル名にします。

raster2pgsql -I -C -e -Y -F -s 26986 -t 128x128  -l 2,4 bostonaerials2008/*.jpg aerials.boston | psql -U postgres -d gisdb -h localhost -p 5432

-- サポートされているラスタタイプの一覧:
raster2pgsql -G

-Gコマンドの出力は次のようになります。

Available GDAL raster formats:
  Virtual Raster
  GeoTIFF
  National Imagery Transmission Format
  Raster Product Format TOC format
  ECRG TOC format
  Erdas Imagine Images (.img)
  CEOS SAR Image
  CEOS Image
  ...
  Arc/Info Export E00 GRID
  ZMap Plus Grid
  NOAA NGS Geoid Height Grids

raster2pgsqlオプション

-?

ヘルプを表示します。引数を全く指定しない場合にも表示されます。

-G

サポートされているラスタ書式を印字します。

(c|a|d|p) 相互に排他的なオプションです。

-c

新しいテーブルを生成し、ラスタを入れます。これがデフォルトモードです。

-a

既存のテーブルにラスタを追加します。

-d

テーブルを削除し、新しいテーブルを生成し、ラスタを入れます。

-p

準備モード、テーブルを作るだけです。

ラスタ処理: ラスタカタログに適切に登録するための制約の適用

-C

SRIDやピクセルサイズ等のラスタ制約を適用して、raster_columnsビューで適切な登録ができるようにします。

-x

制約の最大範囲を無効にします。-Cフラグが使われている場合のみ適用されます。

-r

正規ブロック制約 (空間的に一意で網羅タイル)を適用します。-Cフラグが使用されている場合のみ適用されます。

ラスタ処理: 入力ラスタデータセットの操作に使われる追加的なパラメータ

-s <SRID>

出力ラスタを指定されたSRIDにします。 指定しないか0を指定した場合、ラスタのメタデータに対して、適切なSRIDを決定するためのチェックを行います。

-b BAND

ラスタから抽出するバンドのインデクス (1始まり)。1より多いバンドを抽出するには、コンマ(,)で区切ります。指定しない場合、全てのバンドが抽出されます。

-t TILE_SIZE

行毎に挿入するラスタを切断します。TILE_SIZEは、「幅x高さ」で表現しますが、"auto"を指定すると、最初のラスタを使って適切なタイルサイズが計算され、全てのラスタに適用されます。

-P

全てのタイルが同じ幅と高さを持つことを保証するために、右端、下端のタイルに詰め物を施します。

-R, --register

ファイルシステム (データベース外)ラスタとして、ラスタを登録します。

データベースには、ラスタのメタデータとラスタのファイルパスのみ格納されます (ピクセルは格納されません)。

-l OVERVIEW_FACTOR

ラスタのオーバビューを生成します。一つより多い係数を用いる場合は、コンマ (,) で区切ります。オーバビューのテーブル名はo_overview factor_tableとなります。overview factorにはオーバビュー係数が入り、tableには基底テーブル名が入ります。生成されるオーバビューはデータベースに格納され、-Rは無視されます。生成されたSQLファイルは元データのテーブルとオーバビューテーブルの両方を含むことに注意して下さい。

-N NODATA

NODATA値を持たないバンドで使用するNODATA値を設定します。

テータベースオブジェクトの操作に使われる追加的なパラメータ

-f COLUMN

出力先ラスタカラムの名前を指定します。デフォルトは'rast'です。

-F

ファイル名でカラムを追加します。

-n COLUMN

ファイル名カラムの名前を指定します。-Fを暗に含みます。

-q

PostgreSQL識別子に引用符を付けます。

-I

ラスタカラムにGiSTインデクスを生成します。

-M

ラスタテーブルにvacuum analyzeを行います。

-k

空タイルを保持してラスタバンドごとのNODATA値のチェックを省きます。チェック時間を抑えることになりますが、データベース内の不要な行がずっと増えて、これらの行が空タイルとされないことに注意して下さい。

-T tablespace

生成されるテーブルのテーブルスペースを指定します。-Xフラグを併用しない場合には、インデクス (主キーを含む)はデフォルトのテーブルスペースを使用することにご注意ください。

-X tablespace

テーブルの新しいインデクスに使うテーブル空間を指定します。主キーに適用され、-Iフラグがある場合においては空間インデクスにも適用されます。

-Y max_rows_per_copy=50

COPYステートメントを使い、INSERTを使いません。任意でmax_rows_per_copyを指定します。指定しない場合のデフォルト値は50です。

-e

ステートメント毎に実行して、トランザクションを使用しないようにします。

-E ENDIAN

生成されるラスタのバイナリ出力のエンディアンを制御します。XDR (訳注: ビッグエンディアン)の場合は0を、NDR (訳注:リトルエンディアン)の場合は1を、それぞれ指定します。デフォルトは1です。現時点ではNDR出力のみサポートします。

-V version

出力書式の版を指定します。デフォルトは0です。現時点では0のみサポートします。

PostGISラスタ関数を用いたラスタの生成

データベース内でラスタやラスタテーブルを生成したい場合が多くあります。これを行うための関数が多数あります。一般的な手順は次の通りです。

新しいラスタ行を保持するためのラスタカラムを持つテーブルを生成します。次を実行します。

CREATE TABLE myrasters(rid serial primary key, rast raster);

この目標で助けとなる関数は多数あります。他のラスタの派生でないラスタを生成する場合、ST_MakeEmptyRasterとST_AddBandを順次実行して作業を開始します。

ジオメトリからラスタを生成することもできます。ST_AsRasterを使います。ST_UnionやST_MapAlgebraFctや、地図解析関数群等といった、他の関数を組み合わせる場合もあります。

既存テーブルから新しいラスタテーブルを生成するための多数の選択肢があります。たとえば、ST_Transformを使って、既存テーブルから異なる投影法のラスタテーブルを生成します。

はじめにテーブルにデータを入れたら、ラスタカラムに空間インデクスを生成したくなるでしょう。次のようにします。

CREATE INDEX myrasters_rast_st_convexhull_idx ON myrasters USING gist( ST_ConvexHull(rast) );

ST_ConvexHullを使用していることに注意して下さい。多くのラスタ演算子はラスタの凸包を元にしています。

Note

2.0より前の PostGIS ラスタは、エンベロープを基本にして、凸包ではありませんでした。空間インデクスを適切に働かせるには、エンベロープを基本にしたインデクスを削除して、凸包を元にしたインデクスに置き換えます。

AddRasterConstraintsを用いてラスタ制約を適用します。

「データベース外」クラウドラスタの使用

raster2pgsqlツールはGDALを使用してラスタデータにアクセスします。また、クラウドの「オブジェクト保存」 (AWS S3やGoogle Cloud Storage等)にリモート格納されたラスタを読む能力という、重要なGDAL機能の利点を享受することができます。

クラウドストレージの効率的な仕様には、「クラウド最適化」された書式の使用が必要です。最も知られて幅広く使われているものは、 "cloud optimized GeoTIFF"です。JPEGや非タイル化TIFFなどの非クラウド書式を使うと、発揮される能力は非常に貧弱になります。システムがラスタの一部分にアクセスする必要に迫られるたびに全体をダウンロードするためです。

まず、ラスタをあなたが選択したクラウドストレージに保存します。保存したら、アクセスに使うURIが得られます。"http"URIか、時々特別なサービスを示すURI ( "s3://bucket/object"等)です。非公開バケットにアクセスするには、接続認証のためのGDALコンフィギュレーションオプションが必要になります。このコマンドはクラウドラスタから読み、データベースに書きます。

AWS_ACCESS_KEY_ID=xxxxxxxxxxxxxxxxxxxx \
AWS_SECRET_ACCESS_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx \
raster2pgsql \
  -s 990000 \
  -t 256x256 \
  -I \
  -R \
  /vsis3/your.bucket.com/your_file.tif \
  your_table \
  | psql your_db

テーブルがロードされたら、データベースにリモートラスタらか読むためのアクセス許可を与えます。postgis.enable_outdb_rastersとpostgis.gdal_enabled_driversの、二つのアクセス許可を設定します。

SET postgis.enable_outdb_rasters = true;
SET postgis.gdal_enabled_drivers TO 'ENABLE_ALL';

確実に変更するには、データベースに直接設定します。新しい設定を使うには再接続が必要です。

ALTER DATABASE your_db SET postgis.enable_outdb_rasters = true;
ALTER DATABASE your_db SET postgis.gdal_enabled_drivers TO 'ENABLE_ALL';

非公開ラスタの場合、クラウドラスタから読み取るアクセスキーを与えなければならない場合があります。raster2pgsqlの書き込みに使用したのと同じキーを、データベース内でpostgis.gdal_config_options設定と共に使用するように設定できます。key=valueペアをスペースで区切ることで、複数のオプションを設定できることに注意してください。

SET postgis.gdal_vsi_options = 'AWS_ACCESS_KEY_ID=xxxxxxxxxxxxxxxxxxxx
AWS_SECRET_ACCESS_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';

データをロードし、パーミッションが設定されると、ラスタテーブルは他のラスタテーブルとおなじように、同じ関数を使って、対話的処理が可能となります。データベースは、ピクセルデータの読み取りが必要なら、クラウドへの接続の全てを扱います。

ラスタカタログ

PostGISが生成する、二つのラスタカタログのビューがあります。両方ともラスタテーブルの制約の中に埋め込まれる情報を用いています。結果として、カタログビューは、テーブル内のラスタデータに制約が働くため、常にラスタデータとの矛盾がありません。

raster_columns ラスタタイプのデータベースにおける全てのラスタテーブルカラムのカタログです。

raster_overviews データベース内の、より詳細なテーブルのためのオーバビューを提供するラスタテーブルのカラム全てのカタログです。この種のテーブルは、ロード時に-lを指定した時に生成されます。

ラスタカラムカタログ

raster_columnsは、ラスタタイプのデータベースにおける全てのラスタテーブルカラムのカタログです。テーブルの制約を使ったビューなので、他のデータベースのバックアップからラスタテーブルをリストアしたとしても、情報は常に矛盾がありません。raster_columnsカタログには次のカラムがあります。

ローダを使わずにテーブルを生成したり、ロード時に-C フラグを忘れたりした場合には、事後にAddRasterConstraintsで制約を強制でき、raster_columnsカタログは、ラスタタイルの共通の情報を登録します。

r_table_catalog テーブルが存在するデータベースです。これは常に現在のデータベースを読みます。

r_table_schema ラスタテーブルが属するデータベーススキーマです。

r_table_name ラスタテーブルです。

r_raster_column ラスタタイプであるr_table_nameテーブルのカラムです。PostGISには、一つのテーブルに複数のラスタカラムを持つことを妨げません。異なるラスタカラムを持つラスタテーブルが、ラスタカラム毎に複数回出現するテーブルを持つことができます。

srid ラスタの空間参照系識別番号です。the section called “空間参照系”にあるエントリであるべきです。

scale_x 地理空間座標とピクセルの間の拡大縮小係数です。これは、ラスタカラムのすべてのタイルが同じscale_xを持ち、制約が適用されている場合のみ出現します。詳細情報についてはST_ScaleXを参照してください。

scale_y 地理空間座標とピクセルの間の拡大縮小係数です。これは、ラスタカラムのすべてのタイルが同じscale_yを持ち、scale_yの制約が適用されている場合のみ出現します。詳細情報についてはST_ScaleYを参照してください。

blocksize_x ラスタタイルごとの幅 (横方向のピクセル数)です。詳細情報についてはST_Widthを参照してください。

blocksize_y ラスタタイルごとの高さ (縦方向のピクセル数)です。詳細情報についてはST_Heightを参照してください。

same_alignment 全てのラスタタイルが同じアラインメントを持っているかを示す真偽値です。詳細情報についてはST_SameAlignmentを参照してください。

regular_blocking ラスタカラムが空間的に一意かつカバレッジタイルの制約を持つなら、TRUEとなります。その他の場合はFALSEになります。。

num_bands ラスタ集合のタイルごとのバンド数。これと同じ情報が得られる関数は ST_NumBands

pixel_types バンドごとのピクセルタイプを定義する配列です。この配列の要素数はバンド数と同じです。pixel_typesは、ST_BandPixelTypeで定義されるピクセルタイプの一つを取ります。

nodata_values バンド毎のnodata_valueを示す倍精度浮動小数点数の配列です。バンド数と同じ配列数となります。これらの値は、バンド毎のほとんどの処理で無視されるべきピクセル値の定義です。これはST_BandNoDataValueで得られる情報と似ています。

out_db ラスタバンドデータがデータベース外で維持されているかを示す真偽値の配列です。この配列の添え字はバンド番号と同じです。

extent ラスタ集合における全てのラスタ行の範囲です。集合の範囲を変更するデータを別途ロードする予定である場合、ロード前にDropRasterConstraints関数を実行して、ロード後にAddRasterConstraintsで制約を再適用します。

spatial_index 空間インデクスを持っているかどうかを示す真偽値です。

ラスタオーバビュー

raster_overviewsは、オーバビューで使われるラスタテーブルカラムに関する情報のカタログで、オーバビューを用いる際に知っておくと便利な情報も持ちます。オーバビューテーブルはraster_columnsとraster_overviewsの両方のカタログに入れられます。オーバビューもラスタの一つであるのは確かですが、より高い解像度テーブルの解像度を落としたカリカチュアになるという特殊な目的を満たすためでもあるからです。ラスタをロードする際に-lスイッチを使うと、オーバビューが主ラスタテーブルと一緒に生成されます。もしくは、AddOverviewConstraintsを使うと手動で生成できます。

オーバビューテーブルには、他のラスタテーブルと同じ制約と、オーバビュー特有の制約となる追加情報があります。

Note

raster_overviewsの情報はraster_columnsとは重複しません。raster_columnsにあるオーバビューテーブルに関する情報が必要な場合は、raster_overviewsとraster_columnsとを結合すると、必要な情報の集合を完全に取得することができます。

オーバビューの主たる理由は次の二つです。

ズームアウトした際の地図表示を早くするために、元のテーブルの低解像度表現が一般的に使われます。

レコード数が少なく、ピクセル毎の適用範囲が広いため、高解像度の元テーブルより計算が一般的に早くなります。計算は高解像度テーブルより精度は落ちますが、大まかな計算には十分でありえます。

raster_overviewsカタログには、次の情報のカラムがあります。

o_table_catalog オーバビューテーブルが存在するデータベースです。常に現在のデータベースを読みます。

o_table_schema オーバビューラスタテーブルが属するデータベーススキーマです。

o_table_name ラスタオーバビューテーブル名です。

o_raster_column オーバビューテーブル内のラスタカラムです。

r_table_catalog このオーバビューの元となるラスタテーブルのデータベースです。常に現在のデータベースを読みます。

r_table_schema このオーバビューの元となるラスタテーブルが属するデータベーススキーマです。

r_table_name このオーバビューの元となるラスタテーブルです。

r_raster_column このオーバビューの元となるラスタカラムです。

overview_factor - オーバビューテーブルのピラミッドレベルです。高い数字ほど解像度が低くなります。raster2pgsqlは、画像のフォルダを渡された場合は、分割して、イメージファイルのオーバビューの計算とロードを行います。レベル1は元ファイルと同じです。レベル2は、元ファイルの4分の1になります。たとえば、5000x5000ピクセルの画像ファイルのフォルダがあるとして、125x125に分ける場合、画像ファイルごとに(5000*5000)/(125*125) = 1600行のレコードを持ち、o_2テーブル (レベル2)はceiling(1600/Power(2,2)) = 400行、o_3(レベル3)ではceiling(1600/Power(2,3) ) = 200行のレコードを持ちます。ピクセルがタイルサイズで割り切れない場合、スクラップタイル (完全には値が入っていない)が得られます。raster2pgsqlによって生成される個々のオーバビュータイルは、元となるラスタと同じピクセル数を持ち、個々のピクセルの表現範囲 (オリジナルの Power(2,overview_factor)ピクセル分)が低い解像度になっている点に注意して下さい。

PostGISラスタを使ったカスタムアプリケーションの構築

PostGISラスタに知られている画像書式でラスタをレンダリングするためのSQL関数があります。このことから多数のレンダリングの選択肢が使えます。たとえば、OpenOffice/LibreOfficeを使ってレンダリングが可能で、Rendering PostGIS Raster graphics with LibreOffice Base Reportsにデモンストレーションがあります。さらに、本節で示す通り、多種多様な言語を使用できます。

ST_AsPNG を他の関数とあわせて使った PHP 出力例

本節では、PHPのPostgreSQLドライバとST_AsGDALRaster等の関数を使って、HTML imgタグに埋め込むことができるPHPリクエストストリームにラスタの1、2、3バンドを出力する方法を示します。

サンプルクエリでは、 指定したWGS84バウンディングボックスにインタセクトするタイルを取って、 ST_Unionでインタセクトしたタイルを結合して全てのバンドを返し、ST_Transformでユーザ指定投影法に変換し、ST_AsPNGを使ってPNGで結果を出力するためのラスタ関数群全体をまとめる方法を示します。

次で示すスクリプトは、

http://mywebserver/test_raster.php?srid=2249

で、マサチューセッツ州平面 (フィート単位)のラスタ画像を取得するものです。

<?php
/** test_raster.phpのコンテンツ **/
$conn_str ='dbname=mydb host=localhost port=5432 user=myuser password=mypwd';
$dbconn = pg_connect($conn_str);
header('Content-Type: image/png');
/** 特定の投影法が要求された場合にはそれを使い、それ以外ではメートル単位マサチューセッツ州平面を使います **/
if (!empty( $_REQUEST['srid'] ) && is_numeric( $_REQUEST['srid']) ){
                $input_srid = intval($_REQUEST['srid']);
}
else { $input_srid = 26986; }
/** set bytea_outputは、PostgreSQL 9.0以上で必要になるかも知れませんが、8.4では不要です **/
$sql = "set bytea_output='escape';
SELECT ST_AsPNG(ST_Transform(
                        ST_AddBand(ST_Union(rast,1), ARRAY[ST_Union(rast,2),ST_Union(rast,3)])
                                ,$input_srid) ) As new_rast
 FROM aerials.boston
        WHERE
         ST_Intersects(rast, ST_Transform(ST_MakeEnvelope(-71.1217, 42.227, -71.1210, 42.218,4326),26986) )";
$result = pg_query($sql);
$row = pg_fetch_row($result);
pg_free_result($result);
if ($row === false) return;
echo pg_unescape_bytea($row[0]);
?>

ST_AsPNGを他の関数とあわせて使ったASP.NET C#出力例

本節では、Npgsql PostgreSQL .NETドライバとST_AsGDALRaster等の関数を使って、HTML imgタグに埋め込むことができるように、ラスタの1、2、3バンドを出力する方法を示します。

この例ではNpgsql .NET PostgreSQLドライバが必要です。最新版はhttp://npgsql.projects.postgresql.org/にあります。最新版をダウンロードして、ASP.NET の binフォルダに入れるだけでうまくいきます。

サンプルクエリでは、 指定したWGS84バウンディングボックスにインタセクトするタイルを取って、 ST_Unionでインタセクトしたタイルを結合して全てのバンドを返し、ST_Transformでユーザ指定投影法に変換し、ST_AsPNGを使ってPNGで結果を出力するためのラスタ関数群全体をまとめる方法を示します。

この例はC#で実装している点を除いてはthe section called “ST_AsPNG を他の関数とあわせて使った PHP 出力例”と同じです。

次で示すスクリプトは、

http://mywebserver/TestRaster.ashx?srid=2249

で、マサチューセッツ州平面 (フィート単位)のラスタ画像を取得します。

-- web.config 接続文字列部 --
<connectionStrings>
    <add name="DSN"
        connectionString="server=localhost;database=mydb;Port=5432;User Id=myuser;password=mypwd"/>
</connectionStrings
>

// TestRaster.ashxのコード
<%@ WebHandler Language="C#" Class="TestRaster" %>
using System;
using System.Data;
using System.Web;
using Npgsql;

public class TestRaster : IHttpHandler
{
        public void ProcessRequest(HttpContext context)
        {

                context.Response.ContentType = "image/png";
                context.Response.BinaryWrite(GetResults(context));

        }

        public bool IsReusable {
                get { return false; }
        }

        public byte[] GetResults(HttpContext context)
        {
                byte[] result = null;
                NpgsqlCommand command;
                string sql = null;
                int input_srid = 26986;
        try {
                    using (NpgsqlConnection conn = new NpgsqlConnection(System.Configuration.ConfigurationManager.ConnectionStrings["DSN"].ConnectionString)) {
                            conn.Open();

                if (context.Request["srid"] != null)
                {
                    input_srid = Convert.ToInt32(context.Request["srid"]);
                }
                sql = @"SELECT ST_AsPNG(
                            ST_Transform(
                                        ST_AddBand(
                                ST_Union(rast,1), ARRAY[ST_Union(rast,2),ST_Union(rast,3)])
                                                    ,:input_srid) ) As new_rast
                        FROM aerials.boston
                                WHERE
                                    ST_Intersects(rast,
                                    ST_Transform(ST_MakeEnvelope(-71.1217, 42.227, -71.1210, 42.218,4326),26986) )";
                            command = new NpgsqlCommand(sql, conn);
                command.Parameters.Add(new NpgsqlParameter("input_srid", input_srid));

                            result = (byte[]) command.ExecuteScalar();
                conn.Close();
                        }

                }
        catch (Exception ex)
        {
            result = null;
            context.Response.Write(ex.Message.Trim());
        }
                return result;
        }
}

rasterクエリを画像ファイルで出力するJavaコンソールアプリケーション

これは、一つの画像を返すクエリを取り、指定したファイルに出力する、簡単なJavaコンソールアプリケーションです。

最新のPostgreSQL JDBCドライバはhttp://jdbc.postgresql.org/download.htmlからダウンロードできます。

あとで示すコードをコンパイルします。コマンドは次の通りです。

set env CLASSPATH .:..\postgresql-9.0-801.jdbc4.jar
javac SaveQueryImage.java
jar cfm SaveQueryImage.jar Manifest.txt *.class

次のようにコマンドラインから呼び出します。

java -jar SaveQueryImage.jar "SELECT ST_AsPNG(ST_AsRaster(ST_Buffer(ST_Point(1,5),10, 'quad_segs=2'),150, 150, '8BUI',100));" "test.png"

-- Manifest.txt --
Class-Path: postgresql-9.0-801.jdbc4.jar
Main-Class: SaveQueryImage

// SaveQueryImage.javaのコード
import java.sql.Connection;
import java.sql.SQLException;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.io.*;

public class SaveQueryImage {
  public static void main(String[] argv) {
      System.out.println("Checking if Driver is registered with DriverManager.");

      try {
        //java.sql.DriverManager.registerDriver (new org.postgresql.Driver());
        Class.forName("org.postgresql.Driver");
      }
      catch (ClassNotFoundException cnfe) {
        System.out.println("Couldn't find the driver!");
        cnfe.printStackTrace();
        System.exit(1);
      }

      Connection conn = null;

      try {
        conn = DriverManager.getConnection("jdbc:postgresql://localhost:5432/mydb","myuser", "mypwd");
        conn.setAutoCommit(false);

        PreparedStatement sGetImg = conn.prepareStatement(argv[0]);

        ResultSet rs = sGetImg.executeQuery();

                FileOutputStream fout;
                try
                {
                        rs.next();
                        /** Output to file name requested by user **/
                        fout = new FileOutputStream(new File(argv[1]) );
                        fout.write(rs.getBytes(1));
                        fout.close();
                }
                catch(Exception e)
                {
                        System.out.println("Can't create file");
                        e.printStackTrace();
                }

        rs.close();
                sGetImg.close();
        conn.close();
      }
      catch (SQLException se) {
        System.out.println("Couldn't connect: print out a stack trace and exit.");
        se.printStackTrace();
        System.exit(1);
      }
  }
}

PLPython を使って SQL を介して画像をダンプする

これは、サーバディレクトリ内でレコードごとにファイルを生成するPythonストアド関数です。plpythonが必要です。plpythonuとplpython3uの両方が正しく動作します。

CREATE OR REPLACE FUNCTION write_file (param_bytes bytea, param_filepath text)
RETURNS text
AS $$
f = open(param_filepath, 'wb+')
f.write(param_bytes)
return param_filepath
$$ LANGUAGE plpythonu;

-- 5つの画像をPostgreSQLサーバに可変サイズで描きます。
-- PostgreSQLデーモンのアカウントにフォルダへの書き込み権限が必要ですので
-- ご注意ください。
-- 生成されたファイル名をエコーバックします。
 SELECT write_file(ST_AsPNG(
        ST_AsRaster(ST_Buffer(ST_Point(1,5),j*5, 'quad_segs=2'),150*j, 150*j, '8BUI',100)),
         'C:/temp/slices'|| j || '.png')
         FROM generate_series(1,5) As j;

     write_file
---------------------
 C:/temp/slices1.png
 C:/temp/slices2.png
 C:/temp/slices3.png
 C:/temp/slices4.png
 C:/temp/slices5.png

PSQLでラスタを出力する

PSQLから組み込み機能を用いてバイナリを出力するのは簡単ではありません。ここで紹介する方法は、レガシーなラージオブジェクトをサポートするPostgreSQL上に乗っかる、ちょっとしたハックです。まずは、psqlを起動して、データベースに接続します。

この方法はPythonの場合と違い、ローカル機にファイルが生成されます。

SELECT oid, lowrite(lo_open(oid, 131072), png) As num_bytes
 FROM
 ( VALUES (lo_create(0),
   ST_AsPNG( (SELECT rast FROM aerials.boston WHERE rid=1) )
  ) ) As v(oid,png);
-- 次のような出力が得られます --
   oid   | num_bytes
---------+-----------
 2630819 |     74860

-- 続いて、oidを書き留めて、'C:/temp/aerial_smap.png'を
-- ローカルのコンピュータ上のファイルパスに置き換えたうえで、
-- 次を実行します。
 \lo_export 2630819 'C:/temp/aerial_samp.png'

-- db上のラージオブジェクトストレージからファイルを削除します
SELECT lo_unlink(2630819);

Chapter 10. ラスタ リファレンス

ここで挙げる関数は、PostGISラスタにとって必要と思われるもので、現在PostGISラスタで有効なものです。他に、一般的なユーザが利用しない、ラスタオブジェクトに対して求められるサポート関数があります。

rasterは、ラスタデータの格納と分析のための新しいPostGIS型です。

ラスタファイルからラスタをロードするにはthe section called “ラスタのロードと生成”を参照して下さい。

このリファレンスにおける例ではダミーラスタのラスタテーブルを使っています。ラスタは次のようなコードで形成しています。

CREATE TABLE dummy_rast(rid integer, rast raster);
INSERT INTO dummy_rast(rid, rast)
VALUES (1,
('01' -- little endian - リトルエンディアン (uint8 ndr)
||
'0000' -- version - 版 (uint16 0)
||
'0000' -- nBands - バンド数 (uint16 0)
||
'0000000000000040' -- scaleX - X方向セルサイズ (float64 2)
||
'0000000000000840' -- scaleY - Y方向セルサイズ (float64 3)
||
'000000000000E03F' -- ipX - 左上隅X値 (float64 0.5)
||
'000000000000E03F' -- ipY - 左上隅Y値 (float64 0.5)
||
'0000000000000000' -- skewX - スキューX (float64 0)
||
'0000000000000000' -- skewY - スキューY (float64 0)
||
'00000000' -- SRID (int32 0)
||
'0A00' -- width - 横セル数 (uint16 10)
||
'1400' -- height - 縦セル数 (uint16 20)
)::raster
),
-- Raster: 5 x 5 pixels, 3 bands, PT_8BUI pixel type, NODATA = 0
(2,  ('01000003009A9999999999A93F9A9999999999A9BF000000E02B274A' ||
'41000000007719564100000000000000000000000000000000FFFFFFFF050005000400FDFEFDFEFEFDFEFEFDF9FAFEF' ||
'EFCF9FBFDFEFEFDFCFAFEFEFE04004E627AADD16076B4F9FE6370A9F5FE59637AB0E54F58617087040046566487A1506CA2E3FA5A6CAFFBFE4D566DA4CB3E454C5665')::raster);

ラスタサポートデータ型

Abstract

本節では、ラスタ機能をサポートするために作られたPostgreSQLデータ型の一覧を挙げます。

ラスタ管理

Name

AddRasterConstraints — ロードされたラスタテーブルの特定のカラムにラスタ制約を追加します。制約には空間参照系、スケール、ブロックサイズ、アラインメント、バンド数、バンド型、ラスタカラムが規則正しいブロックかどうかを示すフラグがあります。テーブルは制約が推論されるためのデータがロードされなければなりません。制約の設定が完了するとtrueを返し、問題があると通知を返します。

Synopsis

boolean AddRasterConstraints( | rasttable, |
| rastcolumn, |
| srid=true, |
| scale_x=true, |
| scale_y=true, |
| blocksize_x=true, |
| blocksize_y=true, |
| same_alignment=true, |
| regular_blocking=false, |
| num_bands=true, |
| pixel_types=true, |
| nodata_values=true, |
| out_db=true, |
| extent=true); |

name rasttable;
name rastcolumn;
boolean srid=true;
boolean scale_x=true;
boolean scale_y=true;
boolean blocksize_x=true;
boolean blocksize_y=true;
boolean same_alignment=true;
boolean regular_blocking=false;
boolean num_bands=true ;
boolean pixel_types=true ;
boolean nodata_values=true ;
boolean out_db=true ;
boolean extent=true ;

boolean AddRasterConstraints( | rasttable, |
| rastcolumn, |
| VARIADIC constraints); |

name rasttable;
name rastcolumn;
text[] VARIADIC constraints;

boolean AddRasterConstraints( | rastschema, |
| rasttable, |
| rastcolumn, |
| VARIADIC constraints); |

name rastschema;
name rasttable;
name rastcolumn;
text[] VARIADIC constraints;

boolean AddRasterConstraints( | rastschema, |
| rasttable, |
| rastcolumn, |
| srid=true, |
| scale_x=true, |
| scale_y=true, |
| blocksize_x=true, |
| blocksize_y=true, |
| same_alignment=true, |
| regular_blocking=false, |
| num_bands=true, |
| pixel_types=true, |
| nodata_values=true, |
| out_db=true, |
| extent=true); |

name rastschema;
name rasttable;
name rastcolumn;
boolean srid=true;
boolean scale_x=true;
boolean scale_y=true;
boolean blocksize_x=true;
boolean blocksize_y=true;
boolean same_alignment=true;
boolean regular_blocking=false;
boolean num_bands=true;
boolean pixel_types=true;
boolean nodata_values=true ;
boolean out_db=true ;
boolean extent=true ;

説明

ラスタカラム上に、ラスタカタログraster_columnsで情報を表示するために使われる制約を生成します。rastschemaは、テーブルがあるテーブルスキーマの名前です。sridはSPATIAL_REF_SYSテーブル内のエントリを参照する整数でなければなりません。

raster2pgsqlはこの関数を使ってラスタテーブルを登録します。

渡すのに妥当な制約名は次の通りです。詳細情報についてはthe section called “ラスタカラムカタログ”を参照して下さい。

blocksize ブロックのXとY両方のサイズを指定します

blocksize_x Xタイル(タイル毎のピクセル幅)を設定します

blocksize_y Yタイル(タイル毎のピクセル幅)を設定します

extent テーブル全体の範囲を計算し、全てのラスタがこの範囲内にある制約を適用します

num_bands バンド数

pixel_types バンドごとにピクセルタイプを読み、全てのバンドが同じピクセルタイプであることを確認します。

regular_blocking 空間的に一意 (二つのラスタが空間的に同じにならない)であり、カバレッジタイル (ラスタがカバレッジに整列する)制約であるようにします。

same_alignment 同じアラインメントを持つようにします。任意の2タイルについて比較するとtrueを返すという意味です。ST_SameAlignmentを参照して下さい。

srid 全て同じSRIDを持っていることを確認するためのものです。

その他 -- 上の関数への入力で一覧が挙げられています。

Note

この関数はテーブル内に存在するデータから制約を推論します。動作させるには、まずラスタカラムを生成し、その後にデータをロードする必要があります。

Note

制約を適用した後にデータをさらにロードする必要がある場合には、データ範囲が変わるならDropRasterConstraintsを使います。

Availability: 2.0.0

例: カラムに対して全てのありえる制約をデータに基づいて適用する

CREATE TABLE myrasters(rid SERIAL primary key, rast raster);
INSERT INTO myrasters(rast)
SELECT ST_AddBand(ST_MakeEmptyRaster(1000, 1000, 0.3, -0.3, 2, 2, 0, 0,4326), 1, '8BSI'::text, -129, NULL);

SELECT AddRasterConstraints('myrasters'::name, 'rast'::name);

-- raster_columnsビューに正しく登録されたか確認 --
SELECT srid, scale_x, scale_y, blocksize_x, blocksize_y, num_bands, pixel_types, nodata_values
    FROM raster_columns
    WHERE r_table_name = 'myrasters';

 srid | scale_x | scale_y | blocksize_x | blocksize_y | num_bands | pixel_types| nodata_values
------+---------+---------+-------------+-------------+-----------+-------------+---------------
 4326 |       2 |       2 |        1000 |        1000 |         1 | {8BSI}      | {0}

例: 単一の制約を適用する

CREATE TABLE public.myrasters2(rid SERIAL primary key, rast raster);
INSERT INTO myrasters2(rast)
SELECT ST_AddBand(ST_MakeEmptyRaster(1000, 1000, 0.3, -0.3, 2, 2, 0, 0,4326), 1, '8BSI'::text, -129, NULL);

SELECT AddRasterConstraints('public'::name, 'myrasters2'::name, 'rast'::name,'regular_blocking', 'blocksize');
-- 通知が出ます --
NOTICE:  Adding regular blocking constraint
NOTICE:  Adding blocksize-X constraint
NOTICE:  Adding blocksize-Y constraint

関連情報

the section called “ラスタカラムカタログ”, ST_AddBand, ST_MakeEmptyRaster, DropRasterConstraints, ST_BandPixelType, ST_SRID

Name

DropRasterConstraints — ラスタテーブルカラムを参照するPostGISラスタ制約を削除します。データの再読み込みやラスタカラムデータの更新の際に使えます。

Synopsis

boolean DropRasterConstraints( | rasttable, |
| rastcolumn, |
| srid, |
| scale_x, |
| scale_y, |
| blocksize_x, |
| blocksize_y, |
| same_alignment, |
| regular_blocking, |
| num_bands=true, |
| pixel_types=true, |
| nodata_values=true, |
| out_db=true, |
| extent=true); |

name rasttable;
name rastcolumn;
boolean srid;
boolean scale_x;
boolean scale_y;
boolean blocksize_x;
boolean blocksize_y;
boolean same_alignment;
boolean regular_blocking;
boolean num_bands=true;
boolean pixel_types=true;
boolean nodata_values=true;
boolean out_db=true ;
boolean extent=true;

boolean DropRasterConstraints( | rastschema, |
| rasttable, |
| rastcolumn, |
| srid=true, |
| scale_x=true, |
| scale_y=true, |
| blocksize_x=true, |
| blocksize_y=true, |
| same_alignment=true, |
| regular_blocking=false, |
| num_bands=true, |
| pixel_types=true, |
| nodata_values=true, |
| out_db=true, |
| extent=true); |

name rastschema;
name rasttable;
name rastcolumn;
boolean srid=true;
boolean scale_x=true;
boolean scale_y=true;
boolean blocksize_x=true;
boolean blocksize_y=true;
boolean same_alignment=true;
boolean regular_blocking=false;
boolean num_bands=true;
boolean pixel_types=true;
boolean nodata_values=true;
boolean out_db=true ;
boolean extent=true;

boolean DropRasterConstraints( | rastschema, |
| rasttable, |
| rastcolumn, |
| constraints); |

name rastschema;
name rasttable;
name rastcolumn;
text[] constraints;

説明

AddRasterConstraintsで追加された、ラスタテーブルカラムを参照するPostGISラスタ制約を削除します。データの追加ロードやラスタカラムデータの更新で使えます。ラスタテーブルまたはラスタカラムのridを取得したい場合には使う必要がありません。

ラスタテーブルを削除するには、次の標準的なSQLを使います。

DROP TABLE mytable

ラスタカラムを削除してテーブルの残りのカラムを置いておくには、次の標準的なSQLを使います。

ALTER TABLE mytable DROP COLUMN rast

カラムまたはテーブルが削除されると、テーブルはraster_columnsカタログから見えなくなります。しかしながら、制約だけが削除されたので、ラスタカラムはなおraster_columnsカタログに残ります。ただし、カラム名とテーブルからの内部に関する他の情報は存在しません。

Availability: 2.0.0

例

SELECT DropRasterConstraints ('myrasters','rast');
-- 結果出力 --
t

-- raster_columnsが変更されたことを確認 --
SELECT srid, scale_x, scale_y, blocksize_x, blocksize_y, num_bands, pixel_types, nodata_values
    FROM raster_columns
    WHERE r_table_name = 'myrasters';

 srid | scale_x | scale_y | blocksize_x | blocksize_y | num_bands | pixel_types| nodata_values
------+---------+---------+-------------+-------------+-----------+-------------+---------------
    0 |         |         |             |             |           |             |

関連情報

AddRasterConstraints

Name

AddOverviewConstraints — ラスタカラムに対して、他のオーバビューであることをタグ付けします。

Synopsis

boolean AddOverviewConstraints( | ovschema, |
| ovtable, |
| ovcolumn, |
| refschema, |
| reftable, |
| refcolumn, |
| ovfactor); |

name ovschema;
name ovtable;
name ovcolumn;
name refschema;
name reftable;
name refcolumn;
int ovfactor;

boolean AddOverviewConstraints( | ovtable, |
| ovcolumn, |
| reftable, |
| refcolumn, |
| ovfactor); |

name ovtable;
name ovcolumn;
name reftable;
name refcolumn;
int ovfactor;

説明

raster_overviewsラスタカタログ内の情報を表示するために使われるラスタカラムに制約を追加します。

ovfactor引数は、オーバビューカラムの縮尺乗数を示します。縮尺乗数は大きいほど低い解像度になります。

ovschemaとrefschemaが省略されると、search_pathを走査して発見した最初のテーブルを使います。

Availability: 2.0.0

例

CREATE TABLE res1 AS SELECT
ST_AddBand(
  ST_MakeEmptyRaster(1000, 1000, 0, 0, 2),
  1, '8BSI'::text, -129, NULL
) r1;

CREATE TABLE res2 AS SELECT
ST_AddBand(
  ST_MakeEmptyRaster(500, 500, 0, 0, 4),
  1, '8BSI'::text, -129, NULL
) r2;

SELECT AddOverviewConstraints('res2', 'r2', 'res1', 'r1', 2);

-- raster_overviewsビューに正しく登録されたか確認します --
SELECT o_table_name ot, o_raster_column oc,
       r_table_name rt, r_raster_column rc,
       overview_factor f
FROM raster_overviews WHERE o_table_name = 'res2';
  ot  | oc |  rt  | rc | f
------+----+------+----+---
 res2 | r2 | res1 | r1 | 2
(1 row)

関連情報

the section called “ラスタオーバビュー”, DropOverviewConstraints, ST_CreateOverview, AddRasterConstraints

Name

DropOverviewConstraints — ラスタカラムに対して他のオーバビューであることをタグ付けしているのを解除します。

Synopsis

boolean DropOverviewConstraints( | ovschema, |
| ovtable, |
| ovcolumn); |

name ovschema;
name ovtable;
name ovcolumn;

boolean DropOverviewConstraints( | ovtable, |
| ovcolumn); |

name ovtable;
name ovcolumn;

説明

ラスタカラムから、raster_overviewsラスタカタログ内にある、他のラスタのオーバビューであるこをと示すために使われる制約を削除します。

ovschemaが省略されると、search_pathを走査して発見した最初のテーブルを使います。

Availability: 2.0.0

関連情報

the section called “ラスタオーバビュー”, AddOverviewConstraints, DropRasterConstraints

Name

PostGIS_GDAL_Version — PostGISで使っているGDALライブラリの版を報告します。

Synopsis

text PostGIS_GDAL_Version(
);

;

説明

PostGISで使っているGDALライブラリの版を報告します。GDALがデータファイルを発見できるかについてもチェックして、報告します。

例

SELECT PostGIS_GDAL_Version();
       postgis_gdal_version
-----------------------------------
 GDAL 1.11dev, released 2013/04/13

関連情報

postgis.gdal_datapath

Name

PostGIS_Raster_Lib_Build_Date — 完全なラスタライブラリをビルドした日付を報告します。

Synopsis

text PostGIS_Raster_Lib_Build_Date(
);

;

説明

ラスタをビルドした日付を報告します。

例

SELECT PostGIS_Raster_Lib_Build_Date();
postgis_raster_lib_build_date
-----------------------------
2010-04-28 21:15:10

関連情報

PostGIS_Raster_Lib_Version

Name

PostGIS_Raster_Lib_Version — 完全なラスタの版とビルドコンフィギュレーション情報を報告します。

Synopsis

text PostGIS_Raster_Lib_Version(
);

;

説明

完全なラスタの版とビルドコンフィギュレーション情報を報告します。

例

SELECT PostGIS_Raster_Lib_Version();
postgis_raster_lib_version
-----------------------------
 2.0.0

関連情報

PostGIS_Lib_Version

Name

ST_GDALDrivers — 使用しているGDALライブラリが対応するラスタ書式の一覧を返します。この一覧でcan_write=TrueとなっているものだけがST_AsGDALRasterで使えます。

Synopsis

setof record ST_GDALDrivers( | OUT idx, |
| OUT short_name, |
| OUT long_name, |
| OUT can_read, |
| OUT can_write, |
| OUT create_options); |

integer OUT idx;
text OUT short_name;
text OUT long_name;
text OUT can_read;
text OUT can_write;
text OUT create_options;

説明

使用しているGDALライブラリが対応するラスタ書式のshort_name, long_nameと作成オプションの一覧を返します。short_nameは、ST_AsGDALRasterのformatパラメタに使います。オプションはGDALライブラリのコンパイルに使ったドライバに依存します。create_optionsは、XML形式のCretionOptionList/Optionの集合で、ドライバごとの生成オプションごとに、名前を持ち、追加情報のtype, descriptionとVALUEの集合を持ちます。

Changed: 2.5.0 - can_readカラムとcan_writeカラムを追加。

Changed: 2.0.6, 2.1.3 - GUC (訳注: Grand Unified Configurationの略で、動的に変更できるPostgreSQLパラメータ)または環境変数gdal_enabled_driversが設定されていないデフォルトではドライバが全て無効になりました。

Availability: 2.0.0 - GDAL 1.6.0以上が必要です。

例: ドライバ一覧

SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';
SELECT short_name, long_name, can_write
FROM st_gdaldrivers()
ORDER BY short_name;

   short_name    |                          long_name                          | can_write
-----------------+-------------------------------------------------------------+-----------
 AAIGrid         | Arc/Info ASCII Grid                                         | t
 ACE2            | ACE2                                                        | f
 ADRG            | ARC Digitized Raster Graphics                               | f
 AIG             | Arc/Info Binary Grid                                        | f
 AirSAR          | AirSAR Polarimetric Image                                   | f
 ARG             | Azavea Raster Grid format                                   | t
 BAG             | Bathymetry Attributed Grid                                  | f
 BIGGIF          | Graphics Interchange Format (.gif)                          | f
 BLX             | Magellan topo (.blx)                                        | t
 BMP             | MS Windows Device Independent Bitmap                        | f
 BSB             | Maptech BSB Nautical Charts                                 | f
 PAux            | PCI .aux Labelled                                           | f
 PCIDSK          | PCIDSK Database File                                        | f
 PCRaster        | PCRaster Raster File                                        | f
 PDF             | Geospatial PDF                                              | f
 PDS             | NASA Planetary Data System                                  | f
 PDS4            | NASA Planetary Data System 4                                | t
 PLMOSAIC        | Planet Labs Mosaics API                                     | f
 PLSCENES        | Planet Labs Scenes API                                      | f
 PNG             | Portable Network Graphics                                   | t
 PNM             | Portable Pixmap Format (netpbm)                             | f
 PRF             | Racurs PHOTOMOD PRF                                         | f
 R               | R Object Data Store                                         | t
 Rasterlite      | Rasterlite                                                  | t
 RDA             | DigitalGlobe Raster Data Access driver                      | f
 RIK             | Swedish Grid RIK (.rik)                                     | f
 RMF             | Raster Matrix Format                                        | f
 ROI_PAC         | ROI_PAC raster                                              | f
 RPFTOC          | Raster Product Format TOC format                            | f
 RRASTER         | R Raster                                                    | f
 RS2             | RadarSat 2 XML Product                                      | f
 RST             | Idrisi Raster A.1                                           | t
 SAFE            | Sentinel-1 SAR SAFE Product                                 | f
 SAGA            | SAGA GIS Binary Grid (.sdat, .sg-grd-z)                     | t
 SAR_CEOS        | CEOS SAR Image                                              | f
 SDTS            | SDTS Raster                                                 | f
 SENTINEL2       | Sentinel 2                                                  | f
 SGI             | SGI Image File Format 1.0                                   | f
 SNODAS          | Snow Data Assimilation System                               | f
 SRP             | Standard Raster Product (ASRP/USRP)                         | f
 SRTMHGT         | SRTMHGT File Format                                         | t
 Terragen        | Terragen heightfield                                        | f
 TIL             | EarthWatch .TIL                                             | f
 TSX             | TerraSAR-X Product                                          | f
 USGSDEM         | USGS Optional ASCII DEM (and CDED)                          | t
 VICAR           | MIPL VICAR file                                             | f
 VRT             | Virtual Raster                                              | t
 WCS             | OGC Web Coverage Service                                    | f
 WMS             | OGC Web Map Service                                         | t
 WMTS            | OGC Web Map Tile Service                                    | t
 XPM             | X11 PixMap Format                                           | t
 XYZ             | ASCII Gridded XYZ                                           | t
 ZMap            | ZMap Plus Grid                                              | t

例: ドライバ毎のオプション一覧

-- JPEGのXMLカラムから生成オプションをテーブルとして出力します --
-- この生成オプションはST_AsGDALRasterのオプション引数で使えます --
SELECT (xpath('@name', g.opt))[1]::text As oname,
       (xpath('@type', g.opt))[1]::text As otype,
       (xpath('@description', g.opt))[1]::text As descrip
FROM (SELECT unnest(xpath('/CreationOptionList/Option', create_options::xml)) As opt
FROM  st_gdaldrivers()
WHERE short_name = 'JPEG') As g;

       oname        |  otype  |      descrip
--------------------+---------+-------------------------------------------------
 PROGRESSIVE        | boolean | whether to generate a progressive JPEG
 QUALITY            | int     | good=100, bad=0, default=75
 WORLDFILE          | boolean | whether to geneate a worldfile
 INTERNAL_MASK      | boolean | whether to generate a validity mask
 COMMENT            | string  | Comment
 SOURCE_ICC_PROFILE | string  | ICC profile encoded in Base64
 EXIF_THUMBNAIL     | boolean | whether to generate an EXIF thumbnail(overview).
                                By default its max dimension will be 128
 THUMBNAIL_WIDTH    | int     | Forced thumbnail width
 THUMBNAIL_HEIGHT   | int     | Forced thumbnail height
(9 rows)

-- GeoTIFFの生成オプションを生のXMLで出力します --
SELECT create_options
FROM st_gdaldrivers()
WHERE short_name = 'GTiff';

<CreationOptionList>
    <Option name="COMPRESS" type="string-select">
        <Value
>NONE</Value>
        <Value
>LZW</Value>
        <Value
>PACKBITS</Value>
        <Value
>JPEG</Value>
        <Value
>CCITTRLE</Value>
        <Value
>CCITTFAX3</Value>
        <Value
>CCITTFAX4</Value>
        <Value
>DEFLATE</Value>
    </Option>
    <Option name="PREDICTOR" type="int" description="Predictor Type"/>
    <Option name="JPEG_QUALITY" type="int" description="JPEG quality 1-100" default="75"/>
    <Option name="ZLEVEL" type="int" description="DEFLATE compression level 1-9" default="6"/>
    <Option name="NBITS" type="int" description="BITS for sub-byte files (1-7), sub-uint16 (9-15), sub-uint32 (17-31)"/>
    <Option name="INTERLEAVE" type="string-select" default="PIXEL">
        <Value
>BAND</Value>
        <Value
>PIXEL</Value>
    </Option>
    <Option name="TILED" type="boolean" description="Switch to tiled format"/>
    <Option name="TFW" type="boolean" description="Write out world file"/>
    <Option name="RPB" type="boolean" description="Write out .RPB (RPC) file"/>
    <Option name="BLOCKXSIZE" type="int" description="Tile Width"/>
    <Option name="BLOCKYSIZE" type="int" description="Tile/Strip Height"/>
    <Option name="PHOTOMETRIC" type="string-select">
        <Value
>MINISBLACK</Value>
        <Value
>MINISWHITE</Value>
        <Value
>PALETTE</Value>
        <Value
>RGB</Value>
        <Value
>CMYK</Value>
        <Value
>YCBCR</Value>
        <Value
>CIELAB</Value>
        <Value
>ICCLAB</Value>
        <Value
>ITULAB</Value>
    </Option>
    <Option name="SPARSE_OK" type="boolean" description="Can newly created files have missing blocks?" default="FALSE"/>
    <Option name="ALPHA" type="boolean" description="Mark first extrasample as being alpha"/>
    <Option name="PROFILE" type="string-select" default="GDALGeoTIFF">
        <Value
>GDALGeoTIFF</Value>
        <Value
>GeoTIFF</Value>
        <Value
>BASELINE</Value>
    </Option>
    <Option name="PIXELTYPE" type="string-select">
        <Value
>DEFAULT</Value>
        <Value
>SIGNEDBYTE</Value>
    </Option>
    <Option name="BIGTIFF" type="string-select" description="Force creation of BigTIFF file">
        <Value
>YES</Value>
        <Value
>NO</Value>
        <Value
>IF_NEEDED</Value>
        <Value
>IF_SAFER</Value>
    </Option>
    <Option name="ENDIANNESS" type="string-select" default="NATIVE" description="Force endianness of created file. For DEBUG purpose mostly">
        <Value
>NATIVE</Value>
        <Value
>INVERTED</Value>
        <Value
>LITTLE</Value>
        <Value
>BIG</Value>
    </Option>
    <Option name="COPY_SRC_OVERVIEWS" type="boolean" default="NO" description="Force copy of overviews of source dataset (CreateCopy())"/>
</CreationOptionList
>

-- GeoTIFF生成オプションのXMLをテーブルとして出力します --
SELECT (xpath('@name', g.opt))[1]::text As oname,
       (xpath('@type', g.opt))[1]::text As otype,
       (xpath('@description', g.opt))[1]::text As descrip,
       array_to_string(xpath('Value/text()', g.opt),', ') As vals
FROM (SELECT unnest(xpath('/CreationOptionList/Option', create_options::xml)) As opt
FROM  st_gdaldrivers()
WHERE short_name = 'GTiff') As g;

       oname        |     otype     |                               descrip                                |                                   vals
--------------------+---------------+----------------------------------------------------------------------+---------------------------------------------------------------------------
 COMPRESS           | string-select |                                                                      | NONE, LZW, PACKBITS, JPEG, CCITTRLE, CCITTFAX3, CCITTFAX4, DEFLATE
 PREDICTOR          | int           | Predictor Type                                                       |
 JPEG_QUALITY       | int           | JPEG quality 1-100                                                   |
 ZLEVEL             | int           | DEFLATE compression level 1-9                                        |
 NBITS              | int           | BITS for sub-byte files (1-7), sub-uint16 (9-15), sub-uint32 (17-31) |
 INTERLEAVE         | string-select |                                                                      | BAND, PIXEL
 TILED              | boolean       | Switch to tiled format                                               |
 TFW                | boolean       | Write out world file                                                 |
 RPB                | boolean       | Write out .RPB (RPC) file                                            |
 BLOCKXSIZE         | int           | Tile Width                                                           |
 BLOCKYSIZE         | int           | Tile/Strip Height                                                    |
 PHOTOMETRIC        | string-select |                                                                      | MINISBLACK, MINISWHITE, PALETTE, RGB, CMYK, YCBCR, CIELAB, ICCLAB, ITULAB
 SPARSE_OK          | boolean       | Can newly created files have missing blocks?                         |
 ALPHA              | boolean       | Mark first extrasample as being alpha                                |
 PROFILE            | string-select |                                                                      | GDALGeoTIFF, GeoTIFF, BASELINE
 PIXELTYPE          | string-select |                                                                      | DEFAULT, SIGNEDBYTE
 BIGTIFF            | string-select | Force creation of BigTIFF file                                       | YES, NO, IF_NEEDED, IF_SAFER
 ENDIANNESS         | string-select | Force endianness of created file. For DEBUG purpose mostly           | NATIVE, INVERTED, LITTLE, BIG
 COPY_SRC_OVERVIEWS | boolean       | Force copy of overviews of source dataset (CreateCopy())             |
(19 rows)

関連情報

ST_AsGDALRaster, ST_SRID, postgis.gdal_enabled_drivers

Name

ST_Contour — 与えられたラスタバンドから等高線ベクタを生成します。GDAL等高線生成アルゴリズムを使います。

Synopsis

setof record ST_Contour( | rast, |
| bandnumber, |
| level_interval, |
| level_base, |
| fixed_levels, |
| polygonize); |

raster rast;
integer bandnumber;
double precision level_interval;
double precision level_base;
double precision[] fixed_levels;
boolean polygonize;

説明

与えられたラスタバンドから等高線ベクタを生成します。GDAL等高線生成アルゴリズムを使います。

fixed_levelsパラメータが空でない配列である時、level_intervalとlevel_baseとは無視されます。

返り値は次に示す属性を持つ行の集合です。

geom

等高線のジオメトリ。

id

GDALが等高線に与える一意の識別子。

value

ラインが表現するラスタ値。標高DEM入力の場合、出力等高線の標高となります。

Availability: 3.2.0

例

WITH c AS (
SELECT (ST_Contour(rast, 1, fixed_levels =
> ARRAY[100.0, 200.0, 300.0])).*
FROM dem_grid WHERE rid = 1
)
SELECT st_astext(geom), id, value
FROM c;

関連情報

ST_InterpolateRaster

Name

ST_InterpolateRaster — X値とY値を使用してグリッド上のポイントを配置し、ポイントのZ値をサーフェス標高として配置し、3次元ポイントの入力セットに基づいてグリッドサーフェスを補間します。

Synopsis

raster ST_InterpolateRaster( | input_points, |
| algorithm_options, |
| template, |
| template_band_num=1); |

geometry input_points;
text algorithm_options;
raster template;
integer template_band_num=1;

説明

X値とY値を使用してグリッド上のポイントを配置し、ポイントのZ値をサーフェス標高として配置し、3次元ポイントの入力セットに基づいてグリッドサーフェスを補間します。逆距離、逆距離最近傍、移動平均、最近傍、線形補間の五つの補間アルゴリズムが使用できます。アルゴリズムとそれらのパラメータに関する詳細情報についてはgdal_grid documentationを参照して下さい。どのように補間計算が行われているかの詳細情報についてはGDAL grid tutorialをご覧下さい。

入力パラメータは次の通りです。

input_points

補間を駆動するポイント。Z値を持つジオメトリなら全て受け付けられ、全ての入力ポイントが使用されます。

algorithm_options

アルゴリズムとそのオプションを定義する文字列で、gdal_gridで使われる書式で記述します。たとえば、逆距離補間

template

出力ラスタのジオメトリを駆動するためのラスタテンプレート。幅、高さ、ピクセルｙサイズ、空間範囲、ピクセルタイプがこのテンプレートから読み込まれます。

template_band_num

デフォルトではテンプレートラスタの最初のバンドが出力ラスタの駆動に使われますが、このパラメータで調整できます。

Availability: 3.2.0

例

SELECT ST_InterpolateRaster(
    'MULTIPOINT(10.5 9.5 1000, 11.5 8.5 1000, 10.5 8.5 500, 11.5 9.5 500)'::geometry,
    'invdist:smoothing:2.0',
    ST_AddBand(ST_MakeEmptyRaster(200, 400, 10, 10, 0.01, -0.005, 0, 0), '16BSI')
)

関連情報

ST_Contour

Name

UpdateRasterSRID — ユーザが指定したカラムとテーブルにあるラスタの全てについてSRIDを変更します。

Synopsis

raster UpdateRasterSRID( | schema_name, |
| table_name, |
| column_name, |
| new_srid); |

name schema_name;
name table_name;
name column_name;
integer new_srid;

raster UpdateRasterSRID( | table_name, |
| column_name, |
| new_srid); |

name table_name;
name column_name;
integer new_srid;

説明

ユーザが指定したカラムとテーブルにあるラスタの全てについてSRIDを変更します。この関数は全ての適切なカラム制約 (extent, alignment, SRID)を削除してから、指定したカラムのラスタのSRIDを変更します。

Note

この関数はラスタのデータ (バンドピクセル値)を触りません。ラスタのメタデータのみ変更します。

Availability: 2.1.0

関連情報

UpdateGeometrySRID

Name

ST_CreateOverview — 与えられたラスタカバレッジから解像度を落としたものを生成します。

Synopsis

regclass ST_CreateOverview( | tab, |
| col, |
| factor, |
| algo='NearestNeighbor'); |

regclass tab;
name col;
int factor;
text algo='NearestNeighbor';

説明

元のテーブルからリサンプリングを施したタイルのオーバビューテーブルを生成します。出力タイルは入力タイルと同じサイズで、同じ空間範囲を持ち、入力タイルより低い解像度 (ピクセル数は縦横ともに元のタイルの1/factor倍になります)を持ちます。

オーバビューテーブルはraster_overviewsカタログに出現し、ラスタ制約を持ちます。

アルゴリズム指定オプションは'NearestNeighbor', 'Bilinear', 'Cubic', 'CubicSpline', 'Lanczos'です。詳細についてはGDAL Warp resampling methodsをご覧ください。

Availability: 2.2.0

例

高品質ですが遅い生成書式での出力

SELECT ST_CreateOverview('mydata.mytable'::regclass, 'rast', 2, 'Lanczos');

デフォルトの最近傍補間を使った早い処理による出力

SELECT ST_CreateOverview('mydata.mytable'::regclass, 'rast', 2);

関連情報

ST_Retile, AddOverviewConstraints, AddRasterConstraints, the section called “ラスタオーバビュー”

ラスタコンストラクタ

Name

ST_AddBand — 与えられたタイプで、与えられた初期値にした新しいバンドを、与えられたインデクス位置に追加したラスタを返します。インデクス位置を指定していない場合には、バンドは末尾に追加されます。

Synopsis

(1) raster ST_AddBand( | rast, |
| addbandargset); |

raster rast;
addbandarg[] addbandargset;

(2) raster ST_AddBand( | rast, |
| index, |
| pixeltype, |
| initialvalue=0, |
| nodataval=NULL); |

raster rast;
integer index;
text pixeltype;
double precision initialvalue=0;
double precision nodataval=NULL;

(3) raster ST_AddBand( | rast, |
| pixeltype, |
| initialvalue=0, |
| nodataval=NULL); |

raster rast;
text pixeltype;
double precision initialvalue=0;
double precision nodataval=NULL;

(4) raster ST_AddBand( | torast, |
| fromrast, |
| fromband=1, |
| torastindex=at_end); |

raster torast;
raster fromrast;
integer fromband=1;
integer torastindex=at_end;

(5) raster ST_AddBand( | torast, |
| fromrasts, |
| fromband=1, |
| torastindex=at_end); |

raster torast;
raster[] fromrasts;
integer fromband=1;
integer torastindex=at_end;

(6) raster ST_AddBand( | rast, |
| index, |
| outdbfile, |
| outdbindex, |
| nodataval=NULL); |

raster rast;
integer index;
text outdbfile;
integer[] outdbindex;
double precision nodataval=NULL;

(7) raster ST_AddBand( | rast, |
| outdbfile, |
| outdbindex, |
| index=at_end, |
| nodataval=NULL); |

raster rast;
text outdbfile;
integer[] outdbindex;
integer index=at_end;
double precision nodataval=NULL;

説明

与えられたタイプで、与えられた初期値にし、与えられたNODATA値を付した新しいバンドを追加したラスタを返します。インデクス位置を指定していない場合には、バンドは末尾に追加されます。frombandが指定されない場合には、1番バンドと仮定します。ピクセルタイプはST_BandPixelTypeで指定されているピクセルタイプの文字列表現です。既存のインデクスが指定された場合には、以降のバンドは全て1以上足されたインデクスになります。初期値としてピクセルタイプの最大値を超えた値が指定された場合には、初期値にピクセルタイプの許容最大値が指定されます。

addbandargの配列を取る版 (一つ目の版)では、指定したaddbandargのインデクス値は、addbandargで示されるバンドがラスタに追加される時のラスタとの相対値です。下の複数バンドの例を参照してください。

ラスタの配列を取る版 (五つ目の版)では、torastがNULLなら、配列内のラスタごとのfrombandのバンドが新しいラスタに集約されます。

outdbfileを取る版 (六つ目と七つ目の版)では、値はラスタファイルへのフルパスを含まなければなりません。また、ファイルはPostgreSQLサーバプロセスがアクセス可能でなければなりません。

Enhanced: 2.1.0 addbandarg対応が追加されました。

Enhanced: 2.1.0 out-dbバンドが追加されました。

例: 単一バンド

-- 8ビット符号無し整数で初期値200のバンドを追加します
UPDATE dummy_rast
    SET rast = ST_AddBand(rast,'8BUI'::text,200)
WHERE rid = 1;

-- 100x100単位で左上を0,0とした空ラスタを生成して2バンドを追加 (1番は0/1の真偽値、2番は0-15を許容)
-- addbandargを使用
INSERT INTO dummy_rast(rid,rast)
    VALUES(10, ST_AddBand(ST_MakeEmptyRaster(100, 100, 0, 0, 1, -1, 0, 0, 0),
    ARRAY[
        ROW(1, '1BB'::text, 0, NULL),
        ROW(2, '4BUI'::text, 0, NULL)
            ]::addbandarg[]
     )
    );

-- 全て正しく実行できたかを確認するためにラスタバンドのメタデータを出力 --
SELECT  (bmd).*
FROM (SELECT ST_BandMetaData(rast,generate_series(1,2)) As bmd
    FROM dummy_rast WHERE rid = 10) AS foo;
 -- 結果 --
 pixeltype | nodatavalue | isoutdb | path
-----------+----------------+-------------+---------+------
 1BB       |             | f       |
 4BUI      |             | f       |

-- ラスタのメタデータの出力 --
SELECT  (rmd).width, (rmd).height, (rmd).numbands
FROM (SELECT ST_MetaData(rast) As rmd
    FROM dummy_rast WHERE rid = 10) AS foo;
-- 結果 --
 upperleftx | upperlefty | width | height | scalex | scaley | skewx | skewy | srid | numbands
------------+------------+-------+--------+------------+------------+-------+-------+------+----------
          0 |          0 |   100 |    100 |      1 |     -1 |     0 |     0 |   0 |        2

例: 複数の新規バンド

SELECT
    *
FROM ST_BandMetadata(
    ST_AddBand(
        ST_MakeEmptyRaster(10, 10, 0, 0, 1, -1, 0, 0, 0),
        ARRAY[
            ROW(NULL, '8BUI', 255, 0),
            ROW(NULL, '16BUI', 1, 2),
            ROW(2, '32BUI', 100, 12),
            ROW(2, '32BF', 3.14, -1)
        ]::addbandarg[]
    ),
    ARRAY[]::integer[]
);

 bandnum | pixeltype | nodatavalue | isoutdb | path
---------+-----------+-------------+---------+------
       1 | 8BUI      |           0 | f       |
       2 | 32BF      |          -1 | f       |
       3 | 32BUI     |          12 | f       |
       4 | 16BUI     |           2 | f       |

-- 複数のラスタのようなテーブルの1番バンドを集計して単一ラスタに入れます。
-- test_typeと同じ数のバンドを持つ、マウスの数と同じ行 (新しいラスタ)になります。
-- ご注意: ORDER BY test_typeは、PostgreSQL 9.0以上でのみ対応します。
-- 8.4以下では副問い合わせ内の並び順になります (保証もされません)。
-- 結果ラスタはtest_typeのアルファベット順でtest_typeごとのバンドを持ちます
-- マウス好きの方へ: この例ではマウスは傷つきませんでした
SELECT
    mouse,
    ST_AddBand(NULL, array_agg(rast ORDER BY test_type), 1) As rast
FROM mice_studies
GROUP BY mouse;

例: データベース外のバンド

SELECT
    *
FROM ST_BandMetadata(
    ST_AddBand(
        ST_MakeEmptyRaster(10, 10, 0, 0, 1, -1, 0, 0, 0),
        '/home/raster/mytestraster.tif'::text, NULL::int[]
    ),
    ARRAY[]::integer[]
);

 bandnum | pixeltype | nodatavalue | isoutdb | path
---------+-----------+-------------+---------+------
       1 | 8BUI      |             | t       | /home/raster/mytestraster.tif
       2 | 8BUI      |             | t       | /home/raster/mytestraster.tif
       3 | 8BUI      |             | t       | /home/raster/mytestraster.tif

関連情報

ST_BandMetaData, ST_BandPixelType, ST_MakeEmptyRaster, ST_MetaData, ST_NumBands, ST_Reclass

Name

ST_AsRaster — PostGISジオメトリをPostGISラスタに変換します。

Synopsis

raster ST_AsRaster( | geom, |
| ref, |
| pixeltype, |
| value=1, |
| nodataval=0, |
| touched=false); |

geometry geom;
raster ref;
text pixeltype;
double precision value=1;
double precision nodataval=0;
boolean touched=false;

raster ST_AsRaster( | geom, |
| ref, |
| pixeltype=ARRAY['8BUI'], |
| value=ARRAY[1], |
| nodataval=ARRAY[0], |
| touched=false); |

geometry geom;
raster ref;
text[] pixeltype=ARRAY['8BUI'];
double precision[] value=ARRAY[1];
double precision[] nodataval=ARRAY[0];
boolean touched=false;

raster ST_AsRaster( | geom, |
| scalex, |
| scaley, |
| gridx, |
| gridy, |
| pixeltype, |
| value=1, |
| nodataval=0, |
| skewx=0, |
| skewy=0, |
| touched=false); |

geometry geom;
double precision scalex;
double precision scaley;
double precision gridx;
double precision gridy;
text pixeltype;
double precision value=1;
double precision nodataval=0;
double precision skewx=0;
double precision skewy=0;
boolean touched=false;

raster ST_AsRaster( | geom, |
| scalex, |
| scaley, |
| gridx=NULL, |
| gridy=NULL, |
| pixeltype=ARRAY['8BUI'], |
| value=ARRAY[1], |
| nodataval=ARRAY[0], |
| skewx=0, |
| skewy=0, |
| touched=false); |

geometry geom;
double precision scalex;
double precision scaley;
double precision gridx=NULL;
double precision gridy=NULL;
text[] pixeltype=ARRAY['8BUI'];
double precision[] value=ARRAY[1];
double precision[] nodataval=ARRAY[0];
double precision skewx=0;
double precision skewy=0;
boolean touched=false;

raster ST_AsRaster( | geom, |
| scalex, |
| scaley, |
| pixeltype, |
| value=1, |
| nodataval=0, |
| upperleftx=NULL, |
| upperlefty=NULL, |
| skewx=0, |
| skewy=0, |
| touched=false); |

geometry geom;
double precision scalex;
double precision scaley;
text pixeltype;
double precision value=1;
double precision nodataval=0;
double precision upperleftx=NULL;
double precision upperlefty=NULL;
double precision skewx=0;
double precision skewy=0;
boolean touched=false;

raster ST_AsRaster( | geom, |
| scalex, |
| scaley, |
| pixeltype, |
| value=ARRAY[1], |
| nodataval=ARRAY[0], |
| upperleftx=NULL, |
| upperlefty=NULL, |
| skewx=0, |
| skewy=0, |
| touched=false); |

geometry geom;
double precision scalex;
double precision scaley;
text[] pixeltype;
double precision[] value=ARRAY[1];
double precision[] nodataval=ARRAY[0];
double precision upperleftx=NULL;
double precision upperlefty=NULL;
double precision skewx=0;
double precision skewy=0;
boolean touched=false;

raster ST_AsRaster( | geom, |
| width, |
| height, |
| gridx, |
| gridy, |
| pixeltype, |
| value=1, |
| nodataval=0, |
| skewx=0, |
| skewy=0, |
| touched=false); |

geometry geom;
integer width;
integer height;
double precision gridx;
double precision gridy;
text pixeltype;
double precision value=1;
double precision nodataval=0;
double precision skewx=0;
double precision skewy=0;
boolean touched=false;

raster ST_AsRaster( | geom, |
| width, |
| height, |
| gridx=NULL, |
| gridy=NULL, |
| pixeltype=ARRAY['8BUI'], |
| value=ARRAY[1], |
| nodataval=ARRAY[0], |
| skewx=0, |
| skewy=0, |
| touched=false); |

geometry geom;
integer width;
integer height;
double precision gridx=NULL;
double precision gridy=NULL;
text[] pixeltype=ARRAY['8BUI'];
double precision[] value=ARRAY[1];
double precision[] nodataval=ARRAY[0];
double precision skewx=0;
double precision skewy=0;
boolean touched=false;

raster ST_AsRaster( | geom, |
| width, |
| height, |
| pixeltype, |
| value=1, |
| nodataval=0, |
| upperleftx=NULL, |
| upperlefty=NULL, |
| skewx=0, |
| skewy=0, |
| touched=false); |

geometry geom;
integer width;
integer height;
text pixeltype;
double precision value=1;
double precision nodataval=0;
double precision upperleftx=NULL;
double precision upperlefty=NULL;
double precision skewx=0;
double precision skewy=0;
boolean touched=false;

raster ST_AsRaster( | geom, |
| width, |
| height, |
| pixeltype, |
| value=ARRAY[1], |
| nodataval=ARRAY[0], |
| upperleftx=NULL, |
| upperlefty=NULL, |
| skewx=0, |
| skewy=0, |
| touched=false); |

geometry geom;
integer width;
integer height;
text[] pixeltype;
double precision[] value=ARRAY[1];
double precision[] nodataval=ARRAY[0];
double precision upperleftx=NULL;
double precision upperlefty=NULL;
double precision skewx=0;
double precision skewy=0;
boolean touched=false;

説明

PostGISジオメトリをPostGISラスタに変換します。多数の形式がありますが、結果ラスタのアラインメントとピクセルサイズを設定する三つの考えられる類型に分かれます。

一つ目の群は、最初の2形式です。 アラインメント (scalex, scaley, gridx, gridy)、ピクセルタイプ、NODATA値が提供される参照ラスタと同じとなるラスタを生成します。一般的にこの参照ラスタは、ジオメトリを含むテーブルを参照ラスタを含むテーブルに結合して渡します。

二つ目の群は、4形式あります。ピクセルサイズ (scalex & scaleyとskewx & skewy)の引数を渡してラスタのピクセル範囲を設定します。結果ラスタのwidth & heightはジオメトリの範囲にあわせて調整されます。ほとんどの場合、PostgreSQLが正しい形式を選択するために、scalex & scaleyの整数引数を倍精度浮動小数点数にキャストしなければなりません。

三つ目の群は、4形式あります。ラスタのピクセル範囲 (width & height)を渡してラスタのピクセル範囲を固定するものです。結果ラスタのピクセルサイズ(scalex & scaleyとskewx & skewy)の引数はジオメトリの範囲にあわせて調整されます。

二つ目の群と三つ目の群の群内前半2形式は、アラインメントグリッド (gridx & gridy)の適切な隅でアラインメントを特定します。群内後半2形式は左上隅 (upperleftx & upperlefty)を取ります。

これらの群のそれぞれによって、1バンドまたは複数バンドのラスタを生成することができます。複数バンドのラスタを生成するには、ピクセルタイプ配列 (pixeltype[])、初期値配列 (value)、NODATA値配列 (nodataval)を渡す必要があります。ピクセルタイプが渡されていない場合には、デフォルトは8BUIになり、初期値については1、NODATA値については0になります。

出力ラスタは元のジオメトリと同じ空間参照系になります。参照ラスタを使う形式は例外で、結果ラスタは参照ラスタと同じSRIDになります。

任意引数touchedは、デフォルトではFALSEになります。GDALのALL_TOUCHEDラスタ化オプションに相当し、ラインまたはポリゴンに接触するピクセルが描画されます。ライン上にあるか中心点がポリゴン内部にあるピクセルが描画されるだけではありません。

これは特にジオメトリをデータベースからST_AsPNGやST_AsGDALRaster系の関数を併用して直接JPEGやPNGに描画する際に使えます。

Availability: 2.0.0 - GDAL 1.6.0以上が必要です。

Note

曲線、TIN、多面体サーフェスのような複雑なジオメトリタイプのレンダリングは、まだできませんが、GDALができることは実現できます。

例: ジオメトリをPNGファイルとして出力

黒い円

-- 150x150ピクセルを占める黒い円を出力します --
SELECT ST_AsPNG(ST_AsRaster(ST_Buffer(ST_Point(1,5),10),150, 150));

PostGISだけで描画したバッファの例

-- RGBバンド (118,154,118) - 鴨の羽色 にマップします --
SELECT ST_AsPNG(
    ST_AsRaster(
        ST_Buffer(
            ST_GeomFromText('LINESTRING(50 50,150 150,150 50)'), 10,'join=bevel'),
            200,200,ARRAY['8BUI', '8BUI', '8BUI'], ARRAY[118,154,118], ARRAY[0,0,0]));

関連情報

ST_BandPixelType, ST_Buffer, ST_GDALDrivers, ST_AsGDALRaster, ST_AsPNG, ST_AsJPEG, ST_SRID

Name

ST_Band — 既存のラスタの、一つ以上のバンドを新しいラスタとして返します。既存のラスタから新しいラスタを構築する際に使えます。

Synopsis

raster ST_Band( | rast, |
| nbands = ARRAY[1]); |

raster rast;
integer[] nbands = ARRAY[1];

raster ST_Band( | rast, |
| nband); |

raster rast;
integer nband;

raster ST_Band( | rast, |
| nbands, |
| delimiter=,); |

raster rast;
text nbands;
character delimiter=,;

説明

既存のラスタの、一つ以上のバンドを新しいラスタとして返します。既存ラスタから新しいラスタを構築したり、ラスタの選択したバンドのみを出力したり、バンドの並びを改める際に使えます。バンドが指定されない場合や指定したバンドがラスタに存在しない場合には、全てのバンドを返します。バンド削除等の様々な関数を補助する関数として使われています。

Warning

nbandsを文字列とする版では、デフォルトのデリミタは,です。'1,2,3'と指定できます。異なるデリミタを使いたい場合には、ST_Band(rast, '1@2@3', '@')とします。複数バンドを指定する際に、ST_Band(rast, '{1,2,3}'::int[]);というような、配列を使うことを強くお勧めします。textによるバンド一覧を取る形式は、PostGISの将来の版で削除するかも知れません。

Availability: 2.0.0

例

-- ダミーラスタの1番バンドのラスタと3番を再分類して2BUIにしたバンドのラスタとを生成
SELECT ST_NumBands(rast1) As numb1, ST_BandPixelType(rast1) As pix1,
 ST_NumBands(rast2) As numb2,  ST_BandPixelType(rast2) As pix2
FROM (
    SELECT ST_Band(rast) As rast1, ST_Reclass(ST_Band(rast,3), '100-200):1, [200-254:2', '2BUI') As rast2
        FROM dummy_rast
        WHERE rid = 2) As foo;

 numb1 | pix1 | numb2 | pix2
-------+------+-------+------
     1 | 8BUI |     1 | 2BUI

-- 配列へのキャストを使って2番と3番バンドを返します
SELECT ST_NumBands(ST_Band(rast, '{2,3}'::int[])) As num_bands
    FROM dummy_rast WHERE rid=2;

num_bands
----------
2

-- バンドの指定に配列を使って2番と3番バンドを返します
SELECT ST_NumBands(ST_Band(rast, ARRAY[2,3])) As num_bands
    FROM dummy_rast
WHERE rid=2;

元画像 (rastカラム)

dupe_band

sing_band

-- 元画像の2番バンド、1番バンド、1番バンドでバンドを成すラスタと
-- 3番バンドだけのラスタの生成
SELECT rast, ST_Band(rast, ARRAY[2,1,1]) As dupe_band,
    ST_Band(rast, 3) As sing_band
FROM samples.than_chunked
WHERE rid=35;

関連情報

ST_AddBand, ST_NumBands, ST_Reclass, Chapter 10, ラスタ リファレンス

Name

ST_MakeEmptyCoverage — 空のラスタタイルのグリッドでジオリファレンスを施されている領域を生成します。

Synopsis

raster ST_MakeEmptyCoverage( | tilewidth, |
| tileheight, |
| width, |
| height, |
| upperleftx, |
| upperlefty, |
| scalex, |
| scaley, |
| skewx, |
| skewy, |
| srid=unknown); |

integer tilewidth;
integer tileheight;
integer width;
integer height;
double precision upperleftx;
double precision upperlefty;
double precision scalex;
double precision scaley;
double precision skewx;
double precision skewy;
integer srid=unknown;

説明

ST_MakeEmptyRasterでラスタ集合を生成します。グリッドの次元はwidthとheightです。タイルの次元はtilewidthとtileheightです。領域は左上隅(upperleftx, upperlefty)から右下隅 (upperleftx + width * scalex, upperlefty + height * scaley)で形成されます。

Note

ラスタのscaleyは一般的に負数で、scalexは一般的に正数です。右下隅は、左上隅より、yは小さな値、xは大きな値になります。

Availability: 2.4.0

基本的な例

WGS84で左上が(22, 27)で右下が(55, 53)となる範囲の4x4グリッドの16タイルを生成します。

SELECT (ST_MetaData(tile)).* FROM ST_MakeEmptyCoverage(1, 1, 4, 4, 22, 33, (55 - 22)/(4)::float, (33 - 77)/(4)::float, 0., 0., 4326) tile;

 upperleftx | upperlefty | width | height | scalex | scaley | skewx | skewy | srid | numbands
-------------------------------------------------------------------------------------
         22 |         33 |     1 |      1 |   8.25 |    -11 |     0 |     0 | 4326 |        0
      30.25 |         33 |     1 |      1 |   8.25 |    -11 |     0 |     0 | 4326 |        0
       38.5 |         33 |     1 |      1 |   8.25 |    -11 |     0 |     0 | 4326 |        0
      46.75 |         33 |     1 |      1 |   8.25 |    -11 |     0 |     0 | 4326 |        0
         22 |         22 |     1 |      1 |   8.25 |    -11 |     0 |     0 | 4326 |        0
      30.25 |         22 |     1 |      1 |   8.25 |    -11 |     0 |     0 | 4326 |        0
       38.5 |         22 |     1 |      1 |   8.25 |    -11 |     0 |     0 | 4326 |        0
      46.75 |         22 |     1 |      1 |   8.25 |    -11 |     0 |     0 | 4326 |        0
         22 |         11 |     1 |      1 |   8.25 |    -11 |     0 |     0 | 4326 |        0
      30.25 |         11 |     1 |      1 |   8.25 |    -11 |     0 |     0 | 4326 |        0
       38.5 |         11 |     1 |      1 |   8.25 |    -11 |     0 |     0 | 4326 |        0
      46.75 |         11 |     1 |      1 |   8.25 |    -11 |     0 |     0 | 4326 |        0
         22 |          0 |     1 |      1 |   8.25 |    -11 |     0 |     0 | 4326 |        0
      30.25 |          0 |     1 |      1 |   8.25 |    -11 |     0 |     0 | 4326 |        0
       38.5 |          0 |     1 |      1 |   8.25 |    -11 |     0 |     0 | 4326 |        0
      46.75 |          0 |     1 |      1 |   8.25 |    -11 |     0 |     0 | 4326 |        0

関連情報

ST_MakeEmptyRaster

Name

ST_MakeEmptyRaster — 与えられたピクセル範囲 (width & height)、左上のX,Y、ピクセルサイズ、回転 (scalex, scaley, skewx, skewy)と空間参照系 (srid)が指定された空ラスタ (バンドを持たないラスタ)を返します。ラスタが渡されると、新しいラスタは渡されたラスタと同じサイズ、アラインメント、SRIDになります。SRIDが指定されていない場合には、空間参照系は不明 (0)とされます。

Synopsis

raster ST_MakeEmptyRaster(
rast);

raster rast;

raster ST_MakeEmptyRaster( | width, |
| height, |
| upperleftx, |
| upperlefty, |
| scalex, |
| scaley, |
| skewx, |
| skewy, |
| srid=unknown); |

integer width;
integer height;
float8 upperleftx;
float8 upperlefty;
float8 scalex;
float8 scaley;
float8 skewx;
float8 skewy;
integer srid=unknown;

raster ST_MakeEmptyRaster( | width, |
| height, |
| upperleftx, |
| upperlefty, |
| pixelsize); |

integer width;
integer height;
float8 upperleftx;
float8 upperlefty;
float8 pixelsize;

説明

与えられたピクセル範囲 (width & height)を持ち、かつ、左上隅のX (upperleftx)とY (upperlefty)、ピクセルサイズと回転 (scalex, scaley, skewx, skewy)、空間参照系 (srid)によって空間 (またはワールド)座標上で地理参照された空ラスタ (バンドを持たないラスタ)を返します。

最後の形式では、ピクセルサイズを一つの引数 (pixelsize)で指定しています。scalexはこの引数に、scaleyは引数の正負逆の数に、それぞれ設定され、skewxとskewyは0に設定されます。

既存のラスタを渡すと、同じメタデータ設定 (バンド以外)を持つ新しいラスタが返ります。

SRIDが設定されていない場合には、デフォルトは0です。空ラスタを生成した後に、バンドの追加や編集を行うことになります。ST_AddBandでバンドを定義し、ST_SetValueで初期ピクセル値を設定します。

例

INSERT INTO dummy_rast(rid,rast)
VALUES(3, ST_MakeEmptyRaster( 100, 100, 0.0005, 0.0005, 1, 1, 0, 0, 4326) );

-- 既存のラスタをテンプレートに用いて新しいラスタを生成
INSERT INTO dummy_rast(rid,rast)
SELECT 4, ST_MakeEmptyRaster(rast)
FROM dummy_rast WHERE rid = 3;

-- 既存ラスタと生成したラスタのメタデータを出力
SELECT rid, (md).*
FROM (SELECT rid, ST_MetaData(rast) As md
    FROM dummy_rast
    WHERE rid IN(3,4)) As foo;

-- 出力 --
 rid | upperleftx | upperlefty | width | height | scalex | scaley | skewx | skewy | srid | numbands
-----+------------+------------+-------+--------+------------+------------+-------+-------+------+----------
   3 |     0.0005 |     0.0005 |   100 |    100 |          1 |          1 |    0  |     0 | 4326 |        0
   4 |     0.0005 |     0.0005 |   100 |    100 |          1 |          1 |    0  |     0 | 4326 |        0

関連情報

ST_AddBand, ST_MetaData, ST_ScaleX, ST_ScaleY, ST_SetValue, ST_SkewX, , ST_SkewY

Name

ST_Tile — 求められた出力ラスタのピクセル数に基づいて入力ラスタを分割した結果のラスタ集合を返します。

Synopsis

setof raster ST_Tile( | rast, |
| nband, |
| width, |
| height, |
| padwithnodata=FALSE, |
| nodataval=NULL); |

raster rast;
int[] nband;
integer width;
integer height;
boolean padwithnodata=FALSE;
double precision nodataval=NULL;

setof raster ST_Tile( | rast, |
| nband, |
| width, |
| height, |
| padwithnodata=FALSE, |
| nodataval=NULL); |

raster rast;
integer nband;
integer width;
integer height;
boolean padwithnodata=FALSE;
double precision nodataval=NULL;

setof raster ST_Tile( | rast, |
| width, |
| height, |
| padwithnodata=FALSE, |
| nodataval=NULL); |

raster rast;
integer width;
integer height;
boolean padwithnodata=FALSE;
double precision nodataval=NULL;

説明

求められた出力ラスタのピクセル数に基づいて入力ラスタを分割した結果のラスタ集合を返します。

padwithnodataがFALSEである場合には、ラスタの右端と下端のタイルは、他のタイルと異なるピクセル範囲を持つことがあります。padwithnodataがTRUEの場合には、全てのタイルは同じピクセル範囲を持ち、端のタイルにNODATA値が詰められます。ラスタバンドにNODATA値が指定されていない場合には、nodatavalで指定することができます。

Note

入力ラスタの指定したバンドがデータベース外ラスタの場合には、出力ラスタ内の対応するバンドもデータベース外になります。

Availability: 2.1.0

例

WITH foo AS (
    SELECT ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, 0), 1, '8BUI', 1, 0), 2, '8BUI', 10, 0) AS rast UNION ALL
    SELECT ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 3, 0, 1, -1, 0, 0, 0), 1, '8BUI', 2, 0), 2, '8BUI', 20, 0) AS rast UNION ALL
    SELECT ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 6, 0, 1, -1, 0, 0, 0), 1, '8BUI', 3, 0), 2, '8BUI', 30, 0) AS rast UNION ALL

    SELECT ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 0, -3, 1, -1, 0, 0, 0), 1, '8BUI', 4, 0), 2, '8BUI', 40, 0) AS rast UNION ALL
    SELECT ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 3, -3, 1, -1, 0, 0, 0), 1, '8BUI', 5, 0), 2, '8BUI', 50, 0) AS rast UNION ALL
    SELECT ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 6, -3, 1, -1, 0, 0, 0), 1, '8BUI', 6, 0), 2, '8BUI', 60, 0) AS rast UNION ALL

    SELECT ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 0, -6, 1, -1, 0, 0, 0), 1, '8BUI', 7, 0), 2, '8BUI', 70, 0) AS rast UNION ALL
    SELECT ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 3, -6, 1, -1, 0, 0, 0), 1, '8BUI', 8, 0), 2, '8BUI', 80, 0) AS rast UNION ALL
    SELECT ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 6, -6, 1, -1, 0, 0, 0), 1, '8BUI', 9, 0), 2, '8BUI', 90, 0) AS rast
), bar AS (
    SELECT ST_Union(rast) AS rast FROM foo
), baz AS (
    SELECT ST_Tile(rast, 3, 3, TRUE) AS rast FROM bar
)
SELECT
    ST_DumpValues(rast)
FROM baz;

              st_dumpvalues
------------------------------------------
 (1,"{{1,1,1},{1,1,1},{1,1,1}}")
 (2,"{{10,10,10},{10,10,10},{10,10,10}}")
 (1,"{{2,2,2},{2,2,2},{2,2,2}}")
 (2,"{{20,20,20},{20,20,20},{20,20,20}}")
 (1,"{{3,3,3},{3,3,3},{3,3,3}}")
 (2,"{{30,30,30},{30,30,30},{30,30,30}}")
 (1,"{{4,4,4},{4,4,4},{4,4,4}}")
 (2,"{{40,40,40},{40,40,40},{40,40,40}}")
 (1,"{{5,5,5},{5,5,5},{5,5,5}}")
 (2,"{{50,50,50},{50,50,50},{50,50,50}}")
 (1,"{{6,6,6},{6,6,6},{6,6,6}}")
 (2,"{{60,60,60},{60,60,60},{60,60,60}}")
 (1,"{{7,7,7},{7,7,7},{7,7,7}}")
 (2,"{{70,70,70},{70,70,70},{70,70,70}}")
 (1,"{{8,8,8},{8,8,8},{8,8,8}}")
 (2,"{{80,80,80},{80,80,80},{80,80,80}}")
 (1,"{{9,9,9},{9,9,9},{9,9,9}}")
 (2,"{{90,90,90},{90,90,90},{90,90,90}}")
(18 rows)

WITH foo AS (
    SELECT ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, 0), 1, '8BUI', 1, 0), 2, '8BUI', 10, 0) AS rast UNION ALL
    SELECT ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 3, 0, 1, -1, 0, 0, 0), 1, '8BUI', 2, 0), 2, '8BUI', 20, 0) AS rast UNION ALL
    SELECT ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 6, 0, 1, -1, 0, 0, 0), 1, '8BUI', 3, 0), 2, '8BUI', 30, 0) AS rast UNION ALL

    SELECT ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 0, -3, 1, -1, 0, 0, 0), 1, '8BUI', 4, 0), 2, '8BUI', 40, 0) AS rast UNION ALL
    SELECT ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 3, -3, 1, -1, 0, 0, 0), 1, '8BUI', 5, 0), 2, '8BUI', 50, 0) AS rast UNION ALL
    SELECT ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 6, -3, 1, -1, 0, 0, 0), 1, '8BUI', 6, 0), 2, '8BUI', 60, 0) AS rast UNION ALL

    SELECT ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 0, -6, 1, -1, 0, 0, 0), 1, '8BUI', 7, 0), 2, '8BUI', 70, 0) AS rast UNION ALL
    SELECT ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 3, -6, 1, -1, 0, 0, 0), 1, '8BUI', 8, 0), 2, '8BUI', 80, 0) AS rast UNION ALL
    SELECT ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 6, -6, 1, -1, 0, 0, 0), 1, '8BUI', 9, 0), 2, '8BUI', 90, 0) AS rast
), bar AS (
    SELECT ST_Union(rast) AS rast FROM foo
), baz AS (
    SELECT ST_Tile(rast, 3, 3, 2) AS rast FROM bar
)
SELECT
    ST_DumpValues(rast)
FROM baz;

              st_dumpvalues
------------------------------------------
 (1,"{{10,10,10},{10,10,10},{10,10,10}}")
 (1,"{{20,20,20},{20,20,20},{20,20,20}}")
 (1,"{{30,30,30},{30,30,30},{30,30,30}}")
 (1,"{{40,40,40},{40,40,40},{40,40,40}}")
 (1,"{{50,50,50},{50,50,50},{50,50,50}}")
 (1,"{{60,60,60},{60,60,60},{60,60,60}}")
 (1,"{{70,70,70},{70,70,70},{70,70,70}}")
 (1,"{{80,80,80},{80,80,80},{80,80,80}}")
 (1,"{{90,90,90},{90,90,90},{90,90,90}}")
(9 rows)

関連情報

ST_Union, ST_Retile

Name

ST_Retile — 任意のタイル化されたラスタカバレッジから構成されたタイルの集合を返します。

Synopsis

SETOF raster ST_Retile( | tab, |
| col, |
| ext, |
| sfx, |
| sfy, |
| tw, |
| th, |
| algo='NearestNeighbor'); |

regclass tab;
name col;
geometry ext;
float8 sfx;
float8 sfy;
int tw;
int th;
text algo='NearestNeighbor';

説明

指定された縮尺 (sfx, sfy)と最大サイズ (tw, th)を持ち、指定された範囲 (ext)を包含し、指定されたラスタカバレッジ (tab, col)からのデータを持つタイルの集合を返します。

アルゴリズム指定オプションは'NearestNeighbor', 'Bilinear', 'Cubic', 'CubicSpline', 'Lanczos'です。詳細についてはGDAL Warp resampling methodsをご覧ください。

Availability: 2.2.0

関連情報

ST_CreateOverview

Name

ST_FromGDALRaster — 対応するGDALラスタファイルからラスタを返します。

Synopsis

raster ST_FromGDALRaster( | gdaldata, |
| srid=NULL); |

bytea gdaldata;
integer srid=NULL;

説明

対応するGDALラスタファイルからラスタを返します。gdaldataはbytea型で、GDALラスタファイルの中身です。

sridがNULLの場合には、この関数は、GDALラスタから自動的にSRIDを設定しようとします。sridが与えられている場合には、与えられた値が自動的に設定したSRIDを上書きします。

Availability: 2.1.0

例

WITH foo AS (
    SELECT ST_AsPNG(ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 0.1, -0.1, 0, 0, 4326), 1, '8BUI', 1, 0), 2, '8BUI', 2, 0), 3, '8BUI', 3, 0)) AS png
),
bar AS (
    SELECT 1 AS rid, ST_FromGDALRaster(png) AS rast FROM foo
    UNION ALL
    SELECT 2 AS rid, ST_FromGDALRaster(png, 3310) AS rast FROM foo
)
SELECT
    rid,
    ST_Metadata(rast) AS metadata,
    ST_SummaryStats(rast, 1) AS stats1,
    ST_SummaryStats(rast, 2) AS stats2,
    ST_SummaryStats(rast, 3) AS stats3
FROM bar
ORDER BY rid;

 rid |         metadata          |    stats1     |    stats2     |     stats3
-----+---------------------------+---------------+---------------+----------------
   1 | (0,0,2,2,1,-1,0,0,0,3)    | (4,4,1,0,1,1) | (4,8,2,0,2,2) | (4,12,3,0,3,3)
   2 | (0,0,2,2,1,-1,0,0,3310,3) | (4,4,1,0,1,1) | (4,8,2,0,2,2) | (4,12,3,0,3,3)
(2 rows)

関連情報

ST_AsGDALRaster

ラスタアクセサ

Name

ST_GeoReference — GDAL書式または一般的にワールドファイルでみられるESRI書式の地理参照メタデータを返します。デフォルトはGDALです。

Synopsis

text ST_GeoReference( | rast, |
| format=GDAL); |

raster rast;
text format=GDAL;

説明

GDAL書式または一般的にworld file (英語版WikiPedia)でみられるESRI書式の地理参照メタデータを返します。書式を指定したいない場合のデフォルトはGDALです。書式は'GDAL'または'ESRI'の文字列です。

書式の表現の違いは次の通りです。

GDAL:

scalex
skewy
skewx
scaley
upperleftx
upperlefty

ESRI:

scalex
skewy
skewx
scaley
upperleftx + scalex*0.5
upperlefty + scaley*0.5

例

SELECT ST_GeoReference(rast, 'ESRI') As esri_ref, ST_GeoReference(rast, 'GDAL') As gdal_ref
 FROM dummy_rast WHERE rid=1;

   esri_ref   |   gdal_ref
--------------+--------------
 2.0000000000 | 2.0000000000
 0.0000000000 : 0.0000000000
 0.0000000000 : 0.0000000000
 3.0000000000 : 3.0000000000
 1.5000000000 : 0.5000000000
 2.0000000000 : 0.5000000000

関連情報

ST_SetGeoReference, ST_ScaleX, ST_ScaleY

Name

ST_Height — ラスタの高さをピクセル単位で返します。

Synopsis

integer ST_Height(
rast);

raster rast;

説明

ラスタの高さをピクセル単位で返します。

例

SELECT rid, ST_Height(rast) As rastheight
FROM dummy_rast;

 rid | rastheight
-----+------------
   1 |         20
   2 |          5

関連情報

ST_Width

Name

ST_IsEmpty — ラスタが空 (幅が0で高さが0)の場合にはTRUEを返します。他の場合には、FALSEを返します。

Synopsis

boolean ST_IsEmpty(
rast);

raster rast;

説明

ラスタが空 (幅が0で高さが0)の場合にはTRUEを返します。他の場合には、FALSEを返します。

Availability: 2.0.0

例

SELECT ST_IsEmpty(ST_MakeEmptyRaster(100, 100, 0, 0, 0, 0, 0, 0))
st_isempty |
-----------+
f          |

SELECT ST_IsEmpty(ST_MakeEmptyRaster(0, 0, 0, 0, 0, 0, 0, 0))
st_isempty |
-----------+
t          |

関連情報

ST_HasNoBand

Name

ST_MemSize — ラスタが取る領域の合計をバイト単位で返します。

Synopsis

integer ST_MemSize(
rast);

raster rast;

説明

ラスタが取る領域の合計をバイト単位で返します。

この関数はPostgreSQLビルトイン関数pg_clumn_size, pg_size_pretty, pg_relation_size, pg_total_relation_sizeへのすばらしい賛辞です。

Note

テーブルのバイト単位のサイズを得るpg_relation_sizeはST_MemSizeよりも小さい値を返すことがあります。pg_relation_sizeはTOASTテーブルの寄与分を追加せず、大きなジオメトリはTOASTテーブルに格納されるためです。pg_column_sizeは圧縮後のサイズを返すので、小さくなることがあります。

pg_total_relation_size - テーブル、TOASTテーブル、インデクスを含みます。

Availability: 2.2.0

例

SELECT ST_MemSize(ST_AsRaster(ST_Buffer(ST_Point(1,5),10,1000),150, 150, '8BUI')) As rast_mem;

        rast_mem
        --------
        22568

関連情報

Name

ST_MetaData — ピクセル数、回転 (スキュー)、左上隅位置等のラスタオブジェクトに関する基本的なメタデータを返します。

Synopsis

record ST_MetaData(
rast);

raster rast;

説明

ピクセルサイズ、回転 (skew)、左上隅位置等のラスタオブジェクトに関する基本的なメタデータを返します。返されるカラムはupperleftx | upperlefty | width | height | scalex | scaley | skewx | skewy | srid | numbandsです。

例

SELECT rid, (foo.md).*
 FROM (SELECT rid, ST_MetaData(rast) As md
FROM dummy_rast) As foo;

 rid | upperleftx | upperlefty | width | height | scalex | scaley | skewx | skewy | srid | numbands
 ----+------------+------------+-------+--------+--------+-----------+-------+-------+------+-------
   1 |        0.5 |        0.5 |    10 |     20 |      2 |      3 |     0 |     0 |    0 |        0
   2 | 3427927.75 |    5793244 |     5 |      5 |   0.05 |  -0.05 |     0 |     0 |    0 |        3

関連情報

ST_BandMetaData, ST_NumBands

Name

ST_NumBands — ラスタオブジェクトのバンド数を返します。

Synopsis

integer ST_NumBands(
rast);

raster rast;

説明

ラスタオブジェクトのバンド数を返します。

例

SELECT rid, ST_NumBands(rast) As numbands
FROM dummy_rast;

rid | numbands
----+----------
  1 |        0
  2 |        3

関連情報

ST_Value

Name

ST_PixelHeight — 空間参照系の地理的な単位でのピクセルの高さを返します。

Synopsis

double precision ST_PixelHeight(
rast);

raster rast;

説明

空間参照系の地理的な単位でのピクセルの高さを返します。スキューが無い一般的な状況では、ピクセル高は地理座標とラスタピクセルのスケール率です。

関係について図示したものはST_PixelWidthを参照して下さい。

例: スキューの無いラスタ

SELECT ST_Height(rast) As rastheight, ST_PixelHeight(rast) As pixheight,
 ST_ScaleX(rast) As scalex, ST_ScaleY(rast) As scaley, ST_SkewX(rast) As skewx,
        ST_SkewY(rast) As skewy
FROM dummy_rast;

 rastheight | pixheight | scalex | scaley | skewx | skewy
------------+-----------+--------+--------+-------+----------
         20 |         3 |      2 |      3 |     0 |        0
          5 |      0.05 |   0.05 |  -0.05 |     0 |        0

例: スキューが0でないラスタ

SELECT ST_Height(rast) As rastheight, ST_PixelHeight(rast) As pixheight,
 ST_ScaleX(rast) As scalex, ST_ScaleY(rast) As scaley, ST_SkewX(rast) As skewx,
        ST_SkewY(rast) As skewy
FROM (SELECT ST_SetSKew(rast,0.5,0.5) As rast
        FROM dummy_rast) As skewed;

rastheight |     pixheight     | scalex | scaley | skewx | skewy
-----------+-------------------+--------+--------+-------+----------
        20 |  3.04138126514911 |      2 |      3 |   0.5 |      0.5
         5 | 0.502493781056044 |   0.05 |  -0.05 |   0.5 |      0.5

関連情報

ST_PixelWidth, ST_ScaleX, ST_ScaleY, ST_SkewX, ST_SkewY

Name

ST_PixelWidth — 空間参照系の地理的な単位でのピクセルの幅を返します。

Synopsis

double precision ST_PixelWidth(
rast);

raster rast;

説明

空間参照系の地理的な単位でのピクセルの幅を返します。スキューが無い一般的な状況では、ピクセル幅は地理座標とラスタピクセルのスケール率です。

関係について次の図に示します。

ピクセル幅: i方向のピクセルサイズ

ピクセル高: j方向のピクセルサイズ

例: スキューの無いラスタ

SELECT ST_Width(rast) As rastwidth, ST_PixelWidth(rast) As pixwidth,
    ST_ScaleX(rast) As scalex, ST_ScaleY(rast) As scaley, ST_SkewX(rast) As skewx,
    ST_SkewY(rast) As skewy
    FROM dummy_rast;

    rastwidth | pixwidth | scalex | scaley | skewx | skewy
    -----------+----------+--------+--------+-------+----------
    10 |        2 |      2 |      3 |     0 |        0
     5 |     0.05 |   0.05 |  -0.05 |     0 |        0

例: スキューが0でないラスタ

SELECT ST_Width(rast) As rastwidth, ST_PixelWidth(rast) As pixwidth,
    ST_ScaleX(rast) As scalex, ST_ScaleY(rast) As scaley, ST_SkewX(rast) As skewx,
    ST_SkewY(rast) As skewy
    FROM (SELECT ST_SetSkew(rast,0.5,0.5) As rast
    FROM dummy_rast) As skewed;

    rastwidth |     pixwidth      | scalex | scaley | skewx | skewy
    -----------+-------------------+--------+--------+-------+----------
    10 |  2.06155281280883 |      2 |      3 |   0.5 |      0.5
     5 | 0.502493781056044 |   0.05 |  -0.05 |   0.5 |      0.5

関連情報

ST_PixelHeight, ST_ScaleX, ST_ScaleY, ST_SkewX, ST_SkewY

Name

ST_ScaleX — 空間参照系の地理的な単位でのピクセル幅のX成分を返します。

Synopsis

float8 ST_ScaleX(
rast);

raster rast;

説明

空間参照系の地理的な単位でのピクセル幅のX成分を返します。詳細についてはWorld File (英語版WikiPedia)をご覧ください。

Changed: 2.0.0. WKTRaster版ではST_PixelSizeXと呼ばれていました。

例

SELECT rid, ST_ScaleX(rast) As rastpixwidth
FROM dummy_rast;

 rid | rastpixwidth
-----+--------------
   1 |            2
   2 |         0.05

関連情報

ST_Width

Name

ST_ScaleY — 空間参照系の地理的な単位でのピクセル幅のY成分を返します。

Synopsis

float8 ST_ScaleY(
rast);

raster rast;

説明

空間参照系の地理的な単位でのピクセル幅のY成分を返します。詳細についてはWorld File (英語版WikiPedia)をご覧ください。

Changed: 2.0.0. WKTRaster版ではST_PixelSizeYと呼ばれていました。

例

SELECT rid, ST_ScaleY(rast) As rastpixheight
FROM dummy_rast;

 rid | rastpixheight
-----+---------------
   1 |             3
   2 |         -0.05

関連情報

ST_Height

Name

ST_RasterToWorldCoord — ラスタの指定した列と行における左上隅の地理座標X値とY値 (経度と緯度)を返します。列と行の番号は1始まりです。

Synopsis

record ST_RasterToWorldCoord( | rast, |
| xcolumn, |
| yrow); |

raster rast;
integer xcolumn;
integer yrow;

説明

ラスタの指定した列と行における左上隅の地理座標X値とY値 (経度と緯度)を返します。X値とY値の単位は、地理参照されたラスタの地理単位です。列と行の数字は1始まりですが、引数に0、負数またはラスタのピクセル範囲を超える値が渡されている場合には、ラスタのグリッドがラスタ範囲外に適用できると仮定して、範囲外の座標を返します。

Availability: 2.1.0

例

-- スキューの無いラスタ
SELECT
    rid,
    (ST_RasterToWorldCoord(rast,1, 1)).*,
    (ST_RasterToWorldCoord(rast,2, 2)).*
FROM dummy_rast

 rid | longitude  | latitude | longitude |  latitude
-----+------------+----------+-----------+------------
   1 |        0.5 |      0.5 |       2.5 |        3.5
   2 | 3427927.75 |  5793244 | 3427927.8 | 5793243.95

-- スキューの有るラスタ
SELECT
    rid,
    (ST_RasterToWorldCoord(rast, 1, 1)).*,
    (ST_RasterToWorldCoord(rast, 2, 3)).*
FROM (
    SELECT
        rid,
        ST_SetSkew(rast, 100.5, 0) As rast
    FROM dummy_rast
) As foo

 rid | longitude  | latitude | longitude | latitude
-----+------------+----------+-----------+-----------
   1 |        0.5 |      0.5 |     203.5 |       6.5
   2 | 3427927.75 |  5793244 | 3428128.8 | 5793243.9

関連情報

ST_RasterToWorldCoordX, ST_RasterToWorldCoordY, ST_SetSkew

Name

ST_RasterToWorldCoordX — ラスタの指定した列と行における左上隅の地理座標のX値を返します。列と行の番号は1始まりです。

Synopsis

float8 ST_RasterToWorldCoordX( | rast, |
| xcolumn); |

raster rast;
integer xcolumn;

float8 ST_RasterToWorldCoordX( | rast, |
| xcolumn, |
| yrow); |

raster rast;
integer xcolumn;
integer yrow;

説明

ラスタの指定した列と行における左上隅の地理座標のX値を地理参照したラスタの地理単位で返します。列と行の番号は1始まりです。負数またはラスタの列数を超える値を渡した場合には、スキューとピクセルサイズが選択したラスタと同じであるという仮定のもとで、ラスタファイルから左または右にはずれた座標値を返します。

Note

スキューの無いラスタでは、X列を与えれば十分です。スキューのあるラスタの場合には、地理参照のとれた座標はST_ScaleXとST_SkewXおよび行と列の関数となります。スキューのあるラスタでX列のみ与えた場合にはエラーが発生します。

Changed: 2.1.0 以前の版ではST_Raster2WorldCoordXと呼ばれていました。

例

-- スキューの無いラスタでは列を与えれば十分です
SELECT rid, ST_RasterToWorldCoordX(rast,1) As x1coord,
    ST_RasterToWorldCoordX(rast,2) As x2coord,
    ST_ScaleX(rast) As pixelx
FROM dummy_rast;

 rid |  x1coord   |  x2coord  | pixelx
-----+------------+-----------+--------
   1 |        0.5 |       2.5 |      2
   2 | 3427927.75 | 3427927.8 |   0.05

-- 面白半分にスキューさせてみましょう
SELECT rid, ST_RasterToWorldCoordX(rast, 1, 1) As x1coord,
    ST_RasterToWorldCoordX(rast, 2, 3) As x2coord,
    ST_ScaleX(rast) As pixelx
FROM (SELECT rid, ST_SetSkew(rast, 100.5, 0) As rast FROM dummy_rast) As foo;

 rid |  x1coord   |  x2coord  | pixelx
-----+------------+-----------+--------
   1 |        0.5 |     203.5 |      2
   2 | 3427927.75 | 3428128.8 |   0.05

関連情報

ST_ScaleX, ST_RasterToWorldCoordY, ST_SetSkew, ST_SkewX

Name

ST_RasterToWorldCoordY — ラスタの指定した列と行における左上隅の地理座標のY値を返します。列と行の番号は1始まりです。

Synopsis

float8 ST_RasterToWorldCoordY( | rast, |
| yrow); |

raster rast;
integer yrow;

float8 ST_RasterToWorldCoordY( | rast, |
| xcolumn, |
| yrow); |

raster rast;
integer xcolumn;
integer yrow;

説明

ラスタの指定した列と行における左上隅の地理座標のY値を地理参照したラスタの地理単位で返します。列と行の番号は1始まりです。負数またはラスタの列数や行数を超える値を渡した場合には、スキューとピクセルサイズが選択したラスタと同じであるという仮定のもとで、ラスタファイルから左または右にはずれた座標値を返します。

Note

スキューの無いラスタでは、Y行を与えれば十分です。スキューのあるラスタの場合には、地理参照のとれた座標はST_ScaleYとST_SkewYおよび行と列の関数となります。スキューのあるラスタでY行のみ与えた場合にはエラーが発生します。

Changed: 2.1.0 以前の版ではST_Raster2WorldCoordYと呼ばれていました。

例

-- スキューの無いラスタでは列を与えれば十分です
SELECT rid, ST_RasterToWorldCoordY(rast,1) As y1coord,
    ST_RasterToWorldCoordY(rast,3) As y2coord,
    ST_ScaleY(rast) As pixely
FROM dummy_rast;

 rid | y1coord |  y2coord  | pixely
-----+---------+-----------+--------
   1 |     0.5 |       6.5 |      3
   2 | 5793244 | 5793243.9 |  -0.05

-- 面白半分に回転させてみましょう
SELECT rid, ST_RasterToWorldCoordY(rast,1,1) As y1coord,
    ST_RasterToWorldCoordY(rast,2,3) As y2coord,
    ST_ScaleY(rast) As pixely
FROM (SELECT rid, ST_SetSkew(rast,0,100.5) As rast FROM dummy_rast) As foo;

 rid | y1coord |  y2coord  | pixely
-----+---------+-----------+--------
   1 |     0.5 |       107 |      3
   2 | 5793244 | 5793344.4 |  -0.05

関連情報

ST_ScaleY, ST_RasterToWorldCoordX, ST_SetSkew, ST_SkewY

Name

ST_Rotation — ラスタの回転をラジアンで返します。

Synopsis

float8 ST_Rotation(
rast);

raster rast;

説明

ラスタの回転をラジアンで返します。ラスタが回転を持っていない場合には、NaNが返されます。詳細についてはWorld File (英語版WikiPedia)を参照して下さい。

例

SELECT rid, ST_Rotation(ST_SetScale(ST_SetSkew(rast, sqrt(2)), sqrt(2))) as rot FROM dummy_rast;

 rid |        rot
-----+-------------------
   1 | 0.785398163397448
   2 | 0.785398163397448

関連情報

ST_SetRotation, ST_SetScale, ST_SetSkew

Name

ST_SkewX — 空間参照のXスキュー (回転パラメータ)を返します。

Synopsis

float8 ST_SkewX(
rast);

raster rast;

説明

空間参照のXスキュー (回転パラメータ)を返します。詳細についてはWorld File (英語版WikiPedia)を参照して下さい。

例

SELECT rid, ST_SkewX(rast) As skewx, ST_SkewY(rast) As skewy,
    ST_GeoReference(rast) as georef
FROM dummy_rast;

 rid | skewx | skewy |       georef
-----+-------+-------+--------------------
   1 |     0 |     0 | 2.0000000000
                     : 0.0000000000
                     : 0.0000000000
                     : 3.0000000000
                     : 0.5000000000
                     : 0.5000000000
                     :
   2 |     0 |     0 | 0.0500000000
                     : 0.0000000000
                     : 0.0000000000
                     : -0.0500000000
                     : 3427927.7500000000
                     : 5793244.0000000000

関連情報

ST_GeoReference, ST_SkewY, ST_SetSkew

Name

ST_SkewY — 空間参照のYスキュー (回転パラメータ)を返します。

Synopsis

float8 ST_SkewY(
rast);

raster rast;

説明

空間参照のYスキュー (回転パラメータ)を返します。詳細についてはWorld File (英語版WikiPedia)を参照して下さい。

例

SELECT rid, ST_SkewX(rast) As skewx, ST_SkewY(rast) As skewy,
    ST_GeoReference(rast) as georef
FROM dummy_rast;

 rid | skewx | skewy |       georef
-----+-------+-------+--------------------
   1 |     0 |     0 | 2.0000000000
                     : 0.0000000000
                     : 0.0000000000
                     : 3.0000000000
                     : 0.5000000000
                     : 0.5000000000
                     :
   2 |     0 |     0 | 0.0500000000
                     : 0.0000000000
                     : 0.0000000000
                     : -0.0500000000
                     : 3427927.7500000000
                     : 5793244.0000000000

関連情報

ST_GeoReference, ST_SkewX, ST_SetSkew

Name

ST_SRID — ラスタのspatial_ref_sysテーブルで定義されている空間参照系識別番号を返します。

Synopsis

integer ST_SRID(
rast);

raster rast;

説明

ラスタのspatial_ref_sysテーブルで定義されている空間参照系識別番号を返します。

Note

空間参照を持たないラスタ/ジオメトリのSRIDは、以前は-1でしたがPostGIS 2.0以上では0になります。

例

SELECT ST_SRID(rast) As srid
FROM dummy_rast WHERE rid=1;

srid
----------------
0

関連情報

the section called “空間参照系”, ST_SRID

Name

ST_Summary — ラスタの中身の概要が文字列で返されます。

Synopsis

text ST_Summary(
rast);

raster rast;

説明

ラスタの中身の概要が文字列で返されます。

Availability: 2.1.0

例

SELECT ST_Summary(
    ST_AddBand(
        ST_AddBand(
            ST_AddBand(
                ST_MakeEmptyRaster(10, 10, 0, 0, 1, -1, 0, 0, 0)
                , 1, '8BUI', 1, 0
            )
            , 2, '32BF', 0, -9999
        )
        , 3, '16BSI', 0, NULL
    )
);

                            st_summary
------------------------------------------------------------------
 Raster of 10x10 pixels has 3 bands and extent of BOX(0 -10,10 0)+
     band 1 of pixtype 8BUI is in-db with NODATA value of 0      +
     band 2 of pixtype 32BF is in-db with NODATA value of -9999  +
     band 3 of pixtype 16BSI is in-db with no NODATA value
(1 row)

関連情報

ST_MetaData, ST_BandMetaData, ST_Summary ST_Extent

Name

ST_UpperLeftX — 適用されている空間参照系でのラスタの左上隅のX座標値を返します。

Synopsis

float8 ST_UpperLeftX(
rast);

raster rast;

説明

適用されている空間参照系でのラスタの左上隅のX座標値を返します。

例

SELECt rid, ST_UpperLeftX(rast) As ulx
FROM dummy_rast;

 rid |    ulx
-----+------------
   1 |        0.5
   2 | 3427927.75

関連情報

ST_UpperLeftY, ST_GeoReference, Box3D

Name

ST_UpperLeftY — 適用されている空間参照系でのラスタの左上隅のY座標値を返します。

Synopsis

float8 ST_UpperLeftY(
rast);

raster rast;

説明

適用されている空間参照系でのラスタの左上隅のY座標値を返します。

例

SELECT rid, ST_UpperLeftY(rast) As uly
FROM dummy_rast;

 rid |   uly
-----+---------
   1 |     0.5
   2 | 5793244

関連情報

ST_UpperLeftX, ST_GeoReference, Box3D

Name

ST_Width — ラスタの幅をピクセル単位で返します。

Synopsis

integer ST_Width(
rast);

raster rast;

説明

ラスタの幅をピクセル単位で返します。

例

SELECT ST_Width(rast) As rastwidth
FROM dummy_rast WHERE rid=1;

rastwidth
----------------
10

関連情報

ST_Height

Name

ST_WorldToRasterCoord — ラスタの空間参照系による地理座標のX値とY値 (経度と緯度)またはポイントジオメトリに対応するピクセルの左上隅を返します。

Synopsis

record ST_WorldToRasterCoord( | rast, |
| pt); |

raster rast;
geometry pt;

record ST_WorldToRasterCoord( | rast, |
| longitude, |
| latitude); |

raster rast;
double precision longitude;
double precision latitude;

説明

地理座標のX値とY値 (経度と緯度)またはポイントジオメトリに対応するピクセルの左上隅を返します。X値、Y値やポイントジオメトリがラスタの範囲外であるかないかにかかわらず動作します。地理座標のX値とY値はラスタの空間参照系で表現しなければなりません。

Availability: 2.1.0

例

SELECT
    rid,
    (ST_WorldToRasterCoord(rast,3427927.8,20.5)).*,
    (ST_WorldToRasterCoord(rast,ST_GeomFromText('POINT(3427927.8 20.5)',ST_SRID(rast)))).*
FROM dummy_rast;

 rid | columnx |   rowy    | columnx |   rowy
-----+---------+-----------+---------+-----------
   1 | 1713964 |         7 | 1713964 |         7
   2 |       2 | 115864471 |       2 | 115864471

関連情報

ST_WorldToRasterCoordX, ST_WorldToRasterCoordY, ST_RasterToWorldCoordX, ST_RasterToWorldCoordY, ST_SRID

Name

ST_WorldToRasterCoordX — ラスタの空間参照系に基づくポイントジオメトリ (pt)またはX,Y座標値 (xw,yw)に対応するラスタの列を返します。

Synopsis

integer ST_WorldToRasterCoordX( | rast, |
| pt); |

raster rast;
geometry pt;

integer ST_WorldToRasterCoordX( | rast, |
| xw); |

raster rast;
double precision xw;

integer ST_WorldToRasterCoordX( | rast, |
| xw, |
| yw); |

raster rast;
double precision xw;
double precision yw;

説明

ラスタの空間参照系に基づくポイントジオメトリ (pt)またはX,Y座標値 (xw,yw)に対応するラスタの列を返します。ラスタがスキューされている場合には、ポイントかxwとywの両方かが必要です。ラスタがスキューされていない場合には、xwを指定すれば十分です。ワールド座標系はラスタの空間参照系です。

Changed: 2.1.0 以前の版ではST_World2RasterCoordXと呼ばれていました。

例

SELECT rid, ST_WorldToRasterCoordX(rast,3427927.8) As xcoord,
        ST_WorldToRasterCoordX(rast,3427927.8,20.5) As xcoord_xwyw,
        ST_WorldToRasterCoordX(rast,ST_GeomFromText('POINT(3427927.8 20.5)',ST_SRID(rast))) As ptxcoord
FROM dummy_rast;

 rid | xcoord  |  xcoord_xwyw   | ptxcoord
-----+---------+---------+----------
   1 | 1713964 | 1713964 |  1713964
   2 |       1 |       1 |        1

関連情報

ST_RasterToWorldCoordX, ST_RasterToWorldCoordY, ST_SRID

Name

ST_WorldToRasterCoordY — ラスタの空間参照系に基づくポイントジオメトリ (pt)またはX,Y座標値 (xw,yw)に対応するラスタの行を返します。

Synopsis

integer ST_WorldToRasterCoordY( | rast, |
| pt); |

raster rast;
geometry pt;

integer ST_WorldToRasterCoordY( | rast, |
| xw); |

raster rast;
double precision xw;

integer ST_WorldToRasterCoordY( | rast, |
| xw, |
| yw); |

raster rast;
double precision xw;
double precision yw;

説明

ラスタの空間参照系に基づくポイントジオメトリ (pt)またはX,Y座標値 (xw,yw)に対応するラスタの行を返します。ラスタがスキューされている場合には、ポイントかxwとywの両方かが必要です。ラスタがスキューされていない場合には、ywを指定すれば十分です。ワールド座標系はラスタの空間参照系です。

Changed: 2.1.0 以前の版ではST_World2RasterCoordYと呼ばれていました。

例

SELECT rid, ST_WorldToRasterCoordY(rast,20.5) As ycoord,
        ST_WorldToRasterCoordY(rast,3427927.8,20.5) As ycoord_xwyw,
        ST_WorldToRasterCoordY(rast,ST_GeomFromText('POINT(3427927.8 20.5)',ST_SRID(rast))) As ptycoord
FROM dummy_rast;

 rid |  ycoord   | ycoord_xwyw | ptycoord
-----+-----------+-------------+-----------
   1 |         7 |           7 |         7
   2 | 115864471 |   115864471 | 115864471

関連情報

ST_RasterToWorldCoordX, ST_RasterToWorldCoordY, ST_SRID

ラスタバンドアクセサ

Name

ST_BandMetaData — 指定したラスタバンドの基本的なメタデータを返します。バンド番号を指定しない場合には、1番と仮定します。

Synopsis

(1) record ST_BandMetaData( | rast, |
| band=1); |

raster rast;
integer band=1;

(2) record ST_BandMetaData( | rast, |
| band); |

raster rast;
integer[] band;

説明

指定したラスタバンドの基本的なメタデータを返します。返されるカラムは pixeltype, nodatavalue, isoutdb, path, outdbbandnum, filesize, filetimestamp です。

Note

ラスタがバンドを持たない場合にはエラーが投げられます。

Note

バンドにNODATA値が無い場合には、nodatavalueはNULLになります。

Note

isoutdbがFALSEの場合には、path, outdbbandnum, filedizeおよびfiletimestampはNULLです。outdbのアクセスが禁止されているなら、filesizeとfiletimestampがNULLになります。

Enhanced: 2.5.0 outdbラスタにoutdbbandnum, filesizeとfiletimestampを取り入れました。

例: 一つ目の形式

SELECT
    rid,
    (foo.md).*
FROM (
    SELECT
        rid,
        ST_BandMetaData(rast, 1) AS md
    FROM dummy_rast
    WHERE rid=2
) As foo;

 rid | pixeltype | nodatavalue | isoutdb | path | outdbbandnum
-----+-----------+---- --------+---------+------+--------------
   2 | 8BUI      |           0 | f       |      |

例: 二つ目の形式

WITH foo AS (
    SELECT
        ST_AddBand(NULL::raster, '/home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif', NULL::int[]) AS rast
)
SELECT
    *
FROM ST_BandMetadata(
    (SELECT rast FROM foo),
    ARRAY[1,3,2]::int[]
);

 bandnum | pixeltype | nodatavalue | isoutdb |                                      path                                      | outdbbandnum  | filesize | filetimestamp |
---------+-----------+-------------+---------+--------------------------------------------------------------------------------+---------------+----------+---------------+-
       1 | 8BUI      |             | t       | /home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif      |            1  |    12345 |    1521807257 |
       3 | 8BUI      |             | t       | /home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif      |            3  |    12345 |    1521807257 |
       2 | 8BUI      |             | t       | /home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif      |            2  |    12345 |    1521807257 |

関連情報

ST_MetaData, ST_BandPixelType

Name

ST_BandNoDataValue — 指定されたバンドについてデータが無いことを表現する値を返します。バンド番号を指定しない場合には、1番と仮定します。

Synopsis

double precision ST_BandNoDataValue( | rast, |
| bandnum=1); |

raster rast;
integer bandnum=1;

説明

指定されたバンドについてデータが無いことを表現する値を返します。

例

SELECT ST_BandNoDataValue(rast,1) As bnval1,
    ST_BandNoDataValue(rast,2) As bnval2, ST_BandNoDataValue(rast,3) As bnval3
FROM dummy_rast
WHERE rid = 2;

 bnval1 | bnval2 | bnval3
--------+--------+--------
      0 |      0 |      0

関連情報

ST_NumBands

Name

ST_BandIsNoData — 指定したバンドがNODATA値だけで満たされている場合には、TRUEを返します。

Synopsis

boolean ST_BandIsNoData( | rast, |
| band, |
| forceChecking=true); |

raster rast;
integer band;
boolean forceChecking=true;

boolean ST_BandIsNoData( | rast, |
| forceChecking=true); |

raster rast;
boolean forceChecking=true;

説明

指定したバンドがNODATA値だけで満たされている場合には、TRUEを返します。バンド番号を指定しない場合には、1番と仮定します。最後の引数がTRUEの場合には、全バンドについてピクセル毎に調べます。他の場合には、isnodataフラグの値を返すだけです。この引数を指定しない場合のデフォルト値はFALSEです。

Availability: 2.0.0

Note

フラグが汚れている (最後の引数をTRUEにした場合としない場合とで結果が違う)場合には、ST_SetBandIsNodata関数、または最後の引数をTRUEにしたST_BandNodataValue関数を使って、フラグにTRUEを設定するためにラスタを更新するべきです。ST_SetBandIsNoDataを参照して下さい。

例

-- 一つのラスタカラムを持つダミーテーブルの生成
create table dummy_rast (rid integer, rast raster);

-- 1ピクセルしか持たない2個のバンドで
-- nodatavalue = pixel value = 3 のバンドと nodatavalue = 13, pixel value = 4 のバンドを追加
insert into dummy_rast values(1,
(
'01' -- little endian - リトルエンディアン (uint8 ndr)
||
'0000' -- version - 版 (uint16 0)
||
'0200' -- nBands - バンド数 (uint16 0)
||
'17263529ED684A3F' -- scaleX - X方向セルサイズ (float64 0.000805965234044584)
||
'F9253529ED684ABF' -- scaleY - Y方向セルサイズ (float64 -0.00080596523404458)
||
'1C9F33CE69E352C0' -- ipX - 左上隅X値 (float64 -75.5533328537098)
||
'718F0E9A27A44840' -- ipY - 左上隅Y値 (float64 49.2824585505576)
||
'ED50EB853EC32B3F' -- skewX - スキューX (float64 0.000211812383858707)
||
'7550EB853EC32B3F' -- skewY - スキューY (float64 0.000211812383858704)
||
'E6100000' -- SRID (int32 4326)
||
'0100' -- width - 横セル数 (uint16 1)
||
'0100' -- height - 縦セル数 (uint16 1)
||
'6' -- hasnodatavalueとisnodataの値をtrueにする。
||
'2' -- 1番バンドのタイプ (4BUI)
||
'03' -- NODATA値==3
||
'03' -- 0列0行ピクセルの値==3 (NODATA値と同じ)
||
'0' -- hasnodatavalueをFALSEにする。
||
'5' -- 2番バンドのタイプ (16BSI)
||
'0D00' -- NODATA値==13
||
'0400' -- 0列0行ピクセルの値==4
)::raster
);

select st_bandisnodata(rast, 1) from dummy_rast where rid = 1; -- Expected true
select st_bandisnodata(rast, 2) from dummy_rast where rid = 1; -- Expected false

関連情報

ST_BandNoDataValue, ST_NumBands, ST_SetBandNoDataValue, ST_SetBandIsNoData

Name

ST_BandPath — ファイルシステムに格納されているバンドのシステムファイルパスを返します。バンド番号が指定されていない場合には、1番と仮定します。

Synopsis

text ST_BandPath( | rast, |
| bandnum=1); |

raster rast;
integer bandnum=1;

説明

バンドへのシステムファイルパスを返します。データベース内に格納されているバンドでこの関数を呼んだ場合にはエラーが投げられます。

例

関連情報

Name

ST_BandFileSize — ファイルシステムに格納されているバンドのファイルサイズを返します。バンド番号が指定されていない場合には、1番と仮定します。

Synopsis

bigint ST_BandFileSize( | rast, |
| bandnum=1); |

raster rast;
integer bandnum=1;

説明

ファイルシステムに格納されているバンドのファイルサイズを返します。データベース内バンドを与えるか、データベース外バンドにアクセスできない場合にはエラーが投げられます。

この関数は一般的にST_BandPath()とST_BandFileTimestamp()とを併用して、データベース外ラスタのファイル名が、この関数から見えるものとサーバから見えるものと同じかどうかを判断することができます。

Availability: 2.5.0

例

SELECT ST_BandFileSize(rast,1) FROM dummy_rast WHERE rid = 1;

 st_bandfilesize
-----------------
          240574

Name

ST_BandFileTimestamp — ファイルシステムに格納されているバンドのファイルタイムスタンプ返します。バンド番号が指定されていない場合には、1番と仮定します。

Synopsis

bigint ST_BandFileTimestamp( | rast, |
| bandnum=1); |

raster rast;
integer bandnum=1;

説明

ファイルシステムに保存されているバンドのファイルタイムスタンプを返します (UTC 1970年1月1日 0時0分0秒からの秒数)。データベース内バンドの場合またはデータベース外ラスタへのアクセスが無効な場合にはエラーが投げられます。

この関数は通常、ST_BandPath() および ST_BandFileSize() と組み合わせて使用されるため、クライアントは、outdb ラスタのファイル名がサーバーによって見られるものと同じであるかどうかを判断できます。

Availability: 2.5.0

例

SELECT ST_BandFileTimestamp(rast,1) FROM dummy_rast WHERE rid = 1;

 st_bandfiletimestamp
----------------------
           1521807257

Name

ST_BandPixelType — 指定したバンドのピクセルタイプを返します。バンド番号が指定されていない場合には、1番と仮定します。

Synopsis

text ST_BandPixelType( | rast, |
| bandnum=1); |

raster rast;
integer bandnum=1;

説明

与えられたバンドのセルに格納されるデータの型とサイズを示す名前を返します。

ピクセルタイプは11通りあります。対応しているピクセルタイプは次の通りです。

1BB - 1ビット真偽値

2BUI - 2ビット符号なし整数

4BUI - 4ビット符号なし整数

8BSI - 8ビット整数

8BUI - 8ビット符号なし整数

16BSI - 16ビット整数

16BUI - 16ビット符号なし整数

32BSI - 32ビット整数

32BUI - 32ビット符号なし整数

32BF - 32ビット浮動小数点数

64BF - 64ビット浮動小数点数

例

SELECT ST_BandPixelType(rast,1) As btype1,
    ST_BandPixelType(rast,2) As btype2, ST_BandPixelType(rast,3) As btype3
FROM dummy_rast
WHERE rid = 2;

 btype1 | btype2 | btype3
--------+--------+--------
 8BUI   | 8BUI   | 8BUI

関連情報

ST_NumBands

Name

ST_MinPossibleValue — このピクセルタイプが格納できる最小値を返します。

Synopsis

integer ST_MinPossibleValue(
pixeltype);

text pixeltype;

説明

このピクセルタイプが格納できる最小値を返します。

例

SELECT ST_MinPossibleValue('16BSI');

 st_minpossiblevalue
---------------------
              -32768

SELECT ST_MinPossibleValue('8BUI');

 st_minpossiblevalue
---------------------
                   0

関連情報

ST_BandPixelType

Name

ST_HasNoBand — 指定したバンド番号のバンドが無い場合には、TRUEを返します。バンド番号を指定していない場合には、1番と仮定します。

Synopsis

boolean ST_HasNoBand( | rast, |
| bandnum=1); |

raster rast;
integer bandnum=1;

説明

指定したバンド番号のバンドが無い場合には、TRUEを返します。バンド番号を指定していない場合には、1番と仮定します。

Availability: 2.0.0

例

SELECT rid, ST_HasNoBand(rast) As hb1, ST_HasNoBand(rast,2) as hb2,
ST_HasNoBand(rast,4) as hb4, ST_NumBands(rast) As numbands
FROM dummy_rast;

rid | hb1 | hb2 | hb4 | numbands
-----+-----+-----+-----+----------
1 | t   | t   | t   |        0
2 | f   | f   | t   |        3

関連情報

ST_NumBands

ラスタピクセルアクセサとセッター

Name

ST_PixelAsPolygon — 指定した行と列のピクセルの境界となるジオメトリを返します。

Synopsis

geometry ST_PixelAsPolygon( | rast, |
| columnx, |
| rowy); |

raster rast;
integer columnx;
integer rowy;

説明

指定した行と列のピクセルの境界となるジオメトリを返します。

Availability: 2.0.0

例

-- ラスタピクセルのポリゴンを得ます
SELECT i,j, ST_AsText(ST_PixelAsPolygon(foo.rast, i,j)) As b1pgeom
FROM dummy_rast As foo
    CROSS JOIN generate_series(1,2) As i
    CROSS JOIN generate_series(1,1) As j
WHERE rid=2;

 i | j |                                                    b1pgeom
---+---+-----------------------------------------------------------------------------
 1 | 1 | POLYGON((3427927.75 5793244,3427927.8 5793244,3427927.8 5793243.95,...
 2 | 1 | POLYGON((3427927.8 5793244,3427927.85 5793244,3427927.85 5793243.95, ..

関連情報

ST_DumpAsPolygons, ST_PixelAsPolygons, ST_PixelAsPoint, ST_PixelAsPoints, ST_PixelAsCentroid, ST_PixelAsCentroids, ST_Intersection, ST_AsText

Name

ST_PixelAsPolygons — 全てのピクセルについて境界となるジオメトリを、ピクセルごとのピクセル値とラスタ座標系のXとYとを付けて返します。

Synopsis

setof record ST_PixelAsPolygons( | rast, |
| band=1, |
| exclude_nodata_value=TRUE); |

raster rast;
integer band=1;
boolean exclude_nodata_value=TRUE;

説明

全てのピクセルについて境界となるジオメトリを、ピクセルごとのピクセル値 (倍精度浮動小数点数)とラスタ座標系のXとY (ともに整数)とを付けて返します。

返されるレコードの書式は、geometry型のgeom、倍精度浮動小数点数のval、整数のx、整数のyです。

Note

exclude_nodata_valueがTRUEの時、値がNODATAでないこれらのピクセルだけをポイントとして返します。

Note

ST_PixelAsPolygonsは、ピクセルごとに一つのポリゴンジオメトリを返します。ST_DumpAsPolygonsとは、 一つのジオメトリが同じ値となる一つ以上のピクセルを表現する点で違います。

Availability: 2.0.0

Enhanced: 2.1.0 任意引数exclude_nodata_valueが追加されました。

Changed: 2.1.1 exclude_nodata_valueの挙動を変更しました。

例

-- ラスタピクセルのポリゴンを得ます
SELECT (gv).x, (gv).y, (gv).val, ST_AsText((gv).geom) geom
FROM (SELECT ST_PixelAsPolygons(
                 ST_SetValue(ST_SetValue(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 0.001, -0.001, 0.001, 0.001, 4269),
                                                    '8BUI'::text, 1, 0),
                                         2, 2, 10),
                             1, 1, NULL)
) gv
) foo;

 x | y | val |                geom
---+---+-----------------------------------------------------------------------------
 1 | 1 |     | POLYGON((0 0,0.001 0.001,0.002 0,0.001 -0.001,0 0))
 1 | 2 |   1 | POLYGON((0.001 -0.001,0.002 0,0.003 -0.001,0.002 -0.002,0.001 -0.001))
 2 | 1 |   1 | POLYGON((0.001 0.001,0.002 0.002,0.003 0.001,0.002 0,0.001 0.001))
 2 | 2 |  10 | POLYGON((0.002 0,0.003 0.001,0.004 0,0.003 -0.001,0.002 0))

関連情報

ST_DumpAsPolygons, ST_PixelAsPolygon, ST_PixelAsPoint, ST_PixelAsPoints, ST_PixelAsCentroid, ST_PixelAsCentroids, ST_AsText

Name

ST_PixelAsPoint — ピクセルの左上隅のポイントジオメトリを返します。

Synopsis

geometry ST_PixelAsPoint( | rast, |
| columnx, |
| rowy); |

raster rast;
integer columnx;
integer rowy;

説明

ピクセルの左上隅のポイントジオメトリを返します。

Availability: 2.1.0

例

SELECT ST_AsText(ST_PixelAsPoint(rast, 1, 1)) FROM dummy_rast WHERE rid = 1;

   st_astext
----------------
 POINT(0.5 0.5)

関連情報

ST_DumpAsPolygons, ST_PixelAsPolygon, ST_PixelAsPolygons, ST_PixelAsPoints, ST_PixelAsCentroid, ST_PixelAsCentroids

Name

ST_PixelAsPoints — 全てのピクセルについてポイントジオメトリを、ピクセルごとのピクセル値とラスタ座標系のXとYとを付けて返します。ポイントジオメトリの座標はピクセルの左上隅です。

Synopsis

setof record ST_PixelAsPoints( | rast, |
| band=1, |
| exclude_nodata_value=TRUE); |

raster rast;
integer band=1;
boolean exclude_nodata_value=TRUE;

説明

全てのピクセルについてポイントジオメトリを、ピクセルごとのピクセル値とラスタ座標系のXとYとを付けて返します。ポイントジオメトリの座標はピクセルの左上隅です。

返されるレコードの書式は、geometry型のgeom、倍精度浮動小数点数のval、整数のx、整数のyです。

Note

exclude_nodata_valueがTRUEの時、値がNODATAでないこれらのピクセルだけをポイントとして返します。

Availability: 2.1.0

Changed: 2.1.1 exclude_nodata_valueの挙動を変更しました。

例

SELECT x, y, val, ST_AsText(geom) FROM (SELECT (ST_PixelAsPoints(rast, 1)).* FROM dummy_rast WHERE rid = 2) foo;

 x | y | val |          st_astext
---+---+-----+------------------------------
 1 | 1 | 253 | POINT(3427927.75 5793244)
 2 | 1 | 254 | POINT(3427927.8 5793244)
 3 | 1 | 253 | POINT(3427927.85 5793244)
 4 | 1 | 254 | POINT(3427927.9 5793244)
 5 | 1 | 254 | POINT(3427927.95 5793244)
 1 | 2 | 253 | POINT(3427927.75 5793243.95)
 2 | 2 | 254 | POINT(3427927.8 5793243.95)
 3 | 2 | 254 | POINT(3427927.85 5793243.95)
 4 | 2 | 253 | POINT(3427927.9 5793243.95)
 5 | 2 | 249 | POINT(3427927.95 5793243.95)
 1 | 3 | 250 | POINT(3427927.75 5793243.9)
 2 | 3 | 254 | POINT(3427927.8 5793243.9)
 3 | 3 | 254 | POINT(3427927.85 5793243.9)
 4 | 3 | 252 | POINT(3427927.9 5793243.9)
 5 | 3 | 249 | POINT(3427927.95 5793243.9)
 1 | 4 | 251 | POINT(3427927.75 5793243.85)
 2 | 4 | 253 | POINT(3427927.8 5793243.85)
 3 | 4 | 254 | POINT(3427927.85 5793243.85)
 4 | 4 | 254 | POINT(3427927.9 5793243.85)
 5 | 4 | 253 | POINT(3427927.95 5793243.85)
 1 | 5 | 252 | POINT(3427927.75 5793243.8)
 2 | 5 | 250 | POINT(3427927.8 5793243.8)
 3 | 5 | 254 | POINT(3427927.85 5793243.8)
 4 | 5 | 254 | POINT(3427927.9 5793243.8)
 5 | 5 | 254 | POINT(3427927.95 5793243.8)

関連情報

ST_DumpAsPolygons, ST_PixelAsPolygon, ST_PixelAsPolygons, ST_PixelAsPoint, ST_PixelAsCentroid, ST_PixelAsCentroids

Name

ST_PixelAsCentroid — ピクセルで表現される面の重心 (ポイントジオメトリ)を返します。

Synopsis

geometry ST_PixelAsCentroid( | rast, |
| x, |
| y); |

raster rast;
integer x;
integer y;

説明

ピクセルで表現される面の重心 (ポイントジオメトリ)を返します。

Enhanced: 3.2.0 C言語による、より高速な実装。

Availability: 2.1.0

例

SELECT ST_AsText(ST_PixelAsCentroid(rast, 1, 1)) FROM dummy_rast WHERE rid = 1;

  st_astext
--------------
 POINT(1.5 2)

関連情報

ST_DumpAsPolygons, ST_PixelAsPolygon, ST_PixelAsPolygons, ST_PixelAsPoint, ST_PixelAsPoints, ST_PixelAsCentroids

Name

ST_PixelAsCentroids — 全てのピクセルについて重心 (ポイントジオメト)リを、ピクセルごとのピクセル値とラスタ座標系のXとYとを付けて返します。ポイントジオメトリの座標はピクセルで表現される面の重心です。

Synopsis

setof record ST_PixelAsCentroids( | rast, |
| band=1, |
| exclude_nodata_value=TRUE); |

raster rast;
integer band=1;
boolean exclude_nodata_value=TRUE;

説明

全てのピクセルについて重心 (ポイントジオメト)リを、ピクセルごとのピクセル値とラスタ座標系のXとYとを付けて返します。ポイントジオメトリの座標はピクセルで表現される面の重心です。

返されるレコードの書式は、geometry型のgeom、倍精度浮動小数点数のval、整数のx、整数のyです。

Note

exclude_nodata_valueがTRUEの時、値がNODATAでないこれらのピクセルだけをポイントとして返します。

Enhanced: 3.2.0 C言語による、より高速な実装。

Changed: 2.1.1 exclude_nodata_valueの挙動を変更しました。

Availability: 2.1.0

例

-- LATERAL句を使うにはPostgreSQL 9.3以上が必要です
SELECT x, y, val, ST_AsText(geom)
    FROM (SELECT dp.* FROM dummy_rast, LATERAL ST_PixelAsCentroids(rast, 1) AS dp WHERE rid = 2) foo;
 x | y | val |           st_astext
---+---+-----+--------------------------------
 1 | 1 | 253 | POINT(3427927.775 5793243.975)
 2 | 1 | 254 | POINT(3427927.825 5793243.975)
 3 | 1 | 253 | POINT(3427927.875 5793243.975)
 4 | 1 | 254 | POINT(3427927.925 5793243.975)
 5 | 1 | 254 | POINT(3427927.975 5793243.975)
 1 | 2 | 253 | POINT(3427927.775 5793243.925)
 2 | 2 | 254 | POINT(3427927.825 5793243.925)
 3 | 2 | 254 | POINT(3427927.875 5793243.925)
 4 | 2 | 253 | POINT(3427927.925 5793243.925)
 5 | 2 | 249 | POINT(3427927.975 5793243.925)
 1 | 3 | 250 | POINT(3427927.775 5793243.875)
 2 | 3 | 254 | POINT(3427927.825 5793243.875)
 3 | 3 | 254 | POINT(3427927.875 5793243.875)
 4 | 3 | 252 | POINT(3427927.925 5793243.875)
 5 | 3 | 249 | POINT(3427927.975 5793243.875)
 1 | 4 | 251 | POINT(3427927.775 5793243.825)
 2 | 4 | 253 | POINT(3427927.825 5793243.825)
 3 | 4 | 254 | POINT(3427927.875 5793243.825)
 4 | 4 | 254 | POINT(3427927.925 5793243.825)
 5 | 4 | 253 | POINT(3427927.975 5793243.825)
 1 | 5 | 252 | POINT(3427927.775 5793243.775)
 2 | 5 | 250 | POINT(3427927.825 5793243.775)
 3 | 5 | 254 | POINT(3427927.875 5793243.775)
 4 | 5 | 254 | POINT(3427927.925 5793243.775)
 5 | 5 | 254 | POINT(3427927.975 5793243.775)

関連情報

ST_DumpAsPolygons, ST_PixelAsPolygon, ST_PixelAsPolygons, ST_PixelAsPoint, ST_PixelAsPoints, ST_PixelAsCentroid

Name

ST_Value — 指定したバンドにおけるcolumnx, rowyで指定したピクセルまたは指定したジオメトリポイントに対応するピクセルの値を返します。 バンド番号は1始まりで、指定しない場合には、1番と仮定します。exclude_nodata_valueがFALSEに設定された場合には、NODATA ピクセルを含む全てのピクセルがインタセクトするかが考慮され、値を返します。exclude_nodata_valueを渡さない場合には、ラスタのメタデータから読みます。

Synopsis

double precision ST_Value( | rast, |
| pt, |
| exclude_nodata_value=true); |

raster rast;
geometry pt;
boolean exclude_nodata_value=true;

double precision ST_Value( | rast, |
| band, |
| pt, |
| exclude_nodata_value=true, |
| resample='nearest'); |

raster rast;
integer band;
geometry pt;
boolean exclude_nodata_value=true;
text resample='nearest';

double precision ST_Value( | rast, |
| x, |
| y, |
| exclude_nodata_value=true); |

raster rast;
integer x;
integer y;
boolean exclude_nodata_value=true;

double precision ST_Value( | rast, |
| band, |
| x, |
| y, |
| exclude_nodata_value=true); |

raster rast;
integer band;
integer x;
integer y;
boolean exclude_nodata_value=true;

説明

与えたバンドの、与えた列番号、行番号のピクセル、または与えたジオメトリのポイントにおける値を返します。バンド番号は1始まりで、指定しない場合には、1番と仮定します。

exclude_nodata_valueがTRUEの場合には、nodata値でないピクセルだけを考慮します。exclude_nodata_valueがFALSEの場合には、全てのピクセルが考慮されます。

resampleパラメータの取ることができる値は、デフォルトである最近傍探索リサンプリングを行う"nearest"、バイリニア補間 (WikiPedia 英語版)を行う"bilinear"です。ピクセル中心間の値を見積もるためのものです。

Enhanced: 3.2.0 任意引数resampleが追加されました。

Enhanced: 2.0.0 任意引数exclude_nodata_valueが追加されました。

例

-- PostGISジオメトリポイントを指定してラスタの値を得ます
-- ジオメトリのSRIDはラスタと同じにします
SELECT rid, ST_Value(rast, foo.pt_geom) As b1pval, ST_Value(rast, 2, foo.pt_geom) As b2pval
FROM dummy_rast CROSS JOIN (SELECT ST_SetSRID(ST_Point(3427927.77, 5793243.76), 0) As pt_geom) As foo
WHERE rid=2;

 rid | b1pval | b2pval
-----+--------+--------
   2 |    252 |     79

-- 実際のテーブルを使った一般的な架空の例
SELECT rid, ST_Value(rast, 3, sometable.geom) As b3pval
FROM sometable
WHERE ST_Intersects(rast,sometable.geom);

SELECT rid, ST_Value(rast, 1, 1, 1) As b1pval,
    ST_Value(rast, 2, 1, 1) As b2pval, ST_Value(rast, 3, 1, 1) As b3pval
FROM dummy_rast
WHERE rid=2;

 rid | b1pval | b2pval | b3pval
-----+--------+--------+--------
   2 |    253 |     78 |     70

-- 1番、2番、3番バンドの全ての値を得ます
SELECT x, y, ST_Value(rast, 1, x, y) As b1val,
    ST_Value(rast, 2, x, y) As b2val, ST_Value(rast, 3, x, y) As b3val
FROM dummy_rast CROSS JOIN
generate_series(1, 1000) As x CROSS JOIN generate_series(1, 1000) As y
WHERE rid =  2 AND x <= ST_Width(rast) AND y <= ST_Height(rast);

 x | y | b1val | b2val | b3val
---+---+-------+-------+-------
 1 | 1 |   253 |    78 |    70
 1 | 2 |   253 |    96 |    80
 1 | 3 |   250 |    99 |    90
 1 | 4 |   251 |    89 |    77
 1 | 5 |   252 |    79 |    62
 2 | 1 |   254 |    98 |    86
 2 | 2 |   254 |   118 |   108
 :
 :

-- 上例と同じに1、2、3番バンドの全ての値を得ますが、ピクセル毎の左上隅のポイントを返します
SELECT ST_AsText(ST_SetSRID(
    ST_Point(ST_UpperLeftX(rast) + ST_ScaleX(rast)*x,
        ST_UpperLeftY(rast) + ST_ScaleY(rast)*y),
        ST_SRID(rast))) As uplpt
    , ST_Value(rast, 1, x, y) As b1val,
    ST_Value(rast, 2, x, y) As b2val, ST_Value(rast, 3, x, y) As b3val
FROM dummy_rast CROSS JOIN
generate_series(1,1000) As x CROSS JOIN generate_series(1,1000) As y
WHERE rid =  2 AND x <= ST_Width(rast) AND y <= ST_Height(rast);

            uplpt            | b1val | b2val | b3val
-----------------------------+-------+-------+-------
 POINT(3427929.25 5793245.5) |   253 |    78 |    70
 POINT(3427929.25 5793247)   |   253 |    96 |    80
 POINT(3427929.25 5793248.5) |   250 |    99 |    90
:

-- 指定した範囲内の値を持ち、指定したポリゴンにインタセクトするピクセルの
-- 全てを結合することによって形成されるポリゴンを得ます
SELECT ST_AsText(ST_Union(pixpolyg)) As shadow
FROM (SELECT ST_Translate(ST_MakeEnvelope(
        ST_UpperLeftX(rast), ST_UpperLeftY(rast),
            ST_UpperLeftX(rast) + ST_ScaleX(rast),
            ST_UpperLeftY(rast) + ST_ScaleY(rast), 0
            ), ST_ScaleX(rast)*x, ST_ScaleY(rast)*y
        ) As pixpolyg, ST_Value(rast, 2, x, y) As b2val
    FROM dummy_rast CROSS JOIN
generate_series(1,1000) As x CROSS JOIN generate_series(1,1000) As y
WHERE rid =  2
    AND x <= ST_Width(rast) AND y <= ST_Height(rast)) As foo
WHERE
    ST_Intersects(
        pixpolyg,
        ST_GeomFromText('POLYGON((3427928 5793244,3427927.75 5793243.75,3427928 5793243.75,3427928 5793244))',0)
        ) AND b2val != 254;

        shadow
------------------------------------------------------------------------------------
 MULTIPOLYGON(((3427928 5793243.9,3427928 5793243.85,3427927.95 5793243.85,3427927.95 5793243.9,
 3427927.95 5793243.95,3427928 5793243.95,3427928.05 5793243.95,3427928.05 5793243.9,3427928 5793243.9)),((3427927.95 5793243.9,3427927.95 579324
3.85,3427927.9 5793243.85,3427927.85 5793243.85,3427927.85 5793243.9,3427927.9 5793243.9,3427927.9 5793243.95,
3427927.95 5793243.95,3427927.95 5793243.9)),((3427927.85 5793243.75,3427927.85 5793243.7,3427927.8 5793243.7,3427927.8 5793243.75
,3427927.8 5793243.8,3427927.8 5793243.85,3427927.85 5793243.85,3427927.85 5793243.8,3427927.85 5793243.75)),
((3427928.05 5793243.75,3427928.05 5793243.7,3427928 5793243.7,3427927.95 5793243.7,3427927.95 5793243.75,3427927.95 5793243.8,3427
927.95 5793243.85,3427928 5793243.85,3427928 5793243.8,3427928.05 5793243.8,
3427928.05 5793243.75)),((3427927.95 5793243.75,3427927.95 5793243.7,3427927.9 5793243.7,3427927.85 5793243.7,
3427927.85 5793243.75,3427927.85 5793243.8,3427927.85 5793243.85,3427927.9 5793243.85,
3427927.95 5793243.85,3427927.95 5793243.8,3427927.95 5793243.75)))

-- 大きなラスタタイルの全てのピクセルをチェックは長時間かかります。
-- generate_seriesの任意引数stepを使用してサンプリングすることで、
-- 精度を大きく落としますが、劇的な速度改善が可能です。
-- 次の例では、前の例と同じことをしていますが、
-- 4 (2x2)ピクセルごとに1度チェックを行い、4ピクセルの値として置いています。

SELECT ST_AsText(ST_Union(pixpolyg)) As shadow
FROM (SELECT ST_Translate(ST_MakeEnvelope(
        ST_UpperLeftX(rast), ST_UpperLeftY(rast),
            ST_UpperLeftX(rast) + ST_ScaleX(rast)*2,
            ST_UpperLeftY(rast) + ST_ScaleY(rast)*2, 0
            ), ST_ScaleX(rast)*x, ST_ScaleY(rast)*y
        ) As pixpolyg, ST_Value(rast, 2, x, y) As b2val
    FROM dummy_rast CROSS JOIN
generate_series(1,1000,2) As x CROSS JOIN generate_series(1,1000,2) As y
WHERE rid =  2
    AND x <= ST_Width(rast)  AND y <= ST_Height(rast)  ) As foo
WHERE
    ST_Intersects(
        pixpolyg,
        ST_GeomFromText('POLYGON((3427928 5793244,3427927.75 5793243.75,3427928 5793243.75,3427928 5793244))',0)
        ) AND b2val != 254;

        shadow
------------------------------------------------------------------------------------
 MULTIPOLYGON(((3427927.9 5793243.85,3427927.8 5793243.85,3427927.8 5793243.95,
 3427927.9 5793243.95,3427928 5793243.95,3427928.1 5793243.95,3427928.1 5793243.85,3427928 5793243.85,3427927.9 5793243.85)),
 ((3427927.9 5793243.65,3427927.8 5793243.65,3427927.8 5793243.75,3427927.8 5793243.85,3427927.9 5793243.85,
 3427928 5793243.85,3427928 5793243.75,3427928.1 5793243.75,3427928.1 5793243.65,3427928 5793243.65,3427927.9 5793243.65)))

関連情報

ST_SetValue, ST_DumpAsPolygons, ST_NumBands, ST_PixelAsPolygon, ST_ScaleX, ST_ScaleY, ST_UpperLeftX, ST_UpperLeftY, ST_SRID, ST_AsText, ST_Point, ST_MakeEnvelope, ST_Intersects, ST_Intersection

Name

ST_NearestValue — 与えられたバンドの、columnxとrowyで指定されるか、またはラスタと同じ空間参照系で表現されたポイントで指定されたピクセルに最も近いNODATAでない値を返します。

Synopsis

double precision ST_NearestValue( | rast, |
| bandnum, |
| pt, |
| exclude_nodata_value=true); |

raster rast;
integer bandnum;
geometry pt;
boolean exclude_nodata_value=true;

double precision ST_NearestValue( | rast, |
| pt, |
| exclude_nodata_value=true); |

raster rast;
geometry pt;
boolean exclude_nodata_value=true;

double precision ST_NearestValue( | rast, |
| bandnum, |
| columnx, |
| rowy, |
| exclude_nodata_value=true); |

raster rast;
integer bandnum;
integer columnx;
integer rowy;
boolean exclude_nodata_value=true;

double precision ST_NearestValue( | rast, |
| columnx, |
| rowy, |
| exclude_nodata_value=true); |

raster rast;
integer columnx;
integer rowy;
boolean exclude_nodata_value=true;

説明

与えられたバンドの、columnxとrowyで指定されるか、またはラスタと同じ空間参照系で表現されたポイントで指定されたピクセルに最も近いNODATAでない値を返します。columnx, rowyピクセルまたは指定したジオメトリポイントのピクセルがNODATAである場合には、この関数は、columnx, rowyピクセルかジオメトリポイントのピクセルから最も近いNODATA.でないピクセルを探索します。

バンド番号は1始まりで、bandnumが指定されていない場合には、1番と仮定します。exclude_nodata_valueがFALSEに設定された場合には、NODATAピクセルを含む全てのピクセルがインタセクトするかが考慮され、値を返します。exclude_nodata_valueを渡さない場合には、ラスタのメタデータから読みます。

Availability: 2.1.0

Note

ST_NearestValueはST_Valueと交換可能です。

例

-- 2,2ピクセルは値を持っています
SELECT
    ST_Value(rast, 2, 2) AS value,
    ST_NearestValue(rast, 2, 2) AS nearestvalue
FROM (
    SELECT
        ST_SetValue(
            ST_SetValue(
                ST_SetValue(
                    ST_SetValue(
                        ST_SetValue(
                            ST_AddBand(
                                ST_MakeEmptyRaster(5, 5, -2, 2, 1, -1, 0, 0, 0),
                                '8BUI'::text, 1, 0
                            ),
                            1, 1, 0.
                        ),
                        2, 3, 0.
                    ),
                    3, 5, 0.
                ),
                4, 2, 0.
            ),
            5, 4, 0.
        ) AS rast
) AS foo

 value | nearestvalue
-------+--------------
     1 |            1

-- 2,3ピクセルはNODATAです
SELECT
    ST_Value(rast, 2, 3) AS value,
    ST_NearestValue(rast, 2, 3) AS nearestvalue
FROM (
    SELECT
        ST_SetValue(
            ST_SetValue(
                ST_SetValue(
                    ST_SetValue(
                        ST_SetValue(
                            ST_AddBand(
                                ST_MakeEmptyRaster(5, 5, -2, 2, 1, -1, 0, 0, 0),
                                '8BUI'::text, 1, 0
                            ),
                            1, 1, 0.
                        ),
                        2, 3, 0.
                    ),
                    3, 5, 0.
                ),
                4, 2, 0.
            ),
            5, 4, 0.
        ) AS rast
) AS foo

 value | nearestvalue
-------+--------------
       |            1

関連情報

ST_Neighborhood, ST_Value

Name

ST_SetZ — 入力ジオメトリと同じX/y座標値と、指定されたリサンプリングアルゴリズムを使ってラスタから複写されたZ値とを持つジオメトリを返します。

Synopsis

geometry ST_SetZ( | rast, |
| geom, |
| resample=nearest, |
| band=1); |

raster rast;
geometry geom;
text resample=nearest;
integer band=1;

説明

入力ジオメトリと同じX/Y座標値と、指定されたリサンプリングアルゴリズムを使ってラスタから複写されたZ値とを持つジオメトリを返します。

resampleパラメータの取ることができる値は、デフォルトである最近傍探索リサンプリングを行う"nearest"、バイリニア補間 (WikiPedia 英語版)を行う"bilinear"です。近隣セルも考慮に入れた値を計算するためのものです。

Availability: 3.2.0

例

--
-- 値を持つ2x2ラスタ
--
-- 10 50
-- 40 20
--
WITH test_raster AS (
SELECT
ST_SetValues(
  ST_AddBand(
    ST_MakeEmptyRaster(width =
> 2, height =
> 2,
      upperleftx =
> 0, upperlefty =
> 2,
      scalex =
> 1.0, scaley =
> -1.0,
      skewx =
> 0, skewy =
> 0, srid =
> 4326),
    index =
> 1, pixeltype =
> '16BSI',
    initialvalue =
> 0,
    nodataval =
> -999),
  1,1,1,
  newvalueset =
>ARRAY[ARRAY[10.0::float8, 50.0::float8], ARRAY[40.0::float8, 20.0::float8]]) AS rast
)
SELECT
ST_AsText(
  ST_SetZ(
    rast,
    band =
> 1,
    geom =
> 'SRID=4326;LINESTRING(1.0 1.9, 1.0 0.2)'::geometry,
    resample =
> 'bilinear'
))
FROM test_raster

            st_astext
----------------------------------
 LINESTRING Z (1 1.9 38,1 0.2 27)

関連情報

ST_Value, ST_SetM

Name

ST_SetM — 入力ジオメトリと同じX/Y値を持ち、かつ、指定されたリサンプリングアルゴリズムを使ってラスタから複写されたM値を持つジオメトリを返します。

Synopsis

geometry ST_SetM( | rast, |
| geom, |
| resample=nearest, |
| band=1); |

raster rast;
geometry geom;
text resample=nearest;
integer band=1;

説明

入力ジオメトリと同じX/Y値を持ち、かつ、指定されたリサンプリングアルゴリズムを使ってラスタから複写されたM値を持つジオメトリを返します。

resampleパラメータの取ることができる値は、デフォルトである最近傍探索リサンプリングを行う"nearest"、バイリニア補間 (WikiPedia 英語版)を行う"bilinear"です。近隣セルも考慮に入れた値を計算するためのものです。

Availability: 3.2.0

例

--
-- 値を持つ2x2ラスタ
--
-- 10 50
-- 40 20
--
WITH test_raster AS (
SELECT
ST_SetValues(
  ST_AddBand(
    ST_MakeEmptyRaster(width =
> 2, height =
> 2,
      upperleftx =
> 0, upperlefty =
> 2,
      scalex =
> 1.0, scaley =
> -1.0,
      skewx =
> 0, skewy =
> 0, srid =
> 4326),
    index =
> 1, pixeltype =
> '16BSI',
    initialvalue =
> 0,
    nodataval =
> -999),
  1,1,1,
  newvalueset =
>ARRAY[ARRAY[10.0::float8, 50.0::float8], ARRAY[40.0::float8, 20.0::float8]]) AS rast
)
SELECT
ST_AsText(
  ST_SetM(
    rast,
    band =
> 1,
    geom =
> 'SRID=4326;LINESTRING(1.0 1.9, 1.0 0.2)'::geometry,
    resample =
> 'bilinear'
))
FROM test_raster

            st_astext
----------------------------------
 LINESTRING M (1 1.9 38,1 0.2 27)

関連情報

ST_Value, ST_SetZ

Name

ST_Neighborhood — 与えられたバンドのcolumnX, columnYか、ラスタと同じ空間参照系のジオメトリポイントで指定されたピクセルの周囲にある、NODATAでない2次元倍精度浮動小数点数配列を返します。

Synopsis

double precision[][] ST_Neighborhood( | rast, |
| bandnum, |
| columnX, |
| rowY, |
| distanceX, |
| distanceY, |
| exclude_nodata_value=true); |

raster rast;
integer bandnum;
integer columnX;
integer rowY;
integer distanceX;
integer distanceY;
boolean exclude_nodata_value=true;

double precision[][] ST_Neighborhood( | rast, |
| columnX, |
| rowY, |
| distanceX, |
| distanceY, |
| exclude_nodata_value=true); |

raster rast;
integer columnX;
integer rowY;
integer distanceX;
integer distanceY;
boolean exclude_nodata_value=true;

double precision[][] ST_Neighborhood( | rast, |
| bandnum, |
| pt, |
| distanceX, |
| distanceY, |
| exclude_nodata_value=true); |

raster rast;
integer bandnum;
geometry pt;
integer distanceX;
integer distanceY;
boolean exclude_nodata_value=true;

double precision[][] ST_Neighborhood( | rast, |
| pt, |
| distanceX, |
| distanceY, |
| exclude_nodata_value=true); |

raster rast;
geometry pt;
integer distanceX;
integer distanceY;
boolean exclude_nodata_value=true;

説明

与えられたバンドのcolumnX, columnYか、ラスタと同じ空間参照系のジオメトリポイントで指定されたピクセルの周囲にある、NODATAでない2次元倍精度浮動小数点数配列を返します。distanceXとdistanceY引数は、たとえば、対象ピクセルからX軸に沿って3ピクセルとしてY軸に沿って2ピクセルというふうに、指定したピクセルの周囲のピクセル数を、それぞれX方向とY方向に定義します。2次元配列の中心の値はcolumnX, columnYまたはジオメトリポイントで指定したピクセルの値です。

バンド番号は1始まりで、bandnumが指定されていない場合には、1番と仮定します。exclude_nodata_valueがFALSEに設定された場合には、NODATAピクセルを含む全てのピクセルがインタセクトするかが考慮され、値を返します。exclude_nodata_valueを渡さない場合には、ラスタのメタデータから読みます。

Note

返される2次元配列の各軸の要素数は2 * (distanceX|distanceY) + 1です。distanceXとdistanceYを1にすると、3x3の配列が返ります。

Note

2次元配列の出力はST_Min4ma, ST_Sum4ma, ST_Mean4maといったあらゆるラスタ処理関数に渡すことができます。

Availability: 2.1.0

例

-- 2x2ピクセルは値を持っています
SELECT
    ST_Neighborhood(rast, 2, 2, 1, 1)
FROM (
    SELECT
        ST_SetValues(
            ST_AddBand(
                ST_MakeEmptyRaster(5, 5, -2, 2, 1, -1, 0, 0, 0),
                '8BUI'::text, 1, 0
            ),
            1, 1, 1, ARRAY[
                [0, 1, 1, 1, 1],
                [1, 1, 1, 0, 1],
                [1, 0, 1, 1, 1],
                [1, 1, 1, 1, 0],
                [1, 1, 0, 1, 1]
            ]::double precision[],
            1
        ) AS rast
) AS foo

         st_neighborhood
---------------------------------
{{NULL,1,1},{1,1,1},{1,NULL,1}}

-- 2,3ピクセルはNODATAです
SELECT
    ST_Neighborhood(rast, 2, 3, 1, 1)
FROM (
    SELECT
        ST_SetValues(
            ST_AddBand(
                ST_MakeEmptyRaster(5, 5, -2, 2, 1, -1, 0, 0, 0),
                '8BUI'::text, 1, 0
            ),
            1, 1, 1, ARRAY[
                [0, 1, 1, 1, 1],
                [1, 1, 1, 0, 1],
                [1, 0, 1, 1, 1],
                [1, 1, 1, 1, 0],
                [1, 1, 0, 1, 1]
            ]::double precision[],
            1
        ) AS rast
) AS foo

       st_neighborhood
------------------------------
 {{1,1,1},{1,NULL,1},{1,1,1}}

-- 3x3ピクセルは値を持っています
-- exclude_nodata_value = FALSE
SELECT
    ST_Neighborhood(rast, 3, 3, 1, 1, false)
FROM ST_SetValues(
            ST_AddBand(
                ST_MakeEmptyRaster(5, 5, -2, 2, 1, -1, 0, 0, 0),
                '8BUI'::text, 1, 0
            ),
            1, 1, 1, ARRAY[
                [0, 1, 1, 1, 1],
                [1, 1, 1, 0, 1],
                [1, 0, 1, 1, 1],
                [1, 1, 1, 1, 0],
                [1, 1, 0, 1, 1]
            ]::double precision[],
            1
        ) AS rast

      st_neighborhood
---------------------------
{{1,1,0},{0,1,1},{1,1,1}}

関連情報

ST_NearestValue, ST_Min4ma, ST_Max4ma, ST_Sum4ma, ST_Mean4ma, ST_Range4ma, ST_Distinct4ma, ST_StdDev4ma

Name

ST_SetValue — 与えられたバンドのcolumnX, columnYか、ラスタと同じ空間参照系のジオメトリポイントで指定されたピクセルの値または指定したジオメトリとインタセクトするピクセル群の値を設定することから得られる、変更されたラスタを返します。バンド番号は1始まりで、指定しない場合には、1番と仮定します。

Synopsis

raster ST_SetValue( | rast, |
| bandnum, |
| geom, |
| newvalue); |

raster rast;
integer bandnum;
geometry geom;
double precision newvalue;

raster ST_SetValue( | rast, |
| geom, |
| newvalue); |

raster rast;
geometry geom;
double precision newvalue;

raster ST_SetValue( | rast, |
| bandnum, |
| columnx, |
| rowy, |
| newvalue); |

raster rast;
integer bandnum;
integer columnx;
integer rowy;
double precision newvalue;

raster ST_SetValue( | rast, |
| columnx, |
| rowy, |
| newvalue); |

raster rast;
integer columnx;
integer rowy;
double precision newvalue;

説明

指定されたバンドの、与えられたラスタの行と列またはジオメトリで指定したピクセルの値を新しい値に設定することで得られる、変更したラスタを返します。バンドが指定されいていない場合には、1番と仮定します。

Enhanced: 2.1.0 ST_SetValueでジオメトリを用いる形式が、ポイントだけでなくあらゆるジオメトリタイプに対応するようになりました。ジオメトリを用いる形式はST_SetValuesのgeomval[]を用いる形式をラップしたものです。

例

-- ジオメトリの例
SELECT (foo.geomval).val, ST_AsText(ST_Union((foo.geomval).geom))
FROM (SELECT ST_DumpAsPolygons(
        ST_SetValue(rast,1,
                ST_Point(3427927.75, 5793243.95),
                50)
            ) As geomval
FROM dummy_rast
where rid = 2) As foo
WHERE (foo.geomval).val < 250
GROUP BY (foo.geomval).val;

 val |                                                     st_astext
-----+-------------------------------------------------------------------
  50 | POLYGON((3427927.75 5793244,3427927.75 5793243.95,3427927.8 579324 ...
 249 | POLYGON((3427927.95 5793243.95,3427927.95 5793243.85,3427928 57932 ...

-- 変更したラスタの格納 --
    UPDATE dummy_rast SET rast = ST_SetValue(rast,1, ST_Point(3427927.75, 5793243.95),100)
        WHERE rid = 2   ;

関連情報

ST_Value, ST_DumpAsPolygons

Name

ST_SetValues — 与えられたバンドに複数の値を設定して、変更されたラスタを返します。

Synopsis

raster ST_SetValues( | rast, |
| nband, |
| columnx, |
| rowy, |
| newvalueset, |
| noset=NULL, |
| keepnodata=FALSE); |

raster rast;
integer nband;
integer columnx;
integer rowy;
double precision[][] newvalueset;
boolean[][] noset=NULL;
boolean keepnodata=FALSE;

raster ST_SetValues( | rast, |
| nband, |
| columnx, |
| rowy, |
| newvalueset, |
| nosetvalue, |
| keepnodata=FALSE); |

raster rast;
integer nband;
integer columnx;
integer rowy;
double precision[][] newvalueset;
double precision nosetvalue;
boolean keepnodata=FALSE;

raster ST_SetValues( | rast, |
| nband, |
| columnx, |
| rowy, |
| width, |
| height, |
| newvalue, |
| keepnodata=FALSE); |

raster rast;
integer nband;
integer columnx;
integer rowy;
integer width;
integer height;
double precision newvalue;
boolean keepnodata=FALSE;

raster ST_SetValues( | rast, |
| columnx, |
| rowy, |
| width, |
| height, |
| newvalue, |
| keepnodata=FALSE); |

raster rast;
integer columnx;
integer rowy;
integer width;
integer height;
double precision newvalue;
boolean keepnodata=FALSE;

raster ST_SetValues( | rast, |
| nband, |
| geomvalset, |
| keepnodata=FALSE); |

raster rast;
integer nband;
geomval[] geomvalset;
boolean keepnodata=FALSE;

説明

指定したバンドの指定したピクセルに新しい値を設定した結果として変更されたラスタを返します。columnxとrowyは1始まりです。

keepnodataがTRUEの場合には、NODATA値を持つピクセルはnewvaluesetに一致する値に設定しません。

一つ目の形式では、設定するピクセルをcolumnx, rowyのピクセル座標で決定し、 範囲をnewvalueset配列で決定します。nosetによって、ピクセルをnewvalueset内にある値で、一部を設定されないようにすることができます (PostgreSQLは不調和配列、ジャグ配列を許さないため)。一つ目の形式の例をご覧ください。

二つ目の形式では、一つ目の形式と似ていますが、倍精度浮動小数点数のスカラ値であるnosetvalueをnoset配列の代わりに使う点が違います。nosetvalueの値になるnewvalueset内の要素の設定は行いません。二つ目の形式の例をご覧下さい。

三つ目の形式では、設定するピクセルをcolumnx, rowyのピクセル座標とwidth, height.で決定します。三つ目の形式の例をご覧ください。

四つ目の形式では、rastの1番バンドのピクセルを設定すると仮定する点を除いては、三つ目の形式と同じです。

五つ目の形式では、設定するピクセルをgeomvalの配列で決定します。配列内の全てのジオメトリのタイプがPOINTまたはMULTIPOINTである場合には、ポイントごとの経度と緯度がピクセルの設定に直接使うためのショートカットに使われます。他の場合には、ジオメトリはラスタに変換され一つずつ渡されます。五つ目の形式の例をご覧下さい。

Availability: 2.1.0

例: 一つ目の形式

/*
ST_SetValues()によって次のように書き換わります

+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |          | 1 | 1 | 1 |
+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |    =
>    | 1 | 9 | 9 |
+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |          | 1 | 9 | 9 |
+ - + - + - +          + - + - + - +
*/
SELECT
    (poly).x,
    (poly).y,
    (poly).val
FROM (
SELECT
    ST_PixelAsPolygons(
        ST_SetValues(
            ST_AddBand(
                ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, 0),
                1, '8BUI', 1, 0
            ),
            1, 2, 2, ARRAY[[9, 9], [9, 9]]::double precision[][]
        )
    ) AS poly
) foo
ORDER BY 1, 2;

 x | y | val
---+---+-----
 1 | 1 |   1
 1 | 2 |   1
 1 | 3 |   1
 2 | 1 |   1
 2 | 2 |   9
 2 | 3 |   9
 3 | 1 |   1
 3 | 2 |   9
 3 | 3 |   9

/*
ST_SetValues()によって次のように書き換わります

+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |          | 9 | 9 | 9 |
+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |    =
>    | 9 |   | 9 |
+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |          | 9 | 9 | 9 |
+ - + - + - +          + - + - + - +
*/
SELECT
    (poly).x,
    (poly).y,
    (poly).val
FROM (
SELECT
    ST_PixelAsPolygons(
        ST_SetValues(
            ST_AddBand(
                ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, 0),
                1, '8BUI', 1, 0
            ),
            1, 1, 1, ARRAY[[9, 9, 9], [9, NULL, 9], [9, 9, 9]]::double precision[][]
        )
    ) AS poly
) foo
ORDER BY 1, 2;

 x | y | val
---+---+-----
 1 | 1 |   9
 1 | 2 |   9
 1 | 3 |   9
 2 | 1 |   9
 2 | 2 |
 2 | 3 |   9
 3 | 1 |   9
 3 | 2 |   9
 3 | 3 |   9

/*
ST_SetValues()によって次のように書き換わります

+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |          | 9 | 9 | 9 |
+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |    =
>    | 1 |   | 9 |
+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |          | 9 | 9 | 9 |
+ - + - + - +          + - + - + - +
*/
SELECT
    (poly).x,
    (poly).y,
    (poly).val
FROM (
SELECT
    ST_PixelAsPolygons(
        ST_SetValues(
            ST_AddBand(
                ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, 0),
                1, '8BUI', 1, 0
            ),
            1, 1, 1,
                ARRAY[[9, 9, 9], [9, NULL, 9], [9, 9, 9]]::double precision[][],
                ARRAY[[false], [true]]::boolean[][]
        )
    ) AS poly
) foo
ORDER BY 1, 2;

 x | y | val
---+---+-----
 1 | 1 |   9
 1 | 2 |   1
 1 | 3 |   9
 2 | 1 |   9
 2 | 2 |
 2 | 3 |   9
 3 | 1 |   9
 3 | 2 |   9
 3 | 3 |   9

/*
ST_SetValues()によって次のように書き換わります

+ - + - + - +          + - + - + - +
|   | 1 | 1 |          |   | 9 | 9 |
+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |    =
>    | 1 |   | 9 |
+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |          | 9 | 9 | 9 |
+ - + - + - +          + - + - + - +
*/
SELECT
    (poly).x,
    (poly).y,
    (poly).val
FROM (
SELECT
    ST_PixelAsPolygons(
        ST_SetValues(
            ST_SetValue(
                ST_AddBand(
                    ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, 0),
                    1, '8BUI', 1, 0
                ),
                1, 1, 1, NULL
            ),
            1, 1, 1,
                ARRAY[[9, 9, 9], [9, NULL, 9], [9, 9, 9]]::double precision[][],
                ARRAY[[false], [true]]::boolean[][],
                TRUE
        )
    ) AS poly
) foo
ORDER BY 1, 2;

 x | y | val
---+---+-----
 1 | 1 |
 1 | 2 |   1
 1 | 3 |   9
 2 | 1 |   9
 2 | 2 |
 2 | 3 |   9
 3 | 1 |   9
 3 | 2 |   9
 3 | 3 |   9

例: 二つ目の形式

/*
ST_SetValues()によって次のように書き換わります

+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |          | 1 | 1 | 1 |
+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |    =
>    | 1 | 9 | 9 |
+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |          | 1 | 9 | 9 |
+ - + - + - +          + - + - + - +
*/
SELECT
    (poly).x,
    (poly).y,
    (poly).val
FROM (
SELECT
    ST_PixelAsPolygons(
        ST_SetValues(
            ST_AddBand(
                ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, 0),
                1, '8BUI', 1, 0
            ),
            1, 1, 1, ARRAY[[-1, -1, -1], [-1, 9, 9], [-1, 9, 9]]::double precision[][], -1
        )
    ) AS poly
) foo
ORDER BY 1, 2;

 x | y | val
---+---+-----
 1 | 1 |   1
 1 | 2 |   1
 1 | 3 |   1
 2 | 1 |   1
 2 | 2 |   9
 2 | 3 |   9
 3 | 1 |   1
 3 | 2 |   9
 3 | 3 |   9

/*
この例は上の例と似ていますが、nosetvalueを-1でなくNULLにしています。

ST_SetValues()によって次のように書き換わります

+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |          | 1 | 1 | 1 |
+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |    =
>    | 1 | 9 | 9 |
+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |          | 1 | 9 | 9 |
+ - + - + - +          + - + - + - +
*/
SELECT
    (poly).x,
    (poly).y,
    (poly).val
FROM (
SELECT
    ST_PixelAsPolygons(
        ST_SetValues(
            ST_AddBand(
                ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, 0),
                1, '8BUI', 1, 0
            ),
            1, 1, 1, ARRAY[[NULL, NULL, NULL], [NULL, 9, 9], [NULL, 9, 9]]::double precision[][], NULL::double precision
        )
    ) AS poly
) foo
ORDER BY 1, 2;

 x | y | val
---+---+-----
 1 | 1 |   1
 1 | 2 |   1
 1 | 3 |   1
 2 | 1 |   1
 2 | 2 |   9
 2 | 3 |   9
 3 | 1 |   1
 3 | 2 |   9
 3 | 3 |   9

例: 三つ目の形式

/*
ST_SetValues()によって次のように書き換わります

+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |          | 1 | 1 | 1 |
+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |    =
>    | 1 | 9 | 9 |
+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |          | 1 | 9 | 9 |
+ - + - + - +          + - + - + - +
*/
SELECT
    (poly).x,
    (poly).y,
    (poly).val
FROM (
SELECT
    ST_PixelAsPolygons(
        ST_SetValues(
            ST_AddBand(
                ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, 0),
                1, '8BUI', 1, 0
            ),
            1, 2, 2, 2, 2, 9
        )
    ) AS poly
) foo
ORDER BY 1, 2;

 x | y | val
---+---+-----
 1 | 1 |   1
 1 | 2 |   1
 1 | 3 |   1
 2 | 1 |   1
 2 | 2 |   9
 2 | 3 |   9
 3 | 1 |   1
 3 | 2 |   9
 3 | 3 |   9

/*
ST_SetValues()によって次のように書き換わります

+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |          | 1 | 1 | 1 |
+ - + - + - +          + - + - + - +
| 1 |   | 1 |    =
>    | 1 |   | 9 |
+ - + - + - +          + - + - + - +
| 1 | 1 | 1 |          | 1 | 9 | 9 |
+ - + - + - +          + - + - + - +
*/
SELECT
    (poly).x,
    (poly).y,
    (poly).val
FROM (
SELECT
    ST_PixelAsPolygons(
        ST_SetValues(
            ST_SetValue(
                ST_AddBand(
                    ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, 0),
                    1, '8BUI', 1, 0
                ),
                1, 2, 2, NULL
            ),
            1, 2, 2, 2, 2, 9, TRUE
        )
    ) AS poly
) foo
ORDER BY 1, 2;

 x | y | val
---+---+-----
 1 | 1 |   1
 1 | 2 |   1
 1 | 3 |   1
 2 | 1 |   1
 2 | 2 |
 2 | 3 |   9
 3 | 1 |   1
 3 | 2 |   9
 3 | 3 |   9

例: 五つ目の形式

WITH foo AS (
    SELECT 1 AS rid, ST_AddBand(ST_MakeEmptyRaster(5, 5, 0, 0, 1, -1, 0, 0, 0), 1, '8BUI', 0, 0) AS rast
), bar AS (
    SELECT 1 AS gid, 'SRID=0;POINT(2.5 -2.5)'::geometry geom UNION ALL
    SELECT 2 AS gid, 'SRID=0;POLYGON((1 -1, 4 -1, 4 -4, 1 -4, 1 -1))'::geometry geom UNION ALL
    SELECT 3 AS gid, 'SRID=0;POLYGON((0 0, 5 0, 5 -1, 1 -1, 1 -4, 0 -4, 0 0))'::geometry geom UNION ALL
    SELECT 4 AS gid, 'SRID=0;MULTIPOINT(0 0, 4 4, 4 -4)'::geometry
)
SELECT
    rid, gid, ST_DumpValues(ST_SetValue(rast, 1, geom, gid))
FROM foo t1
CROSS JOIN bar t2
ORDER BY rid, gid;

 rid | gid |                                                                st_dumpvalues
-----+-----+---------------------------------------------------------------------------------------------------------------------------------------------
   1 |   1 | (1,"{{NULL,NULL,NULL,NULL,NULL},{NULL,NULL,NULL,NULL,NULL},{NULL,NULL,1,NULL,NULL},{NULL,NULL,NULL,NULL,NULL},{NULL,NULL,NULL,NULL,NULL}}")
   1 |   2 | (1,"{{NULL,NULL,NULL,NULL,NULL},{NULL,2,2,2,NULL},{NULL,2,2,2,NULL},{NULL,2,2,2,NULL},{NULL,NULL,NULL,NULL,NULL}}")
   1 |   3 | (1,"{{3,3,3,3,3},{3,NULL,NULL,NULL,NULL},{3,NULL,NULL,NULL,NULL},{3,NULL,NULL,NULL,NULL},{NULL,NULL,NULL,NULL,NULL}}")
   1 |   4 | (1,"{{4,NULL,NULL,NULL,NULL},{NULL,NULL,NULL,NULL,NULL},{NULL,NULL,NULL,NULL,NULL},{NULL,NULL,NULL,NULL,NULL},{NULL,NULL,NULL,NULL,4}}")
(4 rows)

配列内における後のgeomvalsで前のgeomvalsを上書きできることを示しています。

WITH foo AS (
    SELECT 1 AS rid, ST_AddBand(ST_MakeEmptyRaster(5, 5, 0, 0, 1, -1, 0, 0, 0), 1, '8BUI', 0, 0) AS rast
), bar AS (
    SELECT 1 AS gid, 'SRID=0;POINT(2.5 -2.5)'::geometry geom UNION ALL
    SELECT 2 AS gid, 'SRID=0;POLYGON((1 -1, 4 -1, 4 -4, 1 -4, 1 -1))'::geometry geom UNION ALL
    SELECT 3 AS gid, 'SRID=0;POLYGON((0 0, 5 0, 5 -1, 1 -1, 1 -4, 0 -4, 0 0))'::geometry geom UNION ALL
    SELECT 4 AS gid, 'SRID=0;MULTIPOINT(0 0, 4 4, 4 -4)'::geometry
)
SELECT
    t1.rid, t2.gid, t3.gid, ST_DumpValues(ST_SetValues(rast, 1, ARRAY[ROW(t2.geom, t2.gid), ROW(t3.geom, t3.gid)]::geomval[]))
FROM foo t1
CROSS JOIN bar t2
CROSS JOIN bar t3
WHERE t2.gid = 1
    AND t3.gid = 2
ORDER BY t1.rid, t2.gid, t3.gid;

 rid | gid | gid |                                                    st_dumpvalues
-----+-----+-----+---------------------------------------------------------------------------------------------------------------------
   1 |   1 |   2 | (1,"{{NULL,NULL,NULL,NULL,NULL},{NULL,2,2,2,NULL},{NULL,2,2,2,NULL},{NULL,2,2,2,NULL},{NULL,NULL,NULL,NULL,NULL}}")
(1 row)

この例は前の例の逆です。

WITH foo AS (
    SELECT 1 AS rid, ST_AddBand(ST_MakeEmptyRaster(5, 5, 0, 0, 1, -1, 0, 0, 0), 1, '8BUI', 0, 0) AS rast
), bar AS (
    SELECT 1 AS gid, 'SRID=0;POINT(2.5 -2.5)'::geometry geom UNION ALL
    SELECT 2 AS gid, 'SRID=0;POLYGON((1 -1, 4 -1, 4 -4, 1 -4, 1 -1))'::geometry geom UNION ALL
    SELECT 3 AS gid, 'SRID=0;POLYGON((0 0, 5 0, 5 -1, 1 -1, 1 -4, 0 -4, 0 0))'::geometry geom UNION ALL
    SELECT 4 AS gid, 'SRID=0;MULTIPOINT(0 0, 4 4, 4 -4)'::geometry
)
SELECT
    t1.rid, t2.gid, t3.gid, ST_DumpValues(ST_SetValues(rast, 1, ARRAY[ROW(t2.geom, t2.gid), ROW(t3.geom, t3.gid)]::geomval[]))
FROM foo t1
CROSS JOIN bar t2
CROSS JOIN bar t3
WHERE t2.gid = 2
    AND t3.gid = 1
ORDER BY t1.rid, t2.gid, t3.gid;

 rid | gid | gid |                                                    st_dumpvalues
-----+-----+-----+---------------------------------------------------------------------------------------------------------------------
   1 |   2 |   1 | (1,"{{NULL,NULL,NULL,NULL,NULL},{NULL,2,2,2,NULL},{NULL,2,1,2,NULL},{NULL,2,2,2,NULL},{NULL,NULL,NULL,NULL,NULL}}")
(1 row)

関連情報

ST_Value, ST_SetValue, ST_PixelAsPolygons

Name

ST_DumpValues — 指定したバンドの値を2次元で得ます。

Synopsis

setof record ST_DumpValues( | rast, |
| nband=NULL, |
| exclude_nodata_value=true); |

raster rast ;
integer[] nband=NULL ;
boolean exclude_nodata_value=true ;

double precision[][] ST_DumpValues( | rast, |
| nband, |
| exclude_nodata_value=true); |

raster rast ;
integer nband ;
boolean exclude_nodata_value=true ;

説明

指定したバンドの値を2次元で得ます (一つ目の添え字で行、二つ目の添え字で列に、それぞれ対応します)。nbandがNULLまたは指定されていない場合には、全てのラスタバンドが処理されます。

Availability: 2.1.0

例

WITH foo AS (
    SELECT ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, 0), 1, '8BUI'::text, 1, 0), 2, '32BF'::text, 3, -9999), 3, '16BSI', 0, 0) AS rast
)
SELECT
    (ST_DumpValues(rast)).*
FROM foo;

 nband |                       valarray
-------+------------------------------------------------------
     1 | {{1,1,1},{1,1,1},{1,1,1}}
     2 | {{3,3,3},{3,3,3},{3,3,3}}
     3 | {{NULL,NULL,NULL},{NULL,NULL,NULL},{NULL,NULL,NULL}}
(3 rows)

WITH foo AS (
    SELECT ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, 0), 1, '8BUI'::text, 1, 0), 2, '32BF'::text, 3, -9999), 3, '16BSI', 0, 0) AS rast
)
SELECT
    (ST_DumpValues(rast, ARRAY[3, 1])).*
FROM foo;

 nband |                       valarray
-------+------------------------------------------------------
     3 | {{NULL,NULL,NULL},{NULL,NULL,NULL},{NULL,NULL,NULL}}
     1 | {{1,1,1},{1,1,1},{1,1,1}}
(2 rows)

WITH foo AS (
    SELECT ST_SetValue(ST_AddBand(ST_MakeEmptyRaster(3, 3, 0, 0, 1, -1, 0, 0, 0), 1, '8BUI', 1, 0), 1, 2, 5) AS rast
)
SELECT
    (ST_DumpValues(rast, 1))[2][1]
FROM foo;

 st_dumpvalues
---------------
             5
(1 row)

関連情報

ST_Value, ST_SetValue, ST_SetValues

Name

ST_PixelOfValue — 検索値と同じ値を持つピクセルのcolumnx, rowyピクセル座標を得ます。

Synopsis

setof record ST_PixelOfValue( | rast, |
| nband, |
| search, |
| exclude_nodata_value=true); |

raster rast ;
integer nband ;
double precision[] search ;
boolean exclude_nodata_value=true ;

setof record ST_PixelOfValue( | rast, |
| search, |
| exclude_nodata_value=true); |

raster rast ;
double precision[] search ;
boolean exclude_nodata_value=true ;

setof record ST_PixelOfValue( | rast, |
| nband, |
| search, |
| exclude_nodata_value=true); |

raster rast ;
integer nband ;
double precision search ;
boolean exclude_nodata_value=true ;

setof record ST_PixelOfValue( | rast, |
| search, |
| exclude_nodata_value=true); |

raster rast ;
double precision search ;
boolean exclude_nodata_value=true ;

説明

検索値と同じ値を持つピクセルのcolumnx, rowyピクセル座標を得ます。バンドを指定しない場合には、1番と仮定します。

Availability: 2.1.0

例

SELECT
    (pixels).*
FROM (
    SELECT
        ST_PixelOfValue(
            ST_SetValue(
                ST_SetValue(
                    ST_SetValue(
                        ST_SetValue(
                            ST_SetValue(
                                ST_AddBand(
                                    ST_MakeEmptyRaster(5, 5, -2, 2, 1, -1, 0, 0, 0),
                                    '8BUI'::text, 1, 0
                                ),
                                1, 1, 0
                            ),
                            2, 3, 0
                        ),
                        3, 5, 0
                    ),
                    4, 2, 0
                ),
                5, 4, 255
            )
        , 1, ARRAY[1, 255]) AS pixels
) AS foo

 val | x | y
-----+---+---
   1 | 1 | 2
   1 | 1 | 3
   1 | 1 | 4
   1 | 1 | 5
   1 | 2 | 1
   1 | 2 | 2
   1 | 2 | 4
   1 | 2 | 5
   1 | 3 | 1
   1 | 3 | 2
   1 | 3 | 3
   1 | 3 | 4
   1 | 4 | 1
   1 | 4 | 3
   1 | 4 | 4
   1 | 4 | 5
   1 | 5 | 1
   1 | 5 | 2
   1 | 5 | 3
 255 | 5 | 4
   1 | 5 | 5

ラスタエディタ

Name

ST_SetGeoReference — 地理参照6パラメタを一度に設定します。数値は空白で区切ります。GDALまたはESRI書式の入力を受け付けます。デフォルトはGDALです。

Synopsis

raster ST_SetGeoReference( | rast, |
| georefcoords, |
| format=GDAL); |

raster rast;
text georefcoords;
text format=GDAL;

raster ST_SetGeoReference( | rast, |
| upperleftx, |
| upperlefty, |
| scalex, |
| scaley, |
| skewx, |
| skewy); |

raster rast;
double precision upperleftx;
double precision upperlefty;
double precision scalex;
double precision scaley;
double precision skewx;
double precision skewy;

説明

地理参照6パラメタを一度に設定します。'GDAL'または'ESRI'書式の入力を受け付けます。デフォルトはGDALです。6パラメタが与えられない場合には、NULLを返します。

書式の表現の違いは次の通りです。

GDAL:

scalex skewy skewx scaley upperleftx upperlefty

ESRI:

scalex skewy skewx scaley upperleftx + scalex*0.5 upperlefty + scaley*0.5

Note

ラスタがデータベース外のバンドを持っている場合には、地理参照の変更によって、バンドの外部保存されているデータに正しくアクセスできなくなることがあります。

Enhanced: 2.1.0 ST_SetGeoReference(raster, double precision, ...)形式を追加しました。

例

WITH foo AS (
    SELECT ST_MakeEmptyRaster(5, 5, 0, 0, 1, -1, 0, 0, 0) AS rast
)
SELECT
    0 AS rid, (ST_Metadata(rast)).*
FROM foo
UNION ALL
SELECT
    1, (ST_Metadata(ST_SetGeoReference(rast, '10 0 0 -10 0.1 0.1', 'GDAL'))).*
FROM foo
UNION ALL
SELECT
    2, (ST_Metadata(ST_SetGeoReference(rast, '10 0 0 -10 5.1 -4.9', 'ESRI'))).*
FROM foo
UNION ALL
SELECT
    3, (ST_Metadata(ST_SetGeoReference(rast, 1, 1, 10, -10, 0.001, 0.001))).*
FROM foo

 rid |     upperleftx     |     upperlefty     | width | height | scalex | scaley | skewx | skewy | srid | numbands
-----+--------------------+--------------------+-------+--------+--------+--------+-------+-------+------+----------
   0 |                  0 |                  0 |     5 |      5 |      1 |     -1 |     0 |     0 |    0 |        0
   1 |                0.1 |                0.1 |     5 |      5 |     10 |    -10 |     0 |     0 |    0 |        0
   2 | 0.0999999999999996 | 0.0999999999999996 |     5 |      5 |     10 |    -10 |     0 |     0 |    0 |        0
   3 |                  1 |                  1 |     5 |      5 |     10 |    -10 | 0.001 | 0.001 |    0 |        0

関連情報

ST_GeoReference, ST_ScaleX, ST_ScaleY, ST_UpperLeftX, ST_UpperLeftY

Name

ST_SetRotation — ラスタの回転をラジアン単位で設定します。

Synopsis

raster ST_SetRotation( | rast, |
| rotation); |

raster rast;
float8 rotation;

説明

ラスタを回転させます。回転はラジアン単位です。詳細についてはWorld File (英語版WikiPedia)をご覧下さい。

例

SELECT
  ST_ScaleX(rast1), ST_ScaleY(rast1), ST_SkewX(rast1), ST_SkewY(rast1),
  ST_ScaleX(rast2), ST_ScaleY(rast2), ST_SkewX(rast2), ST_SkewY(rast2)
FROM (
  SELECT ST_SetRotation(rast, 15) AS rast1, rast as rast2 FROM dummy_rast
) AS foo;
      st_scalex      |      st_scaley      |      st_skewx      |      st_skewy      | st_scalex | st_scaley | st_skewx | st_skewy
---------------------+---------------------+--------------------+--------------------+-----------+-----------+----------+----------
   -1.51937582571764 |   -2.27906373857646 |   1.95086352047135 |   1.30057568031423 |         2 |         3 |        0 |        0
 -0.0379843956429411 | -0.0379843956429411 | 0.0325143920078558 | 0.0325143920078558 |      0.05 |     -0.05 |        0 |        0

関連情報

ST_Rotation, ST_ScaleX, ST_ScaleY, ST_SkewX, ST_SkewY

Name

ST_SetScale — ピクセルサイズのX値とY値を空間参照系の単位で設定します。数値は単位/ピクセルの幅または高さです。

Synopsis

raster ST_SetScale( | rast, |
| xy); |

raster rast;
float8 xy;

raster ST_SetScale( | rast, |
| x, |
| y); |

raster rast;
float8 x;
float8 y;

説明

ピクセルサイズのX値とY値を空間参照系の単位で設定します。数値は単位/ピクセルの幅または高さです。一つだけ渡した場合には、X値とY値は同じ値に設定されます。

Note

ST_SetScaleはラスタの範囲をあわせるためのリサンプリングをしない点でST_Rescaleと異なります。根本的に誤った設定を行ったのを訂正するためにラスタのメタデータ (地理参照)を変更するだけです。ST_Rescaleは、入力ラスタの地理範囲に合わせて計算された幅、高さを持つラスタを返します。ST_SetScaleはラスタの幅も高さも変更しません。

Changed: 2.0.0 WKTRaster版では、ST_SetPixelSizeと呼ばれていました。2.0.0で変更されました。

例

UPDATE dummy_rast
    SET rast = ST_SetScale(rast, 1.5)
WHERE rid = 2;

SELECT ST_ScaleX(rast) As pixx, ST_ScaleY(rast) As pixy, Box3D(rast) As newbox
FROM dummy_rast
WHERE rid = 2;

 pixx | pixy |                    newbox
------+------+----------------------------------------------
  1.5 |  1.5 | BOX(3427927.75 5793244 0, 3427935.25 5793251.5 0)

UPDATE dummy_rast
    SET rast = ST_SetScale(rast, 1.5, 0.55)
WHERE rid = 2;

SELECT ST_ScaleX(rast) As pixx, ST_ScaleY(rast) As pixy, Box3D(rast) As newbox
FROM dummy_rast
WHERE rid = 2;

 pixx | pixy |                   newbox
------+------+--------------------------------------------
  1.5 | 0.55 | BOX(3427927.75 5793244 0,3427935.25 5793247 0)

関連情報

ST_ScaleX, ST_ScaleY, Box3D

Name

ST_SetSkew — 地理参照のスキュー (回転パラメタ)のX値とY値を設定します。一つだけ渡した場合には、X値とY値は同じ値に設定されます。

Synopsis

raster ST_SetSkew( | rast, |
| skewxy); |

raster rast;
float8 skewxy;

raster ST_SetSkew( | rast, |
| skewx, |
| skewy); |

raster rast;
float8 skewx;
float8 skewy;

説明

地理参照のスキュー (回転パラメタ)のX値とY値を設定します。一つだけ渡した場合には、X値とY値は同じ値に設定されます。詳細についてはWorld File (英語版WikiPedia)をご覧下さい。

例

-- 例1
UPDATE dummy_rast SET rast = ST_SetSkew(rast,1,2) WHERE rid = 1;
SELECT rid, ST_SkewX(rast) As skewx, ST_SkewY(rast) As skewy,
    ST_GeoReference(rast) as georef
FROM dummy_rast WHERE rid = 1;

rid | skewx | skewy |    georef
----+-------+-------+--------------
  1 |     1 |     2 | 2.0000000000
                    : 2.0000000000
                    : 1.0000000000
                    : 3.0000000000
                    : 0.5000000000
                    : 0.5000000000

-- 例2 同じ値に設定
UPDATE dummy_rast SET rast = ST_SetSkew(rast,0) WHERE rid = 1;
SELECT rid, ST_SkewX(rast) As skewx, ST_SkewY(rast) As skewy,
    ST_GeoReference(rast) as georef
FROM dummy_rast WHERE rid = 1;

 rid | skewx | skewy |    georef
-----+-------+-------+--------------
   1 |     0 |     0 | 2.0000000000
                     : 0.0000000000
                     : 0.0000000000
                     : 3.0000000000
                     : 0.5000000000
                     : 0.5000000000

関連情報

ST_GeoReference, ST_SetGeoReference, ST_SkewX, ST_SkewY

Name

ST_SetSRID — スタのSRIDをspatial_ref_sysに定義されている特定の整数値に設定します。

Synopsis

raster ST_SetSRID( | rast, |
| srid); |

raster rast;
integer srid;

説明

ラスタのSRIDを特定の整数値に設定します。

Note

ラスタの投影変換は行いません。単にメタデータを空間参照系の定義されている値に設定するだけです。後で投影変換を行う場合に使います。

関連情報

the section called “空間参照系”, ST_SRID

Name

ST_SetUpperLeft — ラスタの左上隅の投影座標系のX値とY値を設定します。

Synopsis

raster ST_SetUpperLeft( | rast, |
| x, |
| y); |

raster rast;
double precision x;
double precision y;

説明

ラスタの左上隅の投影座標系のX値とY値を設定します。

例

SELECT ST_SetUpperLeft(rast,-71.01,42.37)
FROM dummy_rast
WHERE rid = 2;

関連情報

ST_UpperLeftX, ST_UpperLeftY

Name

ST_Resample — 指定したリサンプリングアルゴリズム、新しいピクセル範囲、グリッドの隅、定義するか他のラスタから借りてきた地理参照属性を使ってリサンプリングを行います。

Synopsis

raster ST_Resample( | rast, |
| width, |
| height, |
| gridx=NULL, |
| gridy=NULL, |
| skewx=0, |
| skewy=0, |
| algorithm=NearestNeighbor, |
| maxerr=0.125); |

raster rast;
integer width;
integer height;
double precision gridx=NULL;
double precision gridy=NULL;
double precision skewx=0;
double precision skewy=0;
text algorithm=NearestNeighbor;
double precision maxerr=0.125;

raster ST_Resample( | rast, |
| scalex=0, |
| scaley=0, |
| gridx=NULL, |
| gridy=NULL, |
| skewx=0, |
| skewy=0, |
| algorithm=NearestNeighbor, |
| maxerr=0.125); |

raster rast;
double precision scalex=0;
double precision scaley=0;
double precision gridx=NULL;
double precision gridy=NULL;
double precision skewx=0;
double precision skewy=0;
text algorithm=NearestNeighbor;
double precision maxerr=0.125;

raster ST_Resample( | rast, |
| ref, |
| algorithm=NearestNeighbor, |
| maxerr=0.125, |
| usescale=true); |

raster rast;
raster ref;
text algorithm=NearestNeighbor;
double precision maxerr=0.125;
boolean usescale=true;

raster ST_Resample( | rast, |
| ref, |
| usescale, |
| algorithm=NearestNeighbor, |
| maxerr=0.125); |

raster rast;
raster ref;
boolean usescale;
text algorithm=NearestNeighbor;
double precision maxerr=0.125;

説明

指定したリサンプリングアルゴリズム、新しいピクセル範囲 (width & height)、グリッド隅 (gridx & gridy)、定義するか他のラスタから借りてきた地理参照属性 (scalex, scaley, skewx, skewy)を使ってリサンプリングを行います。参照ラスタを使用する場合には、二つのラスタは同じSRIDでなければなりません。

新しいピクセル値は次のリサンプリングアルゴリズムの一つを使って計算されます:

NearestNeighbor (最近傍補間、英語又は米式綴り方)

Bilinear (双線形補間)

Cubic (3次補完)

CubicSpline (3次スプライン補完)

Lanczos (ランチョス補間)

Max (最大)

Min (最小)

デフォルトはNearestNeighbor (最近傍補間)です。最も実行速度が速いですが、結果の補間が最も悪くなります。

maxerrが指定されていない場合には0.125とします。

Note

詳細については GDAL Warp resampling methodsをご覧下さい。

Availability: 2.0.0 GDAL 1.6.1以上が必要です。

Enhanced: 3.4.0 リサンプリング選択肢に最大と最小を追加

例

SELECT
    ST_Width(orig) AS orig_width,
    ST_Width(reduce_100) AS new_width
FROM (
    SELECT
        rast AS orig,
        ST_Resample(rast,100,100) AS reduce_100
    FROM aerials.boston
    WHERE ST_Intersects(rast,
        ST_Transform(
            ST_MakeEnvelope(-71.128, 42.2392,-71.1277, 42.2397, 4326),26986)
    )
    LIMIT 1
) AS foo;

 orig_width | new_width
------------+-------------
        200 |         100

関連情報

ST_Rescale, ST_Resize, ST_Transform

Name

ST_Rescale — スケール (ピクセルサイズ)だけを調整するリサンプリングを行います。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (英語または米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最近傍補間です。

Synopsis

raster ST_Rescale( | rast, |
| scalexy, |
| algorithm=NearestNeighbor, |
| maxerr=0.125); |

raster rast;
double precision scalexy;
text algorithm=NearestNeighbor;
double precision maxerr=0.125;

raster ST_Rescale( | rast, |
| scalex, |
| scaley, |
| algorithm=NearestNeighbor, |
| maxerr=0.125); |

raster rast;
double precision scalex;
double precision scaley;
text algorithm=NearestNeighbor;
double precision maxerr=0.125;

説明

スケール (またはピクセルサイズ)だけを調整するリサンプリングを行います。新しいピクセル値は次のリサンプリングアルゴリズム使って計算されます:

NearestNeighbor (最近傍補間、英語又は米式綴り方)

Bilinear (双線形補間)

Cubic (3次補完)

CubicSpline (3次スプライン補完)

Lanczos (ランチョス補間)

Max (最大)

Min (最小)

デフォルトはNearestNeighbor (最近傍補間)です。最も実行速度が速いですが、結果の補間が最も悪くなります。

scalexとscaleyで、新しいピクセルサイズを定義します。ラスタを正しい方向にするには、scaleyは負数でなければならないことがしばしばあります。

新しいscalexまたはscaleyがラスタのwidthまたはheightの除数でない時、結果ラスタの範囲は元のラスタの範囲を含むために拡大されます。ST_Resizeをご覧ください。

maxerrは、リサンプリングアルゴリズムで変換を行う際に近似を行うかどうかを決めるしきい値です (ピクセル単位)。maxerrを設定しない場合には、デフォルトの0.125が使用され、この値はGDALのgdalwarpユーティリティで使われる値と同じです。0に設定した場合には、近似は行われません。

Note

詳細については GDAL Warp resampling methodsをご覧下さい。

Note

ST_Recalcは、ST_SetScaleはラスタ範囲に合わせるためのリサンプリングをしない点で、ST_SetScaleと異なります。ST_SetScaleは根本的に誤った設定を行ったのを訂正するためにラスタのメタデータ (地理参照)を変更するだけです。ST_Rescaleは、入力ラスタの地理範囲に合わせて計算された幅、高さを持つラスタを返します。ST_SetScaleはラスタの幅も高さも変更しません。

Availability: 2.0.0 GDAL 1.6.1以上が必要です。

Enhanced: 3.4.0 リサンプリング選択肢に最大と最小を追加

Changed: 2.1.0 SRIDなしのラスタで動作するようになりました。

例

ラスタのピクセルサイズを0.001度から0.0015度にスケール再設定を行う例です。

-- 元のラスタのピクセルサイズ
SELECT ST_PixelWidth(ST_AddBand(ST_MakeEmptyRaster(100, 100, 0, 0, 0.001, -0.001, 0, 0, 4269), '8BUI'::text, 1, 0)) width

   width
----------
0.001

-- スケール再設定したラスタのピクセルサイズ
SELECT ST_PixelWidth(ST_Rescale(ST_AddBand(ST_MakeEmptyRaster(100, 100, 0, 0, 0.001, -0.001, 0, 0, 4269), '8BUI'::text, 1, 0), 0.0015)) width

   width
----------
0.0015

関連情報

ST_Resize, ST_Resample, ST_SetScale, ST_ScaleX, ST_ScaleY, ST_Transform

Name

ST_Reskew — キュー (回転パラメタ)だけを調整するリサンプリングを行います。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最近傍補間です。

Synopsis

raster ST_Reskew( | rast, |
| skewxy, |
| algorithm=NearestNeighbor, |
| maxerr=0.125); |

raster rast;
double precision skewxy;
text algorithm=NearestNeighbor;
double precision maxerr=0.125;

raster ST_Reskew( | rast, |
| skewx, |
| skewy, |
| algorithm=NearestNeighbor, |
| maxerr=0.125); |

raster rast;
double precision skewx;
double precision skewy;
text algorithm=NearestNeighbor;
double precision maxerr=0.125;

説明

スキュー (回転パラメタ)だけを調整するリサンプリングを行います。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最も早いですが最も悪い内挿を行う最近傍補間です。

skewxとskewyによって新しいスキューが定義されます。

新しいラスタの範囲は元のラスタの範囲を含みます。

maxerrが指定されていない場合には0.125とします。

Note

詳細については GDAL Warp resampling methodsをご覧下さい。

Note

ST_Reskewは、ST_SetSkewがラスタの範囲をあわせるためのリサンプリングをしない点でST_SetSkewと異なります。根本的に誤った設定を行ったのを訂正するためにラスタのメタデータ (地理参照)を変更するだけです。ST_Reskewは、入力ラスタの地理範囲に合わせて計算された幅、高さを持つラスタを返します。ST_SetSkewはラスタの幅も高さも変更しません。

Availability: 2.0.0 GDAL 1.6.1以上が必要です。

Changed: 2.1.0 SRIDなしのラスタで動作するようになりました。

例

スキューを0.0から0.0015に再設定する簡単な例です。

-- 回転前の元のラスタ
SELECT ST_Rotation(ST_AddBand(ST_MakeEmptyRaster(100, 100, 0, 0, 0.001, -0.001, 0, 0, 4269), '8BUI'::text, 1, 0));

-- 結果
0

-- ST_Reskewを施したラスタの回転
SELECT ST_Rotation(ST_Reskew(ST_AddBand(ST_MakeEmptyRaster(100, 100, 0, 0, 0.001, -0.001, 0, 0, 4269), '8BUI'::text, 1, 0), 0.0015));

-- 結果
-0.982793723247329

関連情報

ST_Resample, ST_Rescale, ST_SetSkew, ST_SetRotation, ST_SkewX, ST_SkewY, ST_Transform

Name

ST_SnapToGrid — グリッドにスナップすることでラスタをリサンプリングします。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間('Lanczos')を用います。デフォルトは最近傍補間です。

Synopsis

raster ST_SnapToGrid( | rast, |
| gridx, |
| gridy, |
| algorithm=NearestNeighbor, |
| maxerr=0.125, |
| scalex=DEFAULT 0, |
| scaley=DEFAULT 0); |

raster rast;
double precision gridx;
double precision gridy;
text algorithm=NearestNeighbor;
double precision maxerr=0.125;
double precision scalex=DEFAULT 0;
double precision scaley=DEFAULT 0;

raster ST_SnapToGrid( | rast, |
| gridx, |
| gridy, |
| scalex, |
| scaley, |
| algorithm=NearestNeighbor, |
| maxerr=0.125); |

raster rast;
double precision gridx;
double precision gridy;
double precision scalex;
double precision scaley;
text algorithm=NearestNeighbor;
double precision maxerr=0.125;

raster ST_SnapToGrid( | rast, |
| gridx, |
| gridy, |
| scalexy, |
| algorithm=NearestNeighbor, |
| maxerr=0.125); |

raster rast;
double precision gridx;
double precision gridy;
double precision scalexy;
text algorithm=NearestNeighbor;
double precision maxerr=0.125;

説明

任意のピクセル隅 (gridx & gridy)と、任意引数としてピクセルサイズ (scalex & scaley)によって定義されるグリッドにスナップすることでラスタをリサンプリングします。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最も早いですが最も悪い内挿を行う最近傍補間です。

gridxとgridyは、新しいグリッドの任意のピクセル隅を定義します。これは新しいラスタの左上隅に必ずなるものではありません。新しいラスタ範囲の内部または境界である必要はありません。

任意引数として、新しいグリッドのピクセルサイズをscalexとscaleyで指定することができます。

新しいラスタの範囲は元のラスタの範囲を含みます。

maxerrが指定されていない場合には0.125とします。

Note

詳細については GDAL Warp resampling methodsをご覧下さい。

Note

グリッドパラメタより多くの制御が必要な場合には、ST_Resampleを使います。

Availability: 2.0.0 GDAL 1.6.1以上が必要です。

Changed: 2.1.0 SRIDなしのラスタで動作するようになりました。

例

ラスタをわずかに異なるグリッドにスナップさせる簡単な例です。

-- 元のラスタの左上隅のX値
SELECT ST_UpperLeftX(ST_AddBand(ST_MakeEmptyRaster(10, 10, 0, 0, 0.001, -0.001, 0, 0, 4269), '8BUI'::text, 1, 0));
-- 結果
0

-- スナップしたラスタの左上隅のX値
SELECT ST_UpperLeftX(ST_SnapToGrid(ST_AddBand(ST_MakeEmptyRaster(10, 10, 0, 0, 0.001, -0.001, 0, 0, 4269), '8BUI'::text, 1, 0), 0.0002, 0.0002));

-- 結果
-0.0008

関連情報

ST_Resample, ST_Rescale, ST_UpperLeftX, ST_UpperLeftY

Name

ST_Resize — ラスタを新しい幅、高さにサイズ再設定を行います。

Synopsis

raster ST_Resize( | rast, |
| width, |
| height, |
| algorithm=NearestNeighbor, |
| maxerr=0.125); |

raster rast;
integer width;
integer height;
text algorithm=NearestNeighbor;
double precision maxerr=0.125;

raster ST_Resize( | rast, |
| percentwidth, |
| percentheight, |
| algorithm=NearestNeighbor, |
| maxerr=0.125); |

raster rast;
double precision percentwidth;
double precision percentheight;
text algorithm=NearestNeighbor;
double precision maxerr=0.125;

raster ST_Resize( | rast, |
| width, |
| height, |
| algorithm=NearestNeighbor, |
| maxerr=0.125); |

raster rast;
text width;
text height;
text algorithm=NearestNeighbor;
double precision maxerr=0.125;

説明

ラスタを新しい幅、高さにサイズ再設定を行います。新しい幅、高さはピクセル数で確実に指定するか、ラスタの幅、高さの比率で指定します。新しいラスタの範囲は元のラスタの範囲と同じです。

新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最も早いですが最も悪い内挿を行う最近傍補間です。

一つ目の形式では、出力ラスタの実際の幅、高さを予定しています。

二つ目の形式では、0から1の間の値で、入力ラスタの幅、高さに対する比率を指定しています。

三つ目の形式では、出力ラスタの実際の幅、高さを取るか、文字列による入力ラスタの幅、高さに対する百分率 ("20%")を取ります。

Availability: 2.1.0 GDAL 1.6.1以上が必要です。

例

WITH foo AS(
SELECT
    1 AS rid,
    ST_Resize(
        ST_AddBand(
            ST_MakeEmptyRaster(1000, 1000, 0, 0, 1, -1, 0, 0, 0)
            , 1, '8BUI', 255, 0
        )
    , '50%', '500') AS rast
UNION ALL
SELECT
    2 AS rid,
    ST_Resize(
        ST_AddBand(
            ST_MakeEmptyRaster(1000, 1000, 0, 0, 1, -1, 0, 0, 0)
            , 1, '8BUI', 255, 0
        )
    , 500, 100) AS rast
UNION ALL
SELECT
    3 AS rid,
    ST_Resize(
        ST_AddBand(
            ST_MakeEmptyRaster(1000, 1000, 0, 0, 1, -1, 0, 0, 0)
            , 1, '8BUI', 255, 0
        )
    , 0.25, 0.9) AS rast
), bar AS (
    SELECT rid, ST_Metadata(rast) AS meta, rast FROM foo
)
SELECT rid, (meta).* FROM bar

 rid | upperleftx | upperlefty | width | height | scalex | scaley | skewx | skewy | srid | numbands
-----+------------+------------+-------+--------+--------+--------+-------+-------+------+----------
   1 |          0 |          0 |   500 |    500 |      1 |     -1 |     0 |     0 |    0 |        1
   2 |          0 |          0 |   500 |    100 |      1 |     -1 |     0 |     0 |    0 |        1
   3 |          0 |          0 |   250 |    900 |      1 |     -1 |     0 |     0 |    0 |        1
(3 rows)

関連情報

ST_Resample, ST_Rescale, ST_Reskew, ST_SnapToGrid

Name

ST_Transform — ラスタを既知の空間参照系から他の既知の空間参照系に、指定したリサンプリングアルゴリズムで投影変換します。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最近傍補間です。

Synopsis

raster ST_Transform( | rast, |
| srid, |
| algorithm=NearestNeighbor, |
| maxerr=0.125, |
| scalex, |
| scaley); |

raster rast;
integer srid;
text algorithm=NearestNeighbor;
double precision maxerr=0.125;
double precision scalex;
double precision scaley;

raster ST_Transform( | rast, |
| srid, |
| scalex, |
| scaley, |
| algorithm=NearestNeighbor, |
| maxerr=0.125); |

raster rast;
integer srid;
double precision scalex;
double precision scaley;
text algorithm=NearestNeighbor;
double precision maxerr=0.125;

raster ST_Transform( | rast, |
| alignto, |
| algorithm=NearestNeighbor, |
| maxerr=0.125); |

raster rast;
raster alignto;
text algorithm=NearestNeighbor;
double precision maxerr=0.125;

説明

ラスタを既知の空間参照系から他の既知の空間参照系に、指定したリサンプリングアルゴリズムで投影変換します。algorithmが指定されていない場合には'NearestNeighbor'とし、maxerrorが指定されていない場合には0.125とします。

アルゴリズム指定オプションは'NearestNeighbor', 'Bilinear', 'Cubic', 'CubicSpline', 'Lanczos'です。詳細についてはGDAL Warp resampling methodsをご覧ください。

ST_TransformはしばしばST_SetSRIDと混同されます。ST_Transformは、ある空間参照系から別の空間参照系に変更する際に、実際にラスタの座標を変更します (かつピクセル値のリサンプリングを行います)が、ST_SetSRIDは単にラスタの空間参照系識別子を変更するだけです。

三つ目の形式は、他の形式と違い、aligntoとして参照ラスタが求められます。投影変換したラスタは参照ラスタの空間参照系 (SRID)に投影変換して、参照ラスタと同じアラインメントを持つようにします (ST_SameAlignmentがTRUEになるようにします)。

Note

変換機能が思ったように働かない場合には、環境変数PROJSOをPostGISが使用する投影変換ライブラリの.soまたは.dllに指定する必要があるかも知れません。ファイル名の指定だけ必要です。Windowsでの例として、コントロールパネル->システム->システムの詳細設定->環境変数で、PROJSOという名前のシステム変数を追加して、libproj.dll (Proj 4.6.1を使用している場合)を設定します。変更後はPostgreSQLサービス/デーモンを再起動します。

Warning

タイルのカバレッジを変換する時には、ほとんどの場合で、「例: 三つ目の形式」で示す通り、同じアラインメントになり、かつタイル内に隙間がなくなるようにするために、参照ラスタを使用したくなります。

Availability: 2.0.0 GDAL 1.6.1以上が必要です。

Enhanced: 2.1.0 ST_Tranfrorm(rast, alignto)の形式を追加しました。

例

SELECT ST_Width(mass_stm) As w_before, ST_Width(wgs_84) As w_after,
  ST_Height(mass_stm) As h_before, ST_Height(wgs_84) As h_after
    FROM
    ( SELECT rast As mass_stm, ST_Transform(rast,4326) As wgs_84
  ,  ST_Transform(rast,4326, 'Bilinear') AS wgs_84_bilin
        FROM aerials.o_2_boston
            WHERE ST_Intersects(rast,
                ST_Transform(ST_MakeEnvelope(-71.128, 42.2392,-71.1277, 42.2397, 4326),26986) )
        LIMIT 1) As foo;

 w_before | w_after | h_before | h_after
----------+---------+----------+---------
      200 |     228 |      200 |     170

元のラスタはメートル単位のマサチューセッツ州平面 (mass_stm)

WGS84経度緯度に変換した後 (wgs_84)

最近傍補間の代わりに双線形補間を使ってWGS84経度緯度に変換した後 (wgs_84_bilin)

例: 三つ目の形式

次に示す例は、ST_Transform(raster, srid)とST_Transform(raster, alignto)との違いを示しています。

WITH foo AS (
    SELECT 0 AS rid, ST_AddBand(ST_MakeEmptyRaster(2, 2, -500000, 600000, 100, -100, 0, 0, 2163), 1, '16BUI', 1, 0) AS rast UNION ALL
    SELECT 1, ST_AddBand(ST_MakeEmptyRaster(2, 2, -499800, 600000, 100, -100, 0, 0, 2163), 1, '16BUI', 2, 0) AS rast UNION ALL
    SELECT 2, ST_AddBand(ST_MakeEmptyRaster(2, 2, -499600, 600000, 100, -100, 0, 0, 2163), 1, '16BUI', 3, 0) AS rast UNION ALL

    SELECT 3, ST_AddBand(ST_MakeEmptyRaster(2, 2, -500000, 599800, 100, -100, 0, 0, 2163), 1, '16BUI', 10, 0) AS rast UNION ALL
    SELECT 4, ST_AddBand(ST_MakeEmptyRaster(2, 2, -499800, 599800, 100, -100, 0, 0, 2163), 1, '16BUI', 20, 0) AS rast UNION ALL
    SELECT 5, ST_AddBand(ST_MakeEmptyRaster(2, 2, -499600, 599800, 100, -100, 0, 0, 2163), 1, '16BUI', 30, 0) AS rast UNION ALL

    SELECT 6, ST_AddBand(ST_MakeEmptyRaster(2, 2, -500000, 599600, 100, -100, 0, 0, 2163), 1, '16BUI', 100, 0) AS rast UNION ALL
    SELECT 7, ST_AddBand(ST_MakeEmptyRaster(2, 2, -499800, 599600, 100, -100, 0, 0, 2163), 1, '16BUI', 200, 0) AS rast UNION ALL
    SELECT 8, ST_AddBand(ST_MakeEmptyRaster(2, 2, -499600, 599600, 100, -100, 0, 0, 2163), 1, '16BUI', 300, 0) AS rast
), bar AS (
    SELECT
        ST_Transform(rast, 4269) AS alignto
    FROM foo
    LIMIT 1
), baz AS (
    SELECT
        rid,
        rast,
        ST_Transform(rast, 4269) AS not_aligned,
        ST_Transform(rast, alignto) AS aligned
    FROM foo
    CROSS JOIN bar
)
SELECT
    ST_SameAlignment(rast) AS rast,
    ST_SameAlignment(not_aligned) AS not_aligned,
    ST_SameAlignment(aligned) AS aligned
FROM baz

 rast | not_aligned | aligned
------+-------------+---------
 t    | f           | t

アラインメントなし

アラインメントあり

関連情報

ST_Transform, ST_SetSRID

ラスタバンドエディタ

Name

ST_SetBandNoDataValue — 指定したバンドにNODATAを表現する値を設定します。バンドを指定しない場合には、1番と仮定します。NODATA値を持たないようにするには、nodatavalueにNULLを指定します。

Synopsis

raster ST_SetBandNoDataValue( | rast, |
| nodatavalue); |

raster rast;
double precision nodatavalue;

raster ST_SetBandNoDataValue( | rast, |
| band, |
| nodatavalue, |
| forcechecking=false); |

raster rast;
integer band;
double precision nodatavalue;
boolean forcechecking=false;

説明

指定したバンドにNODATAを表現する値を設定します。バンドを指定しない場合には、1番と仮定します。この関数はST_Polygon, ST_DumpAsPolygons, ST_PixelAs系関数群からの結果に影響を与えます。

例

-- 1番バンドのNODATA値を変更します
UPDATE dummy_rast
    SET rast = ST_SetBandNoDataValue(rast,1, 254)
WHERE rid = 2;

-- 1番、2番、3番のNODATA値を変更します
UPDATE dummy_rast
    SET rast =
        ST_SetBandNoDataValue(
            ST_SetBandNoDataValue(
                ST_SetBandNoDataValue(
                    rast,1, 254)
                ,2,99),
                3,108)
        WHERE rid = 2;

-- NODATA値の設定を解除して、処理関数が全てのピクセルを考慮するようにします
UPDATE dummy_rast
    SET rast = ST_SetBandNoDataValue(rast,1, NULL)
WHERE rid = 2;

関連情報

ST_BandNoDataValue, ST_NumBands

Name

ST_SetBandIsNoData — バンドのisnodataフラグをTRUEにします。

Synopsis

raster ST_SetBandIsNoData( | rast, |
| band=1); |

raster rast;
integer band=1;

説明

バンドのisnodataフラグをTRUEにします。バンドを指定しない場合には、1番と仮定します。isnodataフラグが汚れている場合にのみ呼ぶべきものです。ST_BandIsNoDataの、最後の引数にTRUEを設定した場合の結果と指定しない場合の結果とで異なっている時です。

Availability: 2.0.0

例

-- ラスタカラムを一つ持つダミーテーブルを生成します
create table dummy_rast (rid integer, rast raster);

-- 1ピクセルしか持たない2個のバンドで
-- nodatavalue = pixel value = 3 のバンドと nodatavalue = 13, pixel value = 4 のバンドを追加
insert into dummy_rast values(1,
(
'01' -- little endian - リトルエンディアン (uint8 ndr)
||
'0000' -- version - 版 (uint16 0)
||
'0200' -- nBands - バンド数 (uint16 0)
||
'17263529ED684A3F' -- scaleX - X方向セルサイズ (float64 0.000805965234044584)
||
'F9253529ED684ABF' -- scaleY - Y方向セルサイズ (float64 -0.00080596523404458)
||
'1C9F33CE69E352C0' -- ipX - 左上隅X値 (float64 -75.5533328537098)
||
'718F0E9A27A44840' -- ipY - 左上隅Y値 (float64 49.2824585505576)
||
'ED50EB853EC32B3F' -- skewX - スキューX (float64 0.000211812383858707)
||
'7550EB853EC32B3F' -- skewY - スキューY (float64 0.000211812383858704)
||
'E6100000' -- SRID (int32 4326)
||
'0100' -- width - 横セル数 (uint16 1)
||
'0100' -- height - 縦セル数 (uint16 1)
||
'4' -- hasnodatavalueをTRUEにし、isnodata値を (TRUEにするべきところ)FALSEにする
||
'2' -- 1番バンドのタイプ (4BUI)
||
'03' -- NODATA値==3
||
'03' -- 0列0行ピクセルの値==3 (NODATA値と同じ)
||
'0' -- hasnodatavalueをFALSEにする。
||
'5' -- 2番バンドのタイプ (16BSI)
||
'0D00' -- NODATA値==13
||
'0400' -- 0列0行ピクセルの値==4
)::raster
);

select st_bandisnodata(rast, 1) from dummy_rast where rid = 1; -- FALSEを期待
select st_bandisnodata(rast, 1, TRUE) from dummy_rast where rid = 1; -- TRUEを期待

-- isnodataフラグが汚れているのでTRUEに設定します
update dummy_rast set rast = st_setbandisnodata(rast, 1) where rid = 1;

select st_bandisnodata(rast, 1) from dummy_rast where rid = 1; -- TRUEを期待

関連情報

ST_BandNoDataValue, ST_NumBands, ST_SetBandNoDataValue, ST_BandIsNoData

Name

ST_SetBandPath — データベース外バンドの外部パスとバンド番号を更新します。

Synopsis

raster ST_SetBandPath( | rast, |
| band, |
| outdbpath, |
| outdbindex, |
| force=false); |

raster rast;
integer band;
text outdbpath;
integer outdbindex;
boolean force=false;

説明

データベース外バンドの外部パスと外部バンド番号を更新します。

Note

forceがTRUEの場合には、外部ラスタファイルとPostGISラスタとの互換性 (例：アラインメント、ピクセル対応)確認のためのテストを行いません。このモードは、外部ラスタファイルが存在するファイルシステムの変更を目的としています。

Note

内部的には、このメソッドは、存在するパス情報を更新する替わりに、PostGISラスタのbandで指定したバンドを新しいバンドに置き換えます。

Availability: 2.5.0

例

WITH foo AS (
    SELECT
        ST_AddBand(NULL::raster, '/home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif', NULL::int[]) AS rast
)
SELECT
    1 AS query,
    *
FROM ST_BandMetadata(
    (SELECT rast FROM foo),
    ARRAY[1,3,2]::int[]
)
UNION ALL
SELECT
    2,
    *
FROM ST_BandMetadata(
    (
        SELECT
            ST_SetBandPath(
                rast,
                2,
                '/home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected2.tif',
                1
            ) AS rast
        FROM foo
    ),
    ARRAY[1,3,2]::int[]
)
ORDER BY 1, 2;

 query | bandnum | pixeltype | nodatavalue | isoutdb |                                      path                                       | outdbbandnum
-------+---------+-----------+-------------+---------+---------------------------------------------------------------------------------+--------------
     1 |       1 | 8BUI      |             | t       | /home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif       |            1
     1 |       2 | 8BUI      |             | t       | /home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif       |            2
     1 |       3 | 8BUI      |             | t       | /home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif       |            3
     2 |       1 | 8BUI      |             | t       | /home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif       |            1
     2 |       2 | 8BUI      |             | t       | /home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected2.tif      |            1
     2 |       3 | 8BUI      |             | t       | /home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif       |            3

関連情報

ST_BandMetaData, ST_SetBandIndex

Name

ST_SetBandIndex — データベース外バンドの外部バンド番号の更新

Synopsis

raster ST_SetBandIndex( | rast, |
| band, |
| outdbindex, |
| force=false); |

raster rast;
integer band;
integer outdbindex;
boolean force=false;

説明

データベース外バンドの外部バンド番号を更新します。データベース外バンドと関連する外部ラスタファイルには触れません。

Note

forceがTRUEの場合には、外部ラスタファイルとPostGISラスタとの互換性 (例：アラインメント、ピクセル対応)確認のためのテストを行いません。このモードは、バンドが外部ラスタファイル内で移動する場所を対象としています。

Note

内部的には、このメソッドは、存在するパス情報を更新する替わりに、PostGISラスタのbandで指定したバンドを新しいバンドに置き換えます。

Availability: 2.5.0

例

WITH foo AS (
    SELECT
        ST_AddBand(NULL::raster, '/home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif', NULL::int[]) AS rast
)
SELECT
    1 AS query,
    *
FROM ST_BandMetadata(
    (SELECT rast FROM foo),
    ARRAY[1,3,2]::int[]
)
UNION ALL
SELECT
    2,
    *
FROM ST_BandMetadata(
    (
        SELECT
            ST_SetBandIndex(
                rast,
                2,
                1
            ) AS rast
        FROM foo
    ),
    ARRAY[1,3,2]::int[]
)
ORDER BY 1, 2;

 query | bandnum | pixeltype | nodatavalue | isoutdb |                                      path                                       | outdbbandnum
-------+---------+-----------+-------------+---------+---------------------------------------------------------------------------------+--------------
     1 |       1 | 8BUI      |             | t       | /home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif       |            1
     1 |       2 | 8BUI      |             | t       | /home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif       |            2
     1 |       3 | 8BUI      |             | t       | /home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif       |            3
     2 |       1 | 8BUI      |             | t       | /home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif       |            1
     2 |       2 | 8BUI      |             | t       | /home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif       |            1
     2 |       3 | 8BUI      |             | t       | /home/pele/devel/geo/postgis-git/raster/test/regress/loader/Projected.tif       |            3

関連情報

ST_BandMetaData, ST_SetBandPath

ラスタバンド統計情報と解析

Name

ST_Count — ラスタまたはラスタカバレッジの指定したバンドのピクセル数を返します。バンドを指定しない場合には、1番と仮定します。exclude_nodata_valueをTRUEに設定している場合には、NODATA値と等しくないピクセルのみを数えます。

Synopsis

bigint ST_Count( | rast, |
| nband=1, |
| exclude_nodata_value=true); |

raster rast;
integer nband=1;
boolean exclude_nodata_value=true;

bigint ST_Count( | rast, |
| exclude_nodata_value); |

raster rast;
boolean exclude_nodata_value;

説明

ラスタまたはラスタカバレッジの指定したバンドのピクセル数を返します。nbandでバンドを指定しない場合には、1番と仮定します。

Note

exclude_nodata_valueをTRUEに設定している場合には、nodata値と等しくないピクセルのみ数えます。exclude_nodata_valueをFALSEに設定している場合には、全てのピクセルを数えます。

Changed: 3.1.0 - ST_Count(rastertable, rastercolumn, ...) の形式は削除されました。代わりにST_CountAggを使用します。

Availability: 2.0.0

例

-- 249でないピクセルの数え上げと、全てのピクセルの数え上げを行います --
SELECT rid, ST_Count(ST_SetBandNoDataValue(rast,249)) As exclude_nodata,
        ST_Count(ST_SetBandNoDataValue(rast,249),false) As include_nodata
    FROM dummy_rast WHERE rid=2;

rid | exclude_nodata | include_nodata
-----+----------------+----------------
   2 |             23 |             25

関連情報

ST_CountAgg, ST_SummaryStats, ST_SetBandNoDataValue

Name

ST_CountAgg — 集約関数です。ラスタ集合の与えられたバンドのピクセル数を返します。バンドが指定されていない場合には、1番と仮定します。exclude_nodata_valueをTRUEに設定している場合には、NODATA値と等しくないピクセルのみを数えます。

Synopsis

bigint ST_CountAgg( | rast, |
| nband, |
| exclude_nodata_value, |
| sample_percent); |

raster rast;
integer nband;
boolean exclude_nodata_value;
double precision sample_percent;

bigint ST_CountAgg( | rast, |
| nband, |
| exclude_nodata_value); |

raster rast;
integer nband;
boolean exclude_nodata_value;

bigint ST_CountAgg( | rast, |
| exclude_nodata_value); |

raster rast;
boolean exclude_nodata_value;

説明

ラスタ集合の与えられたバンドのピクセル数を返します。nbandでバンドを指定しない場合には、1番と仮定します。

exclude_nodata_valueをTRUEに設定している場合には、NODATA値と等しくないピクセルのみを数えます。exclude_nodata_valueをFALSEに設定している場合には、全てのピクセルを数えます。

デフォルトでは、全てのピクセルを見ます。より早い応答を得るには、sample_percent値を0から1の間で設定します。

Availability: 2.2.0

例

WITH foo AS (
    SELECT
        rast.rast
    FROM (
        SELECT ST_SetValue(
            ST_SetValue(
                ST_SetValue(
                    ST_AddBand(
                        ST_MakeEmptyRaster(10, 10, 10, 10, 2, 2, 0, 0,0)
                        , 1, '64BF', 0, 0
                    )
                    , 1, 1, 1, -10
                )
                , 1, 5, 4, 0
            )
            , 1, 5, 5, 3.14159
        ) AS rast
    ) AS rast
    FULL JOIN (
        SELECT generate_series(1, 10) AS id
    ) AS id
        ON 1 = 1
)
SELECT
    ST_CountAgg(rast, 1, TRUE)
FROM foo;

 st_countagg
-------------
          20
(1 row)

関連情報

ST_Count, ST_SummaryStats, ST_SetBandNoDataValue

Name

ST_Histogram — ラスタまたはラスタカバレッジのビン範囲で分割したデータ分布をまとめるヒストグラムの集合を返します。ビン数を指定しない場合には自動計算されます。

Synopsis

SETOF record ST_Histogram( | rast, |
| nband=1, |
| exclude_nodata_value=true, |
| bins=autocomputed, |
| width=NULL, |
| right=false); |

raster rast;
integer nband=1;
boolean exclude_nodata_value=true;
integer bins=autocomputed;
double precision[] width=NULL;
boolean right=false;

SETOF record ST_Histogram( | rast, |
| nband, |
| bins, |
| width=NULL, |
| right=false); |

raster rast;
integer nband;
integer bins;
double precision[] width=NULL;
boolean right=false;

SETOF record ST_Histogram( | rast, |
| nband, |
| exclude_nodata_value, |
| bins, |
| right); |

raster rast;
integer nband;
boolean exclude_nodata_value;
integer bins;
boolean right;

SETOF record ST_Histogram( | rast, |
| nband, |
| bins, |
| right); |

raster rast;
integer nband;
integer bins;
boolean right;

説明

最小値、最大値、合計数、全体から見た割合からなるレコードの集合を返します。nbandでバンドを指定しない場合には、1番と仮定します。

Note

デフォルトでは、nodataと同じピクセル値は考慮に入れません。exclude_nodata_valueをFALSEに設定すると全てのピクセルを数えます。

width double precision[]

カテゴリ/ビン毎の幅を示す配列です。ビン数の指定がwidth要素数を超える場合には、widthを繰り返します。

例: ビン9個、widthが[a, b, c]では、[a, b, c, a, b, c, a, b, c]が出力されます。

bins integer

取り出し数 -- 関数から戻そうとするレコード数です。指定しない場合には、自動計算されます。

right boolean

ヒストグラムを右から計算します (デフォルトは左からです)。値の評価の優先順位が、X軸について[a, b)から(a, b]に変わります。

Changed: 3.1.0 ST_Histogram(table_name, column_name) の形式は削除されました。

Availability: 2.0.0

例: 単一ラスタタイル - ビン数を自動計算とした、1番、2番、3番バンドのヒストグラムの計算

SELECT band, (stats).*
FROM (SELECT rid, band, ST_Histogram(rast, band) As stats
    FROM dummy_rast CROSS JOIN generate_series(1,3) As band
     WHERE rid=2) As foo;

 band |  min  |  max  | count | percent
------+-------+-------+-------+---------
    1 |   249 |   250 |     2 |    0.08
    1 |   250 |   251 |     2 |    0.08
    1 |   251 |   252 |     1 |    0.04
    1 |   252 |   253 |     2 |    0.08
    1 |   253 |   254 |    18 |    0.72
    2 |    78 | 113.2 |    11 |    0.44
    2 | 113.2 | 148.4 |     4 |    0.16
    2 | 148.4 | 183.6 |     4 |    0.16
    2 | 183.6 | 218.8 |     1 |    0.04
    2 | 218.8 |   254 |     5 |     0.2
    3 |    62 | 100.4 |    11 |    0.44
    3 | 100.4 | 138.8 |     5 |     0.2
    3 | 138.8 | 177.2 |     4 |    0.16
    3 | 177.2 | 215.6 |     1 |    0.04
    3 | 215.6 |   254 |     4 |    0.16

例: ビン数を6で固定して2番バンドだけを計算

SELECT (stats).*
FROM (SELECT rid, ST_Histogram(rast, 2,6) As stats
    FROM dummy_rast
     WHERE rid=2) As foo;

    min     |    max     | count | percent
------------+------------+-------+---------
         78 | 107.333333 |     9 |    0.36
 107.333333 | 136.666667 |     6 |    0.24
 136.666667 |        166 |     0 |       0
        166 | 195.333333 |     4 |    0.16
 195.333333 | 224.666667 |     1 |    0.04
 224.666667 |        254 |     5 |     0.2
(6 rows)

-- 前と同じですが、ビン毎のピクセル値の範囲を明示的に制御しています
SELECT (stats).*
FROM (SELECT rid, ST_Histogram(rast, 2,6,ARRAY[0.5,1,4,100,5]) As stats
    FROM dummy_rast
     WHERE rid=2) As foo;

  min  |  max  | count | percent
-------+-------+-------+----------
    78 |  78.5 |     1 |     0.08
  78.5 |  79.5 |     1 |     0.04
  79.5 |  83.5 |     0 |        0
  83.5 | 183.5 |    17 |   0.0068
 183.5 | 188.5 |     0 |        0
 188.5 |   254 |     6 | 0.003664
(6 rows)

関連情報

ST_Count, ST_SummaryStats, ST_SummaryStatsAgg

Name

ST_Quantile — ラスタまたはラスタテーブルカバレッジのサンプルまたは母集団の分位数を計算します。値がラスタの25%,50%,75%にあるかを調べることができます。

Synopsis

SETOF record ST_Quantile( | rast, |
| nband=1, |
| exclude_nodata_value=true, |
| quantiles=NULL); |

raster rast;
integer nband=1;
boolean exclude_nodata_value=true;
double precision[] quantiles=NULL;

SETOF record ST_Quantile( | rast, |
| quantiles); |

raster rast;
double precision[] quantiles;

SETOF record ST_Quantile( | rast, |
| nband, |
| quantiles); |

raster rast;
integer nband;
double precision[] quantiles;

double precision ST_Quantile( | rast, |
| quantile); |

raster rast;
double precision quantile;

double precision ST_Quantile( | rast, |
| exclude_nodata_value, |
| quantile=NULL); |

raster rast;
boolean exclude_nodata_value;
double precision quantile=NULL;

double precision ST_Quantile( | rast, |
| nband, |
| quantile); |

raster rast;
integer nband;
double precision quantile;

double precision ST_Quantile( | rast, |
| nband, |
| exclude_nodata_value, |
| quantile); |

raster rast;
integer nband;
boolean exclude_nodata_value;
double precision quantile;

double precision ST_Quantile( | rast, |
| nband, |
| quantile); |

raster rast;
integer nband;
double precision quantile;

説明

ラスタまたはラスタテーブルカバレッジのサンプルまたは母集団の分位数を計算します。値がラスタの25%,50%,75%にあるかを調べることができます。

Note

exclude_nodata_valueをFALSEに設定している場合には、NODATA値となるピクセルも数えます。

Changed: 3.1.0 ST_Quantile(table_name, column_name) の形式は削除されました。

Availability: 2.0.0

例

UPDATE dummy_rast SET rast = ST_SetBandNoDataValue(rast,249) WHERE rid=2;
-- 1番バンドの値が249でないピクセルのみ考慮に入れた分位数を計算する例です

SELECT (pvq).*
FROM (SELECT ST_Quantile(rast, ARRAY[0.25,0.75]) As pvq
    FROM dummy_rast WHERE rid=2) As foo
    ORDER BY (pvq).quantile;

 quantile | value
----------+-------
     0.25 |   253
     0.75 |   254

SELECT ST_Quantile(rast, 0.75) As value
    FROM dummy_rast WHERE rid=2;

value
------
  254

-- 実際の例です。2番バンドでジオメトリとインタセクトする部分の全てのピクセルの分位数を計算します。
SELECT rid, (ST_Quantile(rast,2)).* As pvc
    FROM o_4_boston
        WHERE ST_Intersects(rast,
            ST_GeomFromText('POLYGON((224486 892151,224486 892200,224706 892200,224706 892151,224486 892151))',26986)
            )
ORDER BY value, quantile,rid
;

 rid | quantile | value
-----+----------+-------
   1 |        0 |     0
   2 |        0 |     0
  14 |        0 |     1
  15 |        0 |     2
  14 |     0.25 |    37
   1 |     0.25 |    42
  15 |     0.25 |    47
   2 |     0.25 |    50
  14 |      0.5 |    56
   1 |      0.5 |    64
  15 |      0.5 |    66
   2 |      0.5 |    77
  14 |     0.75 |    81
  15 |     0.75 |    87
   1 |     0.75 |    94
   2 |     0.75 |   106
  14 |        1 |   199
   1 |        1 |   244
   2 |        1 |   255
  15 |        1 |   255

関連情報

ST_Count, ST_SummaryStats, ST_SummaryStatsAgg, ST_SetBandNoDataValue

Name

ST_SummaryStats — ラスタまたはラスタカバレッジの指定したバンドについて、ピクセル数、合計値、平均値、標準偏差、最小値、最大値からなる統計情報の概要を返します。バンドを指定しない場合には、1番と仮定します。

Synopsis

summarystats ST_SummaryStats( | rast, |
| exclude_nodata_value); |

raster rast;
boolean exclude_nodata_value;

summarystats ST_SummaryStats( | rast, |
| nband, |
| exclude_nodata_value); |

raster rast;
integer nband;
boolean exclude_nodata_value;

説明

ラスタまたはラスタカバレッジの指定したバンドについて、ピクセル数、合計値、平均値、標準偏差、最小値、最大値からなるsummarystatsによる統計情報の概要を返します。nbandでバンドを指定しない場合には、1番と仮定します。

Note

デフォルトでは、nodataと同じピクセル値は考慮に入れません。exclude_nodata_valueをFALSEに設定すると全てのピクセルを数えます。

Note

デフォルトでは、全てのピクセルを見ます。より早い応答を得るには、sample_percent値を1未満で設定します。

Changed: 3.1.0 ST_SummaryStats(rastertable, rastercolumn, ...) の形式は削除されました。代わりにST_SummaryStatsAggを使用します。

Availability: 2.0.0

例: 単一ラスタタイル

SELECT rid, band, (stats).*
FROM (SELECT rid, band, ST_SummaryStats(rast, band) As stats
    FROM dummy_rast CROSS JOIN generate_series(1,3) As band
     WHERE rid=2) As foo;

 rid | band | count | sum  |    mean    |  stddev   | min | max
-----+------+-------+------+------------+-----------+-----+-----
   2 |    1 |    23 | 5821 | 253.086957 |  1.248061 | 250 | 254
   2 |    2 |    25 | 3682 |     147.28 | 59.862188 |  78 | 254
   2 |    3 |    25 | 3290 |      131.6 | 61.647384 |  62 | 254

例: 対象とする建物とインタセクトするピクセルの概要

この例は、ボストンの建物の全て (約102,000件)と空中写真タイル (150x150ピクセルで約134,000タイル)とで、Windows 64ビット上のPostGISで計算したところ、574ミリ秒かかりました。

WITH
-- 対象地物
   feat AS (SELECT gid As building_id, geom_26986 As geom FROM buildings AS b
    WHERE gid IN(100, 103,150)
   ),
-- ラスタタイルの2番バンドを建物の境界で切り取って
-- その範囲の統計情報を得ます
   b_stats AS
    (SELECT  building_id, (stats).*
FROM (SELECT building_id, ST_SummaryStats(ST_Clip(rast,2,geom)) As stats
    FROM aerials.boston
        INNER JOIN feat
    ON ST_Intersects(feat.geom,rast)
 ) As foo
 )
-- 最後に統計情報の概要を得ます
SELECT building_id, SUM(count) As num_pixels
  , MIN(min) As min_pval
  ,  MAX(max) As max_pval
  , SUM(mean*count)/SUM(count) As avg_pval
    FROM b_stats
 WHERE count
> 0
    GROUP BY building_id
    ORDER BY building_id;
 building_id | num_pixels | min_pval | max_pval |     avg_pval
-------------+------------+----------+----------+------------------
         100 |       1090 |        1 |      255 | 61.0697247706422
         103 |        655 |        7 |      182 | 70.5038167938931
         150 |        895 |        2 |      252 | 185.642458100559

例:ラスタカバレッジ

-- バンドごとの統計情報 --
SELECT band, (stats).*
FROM (SELECT band, ST_SummaryStats('o_4_boston','rast', band) As stats
    FROM generate_series(1,3) As band) As foo;

 band |  count  |  sum   |       mean       |      stddev      | min | max
------+---------+--------+------------------+------------------+-----+-----
    1 | 8450000 | 725799 | 82.7064349112426 | 45.6800222638537 |   0 | 255
    2 | 8450000 | 700487 | 81.4197705325444 | 44.2161184161765 |   0 | 255
    3 | 8450000 | 575943 |  74.682739408284 | 44.2143885481407 |   0 | 255

-- テーブルの場合 -- サンプリング率を100%より低くすると早くなります
-- 25%に設定して、速く答を得ています
SELECT band, (stats).*
FROM (SELECT band, ST_SummaryStats('o_4_boston','rast', band,true,0.25) As stats
    FROM generate_series(1,3) As band) As foo;

 band |  count  |  sum   |       mean       |      stddev      | min | max
------+---------+--------+------------------+------------------+-----+-----
    1 | 2112500 | 180686 | 82.6890480473373 | 45.6961043857248 |   0 | 255
    2 | 2112500 | 174571 |  81.448503668639 | 44.2252623171821 |   0 | 255
    3 | 2112500 | 144364 | 74.6765884023669 | 44.2014869384578 |   0 | 255

関連情報

summarystats, ST_SummaryStatsAgg, ST_Count, ST_Clip

Name

ST_SummaryStatsAgg — 集約関数です。ラスタ集合の指定したバンドについて、ピクセル数、合計値、平均値、標準偏差、最小値、最大値からなる統計情報の概要を返します。バンドを指定しない場合には、1番と仮定します。

Synopsis

summarystats ST_SummaryStatsAgg( | rast, |
| nband, |
| exclude_nodata_value, |
| sample_percent); |

raster rast;
integer nband;
boolean exclude_nodata_value;
double precision sample_percent;

summarystats ST_SummaryStatsAgg( | rast, |
| exclude_nodata_value, |
| sample_percent); |

raster rast;
boolean exclude_nodata_value;
double precision sample_percent;

summarystats ST_SummaryStatsAgg( | rast, |
| nband, |
| exclude_nodata_value); |

raster rast;
integer nband;
boolean exclude_nodata_value;

説明

ラスタまたはラスタカバレッジの指定したバンドについて、ピクセル数、合計値、平均値、標準偏差、最小値、最大値からなるsummarystatsによる統計情報の概要を返します。nbandでバンドを指定しない場合には、1番と仮定します。

Note

デフォルトでは、NODATAと同じピクセル値は考慮に入れません。exclude_nodata_valueをFALSEに設定すると全てのピクセルを数えます。

Note

デフォルトでは全てのピクセルを見ます。よりい早い応答を得るには、sample_percentを0から1の間で設定します。

Availability: 2.2.0

例

WITH foo AS (
    SELECT
        rast.rast
    FROM (
        SELECT ST_SetValue(
            ST_SetValue(
                ST_SetValue(
                    ST_AddBand(
                        ST_MakeEmptyRaster(10, 10, 10, 10, 2, 2, 0, 0,0)
                        , 1, '64BF', 0, 0
                    )
                    , 1, 1, 1, -10
                )
                , 1, 5, 4, 0
            )
            , 1, 5, 5, 3.14159
        ) AS rast
    ) AS rast
    FULL JOIN (
        SELECT generate_series(1, 10) AS id
    ) AS id
        ON 1 = 1
)
SELECT
    (stats).count,
    round((stats).sum::numeric, 3),
    round((stats).mean::numeric, 3),
    round((stats).stddev::numeric, 3),
    round((stats).min::numeric, 3),
    round((stats).max::numeric, 3)
FROM (
    SELECT
        ST_SummaryStatsAgg(rast, 1, TRUE, 1) AS stats
    FROM foo
) bar;

 count |  round  | round  | round |  round  | round
-------+---------+--------+-------+---------+-------
    20 | -68.584 | -3.429 | 6.571 | -10.000 | 3.142
(1 row)

関連情報

summarystats, ST_SummaryStats, ST_Count, ST_Clip

Name

ST_ValueCount — ラスタ　(またはラスタカバレッジ)の指定されたバンドで、指定した値を持つピクセルを対象として、ピクセルバンド値とピクセル数からなるレコードの集合を返します。バンドを指定しない場合には、1番と仮定します。デフォルトではNODATA値のピクセルは数えられず、ピクセルの他の値は出力され、ピクセルバンド値は最も近い整数に丸められます。

Synopsis

SETOF record ST_ValueCount( | rast, |
| nband=1, |
| exclude_nodata_value=true, |
| searchvalues=NULL, |
| roundto=0, |
| OUT value, |
| OUT count); |

raster rast;
integer nband=1;
boolean exclude_nodata_value=true;
double precision[] searchvalues=NULL;
double precision roundto=0;
double precision OUT value;
integer OUT count;

SETOF record ST_ValueCount( | rast, |
| nband, |
| searchvalues, |
| roundto=0, |
| OUT value, |
| OUT count); |

raster rast;
integer nband;
double precision[] searchvalues;
double precision roundto=0;
double precision OUT value;
integer OUT count;

SETOF record ST_ValueCount( | rast, |
| searchvalues, |
| roundto=0, |
| OUT value, |
| OUT count); |

raster rast;
double precision[] searchvalues;
double precision roundto=0;
double precision OUT value;
integer OUT count;

bigint ST_ValueCount( | rast, |
| searchvalue, |
| roundto=0); |

raster rast;
double precision searchvalue;
double precision roundto=0;

bigint ST_ValueCount( | rast, |
| nband, |
| exclude_nodata_value, |
| searchvalue, |
| roundto=0); |

raster rast;
integer nband;
boolean exclude_nodata_value;
double precision searchvalue;
double precision roundto=0;

bigint ST_ValueCount( | rast, |
| nband, |
| searchvalue, |
| roundto=0); |

raster rast;
integer nband;
double precision searchvalue;
double precision roundto=0;

SETOF record ST_ValueCount( | rastertable, |
| rastercolumn, |
| nband=1, |
| exclude_nodata_value=true, |
| searchvalues=NULL, |
| roundto=0, |
| OUT value, |
| OUT count); |

text rastertable;
text rastercolumn;
integer nband=1;
boolean exclude_nodata_value=true;
double precision[] searchvalues=NULL;
double precision roundto=0;
double precision OUT value;
integer OUT count;

SETOF record ST_ValueCount( | rastertable, |
| rastercolumn, |
| searchvalues, |
| roundto=0, |
| OUT value, |
| OUT count); |

text rastertable;
text rastercolumn;
double precision[] searchvalues;
double precision roundto=0;
double precision OUT value;
integer OUT count;

SETOF record ST_ValueCount( | rastertable, |
| rastercolumn, |
| nband, |
| searchvalues, |
| roundto=0, |
| OUT value, |
| OUT count); |

text rastertable;
text rastercolumn;
integer nband;
double precision[] searchvalues;
double precision roundto=0;
double precision OUT value;
integer OUT count;

bigintST_ValueCount( | rastertable, |
| rastercolumn, |
| nband, |
| exclude_nodata_value, |
| searchvalue, |
| roundto=0); |

text rastertable;
text rastercolumn;
integer nband;
boolean exclude_nodata_value;
double precision searchvalue;
double precision roundto=0;

bigint ST_ValueCount( | rastertable, |
| rastercolumn, |
| searchvalue, |
| roundto=0); |

text rastertable;
text rastercolumn;
double precision searchvalue;
double precision roundto=0;

bigint ST_ValueCount( | rastertable, |
| rastercolumn, |
| nband, |
| searchvalue, |
| roundto=0); |

text rastertable;
text rastercolumn;
integer nband;
double precision searchvalue;
double precision roundto=0;

説明

ラスタタイルまたはラスタカバレッジの指定したバンドにおけるピクセルバンド値とピクセル数にあたる、valueとcountからなるレコードの集合を返します。

nbandでバンドを指定しない場合には、1番と仮定します。searchvaluesが指定されていない場合には、ラスタまたはラスタカバレッジで発見した全てのピクセル値が返ります。searchvalueを一つ指定した場合には、指定したピクセルバンド値を持つピクセルの数を示すレコードでなく、整数を返します。

Note

exclude_nodata_valueをFALSEに設定している場合には、NODATA値となるピクセルも数えます。

Availability: 2.0.0

例

UPDATE dummy_rast SET rast = ST_SetBandNoDataValue(rast,249) WHERE rid=2;
-- この例では、1番バンドの、値が249でないピクセルに限って数えます

SELECT (pvc).*
FROM (SELECT ST_ValueCount(rast) As pvc
    FROM dummy_rast WHERE rid=2) As foo
    ORDER BY (pvc).value;

 value | count
-------+-------
   250 |     2
   251 |     1
   252 |     2
   253 |     6
   254 |    12

-- この例では、1番バンドの、249を含む全てのピクセルを数えます
SELECT (pvc).*
FROM (SELECT ST_ValueCount(rast,1,false) As pvc
    FROM dummy_rast WHERE rid=2) As foo
    ORDER BY (pvc).value;

 value | count
-------+-------
   249 |     2
   250 |     2
   251 |     1
   252 |     2
   253 |     6
   254 |    12

-- この例では、2番バンドの、NODATA値でない値を持つピクセルに限って数えます
SELECT (pvc).*
FROM (SELECT ST_ValueCount(rast,2) As pvc
    FROM dummy_rast WHERE rid=2) As foo
    ORDER BY (pvc).value;
 value | count
-------+-------
    78 |     1
    79 |     1
    88 |     1
    89 |     1
    96 |     1
    97 |     1
    98 |     1
    99 |     2
   112 |     2
:

-- 現実の例です。空中写真ラスタタイルの2番バンドを対象にジオメトリとインタセクトするピクセル数を数え、
-- ピクセル数が500を超えるピクセルバンド値のみ返します。
SELECT (pvc).value, SUM((pvc).count) As total
FROM (SELECT ST_ValueCount(rast,2) As pvc
    FROM o_4_boston
        WHERE ST_Intersects(rast,
            ST_GeomFromText('POLYGON((224486 892151,224486 892200,224706 892200,224706 892151,224486 892151))',26986)
             )
        ) As foo
    GROUP BY (pvc).value
    HAVING SUM((pvc).count)
> 500
    ORDER BY (pvc).value;

 value | total
-------+-----
    51 | 502
    54 | 521

-- 指定したジオメトリとインタセクトするタイルごとに値が100になるピクセルを数えて返します
SELECT rid, ST_ValueCount(rast,2,100) As count
    FROM o_4_boston
        WHERE ST_Intersects(rast,
            ST_GeomFromText('POLYGON((224486 892151,224486 892200,224706 892200,224706 892151,224486 892151))',26986)
             ) ;

 rid | count
-----+-------
   1 |    56
   2 |    95
  14 |    37
  15 |    64

関連情報

ST_Count, ST_SetBandNoDataValue

ラスタ入力

Name

ST_RastFromWKB — Well-Known Binary (WKB)ラスタからラスタ値を返します。

Synopsis

raster ST_RastFromWKB(
wkb);

bytea wkb;

説明

Well-Known Binary (WKB)ラスタが与えられると、ラスタを返します。

Availability: 2.5.0

例

SELECT (ST_Metadata(
    ST_RastFromWKB(
        '\001\000\000\000\000\000\000\000\000\000\000\000@\000\000\000\000\000\000\010@\000\000\000\000\000\000\340?\000\000\000\000\000\000\340?\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\012\000\000\000\012\000\024\000'::bytea
    )
)).* AS metadata;

 upperleftx | upperlefty | width | height | scalex | scaley | skewx | skewy | srid | numbands
------------+------------+-------+--------+--------+--------+-------+-------+------+----------
        0.5 |        0.5 |    10 |     20 |      2 |      3 |     0 |     0 |   10 |        0

関連情報

ST_MetaData, ST_RastFromHexWKB, ST_AsBinary/ST_AsWKB, ST_AsHexWKB

Name

ST_RastFromHexWKB — Well-Knownバイナリ (WKB)ラスタの16進数表現からラスタを返します。

Synopsis

raster ST_RastFromHexWKB(
wkb);

text wkb;

説明

Well-Known Binary (WKB)ラスタが16進数表現で与えられると、ラスタを返します。

Availability: 2.5.0

例

SELECT (ST_Metadata(
    ST_RastFromHexWKB(
        '010000000000000000000000400000000000000840000000000000E03F000000000000E03F000000000000000000000000000000000A0000000A001400'
    )
)).* AS metadata;

 upperleftx | upperlefty | width | height | scalex | scaley | skewx | skewy | srid | numbands
------------+------------+-------+--------+--------+--------+-------+-------+------+----------
        0.5 |        0.5 |    10 |     20 |      2 |      3 |     0 |     0 |   10 |        0

関連情報

ST_MetaData, ST_RastFromWKB, ST_AsBinary/ST_AsWKB, ST_AsHexWKB

出力

Name

ST_AsBinary/ST_AsWKB — ラスタのWell-Known Binary (WKB)表現を返します。

Synopsis

bytea ST_AsBinary( | rast, |
| outasin=FALSE); |

raster rast;
boolean outasin=FALSE;

bytea ST_AsWKB( | rast, |
| outasin=FALSE); |

raster rast;
boolean outasin=FALSE;

説明

ラスタのバイナリ表現を返します。outasinがTRUEの場合には、データベース外のバンドがデータベース内のバンドとして扱われます。表現の詳細については、PostGISソースフォルダにあるraster/doc/RFC2-WellKnownBinaryFormatをご覧下さい。

データを文字列表現に変換せずにデータベース外に引き出すためのバイナリカーソルに使えます。

Note

デフォルトでは、WKB出力には、データベース外のバンドの外部ファイルパスを含みます。クライアントがデータベース外にあるラスタファイルにアクセスできない場合には、outasinをTRUEに設定します。

Enhanced: 2.1.0 outasinの追加

Enhanced: 2.5.0 ST_AsWKBの追加

例

SELECT ST_AsBinary(rast) As rastbin FROM dummy_rast WHERE rid=1;

                     rastbin
---------------------------------------------------------------------------------
\001\000\000\000\000\000\000\000\000\000\000\000@\000\000\000\000\000\000\010@\000\000\000\000\000\000\340?\000\000\000\000\000\000\340?\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\012\000\000\000\012\000\024\000

関連情報

ST_RastFromWKB, ST_AsHexWKB

Name

ST_AsHexWKB — Well-Known Binary (WKB)ラスタを16進数表現で返します。

Synopsis

bytea ST_AsHexWKB( | rast, |
| outasin=FALSE); |

raster rast;
boolean outasin=FALSE;

説明

ラスタのバイナリの16進数表現を返します。outasinがTRUEの場合には、データベース外のバンドがデータベース内のバンドとして扱われます。表現の詳細については、PostGISソースフォルダにあるraster/doc/RFC2-WellKnownBinaryFormatをご覧下さい。

Note

デフォルトでは、WKB出力には、データベース外のバンドの外部ファイルパスを含みます。クライアントがデータベース外バンドを持っているラスタファイルにアクセスできない場合には、outasinをTRUEに設定します。

Availability: 2.5.0

例

SELECT ST_AsHexWKB(rast) As rastbin FROM dummy_rast WHERE rid=1;

                                                        st_ashexwkb
----------------------------------------------------------------------------------------------------------------------------
 010000000000000000000000400000000000000840000000000000E03F000000000000E03F000000000000000000000000000000000A0000000A001400

関連情報

ST_RastFromHexWKB, ST_AsBinary/ST_AsWKB

Name

ST_AsGDALRaster — 指定されたGDALラスタ書式でラスタタイルを返します。ラスタ書式はコンパイルしたライブラリが対応するものです。ライブラリが対応する書式の一覧を得るにはST_GDALRasters()を使います。

Synopsis

bytea ST_AsGDALRaster( | rast, |
| format, |
| options=NULL, |
| srid=sameassource); |

raster rast;
text format;
text[] options=NULL;
integer srid=sameassource;

説明

指定された書式でラスタタイルを返します。引数は次の通りです。

format 出力書式です。libgdalライブラリでコンパイルしたドライバに依存します。一般的には'JPEG', 'GTIff', 'PNG'が有効になっています。ライブラリが対応する形式の一覧を得るにはST_GDALDriversを使います。

options GDALオプションの文字列配列です。妥当なオプションは書式に依存します。詳細についてはGDAL Raster format optionsをご覧下さい。

srs 画像に埋め込むproj4textまたはsrtext (spatial_ref_sysから)です。

Availability: 2.0.0 - GDAL 1.6.0以上が必要です。

複数タイルを単一ラスタとするJPEG出力例

SELECT ST_AsGDALRaster(ST_Union(rast), 'JPEG', ARRAY['QUALITY=50']) As rastjpg
FROM dummy_rast
WHERE rast && ST_MakeEnvelope(10, 10, 11, 11);

PostgreSQLラージオブジェクト対応を使ったラスタの出力

ラスタを他の書式に出力する方法の一つとして、PostgreSQL large object export functionsの使用があります。前の例の繰り返しですが、出力も行います。サーバ側のlo関数を使うため、データベースへのスーパーユーザ権限が必要となることに注意して下さい。また、サーバネットワーク上のパスに出力します。ローカルに出力するには、psqlで、サーバのファイルシステムでなくローカルのファイルシステムに出力する等価のlo_関数を使います。

DROP TABLE IF EXISTS tmp_out ;

CREATE TABLE tmp_out AS
SELECT lo_from_bytea(0,
       ST_AsGDALRaster(ST_Union(rast), 'JPEG', ARRAY['QUALITY=50'])
        ) AS loid
  FROM dummy_rast
WHERE rast && ST_MakeEnvelope(10, 10, 11, 11);

SELECT lo_export(loid, '/tmp/dummy.jpg')
   FROM tmp_out;

SELECT lo_unlink(loid)
  FROM tmp_out;

GTIFF出力の例

SELECT ST_AsGDALRaster(rast, 'GTiff') As rastjpg
FROM dummy_rast WHERE rid=2;

-- GeoTIFFをJPEG、90%品質で圧縮して出力します
SELECT ST_AsGDALRaster(rast, 'GTiff',
  ARRAY['COMPRESS=JPEG', 'JPEG_QUALITY=90'],
  4269) As rasttiff
FROM dummy_rast WHERE rid=2;

関連情報

the section called “PostGISラスタを使ったカスタムアプリケーションの構築”, ST_GDALDrivers, ST_SRID

Name

ST_AsJPEG — ラスタの選択されたバンドを、単一のJoint Photographic Exports Group (JPEG)画像としてバイト配列で返します。バンドを指定せず、1バンドか3より多いバンドがある場合には、1番バンドを使用します。3バンドのみ指定した場合には、3バンドを使用し、RGBに対応付けます。

Synopsis

bytea ST_AsJPEG( | rast, |
| options=NULL); |

raster rast;
text[] options=NULL;

bytea ST_AsJPEG( | rast, |
| nband, |
| quality); |

raster rast;
integer nband;
integer quality;

bytea ST_AsJPEG( | rast, |
| nband, |
| options=NULL); |

raster rast;
integer nband;
text[] options=NULL;

bytea ST_AsJPEG( | rast, |
| nbands, |
| options=NULL); |

raster rast;
integer[] nbands;
text[] options=NULL;

bytea ST_AsJPEG( | rast, |
| nbands, |
| quality); |

raster rast;
integer[] nbands;
integer quality;

説明

ラスタの選択されたバンドを、単一のJoint Photographic Exports Group (JPEG)画像として返します。 より一般でないラスタタイプで出力する必要がある場合には、ST_AsGDALRasterを使います。バンドを指定せず、1バンドか3より多いバンドがある場合には、1番バンドを使用します。3バンドのみ指定した場合には、3バンドを使用します。この関数には多数の任意引数が付くさまざまな形式があります。引数については次の通りです。

nband 単一バンド出力のためのものです。

nbands 出力バンドの配列 (JPEGでは3要素が最大です)で、バンドの並び順はRGBです。たとえばARRAY[3,2,1]は、3番バンドを赤、2番バンドを緑、1番バンドを青にそれぞれ対応させます。

quality 0から100の数値です。高いほどしっかりした画像になります。

options JPEGのために定義するGDALオプションの文字列配列です (ST_GDALDriversのcreate_optionsを見てください)。JPEGの妥当なパラメタは PROGRESSIVEの'ON'または'OFF'と、QUALITYの0から100までの数 (デフォルトは75)です。詳細については GDAL Raster format optionsをご覧下さい。

Availability: 2.0.0 - GDAL 1.6.0以上が必要です。

例: 出力

-- 前から3バンドを75%品質で出力
SELECT ST_AsJPEG(rast) As rastjpg
    FROM dummy_rast WHERE rid=2;

-- 1番バンドのみ90%品質で出力
SELECT ST_AsJPEG(rast,1,90) As rastjpg
    FROM dummy_rast WHERE rid=2;

-- 前から3バンドを、2番を赤、1番を緑、3番を青とし、プログレッシブ、90%品質で出力します
SELECT ST_AsJPEG(rast,ARRAY[2,1,3],ARRAY['QUALITY=90','PROGRESSIVE=ON']) As rastjpg
    FROM dummy_rast WHERE rid=2;

関連情報

the section called “PostGISラスタを使ったカスタムアプリケーションの構築”, ST_GDALDrivers, ST_AsGDALRaster, ST_AsPNG, ST_AsTIFF

Name

ST_AsPNG — ラスタの選択されたバンドを、単一のportable network graphics (PNG)画像としてバイト配列で返します。バンドを指定せず、1バンドか3バンドか4バンドある場合には、全てのバンドを使用します。バンドを指定せず、2バンドか4より多いバンドがある場合には、1番バンドを使用します。対象バンドはRGBまたはRGBAに対応付けられます。

Synopsis

bytea ST_AsPNG( | rast, |
| options=NULL); |

raster rast;
text[] options=NULL;

bytea ST_AsPNG( | rast, |
| nband, |
| compression); |

raster rast;
integer nband;
integer compression;

bytea ST_AsPNG( | rast, |
| nband, |
| options=NULL); |

raster rast;
integer nband;
text[] options=NULL;

bytea ST_AsPNG( | rast, |
| nbands, |
| compression); |

raster rast;
integer[] nbands;
integer compression;

bytea ST_AsPNG( | rast, |
| nbands, |
| options=NULL); |

raster rast;
integer[] nbands;
text[] options=NULL;

説明

ラスタの選択されたバンドを、単一のportable network graphics (PNG)画像として返します。より一般でないラスタタイプで出力する必要がある場合には、ST_AsGDALRasterを使います。バンドを指定しない場合には、前から3バンドを出力します。この関数には多数の任意引数が付くさまざまな形式があります。sridが指定されない場合には、sridはラスタが使用しているSRIDを指定します。引数の一覧は次の通りです。

nband 単一バンド出力のためのものです。

nbands 出力バンドの配列 (PNGでは4要素が最大です)で、バンドの並び順はRGBAです。たとえばARRAY[3,2,1]は、3番バンドを赤、2番バンドを緑、1番バンドを青にそれぞれ対応させます。

compression 1から9の数を指定します。大きいほど圧縮効率が上がります。

options PNGのために定義するGDALオプションの文字列配列です (ST_GDALDriversのcreate_optionsを見てください)。PNGの妥当なパラメタはZLEVEL (圧縮に費やす時間の合計で、デフォルトは6)です。ARRAY['ZLEVEL=9']というようにします。この関数が二つの出力を行う必要があるため、ワールドファイルはPNGでは許されません。詳細についてはGDAL Raster format optionsをご覧下さい。

Availability: 2.0.0 - GDAL 1.6.0以上が必要です。

例

SELECT ST_AsPNG(rast) As rastpng
FROM dummy_rast WHERE rid=2;

-- 前から3バンドを出力し、3番を赤、1番を緑、2番を青に対応付けます
SELECT ST_AsPNG(rast, ARRAY[3,1,2]) As rastpng
FROM dummy_rast WHERE rid=2;

関連情報

ST_AsGDALRaster, ST_ColorMap, ST_GDALDrivers, the section called “PostGISラスタを使ったカスタムアプリケーションの構築”

Name

ST_AsTIFF — ラスタの選択されたバンドを、単一のTIFF画像 (バイト配列)として返します。バンドを指定しないか指定したバンドがラスタ内に無い場合には、全てのバンドの使用を試みます。

Synopsis

bytea ST_AsTIFF( | rast, |
| options='', |
| srid=sameassource); |

raster rast;
text[] options='';
integer srid=sameassource;

bytea ST_AsTIFF( | rast, |
| compression='', |
| srid=sameassource); |

raster rast;
text compression='';
integer srid=sameassource;

bytea ST_AsTIFF( | rast, |
| nbands, |
| compression='', |
| srid=sameassource); |

raster rast;
integer[] nbands;
text compression='';
integer srid=sameassource;

bytea ST_AsTIFF( | rast, |
| nbands, |
| options, |
| srid=sameassource); |

raster rast;
integer[] nbands;
text[] options;
integer srid=sameassource;

説明

ラスタの選択されたバンドを、単一のTagged Image File Format (TIFF)画像として返します。バンドを指定しない場合には、全てのバンドの使用を試みます。この関数はST_AsGDALRasterのラッパです。より一般でないラスタタイプで出力する必要がある場合には、ST_AsGDALRasterを使います。この関数には多数の任意引数が付くさまざまな形式があります。空間参照系 (SRS)の文字列表現が指定されていない場合には、ラスタの空間参照系を使います。引数については次の通りです。

nbands 出力バンドの配列 (PNGでは3要素が最大です)で、バンドの並び順はRGBです。たとえばARRAY[3,2,1]は、3番バンドを赤、2番バンドを緑、1番バンドを青にそれぞれ対応させます。

compression 圧縮式 -- JPEG90 (または他のパーセント値), LZW, JPEG, DEFLATE9のいずれかです。

options GTiffを定義するGDALオプションの文字列配列です (ST_GDALDriversのGTiff用のcreate_optionsを見てください)。詳細についてはGDAL Raster format optionsをご覧下さい。

srid ラスタのspatial_ref_sysのSRIDです。地理参照情報を登録するために使われます。

Availability: 2.0.0 - GDAL 1.6.0以上が必要です。

例: JPEG90%品質圧縮の使用

SELECT ST_AsTIFF(rast, 'JPEG90') As rasttiff
FROM dummy_rast WHERE rid=2;

関連情報

ST_GDALDrivers, ST_AsGDALRaster, ST_SRID

ラスタ処理: 地図代数

Name

ST_Clip — 入力ジオメトリで切り取ったラスタを返します。バンドが指定されていない場合には、全てのバンドが返されます。cropが指定されていない場合には、TRUEと仮定され、出力ラスタをクロップします。

Synopsis

raster ST_Clip( | rast, |
| nband, |
| geom, |
| nodataval=NULL, |
| crop=TRUE); |

raster rast;
integer[] nband;
geometry geom;
double precision[] nodataval=NULL;
boolean crop=TRUE;

raster ST_Clip( | rast, |
| nband, |
| geom, |
| nodataval, |
| crop=TRUE); |

raster rast;
integer nband;
geometry geom;
double precision nodataval;
boolean crop=TRUE;

raster ST_Clip( | rast, |
| nband, |
| geom, |
| crop); |

raster rast;
integer nband;
geometry geom;
boolean crop;

raster ST_Clip( | rast, |
| geom, |
| nodataval=NULL, |
| crop=TRUE); |

raster rast;
geometry geom;
double precision[] nodataval=NULL;
boolean crop=TRUE;

raster ST_Clip( | rast, |
| geom, |
| nodataval, |
| crop=TRUE); |

raster rast;
geometry geom;
double precision nodataval;
boolean crop=TRUE;

raster ST_Clip( | rast, |
| geom, |
| crop); |

raster rast;
geometry geom;
boolean crop;

説明

入力ジオメトリgeomで切り取ったラスタを返します。バンドが指定されていない場合には、全てのバンドが処理されます。

ST_Clipが返すラスタは、バンド毎に一つずつ必ず切り取った領域に適用するNODATA値を持ちます。NODATA値が渡されず、入力ラスタがNODATA値を持たない場合には、結果ラスタのNODATA値はST_MinPossibleValue(ST_BandPixelType(rast, band))に設定されます。配列におけるNODATA値の要素数がバンド数より小さい場合には、配列の最後の要素が残りのバンドに適用されます。NODATA値の要素数がバンド数より多い場合には、超過分は無視されます。全てのNODATA値配列を受け付ける形式では、バンド毎に適用される単一値も受け付けます。

cropが指定されていない場合には、TRUEと仮定され、出力ラスタを geom範囲とrast範囲とのインタセクトした範囲にクロップします。cropがFALSEに設定されている場合には、新しいラスタはrastと同じ範囲になります。

Availability: 2.0.0

Enhanced: 2.1.0 C言語で記述されました

MassGISサイトMassGIS Aerial Orthosにあるマサチューセッツ空中写真データを使った例です。座標はメートル単位のマサチューセッツ州平面です。

例: 1バンドの切り取り

-- 空中写真タイルの1番バンドを中心から20メートルのバッファで切り取ります
SELECT ST_Clip(rast, 1,
        ST_Buffer(ST_Centroid(ST_Envelope(rast)),20)
    ) from aerials.boston
WHERE rid = 4;

--ラスタの最終的なピクセル範囲についてのクロップの効果のデモンストレーション
-- crop=trueでは、どのように最終的な範囲がジオメトリに切り取られるかをみます
SELECT ST_XMax(ST_Envelope(ST_Clip(rast, 1, clipper, true))) As xmax_w_trim,
    ST_XMax(clipper) As xmax_clipper,
    ST_XMax(ST_Envelope(ST_Clip(rast, 1, clipper, false))) As xmax_wo_trim,
    ST_XMax(ST_Envelope(rast)) As xmax_rast_orig
FROM (SELECT rast, ST_Buffer(ST_Centroid(ST_Envelope(rast)),6) As clipper
    FROM aerials.boston
WHERE rid = 6) As foo;

   xmax_w_trim    |   xmax_clipper   |   xmax_wo_trim   |  xmax_rast_orig
------------------+------------------+------------------+------------------
 230657.436173996 | 230657.436173996 | 230666.436173996 | 230666.436173996

切り取り前の完全なラスタタイル

切り取り後

例: クロップがなく他のバンドは切り取らず1バンドを切り取る

-- 前の例と同じですが、
-- ST_AddBandは全てのバンドが同じピクセル範囲を持っている必要があるので
-- ST_AddBandを使えるようにするためcropをFALSEに設定しなければなりません
SELECT ST_AddBand(ST_Clip(rast, 1,
        ST_Buffer(ST_Centroid(ST_Envelope(rast)),20),false
    ), ARRAY[ST_Band(rast,2),ST_Band(rast,3)] ) from aerials.boston
WHERE rid = 6;

切り取り前の完全なラスタタイル

切り取り後 - シュールですね

例: 全バンドの切り取り

-- 空中写真タイルの全バンドを20メートルバッファで切り取ります
-- 違いは、全バンドの切り取りのため
-- 切り取り対象のバンドを指定しないことだけです
SELECT ST_Clip(rast,
      ST_Buffer(ST_Centroid(ST_Envelope(rast)), 20),
      false
    ) from aerials.boston
WHERE rid = 4;

切り取り前の完全なラスタタイル

切り取り後

関連情報

ST_AddBand, ST_MapAlgebra (コールバック関数版), ST_Intersection

Name

ST_ColorMap — 元のラスタと指定したバンドから4個までの8BUIバンド (grayscale, RGB, RGBA)からなる新しいラスタを生成します。

Synopsis

raster ST_ColorMap( | rast, |
| nband=1, |
| colormap=grayscale, |
| method=INTERPOLATE); |

raster rast;
integer nband=1;
text colormap=grayscale;
text method=INTERPOLATE;

raster ST_ColorMap( | rast, |
| colormap, |
| method=INTERPOLATE); |

raster rast;
text colormap;
text method=INTERPOLATE;

説明

rastのnbandで示されるバンドにcolormapを適用し、4個までの8BUIバンドからなる新しいラスタを返します。新しいラスタの8BUIバンドの数はcolormapで定義された色要素の数で決まります。

nbandが指定されていない場合には、1番と仮定します。

colormapは事前定義された色マップまたは値を定義する行の集合と色要素のキーワードです。

妥当な事前定義されたcolormapキーワードは次の通りです。

grayscaleまたはgreyscale 1個の8BUIバンドからなるラスタで、グレーの陰影です。

pseudocolor 4個の8BUIバンド (RGBA)からなるラスタで、青から緑、赤に移るものです。

fire 4個の8BUIバンド (RGBA)からなるラスタで、黒から赤、淡黄色に移るものです。

bluered 4個の8BUIバンド (RGBA)からなるラスタで、青からペールホワイト、赤に移るものです。

カスタムカラーマップを指定するためにエントリ (1行1エントリ)の集合をcolormapに渡すことができます。それぞれのエントリは一般的に、ピクセル値、ピクセル値と対応する赤、緑、青、アルファ要素(0から255の間の色要素)からなる5個の値を持ちます。ピクセル値の替わりに百分率値を使うことができ、0%がラスタバンドでの最小値、100%が最大値になります。値はコンマ('.')、タブ、コロン(':')、空白で区切られます。NODATA値に対しては、ピクセル値をnv, null, nodataのいずれかに設定できます。例を次に示します。

5 0 0 0 255
4 100:50 55 255
1 150,100 150 255
0% 255 255 255 255
nv 0 0 0 0

colormapの構文は、GDALツールのgdaldemの起伏モードに似ています。

methodの妥当なキーワードは次の通りです。

INTERPOLATE 与えられたピクセル値の間での滑らかな色合成のための線形補間に使います。

EXACT カラーマップで見つかったピクセル値だけを厳格に一致させます。カラーマップエントリに一致しないピクセルに対しては0 0 0 0 (RGBA)が設定されます。

NEAREST ピクセル値に最も近い値にあうカラーマップエントリを使います。

Note

カラーマップの偉大な参考情報はColorBrewerにあります。

Warning

新しいラスタの結果バンドにはNODATA値が入りません。NODATA値が必要な場合には、 ST_SetBandNoDataValueを使ってNODATA値をセットします。

Availability: 2.1.0

例

これは試行のためのがらくたテーブルです。

-- 試験ラスタテーブルの作成 --
DROP TABLE IF EXISTS funky_shapes;
CREATE TABLE funky_shapes(rast raster);

INSERT INTO funky_shapes(rast)
WITH ref AS (
    SELECT ST_MakeEmptyRaster( 200, 200, 0, 200, 1, -1, 0, 0) AS rast
)
SELECT
    ST_Union(rast)
FROM (
    SELECT
        ST_AsRaster(
            ST_Rotate(
                ST_Buffer(
                    ST_GeomFromText('LINESTRING(0 2,50 50,150 150,125 50)'),
                    i*2
                ),
                pi() * i * 0.125, ST_Point(50,50)
            ),
            ref.rast, '8BUI'::text, i * 5
        ) AS rast
    FROM ref
    CROSS JOIN generate_series(1, 10, 3) AS i
) AS shapes;

SELECT
    ST_NumBands(rast) As n_orig,
    ST_NumBands(ST_ColorMap(rast,1, 'greyscale')) As ngrey,
    ST_NumBands(ST_ColorMap(rast,1, 'pseudocolor')) As npseudo,
    ST_NumBands(ST_ColorMap(rast,1, 'fire')) As nfire,
    ST_NumBands(ST_ColorMap(rast,1, 'bluered')) As nbluered,
    ST_NumBands(ST_ColorMap(rast,1, '
100% 255   0   0
 80% 160   0   0
 50% 130   0   0
 30%  30   0   0
 20%  60   0   0
  0%   0   0   0
  nv 255 255 255
    ')) As nred
FROM funky_shapes;

n_orig | ngrey | npseudo | nfire | nbluered | nred
--------+-------+---------+-------+----------+------
      1 |     1 |       4 |     4 |        4 |    3

例: ST_AsPNGを使用して異なるカラーマップを比較する

SELECT
    ST_AsPNG(rast) As orig_png,
    ST_AsPNG(ST_ColorMap(rast,1,'greyscale')) As grey_png,
    ST_AsPNG(ST_ColorMap(rast,1, 'pseudocolor')) As pseudo_png,
    ST_AsPNG(ST_ColorMap(rast,1, 'nfire')) As fire_png,
    ST_AsPNG(ST_ColorMap(rast,1, 'bluered')) As bluered_png,
    ST_AsPNG(ST_ColorMap(rast,1, '
100% 255   0   0
 80% 160   0   0
 50% 130   0   0
 30%  30   0   0
 20%  60   0   0
  0%   0   0   0
  nv 255 255 255
    ')) As red_png
FROM funky_shapes;

orig_png

grey_png

pseudo_png

fire_png

bluered_png

red_png

関連情報

ST_AsPNG, ST_AsRaster ST_MapAlgebra (コールバック関数版), ST_Grayscale ST_NumBands, ST_Reclass, ST_SetBandNoDataValue, ST_Union

Name

ST_Grayscale — 元のラスタと指定したバンドを赤、緑、青バンドとして一つの8BUIバンドを持つラスタを生成します。

Synopsis

(1) raster ST_Grayscale( | rast, |
| redband=1, |
| greenband=2, |
| blueband=3, |
| extenttype=INTERSECTION); |

raster rast;
integer redband=1;
integer greenband=2;
integer blueband=3;
text extenttype=INTERSECTION;

(2) raster ST_Grayscale( | rastbandargset, |
| extenttype=INTERSECTION); |

rastbandarg[] rastbandargset;
text extenttype=INTERSECTION;

説明

三つの入力バンド (一つ以上のラスタ)を与えられ、一つの8BUIバンドを持つラスタを生成します。タイプが8BUIでない入力バンドは全てST_Reclassで再分類されます。

Note

この関数はST_ColorMapにgrayscaleキーワードを与えた場合とは違います。ST_ColorMapでは一つのバンドを扱いますが、この関数ではRGBの3バンドを期待します。この関数は 0.2989 * 赤 + 0.5870 * 緑 + 0.1140 * 青 という式を適用してRGBをグレースケールにしています。

Availability: 2.5.0

例: 一つ目の形式

SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';
SET postgis.enable_outdb_rasters = True;

WITH apple AS (
    SELECT ST_AddBand(
        ST_MakeEmptyRaster(350, 246, 0, 0, 1, -1, 0, 0, 0),
        '/tmp/apple.png'::text,
        NULL::int[]
    ) AS rast
)
SELECT
    ST_AsPNG(rast) AS original_png,
    ST_AsPNG(ST_Grayscale(rast)) AS grayscale_png
FROM apple;

original_png

grayscale_png

例: 二つ目の形式

SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';
SET postgis.enable_outdb_rasters = True;

WITH apple AS (
    SELECT ST_AddBand(
        ST_MakeEmptyRaster(350, 246, 0, 0, 1, -1, 0, 0, 0),
        '/tmp/apple.png'::text,
        NULL::int[]
    ) AS rast
)
SELECT
    ST_AsPNG(rast) AS original_png,
    ST_AsPNG(ST_Grayscale(
        ARRAY[
            ROW(rast, 1)::rastbandarg, -- red
            ROW(rast, 2)::rastbandarg, -- green
            ROW(rast, 3)::rastbandarg, -- blue
        ]::rastbandarg[]
    )) AS grayscale_png
FROM apple;

関連情報

ST_AsPNG, ST_Reclass, ST_ColorMap

Name

ST_Intersection — 二つのラスタの共有部分またはベクタ化したラスタとジオメトリとのインタセクトした部分を表現する、ラスタまたはジオメトリとピクセル値の組の集合を返します。

Synopsis

setof geomval ST_Intersection( | geom, |
| rast, |
| band_num=1); |

geometry geom;
raster rast;
integer band_num=1;

setof geomval ST_Intersection( | rast, |
| geom); |

raster rast;
geometry geom;

setof geomval ST_Intersection( | rast, |
| band, |
| geomin); |

raster rast;
integer band;
geometry geomin;

raster ST_Intersection( | rast1, |
| rast2, |
| nodataval); |

raster rast1;
raster rast2;
double precision[] nodataval;

raster ST_Intersection( | rast1, |
| rast2, |
| returnband, |
| nodataval); |

raster rast1;
raster rast2;
text returnband;
double precision[] nodataval;

raster ST_Intersection( | rast1, |
| band1, |
| rast2, |
| band2, |
| nodataval); |

raster rast1;
integer band1;
raster rast2;
integer band2;
double precision[] nodataval;

raster ST_Intersection( | rast1, |
| band1, |
| rast2, |
| band2, |
| returnband, |
| nodataval); |

raster rast1;
integer band1;
raster rast2;
integer band2;
text returnband;
double precision[] nodataval;

説明

二つのラスタの共有部分またはベクタ化したラスタとジオメトリとのインタセクトした部分を表現する、ラスタまたはジオメトリとピクセル値の組の集合を返します。

前半の三つの形式は、geomvalの集合を返すもので、ベクタ空間で動作します。ラスタは初めにgeomval行の集合にベクトル化されます (ST_DumpAsPolygonsを使用)。これらの行はPostGIS関数のST_Intersection(geometry, geometry)を使ってジオメトリとインタセクトさせます。NODATA値の領域とだけインタセクトするジオメトリについては空ジオメトリを返します。通常はWHERE節でST_Intersectsを使って結果から確実に排除します。

丸括弧でくくって式の末尾に'.geom'や'.val'をつけることにより、geomvalの結果集合のジオメトリや値の部分にアクセスすることができます。たとえば(ST_Intersection(rast, geom)).geom等とします。

他の形式は、ラスタを引数に取り、ラスタを返します。ST_MapAlgebraExprの二つのラスタを取る形式を使って、インタセクトしている部分を取得します。

結果ラスタの範囲は、二つのラスタの範囲についてインタセクトしている部分です。結果ラスタは、returnband引数として渡されたものにあわせられた'BAND1','BAND2','BOTH'バンドを含みます。どのバンドでもNODATA値の領域は、結果ラスタの全てのバンドのNODATA値領域に現れます。言い換えると、あらゆるNODATA値ピクセルとインタセクトしているピクセルは、結果ラスタではNODATA値ピクセルになります。

インタセクトしなかった領域にNODATA値を入れるために、ST_Intersectionからの結果ラスタは、NODATA値を持たなければなりません。結果ラスタのどのバンドにも、一つか二つのNODATA値を持つnodataval[]配列を与えることでNODATA値を定義したり置き換えたりできます。この配列は、引数で与えた'BAND1','BAND2','BOTH'バンドに依存します。 配列の一つ目の値は、一つ目のバンドのNODATA値を入れ替えるものです。二つ目の値は二つ目のバンドのNODATA値を入れ替えるものです。入力バンドの一つがNODATA値を持っておらず、かつ配列を渡さなかった場合には、ST_MinPossibleValue関数を使ってNODATA値が選ばれます。NODATA値の配列を受け付ける形式の全てが、単一値を受け付けます。単一値は結果ラスタのそれぞれのバンドに適用されます。

全ての形式で、バンド番号を指定していない場合には、1番と仮定します。ラスタとジオメトリを引数にとり、ラスタを得たい場合には、ST_Clipを参照して下さい。

Note

NODATA値に遭遇した時の、結果範囲や返された物に関して、より多くの制御を行いたい場合には、ST_MapAlgebraExprの二つのラスタを取る形式を使います。

Note

ラスタバンドとジオメトリとがインタセクトする部分を計算するには、ST_Clipを使います。ST_Clipは複数のバンドで動作し、ラスタ化されたジオメトリに従ったバンドを返すことはしません。

Note

ST_Intersectionは、ST_Intersectsと組み合わせて、ラスタカラムとジオメトリカラムのインデックスを使うべきです。

Enhanced: 2.0.0 - ラスタ空間のインタセクションが導入されました。2.0.0より前の版では、ベクタ空間でのインタセクションの計算のみに対応していました。

例: ジオメトリとラスタ -- ジオメトリと値を得る

SELECT
    foo.rid,
    foo.gid,
    ST_AsText((foo.geomval).geom) As geomwkt,
    (foo.geomval).val
FROM (
    SELECT
        A.rid,
        g.gid,
        ST_Intersection(A.rast, g.geom) As geomval
    FROM dummy_rast AS A
    CROSS JOIN (
        VALUES
            (1, ST_Point(3427928, 5793243.85) ),
            (2, ST_GeomFromText('LINESTRING(3427927.85 5793243.75,3427927.8 5793243.75,3427927.8 5793243.8)')),
            (3, ST_GeomFromText('LINESTRING(1 2, 3 4)'))
    ) As g(gid,geom)
    WHERE A.rid = 2
) As foo;

 rid | gid |      geomwkt                                               | val
-----+-----+---------------------------------------------------------------------------------------------
   2 |   1 | POINT(3427928 5793243.85)                                  | 249
   2 |   1 | POINT(3427928 5793243.85)                                  | 253
   2 |   2 | POINT(3427927.85 5793243.75)                               | 254
   2 |   2 | POINT(3427927.8 5793243.8)                                 | 251
   2 |   2 | POINT(3427927.8 5793243.8)                                 | 253
   2 |   2 | LINESTRING(3427927.8 5793243.75,3427927.8 5793243.8)   | 252
   2 |   2 | MULTILINESTRING((3427927.8 5793243.8,3427927.8 5793243.75),...) | 250
   2 |   3 | GEOMETRYCOLLECTION EMPTY

関連情報

geomval, ST_Intersects, ST_MapAlgebraExpr, ST_Clip, ST_AsText

Name

ST_MapAlgebra (コールバック関数版) — コールバック関数版 - 一つ以上の入力ラスタ、バンドインデクスと一つのユーザ定義コールバック関数から、一つのバンドからなるラスタを返します。

Synopsis

raster ST_MapAlgebra( | rastbandargset, |
| callbackfunc, |
| pixeltype=NULL, |
| extenttype=INTERSECTION, |
| customextent=NULL, |
| distancex=0, |
| distancey=0, |
| VARIADIC userargs=NULL); |

rastbandarg[] rastbandargset;
regprocedure callbackfunc;
text pixeltype=NULL;
text extenttype=INTERSECTION;
raster customextent=NULL;
integer distancex=0;
integer distancey=0;
text[] VARIADIC userargs=NULL;

raster ST_MapAlgebra( | rast, |
| nband, |
| callbackfunc, |
| pixeltype=NULL, |
| extenttype=FIRST, |
| customextent=NULL, |
| distancex=0, |
| distancey=0, |
| VARIADIC userargs=NULL); |

raster rast;
integer[] nband;
regprocedure callbackfunc;
text pixeltype=NULL;
text extenttype=FIRST;
raster customextent=NULL;
integer distancex=0;
integer distancey=0;
text[] VARIADIC userargs=NULL;

raster ST_MapAlgebra( | rast, |
| nband, |
| callbackfunc, |
| pixeltype=NULL, |
| extenttype=FIRST, |
| customextent=NULL, |
| distancex=0, |
| distancey=0, |
| VARIADIC userargs=NULL); |

raster rast;
integer nband;
regprocedure callbackfunc;
text pixeltype=NULL;
text extenttype=FIRST;
raster customextent=NULL;
integer distancex=0;
integer distancey=0;
text[] VARIADIC userargs=NULL;

raster ST_MapAlgebra( | rast1, |
| nband1, |
| rast2, |
| nband2, |
| callbackfunc, |
| pixeltype=NULL, |
| extenttype=INTERSECTION, |
| customextent=NULL, |
| distancex=0, |
| distancey=0, |
| VARIADIC userargs=NULL); |

raster rast1;
integer nband1;
raster rast2;
integer nband2;
regprocedure callbackfunc;
text pixeltype=NULL;
text extenttype=INTERSECTION;
raster customextent=NULL;
integer distancex=0;
integer distancey=0;
text[] VARIADIC userargs=NULL;

raster ST_MapAlgebra( | rast, |
| nband, |
| callbackfunc, |
| mask, |
| weighted, |
| pixeltype=NULL, |
| extenttype=INTERSECTION, |
| customextent=NULL, |
| VARIADIC userargs=NULL); |

raster rast;
integer nband;
regprocedure callbackfunc;
float8[] mask;
boolean weighted;
text pixeltype=NULL;
text extenttype=INTERSECTION;
raster customextent=NULL;
text[] VARIADIC userargs=NULL;

説明

一つ以上の入力ラスタ、バンドインデクスと一つのユーザ定義コールバック関数から、一つのバンドからなるラスタを返します。

rast,rast1,rast2, rastbandargset

地図代数処理が行われるラスタです。

rastbandargsetによって、多数のラスタと多数のバンドにおいて地図代数処理が使用できます。一つ目の形式の例を見て下さい。

nband, nband1, nband2

処理を行うラスタのバンド番号です。nbandはバンドを示す整数スカラまたは整数配列です。2ラスタ/2バンドの場合では、nband1はrast1のバンド、nband2はrast2のバンドです。

callbackfunc

callbackfunc引数は、SQLまたはPL/pgSQL関数の名前とシグニチャでなければならず、regprocedureにキャストしなければなりません。PL/pgSQL関数の例は次の通りです。

REATE OR REPLACE FUNCTION sample_callbackfunc(value double precision[][][], position integer[][], VARIADIC userargs text[])
    RETURNS double precision
    AS $$
    BEGIN
        RETURN 0;
    END;
    $$ LANGUAGE 'plpgsql' IMMUTABLE;

callbackfuncは、三つの引数を持たなければなりません。すなわち、3次元倍精度浮動小数点数配列、2次元整数配列、VARIADICの1次元文字列配列です。一つ目の引数valueは、全ての入力ラスタからの値 (倍精度浮動小数点数)の配列です。3次元 (1始まり)は、ラスタ番号、行、列です。二つ目の引数positionは、出力ラスタと入力ラスタからのピクセル位置の集合です。一つ目の次元の添え字 (0はじまりです)はラスタ番号です。一つ目の次元の添え字が0の場合に指される位置は、出力ラスタのピクセル位置です。二つ目の次元はXとYからなる二つの要素を持ちます。三つ目の引数userargsはユーザ定義関数特有の引数としてそのまま渡されます。

regprocedure引数をSQL関数に渡すには、完全な関数シグネチャが求められます。regprocedureへのキャストが必要です。上のPL/pgSQL関数を引数として渡すには、引数のSQLは次のようにします。

'sample_callbackfunc(double precision[], integer[], text[])'::regprocedure

引数は関数名と引数の型を含み、関数名と引数を引用符で括り、かつregprocedureにキャストする点に注意が必要です。

mask

N次元の数値配列 (行列)で、地図代数コールバック関数に渡すセルを決めるためのフィルタに使われます。0は近隣セル値をNODATAとして扱うべきであることを示し、1はデータとして扱うべきであることをそれぞれ意味します。weightがTRUEに指定されいる場合には、この配列の値は、近隣セルのピクセル値に対して掛け算を行うための数になります。

weighted

マスク値に重みづけを施す (元の値に対して乗算を行う)か、施さない (マスク処理だけを行う)かを示す真偽値です。

pixeltype

pixeltypeを渡した場合には、新しいラスタの一つのバンドが、そのピクセルタイプになります。pixeltypeにNULLを渡したり指定しなかった場合には、新しいラスタのピクセルタイプは、一つ目のラスタ (extenttypeがINTERSECTION, UNION, FIRST, CUSTOMの場合)か、適切なラスタ (extenttypeがSECOND, LASTの場合)の指定したバンドと同じピクセルタイプになります。疑問を感じたら常にpixeltypeを渡します。

出力ラスタのピクセルタイプは、必ずST_BandPixelTypeに挙げられたものの一つになるか、省略されるか、NULLに設定されます。

extenttype

INTERSECTION (デフォルト), UNION, FIRST (一つのラスタを取る形式でのデフォルト), SECOND, LAST, CUSTOMのいずれかになります。

customextent

extentypeがCUSTOMである場合には、ラスタはcustomextentで提供されます。一つ目の形式の例4をご覧下さい。

distancex

参照セルからのピクセル単位の距離です。結果として得られる行列の幅は2*distancex + 1となります。指定しない場合には、参照セルだけが対象となります (0の距離の近隣ピクセル)。

distancey

参照セルからのピクセル単位の距離です。結果として得られる行列の高さは2*distancey + 1となります。指定しない場合には、参照セルが対象となります (0の距離の近隣ピクセル)。

userargs

callbackfuncの三つ目の引数はvariadic text配列です。全ての文字列引数は指定されたcallbackfuncにそのまま渡され、userargs引数に含まれます。

Note

VARIADICキーワードに関する詳細情報については、PostgreSQL文書とQuery Language (SQL) Functions (訳注: 日本語版は「問い合わせ言語 （SQL）関数」です)の"SQL Functions with Variable Numbers of Arguments" (訳注: 日本語版は「可変長引数を取るSQL関数」)節を参照して下さい。

Note

callbackfuncへのtext[]引数は、あらゆる引数を処理のためにユーザ関数に渡すかどうかの選択にかかわらず求められます。

一つ目の形式では、多数のラスタやバンドで地図代数演算が使えるようになるためのrastbandarg配列を受け付けます。一つ目の形式の例をご覧下さい。

二つ目と三つ目の形式では、一つのラスタにおける一つ以上のバンドについて演算を行います。二つ目の形式と三つ目の形式の例をご覧下さい。

四つ目の形式では、二つのラスタにおいて、それぞれ一つずつのバンドについて演算を行います。四つ目の形式の例をご覧下さい。

Availability: 2.2.0: マスクが追加されました。

Availability: 2.1.0

例: 一つ目の形式

一つのラスタ、一つのバンド

WITH foo AS (
    SELECT 1 AS rid, ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 1, -1, 0, 0, 0), 1, '16BUI', 1, 0) AS rast
)
SELECT
    ST_MapAlgebra(
        ARRAY[ROW(rast, 1)]::rastbandarg[],
        'sample_callbackfunc(double precision[], int[], text[])'::regprocedure
    ) AS rast
FROM foo

一つのラスタ、複数のバンド

WITH foo AS (
    SELECT 1 AS rid, ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 1, -1, 0, 0, 0), 1, '16BUI', 1, 0), 2, '8BUI', 10, 0), 3, '32BUI', 100, 0) AS rast
)
SELECT
    ST_MapAlgebra(
        ARRAY[ROW(rast, 3), ROW(rast, 1), ROW(rast, 3), ROW(rast, 2)]::rastbandarg[],
        'sample_callbackfunc(double precision[], int[], text[])'::regprocedure
    ) AS rast
FROM foo

複数のラスタ、複数のバンド

WITH foo AS (
    SELECT 1 AS rid, ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 1, -1, 0, 0, 0), 1, '16BUI', 1, 0), 2, '8BUI', 10, 0), 3, '32BUI', 100, 0) AS rast UNION ALL
    SELECT 2 AS rid, ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 1, 1, -1, 0, 0, 0), 1, '16BUI', 2, 0), 2, '8BUI', 20, 0), 3, '32BUI', 300, 0) AS rast
)
SELECT
    ST_MapAlgebra(
        ARRAY[ROW(t1.rast, 3), ROW(t2.rast, 1), ROW(t2.rast, 3), ROW(t1.rast, 2)]::rastbandarg[],
        'sample_callbackfunc(double precision[], int[], text[])'::regprocedure
    ) AS rast
FROM foo t1
CROSS JOIN foo t2
WHERE t1.rid = 1
    AND t2.rid = 2

近隣ピクセルを併用したカバレッジのタイルの完全な例です。クエリはPostgreSQL 9.1以上でのみ動作します。

WITH foo AS (
    SELECT 0 AS rid, ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 1, -1, 0, 0, 0), 1, '16BUI', 1, 0) AS rast UNION ALL
    SELECT 1, ST_AddBand(ST_MakeEmptyRaster(2, 2, 2, 0, 1, -1, 0, 0, 0), 1, '16BUI', 2, 0) AS rast UNION ALL
    SELECT 2, ST_AddBand(ST_MakeEmptyRaster(2, 2, 4, 0, 1, -1, 0, 0, 0), 1, '16BUI', 3, 0) AS rast UNION ALL

    SELECT 3, ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, -2, 1, -1, 0, 0, 0), 1, '16BUI', 10, 0) AS rast UNION ALL
    SELECT 4, ST_AddBand(ST_MakeEmptyRaster(2, 2, 2, -2, 1, -1, 0, 0, 0), 1, '16BUI', 20, 0) AS rast UNION ALL
    SELECT 5, ST_AddBand(ST_MakeEmptyRaster(2, 2, 4, -2, 1, -1, 0, 0, 0), 1, '16BUI', 30, 0) AS rast UNION ALL

    SELECT 6, ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, -4, 1, -1, 0, 0, 0), 1, '16BUI', 100, 0) AS rast UNION ALL
    SELECT 7, ST_AddBand(ST_MakeEmptyRaster(2, 2, 2, -4, 1, -1, 0, 0, 0), 1, '16BUI', 200, 0) AS rast UNION ALL
    SELECT 8, ST_AddBand(ST_MakeEmptyRaster(2, 2, 4, -4, 1, -1, 0, 0, 0), 1, '16BUI', 300, 0) AS rast
)
SELECT
    t1.rid,
    ST_MapAlgebra(
        ARRAY[ROW(ST_Union(t2.rast), 1)]::rastbandarg[],
        'sample_callbackfunc(double precision[], int[], text[])'::regprocedure,
        '32BUI',
        'CUSTOM', t1.rast,
        1, 1
    ) AS rast
FROM foo t1
CROSS JOIN foo t2
WHERE t1.rid = 4
    AND t2.rid BETWEEN 0 AND 8
    AND ST_Intersects(t1.rast, t2.rast)
GROUP BY t1.rid, t1.rast

前の例である近隣ピクセルを併用したカバレッジのタイルに似ていますがPostgreSQL 9.0で動作します。

WITH src AS (
    SELECT 0 AS rid, ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 1, -1, 0, 0, 0), 1, '16BUI', 1, 0) AS rast UNION ALL
    SELECT 1, ST_AddBand(ST_MakeEmptyRaster(2, 2, 2, 0, 1, -1, 0, 0, 0), 1, '16BUI', 2, 0) AS rast UNION ALL
    SELECT 2, ST_AddBand(ST_MakeEmptyRaster(2, 2, 4, 0, 1, -1, 0, 0, 0), 1, '16BUI', 3, 0) AS rast UNION ALL

    SELECT 3, ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, -2, 1, -1, 0, 0, 0), 1, '16BUI', 10, 0) AS rast UNION ALL
    SELECT 4, ST_AddBand(ST_MakeEmptyRaster(2, 2, 2, -2, 1, -1, 0, 0, 0), 1, '16BUI', 20, 0) AS rast UNION ALL
    SELECT 5, ST_AddBand(ST_MakeEmptyRaster(2, 2, 4, -2, 1, -1, 0, 0, 0), 1, '16BUI', 30, 0) AS rast UNION ALL

    SELECT 6, ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, -4, 1, -1, 0, 0, 0), 1, '16BUI', 100, 0) AS rast UNION ALL
    SELECT 7, ST_AddBand(ST_MakeEmptyRaster(2, 2, 2, -4, 1, -1, 0, 0, 0), 1, '16BUI', 200, 0) AS rast UNION ALL
    SELECT 8, ST_AddBand(ST_MakeEmptyRaster(2, 2, 4, -4, 1, -1, 0, 0, 0), 1, '16BUI', 300, 0) AS rast
)
WITH foo AS (
    SELECT
        t1.rid,
        ST_Union(t2.rast) AS rast
    FROM src t1
    JOIN src t2
        ON ST_Intersects(t1.rast, t2.rast)
        AND t2.rid BETWEEN 0 AND 8
    WHERE t1.rid = 4
    GROUP BY t1.rid
), bar AS (
    SELECT
        t1.rid,
        ST_MapAlgebra(
            ARRAY[ROW(t2.rast, 1)]::rastbandarg[],
            'raster_nmapalgebra_test(double precision[], int[], text[])'::regprocedure,
            '32BUI',
            'CUSTOM', t1.rast,
            1, 1
        ) AS rast
    FROM src t1
    JOIN foo t2
        ON t1.rid = t2.rid
)
SELECT
    rid,
    (ST_Metadata(rast)),
    (ST_BandMetadata(rast, 1)),
    ST_Value(rast, 1, 1, 1)
FROM bar;

例: 二つ目の形式と三つ目の形式

一つのラスタ、複数のバンド

WITH foo AS (
    SELECT 1 AS rid, ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 1, -1, 0, 0, 0), 1, '16BUI', 1, 0), 2, '8BUI', 10, 0), 3, '32BUI', 100, 0) AS rast
)
SELECT
    ST_MapAlgebra(
        rast, ARRAY[3, 1, 3, 2]::integer[],
        'sample_callbackfunc(double precision[], int[], text[])'::regprocedure
    ) AS rast
FROM foo

一つのラスタ、一つのバンド

WITH foo AS (
    SELECT 1 AS rid, ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 1, -1, 0, 0, 0), 1, '16BUI', 1, 0), 2, '8BUI', 10, 0), 3, '32BUI', 100, 0) AS rast
)
SELECT
    ST_MapAlgebra(
        rast, 2,
        'sample_callbackfunc(double precision[], int[], text[])'::regprocedure
    ) AS rast
FROM foo

例: 四つ目の形式

二つのラスタ、二つのバンド

WITH foo AS (
    SELECT 1 AS rid, ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 1, -1, 0, 0, 0), 1, '16BUI', 1, 0), 2, '8BUI', 10, 0), 3, '32BUI', 100, 0) AS rast UNION ALL
    SELECT 2 AS rid, ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 1, 1, -1, 0, 0, 0), 1, '16BUI', 2, 0), 2, '8BUI', 20, 0), 3, '32BUI', 300, 0) AS rast
)
SELECT
    ST_MapAlgebra(
        t1.rast, 2,
        t2.rast, 1,
        'sample_callbackfunc(double precision[], int[], text[])'::regprocedure
    ) AS rast
FROM foo t1
CROSS JOIN foo t2
WHERE t1.rid = 1
    AND t2.rid = 2

例: マスクの使用

WITH foo AS (SELECT
   ST_SetBandNoDataValue(
ST_SetValue(ST_SetValue(ST_AsRaster(
        ST_Buffer(
            ST_GeomFromText('LINESTRING(50 50,100 90,100 50)'), 5,'join=bevel'),
            200,200,ARRAY['8BUI'], ARRAY[100], ARRAY[0]), ST_Buffer('POINT(70 70)'::geometry,10,'quad_segs=1') ,50),
  'LINESTRING(20 20, 100 100, 150 98)'::geometry,1),0)  AS rast )
SELECT 'original' AS title, rast
FROM foo
UNION ALL
SELECT 'no mask mean value' AS title, ST_MapAlgebra(rast,1,'ST_mean4ma(double precision[], int[], text[])'::regprocedure) AS rast
FROM foo
UNION ALL
SELECT 'mask only consider neighbors, exclude center' AS title, ST_MapAlgebra(rast,1,'ST_mean4ma(double precision[], int[], text[])'::regprocedure,
    '{{1,1,1}, {1,0,1}, {1,1,1}}'::double precision[], false) As rast
FROM foo

UNION ALL
SELECT 'mask weighted only consider neighbors, exclude center multi otehr pixel values by 2' AS title, ST_MapAlgebra(rast,1,'ST_mean4ma(double precision[], int[], text[])'::regprocedure,
    '{{2,2,2}, {2,0,2}, {2,2,2}}'::double precision[], true) As rast
FROM foo;

original

no mask mean value (マスクなし平均値) (マスク配列に全て1があるのと同じ)

mask only consider neighbors, exclude center (近隣セルのみ注目し、中心セルを除くマスク)

mask weighted only consider neighbors, exclude center multi other pixel values by 2 (近隣のみ考慮に入れて中心を除き、2を掛けるウェイトマスク)

関連情報

rastbandarg, ST_Union, ST_MapAlgebra (数式版)

Name

ST_MapAlgebra (数式版) — 数式版 - 一つか二つの入力ラスタ、バンド番号、一つ以上のユーザ定義SQL式から一つのバンドを持つラスタを返します。

Synopsis

raster ST_MapAlgebra( | rast, |
| nband, |
| pixeltype, |
| expression, |
| nodataval=NULL); |

raster rast;
integer nband;
text pixeltype;
text expression;
double precision nodataval=NULL;

raster ST_MapAlgebra( | rast, |
| pixeltype, |
| expression, |
| nodataval=NULL); |

raster rast;
text pixeltype;
text expression;
double precision nodataval=NULL;

raster ST_MapAlgebra( | rast1, |
| nband1, |
| rast2, |
| nband2, |
| expression, |
| pixeltype=NULL, |
| extenttype=INTERSECTION, |
| nodata1expr=NULL, |
| nodata2expr=NULL, |
| nodatanodataval=NULL); |

raster rast1;
integer nband1;
raster rast2;
integer nband2;
text expression;
text pixeltype=NULL;
text extenttype=INTERSECTION;
text nodata1expr=NULL;
text nodata2expr=NULL;
double precision nodatanodataval=NULL;

raster ST_MapAlgebra( | rast1, |
| rast2, |
| expression, |
| pixeltype=NULL, |
| extenttype=INTERSECTION, |
| nodata1expr=NULL, |
| nodata2expr=NULL, |
| nodatanodataval=NULL); |

raster rast1;
raster rast2;
text expression;
text pixeltype=NULL;
text extenttype=INTERSECTION;
text nodata1expr=NULL;
text nodata2expr=NULL;
double precision nodatanodataval=NULL;

説明

数式版 - 一つか二つの入力ラスタ、バンド番号、一つ以上のユーザ定義SQL式から一つのバンドを持つラスタを返します。

Availability: 2.1.0

説明: 一つ目の形式と二つ目の形式 (一つのラスタ)

expressionで定義された妥当なPostgreSQL代数演算を入力ラスタ (rast)に適用して、一つのバンドを持つラスタを生成します。nbandが指定されない場合には、1番バンドと仮定します。新しいラスタは、元のラスタと同じ地理参照、幅、高さになりますが、バンドは一つだけとなります。

pixeltypeが渡された場合には、新しいラスタのバンドは、そのピクセルタイプになります。pixeltypeにNULLが渡された場合には、新しいラスタは入力rastのバンドのピクセルタイプと同じになります。

expressionのキーワードは次の通りです。

[rast] - 演算対象ピクセルの値

[rast.val] - 演算対象ピクセルの値

[rast.x] - 演算対象ピクセルの列 (1始まり)

[rast.y] - 演算対象ピクセルの行 (1始まり)

説明: 三つ目と四つ目の形式 (二つのラスタ)

expressionで定義された妥当な二つのバンドへのPostgreSQL代数演算を入力ラスタ rast1, (rast2)に適用して、一つのバンドを持つラスタを生成します。band1, band2が指定されない場合には、1番バンドと仮定します。新しいラスタは、一つ目のラスタと同じアラインメント (スケール、スキュー、ピクセル隅)を持ちます。新しいラスタは、extenttype引数で定義される範囲になります。

expression

二つのラスタとPostgreSQL定義済み関数/演算子を含むPostgreSQL代数式です。関数と演算子は、二つのピクセルがインタセクトするピクセルの値を定めます。たとえば(([rast1] + [rast2])/2.0)::integerといったふうになります。

pixeltype

出力ラスタのピクセルタイプです。必ずST_BandPixelTypeに挙げられたものの一つになるか、省略されるか、NULLに設定されます。引数として渡されないかNULLが渡された場合には、一つ目のラスタのピクセルタイプになります。

extenttype

新しいラスタの範囲を制御します。

INTERSECTION - 新しいラスタの範囲は二つのラスタのインタセクトした領域です。これがデフォルトです。

UNION - 新しいラスタの範囲は二つのラスタの結合です。

FIRST - 新しいラスタの範囲は一つ目のラスタと同じです。

SECOND - 新しいラスタの範囲は二つ目のラスタと同じです。

nodata1expr

rast1がNODATA値で、特にrast2ピクセルに値がある時に、rast2だけを返すか返すべき値を定義する定数を含む代数式です。

nodata2expr

rast2がNODATA値で、特にrast2ピクセルに値がある時に、rast1だけを返すか返すべき値を定義する定数を含む代数式です。

nodatanodataval

rast1とrast2のピクセルの両方がNOADTA値になる場合に返すべき定数です。

有効なexpression, nodata1expr, nodata2exprのキーワードは次の通りです。

[rast1] - rast1の演算対象ピクセルの値

[rast1.val] - rast1の演算対象ピクセルの値

[rast1.x] - rast1の演算対象ピクセルの列 (1始まり)

[rast1.y] - rast1の演算対象ピクセルの行 (1始まり)

[rast2] - rast2の演算対象ピクセルの値

[rast2.val] - rast2の演算対象ピクセルの値

[rast2.x] - rast2の演算対象ピクセルの列 (1始まり)

[rast2.y] - rast2の演算対象ピクセルの行 (1始まり)

例: 一つ目の形式と二つ目の形式

WITH foo AS (
    SELECT ST_AddBand(ST_MakeEmptyRaster(10, 10, 0, 0, 1, 1, 0, 0, 0), '32BF'::text, 1, -1) AS rast
)
SELECT
    ST_MapAlgebra(rast, 1, NULL, 'ceil([rast]*[rast.x]/[rast.y]+[rast.val])')
FROM foo;

例: 三つ目の形式と四つ目の形式

WITH foo AS (
    SELECT 1 AS rid, ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 0, 1, -1, 0, 0, 0), 1, '16BUI', 1, 0), 2, '8BUI', 10, 0), 3, '32BUI'::text, 100, 0) AS rast UNION ALL
    SELECT 2 AS rid, ST_AddBand(ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(2, 2, 0, 1, 1, -1, 0, 0, 0), 1, '16BUI', 2, 0), 2, '8BUI', 20, 0), 3, '32BUI'::text, 300, 0) AS rast
)
SELECT
    ST_MapAlgebra(
        t1.rast, 2,
        t2.rast, 1,
        '([rast2] + [rast1.val]) / 2'
    ) AS rast
FROM foo t1
CROSS JOIN foo t2
WHERE t1.rid = 1
    AND t2.rid = 2;

関連情報

rastbandarg, ST_Union, ST_MapAlgebra (コールバック関数版)

Name

ST_MapAlgebraExpr — 1バンド版: 入力バンドに対する妥当なPostgreSQL代数演算で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、1番を仮定します。

Synopsis

raster ST_MapAlgebraExpr( | rast, |
| band, |
| pixeltype, |
| expression, |
| nodataval=NULL); |

raster rast;
integer band;
text pixeltype;
text expression;
double precision nodataval=NULL;

raster ST_MapAlgebraExpr( | rast, |
| pixeltype, |
| expression, |
| nodataval=NULL); |

raster rast;
text pixeltype;
text expression;
double precision nodataval=NULL;

説明

Warning

ST_MapAlgebraExpr は2.1.0で非推奨になりました。代わりにST_MapAlgebra (数式版) を使います。

入力ラスタ (rast)に対してexpressionで定義される妥当なPostgreSQL代数演算で形成されるラスタを返します。生成されるラスタは指定したピクセルタイプとなる1バンドラスタです。bandを指定しない場合には、1番と仮定します。新しいラスタは、元のラスタと同じ地理参照、幅、高さを持ちますが、一つのバンドしか持ちません。

pixeltypeが渡された場合には、新しいラスタのバンドは、そのピクセルタイプになります。pixeltypeにNULLが渡された場合には、新しいラスタは入力rastのバンドのピクセルタイプと同じになります。

数式の中では、[rast]で元のバンドのピクセル値を、[rast.x]で1始まりの列番号、[rast.y]で1始まりの行番号を、それぞれ参照することができます。

Availability: 2.0.0

例

元のラスタから1バンドラスタを生成します。元のラスタバンドの値について2で割った余りが入ります。

ALTER TABLE dummy_rast ADD COLUMN map_rast raster;
UPDATE dummy_rast SET map_rast = ST_MapAlgebraExpr(rast,NULL,'mod([rast]::numeric,2)') WHERE rid = 2;

SELECT
    ST_Value(rast,1,i,j) As origval,
    ST_Value(map_rast, 1, i, j) As mapval
FROM dummy_rast
CROSS JOIN generate_series(1, 3) AS i
CROSS JOIN generate_series(1,3) AS j
WHERE rid = 2;

 origval | mapval
---------+--------
     253 |      1
     254 |      0
     253 |      1
     253 |      1
     254 |      0
     254 |      0
     250 |      0
     254 |      0
     254 |      0

ピクセルタイプが2BUIの1バンドラスタを生成します。元のラスタに対して再分類を行った値が入り、NODATA値を0に設定します。

ALTER TABLE dummy_rast ADD COLUMN map_rast2 raster;
UPDATE dummy_rast SET
    map_rast2 = ST_MapAlgebraExpr(rast,'2BUI'::text,'CASE WHEN [rast] BETWEEN 100 and 250 THEN 1 WHEN [rast] = 252 THEN 2 WHEN [rast] BETWEEN 253 and 254 THEN 3 ELSE 0 END'::text, '0')
WHERE rid = 2;

SELECT DISTINCT
    ST_Value(rast,1,i,j) As origval,
    ST_Value(map_rast2, 1, i, j) As mapval
FROM dummy_rast
CROSS JOIN generate_series(1, 5) AS i
CROSS JOIN generate_series(1,5) AS j
WHERE rid = 2;

 origval | mapval
---------+--------
     249 |      1
     250 |      1
     251 |
     252 |      2
     253 |      3
     254 |      3

SELECT
    ST_BandPixelType(map_rast2) As b1pixtyp
FROM dummy_rast
WHERE rid = 2;

 b1pixtyp
----------
 2BUI

元のラスタ (rast_viewカラム)

rast_view_ma

新しいバンドを三つ持つラスタを生成します。元のバンドを三つ持つラスタと同じピクセルタイプです。1番バンドは地図代数関数によって変更され、残りの二つのバンドは値が代わりません。

SELECT
    ST_AddBand(
        ST_AddBand(
            ST_AddBand(
                ST_MakeEmptyRaster(rast_view),
                ST_MapAlgebraExpr(rast_view,1,NULL,'tan([rast])*[rast]')
            ),
            ST_Band(rast_view,2)
        ),
        ST_Band(rast_view, 3)
    )  As rast_view_ma
FROM wind
WHERE rid=167;

関連情報

ST_MapAlgebraExpr, ST_MapAlgebraFct, ST_BandPixelType, ST_GeoReference, ST_Value

Name

ST_MapAlgebraExpr — 2バンド版: 二つの入力バンドに対する妥当なPostgreSQL代数演算で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、どちらも1番と仮定します。結果ラスタは、一つ目のラスタのアラインメント (スケール、スキュー、ピクセル角位置)にあわされます。範囲は"extenttype"引数で定義されます。取りうる"extenttype"の値はINTERSECTION, UNION, FIRST, SECONDです。

Synopsis

raster ST_MapAlgebraExpr( | rast1, |
| rast2, |
| expression, |
| pixeltype=same_as_rast1_band, |
| extenttype=INTERSECTION, |
| nodata1expr=NULL, |
| nodata2expr=NULL, |
| nodatanodataval=NULL); |

raster rast1;
raster rast2;
text expression;
text pixeltype=same_as_rast1_band;
text extenttype=INTERSECTION;
text nodata1expr=NULL;
text nodata2expr=NULL;
double precision nodatanodataval=NULL;

raster ST_MapAlgebraExpr( | rast1, |
| band1, |
| rast2, |
| band2, |
| expression, |
| pixeltype=same_as_rast1_band, |
| extenttype=INTERSECTION, |
| nodata1expr=NULL, |
| nodata2expr=NULL, |
| nodatanodataval=NULL); |

raster rast1;
integer band1;
raster rast2;
integer band2;
text expression;
text pixeltype=same_as_rast1_band;
text extenttype=INTERSECTION;
text nodata1expr=NULL;
text nodata2expr=NULL;
double precision nodatanodataval=NULL;

説明

Warning

ST_MapAlgebraExpr は2.1.0で非推奨になりました。代わりにST_MapAlgebra (数式版) を使います。

expressionで定義された妥当な二つのバンドへのPostgreSQL代数演算を入力ラスタ rast1, (rast2)に適用して、一つのバンドを持つラスタを生成します。band1, band2が指定されない場合には、1番バンドと仮定します。新しいラスタは、一つ目のラスタと同じアラインメント (スケール、スキュー、ピクセル隅)を持ちます。新しいラスタは、extenttype引数で定義される範囲になります。

expression

二つのラスタとPostgreSQL定義済み関数/演算子を含むPostgreSQL代数式です。関数と演算子は、二つのピクセルがインタセクトするピクセルの値を定めます。たとえば(([rast1] + [rast2])/2.0)::integerといったふうになります。

pixeltype

出力ラスタのピクセルタイプです。必ずST_BandPixelTypeに挙げられたものの一つになるか、省略されるか、NULLに設定されます。引数として渡されないかNULLが渡された場合には、一つ目のラスタのピクセルタイプになります。

extenttype

新しいラスタの範囲を制御します。

INTERSECTION - 新しいラスタの範囲は二つのラスタのインタセクトした領域です。これがデフォルトです。

UNION - 新しいラスタの範囲は二つのラスタの結合です。

FIRST - 新しいラスタの範囲は一つ目のラスタと同じです。

SECOND - 新しいラスタの範囲は二つ目のラスタと同じです。

nodata1expr

rast1がNODATA値で、特にrast2ピクセルに値がある時に、rast2だけを返すか返すべき値を定義する定数を含む代数式です。

nodata2expr

rast2がNODATA値で、特にrast2ピクセルに値がある時に、rast1だけを返すか返すべき値を定義する定数を含む代数式です。

nodatanodataval

rast1とrast2のピクセルの両方がNOADTA値になる場合に返すべき定数です。

pixeltypeが渡された場合には、新しいラスタは、指定されたピクセルタイプのバンドを持ちます。pixeltypeとしてNULLが渡されたりピクセルタイプを指定しない場合には、新しいラスタはrast1と同じピクセルタイプになります。

数式の中で使える語は、元バンドのピクセル値を参照する [rast1.val], [rast2.val]、1始まりの列/行インデクスを参照する[rast1.x], [rast1.y]などです。

Availability: 2.0.0

例: 2バンドの共有と結合

元のラスタから1バンドラスタを生成します。元のラスタバンドの値について2で割った余りが入ります。

-- ラスタの集合の生成 --
DROP TABLE IF EXISTS fun_shapes;
CREATE TABLE fun_shapes(rid serial PRIMARY KEY, fun_name text, rast raster);

-- 空間参照系をメートル単位のマサチューセッツ平面として、ボストンのまわりの形状を挿入 --\
INSERT INTO fun_shapes(fun_name, rast)
VALUES ('ref', ST_AsRaster(ST_MakeEnvelope(235229, 899970, 237229, 901930,26986),200,200,'8BUI',0,0));

INSERT INTO fun_shapes(fun_name,rast)
WITH ref(rast) AS (SELECT rast FROM fun_shapes WHERE fun_name = 'ref' )
SELECT 'area' AS fun_name, ST_AsRaster(ST_Buffer(ST_SetSRID(ST_Point(236229, 900930),26986), 1000),
            ref.rast,'8BUI', 10, 0) As rast
FROM ref
UNION ALL
SELECT 'rand bubbles',
            ST_AsRaster(
            (SELECT ST_Collect(geom)
    FROM (SELECT ST_Buffer(ST_SetSRID(ST_Point(236229 + i*random()*100, 900930 + j*random()*100),26986), random()*20) As geom
            FROM generate_series(1,10) As i, generate_series(1,10) As j
            ) As foo ), ref.rast,'8BUI', 200, 0)
FROM ref;

-- 共有と結合の生成 --
SELECT  ST_MapAlgebraExpr(
        area.rast, bub.rast, '[rast2.val]', '8BUI', 'INTERSECTION', '[rast2.val]', '[rast1.val]') As interrast,
        ST_MapAlgebraExpr(
            area.rast, bub.rast, '[rast2.val]', '8BUI', 'UNION', '[rast2.val]', '[rast1.val]') As unionrast
FROM
  (SELECT rast FROM fun_shapes WHERE
 fun_name = 'area') As area
CROSS JOIN  (SELECT rast
FROM fun_shapes WHERE
 fun_name = 'rand bubbles') As bub

インタセクションの場合

結合の場合

例: 別個のバンドとしてキャンバス上にラスタをオーバレイする

-- ST_AsPNGを使って1バンドで灰色に見える画像を作成します --
WITH mygeoms
    AS ( SELECT 2 As bnum, ST_Buffer(ST_Point(1,5),10) As geom
            UNION ALL
            SELECT 3 AS bnum,
                ST_Buffer(ST_GeomFromText('LINESTRING(50 50,150 150,150 50)'), 10,'join=bevel') As geom
            UNION ALL
            SELECT 1 As bnum,
                ST_Buffer(ST_GeomFromText('LINESTRING(60 50,150 150,150 50)'), 5,'join=bevel') As geom
            ),
   -- ジオメトリと1対1に対応するキャンバスを定義
   canvas
    AS (SELECT ST_AddBand(ST_MakeEmptyRaster(200,
        200,
        ST_XMin(e)::integer, ST_YMax(e)::integer, 1, -1, 0, 0) , '8BUI'::text,0) As rast
        FROM (SELECT ST_Extent(geom) As e,
                    Max(ST_SRID(geom)) As srid
                    from mygeoms
                    ) As foo
            ),
   rbands AS (SELECT ARRAY(SELECT ST_MapAlgebraExpr(canvas.rast, ST_AsRaster(m.geom, canvas.rast, '8BUI', 100),
                 '[rast2.val]', '8BUI', 'FIRST', '[rast2.val]', '[rast1.val]') As rast
                FROM mygeoms AS m CROSS JOIN canvas
                ORDER BY m.bnum) As rasts
                )
          SELECT rasts[1] As rast1 , rasts[2] As rast2, rasts[3] As rast3, ST_AddBand(
                    ST_AddBand(rasts[1],rasts[2]), rasts[3]) As final_rast
            FROM rbands;

rast1

rast2

rast3

final_rast

例: 選択した区画の2メートル幅境界線を空中写真にオーバレイする

-- 前二つの切り取ったバンドと
-- 3番バンドにジオメトリをオーバレイしたバンドからなる
-- 3バンドのラスタを生成します
-- このクエリはWindows 64ビット版のPostGISで3.6秒かかりました
WITH pr AS
-- 演算の順序の注意: 全てのラスタを必要なピクセル範囲に切り抜いています
(SELECT ST_Clip(rast,ST_Expand(geom,50) ) As rast, g.geom
    FROM aerials.o_2_boston AS r INNER JOIN
-- 対象の区画を結合して、後でインタセクトできる単一ジオメトリを形成します。
        (SELECT ST_Union(ST_Transform(geom,26986)) AS geom
          FROM landparcels WHERE pid IN('0303890000', '0303900000')) As g
        ON ST_Intersects(rast::geometry, ST_Expand(g.geom,50))
),
-- ラスタの破片を結合します
-- ラスタのST_Unionは非常に遅いですがラスタを小さくすれば速度が上がります
-- 先に切り出しておいてから結合しているのはこのためです
prunion AS
(SELECT ST_AddBand(NULL, ARRAY[ST_Union(rast,1),ST_Union(rast,2),ST_Union(rast,3)] ) As clipped,geom
FROM pr
GROUP BY geom)
-- ラスタの破片を結合し、区画境界線のオーバレイも持った
-- 最終のラスタを返します
-- 最初の二つのバンドと3番バンド+ジオメトリの地図代数関数とを追加します
SELECT ST_AddBand(ST_Band(clipped,ARRAY[1,2])
    , ST_MapAlgebraExpr(ST_Band(clipped,3), ST_AsRaster(ST_Buffer(ST_Boundary(geom),2),clipped, '8BUI',250),
     '[rast2.val]', '8BUI', 'FIRST', '[rast2.val]', '[rast1.val]') ) As rast
FROM prunion;

青線が対象区画の境界です

関連情報

ST_MapAlgebraExpr, ST_AddBand, ST_AsPNG, ST_AsRaster, ST_MapAlgebraFct, ST_BandPixelType, ST_GeoReference, ST_Value, ST_Union, ST_Union

Name

ST_MapAlgebraFct — 1バンド版 - 入力バンドに対する妥当なPostgreSQL関数で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、1番と仮定します。

Synopsis

raster ST_MapAlgebraFct( | rast, |
| onerasteruserfunc); |

raster rast;
regprocedure onerasteruserfunc;

raster ST_MapAlgebraFct( | rast, |
| onerasteruserfunc, |
| VARIADIC args); |

raster rast;
regprocedure onerasteruserfunc;
text[] VARIADIC args;

raster ST_MapAlgebraFct( | rast, |
| pixeltype, |
| onerasteruserfunc); |

raster rast;
text pixeltype;
regprocedure onerasteruserfunc;

raster ST_MapAlgebraFct( | rast, |
| pixeltype, |
| onerasteruserfunc, |
| VARIADIC args); |

raster rast;
text pixeltype;
regprocedure onerasteruserfunc;
text[] VARIADIC args;

raster ST_MapAlgebraFct( | rast, |
| band, |
| onerasteruserfunc); |

raster rast;
integer band;
regprocedure onerasteruserfunc;

raster ST_MapAlgebraFct( | rast, |
| band, |
| onerasteruserfunc, |
| VARIADIC args); |

raster rast;
integer band;
regprocedure onerasteruserfunc;
text[] VARIADIC args;

raster ST_MapAlgebraFct( | rast, |
| band, |
| pixeltype, |
| onerasteruserfunc); |

raster rast;
integer band;
text pixeltype;
regprocedure onerasteruserfunc;

raster ST_MapAlgebraFct( | rast, |
| band, |
| pixeltype, |
| onerasteruserfunc, |
| VARIADIC args); |

raster rast;
integer band;
text pixeltype;
regprocedure onerasteruserfunc;
text[] VARIADIC args;

説明

Warning

ST_MapAlgebraFct は2.1.0で非推奨になりました。代わりにST_MapAlgebra (コールバック関数版)を使います。

入力ラスタ (rast)に対してonerasteruserfuncで指定される妥当なPostgreSQL関数で形成されたラスタを返します。生成されるラスタは指定したピクセルタイプとなる1バンドラスタです。bandを指定しない場合には、1番と仮定します。新しいラスタは、元のラスタと同じ地理参照、幅、高さを持ちますが、一つのバンドしか持ちません。

pixeltypeが渡された場合には、新しいラスタのバンドは、そのピクセルタイプになります。pixeltypeにNULLが渡された場合には、新しいラスタは入力rastのバンドのピクセルタイプと同じになります。

onerasteruserfunc引数は SQL関数またはPL/pgSQL関数のシグネチャで、regprocedureにキャストします。大変単純で本当に使えないPL/pgSQL関数の例を挙げます。

CREATE OR REPLACE FUNCTION simple_function(pixel FLOAT, pos INTEGER[], VARIADIC args TEXT[])
    RETURNS FLOAT
    AS $$ BEGIN
        RETURN 0.0;
    END; $$
    LANGUAGE 'plpgsql' IMMUTABLE;

userfunctionは、2または3の引数を受け付けます。すなわち、float8値、任意の整数配列、VARIADIC文字列配列です。第1引数はラスタセルごとの値です (ラスタのデータ型に関係なく)。第2引数は現在の処理セルの位置で、'{x,y}'であらわされます。第3引数は、ST_MapAlgebraFctへのパラメータの残っているもの全てがuserfunctionに渡されることを示します。

regprodedure引数をSQL関数に渡す際は完全な関数シグネチャとregprocedure型へのキャストが求められます。 上のPL/pgSQL関数を引数に取るには、引数のSQLは次のようにします。

'simple_function(float,integer[],text[])'::regprocedure

引数は関数名と引数の型を含み、関数名と引数を引用符で括り、かつregprocedureにキャストする点に注意が必要です。

userfunctionの第3引数はvariadic text配列です。どのST_MapAlgebraFctにもついてくる全ての文字列引数は、指定されたuserfunctionに、そのまま渡されて、args引数内に入ります。

Note

VARIADICキーワードに関する詳細情報については、PostgreSQL文書とQuery Language (SQL) Functions (訳注: 日本語版は「問い合わせ言語 （SQL）関数」です)の"SQL Functions with Variable Numbers of Arguments" (訳注: 日本語版は「可変長引数を取るSQL関数」)節を参照して下さい。

Note

userfunctionへのtext[]引数は、あらゆる引数を処理のためにユーザ関数に渡すかどうかの選択にかかわらず求められます。

Availability: 2.0.0

例

元のラスタから1バンドラスタを生成します。元のラスタバンドの値について2で割った余りが入ります。

ALTER TABLE dummy_rast ADD COLUMN map_rast raster;
CREATE FUNCTION mod_fct(pixel float, pos integer[], variadic args text[])
RETURNS float
AS $$
BEGIN
    RETURN pixel::integer % 2;
END;
$$
LANGUAGE 'plpgsql' IMMUTABLE;

UPDATE dummy_rast SET map_rast = ST_MapAlgebraFct(rast,NULL,'mod_fct(float,integer[],text[])'::regprocedure) WHERE rid = 2;

SELECT ST_Value(rast,1,i,j) As origval, ST_Value(map_rast, 1, i, j) As mapval
FROM dummy_rast CROSS JOIN generate_series(1, 3) AS i CROSS JOIN generate_series(1,3) AS j
WHERE rid = 2;

 origval | mapval
---------+--------
     253 |      1
     254 |      0
     253 |      1
     253 |      1
     254 |      0
     254 |      0
     250 |      0
     254 |      0
     254 |      0

ピクセルタイプが2BUIの1バンドラスタを生成します。元のラスタに対して再分類を行った値が入り、NODATA値をユーザ関数に渡される引数の値 (0)に設定します。

ALTER TABLE dummy_rast ADD COLUMN map_rast2 raster;
CREATE FUNCTION classify_fct(pixel float, pos integer[], variadic args text[])
RETURNS float
AS
$$
DECLARE
    nodata float := 0;
BEGIN
    IF NOT args[1] IS NULL THEN
        nodata := args[1];
    END IF;
    IF pixel < 251 THEN
        RETURN 1;
    ELSIF pixel = 252 THEN
        RETURN 2;
    ELSIF pixel > 252 THEN
        RETURN 3;
    ELSE
        RETURN nodata;
    END IF;
END;
$$
LANGUAGE 'plpgsql';
UPDATE dummy_rast SET map_rast2 = ST_MapAlgebraFct(rast,'2BUI','classify_fct(float,integer[],text[])'::regprocedure, '0') WHERE rid = 2;

SELECT DISTINCT ST_Value(rast,1,i,j) As origval, ST_Value(map_rast2, 1, i, j) As mapval
FROM dummy_rast CROSS JOIN generate_series(1, 5) AS i CROSS JOIN generate_series(1,5) AS j
WHERE rid = 2;

 origval | mapval
---------+--------
     249 |      1
     250 |      1
     251 |
     252 |      2
     253 |      3
     254 |      3

SELECT ST_BandPixelType(map_rast2) As b1pixtyp
FROM dummy_rast WHERE rid = 2;

 b1pixtyp
----------
 2BUI

元のラスタ (rast_viewカラム)

rast_view_ma

新しいバンドを三つ持つラスタを生成します。元のバンドを三つ持つラスタと同じピクセルタイプです。1番バンドは地図代数関数によって変更され、残りの二つのバンドは値が代わりません。

CREATE FUNCTION rast_plus_tan(pixel float, pos integer[], variadic args text[])
RETURNS float
AS
$$
BEGIN
    RETURN tan(pixel) * pixel;
END;
$$
LANGUAGE 'plpgsql';

SELECT ST_AddBand(
    ST_AddBand(
        ST_AddBand(
            ST_MakeEmptyRaster(rast_view),
            ST_MapAlgebraFct(rast_view,1,NULL,'rast_plus_tan(float,integer[],text[])'::regprocedure)
        ),
        ST_Band(rast_view,2)
    ),
    ST_Band(rast_view, 3) As rast_view_ma
)
FROM wind
WHERE rid=167;

関連情報

ST_MapAlgebraExpr, ST_BandPixelType, ST_GeoReference, ST_SetValue

Name

ST_MapAlgebraFct — 2バンド版 - 二つの入力バンドに対する妥当なPostgreSQL関数で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、1番と仮定します。"extenttype"のデフォルトはINTERSECTIONです。

Synopsis

raster ST_MapAlgebraFct( | rast1, |
| rast2, |
| tworastuserfunc, |
| pixeltype=same_as_rast1, |
| extenttype=INTERSECTION, |
| VARIADIC userargs); |

raster rast1;
raster rast2;
regprocedure tworastuserfunc;
text pixeltype=same_as_rast1;
text extenttype=INTERSECTION;
text[] VARIADIC userargs;

raster ST_MapAlgebraFct( | rast1, |
| band1, |
| rast2, |
| band2, |
| tworastuserfunc, |
| pixeltype=same_as_rast1, |
| extenttype=INTERSECTION, |
| VARIADIC userargs); |

raster rast1;
integer band1;
raster rast2;
integer band2;
regprocedure tworastuserfunc;
text pixeltype=same_as_rast1;
text extenttype=INTERSECTION;
text[] VARIADIC userargs;

説明

Warning

ST_MapAlgebraFct は2.1.0で非推奨になりました。代わりにST_MapAlgebra (コールバック関数版)を使います。

二つの入力ラスタ (rast1, rast2)に対してtworastuserfuncで指定される妥当なPostgreSQL関数で形成されるラスタを返します。band1またはband2が指定されていない場合には、1番と仮定します。新しいラスタは、元のラスタと同じ地理参照、幅、高さを持ちますが、一つのバンドしか持ちません。

pixeltypeが渡された場合には、新しいラスタはそのピクセルタイプのバンドを持ちます。pixelteypeとしてNULLが渡されたりピクセルタイプを指定しない場合には、新しいラスタはrast1の入力バンドと同じピクセルタイプになります。

tworastuserfunc引数はSQL関数またはPL/pgSQL関数のシグネチャで、regprocedureにキャストします。大変単純で本当に使えないPL/pgSQL関数の例を挙げます。

CREATE OR REPLACE FUNCTION simple_function_for_two_rasters(pixel1 FLOAT, pixel2 FLOAT, pos INTEGER[], VARIADIC args TEXT[])
    RETURNS FLOAT
    AS $$ BEGIN
        RETURN 0.0;
    END; $$
    LANGUAGE 'plpgsql' IMMUTABLE;

tworastuserfuncは、3または4の引数を受け付けます。すなわち、倍精度浮動小数点数、倍精度浮動小数点数、任意の整数配列、VARIADIC文字列配列です。第1引数はrast1のラスタセルごとの値です (ラスタのデータ型に関係なく)。第2引数はrast2のラスタセルごとの値です。第3引数は現在の処理セルの位置で、'{x,y}'であらわされます。第4引数は、ST_MapAlgebraFctへのパラメータの残っているもの全てがtworastuserfuncに渡されることを示します。

regprodedure引数をSQL関数に渡す際は完全な関数シグネチャとregprocedure型へのキャストが求められます。上のPL/pgSQL関数を引数に取るには、引数のSQLは次のようにします。

'simple_function(double precision, double precision, integer[], text[])'::regprocedure

引数は関数名と引数の型を含み、関数名と引数を引用符で括り、かつregprocedureにキャストする点に注意が必要です。

tworastuserfunc引数は variadic text配列です。どのST_MapAlgebraFctにもついてくる全ての文字列引数は、指定されたtworastuserfuncに、そのまま渡されて、userargs引数内に入ります。

Note

VARIADICキーワードに関する詳細情報については、PostgreSQL文書とQuery Language (SQL) Functions (訳注: 日本語版は「問い合わせ言語 （SQL）関数」です)の"SQL Functions with Variable Numbers of Arguments" (訳注: 日本語版は「可変長引数を取るSQL関数」)節を参照して下さい。

Note

tworastuserfuncへのtext[]引数は、あらゆる引数を処理のためにユーザ関数に渡すかどうかの選択にかかわらず求められます。

Availability: 2.0.0

例: 別個のバンドとしてキャンバス上にラスタをオーバレイする

-- ユーザ関数の定義 --
CREATE OR REPLACE FUNCTION raster_mapalgebra_union(
    rast1 double precision,
    rast2 double precision,
    pos integer[],
    VARIADIC userargs text[]
)
    RETURNS double precision
    AS $$
    DECLARE
    BEGIN
        CASE
            WHEN rast1 IS NOT NULL AND rast2 IS NOT NULL THEN
                RETURN ((rast1 + rast2)/2.);
            WHEN rast1 IS NULL AND rast2 IS NULL THEN
                RETURN NULL;
            WHEN rast1 IS NULL THEN
                RETURN rast2;
            ELSE
                RETURN rast1;
        END CASE;

        RETURN NULL;
    END;
    $$ LANGUAGE 'plpgsql' IMMUTABLE COST 1000;

-- ラスタの試験テーブルの用意
DROP TABLE IF EXISTS map_shapes;
CREATE TABLE map_shapes(rid serial PRIMARY KEY, rast raster, bnum integer, descrip text);
INSERT INTO map_shapes(rast,bnum, descrip)
WITH mygeoms
    AS ( SELECT 2 As bnum, ST_Buffer(ST_Point(90,90),30) As geom, 'circle' As descrip
            UNION ALL
            SELECT 3 AS bnum,
                ST_Buffer(ST_GeomFromText('LINESTRING(50 50,150 150,150 50)'), 15) As geom, 'big road' As descrip
            UNION ALL
            SELECT 1 As bnum,
                ST_Translate(ST_Buffer(ST_GeomFromText('LINESTRING(60 50,150 150,150 50)'), 8,'join=bevel'), 10,-6) As geom, 'small road' As descrip
            ),
   -- ジオメトリと1対1に対応するキャンバスを定義
   canvas
    AS ( SELECT ST_AddBand(ST_MakeEmptyRaster(250,
        250,
        ST_XMin(e)::integer, ST_YMax(e)::integer, 1, -1, 0, 0 ) , '8BUI'::text,0) As rast
        FROM (SELECT ST_Extent(geom) As e,
                    Max(ST_SRID(geom)) As srid
                    from mygeoms
                    ) As foo
            )
-- キャンバスとアラインメントの合ったラスタを返します
SELECT ST_AsRaster(m.geom, canvas.rast, '8BUI', 240) As rast, bnum, descrip
                FROM mygeoms AS m CROSS JOIN canvas
UNION ALL
SELECT canvas.rast, 4, 'canvas'
FROM canvas;

-- 1バンド版の地図代数関数を実行し、あとでST_AddBandで集めます
INSERT INTO map_shapes(rast,bnum,descrip)
SELECT ST_AddBand(ST_AddBand(rasts[1], rasts[2]),rasts[3]), 4, 'map bands overlay fct union (canvas)'
    FROM (SELECT ARRAY(SELECT ST_MapAlgebraFct(m1.rast, m2.rast,
            'raster_mapalgebra_union(double precision, double precision, integer[], text[])'::regprocedure, '8BUI', 'FIRST')
                FROM map_shapes As m1 CROSS JOIN map_shapes As m2
    WHERE m1.descrip = 'canvas' AND m2.descrip <> 'canvas' ORDER BY m2.bnum) As rasts) As foo;

バンドオーバレイ (キャンバス)の図 (赤:小さい道 緑:円、青:大きな道)

追加引数を取るユーザ定義関数

CREATE OR REPLACE FUNCTION raster_mapalgebra_userargs(
    rast1 double precision,
    rast2 double precision,
    pos integer[],
    VARIADIC userargs text[]
)
    RETURNS double precision
    AS $$
    DECLARE
    BEGIN
        CASE
            WHEN rast1 IS NOT NULL AND rast2 IS NOT NULL THEN
                RETURN least(userargs[1]::integer,(rast1 + rast2)/2.);
            WHEN rast1 IS NULL AND rast2 IS NULL THEN
                RETURN userargs[2]::integer;
            WHEN rast1 IS NULL THEN
                RETURN greatest(rast2,random()*userargs[3]::integer)::integer;
            ELSE
                RETURN greatest(rast1, random()*userargs[4]::integer)::integer;
        END CASE;

        RETURN NULL;
    END;
    $$ LANGUAGE 'plpgsql' VOLATILE COST 1000;

SELECT ST_MapAlgebraFct(m1.rast, 1, m1.rast, 3,
            'raster_mapalgebra_userargs(double precision, double precision, integer[], text[])'::regprocedure,
                '8BUI', 'INTERSECT', '100','200','200','0')
                FROM map_shapes As m1
    WHERE m1.descrip = 'map bands overlay fct union (canvas)';

追加引数を持つユーザ定義関数と同じラスタからの異なるバンド

関連情報

ST_MapAlgebraExpr, ST_BandPixelType, ST_GeoReference, ST_SetValue

Name

ST_MapAlgebraFctNgb — 1バンド版: ユーザ定義PostgreSQL関数を使用する最近傍地図代数関数です。入力ラスタバンドの近傍の値を与えたPL/pgSQLユーザ定義関数の結果からなるラスタを返します。

Synopsis

raster ST_MapAlgebraFctNgb( | rast, |
| band, |
| pixeltype, |
| ngbwidth, |
| ngbheight, |
| onerastngbuserfunc, |
| nodatamode, |
| VARIADIC args); |

raster rast;
integer band;
text pixeltype;
integer ngbwidth;
integer ngbheight;
regprocedure onerastngbuserfunc;
text nodatamode;
text[] VARIADIC args;

説明

Warning

ST_MapAlgebraFctNgb は2.1.0で非推奨になりました。代わりにST_MapAlgebra (コールバック関数版)を使います。

(1バンド版) 入力ラスタバンドの近傍の値を与えたPL/pgSQLユーザ定義関数の結果からなるラスタを返します。ユーザ定義関数は近傍のピクセル値を数の配列として取り、ピクセル毎に、ユーザ定義関数からの結果を返し、現在の対象ピクセルのピクセル値を関数の返り値に置き換えます。

rast

ユーザ定義関数が評価されるラスタです。

band

評価されるラスタのバンド番号です。デフォルトは1です。

pixeltype

出力ラスタのピクセルタイプです。ST_BandPixelTypeの一覧にあるものか、指定しないか、NULLを指定します。指定しないかNULLを指定した場合には、rastのピクセルタイプがデフォルトになります。結果ピクセル値がピクセルタイプが許容する範囲を超える場合には、切り詰められます。

ngbwidth

セル単位の近傍の幅です。

ngbheight

セル単位の近傍の高さです。

onerastngbuserfunc

ラスタの単一バンドの近傍ピクセルに適用されるPL/pgSQLユーザ定義関数です。一つ目の要素は、近傍ピクセルの四角形を表現する数値の2次元配列です。

nodatamode

NODATAまたはNULLとなる近傍ピクセルにおける関数に渡す値を定義します。

'ignore': 近傍で遭遇したNODATA値全てが計算から除外されます。ユーザ定義関数に必ず送られ、ユーザ定義関数が対処方法を決定します。

'NULL': 近傍で遭遇したNODATA値全てが結果をNULLとします。この場合はユーザ定義関数が呼び出されません。

'value': 近傍で遭遇したNODATA値全てが参照ピクセル (近傍の中心にあるピクセル)の値に置き換えられます。この値がNODATAになった場合には、'NULL'と同じ挙動を取ります (影響のある近傍について)。

args

ユーザ定義関数に渡される引数です。

Availability: 2.0.0

例

単一タイルとしてロードされたカトリーナのラスタを使った例です。http://trac.osgeo.org/gdal/wiki/frmts_wtkraster.htmlに説明があります。また、ST_Rescaleの例で準備を行っています。

--
-- 近傍の値の全てに関する平均を計算する、単純なユーザ定義の「コールバック」関数
--
CREATE OR REPLACE FUNCTION rast_avg(matrix float[][], nodatamode text, variadic args text[])
    RETURNS float AS
    $$
    DECLARE
        _matrix float[][];
        x1 integer;
        x2 integer;
        y1 integer;
        y2 integer;
        sum float;
    BEGIN
        _matrix := matrix;
        sum := 0;
        FOR x in array_lower(matrix, 1)..array_upper(matrix, 1) LOOP
            FOR y in array_lower(matrix, 2)..array_upper(matrix, 2) LOOP
                sum := sum + _matrix[x][y];
            END LOOP;
        END LOOP;
        RETURN (sum*1.0/(array_upper(matrix,1)*array_upper(matrix,2) ))::integer ;
    END;
    $$
LANGUAGE 'plpgsql' IMMUTABLE COST 1000;

-- ラスタに対してX,Y軸でそれぞれ2ピクセル内の平均を計算するようにしています --
SELECT ST_MapAlgebraFctNgb(rast, 1,  '8BUI', 4,4,
        'rast_avg(float[][], text, text[])'::regprocedure, 'NULL', NULL) As nn_with_border
    FROM katrinas_rescaled
    limit 1;

ラスタの1番バンド

ピクセル毎に4x4ピクセル内のピクセル平均を計算したラスタ

関連情報

ST_MapAlgebraFct, ST_MapAlgebraExpr, ST_Rescale

Name

ST_Reclass — 元のラスタから再分類したバンドタイプからなるラスタを生成します。nbandは変更するバンドです。nbandが指定されていない場合には、1と仮定します。他の全てのバンドは変更せずに返します。可視画像の書式としてより単純な描画を行うために、16BUIバンドを8BUIバンドに変換する、等のために使います。

Synopsis

raster ST_Reclass( | rast, |
| nband, |
| reclassexpr, |
| pixeltype, |
| nodataval=NULL); |

raster rast;
integer nband;
text reclassexpr;
text pixeltype;
double precision nodataval=NULL;

raster ST_Reclass( | rast, |
| VARIADIC reclassargset); |

raster rast;
reclassarg[] VARIADIC reclassargset;

raster ST_Reclass( | rast, |
| reclassexpr, |
| pixeltype); |

raster rast;
text reclassexpr;
text pixeltype;

説明

入力ラスタ (rast)にreclassexprで定義する妥当なPostgreSQL代数演算子を適用して新しいラスタを生成します。bandが指定されていない場合には、1番と仮定します。新しいラスタは、元のラスタと同じ地理参照、幅、高さを持ちます。指示されていないバンドは変更せずに返ります。妥当な再分類の数式の説明についてはreclassargを参照して下さい。

新しいラスタのバンドはpixeltypeで指定するピクセルタイプになります。reclassargsetを渡した場合は、個々のreclassargが生成されるバンド毎の挙動を定義します。

Availability: 2.0.0

基本的な例

元ラスタから新しいラスタを生成しますが、2番バンドを8BUIから4BUIに変換して、101-254をNODATA値にします。

ALTER TABLE dummy_rast ADD COLUMN reclass_rast raster;
UPDATE dummy_rast SET reclass_rast = ST_Reclass(rast,2,'0-87:1-10, 88-100:11-15, 101-254:0-0', '4BUI',0) WHERE rid = 2;

SELECT i as col, j as row, ST_Value(rast,2,i,j) As origval,
    ST_Value(reclass_rast, 2, i, j) As reclassval,
    ST_Value(reclass_rast, 2, i, j, false) As reclassval_include_nodata
FROM dummy_rast CROSS JOIN generate_series(1, 3) AS i CROSS JOIN generate_series(1,3) AS j
WHERE rid = 2;

 col | row | origval | reclassval | reclassval_include_nodata
-----+-----+---------+------------+---------------------------
   1 |   1 |      78 |          9 |                         9
   2 |   1 |      98 |         14 |                        14
   3 |   1 |     122 |            |                         0
   1 |   2 |      96 |         14 |                        14
   2 |   2 |     118 |            |                         0
   3 |   2 |     180 |            |                         0
   1 |   3 |      99 |         15 |                        15
   2 |   3 |     112 |            |                         0
   3 |   3 |     169 |            |                         0

例: 複数の再分類を使った高度な例

元ラスタから新しいラスタを生成しますが、1番、2番、3番バンドを1BB, 4BUI, 4BUIにそれぞれ変換して再分類します。再分類の識別番号 (理論的には元ラスタと同数のバンド)を入力するために取るVARIADIC reclassarg 引数を使っています。

UPDATE dummy_rast SET reclass_rast =
    ST_Reclass(rast,
        ROW(2,'0-87]:1-10, (87-100]:11-15, (101-254]:0-0', '4BUI',NULL)::reclassarg,
        ROW(1,'0-253]:1, 254:0', '1BB', NULL)::reclassarg,
        ROW(3,'0-70]:1, (70-86:2, [86-150):3, [150-255:4', '4BUI', NULL)::reclassarg
        ) WHERE rid = 2;

SELECT i as col, j as row,ST_Value(rast,1,i,j) As ov1,  ST_Value(reclass_rast, 1, i, j) As rv1,
    ST_Value(rast,2,i,j) As ov2, ST_Value(reclass_rast, 2, i, j) As rv2,
    ST_Value(rast,3,i,j) As ov3, ST_Value(reclass_rast, 3, i, j) As rv3
FROM dummy_rast CROSS JOIN generate_series(1, 3) AS i CROSS JOIN generate_series(1,3) AS j
WHERE rid = 2;

col | row | ov1 | rv1 | ov2 | rv2 | ov3 | rv3
----+-----+-----+-----+-----+-----+-----+-----
  1 |   1 | 253 |   1 |  78 |   9 |  70 |   1
  2 |   1 | 254 |   0 |  98 |  14 |  86 |   3
  3 |   1 | 253 |   1 | 122 |   0 | 100 |   3
  1 |   2 | 253 |   1 |  96 |  14 |  80 |   2
  2 |   2 | 254 |   0 | 118 |   0 | 108 |   3
  3 |   2 | 254 |   0 | 180 |   0 | 162 |   4
  1 |   3 | 250 |   1 |  99 |  15 |  90 |   3
  2 |   3 | 254 |   0 | 112 |   0 | 108 |   3
  3 |   3 | 254 |   0 | 169 |   0 | 175 |   4

例: 単一バンドで32BFのラスタをの可視ラスタへの高度な対応付け

32BFバンドを一つ持つだけのラスタから三つのバンド (8BUI, 8BUI, 8BUI可視ラスタ)を生成します。

ALTER TABLE wind ADD COLUMN rast_view raster;
UPDATE wind
    set rast_view = ST_AddBand( NULL,
        ARRAY[
    ST_Reclass(rast, 1,'0.1-10]:1-10,9-10]:11,(11-33:0'::text, '8BUI'::text,0),
    ST_Reclass(rast,1, '11-33):0-255,[0-32:0,(34-1000:0'::text, '8BUI'::text,0),
    ST_Reclass(rast,1,'0-32]:0,(32-100:100-255'::text, '8BUI'::text,0)
    ]
    );

関連情報

ST_AddBand, ST_Band, ST_BandPixelType, ST_MakeEmptyRaster, reclassarg, ST_Value

Name

ST_Union — ラスタタイルの集合を結合して1以上のバンドからなる単一ラスタを返します。

Synopsis

raster ST_Union(
rast);

setof raster rast;

raster ST_Union( | rast, |
| unionargset); |

setof raster rast;
unionarg[] unionargset;

raster ST_Union( | rast, |
| nband); |

setof raster rast;
integer nband;

raster ST_Union( | rast, |
| uniontype); |

setof raster rast;
text uniontype;

raster ST_Union( | rast, |
| nband, |
| uniontype); |

setof raster rast;
integer nband;
text uniontype;

説明

ラスタタイルの集合を結合して少なくとも一つのバンドからなる単一ラスタを返します。結果ラスタの範囲は集合全体の範囲です。インタセクトする場合には、結果値は、LAST (デフォルト), FIRST, MIN, MAX, COUNT, SUM, MEAN, RANGEのいずれかとなるuniontypeで定義されます。

Note

ラスタを結合するには、全てが同じアラインメントを持たなくてはなりません。ST_SameAlignmentとST_NotSameAlignmentReasonで詳細情報や助けとなる情報が得られます。アラインメント問題を修正する一つの方法として、ST_Resampleを使い、アラインメントの同じ参照ラスタを使います。

Availability: 2.0.0

Enhanced: 2.1.0 速度が改善されました (完全にC言語で記述しました)。

Availability: 2.1.0 ST_Union(rast, unionarg)の形式が導入されました。

Enhanced: 2.1.0 ST_Union(rast) (一つ目の形式)で、全ての入力ラスタの全てのバンドを結合するようになりました。以前の版のPostGISでは、一つ目のバンドと仮定していました。

Enhanced: 2.1.0 ST_Union(rast, uniontype) (四つ目の形式)で、全ての入力ラスタの全てのバンドを結合するようになりました。

例: 塊になっているラスタタイルの単一バンドへの再構成

-- ファイルシステムタイルの1番バンドから新しい単一バンドを生成します
SELECT filename, ST_Union(rast,1) As file_rast
FROM sometable WHERE filename IN('dem01', 'dem02') GROUP BY filename;

例: タイルのジオメトリとインタセクトするタイルを結合した複数バンドのラスタ

-- ラインとインタセクトするタイルを結合した複数バンドラスタを生成します
-- ご注意: 2.0では、単一バンドのラスタを帰すだけです
--   これはunionargで  ARRAY[ROW(1, 'LAST'), ROW(2, 'LAST'), ROW(3, 'LAST')]::unionarg[]
--   を指定するのと同じです。
SELECT ST_Union(rast)
FROM aerials.boston
WHERE ST_Intersects(rast,  ST_GeomFromText('LINESTRING(230486 887771, 230500 88772)',26986) );

例: タイルのジオメトリとインタセクトするタイルを結合した複数バンドのラスタ

バンドの部分集合が欲しいだけの場合や、バンドの並び順を変更したい場合には、より長い書き方にします。

-- ラインとインタセクトするタイルを結合した複数バンドラスタを生成します
SELECT ST_Union(rast,ARRAY[ROW(2, 'LAST'), ROW(1, 'LAST'), ROW(3, 'LAST')]::unionarg[])
FROM aerials.boston
WHERE ST_Intersects(rast,  ST_GeomFromText('LINESTRING(230486 887771, 230500 88772)',26986) );

関連情報

unionarg, ST_Envelope, ST_ConvexHull, ST_Clip, ST_Union

組み込み地図代数コールバック関数

Name

ST_Distinct4ma — 近隣のピクセル値のうち一意となるものを数えるラスタ処理関数です。

Synopsis

float8 ST_Distinct4ma( | matrix, |
| nodatamode, |
| VARIADIC args); |

float8[][] matrix;
text nodatamode;
text[] VARIADIC args;

double precision ST_Distinct4ma( | value, |
| pos, |
| VARIADIC userargs); |

double precision[][][] value;
integer[][] pos;
text[] VARIADIC userargs;

説明

近隣のピクセル値のうち一意となるものを数えます。

Note

一つ目の形式は、ST_MapAlgebraFctNgbへのコールバック引数として使用する専用コールバック関数です。

Note

二つ目の形式は、ST_MapAlgebra (コールバック関数版)へのコールバック引数として使用する専用コールバック関数です。

Warning

一つ目の形式は、ST_MapAlgebraFctNgbが2.1.0で非推奨となったので、使用しないようになります。

Availability: 2.0.0

Enhanced: 2.1.0 二つ目の形式の追加

例

SELECT
    rid,
    st_value(
        st_mapalgebrafctngb(rast, 1, NULL, 1, 1, 'st_distinct4ma(float[][],text,text[])'::regprocedure, 'ignore', NULL), 2, 2
    )
FROM dummy_rast
WHERE rid = 2;
 rid | st_value
-----+----------
   2 |        3
(1 row)

関連情報

ST_MapAlgebraFctNgb, ST_MapAlgebra (コールバック関数版), ST_Min4ma, ST_Max4ma, ST_Sum4ma, ST_Mean4ma, ST_Distinct4ma, ST_StdDev4ma

Name

ST_InvDistWeight4ma — 近隣のピクセル値の内挿補間を行うラスタ処理関数です。

Synopsis

double precision ST_InvDistWeight4ma( | value, |
| pos, |
| VARIADIC userargs); |

double precision[][][] value;
integer[][] pos;
text[] VARIADIC userargs;

説明

近隣のピクセル値の逆距離加重法 (IDW=Inverse Distance Weighted method)による内挿補間を行います。

userargsに渡される、二つの任意引数があります。一つ目は、逆距離加重法の式に与える0から1の間を取る冪数 (下の式の変数k)です。指定しない場合には、デフォルトは1とします。二つ目は、対象ピクセルの値が近隣セルからの補間値に含まれている場合にのみ適用される重み率です。指定せず、かつ対象ピクセルが値を持っている場合には、そのピクセルの持つ値が返されます。

基本的な逆距離加重法の方程式は次の通りです。

k = 冪数で、0から1の浮動小数点数を取ります。

Note

この関数はST_MapAlgebra (コールバック関数版)へのコールバック引数として使用する専用コールバック関数です。

Availability: 2.1.0

例

-- 例が必要

関連情報

ST_MapAlgebra (コールバック関数版), ST_MinDist4ma

Name

ST_Max4ma — 近隣のピクセル値の最大値を計算するラスタ処理関数です。

Synopsis

float8 ST_Max4ma( | matrix, |
| nodatamode, |
| VARIADIC args); |

float8[][] matrix;
text nodatamode;
text[] VARIADIC args;

double precision ST_Max4ma( | value, |
| pos, |
| VARIADIC userargs); |

double precision[][][] value;
integer[][] pos;
text[] VARIADIC userargs;

説明

近隣のピクセル値の最大値を計算します。

二つ目の形式では、userargsに渡す値でNODATAピクセルに代入する値を指定できます。

Note

一つ目の形式は、ST_MapAlgebraFctNgbへのコールバック引数として使用する専用コールバック関数です。

Note

二つ目の形式は、ST_MapAlgebra (コールバック関数版)へのコールバック引数として使用する専用コールバック関数です。

Warning

一つ目の形式は、ST_MapAlgebraFctNgbが2.1.0で非推奨となったので、使用しないようになります。

Availability: 2.0.0

Enhanced: 2.1.0 二つ目の形式の追加

例

SELECT
    rid,
    st_value(
        st_mapalgebrafctngb(rast, 1, NULL, 1, 1, 'st_max4ma(float[][],text,text[])'::regprocedure, 'ignore', NULL), 2, 2
    )
FROM dummy_rast
WHERE rid = 2;
 rid | st_value
-----+----------
   2 |      254
(1 row)

関連情報

ST_MapAlgebraFctNgb, ST_MapAlgebra (コールバック関数版), ST_Min4ma, ST_Sum4ma, ST_Mean4ma, ST_Range4ma, ST_Distinct4ma, ST_StdDev4ma

Name

ST_Mean4ma — 近隣のピクセル値の平均値を計算するラスタ処理関数です。

Synopsis

float8 ST_Mean4ma( | matrix, |
| nodatamode, |
| VARIADIC args); |

float8[][] matrix;
text nodatamode;
text[] VARIADIC args;

double precision ST_Mean4ma( | value, |
| pos, |
| VARIADIC userargs); |

double precision[][][] value;
integer[][] pos;
text[] VARIADIC userargs;

説明

近隣のピクセル値の平均値を計算します。

二つ目の形式では、userargsに渡す値でNODATAピクセルに代入する値を指定できます。

Note

一つ目の形式は、ST_MapAlgebraFctNgbへのコールバック引数として使用する専用コールバック関数です。

Note

二つ目の形式は、ST_MapAlgebra (コールバック関数版)へのコールバック引数として使用する専用コールバック関数です。

Warning

一つ目の形式は、ST_MapAlgebraFctNgbが2.1.0で非推奨となったので、使用しないようになります。

Availability: 2.0.0

Enhanced: 2.1.0 二つ目の形式の追加

例: 一つ目の形式

SELECT
    rid,
    st_value(
        st_mapalgebrafctngb(rast, 1, '32BF', 1, 1, 'st_mean4ma(float[][],text,text[])'::regprocedure, 'ignore', NULL), 2, 2
    )
FROM dummy_rast
WHERE rid = 2;
 rid |     st_value
-----+------------------
   2 | 253.222229003906
(1 row)

例: 二つ目の形式

SELECT
    rid,
    st_value(
              ST_MapAlgebra(rast, 1, 'st_mean4ma(double precision[][][], integer[][], text[])'::regprocedure,'32BF', 'FIRST', NULL, 1, 1)
       ,  2, 2)
  FROM dummy_rast
   WHERE rid = 2;
 rid |     st_value
-----+------------------
   2 | 253.222229003906
(1 row)

関連情報

ST_MapAlgebraFctNgb, ST_MapAlgebra (コールバック関数版), ST_Min4ma, ST_Max4ma, ST_Sum4ma, ST_Range4ma, ST_StdDev4ma

Name

ST_Min4ma — 近隣のピクセル値の最小値を計算するラスタ処理関数です。

Synopsis

float8 ST_Min4ma( | matrix, |
| nodatamode, |
| VARIADIC args); |

float8[][] matrix;
text nodatamode;
text[] VARIADIC args;

double precision ST_Min4ma( | value, |
| pos, |
| VARIADIC userargs); |

double precision[][][] value;
integer[][] pos;
text[] VARIADIC userargs;

説明

近隣のピクセル値の最小値を計算します。

二つ目の形式では、userargsに渡す値でNODATAピクセルに代入する値を指定できます。

Note

一つ目の形式は、ST_MapAlgebraFctNgbへのコールバック引数として使用する専用コールバック関数です。

Note

二つ目の形式は、ST_MapAlgebra (コールバック関数版)へのコールバック引数として使用する専用コールバック関数です。

Warning

一つ目の形式は、ST_MapAlgebraFctNgbが2.1.0で非推奨となったので、使用しないようになります。

Availability: 2.0.0

Enhanced: 2.1.0 二つ目の形式の追加

例

SELECT
    rid,
    st_value(
        st_mapalgebrafctngb(rast, 1, NULL, 1, 1, 'st_min4ma(float[][],text,text[])'::regprocedure, 'ignore', NULL), 2, 2
    )
FROM dummy_rast
WHERE rid = 2;
 rid | st_value
-----+----------
   2 |      250
(1 row)

関連情報

ST_MapAlgebraFctNgb, ST_MapAlgebra (コールバック関数版), ST_Max4ma, ST_Sum4ma, ST_Mean4ma, ST_Range4ma, ST_Distinct4ma, ST_StdDev4ma

Name

ST_MinDist4ma — 対象ピクセルと値を持つ近隣ピクセルとの最短距離をピクセル単位で返すラスタ処理関数です。

Synopsis

double precision ST_MinDist4ma( | value, |
| pos, |
| VARIADIC userargs); |

double precision[][][] value;
integer[][] pos;
text[] VARIADIC userargs;

説明

対象ピクセルと値を持つ近隣ピクセルとの最短距離をピクセル単位で返します。

Note

この関数の意図は、ST_InvDistWeight4maから対象ピクセルの内挿補間された値の有用性を判断することを補助するのに有益なデータポイントを提供することです。この関数は近隣セルの密度が小さい時に特に使えます。

Note

この関数はST_MapAlgebra (コールバック関数版)へのコールバック引数として使用する専用コールバック関数です。

Availability: 2.1.0

例

-- 例が必要

関連情報

ST_MapAlgebra (コールバック関数版), ST_InvDistWeight4ma

Name

ST_Range4ma — 近隣のピクセル値の範囲を計算するラスタ処理関数です。

Synopsis

float8 ST_Range4ma( | matrix, |
| nodatamode, |
| VARIADIC args); |

float8[][] matrix;
text nodatamode;
text[] VARIADIC args;

double precision ST_Range4ma( | value, |
| pos, |
| VARIADIC userargs); |

double precision[][][] value;
integer[][] pos;
text[] VARIADIC userargs;

説明

近隣のピクセル値の範囲を計算します。

二つ目の形式では、userargsに渡す値でNODATAピクセルに代入する値を指定できます。

Note

一つ目の形式は、ST_MapAlgebraFctNgbへのコールバック引数として使用する専用コールバック関数です。

Note

二つ目の形式は、ST_MapAlgebra (コールバック関数版)へのコールバック引数として使用する専用コールバック関数です。

Warning

一つ目の形式は、ST_MapAlgebraFctNgbが2.1.0で非推奨となったので、使用しないようになります。

Availability: 2.0.0

Enhanced: 2.1.0 二つ目の形式の追加

例

SELECT
    rid,
    st_value(
        st_mapalgebrafctngb(rast, 1, NULL, 1, 1, 'st_range4ma(float[][],text,text[])'::regprocedure, 'ignore', NULL), 2, 2
    )
FROM dummy_rast
WHERE rid = 2;
 rid | st_value
-----+----------
   2 |        4
(1 row)

関連情報

ST_MapAlgebraFctNgb, ST_MapAlgebra (コールバック関数版), ST_Min4ma, ST_Max4ma, ST_Sum4ma, ST_Mean4ma, ST_Distinct4ma, ST_StdDev4ma

Name

ST_StdDev4ma — 近隣のピクセル値の標準偏差を計算するラスタ処理関数です。

Synopsis

float8 ST_StdDev4ma( | matrix, |
| nodatamode, |
| VARIADIC args); |

float8[][] matrix;
text nodatamode;
text[] VARIADIC args;

double precision ST_StdDev4ma( | value, |
| pos, |
| VARIADIC userargs); |

double precision[][][] value;
integer[][] pos;
text[] VARIADIC userargs;

説明

近隣のピクセル値の標準偏差を計算します。

Note

一つ目の形式は、ST_MapAlgebraFctNgbへのコールバック引数として使用する専用コールバック関数です。

Note

二つ目の形式は、ST_MapAlgebra (コールバック関数版)へのコールバック引数として使用する専用コールバック関数です。

Warning

一つ目の形式は、ST_MapAlgebraFctNgbが2.1.0で非推奨となったので、使用しないようになります。

Availability: 2.0.0

Enhanced: 2.1.0 二つ目の形式の追加

例

SELECT
    rid,
    st_value(
        st_mapalgebrafctngb(rast, 1, '32BF', 1, 1, 'st_stddev4ma(float[][],text,text[])'::regprocedure, 'ignore', NULL), 2, 2
    )
FROM dummy_rast
WHERE rid = 2;
 rid |     st_value
-----+------------------
   2 | 1.30170822143555
(1 row)

関連情報

ST_MapAlgebraFctNgb, ST_MapAlgebra (コールバック関数版), ST_Min4ma, ST_Max4ma, ST_Sum4ma, ST_Mean4ma, ST_Distinct4ma, ST_StdDev4ma

Name

ST_Sum4ma — 近隣のピクセル値の合計を計算するラスタ処理関数です。

Synopsis

float8 ST_Sum4ma( | matrix, |
| nodatamode, |
| VARIADIC args); |

float8[][] matrix;
text nodatamode;
text[] VARIADIC args;

double precision ST_Sum4ma( | value, |
| pos, |
| VARIADIC userargs); |

double precision[][][] value;
integer[][] pos;
text[] VARIADIC userargs;

説明

近隣のピクセル値の合計を計算します。

二つ目の形式では、userargsに渡す値でNODATAピクセルに代入する値を指定できます。

Note

一つ目の形式は、ST_MapAlgebraFctNgbへのコールバック引数として使用する専用コールバック関数です。

Note

二つ目の形式は、ST_MapAlgebra (コールバック関数版)へのコールバック引数として使用する専用コールバック関数です。

Warning

一つ目の形式は、ST_MapAlgebraFctNgbが2.1.0で非推奨となったので、使用しないようになります。

Availability: 2.0.0

Enhanced: 2.1.0 二つ目の形式の追加

例

SELECT
    rid,
    st_value(
        st_mapalgebrafctngb(rast, 1, '32BF', 1, 1, 'st_sum4ma(float[][],text,text[])'::regprocedure, 'ignore', NULL), 2, 2
    )
FROM dummy_rast
WHERE rid = 2;
 rid | st_value
-----+----------
   2 |     2279
(1 row)

関連情報

ST_MapAlgebraFctNgb, ST_MapAlgebra (コールバック関数版), ST_Min4ma, ST_Max4ma, ST_Mean4ma, ST_Range4ma, ST_Distinct4ma, ST_StdDev4ma

ラスタ処理: DEM (標高)

Name

ST_Aspect — 標高ラスタバンドの傾斜方向 (デフォルトの単位は度)を返します。地形解析に使えます。

Synopsis

raster ST_Aspect( | rast, |
| band=1, |
| pixeltype=32BF, |
| units=DEGREES, |
| interpolate_nodata=FALSE); |

raster rast;
integer band=1;
text pixeltype=32BF;
text units=DEGREES;
boolean interpolate_nodata=FALSE;

raster ST_Aspect( | rast, |
| band, |
| customextent, |
| pixeltype=32BF, |
| units=DEGREES, |
| interpolate_nodata=FALSE); |

raster rast;
integer band;
raster customextent;
text pixeltype=32BF;
text units=DEGREES;
boolean interpolate_nodata=FALSE;

説明

標高ラスタバンドの傾斜方向 (デフォルトの単位は度)を返します。地図代数を利用して、傾斜方向方程式を隣接ピクセルに適用します。

unitsは、傾斜方向の単位を示します。取りえる値はRADIANS, DEGREES (デフォルト)です。

unitsがRADIANSの時、値は0から2πラジアンの間で、北から時計回りに計ります。

unitsがDEGREESの時、値は0から360度の間で、北から時計回りに計ります。

ピクセルの傾斜角が0の場合には、傾斜方向は-1とします。

Note

傾斜角、傾斜方および陰影起伏に関する詳細情報については、ESRI - How hillshade worksおよびERDAS Field Guide - Aspect Imagesを参照して下さい。

Availability: 2.0.0

Enhanced: 2.1.0 ST_MapAlgebra()を使用するようにし、interpolate_nodata任意引数を追加しました。

Changed: 2.1.0 以前の版では、返り値はラジアン単位でした。現在は、デフォルトでは度で返します。

例: 一つ目の形式

WITH foo AS (
    SELECT ST_SetValues(
        ST_AddBand(ST_MakeEmptyRaster(5, 5, 0, 0, 1, -1, 0, 0, 0), 1, '32BF', 0, -9999),
        1, 1, 1, ARRAY[
            [1, 1, 1, 1, 1],
            [1, 2, 2, 2, 1],
            [1, 2, 3, 2, 1],
            [1, 2, 2, 2, 1],
            [1, 1, 1, 1, 1]
        ]::double precision[][]
    ) AS rast
)
SELECT
    ST_DumpValues(ST_Aspect(rast, 1, '32BF'))
FROM foo

                                                                                                    st_dumpvalues

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
----------------------------------
 (1,"{{315,341.565063476562,0,18.4349479675293,45},{288.434936523438,315,0,45,71.5650482177734},{270,270,-1,90,90},{251.565048217773,225,180,135,108.434951782227},{225,198.43495178
2227,180,161.565048217773,135}}")
(1 row)

例: 二つ目の形式

カバレッジのタイルの完全な例です。このクエリはPostgreSQL 9.1以上でのみ動作します。

WITH foo AS (
    SELECT ST_Tile(
        ST_SetValues(
            ST_AddBand(
                ST_MakeEmptyRaster(6, 6, 0, 0, 1, -1, 0, 0, 0),
                1, '32BF', 0, -9999
            ),
            1, 1, 1, ARRAY[
                [1, 1, 1, 1, 1, 1],
                [1, 1, 1, 1, 2, 1],
                [1, 2, 2, 3, 3, 1],
                [1, 1, 3, 2, 1, 1],
                [1, 2, 2, 1, 2, 1],
                [1, 1, 1, 1, 1, 1]
            ]::double precision[]
        ),
        2, 2
    ) AS rast
)
SELECT
    t1.rast,
    ST_Aspect(ST_Union(t2.rast), 1, t1.rast)
FROM foo t1
CROSS JOIN foo t2
WHERE ST_Intersects(t1.rast, t2.rast)
GROUP BY t1.rast;

関連情報

ST_MapAlgebra (コールバック関数版), ST_TRI, ST_TPI, ST_Roughness, ST_HillShade, ST_Slope

Name

ST_HillShade — 与えられた方位、高度、明度、スケールの入力を使って標高ラスタバンドの仮想照明を返します。

Synopsis

raster ST_HillShade( | rast, |
| band=1, |
| pixeltype=32BF, |
| azimuth=315, |
| altitude=45, |
| max_bright=255, |
| scale=1.0, |
| interpolate_nodata=FALSE); |

raster rast;
integer band=1;
text pixeltype=32BF;
double precision azimuth=315;
double precision altitude=45;
double precision max_bright=255;
double precision scale=1.0;
boolean interpolate_nodata=FALSE;

raster ST_HillShade( | rast, |
| band, |
| customextent, |
| pixeltype=32BF, |
| azimuth=315, |
| altitude=45, |
| max_bright=255, |
| scale=1.0, |
| interpolate_nodata=FALSE); |

raster rast;
integer band;
raster customextent;
text pixeltype=32BF;
double precision azimuth=315;
double precision altitude=45;
double precision max_bright=255;
double precision scale=1.0;
boolean interpolate_nodata=FALSE;

説明

与えられた方位、高度、明度、スケールの入力を使って標高ラスタバンドの仮想照明を返します。地図代数を使って、陰影図方程式を隣接ピクセルに適用します。返されるピクセル値は0と255の間です。

azimuthは0から360度の間の値で、北から時計回りに計ります。

altitudeは0から90度の間で、0が水平、90が鉛直上向きです。

max_brightは0から255までの間で、0は明度なしで、255が最大明度です。

scaleは鉛直単位と水平単位との比です。フィート:経度緯度ではscale=370400となり、メートル:経度緯度ではscale=111120となります。

interpolate_nodataがTRUEの場合には、入力ラスタのNODATAピクセルの値は陰影図を計算する前にST_InvDistWeight4maを使って内挿を行います。

Note

陰影図に関する詳細情報については How hillshade worksをご覧下さい。

Availability: 2.0.0

Enhanced: 2.1.0 ST_MapAlgebra()を使用するようにし、interpolate_nodata任意引数を追加しました。

Changed: 2.1.0 以前の版ではazimuthとaltitudeはラジアン単位で表現しました。現在はazimuthとaltitudeは度単位で表現します。

例: 一つ目の形式

WITH foo AS (
    SELECT ST_SetValues(
        ST_AddBand(ST_MakeEmptyRaster(5, 5, 0, 0, 1, -1, 0, 0, 0), 1, '32BF', 0, -9999),
        1, 1, 1, ARRAY[
            [1, 1, 1, 1, 1],
            [1, 2, 2, 2, 1],
            [1, 2, 3, 2, 1],
            [1, 2, 2, 2, 1],
            [1, 1, 1, 1, 1]
        ]::double precision[][]
    ) AS rast
)
SELECT
    ST_DumpValues(ST_Hillshade(rast, 1, '32BF'))
FROM foo

                                                                                                                       st_dumpvalues

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
-----------------------------------------------------------------------
 (1,"{{NULL,NULL,NULL,NULL,NULL},{NULL,251.32763671875,220.749786376953,147.224319458008,NULL},{NULL,220.749786376953,180.312225341797,67.7497863769531,NULL},{NULL,147.224319458008
,67.7497863769531,43.1210060119629,NULL},{NULL,NULL,NULL,NULL,NULL}}")
(1 row)

例: 二つ目の形式

カバレッジのタイルの完全な例です。このクエリはPostgreSQL 9.1以上でのみ動作します。

WITH foo AS (
    SELECT ST_Tile(
        ST_SetValues(
            ST_AddBand(
                ST_MakeEmptyRaster(6, 6, 0, 0, 1, -1, 0, 0, 0),
                1, '32BF', 0, -9999
            ),
            1, 1, 1, ARRAY[
                [1, 1, 1, 1, 1, 1],
                [1, 1, 1, 1, 2, 1],
                [1, 2, 2, 3, 3, 1],
                [1, 1, 3, 2, 1, 1],
                [1, 2, 2, 1, 2, 1],
                [1, 1, 1, 1, 1, 1]
            ]::double precision[]
        ),
        2, 2
    ) AS rast
)
SELECT
    t1.rast,
    ST_Hillshade(ST_Union(t2.rast), 1, t1.rast)
FROM foo t1
CROSS JOIN foo t2
WHERE ST_Intersects(t1.rast, t2.rast)
GROUP BY t1.rast;

関連情報

ST_MapAlgebra (コールバック関数版), ST_TRI, ST_TPI, ST_Roughness, ST_Aspect, ST_Slope

Name

ST_Roughness — DEMの「粗度」を計算したラスタを返します。

Synopsis

raster ST_Roughness( | rast, |
| nband, |
| customextent, |
| pixeltype="32BF", |
| interpolate_nodata=FALSE ); |

raster rast;
integer nband;
raster customextent;
text pixeltype="32BF" ;
boolean interpolate_nodata=FALSE ;

説明

指定された領域の最大値から最小値を減じることでDEMの「粗度」を計算したラスタを返します。

Availability: 2.1.0

例

-- 例が必要

関連情報

ST_MapAlgebra (コールバック関数版), ST_TRI, ST_TPI, ST_Slope, ST_HillShade, ST_Aspect

Name

ST_Slope — 標高ラスタバンドの傾斜角 (デフォルトでは度単位)を返します。地形解析に使えます。

Synopsis

raster ST_Slope( | rast, |
| nband=1, |
| pixeltype=32BF, |
| units=DEGREES, |
| scale=1.0, |
| interpolate_nodata=FALSE); |

raster rast;
integer nband=1;
text pixeltype=32BF;
text units=DEGREES;
double precision scale=1.0;
boolean interpolate_nodata=FALSE;

raster ST_Slope( | rast, |
| nband, |
| customextent, |
| pixeltype=32BF, |
| units=DEGREES, |
| scale=1.0, |
| interpolate_nodata=FALSE); |

raster rast;
integer nband;
raster customextent;
text pixeltype=32BF;
text units=DEGREES;
double precision scale=1.0;
boolean interpolate_nodata=FALSE;

説明

標高ラスタバンドの傾斜角 (デフォルトでは度単位)を返します。地図代数を使って、傾斜角方程式を隣接ピクセルに適用します。

unitsは傾斜角の単位を示します。取りえる値はRADIANS, DEGREES (デフォルト), PERCENTです。

scaleは鉛直単位と水平単位との比です。フィート:経度緯度ではscale=370400となり、メートル:経度緯度ではscale=111120となります。

interpolate_nodataがTRUEの場合には、入力ラスタのNODATAピクセルの値は表面傾斜角を計算する前にST_InvDistWeight4maを使って内挿を行います。

Note

傾斜角、傾斜方および陰影起伏に関する詳細情報については、ESRI - How hillshade worksおよびERDAS Field Guide - Slope Imagesを参照して下さい。

Availability: 2.0.0

Enhanced: 2.1.0 ST_MapAlgebra()を使用するようにし、units, scale, interpolate_nodata任意引数を追加しました。

Changed: 2.1.0 以前の版では、返り値はラジアン単位でした。現在は、デフォルトでは度で返します。

例: 一つ目の形式

WITH foo AS (
    SELECT ST_SetValues(
        ST_AddBand(ST_MakeEmptyRaster(5, 5, 0, 0, 1, -1, 0, 0, 0), 1, '32BF', 0, -9999),
        1, 1, 1, ARRAY[
            [1, 1, 1, 1, 1],
            [1, 2, 2, 2, 1],
            [1, 2, 3, 2, 1],
            [1, 2, 2, 2, 1],
            [1, 1, 1, 1, 1]
        ]::double precision[][]
    ) AS rast
)
SELECT
    ST_DumpValues(ST_Slope(rast, 1, '32BF'))
FROM foo

                            st_dumpvalues

------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
---------------------------------------------------------------------
 (1,"{{10.0249881744385,21.5681285858154,26.5650520324707,21.5681285858154,10.0249881744385},{21.5681285858154,35.2643890380859,36.8698959350586,35.2643890380859,21.5681285858154},
{26.5650520324707,36.8698959350586,0,36.8698959350586,26.5650520324707},{21.5681285858154,35.2643890380859,36.8698959350586,35.2643890380859,21.5681285858154},{10.0249881744385,21.
5681285858154,26.5650520324707,21.5681285858154,10.0249881744385}}")
(1 row)

例: 二つ目の形式

カバレッジのタイルの完全な例です。このクエリはPostgreSQL 9.1以上でのみ動作します。

WITH foo AS (
    SELECT ST_Tile(
        ST_SetValues(
            ST_AddBand(
                ST_MakeEmptyRaster(6, 6, 0, 0, 1, -1, 0, 0, 0),
                1, '32BF', 0, -9999
            ),
            1, 1, 1, ARRAY[
                [1, 1, 1, 1, 1, 1],
                [1, 1, 1, 1, 2, 1],
                [1, 2, 2, 3, 3, 1],
                [1, 1, 3, 2, 1, 1],
                [1, 2, 2, 1, 2, 1],
                [1, 1, 1, 1, 1, 1]
            ]::double precision[]
        ),
        2, 2
    ) AS rast
)
SELECT
    t1.rast,
    ST_Slope(ST_Union(t2.rast), 1, t1.rast)
FROM foo t1
CROSS JOIN foo t2
WHERE ST_Intersects(t1.rast, t2.rast)
GROUP BY t1.rast;

関連情報

ST_MapAlgebra (コールバック関数版), ST_TRI, ST_TPI, ST_Roughness, ST_HillShade, ST_Aspect

Name

ST_TPI — 地形的位置指数を計算したラスタを返します。

Synopsis

raster ST_TPI( | rast, |
| nband, |
| customextent, |
| pixeltype="32BF", |
| interpolate_nodata=FALSE ); |

raster rast;
integer nband;
raster customextent;
text pixeltype="32BF" ;
boolean interpolate_nodata=FALSE ;

説明

地形的位置指数 (TPI=Topographic Position Index)を計算します。地形的位置指数は、半径1における近傍平均値から中心セルの値を引いたものです。

Note

この関数は、近傍平均値半径が1についてのみ対応しています。

Availability: 2.1.0

例

-- 例が必要

関連情報

ST_MapAlgebra (コールバック関数版), ST_TRI, ST_Roughness, ST_Slope, ST_HillShade, ST_Aspect

Name

ST_TRI — 起伏指標を計算したラスタを返します。

Synopsis

raster ST_TRI( | rast, |
| nband, |
| customextent, |
| pixeltype="32BF", |
| interpolate_nodata=FALSE ); |

raster rast;
integer nband;
raster customextent;
text pixeltype="32BF" ;
boolean interpolate_nodata=FALSE ;

説明

起伏指標 (TRI=Terrain Ruggedness Index)は、中心ピクセルと隣接ピクセルを、差の絶対値の平均を取って比較することで計算されます。

Note

この関数は、近傍平均値半径が1についてのみ対応しています。

Availability: 2.1.0

例

-- 例が必要

関連情報

ST_MapAlgebra (コールバック関数版), ST_Roughness, ST_TPI, ST_Slope, ST_HillShade, ST_Aspect

ラスタ処理: ラスタからジオメトリ

Name

Box3D — ラスタを囲むボックスのbox3d表現を返します。

Synopsis

box3d Box3D(
rast);

raster rast;

説明

ラスタの範囲を表現するボックスを返します。

ポリゴンは、バウンディングボックス ((MINX, MINY), (MAXX, MAXY))の4隅のポイントにより定義されます。

Changed: 2.0.0 以前の版では、box3dでなくbox2dを使っていました。box2dは非推奨型となり、box3dに変更しました。

例

SELECT
    rid,
    Box3D(rast) AS rastbox
FROM dummy_rast;

rid |        rastbox
----+-------------------------------------------------
1   | BOX3D(0.5 0.5 0,20.5 60.5 0)
2   | BOX3D(3427927.75 5793243.5 0,3427928 5793244 0)

関連情報

ST_Envelope

Name

ST_ConvexHull — BandNoDataValueと等しいピクセル値を含むラスタの凸包ジオメトリを返します。一般的な形状でスキューのないラスタでは、ST_Envelopeと同じ結果になります。不規則な形状をしているか回転しているラスタでのみ使います。

Synopsis

geometry ST_ConvexHull(
rast);

raster rast;

説明

NoDataValue値のピクセルを含むラスタの凸包ジオメトリを返します。一般的な形状でスキューのないラスタでは、ST_Envelopeと同じ結果になります。不規則な形状をしているかスキューのあるラスタでのみ使います。

Note

ST_Envelopeは、座標値の小数部を切り捨て、ラスタのまわりに小さなバッファを追加します。小数部の切り捨てを行わないST_ConvexHullの答と若干異なります。

例

これの図についてはPostGIS Raster Specificationを参照して下さい。

-- ST_EnvelopeとST_ConvexHullはだいたい同じです
SELECT ST_AsText(ST_ConvexHull(rast)) As convhull,
    ST_AsText(ST_Envelope(rast)) As env
FROM dummy_rast WHERE rid=1;

                        convhull                        |                env
--------------------------------------------------------+------------------------------------
 POLYGON((0.5 0.5,20.5 0.5,20.5 60.5,0.5 60.5,0.5 0.5)) | POLYGON((0 0,20 0,20 60,0 60,0 0))

-- ラスタをスキューします
-- 凸包とエンベロープがどのくらい異なるかをみます
SELECT ST_AsText(ST_ConvexHull(rast)) As convhull,
    ST_AsText(ST_Envelope(rast)) As env
FROM (SELECT ST_SetRotation(rast, 0.1, 0.1) As rast
    FROM dummy_rast WHERE rid=1) As foo;

                        convhull                        |                env
--------------------------------------------------------+------------------------------------
 POLYGON((0.5 0.5,20.5 1.5,22.5 61.5,2.5 60.5,0.5 0.5)) | POLYGON((0 0,22 0,22 61,0 61,0 0))

関連情報

ST_Envelope, ST_MinConvexHull, ST_ConvexHull, ST_AsText

Name

ST_DumpAsPolygons — 指定されたラスタバンドからgeomval (geom,val)行の集合を返します。バンドを指定しない場合のデフォルトは1です。

Synopsis

setof geomval ST_DumpAsPolygons( | rast, |
| band_num=1, |
| exclude_nodata_value=TRUE); |

raster rast;
integer band_num=1;
boolean exclude_nodata_value=TRUE;

説明

集合を返す関数 (SRF=set-returning function)です。geomval行の集合を返します。geomvalはジオメトリ (geom)とピクセルバンド値 (val)からなります。それぞれのポリゴンは、指定したバンドの、valで示される値と同じピクセル値を持っている全てのピクセルの結合です。

ST_DumpAsPolygonはラスタのポリゴン化に使えます。新しい行を生成するのでGROUP BYの逆です。たとえば、単一ラスタを複数のPOLYGON/MULTIPOLYGONに展開できます。

Changed 3.3.0, 能率向上のため評価と修正が無効になりました。不正なジオメトリを返すことがあります。

Availability: GDAL 1.7以上が必要です。

Note

バンドにNODATA値が設定されている場合には、exclude_nodata_value=falseが設定されている場合を除いて、NODATA値を持つピクセルは返りません。

Note

ラスタ内の与えられた値を持つピクセルの数にのみ注意する場合にはST_ValueCountを使う方が速いです。

Note

これは、ピクセル値にかかわらずピクセルごとに一つのジオメトリを返すST_PixelAsPolygonsと違います。

例

-- PostgreSQL 9.3以上では、次のような文法になります
SELECT val, ST_AsText(geom) As geomwkt
FROM (
SELECT dp.*
FROM dummy_rast, LATERAL ST_DumpAsPolygons(rast) AS dp
WHERE rid = 2
) As foo
WHERE val BETWEEN 249 and 251
ORDER BY val;

 val |                                                       geomwkt
-----+--------------------------------------------------------------------------
 249 | POLYGON((3427927.95 5793243.95,3427927.95 5793243.85,3427928 5793243.85,
        3427928 5793243.95,3427927.95 5793243.95))
 250 | POLYGON((3427927.75 5793243.9,3427927.75 5793243.85,3427927.8 5793243.85,
        3427927.8 5793243.9,3427927.75 5793243.9))
 250 | POLYGON((3427927.8 5793243.8,3427927.8 5793243.75,3427927.85 5793243.75,
        3427927.85 5793243.8, 3427927.8 5793243.8))
 251 | POLYGON((3427927.75 5793243.85,3427927.75 5793243.8,3427927.8 5793243.8,
        3427927.8 5793243.85,3427927.75 5793243.85))

関連情報

geomval, ST_Value, ST_Polygon, ST_ValueCount

Name

ST_Envelope — ラスタの範囲のポリゴン表現を返します。

Synopsis

geometry ST_Envelope(
rast);

raster rast;

説明

SRIDで定義されている空間参照系上でのラスタの範囲のポリゴン表現を返します。ポリゴンで表現されるfloat8の最小バウンディングボックスです。

ポリゴンはバウンディングボックスの隅のポイント、すなわち ((MINX, MINY), (MINX, MAXY), (MAXX, MAXY), (MAXX, MINY), (MINX, MINY))です。

例

SELECT rid, ST_AsText(ST_Envelope(rast)) As envgeomwkt
FROM dummy_rast;

 rid |                                         envgeomwkt
-----+--------------------------------------------------------------------
   1 | POLYGON((0 0,20 0,20 60,0 60,0 0))
   2 | POLYGON((3427927 5793243,3427928 5793243,
        3427928 5793244,3427927 5793244, 3427927 5793243))

関連情報

ST_Envelope, ST_AsText, ST_SRID

Name

ST_MinConvexHull — NODATA値を除いたラスタの凸包ジオメトリを返します。

Synopsis

geometry ST_MinConvexHull( | rast, |
| nband=NULL); |

raster rast;
integer nband=NULL;

説明

NODATA値を除いたラスタの凸包ジオメトリを返します。nbandがNULLの場合には、ラスタの全てのバンドが考慮されます。

Availability: 2.1.0

例

WITH foo AS (
    SELECT
        ST_SetValues(
            ST_SetValues(
                ST_AddBand(ST_AddBand(ST_MakeEmptyRaster(9, 9, 0, 0, 1, -1, 0, 0, 0), 1, '8BUI', 0, 0), 2, '8BUI', 1, 0),
                1, 1, 1,
                ARRAY[
                    [0, 0, 0, 0, 0, 0, 0, 0, 0],
                    [0, 0, 0, 0, 0, 0, 0, 0, 0],
                    [0, 0, 0, 0, 0, 0, 0, 0, 0],
                    [0, 0, 0, 1, 0, 0, 0, 0, 1],
                    [0, 0, 0, 1, 1, 0, 0, 0, 0],
                    [0, 0, 0, 1, 0, 0, 0, 0, 0],
                    [0, 0, 0, 0, 0, 0, 0, 0, 0],
                    [0, 0, 0, 0, 0, 0, 0, 0, 0],
                    [0, 0, 0, 0, 0, 0, 0, 0, 0]
                ]::double precision[][]
            ),
            2, 1, 1,
            ARRAY[
                [0, 0, 0, 0, 0, 0, 0, 0, 0],
                [0, 0, 0, 0, 0, 0, 0, 0, 0],
                [0, 0, 0, 0, 0, 0, 0, 0, 0],
                [1, 0, 0, 0, 0, 1, 0, 0, 0],
                [0, 0, 0, 0, 1, 1, 0, 0, 0],
                [0, 0, 0, 0, 0, 1, 0, 0, 0],
                [0, 0, 0, 0, 0, 0, 0, 0, 0],
                [0, 0, 0, 0, 0, 0, 0, 0, 0],
                [0, 0, 1, 0, 0, 0, 0, 0, 0]
            ]::double precision[][]
        ) AS rast
)
SELECT
    ST_AsText(ST_ConvexHull(rast)) AS hull,
    ST_AsText(ST_MinConvexHull(rast)) AS mhull,
    ST_AsText(ST_MinConvexHull(rast, 1)) AS mhull_1,
    ST_AsText(ST_MinConvexHull(rast, 2)) AS mhull_2
FROM foo

               hull               |                mhull                |               mhull_1               |               mhull_2
----------------------------------+-------------------------------------+-------------------------------------+-------------------------------------
 POLYGON((0 0,9 0,9 -9,0 -9,0 0)) | POLYGON((0 -3,9 -3,9 -9,0 -9,0 -3)) | POLYGON((3 -3,9 -3,9 -6,3 -6,3 -3)) | POLYGON((0 -3,6 -3,6 -9,0 -9,0 -3))

関連情報

ST_Envelope, ST_ConvexHull, ST_ConvexHull, ST_AsText

Name

ST_Polygon — NODATA値でないピクセル値を持つピクセルの結合で形成されるマルチポリゴンジオメトリを返します。バンドを指定しない場合のデフォルトは1です。

Synopsis

geometry ST_Polygon( | rast, |
| band_num=1); |

raster rast;
integer band_num=1;

説明

Changed 3.3.0, 能率向上のため評価と修正が無効になりました。不正なジオメトリを返すことがあります。

Availability: 0.1.6 GDAL 1.7以上が必要です。

Enhanced: 2.1.0 速度を改善し (完全にC言語で記述しました)、確実に妥当なマルチポリゴンを返すようにしました。

Changed: 2.1.0 以前の版では、時々ポリゴンを返しましたが、常にマルチポリゴンを返すように変更しました。

例

-- デフォルトではNODATA値は0になるか設定されていないのでST_Polygon()は四角形のポリゴンを返します
SELECT ST_AsText(ST_Polygon(rast)) As geomwkt
FROM dummy_rast
WHERE rid = 2;

geomwkt
--------------------------------------------
MULTIPOLYGON(((3427927.75 5793244,3427928 5793244,3427928 5793243.75,3427927.75 5793243.75,3427927.75 5793244)))

-- 1番目のバンドのNODATA値を変更します
UPDATE dummy_rast SET rast = ST_SetBandNoDataValue(rast,1,254)
WHERE rid = 2;
SELECt rid, ST_BandNoDataValue(rast)
from dummy_rast where rid = 2;

-- ST_Polygonはピクセル値254を除外してマルチポリゴンを返します
SELECT ST_AsText(ST_Polygon(rast)) As geomwkt
FROM dummy_rast
WHERE rid = 2;

geomwkt
---------------------------------------------------------
MULTIPOLYGON(((3427927.9 5793243.95,3427927.85 5793243.95,3427927.85 5793244,3427927.9 5793244,3427927.9 5793243.95)),((3427928 5793243.85,3427928 5793243.8,3427927.95 5793243.8,3427927.95 5793243.85,3427927.9 5793243.85,3427927.9 5793243.9,3427927.9 5793243.95,3427927.95 5793243.95,3427928 5793243.95,3427928 5793243.85)),((3427927.8 5793243.75,3427927.75 5793243.75,3427927.75 5793243.8,3427927.75 5793243.85,3427927.75 5793243.9,3427927.75 5793244,3427927.8 5793244,3427927.8 5793243.9,3427927.8 5793243.85,3427927.85 5793243.85,3427927.85 5793243.8,3427927.85 5793243.75,3427927.8 5793243.75)))

-- 異なるNODATA値が1回だけ欲しい場合には、次のようにします

SELECT ST_AsText(
    ST_Polygon(
        ST_SetBandNoDataValue(rast,1,252)
        )
    ) As geomwkt
FROM dummy_rast
WHERE rid =2;

geomwkt
---------------------------------
MULTIPOLYGON(((3427928 5793243.85,3427928 5793243.8,3427928 5793243.75,3427927.85 5793243.75,3427927.8 5793243.75,3427927.8 5793243.8,3427927.75 5793243.8,3427927.75 5793243.85,3427927.75 5793243.9,3427927.75 5793244,3427927.8 5793244,3427927.85 5793244,3427927.9 5793244,3427928 5793244,3427928 5793243.95,3427928 5793243.85),(3427927.9 5793243.9,3427927.9 5793243.85,3427927.95 5793243.85,3427927.95 5793243.9,3427927.9 5793243.9)))

関連情報

ST_Value, ST_DumpAsPolygons

ラスタ演算子

Name

&& — AのバウンディングボックスがBのバウンディングボックスとインタセクトする場合にTRUEを返します。

Synopsis

boolean &&( | A, |
| B); |

raster A ;
raster B ;

boolean &&( | A, |
| B); |

raster A ;
geometry B ;

boolean &&( | B, |
| A); |

geometry B ;
raster A ;

説明

&&演算子は、AのバウンディングボックスがBのバウンディングボックスにインタセクトする場合に TRUEを返します。

Note

これのオペランドは、ラスタで使用できるインデクスを使用します。

Availability: 2.0.0

例

SELECT A.rid As a_rid, B.rid As b_rid, A.rast && B.rast As intersect
 FROM dummy_rast AS A CROSS JOIN dummy_rast AS B LIMIT 3;

 a_rid | b_rid | intersect
-------+-------+---------
     2 |     2 | t
     2 |     3 | f
     2 |     1 | f

Name

&< — AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの左にある場合にTRUEを返します。

Synopsis

boolean &<( | A, |
| B); |

raster A ;
raster B ;

説明

&<演算子は、AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの左にある場合にTRUEを返します。条件についてより詳細に言うと、BのバウンディングボックスをオーバラップするかBのバウンディングボックスの右に*ない*場合です。

Note

これのオペランドは、ラスタで使用できるインデクスを使用します。

例

SELECT A.rid As a_rid, B.rid As b_rid, A.rast &< B.rast As overleft
 FROM dummy_rast AS A CROSS JOIN dummy_rast AS B;

a_rid | b_rid | overleft
------+-------+----------
    2 |     2 | t
    2 |     3 | f
    2 |     1 | f
    3 |     2 | t
    3 |     3 | t
    3 |     1 | f
    1 |     2 | t
    1 |     3 | t
    1 |     1 | t

Name

&> — AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの右にある場合に TRUE を返します。

Synopsis

boolean &>( | A, |
| B); |

raster A ;
raster B ;

説明

&>演算子は、AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの右にある場合にTRUEを返します。条件についてより詳細に言うと、BのバウンディングボックスをオーバラップするかBのバウンディングボックスの左に*ない*場合です。

Note

これのオペランドは、ジオメトリで使用できるインデックスを使用します。

例

SELECT A.rid As a_rid, B.rid As b_rid, A.rast &> B.rast As overright
 FROM dummy_rast AS A CROSS JOIN dummy_rast AS B;

 a_rid | b_rid | overright
-------+-------+----------
     2 |     2 | t
     2 |     3 | t
     2 |     1 | t
     3 |     2 | f
     3 |     3 | t
     3 |     1 | f
     1 |     2 | f
     1 |     3 | t
     1 |     1 | t

Name

= — AのバウンディングボックスがBのバウンディングボックスと同じ場合にTRUEを返します。倍精度浮動小数点数のバウンディングボックスを使います。

Synopsis

boolean =( | A, |
| B); |

raster A ;
raster B ;

説明

=演算子は、AのバウンディングボックスがBのバウンディングボックスと同じ場合に TRUE を返します。PostgreSQLは内部でラスタの順序決定や比較 (GROUP BY節やORDER BY節など)を行うためにラスタ用として定義している=, <, >演算子を使用します。

Caution

これのオペランドは、ラスタで利用できるインデクスを使いません。代わりに~=を使います。この演算子はラスタカラムのGROUP BYに使うのがほとんどです。

Availability: 2.1.0

関連情報

~=

Name

@ — AのバウンディングボックスがBのバウンディングボックスに含まれる場合にTRUEを返します。倍精度浮動小数点数のバウンディングボックスを使います。

Synopsis

boolean @( | A, |
| B); |

raster A ;
raster B ;

boolean @( | A, |
| B); |

geometry A ;
raster B ;

boolean @( | B, |
| A); |

raster B ;
geometry A ;

説明

@は、ラスタまたはジオメトリであるAのバウンディングボックスが、ラスタまたはジオメトリであるBのバウンディングボックスに含まれる場合にTRUEを返します。

Note

これのオペランドは、ラスタのインデクスを使用します。

Availability: 2.0.0 raster @ raster, raster @ geometry が導入されました。

Availability: 2.0.5 geometry @ raster が導入されました。

関連情報

~

Name

~= — AのバウンディングボックスがBのバウンディングボックスと同じ場合に TRUEを返します。

Synopsis

boolean ~=( | A, |
| B); |

raster A ;
raster B ;

説明

~=演算子は、AのバウンディングボックスがBのバウンディングボックスと同じ場合にTRUEを返します。

Note

これのオペランドは、ラスタで使用できるインデクスを使用します。

Availability: 2.0.0

例

大変便利な利用局面として、単一バンドを持つラスタ集合が二つあって、これらは同じデータなのに異なる主題を表現する場合で、これらを取って複数バンドのラスタを生成する局面です。

SELECT ST_AddBand(prec.rast, alt.rast) As new_rast
    FROM prec INNER JOIN alt ON (prec.rast ~= alt.rast);

関連情報

ST_AddBand, =

Name

~ — AのバウンディングボックスがBのバウンディングボックスを含む場合にTRUEを返します。倍精度浮動小数点数のバウンディングボックスを使います。

Synopsis

boolean ~( | A, |
| B); |

raster A ;
raster B ;

boolean ~( | A, |
| B); |

geometry A ;
raster B ;

boolean ~( | B, |
| A); |

raster B ;
geometry A ;

説明

~演算子は、ラスタまたはジオメトリであるAのバウンディングボックスがラスタまたはジオメトリであるBのバウンディングボックスを含む場合にTRUEを返します。

Note

これのオペランドは、ラスタのインデクスを使用します。

Availability: 2.0.0

関連情報

@

ラスタとラスタバンドの空間関係関数

Name

ST_Contains — rastAの外にrastBの点が無く、rastAの内部にrastBの内部の点が一つ以上ある場合にTRUEを返します。

Synopsis

boolean ST_Contains( | rastA, |
| nbandA, |
| rastB, |
| nbandB); |

raster rastA ;
integer nbandA ;
raster rastB ;
integer nbandB ;

boolean ST_Contains( | rastA, |
| rastB); |

raster rastA ;
raster rastB ;

説明

rastAの外にrastBの点が無く、rastAの内部にrastBの内部の点が一つ以上ある場合に限って、rastAはrastBを包含しています。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

Note

この関数はラスタで利用できるインデクスを使用します。

Note

ラスタとジオメトリの空間関係をテストするには、ST_Contains(ST_Polygon(raster), geometry)またはST_Contains(geometry, ST_Polygon(raster))というふうに、ラスタにST_Polygonを使います。

Note

ST_Contains()はST_Within()の逆です。ST_Contains(rastA, rastB)はST_Within(rastB, rastA)を示します。

Availability: 2.1.0

例

-- バンド番号指定
SELECT r1.rid, r2.rid, ST_Contains(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 1;

NOTICE:  The first raster provided has no bands
 rid | rid | st_contains
-----+-----+-------------
   1 |   1 |
   1 |   2 | f

-- バンド番号不指定
SELECT r1.rid, r2.rid, ST_Contains(r1.rast, r2.rast) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 1;
 rid | rid | st_contains
-----+-----+-------------
   1 |   1 | t
   1 |   2 | f

関連情報

ST_Intersects, ST_Within

Name

ST_ContainsProperly — rastBがrastAの内部でインタセクトし、かつrastAの境界とも外部ともインタセクトしない場合にTRUEを返します。

Synopsis

boolean ST_ContainsProperly( | rastA, |
| nbandA, |
| rastB, |
| nbandB); |

raster rastA ;
integer nbandA ;
raster rastB ;
integer nbandB ;

boolean ST_ContainsProperly( | rastA, |
| rastB); |

raster rastA ;
raster rastB ;

説明

rastBがrastAの内部でインタセクトし、かつrastAの境界とも外部ともインタセクトしない場合には、rastAはrastBに対してContainsProperly (確実に包含している)です。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

rastAは自身にはContainsProperlyではありませんが、Containsです。

Note

この関数はラスタで利用できるインデクスを使用します。

Note

ラスタとジオメトリの空間関係をテストするには、ST_ContainsProperly(ST_Polygon(raster), geometry)またはST_ContainsProperly(geometry, ST_Polygon(raster))というふうに、ラスタにST_Polygonを使います。

Availability: 2.1.0

例

SELECT r1.rid, r2.rid, ST_ContainsProperly(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;

 rid | rid | st_containsproperly
-----+-----+---------------------
   2 |   1 | f
   2 |   2 | f

関連情報

ST_Intersects, ST_Contains

Name

ST_Covers — rastBがrastAの外部に点を持たない場合にTRUEを返します。

Synopsis

boolean ST_Covers( | rastA, |
| nbandA, |
| rastB, |
| nbandB); |

raster rastA ;
integer nbandA ;
raster rastB ;
integer nbandB ;

boolean ST_Covers( | rastA, |
| rastB); |

raster rastA ;
raster rastB ;

説明

rastAの外部にrastBの点が無い場合には、rastAはrastBに対してCoversです。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

Note

この関数はラスタで利用できるインデクスを使用します。

Note

ラスタとジオメトリの空間関係をテストするには、ST_Covers(ST_Polygon(raster), geometry)またはST_Covers(geometry, ST_Polygon(raster))というふうに、ラスタにST_Polygonを使います。

Availability: 2.1.0

例

SELECT r1.rid, r2.rid, ST_Covers(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;

 rid | rid | st_covers
-----+-----+-----------
   2 |   1 | f
   2 |   2 | t

関連情報

ST_Intersects, ST_CoveredBy

Name

ST_CoveredBy — rastAがrastBの外部に点を持たない場合にTRUEを返します。

Synopsis

boolean ST_CoveredBy( | rastA, |
| nbandA, |
| rastB, |
| nbandB); |

raster rastA ;
integer nbandA ;
raster rastB ;
integer nbandB ;

boolean ST_CoveredBy( | rastA, |
| rastB); |

raster rastA ;
raster rastB ;

説明

rastAがrastBの外部に点を持たない場合には、rastAはrastBに対してCoveredByです。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

Note

この関数はラスタで利用できるインデクスを使用します。

Note

ラスタとジオメトリの空間関係をテストするには、ST_CoveredBy(ST_Polygon(raster), geometry)またはST_CoveredBy(geometry, ST_Polygon(raster))というふうに、ラスタにST_Polygonを使います。

Availability: 2.1.0

例

SELECT r1.rid, r2.rid, ST_CoveredBy(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;

 rid | rid | st_coveredby
-----+-----+--------------
   2 |   1 | f
   2 |   2 | t

関連情報

ST_Intersects, ST_Covers

Name

ST_Disjoint — rastAがrastBとインタセクトしない場合にTRUEを返します。

Synopsis

boolean ST_Disjoint( | rastA, |
| nbandA, |
| rastB, |
| nbandB); |

raster rastA ;
integer nbandA ;
raster rastB ;
integer nbandB ;

boolean ST_Disjoint( | rastA, |
| rastB); |

raster rastA ;
raster rastB ;

説明

rastAがrastBとインタセクトしない場合には、rastAとrastBはDisjointです。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

Note

この関数はインデクスを*使いません*。

Note

ラスタとジオメトリの空間関係をテストするには、ST_Disjoint(ST_Polygon(raster), geometry)というふうに、ラスタにST_Polygonを使います。

Availability: 2.1.0

例

-- rid=1のラスタはバンドを持っていないので、 警告が出て、ST_DisjointでNULL値が出ます
SELECT r1.rid, r2.rid, ST_Disjoint(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;

NOTICE:  The second raster provided has no bands
 rid | rid | st_disjoint
-----+-----+-------------
   2 |   1 |
   2 |   2 | f

-- 今度はバンド番号を指定しません
SELECT r1.rid, r2.rid, ST_Disjoint(r1.rast, r2.rast) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;

 rid | rid | st_disjoint
-----+-----+-------------
   2 |   1 | t
   2 |   2 | f

関連情報

ST_Intersects

Name

ST_Intersects — rastAがrastBとインタセクトする場合にTRUEを返します。

Synopsis

boolean ST_Intersects( | rastA, |
| nbandA, |
| rastB, |
| nbandB); |

raster rastA ;
integer nbandA ;
raster rastB ;
integer nbandB ;

boolean ST_Intersects( | rastA, |
| rastB); |

raster rastA ;
raster rastB ;

boolean ST_Intersects( | rast, |
| nband, |
| geommin); |

raster rast ;
integer nband ;
geometry geommin ;

boolean ST_Intersects( | rast, |
| geommin, |
| nband=NULL); |

raster rast ;
geometry geommin ;
integer nband=NULL ;

boolean ST_Intersects( | geommin, |
| rast, |
| nband=NULL); |

geometry geommin ;
raster rast ;
integer nband=NULL ;

説明

rastAがrastBとインタセクトする場合にTRUEを返します。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

Note

この関数はラスタで利用できるインデクスを使用します。

Enhanced: 2.0.0 ラスタ/ラスタのインタセクト対応が導入されました。

Warning

Changed: 2.1.0 ST_Intersects(raster, geometry)形式の挙動が ST_Intersects(geometry, raster)とあうように変更されました。

例

-- 同じラスタの別のバンド
SELECT ST_Intersects(rast, 2, rast, 3) FROM dummy_rast WHERE rid = 2;

 st_intersects
---------------
 t

関連情報

ST_Intersection, ST_Disjoint

Name

ST_Overlaps — rastAとrastBがインタセクトして、かつ一方がもう一方に完全には包含されない場合にはTRUEを返します。

Synopsis

boolean ST_Overlaps( | rastA, |
| nbandA, |
| rastB, |
| nbandB); |

raster rastA ;
integer nbandA ;
raster rastB ;
integer nbandB ;

boolean ST_Overlaps( | rastA, |
| rastB); |

raster rastA ;
raster rastB ;

説明

rastAがrastBをオーバラップする場合にTRUEを返します。rastAとrastBがインタセクトして、かつ一方がもう一方に完全には包含されない場合にはいう意味です。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

Note

この関数はラスタで利用できるインデクスを使用します。

Note

ラスタとジオメトリの空間関係をテストするには、ST_Overlaps(ST_Polygon(raster), geometry)というふうに、ラスタにST_Polygonを使います。

Availability: 2.1.0

例

-- 同じラスタの別のバンドの比較
SELECT ST_Overlaps(rast, 1, rast, 2) FROM dummy_rast WHERE rid = 2;

 st_overlaps
-------------
 f

関連情報

ST_Intersects

Name

ST_Touches — rastAとrastBが少なくとも一つの共通の点を持ち、かつ二つのラスタの内部同士がインタセクトしない場合にTRUEを返します。

Synopsis

boolean ST_Touches( | rastA, |
| nbandA, |
| rastB, |
| nbandB); |

raster rastA ;
integer nbandA ;
raster rastB ;
integer nbandB ;

boolean ST_Touches( | rastA, |
| rastB); |

raster rastA ;
raster rastB ;

説明

rastAがrastBに接触する場合にTRUEを返します。rastAとrastBが少なくとも一つの共通の点を持ち、かつ二つのラスタの内部同士がインタセクトしないという意味です。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

Note

この関数はラスタで利用できるインデクスを使用します。

Note

ラスタとジオメトリの空間関係をテストするには、ST_Touches(ST_Polygon(raster), geometry)というふうに、ラスタにST_Polygonを使います。

Availability: 2.1.0

例

SELECT r1.rid, r2.rid, ST_Touches(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;

 rid | rid | st_touches
-----+-----+------------
   2 |   1 | f
   2 |   2 | f

関連情報

ST_Intersects

Name

ST_SameAlignment — ラスタが同じスキュー、スケール、空間参照系、オフセットを持つ (ピクセルが分割されることなく同じグリッドに置かれている)場合にTRUEを返し、そうでない場合は問題を詳述する通知とともにFALSEを返します。

Synopsis

boolean ST_SameAlignment( | rastA, |
| rastB); |

raster rastA ;
raster rastB ;

boolean ST_SameAlignment( | ulx1, |
| uly1, |
| scalex1, |
| scaley1, |
| skewx1, |
| skewy1, |
| ulx2, |
| uly2, |
| scalex2, |
| scaley2, |
| skewx2, |
| skewy2); |

double precision ulx1 ;
double precision uly1 ;
double precision scalex1 ;
double precision scaley1 ;
double precision skewx1 ;
double precision skewy1 ;
double precision ulx2 ;
double precision uly2 ;
double precision scalex2 ;
double precision scaley2 ;
double precision skewx2 ;
double precision skewy2 ;

boolean ST_SameAlignment(
rastfield);

raster set rastfield ;

説明

非集計版 (一つ目と二つ目の形式): 二つのラスタ (直接与えたラスタでも左上隅、スケール、スキュー、SRIDを使って作ったものでも)が同じスキュー、スケール、空間参照系、を持ち、少なくとも4隅の一つがもう一方のラスタのグリッド隅に落ちる場合にTRUEを返します。そうでない場合には、問題に言及した警告を出します。

集約関数版 (三つ目の形式): ラスタ集合から、全てのラスタが同じアラインメントを持つ場合にTRUEを返します。ST_SameAlignment()関数はPostgreSQLの用語で言うところの「集約」関数です。SUM()やAVG()といった複数のデータ行での操作を意味します。

Availability: 2.0.0

Enhanced: 2.1.0 集約関数版の追加

例: ラスタ

SELECT ST_SameAlignment(
    ST_MakeEmptyRaster(1, 1, 0, 0, 1, 1, 0, 0),
    ST_MakeEmptyRaster(1, 1, 0, 0, 1, 1, 0, 0)
) as sm;

sm
----
t

SELECT ST_SameAlignment(A.rast,b.rast)
 FROM dummy_rast AS A CROSS JOIN dummy_rast AS B;

 NOTICE:  The two rasters provided have different SRIDs
NOTICE:  The two rasters provided have different SRIDs
 st_samealignment
------------------
 t
 f
 f
 f

関連情報

the section called “ラスタのロードと生成”, ST_NotSameAlignmentReason, ST_MakeEmptyRaster

Name

ST_NotSameAlignmentReason — ラスタが同じアラインメントを持つかどうか、また、持たない場合にはその理由を示す文字列を返します。

Synopsis

text ST_NotSameAlignmentReason( | rastA, |
| rastB); |

raster rastA;
raster rastB;

説明

ラスタが同じアラインメントを持つかどうか、また、持たない場合にはその理由を示す文字列を返します。

Note

ラスタが同じアラインメントを持たない理由が複数ある場合には、一つだけ （最初のテストで失敗した)理由を返します。

Availability: 2.1.0

例

SELECT
    ST_SameAlignment(
        ST_MakeEmptyRaster(1, 1, 0, 0, 1, 1, 0, 0),
        ST_MakeEmptyRaster(1, 1, 0, 0, 1.1, 1.1, 0, 0)
    ),
    ST_NotSameAlignmentReason(
        ST_MakeEmptyRaster(1, 1, 0, 0, 1, 1, 0, 0),
        ST_MakeEmptyRaster(1, 1, 0, 0, 1.1, 1.1, 0, 0)
    )
;

 st_samealignment |            st_notsamealignmentreason
------------------+-------------------------------------------------
 f                | The rasters have different scales on the X axis
(1 row)

関連情報

the section called “ラスタのロードと生成”, ST_SameAlignment

Name

ST_Within — rastAがrastBの外部に点を持たず、rastAの内部の少なくとも一つの点がrastBの内部にある場合にTRUEを返します。

Synopsis

boolean ST_Within( | rastA, |
| nbandA, |
| rastB, |
| nbandB); |

raster rastA ;
integer nbandA ;
raster rastB ;
integer nbandB ;

boolean ST_Within( | rastA, |
| rastB); |

raster rastA ;
raster rastB ;

説明

rastAがrastBの外部に点を持たず、rastAの内部の少なくとも一つの点がrastBの内部にある場合にrastAはrastBに対してWithinです。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

Note

これのオペランドは、ラスタで使用できるインデクスを使用します。

Note

ラスタとジオメトリの空間関係をテストするには、ST_Within(ST_Polygon(raster), geometry)またはST_Within(geometry, ST_Polygon(raster))というふうに、ラスタにST_Polygonを使います。

Note

ST_Within()はST_Contains()の逆です。ST_Within(rastA, rastB)はST_Contains(rastB, rastA)を示します。

Availability: 2.1.0

例

SELECT r1.rid, r2.rid, ST_Within(r1.rast, 1, r2.rast, 1) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;

 rid | rid | st_within
-----+-----+-----------
   2 |   1 | f
   2 |   2 | t

関連情報

ST_Intersects, ST_Contains, ST_DWithin, ST_DFullyWithin

Name

ST_DWithin — rastAとrastBが指定した距離内にある場合にTRUEを返します。

Synopsis

boolean ST_DWithin( | rastA, |
| nbandA, |
| rastB, |
| nbandB, |
| distance_of_srid); |

raster rastA ;
integer nbandA ;
raster rastB ;
integer nbandB ;
double precision distance_of_srid ;

boolean ST_DWithin( | rastA, |
| rastB, |
| distance_of_srid); |

raster rastA ;
raster rastB ;
double precision distance_of_srid ;

説明

rastAとrastBが指定した距離内にある場合にTRUEを返します。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

distanceはラスタの空間参照系で定義される単位です。この関数が意味あるものにするには、元のラスタが両方とも同じ空間参照系である、つまり同じSRIDを持たなければなりません。

Note

これのオペランドは、ラスタで使用できるインデクスを使用します。

Note

ラスタとジオメトリの空間関係をテストするには、ST_DWithin(ST_Polygon(raster), geometry)というふうに、ラスタにST_Polygonを使います。

Availability: 2.1.0

例

SELECT r1.rid, r2.rid, ST_DWithin(r1.rast, 1, r2.rast, 1, 3.14) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;

 rid | rid | st_dwithin
-----+-----+------------
   2 |   1 | f
   2 |   2 | t

関連情報

ST_Within, ST_DFullyWithin

Name

ST_DFullyWithin — rastAとrastBが指定した距離内に完全に収まる場合にTRUEを返します。

Synopsis

boolean ST_DFullyWithin( | rastA, |
| nbandA, |
| rastB, |
| nbandB, |
| distance_of_srid); |

raster rastA ;
integer nbandA ;
raster rastB ;
integer nbandB ;
double precision distance_of_srid ;

boolean ST_DFullyWithin( | rastA, |
| rastB, |
| distance_of_srid); |

raster rastA ;
raster rastB ;
double precision distance_of_srid ;

説明

rastAとrastBが指定した距離内に完全に収まる場合にTRUEを返します。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

distanceはラスタの空間参照系で定義される単位です。この関数が意味あるものにするには、元のラスタが両方とも同じ空間参照系である、つまり同じSRIDを持たなければなりません。

Note

これのオペランドは、ラスタで使用できるインデクスを使用します。

Note

ラスタとジオメトリの空間関係をテストするには、ST_DFullyWithin(ST_Polygon(raster), geometry)というふうに、ラスタにST_Polygonを使います。

Availability: 2.1.0

例

SELECT r1.rid, r2.rid, ST_DFullyWithin(r1.rast, 1, r2.rast, 1, 3.14) FROM dummy_rast r1 CROSS JOIN dummy_rast r2 WHERE r1.rid = 2;

 rid | rid | st_dfullywithin
-----+-----+-----------------
   2 |   1 | f
   2 |   2 | t

関連情報

ST_Within, ST_DWithin

ラスタに関する技法

Abstract

本節では、PostGISラスタに関連する様々な落とし穴や技法について説明します。

データベース外ラスタ

多数のファイルを持つディレクトリ

GDALはファイルを開く時に、そのファイルのディレクトリを熱心にスキャンして、他のファイルのカタログを構築します。このディレクトリに多数のファイル (千とか万とか)あるとします。一つのファイルを開くと動作が非常に遅くなります (特にNFSのようなネットワークドライブの場合)。

この振る舞いを制御するために、GDALにはGDAL_DISABLE_READDIR_ON_OPENという環境変数があります。GDAL_DISABLE_READDIR_ON_OPENをTRUEに設定すると、ディレクトリのスキャンを無効にします。

Ubuntuでは (Ubuntu用PostgreSQLのパッケージを使っていると仮定します)、GDAL_DISABLE_READDIR_ON_OPENが/etc/postgresql/POSTGRESQL_VERSION/CLUSTER_NAME/environment内で設定できます (POSTGRESQL_VERSIONは9.6等のPostgreSQLのバージョンで、CLUSTER_NAMEはmaindb等のクラスタ名です)。PostGIS環境変数もここで同じく設定できます。

# postmasterプロセスの環境変数
# このファイルはpostgresql.confと同じ文法で、次のように書きます。
#  VARIABLE = simple_value
#  VARIABLE2 = 'any value!'
# 例えば、英数文字と'-', '_', '.' (のシングルクォート内)以外の文字を含む値を囲む必要があります。
# シェルコマンドは評価されません。
POSTGIS_GDAL_ENABLED_DRIVERS = 'ENABLE_ALL'

POSTGIS_ENABLE_OUTDB_RASTERS = 1

GDAL_DISABLE_READDIR_ON_OPEN = 'TRUE'

開くことができるファイルの最大数

LinuxとPostgreSQLが許している、開くことができるファイルの最大数は、通常は増加していません (通常、プロセスあたり1024ファイルです)。システムは人間のユーザが使用するという仮定に立っているからです。データベース外ラスタは、一つの妥当なクエリで簡単に制限超過させることができます (例えば、10年分のラスタからなるデータセットで、個々のラスタは日別最低気温、最大気温を持っていて、データセット内の最大値と最小値を得たい場合などです)。

最も簡単な変更方法は、PostgreSQL設定max_files_per_processです。デフォルトとして1000が設定されていますが、データベース外ラスタとしては非常に低い値です。安全な開始値は65536でしょう。ただし、実際には、これはデータベースとデータベースに対して実行されるクエリに依存します。サーバ開始時のみ、かつPostgreSQLコンフィギュレーションファイル (例: Ubuntu環境では/etc/postgresql/POSTGRESQL_VERSION/CLUSTER_NAME/postgresql.conf)内のみで設定できます。

...
# - カーネルリソースの使用状況 -

max_files_per_process = 65536           # min 25
                                        # (change requires restart)
...

主な変更はLinuxカーネルのファイルを開く制限です。次の通り、二つに分かれます。

システム全体で開くことができるファイルの最大数

プロセスごとに開くことができるファイルの最大数

システム全体で開くことができるファイルの最大数

次の例で、システム全体の、現在の開くことができるファイルの最大値を調べることができます。

$ sysctl -a | grep fs.file-max
fs.file-max = 131072

返された値が十分には大きくない場合には、次に示す例に従って、/etc/sysctl.d/にファイルを追加します。

$ echo "fs.file-max = 6145324"
>
> /etc/sysctl.d/fs.conf

$ cat /etc/sysctl.d/fs.conf
fs.file-max = 6145324

$ sysctl -p --system
* Applying /etc/sysctl.d/fs.conf ...
fs.file-max = 2097152
* Applying /etc/sysctl.conf ...

$ sysctl -a | grep fs.file-max
fs.file-max = 6145324

プロセスごとの開けるファイルの最大数

PostgreSQLのサーバプロセスごとに開けるファイルの最大数を増やす必要があります。

現在のPostgreSQLサービスのプロセスは開くことができるファイルの最大数を使っていて、次の例のようになっています (PostgreSQLが実行されていることを確認して下さい)。

$ ps aux | grep postgres
postgres 31713  0.0  0.4 179012 17564 pts/0    S    Dec26   0:03 /home/dustymugs/devel/postgresql/sandbox/10/usr/local/bin/postgres -D /home/dustymugs/devel/postgresql/sandbox/10/pgdata
postgres 31716  0.0  0.8 179776 33632 ?        Ss   Dec26   0:01 postgres: checkpointer process
postgres 31717  0.0  0.2 179144  9416 ?        Ss   Dec26   0:05 postgres: writer process
postgres 31718  0.0  0.2 179012  8708 ?        Ss   Dec26   0:06 postgres: wal writer process
postgres 31719  0.0  0.1 179568  7252 ?        Ss   Dec26   0:03 postgres: autovacuum launcher process
postgres 31720  0.0  0.1  34228  4124 ?        Ss   Dec26   0:09 postgres: stats collector process
postgres 31721  0.0  0.1 179308  6052 ?        Ss   Dec26   0:00 postgres: bgworker: logical replication launcher

$ cat /proc/31718/limits
Limit                     Soft Limit           Hard Limit           Units
Max cpu time              unlimited            unlimited            seconds
Max file size             unlimited            unlimited            bytes
Max data size             unlimited            unlimited            bytes
Max stack size            8388608              unlimited            bytes
Max core file size        0                    unlimited            bytes
Max resident set          unlimited            unlimited            bytes
Max processes             15738                15738                processes
Max open files            1024                 4096                 files
Max locked memory         65536                65536                bytes
Max address space         unlimited            unlimited            bytes
Max file locks            unlimited            unlimited            locks
Max pending signals       15738                15738                signals
Max msgqueue size         819200               819200               bytes
Max nice priority         0                    0
Max realtime priority     0                    0
Max realtime timeout      unlimited            unlimited            us

上の例では、プロセスに対する開くことができるファイルの制限が31718になっています。どのプロセスがどうするかは問題ではありません。関心を持っている応答はMax open filesです。

Max open filesのSoft LimitとHard LimitをPostgreSQLの設定で指定したmax_files_per_processよりも多くなるようにしたいと思っています。この例では、max_files_per_processを65536にしています。

Ubuntu (かつ、Ubuntu用PostgreSQLパッケージを使用しているものとします)では、Soft LimitとHard Limitの変更については、/etc/init.d/postgresql (SysV)または/lib/systemd/system/postgresql*.service (systemd)を編集するのが簡単な方法です。

まず、SysV Ubuntuを扱います。ulimit -H -n 262144とulimit -n 131072を/etc/init.d/postgresqlに追加します。

...
case "$1" in
    start|stop|restart|reload)
        if [ "$1" = "start" ]; then
            create_socket_directory
        fi
    if [ -z "`pg_lsclusters -h`" ]; then
        log_warning_msg 'No PostgreSQL clusters exist; see "man pg_createcluster"'
        exit 0
    fi

    ulimit -H -n 262144
    ulimit -n 131072

    for v in $versions; do
        $1 $v || EXIT=$?
    done
    exit ${EXIT:-0}
        ;;
    status)
...

Ubuntuのsystemdを扱います。LimitNOFILE=131072を/lib/systemd/system/postgresql*.serviceの各ファイルの[Service]セクション内に記述します。

...
[Service]

LimitNOFILE=131072

...

[Install]
WantedBy=multi-user.target
...

必要なシステムの変更を行った後、デーモンのリロードを必ず行ってください。

systemctl daemon-reload

Chapter 11. PostGIS追加機能

本章では、PostGISのソースアーカイブとソースレポジトリのextrasフォルダにある機能を記述します。 これらは必ずPostGISバイナリ版に同梱されているものではありませんが、通常は実行可能なplpgsqlベースのものまたは標準的なシェルスクリプトです。

住所標準化

これは、PAGC standardizerから分かれたものです (オリジナルのコードはPAGC PostgreSQL Address Standardizerにあります)。

住所標準化は単一行の住所のパーサで、入力に住所を取り、テーブルに保存された規則と、補助テーブルlex (lexicon, 語彙)およびgaz (gazetteer, 地名集)とを基に正規化します。

コードは、address_standardizerという名前の、一つのPostgreSQLエクステンションとしてビルドされます。CREATE EXTENSION address_standardizer;でインストールできます。address_standardizerエクステンションとともに、address_standardizer_data_usというサンプルデータのエクステンションがビルドされます。これには、アメリカのgaz, lexとrulesテーブルデータがあります。このエクステンションはCREATE EXTENSION address_standardizer_data_us;でインストールできます。

このエクステンションのコードはPostGISのextensions/address_standardizer内にあり、現在は自己充足しています。

インストール手順については、the section called “PAGC住所標準化ツールのインストールと使用”を参照してください。

パーサの動作

パーサは右から左に見ます。最初に郵便番号、州/県、市のMACRO (訳注: マクロ)要素を見ます。その後、番地または交差点もしくはランドマークを扱う場合には、MICRO (訳注: マイクロ)要素を見ます。現在は、国別コードや国名を見ませんが、将来的には導入できると思います。

国別コード

USまたはCAを仮定します。郵便番号か州/県で米国かカナダを分けますが、判別できない場合は米国とします。

郵便番号

Perl互換の正規表現を使用して認識します。正規表現は現在はparseaddress-api.cにあり、必要な際の変更は比較的簡単です。

州/県

Perl互換の正規表現を使用して認識します。正規表現は現在はparseaddress-api.cにありますが、将来的には、メンテナンスを簡単にするためにインクルードファイルに移動するかも知れません。

住所標準化の型

Abstract

本節では住所標準化でインストールされたPostgreSQLデータ型の一覧を挙げます。独自関数をデザインする時に特に重要となるキャストの振る舞いを記述しています。

住所標準化テーブル

Abstract

本節では、住所標準化が住所の正規化に使うPostgreSQLテーブルの書式を挙げます。これらのテーブルはここで参照している名前と同じである必要はありません。例または独自ジオコーダのために、国ごとに異なるlex (lexicon, 語彙)、gaz (gazetteer, 地名集)およびrulesテーブルを持つことができます。これらのテーブルの名前は、住所標準化関数に渡されます。

同梱されているaddress_standardizer_data_usエクステンションには、米国の住所標準化のためのデータがあります。

住所標準化関数

Tigerジオコーダ

Abstract

米国国勢調査局が公開しているTIGER (Topologically Integrated Geographic Encoding and Referencing system ) / Line and Master Address database exportで動作するよう書かれた、PL/pgSQLベースのジオコーダです。

データローダ機能、住所正規化、住所ジオコーダおよび逆ジオコーダ、の四つの要素があります。

米国のための設計ですが、概念および機能の多くは適用可能で、他国の住所と道路ネットワークで動作するように適合させることができます (訳注: 日本の地名については未知です)。

Tiger関連の関数、道路型前置辞・道路型後置辞・州といった再利用可能な参照データ、データロード管理のための様々な制御テーブル、全てのロードされたテーブルが継承するスケルトンテーブル、を収容するためのtigerというスキーマが、スクリプトによって作成されます。

tiger_dataという、もう一つのスキーマが作られます。ここに、ローダが米国国勢調査サイトからダウンロードしてデータベースにロードした州ごとの全ての国勢調査データが収容されます。現在のモデルでは、州ごとのテーブルは、ma_addrやma_edgesといったように名前の先頭に州コードを付けていて、州データのみに強制する制約が付いています。これらのテーブルはtiger schemaにあるaddr, faces, edges等から継承されています。

全てのジオコード関数は基底テーブルを参照するだけです。そのため、tiger_dataデータスキーマやそのデータを他のスキーマに分割できないという条件はありません。例えば、州ごとに異なるスキーマにしても、tiger内のテーブルから継承されているなら使用可能です。

お手持ちのデータベース内のエクステンションを有効にし、使用するデータをロードする方法については、the section called “TigerジオコーダをPostGISデータベースで有効にする”を参照して下さい。

Note

Tigerジオコーダ (tiger_2010)を使っている場合には、extras/tiger内にあるupgrade_geocoder.bat / .sh を使ってアップグレードすることができます。tiger_2010とtiger_2011以上での大きな変更点は、countyテーブルとstateテーブルが、stateごとに出現することがなくなっています。tiger_2010からのデータを持っていて、tiger_2015に置き換えたい場合には、the section called “Tigerジオコーダとデータのアップグレード”を参照して下さい。

Note

PostGIS 2.2.0での新規機能は、Tiger 2015データに対応したことと、住所標準化がPostGISの一部に取り入れられたことです。

PostGIS 2.1.0での新規機能は、PostgreSQL 9.1以上では、TigerジオコーダをPostgreSQLエクステンションモデルでインストールすることができるようになったことです。詳細についてはthe section called “TigerジオコーダをPostGISデータベースで有効にする”を参照して下さい。

PostGISが用意しているNormalize_Addressの代替としてPagc_Normalize_Address関数があります。コンパイルとインストールの方法については、the section called “PAGC住所標準化ツールのインストールと使用”を参照して下さい。

設計:

このプロジェクトの目標は、任意の米国住所文字列を処理し、正規化したTiger国勢調査データを使ってポイントジオメトリを生成し、与えられた住所の位置や、位置のもっともらしさを反映した評価値を算出する、十分に実用的なジオコーダを構築することです。なお、評価値は高いほど悪い結果とします。

PostGIS 2.0.0で導入されたreverse_geocodeは、GPS位置のストリート住所と交差点を得るのに便利です。

ジオコーダは、PostGISに慣れている方ならだれでもインストールと使用が容易な程度に単純であるべきで、PostGISがサポートする全てのプラットフォームで簡便にインストール、使用ができるべきです。

書式や綴りの誤りがあっても確実に機能するための十分なロバスト性があるべきです。

将来のデータ更新が使えるか、最小のプログラムの変更で他のデータが使えるための十分な拡張性もあるべきです。

Note

関数が確実に動作するために、tigerスキーマは、データベース検索パスに追加されていなければなりません。

PostGIS用の二つのオープンソースジオコーダがあります。これらはTigerジオコーダと違い、他国のジオコーディングに対応している利点があります。

Nominatimは、OpenStreetMapの地名集データを使います。データのロードにはosm2pgsqlが必要です。PostgreSQL 8.4以上とPostGIS 1.5以上が必要です。Webサービスのインタフェースとして作られていて、Webサービスと呼ばれるような設計に見えます。Tigerジオコーダと同じように、ジオコーダと逆ジオコーダの要素を持ちます。文書からでは、Tigerジオコーダのような純粋なSQLインタフェースを持っているのか、多くの処理がWebインタフェースに実装されているのか、は明確ではありません。

GIS Graphyも、PostGISを使用したもので、NominatimのようにOpenStreetMap (OSM)データを使用します。OSMデータのロードを行うローダとNominatimのように米国だけでなくジオコーディングを行う能力があります。Nominatimとよく似ていて、Webサービスとして動作し、Java 1.5、サーブレットアプリケーション、Apache Solrに依存しています。GisGraphyは、複数プラットフォームで動作し、他の機能の中には逆ジオコーダがあります。

Name

Drop_Indexes_Generate_Script — tigerスキーマとユーザが指定したスキーマ上の、全ての主キーでなく、かつユニークでないインデックスを削除します。スキーマを指定しない場合のデフォルトスキーマは、tiger_dataです。

Synopsis

text Drop_Indexes_Generate_Script(
param_schema=tiger_data);

text param_schema=tiger_data;

説明

tigerスキーマとユーザが指定したスキーマ上の、全ての主キーでなく、かつユニークでないインデックスを削除します。スキーマを指定しない場合のデフォルトスキーマは、tiger_dataです。

PostgreSQLのクエリプランナを混乱させる可能性があり、不要なディスク容量を取る、インデックスの膨張を最小化するために使います。ジオコーダで使われるインデックスを追加する関数Install_Missing_Indexesを併用します。

Availability: 2.0.0

例

SELECT drop_indexes_generate_script() As actionsql;
actionsql
---------------------------------------------------------
DROP INDEX tiger.idx_tiger_countysub_lookup_lower_name;
DROP INDEX tiger.idx_tiger_edges_countyfp;
DROP INDEX tiger.idx_tiger_faces_countyfp;
DROP INDEX tiger.tiger_place_the_geom_gist;
DROP INDEX tiger.tiger_edges_the_geom_gist;
DROP INDEX tiger.tiger_state_the_geom_gist;
DROP INDEX tiger.idx_tiger_addr_least_address;
DROP INDEX tiger.idx_tiger_addr_tlid;
DROP INDEX tiger.idx_tiger_addr_zip;
DROP INDEX tiger.idx_tiger_county_countyfp;
DROP INDEX tiger.idx_tiger_county_lookup_lower_name;
DROP INDEX tiger.idx_tiger_county_lookup_snd_name;
DROP INDEX tiger.idx_tiger_county_lower_name;
DROP INDEX tiger.idx_tiger_county_snd_name;
DROP INDEX tiger.idx_tiger_county_the_geom_gist;
DROP INDEX tiger.idx_tiger_countysub_lookup_snd_name;
DROP INDEX tiger.idx_tiger_cousub_countyfp;
DROP INDEX tiger.idx_tiger_cousub_cousubfp;
DROP INDEX tiger.idx_tiger_cousub_lower_name;
DROP INDEX tiger.idx_tiger_cousub_snd_name;
DROP INDEX tiger.idx_tiger_cousub_the_geom_gist;
DROP INDEX tiger_data.idx_tiger_data_ma_addr_least_address;
DROP INDEX tiger_data.idx_tiger_data_ma_addr_tlid;
DROP INDEX tiger_data.idx_tiger_data_ma_addr_zip;
DROP INDEX tiger_data.idx_tiger_data_ma_county_countyfp;
DROP INDEX tiger_data.idx_tiger_data_ma_county_lookup_lower_name;
DROP INDEX tiger_data.idx_tiger_data_ma_county_lookup_snd_name;
DROP INDEX tiger_data.idx_tiger_data_ma_county_lower_name;
DROP INDEX tiger_data.idx_tiger_data_ma_county_snd_name;
:
:

関連情報

Install_Missing_Indexes, Missing_Indexes_Generate_Script

Name

Drop_Nation_Tables_Generate_Script — 指定したスキーマ内のテーブルのうち、county_all, state_allまたは、county or stateを削除するスクリプトを生成します。

Synopsis

text Drop_Nation_Tables_Generate_Script(
param_schema=tiger_data);

text param_schema=tiger_data;

説明

指定したスキーマ内のテーブルのうち、名前がcounty_all、state_all、(州コード)_county、(州コード)_stateで始まるテーブルを全て削除するスクリプトを生成します。 tiger_2010データからtiger_2011データに更新する際に必要です。

Availability: 2.1.0

例

SELECT drop_nation_tables_generate_script();
DROP TABLE tiger_data.county_all;
DROP TABLE tiger_data.county_all_lookup;
DROP TABLE tiger_data.state_all;
DROP TABLE tiger_data.ma_county;
DROP TABLE tiger_data.ma_state;

関連情報

Loader_Generate_Nation_Script

Name

Drop_State_Tables_Generate_Script — 指定したスキーマ内の、名前が州コードから始まるテーブルを全て削除するスクリプトを生成します。スキーマが指定されていない場合のデフォルトスキーマはtiger_dataです。

Synopsis

text Drop_State_Tables_Generate_Script( | param_state, |
| param_schema=tiger_data); |

text param_state;
text param_schema=tiger_data;

説明

指定したスキーマ内の、名前が州コードから始まるテーブルを全て削除するスクリプトを生成します。スキーマが指定されていない場合のデフォルトスキーマはtiger_dataです。ある州の以前のデータのロードがうまくいかずに再ロードする際に使います。

Availability: 2.0.0

例

SELECT drop_state_tables_generate_script('PA');
DROP TABLE tiger_data.pa_addr;
DROP TABLE tiger_data.pa_county;
DROP TABLE tiger_data.pa_county_lookup;
DROP TABLE tiger_data.pa_cousub;
DROP TABLE tiger_data.pa_edges;
DROP TABLE tiger_data.pa_faces;
DROP TABLE tiger_data.pa_featnames;
DROP TABLE tiger_data.pa_place;
DROP TABLE tiger_data.pa_state;
DROP TABLE tiger_data.pa_zip_lookup_base;
DROP TABLE tiger_data.pa_zip_state;
DROP TABLE tiger_data.pa_zip_state_loc;

関連情報

Loader_Generate_Script

Name

Geocode — 住所を文字列 (もしくは他の正規化された住所)として取り、可能性のある位置の集合を返します。返される集合の要素は、NAD 83経度緯度のポイントジオメトリ、正規化された住所と評価値を持ちます。評価値は低いほど可能性が高いことを示しています。結果は評価値の低い順に並べ替えられます。オプションにmax_result (最大結果数、デフォルトは10)とrestrict_region (制限領域、デフォルトはNULL)を渡すことができます。

Synopsis

setof record geocode( | address, |
| max_results=10, |
| restrict_region=NULL, |
| OUT addy, |
| OUT geomout, |
| OUT rating); |

varchar address;
integer max_results=10;
geometry restrict_region=NULL;
norm_addy OUT addy;
geometry OUT geomout;
integer OUT rating;

setof record geocode( | in_addy, |
| max_results=10, |
| restrict_region=NULL, |
| OUT addy, |
| OUT geomout, |
| OUT rating); |

norm_addy in_addy;
integer max_results=10;
geometry restrict_region=NULL;
norm_addy OUT addy;
geometry OUT geomout;
integer OUT rating;

説明

文字列住所 (または正規化された住所)を引数に取り、NAD 83経度緯度のポイントジオメトリ (geomout)、個々のnormalized_address (addy)、評価値 (rating)からなる、可能性のある位置の集合を出力します。評価値が低いほど合致度が高くなります。Tigerデータ (エッジ、フェイス、住所)、PostgreSQLあいまい文字列合致 (soundex,levenshtein)を使い、Tigerデータのエッジに沿った住所の補間のためにPostGIS線補間関数を使用っています。評価値が高いほどジオコードの正確度が低くなります。ジオコードされたポイントは、ストリート住所を中心線から左/右に移動しますが、デフォルトでは10メートルです。

Enhanced: 2.0.0 Tiger 2010構造のデータに対応しました。実行速度とジオコーディング精度を改善し、ストリート住所の位置を中心線から側線に移動するための改訂を行いました。また、良い結果の数を指定したり、最も良い結果だけを返すようにするのに使う新しいパラメータmax_resultsを導入しました。

例: 基本

下の例は、3.0GHzの単一プロセッサと2GBのメモリを持つWindows 7機で、PostgreSQL 9.1rc1/PostGIS 2.0を走らせて、MA, MN, CA, RI の各州のTigerデータをロードしたものです。

完全一致は速いです (61ミリ秒)

SELECT g.rating, ST_X(g.geomout) As lon, ST_Y(g.geomout) As lat,
    (addy).address As stno, (addy).streetname As street,
    (addy).streettypeabbrev As styp, (addy).location As city, (addy).stateabbrev As st,(addy).zip
    FROM geocode('75 State Street, Boston MA 02109', 1) As g;
 rating |        lon        |      lat       | stno | street | styp |  city  | st |  zip
--------+-------------------+----------------+------+--------+------+--------+----+-------
      0 | -71.0557505845646 | 42.35897920691 |   75 | State  | St   | Boston | MA | 02109

郵便番号を渡さない場合でも推測可能です (122-150ミリ秒かかりました)

SELECT g.rating, ST_AsText(ST_SnapToGrid(g.geomout,0.00001)) As wktlonlat,
    (addy).address As stno, (addy).streetname As street,
    (addy).streettypeabbrev As styp, (addy).location As city, (addy).stateabbrev As st,(addy).zip
    FROM geocode('226 Hanover Street, Boston, MA',1) As g;
 rating |         wktlonlat         | stno | street  | styp |  city  | st |  zip
--------+---------------------------+------+---------+------+--------+----+-------
      1 | POINT(-71.05528 42.36316) |  226 | Hanover | St   | Boston | MA | 02113

綴りの誤りを処理して、一つ以上の可能性のある答を評価値付きで提供すると遅くなります (500ミリ秒)。

SELECT g.rating, ST_AsText(ST_SnapToGrid(g.geomout,0.00001)) As wktlonlat,
    (addy).address As stno, (addy).streetname As street,
    (addy).streettypeabbrev As styp, (addy).location As city, (addy).stateabbrev As st,(addy).zip
    FROM geocode('31 - 37 Stewart Street, Boston, MA 02116',1) As g;
 rating |         wktlonlat         | stno | street | styp |  city  | st |  zip
--------+---------------------------+------+--------+------+--------+----+-------
     70 | POINT(-71.06466 42.35114) |   31 | Stuart | St   | Boston | MA | 02116

複数住所のジオコードバッチ処理を行います。max_results=1とすると最も簡単です。まだジオコードを行っていない (評価値が無い)もののみ処理します。

CREATE TABLE addresses_to_geocode(addid serial PRIMARY KEY, address text,
        lon numeric, lat numeric, new_address text, rating integer);

INSERT INTO addresses_to_geocode(address)
VALUES ('529 Main Street, Boston MA, 02129'),
 ('77 Massachusetts Avenue, Cambridge, MA 02139'),
 ('25 Wizard of Oz, Walaford, KS 99912323'),
 ('26 Capen Street, Medford, MA'),
 ('124 Mount Auburn St, Cambridge, Massachusetts 02138'),
 ('950 Main Street, Worcester, MA 01610');

-- 全体のジオコードでは、必ず一度コミットが行われます。
-- 多数の住所があって、一度に全てを更新したくない場合として、
-- 最初の三つのアドレスだけ更新します。
-- (323-704ミリ秒 - キャッシュと共有メモリがあるので、最初のジオコーディングは必ず遅くなります)
-- この例では、間違った住所の逆ジオコーディングをしないよう、
-- LEFT JOINで再結合して、合致しないものには-1の評価値を設定しています。
UPDATE addresses_to_geocode
  SET  (rating, new_address, lon, lat)
    = ( COALESCE(g.rating,-1), pprint_addy(g.addy),
       ST_X(g.geomout)::numeric(8,5), ST_Y(g.geomout)::numeric(8,5) )
FROM (SELECT addid, address
    FROM addresses_to_geocode
    WHERE rating IS NULL ORDER BY addid LIMIT 3) As a
    LEFT JOIN LATERAL geocode(a.address,1) As g ON true
WHERE a.addid = addresses_to_geocode.addid;

結果
-----
Query returned successfully: 3 rows affected, 480 ms execution time.

SELECT * FROM addresses_to_geocode WHERE rating is not null;

 addid |                   address                    |    lon    |   lat    |                new_address                | rating
-------+----------------------------------------------+-----------+----------+-------------------------------------------+--------
     1 | 529 Main Street, Boston MA, 02129            | -71.07177 | 42.38357 | 529 Main St, Boston, MA 02129             |      0
     2 | 77 Massachusetts Avenue, Cambridge, MA 02139 | -71.09396 | 42.35961 | 77 Massachusetts Ave, Cambridge, MA 02139 |      0
     3 | 25 Wizard of Oz, Walaford, KS 99912323       | -97.92913 | 38.12717 | Willowbrook, KS 67502                     |    108
(3 rows)

例: ジオメトリフィルタの使用

SELECT g.rating, ST_AsText(ST_SnapToGrid(g.geomout,0.00001)) As wktlonlat,
    (addy).address As stno, (addy).streetname As street,
    (addy).streettypeabbrev As styp,
    (addy).location As city, (addy).stateabbrev As st,(addy).zip
  FROM geocode('100 Federal Street, MA',
        3,
        (SELECT ST_Union(the_geom)
            FROM place WHERE statefp = '25' AND name = 'Lynn')::geometry
        ) As g;

 rating |         wktlonlat         | stno | street  | styp | city | st |  zip
--------+---------------------------+------+---------+------+------+----+-------
      7 | POINT(-70.96796 42.4659)  |  100 | Federal | St   | Lynn | MA | 01905
     16 | POINT(-70.96786 42.46853) | NULL | Federal | St   | Lynn | MA | 01905
(2 rows)

Time: 622.939 ms

関連情報

Normalize_Address, Pprint_Addy, ST_AsText, ST_SnapToGrid, ST_X, ST_Y

Name

Geocode_Intersection — インタセクトする二つのストリート、州コード、市名、郵便番号を引数に取り、最初の交差点の可能性のある位置の集合を出力します。geomoutにNAD83経度緯度のポイント、normalized_addressにそれぞれの位置、ratingに評価値がそれぞれ入ります。評価値が低いほど合致度が高くなります。結果は評価値の低い順にソートされます。最大結果数を渡すことができ、デフォルトは10です。Tigerデータ (エッジ、フェイス、住所)と、PostgreSQLあいまい文字列合致 (soundex, levenshtein)を使います。

Synopsis

setof record geocode_intersection( | roadway1, |
| roadway2, |
| in_state, |
| in_city, |
| in_zip, |
| max_results=10, |
| OUT addy, |
| OUT geomout, |
| OUT rating); |

text roadway1;
text roadway2;
text in_state;
text in_city;
text in_zip;
integer max_results=10;
norm_addy OUT addy;
geometry OUT geomout;
integer OUT rating;

説明

インタセクトする二つのストリート、州コード、市名、郵便番号を引数に取り、最初の交差点の可能性のある位置の集合を出力します。集合の要素は、NAD83経度緯度のポイント、正規化された住所、評価値を持ちます。評価値が低いほど合致度が高くなります。結果は評価値の低い順にソートされます。最大結果数を渡すことができ、デフォルトは10です。normalized_address (addy)、NAD83経度緯度のポイントとしてgeomout、評価値としてratingを返します。評価値が低いほど合致度が高くなります。結果は評価値の低い順にソートされます。Tigerデータ (エッジ、フェイス、住所)と、PostgreSQLあいまい文字列合致 (soundex, levenshtein)を使います。

Availability: 2.0.0

例: 基本

下の例では、3.0GHz単一プロセッサで2GBメモリのWindows 7機上でPostgreSQL 9.0/PostGIS 1.5を走らせ、マサチューセッツ州のTigerデータをロードしています。この場合は、少し遅いです (3000ミリ秒)。

Windows 2003 64ビット 8GBでPostGIS 2.0、PostgreSQL 64ビット版を動かし、Tiger 2011データがロードされている場合もテストしています (41ミリ秒)。

SELECT pprint_addy(addy), st_astext(geomout),rating
            FROM geocode_intersection( 'Haverford St','Germania St', 'MA', 'Boston', '02130',1);
           pprint_addy            |         st_astext          | rating
----------------------------------+----------------------------+--------
98 Haverford St, Boston, MA 02130 | POINT(-71.101375 42.31376) |      0

郵便番号をジオコーダに渡さない場合でも動作し、Windows 2003 64ビットで741ミリ秒でした(Windows 7機で3500ミリ秒)。

SELECT pprint_addy(addy), st_astext(geomout),rating
                FROM geocode_intersection('Weld', 'School', 'MA', 'Boston');
          pprint_addy          |        st_astext         | rating
-------------------------------+--------------------------+--------
 98 Weld Ave, Boston, MA 02119 | POINT(-71.099 42.314234) |      3
 99 Weld Ave, Boston, MA 02119 | POINT(-71.099 42.314234) |      3

関連情報

Geocode, Pprint_Addy, ST_AsText

Name

Get_Geocode_Setting — tiger.geocode_settingsテーブルに格納されている設定のうち指定したものの値を返します。

Synopsis

text Get_Geocode_Setting(
setting_name);

text setting_name;

説明

tiger.geocode_settingsテーブルに格納されている設定のうち指定したものの値を返します。設定によって、関数のデバッグの制御が可能です。今後の予定では、評価値の制御ができるようにします。現在の設定は次の通りです。

name              | setting |  unit   | category  |                                                             short_desc
--------------------------------+---------+---------+-----------+------------------------------------------------------------------------------------------------------------------------------
 debug_geocode_address          | false   | boolean | debug     | trueの場合には、geocode_addressが呼ばれた時に、クエリ等のデバッグ情報をNOTICEログに出力します
 debug_geocode_intersection     | false   | boolean | debug     | trueの場合には、geocode_intersectionが呼ばれた時に、クエリ等のデバッグ情報をNOTICEログに出力します
 debug_normalize_address        | false   | boolean | debug     | trueの場合には、normalize_addressが呼ばれた時に、クエリや中間表現等のデバッグ情報をNOTICEログに出力します
 debug_reverse_geocode          | false   | boolean | debug     | trueの場合には、reverse_geocodeが呼ばれた時に、クエリや中間表現等のデバッグ情報をNOTICEログに出力します
 reverse_geocode_numbered_roads | 0       | integer | rating    | 州道名と郡道名について、0-どの名前でもよい、1-道路番号優先、2-州/郡名優先
 use_pagc_address_parser        | false   | boolean | normalize | trueの場合には、address_standardizer (pagc_normalize_address経由)を使おうと試みます。

Changed: 2.2.0 : デフォルト設定をgeocode_settingsに保存するようにしました。ユーザが設定したものだけがgeocode_settings内にあります。

Availability: 2.1.0

デバッグ設定を返す例

SELECT get_geocode_setting('debug_geocode_address) As result;
result
---------
false

関連情報

Set_Geocode_Setting

Name

Get_Tract — ジオメトリで指定した位置の米国国勢調査統計区またはtractテーブルのフィールドを返します。デフォルトでは、統計区の短縮名を返します。

Synopsis

text get_tract( | loc_geom, |
| output_field=name); |

geometry loc_geom;
text output_field=name;

説明

ジオメトリを与えると、ジオメトリの位置の米国国勢調査統計区を返します。空間参照系を指定しない場合には、NAD83経度緯度と仮定します。

Note

この関数はセンサスのtractを使用しますが、これはデフォルトではロードされません。すでに州テーブルをロード済みなら、Loader_Generate_Census_Scriptスクリプトを使って、tractを、bgおよびtabblockと共にロードできます。

州データをロードしていなくて、これらの追加テーブルをロードしたい場合には、次のようにします。

UPDATE tiger.loader_lookuptables SET load = true WHERE load = false AND lookup_name IN('tract', 'bg', 'tabblock');

これらは、Loader_Generate_Scriptによって取り込まれます。

Availability: 2.0.0

例: 基本

SELECT get_tract(ST_Point(-71.101375, 42.31376) ) As tract_name;
tract_name
---------
1203.01

-- Tigerの地理識別子を返します
SELECT get_tract(ST_Point(-71.101375, 42.31376), 'tract_id' ) As tract_id;
tract_id
---------
25025120301

関連情報

Geocode >

Name

Install_Missing_Indexes — ジオコーダで結合や検索条件に使われ、インデックスが付いていなキーカラムを持つ全てのテーブルを探し、インデックスを追加します。

Synopsis

boolean Install_Missing_Indexes(
);

;

説明

ジオコーダで結合や検索条件に使われ、インデックスが付いていなキーカラムを持つ、tigerスキーマとtiger_dataスキーマ内の全てのテーブルを探し、これらのテーブルにインデックスを追加するためのSQLデータ定義言語を出力し、実行します。これは、クエリの動作速度を上げるのに必要であるのにロード処理で失われたインデックスを追加するのを助ける関数です。インデックス追加スクリプトの生成と実行を行うMissing_Indexes_Generate_Scriptの仲間です。この関数はupdate_geocode.sql更新スクリプトの一部として呼ばれます。

Availability: 2.0.0

例

SELECT install_missing_indexes();
         install_missing_indexes
-------------------------
 t

関連情報

Loader_Generate_Script, Missing_Indexes_Generate_Script

Name

Loader_Generate_Census_Script — 指定した州について、tract (統計区)、bg (block group, 細分区グループ)、tabblock (ブロック)をダウンロードし、tiger_dataに格納するための、指定したプラットフォーム用のシェルスクリプトを生成します。行ごとに州ごとのスクリプトが返されます。

Synopsis

setof text loader_generate_census_script( | param_states, |
| os); |

text[] param_states;
text os;

説明

指定した州について、tract (統計区)、bg (block group, 細分区グループ)、tabblock (ブロック)をダウンロードし、tiger_dataに格納するための、指定したプラットフォーム用のシェルスクリプトを生成します。行ごとに州ごとのスクリプトが返されます。

ダウンロードには、Linuxではunzip (Windowsのデフォルトは7-zip)とwgetとを使います。データの格納にはthe section called “シェープファイルローダを使う”を使います。最小単位は州全体です。生成されるスクリプトは、格納準備中の一時フォルダ内にあるファイルのみ処理します。

プロセスの制御や異なるOSのシェルの書式の制御のために、次の制御テーブルを使います。

loader_variables 国勢調査ダウンロードサイト、年度、データと準備スキーマといった種々の変数の軌跡を保持します。

loader_platform 種々のプラットフォームのプロファイルと種々の実行ファイルを置いてある位置です。windowsとLinux/unixを備えています。追加も可能です。

loader_lookuptables レコードごとにテーブルの種類 (州、国)、レコード処理の有無、ロード方法を定義しています。データインポート方法、データ格納準備、カラム追加、カラム削除、インデックス、制約がそれぞれで定義されています。個々のテーブルは、名前の先頭に州コードを持ち、tigerスキーマのテーブルから継承されています。たとえば、tiger.facesから継承したtiger_data.ma_facesの生成といったことが行われます。

Availability: 2.0.0

Note

Loader_Generate_Script は、このロジックを含んでいますが、PostGIS 2.0.0 alpha 5より前にTigerジオコーダをインストールしてLoader_Generate_Scriptを実行した場合には、これを実行する必要があります。

例

Windowsシェルスクリプト書式での選択した州のデータをロードするスクリプトの生成。

SELECT loader_generate_census_script(ARRAY['MA'], 'windows');
-- 結果 --
set STATEDIR="\gisdata\www2.census.gov\geo\pvs\tiger2010st\25_Massachusetts"
set TMPDIR=\gisdata\temp\
set UNZIPTOOL="C:\Program Files\7-Zip\7z.exe"
set WGETTOOL="C:\wget\wget.exe"
set PGBIN=C:\projects\pg\pg91win\bin\
set PGPORT=5432
set PGHOST=localhost
set PGUSER=postgres
set PGPASSWORD=yourpasswordhere
set PGDATABASE=tiger_postgis20
set PSQL="%PGBIN%psql"
set SHP2PGSQL="%PGBIN%shp2pgsql"
cd \gisdata

%WGETTOOL% http://www2.census.gov/geo/pvs/tiger2010st/25_Massachusetts/25/ --no-parent --relative --accept=*bg10.zip,*tract10.zip,*tabblock10.zip --mirror --reject=html
del %TMPDIR%\*.* /Q
%PSQL% -c "DROP SCHEMA tiger_staging CASCADE;"
%PSQL% -c "CREATE SCHEMA tiger_staging;"
cd %STATEDIR%
for /r %%z in (*.zip) do %UNZIPTOOL% e %%z  -o%TMPDIR%
cd %TMPDIR%
%PSQL% -c "CREATE TABLE tiger_data.MA_tract(CONSTRAINT pk_MA_tract PRIMARY KEY (tract_id) ) INHERITS(tiger.tract); "
%SHP2PGSQL% -c -s 4269 -g the_geom   -W "latin1" tl_2010_25_tract10.dbf tiger_staging.ma_tract10 | %PSQL%
%PSQL% -c "ALTER TABLE tiger_staging.MA_tract10 RENAME geoid10 TO tract_id;  SELECT loader_load_staged_data(lower('MA_tract10'), lower('MA_tract')); "
%PSQL% -c "CREATE INDEX tiger_data_MA_tract_the_geom_gist ON tiger_data.MA_tract USING gist(the_geom);"
%PSQL% -c "VACUUM ANALYZE tiger_data.MA_tract;"
%PSQL% -c "ALTER TABLE tiger_data.MA_tract ADD CONSTRAINT chk_statefp CHECK (statefp = '25');"
:

shスクリプトの生成

STATEDIR="/gisdata/www2.census.gov/geo/pvs/tiger2010st/25_Massachusetts"
TMPDIR="/gisdata/temp/"
UNZIPTOOL=unzip
WGETTOOL="/usr/bin/wget"
export PGBIN=/usr/pgsql-9.0/bin
export PGPORT=5432
export PGHOST=localhost
export PGUSER=postgres
export PGPASSWORD=yourpasswordhere
export PGDATABASE=geocoder
PSQL=${PGBIN}/psql
SHP2PGSQL=${PGBIN}/shp2pgsql
cd /gisdata

wget http://www2.census.gov/geo/pvs/tiger2010st/25_Massachusetts/25/ --no-parent --relative --accept=*bg10.zip,*tract10.zip,*tabblock10.zip --mirror --reject=html
rm -f ${TMPDIR}/*.*
${PSQL} -c "DROP SCHEMA tiger_staging CASCADE;"
${PSQL} -c "CREATE SCHEMA tiger_staging;"
cd $STATEDIR
for z in *.zip; do $UNZIPTOOL -o -d $TMPDIR $z; done
:
:

関連情報

Loader_Generate_Script

Name

Loader_Generate_Script — 指定したプラットフォーム用の、指定した州のTigerデータをダウンロードし、格納準備を行い、tiger_dataスキーマに格納するシェルスクリプトを生成します。行ごとに州ごとのスクリプトが返ります。最新版ではTiger 2010のデータ構造変更に対応していて、国勢統計区、細分区グループ、細分区 (tabblocks)テーブルをダウンロードすることができます。

Synopsis

setof text loader_generate_script( | param_states, |
| os); |

text[] param_states;
text os;

説明

指定したプラットフォーム用の、指定した州のTigerデータをダウンロードし、格納準備を行い、tiger_dataスキーマに格納するシェルスクリプトを生成します。行ごとに州ごとのスクリプトが返ります。

ダウンロードには、Linuxではunzip (Windowsのデフォルトは7-zip)とwgetとを使います。データの格納にはthe section called “シェープファイルローダを使う”を使います。ダウンロードの最小単位は州全体ですが、ファイルを手動でダウンロードすることで上書きできます。生成されるスクリプトは、格納準備中の一時フォルダ内にあるファイルのみ処理します。

プロセスの制御や異なるOSのシェルの書式の制御のために、次の制御テーブルを使います。

loader_variables 国勢調査ダウンロードサイト、年度、データと準備スキーマといった種々の変数の軌跡を保持します。

loader_platform 種々のプラットフォームのプロファイルと種々の実行ファイルを置いてある位置です。windowsとLinux/unixを備えています。追加も可能です。

loader_lookuptables レコードごとにテーブルの種類 (州、国)、レコード処理の有無、ロード方法を定義しています。データインポート方法、データ格納準備、カラム追加、カラム削除、インデックス、制約がそれぞれで定義されています。個々のテーブルは、名前の先頭に州コードを持ち、tigerスキーマのテーブルから継承されています。たとえば、tiger.facesから継承したtiger_data.ma_facesの生成といったことが行われます。

Availability: 2.0.0 Tiger 2010構造のデータに対応しました。国勢統計区 (tract)、細分区グループ ("block groups", bg)、細分区 (tabblocks)テーブルをダウンロードします。

Note

pgAdmin 3を使用している場合には、pgAdmin 3はデフォルトでは長い文字列を切り捨てることに注意して下さい。修正するには、ファイル -> オプション -> クエリツール -> クエリエディタ -> カラムあたり最大文字数を50000文字以上に変更します。

例

gistestが使用中のデータベースで、また/gisdata/data_load.shが実行するシェルコマンドを使って生成するファイルとすると、psqlを使って次のようにします。

psql -U postgres -h localhost -d gistest -A -t \
 -c "SELECT Loader_Generate_Script(ARRAY['MA'], 'gistest')"
> /gisdata/data_load.sh;

Windowsシェルスクリプト書式で二つの州のデータをロードするスクリプトを生成します。

SELECT loader_generate_script(ARRAY['MA','RI'], 'windows') AS result;
-- 結果 --
set TMPDIR=\gisdata\temp\
set UNZIPTOOL="C:\Program Files\7-Zip\7z.exe"
set WGETTOOL="C:\wget\wget.exe"
set PGBIN=C:\Program Files\PostgreSQL\9.4\bin\
set PGPORT=5432
set PGHOST=localhost
set PGUSER=postgres
set PGPASSWORD=yourpasswordhere
set PGDATABASE=geocoder
set PSQL="%PGBIN%psql"
set SHP2PGSQL="%PGBIN%shp2pgsql"
cd \gisdata

cd \gisdata
%WGETTOOL% ftp://ftp2.census.gov/geo/tiger/TIGER2015/PLACE/tl_*_25_* --no-parent --relative --recursive --level=2 --accept=zip --mirror --reject=html
cd \gisdata/ftp2.census.gov/geo/tiger/TIGER2015/PLACE
:
:

shスクリプトの生成

SELECT loader_generate_script(ARRAY['MA','RI'], 'sh') AS result;
-- 結果 --
TMPDIR="/gisdata/temp/"
UNZIPTOOL=unzip
WGETTOOL="/usr/bin/wget"
export PGBIN=/usr/lib/postgresql/9.4/bin
-- PostgreSQLで使う変数: https://www.postgresql.org/docs/current/static/libpq-envars.html
export PGPORT=5432
export PGHOST=localhost
export PGUSER=postgres
export PGPASSWORD=yourpasswordhere
export PGDATABASE=geocoder
PSQL=${PGBIN}/psql
SHP2PGSQL=${PGBIN}/shp2pgsql
cd /gisdata

cd /gisdata
wget ftp://ftp2.census.gov/geo/tiger/TIGER2015/PLACE/tl_*_25_* --no-parent --relative --recursive --level=2 --accept=zip --mirror --reject=html
cd /gisdata/ftp2.census.gov/geo/tiger/TIGER2015/PLACE
rm -f ${TMPDIR}/*.*
:
:

関連情報

the section called “TigerジオコーダをPostGISデータベースで有効にする”, Loader_Generate_Nation_Script, Drop_State_Tables_Generate_Script

Name

Loader_Generate_Nation_Script — 指定したプラットフォーム用の、国と州のルックアップテーブルをロードするシェルスクリプトを生成します。

Synopsis

text loader_generate_nation_script(
os);

text os;

説明

tiger_dataスキーマにcounty_all, county_all_lookup, state_allテーブルをロードする、指定したプラットフォーム用のシェルスクリプトを生成します。それぞれtigerスキーマのcounty, county_lookup, stateから継承されます。

ダウンロードには、Linuxではunzip (Windowsのデフォルトは7-zip)とwgetとを使います。データの格納にはthe section called “シェープファイルローダを使う”を使います。

プロセスの制御や異なるOSのシェルの書式の制御のために、制御テーブルtiger.loader_platform, tiger.loader_variables, tiger.loader_lookuptablesを使います。

loader_variables 国勢調査ダウンロードサイト、年度、データと準備スキーマといった種々の変数の軌跡を保持します。

loader_platformには、種々のプラットフォームのプロファイルや実行可能ファイルの置いてある位置を持ちます。windowsとLinux/unixを備えています。追加も可能です。

loader_lookuptables レコードごとにテーブルの種類 (州、国)、レコード処理の有無、ロード方法を定義しています。データインポート方法、データ格納準備、カラム追加、カラム削除、インデックス、制約がそれぞれで定義されています。個々のテーブルは、名前の先頭に州コードを持ち、tigerスキーマのテーブルから継承されています。たとえば、tiger.facesから継承したtiger_data.ma_facesの生成といったことが行われます。

Enhanced: 2.4.1 5桁郵便番号集計地域 (zcta5)のロードが修正されて、zcta5データは、有効な時には、国データのロードの中でzcta5_allという単一テーブルとしてロードされるようになりました。

Availability: 2.1.0

Note

5桁郵便番号集計地域を国データのロードに取り込みたい場合には、次のようにします。

UPDATE tiger.loader_lookuptables SET load = true WHERE table_name = 'zcta510';

Note

tiger_2010を実行して、それより新しいTigerデータで州データの再ロードを行うには、このスクリプトを実行する前に、最初に、Drop_Nation_Tables_Generate_Scriptによって、テーブル削除スクリプトを生成、実行する必要があります。

例

国データをWindowsにロードするスクリプトを生成します。

SELECT loader_generate_nation_script('windows');

国データをLinux/Unixシステムにロードするスクリプトを生成します。

SELECT loader_generate_nation_script('sh');

関連情報

Loader_Generate_Script, Drop_Nation_Tables_Generate_Script

Name

Missing_Indexes_Generate_Script — ジオコーダで結合に使われるキーカラムを持ち、インデックスが付いていないキーカラムを持つすべてのテーブルを検索し、インデックスを追加するSQLデータ定義言語を出力します。

Synopsis

text Missing_Indexes_Generate_Script(
);

;

説明

tigerスキーマとtiger_dataスキーマ内のジオコーダで結合に使われ、インデックスが付いていないキーカラムを持つ全てのテーブルを検索し、インデックスを付けるSQLデータ定義言語を出力します。これは、クエリの動作速度を上げるのに必要であるのにロード処理で失われたインデックスを追加するのを助ける関数です。ジオコーダが改善されますが、使用される新しいインデックスを受け入れるために、この関数は更新されます。この関数の出力が無い場合がありますが、これは、全てのテーブルにインデックスが付いていると考えられます。

Availability: 2.0.0

例

SELECT missing_indexes_generate_script();
-- 出力: 多数の修正がロードスクリプトで行われる前のデータベースで実行しました ---
CREATE INDEX idx_tiger_county_countyfp ON tiger.county USING btree(countyfp);
CREATE INDEX idx_tiger_cousub_countyfp ON tiger.cousub USING btree(countyfp);
CREATE INDEX idx_tiger_edges_tfidr ON tiger.edges USING btree(tfidr);
CREATE INDEX idx_tiger_edges_tfidl ON tiger.edges USING btree(tfidl);
CREATE INDEX idx_tiger_zip_lookup_all_zip ON tiger.zip_lookup_all USING btree(zip);
CREATE INDEX idx_tiger_data_ma_county_countyfp ON tiger_data.ma_county USING btree(countyfp);
CREATE INDEX idx_tiger_data_ma_cousub_countyfp ON tiger_data.ma_cousub USING btree(countyfp);
CREATE INDEX idx_tiger_data_ma_edges_countyfp ON tiger_data.ma_edges USING btree(countyfp);
CREATE INDEX idx_tiger_data_ma_faces_countyfp ON tiger_data.ma_faces USING btree(countyfp);

関連情報

Loader_Generate_Script, Install_Missing_Indexes

Name

Normalize_Address — 文字列で住所が与えられると、道路後置辞、前置辞、正規化された種別、番地、ストリート名等をフィールドに分けて持つnorm_addy複合型を返します。tiger_geocoderに同梱されているルックアップデータで動作します (Tigerデータ自体は不要です)。

Synopsis

norm_addy normalize_address(
in_address);

varchar in_address;

説明

文字列で住所が与えられると、道路後置辞、前置辞、正規化された種別、番地、ストリート名等をフィールドに分けて持つnorm_addy複合型を返します。全ての住所を正規化した郵便形式にするジオコーディング処理の第一段階です。ジオコーダに同梱されるもの以外で必要な者はありません。

tiger_geocoderによって前もってロードされ、tigerスキーマに格納される、様々な方角/州/後置辞のルックアップテーブルを使います。よって、Tigerデータをダウンロードしたり、追加データをする必要はありません。tigerスキーマ内のルックアップテーブルに略語や別名の追加が必要になることがあります。

tigerスキーマ内に、入力アドレスを正規化するための、多様な制御ルックアップテーブルを使います。

この関数が返すnorm_addy型オブジェクトのフィールドは、次に示す順序です。()はジオコーダの必須フィールド、[]は任意フィールドです。

(address) [predirAbbrev] (streetName) [streetTypeAbbrev] [postdirAbbrev] [internal] [location] [stateAbbrev] [zip] [parsed] [zip4] [address_alphanumeric]

Enhanced: 2.4.0 norm_addyオブジェクトには追加フィールドのzip4とaddress_alphanumericとが含まれます。

address 整数: 番地

predirAbbrev varchar型: N, S, E, W等といった道路の方向前置辞。direction_lookupテーブルに制御されます。

streetName varchar型

streetTypeAbbrev varchar型 ストリート種別の短縮名: St, Ave, Cir等。street_type_lookupテーブルに制御されます。

postdirAbbrev varchar型 N, S, E, W等の道路名の方向後置辞。direction_lookupテーブルに制御されます。

internal varchar型 部屋番号といった内部住所。

location varchar型 通常は市名や県名です。

stateAbbrev varchar型 MA, NY, MI等のような米国の州名の2文字表示です。state_lookupテーブルに制御されます。

zip varchar型 02109等の5桁の数字です。

parsed 真偽型 - 住所が正規化処理で整形されたかを示します。normalize_addressは、住所を返す前にこれをTRUEにします。

zip4 9桁郵便番号の後半4桁です。Availability: PostGIS 2.4.0。

address_alphanumeric 17Rのような文字を含む完全なストリート番号。これの解析はPagc_Normalize_Address関数を使うと良くなります。 Availability: PostGIS 2.4.0。

例

フィールドを選択して出力します。きれいな文字列を求める場合には、Pprint_Addyを使います。

SELECT address As orig, (g.na).streetname, (g.na).streettypeabbrev
 FROM (SELECT address, normalize_address(address) As na
        FROM addresses_to_geocode) As g;

                        orig                         |  streetname   | streettypeabbrev
-----------------------------------------------------+---------------+------------------
 28 Capen Street, Medford, MA                        | Capen         | St
 124 Mount Auburn St, Cambridge, Massachusetts 02138 | Mount Auburn  | St
 950 Main Street, Worcester, MA 01610                | Main          | St
 529 Main Street, Boston MA, 02129                   | Main          | St
 77 Massachusetts Avenue, Cambridge, MA 02139        | Massachusetts | Ave
 25 Wizard of Oz, Walaford, KS 99912323              | Wizard of Oz  |

関連情報

Geocode, Pprint_Addy

Name

Pagc_Normalize_Address — 文字列のストリート住所を与えると、道路後置辞、前置辞、標準タイプ、番地、ストリート名等を複数フィールドに分解して持つnorm_addy複合型を返します。この関数は、tiger_geocoder同梱のルックアップテーブルだけを使います (Tigerデータは不要です)。住所標準化エクステンションが必要です。

Synopsis

norm_addy pagc_normalize_address(
in_address);

varchar in_address;

説明

文字列で住所が与えられると、道路後置辞、前置辞、正規化された種別、番地、ストリート名等をフィールドに分けて持つnorm_addy複合型を返します。全ての住所を正規化した郵便形式にするジオコーディング処理の第一段階です。ジオコーダに同梱されるもの以外で必要な者はありません。

この関数は、Tigerジオコーダとともにロードされ、tigerスキーマに置かれる、種々のpagc_+ルックアップテーブルだけを使うので、Tigerデータや他のデータをダウンロードする必要はありません。略語や別名をtigerスキーマのルックアップテーブルに追加しなければならない場合もあります。

tigerスキーマ内に、入力アドレスを正規化するための、多様な制御ルックアップテーブルを使います。

この関数が返すnorm_addy型オブジェクトのフィールドは、次に示す順序です。()はジオコーダの必須フィールド、[]は任意フィールドです。

処理と書式についてNormalize_Addressと若干の違いがあります。

Availability: 2.1.0

説明このメソッドはaddress_standardizerエクステンションが必要です。

(address) [predirAbbrev] (streetName) [streetTypeAbbrev] [postdirAbbrev] [internal] [location] [stateAbbrev] [zip]

住所標準化エクステンションのstandardaddrは、他国の住所への対応 (countryも含む)があるため、norm_addyより若干フィールドが多くなります。standardaddrの、norm_addyと等価なフィールドは次の通りです。

house_num,predir, name, suftype, sufdir, unit, city, state, postcode

Enhanced: 2.4.0 norm_addyオブジェクトには追加フィールドのzip4とaddress_alphanumericとが含まれます。

address 整数: 番地

predirAbbrev varchar型: N, S, E, W等といった道路の方向前置辞。direction_lookupテーブルに制御されます。

streetName varchar型

streetTypeAbbrev varchar型 ストリート種別の短縮名: St, Ave, Cir等。street_type_lookupテーブルに制御されます。

postdirAbbrev varchar型 N, S, E, W等の道路名の方向後置辞。direction_lookupテーブルに制御されます。

internal varchar型 部屋番号といった内部住所。

location varchar型 通常は市名や県名です。

stateAbbrev varchar型 MA, NY, MI等のような米国の州名の2文字表示です。state_lookupテーブルに制御されます。

zip varchar型 02109等の5桁の数字です。

parsed 真偽型 - 住所が正規化処理で整形されたかを示します。normalize_addressは、住所を返す前にこれをTRUEにします。

zip4 9桁郵便番号の後半4桁です。Availability: PostGIS 2.4.0。

address_alphanumeric 17Rのような文字を含む完全なストリート番号。これの解析はPagc_Normalize_Address関数を使うと良くなります。 Availability: PostGIS 2.4.0。

例

単一呼び出しの例を示します。

SELECT addy.*
FROM pagc_normalize_address('9000 E ROO ST STE 999, Springfield, CO') AS addy;

 address | predirabbrev | streetname | streettypeabbrev | postdirabbrev | internal  |  location   | stateabbrev | zip | parsed
---------+--------------+------------+------------------+---------------+-----------+-------------+-------------+-----+--------
    9000 | E            | ROO        | ST               |               | SUITE 999 | SPRINGFIELD | CO          |     | t

バッチ呼び出しの例です。現在は、postgis_tiger_geocoderはaddress_standardizerを使用しているため、速度の問題があります。うまくいけば、今後解決されることでしょう。normaddyへのジオコーディングのバッチ処理で速度が必要な場合には、住所標準化エクステンションのstandaridze_address関数を直接呼ぶことで回避できます。Geocodeで生成されたデータを使うNormalize_Addressで行っていることと似ています。例を次に示します。

WITH g AS (SELECT address, ROW((sa).house_num, (sa).predir, (sa).name
  , (sa).suftype, (sa).sufdir, (sa).unit , (sa).city, (sa).state, (sa).postcode, true)::norm_addy As na
 FROM (SELECT address, standardize_address('tiger.pagc_lex'
       , 'tiger.pagc_gaz'
       , 'tiger.pagc_rules', address) As sa
        FROM addresses_to_geocode) As g)
SELECT address As orig, (g.na).streetname, (g.na).streettypeabbrev
 FROM  g;

 orig                                                |  streetname   | streettypeabbrev
-----------------------------------------------------+---------------+------------------
 529 Main Street, Boston MA, 02129                   | MAIN          | ST
 77 Massachusetts Avenue, Cambridge, MA 02139        | MASSACHUSETTS | AVE
 25 Wizard of Oz, Walaford, KS 99912323              | WIZARD OF     |
 26 Capen Street, Medford, MA                        | CAPEN         | ST
 124 Mount Auburn St, Cambridge, Massachusetts 02138 | MOUNT AUBURN  | ST
 950 Main Street, Worcester, MA 01610                | MAIN          | ST

関連情報

Normalize_Address, Geocode

Name

Pprint_Addy — norm_addy複合型オブジェクトを与えると、印刷表現を返します。通常はnormalize_addressと併用します。

Synopsis

varchar pprint_addy(
in_addy);

norm_addy in_addy;

説明

norm_addy複合型オブジェクトを与えると、印刷表現を返します。Tigerジオコーダ同梱のデータ以外は不要です。

通常はNormalize_Addressと併用します。

例

単一住所の印刷表現

SELECT pprint_addy(normalize_address('202 East Fremont Street, Las Vegas, Nevada 89101')) As pretty_address;
            pretty_address
---------------------------------------
 202 E Fremont St, Las Vegas, NV 89101

住所テーブルの印刷表現

SELECT address As orig, pprint_addy(normalize_address(address)) As pretty_address
        FROM addresses_to_geocode;

                        orig                         |              pretty_address
-----------------------------------------------------+-------------------------------------------
 529 Main Street, Boston MA, 02129                   | 529 Main St, Boston MA, 02129
 77 Massachusetts Avenue, Cambridge, MA 02139        | 77 Massachusetts Ave, Cambridge, MA 02139
 28 Capen Street, Medford, MA                        | 28 Capen St, Medford, MA
 124 Mount Auburn St, Cambridge, Massachusetts 02138 | 124 Mount Auburn St, Cambridge, MA 02138
 950 Main Street, Worcester, MA 01610                | 950 Main St, Worcester, MA 01610

関連情報

Normalize_Address

Name

Reverse_Geocode — 登録されている空間参照系に基づくポイントジオメトリを引数に取り、理論的に可能性のある住所の配列と交差するストリートの配列を一つのレコードで返します。include_strnum_range = trueの場合には、交差するストリートに番地範囲を追加します。

Synopsis

record Reverse_Geocode( | pt, |
| include_strnum_range=false, |
| OUT intpt, |
| OUT addy, |
| OUT street); |

geometry pt;
boolean include_strnum_range=false;
geometry[] OUT intpt;
norm_addy[] OUT addy;
varchar[] OUT street;

説明

登録されている空間参照系に基づくポイントジオメトリを引数に取り、理論的に可能性のある住所の配列と交差するストリートの配列を一つのレコードで返します。include_strnum_range = trueの場合には、交差するストリートに番地範囲を追加します。include_strnum_rangeは、していない場合のデフォルトはFALSEです。住所は、ポイントから近い順の道路でソートされるので、最初の要素が最も正解に近くなります。

実際の住所ではなく理論的な住所と書いているのには理由があります。Tigerデータは本当の住所ではなく、番地の範囲を持っています。そのため、理論的な住所は番地範囲に基づいて補間したものです。補間する場合には、たとえば、26 Court Sq.が存在しないにもかかわらず、26 Court St. と 26 Court Sq.が返る、といったことがあります。これは、ポイントが二つのストリートの角にあるのが原因で、両方のストリートに沿って補間を行うためです。住所はストリートに沿って等間隔になっていると仮定しています。非常に多くの番地範囲を取ってしまっている自治体の建物があり、他の建物がストリートの終わりにかたまっているため、ストリートの方向が悪いです。

ご注意: この関数はTigerデータに依存しています。指定した点を含む領域のデータが無い場合には、NULLで満たされた一つのレコードが返されます。

返されるレコードの要素は次の通りです。

intpt ポイント配列: 入力ポイントに最も近いストリートの中心線のポイントです。住所と同じだけポイントがあります。

addy norm_addy (正規化された住所)の配列: 入力ポイントに合わせた、可能性のある住所の配列です。最初の要素が最も可能性が高いものです。一般的に、一つだけになるべきですが、ポイントが二つか三つのストリートの角にあったり、ポイントが道路上のどこかにあって側線から離れている場合には、数出現します。

street varchar型の配列: 交差するストリート (ストリートがインタセクトする場合)または一つのストリート (指定したポイントが乗るストリートである場合)です。

Enhanced: 2.4.1 ZCTA5データセットを追加でロードする場合には、reverse_geocode関数は、特定の州データがロードされていなくても、州とZIPを解決することができます。ZTCA5データのロードに関する詳細についてはLoader_Generate_Nation_Scriptを参照して下さい。

Availability: 2.0.0

例

ストリートの角であって、かつ最も近くなる二つの点の例です。MIT (Massachusetts Ave, Cambridge, MA 02139 )に近い位置です。ストリートは三つはないですが、PostgreSQLは配列の範囲からはみ出してもNULLを返すので安全です。番地範囲を含んでいます。

SELECT pprint_addy(r.addy[1]) As st1, pprint_addy(r.addy[2]) As st2, pprint_addy(r.addy[3]) As st3,
            array_to_string(r.street, ',') As cross_streets
        FROM reverse_geocode(ST_GeomFromText('POINT(-71.093902 42.359446)',4269),true) As r;

 結果t
 ------
      st1                                  | st2 | st3 |               cross_streets
-------------------------------------------+-----+-----+----------------------------------------------
 67 Massachusetts Ave, Cambridge, MA 02139 |     |     | 67 - 127 Massachusetts Ave,32 - 88 Vassar St

交差するストリートの番地範囲を含めないことを選択しました。また、二つの異なる住所が分かるよう、二つのストリートの角に本当に近い位置を指定しました。

SELECT pprint_addy(r.addy[1]) As st1, pprint_addy(r.addy[2]) As st2,
pprint_addy(r.addy[3]) As st3, array_to_string(r.street, ',') As cross_str
FROM reverse_geocode(ST_GeomFromText('POINT(-71.06941 42.34225)',4269)) As r;

結果
--------
               st1               |               st2               | st3 | cross_str
---------------------------------+---------------------------------+-----+------------------------
 5 Bradford St, Boston, MA 02118 | 49 Waltham St, Boston, MA 02118 |     | Waltham St

Geocodeからジオコーディングの例を再利用しています。主要な住所と、せいぜい二つの交差するストリートを求めているだけです。

SELECT actual_addr, lon, lat, pprint_addy((rg).addy[1]) As int_addr1,
    (rg).street[1] As cross1, (rg).street[2] As cross2
FROM (SELECT address As actual_addr, lon, lat,
    reverse_geocode( ST_SetSRID(ST_Point(lon,lat),4326) ) As rg
    FROM addresses_to_geocode WHERE rating
> -1) As foo;

                     actual_addr                     |    lon    |   lat    |                 int_addr1                 |     cross1      |   cross2
-----------------------------------------------------+-----------+----------+-------------------------------------------+-----------------+------------
 529 Main Street, Boston MA, 02129                   | -71.07181 | 42.38359 | 527 Main St, Boston, MA 02129             | Medford St      |
 77 Massachusetts Avenue, Cambridge, MA 02139        | -71.09428 | 42.35988 | 77 Massachusetts Ave, Cambridge, MA 02139 | Vassar St       |
 26 Capen Street, Medford, MA                        | -71.12377 | 42.41101 | 9 Edison Ave, Medford, MA 02155           | Capen St        | Tesla Ave
 124 Mount Auburn St, Cambridge, Massachusetts 02138 | -71.12304 | 42.37328 | 3 University Rd, Cambridge, MA 02138      | Mount Auburn St |
 950 Main Street, Worcester, MA 01610                | -71.82368 | 42.24956 | 3 Maywood St, Worcester, MA 01603         | Main St         | Maywood Pl

関連情報

Pprint_Addy, Geocode, Loader_Generate_Nation_Script

Name

Topology_Load_Tiger — Tigerデータの定義領域をPostGISトポロジにロードして、Tigerデータをトポロジの空間参照系に投影変換し、トポロジの許容精度にスナップします。

Synopsis

text Topology_Load_Tiger( | topo_name, |
| region_type, |
| region_id); |

varchar topo_name;
varchar region_type;
varchar region_id;

説明

Tigerデータの定義領域をPostGISトポロジにロードします。フェイス、ノード、エッジは対象トポロジの空間参照系に投影変換され、点は対象トポロジの許容精度にスナップされます。生成されたフェイス、ノード、エッジは、元のTigerデータのフェイス、ノード、エッジの識別値を維持するので、将来、データセットをより簡単にTigerデータに一致させることができます。処理の詳細に関する要約を返します。

これはデータの区域改訂に使えますが、ストリートの中心線に沿って新たに形成されるポリゴンと重ならないポリゴンとが必要です。

Note

この関数はPostGISトポロジモジュールとTigerデータに依存しています。詳細情報については、Chapter 8, トポロジとthe section called “コンフィギュレーション”を参照して下さい。対象領域を含むデータを持っていない場合には、トポロジは作られません。トポロジ関数を使ってトポロジが生成されない場合も失敗します。

Note

ほとんどのトポロジ評価エラーは許容範囲の問題です。エッジの投影変換の後にポイントが準備できなかったり、エッジからずれる場合にあたります。トポロジ評価に失敗する状況を改善するには、精度を下げます。

必須引数:

topo_name データを納めるPostGISトポロジの名前

region_type 境界種別。現在はplace とcountyとだけに対応しています。今後増やす予定です。これは境界を定義するために見るテーブルです。tiger.placeやtiger.county等があたります。

region_id TIGERではgeoidと呼ばれるものです。テーブルで領域の一意の識別子です。placeではtiger.placeテーブルのplcidfpカラムで、郡ではtiger.countryテーブルのcntyidfpカラムで保持します。

Availability: 2.0.0

例: マサチューセッツ州ボストン市のトポロジ

マサチューセッツ州ボストンのトポロジをマサチューセッツ州フィート平面 (2249)、許容範囲0.25フィートで生成し、ボストンのTigerデータのフェイス、エッジ、ノードをロードします。

SELECT topology.CreateTopology('topo_boston', 2249, 0.25);
createtopology
--------------
   15
-- Windows 7 デスクトップ PostgreSQL 9.1 (5州のTigerデータを格納)で 60,902ミリ秒 (約1分)
SELECT tiger.topology_load_tiger('topo_boston', 'place', '2507000');
-- topology_loader_tiger --
29722 edges holding in temporary. 11108 faces added. 1875 edges of faces added.  20576 nodes added.
19962 nodes contained in a face.  0 edge start end corrected.  31597 edges added.

-- 41ミリ秒 --
SELECT topology.TopologySummary('topo_boston');
 -- topologysummary--
Topology topo_boston (15), SRID 2249, precision 0.25
20576 nodes, 31597 edges, 11109 faces, 0 topogeoms in 0 layers

-- 評価に28,797ミリ秒 エラーなしでよかった --
SELECT * FROM
    topology.ValidateTopology('topo_boston');

       error       |   id1    |    id2
-------------------+----------+-----------

例: マサチューセッツ州サフォーク郡のトポロジ

マサチューセッツ州サフォークのトポロジを、マサチューセッツ州メートル平面 (26986)、許容範囲0.25メートルで生成し、サフォークのTigerデータのフェイス、エッジ、ノードをロードします。

SELECT topology.CreateTopology('topo_suffolk', 26986, 0.25);
-- Windows 7 32ビット Tigerデータ5州 で 56,275秒 (約1分)かかりました
-- ボストンのロードのあとウォームアップされたに違いありません
SELECT tiger.topology_load_tiger('topo_suffolk', 'county', '25025');
-- topology_loader_tiger --
 36003 edges holding in temporary. 13518 faces added. 2172 edges of faces added.
 24761 nodes added.  24075 nodes contained in a face.  0 edge start end corrected.  38175 edges added.
-- 31ミリ秒 --
SELECT topology.TopologySummary('topo_suffolk');
 -- topologysummary--
 Topology topo_suffolk (14), SRID 26986, precision 0.25
24761 nodes, 38175 edges, 13519 faces, 0 topogeoms in 0 layers

-- 評価に 33,606ミリ秒 --
SELECT * FROM
    topology.ValidateTopology('topo_suffolk');

       error       |   id1    |    id2
-------------------+----------+-----------
 coincident nodes  | 81045651 |  81064553
 edge crosses node | 81045651 |  85737793
 edge crosses node | 81045651 |  85742215
 edge crosses node | 81045651 | 620628939
 edge crosses node | 81064553 |  85697815
 edge crosses node | 81064553 |  85728168
 edge crosses node | 81064553 |  85733413

関連情報

CreateTopology, CreateTopoGeom, TopologySummary, ValidateTopology

Name

Set_Geocode_Setting — ジオコーダ関数の振る舞いに影響を与える設定を行います。

Synopsis

text Set_Geocode_Setting( | setting_name, |
| setting_value); |

text setting_name;
text setting_value;

説明

tiger.geocode_settingsテーブルに格納されている設定の値を設定します。設定によって、関数のデバッグの切り替えができます。今後、評価値の制御を設定から行えるようにする予定です。現在の設定リストはGet_Geocode_Settingにあります。

Availability: 2.1.0

デバッグ設定を返す例

この関数がTRUEを返す場合にGeocodeを実行すると、時刻とクエリがNOTICEログに出力されます。

SELECT set_geocode_setting('debug_geocode_address', 'true') As result;
result
---------
true

関連情報

Get_Geocode_Setting

Chapter 12. PostGIS関数索引

PostGIS集約関数

次に示す関数は、PostGISが提供する空間集約関数です。sumやaverageといった他のSQL集約関数のように使います。

ST_3DExtent - ジオメトリの3次元バウンディングボックスを返す集約関数です。

ST_3DUnion - 3次元の結合を計算します。

ST_AsFlatGeobuf - 行の集合のFlatGeobuf表現を返します。

ST_AsGeobuf - 行集合のGeobuf表現を返します。

ST_AsMVT - 行集合のMVT表現を返す集約関数です。

ST_ClusterIntersecting - 入力ジオメトリを接続関係にある集合にクラスタリングする集約関数です。

ST_ClusterWithin - 空間的な距離によって入力ジオメトリのクラスタリングを行う集約関数です。

ST_Collect - ジオメトリの集合からジオメトリコレクションまたはマルチ系ジオメトリを生成します。

ST_CoverageUnion - 共有しているエッジを除去することでカバレッジを形成するポリゴンの集合の結合を計算します。

ST_Extent - ジオメトリのバウンディングボックスを返す集約関数です。

ST_MakeLine - POINT、MULTIPOINT、LINESTRINGからLINESTRINGを生成します。

ST_MemUnion - ジオメトリを結合する集約関数で、メモリを効率的に使いますが処理時間のかかるものです。

ST_Polygonize - ジオメトリ集合のラインから形成されるポリゴンのコレクションを計算します。

ST_SameAlignment - ラスタが同じスキュー、スケール、空間参照系、オフセットを持つ (ピクセルが分割されることなく同じグリッドに置かれている)場合にTRUEを返し、そうでない場合は問題を詳述する通知とともにFALSEを返します。

ST_Union - 入力ジオメトリのポイント集合の結合を表現するジオメトリを返します。

TopoElementArray_Agg - element_idとタイプの配列 (topoelements)からなるtopoelementarrayを返します。

PostGISウィンドウ関数

次に示す関数は、PostGISが提供する空間ウィンドウ関数です。row_number(), lead(), lag()等のような他のSQLウィンドウ関数のように使います。全ての関数で、SQLのOVER()句が必要です。

ST_ClusterDBSCAN - 入力ジオメトリごとにDBSCANアルゴリズムを使ってクラスタ番号を返すウィンドウ関数です。

ST_ClusterIntersectingWin - 入力ジオメトリごとに接続された集合にクラスタリングを行い、クラスタIDを返すウィンドウ関数です。

ST_ClusterKMeans - 入力ジオメトリごとにk平均法アルゴリズムを使ってクラスタ番号を返すウィンドウ関数です。

ST_ClusterWithinWin - 入力ジオメトリごとに分離距離を使ったクラスタリングを行い、クラスタIDを返すウィンドウ関数です。

ST_CoverageInvalidEdges - ポリゴンが妥当なカバレッジの形成に失敗する位置を検索するウィンドウ関数。

ST_CoverageSimplify - ポリゴンカバレッジのエッジを単純化するウィンドウ関数。

PostGIS SQL-MM準拠関数

次に示す関数は、SQL/MM 3標準に準拠したPostGIS関数です。

ST_3DArea - 3次元の面ジオメトリの面積を計算します。立体の場合は0を返します。説明 Availability: 2.1.0 このメソッドにはSFCGALバックエンドが必要です。このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 8.1, 10.5 この関数は3次元に対応し、Z値を削除しません。この関数は多面体サーフェスに対応しています。この関数は三角形と不規則三角網 (TIN)に対応しています。

ST_3DDWithin - 二つの3次元ジオメトリが与えらえれた3次元距離内にあるかどうかをテストします。説明二つのジオメトリ値の3次元距離がdistance_of_srid以下ならTRUEを返します。距離の単位はジオメトリの空間参照系の単位です。この関数から意味のある結果を得るには、引数に使うジオメトリを同じ空間系 (同じSRIDを持つ)にしなければなりません。この関数の呼び出しによって、ジオメトリで使用可能なインデックスを使用するバウンディングボックスの比較が自動的に行われます。この関数は3次元に対応し、Z値を削除しません。この関数は多面体サーフェスに対応しています。このメソッドはSQL/MM仕様の実装です。 SQL-MM ? Availability: 2.0.0

ST_3DDifference - 3次元の差分を計算します。説明 geom2に含まれないgeom1の一部を返します。 Availability: 2.2.0 このメソッドにはSFCGALバックエンドが必要です。このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 5.1 この関数は3次元に対応し、Z値を削除しません。この関数は多面体サーフェスに対応しています。この関数は三角形と不規則三角網 (TIN)に対応しています。

ST_3DDistance - 投影座標系の単位で、二つのジオメトリ間の3次元デカルト距離の最小値を返します (空間参照系に基づきます)。説明投影座標系の単位で、二つのジオメトリ間の3次元デカルト距離の最小値を返します (空間参照系に基づきます)。この関数は3次元に対応し、Z値を削除しません。この関数は多面体サーフェスに対応しています。このメソッドはSQL/MM仕様の実装です。 SQL-MM ISO/IEC 13249-3 Availability: 2.0.0 Changed: 2.2.0 - 2次元と3次元の場合には、もはや、存在しないZの値について0を仮定しません。 Changed: 3.0.0 - SFCGAL版は削除されました

ST_3DIntersection - 3次元のインタセクトした (共有する)部分を計算します。説明 geom1とgeom2の間で共有される部分のジオメトリを返します。 Availability: 2.1.0 このメソッドにはSFCGALバックエンドが必要です。このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 5.1 この関数は3次元に対応し、Z値を削除しません。この関数は多面体サーフェスに対応しています。この関数は三角形と不規則三角網 (TIN)に対応しています。

ST_3DIntersects - 二つのジオメトリが3次元空間において空間的にインタセクトするかどうかをテストします。ポイント、ラインストリング、ポリゴン、多面体サーフェス (面)についてのみ動作します。説明オーバラップ、接触、包含は全て、ジオメトリがインタセクトしていることを意味しています。これらがTRUEを返す場合は、空間的にインタセクトしています。非接続は、空間インタセクトについてFALSEとなります。この関数の呼び出しによって、ジオメトリで使用可能なインデックスを使用するバウンディングボックスの比較が自動的に行われます。 Changed: 3.0.0 SFCGALバックエンドが削除され、GEOSバックエンドではTINに対応しました。 Availability: 2.0.0 この関数は3次元に対応し、Z値を削除しません。この関数は多面体サーフェスに対応しています。この関数は三角形と不規則三角網 (TIN)に対応しています。このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 5.1

ST_3DLength - 線ジオメトリの3次元長を返します。説明 LINESTRINGまたはMULTILINESTRINGの場合には、そのジオメトリの3次元長または2次元長を返します。2次元ラインでは2次元長を返します (ST_LengthとST_Length2Dと同じです)。この関数は3次元に対応し、Z値を削除しません。このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 7.1, 10.3 Changed: 2.0.0 以前の版ではST_Length3Dと呼ばれていました。

ST_3DPerimeter - ポリゴンジオメトリの3次元周長を返します。説明 POLYGONまたはMULTIPOLYGONジオメトリの場合には、3次元周囲長を返します。ジオメトリが2次元の場合には、2次元周囲長を返します。この関数は3次元に対応し、Z値を削除しません。このメソッドはSQL/MM仕様の実装です。 SQL-MM ISO/IEC 13249-3: 8.1, 10.5 Changed: 2.0.0 以前の版ではST_Perimeter3Dと呼ばれていました。

ST_3DUnion - 3次元の結合を計算します。説明 Availability: 2.2.0 Availability: 3.3.0 集約関数の形式が追加されましたこのメソッドにはSFCGALバックエンドが必要です。このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 5.1 この関数は3次元に対応し、Z値を削除しません。この関数は多面体サーフェスに対応しています。この関数は三角形と不規則三角網 (TIN)に対応しています。集約関数形式: ジオメトリの集合を3次元結合したジオメトリを返します。ST_3DUnion()関数は、PostgreSQL用語で言うところの「集約関数」です。つまり、SUM()やMEAN()と同じ方法で複数のデータ行の操作を行い、他の集約関数と同じようにNULLジオメトリを無視します。

ST_AddEdgeModFace - 新しいエッジを追加します。新しいエッジがフェイスを分割する場合には、もとのフェイスを編集し、一つのフェイスを追加します。説明新しいエッジを追加します。新しいエッジがフェイスを分割する場合には、もとのフェイスを編集し、一つのフェイスを追加します。可能なら、新しいフェイスは新しいエッジの左側に作られます。左側のフェイスがユニバースフェイス (境界がない)でなければならない場合には、可能ではありません。新しく追加されたエッジの識別番号を返します。この関数によって、既存の接続されているエッジとリレーションシップが更新されます。引数がNULLの場合、与えられたノードが不明な場合(トポロジスキーマのnodeテーブル内に既に存在していなければなりません)、acurveがLINESTRINGでない場合、anodeとanothernodeがacurveの始端、終端でない場合には、例外が投げられます。 acurveジオメトリの空間参照系 (SRID) がトポロジと同じでない場合、例外が投げられます。 Availability: 2.0 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.13

ST_AddEdgeNewFaces - 新しいエッジを追加します。新しいエッジがフェイスを分割する場合には、もとのフェイスを削除して、分割した二つのフェイスに置き換えます。説明新しいエッジを追加します。新しいエッジがフェイスを分割する場合には、もとのフェイスを削除して、分割した二つのフェイスに置き換えます。新しいエッジの識別番号を返します。この関数によって、既存の接続されているエッジとリレーションシップが更新されます。引数がNULLの場合、与えられたノードが不明な場合(トポロジスキーマのnodeテーブル内に既に存在していなければなりません)、acurveがLINESTRINGでない場合、anodeとanothernodeがacurveの始端、終端でない場合には、例外が投げられます。 acurveジオメトリの空間参照系 (SRID) がトポロジと同じでない場合、例外が投げられます。 Availability: 2.0 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.12

ST_AddIsoEdge - anodeとanothernodeで指定される二つの既存孤立ノードを接続するトポロジに、ジオメトリalinestringで定義される孤立エッジを追加し、新しいエッジの識別番号を返します。説明 anodeとanothernodeで指定される二つの既存孤立ノードを接続するトポロジに、ジオメトリalinestringで定義される孤立エッジを追加し、新しいエッジの識別番号を返します。 alinestringジオメトリとトポロジとで空間参照系 (SRID)が異なる場合、引数がNULLである場合、ノードが一つ以上のフェイスに含まれている場合には、二つのノードが既存エッジの始端または終端である場合には、例外が投げられます。 alinestringがanodeとanothernodeに属するフェイス内に無い場合には、例外が投げられます。 anodeとanothernodeが、alinestringの始端と終端でない場合には、例外が投げられます。 Availability: 1.1 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.4

ST_AddIsoNode - フェイスに孤立ノードを追加し、新しいノードの識別番号を返します。フェイスがNULLの場合でもノードは生成されます。説明 atopologyで指定されたトポロジのafaceの識別番号で示された既存のフェイスに対して、apointで示された位置に孤立ノードを追加します。ポイントジオメトリの空間参照系 (SRID)がトポロジと同じでない場合、apointがポイントジオメトリでない場合、ポイントがNULLである場合、または、ポイントが既存のエッジ (境界も含む)とインタセクトする場合には、例外が投げられます。また、ポイントが既にノードとして存在する場合、例外が投げられます。 afaceがNULLでなく、かつapointがフェイス内に無い場合には、例外が投げられます。 Availability: 1.1 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X 3.1

ST_Area - ポリゴンジオメトリの面積を返します。説明ポリゴンジオメトリの面積を返します。ジオメトリ型では2次元のデカルト (平面)面積が、SRIDで指定した単位で計算されます。ジオグラフィ型では、デフォルトでは、面積は回転楕円体上にあるものとし、平方メートル単位で計算されます。より速いものの精度が落ちる計算のために、 ST_Area(geog,false)で球面モデルを使った計算ができます。 Enhanced: 2.0.0 - 2次元多面体サーフェス対応が導入されました。 Enhanced: 2.2.0 - 精度とロバスト性の向上のためにGeographicLibを使って回転楕円体面上での計測を行うようにしています。この新機能を使うには、Proj 4.9.0以上が必要です。 Changed: 3.0.0 - SFCGALに依存しなくなりました。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 8.1.2, 9.5.3 この関数は多面体サーフェスに対応しています。多面体サーフェスについて、2次元多面体サーフェスのみ対応します (2.5次元は対応しません)。2.5次元について、0でない答が与えられるかも知れませんが、完全にXY平面に付いているサーフェスのみです。

ST_AsBinary - ジオメトリ/ジオグラフィの、SRIDメタデータを持たないOGC/ISO Well-Knownバイナリ (WKB)表現を返します。説明ジオメトリのOGC/ISOWell-Knownバイナリ (WKB)表現を返します。最初の形式では、サーバ機のエンディアンをデフォルトとして使います。二つ目の形式では、リトルエンディアン ('NDR')またはビッグエンディアン ('XDR')を指定する文字列を取ります。 WKB書式は、ジオメトリデータをデータベースから、完全な数値精度を維持して読み取るために使われます。これにより、WKT等のテキスト書式で発生する丸め誤差を回避できます。ＷKB表現をPostGISジオメトリに逆変換するにはを使います。 OGC/ISO WKB書式はSRIDを持ちません。SRIDを含むEWKB書式を得るにはを使います。 PostgreSQL 9.0でのデフォルトの振る舞いが変更され、出力がbytea型の16進数エンコーディングなりました。GUIツールで古い振る舞いが必要な場合には、データベース内で SET bytea_output='escape' を実行します。 Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 Enhanced: 2.0.0 高次元が導入されました。 Enhanced: 2.0.0 ジオグラフィでのエンディアン指定が導入されました。 Availability: 1.5.0 ジオグラフィが導入されました。 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をインストールして下さい。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.1 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.37 このメソッドは曲線ストリングと曲線に対応しています。この関数は多面体サーフェスに対応しています。この関数は三角形と不規則三角網 (TIN)に対応しています。この関数は3次元に対応し、Z値を削除しません。

ST_AsGML - GML第2版または第3版としてジオメトリを返します。説明 Geography Markup Language (GML)要素としてジオメトリを返します。versionパラメータは、指定する場合には2か3になります。versionパラメータが無い場合には、デフォルトは2です。maxdecimaldigits引数は出力に使用する小数点以下桁数 (デフォルトは15です)の最大値を減らすために使えます。任意引数maxdecimaldigitsを使用することで、出力ジオメトリが不正になる可能性があります。これを回避するには、前もってに適切なグリッドサイズを与えてこれを使用します。 GML2では2.1.2版を参照し、GML3では3.1.1を参照します。最後の'options'引数はビットフィールドです。GML出力のCRS出力型を定義するために、また緯度/経度でデータを宣言するために使います。 0: GML Short CRS (たとえば EPSG:4326)、デフォルト値 1: GML Long CRS (たとえば urn:ogc:def:crs:EPSG:4326) 2: GML 3のみ対応。srsDimension属性を出力から削除します。 4: GML 3のみ対応。線について<Curve>でなく<LineString>要素を使います。 16: データは緯度/経度 (すなわち SRID=4326)です。デフォルトではデータは平面上にあると仮定します。このオプションはGML 3.1.1による出力でのみ使われ、軸のオーダに関連します。これを設定すると、座標の順序を入れ替えるので、データベースの経度/緯度の順でなく緯度/経度の順になります。 32: ジオメトリのボックス (エンベロープ)を出力します。 'namespace prefix'引数は、カスタム名前空間のプリフィクスを指定したり、名前空間プリフィクスを指定しない (空にした場合)ために使用します。NULLを指定するか省略した場合には、'gml'プレフィクスを使用します。 Availability: 1.3.2 Availability: 1.5.0 ジオグラフィが導入されました。 Enhanced: 2.0.0 プレフィクスが導入されました。 GML 3用であるoptionsの4は、曲線のかわりにラインストリングを使えるようにするためのものです。GML 3の多面体サーフェスとTINが導入されました。optionsの32はボックスを出力するために導入されました。 Changed: 2.0.0 デフォルトの名前付き引数を使います。 Enhanced: 2.1.0 GML 3用にidが導入されました。 ST_AsGMLのGML 3版以上では多面体サーフェスとTINに対応しています。このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 17.2 この関数は3次元に対応し、Z値を削除しません。この関数は多面体サーフェスに対応しています。この関数は三角形と不規則三角網 (TIN)に対応しています。

ST_AsText - ジオメトリ/ジオグラフィのSRIDメタデータのないWell-Known Text (WKT)表現を返します。説明ジオメトリ/ジオグラフィのWell-Known Text (WKT)表現を返します。任意引数maxdecimaldigitsは、出力で使われる小数点以下の最大桁数を制限するのに使います (デフォルトは15)。ＷKT表現をPostGISジオメトリに逆変換するにはを使います。標準のOGC WKT表現はSRIDを含みません。出力表現にSRIDを持たせるには、非標準のPostGIS関数を使います。 WKTにおける数字の文字表現では、完全な浮動小数点数の精度を維持しないことがあります。データ保存や転送で完全な精度を得るにはWell-Known Binary (WKB)書式を使用するのが最善です (およびmaxdecimaldigitsをご覧下さい)。任意引数maxdecimaldigitsを使用することで、出力ジオメトリが不正になる可能性があります。これを回避するには、前もってに適切なグリッドサイズを与えてこれを使用します。 Availability: 1.5 - ジオグラフィ対応が導入されました。 Enhanced: 2.5 - 精度の任意引数が導入されました。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.1 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.25 このメソッドは曲線ストリングと曲線に対応しています。

ST_Boundary - ジオメトリの境界を返します。説明ジオメトリの組み合わせ境界の閉包を返します (訳注: ラインストリングは端点、ポリゴンはエッジ、複合オブジェクトは境界のうち奇数番)。組み合わせ境界はOGC仕様の3.12.3.2節に記述されています。結果として出てくる境界は、OGC SPEC 3.12.2で議論されているように、ジオメトリプリミティブを使って表現できます。 GEOSモジュールで実現しています。 2.0.0より前の版では、この関数はGEOMETRYCOLLECTION.を与えると例外を投げました。2.0.0以上では代わりにNULLが返ります (非対応入力)。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 OGC SPEC s2.1.1.1 このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 5.1.17 この関数は3次元に対応し、Z値を削除しません。 Enhanced: 2.1.0 三角対応が導入されました。 Changed: 3.2.0 TINに対応しました。GEOSを使いません。曲線を線形化しません。

ST_Buffer - あるジオメトリからの距離が指定された距離以下となる点全ての集合となるジオメトリを返します。説明ジオメトリ/ジオグラフィからの距離が与えられた距離より短くなる全ての点を表現するPOLYGONまたはMULTIPOLYGONを生成します。距離に負数を指定すると、ジオメトリは拡大されずに縮小されます。負の距離ではポリゴンを完全に縮小し切る可能性があり、その時はPOLYGON EMPTYを返します。ポイントとラインで負の距離を指定すると、常に空を返します。ジオメトリの場合、指定される距離の単位は、ジオメトリの空間参照系の単位です。ジオグラフィの場合、指定される距離の単位はメートルです。 3番目のパラメータは任意で、バッファの精度とスタイルを扱います。バッファの円弧の精度は四分の一円の近似に使用される辺の数です (デフォルトは8)。バッファのスタイルは キー=値 のペアを空白区切りでリストにして指定します。キーは次の通りです。 'quad_segs=#' : 四分の一円近似に使う辺の数 (デフォルトは8)。 'endcap=round|flat|square' : 終端スタイル (デフォルトは "round")。'butt'は'flat'の同義語として受け付けます。 'join=round|mitre|bevel' : 接続スタイル (デフォルトは"round")。'miter'も'mitre'の同義語として受け付けます。 'mitre_limit=#.#' : マイター比 (訳注: 継ぎ目の内側と外側の距離と線幅との比)の最大値 (継ぎ目スタイルがmiterである場合のみ有効)。'miter_limit'は'mitre_limit'の同義語として受け付けます。 'side=both|left|right' : 'left'または'right'については、線の方向から見た相対的なサイドで、ジオメトリの片側バッファを実行します。これはLINESTRINGジオメトリにだけ関連して、POINTまたはPOLYGONジオメトリには影響がありません。デフォルトでは終端スタイルは四角形です。この関数のジオグラフィ版はジオメトリ実装にかぶせた薄いラッパです。ジオメトリのバウンディングボックスに最適な平面空間参照系を決定します (UTM、ランベルト正積方位図法の北極/南極、最後はメルカトルです)。バッファは平面空間で計算あｓれ、WGS84に戻されます。このため、入力がUTMゾーンと比べて非常に大きくなったり、日付変更線とクロスしたりする場合に、求める動作をしないことがありますバッファ出力は常に妥当なポリゴンジオメトリです。バッファは不正な入力を処理できるので、不正なポリゴンを修復する方法として、距離0のバッファリングが使われます。同じ目的の関数としてはが使われます。バッファ作成は時々、距離内にある地物を検索する際に使われます。この使い方については、の方が効率的です。この関数はZ値を無視します。この関数を3次元ジオメトリ上で使用したとしても、常に2次元の結果となります。 Enhanced: 2.5.0 - ST_Bufferのジオメトリ対応版が強化され、バッファを施す側をside=both|left|rightで指定できるようになりました。 Availability: 1.5 - ST_Bufferが強化され、様々な終端と継ぎ目に対応するようになりました。たとえば、道路ラインストリングを道路ポリゴンに変換する際に終端を丸でなく平面や四角で処理したい場合などに使えます。ジオグラフィ用の薄いラッパが追加されました。 GEOSモジュールで実現しています。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.3 このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 5.1.30

ST_Centroid - ジオメトリの幾何学的重心を返します。説明ジオメトリの幾何学的重心を計算します。[MULTI]POINTに対しては、入力座標の算術平均として計算されます。 [MULTI]LINESTRINGに対しては、各辺の重み付き長さとして計算されます。 [MULTI]POLYGONに対しては、面積から計算されます。空ジオメトリが与えられた場合には、空のGEOMETRYCOLLECTIONが返されます。NULLが与えられた場合には、NULLが返されます。CIRCULARSTRINGまたはCOMPOUNDCURVEが与えられた場合には、まずCurveToLineで直線に変換されてから、LINESTRINGと同じ計算を行います。入力が混合次元の場合には、結果は最大次元のジオメトリの重心と同じになります (低次元ジオメトリは重心に0の「重み」を与えるためです)。ポリゴンジオメトリに対しては、重心は必ずしもポリゴンの内部にあるわけではないことに注意して下さい。たとえば、下図のCの形のポリゴンの重心をご覧下さい。ポリゴン内部にポイントがあることを保障するにはを使います。 New in 2.3.0 : CIRCULARSTRINGとCOMPOUNDCURVEに対応するようになりました (CurveToLineを使います)。 Availability: 2.4.0 ジオグラフィが導入されました。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 8.1.4, 9.5.5

ST_ChangeEdgeGeom - トポロジ構造に影響を与えることなくエッジの形状を変更します。説明トポロジ構造に影響を与えることなくエッジの形状を変更します。全ての引数がNULLであるか、与えられたエッジがtopologyスキーマのedgeテーブルにないか、acurveがLINESTRINGでないか、変更で基になるトポロジが変わるか、のいずれかの場合には、エラーが投げられます。 acurveジオメトリの空間参照系 (SRID) がトポロジと同じでない場合、例外が投げられます。新しいacurveが単純でない場合には、エラーが投げられます。古い位置から新しい位置へのエッジ移動で障害物にあたった場合はエラーが投げられます。 Availability: 1.1.0 Enhanced: 2.0.0 トポロジ整合性の強制を追加しました。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.6

ST_Contains - Bの全てのポイントがA内にあり、かつ、双方の内部に共有点が存在するかどうかをテストします。説明ジオメトリAがジオメトリBを含む場合にはTRUEを返します。AがBを含むというのは、Bのポイントの全てがAの内側 (つまりAの内部または境界)にあり (Aの外部にBのポイントが全くないとも言えます)、かつBの内部の少なくとも一つのポイントがAの内部にある場合に限ります。数学用語では: ST_Contains(A, B) ⇔ (A ⋂ B = B) ∧ (Int(A) ⋂ Int(B) ≠ ∅) 包含関係は反射関係です。あらゆるジオメトリは自己を包含します (対照的に述語内ではジオメトリは確実な包含にはなりません)。また、包含関係は非対称です。ST_Contains(A,B) = trueかつST_Contains(B,A) = trueの場合には、二つのジオメトリはトポロジ的に等価です (ST_Equals(A,B) = true)。 ST_Containsはの反対です。ST_Contains(A,B) = ST_Within(B,A)となります。内部が必ず共通の点を持たなければならないので、定義の微妙な点は、ポリゴンとラインが境界であるラインとポイントを含まないことです。詳細については、Subtleties of OGC Covers, Contains, Withinをご覧下さい。述語は、より包括的な関係を提供します。この関数の呼び出しによって、ジオメトリで使用可能なインデックスを使用するバウンディングボックスの比較が自動的に行われます。インデックスの使用を避けるには_ST_Contains関数を使います。 GEOSモジュールで実現しています。 Enhanced: 2.3.0 PIP short-circuit (ポリゴンとポイントに限定した高速判定)を少ないポイントからなるマルチポイントに対応することができるよう拡張しました。以前の版ではポリゴンとポイントの組み合わせにだけ対応していました。 Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりましたこの関数を不正なジオメトリで呼ばないでください。予期しない結果が返されます。ご注意: これは論理値を返して整数を返さないのが「許される」版です。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.2 // s2.1.13.3 - within(geometry B, geometry A)と同じこのメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.31

ST_ConvexHull - ジオメトリの凸包を計算します。説明ジオメトリの凸包を計算します。凸包は、入力ジオメトリのすべてを囲む最小の凸ジオメトリです。凸包は、ジオメトリの集合に輪ゴムをかけて得られるジオメトリと見ることができます。これは「真空パック」に似ている凹包と異なります。凸包は観察ポイントの集合に基づいて、響を受けた領域を決定するために、しばしば使われます。凸包は一般的にポリゴンです。二つ以上の同一線上のポイントの凸包は、2点のラインストリングになります。一つ以上の同一ポイントの凸包はポイントです。集約関数ではありません。ジオメトリ集合の凸包を計算するには、ジオメトリ集合をジオメトリコレクションに集約するを使います (ST_ConvexHull(ST_Collect(geom))等)。 GEOSモジュールで実現しています。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.3 このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 5.1.16 この関数は3次元に対応し、Z値を削除しません。

ST_CoordDim - ジオメトリの座標次元を返します。説明 ST_Geometry値の座標次元を返します。この関数はのMM対応の別名です。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.3 このメソッドは曲線ストリングと曲線に対応しています。この関数は3次元に対応し、Z値を削除しません。この関数は多面体サーフェスに対応しています。この関数は三角形と不規則三角網 (TIN)に対応しています。

ST_CreateTopoGeo - 空のトポロジにジオメトリのコレクションを追加し、成否を示すメッセージを返します。説明空のトポロジにジオメトリのコレクションを追加し、成否を示すメッセージを返します。空トポロジの追加に使えます。 Availability: 2.0 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.18

ST_Crosses - 二つのジオメトリが内部に共有ポイントを持ち、かつそれだけにならないようになっているかテストします。説明二つのジオメトリを比較して、「空間的にクロスしている」場合にTRUEを返します。ジオメトリは内部の共通点をいくつか持っていますが、全て持っているわけではありません。ジオメトリの内部の共通部分は空ではなく、二つのジオメトリの最大図形次元より小さくなければなりません。二つのジオメトリの共通部分は、入力ジオメトリのいずれとも同じであってはなりません。クロスでないならFALSEを返します。クロスの関係は対称ですが無反射です。数学用語では: ST_Crosses(A, B) ⇔ (dim( Int(A) ⋂ Int(B) ) < max( dim( Int(A) ), dim( Int(B) ) )) ∧ (A ⋂ B ≠ A) ∧ (A ⋂ B ≠ B) DE-9IMインタセクション行列が次の通り合致するとジオメトリはクロスしています。 Point/Line, Point/Area, Line/Areaの場合にはT*T****** Line/Point, Area/Point, Area/Lineの場合にはT*****T** Line/Lineの場合には0******** 点/点の状況や面/面の状況では、結果はFALSEです OpenGIS Simple Feature Specificationでは、この述語はPoint/Line, Point/Area, Line/Line, Line/Areaの場合についてのみ定義されています。JTS/GEOSでは、Line/Point, Area/Point, Area/Lineについて拡張しています。これによって関係が対称になっています。この関数の呼び出しによって、ジオメトリで使用可能なインデックスを使用するバウンディングボックスの比較が自動的に行われます。 Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりましたこのメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.13.3 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.29

ST_CurveToLine - 曲線を含むジオメトリを線ジオメトリに変換します。説明 CIRCULARSTRINGをLINESTRINGに、CURVEPOLYGONをPOLYGONに、MULTISURFACEをMULTIPOLYGONに、それぞれ変換します。CIRCULARSTRINGジオメトリタイプに対応していないデバイスへの出力に使用します。与えられたジオメトリを線型ジオメトリに変換します。それぞれの曲線ジオメトリまたは辺は、`tolerance` とオプションを使用して線形近似に変換します (デフォルトでは4分の1円ごとに32辺でオプションなしです)。 'tolerance_type'引数によって`tolerance`引数の解釈が決定されます。 0 (デフォルト): toleranceは4分の1円の最大辺数です。 1: toleranceは曲線からラインまでの最大差です。単位は入力ジオメトリの単位です。 2: toleranceは生成される半径がなす角度のラジアン単位の最大値です。 'flags'引数はビットフィールドです。デフォルトでは0です。次のビットに対応します。 1: 対称となる (方向独立)出力。 2: 角度維持。対称出力を生成する時に角度 (辺長)減少を避けます。対称フラグがOFFの時は何の効果もありません。 Availability: 1.3.0 Enhanced: 2.4.0 最大距離差による許容範囲と最大角度による許容範囲に対応し、対称出力に対応しました。 Enhanced: 3.0.0 線形化した弧ごとの最小線分数を実装しました。トポロジ的な崩壊を防ぐためです。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.1.7 この関数は3次元に対応し、Z値を削除しません。このメソッドは曲線ストリングと曲線に対応しています。

ST_Difference - ジオメトリBとインタセクトしていないジオメトリAの一部を表現するジオメトリを計算します。説明ジオメトリBとインタセクトしていないジオメトリAの一部を表現するジオメトリを計算します。これはA - ST_Intersection(A,B)と同じです。Aが完全にBに包含されている場合には、適切なタイプの空のジオメトリが返されます。これは、重ね合わせ関数では唯一の入力順序を気にしなければならない関数です。ST_Difference(A, B)は常にAの一部を返します。任意引数gridSizeが与えらえれた場合には、入力は与えられた大きさのグリッドにスナップされ、結果の￥頂点は同じグリッド上で計算されます (GEOS-3.9.0以上が必要)。 GEOSモジュールで実現しています。 Enhanced: 3.1.0 accept a gridSize parameter. Requires GEOS >= 3.9.0 to use the gridSize parameter. このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.3 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.20 この関数は3次元に対応し、Z値を削除しません。ただし、結果はXYのみを使用して計算されます。結果のZ値は複写するか、平均値になるか、補間されます。

ST_Dimension - ST_Geometry値の座標次元を返します。説明ジオメトリの固有次元を返します。ジオメトリは座標次元以下でなければなりません。OGC SPEC s2.1.1.1 - 0ならPOINT、1ならLINESTRING、2ならPOLYGONで、GEOMETRYCOLLECTIONの場合は要素ごとの次元の最大値です。不明なジオメトリ (空のGEOMETRYCOLLECTION等)の場合はNULLが返ります。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.2 Enhanced: 2.0.0 多面体サーフェス対応とTIN対応が導入されました。空ジオメトリを与えた場合に例外を投げなくなりました。 2.0.0より前では、空ジオメトリを与えると例外を投げていました。この関数は多面体サーフェスに対応しています。この関数は三角形と不規則三角網 (TIN)に対応しています。

ST_Disjoint - 二つのジオメトリが共有点を持たないようになっているかテストします。説明二つのジオメトリが接続されていない場合にTRUEを返します。ジオメトリに共有点が全くない場合を指します。二つのジオメトリが他の空間関係がTRUEである場合には接続されていない状況にはありません。接続されていない場合にあｈはFALSEを返します。数学用語では: ST_Disjoint(A, B) ⇔ A ⋂ B = ∅ Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりました GEOSモジュールで実現しています。この関数呼び出しはインデックスを使いません。の否定には、インデックスを使用する、より効率の良い選択肢を使うことができます: ST_Disjoint(A,B) = NOT ST_Intersects(A,B) ご注意: これは論理値を返して整数を返さないのが「許される」版です。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.2 //s2.1.13.3 - a.Relate(b, 'FF*FF****') このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.26

ST_Distance - 二つのジオメトリ値またはジオグラフィ値間の距離を返します。説明型では、二つのジオメトリ間の2次元のデカルト (平面)距離の最小値を返します。単位は投影の単位 (空間参照系の単位)です。型では、二つのジオグラフィ間の最小の測地距離を、メートル単位で返します。SRIDで決定される回転楕円体で計算します。use_spheroidがFALSEの場合には、球面が計算に使われます。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.23 このメソッドは曲線ストリングと曲線に対応しています。 Availability: 1.5.0 1.5でジオグラフィ対応が導入されました。大きいジオメトリや頂点の多いジオメトリについての速度が改善しました。 Enhanced: 2.1.0 ジオグラフィでの速度が改善されました。詳細はMaking Geography fasterをご覧ください。 Enhanced: 2.1.0 - 曲線ジオメトリ対応が導入されました。 Enhanced: 2.2.0 - 精度とロバスト性の向上のためにGeographicLibを使って回転楕円体面上での計測を行うようにしています。この新機能を使うには、Proj 4.9.0以上が必要です。 Changed: 3.0.0 - SFCGALに依存しなくなりました。

ST_EndPoint - LINESTRINGまたはCIRCULARLINESTRINGの終端のポイントを返します。説明 LINESTRINGまたはCIRCULARLINESTRINGジオメトリの、最後のポイントをPOINTで返します。入力パラメータがLINESTRINGでもCIRCULARLINESTRINGでもない場合には、NULLを返します。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.1.4 この関数は3次元に対応し、Z値を削除しません。このメソッドは曲線ストリングと曲線に対応しています。 Changed: 2.0.0 一つのジオメトリマルチラインストリングで動作しなくなりました。PostGIS の古いバージョンでは、この関数は一つのマルチラインストリングで動作し、終端ポイントを返します。2.0.0では、他のマルチラインストリングと同様にNULLを返します。古い動作は文書化されていない機能でしたが、データをLINESTRINGとして格納していると思われるユーザーは、2.0.0 でNULLが返されることを経験するかも知れません。

ST_Envelope - ジオメトリのバウンディングボックスを表現するジオメトリを返します。説明与えられたジオメトリの倍精度浮動小数点数 (float8)の最小バウンディングボックスをジオメトリで返します。ポリゴンはバウンディングボックスの角のポイントで定義されます ((MINX, MINY), (MINX, MAXY), (MAXX, MAXY), (MAXX, MINY), (MINX, MINY))。(PostGISはZMIN/ZMAXも追加します). 縮退する場合 (縦のライン、ポイント)はPOLYGONより低い次元のジオメトリ、すなわちPOINTまたはLINESTRINGを返します。 Availability: 1.5.0 挙動が変更され出力がfloat4からfloat8になりました。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.1 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.19

ST_Equals - 二つのジオメトリが同じ点集合になっているかテストします。説明ジオメトリが「トポロジ的に等価である」場合にTRUEを返します。'='より良い答を得るのに使います。トポロジ的に等価であるとは、ジオメトリが同じ図形次元で、点集合が同じ空間を占めていることを指します。頂点の順位が同じでなくても構いません。ポイントの順序の確認には一貫してを使います (ST_OrderingEqualsは、単純なポイントの順序が同じであるかを確認するより多少厳しいです)。数学用語では: ST_Equals(A, B) ⇔ A = B 次の関係が成り立ちます: ST_Equals(A, B) ⇔ ST_Within(A,B) ∧ ST_Within(B,A) Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりましたこのメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.2 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.24 Changed: 2.2.0 この関数は、どちらのジオメトリも不正であっても、バイナリで同じ場合ならTRUEを返します。

ST_ExteriorRing - ポリゴンの外環を表現するラインストリングを返します。説明 POLYGONの外環を表現するLINESTRINGを返します。ジオメトリがポリゴンでない場合はNULLを返します。この関数はマルチポリゴンでは動作しません。マルチポリゴンに対してはまたはを併用して下さい。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 2.1.5.1 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 8.2.3, 8.3.3 この関数は3次元に対応し、Z値を削除しません。

ST_GMLToSQL - GML表現から指定したST_Geometry値を返します。これはST_GeomFromGMLの別名です。説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.50 (曲線対応を除く) Availability: 1.5 libxml2 1.6+が必要です。 Enhanced: 2.0.0 多面体サーフェス対応とTIN対応が導入されました。 Enhanced: 2.0.0 SRID任意引数が追加されました。

ST_GeomCollFromText - WKT表現と与えられたSRIDからジオメトリのコレクションを生成します。SRIDが与えられていない場合は0とします。説明 Well-Kown-Text (WKT)表現のコレクションと与えられたSRIDからジオメトリのコレクションを生成します。SRIDが与えられていない場合は0とします。 OGC SPEC 3.2.6.2 - 任意引数SRIDは仕様適合のためです。 WKTがGEOMETRYCOLLECTIONでない場合には、NULLを返します。全てのWKTジオメトリがジオメトリコレクションであると絶対的な確信を持てる場合は、この関数は使わないでください。付加的な評価ステップが追加されるのでST_GeomFromTextより遅いです。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s3.2.6.2 このメソッドはSQL/MM仕様の実装です。

ST_GeomFromText - Well-Known Text表現 (WKT)から指定したST_Geometryを返します。説明 OGC Well-Known Text表現からPostGIS ST_Geometryオブジェクトを生成します。 ST_GeomFromText関数には二つの形式があります。一つ目は、SRIDを取らず、空間参照系を持たない (SRID=0)ジオメトリを返すものです。二つ目は、SRIDを第2引数に取り、メタデータの一部としてSRIDを含むジオメトリを返すものです。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s3.2.6.2 - 任意引数SRIDは仕様適合のためです。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.40 このメソッドは曲線ストリングと曲線に対応しています。 OGC非準拠ですが、はST_GeomFromTextやST_PointFromTextより早いです。座標値に数値を使っている場合には簡単になるという利点もあります。他の選択肢としては、速度面ではと似ていて、かつOGC準拠ですが、2次元ポイントしか対応していません。 Changed: 2.0.0 前の版ではST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)')が許されていました。SQL/MM標準への適合のためPostGIS 2.0.0では不正とされます。今はST_GeomFromText('GEOMETRYCOLLECTION EMPTY')となります。

ST_GeomFromWKB - Well-Knwon Binaryジオメトリ表現 (WKB)と任意パラメタのSRIDからジオメトリインスタンスを生成します。説明 ST_GeomFromWKBは、ジオメトリのWell-Known Binary表現と空間参照系識別番号 (SRID)を取り、適切なジオメトリタイプのインスタンスを生成します。この関数は、SQLのジオメトリファクトリの役割を果たします。これは、ST_WKBToSQLの代替名です。 SRIDが指定されていない場合、0 (不明)となります。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s3.2.7.2 - 任意引数SRIDは仕様適合のためです。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.41 このメソッドは曲線ストリングと曲線に対応しています。

ST_GeometryFromText - Well-Knwon Text表現 (WKT)から指定したST_Geometry値を返します。これはST_GeomFromTextの別名です。説明このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.40

ST_GeometryN - ジオメトリコレクションの要素を一つ返します。説明 GEOMETRYCOLLECTION, MULTIPOINT, MULTILINESTRING, MULTICURVE, MULTIPOLYGON, POLYHEDRALSURFACEの入力ジオメトリの、1始まりでN番目の要素を返します。他の場合にはNULLを返します。 OGC仕様のため0.8.0版からインデクスを1始まりにしています。これより前の版では0始まりになっています。ジオメトリの全ての要素を抽出するにはの方が効率的ですし、単一ジオメトリでも動作します。 Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 Changed: 2.0.0 以前の版では非マルチのジオメトリではNULLが返りました。ST_GeometryN(..,1)の場合にはジオメトリを返すよう変更されました。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 9.1.5 この関数は3次元に対応し、Z値を削除しません。このメソッドは曲線ストリングと曲線に対応しています。この関数は多面体サーフェスに対応しています。この関数は三角形と不規則三角網 (TIN)に対応しています。

ST_GeometryType - ジオメトリのSQL-MM型を文字列で返します。説明ジオメトリ型を'ST_LineString', 'ST_Polygon', 'ST_MultiPolygon'等の文字列で返します。この関数はGeometryType(geometry)とは異なり、先頭に'ST'が付き、M値を持っているかを示しません。 Enhanced: 2.0.0 多面体サーフェス対応が導入されました。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.4 この関数は3次元に対応し、Z値を削除しません。この関数は多面体サーフェスに対応しています。

ST_GetFaceEdges - 順序番号を含む、afaceの境界となる、整列したエッジの集合を返します。説明順序番号を含む、afaceの境界となる、整列したエッジの集合を返します。それぞれの出力は、順序番号とエッジ識別番号からなります。順序番号は1から始まります。環ごとのエッジの列挙は、識別番号が最も小さいものから始まります。エッジの順序は左手の法則に従います (境界フェイスは各有向辺の左側にあるようにします)。 Availability: 2.0 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.5

ST_GetFaceGeometry - 指定されたトポロジの中の、フェイス識別番号で指定されたポリゴンを返します。説明指定されたトポロジの中の、フェイス識別番号で指定されたポリゴンを返します。フェイスを作るエッジからポリゴンを構築します。 Availability: 1.1 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.16

ST_InitTopoGeo - 新しいトポロジスキーマを生成し、topology.topologyテーブルに登録します。説明のSQL/MM相当の関数です。空間参照系と許容値の任意引数がありません。トポロジIDでなくトポロジ生成の文字列による説明が返されます。 Availability: 1.1 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.17

ST_InteriorRingN - ポリゴンのN番目の内環 (穴)を返します。説明ポリゴンのN番目の内環を返します。ジオメトリがポリゴンでないかNが範囲外の場合はNULLを返します。この関数はマルチポリゴンでは動作しません。マルチポリゴンに対してはまたはを併用して下さい。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 8.2.6, 8.3.5 この関数は3次元に対応し、Z値を削除しません。

ST_Intersection - ジオメトリAとジオメトリBの共通部分を表現するジオメトリを返します。説明二つのジオメトリのポイント集合の交差を表現するジオメトリを返します。言い換えると、ジオメトリAとジオメトリBの一部であって、二つのジオメトリで共有される部分を返します。ジオメトリが共通するポイントを持っていない (つまり接続されていない)場合には、適切なタイプの空のジオメトリが返されます。任意引数gridSizeが与えらえれた場合には、入力は与えられた大きさのグリッドにスナップされ、結果の￥頂点は同じグリッド上で計算されます (GEOS-3.9.0以上が必要)。と併用するST_Intersectionは、バウンディングボックス、バッファや、対象の国や領域の内部にあるジオメトリの部分のみが必要な場合に使う領域クエリといったようなジオメトリの切り抜きに使えます。この関数のジオグラフィ版はジオメトリ実装にかぶせた薄いラッパです。最初に二つのジオグラフィ値のバウンディングボックスに適合する最適なSRIDを決定します (二つのジオグラフィ値がUTMゾーンの半分以内だけど同じUTMゾーンでない場合はどちらか一つを選びます) (UTMまたはランベルト正積方位図法の北極又は南極を優先し、最悪の場合にメルカトルに後退します)。次に、最適な平面空間参照系でインタセクトする領域を計算して、WGS84ジオグラフィに再変換します。この関数はM値が存在している場合には削除します。 3次元ジオメトリで動作しますが、SFCGALベースのは。3次元ジオメトリの確実な3次元インタセクトした領域を返すので、これを使った方がいいかも知れません。この関数はZ値があっても動作しますが、Z値は平均化されます。 GEOSモジュールで実現しています。 Enhanced: 3.1.0 accept a gridSize parameter Requires GEOS >= 3.9.0 to use the gridSize parameter Changed: 3.0.0 SFCGAL非依存になりました。 Availability: 1.5 ジオグラフィ型が導入されました。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.3 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.18 この関数は3次元に対応し、Z値を削除しません。ただし、結果はXYのみを使用して計算されます。結果のZ値は複写するか、平均値になるか、補間されます。

ST_Intersects - 二つのジオメトリがインタセクトしている (少なくとも一つの共有点がある)かどうかテストします。説明二つのジオメトリがインタセクトする場合にTRUEを返します。任意の共有点を持つ場合を指します。ジオグラフィに対しては、0.00001メートルの距離許容値が使われます (このため非常に近いポイントはインタセクトしているとみなされます)。数学用語では: ST_Intersects(A, B) ⇔ A ⋂ B ≠ ∅ DE-9IMインタセクション行列が次の通り合致するとジオメトリはインタセクトしています。 T******** *T******* ***T***** ****T**** 空間的なインタセクションは全ての他の空間関係テスト関数に含まれます。例外はで、全てのジオメトリがインタセクトしていないかどうかをテストすることになります。この関数の呼び出しによって、ジオメトリで使用可能なインデックスを使用するバウンディングボックスの比較が自動的に行われます。 Changed: 3.0.0 SFCGAL版を削除し、2次元TINのネイティブ対応を追加しました。 Enhanced: 2.5.0 ジオメトリコレクションに対応しました。 Enhanced: 2.3.0 PIP short-circuit (ポリゴンとポイントに限定した高速判定)を少ないポイントからなるマルチポイントに対応することができるよう拡張しました。以前の版ではポリゴンとポイントの組み合わせにだけ対応していました。ジオメトリについては、GEOSモジュールで実現しています。ジオグラフィについてはネイティブです。 Availability: 1.5 ジオグラフィ対応が導入されました。ジオグラフィでは、この関数は0.00001メートルの距離許容を持ち、回転楕円体計算でなく球面を使います。ご注意: これは論理値を返して整数を返さないのが「許される」版です。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.2 //s2.1.13.3 - ST_Intersects(g1, g2 ) --> Not (ST_Disjoint(g1, g2 )) このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.27 このメソッドは曲線ストリングと曲線に対応しています。この関数は三角形と不規則三角網 (TIN)に対応しています。

ST_IsClosed - ラインストリングの始点と終点が一致しているかをテストします。多面体サーフェスについては閉じているか (立体であるか)をテストします。説明 LINESTRINGの始点と終点が一致する場合にTRUEを返します。多面体サーフェスについては、サーフェスが面 (開いている)か立体 (閉じている)かをテストします。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.1.5, 9.3.3 SQL-MMではST_IsClosed(NULL)は0を返しますが、PostGISではNULLを返します。この関数は3次元に対応し、Z値を削除しません。このメソッドは曲線ストリングと曲線に対応しています。 Enhanced: 2.0.0 多面体サーフェス対応が導入されました。この関数は多面体サーフェスに対応しています。

ST_IsEmpty - ジオメトリが空かをテストします。説明ジオメトリが空ジオメトリの場合にtrueを返します。 trueの場合には、このジオメトリは、空のジオメトリコレクション、ポリゴン、ポイント等です。 SQL-MMでは、ST_IsEmpty(NULL)は0を返しますが、PostGISではNULLを返します。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.1 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.7 このメソッドは曲線ストリングと曲線に対応しています。 Changed: 2.0.0 以前の版のPostGISではST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)')を許しました。PostGIS 2.0.0では、SQL/MM標準により準拠させるため、これは不正となります。

ST_IsRing - ラインストリングが閉じていてかつ単純であるかをテストします。説明 LINESTRINGが (ST_StartPoint(g) ~= ST_Endpoint(g))で、かつ (自己インタセクションが無い)場合にTRUEを返します。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 2.1.5.1 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.1.6 SQL-MMでは、ST_IsRing(NULL)は0を返しますが、PostGISではNULLを返します。

ST_IsSimple - ジオメトリが自己インタセクトまたは自己接触となるポイントが無いかをテストします。説明ジオメトリが自己インタセクションや自己接触のような異常な幾何学ポイントを持っていない場合にTRUEを返します。OGCのジオメトリ単純性と妥当性の定義に関する詳細情報については「ジオメトリのOpenGIS準拠を確実にする」をご覧ください。 SQL-MMでは、ST_IsSimple(NULL)は0を返しますが、PostGISではNULLを返します。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.1 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.8 この関数は3次元に対応し、Z値を削除しません。

ST_IsValid - ジオメトリが2次元で整形されているかのテスト。説明 ST_Geometry値が整形式であり、2次元で妥当かどうかをOGC規則に沿ってテストします。3次元と4次元のジオメトリでは、評価は2次元で行います。ジオメトリが不正なら、PostgreSQL NOTICEが出力され、不正である理由の詳細が示されます。 flagsパラメータを持つ版が対応する値についてはで説明しています。ジオメトリ評価に関する詳細情報についてはを参照してください。 SQL-MMでは、ST_IsValid(NULL)は0を返しますが、PostGISではNULLを返します。 GEOSモジュールで実現しています。フラグを受け付ける形式は、2.0.0から有効になりました。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.9 OGC-SFSもSQL-MMもST_IsValidでフラグ引数を含む仕様になっていません。フラグはPostGIS独自拡張です。

ST_Length - 線系ジオメトリの2次元長を返します。説明ジオメトリ型: LINESTRING, MULTILINESTRING, ST_Curve, ST_MultiCurveの場合には2次元デカルト距離を返します。面ジオメトリでは0を返すのでを代わりに使います。長さの単位はジオメトリの空間参照系で決まります。ジオグラフィ型: 計算は逆測地問題を用いています。長さの単位はメートルです。PROJ 4.8.0以上でPostGISをコンパイルしている場合には、回転楕円体面はSRIDで指定されたものとなり、それより前はWGS84となります。use_spheroid = falseとすると、計算は回転楕円体面でなく真球面で行います。現在は、ジオメトリに対してはST_Length2Dの別名ですが、高次元対応に変更されるかも知れません。 Changed: 2.0.0 大幅な変更 -- 以前の版ではジオグラフィのPOLYGONやMULTIPOLYGONへの適用によってPOLYGONやMULTIPOLYGONの周囲長を返しました。2.0.0版ではジオメトリの挙動に従うため0を返すように変更しました。ポリゴンの周囲長を求める場合は、ST_Perimeterを使います。ジオグラフィでは計算は回転楕円体面モデルを使用します。計算が速い反面精度が低い球面計算を使うには、 ST_Length(gg,false)とします。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.5.1 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.1.2, 9.3.4 Availability: 1.5.0 ジオグラフィt対応が導入されました。

ST_LineFromText - WKT表現と与えられたSRIDからジオメトリを生成します。SRIDが与えられていない場合は0 (不明)となります。説明 WKT表現と与えられたSRIDからジオメトリを生成します。SRIDが与えられていない場合は0 (不明)となります。渡されたWKTがLINESTRINGでない場合にはNULLが返ります。 OGC SPEC 3.2.6.2 - 任意引数SRIDは仕様適合のためです。全てのジオメトリがLINESTRINGであると知っている場合は、ST_GeomFromTextを使う方が効率的です。 この関数はST_GeomFromTextの呼び出しと、LINESTRINGを返すかどうかの評価とを行います。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s3.2.6.2 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.2.8

ST_LineFromWKB - WKB表現と与えられたSRIDからLINESTRINGを生成します。説明 ST_LineFromWKBは、ジオメトリのWell-Known Binary表現と空間参照系識別番号 (SRID)を取り、適切なジオメトリタイプを返します。この場合はLINESTRINGジオメトリです。この関数はSQLのジオメトリファクトリの役割を果たします。 SRIDが指定されていない場合は0 (不明)となります。入力byteaがLINESTRINGを表現していない場合はNULLを返します。 OGC SPEC 3.2.6.2 - 任意引数SRIDは仕様適合のためです。全てのジオメトリがLINESTRINGであると知っている場合は、を使う方が効率的です。 この関数はの呼び出しと、LINESTRINGを返すかどうかの評価とを行います。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s3.2.6.2 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.2.9

ST_LinestringFromWKB - WKB表現と与えられたSRIDからジオメトリを生成します。説明 ST_LinestringFromWKBは、ジオメトリのWell-Known Binary表現と空間参照系識別番号 (SRIDを取り、適切なジオメトリタイプのインスタンスを生成します。この場合、LINESTRINGジオメトリです。この関数はSQLのジオメトリファクトリの役割を果たします。 SRIDが指定されていない場合は0 (不明)となります。入力byteaがLINESTRINGを表現していない場合はNULLを返します。これはの別名です。 OGC SPEC 3.2.6.2 - 任意引数SRIDは仕様適合のためです。全てのジオメトリがLINESTRINGであると知っている場合は、を使う方が効率的です。この関数はの呼び出しと、LINESTRINGを返すかどうかの評価とを行います。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s3.2.6.2 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.2.9

ST_LocateAlong - M値に一致するジオメトリ上のポイントを返します。説明 M値を持つジオメトリに沿った位置を返します。結果はポイントまたはマルチポイントです。ポリゴン系入力には対応していません。 offsetが与えられた場合には、結果は、入力ラインの左または右に、指定された距離だけ移動します。正のオフセット値で左に、負の値で右にそれぞれ移動します。この関数は、M要素を持つライン系ジオメトリでのみ使います。 ISO/IEC 13249-3 SQL/MM 空間標準で規定されているため、このような意味になります。 Availability: 1.1.0 それまではST_Locale_Along_Measureでした。 Changed: 2.0.0 以前の版ではST_Locate_Along_Measureと呼ばれていました。この関数はM値に対応します。このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 5.1.13

ST_LocateBetween - M値の範囲に合致する部分ジオメトリを返します。説明指定された範囲のM値を持つ入力ジオメトリの部分ジオメトリとなるジオメトリ (コレクション)を全て返します。 offsetが与えられた場合には、結果は、入力ラインの左または右に、指定された距離だけ移動します。正のオフセット値で左に、負の値で右にそれぞれ移動します。凸でないPOLYGONを抜き出すと不正なジオメトリを返すことがあります。 ISO/IEC 13249-3 SQL/MM 空間標準で規定されているため、このような意味になります。 Availability: 1.1.0 それより前はST_Locate_Between_Measuresでした。 Changed: 2.0.0 以前の版ではST_Locate_Between_Measuresと呼ばれていました。 Enhanced: 3.0.0 - POLYGON, TIN, TRIANGLEへの対応が追加されました。この関数はM値に対応します。このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 5.1

ST_M - ポイントのM値を返します。説明ポイントのM座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。これは (いまだに)OGC仕様に入っていませんが、ポイント座標抽出関数のリストを完全にするために挙げています。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。このメソッドはSQL/MM仕様の実装です。この関数は3次元に対応し、Z値を削除しません。

ST_MLineFromText - WKT表現から指定したST_MultiLineString値を返します。説明 Well-Kown-Text (WKT)表現のコレクションと与えられたSRIDからジオメトリを生成します。SRIDが与えられていない場合は0 (不明)とします。 OGC SPEC 3.2.6.2 - 任意引数SRIDは仕様適合のためです。 WKTがMULTILINESTRINGでない場合はNULLを返します。全てのWKTジオメトリがマルチラインストリングであると絶対的な確信を持てる場合は、この関数は使わないでください。付加的な評価ステップが追加されるのでST_GeomFromTextより遅いです。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s3.2.6.2 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 9.4.4

ST_MPointFromText - Well-Known Text (WKT)表現と与えられたSRIDからジオメトリを生成します。SRIDを与えない場合は0 (不明)となります。説明 Well-Known Text (WKT)表現と与えられたSRIDからジオメトリを生成します。SRIDが与えられていない場合は0 (不明)となります。 OGC SPEC 3.2.6.2 - 任意引数SRIDは仕様適合のためです。 WKTがMULTIPOINTでない場合はNULLを返します。全てのWKTジオメトリがマルチラインストリングであると絶対的な確信を持てる場合は、この関数は使わないでください。付加的な評価ステップが追加されるのでST_GeomFromTextより遅いです。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 3.2.6.2 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 9.2.4

ST_MPolyFromText - Well-Known Text (WKT)表現と与えられたSRIDからマルチポリゴンを生成します。SRIDが与えられていない場合は0 (不明)となります。説明 Well-Known Text (WKT)表現と与えられたSRIDからマルチポリゴンを生成します。SRIDが与えられていない場合は0 (不明)となります。 OGC SPEC 3.2.6.2 - 任意引数SRIDは仕様適合のためです。 WKTがMULTIPOLYGONでない場合はエラーを投げます。全てのWKTジオメトリがマルチポリゴンであると絶対的な確信を持てる場合は、この関数は使わないでください。付加的な評価ステップが追加されるのでST_GeomFromTextより遅いです。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s3.2.6.2 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 9.6.4

ST_ModEdgeHeal - 二つのエッジについて、接続しているノードを削除して修復します。1番目のエッジを編集して、2番目のエッジを削除します。削除されたノードの識別番号を返します。説明二つのエッジについて、接続しているノードを削除して修復します。1番目のエッジを編集して、2番目のエッジを削除します。削除されたノードの識別番号を返します。この関数によって、既存の接続されているエッジとリレーションシップが更新されます。 Availability: 2.0 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.9

ST_ModEdgeSplit - 既存のエッジに沿って新しいノードを生成してエッジを分割します。もとのエッジは変更され、新しいエッジが一つ追加されます。説明既存のエッジに沿って新しいノードを生成してエッジを分割します。もとのエッジは変更され、新しいエッジが一つ追加されます。この関数によって、既存の接続されているエッジとリレーションシップが更新されます。新しく追加されたノードの識別番号が返ります。 Availability: 1.1 Changed: 2.0 - 以前の版では名前を間違えてST_ModEdgesSplitになっていました。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.9

ST_MoveIsoNode - トポロジ内の孤立ノードを別の位置に移動させます。新しいapointジオメトリがノードとして存在しているなら、エラーが投げられます。移動に関する説明を返します。説明トポロジ内の孤立ノードを別の位置に移動させます。新しいapointジオメトリがノードとして存在しているなら、エラーが投げられます。引数がNULLの場合、apointがポイントでない場合、既存のノードが孤立していない (既存のエッジの始端か終端になっている)場合、新しいノード位置が既存のエッジとインタセクトする場合 (終端であっても)、新しい位置が異なるフェイス内にある場合 (3.2.0以降)のいずれかの場合には、例外が投げられます。ポイントジオメトリの空間参照系 (SRID)がトポロジと異なる場合には、例外が投げられます。 Availability: 2.0.0 Enhanced: 3.2.0 ノードが異なるフェイスに移動しないことを保証このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.2

ST_NewEdgeHeal - 二つのエッジについて、接続しているノードを削除して修復します。両方のエッジを削除し、1番目のエッジと同じ方向のエッジに置き換えます。説明二つのエッジについて、接続しているノードを削除して修復します。両方のエッジを削除し、1番目のエッジと同じ方向のエッジに置き換えます。 修復されたエッジに置き換えられた新しいエッジの識別番号を返します。 この関数によって、既存の接続されているエッジとリレーションシップが更新されます。 Availability: 2.0 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.9

ST_NewEdgesSplit - 新しいノードを既存のエッジに沿って作成して、エッジを分割します。もとのエッジは削除され、二つのエッジに置き換えられます。二つの新しいエッジに接続する新しいノードの識別番号を返します。説明 anedgeで指定される既存のエッジに沿ったapointの位置に新しいノードを作成して、エッジを分割します。もとのエッジは削除され、二つつのエッジに置き換えられます。二つの新しいエッジに接続する新しいノードの識別番号を返します。この関数によって、既存の接続されているエッジとリレーションシップが更新されます。ポイントジオメトリの空間参照系 (SRID)がトポロジと異なる場合、apointがポイントジオメトリでない場合、ポイントがNULLの場合、ポイントが既にノードとして存在する場合、エッジが既存のエッジと一致しない場合、ポイントがエッジ内にない場合、例外が投げられます。 Availability: 1.1 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.8

ST_NumGeometries - ジオメトリコレクションの要素数を返します。説明ジオメトリの数を返します。ジオメトリがジオメトリコレクションまたはマルチ系の場合は、ジオメトリの数を返し、単一のジオメトリの場合は1を返し、それ以外の場合はNULLを返します。 Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 Changed: 2.0.0 前の版では、ジオメトリがコレクション/マルチ系でない場合にはNULLを返しました。2.0.0以上では、POLYGON, LINESTRING, POINTといった単一ジオメトリについては1を返します。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 9.1.4 この関数は3次元に対応し、Z値を削除しません。この関数は多面体サーフェスに対応しています。この関数は三角形と不規則三角網 (TIN)に対応しています。

ST_NumInteriorRings - ポリゴンの内環 (穴)の数を返します。説明ポリゴンジオメトリの内環の数を返します。ジオメトリがポリゴンでない場合には、NULLを返します。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 8.2.5 Changed: 2.0.0 - 以前の版では、MULTIPOLYGONを渡して最初のPOLYGONの内環の数を返すことができました。

ST_NumPatches - 多面体サーフェスのフェイス数を返します。多面体でないジオメトリの場合にはNULLを返します。説明多面体サーフェスのフェイス数を返します。多面体でないジオメトリの場合にはNULLを返します。ST_NumGeometriesの別名で、MMの名前付けに対応するためのものです。MM規約を気にしない場合はST_NumGeometriesの方が速いです。 Availability: 2.0.0 この関数は3次元に対応し、Z値を削除しません。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。このメソッドはSQL/MM仕様の実装です。 SQL-MM ISO/IEC 13249-3: 8.5 この関数は多面体サーフェスに対応しています。

ST_NumPoints - ラインストリングまたは曲線ストリングのポイント数を返します。説明 ST_LineStringまたはST_CircularStringのポイント数を返します。1.4より前は仕様通りにラインストリングにのみ対応していました。1.4以上ではラインストリングだけでなく頂点数を返すST_NPointsの別名です。多目的で多数のジオメトリタイプで動作するST_NPointsを使うことを考えて下さい。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.2.4

ST_OrderingEquals - 二つのジオメトリが同じジオメトリを表現し、かつ点の並び順が同じかどうかをテストします。説明 ST_OrderingEqualsは、二つのジオメトリを比較して、ジオメトリが同じで、座標値が同じ順序である場合には、t (TRUE)を返し、それ以外の場合には、f (FALSE)を返します。この関数は、SQL-MM仕様ではなくArcSDE SQL仕様に従って実装しています。http://edndoc.esri.com/arcsde/9.1/sql_api/sqlapi3.htm#ST_OrderingEqualsをご覧ください。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.43

ST_Overlaps - 二つのジオメトリが同じ次元を持ち、インタセクトして、かつ相手と重ならない点少なくとも一つあるかをテストします。説明ジオメトリAとBが「空間的にオーバラップする」場合にTRUEを返します。ジオメトリが同じ次元で、内部のインタセクションも同じ次元で、少なくとも一つの点がもう一方の外側にある (一方がもう一方を覆っている状態でないのと等価です)と、二つのジオメトリがオーバラップしていると言います。オーバラップの関係は、対称性があり、無反射性があります。数学用語では: ST_Overlaps(A, B) ⇔ ( dim(A) = dim(B) = dim( Int(A) ⋂ Int(B) )) ∧ (A ⋂ B ≠ A) ∧ (A ⋂ B ≠ B) この関数の呼び出しによって、ジオメトリで使用可能なインデックスを使用するバウンディングボックスの比較が自動的に行われます。インデックスの使用を避けるには_ST_Overlaps関数を使います。 GEOSモジュールで実現しています。 Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりましたご注意: これは論理値を返して整数を返さないのが「許される」版です。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.2 // s2.1.13.3 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.32

ST_PatchN - 多面体サーフェスのN番目のジオメトリ (フェイス)を返します。説明ジオメトリがPOLYHEDRALSURFACEかPOLYHEDRALSURFACEMの場合には、1始まりでN番目のジオメトリ (フェイス)を返します。それ以外の場合には、NULLを返します。多面体サーフェスを引数にとるST_GeometryNと同じ答えが返ります。ST_GeometryNの方が速いです。インデクスは1始まりです。ジオメトリの全ての要素を抽出するにはが最も効率的です。 Availability: 2.0.0 このメソッドはSQL/MM仕様の実装です。 SQL-MM ISO/IEC 13249-3: 8.5 この関数は3次元に対応し、Z値を削除しません。この関数は多面体サーフェスに対応しています。

ST_Perimeter - ポリゴンジオメトリまたはジオグラフィの境界の長さを返します。説明ジオメトリ/ジオグラフィがST_SrrfaceまたはST_MultiSurface (POLYGONまたはMULTIPOLYGON)の場合に、2次元周囲長を返します。面ジオメトリでない場合には0を返します。ラインストリングについてはを使います。ジオメトリに対しては、周囲長の計測単位は空間参照系によります。ジオグラフィに対しては、測地線の逆測地問題を使って計算し、長さの単位はメートルです。PostGISをPROJ 4.8.0以上でコンパイルしているなら、回転楕円体面はSRIDで指定されたものですが、そうでなければ、WGS84に限定されます。use_spheroid = falseとすると、回転楕円体面でなく近似する球面で計算します。現在は、この関数はST_Perimeter2Dの別名ですが、高次元対応に変更されるかも知れません。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.5.1 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 8.1.3, 9.5.4 Availability: 2.0.0 ジオグラフィ対応が導入されました。

ST_Point - X, YとSRIDの値からポイントを生成します。説明与えられたXとYの座標値からポイントを返します。これは、XとYを取るSQL-MMのと同等です。地理座標系について、Xは経度で、Yは緯度です。 Enhanced: 3.2.0 SRID任意引数が追加されました。古いバージョンでは、ジオメトリにSRIDを与えるにはST_SetSRIDを併用しなければなりませんでした。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 6.1.2

ST_PointFromText - WKTと与えられたSRIDからポイントジオメトリを生成します。SRIDが与えられていない場合は0 (不明)とします。説明 OGC Well-Known Text表現からPostGISのST_Geometryポイントオブジェクトを生成します。SRIDが与えられていない場合は不明 (現在は0)とします。ジオメトリがWKTポイント表現でない場合はNULLを返します。完全に不正なWKTならエラーが投げられます。 ST_PointFromTextには二つの形式があります。 一つ目は、SRIDを取らずに空間参照系を定義していないジオメトリを返すものです。 二つ目は、空間参照系識別番号を第2引数に取り、SRIDをメタデータの一部として含むST_Geometryを返すものです。SRIDはspatial_ref_sysテーブルで定義されていなければなりません。全てのWKTジオメトリがジオメトリコレクションであると絶対的な確信を持てる場合は、この関数は使わないでください。付加的な評価ステップが追加されるのでST_GeomFromTextより遅いです。 経度緯度座標からポイントを生成していて、OGC対応よりもパフォーマンスと精度を重視する場合は、か、OGC対応の別名であるを使用して下さい。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s3.2.6.2 - 任意引数SRIDは仕様適合のためです。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 6.1.8

ST_PointFromWKB - WKBと与えられたSRIDからジオメトリを生成します。説明 ST_PointFromWKBは、ジオメトリのWell-Known Binary表現と空間参照系識別番号 (SRID)を取り、適切なジオメトリタイプのインスタンスを生成します。この場合、POINTジオメトリです。この関数はSQLのジオメトリファクトリの役割を果たします。 SRIDが指定されていない場合は0 (不明)となります。入力byteaがPOINTジオメトリを表現しないならNULLが返されます。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s3.2.7.2 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 6.1.9 この関数は3次元に対応し、Z値を削除しません。このメソッドは曲線ストリングと曲線に対応しています。

ST_PointN - ジオメトリの最初のラインストリングまたは曲線ストリングのN番目のポイントを返します。説明ラインストリングまたは曲線ストリングのN番目の点を返します。負数はラインストリングの終端から逆方向に遡って数えます。-1は終端を指します。ジオメトリにラインストリングが無い場合には、NULLを返します。 OGC仕様のため0.8.0版からインデックスを1始まりにしています。これより前の版では0はじまりになっています。後方インデックス (負数インデックス)はOGC仕様ではありません。マルチラインストリング内のラインストリングのN番目のポイントを得るには、ST_Dumpを併用します。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.2.5, 7.3.5 この関数は3次元に対応し、Z値を削除しません。このメソッドは曲線ストリングと曲線に対応しています。 Changed: 2.0.0 単一ジオメトリのMULTILINESTRINGで動作しなくなりました。単一のラインストリングからなるMULTILINESTRINGについては幸運にも動いていて、最初のポイントを返していました。2.0.0では他のMULTILINESTRINGと同様にNULLを返すようになりました。 Changed: 2.3.0 : 負数インデックスが有効になりました (-1は終端を指します)

ST_PointOnSurface - ポリゴン内またはジオメトリ上にあるのが保証されたポイントを返します。説明サーフェス (POLYGON、MULTIPOLYGON、CURVED POLYGON)内部にあることが保証されたPOINTを返します。PostGISでは、この関数はラインジオメトリとポイントジオメトリ上でも動作します。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s3.2.14.2 // s3.2.18.2 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 8.1.5, 9.5.6. 仕様では、サーフェスジオメトリのみのST_PointOnSurfaceが定義されています。PostGISは、すべての一般的なジオメトリタイプに対応するよう拡張しています。他のデータベース (Oracle、DB2、ArcSDE)は、サーフェスに対してのみこの機能をサポートしているようです。SQL Server 2008では、すべての一般的なジオメトリタイプに対応しています。この関数は3次元に対応し、Z値を削除しません。

ST_Polygon - ラインストリングから指定したSRIDを持つポリゴンを生成します。説明与えられたラインストリングから構築し、sridから空間参照系を指定したポリゴンを返します。 ST_Polygonはの形式1の、SRIDの設定を追加したものに似ています。穴を持つポリゴンを生成するには、の形式2を使い、を使います。この関数はマルチラインストリングを受け付けません。ラインストリングの生成にはを使用します。また、ラインストリングを抽出するにはを使用します。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 8.3.2 この関数は3次元に対応し、Z値を削除しません。

ST_PolygonFromText - Well-Known Text (WKT)表現と与えられたSRIDからジオメトリを生成します。SRIDを与えない場合は0 (不明)となります。説明 WKT表現と与えられたSRIDからジオメトリを生成します。SRIDが与えられていない場合は0 (不明)とします。WKTがポリゴンでない場合はNULLを返します。 OGC SPEC 3.2.6.2 - 任意引数SRIDは仕様適合のためです。全てのWKTジオメトリがポリゴンであると絶対的な確信を持てる場合は、この関数は使わないでください。付加的な評価ステップが追加されるのでST_GeomFromTextより遅いです。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s3.2.6.2 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 8.3.6

ST_Relate - 二つのジオメトリが与えられた交差行列パターンに合致するトポロジ関係があるかどうかを見るか、交差行列を計算するかします。説明これらの関数で、二つのジオメトリに対するDimensionally Extended 9-Intersection Model (DE-9IM)で定義される空間 (トポロジ)関係のテストと評価が可能になります。 DE-9IMは9要素の行列で、二つのジオメトリの内部、境界、外部のインタセクションの次元を示しています。'F', '0', '1', '2'の文字による9文字の文字列で表現します (例えば 'FF1FF0102')。 intersection matrix patternで、特定の種類の空間関係のテストができます。パターンでは追加の文字 'T' (「インタセクションが空でない」という意味)と '*' (「値はなんでもいい」という意味)を使うことができます。一般的な空間関係については、名前の付いた関数, , , , , , , , , , として提供されます。明示的なパターンを使うことで、インタセクト、クロス等の複数のテストを一回でできるようになります。また、名前のある空間関係関数を持たない空間関係のテストも可能になります。たとえば、「内部インタセクション」という空間関係は、名前の付いた空間関係関数では評価できませんが、T********のDE-9IMで評価できます。詳細情報についてはをご覧下さい。一つ目の形式: 二つのジオメトリが、与えられたintersectionMatrixPatternによる空間関係に合うかどうかを見ます。他の名前の付いた空間関係述語の多くと異なり、この関数は自動ではインデックスの呼び出しを*行いません*。インタセクト*しない*ジオメトリでTRUEになる関係があるためです。インタセクションが求められる関係パターンを使用している場合には、関数呼び出しに&&を取り入れてください。存在するなら、名前の追加空間関係関数を使う方が良いです。空間インデックスが存在するなら自動で使用してくれるからです。また、完全な関係評価では有効にならない能率最適化が実装されていることがあります。二つ目の形式: 二つのジオメトリの空間関係のDE-9IM行列文字列を返します。行列文字列は、を使ったDE-9IMパターンと合致するかテストさせることができます。三つ目の形式: 二つ目の形式と同じですが、境界ノード規則の指定ができる点が異なります。この規則によって、マルチラインストリングの端点がDE-9IMの内部または境界上にあると判定されるかどうかを細かく制御できます。boundaryNodeRuleの値は次の通りです。 1: OGC-Mod2 - 線の端点が奇数回出現する場合に境界内にあるとします。これはOGC SFS標準で定義された規則で、ST_Relateのデフォルトです。 2: Endpoint - 全ての端点は境界上にあります。 3: MultivalentEndpoint - 端点が2回以上出現する場合に境界内にあるとします。言い換えると、境界は全ての「接続された」または「内部の」端点です (「接続していない」や「外部の」端点ではない)。 4: MonovalentEndpoint - 端点が1回だけ出現する場合に限って、境界内にあるとします。言い換えると境界は全ての「接続していない」または「外部の」端点です。 OGC仕様にはありませんが実装しました。s2.1.13.2をご覧下さい。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.2 // s2.1.13.3 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.25 GEOSモジュールで実現しています。 Enhanced: 2.0.0 - 境界ノード規則が追加されました。 Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりました

ST_RemEdgeModFace - エッジを削除します。削除されるエッジが二つのフェイスを分割していたなら、一方のフェイスを削除し、もう一方のフェイスを両方の空間を覆うように編集します。説明エッジを削除します。削除されるエッジが二つのフェイスを分割していたなら、一方のフェイスを削除し、もう一方のフェイスを両方の空間を覆うように編集します。右側のフェイスを優先的に保持します。これはと一致します。残ったフェイスのIDを返します。この関数によって、既存の接続されているエッジとリレーションシップが更新されます。既存のTopoGeometryの定義に入り込んでいるエッジは削除を拒絶されます。TopoGeometryが二つのフェイスのうちひとつだけで定義されている (かつ他方は定義に使われていない)場合、二つのフェイスの修復は拒絶されます。引数がNULLである場合、与えられたエッジが不明である場合 (トポロジスキーマのedgeテーブル内に既に存在していなければなりません)、トポロジ名が不正である場合、例外が投げられます。 Availability: 2.0 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.15

ST_RemEdgeNewFace - エッジを削除し、消去対象エッジでフェイスが二つに分割されているなら元の二つのフェイスを削除し、一つの新しいフェイスに置き換えます。説明エッジを削除し、消去対象エッジでフェイスが二つに分割されているなら元の二つのフェイスを削除し、一つの新しいフェイスに置き換えます。新しく作成されたフェイスの識別番号を返します。新しいフェイスが生成されない場合にはNULLを返します。削除対象エッジがダングルである (訳注: 「ぶらさがる」状態、すなわち一方の端が孤立ノードでなく、かつもう一方が孤立ノード)場合か、孤立している場合か、 ユニバースフェイスとの境界になっている (おそらく反対側のフェイスにユニバースが侵入します)場合には、フェイスは生成されません。この関数によって、既存の接続されているエッジとリレーションシップが更新されます。既存のTopoGeometryの定義に入り込んでいるエッジは削除を拒絶されます。TopoGeometryが二つのフェイスのうちひとつだけで定義されている (かつ他方は定義に使われていない)場合、二つのフェイスの修復は拒絶されます。引数がNULLである場合、与えられたエッジが不明である場合 (トポロジスキーマのedgeテーブル内に既に存在していなければなりません)、トポロジ名が不正である場合、例外が投げられます。 Availability: 2.0 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.14

ST_RemoveIsoEdge - 孤立エッジを削除し、実行結果の記述を返します。エッジが孤立していない場合には、例外が投げられます。説明孤立エッジを削除し、実行結果の記述を返します。エッジが孤立していない場合には、例外が投げられます。 Availability: 1.1 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.3

ST_RemoveIsoNode - 孤立ノードを削除し、実行結果が返されます。ノードが孤立していない (エッジの始端または終端である)場合には、例外が投げられます。説明孤立ノードを削除し、実行結果が返されます。ノードが孤立していない (エッジの始端または終端である)場合には、例外が投げられます。 Availability: 1.1 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.3

ST_SRID - ジオメトリの空間参照系識別子を返します。説明 ST_Geometryのspatial_ref_sysテーブルで定義されている空間参照系の識別番号を返します。を参照して下さい。 spatial_ref_sysテーブルはPostGISが知る参照系の全てのカタログを作っていて、ある空間参照系から他の空間参照系に変換するために使われます。ジオメトリの変換を予定している場合は正しい空間参照系の識別番号を持っているか確認することは重要です。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.1 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.5 このメソッドは曲線ストリングと曲線に対応しています。

ST_StartPoint - ラインストリングの始点を返します。説明 LINESTRINGまたはCIRCULARLINESTRINGジオメトリの、最初のポイントをPOINTで返します。入力パラメータがLINESTRINGでもCIRCULARLINESTRINGでもない場合には、NULLを返します。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 7.1.3 この関数は3次元に対応し、Z値を削除しません。このメソッドは曲線ストリングと曲線に対応しています。 Enhanced: 3.2.0 全てのジオメトリのポイントを返すようになりました。以前のバージョンではラインストリング以外ではNULLを返していました。 Changed: 2.0.0 一つのMULTILINESTRINGで動作しなくなりました。PostGIS の古いバージョンでは、この関数は、一つのラインストリングからなるMULTILINESTRINGについては幸運にも動いていて、始端ポイントを返していました。2.0.0では他のMULTILINESTRINGと同様にNULLを返すようになりました。古い動作は文書化されていない機能でしたが、データをLINESTRINGとして格納していると思われるユーザーは、2.0.0 でNULLが返されることを経験するかも知れません。

ST_SymDifference - ジオメトリAとジオメトリBがインタセクトしていない部分を表現するジオメトリを返します。説明ジオメトリAとジオメトリBがインタセクトしていない部分を表現するジオメトリを返します。この関数は、ST_Union(A,B) - ST_Intersection(A,B)と同じです。SymDifference (対象差)と呼ばれるのはST_Union(A,B) - ST_Intersection(A,B)だからです。任意引数gridSizeが与えらえれた場合には、入力は与えられた大きさのグリッドにスナップされ、結果の￥頂点は同じグリッド上で計算されます (GEOS-3.9.0以上が必要)。 GEOSモジュールで実現しています。 Enhanced: 3.1.0 accept a gridSize parameter. Requires GEOS >= 3.9.0 to use the gridSize parameter このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.3 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.21 この関数は3次元に対応し、Z値を削除しません。ただし、結果はXYのみを使用して計算されます。結果のZ値は複写するか、平均値になるか、補間されます。

ST_Touches - 二つのジオメトリが少なくとも一つの共有点を持ち、かつ内部でインタセクトしていないようになっているかテストします。説明 AとBがインタセクトするがAの内部とBの内部がインタセクトしない場合にはTRUEを返します。AとBが少なくとも一つの共有点があり、共有点が少なくとも一つの境界の上にあることと同じです。ポイント/ポイント入力では、ポイントは境界を持たないため、常にFALSEを返します。数学用語では: ST_Touches(A, B) ⇔ (Int(A) ⋂ Int(B) ≠ ∅) ∧ (A ⋂ B ≠ ∅) この関係は、二つのジオメトリのDE-9IM交差行列がどれか一つに合致すると、関係が保持されていることになります。 FT******* F**T***** F***T**** この関数の呼び出しによって、ジオメトリで使用可能なインデックスを使用するバウンディングボックスの比較が自動的に行われます。インデックスの使用を避けるには_ST_Touchesを代わりに使います。 Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりましたこのメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.2 // s2.1.13.3 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.28

ST_Transform - 異なる空間参照系に投影変換された新しいジオメトリを返します。説明異なる空間参照系に投影変換された新しいジオメトリを返します。変換先空間参照系であるto_sridは、妥当なSRID整数パラメータ (spatial_ref_sysにあるということ)です。他にも、to_projとfrom_projにPROJ.4文字列で定義された空間参照系を指定することができますが、最適化されません。変換先空間参照系がSRIDの代わりにPROJ.4文字列で表現されている場合には、出力ジオメトリのSRIDは0になります。from_projを使う場合には、入力ジオメトリは定義されたSRIDを持っていなければなりません。 ST_Transformはしばしばと混同されます。ST_Transformは実際にジオメトリの座標を、ある空間参照系から他のものに変換します。ST_SetSRIDは単にジオメトリのSRIDを変更するだけです。 ST_Transformは変換元空間参照系と変換先空間参照系に与える適切な変換パイプラインを自動的に選択します。特定の変換法を使用するにはを使います。 PostGISはPROJ対応でコンパイルする必要があります。PROJ対応でコンパイルしたかを確認するにはを使います。一つ以上の変換を行う場合は、インデクスの利点を得るために、使用する変換に関する関数インデクスを持つと便利です。 1.3.4より前では、曲線を含むジオメトリで使用すると、この関数はクラッシュします。これは1.3.4以上で訂正されています。 Enhanced: 2.0.0 多面体サーフェス対応が導入されました。 Enhanced: 2.3.0 直接のPROJ.4文字列への対応が導入されました。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.6 このメソッドは曲線ストリングと曲線に対応しています。この関数は多面体サーフェスに対応しています。

ST_Union - 入力ジオメトリのポイント集合の結合を表現するジオメトリを返します。説明入力ジオメトリを結合してオーバラップをしない結果ジオメトリを生成します。出力は単一ジオメトリ、マルチ系ジオメトリ、ジオメトリコレクションのいずれにかなる可能性があります。次の通り複数の形式があります。二入力形式: 二つの入力ジオメトリの結合のジオメトリを返します。いずれかの入力がNULLの場合にはNULLを返します。配列形式: ジオメトリ配列を結合したジオメトリを返します。集約関数形式: ジオメトリの集合を結合したジオメトリを返します。ST_Union()関数は、PostgreSQL用語で言うところの「集約関数」です。つまり、SUM()やMEAN()と同じ方法で複数のデータ行の操作を行い、他の集約関数と同じようにNULLジオメトリを無視します。非集約関数で入力が一つの形式であるも参照して下さい。 ST_Unionの配列形式と集合形式では、http://blog.cleverelephant.ca/2009/01/must-faster-unions-in-postgis-14.htmlで紹介されている早いカスケード結合アルゴリズムを使っています。固定精度空間で動作するようgridSizeを指定できます。入力は与えられたグリッドにスナップされ、結果の頂点は同じグリッド上で計算されます (GEOS-3.9.0以上が必要です)。は、結果に重ね合わせが無いことを求めていない場合には、時々ST_Unionの代わりに用いられます。ST_Collectは、集めレれたジオメトリに処理を実行しないため、通常はST_Unionより早い動作速度になります。 GEOSモジュールで実現しています。 ST_UnionはMULTILINESTRINGを生成し、新しいLINESTRINGを単一のLINESTRINGに縫い付けません。LINESTRINGに縫い付けるにはを使用します。ご注意: この関数は以前は、"Union"から名称変更してGeomUnion()と呼ばれていました。UNIONはSQLの予約語であるためです。 Enhanced: 3.1.0 accept a gridSize parameter. Requires GEOS >= 3.9.0 to use the gridSize parameter Changed: 3.0.0 SFCGAL非依存になりました。 Availability: 1.4.0 - ST_Unionが機能強化されました。ST_Union(geomarray)が導入され、PostgreSQLの高速なコレクションの集約が導入されました。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.3 集約関数版は、OGC仕様に明示的に定義されていません。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.19 ポリゴンが含まれる時、Z値 (標高)を持ちます。この関数は3次元に対応し、Z値を削除しません。ただし、結果はXYのみを使用して計算されます。結果のZ値は複写するか、平均値になるか、補間されます。

ST_Volume - 3次元立体の体積を計算します。面ジオメトリは (閉じていても)0を返します。説明 Availability: 2.2.0 このメソッドにはSFCGALバックエンドが必要です。この関数は3次元に対応し、Z値を削除しません。この関数は多面体サーフェスに対応しています。この関数は三角形と不規則三角網 (TIN)に対応しています。このメソッドはSQL/MM仕様の実装です。 SQL-MM IEC 13249-3: 9.1 (ST_3DVolumeと同じ)

ST_WKBToSQL - Well-Known Binary表現 (WKB)からST_Geometry値を生成します。これはSRIDを取らないST_GeomFromWKBの別名です。説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.36

ST_WKTToSQL - Well-Knwon Text表現 (WKT)から指定したST_Geometry値を返します。これはST_GeomFromTextの別名です。説明このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.34

ST_Within - Aの全てのポイントがB内にあり、かつ両方の内部が共有点を持つかどうかをテストします。説明ジオメトリAがジオメトリB内にある場合にTRUEを返します。Aの全ての点がBの内側 (内部または境界)にあり、Aの内部とBの内部に少なくとも一つの共有点がある場合に限って、AはB内にあると言います。渡すジオメトリが両方とも同じSRIDでなければ、この関数は意味がありません。数学用語では: ST_Within(A, B) ⇔ (A ⋂ B = A) ∧ (Int(A) ⋂ Int(B) ≠ ∅) 内にある、という関係性には反射性があります。全てのジオメトリは、自分の内にあると言えます。また、非対称性を持ちます。ST_Within(A,B) = trueかつST_Within(B,A) = trueの場合には、二つのジオメトリは必ずトポロジ的に等価 (ST_Equals(A,B) = true)になります。 ST_Withinはの反対です。ST_Within(A,B) = ST_Contains(B,A)となります。内部が必ず共有点を持つので、定義は、ポリゴンまたはラインの境界上にあるラインまたはポイントはジオメトリの内にないという微妙なものになります。詳細については、Subtleties of OGC Covers, Contains, Withinをご覧下さい。述語はより包括的な関係を提供します。この関数の呼び出しによって、ジオメトリで使用可能なインデックスを使用するバウンディングボックスの比較が自動的に行われます。インデックスの使用を避けるには_ST_Within関数を使います。 GEOSモジュールで実現しています。 Enhanced: 2.3.0 ジオメトリについて、PIP short-circuit (ポリゴンとポイントに限定した高速判定)を少ないポイントからなるマルチポイントに対応することができるよう拡張しました。以前の版ではポリゴンとポイントの組み合わせにだけ対応していました。 Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりましたこの関数を不正なジオメトリで呼ばないでください。予期しない結果が返されます。ご注意: これは論理値を返して整数を返さないのが「許される」版です。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。 s2.1.1.2 // s2.1.13.3 - a.Relate(b, 'T*F**F***') このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 5.1.30

ST_X - ポイントのX値を返します。説明ポイントのX座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。ジオメトリのX値の最小値と最大値を得るにはとを使います。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 6.1.3 この関数は3次元に対応し、Z値を削除しません。

ST_Y - ポイントのY値を返します。説明ポイントのY座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。ジオメトリの値の最小値と最大値を得るにはとを使います。このメソッドは OGC Simple Features Implementation Specification for SQL 1.1 の実装です。このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 6.1.4 この関数は3次元に対応し、Z値を削除しません。

ST_Z - ポイントのZ値を返します。説明ポイントのZ座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。ジオメトリのZ値の最小値と最大値を得るにはとを使います。このメソッドはSQL/MM仕様の実装です。この関数は3次元に対応し、Z値を削除しません。

TG_ST_SRID - TopoGeometryの空間参照識別子を返します。説明 ST_Geometryのspatial_ref_sysテーブルで定義されている空間参照系の識別番号を返します。を参照して下さい。 spatial_ref_sysテーブルはPostGISが知る参照系の全てのカタログを作っていて、ある空間参照系から他の空間参照系に変換するために使われます。ジオメトリの変換を予定している場合は正しい空間参照系の識別番号を持っているか確認することは重要です。 Availability: 3.2.0 このメソッドはSQL/MM仕様の実装です。 SQL-MM 3: 14.1.5

PostGISジオグラフィ対応関数

次に示す関数と演算子は、ジオグラフィデータ型を入力または出力に取るPostGIS関数/演算子です。

Note

(T)の付いた関数はネイティブなジオグラフィ関数ではなく、実行時にST_Transformを使ってジオメトリとの変換を行います。結果として、日付変更線や極を超えたり、ひとつのUTMゾーンではカバーできない巨大なジオメトリを使用する場合に、予期しない挙動になることがあります。基本的な変換としては、UTMが望ましいですが、ランベルト正積方位図法(北/南)、最悪のシナリオでメルカトルに頼ります。

ST_Area - ポリゴンジオメトリの面積を返します。

ST_AsBinary - ジオメトリ/ジオグラフィの、SRIDメタデータを持たないOGC/ISO Well-Knownバイナリ (WKB)表現を返します。

ST_AsEWKT - ジオメトリのSRIDメタデータが付いたWell-Known Text (WKT)表現を返します。

ST_AsGML - GML第2版または第3版としてジオメトリを返します。

ST_AsGeoJSON - ジオメトリをGeoJSON要素として返します。

ST_AsKML - ジオメトリをKML要素として返します。

ST_AsSVG - ジオメトリからSVGパスデータを返します。

ST_AsText - ジオメトリ/ジオグラフィのSRIDメタデータのないWell-Known Text (WKT)表現を返します。

ST_Azimuth - 北を基準とした2点間の線の方位角を返します。

ST_Buffer - あるジオメトリからの距離が指定された距離以下となる点全ての集合となるジオメトリを返します。

ST_Centroid - ジオメトリの幾何学的重心を返します。

ST_ClosestPoint - g1上にある、g2と最近傍となる2次元ポイントを返します。これは、あるジオメトリから他のジオメトリへの最短ラインの一つ目のポイントです。

ST_CoveredBy - Aの全てのポイントがB内にあるかをテストします。

ST_Covers - Bの全ての点がA内にあるかをテストします。

ST_DWithin - 二つのジオメトリが与えらえれた距離内にあるかどうかをテストします。

ST_Distance - 二つのジオメトリ値またはジオグラフィ値間の距離を返します。

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 - ジオメトリAとジオメトリBの共通部分を表現するジオメトリを返します。

ST_Intersects - 二つのジオメトリがインタセクトしている (少なくとも一つの共有点がある)かどうかテストします。

ST_Length - 線系ジオメトリの2次元長を返します。

ST_LineInterpolatePoint - ラインに沿って、割合で示された位置の補間ポイントを返します。

ST_LineInterpolatePoints - ラインに沿って、割合で示された複数の位置の補間ポイントを返します。

ST_LineLocatePoint - ポイントに最も近いライン上のポイントの位置を割合で返します。

ST_LineSubstring - 二つの割合位置からラインの一部を返します。

ST_Perimeter - ポリゴンジオメトリまたはジオグラフィの境界の長さを返します。

ST_Project - 始点から距離と方位で算出されたポイントを返します。

ST_Segmentize - 与えた長さを超える線分を持たないよう変更したジオメトリ/ジオグラフィを返します。

ST_ShortestLine - 二つのジオメトリの3次元の最短ラインを返します。

ST_Summary - ジオメトリについての要約文を返します。

<-> - AとBの2次元距離を返します。

&& - Aの2次元バウンディングボックスがBの2次元バウンディングボックスとインタセクトする場合にTRUEを返します。

PostGISラスタ機能関数

次に示す関数と演算子は、rasterデータ型を入力または出力に取るPostGIS関数/演算子です。アルファベット順に示します。

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/ST_AsWKB - ラスタのWell-Known Binary (WKB)表現を返します。

ST_AsGDALRaster - 指定されたGDALラスタ書式でラスタタイルを返します。ラスタ書式はコンパイルしたライブラリが対応するものです。ライブラリが対応する書式の一覧を得るにはST_GDALRasters()を使います。

ST_AsHexWKB - Well-Known Binary (WKB)ラスタを16進数表現で返します。

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_BandFileSize - ファイルシステムに格納されているバンドのファイルサイズを返します。バンド番号が指定されていない場合には、1番と仮定します。

ST_BandFileTimestamp - ファイルシステムに格納されているバンドのファイルタイムスタンプ返します。バンド番号が指定されていない場合には、1番と仮定します。

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_Contour - 与えられたラスタバンドから等高線ベクタを生成します。GDAL等高線生成アルゴリズムを使います。

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_Grayscale - 元のラスタと指定したバンドを赤、緑、青バンドとして一つの8BUIバンドを持つラスタを生成します。

ST_HasNoBand - 指定したバンド番号のバンドが無い場合には、TRUEを返します。バンド番号を指定していない場合には、1番と仮定します。

ST_Height - ラスタの高さをピクセル単位で返します。

ST_HillShade - 与えられた方位、高度、明度、スケールの入力を使って標高ラスタバンドの仮想照明を返します。

ST_Histogram - ラスタまたはラスタカバレッジのビン範囲で分割したデータ分布をまとめるヒストグラムの集合を返します。ビン数を指定しない場合には自動計算されます。

ST_InterpolateRaster - X値とY値を使用してグリッド上のポイントを配置し、ポイントのZ値をサーフェス標高として配置し、3次元ポイントの入力セットに基づいてグリッドサーフェスを補間します。

ST_Intersection - 二つのラスタの共有部分またはベクタ化したラスタとジオメトリとのインタセクトした部分を表現する、ラスタまたはジオメトリとピクセル値の組の集合を返します。

ST_Intersects - rastAがrastBとインタセクトする場合にTRUEを返します。

ST_IsEmpty - ラスタが空 (幅が0で高さが0)の場合にはTRUEを返します。他の場合には、FALSEを返します。

ST_MakeEmptyCoverage - 空のラスタタイルのグリッドでジオリファレンスを施されている領域を生成します。

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_RastFromHexWKB - Well-Knownバイナリ (WKB)ラスタの16進数表現からラスタを返します。

ST_RastFromWKB - Well-Known Binary (WKB)ラスタからラスタ値を返します。

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_SetBandIndex - データベース外バンドの外部バンド番号の更新

ST_SetBandIsNoData - バンドのisnodataフラグをTRUEにします。

ST_SetBandNoDataValue - 指定したバンドにNODATAを表現する値を設定します。バンドを指定しない場合には、1番と仮定します。NODATA値を持たないようにするには、nodatavalueにNULLを指定します。

ST_SetBandPath - データベース外バンドの外部パスとバンド番号を更新します。

ST_SetGeoReference - 地理参照6パラメタを一度に設定します。数値は空白で区切ります。GDALまたはESRI書式の入力を受け付けます。デフォルトはGDALです。

ST_SetM - 入力ジオメトリと同じX/Y値を持ち、かつ、指定されたリサンプリングアルゴリズムを使ってラスタから複写されたM値を持つジオメトリを返します。

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_SetZ - 入力ジオメトリと同じX/y座標値と、指定されたリサンプリングアルゴリズムを使ってラスタから複写されたZ値とを持つジオメトリを返します。

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を変更します。

PostGISジオメトリ/ジオグラフィ/ラスタのダンプ関数

次に示す関数は、geometry_dumpまたはgeomvalデータ型の集合または単一データを入力または出力に取るPostGIS関数です。

ST_DumpAsPolygons - 指定されたラスタバンドからgeomval (geom,val)行の集合を返します。バンドを指定しない場合のデフォルトは1です。

ST_Intersection - 二つのラスタの共有部分またはベクタ化したラスタとジオメトリとのインタセクトした部分を表現する、ラスタまたはジオメトリとピクセル値の組の集合を返します。

ST_Dump - ジオメトリの要素となるgeometry_dump行の集合を返します。

ST_DumpPoints - ジオメトリ内の座標の行であるgeometry_dump行の集合を返します。

ST_DumpRings - ポリゴンのリングごとのgeometry_dump行の集合を返します。

ST_DumpSegments - ジオメトリ内の辺の行であるgeometry_dump行の集合を返します。

PostGISボックス関数

次に示す関数は、PostGIS空間型のbox系の型を入力または出力に取るPostGIS関数です。ボックス系にはbox2dとbox3dがあります。

Box2D - ジオメトリの2次元範囲を表現するBOX2Dを返します。

Box3D - ジオメトリの3次元範囲を表現するBOX3Dを返します。

Box3D - ラスタを囲むボックスのbox3d表現を返します。

ST_3DExtent - ジオメトリの3次元バウンディングボックスを返す集約関数です。

ST_3DMakeBox - 二つの3次元のポイントジオメトリで定義されるBOX3Dを生成します。

ST_AsMVTGeom - ジオメトリをMVTタイルの座標空間に変換します。

ST_AsTWKB - TWKB (Tiny Well-Known Binary)としてジオメトリを出力します。

ST_Box2dFromGeoHash - GeoHash文字列からBOX2Dを返します。

ST_ClipByBox2D - 長方形内に落ちるジオメトリの一部を返します。

ST_EstimatedExtent - 空間テーブルの推定範囲を返します。

ST_Expand - 他のバウンディングボックスまたはジオメトリから拡張されたバウンディングボックスを返します。

ST_Extent - ジオメトリのバウンディングボックスを返す集約関数です。

ST_MakeBox2D - 二つの2次元のポイントジオメトリで定義される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の最小値を返します。

RemoveUnusedPrimitives - 存在するTopoGeometryオブジェクトを定義するのに必要でないトポロジプリミティブを削除します。

ValidateTopology - トポロジの問題についての詳細を示すvalidatetopology_returntypeの集合を返します。

~(box2df,box2df) - 二つの単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)の一方がもう一方を包含する場合にTRUEを返します。

~(box2df,geometry) - 単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)をジオメトリの (キャッシュされている)2次元バウンディングボックスが包含する場合にTRUEを返します。

~(geometry,box2df) - ジオメトリの (キャッシュされている)2次元バウンディングボックスが単精度浮動小数点数によるn次元バウンディングボックス (GIDX)を包含する場合にTRUEを返します。

@(box2df,box2df) - 二つの単精度浮動小数点数によるn次元バウンディングボックス (GIDX)の一方がもう一方を包含する場合にTRUEを返します。

@(box2df,geometry) - 単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)がジオメトリの2次元バウンディングボックスに包含される場合にTRUEを返します。

@(geometry,box2df) - ジオメトリの2次元バウンディングボックスが単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)に包含される場合にTRUEを返します。

&&(box2df,box2df) - 二つの単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)が相互にインタセクトする場合にTRUEを返します。

&&(box2df,geometry) - 単精度浮動小数点数による2次元バウンディングボックスがジオメトリの (キャッシュされている)2次元バウンディングボックスとインタセクトする場合にTRUEを返します。

&&(geometry,box2df) - ジオメトリの (キャッシュされている)2次元バウンディングボックスが単精度浮動小数点数による2次元バウンディングボックスとインタセクトする場合にTRUEを返します。

3次元対応PostGIS関数

次に示す関数は、Zインデクスを放り出さないPostGIS関数です。

AddGeometryColumn - ジオメトリカラムを既存のテーブルに追加します。

Box3D - ジオメトリの3次元範囲を表現するBOX3Dを返します。

DropGeometryColumn - ジオメトリカラムを空間テーブルから除去します。

GeometryType - ジオメトリのタイプを文字列で返します。

ST_3DArea - 3次元の面ジオメトリの面積を計算します。立体の場合は0を返します。

ST_3DClosestPoint - g1上の、g2に最も近い3次元ポイントを返します。これは3次元の最短ラインの始点です。

ST_3DConvexHull - ジオメトリの3次元の凸包を計算します。

ST_3DDFullyWithin - 二つの3次元ジオメトリが完全に与えらえれた3次元距離内にあるかどうかをテストします。

ST_3DDWithin - 二つの3次元ジオメトリが与えらえれた3次元距離内にあるかどうかをテストします。

ST_3DDifference - 3次元の差分を計算します。

ST_3DDistance - 投影座標系の単位で、二つのジオメトリ間の3次元デカルト距離の最小値を返します (空間参照系に基づきます)。

ST_3DExtent - ジオメトリの3次元バウンディングボックスを返す集約関数です。

ST_3DIntersection - 3次元のインタセクトした (共有する)部分を計算します。

ST_3DIntersects - 二つのジオメトリが3次元空間において空間的にインタセクトするかどうかをテストします。ポイント、ラインストリング、ポリゴン、多面体サーフェス (面)についてのみ動作します。

ST_3DLength - 線ジオメトリの3次元長を返します。

ST_3DLineInterpolatePoint - 3次元ラインに沿って、割合で示された位置の補間ポイントを返します。

ST_3DLongestLine - 二つのジオメトリ間の3次元最長ラインを返します。

ST_3DMaxDistance - 二つのジオメトリ間の3次元最大デカルト距離 (空間参照系に基づく)を空間参照系の単位で返します。

ST_3DPerimeter - ポリゴンジオメトリの3次元周長を返します。

ST_3DShortestLine - 二つのジオメトリの3次元の最短ラインを返します。

ST_3DUnion - 3次元の結合を計算します。

ST_AddMeasure - ラインに沿ったM値を補間します。

ST_AddPoint - ラインストリングにポイントを追加します。

ST_Affine - ジオメトリに3次元アフィン変換を適用します。

ST_ApproximateMedialAxis - 面ジオメトリの近似的な中心軸を計算します。

ST_AsBinary - ジオメトリ/ジオグラフィの、SRIDメタデータを持たないOGC/ISO Well-Knownバイナリ (WKB)表現を返します。

ST_AsEWKB - ジオメトリの、SRIDメタデータを持つExtended Well-Knownバイナリ (EWKB)表現を返します。

ST_AsEWKT - ジオメトリのSRIDメタデータが付いたWell-Known Text (WKT)表現を返します。

ST_AsGML - GML第2版または第3版としてジオメトリを返します。

ST_AsGeoJSON - ジオメトリをGeoJSON要素として返します。

ST_AsHEXEWKB - ジオメトリのHEXEWKB表現を (文字列として)返します。リトルエンディアン (NDR)またはビッグエンディアン (XDR)のどちらかのエンコーディングを使います。

ST_AsKML - ジオメトリをKML要素として返します。

ST_AsX3D - ジオメトリをX3Dノード要素書式 (ISO-IEC-19776-1.2-X3DEncodings-XML)で返します。

ST_Boundary - ジオメトリの境界を返します。

ST_BoundingDiagonal - ジオメトリのバウンディングボックスの対角線を返します。

ST_CPAWithin - 二つのトラジェクトリの最接近時の距離が指定距離内であるかどうかをテストします。

ST_ChaikinSmoothing - チャイキンのアルゴリズムを使って、与えられたジオメトリの平滑化されたものを返します。

ST_ClosestPointOfApproach - 二つのトラジェクトリの最接近時の距離を返します。

ST_Collect - ジオメトリの集合からジオメトリコレクションまたはマルチ系ジオメトリを生成します。

ST_ConstrainedDelaunayTriangles - 入力ジオメトリの周りの制約付きドロネー三角形を返します。

ST_ConvexHull - ジオメトリの凸包を計算します。

ST_CoordDim - ジオメトリの座標次元を返します。

ST_CurveToLine - 曲線を含むジオメトリを線ジオメトリに変換します。

ST_DelaunayTriangles - ジオメトリの頂点のドローネ三角形を返します。

ST_Difference - ジオメトリBとインタセクトしていないジオメトリAの一部を表現するジオメトリを計算します。

ST_DistanceCPA - 二つのトラジェクトリの最接近する時の距離を返します。

ST_Dump - ジオメトリの要素となるgeometry_dump行の集合を返します。

ST_DumpPoints - ジオメトリ内の座標の行であるgeometry_dump行の集合を返します。

ST_DumpRings - ポリゴンのリングごとのgeometry_dump行の集合を返します。

ST_DumpSegments - ジオメトリ内の辺の行であるgeometry_dump行の集合を返します。

ST_EndPoint - LINESTRINGまたはCIRCULARLINESTRINGの終端のポイントを返します。

ST_ExteriorRing - ポリゴンの外環を表現するラインストリングを返します。

ST_Extrude - 関連するボリュームにサーフェスを押し出します。

ST_FlipCoordinates - X値とY値を入れ替えたジオメトリを返します。

ST_Force2D - ジオメトリを2次元モードに強制します。

ST_ForceCurve - 該当する場合は、ジオメトリを曲線タイプに変換します。

ST_ForceLHR - LHR (Left Hand Rule)方向に強制します。

ST_ForcePolygonCCW - 全ての外環を反時計回りに、全ての内環を時計回りに、それぞれ強制します。

ST_ForcePolygonCW - 全ての外環を時計回りに、全ての内環を反時計回りに、それぞれ強制します。

ST_ForceRHR - ポリゴンの頂点の方向を右回りに強制します。

ST_ForceSFS - SFS 1.1ジオメトリタイプのみ使うようジオメトリに強制します。

ST_Force_3D - ジオメトリをXYZモードに強制します。これはST_Force3DZの別名です。

ST_Force_3DZ - ジオメトリをXYZモードに強制します。

ST_Force_4D - ジオメトリをXYZMモードに強制します。

ST_Force_Collection - ジオメトリをジオメトリコレクションに変換します。

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 - マルチポイントの幾何学的中央値を返します。

ST_GeometryN - ジオメトリコレクションの要素を一つ返します。

ST_GeometryType - ジオメトリのSQL-MM型を文字列で返します。

ST_HasArc - ジオメトリに円弧が含まれているかどうかテストします。

ST_InteriorRingN - ポリゴンのN番目の内環 (穴)を返します。

ST_InterpolatePoint - ジオメトリのポイントに最も近いポイント上の補間M値を返します。

ST_Intersection - ジオメトリAとジオメトリBの共通部分を表現するジオメトリを返します。

ST_IsClosed - ラインストリングの始点と終点が一致しているかをテストします。多面体サーフェスについては閉じているか (立体であるか)をテストします。

ST_IsCollection - ジオメトリのタイプがジオメトリコレクションかをテストします。

ST_IsPlanar - サーフェスが平面であるかないかをチェックします。

ST_IsPolygonCCW - ポリゴンが反時計回りの外環を持っていて、時計回りの内環を持っているかをテストします。

ST_IsPolygonCW - ポリゴンが時計回りの外環を持っていて、反時計回りの内環を持っているかをテストします。

ST_IsSimple - ジオメトリが自己インタセクトまたは自己接触となるポイントが無いかをテストします。

ST_IsSolid - ジオメトリが立体であるかどうかをテストします。妥当性チェックは行いません。

ST_IsValidTrajectory - ジオメトリが妥当なトラジェクトリであるかどうかをテストします。

ST_Length_Spheroid - 回転楕円体面上の経度緯度のジオメトリの2次元または3次元の長さ/周長を返します。

ST_LineFromMultiPoint - マルチポイントジオメトリからラインストリングを生成します。

ST_LineInterpolatePoint - ラインに沿って、割合で示された位置の補間ポイントを返します。

ST_LineInterpolatePoints - ラインに沿って、割合で示された複数の位置の補間ポイントを返します。

ST_LineSubstring - 二つの割合位置からラインの一部を返します。

ST_LineToCurve - 曲線を含むジオメトリを線ジオメトリに変換します。

ST_LocateBetweenElevations - 標高 (Z値)範囲にある部分ジオメトリを返します。

ST_M - ポイントのM値を返します。

ST_MakeLine - POINT、MULTIPOINT、LINESTRINGからLINESTRINGを生成します。

ST_MakePoint - 2次元、3次元 (XYZ)、4次元のポイントを生成します。

ST_MakePolygon - 外殻と穴のリストからポリゴンを生成します。

ST_MakeSolid - ジオメトリを立体にキャストします。チェックはしません。妥当な立体を得るには、入力ジオメトリは閉じた多面体サーフェスか閉じたTINでなければなりません。

ST_MakeValid - 頂点を失うことなしに不正なジオメトリを妥当なジオメトリにしようと試みます。

ST_MemSize - ジオメトリが取るメモリ空間の合計を返します。

ST_MemUnion - ジオメトリを結合する集約関数で、メモリを効率的に使いますが処理時間のかかるものです。

ST_NDims - ST_Geometry値の座標次元を返します。

ST_NPoints - ジオメトリのポイント (頂点)の数を返します。

ST_NRings - ポリゴンジオメトリのリング数を返します。

ST_Node - ラインストリングの集合にノードを作成します。

ST_NumGeometries - ジオメトリコレクションの要素数を返します。

ST_NumPatches - 多面体サーフェスのフェイス数を返します。多面体でないジオメトリの場合にはNULLを返します。

ST_Orientation - サーフェスの方向を判定します。

ST_PatchN - 多面体サーフェスのN番目のジオメトリ (フェイス)を返します。

ST_PointFromWKB - WKBと与えられたSRIDからジオメトリを生成します。

ST_PointN - ジオメトリの最初のラインストリングまたは曲線ストリングのN番目のポイントを返します。

ST_PointOnSurface - ポリゴン内またはジオメトリ上にあるのが保証されたポイントを返します。

ST_Points - ジオメトリの全ての座標を含むマルチポイントを返します。

ST_Polygon - ラインストリングから指定したSRIDを持つポリゴンを生成します。

ST_RemovePoint - ラインストリングからポイントを削除します。

ST_RemoveRepeatedPoints - 重複ポイントを除いたジオメトリを返します。

ST_Reverse - 頂点の順序を逆にしたジオメトリを返します。

ST_Rotate - ジオメトリを原点について回転させます。

ST_RotateX - ジオメトリをX軸について回転させます。

ST_RotateY - ジオメトリをY軸について回転させます。

ST_RotateZ - ジオメトリをZ軸について回転させます。

ST_Scale - 与えた係数でジオメトリを拡大縮小します。

ST_Scroll - 閉じたLINESTRINGの開始点を変更する。

ST_SetPoint - ラインストリングのポイントを与えられたポイントに置き換えます。

ST_ShiftLongitude - 経度座標値を-180度から180度の範囲と0度から360度の範囲との二つの範囲を行き来するようシフトします。

ST_SnapToGrid - 入力ジオメトリの全ての点を規則的なグリッドにスナップします。

ST_StartPoint - ラインストリングの始点を返します。

ST_StraightSkeleton - ジオメトリからストレートスケルトンを計算します。

ST_SwapOrdinates - 与えられたジオメトリにおいて与えられた座標の値を入れ替えたジオメトリを返します。

ST_SymDifference - ジオメトリAとジオメトリBがインタセクトしていない部分を表現するジオメトリを返します。

ST_Tesselate - ポリゴンまたは多面体サーフェスのテッセレーションを計算し、TINまたはTINコレクションを返します。

ST_TransScale - 与えられた係数とオフセットでジオメトリを変換します。

ST_Translate - 与えられたオフセットでジオメトリを変換します。

ST_UnaryUnion - 単一のジオメトリの要素の結合を計算します。

ST_Union - 入力ジオメトリのポイント集合の結合を表現するジオメトリを返します。

ST_Volume - 3次元立体の体積を計算します。面ジオメトリは (閉じていても)0を返します。

ST_WrapX - ジオメトリをX値で回り込ませます。

ST_X - ポイントのX値を返します。

ST_XMax - 2次元または3次元のバウンディングボックスまたはジオメトリのXの最大値を返します。

ST_XMin - 2次元または3次元のバウンディングボックスまたはジオメトリのXの最小値を返します。

ST_Y - ポイントのY値を返します。

ST_YMax - 2次元または3次元のバウンディングボックスまたはジオメトリのYの最大値を返します。

ST_YMin - 2次元または3次元のバウンディングボックスまたはジオメトリのYの最小値を返します。

ST_Z - ポイントのZ値を返します。

ST_ZMax - 2次元または3次元のバウンディングボックスまたはジオメトリのZの最大値を返します。

ST_ZMin - 2次元または3次元のバウンディングボックスまたはジオメトリのZの最小値を返します。

ST_Zmflag - ジオメトリのZM座標次元を示す符号を返します。

TG_Equals - 二つのTopoGeometryが同じトポロジプリミティブで成っている場合にtrueを返します。

TG_Intersects - 二つのTopoGeometryからのプリミティブの組がインタセクトする場合にtrueを返します。

UpdateGeometrySRID - ジオメトリカラム内の全ての地物のSRIDを更新し、テーブルのメタデータを更新します。

geometry_overlaps_nd - Aのn次元バウンディングボックスがBのn次元バウンディングボックスとインタセクトする場合にTRUEを返します。

overlaps_nd_geometry_gidx - ジオメトリの (キャッシュされている)n次元バウンディングボックスが単精度浮動小数点数によるn次元バウンディングボックス (GIDX)とインタセクトする場合にTRUEを返します。

overlaps_nd_gidx_geometry - 単精度浮動小数点数によるn次元バウンディングボックス (GIDX)がジオメトリの (キャッシュされている)n次元バウンディングボックスとインタセクトする場合にTRUEを返します。

overlaps_nd_gidx_gidx - 二つの単精度浮動小数点数によるn次元バウンディングボックス (GIDX)が相互にインタセクトする場合にTRUEを返します。

postgis_sfcgal_full_version - CGALとBoostのバージョンを含む、使用しているSFCGALの完全なバージョンを返します

postgis_sfcgal_version - 使用しているSFCGALのバージョンを返します

PostGIS曲線ジオメトリ対応関数

次に示す関数は、CIRCULARSTRING, CURVEDPOLYGON等の曲線ジオメトリ型が使えるPostGIS関数です。

AddGeometryColumn - ジオメトリカラムを既存のテーブルに追加します。

Box2D - ジオメトリの2次元範囲を表現するBOX2Dを返します。

Box3D - ジオメトリの3次元範囲を表現するBOX3Dを返します。

DropGeometryColumn - ジオメトリカラムを空間テーブルから除去します。

GeometryType - ジオメトリのタイプを文字列で返します。

PostGIS_AddBBox - ジオメトリにバウンディングボックスを追加します。

PostGIS_DropBBox - ジオメトリからバウンディングボックスのキャッシュを削除します。

PostGIS_HasBBox - ジオメトリのバウンディングボックスがキャッシュされている場合にはTRUEを返し、他の場合にはFALSEを返します。

ST_3DExtent - ジオメトリの3次元バウンディングボックスを返す集約関数です。

ST_Affine - ジオメトリに3次元アフィン変換を適用します。

ST_AsBinary - ジオメトリ/ジオグラフィの、SRIDメタデータを持たないOGC/ISO Well-Knownバイナリ (WKB)表現を返します。

ST_AsEWKB - ジオメトリの、SRIDメタデータを持つExtended Well-Knownバイナリ (EWKB)表現を返します。

ST_AsEWKT - ジオメトリのSRIDメタデータが付いたWell-Known Text (WKT)表現を返します。

ST_AsHEXEWKB - ジオメトリのHEXEWKB表現を (文字列として)返します。リトルエンディアン (NDR)またはビッグエンディアン (XDR)のどちらかのエンコーディングを使います。

ST_AsSVG - ジオメトリからSVGパスデータを返します。

ST_AsText - ジオメトリ/ジオグラフィのSRIDメタデータのないWell-Known Text (WKT)表現を返します。

ST_ClusterDBSCAN - 入力ジオメトリごとにDBSCANアルゴリズムを使ってクラスタ番号を返すウィンドウ関数です。

ST_ClusterWithin - 空間的な距離によって入力ジオメトリのクラスタリングを行う集約関数です。

ST_ClusterWithinWin - 入力ジオメトリごとに分離距離を使ったクラスタリングを行い、クラスタIDを返すウィンドウ関数です。

ST_Collect - ジオメトリの集合からジオメトリコレクションまたはマルチ系ジオメトリを生成します。

ST_CoordDim - ジオメトリの座標次元を返します。

ST_CurveToLine - 曲線を含むジオメトリを線ジオメトリに変換します。

ST_Distance - 二つのジオメトリ値またはジオグラフィ値間の距離を返します。

ST_Dump - ジオメトリの要素となるgeometry_dump行の集合を返します。

ST_DumpPoints - ジオメトリ内の座標の行であるgeometry_dump行の集合を返します。

ST_EndPoint - LINESTRINGまたはCIRCULARLINESTRINGの終端のポイントを返します。

ST_EstimatedExtent - 空間テーブルの推定範囲を返します。

ST_FlipCoordinates - X値とY値を入れ替えたジオメトリを返します。

ST_Force2D - ジオメトリを2次元モードに強制します。

ST_ForceCurve - 該当する場合は、ジオメトリを曲線タイプに変換します。

ST_ForceSFS - SFS 1.1ジオメトリタイプのみ使うようジオメトリに強制します。

ST_Force3D - ジオメトリをXYZモードに強制します。これはST_Force3DZの別名です。

ST_Force3DM - ジオメトリをXYMモードに強制します。

ST_Force3DZ - ジオメトリをXYZモードに強制します。

ST_Force4D - ジオメトリをXYZMモードに強制します。

ST_ForceCollection - ジオメトリをジオメトリコレクションに変換します。

ST_GeoHash - ジオメトリのGeoHash表現を返します。

ST_GeogFromWKB - 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 - ジオメトリコレクションの要素を一つ返します。

= - ジオメトリ/ジオグラフィ Aの座標と座標の並び順がジオメトリ/ジオグラフィ Bと同じ場合にTRUEを返します。

&<| - AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの下にある場合にTRUEを返します。

ST_HasArc - ジオメトリに円弧が含まれているかどうかテストします。

ST_Intersects - 二つのジオメトリがインタセクトしている (少なくとも一つの共有点がある)かどうかテストします。

ST_IsClosed - ラインストリングの始点と終点が一致しているかをテストします。多面体サーフェスについては閉じているか (立体であるか)をテストします。

ST_IsCollection - ジオメトリのタイプがジオメトリコレクションかをテストします。

ST_IsEmpty - ジオメトリが空かをテストします。

ST_LineToCurve - 曲線を含むジオメトリを線ジオメトリに変換します。

ST_MemSize - ジオメトリが取るメモリ空間の合計を返します。

ST_NPoints - ジオメトリのポイント (頂点)の数を返します。

ST_NRings - ポリゴンジオメトリのリング数を返します。

ST_PointFromWKB - WKBと与えられたSRIDからジオメトリを生成します。

ST_PointN - ジオメトリの最初のラインストリングまたは曲線ストリングのN番目のポイントを返します。

ST_Points - ジオメトリの全ての座標を含むマルチポイントを返します。

ST_Rotate - ジオメトリを原点について回転させます。

ST_RotateZ - ジオメトリをZ軸について回転させます。

ST_SRID - ジオメトリの空間参照系識別子を返します。

ST_Scale - 与えた係数でジオメトリを拡大縮小します。

ST_SetSRID - ジオメトリにSRIDを設定します。

ST_StartPoint - ラインストリングの始点を返します。

ST_Summary - ジオメトリについての要約文を返します。

ST_SwapOrdinates - 与えられたジオメトリにおいて与えられた座標の値を入れ替えたジオメトリを返します。

ST_TransScale - 与えられた係数とオフセットでジオメトリを変換します。

ST_Transform - 異なる空間参照系に投影変換された新しいジオメトリを返します。

ST_Translate - 与えられたオフセットでジオメトリを変換します。

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座標次元を示す符号を返します。

UpdateGeometrySRID - ジオメトリカラム内の全ての地物のSRIDを更新し、テーブルのメタデータを更新します。

~(box2df,box2df) - 二つの単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)の一方がもう一方を包含する場合にTRUEを返します。

~(box2df,geometry) - 単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)をジオメトリの (キャッシュされている)2次元バウンディングボックスが包含する場合にTRUEを返します。

~(geometry,box2df) - ジオメトリの (キャッシュされている)2次元バウンディングボックスが単精度浮動小数点数によるn次元バウンディングボックス (GIDX)を包含する場合にTRUEを返します。

&& - Aの2次元バウンディングボックスがBの2次元バウンディングボックスとインタセクトする場合にTRUEを返します。

&&& - Aのn次元バウンディングボックスがBのn次元バウンディングボックスとインタセクトする場合にTRUEを返します。

@(box2df,box2df) - 二つの単精度浮動小数点数によるn次元バウンディングボックス (GIDX)の一方がもう一方を包含する場合にTRUEを返します。

@(box2df,geometry) - 単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)がジオメトリの2次元バウンディングボックスに包含される場合にTRUEを返します。

@(geometry,box2df) - ジオメトリの2次元バウンディングボックスが単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)に包含される場合にTRUEを返します。

&&(box2df,box2df) - 二つの単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)が相互にインタセクトする場合にTRUEを返します。

&&(box2df,geometry) - 単精度浮動小数点数による2次元バウンディングボックスがジオメトリの (キャッシュされている)2次元バウンディングボックスとインタセクトする場合にTRUEを返します。

&&(geometry,box2df) - ジオメトリの (キャッシュされている)2次元バウンディングボックスが単精度浮動小数点数による2次元バウンディングボックスとインタセクトする場合にTRUEを返します。

&&&(geometry,gidx) - ジオメトリの (キャッシュされている)n次元バウンディングボックスが単精度浮動小数点数によるn次元バウンディングボックス (GIDX)とインタセクトする場合にTRUEを返します。

&&&(gidx,geometry) - 単精度浮動小数点数によるn次元バウンディングボックス (GIDX)がジオメトリの (キャッシュされている)n次元バウンディングボックスとインタセクトする場合にTRUEを返します。

&&&(gidx,gidx) - 二つの単精度浮動小数点数によるn次元バウンディングボックス (GIDX)が相互にインタセクトする場合にTRUEを返します。

PostGIS多面体サーフェス対応関数

次に示す関数は、POLYHEDRALSURFACE, POLYHEDRALSURFACEMジオメトリが使えるPostGIS関数です。

AddGeometryColumn - ジオメトリカラムを既存のテーブルに追加します。

Box2D - ジオメトリの2次元範囲を表現するBOX2Dを返します。

Box3D - ジオメトリの3次元範囲を表現するBOX3Dを返します。

DropGeometryColumn - ジオメトリカラムを空間テーブルから除去します。

GeometryType - ジオメトリのタイプを文字列で返します。

PostGIS_AddBBox - ジオメトリにバウンディングボックスを追加します。

PostGIS_DropBBox - ジオメトリからバウンディングボックスのキャッシュを削除します。

PostGIS_HasBBox - ジオメトリのバウンディングボックスがキャッシュされている場合にはTRUEを返し、他の場合にはFALSEを返します。

ST_3DExtent - ジオメトリの3次元バウンディングボックスを返す集約関数です。

ST_Affine - ジオメトリに3次元アフィン変換を適用します。

ST_AsBinary - ジオメトリ/ジオグラフィの、SRIDメタデータを持たないOGC/ISO Well-Knownバイナリ (WKB)表現を返します。

ST_AsEWKB - ジオメトリの、SRIDメタデータを持つExtended Well-Knownバイナリ (EWKB)表現を返します。

ST_AsEWKT - ジオメトリのSRIDメタデータが付いたWell-Known Text (WKT)表現を返します。

ST_AsHEXEWKB - ジオメトリのHEXEWKB表現を (文字列として)返します。リトルエンディアン (NDR)またはビッグエンディアン (XDR)のどちらかのエンコーディングを使います。

ST_AsSVG - ジオメトリからSVGパスデータを返します。

ST_AsText - ジオメトリ/ジオグラフィのSRIDメタデータのないWell-Known Text (WKT)表現を返します。

ST_ClusterDBSCAN - 入力ジオメトリごとにDBSCANアルゴリズムを使ってクラスタ番号を返すウィンドウ関数です。

ST_ClusterWithin - 空間的な距離によって入力ジオメトリのクラスタリングを行う集約関数です。

ST_ClusterWithinWin - 入力ジオメトリごとに分離距離を使ったクラスタリングを行い、クラスタIDを返すウィンドウ関数です。

ST_Collect - ジオメトリの集合からジオメトリコレクションまたはマルチ系ジオメトリを生成します。

ST_CoordDim - ジオメトリの座標次元を返します。

ST_CurveToLine - 曲線を含むジオメトリを線ジオメトリに変換します。

ST_Distance - 二つのジオメトリ値またはジオグラフィ値間の距離を返します。

ST_Dump - ジオメトリの要素となるgeometry_dump行の集合を返します。

ST_DumpPoints - ジオメトリ内の座標の行であるgeometry_dump行の集合を返します。

ST_EndPoint - LINESTRINGまたはCIRCULARLINESTRINGの終端のポイントを返します。

ST_EstimatedExtent - 空間テーブルの推定範囲を返します。

ST_FlipCoordinates - X値とY値を入れ替えたジオメトリを返します。

ST_Force2D - ジオメトリを2次元モードに強制します。

ST_ForceCurve - 該当する場合は、ジオメトリを曲線タイプに変換します。

ST_ForceSFS - SFS 1.1ジオメトリタイプのみ使うようジオメトリに強制します。

ST_Force3D - ジオメトリをXYZモードに強制します。これはST_Force3DZの別名です。

ST_Force3DM - ジオメトリをXYMモードに強制します。

ST_Force3DZ - ジオメトリをXYZモードに強制します。

ST_Force4D - ジオメトリをXYZMモードに強制します。

ST_ForceCollection - ジオメトリをジオメトリコレクションに変換します。

ST_GeoHash - ジオメトリのGeoHash表現を返します。

ST_GeogFromWKB - 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 - ジオメトリコレクションの要素を一つ返します。

= - ジオメトリ/ジオグラフィ Aの座標と座標の並び順がジオメトリ/ジオグラフィ Bと同じ場合にTRUEを返します。

&<| - AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの下にある場合にTRUEを返します。

ST_HasArc - ジオメトリに円弧が含まれているかどうかテストします。

ST_Intersects - 二つのジオメトリがインタセクトしている (少なくとも一つの共有点がある)かどうかテストします。

ST_IsClosed - ラインストリングの始点と終点が一致しているかをテストします。多面体サーフェスについては閉じているか (立体であるか)をテストします。

ST_IsCollection - ジオメトリのタイプがジオメトリコレクションかをテストします。

ST_IsEmpty - ジオメトリが空かをテストします。

ST_LineToCurve - 曲線を含むジオメトリを線ジオメトリに変換します。

ST_MemSize - ジオメトリが取るメモリ空間の合計を返します。

ST_NPoints - ジオメトリのポイント (頂点)の数を返します。

ST_NRings - ポリゴンジオメトリのリング数を返します。

ST_PointFromWKB - WKBと与えられたSRIDからジオメトリを生成します。

ST_PointN - ジオメトリの最初のラインストリングまたは曲線ストリングのN番目のポイントを返します。

ST_Points - ジオメトリの全ての座標を含むマルチポイントを返します。

ST_Rotate - ジオメトリを原点について回転させます。

ST_RotateZ - ジオメトリをZ軸について回転させます。

ST_SRID - ジオメトリの空間参照系識別子を返します。

ST_Scale - 与えた係数でジオメトリを拡大縮小します。

ST_SetSRID - ジオメトリにSRIDを設定します。

ST_StartPoint - ラインストリングの始点を返します。

ST_Summary - ジオメトリについての要約文を返します。

ST_SwapOrdinates - 与えられたジオメトリにおいて与えられた座標の値を入れ替えたジオメトリを返します。

ST_TransScale - 与えられた係数とオフセットでジオメトリを変換します。

ST_Transform - 異なる空間参照系に投影変換された新しいジオメトリを返します。

ST_Translate - 与えられたオフセットでジオメトリを変換します。

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座標次元を示す符号を返します。

UpdateGeometrySRID - ジオメトリカラム内の全ての地物のSRIDを更新し、テーブルのメタデータを更新します。

~(box2df,box2df) - 二つの単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)の一方がもう一方を包含する場合にTRUEを返します。

~(box2df,geometry) - 単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)をジオメトリの (キャッシュされている)2次元バウンディングボックスが包含する場合にTRUEを返します。

~(geometry,box2df) - ジオメトリの (キャッシュされている)2次元バウンディングボックスが単精度浮動小数点数によるn次元バウンディングボックス (GIDX)を包含する場合にTRUEを返します。

&& - Aの2次元バウンディングボックスがBの2次元バウンディングボックスとインタセクトする場合にTRUEを返します。

&&& - Aのn次元バウンディングボックスがBのn次元バウンディングボックスとインタセクトする場合にTRUEを返します。

@(box2df,box2df) - 二つの単精度浮動小数点数によるn次元バウンディングボックス (GIDX)の一方がもう一方を包含する場合にTRUEを返します。

@(box2df,geometry) - 単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)がジオメトリの2次元バウンディングボックスに包含される場合にTRUEを返します。

@(geometry,box2df) - ジオメトリの2次元バウンディングボックスが単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)に包含される場合にTRUEを返します。

&&(box2df,box2df) - 二つの単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)が相互にインタセクトする場合にTRUEを返します。

&&(box2df,geometry) - 単精度浮動小数点数による2次元バウンディングボックスがジオメトリの (キャッシュされている)2次元バウンディングボックスとインタセクトする場合にTRUEを返します。

&&(geometry,box2df) - ジオメトリの (キャッシュされている)2次元バウンディングボックスが単精度浮動小数点数による2次元バウンディングボックスとインタセクトする場合にTRUEを返します。

&&&(geometry,gidx) - ジオメトリの (キャッシュされている)n次元バウンディングボックスが単精度浮動小数点数によるn次元バウンディングボックス (GIDX)とインタセクトする場合にTRUEを返します。

&&&(gidx,geometry) - 単精度浮動小数点数によるn次元バウンディングボックス (GIDX)がジオメトリの (キャッシュされている)n次元バウンディングボックスとインタセクトする場合にTRUEを返します。

&&&(gidx,gidx) - 二つの単精度浮動小数点数によるn次元バウンディングボックス (GIDX)が相互にインタセクトする場合にTRUEを返します。

PostGIS関数対応マトリクス

次に示す表は、アルファベット順に並べたPostGIS空間関数と、動作する空間タイプの種類、対応しようとしているOGC/SQL準拠を示しています。

PostGIS関数対応マトリクスは、ネイティブで、その型と派生型とに対応しています。

PostGIS関数対応マトリクスは、動作しますが、ジオメトリにキャストして「最善のSRID」に投影変換したうえでジオグラフィに戻す、組み込み変換キャストを使います。大きな面積の領域や、極にある領域については、予期しない結果になることがありますし、浮動小数点数のごみを蓄積することがあります。

PostGIS関数対応マトリクスは、直接的な対応でなくbox3dへの変換といった他からの自動キャストで動作します。

PostGIS関数対応マトリクスは、PostGISをSFCGAL対応でコンパイルした場合にのみ利用可能な関数です。

PostGIS関数対応マトリクスは、PostGISをSFCGAL対応でコンパイルした場合には、SFCGALが提供し、その他の場合には、GEOSまたは組み込み関数で対応します。

geom - 基本的な2次元ジオメトリ (x,y)に対応しています。

geog - 基本的な2次元ジオグラフィ (x,y)に対応しています。

2.5D - 3次元/4次元 (ZまたはM座標を持つ)空間内の基本的な2次元ジオメトリに対応しています。

PS - 多面体サーフェス (Polyhedral Surface)に対応しています

T - 三角形と不規則三角網 (TIN)に対応しています。

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

新規作成/機能強化/変更されたPostGIS関数

PostGIS 3.4 で新規作成/機能強化された関数

次に示す関数は、新規作成または機能強化されたPostGIS関数です。

PostGIS 3.4 で新規作成された関数

PostGIS_GEOS_Compiled_Version - Availability: 3.4.0 PostGISのビルドに使われたGEOSライブラリのバージョン番号を返します。

ST_ClusterIntersectingWin - Availability: 3.4.0 入力ジオメトリごとに接続された集合にクラスタリングを行い、クラスタIDを返すウィンドウ関数です。

ST_ClusterWithinWin - Availability: 3.4.0 入力ジオメトリごとに分離距離を使ったクラスタリングを行い、クラスタIDを返すウィンドウ関数です。

ST_CoverageInvalidEdges - Availability: 3.4.0 - GEOS 3.12.0以上が必要です ポリゴンが妥当なカバレッジの形成に失敗する位置を検索するウィンドウ関数。

ST_CoverageSimplify - Availability: 3.4.0 - GEOS 3.12.0以上が必要です ポリゴンカバレッジのエッジを単純化するウィンドウ関数。

ST_CoverageUnion - Availability: 3.4.0 - GEOS 3.8.0以上が必要です 共有しているエッジを除去することでカバレッジを形成するポリゴンの集合の結合を計算します。

ST_InverseTransformPipeline - Availability: 3.4.0 定義した座標変換パイプラインの逆変換を使って、異なる空間参照系に座標値を変換した新しいジオメトリを返します。

ST_LargestEmptyCircle - Availability: 3.4.0. ジオメトリとオーバラップ市内最大の円を計算します。

ST_LineExtend - Availability: 3.4.0 最後の辺と最初の辺を指定した距離だけ延長されたラインを返します。

ST_TransformPipeline - Availability: 3.4.0 定義されている座標変換パイプラインを使用して異なる空間参照系に変換された新しいジオメトリを返します。

postgis_srs - Availability: 3.4.0 求める機関と空間参照識別子に関するメタデータレコードを返します。

postgis_srs_all - Availability: 3.4.0 Projデータベース内のあらゆる空間参照系のメタデータレコードを返します。

postgis_srs_codes - Availability: 3.4.0 指定した機関に関連付けられたSRSコードの一覧を返します。

postgis_srs_search - Availability: 3.4.0 boundsパラメータを完全に含む適用範囲を持つ投影座標系のメタデータレコードを返します。

PostGIS 3.4 で機能強化された関数

PostGIS_Full_Version - Enhanced: 3.4.0 現在、外部PROJ設定のNETWORK_ENABLED、URL_ENDPOINT、proj.db位置のDATABASE_PATHがあります 完全なPostGISのバージョン情報とコンフィギュレーション情報を報告します。

PostGIS_PROJ_Version - Enhanced: 3.4.0 現在、NETWORK_ENABLED、URL_ENDPOINT、proj.db位置のDATABASE_PATHがあります PROJ4のバージョン番号を返します。

ST_AsSVG - Enhanced: 3.4.0 全ての曲線タイプに対応しました ジオメトリからSVGパスデータを返します。

ST_Project - Enhanced: 3.4.0 ジオメトリ引数と、azimuthを省略した2ポイント形式を許します。 始点から距離と方位で算出されたポイントを返します。

PostGIS 3.4 で変更された関数

PostGIS_Extensions_Upgrade - Changed: 3.4.0 target_version引数が追加されました。 PostGISエクステンション (例: postgis_raster, postgis_topology, postgis_sfcgal)について、指定したバージョンまたは最新版にパッケージ化し、アップグレードします。

PostGIS 3.3 で新規作成/機能強化された関数

次に示す関数は、新規作成または機能強化されたPostGIS関数です。

PostGIS 3.3 で新規作成された関数

ST_3DConvexHull - Availability: 3.3.0 ジオメトリの3次元の凸包を計算します。

ST_3DUnion - Availability: 3.3.0 集約関数の形式が追加されました 3次元の結合を計算します。

ST_AlphaShape - Availability: 3.3.0 - SFCGAL >= 1.4.1 が必要です。 ジオメトリを囲むアルファシェイプを計算します。

ST_AsMARC21 - Availability: 3.3.0 ジオメトリを、地理データフィールド (034)を持つMARC21/XMLデータとして返します。

ST_GeomFromMARC21 - Availability: 3.3.0 libxml2 2.6以上が必要です。 MARC21/XML地理データを入力に取り、PostGISジオメトリオブジェクトを返します。

ST_Letters - Availability: 3.3.0 デフォルトの開始位置を原点とし、デフォルトの高さを100とする、ジオメトリとして描画された文字を返します。

ST_OptimalAlphaShape - Availability: 3.3.0 - SFCGAL >= 1.4.1 が必要です。 「最適」アルファ値を使ってジオメトリを囲むアルファシェイプを計算します。

ST_SimplifyPolygonHull - Availability: 3.3.0. ポリゴンジオメトリに対してトポロジを保存した状態で簡略化した外側または内側の凹包を計算します。

ST_TriangulatePolygon - Availability: 3.3.0. ポリゴンの制約付きドロネー三角分割を計算します。

postgis_sfcgal_full_version - Availability: 3.3.0 CGALとBoostのバージョンを含む、使用しているSFCGALの完全なバージョンを返します

PostGIS 3.3 で機能強化された関数

ST_ConcaveHull - Enhanced: 3.3.0, GEOS 3.11からGEOSネイティブ実装が有効になりました 全ての入力ジオメトリの頂点を含む凹ジオメトリを計算します。

ST_LineMerge - Enhanced: 3.3.0 accept a directed parameter. MULTILINESTRINGを縫い合わせて形成したラインを返します。

PostGIS 3.3 で変更された関数

PostGIS_Extensions_Upgrade - Changed: 3.3.0 どのPostGISのバージョンからでもアップグレードできるようになりました。ただし全てのシステムで動作するわけではありません。 PostGISエクステンション (例: postgis_raster, postgis_topology, postgis_sfcgal)について、指定したバージョンまたは最新版にパッケージ化し、アップグレードします。

PostGIS 3.2 で新規作成/機能強化された関数

次に示す関数は、新規作成または機能強化されたPostGIS関数です。

PostGIS 3.2 で新規作成された関数

ST_AsFlatGeobuf - Availability: 3.2.0 行の集合のFlatGeobuf表現を返します。

ST_DumpSegments - Availability: 3.2.0 ジオメトリ内の辺の行であるgeometry_dump行の集合を返します。

ST_FromFlatGeobuf - Availability: 3.2.0 FlatGeobufデータを読みます。

ST_FromFlatGeobufToTable - Availability: 3.2.0 FlatGeobufデータの構造に基づいてテーブルを生成します。

ST_Scroll - Availability: 3.2.0 閉じたLINESTRINGの開始点を変更する。

postgis.gdal_config_options - Availability: 3.2.0 データベース外ラスタを操作する時に使用するオプションを設定するためのコンフィギュレーション。

PostGIS 3.2 で機能強化された関数

ST_ClusterKMeans - Enhanced: 3.2.0 max_radiusパラメータに対応しました 入力ジオメトリごとにk平均法アルゴリズムを使ってクラスタ番号を返すウィンドウ関数です。

ST_MakeValid - Enhanced: 3.2.0, アルゴリズムに関する任意パラメータ'linework'と'structure'が追加されました。GEOS 3.10.0以上が必要です。 頂点を失うことなしに不正なジオメトリを妥当なジオメトリにしようと試みます。

ST_Point - Enhanced: 3.2.0 SRID任意引数が追加されました。古いバージョンでは、ジオメトリにSRIDを与えるにはST_SetSRIDを併用しなければなりませんでした。 X, YとSRIDの値からポイントを生成します。

ST_PointM - Enhanced: 3.2.0 SRID任意引数が追加されました。古いバージョンでは、ジオメトリにSRIDを与えるにはST_SetSRIDを併用しなければなりませんでした。 X, Y, MとSRIDの値からポイントを生成します。

ST_PointZ - Enhanced: 3.2.0 SRID任意引数が追加されました。古いバージョンでは、ジオメトリにSRIDを与えるにはST_SetSRIDを併用しなければなりませんでした。 X, Y, ZとSRIDの値からポイントを生成します。

ST_PointZM - Enhanced: 3.2.0 SRID任意引数が追加されました。古いバージョンでは、ジオメトリにSRIDを与えるにはST_SetSRIDを併用しなければなりませんでした。 X, Y, Z, MとSRIDの値からポイントを生成します。

ST_RemovePoint - Enhanced: 3.2.0 ラインストリングからポイントを削除します。

ST_RemoveRepeatedPoints - Enhanced: 3.2.0 重複ポイントを除いたジオメトリを返します。

ST_StartPoint - Enhanced: 3.2.0 全てのジオメトリのポイントを返すようになりました。以前のバージョンではラインストリング以外ではNULLを返していました。 ラインストリングの始点を返します。

PostGIS 3.2 で変更された関数

ST_Boundary - Changed: 3.2.0 TINに対応しました。GEOSを使いません。曲線を線形化しません。 ジオメトリの境界を返します。

PostGIS 3.1 で新規作成/機能強化された関数

次に示す関数は、新規作成または機能強化されたPostGIS関数です。

PostGIS 3.1 で新規作成された関数

ST_Hexagon - Availability: 3.1.0 与えられたエッジサイズと六角形グリッド空間内のセル座標を使って単一の六角形を返します。

ST_HexagonGrid - Availability: 3.1.0 引数ジオメトリの境界を完全にカバーする六角形とセルインデックスを返します。

ST_MaximumInscribedCircle - Availability: 3.1.0. ジオメトリに含まれる最大の円を計算します。

ST_ReducePrecision - Availability: 3.1.0. 全ての与えられたグリッド許容値に丸められたポイントからなる妥当なジオメトリを返します。

ST_Square - Availability: 3.1.0 与えられたエッジサイズと六角形グリッド空間内のセル座標を使って単一の正方形を返します。

ST_SquareGrid - Availability: 3.1.0 引数ジオメトリの境界を完全にカバーするグリッド正方形とセルインデックスを返します。

PostGIS 3.1 で機能強化された関数

ST_AsEWKT - Enhanced: 3.1.0 精度パラメータ (任意)に対応しました。 ジオメトリのSRIDメタデータが付いたWell-Known Text (WKT)表現を返します。

ST_ClusterKMeans - Enhanced: 3.1.0 3次元ジオメトリと重みに対応するようになりました 入力ジオメトリごとにk平均法アルゴリズムを使ってクラスタ番号を返すウィンドウ関数です。

ST_Difference - Enhanced: 3.1.0 accept a gridSize parameter. ジオメトリBとインタセクトしていないジオメトリAの一部を表現するジオメトリを計算します。

ST_Intersection - Enhanced: 3.1.0 accept a gridSize parameter ジオメトリAとジオメトリBの共通部分を表現するジオメトリを返します。

ST_MakeValid - Enhanced: 3.1.0 NaN値を持つ座標の削除が追加されました。 頂点を失うことなしに不正なジオメトリを妥当なジオメトリにしようと試みます。

ST_Subdivide - Enhanced: 3.1.0 accept a gridSize parameter. ジオメトリの線の分割を計算します。

ST_SymDifference - Enhanced: 3.1.0 accept a gridSize parameter. ジオメトリAとジオメトリBがインタセクトしていない部分を表現するジオメトリを返します。

ST_TileEnvelope - Enhanced: 3.1.0 marginパラメータが追加されました。 Webメルカトル (SRID:3857)上で XYZタイルを使った矩形ポリゴンを生成します。

ST_UnaryUnion - Enhanced: 3.1.0 accept a gridSize parameter. 単一のジオメトリの要素の結合を計算します。

ST_Union - Enhanced: 3.1.0 accept a gridSize parameter. 入力ジオメトリのポイント集合の結合を表現するジオメトリを返します。

PostGIS 3.1 で変更された関数

ST_Force3D - Changed: 3.1.0. 0でないZ値を指定できるようになりました。 ジオメトリをXYZモードに強制します。これはST_Force3DZの別名です。

ST_Force3DM - Changed: 3.1.0. 0でないM値を指定できるようになりました。 ジオメトリをXYMモードに強制します。

ST_Force3DZ - Changed: 3.1.0. 0でないZ値を指定できるようになりました。 ジオメトリをXYZモードに強制します。

ST_Force4D - Changed: 3.1.0. 0でないZ値とM値を指定できるようになりました。 ジオメトリをXYZMモードに強制します。

PostGIS 3.0 で新規作成/機能強化された関数

次に示す関数は、新規作成または機能強化されたPostGIS関数です。

PostGIS 3.0 で新規作成された関数

ST_3DLineInterpolatePoint - Availability: 3.0.0 3次元ラインに沿って、割合で示された位置の補間ポイントを返します。

ST_ConstrainedDelaunayTriangles - Availability: 3.0.0 入力ジオメトリの周りの制約付きドロネー三角形を返します。

ST_TileEnvelope - Availability: 3.0.0 Webメルカトル (SRID:3857)上で XYZタイルを使った矩形ポリゴンを生成します。

PostGIS 3.0 で機能強化された関数

ST_AsMVT - Enhanced: 3.0 - 地物IDへの対応を追加。 行集合のMVT表現を返す集約関数です。

ST_Contains - Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりました Bの全てのポイントがA内にあり、かつ、双方の内部に共有点が存在するかどうかをテストします。

ST_ContainsProperly - Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりました Bの全てのポイントがAの内部にあるかをテストします。

ST_CoveredBy - Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりました Aの全てのポイントがB内にあるかをテストします。

ST_Covers - Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりました Bの全ての点がA内にあるかをテストします。

ST_Crosses - Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりました 二つのジオメトリが内部に共有ポイントを持ち、かつそれだけにならないようになっているかテストします。

ST_CurveToLine - Enhanced: 3.0.0 線形化した弧ごとの最小線分数を実装しました。トポロジ的な崩壊を防ぐためです。 曲線を含むジオメトリを線ジオメトリに変換します。

ST_Disjoint - Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりました 二つのジオメトリが共有点を持たないようになっているかテストします。

ST_Equals - Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりました 二つのジオメトリが同じ点集合になっているかテストします。

ST_GeneratePoints - Enhanced: 3.0.0 seedパラメータの追加 ポリゴン内やマルチポリゴン内にランダムなポイントを生成します。

ST_GeomFromGeoJSON - Enhanced: 3.0.0 パースされたジオメトリのデフォルトのSRIDは、他に指定していない場合には4326となります。 ジオメトリのGeoJSON表現を入力として、PostGISジオメトリオブジェクトを出力します。

ST_LocateBetween - Enhanced: 3.0.0 - POLYGON, TIN, TRIANGLEへの対応が追加されました。 M値の範囲に合致する部分ジオメトリを返します。

ST_LocateBetweenElevations - Enhanced: 3.0.0 - POLYGON, TIN, TRIANGLEへの対応が追加されました。 標高 (Z値)範囲にある部分ジオメトリを返します。

ST_Overlaps - Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりました 二つのジオメトリが同じ次元を持ち、インタセクトして、かつ相手と重ならない点少なくとも一つあるかをテストします。

ST_Relate - Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりました 二つのジオメトリが与えられた交差行列パターンに合致するトポロジ関係があるかどうかを見るか、交差行列を計算するかします。

ST_Segmentize - Enhanced: 3.0.0 ジオメトリの分割において、現在は、同じ長さに分割しています 与えた長さを超える線分を持たないよう変更したジオメトリ/ジオグラフィを返します。

ST_Touches - Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりました 二つのジオメトリが少なくとも一つの共有点を持ち、かつ内部でインタセクトしていないようになっているかテストします。

ST_Within - Enhanced: 3.0.0 GEOMETRYCOLLECTIONへの対応が可能となりました Aの全てのポイントがB内にあり、かつ両方の内部が共有点を持つかどうかをテストします。

PostGIS 3.0 で変更された関数

PostGIS_Extensions_Upgrade - Changed: 3.0.0 緩いエクステンションを再パッケージし、また、postgis_rasterに対応しました。 PostGISエクステンション (例: postgis_raster, postgis_topology, postgis_sfcgal)について、指定したバージョンまたは最新版にパッケージ化し、アップグレードします。

ST_3DDistance - Changed: 3.0.0 - SFCGAL版は削除されました 投影座標系の単位で、二つのジオメトリ間の3次元デカルト距離の最小値を返します (空間参照系に基づきます)。

ST_3DIntersects - Changed: 3.0.0 SFCGALバックエンドが削除され、GEOSバックエンドではTINに対応しました。 二つのジオメトリが3次元空間において空間的にインタセクトするかどうかをテストします。ポイント、ラインストリング、ポリゴン、多面体サーフェス (面)についてのみ動作します。

ST_Area - Changed: 3.0.0 - SFCGALに依存しなくなりました。 ポリゴンジオメトリの面積を返します。

ST_AsGeoJSON - Changed: 3.0.0 レコードの入力に対応しました ジオメトリをGeoJSON要素として返します。

ST_AsGeoJSON - Changed: 3.0.0 EPSG:4326以外の場合のSRID出力。 ジオメトリをGeoJSON要素として返します。

ST_AsKML - Changed: 3.0.0 - "version"の付いた形式の削除 ジオメトリをKML要素として返します。

ST_Distance - Changed: 3.0.0 - SFCGALに依存しなくなりました。 二つのジオメトリ値またはジオグラフィ値間の距離を返します。

ST_Intersection - Changed: 3.0.0 SFCGAL非依存になりました。 ジオメトリAとジオメトリBの共通部分を表現するジオメトリを返します。

ST_Intersects - Changed: 3.0.0 SFCGAL版を削除し、2次元TINのネイティブ対応を追加しました。 二つのジオメトリがインタセクトしている (少なくとも一つの共有点がある)かどうかテストします。

ST_Union - Changed: 3.0.0 SFCGAL非依存になりました。 入力ジオメトリのポイント集合の結合を表現するジオメトリを返します。

PostGIS 2.5 で新規作成/機能強化された関数

次に示す関数は、新規作成または機能強化されたPostGIS関数です。

PostGIS 2.5 で新規作成された関数

PostGIS_Extensions_Upgrade - Availability: 2.5.0 PostGISエクステンション (例: postgis_raster, postgis_topology, postgis_sfcgal)について、指定したバージョンまたは最新版にパッケージ化し、アップグレードします。

ST_Angle - Availability: 2.5.0 3点もしくは4点、または2線で定義される二つのベクタ間の角度を返します。

ST_ChaikinSmoothing - Availability: 2.5.0 チャイキンのアルゴリズムを使って、与えられたジオメトリの平滑化されたものを返します。

ST_FilterByM - Availability: 2.5.0 M値に基づいて頂点を削除します。

ST_LineInterpolatePoints - Availability: 2.5.0 ラインに沿って、割合で示された複数の位置の補間ポイントを返します。

ST_OrientedEnvelope - Availability: 2.5.0. ジオメトリを囲む最小の回転四角形を返します。

ST_QuantizeCoordinates - Availability: 2.5.0 座標値の最下位ビットを0にします。

PostGIS 2.5 で機能強化された関数

ST_AsMVT - Enhanced: 2.5.0 - パラレルクエリへの対応の追加。 行集合のMVT表現を返す集約関数です。

ST_AsText - Enhanced: 2.5 - 精度の任意引数が導入されました。 ジオメトリ/ジオグラフィのSRIDメタデータのないWell-Known Text (WKT)表現を返します。

ST_Buffer - Enhanced: 2.5.0 - ST_Bufferのジオメトリ対応版が強化され、バッファを施す側をside=both|left|rightで指定できるようになりました。 あるジオメトリからの距離が指定された距離以下となる点全ての集合となるジオメトリを返します。

ST_GeomFromGeoJSON - Enhanced: 2.5.0 JSONとJSONBの入力を受け付けるようになりました。 ジオメトリのGeoJSON表現を入力として、PostGISジオメトリオブジェクトを出力します。

ST_GeometricMedian - Enhanced: 2.5.0 ポイントの重みとしてのM値の対応が追加されました。 マルチポイントの幾何学的中央値を返します。

ST_Intersects - Enhanced: 2.5.0 ジオメトリコレクションに対応しました。 二つのジオメトリがインタセクトしている (少なくとも一つの共有点がある)かどうかテストします。

ST_OffsetCurve - Enhanced: 2.5 - GEOMETRYCOLLECTIONとULTILINESTRINGへの対応追加 与えられた距離と方面に入力ラインをずらしたラインを返します。

ST_Scale - Enhanced: 2.5.0 局所原点 (originパラメータ)を使った拡大縮小への対応を導入しました。 与えた係数でジオメトリを拡大縮小します。

ST_Split - Enhanced: 2.5.0 マルチラインによるポリゴンの分割に対応するようになりました。 ジオメトリを他のジオメトリで分割してできたジオメトリのコレクションを返します。

ST_Subdivide - Enhanced: 2.5.0 ポリゴン分割で存在するポイントを再利用して頂点数の最小値を8から5に変更。 ジオメトリの線の分割を計算します。

PostGIS 2.4 で新規作成/機能強化された関数

次に示す関数は、新規作成または機能強化されたPostGIS関数です。

PostGIS 2.4 で新規作成された関数

ST_AsGeobuf - Availability: 2.4.0 行集合のGeobuf表現を返します。

ST_AsMVT - Availability: 2.4.0 行集合のMVT表現を返す集約関数です。

ST_AsMVTGeom - Availability: 2.4.0 ジオメトリをMVTタイルの座標空間に変換します。

ST_Centroid - Availability: 2.4.0 ジオグラフィが導入されました。 ジオメトリの幾何学的重心を返します。

ST_ForcePolygonCCW - Availability: 2.4.0 全ての外環を反時計回りに、全ての内環を時計回りに、それぞれ強制します。

ST_ForcePolygonCW - Availability: 2.4.0 全ての外環を時計回りに、全ての内環を反時計回りに、それぞれ強制します。

ST_FrechetDistance - Availability: 2.4.0 - GEOS 3.7.0以上が必要です。 二つのジオメトリのフレシェ距離を返します。

ST_IsPolygonCCW - Availability: 2.4.0 ポリゴンが反時計回りの外環を持っていて、時計回りの内環を持っているかをテストします。

ST_IsPolygonCW - Availability: 2.4.0 ポリゴンが時計回りの外環を持っていて、反時計回りの内環を持っているかをテストします。

PostGIS 2.4 で機能強化された関数

ST_AsTWKB - Enhanced: 2.4.0 メモリと速度の改善。 TWKB (Tiny Well-Known Binary)としてジオメトリを出力します。

ST_Covers - Enhanced: 2.4.0 ジオグラフィ型を使う形式においてポリゴンの中のポリゴンとポリゴンの中のラインストリングへの対応を追加 Bの全ての点がA内にあるかをテストします。

ST_CurveToLine - Enhanced: 2.4.0 最大距離差による許容範囲と最大角度による許容範囲に対応し、対称出力に対応しました。 曲線を含むジオメトリを線ジオメトリに変換します。

ST_Project - Enhanced: 2.4.0 負の距離と非正規化方位を許容するようになりました。 始点から距離と方位で算出されたポイントを返します。

ST_Reverse - Enhanced: 2.4.0 曲線対応が導入されました。 頂点の順序を逆にしたジオメトリを返します。

PostGIS 2.4 で変更された関数

= - Changed: 2.4.0, 以前の版では、ジオメトリ自体の等価性でなくバウンディングボックスが等価かどうかを見ていました。バウンディングボックスが等価かどうかを知る必要がある場合には、替わりにを使います。 ジオメトリ/ジオグラフィ Aの座標と座標の並び順がジオメトリ/ジオグラフィ Bと同じ場合にTRUEを返します。

ST_Node - Changed: 2.4.0 この関数は内部でGEOSUnaryUnionの替わりにGEOSNodeを使用しています。ラインストリングの並び順と方向がPostGIS 2.4より前のものと違うことになるかも知れません。 ラインストリングの集合にノードを作成します。

PostGIS 2.3 で新規作成/機能強化された関数

次に示す関数は、新規作成または機能強化されたPostGIS関数です。

PostGIS 2.3 で新規作成された関数

&&&(geometry,gidx) - Availability: 2.3.0 BRIN (Block Range INdexes)が導入されました。PostgreSQL 9.5以上が必要です。 ジオメトリの (キャッシュされている)n次元バウンディングボックスが単精度浮動小数点数によるn次元バウンディングボックス (GIDX)とインタセクトする場合にTRUEを返します。

&&&(gidx,geometry) - Availability: 2.3.0 BRIN (Block Range INdexes)が導入されました。PostgreSQL 9.5以上が必要です。 単精度浮動小数点数によるn次元バウンディングボックス (GIDX)がジオメトリの (キャッシュされている)n次元バウンディングボックスとインタセクトする場合にTRUEを返します。

&&&(gidx,gidx) - Availability: 2.3.0 BRIN (Block Range INdexes)が導入されました。PostgreSQL 9.5以上が必要です。 二つの単精度浮動小数点数によるn次元バウンディングボックス (GIDX)が相互にインタセクトする場合にTRUEを返します。

&&(box2df,box2df) - Availability: 2.3.0 BRIN (Block Range INdexes)が導入されました。PostgreSQL 9.5以上が必要です。 二つの単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)が相互にインタセクトする場合にTRUEを返します。

&&(box2df,geometry) - Availability: 2.3.0 BRIN (Block Range INdexes)が導入されました。PostgreSQL 9.5以上が必要です。 単精度浮動小数点数による2次元バウンディングボックスがジオメトリの (キャッシュされている)2次元バウンディングボックスとインタセクトする場合にTRUEを返します。

&&(geometry,box2df) - Availability: 2.3.0 BRIN (Block Range INdexes)が導入されました。PostgreSQL 9.5以上が必要です。 ジオメトリの (キャッシュされている)2次元バウンディングボックスが単精度浮動小数点数による2次元バウンディングボックスとインタセクトする場合にTRUEを返します。

@(box2df,box2df) - Availability: 2.3.0 BRIN (Block Range INdexes)が導入されました。PostgreSQL 9.5以上が必要です。 二つの単精度浮動小数点数によるn次元バウンディングボックス (GIDX)の一方がもう一方を包含する場合にTRUEを返します。

@(box2df,geometry) - Availability: 2.3.0 BRIN (Block Range INdexes)が導入されました。PostgreSQL 9.5以上が必要です。 単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)がジオメトリの2次元バウンディングボックスに包含される場合にTRUEを返します。

@(geometry,box2df) - Availability: 2.3.0 BRIN (Block Range INdexes)が導入されました。PostgreSQL 9.5以上が必要です。 ジオメトリの2次元バウンディングボックスが単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)に包含される場合にTRUEを返します。

ST_ClusterDBSCAN - Availability: 2.3.0 入力ジオメトリごとにDBSCANアルゴリズムを使ってクラスタ番号を返すウィンドウ関数です。

ST_ClusterKMeans - Availability: 2.3.0 入力ジオメトリごとにk平均法アルゴリズムを使ってクラスタ番号を返すウィンドウ関数です。

ST_GeneratePoints - Availability: 2.3.0 ポリゴン内やマルチポリゴン内にランダムなポイントを生成します。

ST_GeometricMedian - Availability: 2.3.0 マルチポイントの幾何学的中央値を返します。

ST_MakeLine - Availability: 2.3.0 - MULTIPOINT入力要素への対応が導入されました POINT、MULTIPOINT、LINESTRINGからLINESTRINGを生成します。

ST_MinimumBoundingRadius - Availability: 2.3.0 ジオメトリを完全に包含する最小円の中心ポイントと半径を返します。

ST_MinimumClearance - Availability: 2.3.0 ジオメトリのクリアランスの最小値を返します。この値はジオメトリのロバスト性を示すものです。

ST_MinimumClearanceLine - Availability: 2.3.0 - GEOS 3.6.0以上が必要です。 ジオメトリの最小クリアランスを示す、2点のラインストリングを返します。

ST_Normalize - Availability: 2.3.0 標準的な形式に変えたジオメトリを返します。

ST_Points - Availability: 2.3.0 ジオメトリの全ての座標を含むマルチポイントを返します。

ST_VoronoiLines - Availability: 2.3.0 ジオメトリの頂点からボロノイ図のセルを返します。

ST_VoronoiPolygons - Availability: 2.3.0 ジオメトリの頂点からボロノイ図のセルを返します。

ST_WrapX - Availability: 2.3.0 GEOSが必要です。 ジオメトリをX値で回り込ませます。

~(box2df,box2df) - Availability: 2.3.0 BRIN (Block Range INdexes)が導入されました。PostgreSQL 9.5以上が必要です。 二つの単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)の一方がもう一方を包含する場合にTRUEを返します。

~(box2df,geometry) - Availability: 2.3.0 BRIN (Block Range INdexes)が導入されました。PostgreSQL 9.5以上が必要です。 単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)をジオメトリの (キャッシュされている)2次元バウンディングボックスが包含する場合にTRUEを返します。

~(geometry,box2df) - Availability: 2.3.0 BRIN (Block Range INdexes)が導入されました。PostgreSQL 9.5以上が必要です。 ジオメトリの (キャッシュされている)2次元バウンディングボックスが単精度浮動小数点数によるn次元バウンディングボックス (GIDX)を包含する場合にTRUEを返します。

PostGIS 2.3 で機能強化された関数

ST_Contains - Enhanced: 2.3.0 PIP short-circuit (ポリゴンとポイントに限定した高速判定)を少ないポイントからなるマルチポイントに対応することができるよう拡張しました。以前の版ではポリゴンとポイントの組み合わせにだけ対応していました。 Bの全てのポイントがA内にあり、かつ、双方の内部に共有点が存在するかどうかをテストします。

ST_Covers - Enhanced: 2.3.0 ジオメトリについて、PIP short-circuit (ポリゴンとポイントに限定した高速判定)を少ないポイントからなるマルチポイントに対応することができるよう拡張しました。以前の版ではポリゴンとポイントの組み合わせにだけ対応していました。 Bの全ての点がA内にあるかをテストします。

ST_Expand - Enhanced: 2.3.0 異なる次元の異なる量によるボックスの拡張に対応するようになりました。 他のバウンディングボックスまたはジオメトリから拡張されたバウンディングボックスを返します。

ST_Intersects - Enhanced: 2.3.0 PIP short-circuit (ポリゴンとポイントに限定した高速判定)を少ないポイントからなるマルチポイントに対応することができるよう拡張しました。以前の版ではポリゴンとポイントの組み合わせにだけ対応していました。 二つのジオメトリがインタセクトしている (少なくとも一つの共有点がある)かどうかテストします。

ST_Segmentize - Enhanced: 2.3.0 ジオグラフィの分割において、現在は、同じ長さに分割しています 与えた長さを超える線分を持たないよう変更したジオメトリ/ジオグラフィを返します。

ST_Transform - Enhanced: 2.3.0 直接のPROJ.4文字列への対応が導入されました。 異なる空間参照系に投影変換された新しいジオメトリを返します。

ST_Within - Enhanced: 2.3.0 ジオメトリについて、PIP short-circuit (ポリゴンとポイントに限定した高速判定)を少ないポイントからなるマルチポイントに対応することができるよう拡張しました。以前の版ではポリゴンとポイントの組み合わせにだけ対応していました。 Aの全てのポイントがB内にあり、かつ両方の内部が共有点を持つかどうかをテストします。

PostGIS 2.3 で変更された関数

ST_PointN - Changed: 2.3.0 : 負数インデックスが有効になりました (-1は終端を指します) ジオメトリの最初のラインストリングまたは曲線ストリングのN番目のポイントを返します。

PostGIS 2.2 で新規作成/機能強化された関数

次に示す関数は、新規作成または機能強化されたPostGIS関数です。

PostGIS 2.2 で新規作成された関数

<<#>> - Availability: 2.0.0 KNNはPostgreSQL 9.1以上でのみ有効です。 AのバウンディングボックスとBのバウンディングボックスのn次元距離を返します。

<<->> - Availability: 2.0.0 KNNはPostgreSQL 9.1以上でのみ有効です。 AのバウンディングボックスとBのバウンディングボックスのn次元距離を返します。

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_CPAWithin - Availability: 2.2.0 二つのトラジェクトリの最接近時の距離が指定距離内であるかどうかをテストします。

ST_ClipByBox2D - Availability: 2.2.0 長方形内に落ちるジオメトリの一部を返します。

ST_ClosestPointOfApproach - Availability: 2.2.0 二つのトラジェクトリの最接近時の距離を返します。

ST_ClusterIntersecting - Availability: 2.2.0 入力ジオメトリを接続関係にある集合にクラスタリングする集約関数です。

ST_ClusterWithin - Availability: 2.2.0 空間的な距離によって入力ジオメトリのクラスタリングを行う集約関数です。

ST_DistanceCPA - Availability: 2.2.0 二つのトラジェクトリの最接近する時の距離を返します。

ST_ForceCurve - Availability: 2.2.0 該当する場合は、ジオメトリを曲線タイプに変換します。

ST_IsPlanar - Availability: 2.2.0: これは2.1.0のマニュアルに記述されていましたが、2.1版では偶然に外れてしまいました。 サーフェスが平面であるかないかをチェックします。

ST_IsSolid - Availability: 2.2.0 ジオメトリが立体であるかどうかをテストします。妥当性チェックは行いません。

ST_IsValidTrajectory - Availability: 2.2.0 ジオメトリが妥当なトラジェクトリであるかどうかをテストします。

ST_LineFromEncodedPolyline - Availability: 2.2.0 エンコード化ポリラインからラインストリングを生成します。

ST_MakeSolid - Availability: 2.2.0 ジオメトリを立体にキャストします。チェックはしません。妥当な立体を得るには、入力ジオメトリは閉じた多面体サーフェスか閉じたTINでなければなりません。

ST_RemoveRepeatedPoints - Availability: 2.2.0 重複ポイントを除いたジオメトリを返します。

ST_SetEffectiveArea - Availability: 2.2.0 Visvalingam-Whyattアルゴリズムを使って有効範囲となる個々の頂点を置きます。

ST_SimplifyVW - Availability: 2.2.0 Visvalingam-Whyattアルゴリズムを使用して、入力ジオメトリを簡略化したジオメトリを返します。

ST_Subdivide - Availability: 2.2.0 ジオメトリの線の分割を計算します。

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に影響を与えます。

|=| - Availability:: 2.2.0 インデックス対応はPostgreSQL 9.5以上でのみ有効です。 AトラジェクトリとBトラジェクトリとの最接近する時の距離を返します。

PostGIS 2.2 で機能強化された関数

<-> - Enhanced: 2.2.0 ジオメトリとジオグラフィとのKNN (k近傍法)の動作が本当のものになりました。ジオグラフィのKNNは回転楕円体面上でなく球面上の計算となることに注意して下さい。PostgreSQL 9.4以下では、ジオグラフィに対応していますが、バウンディングボックスの重心に対応するだけです。 AとBの2次元距離を返します。

ST_Area - Enhanced: 2.2.0 - 精度とロバスト性の向上のためにGeographicLibを使って回転楕円体面上での計測を行うようにしています。この新機能を使うには、Proj 4.9.0以上が必要です。 ポリゴンジオメトリの面積を返します。

ST_AsX3D - Enhanced: 2.2.0: GeoCoordinatesと軸 (x/y, 経度/緯度)の反転に対応しました。詳細はoptionsを見て下さい。 ジオメトリをX3Dノード要素書式 (ISO-IEC-19776-1.2-X3DEncodings-XML)で返します。

ST_Azimuth - Enhanced: 2.2.0 - 精度とロバスト性の向上のためにGeographicLibを使って回転楕円体面上での計測を行うようにしています。この新機能を使うには、Proj 4.9.0以上が必要です。 北を基準とした2点間の線の方位角を返します。

ST_Distance - Enhanced: 2.2.0 - 精度とロバスト性の向上のためにGeographicLibを使って回転楕円体面上での計測を行うようにしています。この新機能を使うには、Proj 4.9.0以上が必要です。 二つのジオメトリ値またはジオグラフィ値間の距離を返します。

ST_Scale - Enhanced: 2.2.0 全ての次元の拡大縮小 (factorパラメータ)への対応が導入されました。 与えた係数でジオメトリを拡大縮小します。

ST_Split - Enhanced: 2.2.0 ライン分割をマルチライン、マルチポイントまたはポリゴンもしくはマルチポリゴンの境界で行えるようにしました。 ジオメトリを他のジオメトリで分割してできたジオメトリのコレクションを返します。

ST_Summary - Enhanced: 2.2.0 TINと曲線の対応が追加されました。 ジオメトリについての要約文を返します。

PostGIS 2.2 で変更された関数

<-> - Changed: 2.2.0 PostgreSQL 9.5では、古いハイブリッド書式は遅くなりる可能性があります。そのため、PostGIS 2.2以上かつPostgreSQL 9.5以上においてのみ動作させる場合には、そのやり方をり除きたくなるでしょう。 AとBの2次元距離を返します。

ST_3DClosestPoint - Changed: 2.2.0 - 二つの2次元ジオメトリが入力である場合には、2次元ポイントが返ります (古い挙動では、存在しないZの値について0を仮定していました)。2次元と3次元の場合には、もはや、存在しないZの値について0を仮定しません。 g1上の、g2に最も近い3次元ポイントを返します。これは3次元の最短ラインの始点です。

ST_3DDistance - Changed: 2.2.0 - 2次元と3次元の場合には、もはや、存在しないZの値について0を仮定しません。 投影座標系の単位で、二つのジオメトリ間の3次元デカルト距離の最小値を返します (空間参照系に基づきます)。

ST_3DLongestLine - Changed: 2.2.0 - 二つの2次元ジオメトリが入力である場合には、2次元ポイントが返ります (古い挙動では、存在しないZの値について0を仮定していました)。2次元と3次元の場合には、もはや、存在しないZの値について0を仮定しません。 二つのジオメトリ間の3次元最長ラインを返します。

ST_3DMaxDistance - Changed: 2.2.0 - 2次元と3次元の場合には、もはや、存在しないZの値について0を仮定しません。 二つのジオメトリ間の3次元最大デカルト距離 (空間参照系に基づく)を空間参照系の単位で返します。

ST_3DShortestLine - Changed: 2.2.0 - 二つの2次元ジオメトリが入力である場合には、2次元ポイントが返ります (古い挙動では、存在しないZの値について0を仮定していました)。2次元と3次元の場合には、もはや、存在しないZの値について0を仮定しません。 二つのジオメトリの3次元の最短ラインを返します。

ST_DistanceSphere - Changed: 2.2.0 前の版ではこの関数はST_Distance_Sphereと呼ばれていました。 球面の地球モデルを使って、二つの経度/緯度ジオメトリの最小距離をメートル単位で返します。

ST_DistanceSpheroid - Changed: 2.2.0 前の版ではこの関数はST_Distance_Sphereと呼ばれていました。 回転楕円体面の地球モデルを使って、二つの経度/緯度ジオメトリの最小距離を返します。

ST_Equals - Changed: 2.2.0 この関数は、どちらのジオメトリも不正であっても、バイナリで同じ場合ならTRUEを返します。 二つのジオメトリが同じ点集合になっているかテストします。

ST_LengthSpheroid - Changed: 2.2.0 これより前の版では、これはST_Length_Spheroidと呼ばれ、ST_3DLength_Spheroidという別名を持っていました。 回転楕円体面上の経度緯度のジオメトリの2次元または3次元の長さ/周長を返します。

ST_MemSize - Changed: 2.2.0 命名規則に従うためにST_MemSizeに変更しました。 ジオメトリが取るメモリ空間の合計を返します。

ST_PointInsideCircle - Changed: 2.2.0 前のバージョンではST_Point_Inside_Circleと呼ばれていました。 ポイントジオメトリが中心と半径で定められた円の内側にあるかをテストします。

PostGIS 2.1 で新規作成/機能強化された関数

次に示す関数は、新規作成または機能強化されたPostGIS関数です。

PostGIS 2.1 で新規作成された関数

ST_3DArea - Availability: 2.1.0 3次元の面ジオメトリの面積を計算します。立体の場合は0を返します。

ST_3DIntersection - Availability: 2.1.0 3次元のインタセクトした (共有する)部分を計算します。

ST_Box2dFromGeoHash - Availability: 2.1.0 GeoHash文字列からBOX2Dを返します。

ST_DelaunayTriangles - Availability: 2.1.0 ジオメトリの頂点のドローネ三角形を返します。

ST_Extrude - Availability: 2.1.0 関連するボリュームにサーフェスを押し出します。

ST_ForceLHR - Availability: 2.1.0 LHR (Left Hand Rule)方向に強制します。

ST_GeomFromGeoHash - Availability: 2.1.0 GeoHash文字列からジオメトリを返します。

ST_MinkowskiSum - Availability: 2.1.0 ミンコフスキー和を求めます。

ST_Orientation - Availability: 2.1.0 サーフェスの方向を判定します。

ST_PointFromGeoHash - Availability: 2.1.0 GeoHash文字列からポイントを返します。

ST_StraightSkeleton - Availability: 2.1.0 ジオメトリからストレートスケルトンを計算します。

ST_Tesselate - Availability: 2.1.0 ポリゴンまたは多面体サーフェスのテッセレーションを計算し、TINまたはTINコレクションを返します。

postgis.backend - Availability: 2.1.0 GEOSとSFCGALで重複する関数を提供するバックエンドです。GEOSまたはSFCGALを選択します。デフォルトはGEOSです。

postgis_sfcgal_version - Availability: 2.1.0 使用しているSFCGALのバージョンを返します

PostGIS 2.1 で機能強化された関数

ST_AsGML - Enhanced: 2.1.0 GML 3用にidが導入されました。 GML第2版または第3版としてジオメトリを返します。

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言語で実装しなおしました。 ジオメトリ内の座標の行であるgeometry_dump行の集合を返します。

ST_MakeValid - Enhanced: 2.1.0 GEOMETRYCOLLECTIONとMULTIPOINTの対応の追加 頂点を失うことなしに不正なジオメトリを妥当なジオメトリにしようと試みます。

ST_Segmentize - Enhanced: 2.1.0 ジオグラフィ対応が導入されました。 与えた長さを超える線分を持たないよう変更したジオメトリ/ジオグラフィを返します。

ST_Summary - Enhanced: 2.1.0 空間参照系を持つかを示すSフラグが追加されました。 ジオメトリについての要約文を返します。

PostGIS 2.1 で変更された関数

ST_EstimatedExtent - Changed: 2.1.0 2.0.xまではST_Estimated_Extentと呼ばれていました。 空間テーブルの推定範囲を返します。

ST_Force2D - Changed: 2.1.0 2.0.xの間はST_Force_2Dと呼ばれていました。 ジオメトリを2次元モードに強制します。

ST_Force3D - Changed: 2.1.0 2.0.xの間はST_Force_3Dと呼ばれていました。 ジオメトリをXYZモードに強制します。これはST_Force3DZの別名です。

ST_Force3DM - Changed: 2.1.0 2.0.xの間はST_Force_3DMと呼ばれていました。 ジオメトリをXYMモードに強制します。

ST_Force3DZ - Changed: 2.1.0 2.0.xの間はST_Force_3DZと呼ばれていました。 ジオメトリをXYZモードに強制します。

ST_Force4D - Changed: 2.1.0 2.0.xの間はST_Force_4Dと呼ばれていました。 ジオメトリをXYZMモードに強制します。

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 ジオグラフィ対応の導入の結果、ST_Segmentize('LINESTRING(1 2, 3 4)', 0.5)とすると、あいまい関数エラーが発生します。入力ではジオメトリかジオグラフィかを確実に指定する必要があります。ST_GeomFromText、ST_GeogFromText、使いたい型へのキャスト (例: ST_Segmentize('LINESTRING(1 2, 3 4)'::geometry, 0.5) )を行います 与えた長さを超える線分を持たないよう変更したジオメトリ/ジオグラフィを返します。

PostGIS 2.0 で新規作成/機能強化された関数

次に示す関数は、新規作成または機能強化されたPostGIS関数です。

PostGIS 2.0 で新規作成された関数

&&& - 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次元距離を返します。

ST_3DClosestPoint - Availability: 2.0.0 g1上の、g2に最も近い3次元ポイントを返します。これは3次元の最短ラインの始点です。

ST_3DDFullyWithin - Availability: 2.0.0 二つの3次元ジオメトリが完全に与えらえれた3次元距離内にあるかどうかをテストします。

ST_3DDWithin - Availability: 2.0.0 二つの3次元ジオメトリが与えらえれた3次元距離内にあるかどうかをテストします。

ST_3DDistance - Availability: 2.0.0 投影座標系の単位で、二つのジオメトリ間の3次元デカルト距離の最小値を返します (空間参照系に基づきます)。

ST_3DIntersects - Availability: 2.0.0 二つのジオメトリが3次元空間において空間的にインタセクトするかどうかをテストします。ポイント、ラインストリング、ポリゴン、多面体サーフェス (面)についてのみ動作します。

ST_3DLongestLine - Availability: 2.0.0 二つのジオメトリ間の3次元最長ラインを返します。

ST_3DMaxDistance - Availability: 2.0.0 二つのジオメトリ間の3次元最大デカルト距離 (空間参照系に基づく)を空間参照系の単位で返します。

ST_3DShortestLine - Availability: 2.0.0 二つのジオメトリの3次元の最短ラインを返します。

ST_AsLatLonText - Availability: 2.0 与えられたポイントの度・分・秒表現を返します。

ST_AsX3D - Availability: 2.0.0: ISO-IEC-19776-1.2-X3DEncodings-XML ジオメトリをX3Dノード要素書式 (ISO-IEC-19776-1.2-X3DEncodings-XML)で返します。

ST_CollectionHomogenize - Availability: 2.0.0 ジオメトリコレクションを与えると、最も単純な表現を返します。

ST_ConcaveHull - Availability: 2.0.0 全ての入力ジオメトリの頂点を含む凹ジオメトリを計算します。

ST_FlipCoordinates - Availability: 2.0.0 X値とY値を入れ替えたジオメトリを返します。

ST_GeomFromGeoJSON - Availability: 2.0.0 JSON-C 0.9以上が必要です。 ジオメトリのGeoJSON表現を入力として、PostGISジオメトリオブジェクトを出力します。

ST_InterpolatePoint - Availability: 2.0.0 ジオメトリのポイントに最も近いポイント上の補間M値を返します。

ST_IsValidDetail - Availability: 2.0.0 ジオメトリが妥当か、妥当でないなら理由と位置をそれぞれ示すvalid_detail行を返します。

ST_IsValidReason - Availability: 2.0 フラグを取る形式。 ジオメトリが妥当か否かを示す文字列を返し、不正な場合は理由を返します。

ST_MakeLine - Availability: 2.0.0 - LINESTRING入力要素への対応が導入されました POINT、MULTIPOINT、LINESTRINGからLINESTRINGを生成します。

ST_MakeValid - Availability: 2.0.0 頂点を失うことなしに不正なジオメトリを妥当なジオメトリにしようと試みます。

ST_Node - Availability: 2.0.0 ラインストリングの集合にノードを作成します。

ST_NumPatches - Availability: 2.0.0 多面体サーフェスのフェイス数を返します。多面体でないジオメトリの場合にはNULLを返します。

ST_OffsetCurve - Availability: 2.0 与えられた距離と方面に入力ラインをずらしたラインを返します。

ST_PatchN - Availability: 2.0.0 多面体サーフェスのN番目のジオメトリ (フェイス)を返します。

ST_Perimeter - Availability: 2.0.0 ジオグラフィ対応が導入されました。 ポリゴンジオメトリまたはジオグラフィの境界の長さを返します。

ST_Project - Availability: 2.0.0 始点から距離と方位で算出されたポイントを返します。

ST_RelateMatch - Availability: 2.0.0 DE-9IMインタセクション行列がインタセクション行列パターンに合致するかどうかを見ます。

ST_SharedPaths - Availability: 2.0.0 二つのLINESTRING/MULTILINESTRINGの入力が共有するパスのコレクションを返します。

ST_Snap - Availability: 2.0.0 入力ジオメトリの辺と頂点を参照ジオメトリの頂点にスナップします。

ST_Split - Availability: 2.0.0 GEOSが必要です ジオメトリを他のジオメトリで分割してできたジオメトリのコレクションを返します。

ST_UnaryUnion - Availability: 2.0.0 単一のジオメトリの要素の結合を計算します。

PostGIS 2.0 で機能強化された関数

&& - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。 Aの2次元バウンディングボックスがBの2次元バウンディングボックスとインタセクトする場合にTRUEを返します。

AddGeometryColumn - Enhanced: 2.0.0 use_typmod引数が導入されました。デフォルトでは制約を基にしたものでなくtypmodジオメトリカラムが生成されます。 ジオメトリカラムを既存のテーブルに追加します。

Box2D - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 ジオメトリの2次元範囲を表現するBOX2Dを返します。

Box3D - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 ジオメトリの3次元範囲を表現するBOX3Dを返します。

GeometryType - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 ジオメトリのタイプを文字列で返します。

Populate_Geometry_Columns - Enhanced: 2.0.0 use_typmod任意引数が導入されました。カラムが型修飾子で生成されるか制約チェックで作られるかの制御ができます。 ジオメトリカラムが型修飾子で定義されるか、適切な空間制約を持つようにします。

ST_3DExtent - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 ジオメトリの3次元バウンディングボックスを返す集約関数です。

ST_Affine - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 ジオメトリに3次元アフィン変換を適用します。

ST_Area - Enhanced: 2.0.0 - 2次元多面体サーフェス対応が導入されました。 ポリゴンジオメトリの面積を返します。

ST_AsBinary - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 ジオメトリ/ジオグラフィの、SRIDメタデータを持たないOGC/ISO Well-Knownバイナリ (WKB)表現を返します。

ST_AsBinary - Enhanced: 2.0.0 高次元が導入されました。 ジオメトリ/ジオグラフィの、SRIDメタデータを持たないOGC/ISO Well-Knownバイナリ (WKB)表現を返します。

ST_AsBinary - Enhanced: 2.0.0 ジオグラフィでのエンディアン指定が導入されました。 ジオメトリ/ジオグラフィの、SRIDメタデータを持たないOGC/ISO Well-Knownバイナリ (WKB)表現を返します。

ST_AsEWKB - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 ジオメトリの、SRIDメタデータを持つExtended Well-Knownバイナリ (EWKB)表現を返します。

ST_AsEWKT - Enhanced: 2.0.0 ジオグラフィ対応、多面体サーフェス対応、三角形対応、TIN対応が導入されました。 ジオメトリのSRIDメタデータが付いたWell-Known Text (WKT)表現を返します。

ST_AsGML - Enhanced: 2.0.0 プレフィクスが導入されました。 GML 3用であるoptionsの4は、曲線のかわりにラインストリングを使えるようにするためのものです。GML 3の多面体サーフェスとTINが導入されました。optionsの32はボックスを出力するために導入されました。 GML第2版または第3版としてジオメトリを返します。

ST_AsKML - Enhanced: 2.0.0 - プレフィクスの名前空間の追加、デフォルト値と名前付き引数の追加 ジオメトリをKML要素として返します。

ST_Azimuth - Enhanced: 2.0.0 ジオグラフィ対応が導入されました。 北を基準とした2点間の線の方位角を返します。

ST_Dimension - Enhanced: 2.0.0 多面体サーフェス対応とTIN対応が導入されました。空ジオメトリを与えた場合に例外を投げなくなりました。 ST_Geometry値の座標次元を返します。

ST_Dump - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 ジオメトリの要素となるgeometry_dump行の集合を返します。

ST_DumpPoints - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 ジオメトリ内の座標の行であるgeometry_dump行の集合を返します。

ST_Expand - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 他のバウンディングボックスまたはジオメトリから拡張されたバウンディングボックスを返します。

ST_Extent - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 ジオメトリのバウンディングボックスを返す集約関数です。

ST_Force2D - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。 ジオメトリを2次元モードに強制します。

ST_Force3D - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。 ジオメトリをXYZモードに強制します。これはST_Force3DZの別名です。

ST_Force3DZ - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。 ジオメトリをXYZモードに強制します。

ST_ForceCollection - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。 ジオメトリをジオメトリコレクションに変換します。

ST_ForceRHR - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。 ポリゴンの頂点の方向を右回りに強制します。

ST_GMLToSQL - Enhanced: 2.0.0 多面体サーフェス対応とTIN対応が導入されました。 GML表現から指定したST_Geometry値を返します。これはST_GeomFromGMLの別名です。

ST_GMLToSQL - Enhanced: 2.0.0 SRID任意引数が追加されました。 GML表現から指定したST_Geometry値を返します。これはST_GeomFromGMLの別名です。

ST_GeomFromEWKB - Enhanced: 2.0.0 多面体サーフェス対応とTIN対応が導入されました。 拡張Well-Known Binary表現 (EWKB)から指定したST_Geometry値を返します。

ST_GeomFromEWKT - Enhanced: 2.0.0 多面体サーフェス対応とTIN対応が導入されました。 拡張Well-Known Text表現 (EWKT)から指定されたST_Geometry値を返します。

ST_GeomFromGML - Enhanced: 2.0.0 多面体サーフェス対応とTIN対応が導入されました。 GML表現からPostGISジオメトリオブジェクトを出力します。

ST_GeomFromGML - Enhanced: 2.0.0 SRID任意引数が追加されました。 GML表現からPostGISジオメトリオブジェクトを出力します。

ST_GeometryN - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 ジオメトリコレクションの要素を一つ返します。

ST_GeometryType - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。 ジオメトリのSQL-MM型を文字列で返します。

ST_IsClosed - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。 ラインストリングの始点と終点が一致しているかをテストします。多面体サーフェスについては閉じているか (立体であるか)をテストします。

ST_MakeEnvelope - Enhanced: 2.0 SRID指定なしでエンベロープを指定できるようになりました。 座標値の最小値と最大値から矩形ポリゴンを生成します。

ST_MakeValid - Enhanced: 2.0.1 速度の改善 頂点を失うことなしに不正なジオメトリを妥当なジオメトリにしようと試みます。

ST_NPoints - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。 ジオメトリのポイント (頂点)の数を返します。

ST_NumGeometries - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 ジオメトリコレクションの要素数を返します。

ST_Relate - Enhanced: 2.0.0 - 境界ノード規則が追加されました。 二つのジオメトリが与えられた交差行列パターンに合致するトポロジ関係があるかどうかを見るか、交差行列を計算するかします。

ST_Rotate - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 ジオメトリを原点について回転させます。

ST_Rotate - Enhanced: 2.0.0 回転の原点を指定するパラメタを追加しました。 ジオメトリを原点について回転させます。

ST_RotateX - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 ジオメトリをX軸について回転させます。

ST_RotateY - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 ジオメトリをY軸について回転させます。

ST_RotateZ - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 ジオメトリをZ軸について回転させます。

ST_Scale - Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。 与えた係数でジオメトリを拡大縮小します。

ST_ShiftLongitude - Enhanced: 2.0.0 多面体サーフェス対応とTIN対応が導入されました。 経度座標値を-180度から180度の範囲と0度から360度の範囲との二つの範囲を行き来するようシフトします。

ST_Summary - Enhanced: 2.0.0でジオグラフィ対応が追加されました。 ジオメトリについての要約文を返します。

ST_Transform - Enhanced: 2.0.0 多面体サーフェス対応が導入されました。 異なる空間参照系に投影変換された新しいジオメトリを返します。

PostGIS 2.0 で変更された関数

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を使った削除が可能です。 テーブルとgeometry_columnsの当該テーブルへの参照の全てを削除します。

Populate_Geometry_Columns - Changed: 2.0.0 デフォルトでは、ジオメトリタイプの制限について、制約を確認する代わりに型修飾子を使います。新しいuse_typmodをFALSEに設定して使うことで、制約確認を使用することができます。 ジオメトリカラムが型修飾子で定義されるか、適切な空間制約を持つようにします。

ST_3DExtent - Changed: 2.0.0 以前の版ではST_Extent3Dと呼ばれていました。 ジオメトリの3次元バウンディングボックスを返す集約関数です。

ST_3DLength - Changed: 2.0.0 以前の版ではST_Length3Dと呼ばれていました。 線ジオメトリの3次元長を返します。

ST_3DMakeBox - Changed: 2.0.0以前の版ではST_MakeBox3Dと呼ばれていました。 二つの3次元のポイントジオメトリで定義されるBOX3Dを生成します。

ST_3DPerimeter - Changed: 2.0.0 以前の版ではST_Perimeter3Dと呼ばれていました。 ポリゴンジオメトリの3次元周長を返します。

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をインストールして下さい。 ジオメトリ/ジオグラフィの、SRIDメタデータを持たないOGC/ISO Well-Knownバイナリ (WKB)表現を返します。

ST_AsGML - Changed: 2.0.0 デフォルトの名前付き引数を使います。 GML第2版または第3版としてジオメトリを返します。

ST_AsGeoJSON - Changed: 2.0.0 デフォルト引数と名前付き引数に対応しました。 ジオメトリをGeoJSON要素として返します。

ST_AsSVG - Changed: 2.0.0 - デフォルト引数と名前付き引数に対応しました。 ジオメトリからSVGパスデータを返します。

ST_EndPoint - Changed: 2.0.0 一つのジオメトリマルチラインストリングで動作しなくなりました。PostGIS の古いバージョンでは、この関数は一つのマルチラインストリングで動作し、終端ポイントを返します。2.0.0では、他のマルチラインストリングと同様にNULLを返します。古い動作は文書化されていない機能でしたが、データをLINESTRINGとして格納していると思われるユーザーは、2.0.0 でNULLが返されることを経験するかも知れません。 LINESTRINGまたはCIRCULARLINESTRINGの終端のポイントを返します。

ST_GeomFromText - Changed: 2.0.0 前の版ではST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)')が許されていました。SQL/MM標準への適合のためPostGIS 2.0.0では不正とされます。今はST_GeomFromText('GEOMETRYCOLLECTION EMPTY')となります。 Well-Known Text表現 (WKT)から指定したST_Geometryを返します。

ST_GeometryN - Changed: 2.0.0 以前の版では非マルチのジオメトリではNULLが返りました。ST_GeometryN(..,1)の場合にはジオメトリを返すよう変更されました。 ジオメトリコレクションの要素を一つ返します。

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を使います。 線系ジオメトリの2次元長を返します。

ST_LocateAlong - Changed: 2.0.0 以前の版ではST_Locate_Along_Measureと呼ばれていました。 M値に一致するジオメトリ上のポイントを返します。

ST_LocateBetween - Changed: 2.0.0 以前の版ではST_Locate_Between_Measuresと呼ばれていました。 M値の範囲に合致する部分ジオメトリを返します。

ST_NumGeometries - Changed: 2.0.0 前の版では、ジオメトリがコレクション/マルチ系でない場合にはNULLを返しました。2.0.0以上では、POLYGON, LINESTRING, POINTといった単一ジオメトリについては1を返します。 ジオメトリコレクションの要素数を返します。

ST_NumInteriorRings - Changed: 2.0.0 - 以前の版では、MULTIPOLYGONを渡して最初のPOLYGONの内環の数を返すことができました。 ポリゴンの内環 (穴)の数を返します。

ST_PointN - Changed: 2.0.0 単一ジオメトリのMULTILINESTRINGで動作しなくなりました。単一のラインストリングからなるMULTILINESTRINGについては幸運にも動いていて、最初のポイントを返していました。2.0.0では他のMULTILINESTRINGと同様にNULLを返すようになりました。 ジオメトリの最初のラインストリングまたは曲線ストリングのN番目のポイントを返します。

ST_StartPoint - Changed: 2.0.0 一つのMULTILINESTRINGで動作しなくなりました。PostGIS の古いバージョンでは、この関数は、一つのラインストリングからなるMULTILINESTRINGについては幸運にも動いていて、始端ポイントを返していました。2.0.0では他のMULTILINESTRINGと同様にNULLを返すようになりました。古い動作は文書化されていない機能でしたが、データをLINESTRINGとして格納していると思われるユーザーは、2.0.0 でNULLが返されることを経験するかも知れません。 ラインストリングの始点を返します。

PostGIS 1.5 で新規作成/機能強化された関数

次に示す関数は、新規作成または機能強化されたPostGIS関数です。

PostGIS 1.5 で新規作成された関数

&& - Availability: 1.5.0 ジオグラフィ対応が導入されました。 Aの2次元バウンディングボックスがBの2次元バウンディングボックスとインタセクトする場合にTRUEを返します。

PostGIS_LibXML_Version - Availability: 1.5 LibXML2ライブラリのバージョン番号を返します。

ST_AddMeasure - Availability: 1.5.0 ラインに沿ったM値を補間します。

ST_AsBinary - Availability: 1.5.0 ジオグラフィが導入されました。 ジオメトリ/ジオグラフィの、SRIDメタデータを持たないOGC/ISO Well-Knownバイナリ (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が強化され、様々な終端と継ぎ目に対応するようになりました。たとえば、道路ラインストリングを道路ポリゴンに変換する際に終端を丸でなく平面や四角で処理したい場合などに使えます。ジオグラフィ用の薄いラッパが追加されました。 あるジオメトリからの距離が指定された距離以下となる点全ての集合となるジオメトリを返します。

ST_ClosestPoint - Availability: 1.5.0 g1上にある、g2と最近傍となる2次元ポイントを返します。これは、あるジオメトリから他のジオメトリへの最短ラインの一つ目のポイントです。

ST_CollectionExtract - Availability: 1.5.0 ジオメトリコレクションを与えると、指定されたタイプの要素だけからなるマルチジオメトリを返します。

ST_Covers - Availability: 1.5 - ジオグラフィ対応が導入されました。 Bの全ての点がA内にあるかをテストします。

ST_DFullyWithin - Availability: 1.5.0 二つのジオメトリが完全に与えらえれた距離内にあるかどうかをテストします。

ST_DWithin - Availability: 1.5.0 ジオグラフィが導入されました。 二つのジオメトリが与えらえれた距離内にあるかどうかをテストします。

ST_Distance - Availability: 1.5.0 1.5でジオグラフィ対応が導入されました。大きいジオメトリや頂点の多いジオメトリについての速度が改善しました。 二つのジオメトリ値またはジオグラフィ値間の距離を返します。

ST_DistanceSphere - Availability: 1.5 - ポイント以外のジオメトリが導入されました。以前の版ではポイントでのみ動作しました。 球面の地球モデルを使って、二つの経度/緯度ジオメトリの最小距離をメートル単位で返します。

ST_DistanceSpheroid - Availability: 1.5 - ポイント以外のジオメトリが導入されました。以前の版ではポイントでのみ動作しました。 回転楕円体面の地球モデルを使って、二つの経度/緯度ジオメトリの最小距離を返します。

ST_DumpPoints - Availability: 1.5.0 ジオメトリ内の座標の行であるgeometry_dump行の集合を返します。

ST_Envelope - Availability: 1.5.0 挙動が変更され出力がfloat4からfloat8になりました。 ジオメトリのバウンディングボックスを表現するジオメトリを返します。

ST_Expand - Availability: 1.5.0 出力をfloat4座標値から倍精度に変更しました。 他のバウンディングボックスまたはジオメトリから拡張されたバウンディングボックスを返します。

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ジオメトリオブジェクトを出力します。

ST_HausdorffDistance - Availability: 1.5.0 二つのジオメトリ間のハウスドルフ距離を返します。

ST_Intersection - Availability: 1.5 ジオグラフィ型が導入されました。 ジオメトリAとジオメトリBの共通部分を表現するジオメトリを返します。

ST_Intersects - Availability: 1.5 ジオグラフィ対応が導入されました。 二つのジオメトリがインタセクトしている (少なくとも一つの共有点がある)かどうかテストします。

ST_Length - Availability: 1.5.0 ジオグラフィt対応が導入されました。 線系ジオメトリの2次元長を返します。

ST_LongestLine - Availability: 1.5.0 二つのジオメトリ間の2次元最長ラインを返します。

ST_MakeEnvelope - Availability: 1.5 座標値の最小値と最大値から矩形ポリゴンを生成します。

ST_MaxDistance - Availability: 1.5.0 二つのジオメトリ間の2次元最長距離を空間参照系の単位で返します。

ST_ShortestLine - Availability: 1.5.0 二つのジオメトリの3次元の最短ラインを返します。

~= - Availability: 1.5.0 挙動が変更されました AのバウンディングボックスがBのバウンディングボックスと同じ場合に TRUEを返します。

PostGIS 1.4 で新規作成/機能強化された関数

次に示す関数は、新規作成または機能強化されたPostGIS関数です。

PostGIS 1.4 で新規作成された関数

Populate_Geometry_Columns - Availability: 1.4.0 ジオメトリカラムが型修飾子で定義されるか、適切な空間制約を持つようにします。

ST_Collect - Availability: 1.4.0 - ST_Collect(geometry)が導入されました。ST_Collectがより多くのジオメトリをより早く扱えるよう強化されました。 ジオメトリの集合からジオメトリコレクションまたはマルチ系ジオメトリを生成します。

ST_ContainsProperly - Availability: 1.4.0 Bの全てのポイントがAの内部にあるかをテストします。

ST_GeoHash - Availability: 1.4.0 ジオメトリのGeoHash表現を返します。

ST_IsValidReason - Availability: 1.4 ジオメトリが妥当か否かを示す文字列を返し、不正な場合は理由を返します。

ST_LineCrossingDirection - Availability: 1.4 二つのラインストリングがどのように交差しているかを示す数字を返します。

ST_LocateBetweenElevations - Availability: 1.4.0 標高 (Z値)範囲にある部分ジオメトリを返します。

ST_MakeLine - Availability: 1.4.0 - ST_MakeLine(geomarray)が導入されました。ST_MakeLine集約関数はより多くのポイントをより早く扱うための強化が施されています。 POINT、MULTIPOINT、LINESTRINGからLINESTRINGを生成します。

ST_MinimumBoundingCircle - Availability: 1.4.0 入力ジオメトリを含む最小の円を返します。

ST_Union - Availability: 1.4.0 - ST_Unionが機能強化されました。ST_Union(geomarray)が導入され、PostgreSQLの高速なコレクションの集約が導入されました。 入力ジオメトリのポイント集合の結合を表現するジオメトリを返します。

PostGIS 1.3 で新規作成/機能強化された関数

次に示す関数は、新規作成または機能強化されたPostGIS関数です。

PostGIS 1.3 で新規作成された関数

ST_AsGML - Availability: 1.3.2 GML第2版または第3版としてジオメトリを返します。

ST_AsGeoJSON - Availability: 1.3.4 ジオメトリをGeoJSON要素として返します。

ST_CurveToLine - Availability: 1.3.0 曲線を含むジオメトリを線ジオメトリに変換します。

ST_LineToCurve - Availability: 1.3.0 曲線を含むジオメトリを線ジオメトリに変換します。

ST_SimplifyPreserveTopology - Availability: 1.3.3 Douglas-Peukerアルゴリズムを使用して、与えられたジオメトリを簡略化したものを返します。

Chapter 13. 問題を報告する

ソフトウェアのバグを報告する

効率的なバグの報告はPostGISの開発を助ける本質的な方法です。最も効率的なバグ報告は、PostGIS開発者がそれを再現できるようにすることで、それの引き金となったスクリプトと検出された環境に沿った全ての情報を含んでいるのが理想です。SELECT postgis_full_version() [PostGIS]とSELECT version() [PostgreSQL]とを実行することで十分に良い情報を得ることができます。

最新版を使っていない場合にはrelease changelogをまず見て、既にバグフィクスされていないかを探すのは価値のあることです。

PostGIS bug trackerを使うと、レポートが捨てられず、それの対応プロセスが通知されることを保証します。新しいバグを報告する前にデータベースに問い合わせて、既知のバグかどうかを見て下さい。既知のものでしたら、それに関して持っているあらゆる新しい情報を追加して下さい。

新しいレポートを記入する前にSimon TathamさんのHow to Report Bugs Effectivelyに関するページを読むと良いでしょう。

文書の問題を報告する

文書は、ソフトウェアの機能と挙動を正確に反映するべきものです。正確でない場合は、ソフトウェアのバグがあるか、または文書に誤り若しくは不十分な箇所があることが考えられます。

文書の問題もPostGIS bug trackerに報告することができます。

訂正が小さいものなら、バグトラッカの新しい問題の中に、文書内の位置を特定して記述して下さい。

変更が大きい場合は、パッチが確実に好まれます。Unix上で次の4ステップの処理を行います (既にgitをインストールしていると仮定します)。

PostGISのgitリポジトリを複製します。UNIXでは次のように入力します。

git clone https://git.osgeo.org/gitea/postgis/postgis.git

これでpostgisディレクトリに格納されます

お使いのテキストエディタで文書に変更を加えます。Unixでは、たとえば次のようにします。

vim doc/postgis.xml

文書はHTMLでなくDocBook XMLで書かれていますので、慣れていないなら、残りの文書の例にならって下さい。

文書のマスタコピーからパッチファイルを作成します。Unixでは次のように入力します。

git diff doc/postgis.xml > doc.patch

バグトラッカ内の新しい問題にパッチが取り付けられます。

Appendix A. 付録

リリースノート

PostGIS 3.3.0

2022/08/26

このバージョンにはPostgreSQL 11以上、GEOS 3.6以上、Proj 5.2以上が必要です。GEOS 3.9以上で追加機能が有効になり、GEOS 3.10以上でST_MakeValidの機能強化が有効になり、GEOS 3.11以上で多数の機能強化が追加されます。ST_AlphaShapeとST_OptimalAlphaShapeにはSFCGAL 1.4.1以上が必要です。

ご注意: GEOS 3.11.0は最近リリースされました。GEOS 3.11.0 release notesに詳細があります。

新規フラグの --enable-lto で、数学計算を改善します。ただし、プラットフォームによってはコンパイルエラーが発生する (BSDとMingW64で問題が発生しています)ため、この機能はデフォルトでは無効になっています。

新機能

5116, トポロジのエクスポート/インポート用スクリプト (Sandro Santilliさん)

文字のように見えるジオメトリを生成するST_Letters (Paul Ramseyさん)

5037, postgis_sfcgal: ST_3DConvexHull (Loïc Bartolettiさん)

postgis_sfcgal: sfcgal_full_version - BOOSTとCGALのバージョンの報告 (Loïc Bartolettiさん)

GH 659, MARC21/XML, ST_GeomFromMARC21, ST_AsMARC21 (Jim Jonesさん)

5132, GH 683, sfcgal: ST_3DUnion aggregate function (Sergei Shoulbakovさん)

5143, SFCGAL ST_AlphaShape と ST_OptimalAlphaShape SFCGAL 1.4.1以上が必要 (Loïc Bartolettiさん)

5162, GEOS 3.11以上のST_TriangulatePolygon (Paul Ramseyさん, Martin Davisさん)

5162, ST_SimplifyPolygonHull GEOS 3.11以上が必要 (Paul Ramseyさん, Martin Davisさん)

5183, topology.RemoveUnusedPrimitives (Sandro Santilliさん)

大幅な変更

PostgreSQL 9.6と10への対応を終了します (Regina Obeさん)

WKT MULTOPOINTの出力を変更しました。全ての点が丸括弧で括られるようになりました。(Even Roualtさん)

GH 674, ST_DumpAsPolygonsとST_Polygonのジオメトリの妥当性評価と修正は無効になってて、動作速度は早くなりますが不正なポリゴンが生成される可能性があります (Aliaksandr Kalenikさん)

性能強化

2861, topology.node(containing_face)へのインデックスの追加で、フェイスの分割とマージが早くなりました (Sandro Santilliさん)

2083, リレーション (element_id)とエッジデータ (abs_next*)のインデックスを追加することによるトポロジ関数のST_RemEdgeの高速化 (Sandro Santilliさん)

5118, TopoGeometryのシーケンスがなくなった状態でトポロジを削除できるようにしました (Sandro Santilliさん)

5111, トポロジのフェイスのMBRのより速い計算 (Sandro Santilliさん)

postgis_extensions_upgrade()で、リリース前を含むどのPostGISバージョンからでも対応できるようになりました (Sandro Santilliさん)

5040, postgis_sfcgal_full_versionの追加 (Loïc Bartolettiさん)

GH 655, GiST: 再起呼出し中でのより良いバランスの木の分割 (Darafei Praliaskouskiさん)

GH 657, GiST: 何もしない伸張関数を呼び出さない (Aliaksandr Kalenikさん)

4939, 5161, ST_LineMergeに、道路のグラフ処理の際に使用する、入力ラインストリングの方向を保持するオプションの追加。GEOS 3.11が必要 (Sergei Shoulbakovさん)

GEOS 3.11以上でのST_ConcaveHullの直接使用 (Paul Ramseyさん, Martin Davisさん)

GEOS 3.11以上を使ったST_ConcaveHullのポリゴンを尊重するネイティブ実装 (Paul Ramseyさん, Martin Davisさん)

4574, GH 678, 5121 --enable-lto でリンク時間最適化を有効にできます (Sergei Shoulbakovさん)

GH 676, ST_Clip高速化 (Aliaksandr Kalenikさん)

5135, 高速GiSTインデックス構築はPostgreSQL 15以上ではデフォルトで有効になりました (Sergei Shoulbakovさん)

4939, 5161, ST_LineMergeに、道路のグラフ処理の際に使用する、入力ラインストリングの方向を保持するオプションの追加。GEOS 3.11が必要 (Sergei Shoulbakovさん)

5158, pgtopo_import / pgtopo_exportのマニュアルページ (Sandro Santilliさん)

5170, raster2pgsqlの-Yオプションで使用する、COPYステートメントあたりの行数を制御するパラメータmax_rows_per_copyの追加。指定していない場合のデフォルトは50 (Regina Obeさん)

GH698, ST_Unionで並列集約に対応しました (Sergei Shoulbakovさん)

5024, spatial_ref_sysの更新を ALTER EXTENSION update postgis の一部にしました (Paul Ramseyさん)

誤り訂正

これらは、バックポートされていない前のマイナーバージョンで修正された問題です。

4912, GiST: ジオグラフィでのSTORAGE EXTERNALでクラッシュするのを修正 (Aliaksandr Kalenikさん)

5088, mvt_agg_transfnでメモリ破損 (Victor Collodさん)

5137, クエリ実行前の割り込みフラグのリセット (Sergei Shoulbakovさん)

5148, ST_Clipがラスタのアラインメントとジオメトリ抜き出しに対してよりロバストになりました (Sergei Shoulbakovさん)

4932, ジオグラフィ版のST_Intersects / ST_Distanceの問題 (Paul Ramseyさん)

5089, ST_Reverse が複合曲線の要素も反転するようになりました (Paul Ramseyさん)

PostGIS 3.3.0rc2

2022/08/22

このバージョンにはPostgreSQL 11以上、GEOS 3.6以上、Proj 5.2以上が必要です。GEOS 3.9以上で追加機能が有効になり、GEOS 3.10以上でST_MakeValidの機能強化が有効になり、GEOS 3.11以上で多数の機能強化が追加されます。ST_AlphaShapeとST_OptimalAlphaShapeにはSFCGAL 1.4.1以上が必要です。

ご注意: GEOS 3.11.0は最近リリースされました。GEOS 3.11.0 release notesに詳細があります。

新規フラグの --enable-lto で、数学計算を改善します。ただし、プラットフォームによってはコンパイルエラーが発生する (BSDとMingW64で問題が発生しています)ため、この機能はデフォルトでは無効になっています。

誤り訂正

5089, ST_Reverse が複合曲線の要素も反転するようになりました (Paul Ramseyさん)

5181, Projの文字列解析に失敗した後にエラー状態をリセットするようにしました (Paul Ramseyさん)

5171, 測地線距離の計算で入力が同じ時に計算を省略するようになりました (Paul Ramseyさん)

PostGIS 3.3.0rc1

2022/08/08

このバージョンにはPostgreSQL 11以上、GEOS 3.6以上、Proj 5.2以上が必要です。GEOS 3.9以上で追加機能が有効になり、GEOS 3.10以上でST_MakeValidの機能強化が有効になり、GEOS 3.11以上で多数の機能強化が追加されます。ST_AlphaShapeとST_OptimalAlphaShapeにはSFCGAL 1.4.1以上が必要です。

ご注意: GEOS 3.11.0は最近リリースされました。GEOS 3.11.0 release notesに詳細があります。

新規フラグの --enable-lto で、数学計算を改善します。ただし、プラットフォームによってはコンパイルエラーが発生する (BSDとMingW64で問題が発生しています)ため、この機能はデフォルトでは無効になっています。

有効にするには次のようにします。

./configure --enable-lto

PostGIS 3.3.0beta2からの変更点は次の通りです。

誤り訂正

5154, ラスタ版ST_Valueのコストが小さい (Regina Obeさん)

5157, minimum_bounding_circleのCunitテストを小さい32ビット浮動小数点数の差を許容するよう改訂 (Regina Obeさん)

5191, 関数はint4でなくintegerを使うべき (Regina Obeさん)

5139, to_jsonb、ST_AsGeoJSONとST_AsGMLが並列安全でない (Regina Obe, Paul Ramseyさん)

5025, 関数や演算子群の次元が合わない時に追加演算子が実際に追加されることがないように更新 (Paul Ramseyさん)

5195, #5196 address_standardizerとpostgis_tiger_geocoderのCREATE EXTENSIONでCREATE OR REPLACEからCREATEに変更 (Regina Obeさん)

5202, ダウングレードに対する保護 (Sandro Santilliさん)

5104, pgextwlistを入れるとpostgis_extensions_upgrade()が失敗する (Regina Obeさん)

PostGIS 3.3.0beta2

2022/07/13

このバージョンにはPostgreSQL 11以上、GEOS 3.6以上、Proj 5.2以上が必要です。GEOS 3.9以上で追加機能が有効になり、GEOS 3.10以上でST_MakeValidの機能強化が有効になり、GEOS 3.11以上で多数の機能強化が追加されます。ST_AlphaShapeとST_OptimalAlphaShapeにはSFCGAL 1.4.1以上が必要です。

ご注意: GEOS 3.11.0は最近リリースされました。GEOS 3.11.0 release notesに詳細があります。

新規フラグの --enable-lto で、数学計算を改善します。ただし、プラットフォームによってはコンパイルエラーが発生する (BSDとMingW64で問題が発生しています)ため、この機能はデフォルトでは無効になっています。

有効にするには次のようにします。

./configure --enable-lto

PostGIS 3.3.0beta1からの変更点

新機能

5183, topology.RemoveUnusedPrimitives (Sandro Santilliさん)

性能強化

GH698, ST_Unionで並列集約に対応しました (Sergei Shoulbakovさん)

誤り訂正

5179, ビッグエンディアンでpgsql2shpが構文エラーを出す (Bas Couwenbergさん)

PostGIS 3.3.0beta1

2022/07/03

このバージョンにはPostgreSQL 11以上、GEOS 3.6以上、Proj 5.2以上が必要です。GEOS 3.9以上で追加機能が有効になり、GEOS 3.10以上でST_MakeValidの機能強化が有効になり、GEOS 3.11以上で多数の機能強化が追加されます。

ST_AlphaShapeとST_OptimalAlphaShapeのためにSFCGAL 1.4.1以上が必要です。

ご注意: GEOS 3.11.0は最近リリースされました。GEOS 3.11.0 release notesに詳細があります。

新規フラグの --enable-lto で、数学計算を改善します。ただし、プラットフォームによってはコンパイルエラーが発生する (BSDとMingW64で問題が発生しています)ため、この機能はデフォルトでは無効になっています。

有効にするには次のようにします。

./configure --enable-lto

性能強化

5158, pgtopo_import / pgtopo_exportのマニュアルページ (Sandro Santilliさん)

5170, raster2pgsqlの-Yオプションで使用する、COPYステートメントあたりの行数を制御するパラメータmax_rows_per_copyの追加。指定していない場合のデフォルトは50 (Regina Obeさん)

4939, 5161, ST_LineMergeに、道路のグラフ処理の際に使用する、入力ラインストリングの方向を保持するオプションの追加。GEOS 3.11が必要 (Sergei Shoulbakovさん)

GEOS 3.11以上を使ったST_ConcaveHullのポリゴンを尊重するネイティブ実装 (Paul Ramseyさん, Martin Davisさん)

5039, postgis_tiger_geocoder TIGER 2021 (Regina Obeさん)

新機能

>5169, ST_SimplifyPolygonHull (GEOS 3.11が必要) (Paul Ramseyさん, Martin Davisさん)

5162, GEOS 3.11以上のST_TriangulatePolygon (Paul Ramseyさん, Martin Davisさん)

誤り修正

5173 st_asflatgeobufでTOASTから値を戻す時にクラッシュする (Paul Ramseyさん)

4932, ジオグラフィ版のST_Intersects / ST_Distanceの問題 (Paul Ramseyさん)

5114, データ長が長いカラムか切り詰められたカラムかに対するpgsql2shpでセグメンテーションフォールトが発生する

PostGIS 3.3.0alpha1

2022/05/21

このバージョンでは、PostgreSQL 11以上、GEOS 3.6以上、Proj 4.9以上が必要です。GEOS 3.9以上で追加機能 (多数の処理関数の精度機能)が有効になります。ST_MakesValidの機能強化には3.10以上が必要です。ST_ConcaveHullのGEOS実装の直接使用はGEOS 3.11以上が必要です。

ST_AlphaShapeとST_OptimalAlphaShapeのためにSFCGAL 1.4.1以上が必要です。

新規フラグの --enable-lto で、数学計算を改善します。ただし、プラットフォームによってはコンパイルエラーが発生する (BSDとMingW64で問題が発生しています)ため、この機能はデフォルトでは無効になっています。

有効にするには次のようにします。

./configure --enable-lto

大幅な変更

PostgreSQL 9.6と10への対応を終了します (Regina Obeさん)

WKT MULTOPOINTの出力を変更しました。全ての点が括弧で括られるようになりました。(Even Roualtさん)

GH674, ST_DumpAsPolygonsとST_Polygonにおけるジオメトリ評価と修正が無効になりました。速度は工場しますが、無効なポリゴンが生成される可能性があります。(Aliaksandr Kalenikさん)

性能強化

2861, フェイスの分割とマージを高速にするtopology.node(containing_face)へのインデックスを追加しました (Sandro Santilliさん)

2083, relation(element_id)とedge_data(abs_next*)へのインデックス追加でトポロジ関数ST_RemEdgeを高速化しました (Sandro Santilliさん)

5118, トポジオメトリのシーケンスジェネレータが欠落しているトポロジの削除を可能にしました (Sandro Santilliさん)

5111, トポロジでのMBRフェイスの計算が速くなりました (Sandro Santilliさん)

postgis_extensions_upgrade()で、リリース前を含むどのPostGISバージョンからでも対応できるようになりました (Sandro Santilliさん)

5040, postgis_sfcgal_full_versionを追加しました (Loïc Bartolettiさん)

GH655, GiST: 再起呼出しでより良いバランス木分割を行うようにしました (Darafei Praliaskouskiさん)

GH657, GiST: 実行しない解凍関数を呼ばないようにしました (Aliaksandr Kalenikさん)

4912, GiST: ジオグラフィ用のカラムでSTORAGE EXTERNALと指定されたものを使うとクラッシュする問題を修正 (Aliaksandr Kalenikさん)

GEOS 3.11以上でのST_ConcaveHullの直接使用 (Paul Ramseyさん, Martin Davisさん)

4574, GH678, #5121 --enable-ltoを使用することでリンク時最適化を可能にしました (Sergei Shoulbakov)

GH676, ST_Clipの高速化 (Aliaksandr Kalenikさん)

5135, PostgreSQL 15以上ではデフォルトでGiSTインデックス高速構築が有効になりました (Sergei Shoulbakovさん)

新機能

5116, Topologyエクスポート/インポートスクリプト (Sandro Santilliさん)

文字のように見えるジオメトリを生成するST_Letters (Paul Ramseyさん)

5037, postgis_sfcgal: ST_3DConvexHull (Loïc Bartolettiさん)

postgis_sfcgal: sfcgal_full_version - BOOSTとCGALのバージョンの報告 (Loïc Bartolettiさん)

GH659, MARC21/XMLの入出力関数ST_GeomFromMARC21, ST_AsMARC21 (Jim Jonesさん)

5132, GH683, sfcgal: ST_3DUnion集約関数 (Sergei Shoulbakovさん)

5143, SFCGALのST_AlphaShapeとST_OptimalAlphaShape (Loïc Bartolettiさん)

誤り修正

5100, PostgreSQL 15対応 (pg_atoiの削除) (Laurenz Albeさん)

5123, PostgreSQL 15対応 - PostgreSQL 15では、JSON型とJSON関数を公開しているので、インクルードしません (Regina Obeさん)

5088, メmvt_agg_transfnでのモリ破損 (Victor Collodさん)

5137, クエリ実行前に割り込みフラグをリセットするようにしました (Sergei Shoulbakovさん)

5148, ST_Clipがラスタのアラインメントとジオメトリのクリップに関して、よりロバストになりました (Sergei Shoulbakovさん)

PostGIS 3.2.0 (Olivier Courtin版)

2021/12/18

このバージョンでは、PostgreSQL 9.6以上、GEOS 3.6以上、Proj 4.9以上が必要です。追加機能にはGEOS 3.9以上 (ST_MakeValidの強化には GEOS 3.10以上)、Proj 6.1以上、PostgreSQL 14以上が必要です。

新しいPostgreSQL 14の高速インデックス構築で能率が低下するクエリがあるため、現実世界のクエリの本当の影響を見るユーザ試験が増えるまで、デフォルトでは機能を無効化することにしました。PostgreSQL 14以降を実行する場合には、次の操作を行うことで再有効化が可能です。

ALTER OPERATOR FAMILY gist_geometry_ops_2d USING gist
            ADD FUNCTION 11 (geometry)
            geometry_gist_sortsupport_2d (internal);

変更を戻すには次のようにします。

ALTER OPERATOR FAMILY gist_geometry_ops_2d using gist
        DROP FUNCTION 11 (geometry);

そして、GiSTインデックスの再構築を行います。

大幅な変更

5008, Empty geometries are not reported as being within Infinite distance by ST_DWithinで、空ジオメトリに対しては無限遠にあると正しく報告されない (Sandro Santilliさん)

4824, --without-wagyuビルドオプションを削除しました。WagyuはMVT対応のビルドでは必須になっているためです。

4933, topology.GetFaceByPointは、不正なエッジリンクを持つトポロジでは動作しなくなります。

4981, ST_StartPointが全てのジオメトリに対応しました。ラインストリング以外でNULLを返すことがなくなりました。

4149, ST_AsMVTGeomは、対象範囲に近い縮尺で元のジオメトリの詳細データを以前より多く保存するようになりました。以前の単純化の振る舞いが必要な場合には、事前にST_Simplifyを実行します。 (Darafei Praliaskouskiさん)

- Proj 4.9以上が必要です。

5000, 集約関数ST_AsMVTでのウィンドウ対応を、実際の利用場面が無く、でたらめな入力で異常終了するため、中止 (Paul Ramseyさん)

性能強化

4997, FlatGeobuf書式による入出力 (Björn Harrtellさん)

4575, トポロジのメタテーブルに対してGRANT SELECT ... TO PUBLICを実行 (Sandro Santilliさん)

2592, CreateTopologyにおいてSRID < 0でトポロジを定義できないようになりました (Sandro Santilliさん)

3232, 孤立ノードを異なるフェイスに移動できないようにしました (Sandro Santilliさん)

- トポロジ編集時にコレクションのTopoGeometryを考慮するようになりました (Sandro Santilliさん)

3248, TopoGeometryで使われている孤立エッジを削除できないようにしました (Sandro Santilli)

3231, TopoGeometryで使われている孤立ノードを削除できないようにしました (Sandro Santilliさん)

3239, 接続しているノードがTopoGeometryの定義に使われているエッジの修復をできないようにしました (Sandro Santilliさん)

4950, ValidateTopologyでノード用のcontaining_faceチェックの速度向上 (Sandro Santilliさん)

4945, ValidateTopologyで複数の外殻を持つフェイスのチェック (Sandro Santilliさん)

4944, ValidateTopologyで側面位置矛盾のチェック (Sandro Santilliさん)

3042, ValidateTopologyでエッジ接続のチェック (Sandro Santilliさん)

3276, ValidateTopologyでフェイスのMBRのチェック (Sandro Santilliさん)

4936, ValidateTopologyをバウンディングボックスで制限できるようにしました (Sandro Santilliさん)

4933, 巨大フェイス支配下のトポロジ構築の速度向上 (Sandro Santilliさん)

3233, ValidateTopologyがノードのcontaining_faceをチェックするようになりました (Sandro Santilliさん)

4830, ValidateTopologyが、エッジが両側のフェイスに囲まれているかをチェックするようになりました (Sandro Santilliさん)

4827, WKT入力でNaN座標値を許すようになりました (Paul Ramsey)

- ST_Value()がリサンプリングパラメータを受け付けるようになり、バイリニアのオプションを追加しました。 (Paul Ramseyさん)

3778, #4401, ST_BoundaryがTINで動作し、曲線を線形化しなくなりました (Aliaksandr Kalenikさん)

4881, #4884, 方向を保持するために、relationテーブル内の線のTopoGeometryに対応するedge_idの符号を格納 (Sandro Santilliさん)

4628, シェープファイルのロード時にANALYZEを無効にするオプションを追加 (Stefan Corneliu Petreaさん)

4924, 大きなマルチポイントでの動作がO(N^2) からO(NlogN)に早くなったST_RemoveRepeatedPoints (Aliaksandr Kalenikさん, Darafei Praliaskouskiさん)

4925, ポイントを見落とさないようST_DumpPointsを修正 (Aliaksandr Kalenikさん)

- 検索速度向上のためST_SRID(topogeometry)を無効にしました (Sandro Santilliさん)

2175, 同じ閉じた線をトポロジに追加する時に追加ノードを生成しないようにしました (Sandro Santilliさん)

4974, address_standardizer_data_usのパスを更新しました (AivenのJan Katinsさん, Regina Obeさん)

4975, PostGISアップグレードで一時テーブルを使わないように変更しました (AvienのJan Katinsさん)

4981, ST_StartPointがどのジオメトリもサポートするようになりました (Aliaksandr Kalenikさん)

4799, spatial_ref_sysにあるSRSをGeoJSONに取り込めるようになりました。

4986, PostgreSQL 14のGiSTインデックスが、ヒルベルトソートで早くなりました。 (Han Wangさん, Aliaksandr Kalenikさん, Darafei Praliaskouskiさん, Giuseppe Broccoloさん)

4949, 座標軸の交換の有無を渡すためにproj_normalize_for_visualizationを使います (Paul Ramseyさん)

- GH647, ST_PixelAsCentroids, ST_PixelAsCentroidをC関数の上に再実装 (Sergei Shoulbakovさん)

- GH648, ST_AsMVTGeomは現在より早いクリッピングを使っています (Aliaksandr Kalenikさん)

5018, pgsql2shpのWITH CTE節への基本的な対応 (Regina Obeさん)

5019, address_standardizer: pcre2対応の追加 (Paul Ramseyさん)

新機能

4923, topology.ValidateTopologyRelation (Sandro Santilliさん)

4933, topology.GetFaceContainingPoint (Sandro Santilliさん)

2175, ST_Scroll (Sandro Santilliさん)

4841, トポロジ行を早く取得するFindTopology (Sandro Santilliさん)

4869, レイヤ行を早く取得するFindLayer (Sandro Santilliさん)

4851, TopoGeom_addTopoGeom関数(Sandro Santilliさん)

ST_MakeValid(geometry, options)ではGEOS 3.10にある妥当性構築アルゴリズムの代替が可能になりました (Paul Ramseyさん)

GDALの多数のアルゴリズム (inverse weighted distance, average等)の一つを使ってサンプルポイント間でラスタセル内に値を入れる ST_InterpolateRaster() (Paul Ramseyさん)

GDALのアルゴリズムを使ってラスタ値からとうこうせんを生成するST_Contour() (Paul Ramseyさん)

ST_SetZ()/ST_SetM()でラスタから読み込んだデータを使ってジオメトリのZ値、M値を埋めるようになりました (Paul Ramseyさん)

新しいGUC postgis.gdal_vsi_options。これによって、VSIネットワークサービス上でのデータベース外ラスタが認証キー等を使ったアクセスが可能になりました。(Paul Ramseyさん)

入力ジオメトリの辺の集合を返すST_DumpSegments (Aliaksandr Kalenikさん)

4859, ST_Point, ST_PointZ, ST_PointM, ST_PointZMのSRIDパラメータを持つコンストラクタ (Paul Ramseyさん)

4808, ST_ClusterKMeansはmax_radius引数に対応しました。クラスタ数が不明だがクラスタのサイズが分かっている場合に使います。(Darafei Praliaskouskiさん)

PostGIS 3.2.0beta3

2021/12/04

このバージョンでは、PostgreSQL 9.6以上、GEOS 3.6以上、Proj 4.9以上が必要です。追加機能にはGEOS 3.9以上 (ST_MakeValidの強化には GEOS 3.10以上)、Proj 6.1以上、PostgreSQL 14以上が必要です。

新しいPostgreSQL 14の高速インデックス構築で能率が低下するクエリがあるため、現実世界のクエリの本当の影響を見るユーザ試験が増えるまで、デフォルトでは機能を無効化することにしました。PostgreSQL 14以降を実行する場合には、次の操作を行うことで再有効化が可能です。

ALTER OPERATOR FAMILY gist_geometry_ops_2d USING gist
        ADD FUNCTION 11 (geometry)
        geometry_gist_sortsupport_2d (internal);

変更を戻すには次のようにします。

ALTER OPERATOR FAMILY gist_geometry_ops_2d using gist
     DROP FUNCTION 11 (geometry);

そして、GiSTインデックスの再構築を行います。

PostGIS 3.2.0beta2 リリース以降の変更点は次の通りです。

大幅な変更/修正

5028, 混合ジオメトリ入力でST_AsFlatGeoBufが異常終了する (Björn Harrtellさん)

5029, ST_AsFlatGeobufのインデックス付き出力での破損 (Björn Harrtellさん)

5014, ST_TableFromFlatGeobufで異常終了する (Björn Harrtellさん)

ST_TableFromFlatGeobufをST_FromFlatGeobufToTableに名称変更 (Björn Harrtellさん)

PostgreSQL 14の高速インデックス構築はデフォルトで無効化しました。 (Paul Ramseyさん)

リリース 3.2.0beta2

リリース日: 2021/11/26

このバージョンでは、PostgreSQL 9.6以上、GEOS 3.6以上、Proj 4.9以上が必要です。追加機能にはGEOS 3.9以上 (ST_MakeValidの強化には GEOS 3.10以上)、Proj 6.1以上、PostgreSQL 14以上が必要です。PostGIS 3.2.0beta1 からの変更点は次の通りです。

大幅な変更/修正

5016, ローダ (shp2pgsq): LDFLAGSを見るようになりました (Greg Troxelさん)

5005, ジオメトリカラムが最初の列でない時にテーブルでST_AsFlatGeoBufが異常終了する (Björn Harrtellさん)

5017, topology.ValidateTopologyで"shell_check"テーブルが既に存在するエラーが常に出る (Sandro Santilliさん)

性能強化

5018, pgsql2shpのWITH CTE節への基本的な対応 (Regina Obeさん)

5019, address_standardizer: pcre2対応の追加 (Paul Ramseyさん)

GH647, ST_AsMVTGeomは現在より早いクリッピングを使っています (Aliaksandr Kalenikさん)

GH648, ST_PixelAsCentroids, ST_PixelAsCentroidをC関数の上に再実装 (Sergei Shoulbakovさん)

リリース 3.2.0beta1

リリース日: 2021/10/23

このバージョンでは、PostgreSQL 9.6以上、GEOS 3.6以上、Proj 4.9以上が必要です。追加機能にはGEOS 3.9以上 (ST_MakeValidの強化には GEOS 3.10以上)、Proj 6.1以上、PostgreSQL 14以上が必要です。

誤り修正と大幅な変更

5012, GEOS 3.10.0に対するレグレッションテストのクリーニング (Regina Obeさん, Paul Ramseyさん)

5000, 集約関数ST_AsMVTでのウィンドウ対応を、実際の利用場面が無く、でたらめな入力で異常終了するため、中止 (Paul Ramseyさん)

4994, shp2pgsqlが時々INSERTステートメントを入れそこなう (Sandro Santilliさん)

4990, getfacecontainingpointがi386では失敗する (Sandro Santilliさん)

5008, EMPTYオペランドを与えたST_DWithinが常にFALSEを返す (Sandro Santilliさん)

5002, liblwgeomがデフォルトで警告表示フラグを付けてビルドするようにすべき (Sandro Santilliさん)

性能強化

4997, FlatGeobuf書式による入出力 (Björn Harrtellさん)

リリース 3.2.0alpha1

リリース日: 2021/09/10

このバージョンでは、PostgreSQL 9.6以上、GEOS 3.6以上、Proj 4.9以上が必要です。追加機能にはGEOS 3.9以上 (より機能を多くするには GEOS 3.10以上)、Proj 6.1以上、PostgreSQL 14以上が必要です。

大幅な変更

#4824, `--without-wagyu`ビルドオプションを削除しました。WagyuはMVT対応のビルドでは必須になっているためです。

#4933, topology.GetFaceByPointは、不正なエッジリンクを持つトポロジでは動作しなくなります。

#4981, ST_StartPointが全てのジオメトリに対応しました。ラインストリング以外でNULLを返すことがなくなりました。

#4149, ST_AsMVTGeomは、対象範囲に近い縮尺で元のジオメトリの詳細データを以前より多く保存するようになりました。以前の単純化の振る舞いが必要な場合には、事前にST_Simplifyを実行します。 (Darafei Praliaskouskiさん)

Proj 4.9以上が必要です。

性能強化

#2592, CreateTopologyにおいてSRID > 0でトポロジを定義できないようになりました (Sandro Santilliさん)

#3232, 孤立ノードを異なるフェイスに移動できないようにしました (Sandro Santilliさん)

トポロジ編集時にコレクションのTopoGeometryを考慮するようになりました (Sandro Santilliさん)

#3248, TopoGeometryで使われている孤立エッジを削除できないようにしました (Sandro Santilli)

#3231, TopoGeometryで使われている孤立ノードを削除できないようにしました (Sandro Santilli)

#3239, 接続しているノードがTopoGeometryの定義に使われているエッジの修復をできないようにしました (Sandro Santilliさん)

#4950, ValidateTopologyでノード用のcontaining_faceチェックの速度向上 (Sandro Santilliさん)

#4945, ValidateTopologyで複数の外殻を持つフェイスのチェック (Sandro Santilliさん)

#4944, ValidateTopologyで側面位置矛盾のチェック (Sandro Santilliさん)

#3042, ValidateTopologyでエッジ接続のチェック (Sandro Santilliさん)

#3276, ValidateTopologyでフェイスのMBRのチェック (Sandro Santilliさん)

#4936, ValidateTopologyをバウンディングボックスで制限できるようにしました (Sandro Santilliさん)

#4933, 巨大フェイス支配下のトポロジ構築の速度向上 (Sandro Santilliさん)

#3233, ValidateTopologyがノードのcontaining_faceをチェックするようになりました (Sandro Santilliさん)

#4830, ValidateTopologyが、エッジが両側のフェイスに囲まれているかをチェックするようになりました (Sandro Santilliさん)

#4827, WKT入力でNaN座標値を許すようになりました (Paul Ramsey)

ST_Value()がリサンプリングパラメータを受け付けるようになり、バイリニアのオプションを追加しました。 (Paul Ramseyさん)

#3778, #4401, ST_BoundaryがTINで動作し、曲線を線形化しなくなりました (Aliaksandr Kalenikさん)

#4881, #4884, 方向を保持するために、relationテーブル内の線のTopoGeometryに対応するedge_idの符号を格納 (Sandro Santilliさん)

#4628, シェープファイルのロード時にANALYZEを無効にするオプションを追加 (Stefan Corneliu Petreaさん)

#4924, 大きなマルチポイントでの動作がO(N^2) からO(NlogN)に早くなったST_RemoveRepeatedPoints (Aliaksandr Kalenikさん, Darafei Praliaskouskiさん)

#4925, ポイントを見落とさないようST_DumpPointsを修正 (Aliaksandr Kalenikさん)

検索速度向上のためST_SRID(topogeometry)を無効にしました (Sandro Santilliさん)

#2175, 同じ閉じた線をトポロジに追加する時に追加ノードを生成しないようにしました (Sandro Santilliさん)

#4974, address_standardizer_data_usのパスを更新しました (AivenのJan Katinsさん, Regina Obeさん)

#4975, PostGISアップグレードで一時テーブルを使わないように変更しました (AvienのJan Katinsさん)

#4981, ST_StartPointがどのジオメトリもサポートするようになりました (Aliaksandr Kalenikさん)

#4799, spatial_ref_sysにあるSRSをGeoJSONに取り込めるようになりました。

#4986, PostgreSQL 14のGiSTインデックスが、ヒルベルトソートで早くなりました。 (Han Wangさん, Aliaksandr Kalenikさん, Darafei Praliaskouskiさん, Giuseppe Broccoloさん)

#4949, 座標軸の交換の有無を渡すためにproj_normalize_for_visualizationを使います (Paul Ramseyさん)

新機能

#4923, topology.ValidateTopologyRelation (Sandro Santilliさん)

#4933, topology.GetFaceContainingPoint (Sandro Santilliさん)

#2175, ST_Scroll (Sandro Santilliさん)

#4841, トポロジ行を早く取得するFindTopology (Sandro Santilliさん)

#4869, レイヤ行を早く取得するFindLayer (Sandro Santilli)

#4851, TopoGeom_addTopoGeom関数(Sandro Santilliさん)

ST_MakeValid(geometry, options)ではGEOS 3.10にある妥当性構築アルゴリズムの代替が可能になりました (Paul Ramseyさん)

GDALの多数のアルゴリズム (inverse weighted distance, average等)の一つを使ってサンプルポイント間でラスタセル内に値を入れる ST_InterpolateRaster() (Paul Ramseyさん)

GDALのアルゴリズムを使ってラスタ値からとうこうせんを生成するST_Contour() (Paul Ramseyさん)

ST_SetZ()/ST_SetM()でラスタから読み込んだデータを使ってジオメトリのZ値、M値を埋めるようになりました (Paul Ramseyさん)

新しいGUC postgis.gdal_vsi_options。これによって、VSIネットワークサービス上でのデータベース外ラスタが認証キー等を使ったアクセスが可能になりました。(Paul Ramseyさん)

入力ジオメトリの辺の集合を返すST_DumpSegments (Aliaksandr Kalenikさん)

#4859, ST_Point, ST_PointZ, ST_PointM, ST_PointZMのSRIDパラメータを持つコンストラクタ (Paul Ramseyさん)

#4808, ST_ClusterKMeansはmax_radius引数に対応しました。クラスタ数が不明だがクラスタのサイズが分かっている場合に使います。(Darafei Praliaskouskiさん)

リリース 3.1.0beta1

リリース日: 2020/12/09

3.1.0alpha2からの変更のみ挙げています。本バージョンではPostgreSQL 9.6-13とGEOS >= 3.6+が必要です。Proj6+, PostgreSQL 12+, GEOS 3.9.0devを使用する場合に追加機能と機能強化が有効になります。

大幅な変更

4214, 非推奨関数 ST_Count(tablename,...), ST_ApproxCount(tablename, ...) ST_SummaryStats(tablename, ..), ST_Histogram(tablename, ...), ST_ApproxHistogram(tablename, ...), ST_Quantile(tablename, ...), ST_ApproxQuantile(tablename, ...)を削除。(Darafei Praliaskouskiさん)

性能強化

4801, ST_ClusterKMeansがPOINT[Z]Mジオメトリの重みに対応しました (Darafei Praliaskouskiさん)

4804, ST_ReducePrecision (GEOS 3.9+)で妥当な精度の低下が可能になりました (Paul Ramseyさん)

4805, _ST_SortableHashは、PostgreSQLの並列ソートの能率に関する問題の回避法が出ています。テーブルが巨大な場合には、ORDER BY geomでなくORDER BY _ST_SortableHash(geom) を使います。(Darafei Praliaskouskiさん)

4625, 統計的相関が計算されるようになりました。BRINインデックスで使えるようにするにはANALYZEを実行します。 (Darafei Praliaskouskiさん)

ST_GeomFromGML()内におけるurn:ogc:def:crs:EPSGのaxis order問題を修正 (Even Roualtさん)

リリース 3.1.0alpha3

リリース日: 2020/11/19

3.1.0alpha2からの変更のみ挙げています。本バージョンではPostgreSQL 9.6-13とGEOS >= 3.6+が必要です。Proj6+, PostgreSQL 12+, GEOS 3.9.0devを使用する場合に追加機能と機能強化が有効になります。

大幅な変更

4737, protobuf-cの必須バージョンを1.1.0に突然ながら変更 (Raúl Marínさん) 必須バージョンに合っていないか明示的に無効 (--without-protobuf)にした場合にコンフィギュアが失敗します。

4258, postgis_sfcgalのPostGISから独自ライブラリファイルへの分離 (Regina Obe)

新機能

4698, ST_AsEWKTへのprecisionパラメータの追加 (Raúl Marínさん)

ST_Union, ST_UnaryUnion, ST_Difference, ST_Intersection, ST_SymDifference, ST_Subdivideへの任意パラメータgridSizeの追加、GEOS 3.9が必要 (Sandro Santilliさん)

性能強化

4789, 多数の穴を持つ面TopoGeometryをTopoJSONで出力する際の速度向上 (Sandro Santilli)

4758, トポロジのノード作成のロバスト性の向上 (Sandro Santilliさん)

ST_Subdivideを割り込み可能にしました (Sandro Santilliさん)

4660, 浮動小数点数/座標値の印字を変更 (Raúl Marínさん) - 最短表現を使用します (十分に往復保証される条件付きです) - 絶対値で1e-8未満となる値に指数表記を使用します。以前は絶対値で1e-12未満は0と出力し、それより大きい場合は固定小数点形式です。 - 絶対値で1e+15を超える値に指数表記を使用します (同じ振る舞い)。 - 精度パラメータは指数表記に影響を与えます (以前は[5-8]に固定)。 - 全ての出力関数は求められる精度を尊重します (制限がありません)。 - デフォルトの精度は同じです (GeoJSONは9で、その他は15)。

4729, WKT/KML: 浮動小数点数を直接文字列バッファに書き込むよう変更 (Raúl Marínさん)

4533, BOX型で標準の座標印字システムを使用するよう変更 (Raúl Marínさん)

4686, 可能な時にジオグラフィの伸張を避けるよう変更 (Raúl Marínさん) ジオメトリがバウンディングボックスとST_BoundingDiagonalとの関係で完全に内側にあるか完全に外側にある場合に、ANALYZE, _ST_PointOutside, postgis_geobbox, ST_CombineBbox(box2d, geometry), ST_ClipByBox2Dに影響が出ます。

4741, インデックスを使う必要がある場合にはST_PointInsideCircleは使わず、ST_DWithinを代わりに使ってください。文書を調整 (Darafei Praliaskouski)

4737, ST_AsMVTの、特に並列処理を含むクエリで、能率改善とメモリ使用削減 (Raúl Marínさん)

4746, シリアル化プロセスで小さな最適化 (Raúl Marínさん)

4719, ST_Intersection(geometry,raster)でSRID不一致とスキーマ修飾の不一致で早期に失敗させるよう変更。 (Regina Obeさん)

4784, ST_CollectionExtract(geometry)に、最大次元の要素を抽出するデフォルトの振る舞いを追加。 (Paul Ramseyさん)

誤り訂正

4691, 空ジオメトリでGiSTインデックスを生成する際にセグメンテーション違反が出るのを修正 (Raúl Marínさん)

悪いWKB入力 (Oracleタイプ)と不正なWKBのユニットテストの処理を修正。不正なWKBの処理ではメモリリークを除きました。 (Paul Ramsey)

4740, geography_distance_treeでの値の丸めをgeography_distance上での実行と同じに変更 (Raúl Marínさん, Paul Ramsey, Regina Obeさん)

4739, postgis_oidを使う全ての関数について内部キャッシュの初期化を確実に実行するよう更新 (Raúl Marín)

4767, #4768, #4771, #4772, 不正なWKBのパース時のSEGFAULTが出るのを修正 (Raúl Marínさん)

4769, st_addbandでSEGFAULTが出るのを修正 (Raúl Marínさん)

4790, 同一の頂点を持つ場合のST_3dintersects計算を修正 (Nicklas Avénさん)

4742, TigerジオコーダのアップグレードでTigerを2018年版に戻る (Regina Obeさん)

3372, TopoElementArrayがNULLになれない - ドメイン制約の変更 (Regina Obeさん)

リリース 3.1.0alpha2

リリース日: 2020/07/18

3.1.0alpha1からの変更のみ挙げています。本バージョンではPostgreSQL 9.6-13とGEOS >= 3.6+が必要です。Proj6+, PostgreSQL 12+, GEOS 3.9.0devを使用する場合に追加機能と機能強化が有効になります。

新機能

4656, 暗黙的にGeoJSONを食べさせるためのgeojson_text::geometryのキャスト (Raúl Marínさん)

4687, GEOS MaximumInscribedCircleの公開 (Paul Ramseyさん)

4710, ST_ClusterKMeansが3次元ジオメトリで動作するよう変更 (Darafei Praliaskouskiさん)

性能強化

4675, topology.GetRingEdgesがCでの実装に変更 (Sandro Santilliさん)

4681, ST_GetFaceGeometry: 破損情報の表示 (Sandro Santilliさん)

4651, ST_Simplify: 全く削除されないなら複製しないよう変更 (Raúl Marínさん)

4657,トーストからの復帰を可能な限り避ける (Paul Ramseyさん)

4490, 関数のコストの微調整 (Raúl Marínさん)

4672, getSRSbySRIDとgetSRIDbySRSのキャッシュ (Raúl Marínさん)

4676, トーストされたジオメトリをヘッダだけを読むために伸張を回避しました (Raúl Marínさん) PostgreSQLポイント型へのキャストの最適化 (Raúl Marínさん)

4620, 内部のwagyuを0.5.0に更新 (Raúl Marínさん)

4623, varlena型を返す関数の最適化 (Raúl Marínさん)

4677, 異なるキャッシュタイプ間でのgserializedオブジェクトの共有 (Raúl Marínさん)

MSVCコンパイラによるコンパイルの修正と一切合切の標準化 (Loïc Bartolettiさん)

誤り訂正

4652, ST_GeomFromGMLの複数のメモリ関係の誤りを訂正 (Raúl Marínさん)

4661, デフォルト以外のスキーマでのspatial_ref_sysへのアクセスの修正 (Raúl Marínさん)

4670, ST_AddPoint: 正位置が要求される時の誤りを修正 (Raúl Marínさん)

4699, ST_Union(raster, otherarg)へのNULL入力時に異常終了 (Jaime Casanovaさん, 2ndQuadrant)

4716, configureスクリプト内のpkg-configの複数の問題を修正 (Raúl Marínさん)

リリース 3.1.0alpha1

リリース日: 2020/02/01

このバージョンにはPostgreSQL 9.6+-13 と GEOS >= 3.6+ が必要です。 Proj6+, PostgreSQL 12+, GEOS 3.8.0 で追加機能と機能強化が有効になります。

大幅な変更

バージョン出力をsvn番号からgitハッシュに変更 (Sandro Santilliさん, Raúl Marínさん)

4577, PostgreSQL 9.5対応を削除 (Raúl Marínさん)

4579, postgis_proc_set_search_path.plを削除 (Raúl Marínさん)

4601, ST_TileEnvelopeのシグネチャを変更。

3057, ST_Force3D, ST_Force3DZ, ST_Force3DM, ST_Force4Dのシグネチャを変更。

新機能

4601, ST_TileEnvelopeへのマージン引数の追加 (Yuri Astrakhanさん)

2972, pgsql2shpに消音モード (-q)を追加 (Kristian Thyさん)

4617, configureに`--without-phony-revision`スイッチの追加 (Raúl Marínさん)

3057, Force3D*とForce4Dの任意パラメータ (Kristian Thyさん)

4624, 平面のタイルを生成するために集合を返す関数ST_HexagonGridとST_SquareGrid (Paul Ramseyさん)

性能強化

4539, libmのインクルードを統一しました (Raúl Marínさん)

4569, 不明なSRIDを持つジオメトリのSRIDのtypmodを持つカラムへの挿入を可能にしました (Paul Ramseyさん)

4149, ST_Simplify(geom, 0)がO(N)になりました。ST_Affine (ST_Translate, ST_TransScale, ST_Rotate)を静的化されました。ST_SnapToGridが最適化されました。(Darafei Praliaskouskiさん)

4574, リンク時最適化が有効になりました (Darafei Praliaskouskiさん)

4578, BRIN関数にparallelismとcostプロパティを追加 (Raúl Marínさん)

4473, yacc警告を消す (Raúl Marínさん)

4589, "--enable-debug"なしでビルドする際にCのassertを無効化 (Raúl Marínさん)

4543, 倍精度浮動小数点数の出力にRyuアルゴリズムの導入 (Raúl Marínさん)

4626, libxml2のpkg-configに対応 (Bas Couwenbergさん)

4615, GeoJSON出力の速度向上 (Raúl Marínさん)

リリース 3.0.0

リリース日: 2019/10/20

このバージョンでは PostgreSQL 9.5から12までの間、GEOS 3.6以上がそれぞれ必要です。Proj6+、PostgreSQL 12、GEOS 3.8.0を使っている場合には追加機能と機能強化が有効になります。

新機能

2902, postgis_geos_noop (Sandro Santilliさん)

4128, ST_AsMVTの地物IDへの対応 (Stepan Kuzminさん)

4230, SP-GiSTとGiSTのN次元ボックスのoverlaps, contains, within, equalsへの対応 (Université Libre de Bruxelles (ULB)のEsteban ZimányiさんとArthur Lesuisseさん, Darafei Praliaskouskiさん)

4171, ST_3DLineInterpolatePoint (Julien Cabiecesさん, Vincent Moraさん)

4311, MVTポリゴンの評価にWAGYUを導入しました。利用するにはC++11コンパイラが必要で、CXXFLAGS (CFLAGSでなく)を使います。この選択肢を無効にして2.5からの挙動を維持するには`--without-wagyu`を追加します (Raúl Marínさん)

1833, ST_AsGeoJSON(row)での完全なGeoJSON地物の生成 (Joe Conwayさん)

3687, 暗黙的なGeoJSON生成のためのJSON (ジオメトリ)とJSONB(ジオメトリ)のキャスト (Paul Ramseyさん)

4198, SFCGAL関数のST_ConstrainedDelaunayTrianglesの追加 (Darafei Praliaskouskiさん)

大幅な変更

4267, GEOSの最小バージョンを3.6に変更 (Regina Obeさん, Darafei Praliaskouskiさん)

3888, ラスタ機能を別のエクステンションに分離 (Sandro Santilliさん)

3807, エクステンションのライブラリファイルにマイナーバージョンは含まれなくなりました。古い振る舞いが必要な場合にはコンフィギュレーション時に--with-library-minor-versionオプションを指定します。(Regina Obeさん)

4230, 現在ではN次元ボックスの演算子 (overlaps, contains, within, equals)は、どちらのオペランドに存在しない次元を確認していません。アップグレード後にN次元インデックスのREINDEXを実行して下さい (Darafei Praliaskouskiさん)

4229, PostgreSQL 9.5未満への対応を終了しました (Darafei Praliaskouskiさん)

4260, liblwgeomヘッダファイルがインストールされなくなりました。あなたのプロジェクトでヘッダファイルに依存している場合には、librttopoを代わりに使用して下さい (Darafei Praliaskouskiさん)

4258, ST_Area, ST_Distance, ST_Intersection, ST_Difference, ST_Union, ST_Intersects, ST_3DIntersects, ST_3DDistanceのSFCGAL対応を削除し、postgis.backendスイッチを削除しました (Darafei Praliaskouski)

4267, Proj 6の非推奨APIを有効にして使用しています (Darafei Praliaskouskiさん, Raúl Marínさん)

4267, SFCGALの最小バージョンを1.3.1に変更 (Darafei Praliaskouskiさん)

4331, ST_3DMakeBoxは現在は非常に小さいボックスを返していた場合にエラーを返すように変更 (Regina Obeさん)

4342, ST_AsGeoJSONとST_AsKMLのバージョンを付ける形式を削除しました (Paul Ramseyさん)

4356, ST_Accumを削除しました。array_aggを代わりに使います (Darafei Praliaskouskiさん)

4414, address_standardizerライブラリにバージョン番号が入るよう変更 (Raúl Marín)

4334, 名前を変えた関数パラメータに関係するアップグレードの問題を修正 (Raúl Marínさん)

4442, raster2pgsqlはNODATAタイルを飛ばす。何らかの理由でデータベースに保存する場合には-kオプションを使います。 (Darafei Praliaskouski)

4433, 32ビットのハッシュの修正 (インデックスの再インデックスが必要) (Raúl Marín)

3883, ソートではヒルベルト曲線と省略比較を使用しています。B木インデックスを使っている場合にはREINDEXの実行が必要です (Darafei Praliaskouskiさん)

性能強化

4341, ST_Intersects等で補助するインデックスを提供するためのメカニズムに、PostgreSQL 12以上の「補助関数」APIを使用してSQLインラインを置き換えました。

4330, 出力が中間プロセスにパイプで流されている時にpostgis_restoreがメモリ不足になる問題 (Hugh Ranalliさん)

4322, Proj 6+ APIへの対応、より精度の高い測地系変換、およびWKT投影への対応

4153, ST_Segmentizeは現在は線分を比例して分割します。 (Darafei Praliaskouskiさん)

4162, ST_DWithinの文書にテーブルへのジオメトリと半径との格納されている場合の例を記述しました。 (Darafei Praliaskouskiさん, GitHubユーザBoscopさん)

4161, #4294, ST_AsMVTGeom: 解像度より小さいジオメトリのショートカット (Raúl Marínさん)

4176, ST_IntersectsがGEOMETRYCOLLECTIONに対応するよう変更 (Darafei Praliaskouskiさん)

4181, ST_AsMVTGeom: 評価によるタイプの変更を回避します (Raúl Marínさん)

4183, ST_AsMVTGeom: 単純化後に不正なジオメトリを削除します (Raúl Marínさん)

4196, postgis_extensions_upgrade()がパッケージ化されていないエクステンションのパッケージ化を行うように変更 (Sandro Santilliさん)

4215, ST_DumpAsPolygonsでの浮動小数点数の比較を使用 (Darafei Praliaskouskiさん)

4155, ST_LocateBetweenとST_LocateBetweenElevationsでのGEOMETRYCOLLECTION, POLYGON, TIN, TRIANGLEへの対応 (Darafei Praliaskouskiさん)

2767, AddRasterConstraintの任意パラメータの文書 (Sunveer Singhさん)

4244, BOX2D_outでのアラインメントされていないメモリを回避 (Raúl Marínさん)

4139, 次元混合のN次元インデックスが正しい木を構築できるよう変更 (Darafei Praliaskouskiさん, Arthur Lesuisseさん, Andrew Gierthさん, Raúl Marínさん)

4262, ST_LineToCurveのMULTISURFACEに適合している旨の記述 (Steven Ottensさん)

4276, ST_AsGeoJSONの文書の更新 (Darafei Praliaskouskiさん)

4292, ST_AsMVT: JSONのパースで小数点付き数値を倍精度浮動小数点数とする (Raúl Marínさん)

4300, ST_AsMVTGeom: 常に最も単純なジオメトリを返す (Raúl Marínさん)

4301, ST_Subdivide: 境界と一致しかける座標値で無限ループが発生するのを修正 (Darafei Praliaskouskiさん)

4289, ST_AsMVTGeom: クリップ前に座標空間の変換を行うように変更 (Raúl Marínさん)

4272, 統計情報計算不能時のNOTICEメッセージの改善 (Raúl Marínさん)

4313, #4307, PostgreSQL 12互換性 (Laurenz Albeさん, Raúl Marínさん)

4299, #4304, ST_GeneratePointsは現在はVOLATILE属性が付いていて、seedパラメータが追加されているものはIMMUTABLE属性が付いています (Mike Tavesさん)

4278, ST_3DDistanceとST_3DIntersectsは現在は立体としてのTINと立体としてのPOLYHEDRALSURFACEに対応しています (Darafei Praliaskouskiさん)

4348, ST_AsMVTGeom (GEOS): 常に検証を行うようにしました (Raúl Marínさん)

4295, ST_Overlaps, ST_Contains, ST_ContainsProperly, ST_Covers, ST_CoveredBy, ST_Crosses, ST_Touches, ST_Disjoint, ST_Relate, ST_EqualsでGEOMETRYCOLLECTIONを使用可能に (Esteban Zimányiさん)

4340, ST_Union集約関数はジオメトリ1GB以上でも処理できるようになっています (Darafei Praliaskouskiさん)

4378, TIN入力をGEOSバックエンドの関数に渡すようにしました (Darafei Praliaskouskiさん)

4368, LWGEOM構造体の余分なパディングが最小になるようメンバの並び替え (Raúl Marínさん)

4141, トポロジエクステンション内の行数処理にuint64を使用するよう変更 (Raúl Marínさん)

4412, NODATA=NaNのラスタの入力に対応しました (Darafei Praliaskouskiさん)

4413, raster2pgsql -t auto で、ラスタタイルサイズはGeoTIFFブロックサイズに従います (Darafei Praliaskouskiさん)

4422, Python 3の準備のためPython 2コードの訂正 (Christian Claussさん)

4352, PostgreSQL 12以上でCREATE OR REPLACE AGGREGATEを使用するよう変更 (Raúl Marín)

4394, ジオメトリの等価系演算子をFULL OUTER JOINで利用できるよう変更 (Darafei Praliaskouskiさん)

4441, GiSTをマルチカラムインデックスに対してペナルティが有効になるように、かつシングルカラムインデックスでより速くなるようにしました (Darafei Praliaskouskiさん)

4403, shp2pgsqlのコピーモード (-D)での座標値変換機能への対応 (Regina Obeさん)

4410, SRID不一致のエラーメッセージを従来より説明になるよう変更 (Darafei Praliaskouskiさん)

4399, 全ての出力関数でTINとTRIANGLEに対応 (Darafei Praliaskouskiさん)

3719, 線形化で弧あたりの線分最小数設定の強制 (Dan Bastonさん / City of Helsinki, Raúl Marínさん)

4277, RFC7946により、ST_GeomFromGeoJSONはデフォルトでSRID=4326を設定するようにし、また、4326以外から出力する場合にはST_AsGeoJSONは出力JSONにSRIDを設定するようにしています。 (Darafei Praliaskouskiさん)

3979, 往復関数postgis_sfcgal_noop() (Lucas C. Villa Realさん)

4328, 2次元TIN用のST_3DIntersects (Darafei Praliaskouskiさん)

4509, Tiger 2019のジオコーダの更新 (Regina Obeさん)

リリース 3.0.0rc2

リリース日: 2019/10/13

PostgreSQL+JITでコンパイルする場合にはLLVM 6以上が必要です。

このリリースに対応しているPostgreSQLのバージョンはPostgreSQL 9.5からPostgreSQL 12、GEOS 3.6以上です。Proj6以上とPostgreSQL 12を使うと追加機能が有効になります。GEOS 3.8以上を使うと性能が良くなります。

主なハイライト

4534, lwcurvepoly_from_wkb_stateのリークを修正 (Raúl Marínさん)

4536, lwcollection_from_wkb_stateのリークを修正 (Raúl Marínさん)

4537, WKTコレクションのパーサのリークを修正 (Raúl Marínさん)

4535, WKB: バッファオーバーフローを回避 (Raúl Marínさん)

リリース 3.0.0rc1

リリース日: 2019/10/08

PostgreSQL+JITでコンパイルする場合にはLLVM 6以上が必要です。

このリリースに対応しているPostgreSQLのバージョンはPostgreSQL 9.5からPostgreSQL 12、GEOS 3.6以上です。Proj6以上とPostgreSQL 12を使うと追加機能が有効になります。GEOS 3.8以上を使うと性能が良くなります。

主なハイライト

4519, getSRIDbySRSがクラッシュするのを訂正 (Raúl Marínさん)

4520,C++ライブラリを検出しているときに清浄な環境で行うように変更 (Raúl Marínさん)

集約関数ST_Union()のシグネチャを再格納して、不要な集約関数のシグネチャを削除しました。また、能率/サイズの機能強化をやり直し、ST_Union()で配列型を使用しないようにし、できれば、配列サイズの制限を避けるようにしました。 (Paul Ramseyさん)

リリース 3.0.0beta1

リリース日: 2019/09/28

PostgreSQL+JITでコンパイルする場合にはLLVM 6以上が必要です。

このリリースに対応しているPostgreSQLのバージョンはPostgreSQL 9.5からPostgreSQL 12、GEOS 3.6以上です。Proj6以上とPostgreSQL 12を使うと追加機能が有効になります。GEOS 3.8以上を使うと性能が良くなります。

主なハイライト

4492, ST_Simplifyが第3パラメータの値を無視するのを訂正 (Raúl Marínさん)

4494, ST_Simplify出力に古くなったbboxが含まれるのを修正 (Raúl Marínさん)

4493, ST_RemoveRepeatedPoints出力に古くなったbboxが含まれるのを修正 (Raúl Marínさん)

4495, ST_SnapToGrid出力に古くなったbboxが含まれるのを修正 (Raúl Marínさん)

4496, ST_Simplify(TRIANGLE)で要求があるなら小さい面を保存するように変更 (Raúl Marínさん)

4501, スーパーユーザでなくてもpostgis_tiger_geocoderをインストールできるようにする (Regina Obeさん)

4503, デカルトbboxの計算の速度向上 (Raúl Marínさん)

4504, shp2pgsql -Dがスキーマ修飾テーブルで動作しない (Regina Obeさん)

4505, GEOSとジオメトリとの相互変換の速度向上 (Dan Bastonさん)

4507, GEOS 3.8+のGEOSMakeValidとGEOSBuildAreaの使用 (Dan Bastonさん)

4491, ST_RemoveRepeatedPointsの速度向上 (Raúl Marínさん)

4509, Tiger 2019のジオコーダの更新 (Regina Obeさん)

4338, センサスのブロックレベルデータ (tabblock テーブル)がロードできない (Regina Obeさん)

リリース 3.0.0alpha4

リリース日: 2019/08/11

PostgreSQL+JITでコンパイルする場合にはLLVM 6以上が必要です。

このリリースに対応しているPostgreSQLのバージョンはPostgreSQL 9.5からPostgreSQL 12、GEOS 3.6以上です。Proj6以上とPostgreSQL 12を使用している場合には、追加機能が有効になります。

主なハイライト

4433, 32ビットのハッシュの修正 (インデックスの再インデックスが必要) (Raúl Marín)

4445, geometry_leの誤り修正 (Raúl Marínさん)

4451, gserialized_max_header_sizeの計算の訂正 (Raúl Marínさん)

4450, ST_GeometryTypeの速度向上 (Raúl Marínさん)

4452, ST_TileEnvelope()の追加 (Paul Ramseyさん)

4403, shp2pgsqlのコピーモード (-D)での座標値変換機能への対応 (Regina Obeさん)

4417, spatial_ref_sysの新しいエントリでの更新 (Paul Ramseyさん)

4449, ST_X, ST_Y, ST_Z, ST_Mの速度向上 (Raúl Marínさん)

4454, _ST_OrderingEqualsの速度向上 (Raúl Marínさん)

4453, ST_IsEmptyの速度向上 (Raúl Marínさん)

4271, pg_upgrade後にpostgis_extensions_upgrade()も更新するように変更 (Raúl Marínさん)

4466, _postgis_gserialized_statsの未定義のふるまいを訂正 (Raúl Marínさん)

4209, pgsql2shpでのNULLジオメトリ値の取り扱い (Paul Ramseyさん)

4419, mvt/geobufの有効化/無効化のためのprotobuf版の使用 (Paul Ramsey)

4437, シェープローダ/ダンパでのPOINT EMPTYの取り扱い (Paul Ramseyさん)

4456, Rasbery Pi 32ビットのテスト用のJenkinsボットの追加 (Bruce Rindahlさん,Regina Obeさん)

4420, address_standardizerエクステンションの更新パスが存在しない (Regina Obeさん)

リリース 3.0.0alpha3

リリース日: 2019/07/01

PostgreSQL+JITでコンパイルする場合にはLLVM 6以上が必要です。

このリリースに対応しているPostgreSQLのバージョンはPostgreSQL 9.5からPostgreSQL 12、GEOS 3.6以上です。

主なハイライト

4414, address_standardizerライブラリにバージョン番号が入るよう変更 (Raúl Marín)

4352, PostgreSQL 12以上でCREATE OR REPLACE AGGREGATEを使用するよう変更 (Raúl Marín)

4334, パラメータ名変更に関連するアップグレードの問題を修正 (Raúl Marín)

4388, AddRasterConstraints: 制約を生成する時にNULLを無視するように変更 (Raúl Marín)

4327, getenvの結果をpfreeに与えるのを回避 (Raúl Marín)

4406, ジオハッシュの復号時に不正な文字があるとエラーを投げるように変更 (Raúl Marínさん)

4429, PROJ6を使うとリソースにリークが発生する問題の回避 (Raúl Marín)

4372, PROJ6 速度向上 (Raúl Marín)

3437, ポイントを引数にとるST_Intersectsの速度向上 (Raúl Marín)

4438, 拡張フラグ領域に対応するためシリアル化を変更 (Paul Ramseyさん)

4443, WagyuのコンフィギュレーションでCPPFLAGSを削除するよう修正 (Raúl Marínさん)

4440, FDWの型の検索に失敗する (Paul Ramseyさん)

4442, raster2pgsqlはNODATAタイルを飛ばす。何らかの理由でデータベースに保存する場合には-kオプションを使います。 (Darafei Praliaskouski)

4441, GiSTをマルチカラムインデックスに対してペナルティが有効になるように、かつシングルカラムインデックスでより速くなるようにしました (Darafei Praliaskouskiさん)

リリース 3.0.0alpha2

リリース日: 2019/06/02

PostgreSQL+JITでコンパイルする場合にはLLVM 6以上が必要です。

このリリースに対応しているPostgreSQLのバージョンはPostgreSQL 9.5からPostgreSQL 12、GEOS 3.6以上です。

主なハイライト

#4404, 補助関数の選択性問題の修正 (Paul Ramseyさん)

#4311, Wagyuをポリゴンの評価に関する既定の選択肢にしました。この際、C++11コンパイラが必要で、CXXFLAGSを使います (CFLAGSではない)。MVT対応でビルドする場合に有効になるだけです。`--without-wagyu`で無効にして、2.5の動作を維持できます。 (Raul Marinさん)

#4198, SFCGAL関数ST_ConstrainedDelaunayTrianglesの追加 (Darafei Praliaskouskiさん)

リリース 3.0.0alpha1

リリース日: 2019/05/26

PostgreSQL+JITでコンパイルする場合にはLLVM 6以上が必要です。

このリリースに対応しているPostgreSQLのバージョンはPostgreSQL 9.5からPostgreSQL 12、GEOS 3.6以上です。

新機能

Proj6以上を実行している場合には追加機能が有効になります

詳細はソースツリーに含まれるNEWSファイルをご覧下さい。

リリース 2.5.0

発売日: 2018/09/23

PostgreSQL+JITでコンパイルする場合にはLLVM 6以上が必要です。

このリリースに対応しているPostgreSQLのバージョンはPostgreSQL 9.5からPostgreSQL 12 (開発中)、GEOS 3.5以上です。

新機能

#1847, PostgreSQL 11以上のSP-GiSTの2次元と3次元の対応 (Esteban ZimányiさんとArthur Lesuisseさん (以上Université Libre de Bruxelles (ULB)から)、Darafei Praliaskouskiさん)

#4056, ST_FilterByM (Nicklas Avénさん)

#4050, ST_ChaikinSmoothing (Nicklas Avénさん)

#3989, ST_Buffer single sided option (Stephen Knoxさん)

#3876, ST_Angle function (Rémi Curaさん)

#3564, ST_LineInterpolatePoints (Dan Bastonさん)

#3896, PostGIS_Extensions_Upgrade() (Regina Obeさん)

#3913, パッケージに含まれていないものからのエクステンション生成時のアップグレード (Sandro Santilliさん)

#2256, _postgis_index_extent() for extent from index (Paul Ramseyさん)

#3176, Add ST_OrientedEnvelope (Dan Bastonさん)

#4029, Add ST_QuantizeCoordinates (Dan Bastonさん)

#4063, ST_Scaleの仮想原点任意引数 (Paul Ramseyさん)

#4082, ST_BandFileSizeとST_BandFileTimestampの追加とST_BandMetadataの拡張 (Even Rouaultさん)

#2597, Add ST_Grayscale (Bborie Parkさん)

#4007, Add ST_SetBandPath (Bborie Parkさん)

#4008, Add ST_SetBandIndex (Bborie Parkさん)

大幅な変更

複数の古いバージョンからのアップデートスクリプトは現在は、全て単一のアップグレードスクリプトからのシンボリックリンクになりました (Sandro Santilliさん)

#3944, EPSG第9.2版へのアップデート (Even Rouaultさん)

#3927, ST_AsMVTのパラレル実装

#3925, MVT生成前のジオメトリの簡略化で地図のグリッドセルサイズを使うようにしました

#3899, 空ジオメトリおよび同じ接頭辞のジオメトリについてのB木のソートの並び順は、現在は、定義されています (Darafei Praliaskouskiさん)

#3864, POINTジオメトリのソートの効率改善 (Darafei Praliaskouskiさん)

#3900, GCC警告の修正、make -jが動作します (Darafei Praliaskouskiさん) - TopoGeo_addLinestringの堅牢性の改善 (Sandro Santilliさん) #1855, #1946, #3718, #3838

#3234, 空ポイントをトポロジのノードとして追加するのを禁止しました (Sandro Santilliさん)

#1014, ジオメトリがハッシュ可能になり、共通テーブル式のシグネチャに直接使えるようになりました (Paul Ramseyさん)

#3097, ST_Split()でMULTILINESTRINGで刃ができるようにしました (Paul Ramseyさん)

#3942, JSON-C 0.13以上でプライベートのヘッダを取り込まないように変更 (Björn Esserさん)

#3954, ST_GeometricMedianがポイントの重みに対応しました (Darafei Praliaskouskiさん)

#3965, #3971, #3977, #4071 ST_ClusterKMeansの再記述: 初期化改善、収束の高速化、K=2でも高速化 (Darafei Praliaskouskiさん)

#3982, ST_AsEncodedPolylineがLINESTRING EMPTYとMULTIPOINT EMPTYに対応しました (Darafei Praliaskouskiさん)

#3986, ST_AsTextに桁数を制限するための第2引数が導入されました (Marc Ducobuさん, Darafei Praliaskouskiさん)

#4020, BOX3Dからジオメトリへのキャストで、正しくつながった多面体サーフェイスが返るようになりました (Matthias Bayさん)

#2508, ST_OffsetCurveがジオメトリコレクションで動作するようになりました (Darafei Praliaskouskiさん)

#4006, ST_GeomFromGeoJSONの入力としてjsonとjsonbに対応するようになりました (Paul Ramseyさん, Regina Obeさん)

#4038, ST_Subdivideでジオメトリ分割のためのピボット選択で入力頂点を再利用するようにしました (Darafei Praliaskouskiさん)

#4025, #4032 ST_ClosestPointOfApproach, ST_DistanceCPAおよびST_CPAWithinの精度の問題の修正 (Paul Ramseyさん, Darafei Praliaskouskiさん)

#4076, トポロジ実装でのGEOS使用頻度の低減 (Björn Harrtellさん)

#4080, ST_BandMetaDataに外部ラスタのバンドを追加 - ラスタの挙動に関する情報 (例: データベース外ラスタの能率、最大の開けるファイル数)提供として「ラスタに関する技法」節を文書に追加

#4084: BOX3Dの前後に対する間違ったコード内コメントを訂正 (Matthias Bayさん)

#4060, #4094, PostgreSQL JIT対応 (Raúl Marínさん, Laurenz Albeさん)

#3960, ST_Centroidがlwgeom_centroidを使用するよう変更 (Darafei Praliaskouskiさん)

#4027, lwgeom_geosの重複コードの削除 (Darafei Praliaskouskiさん, Daniel Bastonさん)

#4115, パラレルの計画で不正なプロパティ値を持つMVTを生成する誤りを修正 (Raúl Marínさん)。

#4120, ST_AsMVTGeom: タイル座標系を使ったクリップ (Raúl Marínさん)。

#4132, ラスタのST_IntersectionがTopologyExceptionが投げられることなく動作するよう変更 (Vinícius A.B. Schmidtさん, Darafei Praliaskouskiさん)

#4177, #4180 PostgreSQL 12の開発ブランチへの対応 (Laurenz Albeさん, Raúl Marínさん)

#4156, ST_ChaikinSmoothing: デフォルトでポリゴンの始点終点も平滑化するようにしました (Darafei Praliaskouskiさん)

リリース 2.4.5

リリース日: 2018/09/12

誤り訂正と性能改善のリリースです。

誤り訂正

#4031, ST_CurveToLineに渡される大きなMaxError許容値を生き残るようにしました (Sandro Santilliさん)

#4058, 大きい半径の小さい弧の線形化での無限ループを修正 (Sandro Santilliさん)

#4071, NULL/EMPTYを入力に与えたST_ClusterKMeansが異常終了する問題を修正 (Darafei Praliaskouskiさん)

#4079, ST_AsMVTGeomの出力をのポリゴンを確実に時計回りになるよう変更 (Paul Ramseyさん)

#4070, GEOS中断時に標準のエラーコードを使うよう変更 (Paul Ramseyさん)

#3980, 処理完了までの入力の解放が遅い(lucasvrさん)

#4090, PostgreSQL 11への対応 (Paul Ramseyさん, Raúl Marínさん)

#4077, 特定の空ジオメトリの場合にシリアル化が失敗する (Paul Ramsey)

#3997, lwgeom_medianの誤り修正とゼロ除算の回避 (Raúl Marínさん)

#4093, qsortのコールバックからの結果に一貫性が無い (yugrさん)

#4081, ジオグラフィ版DWithin()の特定ケースでの問題 (Paul Ramseyさん)

#4105, ソースツリーのパラレルビルド (Bas Couwenbergさん)

#4163, MVT: 先頭のジオメトリがNULLの時に発生するリソースリークの修正 (Raúl Marínさん)

リリース 2.4.4

リリース日: 2018/04/08

誤り訂正と性能改善のリリースです。

誤り訂正

#3055, [ラスタ] バンドの無いラスタでST_Clip()を実行するとサーバが異常終了する (Regina Obeさん)

#3942, geojson: json-c >= 0.13でプライベートのヘッダを取り込まないようにしました (Björn Esserさん)

#3952, 並列モードでST_Transformが失敗する (Paul Ramseyさん)

#3978, 2.1以前からのアップグレード時にKNNを訂正するようにしました (Sandro Santilliさん)

#4003, lwpoly_construct_circle: 0で割る問題を回避 (Raúl Marín Rodríguezさん)

#4004, B木インデックス構築時のメモリ枯渇を回避 (Edmund Hornerさん)

#4016, Proj 5.0.0対応 (Raúl Marín Rodríguezさん)

#4017, lwgeomの字句解析器でメモリ破損 (Peter Eさん)

#4020, BOX3Dからジオメトリへのキャストで、正しくつながった多面体サーフェイスが返るようになりました (Matthias Bayさん)

#4025, #4032 時間的に「ほとんどオーバラップしている」範囲に対する不正な答 (Paul Ramseyさん, Darafei Praliaskouskiさん)

#4052, いくつかのジオグラフィ関数のスキーマ修飾 (Regina Obeさん)

#4055, ST_ClusterIntersectingの返り値からSRIDが落ちている (Daniel Bastonさん)

性能強化

#3946, PostgreSQL 11へのコンパイルの対応 (Paul Ramseyさん)

#3992, pkg-config検出のためにpkg.m4のPKG_PROG_PKG_CONFIGマクロを使用するようにしました (Bas Couwenbergさん)

#4044, アップグレードのPostgreSQL 11 への対応 (Regina Obeさん)

リリース 2.4.3

リリース日: 2018/01/17

誤り訂正と性能改善のリリースです。

誤り訂正と機能強化

#3713, '\'文字を出力することがあるエンコーディングへの対応

#3827, コンフィギュアのデフォルトを、多くの人にとっては偽陰性の原因となる、テストの中断をしないように設定 (Regina Obeさん)、#3988での標準準拠のために改訂 (Greg Troxelさん)

#3930, 32ビットプラットフォームでの円の最小バウンディングの問題

#3965, ST_ClusterKMeansで初期化時にいくつかのクラスタが失われる (Darafei Praliaskouskiさん)

#3956, BRINのopclassオブジェクトのアップデートが確実でない (Sandro Santilliさん)

#3982, ST_AsEncodedPolylineがLINESTRING EMPTYとMULTIPOINT EMPTYに対応しました (Darafei Praliaskouskiさん)

#3975, ST_Transformがスキーマ修飾なしでspatial_ref_sysのクエリを実行する。レストア時に発生。 (Paul Ramseyさん)

リリース 2.4.2

リリース日: 2017/11/15

誤り訂正と性能改善のリリースです。

誤り訂正と機能強化

#3917, zcta5のロードを修正

#3667, ジオグラフィ版のST_Segmentizeの誤り修正

#3926, 2.2.6と2.3.4のアップグレード行程が失われていたのを追加 (Muhammad Usamaさん)

リリース 2.4.1

リリース日: 2017/10/18

誤り訂正と性能改善のリリースです。

誤り訂正と機能強化

#3864, B木演算子のメモリリークを修正

#3869, goldリンカを用いたビルドの修正

#3845, 小さなM値を素直に扱う問題

#3871, ジオメトリ比較関数の性能調整

#3879, 弧によっては0で割る

#3878, ヘッダのsignumの一文定義

#3880, TYPMOD_GET_SRIDに未定義の振る舞い

#3875, ビットシフト演算子の振る舞いが不定なのを修正

#3864,B木ジオメトリソートの性能改善

#3874, lw_dist2d_pt_arcに0で割る箇所

#3882, 入力が負数の時にzigzagの振る舞いが不定

#3891, pointarray_to_encoded_polylineに未定義の振る舞い

#3895, 不正なWKB入力についてエラーが投げられる

#3886, ジオメトリの細分でまれにボックスが無くなる問題を修正

#3907, 全ての可能性のあるGBOX文字列出力にとって十分なメモリの確保 (Raúl Marín Rodríguezさん)

リリース 2.4.0

リリース日: 2017/09/30

新機能

#3822, postgis_full_version()が、スクリプトのビルドに使ったPostgreSQLの版の表示と確認を行うようになりました (Sandro Santilliさん)

#2411, ST_Reverseの曲線への対応 (Sandro Santilliさん)

#2951, ジオグラフィのST_Centroid (Danny Götteさん)

#3788, postgis_restore.plがディレクトリ形式 (-Fd)で動作するようになりました (Roger Crew)

#3772, 方向に依存しないST_CurveToLine出力 (Sandro Santilliさん / KKGeo)

#2464, MaxError許容値を持つST_CurveToLine (Sandro Santilliさん / KKGeo)

#3599, ST_AsGeobufを介したGeobuf出力対応 (Björn Harrtellさん)

#3661, ST_AsMVTを介したMapboxベクタタイル出力対応 (Björn Harrtellさん / CartoDB)

#3689, 方向のチェックと強制を行う関数の追加 (Dan Bastonさん)

#3753, 2次元とN次元のポイントのGiSTペナルティの速度改善 (Darafei Praliaskouskiさん, Andrey Borodinさん)

#3677, ST_FrechetDistance (Shinichi Sugiyamaさん)

ほとんどの集約関数 (ラスタとジオメトリ)、および全てのSTABLE / IMMUTABLEラベルの付いた (ラスタとジオメトリ)関数にパラレル安全のラベル付けが施されました

#2249, ラスタのST_MakeEmptyCoverage (David Zwarg, ainomieliさん)

#3709, ST_Projectで符号付き距離が可能になりました (Darafei Praliaskouskiさん)

#524, ジオグラフィのポリゴン上のポリゴン、ライン上のライン、ライン上のポイントに対するCoversの対応 (Danny Götte)

機能強化と訂正

文書への多くの補正やいくつかの翻訳が完成しました。中核文書の多くの修正を行ったAndreas Schildさん。PostGIS日本語翻訳チームが最初の翻訳完成に達しました。

PostgreSQL 10対応

PostgreSQL 11への予備的な対応

#3645, シェープファイルのロードで論理的に削除されたレコードを避けるようにしました

#3747, Tigerジオコーダのnorm_addy複合型へのzip4とaddress_alphanumericの属性追加

#3748, 住所標準化のルックアップテーブルを更新してpagc_normalize_addressの略語を改善

#3647, GEOSNodeを使ってST_Nodeのノード化処理の改善 (Wouter Geraedtsさん)

#3684, EPSG第9版へのアップデート (Even Rouaultさん)

#3830, 住所標準化のinitialization from incompatible pointer typeの訂正 (9.6以上)

#3662, Make shp2pgsqlデバッグ情報を標準エラー出力に送ることでデバッグモードで動作するようにしました

#3405, lwgeom_to_pointsでのメモリリークの訂正

#3832, shp2pgsqlでint8のワイド整数に対応しました

#3841, 決定性ソートをジオグラフィのB木内で空ジオメトリに対応できるようにしました

#3844, Make =演算子を厳密な等価性テストにし、< >を荒い「空間ソート」にしました

#3855, ST_AsTWKBのメモリと実行速度の改善

大幅な変更

PostgreSQL 9.2への対応終了

#3810, GEOS 3.4.0以上をコンパイルに必要となりました

ほとんどの集約関数がパラレル安全のラベル付けが施されました。ほとんどの集約関数が削除と再作成されます。PostGIS集約関数を使っているビューがある場合には、アップグレード前に削除し、アップグレード後に再作成する必要があります。

#3578, ST_NumInteriorRings(POLYGON EMPTY)でNULLでなく0を返すようにしました

ST_DumpPointsをCで再実装したPostGIS 2.1.0以降不要となっていた_ST_DumpPointsを削除

B木インデックス演算子< = >を変更し、ソートでより良い空間局所性を提供しGROUP BYで期待される振る舞いとなるよう変更しました。ジオメトリまたはジオグラフィのB木インデックスが存在している場合には、REINDEXを実行して下さい。B木インデックスが偶然作られてGiSTインデックスに置き換える必要があるかを確認してください。オーダーの比較でボックスの左右で見る古いコードに依存する場合には、<< >>演算子を使うよう更新して下さい。

リリース 2.3.3

リリース日: 2017/07/01

誤り訂正と性能改善のリリースです。

誤り訂正と機能強化

#3777, GROUP BYが空ジオメトリを含むと不規則になる

#3711, 2.5次元のエッジをトポロジに追加すると方位エラーが発生する

#3726, dblatexからのPDFマニュアルでprogramlistingの引用部を良い感じに描画するようになりました (Mike Toewsさん)

#3738, ラスタ: raster2pgsqlで-Y無しで-sを使うとSRIDを設定するのではなく変換を行う

#3744, ST_Subdivideで逆方向のジオメトリの一部が無くなる (Darafei Praliaskouski Komzpaさん)

#3750, @と~演算子がスキーマ修飾を施したジオメトリ関数とラスタ関数が動かない場合がある。レストア問題が原因。 (Axiom Data ScienceのShane StClairさん)

#3682, pgsql2shpの結果で真偽値のフィールド内がおかしい

#3701, pgsql2shpの2重引用符問題から脱出

#3704, 空のジオメトリでST_AsX3Dが異常終了する

#3730, ST_Clipがバンドを計算できなかった時のエラーレベルをErrorからNoticeに変更

リリース 2.3.2

リリース日: 2017/01/31

誤り訂正と性能改善のリリースです。

誤り訂正と機能強化

#3418, PostgreSQL 9.5以上でのKNNの再確認が、誤った順序でタプルを返すインデックスのため、失敗する

#3675, 関係関数でインデックスが使われない場合がある

#3680, PostGIS更新スクリプトで、ビューにGRANTを実行していなかった

#3683, PostgreSQL 9.5未満から9.4より後へのpg_upgradeの後PostGISが更新できない

#3688, ST_AsLatLonText: 分の丸めがおかしい

リリース 2.3.1

リリース日: 2016/11/28

誤り訂正と性能改善のリリースです。

誤り訂正と機能強化

#1973, st_concavehull()が空ジオメトリコレクションを返すことがある gdeさんが訂正

#3501, ラスタへの最大範囲制約を追加する際に大きなテーブルでは配列サイズが範囲を超える

#3643, 最新のOSX XCodeでPostGISがビルドできない

#3644, 割り込みでデッドロックが発生する

#3650, ST_Extent, ST_3DExtentとST_Mem系の集約関数にパラレル安全のラベル付けを施し、パラレル化できるようになりました

#3652, Collection(MultiCurve())での異常終了

#3656, 2.2版以下からの集約関数の更新の訂正

#3659, CREATE EXTENSIONの後にGUCを定義すると間違ったメモリコンテキストを使い異常終了する (manaeemさん)

#3665, BRINインデックスでのインデックス崩壊とメモリリークに対するJulien Rouhaudさん (Dalibo)からのパッチ

#3667, ジオグラフィを引数に取るST_Segmentizeの誤りに対するHugo Mercierさん (Oslandia)からのパッチ

リリース 2.3.0

リリース日: 2016/09/26

新機能リリースです。新しい関数、効率改善、PostGIS 2.2.3からの関連する誤りの訂正、その他の素敵なことがあります。

重大/大幅な変更

#3466, box3dからジオメトリへのキャストが3次元ジオメトリを返すようになりました (Julien Rouhaud of Daliboさん)

#3396, ST_EstimatedExtentでエラーでなく警告が投げられる (Regina Obeさん)

新機能

postgis_restore.plでユーザ定義のTOCへの対応を追加 (Christoph Moench-Tegederさん)

ST_PointNとST_SetPointについて負数のインデックスに対応 (Rémi Curaさん)

ジオグラフィを引数に取るST_Bufferへのパラメータ追加 (Thomas Bonfortさん)

TopoGeom_addElement, TopoGeom_remElement (Sandro Santilliさん)

populate_topology_layer (Sandro Santilliさん)

#454, ST_WrapXとlwgeom_wrapx (Sandro Santilliさん)

#1758, ST_Normalize (Sandro Santilliさん)

#2236, shp2pgsql -dについて"DROP TABLE IF EXISTS"を出すようにしました

#2259, ST_VoronoiPolygonsとST_VoronoiLines (Dan Bastonさん)

#2841と#2996, ST_MinimumBoundingRadiusと新規追加のST_MinimumBoundingCircleとをにヴェルツェルのアルゴリズムを使用して実装 (Dan Bastonさん)

#2991, ST_TransformについてPROJ.4文字列を使えるようにしました (Mike Toewsさん)

#3059, ST_Expandについて座標軸ごとのパラメータ受け渡しを可能にしました (Dan Bastonさん)

#3339, ST_GeneratePoints (Paul Ramseyさん)

#3362, ST_ClusterDBSCAN (Dan Bastonさん)

#3364, ST_GeometricMedian (Dan Bastonさん)

#3391, ST_EstimatedExtentで派生テーブルへの対応を追加 (Alessandro Pasottiさん)

#3424, ST_MinimumClearance (Dan Bastonさん)

#3428, ST_Points (Dan Bastonさん)

#3465, ST_ClusterKMeans (Paul Ramseyさん)

#3469, MULTIPOINTを引数に取るST_MakeLine (Paul Normanさん)

#3549, PostgreSQL 9.6のパラレルクエリモードにできる限り対応 (Paul Ramseyさん, Regina Obeさん)

#3557, ジオメトリ関数に対してクエリ統計情報に基づくコストを設定 (Paul Norman)

#3591, BRINインデックスへの対応を追加。PostgreSQL 9.4以上が必要です。 (2nd QuadrantのGiuseppe Broccoloさん, Julien RouhaudさんとDiagloのRonan Dunklauさん)

#3496, エクステンションによってインストールされたPostGISを再配置できないようにし、関数内ではスキーマ修飾の呼び出しを行うようにしました (Regina Obeさん) これはエクステンションでの#3494, #3486, #3076を最終的に解決するものでした

#3547, Tigerジオコーダを更新し、TIGER 2016に対応するようになり、httpとftpの両方に対応するようになりました。

#3613, 等しい長さの線分を使う分割 (OslandiaのHugo Mercierさん)

誤り訂正

PostGIS 2.2.3からの全ての関連した誤りの訂正

#2841, ST_MinimumBoundingCircleが元の地物を覆い切らない

#3604, pgcommon/Makefile.inによるCFLAGS指定が不正で、liblwgeom.hが誤ったものになる (Greg Troxel)

性能強化

#75, PIP簡略版の強化 (Dan Bastonさん)

#3383, インデックス演算中に小さいジオメトリをデシリアライズするのを避けるようにしました (Dan Bastonさん)

#3400, PIPルーティンの若干の最適化 (Dan Bastonさん)

トポロジへのラインの追加を割り込み可能にしました (Sandro Santilliさん)

Mike Toewsさんからの文書更新

リリース 2.2.2

リリース日: 2016/03/22

誤り訂正と性能改善のリリースです。

新機能

#3463, フェイス崩壊によるエッジの変更で異常終了するのを訂正

#3422, 標準の倍精度システム (arm64, ppc64el, s390c, powerpc, ...)におけるST_Splitのロバスト性の改善

#3427, spatial_ref_sysをEPSG 8.8版に更新

#3433, マルチポイントを引数に取るST_ClusterIntersectingが正しくない

#3435, ST_AsX3Dで凹ジオメトリのレンダリングの訂正

#3436, ptarray_clone_deepでメモリの扱いに間違いがある

#3437, マルチポイントを引数に取るST_Intersectsが正しくない

#3461, ST_GeomFromKMLでinnerBoundaryIsがあり、かつouterBoundaryIsが無い場合にPostGISが異常終了する

#3429, いくつかのプラットフォームで2.1から2.3へのアップデートの際に無限ループやハングが発生する

#3460, アップグレード後にST_ClusterWithinで'Tolerance not defined'エラーが発生する

#3490, ラスタデータのリストア問題、マテリアライズドビュー。

#3426, POINT EMPTYのテストが愉快なアーキテクチャでは失敗する

リリース 2.2.1

リリース日: 2016/01/06

誤り訂正と性能改善のリリースです。

新機能

# 2232, SVGの丸め誤差蓄積の回避

#3321, トポロジのロードにおけるパフォーマンス不具合の訂正

#3329, TopoGeo_addPointにおけるロバスト性の不具合の訂正

#3349, postgis_topologyスクリプトのインストールパスの訂正

#3351, ST_RemoveIsoEdge (とlwt_RemIsoEdge)で終端ノードが孤立するようにしました

#3355, ジオグラフィ型を引数に取るST_Segmentizeがジオメトリボックスを持つ

#3359, toTopoGeomでTopoGeometry定義から低いIDのプリミティブの欠損を訂正

#3360, _raster_constraint_info_scaleへの不正な入力書式

#3375, コレクション (ポイント)に対する繰り返したポイント除去で異常終了する

#3378, 複数トポロジが存在する階層的なTopoGeometryの処理の訂正

#3380, #3402, トポロジのロードでラインが時々削除される

#3388, #3410, ST_Removepointsで終点がなくなるのを訂正

#3389, lwgeom_to_geojsonでのバッファオーバフロー

#3390, Alpine Linux 3.2でのビルドで、postgisとpostgis_topologyエクステンションのコンパイル時にエラーが発生する

#3393, ST_AreaがNaNを返すポリゴンがある

#3401, 32ビットシステムでのST_Splitの堅牢性の改善

#3404, ST_ClusterWithinでバックエンドが異常終了する

#3407, 複数のTopoGeometryオブジェクトを定義するフェイスまたはエッジを分割する時に異常終了するのを訂正

#3411, クラスタリング関数が空間インデックスを使っていない

#3412, TopoGeo_addLinestringでスナップ段階の堅牢性の改善

#3415, OSX 10.9でpkgsrcを使ったビルドの訂正

lwt_ChangeEdgeGeom [liblwgeom]のメモリリークの訂正

リリース 2.2.0

リリース日: 2015/10/07

新機能リリースです。新しい関数、効率改善、その他の素敵なことがあります。

新機能

トポロジAPIがliblwgeom内になりました (Sandro Santilliさん / Regione Toscanaさん - SITA)

liblwgeomの新しいlwgeom_unaryunion

liblwgeomの新しいlwgeom_linemerge

liblwgeomの新しいlwgeom_is_simple

#3169, SFCGAL 1.1に対応: ST_3DDifference, ST_3DUnion, ST_Volume, ST_MakeSolid, ST_IsSolid追加 (Vincent Moraさん / Oslandia)

#3169, ST_ApproximateMedialAxis (Sandro Santilliさん)

ST_CPAWithin (Sandro Santilliさん / Boundless)

CPAの意味を持つ|=|演算子の追加とPostgreSQL 9.5以上のKNN対応 (Sandro Santilliさん / Boundless)

#3131, ジオグラフィ型のKNN対応 (Paul Ramseyさん / CartoDB)

#3023, ST_ClusterIntersecting / ST_ClusterWithin (Dan Bastonさん)

#2703, 全てのジオメトリタイプで確かなKNNの結果が出るようにしました、別名「KNN再確認」 (Paul Ramseyさん / CartoDB)

#1137, ST_RemoveRepeatedPointsに許容誤差値を与えることが可能になりました (Paul Ramseyさん / CartoDB)

#3062, Allow passing M factor to ST_ScaleにM値に対する乗数を渡せるようになりました (Sandro Santilliさん / Boundless)

#3139, ST_BoundingDiagonal (Sandro Santilliさん / Boundless)

#3129, ST_IsValidTrajectory (Sandro Santilliさん / Boundless)

#3128, ST_ClosestPointOfApproach (Sandro Santilliさん / Boundless)

#3152, ST_DistanceCPA (Sandro Santilliさん / Boundless)

インデックスキーの型の正準な出力

ST_SwapOrdinates (Sandro Santilliさん / Boundless)

#2918, 測地線についてGeographicLib関数を使うようにしました (Mike Toewsさん)

#3074, 大きなジオメトリを分解するST_Subdivide (Paul Ramseyさん / CartoDB)

#3040, 重心に基づくKNN GiSTインデックス (<<->>) n次元距離演算子 (Sandro Santilliさん / Boundless)

liblwgeomの相互運用性API (Sandro Santilliさん / CartoDB)

#2939, ST_ClipByBox2D (Sandro Santilliさん / CartoDB)

#2247, ST_Retile, ST_CreateOverview: データベース内ラスタのオーバビューの生成 (Sandro Santilliさん / Vizzuality)

#899, shp2pgsqlの属性名マッピングを行う-mスイッチ (Regina Obeさん / Sandro Santilliさん)

#1678, GDALコンフィギュレーション変数GDAL_DATAを指定するGUC postgis.gdal_datapathを追加

#2843, ラスタ入力での投影変換に対応 (Sandro Santilliさん / Vizzuality)

#2349, Support for encoded_polyline入出力の対応 (Kashif Rasulさん)

#2159, postgis_full_version()からのlibjsonの版の報告

#2770, ST_MemSize(raster)

postgis_noop(raster)追加

ST_TPI(), ST_TRI(), ST_Roughness()の存在しない形式を追加

GDALコンフィギュレーション変数GDAL_SKIPを指定するGUC postgis.gdal_enabled_driversの追加

データベース外バンドへのアクセスを有効にするGUC postgis.enable_outdb_rastersを追加

#2387, PostGISの一部としてのaddress_standardizerエクステンション (Stephen Woodbridgeさん / imaptools.com, Walter Sinclairさん, Regina Obeさん)

#2816, address_standardizerの参考となるlexテーブル, gazテーブル, 規則テーブルを提供するaddress_standardizer_data_usエクステンション (Stephen Woodbridgeさん / imaptools.com, Walter Sinclairさん, Regina Obeさん)

#2341, ST_MapAlgebraの新しいマスクパラメータ

#2397, シェープファイルローダのエンコーディングの自動読み取り

#2430, ST_ForceCurve

#2565, ST_SummaryStatsAgg()

#2567, ST_CountAgg()

#2632, ST_AsGML()が曲線地物に対応するようになりました

#2652, run_test.plに--upgrade-pathスイッチを追加

#2754, エクステンションとしてのSFCGALラッパー

#2227, Visvalingam-Whyattアルゴリズムによる簡略化ST_SimplifyVW, ST_SetEffectiveArea (Nicklas Avénさん)

TWKBエンコード関数とデコード関数 ST_AsTWKB, ST_GeomFromTWKB (Paul Ramseyさん / Nicklas Avénさん / CartoDB)

性能強化

#3223, ST_Equalsへの簡略版memcmpの追加 (Daniel Bastonさん)

#3227, Tiger 2015センサス対応のためのTigerジオコーダのアップグレード

#2278, マイナーリリース間のliblwgeomの互換性確保

#897, ST_AsX3DがGeoCodinates要素に対応し、"GD" "WE"とx/y軸反転とに対応しました (optionsに2, 3を使用)

ST_Split: マルチライン、マルチポイント、(マルチ)ポリゴンの境界によるライン分割を可能にしました

#3070, ジオメトリタイプ制約の簡略化

#2839, 関数インデックスへの選択度見積りの実装、ラスタテーブルでの空間クエリの速度向上。 (Sandro Santilliさん / Vizzuality)

#2361, raster_columnsビューへのspatial_indexカラムの追加

#2390, pgsql2shpのテストスイート

#2527, raster2pgsqlへの、バンドのNODATAの有無のチェックを行わない-kフラグの追加

#2616, トポロジの構築とエクスポートでのテキストへのキャストを低減

#2717, 複合曲線がstartpoint, endpoint, pointn, numpointsに対応しました

#2747, GDAL 2.0対応への追加

#2754, SFCGALがCREATE EXTENSIONでインストールできるようになりました (Vincent Moraさん @ Oslandia)

#2828, ST_Envelope(raster)をSQLからCに変更

#2829, ジオメトリが完全にラスタを含みかつNODATAが指定されていない場合のST_Clip(raster)の短縮動作

#2906, TigerジオコーダのTiger 2014データ処理のための更新

#3048, ジオメトリ簡略化の速度向上 (J.Santanaさん @ CartoDB)

#3092, 多数のテーブルがある場合にgeometry_columnsが遅い

リリース 2.1.8

リリース日: 2015/07/07

重大な誤り訂正のリリースです。

誤り訂正

#3159, ST_Affineでbboxキャッシュを強制しないようにしました

#3018, ジオグラフィに対するGROUP BYで時々重複行が返される

#3048, shp2pgsql - 特定のシステムロケールセットで数字の書式が不正になる

#3094, 不正な形式のGeoJSON入力でバックエンドが異常終了する

#3104, st_asgmlででたらめな文字をIDフィールドに入ってしまう

#3155, make uninstallでliblwgeom.hを消すようにしました

#3177, ネストされた空を引数に取る場合にgserialized_is_emptyが処理できない

ST_LineLocatePointの異常終了の訂正

リリース 2.1.7

リリース日: 2015/03/30

重大な誤り訂正のリリースです。

誤り訂正

#3086, ST_DumpValues()に不正なバンド番号を渡すとバックエンドが異常終了する

#3088, liblwgeom.hでstrcasestrを(再)定義しないようにしました

#3094, 不正な形式のGeoJSON入力でバックエンドが異常終了する

リリース 2.1.6

リリース日: 2015/03/20

誤り訂正と性能改善のリリースです。

性能強化

#3000, エッジ分割修復で確実にインデックスを使うようにしました

#3048, ジオメトリ簡略化の速度向上 (J.Santanaさん @ CartoDB)

#3050, ジオメトリ型の読み取りの高速化 (J.Santana @ CartoDB)

誤り訂正

#2941, ジオグラフィカラムに4326以外のSRIDが入るようになりました

#3069, 小さいオブジェクトがボックスを伴うことで不適切に膨らむ

#3068, 制約されていない次元でpostgis_typmod_dimsがNULLを返すようにしました

#3061, JSON, GML, GML ST_GeomFrom*関数で重複ポイントが可能になりました

#3058, N次元GiSTのpicksplitメソッドを最適な平面で分割するよう訂正

#3052, PostgreSQL 9.1より後で有効な<->, <#>演算子を作成

#3045, &&&演算子での次元の混乱を訂正

#3016, 壊れたトポロジのレイヤの削除が可能になりました

#3015, TopologySummaryで例外を避けるようにしました

#3020, データベース外のST_AddBandで高さの値であるべきところを幅の値にする誤り

#3031, 空のジオメトリ (ポイント)テーブルをダンプしたものをレストアできるようになりました

リリース 2.1.5

リリース日: 2014/12/18

誤り訂正と性能改善のリリースです。

性能強化

#2933, 巨大なマルチジオメトリオブジェクトの構築の速度向上

誤り訂正

#2947, lwgeom_make_validが1要素のコレクションを入力に取る場合に発生するメモリリークを訂正

#2949, lwgeom_mindistance2dが曲線を入力に取る場合に発生するメモリリークを訂正

#2931, BOX表現が大文字小文字の区別をする

#2942, PostgreSQL 9.5対応

#2953, Z値/M値が極端な時に2次元の統計情報が生成されない

#3009, ジオグラフィにキャストすると基になるタプルに影響を与えることがある

リリース 2.1.4

リリース日: 2014/09/10

誤り訂正と性能改善のリリースです。

性能強化

#2745, ポイントに対するST_Simplifyの速度向上

#2747, GDAL 2.0に対応

#2749, rtpostgis_upgrade_20_21.sqlをACIDになるようにしました

#2811, シェープファイル/ラスタをロードする時にインデックス名を指定しないようにしました

#2829, ジオメトリが完全にラスタを含みかつNODATAが指定されていない場合のST_Clip(raster)の短縮動作

#2895, クエリプランを良くするためにST_ConvexHull(raster)のコストを300に増加

誤り訂正

#2605, armel: _ST_Covers()が穴の中のポイントでTRUEを返す

#2911, スケールが1/-1でオフセットが0/0のラスタのST_Rescale/ST_Resample/ST_Resizeの出力を訂正。

ST_Union(raster)が異常終了するのを訂正

#2704, gml:pos配列でST_GeomFromGML()が正しく動作しない (Even Roualtさん)

#2708, スキーマを指定していないとupdategeometrysridがsridのチェックを更新しない。Marc Jansenさんからのパッチ

#2720, lwpoly_add_ringはreallocの後に最大環数を更新するべき

#2759, 複数行のSQLコメントを埋め込んだオブジェクトコメントの処理でpostgis_restore.plを訂正

#2774, ptarray_calculate_gbox_geodeticで未定義の振る舞いを訂正

ST_MakeValidの潜在的なメモリフォールトの訂正

#2784, --with-sfcgalへの偽の引数の処理の訂正

#2772, RASTER_getBandPath (ST_BandPath)内の早すぎるメモリ解放

#2755, SFCGALの全ての版に対する回帰テストを訂正

#2775, lwline_from_lwmpointでメモリリークが発生する

#2802, ST_MapAlgebraが正当なコールバック関数の返り値か確認するようにしました

#2803, ST_MapAlgebraがuserargを使わないSTRICTのコールバック関数を処理するようになりました

#2834, ST_Estimated_Extentと大文字小文字の混じったテーブル名 (回帰テストでの問題)

#2845, ST_AddPointから悪いジオメトリが発生する

#2870, ジオグラフィカラムへのバイナリ挿入なのにジオメトリが挿入される

#2872, make install による文書構築(Greg Troxellさん)

#2819, Centos5 / Solariでisfiniteを見つけるか置き換えるようにしました

#2899, geocodeでlimit 1を指定した時に最善の答えが返らない (Tigerジオコーダ)

#2903, FreeBSDでコンパイルできない

#2927 reverse_geocode (Tigerジオコーダ)が方角プレフィクスを埋めないし、ST_Line_Locate_Pointが呼ばれる

リリース 2.1.3

リリース日: 2014/05/13

誤り訂正とセキュリティ対策のリリースです。

重要な変更

この版から、オフラインでのラスタへのアクセスとGDALドライバの利用はデフォルトでは無効になりました。

環境変数POSTGIS_GDAL_ENABLED_DRIVERSで特定のGDALドライバを有効にできます。デフォルトでは全てのGDALドライバは無効になっています。

環境変数POSTGIS_ENABLE_OUTDB_RASTERSでデータベース外ラスタバンドを有効にできます。デフォルトでは、データベース外ラスタバンドは無効です。

これらの環境変数はPostgreSQLプロセスに設定しなければなりません。また、クラスタ全体の振る舞いを決定するものです。

誤り訂正

#2697, 不正なGeoJSONポリゴン入力でサーバプロセスが異常終了する

#2700, NULL行を持つ高次元データセットのダンプの訂正

#2706, ST_DumpPointsに空ジオメトリを与えるとサーバが異常終了する

リリース 2.1.2

リリース日: 2014/03/31

この版は誤り訂正版です。2.1.1版以降に送られた問題の処理が行われました。

誤り訂正

#2666, コンフィギュア時にSQLプリプロセッサが発見できないとエラーになる

#2534, st_distanceが大きなジオグラフィでは正しくない結果を返す

#2539, json-c/json.hが存在し、以前のjson/json.hのように使用可能であるかの確認

#2543, 単純なクエリからの不正なJOIN選択度エラー

#2546, 文字列座標値を持つGeoJSONのパースが不正

#2547, 階層的なTopoGeometryに対するST_Simplify(TopoGeometry)の訂正

#2552, ST_AsPNG, ST_AsTIFF, ST_AsJPEGのNULLラスタ処理の訂正

#2555, ST_Reclassのrange引数のパースの問題の訂正

#2556, ジオグラフィのST_Intersectsの結果が行挿入順序によって異なる

#2580, 同じデータベースに2回PostGISをインストールさせないようにしました

#2589, 必須でないvoidポインタの使用の削除

#2607, 1プロセスで1024以上のデータベース外ファイルを開くことができない

#2610, フェイス分割アルゴリズムでエッジインデックスの使用を確実にしました

#2615, EstimatedExtent (その下にある統計情報に由来)がおかしいbboxを集める

#2619, GeoJSONで環の配列が空の場合に異常終了する

#2634, 球面距離のコードの回帰テスト

#2638, M値を持つジオグラフィの距離が時々おかしい

#2648, #2653, ”topology”がsearch_pathに無い時のトポロジ関数の訂正

#2654, トポロジでの非推奨呼び出しの削除

#2655, トポロジの権限を持たないユーザがpostgis_full_version()を呼ぶ時の問題

#2674, 欠損した=演算子と演算子クラスhash_raster_opsの訂正

#2675, #2534, #2636, #2634, #2638, 木構造の最適化でのジオグラフィの距離の問題

性能強化

#2494, GiSTインデックスでmemcopyを避けるようにしました (hayamizさん)

#2560, ソフトアップグレード: 変更されていない集約関数の削除/置換を避けるようにしました

リリース 2.1.1

リリース日: 2013/11/06

この版は誤り訂正版です。2.1.0版以降に送られた問題の処理が行われました。

重要な変更

#2514, ラスタライセンスをGPL v3以上からv2以上に変更し、PostGISエクステンションをGPL v2で配布できるようにしました。

誤り訂正

#2396, 回帰テストをよりエンディアン不明なテストにしました

#2434, 珍しい状況でのST_Intersection(geog,geog)の回帰テストの訂正

#2454, exclude_nodata_valueパラメータに沿うST_PixelAsXXX関数の振る舞いの訂正

#2489, 2.0からのアップグレードで古い関数のシグネチャが残されているのを訂正

#2525, 入れ子のコレクションのSRIDの処理の訂正

#2449, インデックス構築の潜在的な永久ループの訂正

#2493, 空ラスタを渡した時のST_DumpValuesの挙動の訂正

#2502, postgis_topology_scripts_installed()のインストールスキーマの訂正

#2504, pgsql2shpの正しくない呼び出しでセグメンテーション違反が発生するのを訂正

#2512, raster_columnsとraster_overviewsの外部テーブルと体現ビューへの対応

性能強化

#2478, Tiger 2013への対応

#2463, 弧ジオメトリの精密な距離計算への対応

リリース 2.1.0

リリース日: 2013/08/17

マイナーリリースです。2.0.3以降に送られた誤り訂正、性能向上、機能向上を行いました。2.0以上からアップグレードする場合には、ソフトアップグレードだけが必要です。1.5以前からアップグレードする場合には、ハードアップグレードが必要です。

重大/大幅な変更

#1653, ST_Resample(raster)からSRIDパラメータを削除し、参照ラスタを使う形式でラスタのSRIDの参照を適用しなくしました。

#1962 ST_Segmentize - ジオグラフィ対応の紹介での結果として、SELECT ST_Segmentize('LINESTRING(1 2, 3 4)',0.5);で関数の曖昧エラーが出る

#2026, ST_Union(raster)が全てのラスタの全てのバンドを結合するようになりました。

#2089, liblwgeom: lwgeom_set_handlersがlwgeom_init_allocatorsに取って代わりました。

#2150, regular_blockingは制約ではなくなりました。raster_columns内の同名のカラムは、patially_unique制約とcoverage_tile制約の存在を確認しています。

ST_Intersects(raster, geometry)をST_Intersects(geometry, raster)と同じに振る舞うようにしました。

ポイント形式のST_SetValue(raster)が入力ポリゴンとラスタのSRIDを確認していなかった。

ST_Hillshadeのazimuthとaltitudeパラメータをラジアンから度に変更。

ST_SlopeとST_Aspectが返すピクセル値をラジアンから度に変更。

#2104, ST_World2RasterCoord, ST_World2RasterCoordX, ST_World2RasterCoordYをST_WorldToRasterCoord, ST_WorldToRasterCoordX, ST_WorldToRasterCoordYにそれぞれ関数名変更。ST_Raster2WorldCoord, ST_Raster2WorldCoordX, ST_Raster2WorldCoordYをST_RasterToWorldCoord, ST_RasterToWorldCoordX, ST_RasterToWorldCoordYにそれぞれ関数名変更。

ST_Estimated_ExtentをST_EstimatedExtentに関数名変更

ST_Line_Interpolate_PointをST_LineInterpolatePointに関数名変更

ST_Line_SubstringをST_LineSubstringに関数名変更

ST_Line_Locate_PointをST_LineLocatePointに関数名変更

ST_Force_XXX をST_ForceXXXに関数名変更

ST_MapAlgebraFctNgbとST_MapAlgebraFctの1ラスタ形式と2ラスタ形式。代わりにST_MapAlgebraを使います。

ST_MapAlgebraExprの1ラスタ形式と2ラスタ形式。代わりに数式形式のST_MapAlgebraを使います。

新機能

- 新しい関数の完全なリストは http://postgis.net/docs/manual-2.1/PostGIS_Special_Functions_Index.html#NewFunctions_2_1 を参照

#310, ST_DumpPointsのC言語関数への変換 (Nathan Wagnerさん)と速度向上

#739, UpdateRasterSRID()

#945, JOIN選択度、N次元選択度計算、ユーザがアクセス可能な選択度およびテスト用統計情報取得関数の改善 (Paul Ramseyさん / OpenGeo)

toTopoGeom with TopoGeometry sink (Sandro Santilliさん / Vizzuality)

clearTopoGeom (Sandro Santilliさん / Vizzuality)

ST_Segmentize(geography) (Paul Ramseyさん / OpenGeo)

ST_DelaunayTriangles (Sandro Santilliさん / Vizzuality)

ST_NearestValue, ST_Neighborhood (Bborie Parkさん / UC Davis)

ST_PixelAsPoint, ST_PixelAsPoints (Bborie Parkさん / UC Davis)

ST_PixelAsCentroid, ST_PixelAsCentroids (Bborie Parkさん / UC Davis)

ST_Raster2WorldCoord, ST_World2RasterCoord (Bborie Parkさん / UC Davis)

ラスタ/ラスタ空間関係関数 (ST_Contains, ST_ContainsProperly, ST_Covers, ST_CoveredBy, ST_Disjoint, ST_Overlaps, ST_Touches, ST_Within, ST_DWithin, ST_DFullyWithin)の追加 (Bborie Parkさん / UC Davis)

ST_SetValues()でのバンド内の多数のピクセル値を入れる形式の追加 (Bborie Parkさん / UC Davis)

#1293, 幅/高さに基づくラスタのサイズ再設定を行うST_Resize(raster)

#1627, PostgreSQLエクステンションとしてのtiger_geocoderパッケージ

#1643, #2076, Tiger 2011と2012のロードに対応したTigerジオコーダのアップグレード (Regina Obeさん / Paragon Corporation) Funded by Hunter Systems Groupの資金提供

ST_MakeValidがジオメトリコレクションに対応しました (Sandro Santilliさん / Vizzuality)

#1709, ST_NotSameAlignmentReason(raster, raster)

#1818, ST_GeomFromGeoHashと仲間 (Jason Smithさん (darkpanda))

#1856, Tigerジオコーダ: 逆ジオコーディングの評価で道路番号が好ましい場合に設定できるようになりました

ST_PixelOfValue (Bborie Parkさん / UC Davis)

PostgreSQLの幾何データ型 (point/path/polygon)との相互キャスト

1つのバンドにジオメトリ集合と該当値を使って1回の呼び出しで多数のピクセル値を入れるためにST_SetValues()にgeomval配列の形式を追加 (Bborie Parkさん / UC Davis)

ラスタをタイルに分解するST_Tile(raster) (Bborie Parkさん / UC Davis)

#1895, 新しいR木のノード分割アルゴリズム (Alex Korotkovさん)

#2011, ラスタを配列で出力するST_DumpValues (Bborie Parkさん / UC Davis)

#2018, ST_DistanceがCircularString, CurvePolygon, MultiCurve, MultiSurface, CompoundCurveに対応しました

#2030, 任意数のラスタ (と任意数のバンド)のST_MapAlgebra (Bborie Parkさん / UC Davis)

#2193, PAGCパーサをTiger住所正規化の置き換えとして使用可能にしました (Steve Woodbridgeさん, Regina Obeさん)

#2210, ST_MinConvexHull(raster)

liblwgeom内のlwgeom_from_geojson (Sandro Santilliさん / Vizzuality)

#1687, TopoGeometryのためのST_Simplify (Sandro Santilliさん / Vizzuality)

#2228, TopoGeometryのためのTopoJSON出力 (Sandro Santilliさん / Vizzuality)

#2123, ST_FromGDALRaster

#613, 文字列パラメータの代わりに数値パラメータを与えるST_SetGeoReference

#2276, データベース外バンド用のST_AddBand(raster)

#2280, ST_Summary(raster)

#2163, ラスタ用のST_TPI (Nathaniel Clayさん)

#2164, ラスタ用のST_TRI (Nathaniel Clayさん)

#2302, ラスタ用のST_Roughness (Nathaniel Clayさん)

#2290, RGBAバンドを生成するST_ColorMap(raster)

#2254, SFCGALバックエンドへの対応。 (バックエンド選択はpostgis.backend変数で行います) GEOSとSFCGALの両方で有効な関数はST_Intersects, ST_3DIntersects, ST_Intersection, ST_Area, ST_Distance, ST_3DDistanceです。SFCGALのみ有効な関数はST_3DIntersection, ST_Tesselate, ST_3DArea, ST_Extrude, ST_ForceLHR ST_Orientation, ST_Minkowski, ST_StraightSkeleton postgis_sfcgal_versionです。PostGISへの新規追加関数はST_ForceSFS (Olivier CourtinさんとHugo Mercier / Oslandia)です

性能強化

新関数と関数改善の詳細については、the section called “PostGIS 2.1 で新規作成/機能強化された関数”を参照して下さい。

ラスタ版ST_UnionとST_Clipの高速化と多くの関数の追加操作

ジオメトリ/ジオグラフィでのプランナの選択度の向上と多数の関数

#823, Tigerジオコーダ: loader_generate_scriptのダウンロード部分の貪欲さを低減

#826, raster2pgsqlの詰め物タイルはデフォルトでなくなりました。-Pフラグで詰め物タイルにできます

#1363, ST_AddBand(raster, ...)配列版のC言語による再記述

#1364, ST_Union(raster, ...)集約関数のC言語による再記述

#1655, ST_Slopeのパラメータの追加的なデフォルト値

#1661, 集約関数形式のST_SameAlignmentを追加

#1719, ST_MakeValidのポイントとジオメトリコレクション入力への対応の追加

#1780, ST_GeoHashのジオグラフィ対応の追加

#1796, ジオグラフィの距離計算の非常に大きな効率改善

#1802, 関数の割り込み可能性について改善。

#1823, ST_AsGMLへのGML 3出力用の識別子カラム (GML 3.2.1から必須)を使用するためのパラメータの追加

#1856, Tigerジオコーダ: 逆ジオコーディングの評価で道路番号が好ましい場合に設定できるようになりました

#1938, 1回の呼び出しで複数の新しいバンドを追加するようST_AddBandを基本からリファクタリング

#1978, 閉じた円弧 (円)の距離計算で悪い答が出る

#1989, 入力ジオメトリをクリップされるべきラスタとの交差だけに処理するようにしました

#2021, ST_Union(raster, ...)集約関数に複数バンド対応を追加

#2006, 極や日付線をまたぐST_Area(geography)への対応の改善

#2065, ST_Clip(raster, ...)がC言語の関数になりました

#2069, ST_Tile(raster)にタイルの詰め物に関するパラメータ追加

#2078, ST_Slope, ST_AspectとST_HillShadeにカバレッジのタイルの処理を解決するための形式を追加

#2097, ST_Union(raster)のuniontypeオプションにRANGEを追加

#2105, 出力を参照ラスタに整列させるためのST_Transform(raster)の形式を追加

#2119, Rasters passed to ST_Resample(), ST_Rescale(), ST_Reskew()とST_SnapToGrid()に渡すラスタはSRIDを必須としなくなりました

#2141, 制約がラスタカラムに追加できない場合の出力がより詳細になりました

#2143, ラスタのblocksize制約で複数値を許容するようになりました

#2148, ラスタのcoverage_tile制約の追加

#2149, ラスタのspatially_unique制約の追加

TopologySummary出力に登録されていないレイヤとレイヤから欠落しているTopoGeometryオブジェクトの個数が含まれるようになりました。

ST_HillShade(), ST_Aspect()とST_Slope()に、実行前に行うNODATAピクセルの補間のための新しいパラメータを追加。

ポイント版ST_SetValue(raster)は現在はgeomval版 ST_SetValues(rast)をラップするようになっています。

中核APIとローダでラスタバンドのisnodataフラグへの確実な対応。

ST_AspectとST_HillShadeのパラメータのデフォルト値の追加

#2178, ST_Summaryは[S]フラグでSRIDの有無が分かるようになりました

#2202, libjson-cの任意化 (コンフィギュアスイッチ--without-json)

#2213, libjson-c 0.10以上への新規対応

#2231, raster2pgsqlがファイル名カラムのカラム名を-nで指定できるようになりました

#2200, ST_Union(raster, uniontype)で全ての入力ラスタの全てのバンドを結合するようになりました。

#2264, postgis_restore.plがカスタムスキーマでPostGISを使っているデータベースへの再格納に対応しました

#2244, ラスタにデータベース外バンドがある場合にジオリファレンスが変わったときに警告が出る

#2222, ST_AsBinaryに、データベース外バンドをデータベース内バンドのように返すべきかを決めるフラグOutAsInパラメータの追加

訂正

#1839, raster2pgsqlでGeoTIFFのサブデータセットの処理

#1840, raster2pgsqlでタイル数を計算する時機のロジックを訂正

#1870, ラスタのST_Intersectsの文書と実際の振る舞いとをあわせました

#1872, ST_ApproxSummarystatsでゼロで割らないようにしました

#1875, パラメータのcountが0で他が全てNULLの時にST_SummaryStatsがNULLを返す

#1932, raster2pgsqlでインデックスのテーブル空間についての書式を訂正

#1936, ST_GeomFromGMLにCurvePolygonを与えると異常終了する

#1939, 独自データ型: summarystats, histogram, quantile, valuecountを削除

#1951, 距離が0のラインストリングで異常終了するのを削除

#1957, 1点のラインストリングを与えるとST_DistanceがNULLを返す

#1976, ジオグラフィの環内ポイントのコードを信頼性向上のため見直し

#1981, gcc 4.6以上で警告の原因となる未使用変数の削除

#1996, GeoJSON出力でPOINT EMPTYに対応

#2062, 距離計算の効率改善

#2057, raster2psqlからlibpqへのリンクの問題を訂正

#2077, ST_Hillshade()が正しくない値を返すのを訂正

#2019, ST_FlipCoordinatesがバウンダリボックスを更新しない

#2100, ST_AsRasterが指定したピクセル型によってはラスタを返さないことがある

#2126, ST_ConvexHull()からの空のラスタの処理を改善

#2165, ST_NumPointsの回帰テストがCircularStringだと失敗する

#2168, ST_Distanceが交換可能にならないときがある

#2182, データベース外ラスタで、SRIDなしでST_Resizeを実行する際の問題訂正

#2188, GDALデータセットからデータをｈ区政する時に問題となる関数パラメータ値のオーバフローの訂正

#2198, ST_Tile()内でデータベース外ラスタのバンドを生成する時に正しくない寸法を使うのを訂正

#2201, 境界上のST_GeoHashが間違っている

#2203, GDAL Warp APIに渡す時の、未知のSRIDを持つラストとデフォルトのgeotransformを処理する方法を変更

#2215, ラスタ除外制約で発生する暗黙のインデックスの名前の衝突の訂正

#2251, デフォルトのgeotransform行列でラスタを再スケーリングすると次元がおかしくなるのを訂正

#2133, ST_MapAlgebraの数式版における効率性回帰テストの訂正

#2257, 空ジオメトリでテストする時にGBOX変数が初期化されない

#2271, ラスタの並列ビルドの阻止

#2282, デバッグモードで未定義関数nd_stats_to_grid()を呼ぶのを訂正

#2307, ST_MakeValidが不正なジオメトリを出力する

#2309, SRS情報取得時の紛らわしいINFOメッセージを削除

#2336, wgetを使って全てのファイルを得るのにFIPS 20 (KS)がワイルドカード展開を行う

#2348, 2.0から2.1へのラスタのアップグレードパスの提供

#2351, ジオグラフィ間のst_distanceが間違っている

#2359, オーバビュー制約の追加時のスキーマ名の処理の訂正

#2371, サポートするGEOSの版のマイナー以下の桁が違う

#2383, 警告メッセージから安全でない \" の使用を削除

#2384, ST_Neighborhoodの変数型が不正

既知の問題

#2111, ラスタバンドはデータベース外ラスタの最初の256バンドだけ参照可能

リリース 2.0.5

リリース日: 2014/03/31

この版は誤り訂正版です。2.0.4版以降に送られた問題の処理が行われました。PostGIS 2.0以上を使っている場合にはソフトアップデートが必要です。PostGIS 1.5以前を使っている場合には、ハードアップグレードが必要です。

誤り訂正

#2494, GiSTインデックスでのmemcpyを回避

#2502, postgis_topology_scripts_installed()のインストールスキーマの訂正

#2504, pgsql2shpの正しくない呼び出しでセグメンテーション違反が発生するのを訂正

#2528, ST_Split / lwline_split_by_lineでのメモリリークを訂正

#2532, ラスタ/ジオメトリの交換演算子の追加

#2533, 重複シグネチャの削除

#2552, ST_AsPNG, ST_AsTIFF, ST_AsJPEGのNULLラスタ処理の訂正

#2555, ST_Reclassのrange引数のパースの問題の訂正

#2589, 必須でないvoidポインタの使用の削除

#2607, 処理時に1024以上のデータベース外ファイルが開けない

#2610, フェイス分割アルゴリズムでエッジインデックスの使用を確実にしました

#2619, GeoJSONポリゴンで空の環があると異常終了する

#2638, M値を持つジオグラフィの距離が時々おかしい

重要な変更

##2514, PostGIS ExtensionをGPLv2で配布できるようにラスタのラインセンスをGPL v3+からv2+に変更

リリース 2.0.4

リリース日: 2013/09/06

この版は誤り訂正版です。2.0.3版以降に送られた問題の処理が行われました。PostGIS 2.0以上を使っている場合にはソフトアップデートが必要です。PostGIS 1.5以前を使っている場合には、ハードアップグレードが必要です。

誤り訂正

#2110, EMPTYと原点上のポイントとの等価演算

TopoGeo_addPointで精度距離でのポイントの追加が可能になりました

#1968,toTopoGeomからエッジがなくなって返るのを訂正

#2165, ST_NumPointsの回帰テストがCircularStringだと失敗する

#2168, ST_Distanceが交換可能にならないときがある

#2186, GUIのプログレスバーの更新が頻繁に過ぎる

#2201, 境界上のST_GeoHashが間違っている

#2257, 空ジオメトリでテストする時にGBOX変数が初期化されない

#2271, ラスタの並列ビルドの阻止

#2267, テーブルの解析からサーバが異常終了する

#2277, 潜在的なセグメンテーション違反を削除

#2307, ST_MakeValidが不正なジオメトリを出力する

#2351, ジオグラフィ間のst_distanceが間違っている

#2359, overview制約のスキーマの処理が不正

#2371, サポートするGEOSの版のマイナー以下の桁が違う

#2372, KMLの座標に空白を入れたらパースできない

システム全体でインストールされるliblwgeomでビルドするよう訂正

#2383, 警告メッセージ内の安全でない \' の使用を訂正

#2410, 頂点が同一線上にある曲線の分割の訂正

#2412, ST_LineToCurveが4頂点未満のラインに対応

#2415, ST_MultiがCOMPOUNDCURVEとCURVEPOLYGONに対応

#2420, ST_LineToCurve: 閉じた円の定義に少なくとも8エッジが必要

#2423, ST_LineToCurve: 同じ角度を形成する全てのアークが必要

#2424, ST_CurveToLine: MULTICURVEのCOMPOUNDCURVEに対応

#2427, ST_CurveToLineでの曲線の1番目のポイントの維持を確実にするようにしました

性能強化

#2269, ANALYZEでジオメトリ全体のTOASTを解除する無駄を排除

既知の問題

#2111, ラスタバンドはデータベース外ラスタの最初の256バンドだけ参照可能

リリース 2.0.3

リリース日: 2013/03/01

この版は誤り訂正版です。2.0.2版以降に送られた問題の処理が行われました。PostGIS 2.0以上を使っている場合にはソフトアップデートが必要です。PostGIS 1.5以前を使っている場合には、ハードアップグレードが必要です。

誤り訂正

#2126, ST_ConvexHull()からの空のラスタの処理を改善

#2134, GDAL関数に渡す前のSRS処理を確実にしました

liblwgeomの様々なメモリリークを訂正

#2173, ラインを頂点で分割する際の堅牢性の訂正とトポロジ構築への波及(#2172)

#2174, 間違った関数lwpoly_free()の使用法の訂正

#2176, ST_ChangeEdgeGeomの堅牢性問題の訂正

#2184, Z値を持つトポロジの複写を正しくしました

postgis_restore.plでダンプでジオメトリカラム名の混合する場合への対応

#2188, GDALデータセットからデータをｈ区政する時に問題となる関数パラメータ値のオーバフローの訂正

#2216, マルチポリゴンのGeoJSON (穴のあるもの)のパーシングで多数のメモリエラー

GeoJSONパーサのメモリリークの訂正

性能強化

#2141, 制約がラスタカラムに追加できない場合の出力がより詳細になりました

ST_ChangeEdgeGeomの速度向上

リリース 2.0.2

リリース日: 2012/12/03

この版は誤り訂正版です。2.0.1版以降に送られた問題の処理が行われました。

誤り訂正

#1287, "gist_geometry_ops"の削除によって、この場合のクライアントのlegacy_gist.sqlのパッケージが壊れた

#1391, 1.5版からのアップデートでエラーが発生する

#1828, ST_DWithinで選択度見積もりが貧弱

#1838, Tigerのラインデータのインポートでエラー

#1869, ST_AsBinaryがlegacy_minor/legacy.sqlスクリプトに一意に追加されない

#1885, Tiger2010のcensus_loader.sqlでtabblockテーブルのフィールド欠損

#1891, liblwgeomのビルドでLDFLAGS環境変数を使うようにしました

#1900, ビッグエンディアン機でのpgsql2shpの訂正

#1932, raster2pgsqlでインデックスのテーブル空間設定が不正な書式になるのを訂正

#1936, ST_GeomFromGMLにCurvePolygonを与えると異常終了する

#1955, 二重接続されたエッジのST_ModEdgeHealとST_NewEdgeHeal

#1957, 1点のラインストリングを与えるとST_DistanceがNULLを返す

#1976, ジオグラフィの環内ポイントのコードを信頼性向上のため見直し

#1978, 閉じた円弧 (円)の長さの計算が間違っている

#1981, gcc 4.6以上で発見された、使われないけれども宣言されている変数の削除

#1987, ST_Simplifyの挙動を1.5.x版に戻しました

#1989, 入力ジオメトリをクリップされるべきラスタとの交差だけに処理するようにしました

#1991, PostgreSQL 9.2上でのジオコーディングが本当に遅い

#1996, GeoJSON出力でPOINT EMPTYに対応

#1998, 両方の終端を共有するエッジをつなげるST_{Mod,New}EdgeHealの訂正

#2001, ST_CurveToLineで、ジオメトリが実際に弧を含んでいない場合に効果が無い

#2015, ST_IsEmpty('POLYGON(EMPTY)')がFALSEを返す

#2019, ST_FlipCoordinatesがバウンダリボックスを更新しない

#2025, TopoGeo_AddLineStringでサイドの位置が衝突するのを訂正

#2026, 距離計算の効率改善

#2033, 2.5次元トポロジへの分割ポイント追加の訂正

#2051, ST_AsGeoJSON出力での精度過剰の訂正

#2052, lwgeom_to_geojsonでのバッファオーバフローの訂正

#2056, ST_SetValue()でのラスタとジオメトリのSRIDチェックの欠落を訂正

#2057, raster2psqlからlibpqへのリンクの問題を訂正

#2060, GetTopoGeomElementArrayで「次元」チェック違反になるのを訂正

#2072, ST_Intersects(raster)がデータベース外バンドで動作することを予防する旧式のチェックの削除

#2077, ST_Hillshade(raster)が正しくない答えを出すのを訂正

#2092, libxml2.8以上でのST_GeomFromKML,ST_GeomFromGMLの名前空間の問題

#2099, ST_OffsetCurveでの例外発生時に二度メモリ開放をしているのを訂正

#2100, ST_AsRaster()が指定したピクセルタイプでラスタを返さないことがある

#2108, ST_Line_Interpolate_Pointが常にポイントを返すのを確実にしました

#2109, ST_Centroidが常にポイントを返すのを確実にしました

#2117, ST_PointOnSurfaceが常にポイントを返すのを確実にしました

#2129, 入力がコレクションの場合のST_Homogenizeで出力のSRIDを訂正

#2130, マルチポリゴンのGeoJson読み込みでメモリエラーが出るのを訂正

Maven jarのURLを更新

性能強化

#1581, ST_Clip(raster, ...)は、現在では、引数のラスタにNODATAが無い場合に、バンドのNODATAを強制しません

#1928, Accept array properties in GML input 入力GMLのマルチ系ジオメトリでの配列を受け付けるようにしました (Kashif RasulさんとShoaib Burqさん / SpacialDB)

#2082, トポロジのエッジテーブルの始端ノードと終端ノードにインデックスを追加

#2087, 再帰的共通テーブル式の使用でtopology.GetRingEdgesの速度向上

リリース 2.0.1

リリース日: 2012/06/22

この版は誤り訂正版です。2.0.0版以降に送られた問題の処理が行われました。

誤り訂正

#1264, st_dwithin(geog, geog, 0)の訂正。

#1468 shp2pgsql-guiのテーブル、カラム、スキーマの入力テキストボックスがずれる

#1694, clangでのビルドの訂正 (vinceさん)

#1708, PostGIS 2.0より前のバックアップの再格納の改善。

#1714, トポロジでの広い許容範囲の処理の堅牢性向上

#1755, ST_GeographyFromTextの高次元への対応。

#1759, ラスタが有効なデータベースで投影変換されたシェープファイルのロード。

#1761, raster2pgsqlでのNetCDF, HDF4およびHDF5のサブデータセットの処理。

#1763, topology.toTopoGeomで独自のsearch_pathを使っている。

#1766, ST_RemEdge*が周辺のTopoGeometryオブジェクトを破壊しないようにしました。

#1774, エッジ塩ｍ、餌取を不正なものに設定した時のエラーを明確にしました。

#1775, 2頂点を対象とするST_ChangeEdgeGeomの衝突検出。

#1776, ST_SymDifference(empty, geom)がgeomを返すよう訂正。

#1779, SQLコメントファイルをインストールするようにしました。

#1782, ラスタでの空間参照系文字列の処理の訂正。

#1789, ValidateTopologyで、エッジとノードのクロスを虚偽報告する問題を訂正。

#1790, toTopoGeomの重複するプリミティブの処理の訂正

#1791, 非常に近いが重ならない2ポイントを引数に取るST_Azimuthの訂正。

#1797, (ValidateTopology(xxx)).*構文の呼び出しに関する訂正。

#1805, put back the 900913 SRID登録を戻しました。

#1813, メタデータテーブル内の読むことができるリレーションだけを表示するよう変更。

#1819, ST_World2RasterCoordとST_Raster2WorldCoord の浮動小数点数の問題の訂正。

#1820 PostgreSQL 9.2beta1でのコンパイル。

#1822, PostgreSQL 9.2beta1でのトポロジのロード。

#1825, 準備されたジオメトリキャッシュの抽出について訂正

#1829, GeoJSONパーサで初期化されていない値の読み込みの訂正

#1834, ユーザ定義の空間参照系をバックアップするためだけのPostGISエクステンションの改訂

#1839, raster2pgsqlでGeoTIFFのサブデータセットの処理

#1840, raster2pgsqlでタイル数を計算する時機のロジックを訂正

#1851, EPSG:3844の空間参照系パラメータの訂正

#1857, ST_AddEdge*Face*での終点不整合の検出失敗を訂正

#1865, postgis_restore.plで、先頭にダッシュ(訳注: "--")が付く行が欠損する。

#1867, topogeo_add*に不正なトポロジ名を渡した際の例外

#1872, ST_ApproxSummarystatsでゼロで割らないようにしました

#1873, ptarray_locate_pointを、線上にある場合にZ/M補間値を返すよう訂正

#1875, パラメータのcountが0で他が全てNULLの時にST_SummaryStatsがNULLを返す

#1881, shp2pgsql-gui -- 時々、フィールドの編集をきっかけに行が削除される

#1883, ジオコーダのインストールで、create_census_base_tables()を実行し要素すると失敗する (Brian Panullaさん)

性能強化

トポロジ編集関数からの例外メッセージをより詳細にしました。

#1786, ビルドの依存関係を改善

#1806, ST_BuildArea, ST_MakeValidおよびST_GetFaceGeometryの速度向上。

#1812, より安定的なテストのためにLIBLWGEOMにlwgeom_normalizeを追加。

リリース 2.0.0

リリース日: 2012/04/03

メジャーリリースです。ハードアップグレードが必要です。完全なダンプの再読み込みと、古い関数を使用している場合には特別な準備が必要です。アップグレードの詳細はthe section called “ハードアップグレード”をご覧ください。本版の詳細情報や変更/追加された関数についてはthe section called “PostGIS 2.0 で新規作成/機能強化された関数”をご覧ください。

テスター - 影のヒーロー

PostGISコミュニティ内の、このリリースの新しい機能をテストしてくれる勇敢なメンバー多数にお世話になっています。この方々なしにメジャーリリースは成功しえません。

勇敢で、非常に詳細かつ徹底したバグレポートを出し、詳細に分析をしてくれた方々を次に示します。

Andrea Periさん - トポロジの多数のテスト、正確性の確認

Andreas Forø Tollefsenさん - ラスタのテスト

Chris Englishさん - トポロジのローダ機能のストレステスト

Salvatore Larosaさん - トポロジのロバスト性のテスト

Brian Hamlinさん - ベンチマーク (コアに組み込む前の試験ブランチも)、Tigerとトポロジを含む多数の要素の全体的なテスト、多種の仮想サーバ上でのテスト

Mike Peaseさん - Tigerジオコーダのテスト - 問題の非常に詳細な報告

Tom van Tilburgさん - ラスタのテスト

重大/大幅な変更

#722, #302, 多数の非推奨関数の削除 (250関数以上) (Regina Obeさん, Paul Ramseyさん)

不定SRIDを-1から0に変更 (Paul Ramseyさん)

-- (1.2で非推奨になっている) buffer, length, intersectsといったSTの付いていない別名で残っている関数の削除と内部関数の名前変更。

-- 非推奨関数を使っている場合には、アプリケーションを変更して下さい。変更しないと得た結果に苦しむことになります。文書が無い関数は、サポートから外れる関数か内部関数です。古いテーブルの制約で、非推奨関数を使っているものがあります。再格納した際にpopulate_geometry_columns()でテーブルの制約の再構築を行わないといけないことがあります。

#944 geometry_columnsは現在はテーブルでなくビューです (Paul Ramseyさん, Regina Obeさん)。テーブルだった時は古い方法で制約 (SRID, タイプ, 次元)を読み、型修飾子で生成されたジオメトリカラムについては生のカラム定義を読みます。

#1081, #1082, #1084, #1088 - 管理関数が型修飾子ジオメトリカラムの生成関数に対応し、現在は型修飾子による生成がデフォルトです (Regina Obeさん)

#1083 probe_geometry_columns(), rename_geometry_table_constraints(), fix_geometry_columns()を削除 - geometry_columnビューでは廃止されています (Regina Obeさん)

#817 古い3D関数をST_3Dに名前変更 (Nicklas Avénさん)

#548 (sorta), ST_NumGeometries,ST_GeometryNが単一ジオメトリに対してNULLでなく1 (またはジオメトリ)を返す (Sandro Santilliさん, Maxime van Noppenさん)

新機能

KNN GiSTインデクスに基づく重心 (<->)とボックス (<#>)の距離演算子 (Paul Ramseyさん / 資金提供 Vizzuality)

TINと多面体サーフェスの対応と多数の3次元対応関数の強化 (Olivier Courtinさん / Oslandia)

ラスター機能の統合と文書化(Pierre Racineさん, Jorge Arévaloさん, Mateusz Loskotさん, Sandro Santilliさん, David Zwargさん, Regina Obeさん, Bborie Parkさん) (企業の開発者と資金提供: University Laval, Deimos Space, CadCorp, Michigan Tech Research Institute, Azavea, Paragon Corporation, UC Davis Center for Vectorborne Diseases)

空間インデックスを3次元を意識したものに変更 - 作業中 (Paul Ramseyさん, Mark Cave-Aylandさん)

トポロジ機能の改善 (関数の追加)、文書化、テスト (Sandro Santilliさん / Faunalia for RT-SIGTA), Andrea Periさん, Regina Obeさん, Jose Carlos Martinez Llari

3次元関係関数と3次元計測関数 (Nicklas Avénさん)

ST_3DDistance, ST_3DClosestPoint, ST_3DIntersects, ST_3DShortestLine等多数...

N次元空間インデックス (Paul Ramseyさん / OpenGeo)

ST_Split (Sandro Santilliさん / Faunalia for RT-SIGTA)

ST_IsValidDetail (Sandro Santilliさん / Faunalia for RT-SIGTA)

ST_MakeValid (Sandro Santilliさん / Faunalia for RT-SIGTA)

ST_RemoveRepeatedPoints (Sandro Santilliさん / Faunalia for RT-SIGTA)

ST_GeometryNとST_NumGeometriesの非コレクションへの対応 (Sandro Santilliさん)

ST_IsCollection (Sandro Santilliさん, Maxime van Noppenさん)

ST_SharedPaths (Sandro Santilliさん / Faunalia for RT-SIGTA)

ST_Snap (Sandro Santilliさん)

ST_RelateMatch (Sandro Santilliさん / Faunalia for RT-SIGTA)

ST_ConcaveHull (Regina Obe and Leo Hsuさん / Paragon Corporation)

ST_UnaryUnion (Sandro Santilliさん / Faunalia for RT-SIGTA)

ST_AsX3D (Regina Obeさん / Arrival 3D funding)

ST_OffsetCurve (Sandro Santilliさん, Rafal Magdaさん)

ST_GeomFromGeoJSON (Kashif Rasulさん, Paul Ramseyさん / Vizzuality funding)

性能強化

シェープファイルローダについて、無償配布の世界規模のシェープファイルの一部でみられる、切り詰められたマルチバイト値を許容するようにしました (Sandro Santilliさん)

shp2pgsqlの多数の誤り訂正と強化、ローダの回帰テストの増強、インポート時のジオメトリとジオグラフィの両方の投影変換 (Jeff Adamsさん / Azaveaさん, Mark Cave-Aylandさん)

pgsql2shpの事前に定義されたリストからの変換 (Loic Dacharyさん / Mark Cave-Aylandさん)

Shp-pgsql GUIローダ - 複数ファイルを一度にロードするできるようにしました (Mark Leslieさん)

Extras - Tigerジオコーダの、古いTigerの書式から新しいTigerのシェープとファイル構造の書式へのアップグレード (Stephen Frostさん)

Extras - Tigerジオコーダについて、TIGER 2010データ対応、逆ジオコーダ関数の追加、多数の誤り訂正、精度強化、最大結果数の制限、速度改善、ルーティンのロード の改訂(Regina Obeさん, Leo Hsuさん / Paragon Corporation / Hunter Systems Groupからの資金提供)

文書全体の校正と修正 (Kasif Rasulさん)

PostGIS JDBCクラスの整理、Mavenビルドの改訂 (Maria Arias de Reynaさん, Sandro Santilliさん)

誤り訂正

#1335 ST_AddPointがLinuxでは不正な結果を返す (Even Rouaultさん)

リリースの特別クレジット

PostGIS 2.0の公開にあたって経済支援を行ってくれた米国国務省人道情報ユニット (HIU)およびVizzualityに感謝します。

リリース 1.5.4

リリース日: 2012/05/07

この版は誤り訂正版です。1.5.3版以降に送られた問題の処理が行われました。

誤り訂正

#547, ST_Containsのメモリの問題 (Sandro Santilliさん)

#621, ジオグラフィのインタセクトする部分の探索の問題 (Paul Ramseyさん)

#627, 不正なジオメトリでPostGIS/PostgreSQLのプロセスが落ちる (Paul Ramseyさん)

#810, 面積計算の精度向上 (Paul Ramseyさん)

#852, 空間述語のロバスト性の改良 (Sandro Santilliさん, Nicklas Avénさん)

#877, ST_Estimated_Extentが空のテーブルに対してNULLを返す (Sandro Santilliさん)

#1028, ST_AsSVGが失敗するとPostgreSQLサーバプロセス全体を落とす (Paul Ramsey)

#1056, 弧と円のバウンダリボックスを訂正 (Paul Ramseyさん)

#1121, populate_geometry_columnsが非推奨関数を使っている (Regin Obeさん, Paul Ramseyさん)

#1135, テストスィートの予見可能性を改善 (Andreas 'ads' Scherbaumさん)

#1146, 画像生成機能の異常終了 (bronaughさん)

#1170, 北極のインタセクションが失敗する (Paul Ramsey)

#1179, 悪い値を与えるとST_AsTextが異常終了する (kjurka)

#1184, 文書用MakefileでDESTDIRを尊重するように訂正 (Bryce L Nordgrenさん)

#1227, 不正なGMLでサーバが異常終了する

#1252, WKTでSRIDが出現する (Paul Ramseyさん)

#1264, st_dwithin(g, g, 0)が動作しない (Paul Ramseyさん)

#1344, 不正なジオメトリを持つテーブルのエクスポートを許す (Sandro Santilliさん)

#1389, SRID 31300と31370のproj4textが間違っている (Paul Ramseyさん)

#1406, shp2pgsqlでジオグラフィをロードすると異常終了する (Sandro Santilliさん)

#1595, ST_Line_SubStringのSRIDが冗長になるのを訂正 (Sandro Santilliさん)

#1596, UpdateGeometrySRID内のSRIDのチェック (Mike Toewsさん, Sandro Santilliさん)

#1602, ST_PolygonizeをZ値を保持するよう訂正 (Sandro Santilliさん)

#1697, GiSTインデックス内で空エントリがあると異常終了する問題を訂正 (Paul Ramseyさん)

#1772, 崩壊した入力を与えた際のST_Line_Locate_Pointを訂正 (Sandro Santilliさん)

#1799, ST_Segmentizeをmax_length=0から防ぐ (Sandro Santilliさん)

900913のパラメータの順序の変更　(Paul Ramseyさん)

"gmake"でのビルドに対応 (Greg Troxelさん)

リリース 1.5.3

リリース日: 2011/06/25

この版は誤り訂正版です。1.5.2版以降に送られた問題の処理が行われました。PostGIS 1.3以上を実行している場合には、ソフトアップグレードで十分です。そうでない場合には、ハードアップグレードが推奨されます。

誤り訂正

#1056, アークジオメトリからの正しいバウンダリボックスの作成とインデックスの誤り訂正 (Paul Ramseyさん)

#1007, ST_IsValidが異常終了する問題を訂正、GEOS 3.3.0以上か3.2.3以上が必要 (Sandro Santilliさん、報告はBirgit Laggnerさん)

#940, PostgreSQL 9.1 beta 1への対応 (Regina Obeさん、Paul Ramseyさん、パッチはstlさんが提出)

#845, ST_Intersectsの精度の誤り (Sandro Santilliさん、Nicklas Avénさん) cdestigterさんの報告

#884, ST_Within, ST_Intersectsの結果が不安定 (Chris Hodgsonさん)

#779, shp2pgsqlの-Sオプションがポイントでは失敗しているように見える (Jeff Adamsさん)

#666, ST_DumpPointsがNULLセーフでない (Regina Obeさん)

#631, NZの投影を更新してグリッド変換に対応 (jpalmerさん)

#630, ST_Collect内の配列の奇妙なNULL対処 (Chris Hodgsonさん) David Bitnerさん報告

#624, ST_GeogFromTextのメモリリーク (ryangさん, Paul Ramseyさん)

#609, マニュアル5.2節のJavaクライアントのソースが間違っている (simocさん、Regina Obeさん)

#604, shp2pgsqlの利用法表示の添削 (Mike Toewsさん、Paul Ramseyさん)

#573 ラインストリングのグループでST_Unionが失敗する、PostGISでなくGEOS 3.3.0の誤り

#457 ST_CollectionExtractが所望のタイプでないものを返す (Nicklas Avénさん、Paul Ramseyさん)

#441 ST_AsGeoJsonでジオメトリコレクションのバウンダリボックスがおかしい (Olivier Courtinさん)

#411 不正なジオメトリのバックアップできない (Sando Santilliさん) Regione Toscanaさんの報告

#409 ST_AsSVGが劣化している (Olivier Courtinさん) Sdikiyの報告

#373 マニュアルのハードアップグレードで文法誤り (Paul Ramseyさん) psvenssoさんの報告

リリース 1.5.2

リリース日: 2010/09/27

この版は誤り訂正版です。1.5.1版以降に送られた問題の処理が行われました。PostGIS 1.3以上を実行している場合には、ソフトアップグレードで十分です。そうでない場合には、ハードアップグレードが推奨されます。

誤り訂正

ローダ: シェープファイルの空ジオメトリ (頂点が全くない)の扱いの訂正 (Sandro Santilliさん)

#536, ジオグラフィを引数に取るST_Intersects, ST_Covers, ST_CoveredBy およびジオメトリを引数に取るST_Equalsが空間インデックスを使っていない (Regina Obeさん, Nicklas Avenさん)

#573, ジオグラフィを引数に取るST_Containsの改良 (Paul Ramseyさん)

ローダ: Mac GTKビルドでコマンド-qで終了する機能を追加 (Paul Ramseyさん)

#393, ローダ: 大きなDBFファイルのための一時的なパッチを追加 (Maxime Guillaudさん, Paul Ramseyさん)

#507, GeoJSONとGML出力で間違っているOGC URNを訂正 (Olivier Courtinさん)

spatial_ref_sys.sql SRID 3021投影のための測地系変換を追加 (Paul Ramsey)

ジオグラフィ - 全てのジオグラフィが見積もり範囲外である場合に異常終了するのを訂正 (Paul Ramseyさん)

#469, array_aggregationの誤りを訂正 (Greg Starkさん, Paul Ramseyさん)

#532, 一時的なジオグラフィテーブルが他のユーザのセッションから見える (Paul Ramseyさん)

#562, 大きなジオグラフィを引数に取った際のST_Dwithinでエラー (Paul Ramsey)

#513, ローダGUIがDBFのみモードの時に空間インデックスを作ろうとする (Paul Ramseyさん)

#527, ローダGUIは、常にログメッセージを末尾に追加するべき (Mark Cave-Aylandさん)

#504, shp2pgsqlは、xmin/xmaxフィールドの名前を変えるべき (Sandro Santilliさん)

#458, postgis_commentsが版フォルダでなくcontribにインストールされる (Mark Cave-Aylandさん)

#474, ジオグラフィカラムを持つテーブルにanalyzeを実行するとサーバが落ちる (Paul Ramseyさん)

#581, LWGEOMのexpand関数で矛盾した結果が生成される (Mark Cave-Aylandさん)

#513, shp2pgsql-guiへのdbfフィルタの追加とdbfのみのロード機能の追加 (Paul Ramseyさん)

PostgreSQL 9.0に対するビルドのさらなる問題の訂正 (Mark Cave-Aylandさん)

#572, シェープファイルのためのパスワードの空白 (Mark Cave-Aylandさん)

#603, shp2pgsql: "-w"でマルチ系オブジェクトの不正なWKTを生成する (Mark Cave-Aylandさん)

リリース 1.5.1

リリース日: 2010/03/11

この版は誤り訂正版です。1.4.1版以降に送られた問題の処理が行われました。PostGIS 1.3以上を実行している場合には、ソフトアップグレードで十分です。そうでない場合には、ハードアップグレードが推奨されます。

誤り訂正

#410, ST_SetPoint, ST_AddPoint, ST_RemovePointをラインストリングに適用した際に、組み込みバウンダリボックスを更新するようにしました (Paul Ramseyさん)

#411, 不正なジオメトリを持つテーブルのダンプを可能にしました (Sandro Santilliさん, for Regione Toscana-SIGTAさん)

#414, アップグレードスクリプト実行時にgeography_columnsビューを含むようにしました (Paul Ramseyさん)

#419, ST_Line_Substringがマルチラインストリング対応になりました (Paul Ramseyさん, Lidwala Consulting Engineersのみなさん)

#421, ST_AsGML()の文字列長の計算の訂正 (Olivier Courtinさん)

#441, 複数種類を持つコレクションからのGML生成を訂正 (Olivier Courtinさん)

#443, GML3での座標値が逆になる (Olivier Courtinさん)

#450, #451, 日付変更線をまたぐジオグラフィ型地物の面積計算が間違っている (Paul Ramseyさん)

間もなくリリースされる PostgreSQL 9.0への対応 (Paul Ramseyさん)

リリース 1.5.0

リリース日: 2010/02/04

このリリースでは、新しいGEOGRAPHY型を介した地理座標 (緯度/経度)への対応、能率強化、新しい入力書式対応 (GML, KML)、全体的な維持が行われました。

API安定性

PostGISのパブリックAPIはマイナーリリース (0.0.X)の間は変更しません

=~演算子をジオメトリ等価性チェックからバウンダリボックス等価性チェックに変更

互換性

GEOS, Proj4およびLibXML2は必須となりました

次に示すライブラリのバージョンは、PostGIS 1.5で必要となる最低限です

全てのプラットフォームでPostgreSQL 8.3以上

GEOS 3.1以上のみ (全ての機能の利点を得るにはGEOS 3.2以上)

新しいST_GeomFromGML/KML関数に関連してLibXML2 2.5以上

Proj4 4.5以上のみ

新機能

the section called “PostGIS 1.5 で新規作成/機能強化された関数”

ハウスドルフ距離計算の追加 (#209) (Vincent Picavetさん)

ST_Buffer処理で、一方のみのバッファリングと他のバッファリングスタイルに対応するためのパラメータの追加 (Sandro Santilliさん)

可視化と解析の関数に関連した、他の距離の追加 (Nicklas Avenさん)

ST_ClosestPoint

ST_DFullyWithin

ST_LongestLine

ST_MaxDistance

ST_ShortestLine

ST_DumpPoints (Maxime van Noppenさん)

ST_GeomFromGMLとST_GeomFromKMLを介したGML, KMLの入力 (Olivier Courtinさん)

ST_CollectionExtractによる同種のコレクションの抽出 (Paul Ramseyさん)

ST_AddMeasureによる既存のラインストリングへのM値の追加 (Paul Ramseyさん)

utilsでのヒストリテーブルの実装 (George Silvaさん)

ジオグラフィ型と対応関数

球面アルゴリズム (Dave Skeaさん)

オブジェクト/インデックス実装 (Paurl Ramseyさん)

選択度の実装 (Mark Cave-Aylandさん)

KML, GMLおよびJSONへのシリアライズ (Olivier Courtin)

ST_Area, ST_Distance, ST_DWithin, ST_GeogFromText, ST_GeogFromWKB, ST_Intersects, ST_Covers, ST_Buffer (Paul Ramseyさん)

性能強化

ST_Distanceの能率改善 (Nicklas Avenさん)

文書の更新と改善 (Regina Obeさん、Kevin Neufeldさん)

テストと品質管理 (Regina Obe)

PostGIS 1.5のPostgreSQL 8.5 trunkへの対応( Guillaume Lelargeさん)

shp2pgsql-guiの中核のWin32対応と改善 (Mark Cave-Aylandさん)

適切な'make check'対応 (Paul Ramseyさん)

誤り訂正

http://trac.osgeo.org/postgis/query?status=closed&milestone=PostGIS+1.5.0&order=priority

リリース 1.4.0

リリース日: 2009/07/24

このリリースでは、能率改善、内部構造とテストの改善、新機能、文書の更新が行われました。PostGIS 1.1以上を実行している場合には、ソフトアップグレードで十分です。そうでない場合には、ハードアップグレードが推奨されます。

API安定性

1.4リリース以降は、PostGISの公開APIはマイナーリリースの間は変更しません。

互換性

PostGIS 1.4に必須の*最低*のバージョン

全てのプラットフォームのPostgreSQL 8.2以上

GEOS 3.0以上のみ

PROJ4 4.5以上のみ

新機能

GEOS 3.1以上でコンパイルした場合には、ST_Union()で高速なカスケードユニオンを使うようにしました (Paul Ramseyさん)

ST_ContainsProperly()はGEOS 3.1以上が必要です

ST_Intersects(), ST_Contains(), ST_Within()について、GEOS 3.1以上で高速なキャッシュジオメトリを使うようにしました (Paul Ramseyさん / 資金提供 Zonar Systems)

文書とマニュアルの大幅改善 (Regina ObeさんとKevin Neufeldさん)

マニュアル内の図とダイアグラム (Kevin Neufeldさん)

正当性評価に失敗した場合の、人が読める説明を返すST_IsValidReason() (Paul Ramseyさん)

ジオメトリからgeohash.orgの符号を返すST_GeoHash() (Paul Ramseyさん)

シェープファイルをロードするためのGTK+マルチプラットフォームGUI (Paul Ramseyさん)

交差方向を返すST_LineCrossingDirection() (Paul Ramseyさん)

Z軸に基づく部分列を返すST_LocateBetweenElevations() (Paul Ramseyさん)

ジオメトリのパーサが文法エラーの位置に関する明示的なエラーメッセージを返すようにしました (Mark Cave-Aylandさん)

JSON書式のジオメトリを返すST_AsGeoJSON() (Olivier Courtinさん)

Populate_Geometry_Columns() -- テーブルとビューについて自動的にgeometry_columnsに追加するようにしました (Kevin Neufeldさん)

ST_MinimumBoundingCircle() --包含する円ポリゴンをより小さくできるようにしました (Bruce Rindahlさん)

性能強化

核のジオメトリシステムを独立したライブラリliglwgeomに移動 (Mark Cave-Aylandさん)

PostgreSQLのビルドブートストラップコマンドpgxsを使った新しいビルドシステム

デバッグフレームワークの形式化と単純化 (Mark Cave-Aylandさん)

クロスプラットフォーム対応を用意にするためにヘッダに全てのビルド時の#defineをコンフィギュア時に生成しヘッダに入れるようにしました

ログ作成フレームワークの形式化と単純化 (Mark Cave-Aylandさん)

CIRCULARSTRING, COMPOUNDCURVEとCURVEPOLYGONの対応の拡張と安定性向上、パースの改善、対応関数強化 (Mark LeslieさんとMark Cave-Aylandさん)

OpenSolarisビルドへの対応改善 (Paul Ramseyさん)

MSVCビルドの対応改善 (Mateusz Loskot)

KML対応の更新 (Olivier Courtin)

liblwgeom用ユニットテストフレームワーク (Paul Ramseyさん)

全てのPostGIS関数を包括的に試験できる新しい試験フレームワーク (Regine Obeさん)

全てのジオメトリ集約関数の能率改善 (Paul Ramseyさん)

まもなく登場するPostgreSQL 8.4の対応 (Mark Cave-Aylandさん, Talha Bin Rizwanさん)

shp2pgsqとpgsql2shpをliblwgeomのパース/アンパースの共通部分に依存させるために再作成しました。 (Mark Cave-Aylandさん)

PDF文書のビルドと予備的なビルドの説明にPDF DbLaTeXを使用するようにしました (Jean David Techerさん)

ユーザ文書 (PDFとHTML)とDoxygen開発者文書の自動ビルド (Kevin Neufeldさん)

ImageMagickによるWKTジオメトリテキストファイルから文書画像への自動ビルド (Kevin Neufeldさん)

HTML文書用CSSをより魅力的にしました (Dane Springmeyerさん)

誤り訂正

http://trac.osgeo.org/postgis/query?status=closed&milestone=PostGIS+1.4.0&order=priority

リリース 1.3.6

リリース日: 2009/05/04

PostGIS 1.1以上を実行している場合には、ソフトアップグレードで十分です。そうでない場合には、ハードアップグレードが推奨されます。このリリースでは、PostgreSQL 8.4への対応、シェープファイルへの出力時のprjファイル出力とが追加され、shp2pgsqlの異常終了に関する訂正と、曲線タイプの処理とdbfファイルだけのインポートでの論理エラーとに関する小さな誤り訂正、AddGeometryColumnsのエラー処理の改善がなされています。

リリース 1.3.5

リリース日: 2008/12/15

PostGIS 1.1以上を実行している場合には、ソフトアップグレードで十分です。そうでない場合には、ハードアップグレードが推奨されます。このリリースは誤り訂正リリースです。ST_ForceCollectionの実行失敗への対応と、MapServerでラインストリングのレイヤを使う場合に重大な影響を受ける関連関数への対応を行っています。

リリース 1.3.4

リリース日: 2008/11/24

このリリースでは、GeoJSON出力とPostgreSQL 8.4でのビルドへの対応、文書品質と出力の美しさの改善、関数レベルのSQL文書を追加し、空間述語の性能改善 (ポリゴン内のポイントのテスト)が行われました。

誤り訂正として、多数の関数で曲線ラインストリングの処理で異常終了する問題、メモリリーク、線形参照が頂点上での計測で失敗する問題等の排除が挙げられます。詳細についてはNEWSファイルをご覧下さい。

リリース 1.3.3

リリース日: 2008/04/12

このリリースでは、shp2gpsqlの誤り訂正、SVGとKMLへの対応の強化、ST_SimplifyPreserveTopology関数の追加、GEOSの版に注意を払ったビルド、厳格かつ稀な失敗ケースの訂正が行われました。

リリース 1.3.2

リリース日: 2007/12/01

このリリースでは、ST_EndPoint()とST_Envelope()の誤り訂正、JDBCビルドとOS/Xへの対応の改善、GML3出力を含むST_AsGML()でのGML出力の対応の改善が行われました。

リリース 1.3.1

リリース日: 2007/08/13

このリリースでは、以前のリリースでの見落としていた、版番号、文書、タグ等に関する問題の訂正が行われました。

リリース 1.3.0

リリース日: 2007/08/09

このリリースでは、空間関係関数の性能改善、新しい空間関係関数の追加、関数名のSQL-MMへの変換 (空間型(Spatial Type)前置辞 (SP)を使います)が行われました。

機能追加

JDBC: Hibernate Dialectの追加 (Norman Barkerさんに感謝)

空間関係関数ST_CoversとST_CoveredByの追加。こららの関数の説明と根拠はhttp://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.htmlにあります。

空間関係関数ST_DWithinの追加。

性能強化

ST_Contains, ST_Intersects, ST_WithinとST_Disjoint用のキャッシュとインデックスを用いたポリゴン内ポイントの簡略版の追加

空間関係関数のインラインインデックス対応の追加 (ST_Disjointを除く)

他の変更

ジオメトリアクセサと処理関数における曲線ジオメトリ対応の拡張

空間型 (ST)前置辞を使用するSQL-MM命名規則への移動の開始。

PostgreSQL 8.3への最初の対応

リリース 1.2.1

リリース日: 2007/01/11

このリリースでは、PostgreSQL 8.2対応の誤り訂正と若干の性能改善が行われています。

変更

Within()のポリゴン内ポイントの短縮動作の訂正。

PostgreSQL 8.2のインデックスに対するNULL処理の訂正。

RPM specファイルの更新。

Transform()で処理を行わなくて良い場合の短縮版を追加。

JDBC: 多次元ジオメトリに対するJTS処理の訂正 (Thomas Martiさんのヒントと部分的なパッチに感謝)。さらに、Javadocがコンパイルされ同梱されるようになりました。GCJ使用時のCLASSPATH問題が訂正されました。pgjdbc 8.2互換性への対応の訂正、JDK 1.3以前の対応欠落の訂正が行われました。

リリース 1.2.0

リリース日: 2006/12/08

このリリースでは、SQL-MM定義の曲線ジオメトリのシリアライズ/デシリアライズ能力に沿ったタイプ定義と、性能改善が行われました。

変更

シリアライズ/デシリアライズの曲線ジオメトリタイプへの対応を追加

性能改善のためにContains()とWithin()にポリゴン内ポイントの短縮版を追加してました。

リリース 1.1.6

リリース日: 2006/11/02

これは誤り訂正のリリースです。特に64ビット機におけるGEOSインタフェースの重大なエラーを訂正しています。SRSパラメータの更新と投影変換の改善 (Z軸を取る)が行われました。アップグレードが必要です。

アップグレード

1.0.3以上からアップグレードする場合には、soft upgradeの手続きを行います。

1.0.0RC6から1.0.2までのリリースからアップグレードする場合には、リリース 1.0.3にあるアップグレードをご覧ください。

1.0.0RC6より前のリリースからのアップグレードは、ハードアップグレードが必要です。

誤り訂正

64ビット機で壊れていたCAPIの訂正

ローダ/ダンパ: 回帰テストと使用法出力の訂正

JDBCにおけるsetSRID()の誤り訂正、Thomas Martiさんに感謝

他の変更

投影変換でのZ軸の使用

spatial_ref_sys.sqlをEPSG 6.11.1に更新

全体のためのバージョン変数を単一で使うためVersion.config基盤を単純化

ローダ/ダンパの使用法メッセージにVersion.configを含むようにしました

手作りで脆いJDBCのバージョンパーサをPropertiesに置き換え

リリース 1.1.5

リリース日: 2006/10/13

誤り訂正版です。Win32での重大なセグメンテーション違反を含みます。アップグレードは推奨されます。

アップグレード

1.0.3以上からアップグレードする場合には、soft upgradeの手続きを行います。

1.0.0RC6から1.0.2までのリリースからアップグレードする場合には、リリース 1.0.3にあるアップグレードをご覧ください。

1.0.0RC6より前のリリースからのアップグレードは、ハードアップグレードが必要です。

誤り訂正

PostgreSQL 8.2用でコンパイルした際に発生する、Win32上のpgsql2shpでセグメンテーション違反を引き起こすMingWのリンクの誤りの訂正

JavaのGeometry.equals()メソッドでNULLポインタ例外が発生する問題を訂正

GPL要求「変更の好まれる形式」の配布を満たすようEJB3Spatial.odtを追加

JDBC JTSコードから用いられていない同期を削除。

shp2pgsql/pgsql2shpのREADMEファイルが非常に古くなっていたのを、マニュアルページにマージして更新。

JDBCの版のタグが"1.1.4"なのに"1.1.3"になっていた問題を訂正。

新機能

非マルチ系ジオメトリのための-Sオプションをshp2pgsqlに追加

リリース 1.1.4

リリース日: 2006/09/27

Javaインタフェースでのいくつかの改善を含む誤り訂正版です。アップグレードは推奨されます。

アップグレード

1.0.3以上からアップグレードする場合には、soft upgradeの手続きを行います。

1.0.0RC6から1.0.2までのリリースからアップグレードする場合には、リリース 1.0.3にあるアップグレードをご覧ください。

1.0.0RC6より前のリリースからのアップグレードは、ハードアップグレードが必要です。

誤り訂正

PostgreSQL 8.2対応で訂正

collect()関数の入力のSRIDを捨てる問題を訂正

MakeBox2dとMakeBox3dでSRID合致確認を追加

GEOS 3.0.0が通るよう回帰テストの訂正

pgsql2shp同時実行の改善。

Javaの変更

SRID処理への新しいJTS開発者の姿勢を反映したJTS対応の再作業。コードの単純化とGNU Trove依存のビルドの削除。

"Geodetix s.r.l. Company"からの寄付によるEJB2対応の追加

Norman Barker <nbarker@ittvis.com>さんの寄付によるEJB3チュートリアル/例の追加

Javaディレクトリ編成の若干の再編

リリース 1.1.3

リリース日: 2006/06/30

誤り訂正リリースです。新しい関数 (特にロングトランザクション対応)とポータビリティ強化を含みます。アップグレードは推奨されます。

アップグレード

1.0.3以上からアップグレードする場合には、soft upgradeの手続きを行います。

1.0.0RC6から1.0.2までのリリースからアップグレードする場合には、リリース 1.0.3にあるアップグレードをご覧ください。

1.0.0RC6より前のリリースからのアップグレードは、ハードアップグレードが必要です。

誤り訂正/修正

distance(ポリゴン, ポリゴン)で誤った結果となる誤り訂正

pgsql2shpの成功時の終了ステータスの誤り訂正。

shp2gpsqlにおけるマルチラインWKTの処理の誤り訂正

affine()でバウンディングボックス更新がある場合に失敗する誤り訂正

WKTパーサ: EMPTY要素を持つマルチ系ジオメトリの構築の禁止(GEOMETRYCOLLECTIONは対応)。

新機能

ロングトランザクション対応の新規追加。

DumpRings()関数の新規追加。

AsHEXEWKB(geom, XDR|NDR)関数の新規追加。

JDBC変更

回帰テストの改善: マルチポイントとXY以外の座標値

JDBCコードの小規模な訂正

全てのフィールドを今後非公開にする準備として適切なアクセサ関数の追加

他の変更

ローダ/ダンパに対応する新しい回帰テスト。

コンフィギュアスイッチ--with-proj-libdirと--with-geos-libdirの追加。

Tru64のビルドへの対応。

文書生成のためにJadeを使用。

pgsql2shpを求める以上のライブラリにリンクしないようにしました。

PostgreSQL 8.2への最初の対応。

リリース 1.1.2

リリース日: 2006/03/30

誤り訂正リリースで、新しい関数とポータビリティ強化を含みます。アップグレードは推奨されます。

アップグレード

1.0.3以上からアップグレードする場合には、soft upgradeの手続きを行います。

1.0.0RC6から1.0.2までのリリースからアップグレードする場合には、リリース 1.0.3にあるアップグレードをご覧ください。

1.0.0RC6より前のリリースからのアップグレードは、ハードアップグレードが必要です。

誤り訂正

SnapToGrid()内の出力バウンディングボックスの計算の誤り訂正

EnforceRHR()の誤り訂正

JDBC2のJTSコード内のSRID処理の訂正

64ビット対応の訂正

新機能

回帰試験をPostGISのインストール*前に*実行できるようになりました

新しいafiine()行列変形関数

新しいrotate{,X,Y,Z}()関数

古い翻訳とaffine()を内部で使用している拡大縮小関数

pgsql 8.0.0以上に対するビルドで、estimated_extent()内にアクセス制御を埋め込みました

他の変更

./configureスクリプトをよりポータブルにしました

./run_testスクリプトを、デフォルトの振る舞いがより健全になるよう変更しました

リリース 1.1.1

リリース日: 2006/01/23

重要な誤り訂正リリースです。アップグレードを強くお勧めします。前の版では、postgis_restore.plにハードアップグレードを阻害する誤りがあります。また、GEOS 2.2以上のコネクタで、ジオメトリコレクションのオブジェクトがトポロジ演算子で使われるのを阻害される誤りがあります。

アップグレード

1.0.3以上からアップグレードする場合には、soft upgradeの手続きを行います。

1.0.0RC6から1.0.2までのリリースからアップグレードする場合には、リリース 1.0.3にあるアップグレードをご覧ください。

1.0.0RC6より前のリリースからのアップグレードは、ハードアップグレードが必要です。

誤り訂正

postgis_restore.plで早すぎるexitがある誤り訂正

GEOS-CAPIコネクタのジオメトリコレクションの処理に関する誤り訂正

Solaris 2.7とMingWへの対応を改善

line_locate_point()の誤り訂正

PostgreSQLのパスの処理を訂正

line_substring()の誤り訂正

回帰テストで局所化されたクラスタへの対応を追加

新機能

line_substring()でZ値とM値の補間を新規追加

line_interpolate_point()でZ値とM値の補間を新規追加

OpenGISのあいまいさのためNumInteriorRing()の別名を追加

リリース 1.1.0

リリース日: 2005/12/21

多数の改善と新規追加が行われたマイナーリリースです。最も注意して頂きたいのは、ビルド手続きが非常に単純化したこと、transform()の速度が大幅に改善したこと、GEOSとの接続の安定化 (CAPI対応)、多数の新規関数、トポロジ対応の草案、です。

PostGISをインストールする前にGEOS-2.2.xにアップグレードすることを強くお勧めします。これによって、将来のGEOSのアップグレードでPostGISライブラリの再構築が必要になることが無くなることが保証されます。

貢献者

このリリースには、Mark Cave Aylandさんからのproj4オブジェクトのキャッシュ機能のコードが含まれています。Markus Schaberさんは、JDBC2コードの多数の改善点を追加しました。Alex Bodnaruさんは、PostgreSQLソース依存の除去を助け、Debianのspecファイルを提供しました。Michael Fuhrさんは、Solarisアーキテクチャの新しい点をテストしました。David TecherさんとGerald Fenoyさんは、GEOS C言語APIコネクタの試験を助けました。Hartmut Tschaunerは、azimuth()関数のコードを提供しました。Devrim GUNDUZさんは、RPMのspecファイルを提供しました。Carl Andersonさんは、新しい面構築関数の作成を助けました。より多くの貢献者情報については他の貢献者をご覧下さい。

アップグレード

1.0.3以降から更新する場合には、ダンプ/リロードは不要です。全ての存在するデータベースで、新しいlwpostgis_upgrade.sqlスクリプトが単純に取り込まれます。詳細情報についてはソフトアップグレードの章をご覧下さい。

1.0.0RC6から1.0.2までのリリースからアップグレードする場合には、リリース 1.0.3にあるアップグレードをご覧ください。

1.0.0RC6より前のリリースからのアップグレードは、ハードアップグレードが必要です。

新しい関数

translate()が使用する関数scale()とtransscale()

line_substring()

line_locate_point()

M(point)

LineMerge(geometry)

shift_longitude(geometry)

azimuth(geometry)

locate_along_measure(geometry, float8)

locate_between_measures(geometry, float8, float8)

ポイントによるオフセットを行うSnapToGrid (4次元まで対応)

BuildArea(any_geometry)

OGC BdPolyFromText(linestring_wkt, srid)

OGC BdMPolyFromText(linestring_wkt, srid)

RemovePoint(linestring, offset)

ReplacePoint(linestring, offset, point)

誤り訂正

polygonize()のメモリリークの誤り訂正

キャスト関数lwgeom_as_anytypeの誤り訂正

psotgis_version()の出力のUSE_GEOS, USE_PROJ , USE_STATS要素を常にライブラリの状態に合わせるよう誤り訂正

関数の内容の変更

SnapToGridにおける高次元値を破棄しなくなりました

Z()関数を、Z値を持たない場合にNULLを返すよう変更

速度改善

transform()関数の大幅な高速化、proj4オブジェクトのキャッシュ機能

AddGeometryColumns()とupdate_geometry_stats()からのfix_geometry_columns()の自動呼出しの削除

JDBC2での作業

Mkaefileの改善

JTS対応の改善

回帰テストシステムの改善

ジオメトリコレクションの基本的な整合性検査メソッド

(HEX)(E)wkbへの対応

HexWKB / EWKT の切り替えのための自動検出機能DriverWrapper

古いJDKリリースのValueSetterで発生するコンパイルの誤り訂正。

EWKTコンストラクタを"SRID=4711;"といった表現を受け取れるよう誤り訂正

予備的な読み込み専用のJava2Dのジオメトリへの対応

他の新しいこと

PostgreSQLソース依存を除去した完全なautoconfを用いたコンフィギュレーション

GEOS C-API対応 (2.2.0以上)

トポロジモデリングの最初の対応

DebianとRPMのspecファイル

lwpostgis_upgrade.sqlスクリプトの追加

他の変更

JTS対応の改善

DBFとSQLの間における整数と文字列の属性の対応付けの厳格化

回帰テスト群の範囲拡大と見やすさ改善

古いjdbcコードはこの版で削除

postgis_proc_upgrade.plの直接の使用を廃止

スクリプトの版とリリースの版とを合わせました

リリース 1.0.6

リリース日: 2005/12/06

若干の誤り訂正と改善があります

アップグレード

1.0.3以降から更新する場合には、ダンプ/リロードは不要です。

1.0.0RC6から1.0.2までのリリースからアップグレードする場合には、リリース 1.0.3にあるアップグレードをご覧ください。

1.0.0RC6より前のリリースからのアップグレードは、ハードアップグレードが必要です。

誤り訂正

コレクションのデシリアライザでpalloc(0)を呼ぶ誤り訂正 (--enable-cassertがある場合のみ)

バウンディングボックスキャッシュ処理の誤り訂正

geom_accum(NULL, NULL)のセグメンテーション違反の誤り訂正

addPoint()のセグメンテーション違反の誤り訂正

lwcollection_clone()の短時間メモリ確保の訂正

segmentize()の誤り訂正

SnapToGrid出力の固定バウンディングボックスの計算

改善

PostgreSQL 8.2への最初の対応

GEOSオプションでSRID整合性検査が無かったのを追加

リリース 1.0.5

リリース日: 2005/11/25

ライブラリにおけるメモリのアラインメントの訂正、ローダのUTF8属性値の処理におけるセグメンテーション違反の訂正、若干の改善と整理を行っています。

Note

shp2pgsqlのコードを以前の版からUNIX標準に適合する (成功時に0を返す)ように変更

アップグレード

1.0.3以降から更新する場合には、ダンプ/リロードは不要です。

1.0.0RC6から1.0.2までのリリースからアップグレードする場合には、リリース 1.0.3にあるアップグレードをご覧ください。

1.0.0RC6より前のリリースからのアップグレードは、ハードアップグレードが必要です。

ライブラリの変更

メモリのアラインメントの訂正

アナライザにおける少量のNULL値の計算の訂正

低水準関数getPoint4d_p()の小さな誤り訂正

シリアライズ関数の速度向上

force_3dm(), force_3dz() およびorce_4d()における誤り訂正

ローダの変更

shp2pgsqlの終了ステータスに関する誤り訂正

ローダの後方互換に関する誤りを訂正 (NULLシェープファイルのロード)

DBFの数値の属性値について最後にドットが付く場合の処理の誤りを訂正

shp2pgsql (utf8エンコーディング)でのセグメンテーション違反が出る誤りを訂正

他の変更

スキーマ対応のpostgis_proc_upgrade.pl、PostgreSQL 7.2以上に対応

マニュアルに「問題を報告する 」の章を追加

リリース 1.0.4

リリース日: 2005/09/09

重大な誤り訂正と若干の改善があります。特に、大きな地理空間テーブルでのGiSTインデックスの構築で起こるメモリリークを訂正しています。

アップグレード

1.0.3から更新する場合には、ダンプ/リロードは不要です。

1.0.0RC6から1.0.2までのリリースからアップグレードする場合には、リリース 1.0.3にあるアップグレードをご覧ください。

1.0.0RC6より前のリリースからのアップグレードは、ハードアップグレードが必要です。

誤り訂正

GiSTインデックスのメモリリーク

proj4のtransform()処理でのセグメンテーション違反の誤り訂正

spatial_ref_sysのproj4の誤り訂正 (+projが無かった)

ローダ: 文字列関数の使用の訂正、NULLオブジェクトチェックの改定、MULTILINESTRING入力でのセグメンテーション違反になる誤りの訂正。

MakeLineの次元処理に関する誤り訂正

translate()で出力バウンディングボックスが壊れることに関する誤り訂正

改善

文書の改善

選択度推測器の堅牢性向上

distance()の少しの速度向上

小規模な整理

GiSTインデックスの整理

BOX3Dパーサでより緩い構文を受け付けるようにしました

リリース 1.0.3

リリース日: 2005/08/08

いくつかの誤り訂正 - 格納されているジオメトリの正しさに厳しい影響を与えるものを含みます - および若干の改善。

アップグレード

バウンディングボックスの計算ルーティンの誤りのため、データベースにキャッシュされているバウンディングボックスが正しくない可能性があり、アップグレード手続きでは特別な注意が必要となりました。

ハードアップグレード手続き (ダンプ/リロード)によって、全てのバウンディングボックス (ダンプ内にない)の再計算が強制的に行われます。これは、1.0.0RC6より前のリリースからのアップグレードには必要です。

1.0.0RC6以上からアップグレードする場合には、このリリースには、ジオメトリのバウンディングボックスの再計算と、その結果として発生する変更を伝播させる全ての処理を強制するPerlスクリプト(utils/rebuild_bbox_caches.pl)を持っています。インストール後にこのスクリプトを実行します (引数無しで走らせるとヘルプが出ます)。もしくは、utils/postgis_proc_upgrade.pを実行して、PostGISのプロシージャと関数を更新します (ソフトアップグレードを参照して下さい)。

誤り訂正

lwgeomの2次元バンディングボックス計算の厳しい誤り訂正

ローダのWKT (-w)ポイント処理の誤り訂正

64ビット機のダンパの誤り訂正

ユーザ定義クエリの処理を行うダンパの誤り訂正

create_undef.plスクリプトの誤り訂正

改善

カノニカル入力関数の少しの能率改善

ローダの小規模な整理

ローダの多バイト文字によるフィールド名への対応

postgis_restore.plスクリプトの改善

ユーティリティスクリプトrebuild_bbox_caches.plの再構築

リリース 1.0.2

リリース日: 2005/07/04

若干の誤り訂正と改善があります

アップグレード

1.0.0RC6から更新する場合には、ダンプ/リロードは不要です。

前のリリースからアップグレードするにはダンプ/リロードが必要です。詳細についてはアップグレードをご覧下さい。

誤り訂正

B木オプションの誤り許容

pg_errorでのメモリリーク

R木インデックスの訂正

ビルドスクリプトの整理 (CFLAGSとCXXFLAGSの混在の回避)

改善

ローダにおける新しいインデックス生成機能 (-lスイッチ)

PostgreSQL 8.1devへの最初の対応

リリース 1.0.1

リリース日: 2005/05/24

若干の誤り訂正といくつかの改善があります。

アップグレード

1.0.0RC6から更新する場合には、ダンプ/リロードは不要です。

前のリリースからアップグレードするにはダンプ/リロードが必要です。詳細についてはアップグレードをご覧下さい。

ライブラリの変更

length_spheroid()の3次元計算の誤り訂正

JOIN選択推定器の誤り訂正

他の変更追加

shp2pgsqlのエスケープ関数の誤り訂正

複数スキーマで同時発生するPostGISに対するより良い対応

文書の訂正

jdbc2: コンパイル時に"-target 1.2 -source 1.2"をデフォルトとするよう変更

pgsql2shpの-kスイッチの追加

postgis_restore.plの独自のcreatedへの対応

pgsql2shp属性名の一意性強制の誤り訂正

NTF (Paris)の投影定義の誤り訂正

postgis_restore.plの整理

リリース 1.0.0

リリース日: 2005/04/19

最後の1.0.0リリースです。若干の誤り訂正、ローダのいくつかの改良 (古いPostGISへの対応が特筆すべき点)、文書の追加がありました。

アップグレード

1.0.0RC6から更新する場合には、ダンプ/リロードは不要です。

前のリリースからアップグレードするにはダンプ/リロードが必要です。詳細についてはアップグレードをご覧下さい。

ライブラリの変更

transform()が不規則なメモリアドレスを解放する問題を訂正

force_3dm()のメモリ確保が必要より小さい問題を訂正

JOIN選択度見積もりの誤り (デフォルト値、メモリリーク、行カウント、SD)訂正

他の変更追加

shp2pgsqlがタブまたはシングルクォートで始まる値を読み飛ばす誤りを訂正

マニュアルへのローダ/ダンパの追加

古い (HWGEOM)PostGISに対応するshp2gsql

shp2pgsqlのフラグに -p (prepare)を追加

マニュアルにOGC互換の強制に関する新章追加

JTSライブラリに対応する新しいautoconf

推測器のテストの誤り訂正 (LWGEOMとスキーマの構文解析への対応)

リリース 1.0.0RC6

リリース日: 2005/03/30

1.0.0の6番目のリリース候補、若干の誤り訂正と整理を行っています。

アップグレード

前のリリースからアップグレードするにはダンプ/リロードが必要です。詳細についてはアップグレードをご覧下さい。

ライブラリの変更

multi()の誤り訂正

noop時にmulti()からの早い復帰

スクリプトの変更

{x,y}{min,max}(box2d)関数の削除

他の変更

postgis_restore.plスクリプトの誤り訂正

64ビット対応のダンパの誤り訂正

リリース 1.0.0RC5

リリース日: 2005/03/25

1.0.0の5番目のリリース候補、若干の誤り訂正と改善があります。

アップグレード

1.0.0RC4から更新する場合には、ダンプ/リロードは不要です。

前のリリースからアップグレードするにはダンプ/リロードが必要です。詳細についてはアップグレードをご覧下さい。

ライブラリの変更

box3d計算の問題 (セグメンテーションフォールト)の訂正 (ほかにもあります)

estimated_extent()でのセグメンテーションフォールトの訂正

他の変更

ビルドスクリプトとユーティリティの若干の改良

性能向上に関する技法の文章の追加

リリース 1.0.0RC4

リリース日: 2005/03/18

1.0.0の4番目のリリース候補、誤り訂正と若干の改善があります。

アップグレード

前のリリースからアップグレードするにはダンプ/リロードが必要です。詳細についてはアップグレードをご覧下さい。

ライブラリの変更

geom_accum()のセグメンテーションフォールトの誤り訂正

64ビットアーキテクチャ対応の誤り訂正

コレクションを引数に取るbox3d計算関数の誤りの訂正

副問い合わせの選択度推定への対応

force_collectionからの早い復帰

SnapToGrid()の一貫性検査の訂正

Box2d出力精度を15桁に後退

スクリプトの変更

distance_sphere()の追加

get_proj4_from_sridの実装をSQLからPL/pgSQLに変更

他の変更

ローダとダンパのMULTOLINEシェープの処理の問題を訂正

ローダでポリゴンの最初の穴を読み飛ばす誤りを訂正

jdbc2: コードの整理、Makefileの改善

FLEX変数とYACC変数がpgsqlのMakefile.globalが取り込まれた*後*で、pgsqlの*空白を除いた*ものが空文字列と評価された場合に限って設定される

既に作成されていたパーサの追加

ビルドスクリプトの改良

Version.configの改善を中心とした版処理の改善

postgis_restore.plの改善

リリース 1.0.0RC3

リリース日: 2005/02/24

1.0.0の3番目のリリース候補、多数の誤り訂正と改善があります。

アップグレード

前のリリースからアップグレードするにはダンプ/リロードが必要です。詳細についてはアップグレードをご覧下さい。

ライブラリの変更

transform()でSRIDが消える問題を訂正、エラー処理を改善。

メモリアラインメントのハンドリングに関する誤り訂正

force_collection()で単純な (単一)ジオメトリ型でMapServerの接続が切れる問題を訂正。

GeometryFromText()でbboxキャッシュを追加しない誤り訂正。

box2d出力の精度低下。

pgsqlで異常終了する問題を避けるため、DEBUGマクロにPGIS_の前置辞を付加

GEOS2POSTGISコンバータのリークを訂正

pallocで確保したクエリコンテキストのメモリを早く開放することによるメモリ使用の削減

スクリプトの変更

PostgreSQL 7.2のインデックスのバインディングを訂正しました。

PG72での動作と、1テーブルに複数カラムの場合への対応のため、probe_geometry_columns()の誤り訂正

boolからtextへのキャストの更新

動作効率改善のため、いくつかの関数をSTABLEからIMMUTABLEに変更

JDBC変更

jdbc2: 小さなパッチ、box2d/box3dの試験、文書とライセンスの改定

jdbc2: pgjdbc 8.0の型の自動登録の誤り訂正とテストケース作成

jdbc2: 古いjdkリリースでの構築を有効にするためためにjdk1.4使用箇所の削除

jdbc2: pg72jdbc2.jarに対するビルドへの対応の追加

jdbc2: Makefileの更新と無駄の除去

jdbc2: JTSジオメトリクラス対応のベータ版を追加

jdbc2: 古いPostGISサーバに対して失敗するのが判明しているテストをスキップするようにしました。

jdbc2: EWKTのM値を持つジオメトリの処理の訂正

他の変更

性能向上に関する技法の新章追加

ドキュメント更新: pgsql72に必要なもの、lwpostgis.sql

autoconfの若干の変更

BUILDDATE抽出の移植可能範囲を広げました

spatial_ref_sys.sqlを訂正してvacuumが全体のデータベースに及ぶのを避けるようにしました。

spatial_ref_sys: NTF (Paris)を0.xで配布していたものに合うよう変更。

リリース 1.0.0RC2

リリース日: 2005/01/26

1.0.0の第2リリース候補版。誤り訂正と若干の改善。

アップグレード

前のリリースからアップグレードするにはダンプ/リロードが必要です。詳細についてはアップグレードをご覧下さい。

ライブラリの変更

ポイント配列からのbox3d計算に関する誤り訂正

distance_spheroid定義に関する誤り訂正

bboxキャッシュ更新がtransform()無かったことに関する誤り訂正

新しいJDBCドライバ (jdbc2)

後方互換のためのGEOMETRYCOLLECTION(EMPTY)書式への対応

バイナリ出力の高速化

OGC WKB/WKTコンストラクタの厳格化

スクリプトの変更

lwpostgis.sql内でのSTABLE, IMMUTABLE, STRICTの訂正

OGC WKB/WKTコンストラクタの厳格化

他の変更

ローダ (i18n、非i18nの両方)の高速化と堅牢化

最初のautoconfスクリプト

リリース 1.0.0RC1

リリース日: 2005/01/13

最初のPostGISメジャーリリース候補版。格納領域の低減とインデックス使用クエリの高速化のためのPostGIS型の内部格納の再設計。

アップグレード

前のリリースからアップグレードするにはダンプ/リロードが必要です。詳細についてはアップグレードをご覧下さい。

変更

標準形式入力パースの高速化。

標準形式出力の可逆化。

PostgreSQL 7.3以上でのEWKBの標準形式バイナリ入出力対応。

4次元座標以上の対応、可逆shapefile->postgis->shapefile変換。

新関数: UpdateGeometrySRID(), AsGML(), SnapToGrid(), ForceRHR(), estimated_extent(), accum().

垂直方向位置インデックス演算子。

JOIN選択関数。

ジオメトリコンストラクタとエディタの強化。

PostGISエクステンションAPI。

ローダのUTF-8対応。