postgis 3.5 - en to ja translation catalogue (4838 entries)

note: Tag: title
en: PostGIS Administration
ja: PostGIS管理

note: Tag: title
en: Configuring raster support
ja: ラスタ機能の設定

note: Tag: para
en: If you enabled raster support you may want to read below how to properly configure it.
ja: ラスタ機能を有効にしたら、下に示す確実な設定方法を読んだ方がいいです。

note: Tag: para
en: As of PostGIS 2.1.3, out-of-db rasters and all raster drivers are disabled by default. In order to re-enable these, you need to set the following environment variables <varname>POSTGIS_GDAL_ENABLED_DRIVERS</varname> and <varname>POSTGIS_ENABLE_OUTDB_RASTERS</varname> in the server environment. For PostGIS 2.2, you can use the more cross-platform approach of setting the corresponding <xref linkend="PostGIS_GUC"/>.
ja: PostGIS 2.1.3以降では、データベース外ラスタと全てのラスタドライバは、デフォルトでは無効になっています。これらを有効にするには、サーバ上で、環境変数 <varname>POSTGIS_GDAL_ENABLED_DRIVERS</varname>と<varname>POSTGIS_ENABLE_OUTDB_RASTERS</varname>を設定します。PostGIS 2.2では、<xref linkend="PostGIS_GUC"/>に従って設定する、クロスプラットフォームな手法があります。

note: Tag: para
en: If you want to enable offline raster:
ja: データベース外ラスタを有効にするには次のようにします:

note: Tag: para
en: Any other setting or no setting at all will disable out of db rasters.
ja: 他の値を入れたり、値を入れない場合には、データベース外ラスタは無効になります。

note: Tag: para
en: In order to enable all GDAL drivers available in your GDAL install, set this environment variable as follows
ja: インストールしたGDALのドライバを有効にするには、次の環境変数を設定します:

note: Tag: para
en: If you want to only enable specific drivers, set your environment variable as follows:
ja: 一部のドライバのみ有効にしたい場合には、環境変数を次のように設定します:

note: Tag: para
en: If you are on windows, do not quote the driver list
ja: Windows環境の場合は、ドライバリストに引用符をつけないで下さい

note: Tag: para
en: Setting environment variables varies depending on OS. For PostgreSQL installed on Ubuntu or Debian via apt-postgresql, the preferred way is to edit <filename>/etc/postgresql/<replaceable>10</replaceable>/<replaceable>main</replaceable>/environment</filename> where 10 refers to version of PostgreSQL and main refers to the cluster.
ja: 環境変数の設定はOSによって異なります。UbuntuまたはDebian上でapt-postgresqlを経由したPostgreSQLのインストールについては、<filename>/etc/postgresql/<replaceable>10</replaceable>/<replaceable>main</replaceable>/environment</filename>を編集するのが好ましい方法です。 ここで、10はPostgreSQLのバージョンを指し、mainはクラスタを指します。

note: Tag: para
en: On windows, if you are running as a service, you can set via System variables which for Windows 7 you can get to by right-clicking on Computer-&gt;Properties Advanced System Settings or in explorer navigating to <varname>Control Panel\All Control Panel Items\System</varname>. Then clicking <emphasis>Advanced System Settings -&gt;Advanced-&gt;Environment Variables</emphasis> and adding new system variables.
ja: Windowsでサービスとして実行している場合には、システム変数で設定します。Windows 7では、コンピュータを右クリックしてプロパティをクリックするか、エクスプローラの検索バーに<varname>コントロール パネル\すべてのコントロール パネル項目\システム</varname>を指定します。 それから、<emphasis>システムの詳細設定 -&gt; 詳細設定 -&gt; 環境変数 </emphasis>を順にクリックして、新しいシステム環境変数を追加します。

note: Tag: para
en: After you set the environment variables, you'll need to restart your PostgreSQL service for the changes to take effect.
ja: 環境変数を設定した後は、設定を反映させるために、PostgreSQLサービスの再起動が必要です。

note: Tag: title
en: Creating spatial databases
ja: 空間データベースの作成

note: Tag: title
en: Spatially enable database using EXTENSION
ja: エクステンションを使って空間データベースを有効にする

note: Tag: para
en: If you are using PostgreSQL 9.1+ and have compiled and installed the extensions/postgis modules, you can turn a database into a spatial one using the EXTENSION mechanism.
ja: PostgreSQL 9.1以上を使っていて、エクステンションのPostGISモジュールをコンパイル、インストールしている場合には、エクステンションというメカニズムを使用して、データベースを空間データベースに切り替えることができます。

note: Tag: para
en: Core postgis extension includes geometry, geography, spatial_ref_sys and all the functions and comments. Raster and topology are packaged as a separate extension.
ja: 中核となるPostGISエクステンションには、ジオメトリ、ジオグラフィ、spatial_ref_sysおよび全ての関数とコメントが含まれています。ラスタとトポロジは別のエクステンションになっています。

note: Tag: para
en: Run the following SQL snippet in the database you want to enable spatially:
ja: 空間データベースにしたいデータベース上で次のSQLを実行します:

note: Tag: title
en: Spatially enable database without using EXTENSION (discouraged)
ja: エクステンションを使わずに空間データベースを有効にする (お勧めできません)

note: Tag: para
en: This is generally only needed if you cannot or don't want to get PostGIS installed in the PostgreSQL extension directory (for example during testing, development or in a restricted environment).
ja: これは、通常はPostgreSQLのエクステンションのディレクトリ内にPostGISをインストールできないか、したくない場合 (たとえばテスト中や開発中、または制限のある環境内)にのみ必要となります。

note: Tag: para
en: Adding PostGIS objects and function definitions into your database is done by loading the various sql files located in <filename>[prefix]/share/contrib</filename> as specified during the build phase.
ja: ビルドの際に指定した<filename>[prefix]/share/contrib</filename>内にある様々なSQLファイルをロードしてPostGISオブジェクトと関数の定義をデータベースに追加します。

note: Tag: para
en: The core PostGIS objects (geometry and geography types, and their support functions) are in the <filename>postgis.sql</filename> script. Raster objects are in the <filename>rtpostgis.sql</filename> script. Topology objects are in the <filename>topology.sql</filename> script.
ja: 中核のPostGISオブジェクト (ジオメトリ型とジオグラフィ型、これらに対応する関数)は<filename>postgis.sql</filename>スクリプトにあります。ラスタオブジェクトは<filename>rtpostgis.sql</filename>スクリプトにあります。トポロジオブジェクトは<filename>topology.sql</filename>スクリプトにあります。

note: Tag: para
en: For a complete set of EPSG coordinate system definition identifiers, you can also load the <filename>spatial_ref_sys.sql</filename> definitions file and populate the <varname>spatial_ref_sys</varname> table. This will permit you to perform ST_Transform() operations on geometries.
ja: 完全なEPSG座標系定義IDセットについては、<filename>spatial_ref_sys.sql</filename>定義ファイルをロードして<varname>spatial_ref_sys</varname>テーブルを生成して下さい。これによりジオメトリ関数ST_Transform()が実行できるようになります。

note: Tag: para
en: If you wish to add comments to the PostGIS functions, you can find them in the <filename>postgis_comments.sql</filename> script. Comments can be viewed by simply typing <command>\dd [function_name]</command> from a <command>psql</command> terminal window.
ja: PostGIS関数にコメントを追加したい場合には、<filename>postgis_comments.sql</filename>スクリプト内のコメントが見つかると思います。コメントは<command>psql</command>のターミナルウィンドウから単に<command>\dd [関数名]</command>と打ち込むだけで見ることができます。

note: Tag: para
en: Run the following Shell commands in your terminal:
ja: ターミナルで次のシェルコマンドを実行します:

note: Tag: title
en: Upgrading spatial databases
ja: 空間データベースのアップグレード

note: Tag: para
en: Upgrading existing spatial databases can be tricky as it requires replacement or introduction of new PostGIS object definitions.
ja: 既存の空間データベースのアップグレードは、新しいPostGISオブジェクト定義の置き換えや導入を必要とするとき、慎重を要することがあります。

note: Tag: para
en: Unfortunately not all definitions can be easily replaced in a live database, so sometimes your best bet is a dump/reload process.
ja: 不幸なことに、定義の全てが実行中のデータベース内で簡単には置き換えられるわけではないので、ダンプ/リロードが最善策となることがあります。

note: Tag: para
en: PostGIS provides a SOFT UPGRADE procedure for minor or bugfix releases, and a HARD UPGRADE procedure for major releases.
ja: PostGISには、マイナーバージョンアップやバグフィクスリリースの場合に使うソフトアップグレードと、メジャーアップグレードで使うハードアップグレードが用意されています。

note: Tag: para
en: Before attempting to upgrade PostGIS, it is always worth to backup your data. If you use the -Fc flag to pg_dump you will always be able to restore the dump with a HARD UPGRADE.
ja: PostGISをアップグレードしようとする前にデータのバックアップを取ることは、常に価値のあるものです。pg_dumpで -Fc フラグを使うと、ハードアップグレードによってダンプを常にリストアすることができます。

note: Tag: title
en: Soft upgrade
ja: ソフトアップグレード

note: Tag: para
en: If you installed your database using extensions, you'll need to upgrade using the extension model as well. If you installed using the old sql script way, you are advised to switch your install to extensions because the script way is no longer supported.
ja: エクステンションを使ってデータベースをインストールした場合には、エクステンションモデルでアップグレードしなければなりません。 古いSQLスクリプトを使ってインストールした場合には、SQLスクリプトは既にサポートされていませんので、エクステンションに切り替えるべきです。

note: Tag: title
en: Soft Upgrade 9.1+ using extensions
ja: 9.1以上でエクステンションを使ったソフトアップグレード

note: Tag: para
en: If you originally installed PostGIS with extensions, then you need to upgrade using extensions as well. Doing a minor upgrade with extensions, is fairly painless.
ja: エクステンションを使ってPostGISをインストールした場合には、エクステンションを使ってアップグレードする必要があります。エクステンションを使ったマイナーアップグレードはかなり楽です。

note: Tag: para
en: If you are running PostGIS 3 or above, then you should use the <xref linkend="PostGIS_Extensions_Upgrade"/> function to upgrade to the latest version you have installed.
ja: PostGIS 3以上を実行している場合には、<xref linkend="PostGIS_Extensions_Upgrade"/>関数を使ってインストールしているもののうち最新の版にアップグレードすべきです。

note: Tag: para
en: If you are running PostGIS 2.5 or lower, then do the following:
ja: PostGIS 2.5以前を実行している場合には、次のようにします:

note: Tag: para
en: If you have multiple versions of PostGIS installed, and you don't want to upgrade to the latest, you can explicitly specify the version as follows:
ja: インストールされたPostGISに複数のバージョンがあり、最新版にアップグレードしたくない場合には、明示的なバージョンの指定ができます。次のようにします:

note: Tag: para
en: If you get an error notice something like:
ja: 次のようなエラー通知が表示されることがあります。

note: Tag: para
en: Then you'll need to backup your database, create a fresh one as described in <xref linkend="create_new_db_extensions"/> and then restore your backup on top of this new database.
ja: この場合は、データベースをバックアップして、 <xref linkend="create_new_db_extensions"/> に記述されているように新しいデータベースを生成し、バックアップを新しいデータベースにリストアしなければなりません。

note: Tag: para
en: If you get a notice message like:
ja: 次のようなメッセージを得ることがあります:

note: Tag: para
en: Then everything is already up to date and you can safely ignore it. <emphasis role="bold">UNLESS</emphasis> you're attempting to upgrade from an development version to the next (which doesn't get a new version number); in that case you can append "next" to the version string, and next time you'll need to drop the "next" suffix again:
ja: この場合は、全てアップデートされていて、安全に無視できます。SVN版から次版 (新しい版番号を得ていないもの)にアップグレードしようと<emphasis role="bold">しない限り</emphasis>、"next"を版文字列に追加できますが、次回に"next"を削除する必要があります:

note: Tag: para
en: If you installed PostGIS originally without a version specified, you can often skip the reinstallation of postgis extension before restoring since the backup just has <code>CREATE EXTENSION postgis</code> and thus picks up the newest latest version during restore.
ja: PostGISをバージョン指定なしにインストールした場合には、 しばしば再格納の前のPostGIS EXTENSIONの再インストールをとばすことができます。 バックアップは<code>CREATE EXTENSION postgis</code>だけで、リストアの間に最新版になります。

note: Tag: para
en: If you are upgrading PostGIS extension from a version prior to 3.0.0, you will have a new extension <emphasis>postgis_raster</emphasis> which you can safely drop, if you don't need raster support. You can drop as follows:
ja: PostGISエクステンションを3.0.0より前からアップグレードする場合には、ラスタ機能が不要なら、安全に削除できる新しい <emphasis>postgis_raster</emphasis>エクステンションを持つことになります。次のようにします:

note: Tag: title
en: Soft Upgrade Pre 9.1+ or without extensions
ja: 9.1より前またはエクステンションを使わないソフトアップグレード

note: Tag: para
en: This section applies only to those who installed PostGIS not using extensions. If you have extensions and try to upgrade with this approach you'll get messages like:
ja: PostGISをエクステンションを使わずにインストールした人向けです。エクステンションを使っていてこの方法を使うと、次のようなメッセージが現れます:

note: Tag: para
en: NOTE: if you are moving from PostGIS 1.* to PostGIS 2.* or from PostGIS 2.* prior to r7409, you cannot use this procedure but would rather need to do a <link linkend="hard_upgrade">HARD UPGRADE</link>.
ja: ご注意: PostGIS 1.*またはr7429以前のPostGIS 2.*へ移行する場合には、この手続きを使うことができませんが、<link linkend="hard_upgrade">ハードアップグレード</link>を実行する必要があります。

note: Tag: para
en: After compiling and installing (make install) you should find a set of <filename>*_upgrade.sql</filename> files in the installation folders. You can list them all with:
ja: コンパイルとインストール (make install)の実行後に、インストール先フォルダ内にある<filename>*_upgrade.sql</filename>のファイルの集合を見つけておくべきです。次のコマンドで一覧を得られます:

note: Tag: para
en: Load them all in turn, starting from <filename>postgis_upgrade.sql</filename>.
ja: <filename>postgis_upgrade.sql</filename>から順番に全てをロードします。

note: Tag: para
en: The same procedure applies to raster, topology and sfcgal extensions, with upgrade files named <filename>rtpostgis_upgrade.sql</filename>, <filename>topology_upgrade.sql</filename> and <filename>sfcgal_upgrade.sql</filename> respectively. If you need them:
ja: 同じ手続きをラスタ、トポロジ、SFCGALエクステンションに適用します。それぞれのファイル名は<filename>rtpostgis_upgrade.sql</filename>, <filename>topology_upgrade.sql</filename>, <filename>sfcgal_upgrade.sql</filename>になります。必要な場合は次のように実行します:

note: Tag: para
en: You are advised to switch to an extension based install by running
ja: エクステンションによるインストールに変更した方が良いです。次のようにします:

note: Tag: para
en: If you can't find the <filename>postgis_upgrade.sql</filename> specific for upgrading your version you are using a version too early for a soft upgrade and need to do a <link linkend="hard_upgrade">HARD UPGRADE</link>.
ja: 求める版へのアップグレードに使う特定の<filename>postgis_upgrade.sql</filename>が発見できない場合には、ソフトアップグレードを実行するにはあまりに前の版を使っています。<link linkend="hard_upgrade">ハードアップグレード</link>が必要です。

note: Tag: para
en: The <xref linkend="PostGIS_Full_Version"/> function should inform you about the need to run this kind of upgrade using a "procs need upgrade" message.
ja: <xref linkend="PostGIS_Full_Version"/>関数の"procs need upgrade"というメッセージで、この種のアップグレードを実行する必要性についての情報が得られます。

note: Tag: title
en: Hard upgrade
ja: ハードアップグレード

note: Tag: para
en: By HARD UPGRADE we mean full dump/reload of postgis-enabled databases. You need a HARD UPGRADE when PostGIS objects' internal storage changes or when SOFT UPGRADE is not possible. The <link linkend="release_notes">Release Notes</link> appendix reports for each version whether you need a dump/reload (HARD UPGRADE) to upgrade.
ja: ハードアップグレードとは、PostGISで利用可能なデータの完全なダンプ/リロードを意味します。PostGISオブジェクトの内部格納状態が変更される場合や、ソフトアップグレードができない場合に、ハードアップグレードが必要です。付録の<link linkend="release_notes">リリースノート</link>に、版ごとについて、ダンプ/リロード (ハードアップグレード)の要否を記載しています。

note: Tag: para
en: The dump/reload process is assisted by the postgis_restore script which takes care of skipping from the dump all definitions which belong to PostGIS (including old ones), allowing you to restore your schemas and data into a database with PostGIS installed without getting duplicate symbol errors or bringing forward deprecated objects.
ja: ダンプ/リロード作業はpostgis_restoreスクリプトが補助します。このスクリプトは、PostGIS (古いものを含む)に属する定義を全て飛ばします。また、重複シンボルエラーや非推奨オブジェクトを持越すことなく、スキーマとデータをPostGISをインストールしたデータベースにリストアできます 。

note: Tag: para
en: Supplementary instructions for windows users are available at <link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiWinUpgrade">Windows Hard upgrade</link>.
ja: Windows用に関する追加情報は <link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiWinUpgrade">Windows Hard upgrade</link>にあります。

note: Tag: para
en: The Procedure is as follows:
ja: 手続きは次の通りです:

note: Tag: para
en: Create a "custom-format" dump of the database you want to upgrade (let's call it <varname>olddb</varname>) include binary blobs (-b) and verbose (-v) output. The user can be the owner of the db, need not be postgres super account.
ja: アップグレードしたデータベース (<varname>olddb</varname>と呼ぶことにしましょう)の「カスタム書式」のダンプを、バイナリBLOBデータを含めたダンプを指定して (-b)、verboseモード (-v)で生成します。ユーザはデータベースのオーナーになることができ、PostgreSQLのスーパーユーザである必要はありません。

note: Tag: para
en: Do a fresh install of PostGIS in a new database -- we'll refer to this database as <varname>newdb</varname>. Please refer to <xref linkend="create_new_db"/> and <xref linkend="create_new_db_extensions"/> for instructions on how to do this.
ja: 新しいデータベースにPostGISを、PostGISが無い状態からインストールします。このデータベースを<varname>newdb</varname>と呼ぶことにします。この作業に関する説明については<xref linkend="create_new_db"/>と<xref linkend="create_new_db_extensions"/>とを参照して下さい。

note: Tag: para
en: The spatial_ref_sys entries found in your dump will be restored, but they will not override existing ones in spatial_ref_sys. This is to ensure that fixes in the official set will be properly propagated to restored databases. If for any reason you really want your own overrides of standard entries just don't load the spatial_ref_sys.sql file when creating the new db.
ja: ダンプにあるspatial_ref_sysは、リストアされますが、既にあるspatial_ref_sysを上書きしません。リストア対象のデータベースに公式データセットの訂正が確実に伝わるようにするためです。標準のエントリを上書きしたい場合は、newdbを生成する際にspaltial_ref_sys.sqlファイルをロードしないだけです。

note: Tag: para
en: If your database is really old or you know you've been using long deprecated functions in your views and functions, you might need to load <filename>legacy.sql</filename> for all your functions and views etc. to properly come back. Only do this if _really_ needed. Consider upgrading your views and functions before dumping instead, if possible. The deprecated functions can be later removed by loading <filename>uninstall_legacy.sql</filename>.
ja: データベースが本当に古く、ビューや関数に、長く非推奨になっている関数があるような場合には、関数やビューを使えるようにする<filename>legacy.sql</filename>をロードする必要があるでしょう。ただし、本当に必要な場合に限ります。可能なら、ビューや関数をダンプせずにアップグレードすることを検討して下さい。非推奨関数は、<filename>uninstall_legacy.sql</filename>で後から削除することができます。

note: Tag: para
en: Restore your backup into your fresh <varname>newdb</varname> database using postgis_restore. Unexpected errors, if any, will be printed to the standard error stream by psql. Keep a log of those.
ja: バックアップを新しい<varname>newdb</varname>データベースにリストアするには、postgis_restoreを使います。psqlが予期せぬエラーを標準エラー出力に出すことがあります。これらのログを保存しておいて下さい。

note: Tag: para
en: Errors may arise in the following cases:
ja: エラーは次の場合に起こりえます:

note: Tag: para
en: Some of your views or functions make use of deprecated PostGIS objects. In order to fix this you may try loading <filename>legacy.sql</filename> script prior to restore or you'll have to restore to a version of PostGIS which still contains those objects and try a migration again after porting your code. If the <filename>legacy.sql</filename> way works for you, don't forget to fix your code to stop using deprecated functions and drop them loading <filename>uninstall_legacy.sql</filename>.
ja: ビューまたは関数の中に非推奨のPostGISオブジェクトを使っているものがある場合。これの訂正には、リストア前に<filename>legacy.sql</filename>スクリプトのロードを試してみることができます。非推奨オブジェクトをまだ持っている版のPostGISにリストアして、コードを作り替えた後に再び移動させることもできます。<filename>legacy.sql</filename>を利用する場合は、非推奨関数を使うのをやめたコードに訂正して、<filename>uninstall_legacy.sql</filename>をロードするのを忘れないでください。

note: Tag: para
en: Some custom records of spatial_ref_sys in dump file have an invalid SRID value. Valid SRID values are bigger than 0 and smaller than 999000. Values in the 999000.999999 range are reserved for internal use while values &gt; 999999 can't be used at all. All your custom records with invalid SRIDs will be retained, with those &gt; 999999 moved into the reserved range, but the spatial_ref_sys table would lose a check constraint guarding for that invariant to hold and possibly also its primary key ( when multiple invalid SRIDS get converted to the same reserved SRID value ).
ja: ダンプファイル内のspatial_ref_sysにあるカスタムレコードが不正なSRIDになっていることがあります。妥当なSRID値は0より大きく999000より小さくなります。999000から999999の間は内部利用のための予約領域ですが、SRID値 &gt; 999999 の場合は、その値は一切使用できません。全ての不正なSRIDを持つ独自レコードは、SRID値 &gt; 999999 の場合は予約領域に移動して、保持されます。しかし、spatial_ref_sysテーブルから、値が保持されるように設定されているチェック制約が外れます。場合によっては (複数の不正なSRIDが同じ予約領域のSRID値に変換されるとき)、主キーも外れます。

note: Tag: para
en: In order to fix this you should copy your custom SRS to a SRID with a valid value (maybe in the 910000..910999 range), convert all your tables to the new srid (see <xref linkend="UpdateGeometrySRID"/>), delete the invalid entry from spatial_ref_sys and re-construct the check(s) with:
ja: これを修正するために、独自のSRSを妥当な値 (910000..910999の範囲)のSRIDに複写し、全てのテーブルを新しいSRIDに変更 (<xref linkend="UpdateGeometrySRID"/>)し、spatial_ref_sysから不正なエントリを削除します。そして、次のようにチェック制約を再構築します:

note: Tag: para
en: If you are upgrading an old database containing french <link xlink:href="https://en.wikipedia.org/wiki/Institut_g%C3%A9ographique_national"> IGN </link> cartography, you will have probably SRIDs out of range and you will see, when importing your database, issues like this :
ja: フランス<link xlink:href="https://en.wikipedia.org/wiki/Institut_g%C3%A9ographique_national">IGN</link>地図を含む古いデータベースをアップグレードする場合には、おそらくSRIDが範囲外になり、データベースのインポート時に次のような問題に遭遇します:

note: Tag: para
en: In this case, you can try following steps : first throw out completely the IGN from the sql which is resulting from postgis_restore. So, after having run :
ja: この場合には、次のステップを試すことができます。最初にpostgis_restoreから出たIGNをSQLから完全に破棄します。そのために次のコマンドを実行します:

note: Tag: para
en: run this command :
ja: 次のコマンドを実行します:

note: Tag: para
en: Create then your newdb, activate the required Postgis extensions, and insert properly the french system IGN with : <link xlink:href="https://raw.githubusercontent.com/Remi-C/IGN_spatial_ref_for_PostGIS/master/Put_IGN_SRS_into_Postgis.sql"> this script </link> After these operations, import your data :
ja: その後、新しいデータベースを生成し、必要なPostGISエクステンションを有効化して、<link xlink:href="https://raw.githubusercontent.com/Remi-C/IGN_spatial_ref_for_PostGIS/master/Put_IGN_SRS_into_Postgis.sql">このスクリプト</link>で確実にフランスIGNの系を挿入します。これらの処理の後、次のようにデータのインポートを行います:

note: Tag: title
en: Performance Tuning
ja: パフォーマンスチューニング

note: Tag: para
en: Tuning for PostGIS performance is much like tuning for any PostgreSQL workload. The only additional consideration is that geometries and rasters are usually large, so memory-related optimizations generally have more of an impact on PostGIS than other types of PostgreSQL queries.
ja: PostGISの調整はPostgreSQLの作業量の調整と非常に似ています。ジオメトリとラスタは重く、メモリ関連の最適化は他のPostgreSQLクエリと比べて影響が大きい点だけは留意して下さい。

note: Tag: para
en: For general details about optimizing PostgreSQL, refer to <link xlink:href="https://wiki.postgresql.org/wiki/Tuning_Your_PostgreSQL_Server">Tuning your PostgreSQL Server</link>.
ja: PostgreSQLの最適化に関する一般的な詳細は、 <link xlink:href="https://wiki.postgresql.org/wiki/Tuning_Your_PostgreSQL_Server">Tuning your PostgreSQL Server</link>をご覧ください。

note: Tag: para
en: For PostgreSQL 9.4+ configuration can be set at the server level without touching <code>postgresql.conf</code> or <code>postgresql.auto.conf</code> by using the <code>ALTER SYSTEM</code> command.
ja: PostgreSQL 9.4以上では、<code>ALTER SYSTEM</code>を使うことで、<code>postgresql.conf</code>や<code>postgresql.auto.conf</code>を触ることなくサーバレベルで設定できます。

note: Tag: para
en: In addition to the Postgres settings, PostGIS has some custom settings which are listed in <xref linkend="PostGIS_GUC"/>.
ja: PostgreSQLの設定に加えて、PostGISには <xref linkend="PostGIS_GUC"/>で挙げる独自設定があります。

note: Tag: title
en: Startup
ja: 起動時

note: Tag: para
en: These settings are configured in <code>postgresql.conf</code>:
ja: 次に示す設定は<code>postgresql.conf</code>にあります:

note: Tag: para
en: Default: partition
ja: デフォルト: partition

note: Tag: para
en: This is generally used for table partitioning. The default for this is set to "partition" which is ideal for PostgreSQL 8.4 and above since it will force the planner to only analyze tables for constraint consideration if they are in an inherited hierarchy and not pay the planner penalty otherwise.
ja: 一般的にテーブルのパーティショニングに使われます。デフォルトとして"partition"に設定されています。継承階層内にあり、プランナにペナルティ以外を払わないなら、クエリプランナにテーブルの制約条件の解析だけを行わせるので、PostgreSQL 8.4以上ではこれが理想的です。

note: Tag: para
en: Default: ~128MB in PostgreSQL 9.6
ja: デフォルト: PostgreSQL 9.6では128MB以下

note: Tag: para
en: Set to about 25% to 40% of available RAM. On windows you may not be able to set as high.
ja: 利用可能なRAMの25%から40%を設定します。Windowsでは高く設定することができないかも知れません。

note: Tag: para
en: <link xlink:href="https://www.postgresql.org/docs/current/static/runtime-config-resource.html#GUC-MAX-WORKER-PROCESSES">max_worker_processes</link> This setting is only available for PostgreSQL 9.4+. For PostgreSQL 9.6+ this setting has additional importance in that it controls the max number of processes you can have for parallel queries.
ja: <link xlink:href="https://www.postgresql.org/docs/current/static/runtime-config-resource.html#GUC-MAX-WORKER-PROCESSES">max_worker_processes</link> これは、PostgreSQL 9.4以上で有効です。PostgreSQL 9.6以上では、パラレルクエリ処理に使うプロセス数の最大値の制御で、さらに重要なものとなっています。

note: Tag: para
en: Default: 8
ja: デフォルト: 8

note: Tag: para
en: Sets the maximum number of background processes that the system can support. This parameter can only be set at server start.
ja: システムが対応できるバックグラウンドプロセスの最大値を設定します。このパラメータはサーバ起動時のみ設定できます。

note: Tag: title
en: Runtime
ja: 実行時

note: Tag: para
en: <link xlink:href="http://www.postgresql.org/docs/current/static/runtime-config-resource.html#GUC-WORK-MEM">work_mem</link> - sets the size of memory used for sort operations and complex queries
ja: <link xlink:href="http://www.postgresql.org/docs/current/static/runtime-config-resource.html#GUC-WORK-MEM">work_mem</link> - 並べ替えや複雑なクエリに使われるメモリのサイズの設定

note: Tag: para
en: Default: 1-4MB
ja: デフォルト: 1-4MB

note: Tag: para
en: Adjust up for large dbs, complex queries, lots of RAM
ja: 大きなデータベースの場合や、複雑なクエリの場合、RAMが多い場合は値を大きくするように調整します。

note: Tag: para
en: Adjust down for many concurrent users or low RAM.
ja: 同時接続ユーザ数が多い場合や、RAMが少ない場合には値を小さくするように調整します。

note: Tag: para
en: If you have lots of RAM and few developers:
ja: たくさんのRAMを持ち、少数の開発者しかいない場合は次のようにします。

note: Tag: para
en: <link xlink:href="http://www.postgresql.org/docs/current/static/runtime-config-resource.html#GUC-MAINTENANCE-WORK-MEM">maintenance_work_mem</link> - the memory size used for VACUUM, CREATE INDEX, etc.
ja: <link xlink:href="http://www.postgresql.org/docs/current/static/runtime-config-resource.html#GUC-MAINTENANCE-WORK-MEM">maintenance_work_mem</link> - VACUUM, CREATE INDEX等で使われるメモリのサイズ

note: Tag: para
en: Default: 16-64MB
ja: デフォルト: 16-64MB

note: Tag: para
en: Generally too low - ties up I/O, locks objects while swapping memory
ja: 一般的には低すぎます - メモリスワップの間、入出力が拘束され、オブジェクトがロックされます

note: Tag: para
en: Recommend 32MB to 1GB on production servers w/lots of RAM, but depends on the # of concurrent users. If you have lots of RAM and few developers:
ja: たくさんのRAMを持つ本番サーバでは32MBから1GBが推奨ですが、同時接続ユーザ数に依存します。たくさんのRAMを持ち、少数の開発者しかいない場合は次のようにします:

note: Tag: para
en: This setting is only available for PostgreSQL 9.6+ and will only affect PostGIS 2.3+, since only PostGIS 2.3+ supports parallel queries. If set to higher than 0, then some queries such as those involving relation functions like <code>ST_Intersects</code> can use multiple processes and can run more than twice as fast when doing so. If you have a lot of processors to spare, you should change the value of this to as many processors as you have. Also make sure to bump up <code>max_worker_processes</code> to at least as high as this number.
ja: この設定はPostgreSQL 9.6以上で使用でき、並列クエリに対応しているPostGIS 2.3以上に影響は限られます。0より大きい値に設定すると、<code>ST_Intersects</code>といった関係関数を含むクエリで、複数プロセッサが使われるようにできます。その時、2倍を超える速度が出る可能性があります。予備のプロセッサが多数ある場合には、この値をプロセッサ数に変更するべきです。また、<code>max_worker_processes</code>をこの値と同じにするようにします。

note: Tag: para
en: Default: 0
ja: デフォルト: 0

note: Tag: para
en: Sets the maximum number of workers that can be started by a single <varname>Gather</varname> node. Parallel workers are taken from the pool of processes established by <varname>max_worker_processes</varname>. Note that the requested number of workers may not actually be available at run time. If this occurs, the plan will run with fewer workers than expected, which may be inefficient. Setting this value to 0, which is the default, disables parallel query execution.
ja: 単一の<varname>Gather</varname>ノードが開始できるワーカの最大数を設定します。並列ワーカは、<varname>max_worker_processes</varname>で確立されたプロセスのプールから取得されます。要求したワーカ数は、実際には実行可能になっていない場合があることに注意して下さい。これが発生する場合には、想定より少ないワーカでプランが実行され、非効率になります。これの値を0 (デフォルト値)にすると、パラレルクエリ実行が無効になります。

note: Tag: title
en: PostGIS Extras
ja: PostGIS追加機能

note: Tag: para
en: This chapter documents features found in the extras folder of the PostGIS source tarballs and source repository. These are not always packaged with PostGIS binary releases, but are usually PL/pgSQL based or standard shell scripts that can be run as is.
ja: 本章では、PostGISのソースアーカイブとソースレポジトリのextrasフォルダにある機能を記述します。 これらは必ずPostGISバイナリ版に同梱されているものではありませんが、通常は実行可能なplpgsqlベースのものまたは標準的なシェルスクリプトです。

note: Tag: title
en: Address Standardizer
ja: 住所標準化

note: Tag: para
en: This is a fork of the <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-11.html">PAGC standardizer</link> (original code for this portion was <link xlink:href="http://sourceforge.net/p/pagc/code/360/tree/branches/sew-refactor/postgresql">PAGC PostgreSQL Address Standardizer</link>).
ja: これは、<link xlink:href="http://www.pagcgeo.org/docs/html/pagc-11.html">PAGC standardizer</link>から分かれたものです (オリジナルのコードは<link xlink:href="http://sourceforge.net/p/pagc/code/360/tree/branches/sew-refactor/postgresql">PAGC PostgreSQL Address Standardizer</link>にあります)。

note: Tag: para
en: The address standardizer is a single line address parser that takes an input address and normalizes it based on a set of rules stored in a table and helper lex and gaz tables.
ja: 住所標準化は単一行の住所のパーサで、入力に住所を取り、テーブルに保存された規則と、補助テーブルlex (lexicon, 語彙)およびgaz (gazetteer, 地名集)とを基に正規化します。

note: Tag: para
en: The code is built into a single PostgreSQL extension library called <code>address_standardizer</code> which can be installed with <code>CREATE EXTENSION address_standardizer;</code>. In addition to the address_standardizer extension, a sample data extension called <code>address_standardizer_data_us</code> extensions is built, which contains gaz, lex, and rules tables for US data. This extensions can be installed via: <code>CREATE EXTENSION address_standardizer_data_us;</code>
ja: コードは、<code>address_standardizer</code>という名前の、一つのPostgreSQLエクステンションとしてビルドされます。<code>CREATE EXTENSION address_standardizer;</code>でインストールできます。address_standardizerエクステンションとともに、<code>address_standardizer_data_us</code>というサンプルデータのエクステンションがビルドされます。これには、アメリカのgaz, lexとrulesテーブルデータがあります。このエクステンションは<code>CREATE EXTENSION address_standardizer_data_us;</code>でインストールできます。

note: Tag: para
en: The code for this extension can be found in the PostGIS <filename>extensions/address_standardizer</filename> and is currently self-contained.
ja: このエクステンションのコードはPostGISの<filename>extensions/address_standardizer</filename>内にあり、現在は自己充足しています。

note: Tag: para
en: For installation instructions refer to: <xref linkend="installing_pagc_address_standardizer"/>.
ja: インストール手順については、<xref linkend="installing_pagc_address_standardizer"/>を参照してください。

note: Tag: title
en: How the Parser Works
ja: パーサの動作

note: Tag: para
en: The parser works from right to left looking first at the macro elements for postcode, state/province, city, and then looks micro elements to determine if we are dealing with a house number street or intersection or landmark. It currently does not look for a country code or name, but that could be introduced in the future.
ja: パーサは右から左に見ます。最初に郵便番号、州/県、市のMACRO (訳注: マクロ)要素を見ます。その後、番地または交差点もしくはランドマークを扱う場合には、MICRO (訳注: マイクロ)要素を見ます。現在は、国別コードや国名を見ませんが、将来的には導入できると思います。

note: Tag: term
en: Country code
ja: 国別コード

note: Tag: para
en: Assumed to be US or CA based on: postcode as US or Canada state/province as US or Canada else US
ja: USまたはCAを仮定します。郵便番号か州/県で米国かカナダを分けますが、判別できない場合は米国とします。

note: Tag: term
en: Postcode/zipcode
ja: 郵便番号

note: Tag: para
en: These are recognized using Perl compatible regular expressions. These regexs are currently in the parseaddress-api.c and are relatively simple to make changes to if needed.
ja: Perl互換の正規表現を使用して認識します。正規表現は現在はparseaddress-api.cにあり、必要な際の変更は比較的簡単です。

note: Tag: term
en: State/province
ja: 州/県

note: Tag: para
en: These are recognized using Perl compatible regular expressions. These regexs are currently in the parseaddress-api.c but could get moved into includes in the future for easier maintenance.
ja: Perl互換の正規表現を使用して認識します。正規表現は現在はparseaddress-api.cにありますが、将来的には、メンテナンスを簡単にするためにインクルードファイルに移動するかも知れません。

note: Tag: title
en: Address Standardizer Types
ja: 住所標準化の型

note: Tag: para
en: This section lists the PostgreSQL data types installed by Address Standardizer extension. Note we describe the casting behavior of these which is very important especially when designing your own functions.
ja: 本節では住所標準化でインストールされたPostgreSQLデータ型の一覧を挙げます。独自関数をデザインする時に特に重要となるキャストの振る舞いを記述しています。

note: Tag: refpurpose
en: A composite type that consists of the elements of an address. This is the return type for <varname>standardize_address</varname> function.
ja: 住所の要素からなる複合型です。<varname>standardize_address</varname>関数が返す型です。

note: Tag: title
en: Description
ja: 説明

note: Tag: para
en: A composite type that consists of elements of an address. This is the return type for <xref linkend="standardize_address"/> function. Some descriptions for elements are borrowed from <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#ss12.1">PAGC Postal Attributes</link>.
ja: 住所の要素からなる複合型です。<xref linkend="standardize_address"/> 関数が返す型です。要素の記述のいくつかは<link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#ss12.1">PAGC Postal Attributes</link>から借りています。

note: Tag: para
en: The token numbers denote the output reference number in the <xref linkend="rulestab"/>.
ja: トークン番号は、<xref linkend="rulestab"/>内の出力参照番号を示します。

note: Tag: para
en: is text (token number <code>0</code>): Refers to building number or name. Unparsed building identifiers and types. Generally blank for most addresses.
ja: 文字列 (トークン番号<code>0</code>): 建物番号や建物名を参照します。解析されていない建物識別子と型です。一般的に、ほとんどの住所では空白です。

note: Tag: para
en: is a text (token number <code>1</code>): This is the street number on a street. Example <emphasis>75</emphasis> in <code>75 State Street</code>.
ja: 文字列 (トークン番号<code>1</code>): ストリートの番号です。<code>75 State Street</code>では <emphasis>75</emphasis>にあたります。

note: Tag: para
en: is text (token number <code>2</code>): STREET NAME PRE-DIRECTIONAL such as North, South, East, West etc.
ja: 文字列 (トークン番号<code>2</code>): North, South, East, Westといった、ストリート名の方角前置語です。

note: Tag: para
en: is text (token number <code>3</code>): STREET NAME PRE-MODIFIER Example <emphasis>OLD</emphasis> in <code>3715 OLD HIGHWAY 99</code>.
ja: 文字列 (トークン番号 <code>3</code>): ストリート名の修飾前置語です。<code>3715 OLD HIGHWAY 99</code>では<emphasis>OLD</emphasis>にあたります。

note: Tag: para
en: is text (token number <code>4</code>): STREET PREFIX TYPE
ja: 文字列 (トークン番号 <code>4</code>): STREET PREFIX TYPE (ストリート名の前置詞の種別)

note: Tag: para
en: is text (token number <code>5</code>): STREET NAME
ja: 文字列 (トークン番号 <code>5</code>): ストリート名

note: Tag: para
en: is text (token number <code>6</code>): STREET POST TYPE e.g. St, Ave, Cir. A street type following the root street name. Example <emphasis>STREET</emphasis> in <code>75 State Street</code>.
ja: 文字列 (トークン番号 <code>6</code>): St, Ave, Cir等の後置詞の種別です。ストリート名に続いて記述されるものです。<code>75 State Street</code>では<emphasis>STREET</emphasis>が該当します。

note: Tag: para
en: is text (token number <code>7</code>): STREET POST-DIRECTIONAL A directional modifier that follows the street name.. Example <emphasis>WEST</emphasis> in <code>3715 TENTH AVENUE WEST</code>.
ja: 文字列 (トークン番号 <code>7</code>): ストリート名に続くNorth, South, East, Westといった、ストリート名の方角前置語です。<code>3715 TENTH AVENUE WEST</code>では<emphasis>WEST</emphasis>が該当します。

note: Tag: para
en: is text (token number <code>8</code>): RURAL ROUTE . Example <emphasis>7</emphasis> in <code>RR 7</code>.
ja: 文字列 (トークン番号 <code>8</code>): RURAL ROUTE (地方集配路線)。<emphasis>8</emphasis>が<code>RR 7</code>では該当します。

note: Tag: para
en: is text: Extra information like Floor number.
ja: 文字列: 階番号のような追加的情報です。

note: Tag: para
en: is text (token number <code>10</code>): Example Boston.
ja: 文字列 (トークン番号 <code>10</code>): 市名です。Boston等が該当します。

note: Tag: para
en: is text (token number <code>11</code>): Example <code>MASSACHUSETTS</code>
ja: 文字列 (トークン番号 <code>11</code>): 州名です。<code>MASSACHUSETTS</code>が該当します。

note: Tag: para
en: is text (token number <code>12</code>): Example <code>USA</code>
ja: 文字列 (トークン番号 <code>12</code>): 国名です。<code>USA</code>が該当します。

note: Tag: para
en: is text POSTAL CODE (ZIP CODE) (token number <code>13</code>): Example <code>02109</code>
ja: 文字列 (トークン番号 <code>13</code>): 郵便番号 (POSTAL CODE, ZIP CODE)です。<code>02109</code>等です。

note: Tag: para
en: is text POSTAL BOX NUMBER (token number <code>14 and 15</code>): Example <code>02109</code>
ja: 文字列 (トークン番号 <code>14 と 15</code>): 私書箱番号です。<code>02109</code>等です。

note: Tag: para
en: is text Apartment number or Suite Number (token number <code>17</code>): Example <emphasis>3B</emphasis> in <code>APT 3B</code>.
ja: 文字列 (トークン番号 <code>17</code>): 部屋番号です。<code>APT 3B</code>の<emphasis>3B</emphasis>が該当します。

note: Tag: title
en: Address Standardizer Tables
ja: 住所標準化テーブル

note: Tag: para
en: This section lists the PostgreSQL table formats used by the address_standardizer for normalizing addresses. Note that these tables do not need to be named the same as what is referenced here. You can have different lex, gaz, rules tables for each country for example or for your custom geocoder. The names of these tables get passed into the address standardizer functions.
ja: 本節では、住所標準化が住所の正規化に使うPostgreSQLテーブルの書式を挙げます。これらのテーブルはここで参照している名前と同じである必要はありません。例または独自ジオコーダのために、国ごとに異なるlex (lexicon, 語彙)、gaz (gazetteer, 地名集)およびrulesテーブルを持つことができます。これらのテーブルの名前は、住所標準化関数に渡されます。

note: Tag: para
en: The packaged extension <varname>address_standardizer_data_us</varname> contains data for standardizing US addresses.
ja: 同梱されている<varname>address_standardizer_data_us</varname>エクステンションには、米国の住所標準化のためのデータがあります。

note: Tag: refpurpose
en: The rules table contains a set of rules that maps address input sequence tokens to standardized output sequence. A rule is defined as a set of input tokens followed by -1 (terminator) followed by set of output tokens followed by -1 followed by number denoting kind of rule followed by ranking of rule.
ja: 規則テーブルには、住所入力順列トークンから標準化した出力順列への対応付けに関する規則の集合が入ります。それぞれの規則は、入力トークン、-1 (終端)、出力トークン、-1、規則の種類を示す数字、規則の階級、からなります。

note: Tag: para
en: A rules table must have at least the following columns, though you are allowed to add more for your own uses.
ja: 規則テーブルには、少なくとも次に示すカラムが必要です。それ以外にカラムを追加してもかまいません。

note: Tag: para
en: Primary key of table
ja: テーブルの主キー

note: Tag: para
en: text field denoting the rule. Details at <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--r-rec--">PAGC Address Standardizer Rule records</link>.
ja: 規則を示す文字列フィールド。 <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--r-rec--">PAGC Address Standardizer Rule records</link>に詳細情報があります。

note: Tag: para
en: A rule consists of a set of non-negative integers representing input tokens, terminated by a -1, followed by an equal number of non-negative integers representing postal attributes, terminated by a -1, followed by an integer representing a rule type, followed by an integer representing the rank of the rule. The rules are ranked from 0 (lowest) to 17 (highest).
ja: ruleには、入力トークンを表現する非負の整数、終端を示す-1、郵便属性を表現する非負の整数、終端を示す-1、規則種別を表現する整数、規則の階級を示す整数からなる集合が入ります。規則は0 (最低)から17 (最高)まであります。

note: Tag: para
en: So for example the rule <code>2 0 2 22 3 -1 5 5 6 7 3 -1 2 6</code> maps to sequence of output tokens <emphasis>TYPE NUMBER TYPE DIRECT QUALIF</emphasis> to the output sequence <emphasis>STREET STREET SUFTYP SUFDIR QUALIF</emphasis>. The rule is an ARC_C rule of rank 6.
ja: たとえば、<code>2 0 2 22 3 -1 5 5 6 7 3 -1 2 6</code>は、<emphasis>TYPE NUMBER TYPE DIRECT QUALIF</emphasis>なる入力トークン順列が、<emphasis>STREET STREET SUFTYP SUFDIR QUALIF</emphasis>なる出力トークン順列に対応付けされ、規則はARC_Cで、階級は6となります。

note: Tag: para
en: Numbers for corresponding output tokens are listed in <xref linkend="stdaddr"/>.
ja: 対応する出力トークンは<xref linkend="stdaddr"/>に挙げています。

note: Tag: title
en: Input Tokens
ja: 入力トークン

note: Tag: para
en: Each rule starts with a set of input tokens followed by a terminator <code>-1</code>. Valid input tokens excerpted from <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#ss12.2">PAGC Input Tokens</link> are as follows:
ja: 個々の規則は、入力トークン順列、終端を示す<code>-1</code>の順です。<link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#ss12.2">PAGC Input Tokens</link>から引用した正当な入力トークンは次の通りです:

note: Tag: emphasis
en: Form-Based Input Tokens
ja: 書式ベースの入力トークン

note: Tag: para
en: (13). The ampersand (&amp;) is frequently used to abbreviate the word "and".
ja: (13) アンパサンド (&amp;)は、"and"という語を短縮するために、よく使われます。

note: Tag: para
en: (9). A punctuation character.
ja: (9) 区切り記号。

note: Tag: para
en: (21). A sequence of two letters. Often used as identifiers.
ja: (21) 二つの文字の順列。しばしば識別子に用いられます。

note: Tag: para
en: (25). Fractions are sometimes used in civic numbers or unit numbers.
ja: (25) ときどき"civic nunber"または"unit number" (訳注: 各戸に付けられる番号)で使われます。

note: Tag: para
en: (23). An alphanumeric string that contains both letters and digits. Used for identifiers.
ja: (23) 英数文字列。識別子に用います。

note: Tag: para
en: (0). A string of digits.
ja: (0) 数字からなる文字列。

note: Tag: para
en: (15). Representations such as First or 1st. Often used in street names.
ja: (15) "First"や"1st"といったものを表現する文字列。しばしばストリート名の中で使われています。

note: Tag: para
en: (18). A single letter.
ja: (18) 一つの文字。

note: Tag: para
en: (1). A word is a string of letters of arbitrary length. A single letter can be both a SINGLE and a WORD.
ja: (1) 任意長を持つ文字列です。一つの文字はSINGLEおよびWORDの両方になりえます。

note: Tag: emphasis
en: Function-based Input Tokens
ja: 機能ベースの入力トークン

note: Tag: para
en: (14). Words used to denote post office boxes. For example <emphasis>Box</emphasis> or <emphasis>PO Box</emphasis>.
ja: (14) 私書箱を示すために使われる語です。たとえば <emphasis>Box</emphasis>または<emphasis>PO Box</emphasis>です。

note: Tag: para
en: (19). Words used to denote buildings or building complexes, usually as a prefix. For example: <emphasis>Tower</emphasis> in <emphasis>Tower 7A</emphasis>.
ja: (19) 建物またはその複合体を示すための語で、通常は前置語になります。たとえば<emphasis>Tower 7A</emphasis>では<emphasis>Tower</emphasis>が該当します。

note: Tag: para
en: (24). Words and abbreviations used to denote buildings or building complexes, usually as a suffix. For example: <emphasis>Shopping Centre</emphasis>.
ja: (24) 建物またはその複合体を示すために使われる語または略語で、通常は後置語になります。たとえば<emphasis>Shopping Centre</emphasis>です。

note: Tag: para
en: (22). Words used to denote directions, for example <emphasis>North</emphasis>.
ja: (22) 方位を示す語です。たとえば <emphasis>North</emphasis>です。

note: Tag: para
en: (20). Words used to denote milepost addresses.
ja: (20) 距離標の住所を示す語です。

note: Tag: para
en: (6). Words and abbreviations used to denote highways and roads. For example: the <emphasis>Interstate</emphasis> in <emphasis>Interstate 5</emphasis>
ja: (6) 高速道路と道路を示す語または略語です。たとえば<emphasis>Interstate 5</emphasis>の<emphasis>Interstate</emphasis>です。

note: Tag: para
en: (8). Words and abbreviations used to denote rural routes. <emphasis>RR</emphasis>.
ja: (8) 地方集配路線を示す語または略語です。たとえば<emphasis>RR</emphasis>です。

note: Tag: para
en: (2). Words and abbreviation used to denote street typess. For example: <emphasis>ST</emphasis> or <emphasis>AVE</emphasis>.
ja: (2) ストリート種別を示す語または略語です。たとえば<emphasis>ST</emphasis>や<emphasis>AVE</emphasis>です。

note: Tag: para
en: (16). Words and abbreviation used to denote internal subaddresses. For example, <emphasis>APT</emphasis> or <emphasis>UNIT</emphasis>.
ja: (16) 内部の部分住所を示す語または略語です。たとえば<emphasis>APT</emphasis>や<emphasis>UNIT</emphasis>です。

note: Tag: emphasis
en: Postal Type Input Tokens
ja: 郵便型入力トークン

note: Tag: para
en: (28). A 5 digit number. Identifies a Zip Code
ja: (28) 5桁の番号。ZIPコードです。

note: Tag: para
en: (29). A 4 digit number. Identifies ZIP4.
ja: (29) 4桁の番号。ZIP4です。

note: Tag: para
en: (27). A 3 character sequence of letter number letter. Identifies an FSA, the first 3 characters of a Canadian postal code.
ja: (27) 英数3文字の順列です。カナダの郵便番号の先頭3文字であるFSAを示します。

note: Tag: para
en: (26). A 3 character sequence of number letter number. Identifies an LDU, the last 3 characters of a Canadian postal code.
ja: (26) 英数3文字の順列です。カナダの郵便番号の末尾3文字です。

note: Tag: emphasis
en: Stopwords
ja: ストップワード

note: Tag: para
en: STOPWORDS combine with WORDS. In rules a string of multiple WORDs and STOPWORDs will be represented by a single WORD token.
ja: STOPWORD (訳注: 処理対象外とする語)はWORDと結合します。規則で、複数のWORDとSTOPWORDの列は、単一のWORDトークンで表現されます。

note: Tag: para
en: (7). A word with low lexical significance, that can be omitted in parsing. For example: <emphasis>THE</emphasis>.
ja: (7) 重要性が低い語で、パース時に省かれます。たとえば<emphasis>THE</emphasis>が該当します。

note: Tag: title
en: Output Tokens
ja: 出力トークン

note: Tag: para
en: After the first -1 (terminator), follows the output tokens and their order, followed by a terminator <code>-1</code>. Numbers for corresponding output tokens are listed in <xref linkend="stdaddr"/>. What are allowed is dependent on kind of rule. Output tokens valid for each rule type are listed in <xref linkend="rule_types_rank"/>.
ja: 1番目の-1 (終端)の後に、出力トークンが続き、その後に<code>-1</code>が続きます。対応する出力トークンの番号は、<xref linkend="stdaddr"/>に挙げています。許されるものは、規則の種類に依存します。それぞれの規則種別で有効なトークンは<xref linkend="rule_types_rank"/>に挙げています。

note: Tag: title
en: Rule Types and Rank
ja: 規則種別と階級

note: Tag: para
en: The final part of the rule is the rule type which is denoted by one of the following, followed by a rule rank. The rules are ranked from 0 (lowest) to 17 (highest).
ja: 規則の最後の部分は規則種別で、次に挙げるものの一つが示すものです。この後には階級が続きます。規則は0 (最低) から17 (最高)までに階級付けされます。

note: Tag: para
en: (token number = "<emphasis role="bold">0</emphasis>"). The class of rules for parsing MACRO clauses such as <emphasis>PLACE STATE ZIP</emphasis>
ja: (トークン番号 = "<emphasis role="bold">0</emphasis>") <emphasis>PLACE STATE ZIP</emphasis>のようなMACRO節をパースするための規則のクラス。

note: Tag: para
en: <emphasis role="bold"><varname>MACRO_C</varname> output tokens</emphasis> (excerpted from <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--">http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--</link>.
ja: <emphasis role="bold"><varname>MACRO_C</varname>出力トークン</emphasis> (<link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--">http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--</link>から抜粋)。

note: Tag: para
en: (token number "10"). Example "Albany"
ja: (トークン番号 "10") たとえば"Albany" (訳注: ニューヨーク州の州都)等。

note: Tag: para
en: (token number "11"). Example "NY"
ja: (トークン番号 "11") たとえば"NY" (訳注: ニューヨーク州)等。

note: Tag: para
en: (token number "12"). This attribute is not used in most reference files. Example "USA"
ja: (トークン番号 "12") ほとんどの参照ファイル内で使われない属性です。たとえば"USA"等。

note: Tag: para
en: (token number "13"). (SADS elements "ZIP CODE" , "PLUS 4" ). This attribute is used for both the US Zip and the Canadian Postal Codes.
ja: (トークン番号 "13") (SADS elements "ZIP CODE" , "PLUS 4" ). 米国Zip (郵便番号)とカナダ郵便番号の両方で使われます。

note: Tag: para
en: (token number = "<emphasis role="bold">1</emphasis>"). The class of rules for parsing full MICRO clauses (such as House, street, sufdir, predir, pretyp, suftype, qualif) (ie ARC_C plus CIVIC_C). These rules are not used in the build phase.
ja: (トークン番号 = "<emphasis role="bold">1</emphasis>") 完全なMICRO節 (House, street, sufdir, predir, pretyp, suftype, qualif等)をパースするための規則のクラス (ARC_CとCIVIC_Cの和)。建物フェーズでは使われません。

note: Tag: para
en: <emphasis role="bold"><varname>MICRO_C</varname> output tokens</emphasis> (excerpted from <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--">http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--</link>.
ja: <emphasis role="bold"><varname>MICRO_C</varname>出力トークン</emphasis> (<link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--">http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--</link>から抜粋)。

note: Tag: para
en: (token number = "<emphasis role="bold">2</emphasis>"). The class of rules for parsing MICRO clauses, excluding the HOUSE attribute. As such uses same set of output tokens as MICRO_C minus the HOUSE token.
ja: (トークン番号 = "<emphasis role="bold">2</emphasis>") HOUSE属性を除いたMICRO節をパースするための規則のクラス。MICRO_CからHOUSEトークンを除いた出力トークン集合と同じです。

note: Tag: para
en: (token number = "<emphasis role="bold">3</emphasis>"). The class of rules for parsing the HOUSE attribute.
ja: (トークン番号 = "<emphasis role="bold">3</emphasis>") HOUSE属性をパースするための規則のクラス。

note: Tag: para
en: (token number = "<emphasis role="bold">4</emphasis>"). The class of rules for parsing EXTRA attributes - attributes excluded from geocoding. These rules are not used in the build phase.
ja: (トークン番号 = "<emphasis role="bold">4</emphasis>") EXTRA属性 (ジオコーディングから除かれる属性)をパースするための規則のクラス。

note: Tag: para
en: <emphasis role="bold"><varname>EXTRA_C</varname> output tokens</emphasis> (excerpted from <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--">http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--</link>.
ja: <emphasis role="bold"><varname>EXTRA_C</varname>出力トークン</emphasis> (<link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--">http://www.pagcgeo.org/docs/html/pagc-12.html#--r-typ--</link>から抜粋)。

note: Tag: para
en: (token number <code>0</code>): Unparsed building identifiers and types.
ja: (トークン番号 <code>0</code>): パースされていない建物識別子と種別。

note: Tag: para
en: (token number <code>14</code>): The <emphasis role="bold">BOX</emphasis> in <code>BOX 3B</code>
ja: (トークン番号 <code>14</code>): <code>BOX 3B</code>内の <emphasis role="bold">BOX</emphasis>にあたります。

note: Tag: para
en: (token number <code>15</code>): The <emphasis role="bold">3B</emphasis> in <code>BOX 3B</code>
ja: (トークン番号 <code>15</code>): <code>BOX 3B</code>内の<emphasis role="bold">3B</emphasis>にあたります。

note: Tag: para
en: (token number <code>8</code>): The <emphasis role="bold">RR</emphasis> in <code>RR 7</code>
ja: (トークン番号 <code>8</code>): <code>RR 7</code>内の<emphasis role="bold">RR</emphasis>にあたります。

note: Tag: para
en: (token number <code>16</code>): The <emphasis role="bold">APT</emphasis> in <code>APT 3B</code>
ja: (トークン番号 <code>16</code>): <code>APT 3B</code>内の<emphasis role="bold">APT</emphasis>にあたります。

note: Tag: para
en: (token number <code>17</code>): The <emphasis role="bold">3B</emphasis> in <code>APT 3B</code>
ja: (トークン番号<code>17</code>): <code>APT 3B</code>内の<emphasis role="bold">3B</emphasis>にあたります。

note: Tag: para
en: (token number <code>9</code>): An otherwise unclassified output.
ja: (トークン番号<code>9</code>): その他分類対象外の出力。

note: Tag: refpurpose
en: A lex table is used to classify alphanumeric input and associate that input with (a) input tokens ( See <xref linkend="rule_input_tokens"/>) and (b) standardized representations.
ja: lexテーブルは英数字の入力をクラス分けして (a) 入力トークン (<xref linkend="rule_input_tokens"/> 参照)と (b) 標準化表現 とに関連付けます。

note: Tag: para
en: A lex (short for lexicon) table is used to classify alphanumeric input and associate that input with <xref linkend="rule_input_tokens"/> and (b) standardized representations. Things you will find in these tables are <code>ONE</code> mapped to stdword: <code>1</code>.
ja: lex (lexiconの略語)テーブルは、英数入力を分類し、入力を (a) <xref linkend="rule_input_tokens"/>および (b) 標準化された表現、に関連付けます。これらのテーブルで発見した物は、<code>ONE</code>がstdwordでは<code>1</code>に対応付けされます。

note: Tag: para
en: A lex has at least the following columns in the table. You may add
ja: lexは少なくとも次のカラムを持ちます。追加できます。

note: Tag: para
en: integer: definition number?
ja: 整数: 定義番号？

note: Tag: para
en: text: the input word
ja: 文字列: 入力単語

note: Tag: para
en: text: the standardized replacement word
ja: 文字列: 正規化した置き換え語

note: Tag: para
en: integer: the kind of word it is. Only if it is used in this context will it be replaced. Refer to <link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--i-tok--">PAGC Tokens</link>.
ja: 整数: その語の種別。このコンテキストで使われる場合のみ置き換えられます。<link xlink:href="http://www.pagcgeo.org/docs/html/pagc-12.html#--i-tok--">PAGC Tokens</link>を参照して下さい。

note: Tag: refpurpose
en: A gaz table is used to standardize place names and associate that input with (a) input tokens ( See <xref linkend="rule_input_tokens"/>) and (b) standardized representations.
ja: gazテーブルは、地名を標準化し、入力と、(a)入力トークン (<xref linkend="rule_input_tokens"/>を参照して下さい)および (b) 標準化された表現とを関連付けるために使われます。

note: Tag: para
en: A gaz (short for gazeteer) table is used to standardize place names and associate that input with <xref linkend="rule_input_tokens"/> and (b) standardized representations. For example if you are in US, you may load these with State Names and associated abbreviations.
ja: gaz (gazeteerの略語)テーブルは、地名を分類し、入力を (a) <xref linkend="rule_input_tokens"/>および (b) 標準化された表現、に関連付けます。たとえば、米国にいる場合には、州名と略称を持つものをダウンロードできます。

note: Tag: para
en: A gaz table has at least the following columns in the table. You may add more columns if you wish for your own purposes.
ja: gazテーブルは少なくとも次のカラムを持ちます。独自の目的のために追加することができます。

note: Tag: para
en: integer: definition number? - identifier used for that instance of the word
ja: 整数: 定義番号？ - 語のインスタンスに使われる識別子

note: Tag: title
en: Address Standardizer Functions
ja: 住所標準化関数

note: Tag: refpurpose
en: Returns a json formatted text listing the parse tokens and standardizations
ja: パースしたトークンと標準化のリストをJSON形式の文字列で返します

note: Tag: para
en: This is a function for debugging address standardizer rules and lex/gaz mappings. It returns a json formatted text that includes the matching rules, mapping of tokens, and best standardized address <xref linkend="stdaddr"/> form of an input address utilizing <xref linkend="lextab"/> table name, <xref linkend="gaztab"/>, and <xref linkend="rulestab"/> table names and an address.
ja: これは住所標準化ルールとlex/gazの対応付けに関するデバッグ用関数です。合致する規則と、<xref linkend="lextab"/>テーブル名、<xref linkend="gaztab"/>、<xref linkend="rulestab"/>テーブル名と住所を使用して、入力住所の<xref linkend="stdaddr"/>形式による最善標準化住所を含むJSON形式の文字列を返します。

note: Tag: para
en: For single line addresses use just <varname>micro</varname>
ja: 単一行の住所は<varname>micro</varname>だけを使います

note: Tag: para
en: For two line address A <varname>micro</varname> consisting of standard first line of postal address e.g. <code>house_num street</code>, and a macro consisting of standard postal second line of an address e.g <code>city, state postal_code country</code>.
ja: 二行住所では、郵便住所の標準の1行目である<code>house_num street</code>等で構成される<varname>micro</varname>と、2行目である<code>city, state postal_code country</code>等で構成されるmacroからなります。

note: Tag: para
en: Elements returned in the json document are
ja: JSON文書で返される要素は次の通りです

note: Tag: para
en: For each word in the input address, returns the position of the word, token categorization of the word, and the standard word it is mapped to. Note that for some input words, you might get back multiple records because some inputs can be categorized as more than one thing.
ja: 入力住所の単語ごとに、単語位置、単語のトークン分類、関連付けられる標準単語が返されます。入力単語のうち、入力が1回より多く分類されると、複数レコードが返されることがあります。

note: Tag: para
en: The set of rules matching the input and the corresponding score for each. The first rule (highest scoring) is what is used for standardization
ja: 入力に合致した規則と対応する個々のスコアの集合です。最初の規則 (最高スコア)が標準化に使われます

note: Tag: para
en: The standardized address elements <xref linkend="stdaddr"/> that would be returned when running <xref linkend="standardize_address"/>
ja: <xref linkend="standardize_address"/>を実行しているとｋにに返される標準化された住所要素<xref linkend="stdaddr"/>

note: Tag: title
en: Examples
ja: 例

note: Tag: para
en: Using address_standardizer_data_us extension
ja: address_standardizer_data_usエクステンションを使います。

note: Tag: para
en: Variant 1: Single line address and returning the input tokens
ja: 一つ目の形式: 単一行アドレスと入力トークンの返却

note: Tag: para
en: Variant 2: Multi line address and returning first rule input mappings and score
ja: 二つ目の形式: 複数行住所と最初の入力規則の対応付けとスコアの返却

note: Tag: title
en: See Also
ja: 関連情報

note: Tag: refpurpose
en: Takes a 1 line address and breaks into parts
ja: 1行の住所を取り、分割します。

note: Tag: para
en: Returns takes an address as input, and returns a record output consisting of fields <emphasis>num</emphasis>, <emphasis>street</emphasis>, <emphasis>street2</emphasis>, <emphasis>address1</emphasis>, <emphasis>city</emphasis>, <emphasis>state</emphasis>, <emphasis>zip</emphasis>, <emphasis>zipplus</emphasis>, <emphasis>country</emphasis>.
ja: 一つの住所を入力に取り、<emphasis>num</emphasis>、<emphasis>street</emphasis>、<emphasis>street2</emphasis>、<emphasis>address1</emphasis>、<emphasis>city</emphasis>、<emphasis>state</emphasis>、<emphasis>zip</emphasis>、<emphasis>zipplus</emphasis>、<emphasis>country</emphasis>からなるレコードを一つ返します。

note: Tag: para
en: Single Address
ja: 単一の住所

note: Tag: para
en: Table of addresses
ja: 住所テーブル

note: Tag: refpurpose
en: Returns an stdaddr form of an input address utilizing lex, gaz, and rule tables.
ja: lexテーブル、gazテーブルおよび規則テーブルを使って、入力住所をstdaddr形式で返します。

note: Tag: para
en: Returns an <xref linkend="stdaddr"/> form of an input address utilizing <xref linkend="lextab"/> table name, <xref linkend="gaztab"/>, and <xref linkend="rulestab"/> table names and an address.
ja: 指定された<xref linkend="lextab"/>、<xref linkend="gaztab"/>および<xref linkend="rulestab"/>のテーブルを使って、入力住所を<xref linkend="stdaddr"/>形式で返します。

note: Tag: para
en: Variant 1: Takes an address as a single line.
ja: 1番目の形式: 単一行で住所を取る形式です。

note: Tag: para
en: Variant 2: Takes an address as 2 parts. A <varname>micro</varname> consisting of standard first line of postal address e.g. <code>house_num street</code>, and a macro consisting of standard postal second line of an address e.g <code>city, state postal_code country</code>.
ja: 2番目の形式: 住所を二つの部分から取ります。<varname>micro</varname>は<code>house_num street</code>等のような、標準的な宛先書式の1行目です。<varname>macro</varname>は、<code>city, state postal_code country</code>等のような、標準的な宛先書式の2行目です。

note: Tag: para
en: Variant 1: Single line address. This doesn't work well with non-US addresses
ja: 一つ目の版: 単一行住所。米国でない住所では十分に働きません。

note: Tag: para
en: Using tables packaged with tiger geocoder. This example only works if you installed <varname>postgis_tiger_geocoder</varname>.
ja: Tigerジオコーダに同梱されているテーブルを使います。この例は<varname>postgis_tiger_geocoder</varname>をインストールしている場合のみ動作します。

note: Tag: para
en: Make easier to read we'll dump output using hstore extension CREATE EXTENSION hstore; you need to install
ja: 読みやすくするために、hstoreエクステンションを使ってダンプします。必要なら CREATE EXTENSION hstore; を実行します。

note: Tag: para
en: Variant 2: As a two part Address
ja: 二つ目の形式: 二つの部分からなる住所

note: Tag: title
en: History Tracking
ja: 履歴追跡

note: Tag: para
en: Suppose you have a table of data that represents the current state of a particular geographic feature. A parcels table, or a roads table, or a fruit trees table, whatever. Generally, GIS tools understand a table as a single entity into which they can update, insert and delete rows from. How you do allow common GIS tools to work against your data, while maintaining an audit trail of what changes have been made, by whom, and what the past state of the data is?
ja: 特定の地物の現在の状態を示すデータのテーブルがあるとします。区画テーブルであったり、道路テーブルであったり、果樹テーブルであったり、なんでもかまいません。一般的にGISツールはテーブルを、更新と削除が可能な単一の実体ととらえます。一般的なGISツールに、先ほどのデータに対して、どういう変更が、誰によってなされ、かつ過去のデータの状態がどうであったかの監査証跡を維持しながら動作させるにはどのようにするでしょうか？

note: Tag: para
en: This <varname>history_table</varname> extra module provides some utility functions for creating and maintaining history.
ja: <varname>history_table</varname>拡張モジュールは、履歴の生成と維持のための関数を提供します。

note: Tag: para
en: The <varname>history_table</varname> was also packaged in PostGIS 1.5, but added to the documentation in PostGIS 2.0. This package is written in plpgsql and located in the <varname>extras/history_table</varname> of PostGIS source tar balls and source repository.
ja: <varname>history_table</varname>はPostGIS 1.5に同梱されていましたが、文書はPostGIS 2.0で追加されました。このパッケージはPL/pgSQLで書かれ、PostGISソースアーカイブまたはソースレポジトリの<varname>extras/history_table</varname>にあります。

note: Tag: para
en: If you have a table 'roads', this module will maintain a 'roads_history' side table, which contains all the columns of the parent table, and the following additional columns:
ja: 'roads'テーブルを持っていると、親テーブルの全てのカラムと次に示すカラムを持つ'roads_history'副テーブルが、このモジュールによって維持されます。

note: Tag: para
en: When you insert a new record into 'roads' a record is automatically inserted into 'roads_history', with the 'date_added' filled in the 'date_deleted' set to NULL, a unique 'history_id', a 'last_operation' of 'INSERT' and 'active_user' set.
ja: 新しいレコードを'roads'に追加すると、レコードは自動的に'roads_history'に挿入され、'date_added'に値が入り、'date_deleted'にNULLが設定され、'history_id'に一意の値が入り、'last_operation'に'INSERT'が入り、'active_user'に値が入ります。

note: Tag: para
en: When you delete a record in 'roads', the record in the history table is *not* deleted, but the 'date_deleted' is set to the current date.
ja: 'roads'内のテーブルを削除すると、履歴テーブルのレコードは*削除されません*。'date_deleted'に現在の日時が入ります。

note: Tag: para
en: When you update a record in 'roads', the current record has 'date_deleted' filled in and a new record is created with the 'date_added' set and 'date_deleted' NULL.
ja: 'roads'テーブルのレコードを更新すると、現在の持つ'date_deleted'に値が入り、新しいレコードが生成され、'date_added'に値が入り、'date_deleted'にNULLが入ります。

note: Tag: para
en: With this information maintained, it is possible to retrieve the history of any record in the roads table:
ja: この情報を維持することで、roadsテーブルの全てのレコードの履歴を取得することができます。

note: Tag: para
en: Or, to retrieve a view of the roads table at any point in the past:
ja: ある過去の時点におけるroadsテーブルの状態を検索することもできます。

note: Tag: refpurpose
en: Creates a table that will hold some interesting values for managing history tables.
ja: 履歴テーブルの管理のための値を持つテーブルを生成します。

note: Tag: para
en: Creates a table that will hold some interesting values for managing history tables. Creates a table called <varname>historic_information</varname>
ja: 履歴テーブルの管理のための値を持つテーブルを生成します。テーブル名は<varname>historic_information</varname>になります。

note: Tag: refpurpose
en: Registers a table in the history_information table for tracking and also adds in side line history table and insert, update, delete rules on the table.
ja: history_informationテーブルに追跡のための登録を行い、履歴テーブルを追加し、テーブルに挿入、更新、削除の規則を設定します。

note: Tag: para
en: Registers a table in the history_information table for tracking and also adds in side line history table with same name as table but prefixed with <varname>history</varname> in the same schema as the original table. Puts in insert, update, delete rules on the table. Any inserts,updates,deletes of the geometry are recorded in the history table.
ja: history_informationテーブルに追跡のための登録を行い、元テーブル名の前に<varname>history</varname>をつけた名前となる履歴テーブルを、元テーブルと同じスキーマに追加し、テーブルに挿入、更新、削除の規則を設定します。ジオメトリの挿入、更新、削除は履歴テーブルに全て記録されます。

note: Tag: para
en: This function currently relies on a geometry column being registered in <varname>geometry_columns</varname> and fails if the geometry column is not present in <varname>geometry_columns</varname> table.
ja: この関数は現在は<varname>geometry_columns</varname>に登録されているジオメトリカラムに依っていて、<varname>geometry_columns</varname>にないジオメトリカラムでは失敗します。

note: Tag: title
en: Tiger Geocoder
ja: Tigerジオコーダ

note: Tag: para
en: A plpgsql based geocoder written to work with the <link xlink:href="http://www.census.gov/geo/www/tiger/">TIGER (Topologically Integrated Geographic Encoding and Referencing system ) / Line and Master Address database export</link> released by the US Census Bureau.
ja: 米国国勢調査局が公開している<link xlink:href="http://www.census.gov/geo/www/tiger/">TIGER (Topologically Integrated Geographic Encoding and Referencing system ) / Line and Master Address database export</link>で動作するよう書かれた、PL/pgSQLベースのジオコーダです。

note: Tag: para
en: There are four components to the geocoder: the data loader functions, the address normalizer, the address geocoder, and the reverse geocoder.
ja: データローダ機能、住所正規化、住所ジオコーダおよび逆ジオコーダ、の四つの要素があります。

note: Tag: para
en: Although it is designed specifically for the US, a lot of the concepts and functions are applicable and can be adapted to work with other country address and road networks.
ja: 米国のための設計ですが、概念および機能の多くは適用可能で、他国の住所と道路ネットワークで動作するように適合させることができます (訳注: 日本の地名については未知です)。

note: Tag: para
en: The script builds a schema called <varname>tiger</varname> to house all the tiger related functions, reusable lookup data such as road type prefixes, suffixes, states, various control tables for managing data load, and skeleton base tables from which all the tiger loaded tables inherit from.
ja: Tiger関連の関数、道路型前置辞・道路型後置辞・州といった再利用可能な参照データ、データロード管理のための様々な制御テーブル、全てのロードされたテーブルが継承するスケルトンテーブル、を収容するための<varname>tiger</varname>というスキーマが、スクリプトによって作成されます。

note: Tag: para
en: Another schema called <varname>tiger_data</varname> is also created which houses all the census data for each state that the loader downloads from Census site and loads into the database. In the current model, each set of state tables is prefixed with the state code e.g <varname>ma_addr</varname>, <varname>ma_edges</varname> etc with constraints to enforce only that state data. Each of these tables inherits from the tables <varname>addr</varname>, <varname>faces</varname>, <varname>edges</varname>, etc located in the <varname>tiger schema</varname>.
ja: <varname>tiger_data</varname>という、もう一つのスキーマが作られます。ここに、ローダが米国国勢調査サイトからダウンロードしてデータベースにロードした州ごとの全ての国勢調査データが収容されます。現在のモデルでは、州ごとのテーブルは、<varname>ma_addr</varname>や<varname>ma_edges</varname>といったように名前の先頭に州コードを付けていて、州データのみに強制する制約が付いています。これらのテーブルは<varname>tiger schema</varname>にある<varname>addr</varname>, <varname>faces</varname>, <varname>edges</varname>等から継承されています。

note: Tag: para
en: All the geocode functions only reference the base tables, so there is no requirement that the data schema be called <varname>tiger_data</varname> or that data can't be further partitioned into other schemas -- e.g a different schema for each state, as long as all the tables inherit from the tables in the <varname>tiger</varname> schema.
ja: 全てのジオコード関数は基底テーブルを参照するだけです。そのため、<varname>tiger_data</varname>データスキーマやそのデータを他のスキーマに分割できないという条件はありません。例えば、州ごとに異なるスキーマにしても、<varname>tiger</varname>内のテーブルから継承されているなら使用可能です。

note: Tag: para
en: For instructions on how to enable the extension in your database and also to load data using it, refer to <xref linkend="install_tiger_geocoder_extension"/>.
ja: お手持ちのデータベース内のエクステンションを有効にし、使用するデータをロードする方法については、<xref linkend="install_tiger_geocoder_extension"/>を参照して下さい。

note: Tag: para
en: If you are using tiger geocoder (tiger_2010), you can upgrade the scripts using the accompanying upgrade_geocoder.bat / .sh scripts in extras/tiger. One major change between <varname>tiger_2010</varname> and <varname>tiger_2011+</varname> is that the <varname>county</varname> and <varname>state</varname> tables are no longer broken out by state. If you have data from tiger_2010 and want to replace with tiger_2015, refer to <xref linkend="upgrade_tiger_geocoder"/>
ja: Tigerジオコーダ (tiger_2010)を使っている場合には、extras/tiger内にあるupgrade_geocoder.bat / .sh を使ってアップグレードすることができます。<varname>tiger_2010</varname>と<varname>tiger_2011以上</varname>での大きな変更点は、<varname>county</varname>テーブルと<varname>state</varname>テーブルが、stateごとに出現することがなくなっています。tiger_2010からのデータを持っていて、tiger_2015に置き換えたい場合には、<xref linkend="upgrade_tiger_geocoder"/>を参照して下さい。

note: Tag: para
en: New in PostGIS 2.2.0 release is support for Tiger 2015 data and inclusion of Address Standardizer as part of PostGIS.
ja: PostGIS 2.2.0での新規機能は、Tiger 2015データに対応したことと、住所標準化がPostGISの一部に取り入れられたことです。

note: Tag: para
en: New in PostGIS 2.1.0 release is ability to install tiger geocoder with PostgreSQL extension model if you are running PostgreSQL 9.1+. Refer to <xref linkend="install_tiger_geocoder_extension"/> for details.
ja: PostGIS 2.1.0での新規機能は、PostgreSQL 9.1以上では、TigerジオコーダをPostgreSQLエクステンションモデルでインストールすることができるようになったことです。詳細については<xref linkend="install_tiger_geocoder_extension"/>を参照して下さい。

note: Tag: para
en: The <xref linkend="Pagc_Normalize_Address"/> function as a drop in replacement for in-built <xref linkend="Normalize_Address"/>. Refer to <xref linkend="installing_pagc_address_standardizer"/> for compile and installation instructions.
ja: PostGISが用意している<xref linkend="Normalize_Address"/>の代替として<xref linkend="Pagc_Normalize_Address"/>関数があります。コンパイルとインストールの方法については、<xref linkend="installing_pagc_address_standardizer"/>を参照して下さい。

note: Tag: para
en: Design:
ja: 設計:

note: Tag: para
en: The goal of this project is to build a fully functional geocoder that can process an arbitrary United States address string and using normalized TIGER census data, produce a point geometry and rating reflecting the location of the given address and likeliness of the location. The higher the rating number the worse the result.
ja: このプロジェクトの目標は、任意の米国住所文字列を処理し、正規化したTiger国勢調査データを使ってポイントジオメトリを生成し、与えられた住所の位置や、位置のもっともらしさを反映した評価値を算出する、十分に実用的なジオコーダを構築することです。なお、評価値は高いほど悪い結果とします。

note: Tag: para
en: The <varname>reverse_geocode</varname> function, introduced in PostGIS 2.0.0 is useful for deriving the street address and cross streets of a GPS location.
ja: PostGIS 2.0.0で導入された<varname>reverse_geocode</varname>は、GPS位置のストリート住所と交差点を得るのに便利です。

note: Tag: para
en: The geocoder should be simple for anyone familiar with PostGIS to install and use, and should be easily installable and usable on all platforms supported by PostGIS.
ja: ジオコーダは、PostGISに慣れている方ならだれでもインストールと使用が容易な程度に単純であるべきで、PostGISがサポートする全てのプラットフォームで簡便にインストール、使用ができるべきです。

note: Tag: para
en: It should be robust enough to function properly despite formatting and spelling errors.
ja: 書式や綴りの誤りがあっても確実に機能するための十分なロバスト性があるべきです。

note: Tag: para
en: It should be extensible enough to be used with future data updates, or alternate data sources with a minimum of coding changes.
ja: 将来のデータ更新が使えるか、最小のプログラムの変更で他のデータが使えるための十分な拡張性もあるべきです。

note: Tag: para
en: The <varname>tiger</varname> schema must be added to the database search path for the functions to work properly.
ja: 関数が確実に動作するために、<varname>tiger</varname>スキーマは、データベース検索パスに追加されていなければなりません。

note: Tag: para
en: There are a couple other open source geocoders for PostGIS, that unlike tiger geocoder have the advantage of multi-country geocoding support
ja: PostGIS用の二つのオープンソースジオコーダがあります。これらはTigerジオコーダと違い、他国のジオコーディングに対応している利点があります。

note: Tag: para
en: <link xlink:href="http://wiki.openstreetmap.org/wiki/Nominatim">Nominatim</link> uses OpenStreetMap gazeteer formatted data. It requires osm2pgsql for loading the data, PostgreSQL 8.4+ and PostGIS 1.5+ to function. It is packaged as a webservice interface and seems designed to be called as a webservice. Just like the tiger geocoder, it has both a geocoder and a reverse geocoder component. From the documentation, it is unclear if it has a pure SQL interface like the tiger geocoder, or if a good deal of the logic is implemented in the web interface.
ja: <link xlink:href="http://wiki.openstreetmap.org/wiki/Nominatim">Nominatim</link>は、OpenStreetMapの地名集データを使います。データのロードにはosm2pgsqlが必要です。PostgreSQL 8.4以上とPostGIS 1.5以上が必要です。Webサービスのインタフェースとして作られていて、Webサービスと呼ばれるような設計に見えます。Tigerジオコーダと同じように、ジオコーダと逆ジオコーダの要素を持ちます。文書からでは、Tigerジオコーダのような純粋なSQLインタフェースを持っているのか、多くの処理がWebインタフェースに実装されているのか、は明確ではありません。

note: Tag: para
en: <link xlink:href="http://www.gisgraphy.com/">GIS Graphy</link> also utilizes PostGIS and like Nominatim works with OpenStreetMap (OSM) data. It comes with a loader to load OSM data and similar to Nominatim is capable of geocoding not just US. Much like Nominatim, it runs as a webservice and relies on Java 1.5, Servlet apps, Solr. GisGraphy is cross-platform and also has a reverse geocoder among some other neat features.
ja: <link xlink:href="http://www.gisgraphy.com/">GIS Graphy</link>も、PostGISを使用したもので、NominatimのようにOpenStreetMap (OSM)データを使用します。OSMデータのロードを行うローダとNominatimのように米国だけでなくジオコーディングを行う能力があります。Nominatimとよく似ていて、Webサービスとして動作し、Java 1.5、サーブレットアプリケーション、Apache Solrに依存しています。GisGraphyは、複数プラットフォームで動作し、他の機能の中には逆ジオコーダがあります。

note: Tag: refpurpose
en: <refpurpose>Generates a script that drops all non-primary key and non-unique indexes on tiger schema and user specified schema. Defaults schema to <varname>tiger_data</varname> if no schema is specified.</refpurpose>
ja: <refpurpose>tigerスキーマとユーザが指定したスキーマ上の、全ての主キーでなく、かつユニークでないインデックスを削除します。スキーマを指定しない場合のデフォルトスキーマは、<varname>tiger_data</varname>です。</refpurpose>

note: Tag: para
en: <para>Generates a script that drops all non-primary key and non-unique indexes on tiger schema and user specified schema. Defaults schema to <varname>tiger_data</varname> if no schema is specified.</para>
ja: <para>tigerスキーマとユーザが指定したスキーマ上の、全ての主キーでなく、かつユニークでないインデックスを削除します。スキーマを指定しない場合のデフォルトスキーマは、<varname>tiger_data</varname>です。</para>

note: Tag: para
en: This is useful for minimizing index bloat that may confuse the query planner or take up unnecessary space. Use in combination with <xref linkend="Install_Missing_Indexes"/> to add just the indexes used by the geocoder.
ja: PostgreSQLのクエリプランナを混乱させる可能性があり、不要なディスク容量を取る、インデックスの膨張を最小化するために使います。ジオコーダで使われるインデックスを追加する関数<xref linkend="Install_Missing_Indexes"/>を併用します。

note: Tag: refpurpose
en: Generates a script that drops all tables in the specified schema that start with <varname>county_all</varname>, <varname>state_all</varname> or state code followed by <varname>county</varname> or <varname>state</varname>.
ja: 指定したスキーマ内のテーブルのうち、<varname>county_all</varname>, <varname>state_all</varname>または、<varname>county</varname> or <varname>state</varname>を削除するスクリプトを生成します。

note: Tag: para
en: Generates a script that drops all tables in the specified schema that start with <varname>county_all</varname>, <varname>state_all</varname> or state code followed by <varname>county</varname> or <varname>state</varname>. This is needed if you are upgrading from <varname>tiger_2010</varname> to <varname>tiger_2011</varname> data.
ja: 指定したスキーマ内のテーブルのうち、名前が<varname>county_all</varname>、<varname>state_all</varname>、<varname>(州コード)_county</varname>、<varname>(州コード)_state</varname>で始まるテーブルを全て削除するスクリプトを生成します。 <varname>tiger_2010</varname>データから<varname>tiger_2011</varname>データに更新する際に必要です。

note: Tag: refpurpose
en: Generates a script that drops all tables in the specified schema that are prefixed with the state abbreviation. Defaults schema to <varname>tiger_data</varname> if no schema is specified.
ja: 指定したスキーマ内の、名前が州コードから始まるテーブルを全て削除するスクリプトを生成します。スキーマが指定されていない場合のデフォルトスキーマは<varname>tiger_data</varname>です。

note: Tag: para
en: Generates a script that drops all tables in the specified schema that are prefixed with the state abbreviation. Defaults schema to <varname>tiger_data</varname> if no schema is specified. This function is useful for dropping tables of a state just before you reload a state in case something went wrong during your previous load.
ja: 指定したスキーマ内の、名前が州コードから始まるテーブルを全て削除するスクリプトを生成します。スキーマが指定されていない場合のデフォルトスキーマは<varname>tiger_data</varname>です。ある州の以前のデータのロードがうまくいかずに再ロードする際に使います。

note: Tag: refpurpose
en: Takes in an address as a string (or other normalized address) and outputs a set of possible locations which include a point geometry in NAD 83 long lat, a normalized address for each, and the rating. The lower the rating the more likely the match. Results are sorted by lowest rating first. Can optionally pass in maximum results, defaults to 10, and restrict_region (defaults to NULL)
ja: 住所を文字列 (もしくは他の正規化された住所)として取り、可能性のある位置の集合を返します。返される集合の要素は、NAD 83経度緯度のポイントジオメトリ、正規化された住所と評価値を持ちます。評価値は低いほど可能性が高いことを示しています。結果は評価値の低い順に並べ替えられます。オプションにmax_result (最大結果数、デフォルトは10)とrestrict_region (制限領域、デフォルトはNULL)を渡すことができます。

note: Tag: para
en: Takes in an address as a string (or already normalized address) and outputs a set of possible locations which include a point geometry in NAD 83 long lat, a <varname>normalized_address</varname> (addy) for each, and the rating. The lower the rating the more likely the match. Results are sorted by lowest rating first. Uses Tiger data (edges,faces,addr), PostgreSQL fuzzy string matching (soundex,levenshtein) and PostGIS line interpolation functions to interpolate address along the Tiger edges. The higher the rating the less likely the geocode is right. The geocoded point is defaulted to offset 10 meters from center-line off to side (L/R) of street address is located on.
ja: 文字列住所 (または正規化された住所)を引数に取り、NAD 83経度緯度のポイントジオメトリ (geomout)、個々の<varname>normalized_address</varname> (addy)、評価値 (rating)からなる、可能性のある位置の集合を出力します。評価値が低いほど合致度が高くなります。Tigerデータ (エッジ、フェイス、住所)、PostgreSQLあいまい文字列合致 (soundex,levenshtein)を使い、Tigerデータのエッジに沿った住所の補間のためにPostGIS線補間関数を使用っています。評価値が高いほどジオコードの正確度が低くなります。ジオコードされたポイントは、ストリート住所を中心線から左/右に移動しますが、デフォルトでは10メートルです。

note: Tag: para
en: Enhanced: 2.0.0 to support Tiger 2010 structured data and revised some logic to improve speed, accuracy of geocoding, and to offset point from centerline to side of street address is located on. The new parameter <varname>max_results</varname> useful for specifying number of best results or just returning the best result.
ja: Enhanced: 2.0.0 Tiger 2010構造のデータに対応しました。実行速度とジオコーディング精度を改善し、ストリート住所の位置を中心線から側線に移動するための改訂を行いました。また、良い結果の数を指定したり、最も良い結果だけを返すようにするのに使う新しいパラメータ<varname>max_results</varname>を導入しました。

note: Tag: title
en: Examples: Basic
ja: 例: 基本

note: Tag: para
en: The below examples timings are on a 3.0 GHZ single processor Windows 7 machine with 2GB ram running PostgreSQL 9.1rc1/PostGIS 2.0 loaded with all of MA,MN,CA, RI state Tiger data loaded.
ja: 下の例は、3.0GHzの単一プロセッサと2GBのメモリを持つWindows 7機で、PostgreSQL 9.1rc1/PostGIS 2.0を走らせて、MA, MN, CA, RI の各州のTigerデータをロードしたものです。

note: Tag: para
en: Exact matches are faster to compute (61ms)
ja: 完全一致は速いです (61ミリ秒)

note: Tag: para
en: Even if zip is not passed in the geocoder can guess (took about 122-150 ms)
ja: 郵便番号を渡さない場合でも推測可能です (122-150ミリ秒かかりました)

note: Tag: para
en: Can handle misspellings and provides more than one possible solution with ratings and takes longer (500ms).
ja: 綴りの誤りを処理して、一つ以上の可能性のある答を評価値付きで提供すると遅くなります (500ミリ秒)。

note: Tag: para
en: Using to do a batch geocode of addresses. Easiest is to set <varname>max_results=1</varname>. Only process those not yet geocoded (have no rating).
ja: 複数住所のジオコードバッチ処理を行います。<varname>max_results=1</varname>とすると最も簡単です。まだジオコードを行っていない (評価値が無い)もののみ処理します。

note: Tag: title
en: Examples: Using Geometry filter
ja: 例: ジオメトリフィルタの使用

note: Tag: refpurpose
en: Takes in 2 streets that intersect and a state, city, zip, and outputs a set of possible locations on the first cross street that is at the intersection, also includes a geomout as the point location in NAD 83 long lat, a <varname>normalized_address</varname> (addy) for each location, and the rating. The lower the rating the more likely the match. Results are sorted by lowest rating first. Can optionally pass in maximum results, defaults to 10. Uses Tiger data (edges, faces, addr), PostgreSQL fuzzy string matching (soundex, levenshtein).
ja: インタセクトする二つのストリート、州コード、市名、郵便番号を引数に取り、最初の交差点の可能性のある位置の集合を出力します。geomoutにNAD83経度緯度のポイント、<varname>normalized_address</varname>にそれぞれの位置、ratingに評価値がそれぞれ入ります。評価値が低いほど合致度が高くなります。結果は評価値の低い順にソートされます。最大結果数を渡すことができ、デフォルトは10です。Tigerデータ (エッジ、フェイス、住所)と、PostgreSQLあいまい文字列合致 (soundex, levenshtein)を使います。

note: Tag: para
en: Takes in 2 streets that intersect and a state, city, zip, and outputs a set of possible locations on the first cross street that is at the intersection, also includes a point geometry in NAD 83 long lat, a normalized address for each location, and the rating. The lower the rating the more likely the match. Results are sorted by lowest rating first. Can optionally pass in maximum results, defaults to 10. Returns <varname>normalized_address</varname> (addy) for each, geomout as the point location in nad 83 long lat, and the rating. The lower the rating the more likely the match. Results are sorted by lowest rating first. Uses Tiger data (edges,faces,addr), PostgreSQL fuzzy string matching (soundex,levenshtein)
ja: インタセクトする二つのストリート、州コード、市名、郵便番号を引数に取り、最初の交差点の可能性のある位置の集合を出力します。集合の要素は、NAD83経度緯度のポイント、正規化された住所、評価値を持ちます。評価値が低いほど合致度が高くなります。結果は評価値の低い順にソートされます。最大結果数を渡すことができ、デフォルトは10です。<varname>normalized_address</varname> (addy)、NAD83経度緯度のポイントとしてgeomout、評価値としてratingを返します。評価値が低いほど合致度が高くなります。結果は評価値の低い順にソートされます。Tigerデータ (エッジ、フェイス、住所)と、PostgreSQLあいまい文字列合致 (soundex, levenshtein)を使います。

note: Tag: para
en: The below examples timings are on a 3.0 GHZ single processor Windows 7 machine with 2GB ram running PostgreSQL 9.0/PostGIS 1.5 loaded with all of MA state Tiger data loaded. Currently a bit slow (3000 ms)
ja: 下の例では、3.0GHz単一プロセッサで2GBメモリのWindows 7機上でPostgreSQL 9.0/PostGIS 1.5を走らせ、マサチューセッツ州のTigerデータをロードしています。この場合は、少し遅いです (3000ミリ秒)。

note: Tag: para
en: Testing on Windows 2003 64-bit 8GB on PostGIS 2.0 PostgreSQL 64-bit Tiger 2011 data loaded -- (41ms)
ja: Windows 2003 64ビット 8GBでPostGIS 2.0、PostgreSQL 64ビット版を動かし、Tiger 2011データがロードされている場合もテストしています (41ミリ秒)。

note: Tag: para
en: Even if zip is not passed in the geocoder can guess (took about 3500 ms on the windows 7 box), on the windows 2003 64-bit 741 ms
ja: 郵便番号をジオコーダに渡さない場合でも動作し、Windows 2003 64ビットで741ミリ秒でした(Windows 7機で3500ミリ秒)。

note: Tag: refpurpose
en: Returns value of specific setting stored in tiger.geocode_settings table.
ja: tiger.geocode_settingsテーブルに格納されている設定のうち指定したものの値を返します。

note: Tag: para
en: Returns value of specific setting stored in tiger.geocode_settings table. Settings allow you to toggle debugging of functions. Later plans will be to control rating with settings. Current list of settings are as follows:
ja: tiger.geocode_settingsテーブルに格納されている設定のうち指定したものの値を返します。設定によって、関数のデバッグの制御が可能です。今後の予定では、評価値の制御ができるようにします。現在の設定は次の通りです。

note: Tag: para
en: Changed: 2.2.0 : default settings are now kept in a table called geocode_settings_default. Use customized settingsa are in geocode_settings and only contain those that have been set by user.
ja: Changed: 2.2.0 : デフォルト設定をgeocode_settingsに保存するようにしました。ユーザが設定したものだけがgeocode_settings内にあります。

note: Tag: title
en: Example return debugging setting
ja: デバッグ設定を返す例

note: Tag: refpurpose
en: Returns census tract or field from tract table of where the geometry is located. Default to returning short name of tract.
ja: ジオメトリで指定した位置の米国国勢調査統計区またはtractテーブルのフィールドを返します。デフォルトでは、統計区の短縮名を返します。

note: Tag: para
en: Given a geometry will return the census tract location of that geometry. NAD 83 long lat is assumed if no spatial ref sys is specified.
ja: ジオメトリを与えると、ジオメトリの位置の米国国勢調査統計区を返します。空間参照系を指定しない場合には、NAD83経度緯度と仮定します。

note: Tag: para
en: This function uses the census <varname>tract</varname> which is not loaded by default. If you have already loaded your state table, you can load tract as well as bg, and tabblock using the <xref linkend="Loader_Generate_Census_Script"/> script.
ja: この関数はセンサスの<varname>tract</varname>を使用しますが、これはデフォルトではロードされません。すでに州テーブルをロード済みなら、<xref linkend="Loader_Generate_Census_Script"/>スクリプトを使って、tractを、bgおよびtabblockと共にロードできます。

note: Tag: para
en: If you have not loaded your state data yet and want these additional tables loaded, do the following
ja: 州データをロードしていなくて、これらの追加テーブルをロードしたい場合には、次のようにします。

note: Tag: para
en: then they will be included by the <xref linkend="Loader_Generate_Script"/>.
ja: これらは、<xref linkend="Loader_Generate_Script"/>によって取り込まれます。

note: Tag: refpurpose
en: Finds all tables with key columns used in geocoder joins and filter conditions that are missing used indexes on those columns and will add them.
ja: ジオコーダで結合や検索条件に使われ、インデックスが付いていなキーカラムを持つ全てのテーブルを探し、インデックスを追加します。

note: Tag: para
en: Finds all tables in <varname>tiger</varname> and <varname>tiger_data</varname> schemas with key columns used in geocoder joins and filters that are missing indexes on those columns and will output the SQL DDL to define the index for those tables and then execute the generated script. This is a helper function that adds new indexes needed to make queries faster that may have been missing during the load process. This function is a companion to <xref linkend="Missing_Indexes_Generate_Script"/> that in addition to generating the create index script, also executes it. It is called as part of the <filename>update_geocode.sql</filename> upgrade script.
ja: ジオコーダで結合や検索条件に使われ、インデックスが付いていなキーカラムを持つ、<varname>tiger</varname>スキーマと<varname>tiger_data</varname>スキーマ内の全てのテーブルを探し、これらのテーブルにインデックスを追加するためのSQLデータ定義言語を出力し、実行します。これは、クエリの動作速度を上げるのに必要であるのにロード処理で失われたインデックスを追加するのを助ける関数です。インデックス追加スクリプトの生成と実行を行う<xref linkend="Missing_Indexes_Generate_Script"/>の仲間です。この関数は<filename>update_geocode.sql</filename>更新スクリプトの一部として呼ばれます。

note: Tag: refpurpose
en: Generates a shell script for the specified platform for the specified states that will download Tiger census state tract, bg, and tabblocks data tables, stage and load into <varname>tiger_data</varname> schema. Each state script is returned as a separate record.
ja: 指定した州について、tract (統計区)、bg (block group, 細分区グループ)、tabblock (ブロック)をダウンロードし、<varname>tiger_data</varname>に格納するための、指定したプラットフォーム用のシェルスクリプトを生成します。行ごとに州ごとのスクリプトが返されます。

note: Tag: para
en: Generates a shell script for the specified platform for the specified states that will download Tiger data census state <varname>tract</varname>, block groups <varname>bg</varname>, and <varname>tabblocks</varname> data tables, stage and load into <varname>tiger_data</varname> schema. Each state script is returned as a separate record.
ja: 指定した州について、<varname>tract</varname> (統計区)、<varname>bg</varname> (block group, 細分区グループ)、<varname>tabblock</varname> (ブロック)をダウンロードし、<varname>tiger_data</varname>に格納するための、指定したプラットフォーム用のシェルスクリプトを生成します。行ごとに州ごとのスクリプトが返されます。

note: Tag: para
en: It uses unzip on Linux (7-zip on Windows by default) and wget to do the downloading. It uses <xref linkend="shp2pgsql_usage"/> to load in the data. Note the smallest unit it does is a whole state. It will only process the files in the staging and temp folders.
ja: ダウンロードには、Linuxではunzip (Windowsのデフォルトは7-zip)とwgetとを使います。データの格納には<xref linkend="shp2pgsql_usage"/>を使います。最小単位は州全体です。生成されるスクリプトは、格納準備中の一時フォルダ内にあるファイルのみ処理します。

note: Tag: para
en: It uses the following control tables to control the process and different OS shell syntax variations.
ja: プロセスの制御や異なるOSのシェルの書式の制御のために、次の制御テーブルを使います。

note: Tag: para
en: <varname>loader_variables</varname> keeps track of various variables such as census site, year, data and staging schemas
ja: <varname>loader_variables</varname> 国勢調査ダウンロードサイト、年度、データと準備スキーマといった種々の変数の軌跡を保持します。

note: Tag: para
en: <varname>loader_platform</varname> profiles of various platforms and where the various executables are located. Comes with windows and linux. More can be added.
ja: <varname>loader_platform</varname> 種々のプラットフォームのプロファイルと種々の実行ファイルを置いてある位置です。windowsとLinux/unixを備えています。追加も可能です。

note: Tag: para
en: <varname>loader_lookuptables</varname> each record defines a kind of table (state, county), whether to process records in it and how to load them in. Defines the steps to import data, stage data, add, removes columns, indexes, and constraints for each. Each table is prefixed with the state and inherits from a table in the tiger schema. e.g. creates <varname>tiger_data.ma_faces</varname> which inherits from <varname>tiger.faces</varname>
ja: <varname>loader_lookuptables</varname> レコードごとにテーブルの種類 (州、国)、レコード処理の有無、ロード方法を定義しています。データインポート方法、データ格納準備、カラム追加、カラム削除、インデックス、制約がそれぞれで定義されています。個々のテーブルは、名前の先頭に州コードを持ち、tigerスキーマのテーブルから継承されています。たとえば、<varname>tiger.faces</varname>から継承した<varname>tiger_data.ma_faces</varname>の生成といったことが行われます。

note: Tag: para
en: includes this logic, but if you installed tiger geocoder prior to PostGIS 2.0.0 alpha5, you'll need to run this on the states you have already done to get these additional tables.
ja: は、このロジックを含んでいますが、PostGIS 2.0.0 alpha 5より前にTigerジオコーダをインストールしてLoader_Generate_Scriptを実行した場合には、これを実行する必要があります。

note: Tag: para
en: Generate script to load up data for select states in Windows shell script format.
ja: Windowsシェルスクリプト書式での選択した州のデータをロードするスクリプトの生成。

note: Tag: para
en: Generate sh script
ja: shスクリプトの生成

note: Tag: refpurpose
en: Generates a shell script for the specified platform for the specified states that will download Tiger data, stage and load into <varname>tiger_data</varname> schema. Each state script is returned as a separate record. Latest version supports Tiger 2010 structural changes and also loads census tract, block groups, and blocks tables.
ja: 指定したプラットフォーム用の、指定した州のTigerデータをダウンロードし、格納準備を行い、<varname>tiger_data</varname>スキーマに格納するシェルスクリプトを生成します。行ごとに州ごとのスクリプトが返ります。最新版ではTiger 2010のデータ構造変更に対応していて、国勢統計区、細分区グループ、細分区 (tabblocks)テーブルをダウンロードすることができます。

note: Tag: para
en: Generates a shell script for the specified platform for the specified states that will download Tiger data, stage and load into <varname>tiger_data</varname> schema. Each state script is returned as a separate record.
ja: 指定したプラットフォーム用の、指定した州のTigerデータをダウンロードし、格納準備を行い、<varname>tiger_data</varname>スキーマに格納するシェルスクリプトを生成します。行ごとに州ごとのスクリプトが返ります。

note: Tag: para
en: It uses unzip on Linux (7-zip on Windows by default) and wget to do the downloading. It uses <xref linkend="shp2pgsql_usage"/> to load in the data. Note the smallest unit it does is a whole state, but you can overwrite this by downloading the files yourself. It will only process the files in the staging and temp folders.
ja: ダウンロードには、Linuxではunzip (Windowsのデフォルトは7-zip)とwgetとを使います。データの格納には<xref linkend="shp2pgsql_usage"/>を使います。ダウンロードの最小単位は州全体ですが、ファイルを手動でダウンロードすることで上書きできます。生成されるスクリプトは、格納準備中の一時フォルダ内にあるファイルのみ処理します。

note: Tag: para
en: Availability: 2.0.0 to support Tiger 2010 structured data and load census tract (tract), block groups (bg), and blocks (tabblocks) tables .
ja: Availability: 2.0.0 Tiger 2010構造のデータに対応しました。国勢統計区 (tract)、細分区グループ ("block groups", bg)、細分区 (tabblocks)テーブルをダウンロードします。

note: Tag: para
en: If you are using pgAdmin 3, be warned that by default pgAdmin 3 truncates long text. To fix, change <emphasis>File -&gt; Options -&gt; Query Tool -&gt; Query Editor - &gt; Max. characters per column</emphasis> to larger than 50000 characters.
ja: pgAdmin 3を使用している場合には、pgAdmin 3はデフォルトでは長い文字列を切り捨てることに注意して下さい。修正するには、<emphasis>ファイル -&gt; オプション -&gt; クエリツール -&gt; クエリエディタ -&gt; カラムあたり最大文字数</emphasis>を50000文字以上に変更します。

note: Tag: para
en: Using psql where gistest is your database and <filename>/gisdata/data_load.sh</filename> is the file to create with the shell commands to run.
ja: gistestが使用中のデータベースで、また<filename>/gisdata/data_load.sh</filename>が実行するシェルコマンドを使って生成するファイルとすると、psqlを使って次のようにします。

note: Tag: para
en: Generate script to load up data for 2 states in Windows shell script format.
ja: Windowsシェルスクリプト書式で二つの州のデータをロードするスクリプトを生成します。

note: Tag: refpurpose
en: Generates a shell script for the specified platform that loads in the county and state lookup tables.
ja: 指定したプラットフォーム用の、国と州のルックアップテーブルをロードするシェルスクリプトを生成します。

note: Tag: para
en: Generates a shell script for the specified platform that loads in the <varname>county_all</varname>, <varname>county_all_lookup</varname>, <varname>state_all</varname> tables into <varname>tiger_data</varname> schema. These inherit respectively from the <varname>county</varname>, <varname>county_lookup</varname>, <varname>state</varname> tables in <varname>tiger</varname> schema.
ja: <varname>tiger_data</varname>スキーマに<varname>county_all</varname>, <varname>county_all_lookup</varname>, <varname>state_all</varname>テーブルをロードする、指定したプラットフォーム用のシェルスクリプトを生成します。それぞれ<varname>tiger</varname>スキーマの<varname>county</varname>, <varname>county_lookup</varname>, <varname>state</varname>から継承されます。

note: Tag: para
en: It uses unzip on Linux (7-zip on Windows by default) and wget to do the downloading. It uses <xref linkend="shp2pgsql_usage"/> to load in the data.
ja: ダウンロードには、Linuxではunzip (Windowsのデフォルトは7-zip)とwgetとを使います。データの格納には<xref linkend="shp2pgsql_usage"/>を使います。

note: Tag: para
en: It uses the following control tables <varname>tiger.loader_platform</varname>, <varname>tiger.loader_variables</varname>, and <varname>tiger.loader_lookuptables</varname> to control the process and different OS shell syntax variations.
ja: プロセスの制御や異なるOSのシェルの書式の制御のために、制御テーブル<varname>tiger.loader_platform</varname>, <varname>tiger.loader_variables</varname>, <varname>tiger.loader_lookuptables</varname>を使います。

note: Tag: para
en: <varname>loader_platform</varname> profiles of various platforms and where the various executables are located. Comes with windows and linux/unix. More can be added.
ja: <varname>loader_platform</varname>には、種々のプラットフォームのプロファイルや実行可能ファイルの置いてある位置を持ちます。windowsとLinux/unixを備えています。追加も可能です。

note: Tag: para
en: Enhanced: 2.4.1 zip code 5 tabulation area (zcta5) load step was fixed and when enabled, zcta5 data is loaded as a single table called zcta5_all as part of the nation script load.
ja: Enhanced: 2.4.1 5桁郵便番号集計地域 (zcta5)のロードが修正されて、zcta5データは、有効な時には、国データのロードの中でzcta5_allという単一テーブルとしてロードされるようになりました。

note: Tag: para
en: If you want zip code 5 tabulation area (zcta5) to be included in your nation script load, do the following:
ja: 5桁郵便番号集計地域を国データのロードに取り込みたい場合には、次のようにします。

note: Tag: para
en: If you were running <varname>tiger_2010</varname> version and you want to reload as state with newer tiger data, you'll need to for the very first load generate and run drop statements <xref linkend="Drop_Nation_Tables_Generate_Script"/> before you run this script.
ja: <varname>tiger_2010</varname>を実行して、それより新しいTigerデータで州データの再ロードを行うには、このスクリプトを実行する前に、最初に、<xref linkend="Drop_Nation_Tables_Generate_Script"/>によって、テーブル削除スクリプトを生成、実行する必要があります。

note: Tag: para
en: Generate script script to load nation data Windows.
ja: 国データをWindowsにロードするスクリプトを生成します。

note: Tag: para
en: Generate script to load up data for Linux/Unix systems.
ja: 国データをLinux/Unixシステムにロードするスクリプトを生成します。

note: Tag: refpurpose
en: Finds all tables with key columns used in geocoder joins that are missing indexes on those columns and will output the SQL DDL to define the index for those tables.
ja: ジオコーダで結合に使われるキーカラムを持ち、インデックスが付いていないキーカラムを持つすべてのテーブルを検索し、インデックスを追加するSQLデータ定義言語を出力します。

note: Tag: para
en: Finds all tables in <varname>tiger</varname> and <varname>tiger_data</varname> schemas with key columns used in geocoder joins that are missing indexes on those columns and will output the SQL DDL to define the index for those tables. This is a helper function that adds new indexes needed to make queries faster that may have been missing during the load process. As the geocoder is improved, this function will be updated to accommodate new indexes being used. If this function outputs nothing, it means all your tables have what we think are the key indexes already in place.
ja: <varname>tiger</varname>スキーマと<varname>tiger_data</varname>スキーマ内のジオコーダで結合に使われ、インデックスが付いていないキーカラムを持つ全てのテーブルを検索し、インデックスを付けるSQLデータ定義言語を出力します。これは、クエリの動作速度を上げるのに必要であるのにロード処理で失われたインデックスを追加するのを助ける関数です。ジオコーダが改善されますが、使用される新しいインデックスを受け入れるために、この関数は更新されます。この関数の出力が無い場合がありますが、これは、全てのテーブルにインデックスが付いていると考えられます。

note: Tag: refpurpose
en: Given a textual street address, returns a composite <varname>norm_addy</varname> type that has road suffix, prefix and type standardized, street, streetname etc. broken into separate fields. This function will work with just the lookup data packaged with the tiger_geocoder (no need for tiger census data).
ja: 文字列で住所が与えられると、道路後置辞、前置辞、正規化された種別、番地、ストリート名等をフィールドに分けて持つ<varname>norm_addy</varname>複合型を返します。tiger_geocoderに同梱されているルックアップデータで動作します (Tigerデータ自体は不要です)。

note: Tag: para
en: Given a textual street address, returns a composite <varname>norm_addy</varname> type that has road suffix, prefix and type standardized, street, streetname etc. broken into separate fields. This is the first step in the geocoding process to get all addresses into normalized postal form. No other data is required aside from what is packaged with the geocoder.
ja: 文字列で住所が与えられると、道路後置辞、前置辞、正規化された種別、番地、ストリート名等をフィールドに分けて持つ<varname>norm_addy</varname>複合型を返します。全ての住所を正規化した郵便形式にするジオコーディング処理の第一段階です。ジオコーダに同梱されるもの以外で必要な者はありません。

note: Tag: para
en: This function just uses the various direction/state/suffix lookup tables preloaded with the tiger_geocoder and located in the <varname>tiger</varname> schema, so it doesn't need you to download tiger census data or any other additional data to make use of it. You may find the need to add more abbreviations or alternative namings to the various lookup tables in the <varname>tiger</varname> schema.
ja: tiger_geocoderによって前もってロードされ、<varname>tiger</varname>スキーマに格納される、様々な方角/州/後置辞のルックアップテーブルを使います。よって、Tigerデータをダウンロードしたり、追加データをする必要はありません。<varname>tiger</varname>スキーマ内のルックアップテーブルに略語や別名の追加が必要になることがあります。

note: Tag: para
en: It uses various control lookup tables located in <varname>tiger</varname> schema to normalize the input address.
ja: <varname>tiger</varname>スキーマ内に、入力アドレスを正規化するための、多様な制御ルックアップテーブルを使います。

note: Tag: para
en: Fields in the <varname>norm_addy</varname> type object returned by this function in this order where () indicates a field required by the geocoder, [] indicates an optional field:
ja: この関数が返す<varname>norm_addy</varname>型オブジェクトのフィールドは、次に示す順序です。()はジオコーダの必須フィールド、[]は任意フィールドです。

note: Tag: para
en: Enhanced: 2.4.0 norm_addy object includes additional fields zip4 and address_alphanumeric.
ja: Enhanced: 2.4.0 norm_addyオブジェクトには追加フィールドのzip4とaddress_alphanumericとが含まれます。

note: Tag: para
en: <varname>address</varname> is an integer: The street number
ja: <varname>address</varname> 整数: 番地

note: Tag: para
en: <varname>predirAbbrev</varname> is varchar: Directional prefix of road such as N, S, E, W etc. These are controlled using the <varname>direction_lookup</varname> table.
ja: <varname>predirAbbrev</varname> varchar型: N, S, E, W等といった道路の方向前置辞。<varname>direction_lookup</varname>テーブルに制御されます。

note: Tag: para
en: <varname>streetName</varname> varchar
ja: <varname>streetName</varname> varchar型

note: Tag: para
en: <varname>streetTypeAbbrev</varname> varchar abbreviated version of street type: e.g. St, Ave, Cir. These are controlled using the <varname>street_type_lookup</varname> table.
ja: <varname>streetTypeAbbrev</varname> varchar型 ストリート種別の短縮名: St, Ave, Cir等。<varname>street_type_lookup</varname>テーブルに制御されます。

note: Tag: para
en: <varname>postdirAbbrev</varname> varchar abbreviated directional suffice of road N, S, E, W etc. These are controlled using the <varname>direction_lookup</varname> table.
ja: <varname>postdirAbbrev</varname> varchar型 N, S, E, W等の道路名の方向後置辞。<varname>direction_lookup</varname>テーブルに制御されます。

note: Tag: para
en: <varname>internal</varname> varchar internal address such as an apartment or suite number.
ja: <varname>internal</varname> varchar型 部屋番号といった内部住所。

note: Tag: para
en: <varname>location</varname> varchar usually a city or governing province.
ja: <varname>location</varname> varchar型 通常は市名や県名です。

note: Tag: para
en: <varname>stateAbbrev</varname> varchar two character US State. e.g MA, NY, MI. These are controlled by the <varname>state_lookup</varname> table.
ja: <varname>stateAbbrev</varname> varchar型 MA, NY, MI等のような米国の州名の2文字表示です。<varname>state_lookup</varname>テーブルに制御されます。

note: Tag: para
en: <varname>zip</varname> varchar 5-digit zipcode. e.g. 02109.
ja: <varname>zip</varname> varchar型 02109等の5桁の数字です。

note: Tag: para
en: <varname>parsed</varname> boolean - denotes if address was formed from normalize process. The normalize_address function sets this to true before returning the address.
ja: <varname>parsed</varname> 真偽型 - 住所が正規化処理で整形されたかを示します。normalize_addressは、住所を返す前にこれをTRUEにします。

note: Tag: para
en: <varname>zip4</varname> last 4 digits of a 9 digit zip code. Availability: PostGIS 2.4.0.
ja: <varname>zip4</varname> 9桁郵便番号の後半4桁です。Availability: PostGIS 2.4.0。

note: Tag: para
en: <varname>address_alphanumeric</varname> Full street number even if it has alpha characters like 17R. Parsing of this is better using <xref linkend="Pagc_Normalize_Address"/> function. Availability: PostGIS 2.4.0.
ja: <varname>address_alphanumeric</varname> 17Rのような文字を含む完全なストリート番号。これの解析は<xref linkend="Pagc_Normalize_Address"/>関数を使うと良くなります。 Availability: PostGIS 2.4.0。

note: Tag: para
en: Output select fields. Use <xref linkend="Pprint_Addy"/> if you want a pretty textual output.
ja: フィールドを選択して出力します。きれいな文字列を求める場合には、<xref linkend="Pprint_Addy"/>を使います。

note: Tag: refpurpose
en: Given a textual street address, returns a composite <varname>norm_addy</varname> type that has road suffix, prefix and type standardized, street, streetname etc. broken into separate fields. This function will work with just the lookup data packaged with the tiger_geocoder (no need for tiger census data). Requires address_standardizer extension.
ja: 文字列のストリート住所を与えると、道路後置辞、前置辞、標準タイプ、番地、ストリート名等を複数フィールドに分解して持つ<varname>norm_addy</varname>複合型を返します。この関数は、tiger_geocoder同梱のルックアップテーブルだけを使います (Tigerデータは不要です)。住所標準化エクステンションが必要です。

note: Tag: para
en: This function just uses the various pagc_* lookup tables preloaded with the tiger_geocoder and located in the <varname>tiger</varname> schema, so it doesn't need you to download tiger census data or any other additional data to make use of it. You may find the need to add more abbreviations or alternative namings to the various lookup tables in the <varname>tiger</varname> schema.
ja: この関数は、Tigerジオコーダとともにロードされ、<varname>tiger</varname>スキーマに置かれる、種々のpagc_+ルックアップテーブルだけを使うので、Tigerデータや他のデータをダウンロードする必要はありません。略語や別名を<varname>tiger</varname>スキーマのルックアップテーブルに追加しなければならない場合もあります。

note: Tag: para
en: There are slight variations in casing and formatting over the <xref linkend="Normalize_Address"/>.
ja: 処理と書式について<xref linkend="Normalize_Address"/>と若干の違いがあります。

note: Tag: para
en: The native standardaddr of address_standardizer extension is at this time a bit richer than norm_addy since its designed to support international addresses (including country). standardaddr equivalent fields are:
ja: 住所標準化エクステンションのstandardaddrは、他国の住所への対応 (countryも含む)があるため、norm_addyより若干フィールドが多くなります。standardaddrの、norm_addyと等価なフィールドは次の通りです。

note: Tag: para
en: Single call example
ja: 単一呼び出しの例を示します。

note: Tag: para
en: Batch call. There are currently speed issues with the way postgis_tiger_geocoder wraps the address_standardizer. These will hopefully be resolved in later editions. To work around them, if you need speed for batch geocoding to call generate a normaddy in batch mode, you are encouraged to directly call the address_standardizer standardize_address function as shown below which is similar exercise to what we did in <xref linkend="Normalize_Address"/> that uses data created in <xref linkend="Geocode"/>.
ja: バッチ呼び出しの例です。現在は、postgis_tiger_geocoderはaddress_standardizerを使用しているため、速度の問題があります。うまくいけば、今後解決されることでしょう。normaddyへのジオコーディングのバッチ処理で速度が必要な場合には、住所標準化エクステンションのstandaridze_address関数を直接呼ぶことで回避できます。<xref linkend="Geocode"/>で生成されたデータを使う<xref linkend="Normalize_Address"/>で行っていることと似ています。例を次に示します。

note: Tag: refpurpose
en: Given a <varname>norm_addy</varname> composite type object, returns a pretty print representation of it. Usually used in conjunction with normalize_address.
ja: <varname>norm_addy</varname>複合型オブジェクトを与えると、印刷表現を返します。通常はnormalize_addressと併用します。

note: Tag: para
en: Given a <varname>norm_addy</varname> composite type object, returns a pretty print representation of it. No other data is required aside from what is packaged with the geocoder.
ja: <varname>norm_addy</varname>複合型オブジェクトを与えると、印刷表現を返します。Tigerジオコーダ同梱のデータ以外は不要です。

note: Tag: para
en: Usually used in conjunction with <xref linkend="Normalize_Address"/>.
ja: 通常は<xref linkend="Normalize_Address"/>と併用します。

note: Tag: para
en: Pretty print a single address
ja: 単一住所の印刷表現

note: Tag: para
en: Pretty print address a table of addresses
ja: 住所テーブルの印刷表現

note: Tag: refpurpose
en: Takes a geometry point in a known spatial ref sys and returns a record containing an array of theoretically possible addresses and an array of cross streets. If include_strnum_range = true, includes the street range in the cross streets.
ja: 登録されている空間参照系に基づくポイントジオメトリを引数に取り、理論的に可能性のある住所の配列と交差するストリートの配列を一つのレコードで返します。include_strnum_range = trueの場合には、交差するストリートに番地範囲を追加します。

note: Tag: para
en: Takes a geometry point in a known spatial ref and returns a record containing an array of theoretically possible addresses and an array of cross streets. If include_strnum_range = true, includes the street range in the cross streets. include_strnum_range defaults to false if not passed in. Addresses are sorted according to which road a point is closest to so first address is most likely the right one.
ja: 登録されている空間参照系に基づくポイントジオメトリを引数に取り、理論的に可能性のある住所の配列と交差するストリートの配列を一つのレコードで返します。include_strnum_range = trueの場合には、交差するストリートに番地範囲を追加します。include_strnum_rangeは、していない場合のデフォルトはFALSEです。住所は、ポイントから近い順の道路でソートされるので、最初の要素が最も正解に近くなります。

note: Tag: para
en: Why do we say theoretical instead of actual addresses. The Tiger data doesn't have real addresses, but just street ranges. As such the theoretical address is an interpolated address based on the street ranges. Like for example interpolating one of my addresses returns a 26 Court St. and 26 Court Sq., though there is no such place as 26 Court Sq. This is because a point may be at a corner of 2 streets and thus the logic interpolates along both streets. The logic also assumes addresses are equally spaced along a street, which of course is wrong since you can have a municipal building taking up a good chunk of the street range and the rest of the buildings are clustered at the end.
ja: 実際の住所ではなく理論的な住所と書いているのには理由があります。Tigerデータは本当の住所ではなく、番地の範囲を持っています。そのため、理論的な住所は番地範囲に基づいて補間したものです。補間する場合には、たとえば、26 Court Sq.が存在しないにもかかわらず、26 Court St. と 26 Court Sq.が返る、といったことがあります。これは、ポイントが二つのストリートの角にあるのが原因で、両方のストリートに沿って補間を行うためです。住所はストリートに沿って等間隔になっていると仮定しています。非常に多くの番地範囲を取ってしまっている自治体の建物があり、他の建物がストリートの終わりにかたまっているため、ストリートの方向が悪いです。

note: Tag: para
en: Note: Hmm this function relies on Tiger data. If you have not loaded data covering the region of this point, then hmm you will get a record filled with NULLS.
ja: ご注意: この関数はTigerデータに依存しています。指定した点を含む領域のデータが無い場合には、NULLで満たされた一つのレコードが返されます。

note: Tag: para
en: Returned elements of the record are as follows:
ja: 返されるレコードの要素は次の通りです。

note: Tag: para
en: <varname>intpt</varname> is an array of points: These are the center line points on the street closest to the input point. There are as many points as there are addresses.
ja: <varname>intpt</varname> ポイント配列: 入力ポイントに最も近いストリートの中心線のポイントです。住所と同じだけポイントがあります。

note: Tag: para
en: <varname>addy</varname> is an array of norm_addy (normalized addresses): These are an array of possible addresses that fit the input point. The first one in the array is most likely. Generally there should be only one, except in the case when a point is at the corner of 2 or 3 streets, or the point is somewhere on the road and not off to the side.
ja: <varname>addy</varname> norm_addy (正規化された住所)の配列: 入力ポイントに合わせた、可能性のある住所の配列です。最初の要素が最も可能性が高いものです。一般的に、一つだけになるべきですが、ポイントが二つか三つのストリートの角にあったり、ポイントが道路上のどこかにあって側線から離れている場合には、数出現します。

note: Tag: para
en: <varname>street</varname> an array of varchar: These are cross streets (or the street) (streets that intersect or are the street the point is projected to be on).
ja: <varname>street</varname> varchar型の配列: 交差するストリート (ストリートがインタセクトする場合)または一つのストリート (指定したポイントが乗るストリートである場合)です。

note: Tag: para
en: Enhanced: 2.4.1 if optional zcta5 dataset is loaded, the reverse_geocode function can resolve to state and zip even if the specific state data is not loaded. Refer to <xref linkend="Loader_Generate_Nation_Script"/> for details on loading zcta5 data.
ja: Enhanced: 2.4.1 ZCTA5データセットを追加でロードする場合には、reverse_geocode関数は、特定の州データがロードされていなくても、州とZIPを解決することができます。ZTCA5データのロードに関する詳細については<xref linkend="Loader_Generate_Nation_Script"/>を参照して下さい。

note: Tag: para
en: Example of a point at the corner of two streets, but closest to one. This is approximate location of MIT: 77 Massachusetts Ave, Cambridge, MA 02139 Note that although we don't have 3 streets, PostgreSQL will just return null for entries above our upper bound so safe to use. This includes street ranges
ja: ストリートの角であって、かつ最も近くなる二つの点の例です。MIT (Massachusetts Ave, Cambridge, MA 02139 )に近い位置です。ストリートは三つはないですが、PostgreSQLは配列の範囲からはみ出してもNULLを返すので安全です。番地範囲を含んでいます。

note: Tag: para
en: Here we choose not to include the address ranges for the cross streets and picked a location really really close to a corner of 2 streets thus could be known by two different addresses.
ja: 交差するストリートの番地範囲を含めないことを選択しました。また、二つの異なる住所が分かるよう、二つのストリートの角に本当に近い位置を指定しました。

note: Tag: para
en: For this one we reuse our geocoded example from <xref linkend="Geocode"/> and we only want the primary address and at most 2 cross streets.
ja: <xref linkend="Geocode"/>からジオコーディングの例を再利用しています。主要な住所と、せいぜい二つの交差するストリートを求めているだけです。

note: Tag: refpurpose
en: Loads a defined region of tiger data into a PostGIS Topology and transforming the tiger data to spatial reference of the topology and snapping to the precision tolerance of the topology.
ja: Tigerデータの定義領域をPostGISトポロジにロードして、Tigerデータをトポロジの空間参照系に投影変換し、トポロジの許容精度にスナップします。

note: Tag: para
en: Loads a defined region of tiger data into a PostGIS Topology. The faces, nodes and edges are transformed to the spatial reference system of the target topology and points are snapped to the tolerance of the target topology. The created faces, nodes, edges maintain the same ids as the original Tiger data faces, nodes, edges so that datasets can be in the future be more easily reconciled with tiger data. Returns summary details about the process.
ja: Tigerデータの定義領域をPostGISトポロジにロードします。フェイス、ノード、エッジは対象トポロジの空間参照系に投影変換され、点は対象トポロジの許容精度にスナップされます。生成されたフェイス、ノード、エッジは、元のTigerデータのフェイス、ノード、エッジの識別値を維持するので、将来、データセットをより簡単にTigerデータに一致させることができます。処理の詳細に関する要約を返します。

note: Tag: para
en: This would be useful for example for redistricting data where you require the newly formed polygons to follow the center lines of streets and for the resulting polygons not to overlap.
ja: これはデータの区域改訂に使えますが、ストリートの中心線に沿って新たに形成されるポリゴンと重ならないポリゴンとが必要です。

note: Tag: para
en: This function relies on Tiger data as well as the installation of the PostGIS topology module. For more information, refer to <xref linkend="Topology"/> and <xref linkend="installation_configuration"/>. If you have not loaded data covering the region of interest, then no topology records will be created. This function will also fail if you have not created a topology using the topology functions.
ja: この関数はPostGISトポロジモジュールとTigerデータに依存しています。詳細情報については、<xref linkend="Topology"/>と<xref linkend="installation_configuration"/>を参照して下さい。対象領域を含むデータを持っていない場合には、トポロジは作られません。トポロジ関数を使ってトポロジが生成されない場合も失敗します。

note: Tag: para
en: Most topology validation errors are a result of tolerance issues where after transformation the edges points don't quite line up or overlap. To remedy the situation you may want to increase or lower the precision if you get topology validation failures.
ja: ほとんどのトポロジ評価エラーは許容範囲の問題です。エッジの投影変換の後にポイントが準備できなかったり、エッジからずれる場合にあたります。トポロジ評価に失敗する状況を改善するには、精度を下げます。

note: Tag: para
en: Required arguments:
ja: 必須引数:

note: Tag: para
en: <varname>topo_name</varname> The name of an existing PostGIS topology to load data into.
ja: <varname>topo_name</varname> データを納めるPostGISトポロジの名前

note: Tag: para
en: <varname>region_type</varname> The type of bounding region. Currently only <varname>place</varname> and <varname>county</varname> are supported. Plan is to have several more. This is the table to look into to define the region bounds. e.g <varname>tiger.place</varname>, <varname>tiger.county</varname>
ja: <varname>region_type</varname> 境界種別。現在は<varname>place</varname> と<varname>county</varname>とだけに対応しています。今後増やす予定です。これは境界を定義するために見るテーブルです。<varname>tiger.place</varname>や<varname>tiger.county</varname>等があたります。

note: Tag: para
en: <varname>region_id</varname> This is what TIGER calls the geoid. It is the unique identifier of the region in the table. For place it is the <varname>plcidfp</varname> column in <varname>tiger.place</varname>. For county it is the <varname>cntyidfp</varname> column in <varname>tiger.county</varname>
ja: <varname>region_id</varname> TIGERではgeoidと呼ばれるものです。テーブルで領域の一意の識別子です。placeでは<varname>tiger.place</varname>テーブルの<varname>plcidfp</varname>カラムで、郡では<varname>tiger.country</varname>テーブルの<varname>cntyidfp</varname>カラムで保持します。

note: Tag: title
en: Example: Boston, Massachusetts Topology
ja: 例: マサチューセッツ州ボストン市のトポロジ

note: Tag: para
en: Create a topology for Boston, Massachusetts in Mass State Plane Feet (2249) with tolerance 0.25 feet and then load in Boston city tiger faces, edges, nodes.
ja: マサチューセッツ州ボストンのトポロジをマサチューセッツ州フィート平面 (2249)、許容範囲0.25フィートで生成し、ボストンのTigerデータのフェイス、エッジ、ノードをロードします。

note: Tag: title
en: Example: Suffolk, Massachusetts Topology
ja: 例: マサチューセッツ州サフォーク郡のトポロジ

note: Tag: para
en: Create a topology for Suffolk, Massachusetts in Mass State Plane Meters (26986) with tolerance 0.25 meters and then load in Suffolk county tiger faces, edges, nodes.
ja: マサチューセッツ州サフォークのトポロジを、マサチューセッツ州メートル平面 (26986)、許容範囲0.25メートルで生成し、サフォークのTigerデータのフェイス、エッジ、ノードをロードします。

note: Tag: refpurpose
en: Sets a setting that affects behavior of geocoder functions.
ja: ジオコーダ関数の振る舞いに影響を与える設定を行います。

note: Tag: para
en: Sets value of specific setting stored in <varname>tiger.geocode_settings</varname> table. Settings allow you to toggle debugging of functions. Later plans will be to control rating with settings. Current list of settings are listed in <xref linkend="Get_Geocode_Setting"/>.
ja: <varname>tiger.geocode_settings</varname>テーブルに格納されている設定の値を設定します。設定によって、関数のデバッグの切り替えができます。今後、評価値の制御を設定から行えるようにする予定です。現在の設定リストは<xref linkend="Get_Geocode_Setting"/>にあります。

note: Tag: para
en: If you run <xref linkend="Geocode"/> when this function is true, the NOTICE log will output timing and queries.
ja: この関数がTRUEを返す場合に<xref linkend="Geocode"/>を実行すると、時刻とクエリがNOTICEログに出力されます。

note: Tag: title
en: Topology
ja: トポロジ

note: Tag: para
en: The PostGIS Topology types and functions are used to manage topological objects such as faces, edges and nodes.
ja: PostGISトポロジ型と関数は、フェイス、エッジ、ノード等のトロポジオブジェクトを管理するために使います。

note: Tag: para
en: Sandro Santilli's presentation at PostGIS Day Paris 2011 conference gives a good synopsis of PostGIS Topology and where it is headed <link xlink:href="http://strk.kbt.io/projects/postgis/Paris2011_TopologyWithPostGIS_2_0.pdf">Topology with PostGIS 2.0 slide deck</link>.
ja: PostGIS Day Paris 2011におけるSandro Santilliさんの講演が、PostGISトポロジの概略説明として良いです。<link xlink:href="http://strk.keybit.net/projects/postgis/Paris2011_TopologyWithPostGIS_2_0.pdf">Topology with PostGIS 2.0 slide deck</link>にあります。

note: Tag: para
en: Vincent Picavet provides a good synopsis and overview of what is Topology, how is it used, and various FOSS4G tools that support it in <link xlink:href="https://gitlab.com/Oslandia/documentation/presentations/-/blob/master/2012/pgconf_eu_2012/pgconfeu2012_vincent_picavet_postgis_topology.pdf">PostGIS Topology PGConf EU 2012</link>.
ja: Vincent Picavetさんはトポロジとは何か、どのように使われるか、および、対応するFOSS4Gツールに関する良い概略説明を <link xlink:href="https://gitlab.com/Oslandia/documentation/presentations/-/blob/master/2012/pgconf_eu_2012/pgconfeu2012_vincent_picavet_postgis_topology.pdf">PostGIS Topology PGConf EU 2012</link>で出しています。

note: Tag: para
en: An example of a topologically based GIS database is the <link xlink:href="https://www.census.gov/geo/maps-data/data/tiger.html">US Census Topologically Integrated Geographic Encoding and Referencing System (TIGER)</link> database. If you want to experiment with PostGIS topology and need some data, check out <xref linkend="Topology_Load_Tiger"/>.
ja: トポロジベースのGISデータベースの例として<link xlink:href="https://www.census.gov/geo/maps-data/data/tiger.html">US Census Topologically Integrated Geographic Encoding and Referencing System (TIGER)</link>があります。PostGISトポロジの試験がしたくて、何らかのデータが必要なら<xref linkend="Topology_Load_Tiger"/>をご覧下さい。

note: Tag: para
en: The PostGIS topology module has existed in prior versions of PostGIS but was never part of the Official PostGIS documentation. In PostGIS 2.0.0 major cleanup is going on to remove use of all deprecated functions in it, fix known usability issues, better document the features and functions, add new functions, and enhance to closer conform to SQL-MM standards.
ja: PostGISトポロジモジュールは前の版にもありましたが、正式なPostGIS文書の中には入れていませんでした。PostGIS 2.0.0 では、全ての非推奨関数を無くし、知られていた使いやすさの問題を解決し、機能と関数の文書をより良くし、新しい関数を追加し、SQL-MM標準により準拠させるために、大整理を行っています。

note: Tag: para
en: Details of this project can be found at <link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiPostgisTopology">PostGIS Topology Wiki</link>
ja: このプロジェクトの詳細情報は<link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiPostgisTopology">PostGIS Topology Wiki</link>にあります。

note: Tag: para
en: All functions and tables associated with this module are installed in a schema called <varname>topology</varname>.
ja: このモジュールに関する全ての関数とテーブルは、<varname>topology</varname>スキーマにインストールされます。

note: Tag: para
en: Functions that are defined in SQL/MM standard are prefixed with ST_ and functions specific to PostGIS are not prefixed.
ja: SQL/MM標準で定義される関数はST_プリフィクスを持ち、PostGIS特有の関数はこのプリフィクスを持ちません。

note: Tag: para
en: Topology support is build by default starting with PostGIS 2.0, and can be disabled specifying --without-topology configure option at build time as described in <xref linkend="postgis_installation"/>
ja: PostGIS 2.0以降では、トポロジ機能はデフォルトでビルドされます。<xref linkend="postgis_installation"/>で説明されている通り、ビルド時のコンフィギュアオプション --without-topology を指定することで、無効にできます。

note: Tag: title
en: Topology Types
ja: トポロジ型

note: Tag: para
en: This section lists the PostgreSQL data types installed by PostGIS Topology. Note we describe the casting behavior of these which is very important especially when designing your own functions.
ja: 本節では、PostGISトポロジでインストールされるPostgreSQLデータ型の一覧を挙げます。独自に関数をデザインする際に特に重要となる、キャストでの挙動を記述していることにご注意ください。

note: Tag: refpurpose
en: A composite type that consists of a sequence number and an edge number.
ja: 順序番号とエッジ番号で構成される複合型。

note: Tag: para
en: A composite type that consists of a sequence number and an edge number. This is the return type for <varname>ST_GetFaceEdges</varname> and <varname>GetNodeEdges</varname> functions.
ja: 順序番号とエッジ番号で構成される複合型。これは<varname>ST_GetFaceEdges</varname>と<varname>GetNodeEdges</varname>の返り値の型です。

note: Tag: para
en: <varname>sequence</varname> is an integer: Refers to a topology defined in the topology.topology table which defines the topology schema and srid.
ja: <varname>sequence</varname> (整数): トポロジスキーマとSRIDを定義するtopology.topologyテーブルで定義されるトポロジへの参照です。

note: Tag: para
en: <varname>edge</varname> is an integer: The identifier of an edge.
ja: <varname>edge</varname> (整数): エッジの識別番号です。

note: Tag: refpurpose
en: A composite type representing a topologically defined geometry.
ja: トポロジとして定義されたジオメトリを表現する型です。

note: Tag: para
en: A composite type that refers to a topology geometry in a specific topology layer, having a specific type and a specific id. The elements of a TopoGeometry are the properties: topology_id, layer_id, id integer, type integer.
ja: 特定のトポロジレイヤ内のトポロジジオメトリを参照する複合型で、特定のタイプと特定のIDを持ちます。TopoGeometryの要素はtopology_id, layer_id, id integer, type integerの各属性です。

note: Tag: para
en: <varname>topology_id</varname> is an integer: Refers to a topology defined in the topology.topology table which defines the topology schema and srid.
ja: <varname>topology_id</varname> (整数): トポロジスキーマとSRIDを定義するtopology.topologyテーブルで定義されているトポロジへの参照です。

note: Tag: para
en: <varname>layer_id</varname> is an integer: The layer_id in the layers table that the TopoGeometry belongs to. The combination of topology_id, layer_id provides a unique reference in the topology.layers table.
ja: <varname>layer_id</varname> (整数): TopoGeometryが属するlayersテーブルにおけるlayer_idです。topology_idとlayer_idとの組み合わせで、topology.layersテーブルを一意に参照できます。

note: Tag: para
en: <varname>id</varname> is an integer: The id is the autogenerated sequence number that uniquely defines the topogeometry in the respective topology layer.
ja: <varname>id</varname> (整数): それぞれのトポロジでTopoGeometryを一意にするための順序整数で、自動生成されます。

note: Tag: para
en: <varname>type</varname> integer between 1 - 4 that defines the geometry type: 1:[multi]point, 2:[multi]line, 3:[multi]poly, 4:collection
ja: <varname>type</varname> (1から4の整数でジオメトリタイプを定義): 1:[multi]point, 2:[multi]line, 3:[multi]poly, 4:collectionとなります。

note: Tag: title
en: Casting Behavior
ja: キャストの挙動

note: Tag: para
en: This section lists the automatic as well as explicit casts allowed for this data type
ja: 本節では、このデータ型で許容される明示的なキャストと自動キャストの一覧を挙げます。

note: Tag: entry
en: Cast To
ja: キャスト先

note: Tag: entry
en: Behavior
ja: ふるまい

note: Tag: entry
en: automatic
ja: 自動

note: Tag: refpurpose
en: A composite type that consists of an error message and id1 and id2 to denote location of error. This is the return type for <varname>ValidateTopology</varname>.
ja: エラーメッセージとエラーの場所を示すid1とid2からなる複合型です。これは<varname>ValidateTopology</varname>が返す型です。

note: Tag: para
en: A composite type that consists of an error message and two integers. The <xref linkend="ValidateTopology"/> function returns a set of these to denote validation errors and the id1 and id2 to denote the ids of the topology objects involved in the error.
ja: エラーメッセージと二つの整数からなる複合型です。<xref linkend="ValidateTopology"/>関数は、これの集合を返します。評価エラーを示し、id1とid2でエラーを含むトポロジオブジェクトの識別番号を示します。

note: Tag: para
en: <varname>error</varname> is varchar: Denotes type of error.
ja: <varname>error</varname> (varchar): エラーのタイプを示します。

note: Tag: para
en: Current error descriptors are: coincident nodes, edge crosses node, edge not simple, edge end node geometry mismatch, edge start node geometry mismatch, face overlaps face,face within face,
ja: 現在のエラー記述: coincident nodes (訳注: ノード重複), edge crosses node (訳注: エッジとノードのクロス), edge not simple (訳注: 単純でないエッジ), edge end node geometry mismatch (訳注: 終了ノードジオメトリの不整合), edge start node geometry mismatch (訳注: 開始ノードジオメトリの不整合), face overlaps face (訳注: フェイス同士のオーバラップ), face within face (訳注: フェイス間の包含)

note: Tag: para
en: <varname>id1</varname> is an integer: Denotes identifier of edge / face / nodes in error.
ja: <varname>id1</varname> (整数): エラーを持つエッジ/フェイス/ノードの識別番号を示します。

note: Tag: para
en: <varname>id2</varname> is an integer: For errors that involve 2 objects denotes the secondary edge / or node
ja: <varname>id2</varname> (整数): 2オブジェクトでのエラーにおける二つ目のエッジ/ノードの識別番号を示します。

note: Tag: title
en: Topology Domains
ja: トポロジドメイン

note: Tag: para
en: This section lists the PostgreSQL domains installed by PostGIS Topology. Domains can be used like object types as return objects of functions or table columns. The distinction between a domain and a type is that a domain is an existing type with a check constraint bound to it.
ja: 本節では、PostGISトポロジでインストールされるPostgreSQLドメインの一覧を挙げます。ドメインは、オブジェクト型のように扱え、関数やテーブルカラムのオブジェクトを返します。ドメインは存在するチェック制約を持つ既存の型である点で、型とは違います。

note: Tag: refpurpose
en: An array of 2 integers generally used to identify a TopoGeometry component.
ja: 二つの整数の配列で、通常TopoGeometry要素を識別するために使われます。

note: Tag: para
en: An array of 2 integers used to represent one component of a simple or hierarchical <xref linkend="topogeometry"/>.
ja: 二つの整数の配列で、単純または階層を持つ<xref linkend="topogeometry"/>の一つのコンポーネントを表現するために使われます。

note: Tag: para
en: In the case of a simple TopoGeometry the first element of the array represents the identifier of a topological primitive and the second element represents its type (1:node, 2:edge, 3:face). In the case of a hierarchical TopoGeometry the first element of the array represents the identifier of a child TopoGeometry and the second element represents its layer identifier.
ja: 単純なTopoGeometryの場合は、配列の最初の要素がトポロジのプリミティブの識別を表現し、二つ目の要素がタイプ (1:ノード 2:エッジ, 3:フェイス)を表現します。階層的なTopoGeometryの場合は、一つ目の要素が子のTopoGeometryの識別子を表現し、二つ目の要素はレイヤ識別子を表現します。

note: Tag: para
en: For any given hierarchical TopoGeometry all child TopoGeometry elements will come from the same child layer, as specified in the topology.layer record for the layer of the TopoGeometry being defined.
ja: 階層的なTopoGeometryについては、全ての子のTopoGeometry要素は同じ子レイヤから来ます。子レイヤは、定義されたTopoGeometryのレイヤのtopology.layerレコード内で指定されます。

note: Tag: refpurpose
en: An array of TopoElement objects.
ja: TopoElementオブジェクトの配列。

note: Tag: para
en: An array of 1 or more TopoElement objects, generally used to pass around components of TopoGeometry objects.
ja: 1以上のTopoElementオブジェクトの配列で、通常はTopoGeometryオブジェクトのコンポーネントを分配するために使われます。

note: Tag: title
en: Topology and TopoGeometry Management
ja: トポロジ管理とTopoGeometry管理

note: Tag: para
en: This section lists the Topology functions for building new Topology schemas, validating topologies, and managing TopoGeometry Columns
ja: 本節では、新しいトポロジスキーマの構築、トポロジの評価、TopoGeometryカラムの管理のためのトポロジ関数の一覧を挙げます。

note: Tag: refpurpose
en: Adds a topogeometry column to an existing table, registers this new column as a layer in topology.layer and returns the new layer_id.
ja: 既存のテーブルにTopoGeometryカラムを追加し、topology.layer内に新しいレイヤとして新しいカラムを登録して、新しい layer_id を返します。

note: Tag: para
en: Each TopoGeometry object belongs to a specific Layer of a specific Topology. Before creating a TopoGeometry object you need to create its TopologyLayer. A Topology Layer is an association of a feature-table with the topology. It also contain type and hierarchy information. We create a layer using the AddTopoGeometryColumn() function:
ja: それぞれのTopoGeometryオブジェクトは、特定のトポロジの特定のレイヤに属します。TopoGeometryオブジェクト生成の前に、トポロジレイヤの生成が必要です。トポロジレイヤは地物テーブルとトポロジとで組織されます。また、タイプと階層の情報を持ちます。レイヤの生成にはAddTopoGeometryColumn()を使います。

note: Tag: para
en: This function will both add the requested column to the table and add a record to the topology.layer table with all the given info.
ja: この関数は、リクエストされたカラムをテーブルに追加し、topology.layerテーブルに、与えられた全ての情報のレコードを追加します。

note: Tag: para
en: If you don't specify [child_layer] (or set it to NULL) this layer would contain Basic TopoGeometries (composed by primitive topology elements). Otherwise this layer will contain hierarchical TopoGeometries (composed by TopoGeometries from the child_layer).
ja: [child_layer]を指定しない (またはNULLを指定する)場合、このレイヤは、基本的なTopoGeometry (プリミティブなトポロジ要素で構成)を含みます。指定する場合、このレイヤは階層的なTopoGeometry (child_layerからのTopoGeometryで構成)を持ちます。

note: Tag: para
en: Once the layer is created (its id is returned by the AddTopoGeometryColumn function) you're ready to construct TopoGeometry objects in it
ja: レイヤが生成される (これの識別番号は、AddTopoGeometryColumn関数が返します)と、TopoGeometryオブジェクトをこの中に構築する準備ができます。

note: Tag: para
en: Valid <varname>feature_type</varname>s are: POINT, MULTIPOINT, LINE, MULTILINE, POLYGON, MULTIPOLYGON, COLLECTION
ja: 妥当な<varname>feature_type</varname>: POINT, MULTIPOINT, LINE, MULTILINE, POLYGON, MULTIPOLYGON, COLLECTION

note: Tag: refpurpose
en: Renames a topogeometry column
ja: TopoGeometryカラムの名前を変更します

note: Tag: para
en: This function changes the name of an existing TopoGeometry column ensuring metadata information about it is updated accordingly.
ja: この関数は存在するTopoGeometryカラムの名前を変更します。この際、メタデータ情報が適切に更新されるようにします。

note: Tag: refpurpose
en: Use with caution: Drops a topology schema and deletes its reference from topology.topology table and references to tables in that schema from the geometry_columns table.
ja: 使用上の注意: この関数によって、トポロジスキーマが削除され、topology.topologyテーブルからの参照が削除され、geometry_columnsテーブルから削除対象スキーマ内のテーブルへの参照が削除されます。

note: Tag: para
en: Drops a topology schema and deletes its reference from topology.topology table and references to tables in that schema from the geometry_columns table. This function should be USED WITH CAUTION, as it could destroy data you care about. If the schema does not exist, it just removes reference entries the named schema.
ja: トポロジスキーマを削除し、topology.topologyテーブルからの参照を削除し、geometry_columnsテーブルから削除対象スキーマ内のテーブルへの参照を削除します。この関数は *十分に注意してご使用下さい*。残しておきたかったデータが破壊される可能性があります。スキーマが存在しない場合、スキーマへの参照に関するエントリの削除だけを行います。

note: Tag: para
en: Cascade drops the ma_topo schema and removes all references to it in topology.topology and geometry_columns.
ja: ma_topoスキーマをカスケード削除し、topology.topologyにある参照のうち関係するものを全て削除します。

note: Tag: refpurpose
en: Renames a topology
ja: トポロジ名を変更します

note: Tag: para
en: Renames a topology schema, updating its metadata record in the <varname>topology.topology</varname> table.
ja: トポロジスキーマの名前を変更し、<varname>topology.topology</varname>テーブルに格納されているメタデータを更新します。

note: Tag: para
en: Rename a topology from <varname>topo_stage</varname> to <varname>topo_prod</varname>.
ja: <varname>topo_stage</varname>から<varname>topo_prod</varname>にトポロジ名を変更します。

note: Tag: refpurpose
en: Drops the topogeometry column from the table named <varname>table_name</varname> in schema <varname>schema_name</varname> and unregisters the columns from topology.layer table.
ja: <varname>schema_name</varname>で指定されたスキーマ内にある<varname>table_name</varname>で指定されたテーブルからTopoGeometryカラムを削除し、topology.layerテーブルにある登録を解除します。

note: Tag: para
en: Drops the topogeometry column from the table named <varname>table_name</varname> in schema <varname>schema_name</varname> and unregisters the columns from topology.layer table. Returns summary of drop status. NOTE: it first sets all values to NULL before dropping to bypass referential integrity checks.
ja: <varname>schema_name</varname>で指定されたスキーマ内にある<varname>table_name</varname>で指定されたテーブルからTopoGeometryカラムを削除し、topology.layerテーブルにある登録を解除します。削除の概要報告を返します。ご注意: この関数は、参照整合性チェックをすり抜けるために、まずNULL値に上書きしてから削除します。

note: Tag: refpurpose
en: Adds missing entries to topology.layer table by reading metadata from topo tables.
ja: テーブルからメタデータを読み、topology.layerテーブルに不足しているものを追加します。

note: Tag: para
en: Adds missing entries to the <varname>topology.layer</varname> table by inspecting topology constraints on tables. This function is useful for fixing up entries in topology catalog after restores of schemas with topo data.
ja: テーブルの制約を読み、<varname>topology.layer</varname>テーブルに不足しているものを追加します。トポロジデータをスキーマに格納した後に、トポロジカタログで抜けているものを訂正するのに使います。

note: Tag: para
en: It returns the list of entries created. Returned columns are <varname>schema_name</varname>, <varname>table_name</varname>, <varname>feature_column</varname>.
ja: 生成されたもののリストを返します。返されるカラムは <varname>schema_name</varname>, <varname>table_name</varname>, <varname>feature_column</varname>です。

note: Tag: refpurpose
en: <refpurpose>Takes a topology name and provides summary totals of types of objects in topology.</refpurpose>
ja: <refpurpose>トポロジ名を取り、トポロジ内のオブジェクトの型に関する概要の全体を提供します。</refpurpose>

note: Tag: para
en: <para>Takes a topology name and provides summary totals of types of objects in topology.</para>
ja: <para>トポロジ名を取り、トポロジ内のオブジェクトの型に関する概要の全体を提供します。</para>

note: Tag: refpurpose
en: Returns a set of validatetopology_returntype objects detailing issues with topology.
ja: トポロジの問題についての詳細を示すvalidatetopology_returntypeの集合を返します。

note: Tag: para
en: Returns a set of <xref linkend="validatetopology_returntype"/> objects detailing issues with topology, optionally limiting the check to the area specified by the <varname>bbox</varname> parameter.
ja: トポロジの問題の詳細説明に関する<xref linkend="validatetopology_returntype"/>オブジェクトを返します。任意に<varname>bbox</varname>パラメータで指定された範囲に確認を制限します。

note: Tag: para
en: List of possible errors, what they mean and what the returned ids represent are displayed below:
ja: エラーの一覧を示します。可能性のある、意味することろ、返されるid表現は次の通りです:

note: Tag: entry
en: Meaning
ja: 意味

note: Tag: entry
en: coincident nodes
ja: coincident nodes (訳注: 重複ノード)

note: Tag: entry
en: Identifier of first node.
ja: 最初のノードの識別子。

note: Tag: entry
en: Identifier of second node.
ja: 2番目のノードの識別子。

note: Tag: entry
en: Two nodes have the same geometry.
ja: 二つのノードは同じジオメトリを持ちます。

note: Tag: entry
en: edge crosses node
ja: edge crosses node (訳注: エッジとノードのクロス)

note: Tag: entry
en: Identifier of the edge.
ja: エッジの識別子。

note: Tag: entry
en: Identifier of the node.
ja: ノードの識別子。

note: Tag: entry
en: An edge has a node in its interior. See <xref linkend="ST_Relate"/>.
ja: エッジが内部にノードを持っています。<xref linkend="ST_Relate"/>を参照して下さい。

note: Tag: entry
en: invalid edge
ja: invalid edge (訳注: 不正なエッジ)

note: Tag: entry
en: An edge geometry is invalid. See <xref linkend="ST_IsValid"/>.
ja: エッジジオメトリが不正です。<xref linkend="ST_IsValid"/>をご覧下さい。

note: Tag: entry
en: edge not simple
ja: edge not simple (訳注: 単純でないエッジ)

note: Tag: entry
en: An edge geometry has self-intersections. See <xref linkend="ST_IsSimple"/>.
ja: エッジジオメトリが自己交差しています。<xref linkend="ST_IsSimple"/>を参照して下さい。

note: Tag: entry
en: edge crosses edge
ja: edge crosses edge (訳注: エッジとエッジのクロス)

note: Tag: entry
en: Identifier of first edge.
ja: 最初のエッジの識別子。

note: Tag: entry
en: Identifier of second edge.
ja: 2番目のエッジの識別子。

note: Tag: entry
en: Two edges have an interior intersection. See <xref linkend="ST_Relate"/>.
ja: 二つのエッジが内部でインタセクトしています。<xref linkend="ST_Relate"/>をご覧下さい。

note: Tag: entry
en: edge start node geometry mismatch
ja: edge start node geometry mismatch (訳注: 開始ノードジオメトリの不整合)

note: Tag: entry
en: Identifier of the indicated start node.
ja: 示された開始ノードの識別子。

note: Tag: entry
en: The geometry of the node indicated as the starting node for an edge does not match the first point of the edge geometry. See <xref linkend="ST_StartPoint"/>.
ja: エッジの開始ノードとして示されたノードのジオメトリが、エッジジオメトリの最初のポイントと合致しません。<xref linkend="ST_StartPoint"/>を参照して下さい。

note: Tag: entry
en: edge end node geometry mismatch
ja: edge end node geometry mismatch (訳注: 終了ノードジオメトリの不整合)

note: Tag: entry
en: Identifier of the indicated end node.
ja: 示された終了ノードの識別子。

note: Tag: entry
en: The geometry of the node indicated as the ending node for an edge does not match the last point of the edge geometry. See <xref linkend="ST_EndPoint"/>.
ja: エッジの終了ノードとして示されたノードのジオメトリがエッジジオメトリの最後のポイントと合致しません。<xref linkend="ST_EndPoint"/>を参照して下さい。

note: Tag: entry
en: face without edges
ja: face without edges (訳注: エッジのないフェイス)

note: Tag: entry
en: Identifier of the orphaned face.
ja: 取り残されたフェイスの識別子。

note: Tag: entry
en: No edge reports an existing face on either of its sides (left_face, right_face).
ja: 既存のフェイスを左右いずれかの側に (left_face, right_faceとして)持つエッジが存在しません。

note: Tag: entry
en: face has no rings
ja: face has no rings (訳注: 環のないフェイス)

note: Tag: entry
en: Identifier of the partially-defined face.
ja: 部分的に定義されたフェイスの識別子。

note: Tag: entry
en: Edges reporting a face on their sides do not form a ring.
ja: 環を形成しない側のフェイスを示すエッジ。

note: Tag: entry
en: face has wrong mbr
ja: face has wrong mbr (訳注: 誤ったバウンディングボックスを持ったフェイス)

note: Tag: entry
en: Identifier of the face with wrong mbr cache.
ja: 不正なMBRキャッシュを持つフェイスの識別子。

note: Tag: entry
en: Minimum bounding rectangle of a face does not match minimum bounding box of the collection of edges reporting the face on their sides.
ja: フェイスの最小バウンディング四角形が、サイド上のフェイスを示すエッジのコレクションの最小バウンディングボックスと合致しません。

note: Tag: entry
en: hole not in advertised face
ja: hole not in advertised face (訳注: 穴がフェイス内に存在しない)

note: Tag: entry
en: Signed identifier of an edge, identifying the ring. See <xref linkend="GetRingEdges"/>.
ja: リングを識別する符号付きのエッジ識別子。<xref linkend="GetRingEdges"/>を参照して下さい。

note: Tag: entry
en: A ring of edges reporting a face on its exterior is contained in different face.
ja: エッジの環が、外環のフェイスが異なるフェイスに含まれているフェイスを示します。

note: Tag: entry
en: not-isolated node has not- containing_face
ja: not-isolated node has not- containing_face (訳注: 非孤立ノードが非孤立フェイスを持っています)

note: Tag: entry
en: Identifier of the ill-defined node.
ja: はっきりしないノードの識別子。

note: Tag: entry
en: A node which is reported as being on the boundary of one or more edges is indicating a containing face.
ja: 一つ以上のエッジの境界上にあると示された一つのノードが、そのノードを含んでいるフェイスを示しています。

note: Tag: entry
en: isolated node has containing_face
ja: isolated node has containing_face (訳注: 孤立ノードがcontaining_faceを持っています)

note: Tag: entry
en: A node which is not reported as being on the boundary of any edges is lacking the indication of a containing face.
ja: どのエッジの境界上にもないと報告されるノードが、それを含むフェイスが無いことを示しています。

note: Tag: entry
en: isolated node has wrong containing_face
ja: isolated node has wrong containing_face (訳注: この孤立ノードを含んでいるフェイスが不正)

note: Tag: entry
en: Identifier of the misrepresented node.
ja: 不正確なノードの識別子。

note: Tag: entry
en: A node which is not reported as being on the boundary of any edges indicates a containing face which is not the actual face containing it. See <xref linkend="GetFaceContainingPoint"/>.
ja: どのエッジの境界上にもないと報告されるノードが、そのノードを実際に含むフェイスではないフェイスに含まれていることを示しています。<xref linkend="GetFaceContainingPoint"/>を参照して下さい。

note: Tag: entry
en: invalid next_right_edge
ja: invalid next_right_edge (訳注: 不正なnext_right_edge)

note: Tag: entry
en: Identifier of the misrepresented edge.
ja: 不正確なエッジの識別子。

note: Tag: entry
en: Signed id of the edge which should be indicated as the next right edge.
ja: 符号付き識別子で次の右エッジを示します。

note: Tag: entry
en: The edge indicated as the next edge encountered walking on the right side of an edge is wrong.
ja: エッジの右側を進んで遭遇する次のエッジが間違っていることを示しています。

note: Tag: entry
en: invalid next_left_edge
ja: invalid next_left_edge (訳注: 不正なnext_left_edge)

note: Tag: entry
en: Signed id of the edge which should be indicated as the next left edge.
ja: 符号付き識別子で次の左エッジを示します。

note: Tag: entry
en: The edge indicated as the next edge encountered walking on the left side of an edge is wrong.
ja: エッジの左側を進んで遭遇する次のエッジが間違っていることを示しています。

note: Tag: entry
en: mixed face labeling in ring
ja: mixed face labeling in ring (訳注: リング内のフェイスのラベルの矛盾)

note: Tag: entry
en: Edges in a ring indicate conflicting faces on the walking side. This is also known as a "Side Location Conflict".
ja: リング内のエッジが、進む側にあるフェイスが矛盾していることを示しています。これは「サイドロケーションの矛盾」とも言われます。

note: Tag: entry
en: non-closed ring
ja: non-closed ring (訳注: 閉じていないリング)

note: Tag: entry
en: A ring of edges formed by following next_left_edge/next_right_edge attributes starts and ends on different nodes.
ja: 続くnext_left_edge/next_right_edge属性で形成されるエッジのリングの始点と終点が異なります。

note: Tag: entry
en: face has multiple shells
ja: face has multiple shells (訳注: 複数の外殻を持つフェイス)

note: Tag: entry
en: Identifier of the contended face.
ja: 競合するフェイスの識別子。

note: Tag: entry
en: More than a one ring of edges indicate the same face on its interior.
ja: 複数のエッジのリングがその内部で同じフェイスを示しています。

note: Tag: para
en: Enhanced: 2.0.0 more efficient edge crossing detection and fixes for false positives that were existent in prior versions.
ja: Enhanced: 2.0.0では、より効果的なエッジ交差検出が可能になり、以前の版で残っていた偽陽性を解決しています。

note: Tag: para
en: Changed: 2.2.0 values for id1 and id2 were swapped for 'edge crosses node' to be consistent with error description.
ja: Changed: 2.2.0 エラーの記述と矛盾しないように'edge crosses node'のid1とid2の値が入れ替わっています。

note: Tag: para
en: Changed: 3.2.0 added optional bbox parameter, perform face labeling and edge linking checks.
ja: Changed: 3.2.0 任意パラメータbboxを追加し、フェイスラベルとエッジリンクのチェックを追加しました。

note: Tag: refpurpose
en: Returns info about invalid topology relation records
ja: 不正なトポロジ関係の行に関する情報を返します。

note: Tag: para
en: Returns a set records giving information about invalidities in the relation table of the topology.
ja: トポロジの関係テーブルの不正点に関する情報を提供するレコードの集合を返します。

note: Tag: refpurpose
en: Returns a topology record by different means.
ja: 異なる方法でトポロジ行を返します。

note: Tag: para
en: Takes a topology identifier or the identifier of a topology-related object and returns a topology.topology record.
ja: トポロジ識別子またはトポロジ関連オブジェクトの識別しを取り、topology.topologyレコードを返します。

note: Tag: refpurpose
en: Returns a topology.layer record by different means.
ja: 様々な方法でtopology.layer行を返します。

note: Tag: para
en: Takes a layer identifier or the identifier of a topology-related object and returns a topology.layer record.
ja: トポロジ識別子またはトポロジ関連オブジェクトの識別子を取り、topology.topologyレコードを返します。

note: Tag: title
en: Topology Statistics Management
ja: トポロジ統計管理

note: Tag: para
en: This section discusses management of database statistics during topology building.
ja: 本節では、トポロジ構築時のデータベース統計の管理について説明します。

note: Tag: para
en: Adding elements to a topology triggers many database queries for finding existing edges that will be split, adding nodes and updating edges that will node with the new linework. For this reason it is useful that statistics about the data in the topology tables are up-to-date.
ja: トポロジに要素を追加すると、そのトリガとして、分割されることになる既存のエッジを探索し、ノードを追加し、新しいラインでノードを作成するエッジを更新するために多数のデータベースクエリが発生します。このため、トポロジテーブル内のデータに関する統計情報が最新の状態になっているなら、統計情報を使うと便利です。

note: Tag: para
en: PostGIS Topology population and editing functions do not automatically update the statistics because a updating stats after each and every change in a topology would be overkill, so it is the caller's duty to take care of that.
ja: PostGISトポロジーの追加や編集の関数は、自動的に統計情報を更新することはありません。トポロジにおいて逐次変更していては、統計情報の更新が過剰になるためです。処理は呼び出し元の義務となっています。

note: Tag: para
en: That the statistics updated by autovacuum will NOT be visible to transactions which started before autovacuum process completed, so long-running transactions will need to run ANALYZE themselves, to use updated statistics.
ja: autovacuumで更新された統計情報は、autovacuumプロセス完了前に始まったトランザクションからは見えないので、更新した統計情報を使うには、実行時間の長いトランザクションではANALYZE自体を実行する必要があります。

note: Tag: title
en: Topology Constructors
ja: トポロジコンストラクタ

note: Tag: para
en: This section covers the topology functions for creating new topologies.
ja: 本節では、新しいトポロジを生成するトポロジ関数を挙げます。

note: Tag: refpurpose
en: Creates a new topology schema and registers it in the topology.topology table.
ja: 新しいトポロジスキーマを生成し、topology.topologyテーブルに登録します。

note: Tag: para
en: Creates a new topology schema with name <varname>topology_name</varname> and registers it in the <varname>topology.topology</varname> table. Topologies must be uniquely named. The topology tables (<varname>edge_data</varname>, <varname>face</varname>, <varname>node</varname>,and <varname>relation</varname> are created in the schema. It returns the id of the topology.
ja: <varname>topology_name</varname>という名前でトポロジスキーマを新たに生成し、<varname>topology.topology</varname>テーブルに登録します。トポロジ名は一意でなければなりません。トポロジテーブル (<varname>edge_data</varname>, <varname>face</varname>, <varname>node</varname>, <varname>relation</varname>)は、このスキーマ内に生成されます。トポロジのIDを返します。

note: Tag: para
en: The <varname>srid</varname> is the <link linkend="spatial_ref_sys">spatial reference system</link> SRID for the topology.
ja: <varname>srid</varname>は、このトポロジの<link linkend="spatial_ref_sys">空間参照系</link>のSRIDです。

note: Tag: para
en: The tolerance <varname>prec</varname> is measured in the units of the spatial reference system. The tolerance defaults to 0.
ja: 許容値<varname>prec</varname>は空間参照系の単位で計測されます。許容値はデフォルトでは0.0です。

note: Tag: para
en: <varname>hasz</varname> defaults to false if not specified.
ja: <varname>hasz</varname>を指定しない場合のデフォルトはFALSEです。

note: Tag: para
en: This is similar to the SQL/MM <xref linkend="ST_InitTopoGeo"/> but has more functionality.
ja: これはSQL/MMの<xref linkend="ST_InitTopoGeo"/>に似ていますが、より高機能です。

note: Tag: para
en: Enhanced: 2.0 added the signature accepting hasZ
ja: Enhanched: 2.0 hasZを受け付ける形式の追加

note: Tag: para
en: Create a topology schema called <varname>ma_topo</varname> that stores edges and nodes in Massachusetts State Plane-meters (SRID = 26986). The tolerance represents 0.5 meters since the spatial reference system is meter-based.
ja: <varname>ma_topo</varname>という名前のトポロジスキーマを生成します。これはマサチューセッツ州メートル平面 (SRID 26986)でエッジとノードを保存することとします。空間参照系の単位がメートルなので、許容値は0.5メートルとなります。

note: Tag: para
en: Create a topology for Rhode Island called <varname>ri_topo</varname> in spatial reference system State Plane-feet (SRID = 3438)
ja: <varname>ri_topo</varname>という名前の、空間参照系をフィート平面 (SRID = 3438)としたロードアイランドのトポロジの生成

note: Tag: refpurpose
en: Makes a copy of a topology (nodes, edges, faces, layers and TopoGeometries) into a new schema
ja: トポロジ (ノード、エッジ、フェイス、レイヤとTopoGeometry)の新しいスキーマに複写します。

note: Tag: para
en: Creates a new topology with name <varname>new_name</varname>, with SRID and precision copied from <varname>existing_topology_name</varname> The nodes, edges and faces in <varname>existing_topology_name</varname> are copied into the new topology, as well as Layers and their associated TopoGeometries.
ja: <varname>new_name</varname>という名前のトポロジを作成しますが、SRIDと精度は<varname>existing_topology_name</varname>から複写します。<varname>existing_topology_name</varname>のノード、エッジ、フェイスと、レイヤとそれに関連付けられたTopoGeometryは、新しいトポロジに複写されます。

note: Tag: para
en: The new rows in the <varname>topology.layer</varname> table contain synthetic values for schema_name, table_name and feature_column. This is because the TopoGeometry objects exist only as a definition and are not yet available in a user-defined table.
ja: <varname>topology.layer</varname>テーブルの新しい行にはschema_name, table_name, feature_columnの値の合成値が含まれます。TopoGeometryオブジェクトは定義だけが存在するのであって、ユーザ定義テーブルで使用できる状態にないからです。

note: Tag: para
en: Make a backup of a topology called <varname>ma_topo</varname>.
ja: <varname>ma_topo</varname>という名前のトポロジのバックアップを作成します。

note: Tag: para
en: This is the SQL-MM equivalent of <xref linkend="CreateTopology"/>. It lacks options for spatial reference system and tolerance. it returns a text description of the topology creation, instead of the topology id.
ja: <xref linkend="CreateTopology"/>のSQL/MM相当の関数です。空間参照系と許容値の任意引数がありません。トポロジIDでなくトポロジ生成の文字列による説明が返されます。

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.17
ja: &sqlmm_compliant; SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.17

note: Tag: refpurpose
en: <refpurpose>Adds a collection of geometries to a given empty topology and returns a message detailing success.</refpurpose>
ja: <refpurpose>空のトポロジにジオメトリのコレクションを追加し、成否を示すメッセージを返します。 </refpurpose>

note: Tag: para
en: <para>Adds a collection of geometries to a given empty topology and returns a message detailing success.</para>
ja: <para>空のトポロジにジオメトリのコレクションを追加し、成否を示すメッセージを返します。 </para>

note: Tag: para
en: Useful for populating an empty topology.
ja: 空トポロジの追加に使えます。

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details -- X.3.18
ja: &sqlmm_compliant; SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.18

note: Tag: refpurpose
en: Adds a point to an existing topology using a tolerance and possibly splitting an existing edge.
ja: 許容差を使って既存のトポロジにポイントを追加し、可能ならエッジを分割します。

note: Tag: para
en: Adds a point to an existing topology and returns its identifier. The given point will snap to existing nodes or edges within given tolerance. An existing edge may be split by the snapped point.
ja: 既存のトポロジにポイントを追加し、その識別番号を返します。指定されたポイントは、許容差の範囲内で既存のノードまたはエッジにスナップします。既存のエッジはスナップされたポイントで分割されることがあります。

note: Tag: refpurpose
en: Adds a linestring to an existing topology using a tolerance and possibly splitting existing edges/faces.
ja: 許容差を使って既存のトポロジにラインストリングを追加し、可能ならエッジ/フェイスを分割します。

note: Tag: para
en: Adds a linestring to an existing topology and returns a set of signed edge identifiers forming it up (negative identifies mean the edge goes in the opposite direction of the input linestring). The given line will snap to existing nodes or edges within given tolerance. Existing edges and faces may be split by the line. New nodes and faces may be added.
ja: 許容差を使って既存のトポロジにラインストリングを追加し、それを形成する符号付きエッジ識別子 (負符号は入力ラインストリングの逆方向に進む場合に付きます)の集合を返します。与えられたリンは既存のノードまたはエッジに指定した許容値内でスナップします。既存のエッジやフェイスはラインで分割される可能性があります。新しいノードとフェイスが追加される可能性があります。

note: Tag: para
en: Updating statistics about topologies being loaded via this function is up to caller, see <xref linkend="Topology_StatsManagement"/>.
ja: この関数を介してロードされたトポロジの統計情報の更新は呼び出し元次第です。<xref linkend="Topology_StatsManagement"/>をご覧下さい。

note: Tag: para
en: Enhanced: 3.2.0 added support for returning signed identifier.
ja: Enhanced: 3.2.0 符号付き識別子を返す機能が追加されました。

note: Tag: refpurpose
en: Adds a polygon to an existing topology using a tolerance and possibly splitting existing edges/faces. Returns face identifiers.
ja: 許容差を使って既存のトポロジにラインストリングを追加し、可能ならエッジ/フェイスを分割します。エッジ識別番号を返します。

note: Tag: para
en: Adds a polygon to an existing topology and returns a set of face identifiers forming it up. The boundary of the given polygon will snap to existing nodes or edges within given tolerance. Existing edges and faces may be split by the boundary of the new polygon.
ja: 既存のトポロジにポリゴンを追加し、これを構成するフェイスの識別番号の集合を返します。指定されたポリゴンの境界線は、許容差の範囲内で既存のノードまたはエッジにスナップします。既存のエッジとフェイスはポリゴンの境界線で分割されることがあります。

note: Tag: refpurpose
en: Load a geometry into an existing topology, snapping and splitting as needed.
ja: ジオメトリを既存のトポロジにロードし、必要に応じてスナップと分割を実行します。

note: Tag: para
en: Loads a geometry into an existing topology. The given geometry will snap to existing nodes or edges within given tolerance. Existing edges and faces may be split as a consequence of the load.
ja: ジオメトリを既存のトポロジにロードします。与えられたジオメトリは、与えられた許容値の範囲内で、既存のノードまたはエッジにスナップします。既存のエッジとフェイスはロードの結果分割される場合があります。

note: Tag: title
en: Topology Editors
ja: トポロジエディタ

note: Tag: para
en: This section covers topology functions for adding, moving, deleting, and splitting edges, faces, and nodes. All of these functions are defined by ISO SQL/MM.
ja: 本節では、エッジ、フェイス、ノードの追加、移動、削除、分割に関する関数を挙げます。本節の関数はすべてISO SQL/MMで定義されています。

note: Tag: refpurpose
en: Adds an isolated node to a face in a topology and returns the nodeid of the new node. If face is null, the node is still created.
ja: フェイスに孤立ノードを追加し、新しいノードの識別番号を返します。フェイスがNULLの場合でもノードは生成されます。

note: Tag: para
en: Adds an isolated node with point location <varname>apoint</varname> to an existing face with faceid <varname>aface</varname> to a topology <varname>atopology</varname> and returns the nodeid of the new node.
ja: <varname>atopology</varname>で指定されたトポロジの<varname>aface</varname>の識別番号で示された既存のフェイスに対して、<varname>apoint</varname>で示された位置に孤立ノードを追加します。

note: Tag: para
en: If the spatial reference system (srid) of the point geometry is not the same as the topology, the <varname>apoint</varname> is not a point geometry, the point is null, or the point intersects an existing edge (even at the boundaries) then an exception is thrown. If the point already exists as a node, an exception is thrown.
ja: ポイントジオメトリの空間参照系 (SRID)がトポロジと同じでない場合、<varname>apoint</varname>がポイントジオメトリでない場合、ポイントがNULLである場合、または、ポイントが既存のエッジ (境界も含む)とインタセクトする場合には、例外が投げられます。また、ポイントが既にノードとして存在する場合、例外が投げられます。

note: Tag: para
en: If <varname>aface</varname> is not null and the <varname>apoint</varname> is not within the face, then an exception is thrown.
ja: <varname>aface</varname>がNULLでなく、かつ<varname>apoint</varname>がフェイス内に無い場合には、例外が投げられます。

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Net Routines: X+1.3.1
ja: &sqlmm_compliant; SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X 3.1

note: Tag: refpurpose
en: <refpurpose>Adds an isolated edge defined by geometry <varname>alinestring</varname> to a topology connecting two existing isolated nodes <varname>anode</varname> and <varname>anothernode</varname> and returns the edge id of the new edge.</refpurpose>
ja: <refpurpose><varname>anode</varname>と<varname>anothernode</varname>で指定される二つの既存孤立ノードを接続するトポロジに、ジオメトリ<varname>alinestring</varname>で定義される孤立エッジを追加し、新しいエッジの識別番号を返します。</refpurpose>

note: Tag: para
en: <para>Adds an isolated edge defined by geometry <varname>alinestring</varname> to a topology connecting two existing isolated nodes <varname>anode</varname> and <varname>anothernode</varname> and returns the edge id of the new edge.</para>
ja: <para><varname>anode</varname>と<varname>anothernode</varname>で指定される二つの既存孤立ノードを接続するトポロジに、ジオメトリ<varname>alinestring</varname>で定義される孤立エッジを追加し、新しいエッジの識別番号を返します。</para>

note: Tag: para
en: If the spatial reference system (srid) of the <varname>alinestring</varname> geometry is not the same as the topology, any of the input arguments are null, or the nodes are contained in more than one face, or the nodes are start or end nodes of an existing edge, then an exception is thrown.
ja: <varname>alinestring</varname>ジオメトリとトポロジとで空間参照系 (SRID)が異なる場合、引数がNULLである場合、ノードが一つ以上のフェイスに含まれている場合には、二つのノードが既存エッジの始端または終端である場合には、例外が投げられます。

note: Tag: para
en: If the <varname>alinestring</varname> is not within the face of the face the <varname>anode</varname> and <varname>anothernode</varname> belong to, then an exception is thrown.
ja: <varname>alinestring</varname>が<varname>anode</varname>と<varname>anothernode</varname>に属するフェイス内に無い場合には、例外が投げられます。

note: Tag: para
en: If the <varname>anode</varname> and <varname>anothernode</varname> are not the start and end points of the <varname>alinestring</varname> then an exception is thrown.
ja: <varname>anode</varname>と<varname>anothernode</varname>が、<varname>alinestring</varname>の始端と終端でない場合には、例外が投げられます。

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.4
ja: &sqlmm_compliant; SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.4

note: Tag: refpurpose
en: Add a new edge and, if in doing so it splits a face, delete the original face and replace it with two new faces.
ja: 新しいエッジを追加します。新しいエッジがフェイスを分割する場合には、もとのフェイスを削除して、分割した二つのフェイスに置き換えます。

note: Tag: para
en: Add a new edge and, if in doing so it splits a face, delete the original face and replace it with two new faces. Returns the id of the newly added edge.
ja: 新しいエッジを追加します。新しいエッジがフェイスを分割する場合には、もとのフェイスを削除して、分割した二つのフェイスに置き換えます。新しいエッジの識別番号を返します。

note: Tag: para
en: Updates all existing joined edges and relationships accordingly.
ja: この関数によって、既存の接続されているエッジとリレーションシップが更新されます。

note: Tag: para
en: If any arguments are null, the given nodes are unknown (must already exist in the <varname>node</varname> table of the topology schema) , the <varname>acurve</varname> is not a <varname>LINESTRING</varname>, the <varname>anode</varname> and <varname>anothernode</varname> are not the start and endpoints of <varname>acurve</varname> then an error is thrown.
ja: 引数がNULLの場合、与えられたノードが不明な場合(トポロジスキーマの<varname>node</varname>テーブル内に既に存在していなければなりません)、<varname>acurve</varname>が<varname>LINESTRING</varname>でない場合、<varname>anode</varname>と<varname>anothernode</varname>が<varname>acurve</varname>の始端、終端でない場合には、例外が投げられます。

note: Tag: para
en: If the spatial reference system (srid) of the <varname>acurve</varname> geometry is not the same as the topology an exception is thrown.
ja: <varname>acurve</varname>ジオメトリの空間参照系 (SRID) がトポロジと同じでない場合、例外が投げられます。

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.12
ja: &sqlmm_compliant; SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.12

note: Tag: refpurpose
en: Add a new edge and, if in doing so it splits a face, modify the original face and add a new face.
ja: 新しいエッジを追加します。新しいエッジがフェイスを分割する場合には、もとのフェイスを編集し、一つのフェイスを追加します。

note: Tag: para
en: Add a new edge and, if doing so splits a face, modify the original face and add a new one.
ja: 新しいエッジを追加します。新しいエッジがフェイスを分割する場合には、もとのフェイスを編集し、一つのフェイスを追加します。

note: Tag: para
en: If possible, the new face will be created on left side of the new edge. This will not be possible if the face on the left side will need to be the Universe face (unbounded).
ja: 可能なら、新しいフェイスは新しいエッジの左側に作られます。左側のフェイスがユニバースフェイス (境界がない)でなければならない場合には、可能ではありません。

note: Tag: para
en: Returns the id of the newly added edge.
ja: 新しく追加されたエッジの識別番号を返します。

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.13
ja: &sqlmm_compliant; SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.13

note: Tag: refpurpose
en: <refpurpose>Removes an edge and, if the removed edge separated two faces, delete the original faces and replace them with a new face.</refpurpose>
ja: <refpurpose>エッジを削除し、消去対象エッジでフェイスが二つに分割されているなら元の二つのフェイスを削除し、一つの新しいフェイスに置き換えます。</refpurpose>

note: Tag: para
en: <para>Removes an edge and, if the removed edge separated two faces, delete the original faces and replace them with a new face.</para>
ja: <para>エッジを削除し、消去対象エッジでフェイスが二つに分割されているなら元の二つのフェイスを削除し、一つの新しいフェイスに置き換えます。</para>

note: Tag: para
en: Returns the id of a newly created face or NULL, if no new face is created. No new face is created when the removed edge is dangling or isolated or confined with the universe face (possibly making the universe flood into the face on the other side).
ja: 新しく作成されたフェイスの識別番号を返します。新しいフェイスが生成されない場合にはNULLを返します。削除対象エッジがダングルである (訳注: 「ぶらさがる」状態、すなわち一方の端が孤立ノードでなく、かつもう一方が孤立ノード)場合か、孤立している場合か、 ユニバースフェイスとの境界になっている (おそらく反対側のフェイスにユニバースが侵入します)場合には、フェイスは生成されません。

note: Tag: para
en: Refuses to remove an edge participating in the definition of an existing TopoGeometry. Refuses to heal two faces if any TopoGeometry is defined by only one of them (and not the other).
ja: 既存のTopoGeometryの定義に入り込んでいるエッジは削除を拒絶されます。TopoGeometryが二つのフェイスのうちひとつだけで定義されている (かつ他方は定義に使われていない)場合、二つのフェイスの修復は拒絶されます。

note: Tag: para
en: If any arguments are null, the given edge is unknown (must already exist in the <varname>edge</varname> table of the topology schema), the topology name is invalid then an error is thrown.
ja: 引数がNULLである場合、与えられたエッジが不明である場合 (トポロジスキーマの<varname>edge</varname>テーブル内に既に存在していなければなりません)、トポロジ名が不正である場合、例外が投げられます。

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.14
ja: &sqlmm_compliant; SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.14

note: Tag: refpurpose
en: Removes an edge, and if the edge separates two faces deletes one face and modifies the other face to cover the space of both.
ja: エッジを削除します。削除されるエッジが二つのフェイスを分割していたなら、一方のフェイスを削除し、もう一方のフェイスを両方の空間を覆うように編集します。

note: Tag: para
en: Removes an edge, and if the removed edge separates two faces deletes one face and modifies the other face to cover the space of both. Preferentially keeps the face on the right, to be consistent with <xref linkend="ST_AddEdgeModFace"/>. Returns the id of the face which is preserved.
ja: エッジを削除します。削除されるエッジが二つのフェイスを分割していたなら、一方のフェイスを削除し、もう一方のフェイスを両方の空間を覆うように編集します。右側のフェイスを優先的に保持します。これは<xref linkend="ST_AddEdgeModFace"/>と一致します。残ったフェイスのIDを返します。

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.15
ja: &sqlmm_compliant; SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.15

note: Tag: refpurpose
en: <refpurpose>Changes the shape of an edge without affecting the topology structure.</refpurpose>
ja: <refpurpose>トポロジ構造に影響を与えることなくエッジの形状を変更します。</refpurpose>

note: Tag: para
en: <para>Changes the shape of an edge without affecting the topology structure.</para>
ja: <para>トポロジ構造に影響を与えることなくエッジの形状を変更します。</para>

note: Tag: para
en: If any arguments are null, the given edge does not exist in the <varname>edge</varname> table of the topology schema, the <varname>acurve</varname> is not a <varname>LINESTRING</varname>, or the modification would change the underlying topology then an error is thrown.
ja: 全ての引数がNULLであるか、与えられたエッジがtopologyスキーマの<varname>edge</varname>テーブルにないか、<varname>acurve</varname>が<varname>LINESTRING</varname>でないか、変更で基になるトポロジが変わるか、のいずれかの場合には、エラーが投げられます。

note: Tag: para
en: If the new <varname>acurve</varname> is not simple, then an error is thrown.
ja: 新しい<varname>acurve</varname>が単純でない場合には、エラーが投げられます。

note: Tag: para
en: If moving the edge from old to new position would hit an obstacle then an error is thrown.
ja: 古い位置から新しい位置へのエッジ移動で障害物にあたった場合はエラーが投げられます。

note: Tag: para
en: Enhanced: 2.0.0 adds topological consistency enforcement
ja: Enhanced: 2.0.0 トポロジ整合性の強制を追加しました。

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details X.3.6
ja: &sqlmm_compliant; SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.6

note: Tag: refpurpose
en: Split an edge by creating a new node along an existing edge, modifying the original edge and adding a new edge.
ja: 既存のエッジに沿って新しいノードを生成してエッジを分割します。もとのエッジは変更され、新しいエッジが一つ追加されます。

note: Tag: para
en: Split an edge by creating a new node along an existing edge, modifying the original edge and adding a new edge. Updates all existing joined edges and relationships accordingly. Returns the identifier of the newly added node.
ja: 既存のエッジに沿って新しいノードを生成してエッジを分割します。もとのエッジは変更され、新しいエッジが一つ追加されます。この関数によって、既存の接続されているエッジとリレーションシップが更新されます。新しく追加されたノードの識別番号が返ります。

note: Tag: para
en: Changed: 2.0 - In prior versions, this was misnamed ST_ModEdgesSplit
ja: Changed: 2.0 - 以前の版では名前を間違えてST_ModEdgesSplitになっていました。

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.9
ja: &sqlmm_compliant; SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.9

note: Tag: refpurpose
en: Heals two edges by deleting the node connecting them, modifying the first edge and deleting the second edge. Returns the id of the deleted node.
ja: 二つのエッジについて、接続しているノードを削除して修復します。1番目のエッジを編集して、2番目のエッジを削除します。削除されたノードの識別番号を返します。

note: Tag: para
en: Heals two edges by deleting the node connecting them, modifying the first edge and deleting the second edge. Returns the id of the deleted node. Updates all existing joined edges and relationships accordingly.
ja: 二つのエッジについて、接続しているノードを削除して修復します。1番目のエッジを編集して、2番目のエッジを削除します。削除されたノードの識別番号を返します。この関数によって、既存の接続されているエッジとリレーションシップが更新されます。

note: Tag: refpurpose
en: Heals two edges by deleting the node connecting them, deleting both edges, and replacing them with an edge whose direction is the same as the first edge provided.
ja: 二つのエッジについて、接続しているノードを削除して修復します。両方のエッジを削除し、1番目のエッジと同じ方向のエッジに置き換えます。

note: Tag: para
en: Heals two edges by deleting the node connecting them, deleting both edges, and replacing them with an edge whose direction is the same as the first edge provided. Returns the id of the new edge replacing the healed ones. Updates all existing joined edges and relationships accordingly.
ja: 二つのエッジについて、接続しているノードを削除して修復します。両方のエッジを削除し、1番目のエッジと同じ方向のエッジに置き換えます。 修復されたエッジに置き換えられた新しいエッジの識別番号を返します。 この関数によって、既存の接続されているエッジとリレーションシップが更新されます。

note: Tag: refpurpose
en: Moves an isolated node in a topology from one point to another. If new <varname>apoint</varname> geometry exists as a node an error is thrown. Returns description of move.
ja: トポロジ内の孤立ノードを別の位置に移動させます。新しい<varname>apoint</varname>ジオメトリがノードとして存在しているなら、エラーが投げられます。移動に関する説明を返します。

note: Tag: para
en: Moves an isolated node in a topology from one point to another. If new <varname>apoint</varname> geometry exists as a node an error is thrown.
ja: トポロジ内の孤立ノードを別の位置に移動させます。新しい<varname>apoint</varname>ジオメトリがノードとして存在しているなら、エラーが投げられます。

note: Tag: para
en: If any arguments are null, the <varname>apoint</varname> is not a point, the existing node is not isolated (is a start or end point of an existing edge), new node location intersects an existing edge (even at the end points) or the new location is in a different face (since 3.2.0) then an exception is thrown.
ja: 引数がNULLの場合、<varname>apoint</varname>がポイントでない場合、既存のノードが孤立していない (既存のエッジの始端か終端になっている)場合、新しいノード位置が既存のエッジとインタセクトする場合 (終端であっても)、新しい位置が異なるフェイス内にある場合 (3.2.0以降)のいずれかの場合には、例外が投げられます。

note: Tag: para
en: If the spatial reference system (srid) of the point geometry is not the same as the topology an exception is thrown.
ja: ポイントジオメトリの空間参照系 (SRID)がトポロジと異なる場合には、例外が投げられます。

note: Tag: para
en: Enhanced: 3.2.0 ensures the nod cannot be moved in a different face
ja: Enhanced: 3.2.0 ノードが異なるフェイスに移動しないことを保証

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Net Routines: X.3.2
ja: &sqlmm_compliant; SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.2

note: Tag: refpurpose
en: Split an edge by creating a new node along an existing edge, deleting the original edge and replacing it with two new edges. Returns the id of the new node created that joins the new edges.
ja: 新しいノードを既存のエッジに沿って作成して、エッジを分割します。もとのエッジは削除され、二つのエッジに置き換えられます。二つの新しいエッジに接続する新しいノードの識別番号を返します。

note: Tag: para
en: Split an edge with edge id <varname>anedge</varname> by creating a new node with point location <varname>apoint</varname> along current edge, deleting the original edge and replacing it with two new edges. Returns the id of the new node created that joins the new edges. Updates all existing joined edges and relationships accordingly.
ja: <varname>anedge</varname>で指定される既存のエッジに沿った<varname>apoint</varname>の位置に新しいノードを作成して、エッジを分割します。もとのエッジは削除され、二つつのエッジに置き換えられます。二つの新しいエッジに接続する新しいノードの識別番号を返します。この関数によって、既存の接続されているエッジとリレーションシップが更新されます。

note: Tag: para
en: If the spatial reference system (srid) of the point geometry is not the same as the topology, the <varname>apoint</varname> is not a point geometry, the point is null, the point already exists as a node, the edge does not correspond to an existing edge or the point is not within the edge then an exception is thrown.
ja: ポイントジオメトリの空間参照系 (SRID)がトポロジと異なる場合、<varname>apoint</varname>がポイントジオメトリでない場合、ポイントがNULLの場合、ポイントが既にノードとして存在する場合、エッジが既存のエッジと一致しない場合、ポイントがエッジ内にない場合、例外が投げられます。

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Net Routines: X.3.8
ja: &sqlmm_compliant; SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.8

note: Tag: refpurpose
en: <refpurpose>Removes an isolated node and returns description of action. If the node is not isolated (is start or end of an edge), then an exception is thrown.</refpurpose>
ja: <refpurpose>孤立ノードを削除し、実行結果が返されます。ノードが孤立していない (エッジの始端または終端である)場合には、例外が投げられます。</refpurpose>

note: Tag: para
en: <para>Removes an isolated node and returns description of action. If the node is not isolated (is start or end of an edge), then an exception is thrown.</para>
ja: <para>孤立ノードを削除し、実行結果が返されます。ノードが孤立していない (エッジの始端または終端である)場合には、例外が投げられます。</para>

note: Tag: para
en: &sqlmm_compliant; SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X+1.3.3
ja: &sqlmm_compliant; SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.3

note: Tag: refpurpose
en: <refpurpose>Removes an isolated edge and returns description of action. If the edge is not isolated, then an exception is thrown.</refpurpose>
ja: <refpurpose>孤立エッジを削除し、実行結果の記述を返します。エッジが孤立していない場合には、例外が投げられます。</refpurpose>

note: Tag: para
en: <para>Removes an isolated edge and returns description of action. If the edge is not isolated, then an exception is thrown.</para>
ja: <para>孤立エッジを削除し、実行結果の記述を返します。エッジが孤立していない場合には、例外が投げられます。</para>

note: Tag: title
en: Topology Accessors
ja: トポロジアクセサ

note: Tag: refpurpose
en: Finds the edge-id of an edge that intersects a given point.
ja: 与えられたポイントにインタセクトするエッジの識別番号を探索します。

note: Tag: para
en: Retrieves the id of an edge that intersects a Point.
ja: 与えられたポイントにインタセクトするエッジの識別番号を探索します。

note: Tag: para
en: The function returns an integer (id-edge) given a topology, a POINT and a tolerance. If tolerance = 0 then the point has to intersect the edge.
ja: この関数は、トポロジ、ポイント、許容差を引数にして、整数 (エッジの識別番号)を返します。許容差が0の場合、ポイントはエッジとインタセクトしていなければなりません。

note: Tag: para
en: If <varname>apoint</varname> doesn't intersect an edge, returns 0 (zero).
ja: <varname>apoint</varname>がエッジとインタセクトしない場合には、0を返します。

note: Tag: para
en: If use tolerance &gt; 0 and there is more than one edge near the point then an exception is thrown.
ja: 許容差 &gt; 0 として、ポイント付近のエッジが一つより多い場合には、例外が投げられます。

note: Tag: para
en: If tolerance = 0, the function uses ST_Intersects otherwise uses ST_DWithin.
ja: 許容差が0の場合には、ST_Intersectsを使い、それ以外では、ST_DWinthinを使います。

note: Tag: para
en: Performed by the GEOS module.
ja: GEOSモジュールで実現しています。

note: Tag: para
en: These examples use edges we created in <xref linkend="AddEdge"/>
ja: 本例では<xref linkend="AddEdge"/>で作ったエッジを使います。

note: Tag: refpurpose
en: Finds face intersecting a given point.
ja: 与えたポイントとインタセクトするフェイスを見つけます。

note: Tag: para
en: Finds a face referenced by a Point, with given tolerance.
ja: ポイントと与えた許容値で参照されるフェイスを見つけます。

note: Tag: para
en: The function will effectively look for a face intersecting a circle having the point as center and the tolerance as radius.
ja: この関数は、ポイントを中心に持ち半径が許容値となる円とインタセクトするフェイスを効率的に探します。

note: Tag: para
en: If no face intersects the given query location, 0 is returned (universal face).
ja: 与えられたクエリ位置とインタセクトするフェイスが無い場合には、0を返します (ユニバーサルフェイス)。

note: Tag: para
en: If more than one face intersect the query location an exception is thrown.
ja: 1以上のフェイスがクエリ位置とインタセクトする場合には例外が投げられます。

note: Tag: para
en: Enhanced: 3.2.0 more efficient implementation and clearer contract, stops working with invalid topologies.
ja: Enhanced: 3.2.0 より効率的な実装とより明確な短縮、不正なトポロジでの動作停止。

note: Tag: refpurpose
en: Finds the face containing a point.
ja: ポイントを含むフェイスを見つけます。

note: Tag: para
en: Returns the id of the face containing a point.
ja: ポイントを含むフェイスのIDを返します。

note: Tag: para
en: An exception is thrown if the point falls on a face boundary.
ja: ポイントがフェイスの境界に落ちた場合には例外が投げられます。

note: Tag: para
en: The function relies on a valid topology, using edge linking and face labeling.
ja: この関数は妥当なトポロジが前提であり、エッジリンクとフェイスラベルを使用して動作します。

note: Tag: refpurpose
en: Finds the node-id of a node at a point location.
ja: ポイント位置にあるノードの識別番号を探索します。

note: Tag: para
en: Retrieves the id of a node at a point location.
ja: ポイント位置にあるノードの識別番号を探索します。

note: Tag: para
en: The function returns an integer (id-node) given a topology, a POINT and a tolerance. If tolerance = 0 means exact intersection, otherwise retrieves the node from an interval.
ja: トポロジ、POINT、許容値が与えられ、整数 (ノード識別番号)が返ります。tolerance = 0 の場合には、確実にインタセクトするノードを取得し、そうでない場合には、指定した間隔の中からノードを取得します。

note: Tag: para
en: If <varname>apoint</varname> doesn't intersect a node, returns 0 (zero).
ja: <varname>apoint</varname>がノードとインタセクトしない場合には、0を返します。

note: Tag: para
en: If use tolerance &gt; 0 and there is more than one node near the point then an exception is thrown.
ja: 許容差 &gt; 0 として、ポイント付近のノードが一つより多い場合には、例外が投げられます。

note: Tag: refpurpose
en: <refpurpose>Returns the id of a topology in the topology.topology table given the name of the topology.</refpurpose>
ja: <refpurpose>トポロジ名からtopology.topologyテーブル内にあるトポロジの識別番号を返します。</refpurpose>

note: Tag: para
en: <para>Returns the id of a topology in the topology.topology table given the name of the topology.</para>
ja: <para>トポロジ名からtopology.topologyテーブル内にあるトポロジの識別番号を返します。</para>

note: Tag: refpurpose
en: Returns the SRID of a topology in the topology.topology table given the name of the topology.
ja: トポロジ名からtopology.topologyテーブル内にあるトポロジのSRIDを返します。

note: Tag: para
en: Returns the spatial reference id of a topology in the topology.topology table given the name of the topology.
ja: 与えられたトポロジ名からtopology.topologyテーブル内のトポロジの空間参照系識別番号を返します。

note: Tag: refpurpose
en: Returns the name of a topology (schema) given the id of the topology.
ja: 識別番号からトポロジ (スキーマ)の名前を返します。

note: Tag: para
en: Returns the topology name (schema) of a topology from the topology.topology table given the topology id of the topology.
ja: 識別番号からトポロジ (スキーマ)の名前を返します。

note: Tag: refpurpose
en: Returns a set of ordered edges that bound <varname>aface</varname>.
ja: 順序番号を含む、<varname>aface</varname>の境界となる、整列したエッジの集合を返します。

note: Tag: para
en: Returns a set of ordered edges that bound <varname>aface</varname>. Each output consists of a sequence and edgeid. Sequence numbers start with value 1.
ja: 順序番号を含む、<varname>aface</varname>の境界となる、整列したエッジの集合を返します。それぞれの出力は、順序番号とエッジ識別番号からなります。順序番号は1から始まります。

note: Tag: para
en: Enumeration of each ring edges start from the edge with smallest identifier. Order of edges follows a left-hand-rule (bound face is on the left of each directed edge).
ja: 各リングエッジの列挙は、識別番号が最も小さいものから始まります。エッジの順序は左手の法則に従います (境界フェイスは各有向辺の左側にあるようにします)。

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.5
ja: &sqlmm_compliant; SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.5

note: Tag: refpurpose
en: Returns the polygon in the given topology with the specified face id.
ja: 指定されたトポロジの中の、フェイス識別番号で指定されたポリゴンを返します。

note: Tag: para
en: Returns the polygon in the given topology with the specified face id. Builds the polygon from the edges making up the face.
ja: 指定されたトポロジの中の、フェイス識別番号で指定されたポリゴンを返します。フェイスを作るエッジからポリゴンを構築します。

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.16
ja: &sqlmm_compliant; SQL-MM 3 トポロジ-ジオメトリ および トポロジ-ネットワーク 3: ルーチン詳細: X.3.16

note: Tag: refpurpose
en: Returns the ordered set of signed edge identifiers met by walking on an a given edge side.
ja: 与えられた側を歩いて得られた、正負符号付きエッジ識別番号の集合を、順序通りに返します。

note: Tag: para
en: Returns the ordered set of signed edge identifiers met by walking on an a given edge side. Each output consists of a sequence and a signed edge id. Sequence numbers start with value 1.
ja: 与えられた側を歩いて得られた、正負符号付きエッジ識別番号の集合を、順序通りに返します。出力は順序番号と正負符号付きエッジ識別番号からなります。順序番号は1始まりです。

note: Tag: para
en: If you pass a positive edge id, the walk starts on the left side of the corresponding edge and follows the edge direction. If you pass a negative edge id, the walk starts on the right side of it and goes backward.
ja: 正のエッジ識別番号を渡すと、対応するエッジの左側を歩き、エッジを順方向に進みます。負のエッジ識別番号を渡すと、右側を歩き、エッジを逆方向に進みます。

note: Tag: para
en: If <varname>max_edges</varname> is not null no more than those records are returned by that function. This is meant to be a safety parameter when dealing with possibly invalid topologies.
ja: <varname>max_edges</varname>がNULLでな場合には、返されるレコードを超えることはありません。これは、不正なトポロジを扱うときの安全確保のためのパラメータであることを意味します。

note: Tag: para
en: This function uses edge ring linking metadata.
ja: この関数はメタデータとリンクするエッジ環を使います。

note: Tag: refpurpose
en: Returns an ordered set of edges incident to the given node.
ja: 与えられたノードに付随するエッジの集合を整列して返します。

note: Tag: para
en: Returns an ordered set of edges incident to the given node. Each output consists of a sequence and a signed edge id. Sequence numbers start with value 1. A positive edge starts at the given node. A negative edge ends into the given node. Closed edges will appear twice (with both signs). Order is clockwise starting from northbound.
ja: 与えられたノードに付随するエッジの集合を整列して返します。 出力は、連続する、正負符号を持つエッジ識別番号からなります。順序番号は1から始まります。 正のエッジは与えられたノードから始まるものです。 負のエッジは与えられたノードで終わるものです。 閉じたエッジは2回現れます (正と負になります)。 並び順は北側から時計回りになります。

note: Tag: para
en: This function computes ordering rather than deriving from metadata and is thus usable to build edge ring linking.
ja: この関数は、並び順を計算していて、メタデータからのデータを使わないので、 連結しているエッジ環を構築するのに使えます。

note: Tag: title
en: Topology Processing
ja: トポロジ処理

note: Tag: para
en: This section covers the functions for processing topologies in non-standard ways.
ja: 本節では、非標準の手法でのトポロジ処理の関数を挙げます。

note: Tag: refpurpose
en: Finds and registers all faces defined by topology edges.
ja: トポロジエッジで定義される全てのフェイスを探索し、追加します。

note: Tag: para
en: Registers all faces that can be built out a topology edge primitives.
ja: トポロジエッジプリミティブで構築することができる全てのフェイスを登録します。

note: Tag: para
en: The target topology is assumed to contain no self-intersecting edges.
ja: 対象トポロジは自己インタセクトするエッジが無いと仮定しています。

note: Tag: para
en: Already known faces are recognized, so it is safe to call Polygonize multiple times on the same topology.
ja: 既に登録されているフェイスは認識されているので、同じトポロジに対してPolygonizeを複数回呼んでも問題ありません。

note: Tag: para
en: This function does not use nor set the next_left_edge and next_right_edge fields of the edge table.
ja: この関数はエッジテーブルのnext_left_edgeとnext_right_edgeフィールドの読み書きを行いません。

note: Tag: refpurpose
en: Adds a point node to the node table in the specified topology schema and returns the nodeid of new node. If point already exists as node, the existing nodeid is returned.
ja: 指定したトポロジスキーマのノードテーブルにポイントノードを追加し、新しいノードの識別番号を返します。指定したポイントに既にノードがある場合は既存のノード識別番号を返します。

note: Tag: para
en: Adds a point node to the node table in the specified topology schema. The <xref linkend="AddEdge"/> function automatically adds start and end points of an edge when called so not necessary to explicitly add nodes of an edge.
ja: 指定したトポロジスキーマのノードテーブルにポイントノードを追加します。 <xref linkend="AddEdge"/>関数は、呼ばれると自動的にエッジの始端と終端のポイントを追加するので、明示的にエッジのノードを追加する必要はあまりありません。

note: Tag: para
en: If any edge crossing the node is found either an exception is raised or the edge is split, depending on the <varname>allowEdgeSplitting</varname> parameter value.
ja: ノードとクロスするエッジが発見された場合は、例外が発生するか、エッジが分割されます。<varname>allowEdgeSplitting</varname>パラメータの値に依存します。

note: Tag: para
en: If <varname>computeContainingFace</varname> is true a newly added node would get the correct containing face computed.
ja: <varname>computeContainingFace</varname>がtrueの場合には、新しく追加されたノードによって、ノードを含む正しいフェイスが計算されます。

note: Tag: para
en: If the <varname>apoint</varname> geometry already exists as a node, the node is not added but the existing nodeid is returned.
ja: <varname>apoint</varname>ジオメトリが既にノードとして存在する場合、ノードは追加されずに、既存ノードの識別番号を返します。

note: Tag: refpurpose
en: Adds a linestring edge to the edge table and associated start and end points to the point nodes table of the specified topology schema using the specified linestring geometry and returns the edgeid of the new (or existing) edge.
ja: 指定したラインストリングジオメトリを使って、ラインストリングエッジをエッジテーブルに追加し、指定したトポロジスキーマの始点終点をポイントノードテーブルに追加し、新しい (または既存の)エッジの識別番号を返します。

note: Tag: para
en: Adds an edge to the edge table and associated nodes to the nodes table of the specified <varname>toponame</varname> schema using the specified linestring geometry and returns the edgeid of the new or existing record. The newly added edge has "universe" face on both sides and links to itself.
ja: 指定したラインストリングジオメトリを使って、指定した<varname>toponame</varname>スキーマのノードテーブルにノードを追加し、新しいまたは既存のレコードのエッジ識別番号を返します。ラインストリングエッジをエッジテーブルに追加し、指定したトポロジスキーマの始点終点をポイントノードテーブルに追加し、新規または既存のエッジの識別番号を返します。新しく追加されたエッジは両側にユニバースフェイスを持ち、自分自身にリンクしています。

note: Tag: para
en: If the <varname>aline</varname> geometry crosses, overlaps, contains or is contained by an existing linestring edge, then an error is thrown and the edge is not added.
ja: <varname>aline</varname>ジオメトリが既存のエッジとクロスしたり、既存のエッジをオーバラップしたり、既存のエッジを包含したり、既存のエッジに包含されたりする場合には、エラーが投げられ、エッジは追加されません。

note: Tag: para
en: The geometry of <varname>aline</varname> must have the same <varname>srid</varname> as defined for the topology otherwise an invalid spatial reference sys error will be thrown.
ja: <varname>aline</varname>のジオメトリは<varname>srid</varname>がトポロジで指定されたものと同じである必要があり、異なる場合には、不正な空間参照系エラーが投げられます。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="TopoGeo_AddLineString"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="TopoGeo_AddLineString"/>を代わりに使います。

note: Tag: refpurpose
en: <refpurpose>Registers a face primitive to a topology and gets its identifier.</refpurpose>
ja: <refpurpose>フェイスプリミティブをトポロジに登録し、その識別番号を得ます。 </refpurpose>

note: Tag: para
en: <para>Registers a face primitive to a topology and gets its identifier.</para>
ja: <para>フェイスプリミティブをトポロジに登録し、その識別番号を得ます。 </para>

note: Tag: para
en: For a newly added face, the edges forming its boundaries and the ones contained in the face will be updated to have correct values in the left_face and right_face fields. Isolated nodes contained in the face will also be updated to have a correct containing_face field value.
ja: 新しく追加されたフェイスのために、境界を形成するエッジとフェイスに含まれるエッジはleft_faceとright_faceフィールドに正しい値を持つよう更新されます。フェイスに含まれる孤立ノードも正しいcontaining_faceフィールド値を持つよう更新されます。

note: Tag: para
en: The target topology is assumed to be valid (containing no self-intersecting edges). An exception is raised if: The polygon boundary is not fully defined by existing edges or the polygon overlaps an existing face.
ja: 対象トポロジは妥当 (自己インタセクトするエッジが無い)と仮定しています。ポリゴンの境界が既存のエッジでは完全には定義されない場合や、ポリゴンが既存のフェイスにオーバラップする場合には、例外が投げられます。

note: Tag: para
en: If the <varname>apolygon</varname> geometry already exists as a face, then: if <varname>force_new</varname> is false (the default) the face id of the existing face is returned; if <varname>force_new</varname> is true a new id will be assigned to the newly registered face.
ja: <varname>apolygon</varname>ジオメトリがフェイスとして既に存在している場合には、<varname>force_new</varname>がFALSE (デフォルト)なら既存フェイスのフェイスIDを返し、<varname>force_new</varname> がTRUEなら新しいIDが新規登録されたフェイスに割り当てられます。

note: Tag: para
en: When a new registration of an existing face is performed (force_new=true), no action will be taken to resolve dangling references to the existing face in the edge, node an relation tables, nor will the MBR field of the existing face record be updated. It is up to the caller to deal with that.
ja: 既存フェイスの新規登録が実行される時(force_new=true)、そのエッジ内の既存のフェイスへの参照のダングルを解決しません。また、関連テーブルのノードと既存フェイスのレコードのMBR(訳注: 最小境界矩形)フィールドの更新も行いません。これに対応するのは、この関数を呼び出した側です。

note: Tag: para
en: The <varname>apolygon</varname> geometry must have the same <varname>srid</varname> as defined for the topology otherwise an invalid spatial reference sys error will be thrown.
ja: <varname>apolygon</varname>ジオメトリはトポロジと同じ<varname>srid</varname>である必要があり、異なる場合には、不正な空間参照系エラーが投げられます。

note: Tag: refpurpose
en: Returns a "simplified" geometry version of the given TopoGeometry using the Douglas-Peucker algorithm.
ja: 与えたTopoGeometryを「シンプル化した」ジオメトリを返します。ダグラス-ポーカーのアルゴリズムを使います。

note: Tag: para
en: Returns a "simplified" geometry version of the given TopoGeometry using the Douglas-Peucker algorithm on each component edge.
ja: 与えたTopoGeometryを「シンプル化した」ジオメトリを返します。個々の要素エッジに対してダグラス-ポーカーのアルゴリズムを使います。

note: Tag: para
en: The returned geometry may be non-simple or non-valid.
ja: 返されるジオメトリは単純でなかったり不正であったりする場合があります。

note: Tag: para
en: Splitting component edges may help retaining simplicity/validity.
ja: 要素エッジの分割によって単純性/妥当性を維持することがあります。

note: Tag: para
en: Geometry <xref linkend="ST_Simplify"/>, <xref linkend="ST_IsSimple"/>, <xref linkend="ST_IsValid"/>, <xref linkend="ST_ModEdgeSplit"/>
ja: <xref linkend="ST_Simplify"/> (ジオメトリ), <xref linkend="ST_IsSimple"/>, <xref linkend="ST_IsValid"/>, <xref linkend="ST_ModEdgeSplit"/>

note: Tag: refpurpose
en: Removes topology primitives which not needed to define existing TopoGeometry objects.
ja: 存在するTopoGeometryオブジェクトを定義するのに必要でないトポロジプリミティブを削除します。

note: Tag: para
en: Finds all primitives (nodes, edges, faces) that are not strictly needed to represent existing TopoGeometry objects and removes them, maintaining topology validity (edge linking, face labeling) and TopoGeometry space occupation.
ja: 存在するTopoGeometryオブジェクトを表現するのに厳密には必要でない全てのプリミティブ (nodes, edges, faces)を見つけ、これらを削除し、トポロジの妥当性 (エッジのリンク、フェイスのラベル)を維持します。

note: Tag: para
en: No new primitive identifiers are created, but rather existing primitives are expanded to include merged faces (upon removing edges) or healed edges (upon removing nodes).
ja: 新しいプリミティブ識別子が作られませんが、既存のプリミティブはフェイスのマージ (エッジの削除のため)や修復されたエッジ (ノードの削除のため)を含むために拡張されます。

note: Tag: title
en: TopoGeometry Constructors
ja: TopoGeometryコンストラクタ

note: Tag: para
en: This section covers the topology functions for creating new topogeometries.
ja: 本節では、新しいTopoGeometryを生成するトポロジ関数を挙げます。

note: Tag: refpurpose
en: Creates a new topo geometry object from topo element array - tg_type: 1:[multi]point, 2:[multi]line, 3:[multi]poly, 4:collection
ja: 新しいTopoGeometryオブジェクトをtopoエレメント配列から生成します - tg_type: 1:[multi]point, 2:[multi]line, 3:[multi]poly, 4:collection

note: Tag: para
en: Creates a topogeometry object for layer denoted by <varname>layer_id</varname> and registers it in the relations table in the <varname>toponame</varname> schema.
ja: <varname>layer_id</varname>で示されたレイヤでTopoGeometryオブジェクトを生成し、<varname>toponame</varname>スキーマの関連テーブルに登録します。

note: Tag: para
en: <varname>tg_type</varname> is an integer: 1:[multi]point (punctal), 2:[multi]line (lineal), 3:[multi]poly (areal), 4:collection. <varname>layer_id</varname> is the layer id in the topology.layer table.
ja: <varname>tg_type</varname>は次の整数値とします: 1:[multi]point (点), 2:[multi]line (線), 3:[multi]poly (面), 4:collection。<varname>layer_id</varname>は、topology.layerテーブル内のレイヤ識別番号です。

note: Tag: para
en: punctal layers are formed from set of nodes, lineal layers are formed from a set of edges, areal layers are formed from a set of faces, and collections can be formed from a mixture of nodes, edges, and faces.
ja: 点レイヤはノードの集合から形成され、線レイヤはエッジの集合から形成され、面レイヤはフェイスの集合から形成され、コレクションはノード、エッジ、フェイスの混合から形成されます。

note: Tag: para
en: Omitting the array of components generates an empty TopoGeometry object.
ja: 要素の配列を省略した場合、空のTopoGeometryオブジェクトが生成されます。

note: Tag: title
en: Examples: Form from existing edges
ja: 例: 既存エッジからの形成

note: Tag: para
en: Create a topogeom in ri_topo schema for layer 2 (our ri_roads), of type (2) LINE, for the first edge (we loaded in <varname>ST_CreateTopoGeo</varname>).
ja: ri_topoスキーマ内 (<varname>ST_CreateTopoGeo</varname>の例でロードしてあります)で、ラインタイプ (整数値で2)の、layer_idが2のレイヤ (ri_roads)の最初のエッジからTopoGeometryを生成します。

note: Tag: title
en: Examples: Convert an areal geometry to best guess topogeometry
ja: 例: 面ジオメトリから最善と推測されるTopoGeometryへの変換

note: Tag: para
en: Lets say we have geometries that should be formed from a collection of faces. We have for example blockgroups table and want to know the topo geometry of each block group. If our data was perfectly aligned, we could do this:
ja: フェイスのコレクションから形成されるジオメトリがあるとします。blockgroupsテーブルがあり、それぞれの区画群のTopoGeometryを知りたいとします。データが完全に整列しているなら、次のようにできます。

note: Tag: refpurpose
en: Converts a simple Geometry into a topo geometry.
ja: 単純なジオメトリからTopoGeometryを生成します。

note: Tag: para
en: Converts a simple Geometry into a <xref linkend="topogeometry"/>.
ja: 単純なジオメトリから<xref linkend="topogeometry"/>を生成します。

note: Tag: para
en: Topological primitives required to represent the input geometry will be added to the underlying topology, possibly splitting existing ones, and they will be associated with the output TopoGeometry in the <varname>relation</varname> table.
ja: 入力ジオメトリを表現するために必要なトポロジプリミティブが、下位にあるトポロジに追加されます。既存のものを分割することもあります。<varname>relation</varname>テーブル内のTopoGeometryの出力に紐づきます。

note: Tag: para
en: Existing TopoGeometry objects (with the possible exception of <varname>topogeom</varname>, if given) will retain their shapes.
ja: 既存のTopoGeometryオブジェクトは形状を維持します (<varname>topogeom</varname>が与えられている場合には、それが例外となる可能性があります)。

note: Tag: para
en: When <varname>tolerance</varname> is given it will be used to snap the input geometry to existing primitives.
ja: <varname>tolerance</varname>は、与えられた場合には、入力ジオメトリを既存のプリミティブにスナップさせるために使われます。

note: Tag: para
en: In the first form a new TopoGeometry will be created for the given layer (<varname>layer_id</varname>) of the given topology (<varname>toponame</varname>).
ja: 1番目の形式では、新しいTopoGeometryは、与えられたトポロジ (<varname>toponame</varname>)の与えられたレイヤ (<varname>layer_id</varname>)に作られます。

note: Tag: para
en: In the second form the primitives resulting from the conversion will be added to the pre-existing TopoGeometry (<varname>topogeom</varname>), possibly adding space to its final shape. To have the new shape completely replace the old one see <xref linkend="clearTopoGeom"/>.
ja: 2番目の形式では、変換結果のプリミティブが、既存のTopoGeometry (<varname>topogeom</varname>)に追加されます。また、最終の形状にスペースを追加することがあります。新しい形状を完全に持つには、古いものを入れ替えます。<xref linkend="clearTopoGeom"/>を参照して下さい。

note: Tag: para
en: Enhanced: 2.1.0 adds the version taking an existing TopoGeometry.
ja: Enhanced: 2.1.0版では、既存のTopoGeometryを取る形式が追加されました。

note: Tag: para
en: This is a full self-contained workflow
ja: これは完全に全て揃ったワークフローです。

note: Tag: refpurpose
en: Returns a <varname>topoelementarray</varname> for a set of element_id, type arrays (topoelements).
ja: element_idとタイプの配列 (topoelements)からなる<varname>topoelementarray</varname>を返します。

note: Tag: para
en: Used to create a <xref linkend="topoelementarray"/> from a set of <xref linkend="topoelement"/>.
ja: <xref linkend="topoelementarray"/>を<xref linkend="topoelement"/>の集合から生成するために使います。

note: Tag: refpurpose
en: Converts a topogeometry to a topoelement.
ja: TopoGeometryをTopoElementに変換します。

note: Tag: para
en: Converts a <xref linkend="topogeometry"/> to a <xref linkend="topoelement"/>.
ja: <xref linkend="topogeometry"/>を<xref linkend="topoelement"/>に変換します。

note: Tag: title
en: TopoGeometry Editors
ja: TopoGeometryエディタ

note: Tag: para
en: This section covers the topology functions for editing existing topogeometries.
ja: 本節では、既存のTopoGeometryを編集する関数を挙げます。

note: Tag: refpurpose
en: Clears the content of a topo geometry.
ja: TopoGeometryの中身を消去します。

note: Tag: para
en: Clears the content a <xref linkend="topogeometry"/> turning it into an empty one. Mostly useful in conjunction with <xref linkend="toTopoGeom"/> to replace the shape of existing objects and any dependent object in higher hierarchical levels.
ja: <xref linkend="topogeometry"/>の中身を消去し、空にします。<xref linkend="toTopoGeom"/>と併用して、既存オブジェクトと上位にある依存オブジェクトの形状の置換に、だいたい便利です。

note: Tag: refpurpose
en: Adds an element to the definition of a TopoGeometry.
ja: TopoGeometryの定義に要素を追加します。

note: Tag: para
en: Adds a <xref linkend="topoelement"/> to the definition of a TopoGeometry object. Does not error out if the element is already part of the definition.
ja: <xref linkend="topoelement"/>をTopoGeometryオブジェクトの定義に追加します。要素がすでに定義の一部になっていても、エラーは発生しません。

note: Tag: refpurpose
en: Removes an element from the definition of a TopoGeometry.
ja: TopoGeometryの定義から要素を削除します。

note: Tag: para
en: Removes a <xref linkend="topoelement"/> from the definition of a TopoGeometry object.
ja: TopoGeometryオブジェクトの定義から<xref linkend="topoelement"/>を削除します。

note: Tag: refpurpose
en: Adds element of a TopoGeometry to the definition of another TopoGeometry.
ja: TopoGeometryの要素を他のTopoGeometryの定義に追加します。

note: Tag: para
en: Adds the elements of a <xref linkend="topogeometry"/> to the definition of another TopoGeometry, possibly changing its cached type (type attribute) to a collection, if needed to hold all elements in the source object.
ja: <xref linkend="topogeometry"/>の要素を他のTopoGeometryの定義に追加します。ソースオブジェクト内にすべての要素を保持する必要がある場合には、キャッシュされたタイプ (type属性)をコレクションに変更する可能性があります。

note: Tag: para
en: The two TopoGeometry objects need be defined against the *same* topology and, if hierarchically defined, need be composed by elements of the same child layer.
ja: 二つのTopoGeometryオブジェクトは*同じ*トポロジに対して定義されている必要があります。また、階層的な定義がある場合には、同じ子レイヤの要素で構成されている必要があります。

note: Tag: refpurpose
en: Adds a geometry shape to an existing topo geometry.
ja: ジオメトリの形状を既存のTopoGeometryに追加します。

note: Tag: para
en: Refer to <xref linkend="toTopoGeom"/>.
ja: <xref linkend="toTopoGeom"/>を参照して下さい。

note: Tag: title
en: TopoGeometry Accessors
ja: TopoGeometryアクセサ

note: Tag: refpurpose
en: Returns a <varname>topoelementarray</varname> (an array of topoelements) containing the topological elements and type of the given TopoGeometry (primitive elements).
ja: 与えられたTopoGeometry (プリミティブ要素)のトポロジ要素とタイプを含む<varname>topoelementarray</varname> (topoelementの配列)を返します。

note: Tag: para
en: Returns a <xref linkend="topoelementarray"/> containing the topological elements and type of the given TopoGeometry (primitive elements). This is similar to GetTopoGeomElements except it returns the elements as an array rather than as a dataset.
ja: トポロジ要素と与えられたTopoGeometry (プリミティブ要素)のタイプを含む<xref linkend="topoelementarray"/>を返します。GetTopoGeomElementsに近いですが、これは、要素群をデータセットでなく配列で返しています。

note: Tag: para
en: tg_id is the topogeometry id of the topogeometry object in the topology in the layer denoted by <varname>layer_id</varname> in the topology.layer table.
ja: tg_idは、topology.layerテーブル内の<varname>layer_id</varname>で指定されたレイヤのトポロジにおけるTopoGeometryオブジェクトの識別番号です。

note: Tag: refpurpose
en: Returns a set of <varname>topoelement</varname> objects containing the topological element_id,element_type of the given TopoGeometry (primitive elements).
ja: 与えられたTopoGeometry (プリミティブ要素)の、トポロジのelement_idとelement_typeを含む<varname>topoelement</varname>オブジェクトの集合を返します。

note: Tag: para
en: Returns a set of element_id,element_type (topoelements) corresponding to primitive topology elements <xref linkend="topoelement"/> (1: nodes, 2: edges, 3: faces) that a given topogeometry object in <varname>toponame</varname> schema is composed of.
ja: <varname>toponame</varname>スキーマ内で与えられたTopoGeometryオブジェクトを形成するプリミティブなトポロジ要素 <xref linkend="topoelement"/> (1:ノード、2:エッジ、3:フェイス)に対応したelement_id, element_type (topoelements)の集合を返します。

note: Tag: refpurpose
en: Returns the spatial reference identifier for a topogeometry.
ja: TopoGeometryの空間参照識別子を返します。

note: Tag: para
en: Returns the spatial reference identifier for the ST_Geometry as defined in spatial_ref_sys table. <xref linkend="spatial_ref_sys"/>
ja: ST_Geometryのspatial_ref_sysテーブルで定義されている空間参照系の識別番号を返します。<xref linkend="spatial_ref_sys"/>を参照して下さい。

note: Tag: para
en: spatial_ref_sys table is a table that catalogs all spatial reference systems known to PostGIS and is used for transformations from one spatial reference system to another. So verifying you have the right spatial reference system identifier is important if you plan to ever transform your geometries.
ja: spatial_ref_sysテーブルはPostGISが知る参照系の全てのカタログを作っていて、ある空間参照系から他の空間参照系に変換するために使われます。ジオメトリの変換を予定している場合は正しい空間参照系の識別番号を持っているか確認することは重要です。

note: Tag: title
en: TopoGeometry Outputs
ja: TopoGeometry出力

note: Tag: refpurpose
en: Returns the GML representation of a topogeometry.
ja: TopoGeometryのGML表現を返します。

note: Tag: para
en: Returns the GML representation of a topogeometry in version GML3 format. If no <varname>nsprefix_in</varname> is specified then <varname>gml</varname> is used. Pass in an empty string for nsprefix to get a non-qualified name space. The precision (default: 15) and options (default 1) parameters, if given, are passed untouched to the underlying call to ST_AsGML.
ja: GML3の書式でTopoGeometryのGML表現を返します。<varname>nsprefix_in</varname>が指定されていない場合には、<varname>gml</varname>が使われます。非修飾名前空間を得るにはnsprefixに空文字列を渡します。精度 (デフォルトは15)とoptions (デフォルトは1)パラメタは、与えられた場合には、裏で呼んでいるST_AsGMLにそのまま渡します。

note: Tag: para
en: The <varname>visitedTable</varname> parameter, if given, is used for keeping track of the visited Node and Edge elements so to use cross-references (xlink:xref) rather than duplicating definitions. The table is expected to have (at least) two integer fields: 'element_type' and 'element_id'. The calling user must have both read and write privileges on the given table. For best performance, an index should be defined on <varname>element_type</varname> and <varname>element_id</varname>, in that order. Such index would be created automatically by adding a unique constraint to the fields. Example:
ja: <varname>visitedTable</varname>パラメタは、与えられた場合には、訪問したノード要素とエッジ要素のトラックを保持するために使われ、重複定義になるところで相互参照 (xlink:xref)を使います。テーブルは 整数カラムである'element_type'と'element_id'とを持つことを期待されます。この関数を呼び出したユーザは、このテーブルへの読み込み権限と書き込み権限とが必要です。効率よくするには、 <varname>element_type</varname>と<varname>element_id</varname>に、この順序でインデックスを定義します。インデックスは一意制約をカラムに追加すると自動的に生成されます。例を示します。

note: Tag: para
en: The <varname>idprefix</varname> parameter, if given, will be prepended to Edge and Node tag identifiers.
ja: <varname>idprefix</varname>パラメタは、指定された場合には、Edgeタグ識別子とNodeタグ識別子の前に付きます。

note: Tag: para
en: The <varname>gmlver</varname> parameter, if given, will be passed to the underlying ST_AsGML. Defaults to 3.
ja: <varname>gmlver</varname>パラメタは、指定された場合には、裏で呼んでいるST_AsGMLに渡されます。デフォルトは3です。

note: Tag: para
en: This uses the topo geometry we created in <xref linkend="CreateTopoGeom"/>
ja: ここでは<xref linkend="CreateTopoGeom"/>で生成したTopoGeometryを使用しています。

note: Tag: para
en: Same exercise as previous without namespace
ja: 上の例から名前空間を取り除いた例です。

note: Tag: refpurpose
en: Returns the TopoJSON representation of a topogeometry.
ja: opoGeometryのTopoJSON表現を返します。

note: Tag: para
en: Returns the TopoJSON representation of a topogeometry. If <varname>edgeMapTable</varname> is not null, it will be used as a lookup/storage mapping of edge identifiers to arc indices. This is to be able to allow for a compact "arcs" array in the final document.
ja: TopoGeometryのTopoJSON表現を返します。<varname>edgeMapTable</varname>がNULLでない場合には、エッジ識別番号とアーク添え字のルックアップと格納のマッピングに使われます。これは、最終的な文書内のコンパクトな"arcs"配列ができるようにするためです。

note: Tag: para
en: The table, if given, is expected to have an "arc_id" field of type "serial" and an "edge_id" of type integer; the code will query the table for "edge_id" so it is recommended to add an index on that field.
ja: このテーブルは、与えられた場合には、"serial"型の"arc_id"カラムと整数型の"edge_id"とを持つことが期待されます。関数はこのテーブルに"edge_id"を問い合わせるので、このカラムにインデクスを追加することが推奨されます。

note: Tag: para
en: Arc indices in the TopoJSON output are 0-based but they are 1-based in the "edgeMapTable" table.
ja: TopoJSONでのアークのインデックスは0始まりですが、"edgeMapTable"テーブルでは1始まりです。

note: Tag: para
en: A full TopoJSON document will be need to contain, in addition to the snippets returned by this function, the actual arcs plus some headers. See the <link xlink:href="http://github.com/mbostock/topojson-specification/blob/master/README.md">TopoJSON specification</link>.
ja: 完全なTopoJSON文書は、この関数が返すスニペットだけでなく、実際のarcsメンバと、いくつかのヘッダを含む必要があります。 <link xlink:href="http://github.com/mbostock/topojson-specification/blob/master/README.md">TopoJSON specification</link>をご覧ください。

note: Tag: para
en: Enhanced: 2.2.1 added support for puntal inputs
ja: Enhanced: 2.2.1 点入力に対応するようになりました

note: Tag: title
en: Topology Spatial Relationships
ja: トポロジ空間関係関数

note: Tag: para
en: This section lists the Topology functions used to check relationships between topogeometries and topology primitives
ja: 本節ではTopoGeometryとトポロジプリミティブとの間の関係を見るトポロジ関数の一覧を挙げます。

note: Tag: refpurpose
en: Returns true if two topogeometries are composed of the same topology primitives.
ja: 二つのTopoGeometryが同じトポロジプリミティブで成っている場合にtrueを返します。

note: Tag: para
en: Returns true if two topogeometries are composed of the same topology primitives: faces, edges, nodes.
ja: 二つTopoGeometryが同じトポロジプリミティブで成っている場合にtrueを返します。

note: Tag: para
en: This function not supported for topogeometries that are geometry collections. It also can not compare topogeometries from different topologies.
ja: この関数はジオメトリコレクションのTopoGeometryに対応していません。異なるトポロジからなるTopoGeometryとの比較もできません。

note: Tag: refpurpose
en: <refpurpose>Returns true if any pair of primitives from the two topogeometries intersect.</refpurpose>
ja: <refpurpose>二つのTopoGeometryからのプリミティブの組がインタセクトする場合にtrueを返します。</refpurpose>

note: Tag: para
en: <para>Returns true if any pair of primitives from the two topogeometries intersect.</para>
ja: <para>二つのTopoGeometryからのプリミティブがインタセクトする場合にtrueを返します。</para>

note: Tag: para
en: This function not supported for topogeometries that are geometry collections. It also can not compare topogeometries from different topologies. Also not currently supported for hierarchical topogeometries (topogeometries composed of other topogeometries).
ja: この関数はジオメトリコレクションのTopoGeometryに対応していません。異なるトポロジからなるTopoGeometryとの比較もできません。また、現在のところ、階層TopoGeometry (他のTopoGeometryからなるTopoGeometry)に対応していません。

note: Tag: title
en: Importing and exporting Topologies
ja: トポロジのインポートとエクスポート

note: Tag: para
en: Once you have created topologies, and maybe associated topological layers, you might want to export them into a file-based format for backup or transfer into another database.
ja: トポロジを生成したり、場合によってはトポロジレイヤに関連付けると、バックアップや他のデータベースへの転送のために、ファイルに出力するフォーマットでエクスポートした方がいいでしょう。

note: Tag: para
en: Using the standard dump/restore tools of PostgreSQL is problematic because topologies are composed by a set of tables (4 for primitives, an arbitrary number for layers) and records in metadata tables (topology.topology and topology.layer). Additionally, topology identifiers are not univoque across databases so that parameter of your topology will need to be changes upon restoring it.
ja: トポロジはテーブルの集合 (プリミティブで4テーブル、レイヤで任意数)と、メタデータテーブルのレコード (topology.topologyとtopology.layer)になっているため、PostgreSQLの標準的なダンプ/レストアのツールでは問題があります。さらに、トポロジの識別子はデータベース間で同じではないため、トポロジのパラメータはレストア時に変更する必要があります。

note: Tag: para
en: In order to simplify export/restore of topologies a pair of executables are provided: <filename>pgtopo_export</filename> and <filename>pgtopo_import</filename>. Example usage:
ja: トポロジのエクスポート/レストアを簡単化するために、二つの実行可能ファイルが提供されています。<filename>pgtopo_export</filename>と<filename>pgtopo_import</filename>です。使用例は次の通りです。

note: Tag: title
en: Using the Topology exporter
ja: トポロジエクスポータの使用

note: Tag: para
en: The <filename>pgtopo_export</filename> script takes the name of a database and a topology and outputs a dump file which can be used to import the topology (and associated layers) into a new database.
ja: <filename>pgtopo_export</filename>スクリプトはデータベース名とトポロジ名を取り、トポロジ (と関連するレイヤ)を新しいデータベースにインポートするために使うことができるダンプファイルを出力します。

note: Tag: para
en: By default <filename>pgtopo_export</filename> writes the dump file to the standard output so that it can be piped to <filename>pgtopo_import</filename> or redirected to a file (refusing to write to terminal). You can optionally specify an output filename with the <code>-f</code> commandline switch.
ja: デフォルトでは<filename>pgtopo_export</filename>はダンプファイルを標準出力に書くので、<filename>pgtopo_import</filename>にパイプで繋げたり、ファイルにリダイレクトする (端末への出力を止める)ことができます。出力ファイル名をコマンドラインスイッチ<code>-f</code>で指定することもできます。

note: Tag: para
en: By default <filename>pgtopo_export</filename> includes a dump of all layers defined against the given topology. This may be more data than you need, or may be non-working (in case your layer tables have complex dependencies) in which case you can request skipping the layers with the <code>--skip-layers</code> switch and deal with those separately.
ja: デフォルトでは<filename>pgtopo_export</filename>は、指定されたトポロジに対して定義されたレイヤの全てのダンプが含まれます。これは、必要なデータより多い場合もありますし、動作しない場合もあり (レイヤテーブルが複雑な依存関係を持っている場合)、この場合には<code>--skip-layers</code>スイッチでレイヤをスキップし、別々に処理することができます。

note: Tag: para
en: Invoking <filename>pgtopo_export</filename> with the <code>--help</code> (or <code>-h</code> for short) switch will always print short usage string.
ja: <filename>pgtopo_export</filename>を<code>--help</code> (または短縮の<code>-h</code>)スイッチで実行すると、常に短い使用法文字列を印字します。

note: Tag: para
en: The dump file format is a compressed tar archive of a <filename>pgtopo_export</filename> directory containing at least a <filename>pgtopo_dump_version</filename> file with format version info. As of version <code>1</code> the directory contains tab-delimited CSV files with data of the topology primitive tables (node, edge_data, face, relation), the topology and layer records associated with it and (unless <code>--skip-layers</code> is given) a custom-format PostgreSQL dump of tables reported as being layers of the given topology.
ja: ダンプファイルフォーマットは、少なくともフォーマットバージョン情報を持つ<filename>pgtopo_dump_version</filename>ファイルを含む<filename>pgtopo_export</filename>ディレクトリの圧縮されたtarアーカイブです。バージョン<code>1</code>では、ディレクトリにはトポロジのプリミティブテーブル (node, edge_data, face, relation)と、プリミティブと関連付けられたトポロジとレイヤとを持つタブ区切りCSVファイルが含まれ、(<code>--skip-layers</code>が与えられない場合)与えられたトポロジのレイヤとして報告されたテーブルのPostgrfeSQLダンプのカスタムフォーマットも含まれます。

note: Tag: title
en: Using the Topology importer
ja: トポロジインポータの使用

note: Tag: para
en: The <filename>pgtopo_import</filename> script takes a <code>pgtopo_export</code> format topology dump and a name to give to the topology to be created and outputs an SQL script reconstructing the topology and associated layers.
ja: <filename>pgtopo_import</filename>スクリプトは<code>pgtopo_export</code>書式のトポロジのダンプと、生成するトポロジに与える名前とを取り、そこからトポロジと関連するレイヤを再構築するSQLスクリプトを出力します。

note: Tag: para
en: The generated SQL file will contain statements that create a topology with the given name, load primitive data in it, restores and registers all topology layers by properly linking all TopoGeometry values to their correct topology.
ja: 生成されたSQLには、与えられた名前でトポロジを生成し、プリミティブなデータをロードし、格納して、TopoGeometry値を確実に正しいトポロジに関連付けることで全てのトポロジレイヤを登録する手続きが含まれます。

note: Tag: para
en: By default <filename>pgtopo_import</filename> reads the dump from the standard input so that it can be used in conjunction with <filename>pgtopo_export</filename> in a pipeline. You can optionally specify an input filename with the <code>-f</code> commandline switch.
ja: デフォルトでは<filename>pgtopo_import</filename>は標準入力からダンプを読むので、<filename>pgtopo_export</filename>をパイプで繋げて併用することができます。入力ファイル名をコマンドラインスイッチ<code>-f</code>で指定することもできます。

note: Tag: para
en: By default <filename>pgtopo_import</filename> includes in the output SQL file the code to restore all layers found in the dump.
ja: デフォルトでは<filename>pgtopo_import</filename>のSQLファイル出力には、ダンプで発見された全てのレイヤを格納するためのコードが含まれます。

note: Tag: para
en: This may be unwanted or non-working in case your target database already have tables with the same name as the ones in the dump. In that case you can request skipping the layers with the <code>--skip-layers</code> switch and deal with those separately (or later).
ja: これらは、ダンプ内にあるテーブル名が既に対象データベース内のテーブル名で使われている場合には、望ましくないようになるか動作しない可能性があります。この場合には、レイヤをスキップする<code>--skip-layers</code>スイッチを使い、別に (または後で)処理することができます。

note: Tag: para
en: SQL to only load and link layers to a named topology can be generated using the <code>--only-layers</code> switch. This can be useful to load layers AFTER resolving the naming conflicts or to link layers to a different topology (say a spatially-simplified version of the starting topology).
ja: ロードして、レイヤを名前付きトポロジにリンクするSQLは<code>--only-layers</code>スイッチで生成できます。これは、名前の競合を解決した*後に*レイヤをロードしたり、異なるトポロジのレイヤ (開始トポロジで空間的に単純化されたもの等が挙げられます)にリンクするのに使えます。

note: Tag: title
en: PostGIS Installation
ja: PostGISインストール

note: Tag: para
en: This chapter details the steps required to install PostGIS.
ja: 本章では、PostGISのインストールに必要な手順について説明します。

note: Tag: title
en: Short Version
ja: 簡略版

note: Tag: para
en: To compile assuming you have all the dependencies in your search path:
ja: 全ての依存がパスに入っているとする場合、次のようにコンパイルします。

note: Tag: para
en: Once PostGIS is installed, it needs to be enabled (<xref linkend="create_spatial_db"/>) or upgraded (<xref linkend="upgrading"/>) in each individual database you want to use it in.
ja: PostGISをインストールした後は、利用したいデータベース個々内で利用可能にする (<xref linkend="create_spatial_db"/>)か、アップグレード (<xref linkend="upgrading"/>)する必要があります。

note: Tag: title
en: Compiling and Install from Source
ja: ソースからのコンパイルとインストール

note: Tag: para
en: Many OS systems now include pre-built packages for PostgreSQL/PostGIS. In many cases compilation is only necessary if you want the most bleeding edge versions or you are a package maintainer.
ja: 多くのOSで、ビルドされたPostgreSQL/PostGISパッケージがあります。多くの場合、コンパイルが必要なのは、最もひどい最先端の版が欲しい場合やパッケージメンテナンスを行う人ぐらいです。

note: Tag: para
en: This section includes general compilation instructions, if you are compiling for Windows etc or another OS, you may find additional more detailed help at <link xlink:href="https://trac.osgeo.org/postgis/wiki/UsersWikiInstall">PostGIS User contributed compile guides</link> and <link xlink:href="http://trac.osgeo.org/postgis/wiki/DevWikiMain">PostGIS Dev Wiki</link>.
ja: 本節では、一般的なコンパイル手順を示します。Windows用や他のOS用等にコンパイルするなら、<link xlink:href="https://trac.osgeo.org/postgis/wiki/UsersWikiInstall">PostGIS User contributed compile guides</link>や<link xlink:href="http://trac.osgeo.org/postgis/wiki/DevWikiMain">PostGIS Dev Wiki</link>で、より詳細な助けが見つかるかも知れません。

note: Tag: para
en: Pre-Built Packages for various OS are listed in <link xlink:href="https://trac.osgeo.org/postgis/wiki/UsersWikiPackages">PostGIS Pre-built Packages</link>
ja: 多くのOS用のビルド済みパッケージの一覧は<link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiPackages">PostGIS Pre-built Packages</link>にあります。

note: Tag: para
en: If you are a windows user, you can get stable builds via Stackbuilder or <link xlink:href="https://postgis.net/windows_downloads">PostGIS Windows download site</link> We also have <link xlink:href="https://postgis.net/windows_downloads">very bleeding-edge windows experimental builds</link> that are built usually once or twice a week or whenever anything exciting happens. You can use these to experiment with the in progress releases of PostGIS
ja: Windowsユーザの場合は、スタックビルダか、<link xlink:href="http://www.postgis.org/download/windows/">PostGIS Windows download site</link>から安定版を得ることができます。また、週に1回か2回のビルドと刺激的なことがあった時の随時ビルドとを行っている<link xlink:href="https://postgis.net/windows_downloads">very bleeding-edge windows experimental builds</link>もあります。これらはPostGISの進行中のリリースでの試験に使用します。

note: Tag: para
en: The PostGIS module is an extension to the PostgreSQL backend server. As such, PostGIS &last_release_version; <emphasis>requires</emphasis> full PostgreSQL server headers access in order to compile. It can be built against PostgreSQL versions &min_postgres_version; - &max_postgres_version;. Earlier versions of PostgreSQL are <emphasis>not</emphasis> supported.
ja: PostGISモジュールは、PostgreSQLバックエンドサーバの拡張です。PostGIS &last_release_version;では、コンパイルのために、完全なPostgreSQLサーバヘッダが<emphasis>必要です</emphasis>。PostgreSQL &min_postgres_version; - &max_postgres_version;の間でビルドできます。古い版のPostgreSQLは<emphasis>サポートされません</emphasis>。

note: Tag: para
en: Refer to the PostgreSQL installation guides if you haven't already installed PostgreSQL. <link xlink:href="https://www.postgresql.org"> https://www.postgresql.org </link> .
ja: PostgreSQLをインストールしていないならPostgreSQLインストールガイドを参照して下さい。<link xlink:href="http://www.postgresql.org/">http://www.postgresql.org/</link>にあります。

note: Tag: para
en: For GEOS functionality, when you install PostgreSQL you may need to explicitly link PostgreSQL against the standard C++ library:
ja: GEOS機能を有効にするために、PostgreSQLをインストール時に明示的に標準C++ライブラリに対する明示的なリンクが必要になる場合があります。

note: Tag: para
en: This is a workaround for bogus C++ exceptions interaction with older development tools. If you experience weird problems (backend unexpectedly closed or similar things) try this trick. This will require recompiling your PostgreSQL from scratch, of course.
ja: これは、古い開発ツールとインチキC++例外との対話のための応急処置です。怪しい問題 (望んでいないのにバックエンドが閉じたりそれに近い挙動を起こす)を経験したなら、このトリックを試してみて下さい。もちろん、これを行うにはPostgreSQLをはじめからコンパイルし直す必要があります。

note: Tag: para
en: The following steps outline the configuration and compilation of the PostGIS source. They are written for Linux users and will not work on Windows or Mac.
ja: 次のステップでは、PostGISソースのコンフィギュレーションとコンパイルに概要を記述します。これらは、Linuxユーザ用に書いてありますので、WindowsやMacでは動作しません。

note: Tag: title
en: Getting the Source
ja: ソースの取得

note: Tag: para
en: Retrieve the PostGIS source archive from the downloads website <link xlink:href="&postgis_download_url;"> &postgis_download_url; </link>
ja: ダウンロードサイト<link xlink:href="&postgis_download_url;"> &postgis_download_url; </link>からソースのアーカイブを入手します。

note: Tag: para
en: This will create a directory called <varname>postgis-&last_release_version;</varname> in the current working directory.
ja: これで、カレントディレクトリの下に<varname>postgis-&last_release_version;</varname>ができます。

note: Tag: para
en: Alternatively, checkout the source from the <link xlink:href="https://git-scm.com/"> git </link> repository <link xlink:href="https://git.osgeo.org/gitea/postgis/postgis/"> https://git.osgeo.org/gitea/postgis/postgis/ </link> .
ja: もしくは <link xlink:href="https://git-scm.com/"> git </link>レポジトリ<link xlink:href="https://git.osgeo.org/gitea/postgis/postgis/"> https://git.osgeo.org/gitea/postgis/postgis/ </link>からチェックアウトします。

note: Tag: para
en: Change into the newly created <varname>postgis</varname> directory to continue the installation.
ja: 新しく作られた<varname>postgis</varname>ディレクトトリに移動して、インストールを続けます。

note: Tag: title
en: Install Requirements
ja: インストール要件

note: Tag: para
en: PostGIS has the following requirements for building and usage:
ja: PostGISのビルドと利用のために、次のものが必要です。

note: Tag: emphasis
en: Required
ja: 必須

note: Tag: para
en: PostgreSQL &min_postgres_version; - &max_postgres_version;. A complete installation of PostgreSQL (including server headers) is required. PostgreSQL is available from <link xlink:href="https://www.postgresql.org"> https://www.postgresql.org </link> .
ja: PostgreSQL &min_postgres_version; - &max_postgres_version;。PostgreSQLの完全なインストール (サーバヘッダを含む)が必要です。PostgreSQLは<link xlink:href="http://www.postgresql.org/"> http://www.postgresql.org/</link>にあります。

note: Tag: para
en: For a full PostgreSQL / PostGIS support matrix and PostGIS/GEOS support matrix refer to <link xlink:href="https://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS">https://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS</link>
ja: 完全なPosgreSQL/PostGIS対応表とPostGIS/GEOS対応表については<link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS">http://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS</link>をご覧ください。

note: Tag: para
en: GNU C compiler (<filename>gcc</filename>). Some other ANSI C compilers can be used to compile PostGIS, but we find far fewer problems when compiling with <filename>gcc</filename>.
ja: GNU Cコンパイラ (<filename>gcc</filename>)。ANSI Cコンパイラの中には、PostGISをコンパイルできるものもありますが、<filename>gcc</filename>でコンパイルするのが最も問題が少ないと見ています。

note: Tag: para
en: GNU Make (<filename>gmake</filename> or <filename>make</filename>). For many systems, GNU <filename>make</filename> is the default version of make. Check the version by invoking <filename>make -v</filename>. Other versions of <filename>make</filename> may not process the PostGIS <filename>Makefile</filename> properly.
ja: GNU Make (<filename>gmake</filename>または<filename>make</filename>)。多くのシステムで、GNU <filename>make</filename>がデフォルトのmakeになっています。<filename>make -v</filename>を実行して版を確認して下さい。他版の<filename>make</filename>では、PostGISの<filename>Makefile</filename>を完全に処理しきれないかもしれません。

note: Tag: para
en: Proj reprojection library. Proj 6.1 or above is required. The Proj library is used to provide coordinate reprojection support within PostGIS. Proj is available for download from <link xlink:href="https://proj.org/"> https://proj.org/ </link> .
ja: 投影変換ライブラリProj。Proj 6.1以上が必要です。Projライブラリは、PostGISの座標系投影変換機能に使われます。Projは<link xlink:href="https://proj.org/"> https://proj.org/ </link>からダウンロードできます。

note: Tag: para
en: GEOS geometry library, version &min_geos_version; or greater, but GEOS 3.12+ is required to take full advantage of all the new functions and features. GEOS is available for download from <link xlink:href="https://libgeos.org/"> https://libgeos.org </link>.
ja: ジオメトリライブラリGEOSの新しい関数と機能の利点を完全に得るには&min_geos_version;以上で、GEOS 3.12以上が必要です。GEOSは <link xlink:href="https://libgeos.org/">https://libgeos.org/</link>からダウンロードできます。

note: Tag: para
en: LibXML2, version 2.5.x or higher. LibXML2 is currently used in some imports functions (ST_GeomFromGML and ST_GeomFromKML). LibXML2 is available for download from <link xlink:href="https://gitlab.gnome.org/GNOME/libxml2/-/releases">https://gitlab.gnome.org/GNOME/libxml2/-/releases</link>.
ja: LibXML2, 2.5.x以上。現在は、LibXML2はインポート関数 (ST_GeomFromGMLとST_GeomFromKML)で使われています。LibXML2は<link xlink:href="https://gitlab.gnome.org/GNOME/libxml2/-/releases">https://gitlab.gnome.org/GNOME/libxml2/-/releases</link>からダウンロードできます。

note: Tag: para
en: JSON-C, version 0.9 or higher. JSON-C is currently used to import GeoJSON via the function ST_GeomFromGeoJson. JSON-C is available for download from <link xlink:href="https://github.com/json-c/json-c/releases">https://github.com/json-c/json-c/releases/</link>.
ja: JSON-C 0.9以上。JSON-Cは現在、ST_GeomFromGeoJsonによるGeoJSONの取り込みに使われます。JSON-Cは<link xlink:href="https://github.com/json-c/json-c/releases/">https://github.com/json-c/json-c/releases/</link>からダウンロード可能です。

note: Tag: para
en: GDAL, version 3+ is preferred. This is required for raster support. <link xlink:href="https://gdal.org/download.html">https://gdal.org/download.html</link>.
ja: GDAL バージョン3以上が推奨されます。ラスタ機能に必要です。<link xlink:href="https://gdal.org/download.html">https://gdal.org/download.html</link>にあります。

note: Tag: para
en: If compiling with PostgreSQL+JIT, LLVM version &gt;=6 is required <link xlink:href="https://trac.osgeo.org/postgis/ticket/4125">https://trac.osgeo.org/postgis/ticket/4125</link>.
ja: PostgreSQL+JITでコンパイルする場合には、LLVM 6版以上が必要です。<link xlink:href="https://trac.osgeo.org/postgis/ticket/4125">https://trac.osgeo.org/postgis/ticket/4125</link>を参照して下さい。

note: Tag: emphasis
en: Optional
ja: オプション

note: Tag: para
en: GDAL (pseudo optional) only if you don't want raster you can leave it out. Also make sure to enable the drivers you want to use as described in <xref linkend="raster_configuration"/>.
ja: GDAL (擬似的任意)。ラスタが必要ない場合に限り不要です。<xref linkend="raster_configuration"/>の説明に従って使用したいドライバを有効にしてください。

note: Tag: para
en: GTK (requires GTK+2.0, 2.8+) to compile the shp2pgsql-gui shape file loader. <link xlink:href="http://www.gtk.org/"> http://www.gtk.org/ </link> .
ja: GTK (GTK+2.0, 2.8+が必要)。シェープファイルのローダであるshp2pgsql-guiのコンパイル用です。<link xlink:href="http://www.gtk.org/">http://www.gtk.org/</link>にあります。

note: Tag: para
en: SFCGAL, 1.4.1 or higher is required and 1.5.0+ is needed to be able to use all functionality. SFCGAL can be used to provide additional 2D and 3D advanced analysis functions to PostGIS cf <xref linkend="reference_sfcgal"/>. And also allow to use SFCGAL rather than GEOS for some 2D functions provided by both backends (like ST_Intersection or ST_Area, for instance). A PostgreSQL configuration variable <code>postgis.backend</code> allow end user to control which backend he want to use if SFCGAL is installed (GEOS by default). Nota: SFCGAL 1.2 require at least CGAL 4.3 and Boost 1.54 (cf: <link xlink:href="https://sfcgal.org">https://sfcgal.org</link>) <link xlink:href="https://gitlab.com/sfcgal/SFCGAL/">https://gitlab.com/sfcgal/SFCGAL/</link>.
ja: SFCGAL 1.4.1 以上が必要ですが、全ての機能を使用できるようにするためには、1.5.0以上が必要です。SFCGALは、<xref linkend="reference_sfcgal"/>のような、追加の2次元、3次元の高度な解析機能をPostGISに提供するために使います。また、両方のバックエンドから提供されている2次元関数 (ST_IntersectionやST_Areaなど)に、GEOSでなくSFCGALを使用することができるようになります。PostgreSQLのコンフィギュレーション変数である<code>postgis.backend</code>によって、SFCGALがインストールされている場合にエンドユーザがどのバックエンドを使うかを制御することができるようになります (デフォルトはGEOS)。ご注意: SFCGAL 1.2は少なくともCGAL 4.3とBoost 1.54 が必要です (<link xlink:href="https://sfcgal.org/">https://sfcgal.org/</link> 参照) <link xlink:href="https://gitlab.com/sfcgal/SFCGAL/">https://gitlab.com/sfcgal/SFCGAL/</link>。

note: Tag: para
en: In order to build the <xref linkend="Address_Standardizer"/> you will also need PCRE <link xlink:href="http://www.pcre.org">http://www.pcre.org</link> (which generally is already installed on nix systems). <xref linkend="Address_Standardizer"/> will automatically be built if it detects a PCRE library, or you pass in a valid <varname>--with-pcre-dir=/path/to/pcre</varname> during configure.
ja: <xref linkend="Address_Standardizer"/>をビルドするには、PCRE <link xlink:href="http://www.pcre.org">http://www.pcre.org</link> (通常はnixシステムにはインストールされています)も必要です。PCREライブラリを検出したら<xref linkend="Address_Standardizer"/>は自動でビルドされます。もしくは、コンフィギュアの際に有効な<varname>--with-pcre-dir=/path/to/pcre</varname>を指定します。

note: Tag: para
en: To enable ST_AsMVT protobuf-c library 1.1.0 or higher (for usage) and the protoc-c compiler (for building) are required. Also, pkg-config is required to verify the correct minimum version of protobuf-c. See <link xlink:href="https://github.com/protobuf-c/protobuf-c">protobuf-c</link>. By default, Postgis will use Wagyu to validate MVT polygons faster which requires a c++11 compiler. It will use CXXFLAGS and the same compiler as the PostgreSQL installation. To disable this and use GEOS instead use the <varname>--without-wagyu</varname> during the configure step.
ja: ST_AsMVTを有効にするには、protobuf-cライブラリ (実行時)とprotoc-cコンパイラ (ビルド時)が必要です。protobuf-cの正しい最小版を確認するには、pkg-configが必要です。<link xlink:href="https://github.com/protobuf-c/protobuf-c">protobuf-c</link>をご覧下さい。デフォルトでは、PostGISは、MVTポリゴンを高速に評価するためにWagyuを使用していますが、C++11コンパイラが必要です。CXXFLAGSを使って、PostgreSQLインストールに使ったのと同じコンパイラを使います。これを無効化してGEOSを代わりに使う場合には、コンフィギュレーション時に<varname>--without-wagyu</varname>を指定します。

note: Tag: para
en: CUnit (<filename>CUnit</filename>). This is needed for regression testing. <link xlink:href="http://cunit.sourceforge.net/">http://cunit.sourceforge.net/</link>
ja: CUnit (<filename>CUnit</filename>)。レグレッションテストに必要です。<link xlink:href="http://cunit.sourceforge.net/">http://cunit.sourceforge.net/</link>にあります。

note: Tag: para
en: DocBook (<filename>xsltproc</filename>) is required for building the documentation. Docbook is available from <link xlink:href="http://www.docbook.org/"> http://www.docbook.org/ </link> .
ja: DocBook (<filename>xsltproc</filename>)。文書のビルドに必要です。<link xlink:href="http://www.docbook.org/">http://www.docbook.org/</link>にあります。

note: Tag: para
en: DBLatex (<filename>dblatex</filename>) is required for building the documentation in PDF format. DBLatex is available from <link xlink:href="http://dblatex.sourceforge.net/"> http://dblatex.sourceforge.net/ </link> .
ja: DBLatex (<filename>dblatex</filename>)。文書をPDFでビルドするのに必要です。<link xlink:href="http://dblatex.sourceforge.net/">http://dblatex.sourcforge.net/</link>にあります。

note: Tag: para
en: ImageMagick (<filename>convert</filename>) is required to generate the images used in the documentation. ImageMagick is available from <link xlink:href="http://www.imagemagick.org/"> http://www.imagemagick.org/ </link> .
ja: ImageMagick (<filename>convert</filename>)。文書で使う画像を生成するのに必要です。<link xlink:href="http://www.imagemagick.org/">http://www.imagemagick.org/</link>にあります。

note: Tag: title
en: Build configuration
ja: コンフィギュレーション

note: Tag: para
en: As with most linux installations, the first step is to generate the Makefile that will be used to build the source code. This is done by running the shell script
ja: ほとんどのLinuxのインストールと同様に、最初のステップでは、ソースコードのビルドに使われるMakefileを生成します。これは、シェルスクリプトが行います。

note: Tag: para
en: With no additional parameters, this command will attempt to automatically locate the required components and libraries needed to build the PostGIS source code on your system. Although this is the most common usage of <command>./configure</command>, the script accepts several parameters for those who have the required libraries and programs in non-standard locations.
ja: パラメータを付けない場合には、このコマンドは自動で、PostGISのソースコードのビルドを行うのに必要なコンポーネントやライブラリをシステム上で探します。<command>./configure</command>とするのが一般的な使い方ですが、標準的でない位置に必要なライブラリやプログラムを置いてある場合のために、いくつかのパラメータを受け付けます。

note: Tag: para
en: The following list shows only the most commonly used parameters. For a complete list, use the <command>--help</command> or <command>--help=short</command> parameters.
ja: 次のリストで、共通して使われるパラメータを示します。 完全なリストについては、<command>--help</command>または<command>--help=short</command>パラメータを使って下さい。

note: Tag: para
en: Starting with PostGIS 3.0, the library files generated by default will no longer have the minor version as part of the file name. This means all PostGIS 3 libs will end in <code>postgis-3</code>. This was done to make pg_upgrade easier, with downside that you can only install one version PostGIS 3 series in your server. To get the old behavior of file including the minor version: e.g. <code>postgis-3.0</code> add this switch to your configure statement.
ja: PostGIS 3.0以降では、デフォルトではライブラリファイルのファイル名にマイナーバージョンが入らなくなりました。PostGIS 3のライブラリは<code>postgis-3</code>で終わります。pg_upgradeを簡単にするために実施された変更ですが、サーバにPostGIS 3シリーズは一つのマイナーバージョンのものだけしかインストールできません。<code>postgis-3.0</code>といったようにマイナーバージョンをファイル名に含む古い振る舞いにしたいなら、コンフィギュレーション実行の際に次のスイッチを追加します。

note: Tag: para
en: This is the location the PostGIS loader executables and shared libs will be installed. By default, this location is the same as the detected PostgreSQL installation.
ja: PostGISライブラリとSQLスクリプトのインストール先を指定します。デフォルトでは、検出されたPostgreSQLのインストール先と同じになります。

note: Tag: para
en: This parameter is currently broken, as the package will only install into the PostgreSQL installation directory. Visit <link xlink:href="http://trac.osgeo.org/postgis/ticket/635"> http://trac.osgeo.org/postgis/ticket/635 </link> to track this bug.
ja: このパラメータは現在のところ壊れていて、PostgreSQLのインストール先にしかインストールされません。このバグのトラックについては<link xlink:href="http://trac.osgeo.org/postgis/ticket/635">http://trac.osgeo.org/postgis/ticket/635</link>をご覧ください。

note: Tag: para
en: PostgreSQL provides a utility called <command>pg_config</command> to enable extensions like PostGIS to locate the PostgreSQL installation directory. Use this parameter (<command>--with-pgconfig=/path/to/pg_config</command>) to manually specify a particular PostgreSQL installation that PostGIS will build against.
ja: PostgreSQLは、PostGISなどの拡張に対してPostgreSQLのインストール先ディレクトリを伝える<command>pg_config</command>というユーティリティを持っています。PostGISの対象とする特定のPostgreSQLのインストール先を手動で指定する場合に、このパラメータ(<command>--with-pgconfig=/path/to/pg_config</command>)を使います。

note: Tag: para
en: GDAL, a required library, provides functionality needed for raster support <command>gdal-config</command> to enable software installations to locate the GDAL installation directory. Use this parameter (<command>--with-gdalconfig=/path/to/gdal-config</command>) to manually specify a particular GDAL installation that PostGIS will build against.
ja: 必須ライブラリであるGDALは、ラスタ機能に必要な機能を提供します。GDALには、インストール先ディレクトリをインストールスクリプトに伝える<command>gdal-config</command>があります。PostGISのビルドに使う特定のGDALを手動で指定する場合に、このパラメータ (<command>--with-gdalconfig=/path/to/gdal-config</command>)を使います。

note: Tag: para
en: GEOS, a required geometry library, provides a utility called <command>geos-config</command> to enable software installations to locate the GEOS installation directory. Use this parameter (<command>--with-geosconfig=/path/to/geos-config</command>) to manually specify a particular GEOS installation that PostGIS will build against.
ja: 必須のジオメトリライブラリであるGEOSには、ソフトウェアのインストール時にGEOSのインストール先ディレクトリを伝える<command>geos-config</command>というユーティリティがあります。PostGISのビルドに使う特定のGEOSを手動で指定する場合に、このパラメータ (<command>--with-geosconfig=/path/to/geos-config</command>)を使います。

note: Tag: para
en: LibXML is the library required for doing GeomFromKML/GML processes. It normally is found if you have libxml installed, but if not or you want a specific version used, you'll need to point PostGIS at a specific <filename>xml2-config</filename> confi file to enable software installations to locate the LibXML installation directory. Use this parameter (<command>&gt;--with-xml2config=/path/to/xml2-config</command>) to manually specify a particular LibXML installation that PostGIS will build against.
ja: LibXMLはGeomFromKML/GML処理を行うのに必須のライブラリです。通常はlibxmlをインストールしているなら発見されますが、発見できない場合や特定の版を使用したい場合は、<filename>xml2-config</filename>を指定してインストールスクリプトにLibXMLのインストール先ディレクトリを伝えます。PostGISのビルドに使う特定のLibXMLを手動で指定する場合に、このパラメータ (<command>&gt;--with-xml2config=/path/to/xml2-config</command>)を使います。

note: Tag: para
en: Proj is a reprojection library required by PostGIS. Use this parameter (<command>--with-projdir=/path/to/projdir</command>) to manually specify a particular Proj installation directory that PostGIS will build against.
ja: ProjはPostGISに必須の投影変換ライブラリです。PostGISのビルドに使う特定のProjのインストールディレクトリを手動で指定する場合は、このパラメータ (<command>--with-projdir=/path/to/projdir</command>)を使います。

note: Tag: para
en: Directory where iconv is installed.
ja: iconvのインストール先ディレクトリを指定します。

note: Tag: para
en: <link xlink:href="http://oss.metaparadigm.com/json-c/">JSON-C</link> is an MIT-licensed JSON library required by PostGIS ST_GeomFromJSON support. Use this parameter (<command>--with-jsondir=/path/to/jsondir</command>) to manually specify a particular JSON-C installation directory that PostGIS will build against.
ja: <link xlink:href="http://oss.metaparadigm.com/json-c/">JSON-C</link>は、MITライセンスのJSONライブラリで、PostGISのST_GeomFromJSONに必須です。PostGISのビルドに使う特定のJSON-Cを手動で指定する場合に、このパラメータ (<command>--with-jsondir=/path/to/jsondir</command>)を使います。

note: Tag: para
en: <link xlink:href="http://www.pcre.org/">PCRE</link> is an BSD-licensed Perl Compatible Regular Expression library required by address_standardizer extension. Use this parameter (<command>--with-pcredir=/path/to/pcredir</command>) to manually specify a particular PCRE installation directory that PostGIS will build against.
ja: <link xlink:href="http://www.pcre.org/">PCRE</link>は、BSDライセンスのPerl互換正規表現ライブラリです。住所標準化エクステンションに必須です。PostGISのビルド対象としている特定のPCREを手動で指定する場合に、このパラメータ (<command>--with-pcredir=/path/to/pcredir</command>)を使います。

note: Tag: para
en: Compile the data import GUI (requires GTK+2.0). This will create shp2pgsql-gui graphical interface to shp2pgsql.
ja: データインポートGUI (GTK+2.0が必要)をコンパイルします。このパラメータによって、shp2pgsql-guiという、shp2pgsqlのグラフィカルユーザインタフェースが作成されます。

note: Tag: para
en: Compile without raster support.
ja: ラスタ機能なしでコンパイルします。

note: Tag: para
en: Disable topology support. There is no corresponding library as all logic needed for topology is in postgis-&last_release_version; library.
ja: トポロジ対応を無くしてコンパイルします。トポロジに必要なロジックは全てpostgis-&last_release_version;ライブラリ内に作られるので、関連ライブラリはありません。

note: Tag: para
en: By default PostGIS will try to detect gettext support and compile with it, however if you run into incompatibility issues that cause breakage of loader, you can disable it entirely with this command. Refer to ticket <link xlink:href="http://trac.osgeo.org/postgis/ticket/748">http://trac.osgeo.org/postgis/ticket/748</link> for an example issue solved by configuring with this. NOTE: that you aren't missing much by turning this off. This is used for international help/label support for the GUI loader which is not yet documented and still experimental.
ja: デフォルトでは、gettextの検出とこれを用いたコンパイルを試みますが、ローダ破損を引き起こす非互換性問題のもとで実行する場合には、このコマンドで無効にできます。これを使ったコンフィギュレーションによって解決する問題の例は<link xlink:href="http://trac.osgeo.org/postgis/ticket/748">http://trac.osgeo.org/postgis/ticket/748</link>にあります。ご注意: これを切ることで多くの機能がなくなるわけではありません。まだ文書化されていなくて試験段階であるGUIローダにおける内部のヘルプ/ラベル機能に使われています。

note: Tag: para
en: By default PostGIS will not install with sfcgal support without this switch. <varname>PATH</varname> is an optional argument that allows to specify an alternate PATH to sfcgal-config.
ja: デフォルトでは、このスイッチなしではSFCGAL対応でインストールされません。<varname>PATH</varname>は、sfcgal-configへのパスを指定することができる追加的な引数です。

note: Tag: para
en: Disable updating postgis_revision.h to match current HEAD of the git repository.
ja: Gitレポジトリの現在のHEADに一致するように、postgis_revision.hの更新を無効にします。

note: Tag: para
en: If you obtained PostGIS from the <link xlink:href="https://trac.osgeo.org/postgis/wiki/CodeRepository"> code repository </link> , the first step is really to run the script
ja: PostGISを<link xlink:href="https://trac.osgeo.org/postgis/wiki/CodeRepository">コードレポジトリ</link>から得る場合には、はじめに次のスクリプトを実行します。

note: Tag: para
en: This script will generate the <command>configure</command> script that in turn is used to customize the installation of PostGIS.
ja: このスクリプトによって<command>configure</command>スクリプトが生成されます。これはPostGISのインストールに関するカスタマイズに使われます。

note: Tag: para
en: If you instead obtained PostGIS as a tarball, running <command>./autogen.sh</command> is not necessary as <command>configure</command> has already been generated.
ja: PostGISをアーカイブファイルで入手する場合には、<command>configure</command>が既に生成されているので<command>./autogen.sh</command>は不要です。

note: Tag: title
en: Building
ja: ビルド

note: Tag: para
en: Once the Makefile has been generated, building PostGIS is as simple as running
ja: Makefileが生成されたら、PostGISのビルドは、次のコマンドを実行するだけです。

note: Tag: para
en: The last line of the output should be "<code>PostGIS was built successfully. Ready to install.</code>"
ja: 出力の最後の行に"<code>PostGIS was built successfully. Ready to install.</code>"と出れば終わりです。

note: Tag: para
en: As of PostGIS v1.4.0, all the functions have comments generated from the documentation. If you wish to install these comments into your spatial databases later, run the command which requires docbook. The postgis_comments.sql and other package comments files raster_comments.sql, topology_comments.sql are also packaged in the tar.gz distribution in the doc folder so no need to make comments if installing from the tar ball. Comments are also included as part of the CREATE EXTENSION install.
ja: PostGIS 1.4.0版からは、全ての関数に文書から生成されるコメントが付きます。これらのコメントを後からインストールするには、次のコマンドを実行しますが、docbookが必要です。アーカイブファイルからインストールする場合は、postgis_comments.sql, raster_comments.sql, topology_comments.sqlは、docフォルダにあるので、コメントを作成する必要はありません。コメントはCREATE EXTENSIONによるインストールの一部として取り込まれます。

note: Tag: para
en: Introduced in PostGIS 2.0. This generates html cheat sheets suitable for quick reference or for student handouts. This requires xsltproc to build and will generate 4 files in doc folder <filename>topology_cheatsheet.html</filename>, <filename>tiger_geocoder_cheatsheet.html</filename>, <filename>raster_cheatsheet.html</filename>, <filename>postgis_cheatsheet.html</filename>
ja: PostGIS 2.0で導入されました。早見表にも、また学習中の方のハンドアウトにも適しているHTMLチートシートを生成します。xsltprocが必要で、<filename>topology_cheatsheet.html</filename>, <filename>tiger_geocoder_cheatsheet.html</filename>, <filename>raster_cheatsheet.html</filename>, <filename>postgis_cheatsheet.html</filename>の4ファイルが生成されます。

note: Tag: para
en: You can download some pre-built ones available in html and pdf from <link xlink:href="http://www.postgis.us/study_guides">PostGIS / PostgreSQL Study Guides</link>
ja: HTMLとPDFのビルド済みのものは<link xlink:href="http://www.postgis.us/study_guides">PostGIS / PostgreSQL Study Guides</link>にあります。

note: Tag: title
en: Building PostGIS Extensions and Deploying them
ja: PostGISエクステンションのビルドとデプロイ

note: Tag: para
en: The PostGIS extensions are built and installed automatically if you are using PostgreSQL 9.1+.
ja: PostgreSQL 9.1以上を使用している場合は、PostGISエクステンションが自動的にビルド、インストールされます。

note: Tag: para
en: If you are building from source repository, you need to build the function descriptions first. These get built if you have docbook installed. You can also manually build with the statement:
ja: ソースレポジトリからビルドしている場合は、関数の記述を最初にビルドする必要があります。これらは、docbookがインストールされている時にビルドされます。手動でインストールするには次のようにします。

note: Tag: para
en: Building the comments is not necessary if you are building from a release tar ball since these are packaged pre-built with the tar ball already.
ja: アーカイブファイルからのビルドの場合は、ビルド済みのものがあるので、コメントのビルドは必須ではありません。

note: Tag: para
en: The extensions should automatically build as part of the make install process. You can if needed build from the extensions folders or copy files if you need them on a different server.
ja: PostgreSQL 9.1を対象にビルドしている場合は、エクステンションは自動的にmake install処理の一部としてビルドするべきです。必要ならextensionsフォルダからビルドできますし、他のサーバで必要ならファイルの複製ができます。

note: Tag: para
en: <code>make check</code> uses psql to run tests and as such can use psql environment variables. Common ones useful to override are <varname>PGUSER</varname>,<varname>PGPORT</varname>, and <varname>PGHOST</varname>. Refer to <link xlink:href="https://www.postgresql.org/docs/current/libpq-envars.html">psql environment variables</link>
ja: <code>make check</code>は、テスト実行のためにpsqlを使用し、psql環境変数を使用します。一般的なpsql環境変数で上書きすると便利なのが <varname>PGUSER</varname>,<varname>PGPORT</varname>, and <varname>PGHOST</varname>です。<link xlink:href="https://www.postgresql.org/docs/current/libpq-envars.html">環境変数</link>を参照して下さい。

note: Tag: para
en: The extension files will always be the same for the same version of PostGIS and PostgreSQL regardless of OS, so it is fine to copy over the extension files from one OS to another as long as you have the PostGIS binaries already installed on your servers.
ja: エクステンションファイルは、常に、OSに関係なく同じ版のPostGISでは同じです。PostGISバイナリを既にインストールしている限りは、エクステンションファイルをあるOSから別のものに複写して大丈夫です。

note: Tag: para
en: If you want to install the extensions manually on a separate server different from your development, You need to copy the following files from the extensions folder into the <filename>PostgreSQL / share / extension</filename> folder of your PostgreSQL install as well as the needed binaries for regular PostGIS if you don't have them already on the server.
ja: 開発用と異なる別のサーバでエクステンションを手動でインストールしたい場合は、サーバにない時に必要となる通常のPostGISのバイナリだけでなく、次のファイルをextensionsフォルダからPostgreSQLインストール先の<filename>PostgreSQL / share / extension</filename>フォルダに複写します。

note: Tag: para
en: These are the control files that denote information such as the version of the extension to install if not specified. <filename>postgis.control, postgis_topology.control</filename>.
ja: 指定されていない場合のインストールするエクステンションの版等の情報を示す制御ファイ<filename>postgis.control, postgis_topology.control</filename>。

note: Tag: para
en: All the files in the /sql folder of each extension. Note that these need to be copied to the root of the PostgreSQL share/extension folder <filename>extensions/postgis/sql/*.sql</filename>, <filename>extensions/postgis_topology/sql/*.sql</filename>
ja: エクステンションごとの/sqlフォルダにあるファイル全て。<filename>extensions/postgis/sql/*.sql</filename>, <filename>extensions/postgis_topology/sql/*.sql</filename>はPostgreSQL share/extensionフォルダの最上位に複写する必要があることに注意して下さい。

note: Tag: para
en: Once you do that, you should see <varname>postgis</varname>, <varname>postgis_topology</varname> as available extensions in PgAdmin -&gt; extensions.
ja: 以上を実行すると、PgAdmin -&gt; extensionで<varname>postgis</varname>, <varname>postgis_topology</varname>が有効なエクステンションとして見えます。

note: Tag: para
en: If you are using psql, you can verify that the extensions are installed by running this query:
ja: psqlを使う場合は、次のクエリを実行してエクステンションがインストールされていることを確認できます。

note: Tag: para
en: If you have the extension installed in the database you are querying, you'll see mention in the <varname>installed_version</varname> column. If you get no records back, it means you don't have postgis extensions installed on the server at all. PgAdmin III 1.14+ will also provide this information in the <varname>extensions</varname> section of the database browser tree and will even allow upgrade or uninstall by right-clicking.
ja: クエリを行ったデータベースにエクステンションがインストールされている場合は、<varname>installed_version</varname>カラムに記載が見えます。レコードが返ってこない場合は、PostGIS EXTENSIONがインストールされていないことになります。PgAdmin III 1.14以上では、データベースブラウザツリーの<varname>extensions</varname>セクションで提供されていて、右クリックでアップグレードまたアンインストールできます。

note: Tag: para
en: If you have the extensions available, you can install postgis extension in your database of choice by either using pgAdmin extension interface or running these sql commands:
ja: 有効なエクステンションがある場合、pgAdminエクステンションインタフェースまたは次のSQLの実行によって、選択したデータベースにPostGISエクステンションをインストールできます。

note: Tag: para
en: In psql you can use to see what versions you have installed and also what schema they are installed.
ja: psqlでは、どの版が、どのスキーマにインストールされているかを見ることができます。

note: Tag: para
en: Extension tables <varname>spatial_ref_sys</varname>, <varname>layer</varname>, <varname>topology</varname> can not be explicitly backed up. They can only be backed up when the respective <varname>postgis</varname> or <varname>postgis_topology</varname> extension is backed up, which only seems to happen when you backup the whole database. As of PostGIS 2.0.1, only srid records not packaged with PostGIS are backed up when the database is backed up so don't go around changing srids we package and expect your changes to be there. Put in a ticket if you find an issue. The structures of extension tables are never backed up since they are created with <code>CREATE EXTENSION</code> and assumed to be the same for a given version of an extension. These behaviors are built into the current PostgreSQL extension model, so nothing we can do about it.
ja: エクステンションのテーブル<varname>spatial_ref_sys</varname>, <varname>layer</varname>, <varname>topology</varname>は、明示的にバックアップできません。それぞれの<varname>postgis</varname>または<varname>postgis_topology</varname>エクステンションがバックアップされる時のみバックアップできます。これは、データベース全体のバックアップの時のみ行われます。PostGIS 2.0.1の時点では、データベースがバックアップされる際に、PostGISでパッケージ化されていないsridレコードのみバックアップされます。パッケージに入っているsridの変更は巡回せず、変更はそこにあるものと期待されます。PostGIS 2.0.1の時点では、データベースがバックアップされるときにPostGISに入っていないsridのレコードだけがバックアップされます。PostGISに入っていて後に変更されたsridの変更については巡回しません。問題が見られたら、チケットを発行して下さい。エクステンションテーブルの構造は<code>CREATE EXTENSION</code>で生成されるので、バックアップを行いません。エクステンションの与えられた版と同じものであると仮定されます。この挙動は現在のPostgreSQL エクステンションモデルに組み込まれているため、これについては何もできません。

note: Tag: para
en: If you installed &last_release_version;, without using our wonderful extension system, you can change it to be extension based by running the below commands to package the functions in their respective extension. Installing using `unpackaged` was removed in PostgreSQL 13, so you are advised to switch to an extension build before upgrading to PostgreSQL 13.
ja: 素晴らしいエクステンション機構を使わずに&last_release_version;をインストールした場合には、それぞれのエクステンションが持つ関数をパッケージするためのコマンドを実行して、エクステンションに基づくように変更できます。PostgreSQL 13では、パッケージしない方法でのインストールは削除されましたので、PostgreSQL 13にアップグレードする前にエクステンションをビルドするように変更するべきです。

note: Tag: title
en: Testing
ja: テスト

note: Tag: para
en: If you wish to test the PostGIS build, run
ja: PostGISのテストを行うには、次のコマンドを実行します。

note: Tag: para
en: The above command will run through various checks and regression tests using the generated library against an actual PostgreSQL database.
ja: このコマンドで、実際のPostgreSQLデータベースに対して生成したライブラリを使用した、様々なチェックとレグレッションテストを行います。

note: Tag: para
en: If you configured PostGIS using non-standard PostgreSQL, GEOS, or Proj locations, you may need to add their library locations to the <varname>LD_LIBRARY_PATH</varname> environment variable.
ja: PostgreSQL, GEOS または Proj を標準の位置にインストールしていない場合には、環境変数<varname>LD_LIBRARY_PATH</varname>に、ライブラリの位置を追加する必要があるかも知れません。

note: Tag: para
en: Currently, the <command>make check</command> relies on the <code>PATH</code> and <code>PGPORT</code> environment variables when performing the checks - it does <emphasis>not</emphasis> use the PostgreSQL version that may have been specified using the configuration parameter <command>--with-pgconfig</command>. So make sure to modify your PATH to match the detected PostgreSQL installation during configuration or be prepared to deal with the impending headaches.
ja: 現在のところ<command>make check</command>は、チェックを行う際に 環境変数<code>PATH</code>と<code>PGPORT</code>によっています。コンフィギュレーションパラメータ<command>--with-pgconfig</command>を使って特定したPostgreSQLでは<emphasis>ありません</emphasis>。PATHを編集して、コンフィギュレーションの際に検出したPostgreSQLと一致するようにして下さい。もしくは、間もなく襲ってくる頭痛の準備をしておいて下さい。

note: Tag: para
en: If successful, make check will produce the output of almost 500 tests. The results will look similar to the following (numerous lines omitted below):
ja: 成功したなら、make checkで約500個のテストを生成します。結果は次のようなかんじになります (かなりの行を省略しています)。

note: Tag: para
en: The <varname>postgis_tiger_geocoder</varname> and <varname>address_standardizer</varname> extensions, currently only support the standard PostgreSQL installcheck. To test these use the below. Note: the make install is not necessary if you already did make install at root of PostGIS code folder.
ja: <varname>postgis_tiger_geocoder</varname>と<varname>address_standardizer</varname>エクステンションは、現在は、標準的なPostgreSQLインストールチェックにのみ対応しています。これらをテストするには、次のようにします。ご注意: PostGISコードフォルダのルートでmake installを既に行っている場合には、make installは重要ではありません。

note: Tag: para
en: For address_standardizer:
ja: address_standardizer用:

note: Tag: para
en: Output should look like:
ja: 出力は次のようなかんじになります。

note: Tag: para
en: For tiger geocoder, make sure you have postgis and fuzzystrmatch extensions available in your PostgreSQL instance. The address_standardizer tests will also kick in if you built postgis with address_standardizer support:
ja: Tiger Geocodeを使う場合には、使用するPostgreSQLインスタンス内にPostGISとfuzzystrmatchのエクステンションが必要です。PostGISをaddress_standardizer機能付きでビルドした場合は、address_standardizerのテストも行います。

note: Tag: para
en: output should look like:
ja: 出力は次のようなかんじになります。

note: Tag: title
en: Installation
ja: インストール

note: Tag: para
en: To install PostGIS, type
ja: PostGISをインストールするには、次のコマンドを実行します。

note: Tag: para
en: This will copy the PostGIS installation files into their appropriate subdirectory specified by the <command>--prefix</command> configuration parameter. In particular:
ja: これにより、PostGISのインストールファイルが、<command>--prefix</command>パラメータで指定した、適切なサブディレクトリに複写されます。次に特筆すべきサブディレクトリを示します。

note: Tag: para
en: The loader and dumper binaries are installed in <filename>[prefix]/bin</filename>.
ja: ローダとダンパのバイナリのインストール先は<filename>[prefix]/bin</filename>です。

note: Tag: para
en: The SQL files, such as <filename>postgis.sql</filename>, are installed in <filename>[prefix]/share/contrib</filename>.
ja: <filename>postgis.sql</filename>などのSQLファイルのインストール先は<filename>[prefix]/share/contrib</filename>です。

note: Tag: para
en: The PostGIS libraries are installed in <filename>[prefix]/lib</filename>.
ja: PostGISライブラリのインストール先は<filename>[prefix]/lib</filename>です。

note: Tag: para
en: If you previously ran the <command>make comments</command> command to generate the <filename>postgis_comments.sql</filename>, <filename>raster_comments.sql</filename> file, install the sql file by running
ja: 先に<command>make comments</command>を実行して<filename>postgis_comments.sql</filename>, <filename>raster_comments.sql</filename>を生成していた場合は、次のコマンドを実行すると、これらのSQLファイルがインストールされます。

note: Tag: para
en: <filename>postgis_comments.sql</filename>, <filename>raster_comments.sql</filename>, <filename>topology_comments.sql</filename> was separated from the typical build and installation targets since with it comes the extra dependency of <command>xsltproc</command>.
ja: <filename>postgis_comments.sql</filename>, <filename>raster_comments.sql</filename>, <filename>topology_comments.sql</filename>は、<command>xsltproc</command>の外部依存ができたので、通常のビルドとインストールから切り離されました。

note: Tag: title
en: Installing and Using the address standardizer
ja: PAGC住所標準化ツールのインストールと使用

note: Tag: para
en: The <code>address_standardizer</code> extension used to be a separate package that required separate download. From PostGIS 2.2 on, it is now bundled in. For more information about the address_standardize, what it does, and how to configure it for your needs, refer to <xref linkend="Address_Standardizer"/>.
ja: <code>address_standardizer</code>エクステンションは、別途ダウンロードする必要がある別パッケージとしていました。PostGIS 2.2からは同梱されています。address_standardizeの追加情報、できること、および、コンフィギュレーション方法については、<xref linkend="Address_Standardizer"/>をご覧下さい。

note: Tag: para
en: This standardizer can be used in conjunction with the PostGIS packaged tiger geocoder extension as a replacement for the <xref linkend="Normalize_Address"/> discussed. To use as replacement refer to <xref linkend="tiger_pagc_address_standardizing"/>. You can also use it as a building block for your own geocoder or use it to standardize your addresses for easier compare of addresses.
ja: 標準化エクステンションは、<xref linkend="Normalize_Address"/>の後継で、PostGISに入っているTigerジオコーダエクステンションに使うことができます。この場合の使い方については<xref linkend="tiger_pagc_address_standardizing"/>を参照して下さい。また、ユーザ自身がつくるジオコーダの要素として使用したり、住所の比較を簡単にするために住所を標準化するために使うことができます。

note: Tag: para
en: The address standardizer relies on PCRE which is usually already installed on many Nix systems, but you can download the latest at: <link xlink:href="http://www.pcre.org">http://www.pcre.org</link>. If during <xref linkend="installation_configuration"/>, PCRE is found, then the address standardizer extension will automatically be built. If you have a custom pcre install you want to use instead, pass to configure <code>--with-pcredir=/path/to/pcre</code> where <filename>/path/to/pcre</filename> is the root folder for your pcre include and lib directories.
ja: 住所標準化エクステンションはPCREに依存しています。PCREは多くのUNIX系システムにインストールされていますが、<link xlink:href="http://www.pcre.org">http://www.pcre.org</link>から最新版をダウンロードできます。<xref linkend="installation_configuration"/>の際にPCREを発見すると、住所標準化エクステンションが自動的にビルドされます。使用したいPCREのインストールが独自なものである場合は、configureに<code>--with-pcredir=/path/to/pcre</code>を渡します。<filename>/path/to/pcre</filename>は、PCREのincludeとlibのあるルートフォルダです。

note: Tag: para
en: For Windows users, the PostGIS 2.1+ bundle is packaged with the address_standardizer already so no need to compile and can move straight to <code>CREATE EXTENSION</code> step.
ja: Windowsでは、PostGIS 2.1以上に住所標準化エクステンションが同梱されているので、コンパイルを行わずに、すぐに<code>CREATE EXTENSION</code>に行くことができます。

note: Tag: para
en: Once you have installed, you can connect to your database and run the SQL:
ja: インストールしたら、対象データベースに接続して次のSQLが実行できます。

note: Tag: para
en: The following test requires no rules, gaz, or lex tables
ja: 次のテストでは、rules, gaz, lexテーブルは必要ありません。

note: Tag: para
en: Output should be
ja: 出力は次のようになります。

note: Tag: title
en: Installing, Upgrading Tiger Geocoder, and loading data
ja: Tigerジオコーダのインストールとアップグレードとデータロード

note: Tag: para
en: Extras like Tiger geocoder may not be packaged in your PostGIS distribution. If you are missing the tiger geocoder extension or want a newer version than what your install comes with, then use the <filename>share/extension/postgis_tiger_geocoder.*</filename> files from the packages in <link xlink:href="http://postgis.net/windows_downloads/">Windows Unreleased Versions</link> section for your version of PostgreSQL. Although these packages are for windows, the postgis_tiger_geocoder extension files will work on any OS since the extension is an SQL/plpgsql only extension.
ja: Tigerジオコーダのような拡張機能はPostGISディストリビューションに同梱されていません。Tigerジオコーダエクステンションが無かったり、インストールしているものより新しい版のものが欲しい場合には、<link xlink:href="http://postgis.net/windows_downloads/">Windows Unreleased Versions</link>でPostgreSQLの版に合ったパッケージにある<filename>share/extension/postgis_tiger_geocoder.*</filename>ファイルを使います。これらのパッケージはWindows用ですが、postgis_tige_geocoderエクステンションファイルは、SQLとPL/pgSQLだけですので、他のOSでも動作します。

note: Tag: title
en: Tiger Geocoder Enabling your PostGIS database
ja: TigerジオコーダをPostGISデータベースで有効にする

note: Tag: para
en: These directions assume your PostgreSQL installation already has the postgis_tiger_geocoder extension installed.
ja: ここの説明では、お手持ちのPostgreSQLにpostgis_tiger_geocoderエクステンションがインストールされていると仮定します。

note: Tag: para
en: Connect to your database via psql or pgAdmin or some other tool and run the following SQL commands. Note that if you are installing in a database that already has postgis, you don't need to do the first step. If you have <varname>fuzzystrmatch</varname> extension already installed, you don't need to do the second step either.
ja: psql、pgAdminまたは他のツールでデータベースに接続して、次のSQLコマンドを実行します。既にPostGISを持っているデータベースにインストールする場合は、一つ目の手順は不要です。<varname>fuzzystrmatch</varname>エクステンションが既にインストールされている場合は、二つ目の手順は不要です。

note: Tag: para
en: If you already have postgis_tiger_geocoder extension installed, and just want to update to the latest run:
ja: 既にpostgis_tiger_geocoderエクステンションをインストールしていて、最新版に更新するだけの場合には、次を実行します。

note: Tag: para
en: If you made custom entries or changes to <varname>tiger.loader_platform</varname> and <varname>tiger.loader_variables</varname> you may need to update these.
ja: 独自のエントリを生成した場合や、<varname>tiger.loader_platform</varname>と<varname>tiger.loader_variables</varname>に変更を加えた場合には、これらをアップデートしなければならないことがあります。

note: Tag: para
en: To confirm your install is working correctly, run this sql in your database:
ja: 正しくインストールされたかを確認するために、インストール対象データベース内で次のSQLを実行します。

note: Tag: para
en: Which should output
ja: 出力は次のようになります。

note: Tag: para
en: Create a new record in <varname>tiger.loader_platform</varname> table with the paths of your executables and server.
ja: <varname>tiger.loader_platform</varname>テーブルの、実行ファイルやサーバのパスを持つ新しいレコードを生成します。

note: Tag: para
en: So for example to create a profile called debbie that follows <code>sh</code> convention. You would do:
ja: <code>sh</code>コンベンションのあとにdebbieというプロファイルを生成する例として、次のコマンドを実行します。

note: Tag: para
en: And then edit the paths in the <emphasis>declare_sect</emphasis> column to those that fit Debbie's pg, unzip,shp2pgsql, psql, etc path locations.
ja: それから、<emphasis>declare_sect</emphasis>カラム内のパスを編集して、Debbieのpg, unzip, shp2pgsql, psql他のパス位置に適応するようにします。

note: Tag: para
en: If you don't edit this <varname>loader_platform</varname> table, it will just contain common case locations of items and you'll have to edit the generated script after the script is generated.
ja: <varname>loader_platform</varname>テーブルを編集しない場合は、一般的なアイテムの位置を持っているので、スクリプトが生成された後で、スクリプトを編集しなければなりません。

note: Tag: para
en: As of PostGIS 2.4.1 the Zip code-5 digit tabulation area <varname>zcta5</varname> load step was revised to load current zcta5 data and is part of the <xref linkend="Loader_Generate_Nation_Script"/> when enabled. It is turned off by default because it takes quite a bit of time to load (20 to 60 minutes), takes up quite a bit of disk space, and is not used that often.
ja: PostGIS 2.4.1からは、<varname>ZTCA5</varname> (Zip Code 5 digit Tabulation Area)のロード手順が変更され、有効になった時に<xref linkend="Loader_Generate_Nation_Script"/>の一部として現在のZCTA5データをロードするようになりました。デフォルトでは切られています。ロードにかなりの時間 (20から60分)が取られ、かなりのディスクスペースを占有するのに、そんなに頻繁には使わないためです。

note: Tag: para
en: To enable it, do the following:
ja: 有効にするには、次のようにします。

note: Tag: para
en: If present the <xref linkend="Geocode"/> function can use it if a boundary filter is added to limit to just zips in that boundary. The <xref linkend="Reverse_Geocode"/> function uses it if the returned address is missing a zip, which often happens with highway reverse geocoding.
ja: 境界のフィルタが追加され、ちょうど境界内のZIPに制限された場合に、<xref linkend="Geocode"/>関数は、ZCTA5が存在するなら使います。<xref linkend="Reverse_Geocode"/>関数は、返された住所にZIPコードが無い場合に (しばしば高速道路での逆ジオコーディングで発生します)、これを使います。

note: Tag: para
en: Create a folder called <filename>gisdata</filename> on root of server or your local pc if you have a fast network connection to the server. This folder is where the tiger files will be downloaded to and processed. If you are not happy with having the folder on the root of the server, or simply want to change to a different folder for staging, then edit the field <varname>staging_fold</varname> in the <varname>tiger.loader_variables</varname> table.
ja: サーバまたはローカル (サーバへのネットワーク接続が早い場合)のルートに<filename>gisdata</filename>というフォルダを作成します。このフォルダはTigerファイルがダウンロードされ、処理される場所です。サーバのルートにフォルダを作ると不幸になる場合や、単に他のフォルダに移したい場合には、<varname>tiger.loader_variables</varname>テーブルの<varname>staging_fold</varname>フィールドを編集します。

note: Tag: para
en: Create a folder called temp in the <filename>gisdata</filename> folder or wherever you designated the <varname>staging_fold</varname> to be. This will be the folder where the loader extracts the downloaded tiger data.
ja: <filename>gisdata</filename>フォルダ内にtempというフォルダを作成します。もしくは、<varname>staging_fold</varname>で示されたフォルダを作成します。ローダがダウンロードしたTigerデータを展開する場所です。

note: Tag: para
en: Then run the <xref linkend="Loader_Generate_Nation_Script"/> SQL function make sure to use the name of your custom profile and copy the script to a .sh or .bat file. So for example to build the nation load:
ja: そして、SQL関数<xref linkend="Loader_Generate_Nation_Script"/>を実行して、独自のプロファイルの名前を使うか確認し、.shまたは.batファイルにスクリプトを複写します。たとえば、新しいプロファイルで国のロードを行う場合には、次のようにします。

note: Tag: para
en: Run the generated nation load commandline scripts.
ja: 生成された国データをロードするコマンドラインスクリプトを実行します。

note: Tag: para
en: After you are done running the nation script, you should have three tables in your <code>tiger_data</code> schema and they should be filled with data. Confirm you do by doing the following queries from psql or pgAdmin
ja: 国スクリプトを実行した後、<code>tiger_data</code>スキーマに三つのテーブルが作られ、データが格納されています。次のクエリをpsqlかpgAdminから実行して、確認します。

note: Tag: para
en: This will only have data if you marked zcta5 to be loaded
ja: これはロードするzcta5に印を付けたデータだけが含まれます

note: Tag: para
en: By default the tables corresponding to <varname>bg</varname>, <varname>tract</varname>, <varname>tabblock20</varname> are not loaded. These tables are not used by the geocoder but are used by folks for population statistics. If you wish to load them as part of your state loads, run the following statement to enable them.
ja: デフォルトでは<varname>bg</varname>, <varname>tract</varname>, <varname>tabblock20</varname>に対応するテーブルはロードされません。ジオコーダはこれらのテーブルを使いませんが、一般に、人口統計に使います。州データのロードの一部としてロードするには、次の手続きを実行して有効にします。

note: Tag: para
en: Alternatively you can load just these tables after loading state data using the <xref linkend="Loader_Generate_Census_Script"/>
ja: もしくは、<xref linkend="Loader_Generate_Census_Script"/>を使って州のデータをロードした後に、これらのテーブルだけをロードできます。

note: Tag: para
en: DO NOT Generate the state script until you have already loaded the nation data, because the state script utilizes county list loaded by nation script.
ja: 国データのロードを完了する前に*州スクリプトを作ってはなりません*。州スクリプトは国スクリプトでロードされる国リストを利用するためです。

note: Tag: para
en: For each state you want to load data for, generate a state script <xref linkend="Loader_Generate_Script"/>.
ja: データをロードしたい州ごとに、<xref linkend="Loader_Generate_Script"/>で州スクリプトを作ります。

note: Tag: para
en: Run the generated commandline scripts.
ja: 生成されたコマンドラインスクリプトを実行します。

note: Tag: para
en: After you are done loading all data or at a stopping point, it's a good idea to analyze all the tiger tables to update the stats (include inherited stats)
ja: 全てのデータのロードが完了するか中断ポイントに達した後に、全てのtigerテーブルに対してanalyzeを実行して、(継承されたものも含めて)状態を更新するのは良いことです。

note: Tag: title
en: Using Address Standardizer Extension with Tiger geocoder
ja: TigerジオコーダをPostGISデータベースで有効にする: エクステンションを使用

note: Tag: para
en: One of the many complaints of folks is the address normalizer function <xref linkend="Normalize_Address"/> function that normalizes an address for prepping before geocoding. The normalizer is far from perfect and trying to patch its imperfectness takes a vast amount of resources. As such we have integrated with another project that has a much better address standardizer engine. To use this new address_standardizer, you compile the extension as described in <xref linkend="installing_pagc_address_standardizer"/> and install as an extension in your database.
ja: 皆さんが問題と思われるの多くのことのひとつに、ジオコーディング前の準備に住所を正規化する関数<xref linkend="Normalize_Address"/>があります。住所正規化は万全と言うにはほど遠く、パッチをあてようとすると膨大な資源を費やします。よって、より良い住所標準化エンジンを持つ他のプロジェクトに統合しました。この新しい住所標準化を使うには、<xref linkend="installing_pagc_address_standardizer"/>で記述するようにエクステンションをコンパイルし、使用するデータベースにインストールします。

note: Tag: para
en: Once you install this extension in the same database as you have installed <code>postgis_tiger_geocoder</code>, then the <xref linkend="Pagc_Normalize_Address"/> can be used instead of <xref linkend="Normalize_Address"/>. This extension is tiger agnostic, so can be used with other data sources such as international addresses. The tiger geocoder extension does come packaged with its own custom versions of <xref linkend="rulestab"/> ( <code>tiger.pagc_rules</code>) , <xref linkend="gaztab"/> (<code>tiger.pagc_gaz</code>), and <xref linkend="lextab"/> (<code>tiger.pagc_lex</code>). These you can add and update to improve your standardizing experience for your own needs.
ja: このエクステンションを<code>postgis_tiger_geocoder</code>をインストールしているデータベースにインストールすると、<xref linkend="Pagc_Normalize_Address"/>を、<xref linkend="Normalize_Address"/>の代わりに使うことができます。このエクステンションはTigerジオコーダからは見えないので、国際的な住所といった他のデータソースでも使えます。Tigerジオコーダエクステンションは、その版の<xref linkend="rulestab"/> (<code>tiger.pagc_rules</code>), <xref linkend="gaztab"/> (<code>tiger.pagc_gaz</code>), <xref linkend="lextab"/> (<code>tiger.pagc_lex</code>)を同梱しています。これらは、必要に応じて標準化の改善のために追加や更新ができます。

note: Tag: title
en: Required tools for tiger data loading
ja: Tigerデータのロードに必要なツール

note: Tag: para
en: The load process downloads data from the census website for the respective nation files, states requested, extracts the files, and then loads each state into its own separate set of state tables. Each state table inherits from the tables defined in <varname>tiger</varname> schema so that its sufficient to just query those tables to access all the data and drop a set of state tables at any time using the <xref linkend="Drop_State_Tables_Generate_Script"/> if you need to reload a state or just don't need a state anymore.
ja: ロードプロセスによって、米センサスウェブサイトから個々の国ファイル、リクエストされた州のデータをダウンロードし、ファイルを展開し、個別の州をそれぞれの州テーブルの集合にロードします。各州のテーブルは、<varname>tiger</varname>スキーマで定義されたテーブルを継承しているので、これらのテーブルに対して全てのデータにアクセスするためのクエリを出すことができますし、州の再読み込みが必要となったり、州が必要ない場合には、<xref linkend="Drop_State_Tables_Generate_Script"/>で、いつでも州テーブルの集合を削除するクエリを出すことができます。

note: Tag: para
en: In order to be able to load data you'll need the following tools:
ja: データのロードを可能にするためには次のツールが必要です。

note: Tag: para
en: A tool to unzip the zip files from census website.
ja: センサスウェブサイトから取得するZIPファイルを展開するツール。

note: Tag: para
en: For Unix like systems: <varname>unzip</varname> executable which is usually already installed on most Unix like platforms.
ja: Unix系システムでは、<varname>unzip</varname>実行ファイルです。通常は、ほとんどのUnix系プラットフォームで既にインストールされています。

note: Tag: para
en: For Windows, 7-zip which is a free compress/uncompress tool you can download from <link xlink:href="http://www.7-zip.org/">http://www.7-zip.org/</link>
ja: Windowsでは7-zipです。<link xlink:href="http://www.7-zip.org/">http://www.7-zip.org/</link>からダウンロードできる無償の圧縮解凍ツールです。

note: Tag: para
en: <filename>shp2pgsql</filename> commandline which is installed by default when you install PostGIS.
ja: <filename>shp2pgsql</filename>コマンド。PostGISインストール時にデフォルトでインストールされます。

note: Tag: para
en: <filename>wget</filename> which is a web grabber tool usually installed on most Unix/Linux systems.
ja: <filename>wget</filename>コマンド。通常はほとんどのUnix/Linuxシステムにインストールされている、ウェブ取得ツールです。

note: Tag: para
en: If you are on windows, you can get pre-compiled binaries from <link xlink:href="http://gnuwin32.sourceforge.net/packages/wget.htm">http://gnuwin32.sourceforge.net/packages/wget.htm</link>
ja: Windows用については、コンパイル済みのバイナリを<link xlink:href="http://gnuwin32.sourceforge.net/packages/wget.htm">http://gnuwin32.sourceforge.net/packages/wget.htm</link>から取得できます。

note: Tag: para
en: If you are upgrading from tiger_2010, you'll need to first generate and run <xref linkend="Drop_Nation_Tables_Generate_Script"/>. Before you load any state data, you need to load the nation wide data which you do with <xref linkend="Loader_Generate_Nation_Script"/>. Which will generate a loader script for you. <xref linkend="Loader_Generate_Nation_Script"/> is a one-time step that should be done for upgrading (from a prior year tiger census data) and for new installs.
ja: tiger_2010からアップグレードする場合には、最初に<xref linkend="Drop_Nation_Tables_Generate_Script"/>を生成、実行する必要があります。どの州データもロードする前に、<xref linkend="Loader_Generate_Nation_Script"/>で全国的なデータをロードする必要があります。これによりローダスクリプトが生成されます。(以前の年のTiger国勢調査データからの)アップグレードや新規インストールで行う<xref linkend="Loader_Generate_Nation_Script"/>の回数は1回です。

note: Tag: para
en: To load state data refer to <xref linkend="Loader_Generate_Script"/> to generate a data load script for your platform for the states you desire. Note that you can install these piecemeal. You don't have to load all the states you want all at once. You can load them as you need them.
ja: 州データをロードするには、<xref linkend="Loader_Generate_Script"/>を参照して、手持ちのプラットフォームで動作する、求める州データをロードするデータロードスクリプトを生成します。州データはひとつずつダウンロードできることに注意して下さい。一度に必要な州の全てについてデータをロードする必要はありません。必要なだけダウンロードできます。

note: Tag: para
en: After the states you desire have been loaded, make sure to run the: <programlisting>SELECT install_missing_indexes();</programlisting> as described in <xref linkend="Install_Missing_Indexes"/>.
ja: 求める州データをロードした後は、<xref linkend="Install_Missing_Indexes"/>に示すように、<programlisting>SELECT install_missing_indexes();</programlisting>を実行するようにして下さい。

note: Tag: para
en: To test that things are working as they should, try to run a geocode on an address in your state using <xref linkend="Geocode"/>
ja: 行うべきことができたかをテストするために、<xref linkend="Geocode"/>を使用する州の中の住所についてジオコーダを実行してみます。

note: Tag: title
en: Upgrading your Tiger Geocoder Install and Data
ja: Tigerジオコーダとデータのアップグレード

note: Tag: para
en: First upgrade your postgis_tiger_geocoder extension as follows:
ja: まずpostgis_tiger_geocoderエクステンションを次のようにアップグレードします。

note: Tag: para
en: Next drop all nation tables and load up the new ones. Generate a drop script with this SQL statement as detailed in <xref linkend="Drop_Nation_Tables_Generate_Script"/>
ja: 次に、全ての国テーブルを削除し、新しい国テーブルをロードします。<xref linkend="Drop_Nation_Tables_Generate_Script"/>に詳細がある通り、このSQLステートメントを使った削除スクリプトを生成します。

note: Tag: para
en: Run the generated drop SQL statements.
ja: 生成した削除SQLステートメントを実行します。

note: Tag: para
en: Generate a nation load script with this SELECT statement as detailed in <xref linkend="Loader_Generate_Nation_Script"/>
ja: <xref linkend="Loader_Generate_Nation_Script"/>に詳細がある通り、このSELECTステートメントを使った削除スクリプトを生成します。

note: Tag: emphasis
en: For windows
ja: Windows向け

note: Tag: emphasis
en: For unix/linux
ja: Unix/Linux向け

note: Tag: para
en: Refer to <xref linkend="install_tiger_geocoder_extension"/> for instructions on how to run the generate script. This only needs to be done once.
ja: 生成スクリプトの実行方法に関する説明は、<xref linkend="install_tiger_geocoder_extension"/>を参照して下さい。これは一度だけ実行する必要があります。

note: Tag: para
en: You can have a mix of different year state tables and can upgrade each state separately. Before you upgrade a state you first need to drop the prior year state tables for that state using <xref linkend="Drop_State_Tables_Generate_Script"/>.
ja: 州テーブルで複数年分が混ざっていてもよく、また州ごとに分割してアップグレードできます。一つの州をアップグレードする前に、<xref linkend="Drop_State_Tables_Generate_Script"/>を使って、以前の年の州テーブルを削除する必要があります。

note: Tag: title
en: Common Problems during installation
ja: 共通の問題

note: Tag: para
en: There are several things to check when your installation or upgrade doesn't go as you expected.
ja: インストールやアップグレードが思うようにいかない時にチェックすることがいくつかあります。

note: Tag: para
en: Check that you have installed PostgreSQL &min_postgres_version; or newer, and that you are compiling against the same version of the PostgreSQL source as the version of PostgreSQL that is running. Mix-ups can occur when your (Linux) distribution has already installed PostgreSQL, or you have otherwise installed PostgreSQL before and forgotten about it. PostGIS will only work with PostgreSQL &min_postgres_version; or newer, and strange, unexpected error messages will result if you use an older version. To check the version of PostgreSQL which is running, connect to the database using psql and run this query:
ja: PostgreSQL &min_postgres_version;以上をインストールしているか、実行中のPostgreSQLと同じ版のソースでコンパイルしているか、をチェックします。(Linuxの)ディストリビューションによって既にPostgreSQLがインストールされている時や、 PostgreSQLを以前にインストールして忘れた場合に、 混乱が発生することがあります。PostGISはPostgreSQL &min_postgres_version;以上で動作します。古い版のものを使った場合には、おかしな予想外のエラーメッセージが表示されます。実行中のPostgreSQLの版をチェックするには、psqlを使ってデータベースを接続して、次のクエリを実行して下さい。

note: Tag: para
en: If you are running an RPM based distribution, you can check for the existence of pre-installed packages using the <command>rpm</command> command as follows: <command>rpm -qa | grep postgresql</command>
ja: RPMベースのディストリビューションを実行している場合、 プリインストールされたパッケージが存在するかのチェックは、<command>rpm</command> コマンドを使って<command>rpm -qa | grep postgresql</command>でチェックできます。

note: Tag: para
en: If your upgrade fails, make sure you are restoring into a database that already has PostGIS installed.
ja: アップグレードに失敗する場合、既にPostGISがインストールされているデータベースにリストアしているか確認して下さい。

note: Tag: para
en: Also check that configure has correctly detected the location and version of PostgreSQL, the Proj library and the GEOS library.
ja: また、コンフィギュアが正しくPostgreSQL、Proj4ライブラリ、GEOSライブラリのインストール先を検出したかチェックして下さい。

note: Tag: para
en: The output from configure is used to generate the <filename>postgis_config.h</filename> file. Check that the <varname>POSTGIS_PGSQL_VERSION</varname>, <varname>POSTGIS_PROJ_VERSION</varname> and <varname>POSTGIS_GEOS_VERSION</varname> variables have been set correctly.
ja: コンフィギュアからの出力で<filename>postgis_config.h</filename>ファイルが作られます。<varname>POSTGIS_PGSQL_VERSION</varname>、<varname>POSTGIS_PROJ_VERSION</varname>および<varname>POSTGIS_GEOS_VERSION</varname>変数が正しくセットされたかをチェックして下さい。

note: Tag: title
en: Introduction
ja: 導入

note: Tag: para
en: PostGIS is a spatial extension for the PostgreSQL relational database that was created by Refractions Research Inc, as a spatial database technology research project. Refractions is a GIS and database consulting company in Victoria, British Columbia, Canada, specializing in data integration and custom software development.
ja: PostGISは、PostgreSQLリレーショナルデータベースの空間拡張です。Refractions Research Incが、空間データベース技術の研究プロジェクトとして作成しました。Refractionsはカナダ・ブリティッシュコロンビア州・ビクトリアにある、データインテグレーションとカスタムソフトウェア開発に特化した、GISとデータベースのコンサルティング会社です。

note: Tag: para
en: PostGIS is now a project of the OSGeo Foundation and is developed and funded by many FOSS4G developers and organizations all over the world that gain great benefit from its functionality and versatility.
ja: PostGISは、現在ではOSGeo財団のプロジェクトです。多数のFOSS4G開発者とPostGISの機能と多彩さから大きな利益を得る世界中の企業が、PostGISの開発と資金提供を行っています。

note: Tag: para
en: The PostGIS project development group plans on supporting and enhancing PostGIS to better support a range of important GIS functionality in the areas of OGC and SQL/MM spatial standards, advanced topological constructs (coverages, surfaces, networks), data source for desktop user interface tools for viewing and editing GIS data, and web-based access tools.
ja: PostGISプロジェクトの開発グループは、PostGISが、OGCとSQL/MM空間標準の領域における重要なGIS機能、高度なトポロジ構築 (カバレッジ、サーフェス、ネットワーク)、GISデータの表示と編集を行うデスクトップユーザインタフェースツールのデータソース、およびウェブベースのアクセスツールのためのデータソースに、より良く対応するよう、サポートと機能強化を行う予定です。

note: Tag: title
en: Project Steering Committee
ja: プロジェクト運営委員会

note: Tag: para
en: The PostGIS Project Steering Committee (PSC) coordinates the general direction, release cycles, documentation, and outreach efforts for the PostGIS project. In addition the PSC provides general user support, accepts and approves patches from the general PostGIS community and votes on miscellaneous issues involving PostGIS such as developer commit access, new PSC members or significant API changes.
ja: PostGISプロジェクト運営委員会 (PostGIS Project Steering Committee, PSC)は、総合的な指示、リリースサイクル、ドキュメンテーション、支援活動に関する調整を行っています。また、委員会は、全体的なユーザサポート、PostGISコミュニティからのパッチの受け付けと適用、 開発者のコミットのアクセス、新しい委員、APIの重要な変更といった、PostGISを含む雑多な問題に関する投票を行っています。

note: Tag: para
en: MVT support, Bug fixing, Performance and stability improvements, GitHub curation, alignment of PostGIS with PostgreSQL releases
ja: MVT機能、誤り修正、パフォーマンスと安定性の向上、GitHubキュレーション、PostGISとPostgreSQLのリリースの調整

note: Tag: para
en: CI and website maintenance, Windows production and experimental builds, documentation, alignment of PostGIS with PostgreSQL releases, X3D support, TIGER geocoder support, management functions.
ja: 継続的インテグレーションとウェブサイトのメンテナンス、Windows版と試験版のビルド、ドキュメンテーション、PostgreSQLとの調整、X3D対応、Tiger Geocoder機能、関数管理。

note: Tag: term
en: Darafei Praliaskouski
ja: Darafei Praliaskouskiさん

note: Tag: para
en: Index improvements, bug fixing and geometry/geography function improvements, SFCGAL, raster, GitHub curation, and ci maintenance.
ja: インデックス改善、誤り修正とジオメトリ/ジオグラフィ関数の改善、SFCGAL、ラスタ、GitHubキュレーション、継続的インテグレーション対応。

note: Tag: term
en: Paul Ramsey (Chair)
ja: Paul Ramsey (委員長)

note: Tag: para
en: Co-founder of PostGIS project. General bug fixing, geography support, geography and geometry index support (2D, 3D, nD index and anything spatial index), underlying geometry internal structures, GEOS functionality integration and alignment with GEOS releases, alignment of PostGIS with PostgreSQL releases, loader/dumper, and Shapefile GUI loader.
ja: PostGISプロジェクトの副創始者。総合的なバグフィクス、ジオグラフィ機能、ジオグラフィとジオメトリのインデックス機能 (2次元,、3次元、n次元インデクスとあらゆる空間インデクス)、ジオメトリ内部構造、GEOS機能の統合とGEOSリリースとの調整、PostgreSQLのリリースとの調整、ローダ/ダンパ、シェープファイルGUIローダ。

note: Tag: para
en: Bug fixes and maintenance, ci maintenance, git mirror management, management functions, integration of new GEOS functionality and alignment with GEOS releases, topology support, and raster framework and low level API functions.
ja: 誤り修正とメンテナンス、継続的インテグレーション対応、gitミラーの管理、関数管理、GEOSの新機能の統合、GEOSリリースとの調整、トポロジ機能、ラスタフレームワークと低水準API関数。

note: Tag: title
en: Core Contributors Present
ja: 現在の中核貢献者

note: Tag: para
en: Distance function enhancements (including 3D distance and relationship functions) and additions, Tiny WKB (TWKB) output format and general user support
ja: 距離関数の強化 (3次元距離、関係関数を含む)と追加、Tiny WKB出力書式（TWKB）と一般的なユーザサポート。

note: Tag: para
en: SFCGAL enhancements and maintenance and ci support
ja: SFCGAL機能強化とメインテナンスと継続的インテグレーション対応

note: Tag: para
en: Geometry clustering function additions, other geometry algorithm enhancements, GEOS enhancements and general user support
ja: ジオメトリクラスタリング関数の追加、他のジオメトリアルゴリズムの強化、GEOSの強化、および全体のユーザ対応

note: Tag: para
en: GEOS enhancements and documentation
ja: GEOS機能強化と文書

note: Tag: para
en: MapBox Vector Tile, GeoBuf, and Flatgeobuf functions. Gitea testing and GitLab experimentation.
ja: MapBoxベクタタイル関数、GeoBuf関数、Flatgeobuf 関数。Giteaの試験とGitLabの実験。

note: Tag: para
en: Geometry Processing, PostgreSQL gist, general bug fixing
ja: ジオメトリ処理、PostgreSQL GiST、共通部の誤り修正

note: Tag: title
en: Core Contributors Past
ja: 過去の中核貢献者

note: Tag: para
en: Prior PSC Member. Raster development, integration with GDAL, raster loader, user support, general bug fixing, testing on various OS (Slackware, Mac, Windows, and more)
ja: 以前のPSCメンバ。ラスタ開あｈ津、GDALとの統合、ラスタローダ、ユーザ対応、共通部の誤り修正、様々なOS (Slackware、Mac、Windows等多数)での試験

note: Tag: para
en: Prior PSC Member. Coordinated bug fixing and maintenance effort, spatial index selectivity and binding, loader/dumper, and Shapefile GUI Loader, integration of new and new function enhancements.
ja: 以前のPSCメンバ。誤り修正とメンテナンスの活動、空間インデックス選択性とバインディング、ローダ/ダンパ、およびシェープファイルGUIローダの調整、新機能の統合と強化。

note: Tag: para
en: Raster development, GDAL driver support, loader
ja: ラスタ開発、GDALドライバ機能、ローダ。

note: Tag: para
en: (Emeritus) Input/output XML (KML,GML)/GeoJSON functions, 3D support and bug fixes.
ja: (名誉) XML (KML, GML)/GeoJSON入出力関数と3次元対応と誤り修正。

note: Tag: para
en: Prior PSC Member. General development, site and buildbot maintenance, OSGeo incubation management
ja: 以前のPSCメンバ。一般的な開発、サイトとBuildbotのメンテナンス、OSGeoインキュベーション管理。

note: Tag: para
en: CMake support for PostGIS, built original raster loader in python and low level raster API functions
ja: CMakeのPostGISへの対応、Python版のオリジナルのラスタローダと低級ラスタAPI関数の構築。

note: Tag: para
en: Prior PSC Member. Documentation and documentation support tools, buildbot maintenance, advanced user support on PostGIS newsgroup, and PostGIS maintenance function enhancements.
ja: 以前のPSCメンバ。文書と文書補助ツール、Buildbotのメンテナンス、PostGISニュースグループでの高度なユーザサポート、PostGISメンテナンス機能の強化。

note: Tag: para
en: The original developer/Co-founder of PostGIS. Dave wrote the server side objects, index bindings, and many of the server side analytical functions.
ja: PostGISのオリジナルの開発/副創始者。サーバサイドのオブジェクト、インデクスのバインディングや多数のサーバサイドの解析機能を記述。

note: Tag: para
en: Original development of the Shapefile loader/dumper.
ja: シェープファイルのローダ/ダンパのオリジナル開発者。

note: Tag: para
en: Ongoing maintenance and development of core functions. Enhanced curve support. Shapefile GUI loader.
ja: 中核機能の、継続的なメンテナンスと開発。曲線機能の強化。シェープファイルGUIローダ。

note: Tag: para
en: Architect of PostGIS raster implementation. Raster overall architecture, prototyping, programming support
ja: PostGISラスタ実装の設計。ラスタ全体のアーキテクチャ、プロトタイプ作成、プログラミング補助

note: Tag: para
en: Raster development (mostly map algebra analytic functions)
ja: ラスタ開発 (ほとんど地図代数解析関数)。

note: Tag: title
en: Other Contributors
ja: 他の貢献者

note: Tag: term
en: Individual Contributors
ja: 個人

note: Tag: term
en: Corporate Sponsors
ja: 企業

note: Tag: para
en: These are corporate entities that have contributed developer time, hosting, or direct monetary funding to the PostGIS project. In alphabetical order:
ja: これらは、PostGISプロジェクトに開発者の時間、ホスティング、または直接の資金提供のいずれかの貢献をした企業です。アルファベット順:

note: Tag: link
en: City of Boston (DND)
ja: ボストン市 (近隣地区開発局)

note: Tag: link
en: City of Helsinki
ja: ヘルシンキ市

note: Tag: link
en: Michigan Tech Research Institute
ja: ミシガン工科大学研究所

note: Tag: link
en: Natural Resources Canada
ja: カナダ天然資源省

note: Tag: simpara
en: Norwegian Forest and Landscape Institute
ja: ノルウェー森林景観研究所

note: Tag: link
en: Norwegian Institute of Bioeconomy Research (NIBIO)
ja: ノルウェー生物経済研究所 (NIBIO)

note: Tag: link
en: OSGeo
ja: OSGeo財団

note: Tag: link
en: Regione Toscana - SITA
ja: トスカナ州- SITA

note: Tag: link
en: Stadt Uster
ja: ウスター市

note: Tag: link
en: UC Davis Center for Vectorborne Diseases
ja: カリフォルニア大デービス校節足動媒介感染症センター

note: Tag: link
en: Université Laval
ja: ラヴァル大学

note: Tag: link
en: U.S. Department of State (HIU)
ja: 米国国務省 (人道情報部門)

note: Tag: term
en: Crowd Funding Campaigns
ja: クラウドファンディングキャンペーン

note: Tag: para
en: Crowd funding campaigns are campaigns we run to get badly wanted features funded that can service a large number of people. Each campaign is specifically focused on a particular feature or set of features. Each sponsor chips in a small fraction of the needed funding and with enough people/organizations contributing, we have the funds to pay for the work that will help many. If you have an idea for a feature you think many others would be willing to co-fund, please post to the <link xlink:href="https://lists.osgeo.org/mailman/listinfo/postgis-users">PostGIS newsgroup</link> your thoughts and together we can make it happen.
ja: クラウドファンディングキャンペーンは、PostGIS開発チームが走らせているキャンペーンです。欲しくて仕方ない機能に資金を与えて、多数の人々にサービスを提供できるようにするためのものです。それぞれのキャンペーンでは、特定の機能または機能の集合に焦点があてられます。それぞれのスポンサーは、必要な資金提供のうち少しだけを提供し、十分な人/組織の寄付で、たくさんの助けになる作業に支払う基金を持ちます。他の多くの人が寄付に協力してくれそうな機能に関するアイデアがありましたら、<link xlink:href="https://lists.osgeo.org/mailman/listinfo/postgis-users">PostGIS newsgroup</link>に、その考えを投稿して下さい。一緒に実現できます。

note: Tag: para
en: PostGIS 2.0.0 was the first release we tried this strategy. We used <link xlink:href="http://www.pledgebank.com">PledgeBank</link> and we got two successful campaigns out of it.
ja: PostGIS 2.0.0はこの戦略を実施する最初のリリースです。<link xlink:href="http://www.pledgebank.com">PledgeBank</link>を使い、2件のキャンペーンが成功しました。

note: Tag: para
en: <link xlink:href="http://www.pledgebank.com/postgistopology"><emphasis role="bold">postgistopology</emphasis></link> - 10 plus sponsors each contributed $250 USD to build toTopoGeometry function and beef up topology support in 2.0.0. It happened.
ja: <link xlink:href="http://www.pledgebank.com/postgistopology"><emphasis role="bold">postgistopology</emphasis></link> - 10以上のスポンサーがTopoGeometry機能の構築と2.0.0でのトポロジ対応強化とのために、それぞれ250米ドルを寄付しました。

note: Tag: para
en: <link xlink:href="http://www.pledgebank.com/postgis64windows"><emphasis role="bold">postgis64windows</emphasis></link> - 20 someodd sponsors each contributed $100 USD to pay for the work needed to work out PostGIS 64-bit issues on windows. It happened.
ja: <link xlink:href="http://www.pledgebank.com/postgis64windows"><emphasis role="bold">postgis64windows</emphasis></link> - 20のスポンサーが、Windows上でのPostGIS 64ビット版に必要な作業のために、それぞれ100米ドルを寄付しました。

note: Tag: term
en: Important Support Libraries
ja: 重要なサポートライブラリ

note: Tag: para
en: The <link xlink:href="https://libgeos.org">GEOS</link> geometry operations library
ja: ジオメトリ演算ライブラ <link xlink:href="https://libgeos.org">GEOS</link>

note: Tag: para
en: The <link xlink:href="https://gdal.org">GDAL</link> Geospatial Data Abstraction Library used to power much of the raster functionality introduced in PostGIS 2. In kind, improvements needed in GDAL to support PostGIS are contributed back to the GDAL project.
ja: 地理空間データ抽象化ライブラリ<link xlink:href="https://gdal.org">GDAL</link>は、PostGIS 2で導入されたラスタ機能の多くに使われています。また、GDALのPostGIS対応に必要な改善でGDALプロジェクトに貢献しています。

note: Tag: para
en: The <link xlink:href="https://www.proj4.org">PROJ</link> cartographic projection library
ja: 地図投影ライブラリ<link xlink:href="https://www.proj4.org">PROJ</link>

note: Tag: para
en: Last but not least, <link xlink:href="http://www.postgresql.org">PostgreSQL</link>, the giant that PostGIS stands on. Much of the speed and flexibility of PostGIS would not be possible without the extensibility, great query planner, GIST index, and plethora of SQL features provided by PostgreSQL.
ja: 最後ですがおろそかにできないのが<link xlink:href="http://www.postgresql.org">PostgreSQL</link>です。PostGISはこの巨人に立っています。PostGISの速度と柔軟性は、PostgreSQLが提供する拡張性、優れたクエリプランナ、GiSTインデックス、多数のSQL機能があって初めて成り立ちます。

note: Tag: title
en: Performance Tips
ja: 性能向上に関する技法

note: Tag: title
en: Small tables of large geometries
ja: 大きなジオメトリを持つ小さなテーブル

note: Tag: title
en: Problem description
ja: 問題の説明

note: Tag: para
en: Current PostgreSQL versions (including 9.6) suffer from a query optimizer weakness regarding TOAST tables. TOAST tables are a kind of "extension room" used to store large (in the sense of data size) values that do not fit into normal data pages (like long texts, images or complex geometries with lots of vertices), see <link xlink:href="http://www.postgresql.org/docs/current/static/storage-toast.html">the PostgreSQL Documentation for TOAST</link> for more information).
ja: 現版のPostgreSQL (9.6を含む)では、TOASTテーブルに従うクエリオプティマイザの弱さに苦しみます。 TOASTテーブルは、(長いテキスト、イメージ、多数の頂点を持つ複合ジオメトリといった)通常のデータページに適合しない、(データサイズという意味では)巨大な値を納めるための「拡張部屋」の一種です。詳細情報は <link xlink:href="http://www.postgresql.org/docs/current/static/storage-toast.html">the PostgreSQL Documentation for TOAST</link>をご覧ください。

note: Tag: para
en: The problem appears if you happen to have a table with rather large geometries, but not too many rows of them (like a table containing the boundaries of all European countries in high resolution). Then the table itself is small, but it uses lots of TOAST space. In our example case, the table itself had about 80 rows and used only 3 data pages, but the TOAST table used 8225 pages.
ja: (高解像度で全てのヨーロッパの国の境界を含むテーブルのような)大きなジオメトリがあるうえ、行がそう多くないテーブルを持つようになると、この問題が出てきます。テーブル自体は小さいのですが、多くのTOASTスペースを使います。例として、テーブル自体は概ね80行で3データページしか使わなくてもTOASTテーブルで8225ページを使うとします。

note: Tag: para
en: Now issue a query where you use the geometry operator &amp;&amp; to search for a bounding box that matches only very few of those rows. Now the query optimizer sees that the table has only 3 pages and 80 rows. It estimates that a sequential scan on such a small table is much faster than using an index. And so it decides to ignore the GIST index. Usually, this estimation is correct. But in our case, the &amp;&amp; operator has to fetch every geometry from disk to compare the bounding boxes, thus reading all TOAST pages, too.
ja: ここで、ジオメトリ演算子の&amp;&amp;を使って、ほとんどマッチしないようなバウンダリボックスを検索するクエリを出してみます。クエリオプティマイザにはテーブルは3ページ80行しかないように見えます。オプティマイザは、小さなテーブルを順に走査する方がインデックスを使うよりも早いと見積もります。そして、GiSTインデックスは無視すると決めます。通常なら、この見積もりは正しいです。しかし、この場合は&amp;&amp;演算子が全てのジオメトリをディスクから呼び出してバウンディングボックスと比較しなければならなくなり、ゆえに、全てのTOASTページもまた呼び出す必要があります。

note: Tag: para
en: To see whether your suffer from this issue, use the "EXPLAIN ANALYZE" postgresql command. For more information and the technical details, you can read the thread on the PostgreSQL performance mailing list: <link xlink:href="http://archives.postgresql.org/pgsql-performance/2005-02/msg00030.php">http://archives.postgresql.org/pgsql-performance/2005-02/msg00030.php</link>
ja: この問題に苦しむかどうかを見るには、PostgreSQLの"EXPLAIN ANALYZE"コマンドを使います。詳細情報と技術情報については、PostgreSQL性能メーリングリストのスレッド<link xlink:href="http://archives.postgresql.org/pgsql-performance/2005-02/msg00030.php">http://archives.postgresql.org/pgsql-performance/2005-02/msg00030.php</link>をご覧下さい。

note: Tag: para
en: and newer thread on PostGIS <link xlink:href="https://lists.osgeo.org/pipermail/postgis-devel/2017-June/026209.html">https://lists.osgeo.org/pipermail/postgis-devel/2017-June/026209.html</link>
ja: また、PostGISの新しいスレッド<link xlink:href="https://lists.osgeo.org/pipermail/postgis-devel/2017-June/026209.html">https://lists.osgeo.org/pipermail/postgis-devel/2017-June/026209.html</link>もご覧下さい。

note: Tag: title
en: Workarounds
ja: 応急処置

note: Tag: para
en: The PostgreSQL people are trying to solve this issue by making the query estimation TOAST-aware. For now, here are two workarounds:
ja: PostgreSQLコミュニティでは、TOASTを意識したクエリ見積もりを作ることで、この問題を解決しようとしています。今のところは、二つの応急処置があります。

note: Tag: para
en: The first workaround is to force the query planner to use the index. Send "SET enable_seqscan TO off;" to the server before issuing the query. This basically forces the query planner to avoid sequential scans whenever possible. So it uses the GIST index as usual. But this flag has to be set on every connection, and it causes the query planner to make misestimations in other cases, so you should "SET enable_seqscan TO on;" after the query.
ja: 一つは、クエリプランナにインデックスの使用を強制することです。クエリを発行する前に"SET enable_seqscan TO off;"をサーバに送信します。これは基本的にクエリプランナに対して可能な限り順に走査することを避けるよう強制します。そのためGiSTインデックスを通常使うようになります。しかし、このフラグは接続するたびに設定しなければならず、他のケースにおいてはクエリプランナに誤った見積もりをさせることになるので、 "SET enable_seqscan TO on;"をクエリの後に送信すべきです。

note: Tag: para
en: The second workaround is to make the sequential scan as fast as the query planner thinks. This can be achieved by creating an additional column that "caches" the bbox, and matching against this. In our example, the commands are like:
ja: もう一つは、順に走査することをクエリプランナが考える程度に早くすることです。これは、バウンダリボックスの「キャッシュ」を行う追加カラムを作成し、このカラムにマッチさせるようにすることで達成することができます。ここでの例では次のようになります。

note: Tag: para
en: Now change your query to use the &amp;&amp; operator against bbox instead of geom_column, like:
ja: そして、次のように、&amp;&amp;演算子をgeom_columnに対して行っていたものをbboxに変更します。

note: Tag: para
en: Of course, if you change or add rows to mytable, you have to keep the bbox "in sync". The most transparent way to do this would be triggers, but you also can modify your application to keep the bbox column current or run the UPDATE query above after every modification.
ja: もちろん、mytableの行を変更または追加したら、bboxを「同期」するようにしなければなりません。最もすっきりした方法はトリガです。もしくは、アプリケーションを変更してbboxカラムの現状を保持するか、テーブル更新後にいつもUPDATEクエリを実行するかでも対応できます。

note: Tag: title
en: CLUSTERing on geometry indices
ja: ジオメトリインデックスでCLUSTERを実行する

note: Tag: para
en: For tables that are mostly read-only, and where a single index is used for the majority of queries, PostgreSQL offers the CLUSTER command. This command physically reorders all the data rows in the same order as the index criteria, yielding two performance advantages: First, for index range scans, the number of seeks on the data table is drastically reduced. Second, if your working set concentrates to some small intervals on the indices, you have a more efficient caching because the data rows are spread along fewer data pages. (Feel invited to read the CLUSTER command documentation from the PostgreSQL manual at this point.)
ja: 読み込むことがほとんどで、かつほとんどのクエリでひとつのインデックスを使うようなテーブルのために、PostgreSQLはCLUSTERコマンドを提供しています。このコマンドは、全てのデータ行を、インデックス基準にあわせて物理的に再整理するので、二つの性能の利点を生みます。一つは、インデックスの範囲走査のために、データテーブルのシーク回数が劇的に減少することです。もう一つは、いくつかの小さなインデックス間隔に集中する場合には、データ行が分布するデータページがより少なくなることで、より効率的なキャッシュを持つことです (この点は、PostgreSQLマニュアルのCLUSTERコマンドのドキュメントを読むように仕向けられていると感じて下さい)。

note: Tag: para
en: However, currently PostgreSQL does not allow clustering on PostGIS GIST indices because GIST indices simply ignores NULL values, you get an error message like:
ja: しかし、GiSTインデックスは単純にNULL値を無視するため現在のところPostGISのGiSTインデックスのクラスタリングはできず、次のようなエラーメッセージを得ます。

note: Tag: para
en: As the HINT message tells you, one can work around this deficiency by adding a "not null" constraint to the table:
ja: ヒントメッセージにある通り、テーブルに"not null"制限を追加することで、この欠陥にとりあえず対応できます。例を示します。

note: Tag: para
en: Of course, this will not work if you in fact need NULL values in your geometry column. Additionally, you must use the above method to add the constraint, using a CHECK constraint like "ALTER TABLE blubb ADD CHECK (geometry is not null);" will not work.
ja: もちろん、ジオメトリカラムで実際にNULL値が必要な場合、この対応はできません。さらには、制限を追加するには上の方法を使わなければならず、"ALTER TABLE blubb ADD CHECK (geometry is not null);"のようなCHECK制限は使えません。

note: Tag: title
en: Avoiding dimension conversion
ja: 次元変換の回避

note: Tag: para
en: Sometimes, you happen to have 3D or 4D data in your table, but always access it using OpenGIS compliant ST_AsText() or ST_AsBinary() functions that only output 2D geometries. They do this by internally calling the ST_Force2D() function, which introduces a significant overhead for large geometries. To avoid this overhead, it may be feasible to pre-drop those additional dimensions once and forever:
ja: ときどき、テーブルで3次元、4次元のデータを持つのに、常にOpenGIS準拠のST_AsText()またはST_AsBinary()関数を使ってアクセスして 2次元ジオメトリを出力させるようなことが起きます。内部でST_Force_2d()関数を呼んでいるために発生しますが、これは、大きなジオメトリでは重大なオーバヘッドを誘引することになります。このオーバヘッドを回避するには、一度追加された次元を前もって落とし、かつこれを永続化するのが適当かも知れません。

note: Tag: para
en: Note that if you added your geometry column using AddGeometryColumn() there'll be a constraint on geometry dimension. To bypass it you will need to drop the constraint. Remember to update the entry in the geometry_columns table and recreate the constraint afterwards.
ja: AddGeometryColumn()を使ってジオメトリカラムを追加した場合、ジオメトリの次元に関する制限があることに注意してください。この制限を迂回するには、制限の削除が必要になります。geometry_columnsテーブル内のエントリを更新して、その後で制限を再作成することを忘れないで下さい。

note: Tag: para
en: In case of large tables, it may be wise to divide this UPDATE into smaller portions by constraining the UPDATE to a part of the table via a WHERE clause and your primary key or another feasible criteria, and running a simple "VACUUM;" between your UPDATEs. This drastically reduces the need for temporary disk space. Additionally, if you have mixed dimension geometries, restricting the UPDATE by "WHERE dimension(geom)&gt;2" skips re-writing of geometries that already are in 2D.
ja: 大きなテーブルの場合、WHERE節、およびプライマリキー若しくは他の適切な基準によってテーブルの一部へのUPDATEを制限させて、UPDATEの実行の間に単に"VACUUM;"と実行することで、UPDATEをより小さい塊に分割するのが賢いやり方かもしれません。これにより、テンポラリディスクスペースが劇的に減少します。さらに、次元混合のジオメトリを持つ場合、"WHERE dimension(the_geom)&gt;2"によってUPDATEを制限することで、2次元で書かれているジオメトリの再書き込みをスキップさせることができます。

note: Tag: title
en: PostGIS &last_release_version; Manual
ja: PostGIS &last_release_version; マニュアル

note: Tag: orgname
en: The PostGIS Development Group
ja: PostGIS開発グループ

note: Tag: affiliation
en: <orgname><link xlink:href="http://www.cleverelephant.ca">clever elephant</link></orgname> <address><city>Victoria</city> <state>British Columbia</state> <country>Canada</country> <email>pramsey@cleverelephant.ca</email></address>
ja: <orgname><link xlink:href="http://www.cleverelephant.ca">clever elephant</link></orgname><address><city>ビクトリア</city><state>ブリティッシュコロンビア</state><country>カナダ</country><email> pramsey@cleverelephant.ca </email></address>

note: Tag: para
en: PostGIS is an extension to the <link xlink:href="https://www.postgresql.org/">PostgreSQL</link> object-relational database system which allows GIS (Geographic Information Systems) objects to be stored in the database. PostGIS includes support for GiST-based R-Tree spatial indexes, and functions for analysis and processing of GIS objects.
ja: PostGISは、オブジェクトRDBである<link xlink:href="https://www.postgresql.org/">PostgreSQL</link>の拡張で、GIS (地理情報システム)オブジェクトを格納することができます。PostGISは、GiSTベースのR木空間インデクスをサポートし、GISオブジェクトの解析および処理を行う機能を持ちます。

note: Tag: para
en: This is the manual for version &last_release_version;
ja: 本マニュアルは、&last_release_version;版のマニュアルです。

note: Tag: para
en: This work is licensed under a <link xlink:href="http://creativecommons.org/licenses/by-sa/3.0/">Creative Commons Attribution-Share Alike 3.0 License</link>. Feel free to use this material any way you like, but we ask that you attribute credit to the PostGIS Project and wherever possible, a link back to <link xlink:href="https://postgis.net">https://postgis.net</link>.
ja: この作品は<link xlink:href="http://creativecommons.org/licenses/by-sa/3.0/deed.ja">クリエイティブ・コモンズ 表示 - 継承 3.0 非移植 ライセンス</link>の下に提供されています。好きなようにこの材料を使うことができますが、PostGIS Project のクレジット提示を求めます。また可能な限り<link xlink:href="http://postgis.net">http://postgis.net</link>へのリンクを求めます。

note: Tag: title
en: PostGIS Special Functions Index
ja: PostGIS関数索引

note: Tag: title
en: PostGIS Aggregate Functions
ja: PostGIS集約関数

note: Tag: para
en: The functions below are spatial aggregate functions that are used in the same way as SQL aggregate function such as <code>sum</code> and <code>average</code>.
ja: 次に示す関数は、PostGISが提供する空間集約関数です。<code>sum</code>や<code>average</code>といった他のSQL集約関数のように使います。

note: Tag: title
en: PostGIS Window Functions
ja: PostGISウィンドウ関数

note: Tag: para
en: The functions below are spatial window functions that are used in the same way as SQL window functions such as <code>row_number()</code>, <code>lead()</code>, and <code>lag()</code>. They must be followed by an <code>OVER()</code> clause.
ja: 次に示す関数は、PostGISが提供する空間ウィンドウ関数です。<code>row_number()</code>, <code>lead()</code>, <code>lag()</code>等のような他のSQLウィンドウ関数のように使います。全ての関数で、SQLの<code>OVER()</code>句が必要です。

note: Tag: title
en: PostGIS SQL-MM Compliant Functions
ja: PostGIS SQL-MM準拠関数

note: Tag: para
en: The functions given below are PostGIS functions that conform to the SQL/MM 3 standard
ja: 次に示す関数は、SQL/MM 3標準に準拠したPostGIS関数です。

note: Tag: title
en: PostGIS Geography Support Functions
ja: PostGISジオグラフィ対応関数

note: Tag: para
en: The functions and operators given below are PostGIS functions/operators that take as input or return as output a <link linkend="PostGIS_Geography">geography</link> data type object.
ja: 次に示す関数と演算子は、<link linkend="PostGIS_Geography">ジオグラフィ</link>データ型を入力または出力に取るPostGIS関数/演算子です。

note: Tag: para
en: Functions with a (T) are not native geodetic functions, and use a ST_Transform call to and from geometry to do the operation. As a result, they may not behave as expected when going over dateline, poles, and for large geometries or geometry pairs that cover more than one UTM zone. Basic transform - (favoring UTM, Lambert Azimuthal (North/South), and falling back on mercator in worst case scenario)
ja: (T)の付いた関数はネイティブなジオグラフィ関数ではなく、実行時にST_Transformを使ってジオメトリとの変換を行います。結果として、日付変更線や極を超えたり、ひとつのUTMゾーンではカバーできない巨大なジオメトリを使用する場合に、予期しない挙動になることがあります。基本的な変換としては、UTMが望ましいですが、ランベルト正積方位図法(北/南)、最悪のシナリオでメルカトルに頼ります。

note: Tag: title
en: PostGIS Raster Support Functions
ja: PostGISラスタ機能関数

note: Tag: para
en: The functions and operators given below are PostGIS functions/operators that take as input or return as output a <xref linkend="raster"/> data type object. Listed in alphabetical order.
ja: 次に示す関数と演算子は、<xref linkend="raster"/>データ型を入力または出力に取るPostGIS関数/演算子です。アルファベット順に示します。

note: Tag: title
en: PostGIS Geometry / Geography / Raster Dump Functions
ja: PostGISジオメトリ/ジオグラフィ/ラスタのダンプ関数

note: Tag: para
en: The functions given below are PostGIS functions that take as input or return as output a set of or single <link linkend="geometry_dump">geometry_dump</link> or <link linkend="geomval">geomval</link> data type object.
ja: 次に示す関数は、<link linkend="geometry_dump">geometry_dump</link>または<link linkend="geomval">geomval</link>データ型の集合または単一データを入力または出力に取るPostGIS関数です。

note: Tag: title
en: PostGIS Box Functions
ja: PostGISボックス関数

note: Tag: para
en: The functions given below are PostGIS functions that take as input or return as output the box* family of PostGIS spatial types. The box family of types consists of <link linkend="box2d_type">box2d</link>, and <link linkend="box3d_type">box3d</link>
ja: 次に示す関数は、PostGIS空間型のbox系の型を入力または出力に取るPostGIS関数です。ボックス系には<link linkend="box2d_type">box2d</link>と<link linkend="box3d_type">box3d</link>があります。

note: Tag: title
en: PostGIS Functions that support 3D
ja: 3次元対応PostGIS関数

note: Tag: para
en: The functions given below are PostGIS functions that do not throw away the Z-Index.
ja: 次に示す関数は、Zインデクスを放り出さないPostGIS関数です。

note: Tag: title
en: PostGIS Curved Geometry Support Functions
ja: PostGIS曲線ジオメトリ対応関数

note: Tag: para
en: The functions given below are PostGIS functions that can use CIRCULARSTRING, CURVEPOLYGON, and other curved geometry types
ja: 次に示す関数は、CIRCULARSTRING, CURVEDPOLYGON等の曲線ジオメトリ型が使えるPostGIS関数です。

note: Tag: title
en: PostGIS Polyhedral Surface Support Functions
ja: PostGIS多面体サーフェス対応関数

note: Tag: para
en: The functions given below are PostGIS functions that can use POLYHEDRALSURFACE, POLYHEDRALSURFACEM geometries
ja: 次に示す関数は、POLYHEDRALSURFACE, POLYHEDRALSURFACEMジオメトリが使えるPostGIS関数です。

note: Tag: title
en: PostGIS Function Support Matrix
ja: PostGIS関数対応マトリクス

note: Tag: para
en: Below is an alphabetical listing of spatial specific functions in PostGIS and the kinds of spatial types they work with or OGC/SQL compliance they try to conform to.
ja: 次に示す表は、アルファベット順に並べたPostGIS空間関数と、動作する空間タイプの種類、対応しようとしているOGC/SQL準拠を示しています。

note: Tag: simpara
en: A <inlinemediaobject><imageobject><imagedata fileref="images/matrix_checkmark.png"/></imageobject></inlinemediaobject> means the function works with the type or subtype natively.
ja: <inlinemediaobject><imageobject><imagedata fileref="images/matrix_checkmark.png"/></imageobject></inlinemediaobject>は、ネイティブで、その型と派生型とに対応しています。

note: Tag: simpara
en: A <inlinemediaobject><imageobject><imagedata fileref="images/matrix_transform.png"/></imageobject></inlinemediaobject> means it works but with a transform cast built-in using cast to geometry, transform to a "best srid" spatial ref and then cast back. Results may not be as expected for large areas or areas at poles and may accumulate floating point junk.
ja: <inlinemediaobject><imageobject><imagedata fileref="images/matrix_transform.png"/></imageobject></inlinemediaobject>は、動作しますが、ジオメトリにキャストして「最善のSRID」に投影変換したうえでジオグラフィに戻す、組み込み変換キャストを使います。大きな面積の領域や、極にある領域については、予期しない結果になることがありますし、浮動小数点数のごみを蓄積することがあります。

note: Tag: simpara
en: A <inlinemediaobject><imageobject><imagedata fileref="images/matrix_autocast.png"/></imageobject></inlinemediaobject> means the function works with the type because of a auto-cast to another such as to box3d rather than direct type support.
ja: <inlinemediaobject><imageobject><imagedata fileref="images/matrix_autocast.png"/></imageobject></inlinemediaobject>は、直接的な対応でなくbox3dへの変換といった他からの自動キャストで動作します。

note: Tag: simpara
en: A <inlinemediaobject><imageobject><imagedata fileref="images/matrix_sfcgal_required.png"/></imageobject></inlinemediaobject> means the function only available if PostGIS compiled with SFCGAL support.
ja: <inlinemediaobject><imageobject><imagedata fileref="images/matrix_sfcgal_required.png"/></imageobject></inlinemediaobject>は、PostGISをSFCGAL対応でコンパイルした場合にのみ利用可能な関数です。

note: Tag: simpara
en: geom - Basic 2D geometry support (x,y).
ja: geom - 基本的な2次元ジオメトリ (x,y)に対応しています。

note: Tag: simpara
en: geog - Basic 2D geography support (x,y).
ja: geog - 基本的な2次元ジオグラフィ (x,y)に対応しています。

note: Tag: simpara
en: 2.5D - basic 2D geometries in 3 D/4D space (has Z or M coord).
ja: 2.5D - 3次元/4次元 (ZまたはM座標を持つ)空間内の基本的な2次元ジオメトリに対応しています。

note: Tag: simpara
en: PS - Polyhedral surfaces
ja: PS - 多面体サーフェス (Polyhedral Surface)に対応しています

note: Tag: simpara
en: T - Triangles and Triangulated Irregular Network surfaces (TIN)
ja: T - 三角形と不規則三角網 (TIN)に対応しています。

note: Tag: entry
en: Function
ja: 関数

note: Tag: entry
en: Curves
ja: 曲線

note: Tag: title
en: New, Enhanced or changed PostGIS Functions
ja: 新規作成/機能強化/変更されたPostGIS関数

note: Tag: title
en: PostGIS Reference
ja: PostGISリファレンス

note: Tag: para
en: The functions given below are the ones which a user of PostGIS is likely to need. There are other functions which are required support functions to the PostGIS objects which are not of use to a general user.
ja: ここで示す関数はPostGISユーザが必要とすると思われる関数です。この他に、一般的なユーザが使わないPostGISオブジェクトに対して求められるサポート関数があります。

note: Tag: para
en: PostGIS has begun a transition from the existing naming convention to an SQL-MM-centric convention. As a result, most of the functions that you know and love have been renamed using the standard spatial type (ST) prefix. Previous functions are still available, though are not listed in this document where updated functions are equivalent. The non ST_ functions not listed in this documentation are deprecated and will be removed in a future release so STOP USING THEM.
ja: PostGISは、既存の名前付け方針からSQL-MM中心の方針への切り替えを開始しています。結果として、ユーザが知っていて愛用している関数の多くが標準空間型 (ST) プレフィクスを使うように名前変更されました。以前の関数はまだ有効ですが、更新された等価な関数があるものについては、この文書の一覧から外しています (訳注: 非推奨関数はPostGIS 2.0では基本的に外れています)。これらの関数は非推奨であり、将来のリリースでは削除されますので、*使わないでください*。

note: Tag: title
en: Geometry Accessors
ja: ジオメトリアクセサ

note: Tag: refpurpose
en: Returns the type of a geometry as text.
ja: ジオメトリのタイプを文字列で返します。

note: Tag: para
en: Returns the type of the geometry as a string. Eg: 'LINESTRING', 'POLYGON', 'MULTIPOINT', etc.
ja: ジオメトリ型を'LINESTRING', 'POLYGON', 'MULTIPOINT'などの文字列で返します。

note: Tag: para
en: OGC SPEC s2.1.1.1 - Returns the name of the instantiable subtype of Geometry of which this Geometry instance is a member. The name of the instantiable subtype of Geometry is returned as a string.
ja: OGC SPEC s2.1.1.1 - このジオメトリインスタンスがメンバーになっているジオメトリのインスタンス化可能な派生タイプの名前を返します。インスタンス化可能な派生タイプの名前は、文字列として返されます。

note: Tag: para
en: This function also indicates if the geometry is measured, by returning a string of the form 'POINTM'.
ja: この関数は、'POINTM'等が返るので、ジオメトリがM値を持っているかどうかも示します。

note: Tag: para
en: Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
ja: Enhanced: 2.0.0 多面体サーフェス対応、三角対応、TIN対応が導入されました。

note: Tag: refpurpose
en: Returns the boundary of a geometry.
ja: ジオメトリの境界を返します。

note: Tag: para
en: Returns the closure of the combinatorial boundary of this Geometry. The combinatorial boundary is defined as described in section 3.12.3.2 of the OGC SPEC. Because the result of this function is a closure, and hence topologically closed, the resulting boundary can be represented using representational geometry primitives as discussed in the OGC SPEC, section 3.12.2.
ja: ジオメトリの組み合わせ境界の閉包を返します (訳注: ラインストリングは端点、ポリゴンはエッジ、複合オブジェクトは境界のうち奇数番)。組み合わせ境界はOGC仕様の3.12.3.2節に記述されています。結果として出てくる境界は、OGC SPEC 3.12.2で議論されているように、ジオメトリプリミティブを使って表現できます。

note: Tag: para
en: Performed by the GEOS module
ja: GEOSモジュールで実現しています。

note: Tag: para
en: Prior to 2.0.0, this function throws an exception if used with <varname>GEOMETRYCOLLECTION</varname>. From 2.0.0 up it will return NULL instead (unsupported input).
ja: 2.0.0より前の版では、この関数は<varname>GEOMETRYCOLLECTION</varname>.を与えると例外を投げました。2.0.0以上では代わりにNULLが返ります (非対応入力)。

note: Tag: para
en: Enhanced: 2.1.0 support for Triangle was introduced
ja: Enhanced: 2.1.0 三角対応が導入されました。

note: Tag: para
en: Changed: 3.2.0 support for TIN, does not use geos, does not linearize curves
ja: Changed: 3.2.0 TINに対応しました。GEOSを使いません。曲線を線形化しません。

note: Tag: para
en: Linestring with boundary points overlaid
ja: 境界ポイントを重ねたラインストリング

note: Tag: para
en: polygon holes with boundary multilinestring
ja: 境界マルチラインストリングを重ねたポリゴンの穴

note: Tag: refpurpose
en: Returns the diagonal of a geometry's bounding box.
ja: ジオメトリのバウンディングボックスの対角線を返します。

note: Tag: para
en: Returns the diagonal of the supplied geometry's bounding box as a LineString. The diagonal is a 2-point LineString with the minimum values of each dimension in its start point and the maximum values in its end point. If the input geometry is empty, the diagonal line is a LINESTRING EMPTY.
ja: 与えられたジオメトリのバウンディングボックスの対角線をラインストリングで返します。最小値のポイントを始点とし、最大値のポイントを終点とする、二つのポイントからなるラインストリングになります。入力ジオメトリが空の場合には、対角線はLINESTRING EMPTYとなります。

note: Tag: para
en: The optional <varname>fits</varname> parameter specifies if the best fit is needed. If false, the diagonal of a somewhat larger bounding box can be accepted (which is faster to compute for geometries with many vertices). In either case, the bounding box of the returned diagonal line always covers the input geometry.
ja: <varname>fits</varname>パラメータは、最良適合が必要かどうかを指定するものです。FALSEの場合には、幾分大きめなバウンディングボックスの対角線を受け付けることができます (多数の頂点からなるジオメトリの取得が早くなります)。いずれにしても返された対角線のバウンディングボックスは常に入力ジオメトリを含みます。

note: Tag: para
en: The returned geometry retains the SRID and dimensionality (Z and M presence) of the input geometry.
ja: 返されるラインストリングは常に、入力ジオメトリのSRIDと次元 (ZとMがあること)を維持します。

note: Tag: para
en: In degenerate cases (i.e. a single vertex in input) the returned linestring will be formally invalid (no interior). The result is still topologically valid.
ja: 縮退した (入力の頂点が一つ)場合、返されるラインストリングは形式的に不正です (内部が無い)。トポロジ的には妥当です。

note: Tag: refpurpose
en: Return the coordinate dimension of a geometry.
ja: ジオメトリの座標次元を返します。

note: Tag: para
en: Return the coordinate dimension of the ST_Geometry value.
ja: ST_Geometry値の座標次元を返します。

note: Tag: para
en: This is the MM compliant alias name for <xref linkend="ST_NDims"/>
ja: この関数は<xref linkend="ST_NDims"/>のMM対応の別名です。

note: Tag: refpurpose
en: Returns the topological dimension of a geometry.
ja: ST_Geometry値の座標次元を返します。

note: Tag: para
en: Return the topological dimension of this Geometry object, which must be less than or equal to the coordinate dimension. OGC SPEC s2.1.1.1 - returns 0 for <varname>POINT</varname>, 1 for <varname>LINESTRING</varname>, 2 for <varname>POLYGON</varname>, and the largest dimension of the components of a <varname>GEOMETRYCOLLECTION</varname>. If the dimension is unknown (e.g. for an empty <varname>GEOMETRYCOLLECTION</varname>) 0 is returned.
ja: ジオメトリの固有次元を返します。ジオメトリは座標次元以下でなければなりません。OGC SPEC s2.1.1.1 - 0なら<varname>POINT</varname>、1なら<varname>LINESTRING</varname>、2なら<varname>POLYGON</varname>で、<varname>GEOMETRYCOLLECTION</varname>の場合は要素ごとの次元の最大値です。不明なジオメトリ (空の<varname>GEOMETRYCOLLECTION</varname>等)の場合はNULLが返ります。

note: Tag: para
en: Enhanced: 2.0.0 support for Polyhedral surfaces and TINs was introduced. No longer throws an exception if given empty geometry.
ja: Enhanced: 2.0.0 多面体サーフェス対応とTIN対応が導入されました。空ジオメトリを与えた場合に例外を投げなくなりました。

note: Tag: para
en: Prior to 2.0.0, this function throws an exception if used with empty geometry.
ja: 2.0.0より前では、空ジオメトリを与えると例外を投げていました。

note: Tag: refpurpose
en: Returns a set of <varname>geometry_dump</varname> rows for the components of a geometry.
ja: ジオメトリの要素となる<varname>geometry_dump</varname>行の集合を返します。

note: Tag: para
en: A set-returning function (SRF) that extracts the components of a geometry. It returns a set of <xref linkend="geometry_dump"/> rows, each containing a geometry (<parameter>geom</parameter> field) and an array of integers (<parameter>path</parameter> field).
ja: ジオメトリ要素を抽出する、集合を返す関数 (SRF=Set-Returning Function)です。ジオメトリ (<parameter>geom</parameter>フィールド)と整数配列 (<parameter>path</parameter>フィールド)からなる<xref linkend="geometry_dump"/>行の集合を返します。

note: Tag: para
en: For an atomic geometry type (POINT,LINESTRING,POLYGON) a single record is returned with an empty <parameter>path</parameter> array and the input geometry as <parameter>geom</parameter>. For a collection or multi-geometry a record is returned for each of the collection components, and the <parameter>path</parameter> denotes the position of the component inside the collection.
ja: 非マルチ系ジオメトリタイプ (POINT,LINESTRING,POLYGON)では、<parameter>path</parameter>配列が空で<parameter>geom</parameter>が入力ジオメトリと同じになる単一の行が返ります。コレクションまたはマルチ系ジオメトリでは、個々の要素と、コレクションの要素位置を示す<parameter>path</parameter>とからなる行を返します。

note: Tag: para
en: ST_Dump is useful for expanding geometries. It is the inverse of a <xref linkend="ST_Collect"/> / GROUP BY, in that it creates new rows. For example it can be use to expand MULTIPOLYGONS into POLYGONS.
ja: ST_Dumpはジオメトリを展開するのに使います。<xref linkend="ST_Collect"/>/GROUP BYの逆で、この関数の中で新行を作成します。たとえば、MULTIPOLYGONをPOLYGONに展開するために使います。

note: Tag: para
en: Availability: PostGIS 1.0.0RC1. Requires PostgreSQL 7.3 or higher.
ja: Availability: PostGIS 1.0.0RC1。PostgreSQL 7.3以上が必要です。

note: Tag: para
en: Prior to 1.3.4, this function crashes if used with geometries that contain CURVES. This is fixed in 1.3.4+
ja: 1.3.4より前では、曲線を含むジオメトリで使用すると、この関数はクラッシュします。これは1.3.4以上で訂正されています。

note: Tag: title
en: Standard Examples
ja: 標準的な例

note: Tag: title
en: Polyhedral Surfaces, TIN and Triangle Examples
ja: 多面体サーフェス、TIN、三角形の例

note: Tag: refpurpose
en: Returns a set of <varname>geometry_dump</varname> rows for the coordinates in a geometry.
ja: ジオメトリ内の座標の行である<varname>geometry_dump</varname>行の集合を返します。

note: Tag: para
en: A set-returning function (SRF) that extracts the coordinates (vertices) of a geometry. It returns a set of <xref linkend="geometry_dump"/> rows, each containing a geometry (<parameter>geom</parameter> field) and an array of integers (<parameter>path</parameter> field).
ja: ジオメトリの座標 (頂点)を抽出する、集合を返す関数 (SRF=Set-Returning Function)です。ジオメトリ (<parameter>geom</parameter>フィールド)と整数配列 (<parameter>path</parameter>フィールド)からなる<xref linkend="geometry_dump"/>行の集合を返します。

note: Tag: para
en: the <parameter>geom</parameter> field <varname>POINT</varname>s represent the coordinates of the supplied geometry.
ja: <parameter>geom</parameter>フィールドには、与えられたジオメトリの座標を表現する<varname>POINT</varname>が入ります。

note: Tag: para
en: the <parameter>path</parameter> field (an <varname>integer[]</varname>) is an index enumerating the coordinate positions in the elements of the supplied geometry. The indices are 1-based. For example, for a <varname>LINESTRING</varname> the paths are <varname>{i}</varname> where <varname>i</varname> is the <varname>nth</varname> coordinate in the <varname>LINESTRING</varname>. For a <varname>POLYGON</varname> the paths are <varname>{i,j}</varname> where <varname>i</varname> is the ring number (1 is outer; inner rings follow) and <varname>j</varname> is the coordinate position in the ring.
ja: <parameter>path</parameter>フィールド (<varname>integer[]</varname>)は、与えられたジオメトリの要素内の座標位置を列挙するインデックスです。インデックスは1始まりです。たとえば、<varname>LINESTRING</varname>に対しては、<varname>LINESTRING</varname>の<varname>n番目</varname>の座標を<varname>i</varname>とすると、<varname>{i}</varname>となります。<varname>POLYGON</varname>に対しては、<varname>i</varname>を環番号 (1が外環、続いて内環)、<varname>j</varname>を環の座標位置とすると、<varname>{i,j}</varname>となります。

note: Tag: para
en: To obtain a single geometry containing the coordinates use <xref linkend="ST_Points"/>.
ja: 座業を含む単一ジオメトリを取得するには<xref linkend="ST_Points"/>を使います。

note: Tag: para
en: Enhanced: 2.1.0 Faster speed. Reimplemented as native-C.
ja: Enhanced: 2.1.0 速度向上しました。C言語で実装しなおしました。

note: Tag: title
en: Classic Explode a Table of LineStrings into nodes
ja: ラインストリングのテーブルのノードへの古典的な分割

note: Tag: title
en: Standard Geometry Examples
ja: 標準的な例

note: Tag: refpurpose
en: Returns a set of <varname>geometry_dump</varname> rows for the segments in a geometry.
ja: ジオメトリ内の辺の行である<varname>geometry_dump</varname>行の集合を返します。

note: Tag: para
en: A set-returning function (SRF) that extracts the segments of a geometry. It returns a set of <xref linkend="geometry_dump"/> rows, each containing a geometry (<parameter>geom</parameter> field) and an array of integers (<parameter>path</parameter> field).
ja: ジオメトリの辺を抽出する、集合を返す関数 (SRF=Set-Returning Function)です。ジオメトリ (<parameter>geom</parameter>フィールド)と整数配列 (<parameter>path</parameter>フィールド)からなる<xref linkend="geometry_dump"/>行の集合を返します。

note: Tag: para
en: the <parameter>geom</parameter> field <varname>LINESTRING</varname>s represent the linear segments of the supplied geometry, while the <varname>CIRCULARSTRING</varname>s represent the arc segments.
ja: <parameter>geom</parameter>フィールドの<varname>LINESTRING</varname>は与えられたジオメトリの線分を表現し、<varname>CIRCULARSTRING</varname>は円弧線分を表現します。

note: Tag: para
en: the <parameter>path</parameter> field (an <varname>integer[]</varname>) is an index enumerating the segment start point positions in the elements of the supplied geometry. The indices are 1-based. For example, for a <varname>LINESTRING</varname> the paths are <varname>{i}</varname> where <varname>i</varname> is the <varname>nth</varname> segment start point in the <varname>LINESTRING</varname>. For a <varname>POLYGON</varname> the paths are <varname>{i,j}</varname> where <varname>i</varname> is the ring number (1 is outer; inner rings follow) and <varname>j</varname> is the segment start point position in the ring.
ja: <parameter>path</parameter>フィールド (<varname>integer[]</varname>)は、与えられたジオメトリの要素内の辺の始点位置を列挙するインデックスです。インデックスは1始まりです。たとえば、<varname>LINESTRING</varname>に対しては、<varname>LINESTRING</varname>の<varname>n番目</varname>の辺を<varname>i</varname>とすると、<varname>{i}</varname>となります。<varname>POLYGON</varname>に対しては、<varname>i</varname>を環番号 (1が外環、続いて内環)、<varname>j</varname>を環の辺の始点位置とすると、<varname>{i,j}</varname>となります。

note: Tag: title
en: TIN and Triangle Examples
ja: TIN、三角形の例

note: Tag: refpurpose
en: Returns a set of <varname>geometry_dump</varname> rows for the exterior and interior rings of a Polygon.
ja: ポリゴンのリングごとの<varname>geometry_dump</varname>行の集合を返します。

note: Tag: para
en: A set-returning function (SRF) that extracts the rings of a polygon. It returns a set of <xref linkend="geometry_dump"/> rows, each containing a geometry (<parameter>geom</parameter> field) and an array of integers (<parameter>path</parameter> field).
ja: ジオメトリ要素を抽出する、集合を返す関数 (SRF=Set-Returning Function)です。ジオメトリ (<parameter>geom</parameter>フィールド)と整数配列 (<parameter>path</parameter>フィールド)からなる<xref linkend="geometry_dump"/>行の集合を返します。

note: Tag: para
en: The <parameter>geom</parameter> field contains each ring as a POLYGON. The <parameter>path</parameter> field is an integer array of length 1 containing the polygon ring index. The exterior ring (shell) has index 0. The interior rings (holes) have indices of 1 and higher.
ja: ジオメトリ要素を抽出する、集合を返す関数 (SRF=Set-Returning Function)です。ジオメトリ (<parameter>geom</parameter>フィールド)と整数配列 (<parameter>path</parameter>フィールド)からなる<xref linkend="geometry_dump"/>行の集合を返します。

note: Tag: para
en: This only works for POLYGON geometries. It does not work for MULTIPOLYGONS
ja: POLYGONジオメトリでのみ動作します。MULTIPOLYGONでは動作しません。

note: Tag: para
en: Availability: PostGIS 1.1.3. Requires PostgreSQL 7.3 or higher.
ja: Availability: PostGIS 1.1.3 PostgreSQL 7.3以上が必要です。

note: Tag: para
en: General form of query.
ja: クエリの一般的な形式。

note: Tag: para
en: A polygon with a single hole.
ja: 単一の穴を持つポリゴン

note: Tag: refpurpose
en: Returns the last point of a LineString or CircularLineString.
ja: LINESTRINGまたはCIRCULARLINESTRINGの終端のポイントを返します。

note: Tag: para
en: Returns the last point of a <varname>LINESTRING</varname> or <varname>CIRCULARLINESTRING</varname> geometry as a <varname>POINT</varname>. Returns <varname>NULL</varname> if the input is not a <varname>LINESTRING</varname> or <varname>CIRCULARLINESTRING</varname>.
ja: <varname>LINESTRING</varname>または<varname>CIRCULARLINESTRING</varname>ジオメトリの、最後のポイントを<varname>POINT</varname>で返します。入力パラメータが<varname>LINESTRING</varname>でも<varname>CIRCULARLINESTRING</varname>でもない場合には、<varname>NULL</varname>を返します。

note: Tag: para
en: Changed: 2.0.0 no longer works with single geometry MultiLineStrings. In older versions of PostGIS a single-line MultiLineString would work with this function and return the end point. In 2.0.0 it returns NULL like any other MultiLineString. The old behavior was an undocumented feature, but people who assumed they had their data stored as LINESTRING may experience these returning NULL in 2.0.0.
ja: Changed: 2.0.0 一つのジオメトリマルチラインストリングで動作しなくなりました。PostGIS の古いバージョンでは、この関数は一つのマルチラインストリングで動作し、終端ポイントを返します。2.0.0では、他のマルチラインストリングと同様にNULLを返します。古い動作は文書化されていない機能でしたが、データをLINESTRINGとして格納していると思われるユーザーは、2.0.0 でNULLが返されることを経験するかも知れません。

note: Tag: para
en: End point of a LineString
ja: ラインストリングの終端ポイント

note: Tag: para
en: End point of a non-LineString is NULL
ja: ラインストリング以外の終端ポイントはNULL

note: Tag: para
en: End point of a 3D LineString
ja: 3次元ラインストリングの終端ポイント

note: Tag: para
en: End point of a CircularString
ja: CIRCULARSTRINGの終端ポイント

note: Tag: refpurpose
en: Returns a geometry representing the bounding box of a geometry.
ja: ジオメトリのバウンディングボックスを表現するジオメトリを返します。

note: Tag: para
en: Returns the double-precision (float8) minimum bounding box for the supplied geometry, as a geometry. The polygon is defined by the corner points of the bounding box ((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MINY</varname>)). (PostGIS will add a <varname>ZMIN</varname>/<varname>ZMAX</varname> coordinate as well).
ja: 与えられたジオメトリの倍精度浮動小数点数 (float8)の最小バウンディングボックスをジオメトリで返します。ポリゴンはバウンディングボックスの角のポイントで定義されます ((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MINY</varname>))。(PostGISは<varname>ZMIN</varname>/<varname>ZMAX</varname>も追加します).

note: Tag: para
en: Degenerate cases (vertical lines, points) will return a geometry of lower dimension than <varname>POLYGON</varname>, ie. <varname>POINT</varname> or <varname>LINESTRING</varname>.
ja: 縮退する場合 (縦のライン、ポイント)は<varname>POLYGON</varname>より低い次元のジオメトリ、すなわち<varname>POINT</varname>または<varname>LINESTRING</varname>を返します。

note: Tag: para
en: Availability: 1.5.0 behavior changed to output double precision instead of float4
ja: Availability: 1.5.0 挙動が変更され出力がfloat4からfloat8になりました。

note: Tag: para
en: Envelope of a point and linestring.
ja: ポイントとラインストリングの最小バウンディングボックス

note: Tag: refpurpose
en: Returns a LineString representing the exterior ring of a Polygon.
ja: ポリゴンの外環を表現するラインストリングを返します。

note: Tag: para
en: Returns a LINESTRING representing the exterior ring (shell) of a POLYGON. Returns NULL if the geometry is not a polygon.
ja: POLYGONの外環を表現するLINESTRINGを返します。ジオメトリがポリゴンでない場合はNULLを返します。

note: Tag: para
en: This function does not support MULTIPOLYGONs. For MULTIPOLYGONs use in conjunction with <xref linkend="ST_GeometryN"/> or <xref linkend="ST_Dump"/>
ja: この関数はマルチポリゴンでは動作しません。マルチポリゴンに対しては<xref linkend="ST_GeometryN"/>または<xref linkend="ST_Dump"/>を併用して下さい。

note: Tag: refpurpose
en: Return an element of a geometry collection.
ja: ジオメトリコレクションの要素を一つ返します。

note: Tag: para
en: Return the 1-based Nth element geometry of an input geometry which is a GEOMETRYCOLLECTION, MULTIPOINT, MULTILINESTRING, MULTICURVE, MULTI)POLYGON, or POLYHEDRALSURFACE. Otherwise, returns NULL.
ja: GEOMETRYCOLLECTION, MULTIPOINT, MULTILINESTRING, MULTICURVE, MULTIPOLYGON, POLYHEDRALSURFACEの入力ジオメトリの、1始まりでN番目の要素を返します。他の場合にはNULLを返します。

note: Tag: para
en: Index is 1-based as for OGC specs since version 0.8.0. Previous versions implemented this as 0-based instead.
ja: OGC仕様のため0.8.0版からインデクスを1始まりにしています。これより前の版では0始まりになっています。

note: Tag: para
en: To extract all elements of a geometry, <xref linkend="ST_Dump"/> is more efficient and works for atomic geometries.
ja: ジオメトリの全ての要素を抽出するには<xref linkend="ST_Dump"/>の方が効率的ですし、単一ジオメトリでも動作します。

note: Tag: para
en: Changed: 2.0.0 Prior versions would return NULL for singular geometries. This was changed to return the geometry for ST_GeometryN(..,1) case.
ja: Changed: 2.0.0 以前の版では非マルチのジオメトリではNULLが返りました。ST_GeometryN(..,1)の場合にはジオメトリを返すよう変更されました。

note: Tag: refpurpose
en: Returns the SQL-MM type of a geometry as text.
ja: ジオメトリのSQL-MM型を文字列で返します。

note: Tag: para
en: Returns the type of the geometry as a string. EG: 'ST_LineString', 'ST_Polygon','ST_MultiPolygon' etc. This function differs from GeometryType(geometry) in the case of the string and ST in front that is returned, as well as the fact that it will not indicate whether the geometry is measured.
ja: ジオメトリ型を'ST_LineString', 'ST_Polygon', 'ST_MultiPolygon'等の文字列で返します。この関数はGeometryType(geometry)とは異なり、先頭に'ST'が付き、M値を持っているかを示しません。

note: Tag: para
en: Enhanced: 2.0.0 support for Polyhedral surfaces was introduced.
ja: Enhanced: 2.0.0 多面体サーフェス対応が導入されました。

note: Tag: refpurpose
en: Tests if a geometry contains a circular arc
ja: ジオメトリに円弧が含まれているかどうかテストします。

note: Tag: para
en: Returns true if a geometry or geometry collection contains a circular string
ja: ジオメトリまたはジオメトリコレクションに曲線ラインストリングが含まれている場合にTRUEを返します。

note: Tag: refpurpose
en: Returns the Nth interior ring (hole) of a Polygon.
ja: ポリゴンのN番目の内環 (穴)を返します。

note: Tag: para
en: Returns the Nth interior ring (hole) of a POLYGON geometry as a LINESTRING. The index starts at 1. Returns NULL if the geometry is not a polygon or the index is out of range.
ja: ポリゴンのN番目の内環を返します。ジオメトリがポリゴンでないかNが範囲外の場合はNULLを返します。

note: Tag: refpurpose
en: Return the number of component curves in a CompoundCurve.
ja: 複合曲線内の曲線の数を返します。

note: Tag: para
en: Return the number of component curves in a CompoundCurve, zero for an empty CompoundCurve, or NULL for a non-CompoundCurve input.
ja: 複合曲線内の曲線の数を返します。入力が空の複合曲線の場合には0を返し、複合曲線でない場合にはNULLを返します。

note: Tag: refpurpose
en: Returns the Nth component curve geometry of a CompoundCurve.
ja: 複合曲線のＮ番目の曲線ジオメトリを返します。

note: Tag: para
en: Returns the Nth component curve geometry of a CompoundCurve. The index starts at 1. Returns NULL if the geometry is not a CompoundCurve or the index is out of range.
ja: 複合曲線のＮ番目の曲線ジオメトリを返します。インデックスは1始まりです。ジオメトリが複合曲線でない場合やインデックスが範囲外の場合にはNULLを返します。

note: Tag: refpurpose
en: Tests if a LineStrings's start and end points are coincident. For a PolyhedralSurface tests if it is closed (volumetric).
ja: ラインストリングの始点と終点が一致しているかをテストします。多面体サーフェスについては閉じているか (立体であるか)をテストします。

note: Tag: para
en: Returns <varname>TRUE</varname> if the <varname>LINESTRING</varname>'s start and end points are coincident. For Polyhedral Surfaces, reports if the surface is areal (open) or volumetric (closed).
ja: <varname>LINESTRING</varname>の始点と終点が一致する場合に<varname>TRUE</varname>を返します。多面体サーフェスについては、サーフェスが面 (開いている)か立体 (閉じている)かをテストします。

note: Tag: para
en: SQL-MM defines the result of <code>ST_IsClosed(NULL)</code> to be 0, while PostGIS returns <varname>NULL</varname>.
ja: SQL-MMでは<code>ST_IsClosed(NULL)</code>の結果は0と定義されていますが、PostGISでは<varname>NULL</varname>を返します。

note: Tag: title
en: Line String and Point Examples
ja: ラインストリングとポイントの例

note: Tag: title
en: Polyhedral Surface Examples
ja: 多面体サーフェスの例

note: Tag: refpurpose
en: Tests if a geometry is a geometry collection type.
ja: ジオメトリのタイプがジオメトリコレクションかをテストします。

note: Tag: para
en: Returns <varname>TRUE</varname> if the geometry type of the argument a geometry collection type. Collection types are the following:
ja: ジオメトリのタイプがジオメトリコレクションである場合に<varname>TRUE</varname>を返します。コレクションは次の通りです。

note: Tag: para
en: GEOMETRYCOLLECTION
ja: ジオメトリコレクション

note: Tag: para
en: MULTI{POINT,POLYGON,LINESTRING,CURVE,SURFACE}
ja: マルチポイント、マルチポリゴン、マルチラインストリング、マルチ曲線、マルチサーフェス

note: Tag: para
en: COMPOUNDCURVE
ja: 複合曲線

note: Tag: para
en: This function analyzes the type of the geometry. This means that it will return <varname>TRUE</varname> on collections that are empty or that contain a single element.
ja: この関数はジオメトリのタイプを解析します。これは、空のコレクションである場合、または一つのエレメントを持つコレクションである場合には<varname>TRUE</varname>を返すことを意味します。

note: Tag: refpurpose
en: Tests if a geometry is empty.
ja: ジオメトリが空かをテストします。

note: Tag: para
en: Returns true if this Geometry is an empty geometry. If true, then this Geometry represents an empty geometry collection, polygon, point etc.
ja: ジオメトリが空ジオメトリの場合にtrueを返します。 trueの場合には、このジオメトリは、空のジオメトリコレクション、ポリゴン、ポイント等です。

note: Tag: para
en: SQL-MM defines the result of ST_IsEmpty(NULL) to be 0, while PostGIS returns NULL.
ja: SQL-MMでは、ST_IsEmpty(NULL)は0を返しますが、PostGISではNULLを返します。

note: Tag: para
en: Changed: 2.0.0 In prior versions of PostGIS ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') was allowed. This is now illegal in PostGIS 2.0.0 to better conform with SQL/MM standards
ja: Changed: 2.0.0 以前の版のPostGISではST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)')を許しました。PostGIS 2.0.0では、SQL/MM標準により準拠させるため、これは不正となります。

note: Tag: refpurpose
en: Tests if Polygons have exterior rings oriented counter-clockwise and interior rings oriented clockwise.
ja: ポリゴンが反時計回りの外環を持っていて、時計回りの内環を持っているかをテストします。

note: Tag: para
en: Returns true if all polygonal components of the input geometry use a counter-clockwise orientation for their exterior ring, and a clockwise direction for all interior rings.
ja: 入力ジオメトリの全てのポリゴン要素の外環については反時計回りで、全ての内環については時計回りである場合には、TRUEを返します。

note: Tag: para
en: Returns true if the geometry has no polygonal components.
ja: ジオメトリがポリゴン要素を持っていない場合にはTRUEを返します。

note: Tag: para
en: Closed linestrings are not considered polygonal components, so you would still get a true return by passing a single closed linestring no matter its orientation.
ja: 閉じたラインストリングはポリゴン要素とみなされません。単一の閉じたラインストリングを渡すと、右回り左回りにかかわらずTRUEが得られます。

note: Tag: para
en: If a polygonal geometry does not use reversed orientation for interior rings (i.e., if one or more interior rings are oriented in the same direction as an exterior ring) then both ST_IsPolygonCW and ST_IsPolygonCCW will return false.
ja: ポリゴン要素の内環が逆回りになっていない (すなわち外環と同じ方向で回る内環が1個以上ある)場合には、ST_IsPolygonCWとST_IsPolygonCCW の両方ともにFALSEを返します。

note: Tag: refpurpose
en: Tests if Polygons have exterior rings oriented clockwise and interior rings oriented counter-clockwise.
ja: ポリゴンが時計回りの外環を持っていて、反時計回りの内環を持っているかをテストします。

note: Tag: para
en: Returns true if all polygonal components of the input geometry use a clockwise orientation for their exterior ring, and a counter-clockwise direction for all interior rings.
ja: 入力ジオメトリの全てのポリゴン要素の外環については時計回りで、全ての内環については反時計回りである場合には、TRUEを返します。

note: Tag: refpurpose
en: Tests if a LineString is closed and simple.
ja: ラインストリングが閉じていてかつ単純であるかをテストします。

note: Tag: para
en: Returns <varname>TRUE</varname> if this <varname>LINESTRING</varname> is both <xref linkend="ST_IsClosed"/> (<code>ST_StartPoint(g) ~= ST_Endpoint(g)</code>) and <xref linkend="ST_IsSimple"/> (does not self intersect).
ja: この<varname>LINESTRING</varname>が<xref linkend="ST_IsClosed"/>(<code>ST_StartPoint(g) ~= ST_Endpoint(g)</code>)かつ<xref linkend="ST_IsSimple"/>(自己交差していない)場合には<varname>TRUE</varname>を返します。

note: Tag: para
en: SQL-MM defines the result of <code>ST_IsRing(NULL)</code> to be 0, while PostGIS returns <varname>NULL</varname>.
ja: SQL-MMでは<code>ST_IsRing(NULL)</code>の結果は0と定義されていますが、PostGISでは<varname>NULL</varname>を返します。

note: Tag: refpurpose
en: Tests if a geometry has no points of self-intersection or self-tangency.
ja: ジオメトリが自己インタセクトまたは自己接触となるポイントが無いかをテストします。

note: Tag: para
en: Returns true if this Geometry has no anomalous geometric points, such as self-intersection or self-tangency. For more information on the OGC's definition of geometry simplicity and validity, refer to <link linkend="OGC_Validity">"Ensuring OpenGIS compliance of geometries"</link>
ja: ジオメトリが自己インタセクションや自己接触のような異常な幾何学ポイントを持っていない場合にTRUEを返します。OGCのジオメトリ単純性と妥当性の定義に関する詳細情報については<link linkend="OGC_Validity">「ジオメトリのOpenGIS準拠を確実にする」</link>をご覧ください。

note: Tag: para
en: SQL-MM defines the result of ST_IsSimple(NULL) to be 0, while PostGIS returns NULL.
ja: SQL-MMでは、ST_IsSimple(NULL)は0を返しますが、PostGISではNULLを返します。

note: Tag: refpurpose
en: Returns the M coordinate of a Point.
ja: ポイントのM値を返します。

note: Tag: para
en: Return the M coordinate of a Point, or NULL if not available. Input must be a Point.
ja: ポイントのM座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。

note: Tag: para
en: This is not (yet) part of the OGC spec, but is listed here to complete the point coordinate extractor function list.
ja: これは (いまだに)OGC仕様に入っていませんが、ポイント座標抽出関数のリストを完全にするために挙げています。

note: Tag: refpurpose
en: Returns the amount of memory space a geometry takes.
ja: ジオメトリが取るメモリ空間の合計を返します。

note: Tag: para
en: Returns the amount of memory space (in bytes) the geometry takes.
ja: ジオメトリが取るメモリ空間の合計をバイト単位で返します。

note: Tag: para
en: This complements the PostgreSQL built-in <link xlink:href="https://www.postgresql.org/docs/current/functions-admin.html#FUNCTIONS-ADMIN-DBOBJECT">database object functions</link> pg_column_size, pg_size_pretty, pg_relation_size, pg_total_relation_size.
ja: この関数は、PostgreSQLビルトイン<link xlink:href="https://www.postgresql.jp/document/current/html/functions-admin.html#FUNCTIONS-ADMIN-DBOBJECT">データベースオブジェクト管理関数</link>のpg_column_size, pg_size_pretty, pg_relation_size, pg_total_relation_sizeを補完します。

note: Tag: para
en: pg_relation_size which gives the byte size of a table may return byte size lower than ST_MemSize. This is because pg_relation_size does not add toasted table contribution and large geometries are stored in TOAST tables.
ja: テーブルのバイト単位のサイズを与えるpg_relation_sizeはST_Mem_Sizeより小さいバイト数が返ります。これはpg_relation_sizeがTOAST化されたテーブルの寄与を追加せず、TOASTテーブルに格納された大きなジオメトリを加えないためです。

note: Tag: para
en: pg_total_relation_size - includes, the table, the toasted tables, and the indexes.
ja: pg_total_relation_size - テーブル、TOASTテーブル、インデックスを含みます。

note: Tag: para
en: pg_column_size returns how much space a geometry would take in a column considering compression, so may be lower than ST_MemSize
ja: pg_column_sizeは、ジオメトリがカラム内で取る領域がどれだけかを、圧縮を考慮して返します。そのため、ST_MemSizeより小さくなることがあります。

note: Tag: para
en: Changed: 2.2.0 name changed to ST_MemSize to follow naming convention.
ja: Changed: 2.2.0 命名規則に従うためにST_MemSizeに変更しました。

note: Tag: refpurpose
en: Returns the coordinate dimension of a geometry.
ja: ST_Geometry値の座標次元を返します。

note: Tag: para
en: Returns the coordinate dimension of the geometry. PostGIS supports 2 - (x,y) , 3 - (x,y,z) or 2D with measure - x,y,m, and 4 - 3D with measure space x,y,z,m
ja: ジオメトリの座標次元返します。PostGISでは、2 - (X,Y), 3 - (X,Y,Z), (X,Y,M), 4 - (X,Y,Z,M)に対応しています。

note: Tag: refpurpose
en: Returns the number of points (vertices) in a geometry.
ja: ジオメトリのポイント (頂点)の数を返します。

note: Tag: para
en: Return the number of points in a geometry. Works for all geometries.
ja: ジオメトリのポイントの数を返します。全てのジオメトリに対して動作します。

note: Tag: refpurpose
en: Returns the number of rings in a polygonal geometry.
ja: ポリゴンジオメトリのリング数を返します。

note: Tag: para
en: If the geometry is a polygon or multi-polygon returns the number of rings. Unlike NumInteriorRings, it counts the outer rings as well.
ja: ジオメトリがポリゴンまたはマルチポリゴンの場合、リング数を返します。NumInteriorRingsと違い、外環も数えます。

note: Tag: refpurpose
en: Returns the number of elements in a geometry collection.
ja: ジオメトリコレクションの要素数を返します。

note: Tag: para
en: Returns the number of elements in a geometry collection (GEOMETRYCOLLECTION or MULTI*). For non-empty atomic geometries returns 1. For empty geometries returns 0.
ja: ジオメトリコレクション等(GEOMETRYCOLLECTIONやMULTI系)の要素数を返します。空ジオメトリでなく、ジオメトリコレクション等でもないジオメトリに対しては1を返します。空ジオメトリに対しては0を返します。

note: Tag: para
en: Changed: 2.0.0 In prior versions this would return NULL if the geometry was not a collection/MULTI type. 2.0.0+ now returns 1 for single geometries e.g POLYGON, LINESTRING, POINT.
ja: Changed: 2.0.0 前の版では、ジオメトリがコレクション/マルチ系でない場合にはNULLを返しました。2.0.0以上では、POLYGON, LINESTRING, POINTといった単一ジオメトリについては1を返します。

note: Tag: refpurpose
en: Returns the number of interior rings (holes) of a Polygon.
ja: ポリゴンの内環 (穴)の数を返します。

note: Tag: para
en: Return the number of interior rings of a polygon geometry. Return NULL if the geometry is not a polygon.
ja: ポリゴンジオメトリの内環の数を返します。ジオメトリがポリゴンでない場合には、NULLを返します。

note: Tag: para
en: Changed: 2.0.0 - in prior versions it would allow passing a MULTIPOLYGON, returning the number of interior rings of first POLYGON.
ja: Changed: 2.0.0 - 以前の版では、MULTIPOLYGONを渡して最初のPOLYGONの内環の数を返すことができました。

note: Tag: refpurpose
en: Returns the number of interior rings (holes) of a Polygon. Aias for ST_NumInteriorRings
ja: ポリゴンの内環 (穴)の数を返します。ST_NumInteriorRingsの別名です。

note: Tag: refpurpose
en: Return the number of faces on a Polyhedral Surface. Will return null for non-polyhedral geometries.
ja: 多面体サーフェスのフェイス数を返します。多面体でないジオメトリの場合にはNULLを返します。

note: Tag: para
en: Return the number of faces on a Polyhedral Surface. Will return null for non-polyhedral geometries. This is an alias for ST_NumGeometries to support MM naming. Faster to use ST_NumGeometries if you don't care about MM convention.
ja: 多面体サーフェスのフェイス数を返します。多面体でないジオメトリの場合にはNULLを返します。ST_NumGeometriesの別名で、MMの名前付けに対応するためのものです。MM規約を気にしない場合はST_NumGeometriesの方が速いです。

note: Tag: refpurpose
en: Returns the number of points in a LineString or CircularString.
ja: ラインストリングまたは曲線ストリングのポイント数を返します。

note: Tag: para
en: Return the number of points in an ST_LineString or ST_CircularString value. Prior to 1.4 only works with linestrings as the specs state. From 1.4 forward this is an alias for ST_NPoints which returns number of vertices for not just linestrings. Consider using ST_NPoints instead which is multi-purpose and works with many geometry types.
ja: ST_LineStringまたはST_CircularStringのポイント数を返します。1.4より前は仕様通りにラインストリングにのみ対応していました。1.4以上ではラインストリングだけでなく頂点数を返すST_NPointsの別名です。多目的で多数のジオメトリタイプで動作するST_NPointsを使うことを考えて下さい。

note: Tag: refpurpose
en: Returns the Nth geometry (face) of a PolyhedralSurface.
ja: 多面体サーフェスのN番目のジオメトリ (フェイス)を返します。

note: Tag: para
en: Returns the 1-based Nth geometry (face) if the geometry is a POLYHEDRALSURFACE or POLYHEDRALSURFACEM. Otherwise, returns NULL. This returns the same answer as ST_GeometryN for PolyhedralSurfaces. Using ST_GeometryN is faster.
ja: ジオメトリがPOLYHEDRALSURFACEかPOLYHEDRALSURFACEMの場合には、1始まりでN番目のジオメトリ (フェイス)を返します。それ以外の場合には、NULLを返します。多面体サーフェスを引数にとるST_GeometryNと同じ答えが返ります。ST_GeometryNの方が速いです。

note: Tag: para
en: Index is 1-based.
ja: インデクスは1始まりです。

note: Tag: para
en: If you want to extract all elements of a geometry <xref linkend="ST_Dump"/> is more efficient.
ja: ジオメトリの全ての要素を抽出するには<xref linkend="ST_Dump"/>が最も効率的です。

note: Tag: refpurpose
en: Returns the Nth point in the first LineString or circular LineString in a geometry.
ja: ジオメトリの最初のラインストリングまたは曲線ストリングのN番目のポイントを返します。

note: Tag: para
en: Return the Nth point in a single linestring or circular linestring in the geometry. Negative values are counted backwards from the end of the LineString, so that -1 is the last point. Returns NULL if there is no linestring in the geometry.
ja: ラインストリングまたは曲線ストリングのN番目の点を返します。負数はラインストリングの終端から逆方向に遡って数えます。-1は終端を指します。ジオメトリにラインストリングが無い場合には、NULLを返します。

note: Tag: para
en: Index is 1-based as for OGC specs since version 0.8.0. Backward indexing (negative index) is not in OGC Previous versions implemented this as 0-based instead.
ja: OGC仕様のため0.8.0版からインデックスを1始まりにしています。これより前の版では0はじまりになっています。後方インデックス (負数インデックス)はOGC仕様ではありません。

note: Tag: para
en: If you want to get the Nth point of each LineString in a MultiLineString, use in conjunction with ST_Dump
ja: マルチラインストリング内のラインストリングのN番目のポイントを得るには、ST_Dumpを併用します。

note: Tag: para
en: Changed: 2.0.0 no longer works with single geometry multilinestrings. In older versions of PostGIS -- a single line multilinestring would work happily with this function and return the start point. In 2.0.0 it just returns NULL like any other multilinestring.
ja: Changed: 2.0.0 単一ジオメトリのMULTILINESTRINGで動作しなくなりました。単一のラインストリングからなるMULTILINESTRINGについては幸運にも動いていて、最初のポイントを返していました。2.0.0では他のMULTILINESTRINGと同様にNULLを返すようになりました。

note: Tag: para
en: Changed: 2.3.0 : negative indexing available (-1 is last point)
ja: Changed: 2.3.0 : 負数インデックスが有効になりました (-1は終端を指します)

note: Tag: refpurpose
en: Returns a MultiPoint containing the coordinates of a geometry.
ja: ジオメトリの全ての座標を含むマルチポイントを返します。

note: Tag: para
en: Returns a MultiPoint containing all the coordinates of a geometry. Duplicate points are preserved, including the start and end points of ring geometries. (If desired, duplicate points can be removed by calling <xref linkend="ST_RemoveRepeatedPoints"/> on the result).
ja: ジオメトリの全ての座標を含むマルチポイントを返します。リングジオメトリの始点と終点を含む重複ポイントは保存されます (重複ポイントの削除が必要なら<xref linkend="ST_RemoveRepeatedPoints"/>を呼ぶと削除した結果が得られます)。

note: Tag: para
en: To obtain information about the position of each coordinate in the parent geometry use <xref linkend="ST_DumpPoints"/>.
ja: 親ジオメトリの個々の座標のポイントに関する情報を取得するには<xref linkend="ST_DumpPoints"/>を使います。

note: Tag: para
en: M and Z coordinates are preserved if present.
ja: M値とZ値が存在する場合には保持されます。

note: Tag: refpurpose
en: Returns the first point of a LineString.
ja: ラインストリングの始点を返します。

note: Tag: para
en: Returns the first point of a <varname>LINESTRING</varname> or <varname>CIRCULARLINESTRING</varname> geometry as a <varname>POINT</varname>. Returns <varname>NULL</varname> if the input is not a <varname>LINESTRING</varname> or <varname>CIRCULARLINESTRING</varname>.
ja: <varname>LINESTRING</varname>または<varname>CIRCULARLINESTRING</varname>ジオメトリの、最初のポイントを<varname>POINT</varname>で返します。入力パラメータが<varname>LINESTRING</varname>でも<varname>CIRCULARLINESTRING</varname>でもない場合には、<varname>NULL</varname>を返します。

note: Tag: para
en: Enhanced: 3.2.0 returns a point for all geometries. Prior behavior returns NULLs if input was not a LineString.
ja: Enhanced: 3.2.0 全てのジオメトリのポイントを返すようになりました。以前のバージョンではラインストリング以外ではNULLを返していました。

note: Tag: para
en: Changed: 2.0.0 no longer works with single geometry MultiLineStrings. In older versions of PostGIS a single-line MultiLineString would work happily with this function and return the start point. In 2.0.0 it just returns NULL like any other MultiLineString. The old behavior was an undocumented feature, but people who assumed they had their data stored as LINESTRING may experience these returning NULL in 2.0.0.
ja: Changed: 2.0.0 一つのMULTILINESTRINGで動作しなくなりました。PostGIS の古いバージョンでは、この関数は、一つのラインストリングからなるMULTILINESTRINGについては幸運にも動いていて、始端ポイントを返していました。2.0.0では他のMULTILINESTRINGと同様にNULLを返すようになりました。古い動作は文書化されていない機能でしたが、データをLINESTRINGとして格納していると思われるユーザーは、2.0.0 でNULLが返されることを経験するかも知れません。

note: Tag: para
en: Start point of a LineString
ja: ラインストリングの始端ポイント

note: Tag: para
en: Start point of a non-LineString is NULL
ja: ラインストリングでないものの始端ポイントはNULL

note: Tag: para
en: Start point of a 3D LineString
ja: 3次元ラインストリングの始端ポイント

note: Tag: para
en: Start point of a CircularString
ja: CIRCULARSTRINGの始端ポイント

note: Tag: refpurpose
en: Returns a text summary of the contents of a geometry.
ja: ジオメトリについての要約文を返します。

note: Tag: para
en: Returns a text summary of the contents of the geometry.
ja: ジオメトリについての要約文を返します。

note: Tag: para
en: Flags shown square brackets after the geometry type have the following meaning:
ja: ジオメトリ型の後の角括弧で示されたフラグには次の意味があります。

note: Tag: para
en: M: has M coordinate
ja: M: M軸を持ちます

note: Tag: para
en: Z: has Z coordinate
ja: Z: Z軸を持ちます

note: Tag: para
en: B: has a cached bounding box
ja: B: バウンディングボックスを持ちます

note: Tag: para
en: G: is geodetic (geography)
ja: G: 測地座標系 (ジオグラフィ)です

note: Tag: para
en: S: has spatial reference system
ja: S: 空間参照系を持ちます

note: Tag: para
en: Enhanced: 2.0.0 added support for geography
ja: Enhanced: 2.0.0でジオグラフィ対応が追加されました。

note: Tag: para
en: Enhanced: 2.1.0 S flag to denote if has a known spatial reference system
ja: Enhanced: 2.1.0 空間参照系を持つかを示すSフラグが追加されました。

note: Tag: para
en: Enhanced: 2.2.0 Added support for TIN and Curves
ja: Enhanced: 2.2.0 TINと曲線の対応が追加されました。

note: Tag: refpurpose
en: Returns the X coordinate of a Point.
ja: ポイントのX値を返します。

note: Tag: para
en: Return the X coordinate of the point, or NULL if not available. Input must be a point.
ja: ポイントのX座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。

note: Tag: para
en: To get the minimum and maximum X value of geometry coordinates use the functions <xref linkend="ST_XMin"/> and <xref linkend="ST_XMax"/>.
ja: ジオメトリのX値の最小値と最大値を得るには<xref linkend="ST_XMin"/>と<xref linkend="ST_XMax"/>を使います。

note: Tag: refpurpose
en: Returns the Y coordinate of a Point.
ja: ポイントのY値を返します。

note: Tag: para
en: Return the Y coordinate of the point, or NULL if not available. Input must be a point.
ja: ポイントのY座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。

note: Tag: para
en: To get the minimum and maximum Y value of geometry coordinates use the functions <xref linkend="ST_YMin"/> and <xref linkend="ST_YMax"/>.
ja: ジオメトリの値の最小値と最大値を得るには<xref linkend="ST_YMin"/>と<xref linkend="ST_YMax"/>を使います。

note: Tag: refpurpose
en: Returns the Z coordinate of a Point.
ja: ポイントのZ値を返します。

note: Tag: para
en: Return the Z coordinate of the point, or NULL if not available. Input must be a point.
ja: ポイントのZ座標値を返し、有効でないならNULLを返します。入力はポイントでなければなりません。

note: Tag: para
en: To get the minimum and maximum Z value of geometry coordinates use the functions <xref linkend="ST_ZMin"/> and <xref linkend="ST_ZMax"/>.
ja: ジオメトリのZ値の最小値と最大値を得るには<xref linkend="ST_ZMin"/>と<xref linkend="ST_ZMax"/>を使います。

note: Tag: refpurpose
en: <refpurpose>Returns a code indicating the ZM coordinate dimension of a geometry.</refpurpose>
ja: <refpurpose>ジオメトリのZM座標次元を示す符号を返します。</refpurpose>

note: Tag: para
en: <para>Returns a code indicating the ZM coordinate dimension of a geometry.</para>
ja: <para>ジオメトリのZM座標次元を示す符号を返します。</para>

note: Tag: para
en: Values are: 0 = 2D, 1 = 3D-M, 2 = 3D-Z, 3 = 4D.
ja: 値は 0=XY, 1=XYM, 2=XYZ, 3=XYZMとなります。

note: Tag: refpurpose
en: Checks if a geometry has a Z dimension.
ja: ジオメトリがZ値を持っているかどうかを確認します。

note: Tag: para
en: Checks if the input geometry has a Z dimension and returns a boolean value. If the geometry has a Z dimension, it returns true; otherwise, it returns false.
ja: 入力ジオメトリがZ値を持っているかどうかを確認して、真偽値を返します。ジオメトリがZ値を持っている場合にはTRUEを返し、そうでない場合にはFALSEを返します。

note: Tag: para
en: Geometry objects with a Z dimension typically represent three-dimensional (3D) geometries, while those without it are two-dimensional (2D) geometries.
ja: 通常は、Z値を持つジオメトリオブジェクトは3次元 (3D)ジオメトリを表現し、Z値を持たないものは2次元 (2D)ジオメトリとなります。

note: Tag: para
en: This function is useful for determining if a geometry has elevation or height information.
ja: この関数はジオメトリが標高や高さに関する情報を持つかどうかを判断するのに使います。

note: Tag: refpurpose
en: Checks if a geometry has an M (measure) dimension.
ja: ジオメトリがM値をもっているかどうかを確認します。

note: Tag: para
en: Checks if the input geometry has an M (measure) dimension and returns a boolean value. If the geometry has an M dimension, it returns true; otherwise, it returns false.
ja: 入力ジオメトリがM値を持っているかどうかを確認して、真偽値を返します。ジオメトリがM値を持っている場合にはTRUEを返し、そうでない場合にはFALSEを返します。

note: Tag: para
en: Geometry objects with an M dimension typically represent measurements or additional data associated with spatial features.
ja: M次元を持つジオメトリオブジェクトは通常、空間地物に関連付けられた計測値または追加データを表現します。

note: Tag: para
en: This function is useful for determining if a geometry includes measure information.
ja: この関数はジオメトリがM値に関する情報を持つかどうかを判断するのに使います。

note: Tag: title
en: Bounding Box Functions
ja: バウンディングボックス関数

note: Tag: para
en: These functions produce or operate on bounding boxes. They can also provide and accept geometry values, by using automatic or explicit casts.
ja: これらの関数は、バウンディングボックスを生成または操作します。自動キャストまたは明示的なキャストを使って、ジオメトリ値を提供し、受け付けます。

note: Tag: para
en: See also <xref linkend="PostGIS_BoxFunctions"/>.
ja: <xref linkend="PostGIS_BoxFunctions"/>を参照して下さい。

note: Tag: refpurpose
en: Returns a BOX2D representing the 2D extent of a geometry.
ja: ジオメトリの2次元範囲を表現するBOX2Dを返します。

note: Tag: para
en: Returns a <xref linkend="box2d_type"/> representing the 2D extent of the geometry.
ja: ジオメトリの2次元範囲を表現する<xref linkend="box2d_type"/>を返します。

note: Tag: refpurpose
en: Returns a BOX3D representing the 3D extent of a geometry.
ja: ジオメトリの3次元範囲を表現するBOX3Dを返します。

note: Tag: para
en: Returns a <xref linkend="box3d_type"/> representing the 3D extent of the geometry.
ja: ジオメトリの3次元範囲を表現する<xref linkend="box3d_type"/>を返します。

note: Tag: refpurpose
en: Returns the estimated extent of a spatial table.
ja: 空間テーブルの推定範囲を返します。

note: Tag: para
en: Returns the estimated extent of a spatial table as a <xref linkend="box2d_type"/>. The current schema is used if not specified. The estimated extent is taken from the geometry column's statistics. This is usually much faster than computing the exact extent of the table using <xref linkend="ST_Extent"/> or <xref linkend="ST_3DExtent"/>.
ja: 空間テーブルの推定範囲を<xref linkend="box2d_type"/>で返します。スキーマが指定されていない場合には現在のスキーマが使われます。推定範囲はジオメトリカラムの統計情報から取得します。これは通常は、<xref linkend="ST_Extent"/>または<xref linkend="ST_3DExtent"/>を使ってテーブルの確定範囲を計算するより、ずっと早く計算できます。

note: Tag: para
en: The default behavior is to also use statistics collected from child tables (tables with INHERITS) if available. If <varname>parent_only</varname> is set to TRUE, only statistics for the given table are used and child tables are ignored.
ja: 指定が無い場合には、子テーブル (INHERITSを使って作られたテーブル)が存在するなら、そこから得られた統計情報も使用します。<varname>parent_only</varname>がTRUEの場合には、パラメータで与えられたテーブルの統計情報だけが使用され、子テーブルの統計情報は無視されます。

note: Tag: para
en: For PostgreSQL &gt;= 8.0.0 statistics are gathered by VACUUM ANALYZE and the result extent will be about 95% of the actual one. For PostgreSQL &lt; 8.0.0 statistics are gathered by running <code>update_geometry_stats()</code> and the result extent is exact.
ja: PostgreSQL 8.0.0以上ではVACUUM ANALYZEで統計情報を集め、結果として得られる範囲は実際の95%程度です。PostgreSQL 8.0.0より前の場合には、<code>update_geometry_stats()</code>で統計情報が集められ、結果の範囲は確定値です。

note: Tag: para
en: In the absence of statistics (empty table or no ANALYZE called) this function returns NULL. Prior to version 1.5.4 an exception was thrown instead.
ja: 統計情報が無い (空のテーブルまたはANALYZEを実行していない)場合には、この関数はNULLを返します。1.5.4より前では、代わりに例外が投げられていました。

note: Tag: para
en: Escaping names for tables and/or namespaces that include special characters and quotes may require special handling. A user notes: "For schemas and tables, use identifier escaping rules to produce a double-quoted string, and afterwards remove the first and last double-quote character. For geometry column pass as is."
ja: テーブルや名前空間の名前のうち特殊文字や引用符をエスケープすると、特別な処理が必要になる可能性があります。あるユーザは「スキーマとテーブルでは、識別子エスケープ規則を使って、二重引用符を付けた文字列を生成して、その後最初と最後の二重引用符を削ります。ジオメトリカラムについてはそのまま渡します」

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Estimated_Extent.
ja: Changed: 2.1.0 2.0.xまではST_Estimated_Extentと呼ばれていました。

note: Tag: refpurpose
en: Returns a bounding box expanded from another bounding box or a geometry.
ja: 他のバウンディングボックスまたはジオメトリから拡張されたバウンディングボックスを返します。

note: Tag: para
en: Returns a bounding box expanded from the bounding box of the input, either by specifying a single distance with which the box should be expanded on both axes, or by specifying an expansion distance for each axis. Uses double-precision. Can be used for distance queries, or to add a bounding box filter to a query to take advantage of a spatial index.
ja: 入力のバウンディングボックスから拡張したバウンディングボックスを返します。一つの距離を指定して全ての方向に拡張するものと、方向ごとに距離を指定して拡張するものとがあります。倍精度浮動小数点を使います。距離に関するクエリで使いますし、空間インデックスの利点を得るために行うクエリへのフィルタを追加するために使います。

note: Tag: para
en: In addition to the version of ST_Expand accepting and returning a geometry, variants are provided that accept and return <xref linkend="box2d_type"/> and <xref linkend="box3d_type"/> data types.
ja: ST_Expandは、ジオメトリを受け付けジオメトリを返す版だけでなく、<xref linkend="box2d_type"/>や<xref linkend="box3d_type"/>のデータ型を受け付けて返す形式もあります。

note: Tag: para
en: Distances are in the units of the spatial reference system of the input.
ja: 距離の単位は入力の空間参照系の単位です。

note: Tag: para
en: ST_Expand is similar to <xref linkend="ST_Buffer"/>, except while buffering expands a geometry in all directions, ST_Expand expands the bounding box along each axis.
ja: ST_Expandは<xref linkend="ST_Buffer"/>と似ていますが、ST_Bufferではジオメトリを全ての方向に拡張するのに対して、ST_Expandはバウンディングボックスを各軸に沿って拡張する点が異なります。

note: Tag: para
en: Pre version 1.3, ST_Expand was used in conjunction with <xref linkend="ST_Distance"/> to do indexable distance queries. For example, <code>geom &amp;&amp; ST_Expand('POINT(10 20)', 10) AND ST_Distance(geom, 'POINT(10 20)') &lt; 10</code>. This has been replaced by the simpler and more efficient <xref linkend="ST_DWithin"/> function.
ja: 1.3より前の版では、インデックス化可能な距離クエリではST_Expandと<xref linkend="ST_Distance"/>とが組み合わせて使われていました。たとえば<code>geom &amp;&amp; ST_Expand('POINT(10 20)', 10) AND ST_Distance(geom, 'POINT(10 20)') &lt; 10</code>といったようになります。これはより単純でより効率的な<xref linkend="ST_DWithin"/>に置き換わりました。

note: Tag: para
en: Availability: 1.5.0 behavior changed to output double precision instead of float4 coordinates.
ja: Availability: 1.5.0 出力をfloat4座標値から倍精度に変更しました。

note: Tag: para
en: Enhanced: 2.3.0 support was added to expand a box by different amounts in different dimensions.
ja: Enhanced: 2.3.0 異なる次元の異なる量によるボックスの拡張に対応するようになりました。

note: Tag: para
en: Examples below use US National Atlas Equal Area (SRID=2163) which is a meter projection
ja: 次に示す例では、メートル単位の投影法である米国ナショナルアトラス正積図法 (SRID=2163)を使っています。

note: Tag: refpurpose
en: Aggregate function that returns the bounding box of geometries.
ja: ジオメトリのバウンディングボックスを返す集約関数です。

note: Tag: para
en: An aggregate function that returns a <xref linkend="box2d_type"/> bounding box that bounds a set of geometries.
ja: ジオメトリの集合の<xref linkend="box2d_type"/>バウンディングボックスを返す集約関数です。

note: Tag: para
en: The bounding box coordinates are in the spatial reference system of the input geometries.
ja: バウンディングボックスの座標は、入力ジオメトリの空間参照系に従います。

note: Tag: para
en: ST_Extent is similar in concept to Oracle Spatial/Locator's SDO_AGGR_MBR.
ja: ST_ExtentはOracle Spatial/LocatorのSDO_AGGR_MBRと似た発想のものです。

note: Tag: para
en: ST_Extent returns boxes with only X and Y ordinates even with 3D geometries. To return XYZ ordinates use <xref linkend="ST_3DExtent"/>.
ja: ST_Extentは、3次元ジオメトリであってもX値とY値だけを持つボックスを返します。Z値も得たいなら<xref linkend="ST_3DExtent"/>を使います。

note: Tag: para
en: The returned <code>box3d</code> value does not include a SRID. Use <xref linkend="ST_SetSRID"/> to convert it into a geometry with SRID metadata. The SRID is the same as the input geometries.
ja: 返された<code>box3d</code>値はSRIDを含みません。<xref linkend="ST_SetSRID"/>でSRIDメタデータを持つジオメトリに変換して下さい。SRIDは入力ジオメトリと同じです。

note: Tag: para
en: Examples below use Massachusetts State Plane ft (SRID=2249)
ja: 次に示す例では、フィート単位のマサチューセッツ州平面 (SRID=2249)を使っています。

note: Tag: refpurpose
en: Aggregate function that returns the 3D bounding box of geometries.
ja: ジオメトリの3次元バウンディングボックスを返す集約関数です。

note: Tag: para
en: An aggregate function that returns a <xref linkend="box3d_type"/> (includes Z ordinate) bounding box that bounds a set of geometries.
ja: ジオメトリ集合の<xref linkend="box3d_type"/> (Z値を持つ)を返す集約関数です。

note: Tag: para
en: Changed: 2.0.0 In prior versions this used to be called ST_Extent3D
ja: Changed: 2.0.0 以前の版ではST_Extent3Dと呼ばれていました。

note: Tag: refpurpose
en: Creates a BOX2D defined by two 2D point geometries.
ja: 二つの2次元のポイントジオメトリで定義されるBOX2Dを生成します。

note: Tag: para
en: Creates a <xref linkend="box2d_type"/> defined by two Point geometries. This is useful for doing range queries.
ja: 二つのポイントジオメトリで定義される<xref linkend="box2d_type"/> を生成します。これは範囲のクエリを実行する時に便利です。

note: Tag: refpurpose
en: Creates a BOX3D defined by two 3D point geometries.
ja: 二つの3次元のポイントジオメトリで定義されるBOX3Dを生成します。

note: Tag: para
en: Creates a <xref linkend="box3d_type"/> defined by two 3D Point geometries.
ja: 二つの3次元ポイントジオメトリで定義される<xref linkend="box3d_type"/>が生成されます。

note: Tag: para
en: This function supports 3D and will not drop the z-index.
ja: この関数は3次元に対応し、Z値を削除しません。

note: Tag: para
en: Changed: 2.0.0 In prior versions this used to be called ST_MakeBox3D
ja: Changed: 2.0.0以前の版ではST_MakeBox3Dと呼ばれていました。

note: Tag: refpurpose
en: <refpurpose>Returns the X maxima of a 2D or 3D bounding box or a geometry.</refpurpose>
ja: <refpurpose>2次元または3次元のバウンディングボックスまたはジオメトリのXの最大値を返します。</refpurpose>

note: Tag: para
en: <para>Returns the X maxima of a 2D or 3D bounding box or a geometry.</para>
ja: <para>2次元または3次元のバウンディングボックスまたはジオメトリのXの最大値を返します。</para>

note: Tag: para
en: Although this function is only defined for box3d, it also works for box2d and geometry values due to automatic casting. However, it will not accept a geometry or box2d text representation, since those do not auto-cast.
ja: この関数はbox3dだけをパラメータに取るよう定義されていますが、自動キャストを介してbox2dやジオメトリ値でも動作します。しかしながら、ジオメトリやbox2dの文字列表現は自動キャストを行わないため受け付けません。

note: Tag: refpurpose
en: <refpurpose>Returns the X minima of a 2D or 3D bounding box or a geometry.</refpurpose>
ja: <refpurpose>2次元または3次元のバウンディングボックスまたはジオメトリのXの最小値を返します。</refpurpose>

note: Tag: para
en: <para>Returns the X minima of a 2D or 3D bounding box or a geometry.</para>
ja: <para>2次元または3次元のバウンディングボックスまたはジオメトリのXの最小値を返します。</para>

note: Tag: para
en: Although this function is only defined for box3d, it also works for box2d and geometry values due to automatic casting. However it will not accept a geometry or box2d text representation, since those do not auto-cast.
ja: この関数はBOX3Dに対してのみ定義されていますが、自動キャストによってBOX2Dやジオメトリ値でも動作します。しかしながら、ジオメトリまたはBOX2Dの文字列表現は、自動キャストを行わないため、受け付けません。

note: Tag: refpurpose
en: <refpurpose>Returns the Y maxima of a 2D or 3D bounding box or a geometry.</refpurpose>
ja: <refpurpose>2次元または3次元のバウンディングボックスまたはジオメトリのYの最大値を返します。</refpurpose>

note: Tag: para
en: <para>Returns the Y maxima of a 2D or 3D bounding box or a geometry.</para>
ja: <para>2次元または3次元のバウンディングボックスまたはジオメトリのYの最大値を返します。</para>

note: Tag: refpurpose
en: <refpurpose>Returns the Y minima of a 2D or 3D bounding box or a geometry.</refpurpose>
ja: <refpurpose>2次元または3次元のバウンディングボックスまたはジオメトリのYの最小値を返します。</refpurpose>

note: Tag: para
en: <para>Returns the Y minima of a 2D or 3D bounding box or a geometry.</para>
ja: <para>2次元または3次元のバウンディングボックスまたはジオメトリのYの最小値を返します。</para>

note: Tag: refpurpose
en: <refpurpose>Returns the Z maxima of a 2D or 3D bounding box or a geometry.</refpurpose>
ja: <refpurpose>2次元または3次元のバウンディングボックスまたはジオメトリのZの最大値を返します。</refpurpose>

note: Tag: para
en: <para>Returns the Z maxima of a 2D or 3D bounding box or a geometry.</para>
ja: <para>2次元または3次元のバウンディングボックスまたはジオメトリのZの最大値を返します。</para>

note: Tag: refpurpose
en: <refpurpose>Returns the Z minima of a 2D or 3D bounding box or a geometry.</refpurpose>
ja: <refpurpose>2次元または3次元のバウンディングボックスまたはジオメトリのZの最小値を返します。</refpurpose>

note: Tag: para
en: <para>Returns the Z minima of a 2D or 3D bounding box or a geometry.</para>
ja: <para>2次元または3次元のバウンディングボックスまたはジオメトリのZの最小値を返します。</para>

note: Tag: title
en: Clustering Functions
ja: クラスタリング関数

note: Tag: para
en: These functions implement clustering algorithms for sets of geometries.
ja: これらの関数はジオメトリ集合に対するクラスタリングアルゴリズムを実装したものです。

note: Tag: refpurpose
en: Window function that returns a cluster id for each input geometry using the DBSCAN algorithm.
ja: 入力ジオメトリごとにDBSCANアルゴリズムを使ってクラスタ番号を返すウィンドウ関数です。

note: Tag: para
en: A window function that returns a cluster number for each input geometry, using the 2D <link xlink:href="https://en.wikipedia.org/wiki/DBSCAN">Density-based spatial clustering of applications with noise (DBSCAN)</link> algorithm. Unlike <xref linkend="ST_ClusterKMeans"/>, it does not require the number of clusters to be specified, but instead uses the desired <link linkend="ST_Distance">distance</link> (<varname>eps</varname>) and density (<varname>minpoints</varname>) parameters to determine each cluster.
ja: 2次元<link xlink:href="https://en.wikipedia.org/wiki/DBSCAN">Density-based spatial clustering of applications with noise (DBSCAN)</link>アルゴリズムを使って、入力ジオメトリ毎にクラスタ番号を返すウィンドウ関数です。<xref linkend="ST_ClusterKMeans"/>と違い、クラスタ数の指定は不要ですが、代わりに、クラスタを決定するために、期待する<link linkend="ST_Distance">距離</link>(<varname>eps</varname>)と密度(<varname>minpoints</varname>)のパラメータを使います。

note: Tag: para
en: An input geometry is added to a cluster if it is either:
ja: 入力ジオメトリは、次のいずれかの場合にはクラスタに追加されます:

note: Tag: para
en: A "core" geometry, that is within <varname>eps</varname> <link linkend="ST_Distance">distance</link> of at least <varname>minpoints</varname> input geometries (including itself); or
ja: 「核」ジオメトリという、入力ジオメトリ (自分を含む)のうち少なくとも<varname>minpoints</varname>個が<varname>eps</varname>で指定した<link linkend="ST_Distance">距離</link>の範囲内にあるもの。または

note: Tag: para
en: A "border" geometry, that is within <varname>eps</varname> <link linkend="ST_Distance">distance</link> of a core geometry.
ja: 「境界」ジオメトリという、核ジオメトリから<varname>eps</varname>で指定した<link linkend="ST_Distance">距離</link>の範囲内にあるものです。

note: Tag: para
en: Note that border geometries may be within <varname>eps</varname> distance of core geometries in more than one cluster. Either assignment would be correct, so the border geometry will be arbitrarily asssigned to one of the available clusters. In this situation it is possible for a correct cluster to be generated with fewer than <varname>minpoints</varname> geometries. To ensure deterministic assignment of border geometries (so that repeated calls to ST_ClusterDBSCAN will produce identical results) use an <code>ORDER BY</code> clause in the window definition. Ambiguous cluster assignments may differ from other DBSCAN implementations.
ja: 境界ジオメトリは、複数のクラスタの核ジオメトリの<varname>eps</varname>距離内に存在する場合があることに注意して下さい。どちらに割り当てても正しいので、境界ジオメトリは有効なクラスタの一つに任意に割り当てられます。この状況では、正しいクラスタが<varname>minpoints</varname>ジオメトリより少ないジオメトリで生成される可能性があります。境界ジオメトリの割当の決定性を確実にする (その結果、ST_ClusterDBSCANの呼び出しで同じ結果が生成される)には、ウィンドウ定義内で<code>ORDER BY</code>節を使います。あいまいなクラスタ割当は他のDBSCAN実装とは異なるかも知れません。

note: Tag: para
en: Geometries that do not meet the criteria to join any cluster are assigned a cluster number of NULL.
ja: どのクラスタとの結合の基準に合わないジオメトリは、NULLのクラスタ番号が割り当てられます。

note: Tag: para
en: Clustering polygon within 50 meters of each other, and requiring at least 2 polygons per cluster.
ja: 少なくともクラスタごとに二つ以上のポリゴンが必要な50メートル以内のクラスタ。

note: Tag: para
en: Clusters within 50 meters with at least 2 items per cluster. Singletons have NULL for cid
ja: 少なくともクラスタごとに二つ以上のポリゴンがある50メートル以内のクラスタ。一つだけならcidはNULL。

note: Tag: para
en: A example showing combining parcels with the same cluster number into geometry collections.
ja: 同じクラスタ番号の区画をジオメトリコレクションに合併する例。

note: Tag: refpurpose
en: Aggregate function that clusters input geometries into connected sets.
ja: 入力ジオメトリを接続関係にある集合にクラスタリングする集約関数です。

note: Tag: para
en: An aggregate function that returns an array of GeometryCollections partitioning the input geometries into connected clusters that are disjoint. Each geometry in a cluster intersects at least one other geometry in the cluster, and does not intersect any geometry in other clusters.
ja: 入力ジオメトリから接続されたものをクラスタとし、クラスタ間は接続されていないように分割してGEOMETRYCOLLECTIONの配列を返す集約関数です。クラスタ内の個々のジオメトリは同一クラスタ内の他のジオメトリの少なくとも一つとインタセクトし、他のクラスタ内のいずれのジオメトリともインタセクトしません。

note: Tag: refpurpose
en: Window function that returns a cluster id for each input geometry, clustering input geometries into connected sets.
ja: 入力ジオメトリごとに接続された集合にクラスタリングを行い、クラスタIDを返すウィンドウ関数です。

note: Tag: para
en: A window function that builds connected clusters of geometries that intersect. It is possible to traverse all geometries in a cluster without leaving the cluster. The return value is the cluster number that the geometry argument participates in, or null for null inputs.
ja: インタセクトするジオメトリの接続されたクラスタを構築するウィンドウ関数です。クラスタを離れることなく、クラスタ内の全てのジオメトリを走査することができます。返り値はジオメトリ引数が入っているクラスタの番号です。入力がNULLの場合にはNULLを返します。

note: Tag: refpurpose
en: Window function that returns a cluster id for each input geometry using the K-means algorithm.
ja: 入力ジオメトリごとにk平均法アルゴリズムを使ってクラスタ番号を返すウィンドウ関数です。

note: Tag: para
en: Returns <link xlink:href="https://en.wikipedia.org/wiki/K-means_clustering">K-means</link> cluster number for each input geometry. The distance used for clustering is the distance between the centroids for 2D geometries, and distance between bounding box centers for 3D geometries. For POINT inputs, M coordinate will be treated as weight of input and has to be larger than 0.
ja: 入力ジオメトリごとの<link xlink:href="https://en.wikipedia.org/wiki/K-means_clustering">K平均法</link>のクラスタ番号を返します。クラスタリングに使われる距離は、2次元ジオメトリでは重心間の距離、3次元ジオメトリではバウンディングボックスの中心点間の距離です。POINT入力では、M値は入力の重みとして扱われ、0より大きくなければなりません。

note: Tag: para
en: <varname>max_radius</varname>, if set, will cause ST_ClusterKMeans to generate more clusters than <varname>k</varname> ensuring that no cluster in output has radius larger than <varname>max_radius</varname>. This is useful in reachability analysis.
ja: <varname>max_radius</varname>が設定されている場合には、ST_ClusterKMeansは、出力クラスタが<varname>max_radius</varname>より半径が大きいクラスタを作らなくなるので、<varname>k</varname>より多いクラスタを生成します。到達可能性分析に使います。

note: Tag: para
en: Enhanced: 3.2.0 Support for <varname>max_radius</varname>
ja: Enhanced: 3.2.0 <varname>max_radius</varname>パラメータに対応しました

note: Tag: para
en: Enhanced: 3.1.0 Support for 3D geometries and weights
ja: Enhanced: 3.1.0 3次元ジオメトリと重みに対応するようになりました

note: Tag: para
en: Generate dummy set of parcels for examples:
ja: 例としてダミーの区画の集合を生成します:

note: Tag: para
en: Parcels color-coded by cluster number (cid)
ja: クラスタ番号 (cid)による色付けを施した区画

note: Tag: para
en: Partitioning parcel clusters by type:
ja: タイプ別による区画の分割:

note: Tag: para
en: Example: Clustering a preaggregated planetary-scale data population dataset using 3D clusering and weighting. Identify at least 20 regions based on <link xlink:href="https://data.humdata.org/dataset/kontur-population-dataset">Kontur Population Data</link> that do not span more than 3000 km from their center:
ja: 例: 3次元クラスタリングと重み付けを使った、事前集計した地球規模の人口データセットのクラスタリング。<link xlink:href="https://data.humdata.org/dataset/kontur-population-dataset">Kontur Population Data</link>に基づいて、中心から3000km以下となる、少なくとも 20 の地域が識別されます:

note: Tag: para
en: World population clustered to above specs produces 46 clusters. Clusters are centered at well-populated regions (New York, Moscow). Greenland is one cluster. There are island clusters that span across the antimeridian. Cluster edges follow Earth's curvature.
ja: 世界人口を上記仕様でクラスタリングして、46のクラスタを得ました。人口集中地域 (ニューヨーク、モスクワ)にクラスタの中心が来ます。グリーンランドは一つのクラスタです。日付変更線をまたぐクラスタがあります。クラスタのエッジは地球の曲線に従います。

note: Tag: refpurpose
en: Aggregate function that clusters geometries by separation distance.
ja: 分離距離でジオメトリのクラスタリングを行う集約関数です。

note: Tag: para
en: An aggregate function that returns an array of GeometryCollections, where each collection is a cluster containing some input geometries. Clustering partitions the input geometries into sets in which each geometry is within the specified <parameter>distance</parameter> of at least one other geometry in the same cluster. Distances are Cartesian distances in the units of the SRID.
ja: GEOMETRYCOLLECTIONの配列を返す集約関数で、個々の要素は入力ジオメトリを含むクラスタです。クラスタリングは入力ジオメトリを、それぞれのジオメトリが、同じクラスタ内の他のジオメトリのうち少なくとも一つとの距離が<parameter>distance</parameter>以内となる集合に分割します。距離はSRIDの単位を取るデカルト距離です。

note: Tag: para
en: ST_ClusterWithin is equivalent to running <xref linkend="ST_ClusterDBSCAN"/> with <code>minpoints =&gt; 0</code>.
ja: ST_ClusterWithin は、<xref linkend="ST_ClusterDBSCAN"/> を <code>minpoints =&gt; 0</code> で実行するのと同じです。

note: Tag: refpurpose
en: Window function that returns a cluster id for each input geometry, clustering using separation distance.
ja: 入力ジオメトリごとに分離距離を使ったクラスタリングを行い、クラスタIDを返すウィンドウ関数です。

note: Tag: para
en: A window function that returns a cluster number for each input geometry. Clustering partitions the geometries into sets in which each geometry is within the specified <varname>distance</varname> of at least one other geometry in the same cluster. Distances are Cartesian distances in the units of the SRID.
ja: 入力ジオメトリ毎のクラスタ番号を返すウィンドウ関数です。クラスタリングはジオメトリを、それぞれのジオメトリが、同じクラスタ内の他のジオメトリのうち少なくとも一つとの距離が<varname>distance</varname>以内となる集合に分割します。距離はSRIDの単位を取るデカルト距離です。

note: Tag: para
en: ST_ClusterWithinWin is equivalent to running <xref linkend="ST_ClusterDBSCAN"/> with <code>minpoints =&gt; 0</code>.
ja: ST_ClusterWithinWin は、<xref linkend="ST_ClusterDBSCAN"/> を <code>minpoints =&gt; 0</code> で実行するのと同じです。

note: Tag: title
en: Geometry Constructors
ja: ジオメトリ コンストラクタ

note: Tag: refpurpose
en: Creates a GeometryCollection or Multi* geometry from a set of geometries.
ja: ジオメトリの集合からジオメトリコレクションまたはマルチ系ジオメトリを生成します。

note: Tag: para
en: Collects geometries into a geometry collection. The result is either a Multi* or a GeometryCollection, depending on whether the input geometries have the same or different types (homogeneous or heterogeneous). The input geometries are left unchanged within the collection.
ja: ジオメトリを集めてジオメトリコレクションにします。結果はマルチ系ジオメトリかジオメトリコレクションかのいずれかで、この差は、入力ジオメトリのタイプが同じか異なるか(均質か不均質か)で決まります。入力ジオメトリはコレクション内で変更されることはありません。

note: Tag: para
en: <emphasis role="bold">Variant 1:</emphasis> accepts two input geometries
ja: <emphasis role="bold">1番目の形式:</emphasis> 二つの入力ジオメトリを受け付ける。

note: Tag: para
en: <emphasis role="bold">Variant 2:</emphasis> accepts an array of geometries
ja: <emphasis role="bold">2番目の形式:</emphasis> ジオメトリの配列を受け付ける。

note: Tag: para
en: <emphasis role="bold">Variant 3:</emphasis> aggregate function accepting a rowset of geometries.
ja: <emphasis role="bold">3番目の形式:</emphasis> ジオメトリの行集合を受け付ける集約関数。

note: Tag: para
en: If any of the input geometries are collections (Multi* or GeometryCollection) ST_Collect returns a GeometryCollection (since that is the only type which can contain nested collections). To prevent this, use <xref linkend="ST_Dump"/> in a subquery to expand the input collections to their atomic elements (see example below).
ja: 入力ジオメトリのいずれかがコレクション (マルチ系ジオメトリまたはジオメトリコレクション)の場合には、ST_Collectはジオメトリコレクションを返します (入れ子になったコレクションを含む唯一のタイプであるため)。これを避けるには、サブクエリで<xref linkend="ST_Dump"/> を使い、入力コレクションを分解できない要素にまで分解します (下に例があります)。

note: Tag: para
en: ST_Collect and <xref linkend="ST_Union"/> appear similar, but in fact operate quite differently. ST_Collect aggregates geometries into a collection without changing them in any way. ST_Union geometrically merges geometries where they overlap, and splits linestrings at intersections. It may return single geometries when it dissolves boundaries.
ja: ST_Collectと<xref linkend="ST_Union"/>は似ているように見えますが、実際には全く異なる処理を行います。ST_Collectは入力ジオメトリを変更せずにコレクションにする集約関数です。ST_Unionは、オーバラップしている時は幾何学的に併合し、インタセクトするところでラインストリングを分割します。境界をディゾルブするときには単一のジオメトリを返す可能性があります。

note: Tag: para
en: Availability: 1.4.0 - ST_Collect(geomarray) was introduced. ST_Collect was enhanced to handle more geometries faster.
ja: Availability: 1.4.0 - ST_Collect(geometry)が導入されました。ST_Collectがより多くのジオメトリをより早く扱えるよう強化されました。

note: Tag: title
en: Examples - Two-input variant
ja: 例 - 二つ入力を引数に取る形式

note: Tag: para
en: Collect 2D points.
ja: 2次元ポイントを収集します。

note: Tag: para
en: Collect 3D points.
ja: 2次元ポイントの収集

note: Tag: para
en: Collect curves.
ja: 曲線を収集します。

note: Tag: title
en: Examples - Array variant
ja: 例 - 配列を引数に取る形式

note: Tag: para
en: Using an array constructor for a subquery.
ja: サブクエリから配列を生成するコンストラクタの使用。

note: Tag: para
en: Using an array constructor for values.
ja: 値から配列を生成するコンストラクタの使用。

note: Tag: title
en: Examples - Aggregate variant
ja: 例 - 集約関数の形式

note: Tag: para
en: Creating multiple collections by grouping geometries in a table.
ja: テーブル内のジオメトリのグループ化による複数コレクションを生成します。

note: Tag: refpurpose
en: <refpurpose>Creates a LineString from a MultiPoint geometry.</refpurpose>
ja: <refpurpose>マルチポイントジオメトリからラインストリングを生成します。</refpurpose>

note: Tag: para
en: <para>Creates a LineString from a MultiPoint geometry.</para>
ja: <para>マルチポイントジオメトリからラインストリングを生成します。</para>

note: Tag: para
en: Use <xref linkend="ST_MakeLine"/> to create lines from Point or LineString inputs.
ja: ポイントまたはラインストリングの入力からラインを生成するには<xref linkend="ST_MakeLine"/>を使います。

note: Tag: para
en: Create a 3D line string from a 3D MultiPoint
ja: マルチポイントジオメトリからラインストリングを生成します。

note: Tag: refpurpose
en: Creates a rectangular Polygon from minimum and maximum coordinates.
ja: 座標値の最小値と最大値から矩形ポリゴンを生成します。

note: Tag: para
en: Creates a rectangular Polygon from the minimum and maximum values for X and Y. Input values must be in the spatial reference system specified by the SRID. If no SRID is specified the unknown spatial reference system (SRID 0) is used.
ja: XとYの最小値と最大値から矩形ポリゴンを生成します。入力値はSRIDで指定された空間参照系に合わせなければなりません。SRIDが指定されていない場合には、不明な空間参照系 (SRID 0)が使われます。

note: Tag: para
en: Enhanced: 2.0: Ability to specify an envelope without specifying an SRID was introduced.
ja: Enhanced: 2.0 SRID指定なしでエンベロープを指定できるようになりました。

note: Tag: title
en: Example: Building a bounding box polygon
ja: 例: バウンディングボックスポリゴンの生成

note: Tag: refpurpose
en: Creates a LineString from Point, MultiPoint, or LineString geometries.
ja: POINT、MULTIPOINT、LINESTRINGからLINESTRINGを生成します。

note: Tag: para
en: Creates a LineString containing the points of Point, MultiPoint, or LineString geometries. Other geometry types cause an error.
ja: ポイント、マルチポイントまたはラインストリングのジオメトリの点を含むラインストリングを生成します。他のジオメトリではエラーが発生します。

note: Tag: para
en: <emphasis role="bold">Variant 3:</emphasis> aggregate function accepting a rowset of geometries. To ensure the order of the input geometries use <varname>ORDER BY</varname> in the function call, or a subquery with an <varname>ORDER BY</varname> clause.
ja: <emphasis role="bold">形式3:</emphasis> ジオメトリの行集合を受け付ける約関数。入力ジオメトリの順序を確実にするには、関数呼び出しで<varname>ORDER BY</varname>を使うか、<varname>ORDER BY</varname>節を持つサブクエリを使います。

note: Tag: para
en: Repeated nodes at the beginning of input LineStrings are collapsed to a single point. Repeated points in Point and MultiPoint inputs are not collapsed. <xref linkend="ST_RemoveRepeatedPoints"/> can be used to collapse repeated points from the output LineString.
ja: 入力ラインストリングの開始位置で重複するノードは単一のポイントに減らされます。ポイントとマルチポイントの入力での重複するポイントは減らされません。出力ラインストリングから重複ポイントを削除するには<xref linkend="ST_RemoveRepeatedPoints"/>が使えます。

note: Tag: para
en: Availability: 2.3.0 - Support for MultiPoint input elements was introduced
ja: Availability: 2.3.0 - MULTIPOINT入力要素への対応が導入されました

note: Tag: para
en: Availability: 2.0.0 - Support for LineString input elements was introduced
ja: Availability: 2.0.0 - LINESTRING入力要素への対応が導入されました

note: Tag: para
en: Availability: 1.4.0 - ST_MakeLine(geomarray) was introduced. ST_MakeLine aggregate functions was enhanced to handle more points faster.
ja: Availability: 1.4.0 - ST_MakeLine(geomarray)が導入されました。ST_MakeLine集約関数はより多くのポイントをより早く扱うための強化が施されています。

note: Tag: title
en: Examples: Two-input variant
ja: 例: 二つ入力を引数に取る形式

note: Tag: para
en: Create a line composed of two points.
ja: 二つのポイントで構成されるラインを生成します。

note: Tag: para
en: Create a 3D line from two 3D points.
ja: 二つの3次元ポイントから3次元ラインを生成します。

note: Tag: para
en: Create a line from two disjoint LineStrings.
ja: 二つの接続されていないラインストリングからラインを生成します。

note: Tag: title
en: Examples: Array variant
ja: 例: 配列を引数に取る形式

note: Tag: para
en: Create a line from an array formed by a subquery with ordering.
ja: 並べ替えを伴うサブクエリで作られた配列からラインを生成します。

note: Tag: para
en: Create a 3D line from an array of 3D points
ja: 3次元ポイントの配列から3次元ラインを生成します。

note: Tag: title
en: Examples: Aggregate variant
ja: 例: 集約関数の形式

note: Tag: para
en: This example queries time-based sequences of GPS points from a set of tracks and creates one record for each track. The result geometries are LineStrings composed of the GPS track points in the order of travel.
ja: この例ではGPSトラックの集合からポイントの時間ベースのシーケンスを問い合わせています。結果ジオメトリは、GPSトラックの移動順ポイントで構成されるラインストリングです。

note: Tag: para
en: Using aggregate <varname>ORDER BY</varname> provides a correctly-ordered LineString.
ja: <varname>ORDER BY</varname>節を使うことで、正しい順序のLINESTRINGが生成できます。

note: Tag: para
en: Prior to PostgreSQL 9, ordering in a subquery can be used. However, sometimes the query plan may not respect the order of the subquery.
ja: PostgreSQL 9より前の版では、サブクエリでの順序付けを使うことができます。ただし、クエリプランでサブクエリの並び順が尊重されない場合があります。

note: Tag: refpurpose
en: Creates a 2D, 3DZ or 4D Point.
ja: 2次元、3次元 (XYZ)、4次元のポイントを生成します。

note: Tag: para
en: Creates a 2D XY, 3D XYZ or 4D XYZM Point geometry. Use <xref linkend="ST_MakePointM"/> to make points with XYM coordinates.
ja: XY 2次元、XYZ 3次元、XYZM 4次元のポイントジオメトリを生成します。XYM座標のポイントを生成するには <xref linkend="ST_MakePointM"/> を使用します。

note: Tag: para
en: Use <xref linkend="ST_SetSRID"/> to specify a SRID for the created point.
ja: 生成したポイントのSRIDを指定するには<xref linkend="ST_SetSRID"/>を使います。

note: Tag: para
en: While not OGC-compliant, <varname>ST_MakePoint</varname> is faster and more precise than <xref linkend="ST_GeomFromText"/> and <xref linkend="ST_PointFromText"/>. It is also easier to use for numeric coordinate values.
ja: OGC準拠ではありませんが、<varname>ST_MakePoint</varname>は<xref linkend="ST_GeomFromText"/>や<xref linkend="ST_PointFromText"/>より高速かつ正確です。また、簡単に数値の座標値を使用できます。

note: Tag: para
en: For geodetic coordinates, <varname>X</varname> is longitude and <varname>Y</varname> is latitude
ja: 地理座標系について、<varname>X</varname>は経度で、<varname>Y</varname>は緯度です。

note: Tag: para
en: The functions <xref linkend="ST_Point"/>, <xref linkend="ST_PointZ"/>, <xref linkend="ST_PointM"/>, and <xref linkend="ST_PointZM"/> can be used to create points with a given SRID.
ja: <xref linkend="ST_Point"/>, <xref linkend="ST_PointZ"/>, <xref linkend="ST_PointM"/>, <xref linkend="ST_PointZM"/>関数を使用すると、与えられたSRIDを持つポイントを生成することができます。

note: Tag: refpurpose
en: Creates a Point from X, Y and M values.
ja: X, Y, M値からポイントを生成します。

note: Tag: para
en: Creates a point with X, Y and M (measure) ordinates. Use <xref linkend="ST_MakePoint"/> to make points with XY, XYZ, or XYZM coordinates.
ja: X, Y, M座標値を持つポイントを生成します。XY, XYZ, XYZM座標のポイントを生成するには<xref linkend="ST_MakePoint"/>を使います。

note: Tag: para
en: The functions <xref linkend="ST_PointM"/>, and <xref linkend="ST_PointZM"/> can be used to create points with an M value and a given SRID.
ja: <xref linkend="ST_PointM"/>, <xref linkend="ST_PointZM"/>関数を使うと、与えられたSRIDを持ち、M値を持つポイントを生成することができます。

note: Tag: para
en: is used for text output because <xref linkend="ST_AsText"/> does not support M values.
ja: は文字列出力のために使います。<xref linkend="ST_AsText"/>がM値に対応していないためです。

note: Tag: para
en: Create point with unknown SRID.
ja: 不明なSRIDでのポイントを生成します。

note: Tag: para
en: Create point with a measure in the WGS 84 geodetic coordinate system.
ja: WGS 84地理座標系のM値を持つポイントの生成。

note: Tag: para
en: Get measure of created point.
ja: 生成したポイントのM値を取得します。

note: Tag: refpurpose
en: Creates a Polygon from a shell and optional list of holes.
ja: 外殻と穴のリストからポリゴンを生成します。

note: Tag: para
en: Creates a Polygon formed by the given shell and optional array of holes. Input geometries must be closed LineStrings (rings).
ja: 与えられた外殻と任意指定の穴の配列で掲載されるポリゴンを生成します。入力ジオメトリは閉じたラインストリング (リング)でなければなりません。

note: Tag: para
en: <emphasis role="bold">Variant 1:</emphasis> Accepts one shell LineString.
ja: <emphasis role="bold">形式1:</emphasis> 一つの外殻のラインストリングを受け付けます。

note: Tag: para
en: <emphasis role="bold">Variant 2:</emphasis> Accepts a shell LineString and an array of inner (hole) LineStrings. A geometry array can be constructed using the PostgreSQL array_agg(), ARRAY[] or ARRAY() constructs.
ja: <emphasis role="bold">形式2:</emphasis> 外殻のラインストリングと内部 (穴)のラインストリングの配列とを受け付けます。ジオメトリ配列はPostgreSQLのarray_agg(), ARRAY[], ARRAY()コンストラクタを使います。

note: Tag: para
en: This function does not accept MultiLineStrings. Use <xref linkend="ST_LineMerge"/> to generate a LineString, or <xref linkend="ST_Dump"/> to extract LineStrings.
ja: この関数はマルチラインストリングを受け付けません。ラインストリングの生成には<xref linkend="ST_LineMerge"/>を使用します。また、ラインストリングを抽出するには<xref linkend="ST_Dump"/>を使用します。

note: Tag: title
en: Examples: Single input variant
ja: 例: 単一入力の形式

note: Tag: para
en: Create a Polygon from a 2D LineString.
ja: 2次元ラインストリングからポリゴンを生成します。

note: Tag: para
en: Create a Polygon from an open LineString, using <xref linkend="ST_StartPoint"/> and <xref linkend="ST_AddPoint"/> to close it.
ja: 開いたラインストリングを閉じるために<xref linkend="ST_StartPoint"/>と<xref linkend="ST_AddPoint"/>を使用したうえでポリゴンを生成します。

note: Tag: para
en: Create a Polygon from a 3D LineString
ja: 3次元ラインストリングからポリゴンを生成します。

note: Tag: para
en: Create a Polygon from a LineString with measures
ja: M値を持つラインストリングからポリゴンを生成します。

note: Tag: title
en: Examples: Outer shell with inner holes variant
ja: 例: 内部の穴を持つ外殻の形式

note: Tag: para
en: Create a donut Polygon with an extra hole
ja: 余分な穴を持つドーナツポリゴンを生成します。

note: Tag: para
en: Create a set of province boundaries with holes representing lakes. The input is a table of province Polygons/MultiPolygons and a table of water linestrings. Lines forming lakes are determined by using <xref linkend="ST_IsClosed"/>. The province linework is extracted by using <xref linkend="ST_Boundary"/>. As required by <code>ST_MakePolygon</code>, the boundary is forced to be a single LineString by using <xref linkend="ST_LineMerge"/>. (However, note that if a province has more than one region or has islands this will produce an invalid polygon.) Using a LEFT JOIN ensures all provinces are included even if they have no lakes.
ja: 湖を表現する穴を持つ県の境界の集合を生成します。入力は県ポリゴン/マルチポリゴンのテーブルと水涯線のラインストリングのテーブルです。湖を構成するラインは<xref linkend="ST_IsClosed"/>で判定します。県を示すラインは<xref linkend="ST_Boundary"/>で抽出します。<code>ST_MakePolygon</code>が必要ですので、境界を<xref linkend="ST_LineMerge"/>で単一のLINESTRINGに強制します(県が二つ以上の領域を持つか島を持つ場合には、不正なポリゴンを生成します)。LEFT JOINを使って、湖の無い県を含む全ての県が返ることを保証しています。

note: Tag: para
en: The CASE construct is used because passing a null array into ST_MakePolygon results in a NULL return value.
ja: NULL配列をST_MakePolygonに渡すとNULLが返るので、CASE式を使っています。

note: Tag: para
en: Another technique is to utilize a correlated subquery and the ARRAY() constructor that converts a row set to an array.
ja: 他には、相関サブクエリと行集合を配列に変換するARRAY()コンストラクタとを使う手法があります。

note: Tag: refpurpose
en: Creates a Point with X, Y and SRID values.
ja: X, YとSRIDの値からポイントを生成します。

note: Tag: para
en: Returns a Point with the given X and Y coordinate values. This is the SQL-MM equivalent for <xref linkend="ST_MakePoint"/> that takes just X and Y.
ja: 与えられたXとYの座標値からポイントを返します。これは、XとYを取るSQL-MMの<xref linkend="ST_MakePoint"/>と同等です。

note: Tag: para
en: Enhanced: 3.2.0 srid as an extra optional argument was added. Older installs require combining with ST_SetSRID to mark the srid on the geometry.
ja: Enhanced: 3.2.0 SRID任意引数が追加されました。古いバージョンでは、ジオメトリにSRIDを与えるにはST_SetSRIDを併用しなければなりませんでした。

note: Tag: title
en: Examples: Geometry
ja: 例: ジオメトリ

note: Tag: para
en: Creating a point with SRID specified:
ja: 指定したSRIDを持つポイントの生成:

note: Tag: para
en: Alternative way of specifying SRID:
ja: SRIDを指定する別の方法:

note: Tag: title
en: Examples: Geography
ja: 例: ジオグラフィ

note: Tag: para
en: Create <link linkend="PostGIS_Geography">geography</link> points using the <varname>::</varname> cast syntax:
ja: <link linkend="PostGIS_Geography">ジオグラフィ</link>のポイントを、キャストの書き方 <varname>::</varname> を使って生成します:

note: Tag: para
en: Pre-PostGIS 3.2 code, using <varname>CAST</varname>:
ja: PostGIS 3.2より前のコードでは<varname>CAST</varname>を使います:

note: Tag: para
en: If the point coordinates are not in a geodetic coordinate system (such as WGS84), then they must be reprojected before casting to a geography. In this example a point in Pennsylvania State Plane feet (SRID 2273) is projected to WGS84 (SRID 4326).
ja: ポイントの座標が地理座標系 (WGS84等)でない場合には、ジオグラフィにキャストする前に座標系変換を行う必要があります。この例では、ペンシルバニア州平面フィート (SRID 2273)上のポイントをWGS84 (SRID 4326)に座標系変換を行っています。

note: Tag: refpurpose
en: Creates a Point with X, Y, Z and SRID values.
ja: X, Y, ZとSRIDの値からポイントを生成します。

note: Tag: para
en: Returns an Point with the given X, Y and Z coordinate values, and optionally an SRID number.
ja: 与えたX,Y,Z座標値を持ち、与えた場合はSRID値も持つポイントを生成します。

note: Tag: refpurpose
en: Creates a Point with X, Y, M and SRID values.
ja: X, Y, MとSRIDの値からポイントを生成します。

note: Tag: para
en: Returns an Point with the given X, Y and M coordinate values, and optionally an SRID number.
ja: 与えたX,Y,M座標値を持ち、与えた場合はSRID値も持つポイントを生成します。

note: Tag: refpurpose
en: Creates a Point with X, Y, Z, M and SRID values.
ja: X, Y, Z, MとSRIDの値からポイントを生成します。

note: Tag: para
en: Returns an Point with the given X, Y, Z and M coordinate values, and optionally an SRID number.
ja: 与えたX,Y,Z,M座標値を持ち、与えた場合はSRID値も持つポイントを生成します。

note: Tag: refpurpose
en: Creates a Polygon from a LineString with a specified SRID.
ja: ラインストリングから指定したSRIDを持つポリゴンを生成します。

note: Tag: para
en: Returns a polygon built from the given LineString and sets the spatial reference system from the <varname>srid</varname>.
ja: 与えられたラインストリングから構築し、<varname>srid</varname>から空間参照系を指定したポリゴンを返します。

note: Tag: para
en: ST_Polygon is similar to <xref linkend="ST_MakePolygon"/> Variant 1 with the addition of setting the SRID.
ja: ST_Polygonは<xref linkend="ST_MakePolygon"/>の形式1の、SRIDの設定を追加したものに似ています。

note: Tag: para
en: To create polygons with holes use <xref linkend="ST_MakePolygon"/> Variant 2 and then <xref linkend="ST_SetSRID"/>.
ja: 穴を持つポリゴンを生成するには、<xref linkend="ST_MakePolygon"/>の形式2を使い、<xref linkend="ST_SetSRID"/>を使います。

note: Tag: para
en: Create a 2D polygon.
ja: 2次元ポリゴンを生成します。

note: Tag: para
en: Create a 3D polygon.
ja: 3次元ポリゴンを生成します。

note: Tag: refpurpose
en: Creates a rectangular Polygon in <link xlink:href="https://en.wikipedia.org/wiki/Web_Mercator_projection">Web Mercator</link> (SRID:3857) using the <link xlink:href="https://en.wikipedia.org/wiki/Tiled_web_map">XYZ tile system</link>.
ja: <link xlink:href="https://en.wikipedia.org/wiki/Web_Mercator_projection">Webメルカトル</link> (SRID:3857)上で <link xlink:href="https://en.wikipedia.org/wiki/Tiled_web_map">XYZタイル</link>を使った矩形ポリゴンを生成します。

note: Tag: para
en: Creates a rectangular Polygon giving the extent of a tile in the <link xlink:href="https://en.wikipedia.org/wiki/Tiled_web_map">XYZ tile system</link>. The tile is specified by the zoom level Z and the XY index of the tile in the grid at that level. Can be used to define the tile bounds required by <xref linkend="ST_AsMVTGeom"/> to convert geometry into the MVT tile coordinate space.
ja: <link xlink:href="https://en.wikipedia.org/wiki/Tiled_web_map">XYZ tile system</link>でのタイルの範囲を示す長方形ポリゴンを生成します。タイルはズームレベルを示すZと、そのレベルでのタイルインデックスを示すX, Yで指定します。<xref linkend="ST_AsMVTGeom"/>でジオメトリをMVTタイルの座標空間に変換のために必要なタイル境界を定義するために使います。

note: Tag: para
en: By default, the tile envelope is in the <link xlink:href="https://en.wikipedia.org/wiki/Web_Mercator_projection">Web Mercator</link> coordinate system (SRID:3857) using the standard range of the Web Mercator system (-20037508.342789, 20037508.342789). This is the most common coordinate system used for MVT tiles. The optional <varname>bounds</varname> parameter can be used to generate tiles in any coordinate system. It is a geometry that has the SRID and extent of the "Zoom Level zero" square within which the XYZ tile system is inscribed.
ja: デフォルトでは、タイルエンベロープの座標系は<link xlink:href="https://en.wikipedia.org/wiki/Web_Mercator_projection">Web Mercator</link> (SRID: 3857)で、標準的なウェブメルカトルの範囲 (-20037508.342789, 20037508.342789)を取ります。これがMVTタイルで使用される最も標準的な座標系です。任意パラメータ<varname>bounds</varname>を使うと、あらゆる座標系のタイルを生成することができます。SRIDを持ち、ズームレベル0の時の、ジオメトリのXYZタイルシステムが内側に存在する矩形を示すジオメトリを与えます。

note: Tag: para
en: The optional <varname>margin</varname> parameter can be used to expand a tile by the given percentage. E.g. <varname>margin=0.125</varname> expands the tile by 12.5%, which is equivalent to buffer=512 when the tile extent size is 4096, as used in <xref linkend="ST_AsMVTGeom"/>. This is useful to create a tile buffer to include data lying outside of the tile's visible area, but whose existence affects the tile rendering. For example, a city name (a point) could be near an edge of a tile, so its label should be rendered on two tiles, even though the point is located in the visible area of just one tile. Using expanded tiles in a query will include the city point in both tiles. Use a negative value to shrink the tile instead. Values less than -0.5 are prohibited because that would eliminate the tile completely. Do not specify a margin when using with <varname>ST_AsMVTGeom</varname>. See the example for <xref linkend="ST_AsMVT"/>.
ja: 任意パラメータ<varname>margin</varname>は、タイルを与えられた割合だけ拡張するために使います。たとえば<varname>margin=0.125</varname>と指定すると、12.5%拡張します。これは、<xref linkend="ST_AsMVTGeom"/>で使われている、タイルサイズが4096の時にbuffer=512と指定するのと等価です。タイル表示領域の外側にバッファを生成するために使いますが、この範囲はタイル描画に影響を与えます。たとえば、市名 (ポイント)を一つのタイルの端付近にあっても、そのラベルが二つのタイルで描画されるべきです。拡張したタイルをクエリで使うと、両方のタイルに市名のポイントが含まれることになります。負数を指定すると反対に縮小します。-0.5より小さい値は、タイルを完全に消すことになるので、許可されません。<varname>ST_AsMVTGeom</varname>と併用する時はマージンを指定しないでください。<xref linkend="ST_AsMVT"/>の例をご覧下さい。

note: Tag: para
en: Enhanced: 3.1.0 Added margin parameter.
ja: Enhanced: 3.1.0 marginパラメータが追加されました。

note: Tag: title
en: Example: Building a tile envelope
ja: 例: タイルエンベロープの構築

note: Tag: refpurpose
en: Returns a set of hexagons and cell indices that completely cover the bounds of the geometry argument.
ja: 引数ジオメトリの境界を完全にカバーする六角形とセルインデックスを返します。

note: Tag: para
en: Starts with the concept of a hexagon tiling of the plane. (Not a hexagon tiling of the globe, this is not the <link xlink:href="https://github.com/uber/h3">H3</link> tiling scheme.) For a given planar SRS, and a given edge size, starting at the origin of the SRS, there is one unique hexagonal tiling of the plane, Tiling(SRS, Size). This function answers the question: what hexagons in a given Tiling(SRS, Size) overlap with a given bounds.
ja: 平面の六角形タイルの概念から始まります。(地球の六角形タイルではなく<link xlink:href="https://github.com/uber/h3">H3</link>タイルスキーマではありません)。平面 SRS とエッジサイズを与えると、SRS の原点から始まり、平面の一意な六角形のタイル、すなわち Tiling(SRS, Size)が一つ存在します。この関数は、指定されたTiling(SRS, Size)内の六角形が指定された境界を覆っているかどうかという質問に答えます。

note: Tag: para
en: The SRS for the output hexagons is the SRS provided by the bounds geometry.
ja: 出力六角形のSRSは境界ジオメトリのSRSです。

note: Tag: para
en: Doubling or tripling the edge size of the hexagon generates a new parent tiling that fits with the origin tiling. Unfortunately, it is not possible to generate parent hexagon tilings that the child tiles perfectly fit inside.
ja: 六角形の辺の長さを2倍または3倍にすることで、元のタイルに適合する新しい親タイルが生成されます。残念ながら子タイルが完全に親タイルの中に入るような親六角形タイルを生成することはできません。

note: Tag: title
en: Example: Counting points in hexagons
ja: 例: 六角形の中の点を数え上げる

note: Tag: para
en: To do a point summary against a hexagonal tiling, generate a hexagon grid using the extent of the points as the bounds, then spatially join to that grid.
ja: 六角形タイリングに対してポイントをまとめるには、ポイントの範囲を境界として使って六角形グリッドを生成し、グリッドに空間的に結合します。

note: Tag: title
en: Example: Generating hex coverage of polygons
ja: 例: ポリゴンの六角形カバレッジの生成

note: Tag: para
en: If we generate a set of hexagons for each polygon boundary and filter out those that do not intersect their hexagons, we end up with a tiling for each polygon.
ja: ポリゴン境界ごとに六角形の集合を生成し、六角形とインタセクトしないものを除外すると、ポリゴンごとのタイルとなります。

note: Tag: para
en: Tiling states results in a hexagon coverage of each state, and multiple hexagons overlapping at the borders between states.
ja: 州のタイルは、それぞれの州の六角形のカバレッジとなり、複数の六角形が州境界で重なります。

note: Tag: para
en: The LATERAL keyword is implied for set-returning functions when referring to a prior table in the FROM list. So CROSS JOIN LATERAL, CROSS JOIN, or just plain , are equivalent constructs for this example.
ja: LATERALキーワードは、FROMリスト内の、対象より前のテーブルを参照する時は、集合を返す関数に暗黙的に含まれます。 CROSS JOIN LATERAL、CROSS JOIN、指定なし、は、この例の同じ構成要素です。

note: Tag: refpurpose
en: Returns a single hexagon, using the provided edge size and cell coordinate within the hexagon grid space.
ja: 与えられたエッジサイズと六角形グリッド空間内のセル座標を使って単一の六角形を返します。

note: Tag: para
en: Uses the same hexagon tiling concept as <xref linkend="ST_HexagonGrid"/>, but generates just one hexagon at the desired cell coordinate. Optionally, can adjust origin coordinate of the tiling, the default origin is at 0,0.
ja: <xref linkend="ST_HexagonGrid"/>と同じ六角形タイルの概念を使いますが、求めるセルの座標に一つだけの六角形を生成します。任意でタイルの原点の座標を調整できます。デフォルトの原点座標は0,0です。

note: Tag: para
en: Hexagons are generated with no SRID set, so use <xref linkend="ST_SetSRID"/> to set the SRID to the one you expect.
ja: 六角形はSRIDの設定なしで生成されるので、SRIDを期待する値に設定するために<xref linkend="ST_SetSRID"/>を使います。

note: Tag: title
en: Example: Creating a hexagon at the origin
ja: 例: 原点で六角形の生成

note: Tag: refpurpose
en: Returns a set of grid squares and cell indices that completely cover the bounds of the geometry argument.
ja: 引数ジオメトリの境界を完全にカバーするグリッド正方形とセルインデックスを返します。

note: Tag: para
en: Starts with the concept of a square tiling of the plane. For a given planar SRS, and a given edge size, starting at the origin of the SRS, there is one unique square tiling of the plane, Tiling(SRS, Size). This function answers the question: what grids in a given Tiling(SRS, Size) overlap with a given bounds.
ja: 平面の正方形タイルの概念から始まります。与えられた平面SRSとエッジサイズに対して、SRS原点から始まり、一意の平面の正方形タイル(SRS, Size)が一つ存在します。この関数は、与えられたタイル(SRS, Size)内のグリッド内のどのタイルが与えられた境界とオーバラップするかという問題に答えを出します。

note: Tag: para
en: The SRS for the output squares is the SRS provided by the bounds geometry.
ja: 出力正方形のSRSは境界ジオメトリのSRSです。

note: Tag: para
en: Doubling or edge size of the square generates a new parent tiling that perfectly fits with the original tiling. Standard web map tilings in mercator are just powers-of-two square grids in the mercator plane.
ja: 正方形の2倍またはエッジサイズによって、新しい親タイルが生成されます。親タイルは完全に元のタイルに適合します。標準のウェブマップにおけるメルカトルのタイルは、メルカトル平面の2の累乗での正方形です。

note: Tag: title
en: Example: Generating a 1 degree grid for a country
ja: 例: 国の1度グリッドの生成

note: Tag: para
en: The grid will fill the whole bounds of the country, so if you want just squares that touch the country you will have to filter afterwards with ST_Intersects.
ja: グリッドは国の境界全体を埋めます。国に接触する四角形が欲しい場合には、ST_Intersects後にフィルタリングする必要があります。

note: Tag: title
en: Example: Counting points in squares (using single chopped grid)
ja: 例: 正方形内のポイントの数え上げ (細かくした単一のグリッドを使用)

note: Tag: para
en: To do a point summary against a square tiling, generate a square grid using the extent of the points as the bounds, then spatially join to that grid. Note the estimated extent might be off from actual extent, so be cautious and at very least make sure you've analyzed your table.
ja: 正方形タイルのポイントのサマリを行うには、境界としてポイントの拡張を使った正方形グリッドを生成し、グリッドに空間的に結合します。推定範囲は実際の範囲と異なる場合があるのでご注意下さい。慎重に取り扱うようにし、最低でも確実にテーブルを解析して下さい。

note: Tag: title
en: Example: Counting points in squares using set of grid per point
ja: 例: ポイントごとのグリッドの集合を使った正方形内のポイント数え上げ

note: Tag: para
en: This yields the same result as the first example but will be slower for a large number of points
ja: これは最初の例と同じ結果になりますが、ポイント数が多くなると遅くなります。

note: Tag: refpurpose
en: Returns a single square, using the provided edge size and cell coordinate within the square grid space.
ja: 与えられたエッジサイズと六角形グリッド空間内のセル座標を使って単一の正方形を返します。

note: Tag: para
en: Uses the same square tiling concept as <xref linkend="ST_SquareGrid"/>, but generates just one square at the desired cell coordinate. Optionally, can adjust origin coordinate of the tiling, the default origin is at 0,0.
ja: <xref linkend="ST_SquareGrid"/>と同じ正方形タイルの概念を使っていますが、求めるセルの座標に一つだけの正方形を生成します。任意でタイルの原点の座標を調整できます。デフォルトの原点座標は0,0です。

note: Tag: para
en: Squares are generated with no SRID set, so use <xref linkend="ST_SetSRID"/> to set the SRID to the one you expect.
ja: 四角形はSRIDの設定なしで生成されるので、SRIDを期待する値に設定するために<xref linkend="ST_SetSRID"/>を使います。

note: Tag: title
en: Example: Creating a square at the origin
ja: 例: 原点で四角形の生成

note: Tag: refpurpose
en: Returns the input letters rendered as geometry with a default start position at the origin and default text height of 100.
ja: デフォルトの開始位置を原点とし、デフォルトの高さを100とする、ジオメトリとして描画された文字を返します。

note: Tag: para
en: Uses a built-in font to render out a string as a multipolygon geometry. The default text height is 100.0, the distance from the bottom of a descender to the top of a capital. The default start position places the start of the baseline at the origin. Over-riding the font involves passing in a json map, with a character as the key, and base64 encoded TWKB for the font shape, with the fonts having a height of 1000 units from the bottom of the descenders to the tops of the capitals.
ja: 組込みフォントを使って、出力文字列をマルチポリゴンとして描画します。ディセンダからキャピタルまでの文字高さは100.0です。デフォルトのベースラインの開始位置は原点に置かれます。フォントのオーバライドは文字をキーとしたJSONマッピングと、ディセンダからキャピタルまでの1000単位の高さを持つフォント形状のTWKBをbase64エンコードしたものを渡します。

note: Tag: para
en: The text is generated at the origin by default, so to reposition and resize the text, first apply the <code>ST_Scale</code> function and then apply the <code>ST_Translate</code> function.
ja: テキストは、デフォルトでは原点に生成されるので、テキストの位置変更とサイズ変更とを行います。最初に<code>ST_Scale</code>関数を適用し、その後<code>ST_Translate</code>関数を適用します。

note: Tag: title
en: Example: Generating the word 'Yo'
ja: 例: 単語'Yo'の生成

note: Tag: para
en: Letters generated by ST_Letters
ja: ST_Letterで生成した文字

note: Tag: title
en: Example: Scaling and moving words
ja: 例: 単語の拡大と移動

note: Tag: title
en: Coverages
ja: カバレッジ

note: Tag: para
en: These functions operate on sets of polygonal geometry that form "implicit coverages". To form a valid coverage polygons must not overlap, and the vertices of adjacent edges must match exactly. Coverages are fast to process, and can be operated on with window functions, which retain the coverage topology inside the window partition while altering the edges.
ja: これらの関数は「暗黙的なカバレッジ」を形成するポリゴンジオメトリの集合で動作します。妥当なカバレッジを形成するには、ポリゴンはオーバラップしてはいけませんし、隣接するエッジの頂点が確実に合致していなければいけません。カバレッジは処理が速く、かつ、エッジを変更してもウィンドウパーティション内のカバレッジのトポロジを保持するウィンドウ関数で操作できます。

note: Tag: refpurpose
en: Window function that finds locations where polygons fail to form a valid coverage.
ja: ポリゴンが妥当なカバレッジの形成に失敗する位置を検索するウィンドウ関数。

note: Tag: para
en: A window function which checks if the polygons in the window partition form a valid polygonal coverage. It returns linear indicators showing the location of invalid edges (if any) in each polygon.
ja: ウィンドウパーティション内のポリゴンが妥当なポリゴンカバレッジを形成するかどうかチェックするウィンドウ関数です。個々のポリゴン内の不正なエッジの位置 (あるなら)を示す線形インジケータを返します。

note: Tag: para
en: A set of valid polygons is a valid coverage if the following conditions hold:
ja: 次の条件を満たすなら妥当なポリゴンの集合は妥当なカバレッジです:

note: Tag: para
en: <emphasis role="bold">Non-overlapping</emphasis> - polygons do not overlap (their interiors do not intersect)
ja: <emphasis role="bold">オーバラップなし</emphasis> - ポリゴン同士がオーバラップしない (ポリゴンの内部でインタセクトしない)

note: Tag: para
en: <emphasis role="bold">Edge-Matched</emphasis> - vertices along shared edges are identical
ja: <emphasis role="bold">エッジ一致</emphasis> - 共有エッジに沿った頂点が同一

note: Tag: para
en: As a window function a value is returned for every input polygon. For polygons which violate one or more of the validity conditions the return value is a MULTILINESTRING containing the problematic edges. Coverage-valid polygons return the value NULL. Non-polygonal or empty geometries also produce NULL values.
ja: ウィンドウ関数として、入力ポリゴンごとに値が返されます。妥当性条件の一つ以上に違反するポリゴンについては返り値は、問題のあるエッジを含むMULTILINESTRINGです。カバレッジ妥当なポリゴンに対してはNULLを返します。非ポリゴンや空ジオメトリに対してもNULL値が返ります。

note: Tag: para
en: The conditions allow a valid coverage to contain holes (gaps between polygons), as long as the surrounding polygons are edge-matched. However, very narrow gaps are often undesirable. If the <parameter>tolerance</parameter> parameter is specified with a non-zero distance, edges forming narrower gaps will also be returned as invalid.
ja: この条件では、周囲のポリゴンがエッジ一致になっている限りは、妥当なカバレッジは穴 (ポリゴン間の隙間)を含むことができます。しかしながら、非常に小さい隙間は、望まれないものとされることがしばしばあります。<parameter>tolerance</parameter>パラメタが0でない距離で指定されている場合には、小さい隙間を形成するエッジば不正なものとして返されます。

note: Tag: para
en: The polygons being checked for coverage validity must also be valid geometries. This can be checked with <xref linkend="ST_IsValid"/>.
ja: カバレッジ妥当性のチェックがなされたポリゴンも妥当なジオメトリです。<xref linkend="ST_IsValid"/>でチェックできます。

note: Tag: para
en: Requires GEOS &gt;= 3.12.0
ja: GEOS 3.12.0以上が必要です

note: Tag: para
en: Invalid edges caused by overlap and non-matching vertices
ja: オーバラップと頂点不一致により発生した不正エッジ

note: Tag: refpurpose
en: Window function that simplifies the edges of a polygonal coverage.
ja: ポリゴンカバレッジのエッジを単純化するウィンドウ関数。

note: Tag: para
en: A window function which simplifies the edges of polygons in a polygonal coverage. The simplification preserves the coverage topology. This means the simplified output polygons are consistent along shared edges, and still form a valid coverage.
ja: ポリゴンカバレッジ内でポリゴンのエッジを単純化するウィンドウ関数です。この単純化ではカバレッジのトポロジが保持されます。単純化した出力ポリゴンは共有するエッジに沿って構成され、妥当なカバレッジを形成します。

note: Tag: para
en: The simplification uses a variant of the <link xlink:href="https://en.wikipedia.org/wiki/Visvalingam%E2%80%93Whyatt_algorithm">Visvalingam–Whyatt algorithm</link>. The <parameter>tolerance</parameter> parameter has units of distance, and is roughly equal to the square root of triangular areas to be simplified.
ja: 単純化では<link xlink:href="https://en.wikipedia.org/wiki/Visvalingam%E2%80%93Whyatt_algorithm">Visvalingam–Whyatt algorithm</link>版を使います。<parameter>tolerance</parameter>パラメータは距離の単位を持ち、単純化する三角形面積の平方根とだいたい同じです。

note: Tag: para
en: To simplify only the "internal" edges of the coverage (those that are shared by two polygons) set the <parameter>simplifyBoundary</parameter> parameter to false.
ja: カバレッジの「内部の」エッジ (二つのポリゴンに共有されている)だけを単純化するには、<parameter>simplifyBoundary</parameter>パラメタをFALSEに設定します。

note: Tag: para
en: 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 <xref linkend="ST_CoverageInvalidEdges"/> to determine if a coverage is valid.
ja: 入力が妥当なカバレッジでない場合には、出力に予期しない何か (境界のインタセクト、共有されているように見えるのに分かれている境界)が出現する可能性があります。カバレッジが妥当かどうかを判断するには<xref linkend="ST_CoverageInvalidEdges"/>を使います。

note: Tag: para
en: Input coverage
ja: 入力カバレッジ

note: Tag: para
en: Simplified coverage
ja: カバレッジの単純化

note: Tag: refpurpose
en: Computes the union of a set of polygons forming a coverage by removing shared edges.
ja: 共有しているエッジを除去することでカバレッジを形成するポリゴンの集合の結合を計算します。

note: Tag: para
en: An aggregate function which unions a set of polygons forming a polygonal coverage. The result is a polygonal geometry covering the same area as the coverage. This function produces the same result as <xref linkend="ST_Union"/>, but uses the coverage structure to compute the union much faster.
ja: ポリゴンカバレッジを形成するポリゴンの集合の結合を行う集約関数です。結果はカバレッジと同じ領域を覆うポリゴンジオメトリです。この関数は<xref linkend="ST_Union"/>と同じ結果を返しますが、高速に計算するためにカバレッジ構造を使用します。

note: Tag: para
en: If the input is not a valid coverage there may be unexpected artifacts in the output (such as unmerged or overlapping polygons). Use <xref linkend="ST_CoverageInvalidEdges"/> to determine if a coverage is valid.
ja: 入力が妥当なカバレッジでない場合には、出力に予期しない何か (マージされていないポリゴンやオーバラップするポリゴン)が出現する可能性があります。カバレッジが妥当かどうかを判断するには<xref linkend="ST_CoverageInvalidEdges"/>を使います。

note: Tag: para
en: Availability: 3.4.0 - requires GEOS &gt;= 3.8.0
ja: Availability: 3.4.0 - GEOS 3.8.0以上が必要です

note: Tag: para
en: Union result
ja: 結合結果

note: Tag: title
en: Geometry Editors
ja: ジオメトリエディタ

note: Tag: para
en: These functions create modified geometries by changing type, structure or vertices.
ja: これらの関数は、タイプ、構造または頂点の変更によって編集されたジオメトリを生成します。

note: Tag: refpurpose
en: Add a point to a LineString.
ja: ラインストリングにポイントを追加します。

note: Tag: para
en: Adds a point to a LineString before the index <parameter>position</parameter> (using a 0-based index). If the <parameter>position</parameter> parameter is omitted or is -1 the point is appended to the end of the LineString.
ja: LINESTRINGの<parameter>position</parameter>の位置 (0はじまり)の前にポイントを追加します。<parameter>position</parameter>パラメータが省略されるか-1の場合には、LINESTRINGの末尾に追加されます。

note: Tag: para
en: Add a point to the end of a 3D line
ja: 3次元ラインの末尾へのポイントの追加

note: Tag: para
en: Guarantee all lines in a table are closed by adding the start point of each line to the end of the line only for those that are not closed.
ja: テーブル内の全てのラインについて、閉じていないラインにだけ始端を末尾に追加することで、閉じていることを保証します。

note: Tag: refpurpose
en: Given a geometry collection, returns a multi-geometry containing only elements of a specified type.
ja: ジオメトリコレクションを与えると、指定されたタイプの要素だけからなるマルチジオメトリを返します。

note: Tag: para
en: Given a geometry collection, returns a homogeneous multi-geometry.
ja: ジオメトリコレクションを指定すると、要素のタイプが統一されたマルチジオメトリを返します。

note: Tag: para
en: If the <parameter>type</parameter> is not specified, returns a multi-geometry containing only geometries of the highest dimension. So polygons are preferred over lines, which are preferred over points.
ja: <parameter>type</parameter>が指定されていない場合には、最大次元のジオメトリだけを含むマルチジオメトリを返します。このため、ポリゴンはラインに優先され、ラインはポイントに優先されます。

note: Tag: para
en: If the <parameter>type</parameter> is specified, returns a multi-geometry containing only that type. If there are no sub-geometries of the right type, an EMPTY geometry is returned. Only points, lines and polygons are supported. The type numbers are:
ja: <parameter>type</parameter>が指定されている場合には、指定されたタイプだけを含むマルチジオメトリを返します。指定されたタイプの要素が無い場合には、EMPTYジオメトリを返します。ポイント、ライン、ポリゴンだけに対応しています。タイプの番号は次の通りです。

note: Tag: para
en: For atomic geometry inputs, the geometry is returned unchanged if the input type matches the requested type. Otherwise, the result is an EMPTY geometry of the specified type. If required, these can be converted to multi-geometries using <xref linkend="ST_Multi"/>.
ja: 非マルチジオメトリの入力に対しては、ジオメトリのタイプと指定したタイプが合致している場合には変更せず返します。合致しない場合には、指定したタイプのEMPTYジオメトリを返します。ST_Multi"/>を使ってマルチ系ジオメトリに変換する必要があるなら<xref linkend="ST_Multi"/>を使います。

note: Tag: para
en: MultiPolygon results are not checked for validity. If the polygon components are adjacent or overlapping the result will be invalid. (For example, this can occur when applying this function to an <xref linkend="ST_Split"/> result.) This situation can be checked with <xref linkend="ST_IsValid"/> and repaired with <xref linkend="ST_MakeValid"/>.
ja: マルチポリゴンの結果は妥当性チェックを行いません。ポリゴン要素が隣接やオーバラップしている場合には、結果ジオメトリは不正となります (たとえば、この関数を<xref linkend="ST_Split"/>の結果に適用すると発生します)。この状況に陥っているかは<xref linkend="ST_IsValid"/>で確認でき、<xref linkend="ST_MakeValid"/>で修復できます。

note: Tag: para
en: Prior to 1.5.3 this function returned atomic inputs unchanged, no matter type. In 1.5.3 non-matching single geometries returned a NULL result. In 2.0.0 non-matching single geometries return an EMPTY result of the requested type.
ja: 1.5.3より前のこの関数は非マルチジオメトリの入力に対して、指定タイプに関係なく変更せずに返しました。1.5.3で指定タイプに合致しない単一ジオメトリ入力に対してNULLを返すようになりました。2.0.0で、合致しないジオメトリに対して、指定タイプのEMPTYジオメトリを返すようになりました。

note: Tag: para
en: Extract highest-dimension type:
ja: 最大次元となるタイプの抽出:

note: Tag: para
en: Extract points (type 1 == POINT):
ja: ポイントの抽出 (type 1 == POINT):

note: Tag: para
en: Extract lines (type 2 == LINESTRING):
ja: ラインの抽出 (type 2 == LINESTRING):

note: Tag: refpurpose
en: Returns the simplest representation of a geometry collection.
ja: ジオメトリコレクションを与えると、最も単純な表現を返します。

note: Tag: para
en: Given a geometry collection, returns the "simplest" representation of the contents.
ja: ジオメトリコレクションを与えると、「最も単純な」表現を返します。

note: Tag: para
en: Homogeneous (uniform) collections are returned as the appropriate multi-geometry.
ja: 同種の要素からなるコレクションが適切なマルチ系ジオメトリとして返されます。

note: Tag: para
en: Heterogeneous (mixed) collections are flattened into a single GeometryCollection.
ja: タイプ混合のコレクションはフラットな単一のGEOMETRYCOLLECTIONに変換されます。

note: Tag: para
en: Collections containing a single atomic element are returned as that element.
ja: 単一の非マルチジオメトリ要素からなるコレクションはその要素が返されます。

note: Tag: para
en: Atomic geometries are returned unchanged. If required, these can be converted to a multi-geometry using <xref linkend="ST_Multi"/>.
ja: 非マルチジオメトリは変更されずに返ります。マルチジオメトリへの変換が必要なら<xref linkend="ST_Multi"/>を使います。

note: Tag: para
en: This function does not ensure that the result is valid. In particular, a collection containing adjacent or overlapping Polygons will create an invalid MultiPolygon. This situation can be checked with <xref linkend="ST_IsValid"/> and repaired with <xref linkend="ST_MakeValid"/>.
ja: この関数は結果ジオメトリの妥当性を保証されず、隣接やオーバラップする複数ポリゴンからは不正なMULTIPOLYGONが生成されます。この状況に陥っているかは<xref linkend="ST_IsValid"/>で確認でき、<xref linkend="ST_MakeValid"/>で修復できます。

note: Tag: para
en: Single-element collection converted to an atomic geometry
ja: 単一要素のコレクションから非マルチジオメトリへの変換

note: Tag: para
en: Nested single-element collection converted to an atomic geometry:
ja: ネスト下単一要素のコレクションから非マルチジオメトリへの変換:

note: Tag: para
en: Collection converted to a multi-geometry:
ja: コレクションからマルチ系ジオメトリへの変換:

note: Tag: para
en: Nested heterogeneous collection flattened to a GeometryCollection:
ja: ネストしたタイプ混合のコレクションからフラットなジオメトリコレクションへの変換:

note: Tag: para
en: Collection of Polygons converted to an (invalid) MultiPolygon:
ja: ポリゴンのコレクションから (不正な)マルチポリゴンへの変換:

note: Tag: refpurpose
en: Converts a geometry containing curves to a linear geometry.
ja: 曲線を含むジオメトリを線ジオメトリに変換します。

note: Tag: para
en: Converts a CIRCULAR STRING to regular LINESTRING or CURVEPOLYGON to POLYGON or MULTISURFACE to MULTIPOLYGON. Useful for outputting to devices that can't support CIRCULARSTRING geometry types
ja: CIRCULARSTRINGをLINESTRINGに、CURVEPOLYGONをPOLYGONに、MULTISURFACEをMULTIPOLYGONに、それぞれ変換します。CIRCULARSTRINGジオメトリタイプに対応していないデバイスへの出力に使用します。

note: Tag: para
en: Converts a given geometry to a linear geometry. Each curved geometry or segment is converted into a linear approximation using the given `tolerance` and options (32 segments per quadrant and no options by default).
ja: 与えられたジオメトリを線型ジオメトリに変換します。それぞれの曲線ジオメトリまたは辺は、`tolerance` とオプションを使用して線形近似に変換します (デフォルトでは4分の1円ごとに32辺でオプションなしです)。

note: Tag: para
en: The 'tolerance_type' argument determines interpretation of the `tolerance` argument. It can take the following values:
ja: 'tolerance_type'引数によって`tolerance`引数の解釈が決定されます。

note: Tag: para
en: 0 (default): Tolerance is max segments per quadrant.
ja: 0 (デフォルト): toleranceは4分の1円の最大辺数です。

note: Tag: para
en: 1: Tolerance is max-deviation of line from curve, in source units.
ja: 1: toleranceは曲線からラインまでの最大差です。単位は入力ジオメトリの単位です。

note: Tag: para
en: 2: Tolerance is max-angle, in radians, between generating radii.
ja: 2: toleranceは生成される半径がなす角度のラジアン単位の最大値です。

note: Tag: para
en: The 'flags' argument is a bitfield. 0 by default. Supported bits are:
ja: 'flags'引数はビットフィールドです。デフォルトでは0です。次のビットに対応します。

note: Tag: para
en: 1: Symmetric (orientation idependent) output.
ja: 1: 対称となる (方向独立)出力。

note: Tag: para
en: 2: Retain angle, avoids reducing angles (segment lengths) when producing symmetric output. Has no effect when Symmetric flag is off.
ja: 2: 角度維持。対称出力を生成する時に角度 (辺長)減少を避けます。対称フラグがOFFの時は何の効果もありません。

note: Tag: para
en: Enhanced: 2.4.0 added support for max-deviation and max-angle tolerance, and for symmetric output.
ja: Enhanced: 2.4.0 最大距離差による許容範囲と最大角度による許容範囲に対応し、対称出力に対応しました。

note: Tag: para
en: Enhanced: 3.0.0 implemented a minimum number of segments per linearized arc to prevent topological collapse.
ja: Enhanced: 3.0.0 線形化した弧ごとの最小線分数を実装しました。トポロジ的な崩壊を防ぐためです。

note: Tag: refpurpose
en: Change start point of a closed LineString.
ja: 閉じたLINESTRINGの開始点を変更する。

note: Tag: para
en: Changes the start/end point of a closed LineString to the given vertex <parameter>point</parameter>.
ja: 閉じたLINESTRINGの開始/終了点を <parameter>point</parameter>で指定した頂点に変更します。

note: Tag: para
en: Make e closed line start at its 3rd vertex
ja: 閉じたラインの3番目の頂点を開始点にする

note: Tag: refpurpose
en: Returns a version of a geometry with X and Y axis flipped.
ja: X値とY値を入れ替えたジオメトリを返します。

note: Tag: para
en: Returns a version of the given geometry with X and Y axis flipped. Useful for fixing geometries which contain coordinates expressed as latitude/longitude (Y,X).
ja: 与えられたジオメトリのX値とY値を入れ替えたものを返します。緯度経度 (Y,X)で表現される座標値を持つジオメトリを修正するのに使います。

note: Tag: title
en: Example
ja: 例

note: Tag: refpurpose
en: Force the geometries into a "2-dimensional mode".
ja: ジオメトリを2次元モードに強制します。

note: Tag: para
en: Forces the geometries into a "2-dimensional mode" so that all output representations will only have the X and Y coordinates. This is useful for force OGC-compliant output (since OGC only specifies 2-D geometries).
ja: ジオメトリを「2次元モード」に強制させます。全ての出力表現はXY座標値のみを持つことになります。OGC準拠の出力 (OGCは2次元ジオメトリのみ策定しています)に強制するために使われます。

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Force_2D.
ja: Changed: 2.1.0 2.0.xの間はST_Force_2Dと呼ばれていました。

note: Tag: refpurpose
en: Force the geometries into XYZ mode. This is an alias for ST_Force3DZ.
ja: ジオメトリをXYZモードに強制します。これはST_Force3DZの別名です。

note: Tag: para
en: Forces the geometries into XYZ mode. This is an alias for ST_Force3DZ. If a geometry has no Z component, then a <parameter>Zvalue</parameter> Z coordinate is tacked on.
ja: ジオメトリをXYZモードに強制します。これはST_Force_3DZの別名です。ジオメトリがZ値を持っていない場合は<parameter>Zvalue</parameter>のZ値を追加します。

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Force_3D.
ja: Changed: 2.1.0 2.0.xの間はST_Force_3Dと呼ばれていました。

note: Tag: para
en: Changed: 3.1.0. Added support for supplying a non-zero Z value.
ja: Changed: 3.1.0. 0でないZ値を指定できるようになりました。

note: Tag: refpurpose
en: Force the geometries into XYZ mode.
ja: ジオメトリをXYZモードに強制します。

note: Tag: para
en: Forces the geometries into XYZ mode. If a geometry has no Z component, then a <parameter>Zvalue</parameter> Z coordinate is tacked on.
ja: ジオメトリをXYZモードに強制します。これはST_Force_3DZの別名です。ジオメトリがZ値を持っていない場合は<parameter>Zvalue</parameter>のZ値を追加します。

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Force_3DZ.
ja: Changed: 2.1.0 2.0.xの間はST_Force_3DZと呼ばれていました。

note: Tag: refpurpose
en: Force the geometries into XYM mode.
ja: ジオメトリをXYMモードに強制します。

note: Tag: para
en: Forces the geometries into XYM mode. If a geometry has no M component, then a <parameter>Mvalue</parameter> M coordinate is tacked on. If it has a Z component, then Z is removed
ja: ジオメトリをXYMモードに強制します。ジオメトリがM値を持っていない場合は<parameter>Mvalue</parameter>のM値を追加します。Z値を持っている場合はZ値は除去されます。

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Force_3DM.
ja: Changed: 2.1.0 2.0.xの間はST_Force_3DMと呼ばれていました。

note: Tag: para
en: Changed: 3.1.0. Added support for supplying a non-zero M value.
ja: Changed: 3.1.0. 0でないM値を指定できるようになりました。

note: Tag: refpurpose
en: Force the geometries into XYZM mode.
ja: ジオメトリをXYZMモードに強制します。

note: Tag: para
en: Forces the geometries into XYZM mode. <parameter>Zvalue</parameter> and <parameter>Mvalue</parameter> is tacked on for missing Z and M dimensions, respectively.
ja: ジオメトリをXYZMモードに強制します。Z値やM値が無い場合は<parameter>Zvalue</parameter>と<parameter>Mvalue</parameter>を追加します。

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Force_4D.
ja: Changed: 2.1.0 2.0.xの間はST_Force_4Dと呼ばれていました。

note: Tag: para
en: Changed: 3.1.0. Added support for supplying non-zero Z and M values.
ja: Changed: 3.1.0. 0でないZ値とM値を指定できるようになりました。

note: Tag: refpurpose
en: Convert the geometry into a GEOMETRYCOLLECTION.
ja: ジオメトリをジオメトリコレクションに変換します。

note: Tag: para
en: Converts the geometry into a GEOMETRYCOLLECTION. This is useful for simplifying the WKB representation.
ja: ジオメトリをジオメトリコレクションに変換します。これはWKB表現を単純化するのに便利です。

note: Tag: para
en: Availability: 1.2.2, prior to 1.3.4 this function will crash with Curves. This is fixed in 1.3.4+
ja: Availability: 1.2.2 1.3.4より前は、曲線を含むジオメトリで使うとクラッシュしました。これは1.3.4以上では訂正されています。

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Force_Collection.
ja: Changed: 2.1.0 2.0.xの間はST_Force_Collectionと呼ばれていました。

note: Tag: refpurpose
en: Upcast a geometry into its curved type, if applicable.
ja: 該当する場合は、ジオメトリを曲線タイプに変換します。

note: Tag: para
en: Turns a geometry into its curved representation, if applicable: lines become compoundcurves, multilines become multicurves polygons become curvepolygons multipolygons become multisurfaces. If the geometry input is already a curved representation returns back same as input.
ja: 可能ならジオメトリを曲線表現に変更します。ラインは複合曲線になり、マルチラインはマルチ曲線になり、ポリゴンは曲線ポリゴンになり、マルチポリゴンはマルチサーフェスになります。入力ジオメトリが既に曲線表現であるなら、入力と同じ値が返されます。

note: Tag: refpurpose
en: Orients all exterior rings counter-clockwise and all interior rings clockwise.
ja: 全ての外環を反時計回りに、全ての内環を時計回りに、それぞれ強制します。

note: Tag: para
en: Forces (Multi)Polygons to use a counter-clockwise orientation for their exterior ring, and a clockwise orientation for their interior rings. Non-polygonal geometries are returned unchanged.
ja: (マルチ)ポリゴンに対して、外環を反時計回りに、内環を時計回りに強制します。ポリゴンでないジオメトリは、変更されずに返されます。

note: Tag: refpurpose
en: Orients all exterior rings clockwise and all interior rings counter-clockwise.
ja: 全ての外環を時計回りに、全ての内環を反時計回りに、それぞれ強制します。

note: Tag: para
en: Forces (Multi)Polygons to use a clockwise orientation for their exterior ring, and a counter-clockwise orientation for their interior rings. Non-polygonal geometries are returned unchanged.
ja: (マルチ)ポリゴンに対して、外環を時計回りに、内環を反時計回りに強制します。ポリゴンでないジオメトリは、変更されずに返されます。

note: Tag: refpurpose
en: Force the geometries to use SFS 1.1 geometry types only.
ja: SFS 1.1ジオメトリタイプのみ使うようジオメトリに強制します。

note: Tag: refpurpose
en: Force the orientation of the vertices in a polygon to follow the Right-Hand-Rule.
ja: ポリゴンの頂点の方向を右回りに強制します。

note: Tag: para
en: Forces the orientation of the vertices in a polygon to follow a Right-Hand-Rule, in which the area that is bounded by the polygon is to the right of the boundary. In particular, the exterior ring is orientated in a clockwise direction and the interior rings in a counter-clockwise direction. This function is a synonym for <xref linkend="ST_ForcePolygonCW"/>
ja: ポリゴンの頂点の方向はRight-Hand-Ruleに従います。この際、ポリゴンの領域は、境界線の右側になります。特に、外環は時計回りに強制され、内環は反時計回りに強制されます。この関数は<xref linkend="ST_ForcePolygonCW"/>の別名です。

note: Tag: para
en: The above definition of the Right-Hand-Rule conflicts with definitions used in other contexts. To avoid confusion, it is recommended to use ST_ForcePolygonCW.
ja: 上のRHRの定義は、他の文脈で使われる場合の定義と矛盾します。これを解消するには、ST_ForcePolygonCWを使うことを推奨します。

note: Tag: refpurpose
en: Returns a line extended forwards and backwards by specified distances.
ja: 指定距離ぶん前後に延長されたラインを返します。

note: Tag: para
en: Returns a line extended forwards and backwards by adding new start (and end) points at the given distance(s). A distance of zero does not add a point. Only non-negative distances are allowed. The direction(s) of the added point(s) is determined by the first (and last) two distinct points of the line. Duplicate points are ignored.
ja: 新しい始点 (と終点)を与えられた距離を取って追加することで、指定距離ぶん前後に延長されたラインを返します。距離を0にした場合には、ポイントは追加されません。非負の距離値のみ受け付けます。追加ポイントの方向は始点(と終点の二つの異なるポイントによって決定されます。重複ポイントは無視されます。

note: Tag: title
en: Example: Extends a line 5 units forward and 6 units backward
ja: 例: ラインを前方に5単位延長し、後方に6単位延長する

note: Tag: refpurpose
en: Converts a linear geometry to a curved geometry.
ja: 曲線を含むジオメトリを線ジオメトリに変換します。

note: Tag: para
en: Converts plain LINESTRING/POLYGON to CIRCULAR STRINGs and Curved Polygons. Note much fewer points are needed to describe the curved equivalent.
ja: LINESTRING/POLYGONをCIRCULARSTRINGと曲線ポリゴンに変換します。等価の曲線を記述するのに必要なポイントが少なくなります。

note: Tag: para
en: If the input LINESTRING/POLYGON is not curved enough to clearly represent a curve, the function will return the same input geometry.
ja: 入力ラインストリング/ポリゴンが、曲線をはっきりと表現するのには不十分な場合には、関数は入力ジオメトリと同じものを返します。

note: Tag: refpurpose
en: Return the geometry as a MULTI* geometry.
ja: マルチ系ジオメトリを返します。

note: Tag: para
en: Returns the geometry as a MULTI* geometry collection. If the geometry is already a collection, it is returned unchanged.
ja: マルチ系ジオメトリを返します。ジオメトリが既にマルチ系なら変更せずに返します。

note: Tag: refpurpose
en: Return the geometry in its canonical form.
ja: 標準的な形式に変えたジオメトリを返します。

note: Tag: para
en: Returns the geometry in its normalized/canonical form. May reorder vertices in polygon rings, rings in a polygon, elements in a multi-geometry complex.
ja: 正規化/標準化された形式のジオメトリを返します。ポリゴンの環における頂点の順序、ポリゴンにおける環の順序、複合ジオメトリにおける要素の順序が変更されることがあります。

note: Tag: para
en: Mostly only useful for testing purposes (comparing expected and obtained results).
ja: ほとんどの場合、試験目的 (期待した結果と実際に得た結果との比較)でのみ使用します。

note: Tag: refpurpose
en: Returns a point projected from a start point by a distance and bearing (azimuth).
ja: 始点から距離と方位で算出されたポイントを返します。

note: Tag: para
en: Returns a point projected from a point along a geodesic using a given distance and azimuth (bearing). This is known as the direct geodesic problem.
ja: 始点から測地線に沿って与えられた距離と方位で算出されたポイントを返します。測地問題と言われるものです。

note: Tag: para
en: The two-point version uses the path from the first to the second point to implicitly define the azimuth and uses the distance as before.
ja: 2ポイント版は、方位を黙示的に定義するために一つ目のポイントから二つ目のポイントに向かう線を使い、距離は以前と同様に使います。

note: Tag: para
en: The distance is given in meters. Negative values are supported.
ja: 距離はメートルで与えます。負数に対応しています。

note: Tag: para
en: The azimuth (also known as heading or bearing) is given in radians. It is measured clockwise from true north.
ja: 方位はラジアンで与えます。真北 (方位 0)から時計回りに増えます。 真北から時計回りに数えます。

note: Tag: para
en: North is azimuth zero (0 degrees)
ja: 北は方位ゼロ (0度)です

note: Tag: para
en: East is azimuth &#x03C0;/2 (90 degrees)
ja: 東は方位 &#x03C0;/2 (90度)です

note: Tag: para
en: South is azimuth &#x03C0; (180 degrees)
ja: 南は方位 &#x03C0; (180度)です

note: Tag: para
en: West is azimuth 3&#x03C0;/2 (270 degrees)
ja: 西は方位 3&#x03C0;/2 (270度)です

note: Tag: para
en: Negative azimuth values and values greater than 2&#x03C0; (360 degrees) are supported.
ja: 負の方位値と2&#x03C0; (360度)を超える値に対応しています。

note: Tag: para
en: Enhanced: 2.4.0 Allow negative distance and non-normalized azimuth.
ja: Enhanced: 2.4.0 負の距離と非正規化方位を許容するようになりました。

note: Tag: para
en: Enhanced: 3.4.0 Allow geometry arguments and two-point form omitting azimuth.
ja: Enhanced: 3.4.0 ジオメトリ引数と、azimuthを省略した2ポイント形式を許します。

note: Tag: title
en: Example: Projected point at 100,000 meters and bearing 45 degrees
ja: 例: 100,000メートル、方位45度で計算されるポイント

note: Tag: refpurpose
en: Sets least significant bits of coordinates to zero
ja: 座標値の最下位ビットを0にします。

note: Tag: para
en: <code>ST_QuantizeCoordinates</code> determines the number of bits (<code>N</code>) required to represent a coordinate value with a specified number of digits after the decimal point, and then sets all but the <code>N</code> most significant bits to zero. The resulting coordinate value will still round to the original value, but will have improved compressiblity. This can result in a significant disk usage reduction provided that the geometry column is using a <link xlink:href="https://www.postgresql.org/docs/current/static/storage-toast.html#STORAGE-TOAST-ONDISK"> compressible storage type</link>. The function allows specification of a different number of digits after the decimal point in each dimension; unspecified dimensions are assumed to have the precision of the <code>x</code> dimension. Negative digits are interpreted to refer digits to the left of the decimal point, (i.e., <code>prec_x=-2</code> will preserve coordinate values to the nearest 100.
ja: <code>ST_QuantizeCoordinates</code>は、指定した小数点以下の桁数での座標値表現に必要なビット数 (<code>N</code>)を決定し、最大の有効ビット数<code>N</code>以外を0にします。結果の座標値は元の値を丸めますが、圧縮性が改善されます。これにより、ジオメトリカラムが<link xlink:href="https://www.postgresql.org/docs/current/static/storage-toast.html#STORAGE-TOAST-ONDISK"> compressible storage type</link>を使って、ディスク使用を劇的に減少させることができます。この関数によって、小数点以下の桁数の異なる指定が可能になります。指定されていない次元は<code>x</code>次元の精度を持つものとします。負の桁数は、小数点以上の桁数の参照と解釈されます (例: <code>prec_x=-2</code>は100付近の座標値を保存します)。

note: Tag: para
en: The coordinates produced by <code>ST_QuantizeCoordinates</code> are independent of the geometry that contains those coordinates and the relative position of those coordinates within the geometry. As a result, existing topological relationships between geometries are unaffected by use of this function. The function may produce invalid geometry when it is called with a number of digits lower than the intrinsic precision of the geometry.
ja: <code>ST_QuantizeCoordinates</code>が生成する座標は、これらの座標を含むジオメトリや、ジオメトリ内のこれらの相対的な位置から独立しています。結果として、ジオメトリ間に存在するトポロジ関係は、この関数の使用によって影響を受けることはありません。この関数は、ジオメトリの内在的な精度より低い桁数では不正なジオメトリを生成する可能性があります。

note: Tag: title
en: Technical Background
ja: 技術背景

note: Tag: para
en: PostGIS stores all coordinate values as double-precision floating point integers, which can reliably represent 15 significant digits. However, PostGIS may be used to manage data that intrinsically has fewer than 15 significant digits. An example is TIGER data, which is provided as geographic coordinates with six digits of precision after the decimal point (thus requiring only nine significant digits of longitude and eight significant digits of latitude.)
ja: PostGIS はすべての座標値を倍精度浮動小数点数として格納し、15桁の有効桁数を確実に表すことができます。ただし、PostGISでは、本質的に15桁未満のデータの管理ができます。例としては、小数点以下6桁の精度の地理座標として提供されるTigerデータがあります (故に、必要な有効桁数は、経度は9桁、緯度は8桁です)。

note: Tag: para
en: When 15 significant digits are available, there are many possible representations of a number with 9 significant digits. A double precision floating point number uses 52 explicit bits to represent the significand (mantissa) of the coordinate. Only 30 bits are needed to represent a mantissa with 9 significant digits, leaving 22 insignificant bits; we can set their value to anything we like and still end up with a number that rounds to our input value. For example, the value 100.123456 can be represented by the floating point numbers closest to 100.123456000000, 100.123456000001, and 100.123456432199. All are equally valid, in that <code>ST_AsText(geom, 6)</code> will return the same result with any of these inputs. As we can set these bits to any value, <code>ST_QuantizeCoordinates</code> sets the 22 insignificant bits to zero. For a long coordinate sequence this creates a pattern of blocks of consecutive zeros that is compressed by PostgreSQL more efficiently.
ja: 有効桁数が15の時、多数のありえる9桁の表現があります。倍精度浮動小数点数は52の明示的なビット数を座標の仮数部に使っています。有効桁数9桁では仮数部は30ビットだけ必要で、22ビットは有効ではありません。これらの値を好きなものにすることができ、結局は入力値を丸める数字となります。例えば、100.123456という値は100.123456000000, 100.123456000001および100.123456432199に近い数として表現されます。全ては等しく妥当で、これらの入力では<code>ST_AsText(geom, 6)</code>は同じ結果を返します。これらのビット数をあらゆる値にセットすることができるので、<code>ST_QuantizeCoordinates</code>は無効ビットとなる22ビットに0をセットします。長い座標値のビット列では、連続的な0のブロックから、PostgreSQLによって効率的に圧縮されたパターンを生成します。

note: Tag: para
en: Only the on-disk size of the geometry is potentially affected by <code>ST_QuantizeCoordinates</code>. <xref linkend="ST_MemSize"/>, which reports the in-memory usage of the geometry, will return the the same value regardless of the disk space used by a geometry.
ja: ジオメトリのディスク上のサイズだけが<code>ST_QuantizeCoordinates</code>の影響を潜在的に受けます。ジオメトリのメモリ利用を報告する<xref linkend="ST_MemSize"/>は、ジオメトリに使われるディスク上のサイズにかかわらず同じ値を返します。

note: Tag: refpurpose
en: Remove a point from a linestring.
ja: ラインストリングからポイントを削除します。

note: Tag: para
en: Removes a point from a LineString, given its index (0-based). Useful for turning a closed line (ring) into an open linestring.
ja: ラインストリングからポイントを削除します。インデックスは0始まりです。閉じたリングを開いたラインストリングに変えるのに使います。

note: Tag: para
en: Guarantees no lines are closed by removing the end point of closed lines (rings). Assumes geom is of type LINESTRING
ja: 閉じたライン (リング)の終点を削除するとラインが閉じなくなることが保証されています。geomがLINESTRINGであると仮定するします。

note: Tag: refpurpose
en: Returns a version of a geometry with duplicate points removed.
ja: 重複ポイントを除いたジオメトリを返します。

note: Tag: para
en: Returns a version of the given geometry with duplicate consecutive points removed. The function processes only (Multi)LineStrings, (Multi)Polygons and MultiPoints but it can be called with any kind of geometry. Elements of GeometryCollections are processed individually. The endpoints of LineStrings are preserved.
ja: 重複ポイントを除いたジオメトリを返します。この関数は(MULTI)LINESTRING、(MULTI)POLYGON、MULTIPOINTのみを処理しますが、全ての種類のジオメトリを与えることができます。GEOMETRYCOLLECTIONの要素は個別に処理されます。LINESTRINGの端点は保持されます。

note: Tag: para
en: If the <parameter>tolerance</parameter> parameter is provided, vertices within the tolerance distance of one another are considered to be duplicates.
ja: <parameter>tolerance</parameter>を指定した場合には、他の頂点との距離が許容距離内にある頂点は重複しているとみなされます。

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Collection elements are processed individually.
ja: <emphasis role="bold">例:</emphasis> ジオメトリコレクションの要素は個別に処理されます。

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Repeated point removal with a distance tolerance.
ja: <emphasis role="bold">例:</emphasis> 許容距離内にある繰り返しポイントの削除。

note: Tag: refpurpose
en: Removes points that are irrelevant for rendering a specific rectangluar view of a geometry.
ja: 指定した矩形表示範囲での描画に関係のないジオメトリのポイントを削除します。

note: Tag: para
en: Returns a <xref linkend="geometry"/> without points being irrelevant for rendering the geometry within a given rectangluar view.
ja: 指定した矩形表示範囲での描画に関係のないポイントを外した<xref linkend="geometry"/>を返します。

note: Tag: para
en: This function can be used to quickly preprocess geometries that should be rendered only within certain bounds.
ja: この関数を使用すると、特定の範囲内のみで描画する必要があるジオメトリに対して素早い前処理を実行できます。

note: Tag: para
en: Only geometries of type (MULTI)POLYGON and (MULTI)LINESTRING are evaluated. Other geometries keep unchanged.
ja: (MULTI)POLYGONと(MULTI)LINESTRINGのタイプのジオメトリだけが評価されます。他のジオメトリは変更されません。

note: Tag: para
en: In contrast to <code>ST_ClipByBox2D()</code> this function
ja: この関数は次の点において<code>ST_ClipByBox2D()</code>と対照的です

note: Tag: para
en: sorts out points without computing new intersection points which avoids rounding errors and usually increases performance,
ja: この関数は、新しいインタセクトするポイントを計算することなくポイントの並べ替えを行うので、丸め誤差が回避され、通常は効率が向上し、

note: Tag: para
en: returns a geometry with equal or similar point number,
ja: ポイント数が同じ又は近いジオメトリを返し、

note: Tag: para
en: leads to the same rendering result within the specified view, and
ja: 指定した描画範囲内では同じ描画結果になり、

note: Tag: para
en: may introduce self-intersections which would make the resulting geometry invalid (see example below).
ja: 自己交差を発生させ、結果ジオメトリを不正にする可能性があります (下の例をご覧下さい)。

note: Tag: para
en: If <code>cartesian_hint</code> is set to <code>true</code>, the algorithm applies additional optimizations involving cartesian math to further reduce the resulting point number. Please note that using this option might introduce rendering artifacts if the resulting coordinates are projected into another (non-cartesian) coordinate system before rendering.
ja: <code>cartesian_hint</code>を<code>TRUE</code>に設定した場合には、アルゴリズムは、結果のポイント数をさらに減らすために、デカルト数学を含む、追加の最適化を適用します。結果の座標が他の (非デカルト)座標系に投影変換される場合には、この任意引数を使用することで、描画の不自然な諧調やノイズが現れる可能性があることに注意して下さい。

note: Tag: para
en: For polygons, this function does currently not ensure that the result is valid. This situation can be checked with <xref linkend="ST_IsValid"/> and repaired with <xref linkend="ST_MakeValid"/>.
ja: ポリゴンに対しては、この関数は現在は結果の妥当性を保証しません。この状況は<xref linkend="ST_IsValid"/>で確認でき、<xref linkend="ST_MakeValid"/>で修復することができます。

note: Tag: para
en: Example: ST_RemoveIrrelevantPointsForView() applied to a polygon. Blue points remain, the rendering result (light-blue area) within the grey view box remains as well.
ja: 例: ST_RemoveIrrelevantPointsForView()をポリゴンに適用しています。青いポイントが残り、灰色の描画範囲も残したうえで、結果の描画を行います (薄青の領域)。

note: Tag: para
en: Example: Due to the fact that points are just sorted out and no new points are computed, the result of ST_RemoveIrrelevantPointsForView() may contain self-intersections.
ja: 例: ポイントが並べ替えられただけで、新しいポイントが計算されなかったという事実のため、ST_RemoveIrrelevantPointsForView()の結果に自己交差が含まれることがあります。

note: Tag: refpurpose
en: Removes small parts (polygon rings or linestrings) of a geometry.
ja: ジオメトリの全ての小さな部位 (ポリゴンのリングまたはラインストリング)を削除します。

note: Tag: para
en: Returns a <xref linkend="geometry"/> without small parts (exterior or interior polygon rings, or linestrings).
ja: 小さい部位 (外側リングや内側リングやラインストリング)を持たない<xref linkend="geometry"/>を返します。

note: Tag: para
en: This function can be used as preprocessing step for creating simplified maps, e. g. to remove small islands or holes.
ja: この関数は、地図の簡略化における、小さい島や穴を削除するたといった前処理段階で使います。

note: Tag: para
en: It evaluates only geometries of type (MULTI)POLYGON and (MULTI)LINESTRING. Other geometries remain unchanged.
ja: (MULTI)POLYGONと(MULTI)LINESTRINGのタイプのジオメトリだけが評価されます。他のジオメトリは変更されません。

note: Tag: para
en: If <parameter>minSizeX</parameter> is greater than 0, parts are sorted out if their width is smaller than <parameter>minSizeX</parameter>.
ja: <parameter>minSizeX</parameter>が0より大きい場合には、<parameter>minSizeX</parameter>より小さい幅の部位が分けられます。

note: Tag: para
en: If <parameter>minSizeY</parameter> is greater than 0, parts are sorted out if their height is smaller than <parameter>minSizeY</parameter>.
ja: <parameter>minSizeY</parameter>が0より大きい場合には、<parameter>minSizeY</parameter>より小さい高さの部位が分けられます。

note: Tag: para
en: Both <parameter>minSizeX</parameter> and <parameter>minSizeY</parameter> are measured in coordinate system units of the geometry.
ja: <parameter>minSizeX</parameter>と<parameter>minSizeY</parameter>は、ともにジオメトリの座標系の単位で計測されます。

note: Tag: para
en: For polygon types, evaluation is done separately for each ring which can lead to one of the following results:
ja: ポリゴンタイプの場合には、評価はリングごとに個別に行われ、次の結果のいずれかが導かれます:

note: Tag: para
en: the original geometry,
ja: 元のジオメトリ

note: Tag: para
en: a POLYGON with all rings with less vertices,
ja: 全てのリングで頂点が減ったPOLYGON、

note: Tag: para
en: a POLYGON with a reduced number of interior rings (having possibly less vertices),
ja: 内側リングの数が減ったPOLYGON (さらに頂点が減っている場合あり)、

note: Tag: para
en: a POLYGON EMPTY, or
ja: POLYGON EMPTY、

note: Tag: para
en: a MULTIPOLYGON with a reduced number of polygons (having possibly less interior rings or vertices), or
ja: 要素ポリゴン数が減ったMULTIPOLYGON (さらに内側リング数や頂点数が減っている場合あり)、

note: Tag: para
en: a MULTIPOLYGON EMPTY.
ja: MULTIPOLYGON EMPTY。

note: Tag: para
en: For linestring types, evaluation is done for each linestring which can lead to one of the following results:
ja: ラインストリングタイプの場合には、ラインストリングごとに評価が行われるので、次のような結果が導かれます:

note: Tag: para
en: a LINESTRING with a reduced number of vertices,
ja: 頂点数の減ったLINESTRING、

note: Tag: para
en: a LINESTRING EMPTY,
ja: LINESTRING EMPTY、

note: Tag: para
en: a MULTILINESTRING with a reduced number of linestrings (having possibly less vertices), or
ja: 要素ラインストリング数の減ったMULTILINESTRING (さらに頂点が減っている場合あり)、

note: Tag: para
en: a MULTILINESTRING EMPTY.
ja: MULTILINESTRING EMPTY。

note: Tag: para
en: Example: ST_RemoveSmallParts() applied to a multi-polygon. Blue parts remain.
ja: 例: マルチポリゴンを適用したST_RemoveSmallParts()。青い領域が残った領域です。

note: Tag: refpurpose
en: Return the geometry with vertex order reversed.
ja: 頂点の順序を逆にしたジオメトリを返します。

note: Tag: para
en: Can be used on any geometry and reverses the order of the vertices.
ja: どのジオメトリでも使用可能です。頂点の順序を逆にします。

note: Tag: para
en: Enhanced: 2.4.0 support for curves was introduced.
ja: Enhanced: 2.4.0 曲線対応が導入されました。

note: Tag: refpurpose
en: Returns a modified geometry/geography having no segment longer than a given distance.
ja: 与えた長さを超える線分を持たないよう変更したジオメトリ/ジオグラフィを返します。

note: Tag: para
en: Returns a modified geometry/geography having no segment longer than <varname>max_segment_length</varname>. Length is computed in 2D. Segments are always split into equal-length subsegments.
ja: <varname>max_segment_length</varname>を超える長さの線分を持たないよう変更したジオメトリ/ジオグラフィを返します。長さは2次元で計算されます。線分は常に等長の線分に分割されます。

note: Tag: para
en: For geometry, the maximum length is in the units of the spatial reference system.
ja: ジオメトリについては、最大長の単位は空間参照系の単位です。

note: Tag: para
en: For geography, the maximum length is in meters. Distances are computed on the sphere. Added vertices are created along the spherical great-circle arcs defined by segment endpoints.
ja: ジオグラフィについては、最大長の単位はメートルです。距離は球面で計算します。追加される頂点は、線分の端点間で定まる球面の大円弧に沿うように作られます。

note: Tag: para
en: This only shortens long segments. It does not lengthen segments shorter than the maximum length.
ja: この関数は長い線分を短くするだけです。最大長より短い線分を長くすることはしません。

note: Tag: para
en: For inputs containing long segments, specifying a relatively short <varname>max_segment_length</varname> can cause a very large number of vertices to be added. This can happen unintentionally if the argument is specified accidentally as a number of segments, rather than a maximum length.
ja: 長い線分を含む入力では、比較的短い <varname>max_segment_length</varname> を指定すると、非常に多くの頂点が追加される可能性があります。これは、引数が最大長ではなく線分数として誤って指定された場合に、意図せずに発生する可能性があります。

note: Tag: para
en: Enhanced: 3.0.0 Segmentize geometry now produces equal-length subsegments
ja: Enhanced: 3.0.0 ジオメトリの分割において、現在は、同じ長さに分割しています

note: Tag: para
en: Enhanced: 2.3.0 Segmentize geography now produces equal-length subsegments
ja: Enhanced: 2.3.0 ジオグラフィの分割において、現在は、同じ長さに分割しています

note: Tag: para
en: Enhanced: 2.1.0 support for geography was introduced.
ja: Enhanced: 2.1.0 ジオグラフィ対応が導入されました。

note: Tag: para
en: Changed: 2.1.0 As a result of the introduction of geography support, the usage <code>ST_Segmentize('LINESTRING(1 2, 3 4)', 0.5)</code> causes an ambiguous function error. The input needs to be properly typed as a geometry or geography. Use ST_GeomFromText, ST_GeogFromText or a cast to the required type (e.g. <code>ST_Segmentize('LINESTRING(1 2, 3 4)'::geometry, 0.5) )</code>
ja: Changed: 2.1.0 ジオグラフィ対応の導入の結果、<code>ST_Segmentize('LINESTRING(1 2, 3 4)', 0.5)</code>とすると、あいまい関数エラーが発生します。入力ではジオメトリかジオグラフィかを確実に指定する必要があります。ST_GeomFromText、ST_GeogFromText、使いたい型へのキャスト (例: <code>ST_Segmentize('LINESTRING(1 2, 3 4)'::geometry, 0.5) )</code>を行います

note: Tag: para
en: Segmentizing a line. Long segments are split evenly, and short segments are not split.
ja: ラインの分割。長い線分は均等に分割され、短い線分は分割されません。

note: Tag: para
en: Segmentizing a polygon:
ja: ポリゴンの分割:

note: Tag: para
en: Segmentizing a geographic line, using a maximum segment length of 2000 kilometers. Vertices are added along the great-circle arc connecting the endpoints.
ja: 2000キロメートルの最大線分長を使ったジオグラフィのラインの分割。頂点は、端点間をつなぐ大円弧に沿って追加されます。

note: Tag: para
en: A geographic line segmentized along a great circle arc
ja: 大円弧に沿って細分化されたジオグラフィのライン

note: Tag: refpurpose
en: Replace point of a linestring with a given point.
ja: ラインストリングのポイントを与えられたポイントに置き換えます。

note: Tag: para
en: Replace point N of linestring with given point. Index is 0-based.Negative index are counted backwards, so that -1 is last point. This is especially useful in triggers when trying to maintain relationship of joints when one vertex moves.
ja: ラインストリングのN番目を与えられたポイントに置き換えます。インデクスは0はじまりです。負のインデックス値を与えると末尾から数えます。-1は末尾のポイントを指します。これは、頂点が一つ動いた時に接続のリレーションシップを維持しようとする場合のトリガに特に便利です。

note: Tag: para
en: Updated 2.3.0 : negative indexing
ja: Updated 2.3.0 : 添え字の負数

note: Tag: refpurpose
en: Shifts the longitude coordinates of a geometry between -180..180 and 0..360.
ja: 経度座標値を-180度から180度の範囲と0度から360度の範囲との二つの範囲を行き来するようシフトします。

note: Tag: para
en: Reads every point/vertex in a geometry, and shifts its longitude coordinate from -180..0 to 180..360 and vice versa if between these ranges. This function is symmetrical so the result is a 0..360 representation of a -180..180 data and a -180..180 representation of a 0..360 data.
ja: ジオメトリの全てのポイント/頂点を読み、経度値が-180度から0度の範囲にあるのを180度から360度の範囲にシフトして、180度から360度の範囲にあるのを-180度から0度の範囲にシフトします。この関数は対称となりますので、-180度から180度の範囲のデータを0度から360度の範囲の表現にし、0度から360度の範囲のデータを-180度から180度の範囲の表現にします。

note: Tag: para
en: This is only useful for data with coordinates in longitude/latitude; e.g. SRID 4326 (WGS 84 geographic)
ja: この関数は、SRID 436 (WGS84地理座標系)のような緯度経度の座標値を持つデータの場合に限って使います。

note: Tag: para
en: Pre-1.3.4 bug prevented this from working for MULTIPOINT. 1.3.4+ works with MULTIPOINT as well.
ja: 1.3.4より前ではMULTIPOINTでは動作しないバグがありました。1.3.4以上ではMULTIPOINTでも動作します。

note: Tag: para
en: Enhanced: 2.0.0 support for Polyhedral surfaces and TIN was introduced.
ja: Enhanced: 2.0.0 多面体サーフェス対応とTIN対応が導入されました。

note: Tag: para
en: NOTE: this function was renamed from "ST_Shift_Longitude" in 2.2.0
ja: ご注意: この関数は2.0.0で"ST_Shift_Longitude"から名称変更しました。

note: Tag: refpurpose
en: Wrap a geometry around an X value.
ja: ジオメトリをX値で回り込ませます。

note: Tag: para
en: This function splits the input geometries and then moves every resulting component falling on the right (for negative 'move') or on the left (for positive 'move') of given 'wrap' line in the direction specified by the 'move' parameter, finally re-unioning the pieces together.
ja: 入力ジオメトリを分割して、全ての結果要素が「回り込み ('wrap')」線から’move'パラメータで決められた方向、すなわち、右側 ('move'が負数)または左側 ('move'が正数)に全ての要素が落ちるように移動させ、最後に再結合します。

note: Tag: para
en: This is useful to "recenter" long-lat input to have features of interest not spawned from one side to the other.
ja: 経度緯度入力を「再センタリング」して、対象地物が一方からもう一方に飛ばないようにするのに使えます。

note: Tag: para
en: Availability: 2.3.0 requires GEOS
ja: Availability: 2.3.0 GEOSが必要です。

note: Tag: refpurpose
en: Snap all points of the input geometry to a regular grid.
ja: 入力ジオメトリの全ての点を規則的なグリッドにスナップします。

note: Tag: para
en: Variant 1,2,3: Snap all points of the input geometry to the grid defined by its origin and cell size. Remove consecutive points falling on the same cell, eventually returning NULL if output points are not enough to define a geometry of the given type. Collapsed geometries in a collection are stripped from it. Useful for reducing precision.
ja: 1, 2, 3番目の形式では、入力ジオメトリの全てのポイントを原点とセルサイズを定めたグリッドにスナップします。同じセルに落ちた、連続するポイントを削除します。引数ジオメトリのジオメトリタイプを定義できないポイントしか残らなかった場合は、NULLを返します。コレクション内で崩壊したジオメトリはそこから削除されます。精度を落とすのに使います。

note: Tag: para
en: Variant 4: Introduced 1.1.0 - Snap all points of the input geometry to the grid defined by its origin (the second argument, must be a point) and cell sizes. Specify 0 as size for any dimension you don't want to snap to a grid.
ja: 4番目の形式は、1.1.0で導入されました。入力ジオメトリの全てのポイントを原点 (第2引数で指定するもので、ポイントでなければなりません)とセルサイズを定めたグリッドにスナップします。グリッドにスナップしたくない次元についてはサイズに0を指定します。

note: Tag: para
en: The returned geometry might lose its simplicity (see <xref linkend="ST_IsSimple"/>).
ja: 返されるジオメトリは単純性が失われているかも知れません (<xref linkend="ST_IsSimple"/>を参照してください)。

note: Tag: para
en: Before release 1.1.0 this function always returned a 2d geometry. Starting at 1.1.0 the returned geometry will have same dimensionality as the input one with higher dimension values untouched. Use the version taking a second geometry argument to define all grid dimensions.
ja: 1.1.0版より前では、この関数は常に2次元ジオメトリを返しました。1.1.0版からは、返されるジオメトリの次元数は、入力値のうちで手のつけられていない最大の次元と同じになります。全てのグリッドの次元を定義するには、第2引数にジオメトリを取る形式を使って下さい。

note: Tag: para
en: Availability: 1.1.0 - Z and M support
ja: Availability: 1.1.0 - Z値とM値に対応しました

note: Tag: refpurpose
en: Snap segments and vertices of input geometry to vertices of a reference geometry.
ja: 入力ジオメトリの辺と頂点を参照ジオメトリの頂点にスナップします。

note: Tag: para
en: Snaps the vertices and segments of a geometry to another Geometry's vertices. A snap distance tolerance is used to control where snapping is performed. The result geometry is the input geometry with the vertices snapped. If no snapping occurs then the input geometry is returned unchanged.
ja: ジオメトリの頂点と辺を、もう一つのジオメトリの頂点にスナップします。スナップが実行される位置を制御するにはスナップ距離許容値を使います。結果ジオメトリはスナップされた頂点を持つ入力ジオメトリです。スナップが発生しなかった場合には、入力ジオメトリが変更されずに返されます。

note: Tag: para
en: Snapping one geometry to another can improve robustness for overlay operations by eliminating nearly-coincident edges (which cause problems during noding and intersection calculation).
ja: 一つのジオメトリからもう一つへの変換によって、近傍エッジ (ノード生成とインタセクション計算で問題を引き起こします)を除くことになり、オーバレイ演算のロバスト性が改善されます。

note: Tag: para
en: Too much snapping can result in invalid topology being created, so the number and location of snapped vertices is decided using heuristics to determine when it is safe to snap. This can result in some potential snaps being omitted, however.
ja: あまりに多数のスナップを行った場合には、生成されるトポロジが不正になる可能性があります。いつスナップが安全かを判定するために、ヒューリスティックにスナップされた頂点の数と位置が決めるしかありません。しかし、省略された潜在的なスナップになりえます。

note: Tag: para
en: The returned geometry might lose its simplicity (see <xref linkend="ST_IsSimple"/>) and validity (see <xref linkend="ST_IsValid"/>).
ja: 返されるジオメトリは単純性が失われているかも知れません (<xref linkend="ST_IsSimple"/>を参照してください)し、妥当性が失われているかも知れません (<xref linkend="ST_IsValid"/>を参照して下さい)。

note: Tag: para
en: A multipolygon shown with a linestring (before any snapping)
ja: マルチポリゴンとラインストリング (スナップ前)

note: Tag: para
en: A multipolygon snapped to linestring to tolerance: 1.01 of distance. The new multipolygon is shown with reference linestring
ja: ラインストリングに1.01の許容距離でマルチポリゴンをスナップします。新しいマルチポリゴンはラインストリングにつながります。

note: Tag: para
en: A multipolygon snapped to linestring to tolerance: 1.25 of distance. The new multipolygon is shown with reference linestring
ja: マルチラインストリングに1.25の許容距離でマルチポリゴンをスナップします。新しいマルチポリゴンはラインストリングにつながります。

note: Tag: para
en: The linestring snapped to the original multipolygon at tolerance 1.01 of distance. The new linestring is shown with reference multipolygon
ja: 元のマルチポリゴンに1.01の許容距離でラインストリングをスナップします。新しいラインストリングはマルチポリゴンにつながります。

note: Tag: para
en: The linestring snapped to the original multipolygon at tolerance 1.25 of distance. The new linestring is shown with reference multipolygon
ja: 元のマルチポリゴンに1.25の許容距離でラインストリングをスナップします。新しいラインストリングはマルチポリゴンにつながります。

note: Tag: refpurpose
en: Returns a version of the given geometry with given ordinate values swapped.
ja: 与えられたジオメトリにおいて与えられた座標の値を入れ替えたジオメトリを返します。

note: Tag: para
en: Returns a version of the given geometry with given ordinates swapped.
ja: 与えられたジオメトリにおいて与えられた座標の値を入れ替えたジオメトリを返します。

note: Tag: para
en: The <varname>ords</varname> parameter is a 2-characters string naming the ordinates to swap. Valid names are: x,y,z and m.
ja: <varname>ords</varname>引数は2文字の文字列で、入れ替える座標名を示します。座標名はx, y, z, mが有効です。

note: Tag: title
en: Exceptional Functions
ja: 例外的関数

note: Tag: para
en: These functions are rarely used functions that should only be used if your data is corrupted in someway. They are used for troubleshooting corruption and also fixing things that should under normal circumstances, never happen.
ja: ここで示す関数は、データが何らかの理由で破損した場合にだけ使われる、使用頻度の低い関数です。これらの関数は破損のトラブルシューティングと通常の環境では決して起こらないことを訂正するために使われます。

note: Tag: refpurpose
en: Add bounding box to the geometry.
ja: ジオメトリにバウンディングボックスを追加します。

note: Tag: para
en: Add bounding box to the geometry. This would make bounding box based queries faster, but will increase the size of the geometry.
ja: ジオメトリにバウンディングボックスを追加します。これにより、バウンディングボックスに基づく検索が早くなりますが、ジオメトリのサイズが大きくなります。

note: Tag: para
en: Bounding boxes are automatically added to geometries so in general this is not needed unless the generated bounding box somehow becomes corrupted or you have an old install that is lacking bounding boxes. Then you need to drop the old and re-add.
ja: バウンディングボックスは自動的にジオメトリに追加されるので、通常はこの関数は不要ですが、生成されたバウンディングボックスが何らかの理由で破損するか、バウンディングボックスを欠く古い版をインストールしている場合に使われます。古いものを削除し、再追加する必要があります。

note: Tag: refpurpose
en: Drop the bounding box cache from the geometry.
ja: ジオメトリからバウンディングボックスのキャッシュを削除します。

note: Tag: para
en: Drop the bounding box cache from the geometry. This reduces geometry size, but makes bounding-box based queries slower. It is also used to drop a corrupt bounding box. A tale-tell sign of a corrupt cached bounding box is when your ST_Intersects and other relation queries leave out geometries that rightfully should return true.
ja: ジオメトリからバウンディングボックスのキャッシュを削除します。これによりジオメトリのサイズは小さくなりますが、バウンディングボックスを基にした検索が遅くなります。破損したバウンディングボックスを削除する際にも使われます。ST_Intersectsや他の関係関数がジオメトリを正しくtrueを返すべきジオメトリを無視すると、それが、バウンディングボックスのキャッシュが破損したことを示す合図です。

note: Tag: para
en: Bounding boxes are automatically added to geometries and improve speed of queries so in general this is not needed unless the generated bounding box somehow becomes corrupted or you have an old install that is lacking bounding boxes. Then you need to drop the old and re-add. This kind of corruption has been observed in 8.3-8.3.6 series whereby cached bboxes were not always recalculated when a geometry changed and upgrading to a newer version without a dump reload will not correct already corrupted boxes. So one can manually correct using below and re-add the bbox or do a dump reload.
ja: バウンディングボックスは自動的にジオメトリに追加されるので、通常はこの関数は不要ですが、生成されたバウンディングボックスが何らかの理由で破損するか、バウンディングボックスを欠く古い版をインストールしている場合に使われます。古いものを削除し、再追加する必要があります。この種類の破損は8.3-8.3.6で観察されました。ジオメトリが変更された際に常にキャッシュされたバウンディングボックスが再計算されておらず、ダンプと再読み込みを行わずに新しい版へのアップグレードを行うと、既に破損したバウンディングボックスが訂正されないためです。次に示すように手動で収集してバウンディングボックスを再追加するか、ダンプとリロードを使います。

note: Tag: refpurpose
en: Returns TRUE if the bbox of this geometry is cached, FALSE otherwise.
ja: ジオメトリのバウンディングボックスがキャッシュされている場合にはTRUEを返し、他の場合にはFALSEを返します。

note: Tag: para
en: Returns TRUE if the bbox of this geometry is cached, FALSE otherwise. Use <xref linkend="PostGIS_AddBBox"/> and <xref linkend="PostGIS_DropBBox"/> to control caching.
ja: ジオメトリのバウンディングボックスがキャッシュされている場合にはTRUEを返し、他の場合にはFALSEを返します。<xref linkend="PostGIS_AddBBox"/>と<xref linkend="PostGIS_DropBBox"/>でバウンディングボックスのキャッシュを制御します。

note: Tag: title
en: Grand Unified Custom Variables (GUCs)
ja: Grand Unified Custom変数 (GUC)

note: Tag: para
en: This section lists custom PostGIS Grand Unified Custom Variables (GUC). These can be set globally, by database, by session or by transaction. Best set at global or database level.
ja: 本節では、PostGIS GUC (Grand Unified Custom)変数の一覧を上げます。これらは、グローバル、データベースごと、セッションごと、またはトランザクションごとに設定できます。グローバルまたはデータベースごとの設定が最善です。

note: Tag: refpurpose
en: The backend to service a function where GEOS and SFCGAL overlap. Options: geos or sfcgal. Defaults to geos.
ja: GEOSとSFCGALで重複する関数を提供するバックエンドです。GEOSまたはSFCGALを選択します。デフォルトはGEOSです。

note: Tag: para
en: This GUC is only relevant if you compiled PostGIS with sfcgal support. By default <varname>geos</varname> backend is used for functions where both GEOS and SFCGAL have the same named function. This variable allows you to override and make sfcgal the backend to service the request.
ja: このGUCはSFCGALサポートでPostGISをコンパイルした場合にのみ適切なものとなります。デフォルトでは、<varname>geos</varname>バックエンドはGEOSとSFCGALが同じ名前の関数を持つ関数で使われます。この変数によって、SFCGALをリクエストを提供するバックエンドにすることができます。

note: Tag: para
en: Sets backend just for life of connection
ja: バックエンドを接続時にだけ設定します。

note: Tag: para
en: Sets backend for new connections to database
ja: データベースへの新規接続にバックエンドを設定します。

note: Tag: refpurpose
en: A configuration option to assign the value of GDAL's GDAL_DATA option. If not set, the environmentally set GDAL_DATA variable is used.
ja: GDALのGDAL_DATAオプションの値を設定するためのコンフィギュレーションオプションです。設定しない場合には、GDAL_DATA環境変数が使われます。

note: Tag: para
en: A PostgreSQL GUC variable for setting the value of GDAL's GDAL_DATA option. The <varname>postgis.gdal_datapath</varname> value should be the complete physical path to GDAL's data files.
ja: GDALのGDAL_DATAオプションの値の設定に使うPostgreSQL GUC変数です。<varname>postgis.gdal_datapath</varname>値は完全にGDALのデータファイルへの物理的なパスになるべきものです。

note: Tag: para
en: This configuration option is of most use for Windows platforms where GDAL's data files path is not hard-coded. This option should also be set when GDAL's data files are not located in GDAL's expected path.
ja: コンフィギュレーションオプションは、GDALのデータファイルパスがハードコーディングされていないWindowsプラットフォームのためにほとんど使われます。このオプションは、GDALのデータファイルがGDALの期待されているパスに無いときに設定します。

note: Tag: para
en: This option can be set in PostgreSQL's configuration file postgresql.conf. It can also be set by connection or transaction.
ja: このオプションは、PostgreSQLのコンフィギュレーションファイルpostgresql.confで設定できます。コネクションまたはトランザクションでも設定できます。

note: Tag: para
en: Additional information about GDAL_DATA is available at GDAL's <link xlink:href="http://trac.osgeo.org/gdal/wiki/ConfigOptions">Configuration Options</link>.
ja: GDAL_DATAに関する追加情報報は、GDALの<link xlink:href="http://trac.osgeo.org/gdal/wiki/ConfigOptions">Configuration Options</link>にあります。

note: Tag: para
en: Set and reset <varname>postgis.gdal_datapath</varname>
ja: <varname>postgis.gdal_datapath</varname>の設定とリセット。

note: Tag: para
en: Setting on windows for a particular database
ja: Windows上における特定のデータベース上で設定する場合は次の通りです。

note: Tag: refpurpose
en: A configuration option to set the enabled GDAL drivers in the PostGIS environment. Affects the GDAL configuration variable GDAL_SKIP.
ja: PostGIS環境でGDALドライバを有効にするコンフィギュレーションオプションです。GDALコンフィギュレーション変数GDAL_SKIPに影響を与えます。

note: Tag: para
en: A configuration option to set the enabled GDAL drivers in the PostGIS environment. Affects the GDAL configuration variable GDAL_SKIP. This option can be set in PostgreSQL's configuration file: postgresql.conf. It can also be set by connection or transaction.
ja: PostGIS環境でGDALドライバを有効にするコンフィギュレーションオプションです。GDALコンフィギュレーション変数GDAL_SKIPに影響を与えます。このオプションは、PostgreSQLのコンフィギュレーションファイルpostgresql.confで設定できます。コネクションまたはトランザクションでも設定できます。

note: Tag: para
en: The initial value of <varname>postgis.gdal_enabled_drivers</varname> may also be set by passing the environment variable <varname>POSTGIS_GDAL_ENABLED_DRIVERS</varname> with the list of enabled drivers to the process starting PostgreSQL.
ja: <varname>postgis.gdal_enabled_drivers</varname>の初期値は、PostgreSQL開始プロセスに渡される、有効とするドライバの一覧からなる環境変数<varname>POSTGIS_GDAL_ENABLED_DRIVERS</varname>によって設定されます。

note: Tag: para
en: Enabled GDAL specified drivers can be specified by the driver's short-name or code. Driver short-names or codes can be found at <link xlink:href="http://www.gdal.org/formats_list.html">GDAL Raster Formats</link>. Multiple drivers can be specified by putting a space between each driver.
ja: 有効にするGDALドライバは、ドライバの短縮名またはコードで指定します。ドライバの短縮名またはコードは<link xlink:href="http://www.gdal.org/formats_list.html">GDAL Raster Formats</link>にあります。複数のドライバを指定するには、ドライバの間に一つの空白を置きます。

note: Tag: para
en: There are three special codes available for <varname>postgis.gdal_enabled_drivers</varname>. The codes are case-sensitive.
ja: <varname>postgis.gdal_enabled_drivers</varname>には三つの特別なコードがあります。大文字小文字を区別します。

note: Tag: para
en: <varname>DISABLE_ALL</varname> disables all GDAL drivers. If present, <varname>DISABLE_ALL</varname> overrides all other values in <varname>postgis.gdal_enabled_drivers</varname>.
ja: <varname>DISABLE_ALL</varname> 全てのGDALドライバを無効にします。<varname>DISABLE_ALL</varname>は<varname>postgis.gdal_enabled_drivers</varname>にある他の全ての値を上書きします。

note: Tag: para
en: <varname>ENABLE_ALL</varname> enables all GDAL drivers.
ja: <varname>ENABLE_ALL</varname> 全てのGDALドライバを有効にします。

note: Tag: para
en: <varname>VSICURL</varname> enables GDAL's <varname>/vsicurl/</varname> virtual file system.
ja: <varname>VSICURL</varname> GDALの仮想ファイルシステム<varname>/vsicurl/</varname>を有効にします。

note: Tag: para
en: When <varname>postgis.gdal_enabled_drivers</varname> is set to DISABLE_ALL, attempts to use out-db rasters, ST_FromGDALRaster(), ST_AsGDALRaster(), ST_AsTIFF(), ST_AsJPEG() and ST_AsPNG() will result in error messages.
ja: <varname>postgis.gdal_enabled_drivers</varname>がDISABLE_ALLにっていされると、データベース外ラスタ, ST_FromGDALRaster(), ST_AsGDALRaster(), ST_AsTIFF(), ST_AsJPEG(), ST_AsPNG()を使おうとすると、エラーメッセージが返されます。

note: Tag: para
en: In the standard PostGIS installation, <varname>postgis.gdal_enabled_drivers</varname> is set to DISABLE_ALL.
ja: 標準的なPostGISのインストールでは、 <varname>postgis.gdal_enabled_drivers</varname>はDISALBE_ALLに設定されます。

note: Tag: para
en: Additional information about GDAL_SKIP is available at GDAL's <link xlink:href="http://trac.osgeo.org/gdal/wiki/ConfigOptions">Configuration Options</link>.
ja: GDAL_SKIPに関する追加情報は、GDALの<link xlink:href="http://trac.osgeo.org/gdal/wiki/ConfigOptions">Configuration Options</link>にあります。

note: Tag: para
en: Set and reset <varname>postgis.gdal_enabled_drivers</varname>
ja: <varname>postgis.gdal_enabled_drivers</varname>の設定とリセット。

note: Tag: para
en: Sets backend for all new connections to database
ja: データベースへの新規接続にバックエンドを設定します。

note: Tag: para
en: Sets default enabled drivers for all new connections to server. Requires super user access and PostgreSQL 9.4+. Also note that database, session, and user settings override this.
ja: サーバへの全ての新規接続のための、有効なドライバのデフォルトを設定します。スーパーユーザ権限とPostgreSQL 9.4以上が必要です。データベース設定、セッション設定、ユーザ設定によって上書きされます。

note: Tag: para
en: Enable all GDAL Drivers
ja: 全てのGDALドライバを有効にします。

note: Tag: para
en: Disable all GDAL Drivers
ja: 全てのGDALドライバを無効にします。

note: Tag: refpurpose
en: A boolean configuration option to enable access to out-db raster bands.
ja: データベース外ラスタのバンドにアクセスできるようにする、真偽型のコンフィギュレーションオプション。

note: Tag: para
en: A boolean configuration option to enable access to out-db raster bands. This option can be set in PostgreSQL's configuration file: postgresql.conf. It can also be set by connection or transaction.
ja: データベース外ラスタのバンドにアクセスできるようにする、真偽型のコンフィギュレーションオプションです。このオプションは、PostgreSQLのコンフィギュレーションファイルpostgresql.confで設定できます。コネクションまたはトランザクションでも設定できます。

note: Tag: para
en: The initial value of <varname>postgis.enable_outdb_rasters</varname> may also be set by passing the environment variable <varname>POSTGIS_ENABLE_OUTDB_RASTERS</varname> with a non-zero value to the process starting PostgreSQL.
ja: <varname>postgis.enable_outdb_rasters</varname>の初期値は、環境変数<varname>POSTGIS_ENABLE_OUTDB_RASTERS</varname>が0でない値で、PostgreSQL開始プロセスに渡されることでで設定されます。

note: Tag: para
en: Even if <varname>postgis.enable_outdb_rasters</varname> is True, the GUC <varname>postgis.gdal_enabled_drivers</varname> determines the accessible raster formats.
ja: <varname>postgis.enable_outdb_rasters</varname>がTRUEであってでも、GUC <varname>postgis.gdal_enabled_drivers</varname>は、アクセス可能なラスタ書式を判定します。

note: Tag: para
en: In the standard PostGIS installation, <varname>postgis.enable_outdb_rasters</varname> is set to False.
ja: 標準的なPostGISのインストールでは、<varname>postgis.enable_outdb_rasters</varname>はFALSEに設定されています。

note: Tag: para
en: Set and reset <varname>postgis.enable_outdb_rasters</varname> for current session
ja: 現在のセッションでの<varname>postgis.enable_outdb_rasters</varname>の設定とリセット。

note: Tag: para
en: Set for specific database
ja: 特定のデータベースに対する設定

note: Tag: para
en: Setting for whole database cluster. You need to reconnect to the database for changes to take effect.
ja: データベースクラスタ全体の設定。変更を有効にするには、データベースに再接続する必要があります。

note: Tag: refpurpose
en: A string configuration to set options used when working with an out-db raster.
ja: データベース外ラスタを操作する時に使用するオプションを設定するためのコンフィギュレーション。

note: Tag: para
en: A string configuration to set options used when working with an out-db raster. <link xlink:href="http://trac.osgeo.org/gdal/wiki/ConfigOptions">Configuration options</link> control things like how much space GDAL allocates to local data cache, whether to read overviews, and what access keys to use for remote out-db data sources.
ja: データベース外ラスタを操作する時に使用するオプションを設定するためのコンフィギュレーション。<link xlink:href="http://trac.osgeo.org/gdal/wiki/ConfigOptions">Configuration options</link>によって、どれだけGDALがローカルデータキャッシュを確保するか、オーバビューを読むかどうか、リモートのデータベース外データソースを使う際のアクセスキー等を制御します。

note: Tag: para
en: Set <varname>postgis.gdal_vsi_options</varname> for current session:
ja: 現在のセッションでの<varname>postgis.gdal_vsi_options</varname>の設定:

note: Tag: para
en: Set <varname>postgis.gdal_vsi_options</varname> just for the <emphasis>current transaction</emphasis> using the <varname>LOCAL</varname> keyword:
ja: <varname>LOCAL</varname>キーワードを使う<emphasis>現在のトランザクション</emphasis>のための<varname>postgis.gdal_vsi_options</varname>の設定:

note: Tag: title
en: Geometry Input
ja: ジオメトリ入力

note: Tag: para
en: These functions create geometry objects from various textual or binary formats.
ja: これらの関数によって、様々な文字列形式やバイナリ形式からジオメトリオブジェクトを生成できます。

note: Tag: refpurpose
en: <refpurpose>Construct a Polygon given an arbitrary collection of closed linestrings as a MultiLineString Well-Known text representation.</refpurpose>
ja: <refpurpose>マルチラインストリングのWell-Known Text表現による、閉じたラインストリングの任意のコレクションからポリゴンを生成します。</refpurpose>

note: Tag: para
en: <para>Construct a Polygon given an arbitrary collection of closed linestrings as a MultiLineString Well-Known text representation.</para>
ja: <para>マルチラインストリングのWell-Known Text表現による、閉じたラインストリングの任意のコレクションからポリゴンを構築します。</para>

note: Tag: para
en: Throws an error if WKT is not a MULTILINESTRING. Throws an error if output is a MULTIPOLYGON; use ST_BdMPolyFromText in that case, or see ST_BuildArea() for a postgis-specific approach.
ja: WKTがMULTILINESTRINGでない場合には、エラーが投げられます。出力がMULTIPOLYGONになる場合には、エラーが投げられますが、この場合はST_BdMPolyFromTextを使うかPostGIS独特のアプローチとして<link linkend="ST_BuildArea">ST_BuildArea()</link>をご覧ください。

note: Tag: refpurpose
en: Construct a MultiPolygon given an arbitrary collection of closed linestrings as a MultiLineString text representation Well-Known text representation.
ja: マルチラインストリングのWell-Known Text表現による、閉じたラインストリングの任意のコレクションからマルチポリゴンを構築します。

note: Tag: para
en: Construct a Polygon given an arbitrary collection of closed linestrings, polygons, MultiLineStrings as Well-Known text representation.
ja: マルチラインストリングのWell-Known Text表現による、閉じたラインストリングの任意のコレクションからマルチポリゴンを構築します。

note: Tag: para
en: Throws an error if WKT is not a MULTILINESTRING. Forces MULTIPOLYGON output even when result is really only composed by a single POLYGON; use <link linkend="ST_BdPolyFromText">ST_BdPolyFromText</link> if you're sure a single POLYGON will result from operation, or see <link linkend="ST_BuildArea">ST_BuildArea()</link> for a postgis-specific approach.
ja: WKTがMULTILINESTRINGでない場合には、エラーが投げられます。出力が単一のポリゴンであってもマルチポリゴンに強制されます。単一のポリゴンが返って欲しい場合は<link linkend="ST_BdPolyFromText">ST_BdPolyFromText</link>を使うかPostGIS独特のアプローチとして<link linkend="ST_BuildArea">ST_BuildArea()</link>をご覧ください。

note: Tag: refpurpose
en: Return a specified geography value from Well-Known Text representation or extended (WKT).
ja: Well-Known Text表現または拡張WKTから指定したジオグラフィ値を返します。

note: Tag: para
en: Returns a geography object from the well-known text or extended well-known representation. SRID 4326 is assumed if unspecified. This is an alias for ST_GeographyFromText. Points are always expressed in long lat form.
ja: Well-Known Text表現または拡張WKTから指定したジオグラフィ値を返します。SRID 4326を仮定します。この関数はST_GeographyFromTextの別名です。ポイントは常に経度緯度形式で表現されます。

note: Tag: para
en: Returns a geography object from the well-known text representation. SRID 4326 is assumed if unspecified.
ja: Well-Known Text表現から指定したジオグラフィ値を返します。SRID 4326を仮定します。

note: Tag: refpurpose
en: Makes a collection Geometry from collection WKT with the given SRID. If SRID is not given, it defaults to 0.
ja: WKT表現と与えられたSRIDからジオメトリのコレクションを生成します。SRIDが与えられていない場合は0とします。

note: Tag: para
en: Makes a collection Geometry from the Well-Known-Text (WKT) representation with the given SRID. If SRID is not given, it defaults to 0.
ja: Well-Kown-Text (WKT)表現のコレクションと与えられたSRIDからジオメトリのコレクションを生成します。SRIDが与えられていない場合は0とします。

note: Tag: para
en: OGC SPEC 3.2.6.2 - option SRID is from the conformance suite
ja: OGC SPEC 3.2.6.2 - 任意引数SRIDは仕様適合のためです。

note: Tag: para
en: Returns null if the WKT is not a GEOMETRYCOLLECTION
ja: WKTがGEOMETRYCOLLECTIONでない場合には、NULLを返します。

note: Tag: para
en: If you are absolutely sure all your WKT geometries are collections, don't use this function. It is slower than ST_GeomFromText since it adds an additional validation step.
ja: 全てのWKTジオメトリがジオメトリコレクションであると絶対的な確信を持てる場合は、この関数は使わないでください。付加的な評価ステップが追加されるのでST_GeomFromTextより遅いです。

note: Tag: refpurpose
en: Return a specified ST_Geometry value from Extended Well-Known Text representation (EWKT).
ja: 拡張Well-Known Text表現 (EWKT)から指定されたST_Geometry値を返します。

note: Tag: para
en: Constructs a PostGIS ST_Geometry object from the OGC Extended Well-Known text (EWKT) representation.
ja: 拡張Well-Known Text表現 (EWKT)からPostGIS ST_Geometryオブジェクトを生成します。

note: Tag: para
en: The EWKT format is not an OGC standard, but an PostGIS specific format that includes the spatial reference system (SRID) identifier
ja: EWKT書式はOGC標準ではなくPostGIS独特の書式で、空間参照系ID (SRID)を含みます。

note: Tag: refpurpose
en: Takes MARC21/XML geographic data as input and returns a PostGIS geometry object.
ja: MARC21/XML地理データを入力に取り、PostGISジオメトリオブジェクトを返します。

note: Tag: para
en: This function creates a PostGIS geometry from a MARC21/XML record, which can contain a <varname>POINT</varname> or a <varname>POLYGON</varname>. In case of multiple geographic data entries in the same MARC21/XML record, a <varname>MULTIPOINT</varname> or <varname>MULTIPOLYGON</varname> will be returned. If the record contains mixed geometry types, a <varname>GEOMETRYCOLLECTION</varname> will be returned. It returns NULL if the MARC21/XML record does not contain any geographic data (datafield:034).
ja: この関数はMARC21/XMLデータからPostGISジオメトリを生成するものです。<varname>POINT</varname>または<varname>POLYGON</varname>を含みます。同じMARC21/XMLデータで複数の地理データが存在する場合には、 <varname>MULTIPOINT</varname>または<varname>MULTIPOLYGON</varname> を返します。データにジオメトリタイプが混じっている場合には、<varname>GEOMETRYCOLLECTION</varname>を返します。MARC21/XMLデータに地理データ (データフィールド:034)を含まない場合にはNULLを返します。

note: Tag: para
en: LOC MARC21/XML versions supported:
ja: 対応するLOC MARC21/XMLのバージョンは次の通りです。

note: Tag: para
en: Availability: 3.3.0, requires libxml2 2.6+
ja: Availability: 3.3.0 libxml2 2.6以上が必要です。

note: Tag: para
en: The MARC21/XML Coded Cartographic Mathematical Data currently does not provide any means to describe the Spatial Reference System of the encoded coordinates, so this function will always return a geometry with <varname>SRID 0</varname>.
ja: MARC21/XMLコード化地理数値データでは、今のところコード化した座標の空間参照系を記述する手段がないため、この関数は常に<varname>SRID 0</varname>のジオメトリを返すことになります。

note: Tag: para
en: Returned <varname>POLYGON</varname> geometries will always be clockwise oriented.
ja: 返される<varname>POLYGON</varname>ジオメトリは常に時計回り方向です。

note: Tag: para
en: Converting MARC21/XML geographic data containing a single <varname>POINT</varname> encoded as <varname>hddd.dddddd</varname>
ja: <varname>POINT</varname>を一つ含み <varname>hddd.dddddd</varname>でエンコードしたMARC21/XML地理データの変換

note: Tag: para
en: Converting MARC21/XML geographic data containing a single <varname>POLYGON</varname> encoded as <varname>hdddmmss</varname>
ja: <varname>POLYGON</varname>を一つ含み <varname>hdddmmss</varname>でエンコードしたMARC21/XML地理データの変換

note: Tag: para
en: Converting MARC21/XML geographic data containing a <varname>POLYGON</varname> and a <varname>POINT</varname>:
ja: <varname>POLYGON</varname>と<varname>POINT</varname>を含むMARC21/XML地理データの変換:

note: Tag: refpurpose
en: Return a specified ST_Geometry value from Well-Known Text representation (WKT). This is an alias name for ST_GeomFromText
ja: Well-Knwon Text表現 (WKT)から指定したST_Geometry値を返します。これはST_GeomFromTextの別名です。

note: Tag: refpurpose
en: Return a specified ST_Geometry value from Well-Known Text representation (WKT).
ja: Well-Known Text表現 (WKT)から指定したST_Geometryを返します。

note: Tag: para
en: Constructs a PostGIS ST_Geometry object from the OGC Well-Known text representation.
ja: OGC Well-Known Text表現からPostGIS ST_Geometryオブジェクトを生成します。

note: Tag: para
en: There are two variants of ST_GeomFromText function. The first takes no SRID and returns a geometry with no defined spatial reference system (SRID=0). The second takes a SRID as the second argument and returns a geometry that includes this SRID as part of its metadata.
ja: ST_GeomFromText関数には二つの形式があります。一つ目は、SRIDを取らず、空間参照系を持たない (SRID=0)ジオメトリを返すものです。二つ目は、SRIDを第2引数に取り、メタデータの一部としてSRIDを含むジオメトリを返すものです。

note: Tag: para
en: &sfs_compliant; s3.2.6.2 - option SRID is from the conformance suite.
ja: &sfs_compliant; s3.2.6.2 - 任意引数SRIDは仕様適合のためです。

note: Tag: para
en: While not OGC-compliant, <xref linkend="ST_MakePoint"/> is faster than ST_GeomFromText and ST_PointFromText. It is also easier to use for numeric coordinate values. <xref linkend="ST_Point"/> is another option similar in speed to <xref linkend="ST_MakePoint"/> and is OGC-compliant, but doesn't support anything but 2D points.
ja: OGC非準拠ですが、<xref linkend="ST_MakePoint"/>はST_GeomFromTextやST_PointFromTextより早いです。座標値に数値を使っている場合には簡単になるという利点もあります。他の選択肢として<xref linkend="ST_Point"/>は、速度面では<xref linkend="ST_MakePoint"/>と似ていて、かつOGC準拠ですが、2次元ポイントしか対応していません。

note: Tag: para
en: Changed: 2.0.0 In prior versions of PostGIS ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') was allowed. This is now illegal in PostGIS 2.0.0 to better conform with SQL/MM standards. This should now be written as ST_GeomFromText('GEOMETRYCOLLECTION EMPTY')
ja: Changed: 2.0.0 前の版ではST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)')が許されていました。SQL/MM標準への適合のためPostGIS 2.0.0では不正とされます。今はST_GeomFromText('GEOMETRYCOLLECTION EMPTY')となります。

note: Tag: refpurpose
en: Makes a Geometry from WKT representation with the given SRID. If SRID is not given, it defaults to 0.
ja: WKT表現と与えられたSRIDからジオメトリを生成します。SRIDが与えられていない場合は0 (不明)となります。

note: Tag: para
en: Makes a Geometry from WKT with the given SRID. If SRID is not given, it defaults to 0. If WKT passed in is not a LINESTRING, then null is returned.
ja: WKT表現と与えられたSRIDからジオメトリを生成します。SRIDが与えられていない場合は0 (不明)となります。渡されたWKTがLINESTRINGでない場合にはNULLが返ります。

note: Tag: para
en: OGC SPEC 3.2.6.2 - option SRID is from the conformance suite.
ja: OGC SPEC 3.2.6.2 - 任意引数SRIDは仕様適合のためです。

note: Tag: para
en: If you know all your geometries are LINESTRINGS, its more efficient to just use ST_GeomFromText. This just calls ST_GeomFromText and adds additional validation that it returns a linestring.
ja: 全てのジオメトリがLINESTRINGであると知っている場合は、ST_GeomFromTextを使う方が効率的です。 この関数はST_GeomFromTextの呼び出しと、LINESTRINGを返すかどうかの評価とを行います。

note: Tag: refpurpose
en: Return a specified ST_MultiLineString value from WKT representation.
ja: WKT表現から指定したST_MultiLineString値を返します。

note: Tag: para
en: Makes a Geometry from Well-Known-Text (WKT) with the given SRID. If SRID is not given, it defaults to 0.
ja: Well-Kown-Text (WKT)表現のコレクションと与えられたSRIDからジオメトリを生成します。SRIDが与えられていない場合は0 (不明)とします。

note: Tag: para
en: Returns null if the WKT is not a MULTILINESTRING
ja: WKTがMULTILINESTRINGでない場合はNULLを返します。

note: Tag: para
en: If you are absolutely sure all your WKT geometries are points, don't use this function. It is slower than ST_GeomFromText since it adds an additional validation step.
ja: 全てのWKTジオメトリがマルチラインストリングであると絶対的な確信を持てる場合は、この関数は使わないでください。付加的な評価ステップが追加されるのでST_GeomFromTextより遅いです。

note: Tag: refpurpose
en: <refpurpose>Makes a Geometry from WKT with the given SRID. If SRID is not given, it defaults to 0.</refpurpose>
ja: <refpurpose>Well-Known Text (WKT)表現と与えられたSRIDからジオメトリを生成します。SRIDを与えない場合は0 (不明)となります。</refpurpose>

note: Tag: para
en: <para>Makes a Geometry from WKT with the given SRID. If SRID is not given, it defaults to 0.</para>
ja: <para>Well-Known Text (WKT)表現と与えられたSRIDからジオメトリを生成します。SRIDが与えられていない場合は0 (不明)となります。</para>

note: Tag: para
en: Returns null if the WKT is not a MULTIPOINT
ja: WKTがMULTIPOINTでない場合はNULLを返します。

note: Tag: refpurpose
en: Makes a MultiPolygon Geometry from WKT with the given SRID. If SRID is not given, it defaults to 0.
ja: Well-Known Text (WKT)表現と与えられたSRIDからマルチポリゴンを生成します。SRIDが与えられていない場合は0 (不明)となります。

note: Tag: para
en: Makes a MultiPolygon from WKT with the given SRID. If SRID is not given, it defaults to 0.
ja: Well-Known Text (WKT)表現と与えられたSRIDからマルチポリゴンを生成します。SRIDが与えられていない場合は0 (不明)となります。

note: Tag: para
en: Throws an error if the WKT is not a MULTIPOLYGON
ja: WKTがMULTIPOLYGONでない場合はエラーを投げます。

note: Tag: para
en: If you are absolutely sure all your WKT geometries are multipolygons, don't use this function. It is slower than ST_GeomFromText since it adds an additional validation step.
ja: 全てのWKTジオメトリがマルチポリゴンであると絶対的な確信を持てる場合は、この関数は使わないでください。付加的な評価ステップが追加されるのでST_GeomFromTextより遅いです。

note: Tag: refpurpose
en: Makes a point Geometry from WKT with the given SRID. If SRID is not given, it defaults to unknown.
ja: WKTと与えられたSRIDからポイントジオメトリを生成します。SRIDが与えられていない場合は0 (不明)とします。

note: Tag: para
en: Constructs a PostGIS ST_Geometry point object from the OGC Well-Known text representation. If SRID is not given, it defaults to unknown (currently 0). If geometry is not a WKT point representation, returns null. If completely invalid WKT, then throws an error.
ja: OGC Well-Known Text表現からPostGISのST_Geometryポイントオブジェクトを生成します。SRIDが与えられていない場合は不明 (現在は0)とします。ジオメトリがWKTポイント表現でない場合はNULLを返します。完全に不正なWKTならエラーが投げられます。

note: Tag: para
en: There are 2 variants of ST_PointFromText function, the first takes no SRID and returns a geometry with no defined spatial reference system. The second takes a spatial reference id as the second argument and returns an ST_Geometry that includes this srid as part of its meta-data. The srid must be defined in the spatial_ref_sys table.
ja: ST_PointFromTextには二つの形式があります。 一つ目は、SRIDを取らずに空間参照系を定義していないジオメトリを返すものです。 二つ目は、空間参照系識別番号を第2引数に取り、SRIDをメタデータの一部として含むST_Geometryを返すものです。SRIDはspatial_ref_sysテーブルで定義されていなければなりません。

note: Tag: para
en: If you are absolutely sure all your WKT geometries are points, don't use this function. It is slower than ST_GeomFromText since it adds an additional validation step. If you are building points from long lat coordinates and care more about performance and accuracy than OGC compliance, use <xref linkend="ST_MakePoint"/> or OGC compliant alias <xref linkend="ST_Point"/>.
ja: 全てのWKTジオメトリがジオメトリコレクションであると絶対的な確信を持てる場合は、この関数は使わないでください。付加的な評価ステップが追加されるのでST_GeomFromTextより遅いです。 経度緯度座標からポイントを生成していて、OGC対応よりもパフォーマンスと精度を重視する場合は、<xref linkend="ST_MakePoint"/>か、OGC対応の別名である<xref linkend="ST_Point"/>を使用して下さい。

note: Tag: para
en: Makes a Geometry from WKT with the given SRID. If SRID is not given, it defaults to 0. Returns null if WKT is not a polygon.
ja: WKT表現と与えられたSRIDからジオメトリを生成します。SRIDが与えられていない場合は0 (不明)とします。WKTがポリゴンでない場合はNULLを返します。

note: Tag: para
en: If you are absolutely sure all your WKT geometries are polygons, don't use this function. It is slower than ST_GeomFromText since it adds an additional validation step.
ja: 全てのWKTジオメトリがポリゴンであると絶対的な確信を持てる場合は、この関数は使わないでください。付加的な評価ステップが追加されるのでST_GeomFromTextより遅いです。

note: Tag: refpurpose
en: Creates a geography instance from a Well-Known Binary geometry representation (WKB) or extended Well Known Binary (EWKB).
ja: Well-Known Binaryジオメトリ表現(WKB)または拡張WKB(EWKB)からジオグラフィインスタンスを生成します。

note: Tag: para
en: The <varname>ST_GeogFromWKB</varname> function, takes a well-known binary representation (WKB) of a geometry or PostGIS Extended WKB and creates an instance of the appropriate geography type. This function plays the role of the Geometry Factory in SQL.
ja: <varname>ST_GeogFromWKB</varname>は、ジオメトリのWell-Known Binary表現 (WKB)またはPostGIS拡張WKBを得て、適切なジオグラフィ型のインスタンスを生成します。この関数はSQLのジオメトリファクトリの役割を果たします。

note: Tag: para
en: If SRID is not specified, it defaults to 4326 (WGS 84 long lat).
ja: SRIDが指定されていない場合には、デフォルトは4326 (WGS 84経度緯度)となります。

note: Tag: refpurpose
en: Return a specified ST_Geometry value from Extended Well-Known Binary representation (EWKB).
ja: 拡張Well-Known Binary表現 (EWKB)から指定したST_Geometry値を返します。

note: Tag: para
en: Constructs a PostGIS ST_Geometry object from the OGC Extended Well-Known binary (EWKT) representation.
ja: 拡張Well-Known Binary表現 (EWKB)からPostGISのST_Geometryオブジェクトを構築します。

note: Tag: para
en: The EWKB format is not an OGC standard, but a PostGIS specific format that includes the spatial reference system (SRID) identifier
ja: EWKB書式はOGC標準ではなくPostGIS独特の書式で、空間参照系識別番号 (SRID)を含みます。

note: Tag: para
en: line string binary rep 0f LINESTRING(-71.160281 42.258729,-71.160837 42.259113,-71.161144 42.25932) in NAD 83 long lat (4269).
ja: NAD83経度緯度 (4269)のLINESTRING(-71.160281 42.258729,-71.160837 42.259113,-71.161144 42.25932)のバイナリ表現です。

note: Tag: para
en: NOTE: Even though byte arrays are delimited with \ and may have ', we need to escape both out with \ and '' if standard_conforming_strings is off. So it does not look exactly like its AsEWKB representation.
ja: ご注意: byte配列は、\で区切られ、'を持ちますが、standard_conforming_stringsが切られている場合には、\と''でエスケープします。正確にはAsEWKB表現とはあいません。

note: Tag: para
en: In PostgreSQL 9.1+ - standard_conforming_strings is set to on by default, where as in past versions it was set to off. You can change defaults as needed for a single query or at the database or server level. Below is how you would do it with standard_conforming_strings = on. In this case we escape the ' with standard ansi ', but slashes are not escaped
ja: PostgreSQL 9.1より前では、standard_conforming_stringsは切られていましたが、9.1以上では、デフォルトで入っていることになりました。必要に応じて、クエリ1回で、データベースまたはサーバレベルでのデフォルトを変更できます。standard_conforming_strings = on使った場合を次に示します。この場合、'を標準ANSIの'でエスケープしますが、バックスラッシュはエスケープしていません。

note: Tag: refpurpose
en: Creates a geometry instance from a Well-Known Binary geometry representation (WKB) and optional SRID.
ja: Well-Knwon Binaryジオメトリ表現 (WKB)と任意パラメタのSRIDからジオメトリインスタンスを生成します。

note: Tag: para
en: The <varname>ST_GeomFromWKB</varname> function, takes a well-known binary representation of a geometry and a Spatial Reference System ID (<varname>SRID</varname>) and creates an instance of the appropriate geometry type. This function plays the role of the Geometry Factory in SQL. This is an alternate name for ST_WKBToSQL.
ja: <varname>ST_GeomFromWKB</varname>は、ジオメトリのWell-Known Binary表現と空間参照系識別番号 (<varname>SRID</varname>)を取り、適切なジオメトリタイプのインスタンスを生成します。この関数は、SQLのジオメトリファクトリの役割を果たします。これは、ST_WKBToSQLの代替名です。

note: Tag: para
en: If SRID is not specified, it defaults to 0 (Unknown).
ja: SRIDが指定されていない場合、0 (不明)となります。

note: Tag: para
en: &sfs_compliant; s3.2.7.2 - the optional SRID is from the conformance suite
ja: &sfs_compliant; s3.2.7.2 - 任意引数SRIDは仕様適合のためです。

note: Tag: refpurpose
en: Makes a <varname>LINESTRING</varname> from WKB with the given SRID
ja: WKB表現と与えられたSRIDから<varname>LINESTRING</varname>を生成します。

note: Tag: para
en: The <varname>ST_LineFromWKB</varname> function, takes a well-known binary representation of geometry and a Spatial Reference System ID (<varname>SRID</varname>) and creates an instance of the appropriate geometry type - in this case, a <varname>LINESTRING</varname> geometry. This function plays the role of the Geometry Factory in SQL.
ja: <varname>ST_LineFromWKB</varname>は、ジオメトリのWell-Known Binary表現と空間参照系識別番号 (<varname>SRID</varname>)を取り、適切なジオメトリタイプを返します。この場合は<varname>LINESTRING</varname>ジオメトリです。この関数はSQLのジオメトリファクトリの役割を果たします。

note: Tag: para
en: If an SRID is not specified, it defaults to 0. <varname>NULL</varname> is returned if the input <varname>bytea</varname> does not represent a <varname>LINESTRING</varname>.
ja: SRIDが指定されていない場合は0 (不明)となります。入力<varname>bytea</varname>が<varname>LINESTRING</varname>を表現していない場合は<varname>NULL</varname>を返します。

note: Tag: para
en: If you know all your geometries are <varname>LINESTRING</varname>s, its more efficient to just use <xref linkend="ST_GeomFromWKB"/>. This function just calls <xref linkend="ST_GeomFromWKB"/> and adds additional validation that it returns a linestring.
ja: 全てのジオメトリが<varname>LINESTRING</varname>であると知っている場合は、<xref linkend="ST_GeomFromWKB"/>を使う方が効率的です。 この関数は<xref linkend="ST_GeomFromWKB"/>の呼び出しと、LINESTRINGを返すかどうかの評価とを行います。

note: Tag: refpurpose
en: Makes a geometry from WKB with the given SRID.
ja: WKB表現と与えられたSRIDからジオメトリを生成します。

note: Tag: para
en: The <varname>ST_LinestringFromWKB</varname> function, takes a well-known binary representation of geometry and a Spatial Reference System ID (<varname>SRID</varname>) and creates an instance of the appropriate geometry type - in this case, a <varname>LINESTRING</varname> geometry. This function plays the role of the Geometry Factory in SQL.
ja: <varname>ST_LinestringFromWKB</varname>は、ジオメトリのWell-Known Binary表現と空間参照系識別番号 (<varname>SRID</varname>を取り、適切なジオメトリタイプのインスタンスを生成します。この場合、<varname>LINESTRING</varname>ジオメトリです。この関数はSQLのジオメトリファクトリの役割を果たします。

note: Tag: para
en: If an SRID is not specified, it defaults to 0. <varname>NULL</varname> is returned if the input <varname>bytea</varname> does not represent a <varname>LINESTRING</varname> geometry. This an alias for <xref linkend="ST_LineFromWKB"/>.
ja: SRIDが指定されていない場合は0 (不明)となります。入力<varname>bytea</varname>が<varname>LINESTRING</varname>を表現していない場合は<varname>NULL</varname>を返します。これは<xref linkend="ST_LineFromWKB"/>の別名です。

note: Tag: para
en: OGC SPEC 3.2.6.2 - optional SRID is from the conformance suite.
ja: OGC SPEC 3.2.6.2 - 任意引数SRIDは仕様適合のためです。

note: Tag: para
en: If you know all your geometries are <varname>LINESTRING</varname>s, it's more efficient to just use <xref linkend="ST_GeomFromWKB"/>. This function just calls <xref linkend="ST_GeomFromWKB"/> and adds additional validation that it returns a <varname>LINESTRING</varname>.
ja: 全てのジオメトリが<varname>LINESTRING</varname>であると知っている場合は、<xref linkend="ST_GeomFromWKB"/>を使う方が効率的です。この関数は<xref linkend="ST_GeomFromWKB"/>の呼び出しと、<varname>LINESTRING</varname>を返すかどうかの評価とを行います。

note: Tag: refpurpose
en: Makes a geometry from WKB with the given SRID
ja: WKBと与えられたSRIDからジオメトリを生成します。

note: Tag: para
en: The <varname>ST_PointFromWKB</varname> function, takes a well-known binary representation of geometry and a Spatial Reference System ID (<varname>SRID</varname>) and creates an instance of the appropriate geometry type - in this case, a <varname>POINT</varname> geometry. This function plays the role of the Geometry Factory in SQL.
ja: <varname>ST_PointFromWKB</varname>は、ジオメトリのWell-Known Binary表現と空間参照系識別番号 (<varname>SRID</varname>)を取り、適切なジオメトリタイプのインスタンスを生成します。この場合、<varname>POINT</varname>ジオメトリです。この関数はSQLのジオメトリファクトリの役割を果たします。

note: Tag: para
en: If an SRID is not specified, it defaults to 0. <varname>NULL</varname> is returned if the input <varname>bytea</varname> does not represent a <varname>POINT</varname> geometry.
ja: SRIDが指定されていない場合は0 (不明)となります。入力<varname>bytea</varname>が<varname>POINT</varname>ジオメトリを表現しないなら<varname>NULL</varname>が返されます。

note: Tag: refpurpose
en: Return a specified ST_Geometry value from Well-Known Binary representation (WKB). This is an alias name for ST_GeomFromWKB that takes no srid
ja: Well-Known Binary表現 (WKB)からST_Geometry値を生成します。これはSRIDを取らないST_GeomFromWKBの別名です。

note: Tag: title
en: Other Formats
ja: その他の書式

note: Tag: refpurpose
en: <refpurpose>Return a BOX2D from a GeoHash string.</refpurpose>
ja: <refpurpose>GeoHash文字列からBOX2Dを返します。</refpurpose>

note: Tag: para
en: <para>Return a BOX2D from a GeoHash string.</para>
ja: <para>GeoHash文字列からBOX2Dを返します。</para>

note: Tag: para
en: If no <varname>precision</varname> is specified ST_Box2dFromGeoHash returns a BOX2D based on full precision of the input GeoHash string.
ja: <varname>precision</varname>が指定されない場合には、ST_Box2dFromGeoHashは、入力ジオハッシュ文字列の完全な精度に基づいたBOX2Dを返します。

note: Tag: para
en: If <varname>precision</varname> is specified ST_Box2dFromGeoHash will use that many characters from the GeoHash to create the BOX2D. Lower precision values results in larger BOX2Ds and larger values increase the precision.
ja: <varname>precision</varname>が指定されている場合には、ST_Box2dFromGeoHashは、BOX2Dを生成するために、GeoHashからの多数の文字を使用します。低い精度の値では大きなBOX2Dを返し、値が大きいほど精度が増します。

note: Tag: refpurpose
en: Return a geometry from a GeoHash string.
ja: GeoHash文字列からジオメトリを返します。

note: Tag: para
en: Return a geometry from a GeoHash string. The geometry will be a polygon representing the GeoHash bounds.
ja: GeoHash文字列からジオメトリを返します。ジオメトリはGeoHashバウンディングボックスのポリゴン表現となります。

note: Tag: para
en: If no <varname>precision</varname> is specified ST_GeomFromGeoHash returns a polygon based on full precision of the input GeoHash string.
ja: <varname>precision</varname>を指定しない場合には、ST_GeomFromGeoHashは、入力GeoHash文字列の最大精度に基づくポリゴンを返します。

note: Tag: para
en: If <varname>precision</varname> is specified ST_GeomFromGeoHash will use that many characters from the GeoHash to create the polygon.
ja: <varname>precision</varname>が指定されると、ST_GeomFromGeoHashは、ポリゴンを生成するためGeoHashからの多数の文字を使います。

note: Tag: refpurpose
en: Takes as input GML representation of geometry and outputs a PostGIS geometry object
ja: GML表現からPostGISジオメトリオブジェクトを出力します。

note: Tag: para
en: Constructs a PostGIS ST_Geometry object from the OGC GML representation.
ja: OGC GML表現からPostGIS ST_Geometryオブジェクトを生成します。

note: Tag: para
en: ST_GeomFromGML works only for GML Geometry fragments. It throws an error if you try to use it on a whole GML document.
ja: ST_GeomFromGMLは、GMLのうちジオメトリ部分でのみ動作します。GML文書全体に使用しようとするとエラーが投げられます。

note: Tag: para
en: OGC GML versions supported: <itemizedlist> <listitem> <para>GML 3.2.1 Namespace</para> </listitem> <listitem> <para>GML 3.1.1 Simple Features profile SF-2 (with GML 3.1.0 and 3.0.0 backward compatibility)</para> </listitem> <listitem> <para>GML 2.1.2</para> </listitem> </itemizedlist> OGC GML standards, cf: <link xlink:href="http://www.opengeospatial.org/standards/gml">http://www.opengeospatial.org/standards/gml</link>:
ja: サポートされているOGC GMLの版は次のとおりです。<itemizedlist> <listitem> <para>GML 3.2.1 Namespace</para> </listitem> <listitem> <para>GML 3.1.1 Simple Features profile SF-2 (GML 3.1.0と3.0.0の後方互換)</para> </listitem> <listitem> <para>GML 2.1.2</para> </listitem> </itemizedlist> OGC GML標準については、<link xlink:href="http://www.opengeospatial.org/standards/gml">http://www.opengeospatial.org/standards/gml</link>をご覧下さい。

note: Tag: para
en: Availability: 1.5, requires libxml2 1.6+
ja: Availability: 1.5 libxml2 1.6+が必要です。

note: Tag: para
en: Enhanced: 2.0.0 default srid optional parameter added.
ja: Enhanced: 2.0.0 SRID任意引数が追加されました。

note: Tag: para
en: GML allow mixed dimensions (2D and 3D inside the same MultiGeometry for instance). As PostGIS geometries don't, ST_GeomFromGML convert the whole geometry to 2D if a missing Z dimension is found once.
ja: GMLは、複合次元 (たとえば、2次元と3次元が同じMultiGeometry内にある)を許します。PostGISジオメトリは許さないので、ST_GeomFromGMLは、Z次元が無いジオメトリを一つでも発見すると、ジオメトリ全体を2次元に変換します。

note: Tag: para
en: GML support mixed SRS inside the same MultiGeometry. As PostGIS geometries don't, ST_GeomFromGML, in this case, reproject all subgeometries to the SRS root node. If no srsName attribute available for the GML root node, the function throw an error.
ja: GMLは同じMultiGeometry内での複合SRSをサポートします。PostGISではサポートしないので、ST_GeomFromGMLは、この場合には、全てのサブジオメトリをルートノードのSRSに投影変換します。GMLのルートノードにsrsName属性が無い場合、関数はエラーを投げます。

note: Tag: para
en: ST_GeomFromGML function is not pedantic about an explicit GML namespace. You could avoid to mention it explicitly for common usages. But you need it if you want to use XLink feature inside GML.
ja: ST_GeomFromGML関数は、明示的なGML名前空間について杓子定規ではありません。共通使用で名前空間の明示を避けることができます。ただし、GML内でXLink機能を使いたい場合は必要です。

note: Tag: para
en: ST_GeomFromGML function not support SQL/MM curves geometries.
ja: ST_GeomFromGMLはSQL/MM曲線ジオメトリに対応していません。

note: Tag: title
en: Examples - A single geometry with srsName
ja: 例 - srsName属性を持つ単一のジオメトリ

note: Tag: title
en: Examples - XLink usage
ja: 例 - XLink使用法

note: Tag: title
en: Examples - Polyhedral Surface
ja: 例 - 多面体サーフェス

note: Tag: refpurpose
en: Takes as input a geojson representation of a geometry and outputs a PostGIS geometry object
ja: ジオメトリのGeoJSON表現を入力として、PostGISジオメトリオブジェクトを出力します。

note: Tag: para
en: Constructs a PostGIS geometry object from the GeoJSON representation.
ja: GeoJSON表現からPostGISジオメトリオブジェクトを生成します。

note: Tag: para
en: ST_GeomFromGeoJSON works only for JSON Geometry fragments. It throws an error if you try to use it on a whole JSON document.
ja: ST_GeomFromGeoJSONは、JSONのうちジオメトリ部分でのみ動作します。JSON文書全体を使おうとするとエラーが投げられます。

note: Tag: para
en: Enhanced: 3.0.0 parsed geometry defaults to SRID=4326 if not specified otherwise.
ja: Enhanced: 3.0.0 パースされたジオメトリのデフォルトのSRIDは、他に指定していない場合には4326となります。

note: Tag: para
en: Enhanced: 2.5.0 can now accept json and jsonb as inputs.
ja: Enhanced: 2.5.0 JSONとJSONBの入力を受け付けるようになりました。

note: Tag: para
en: Availability: 2.0.0 requires - JSON-C &gt;= 0.9
ja: Availability: 2.0.0 JSON-C 0.9以上が必要です。

note: Tag: para
en: If you do not have JSON-C enabled, support you will get an error notice instead of seeing an output. To enable JSON-C, run configure --with-jsondir=/path/to/json-c. See <xref linkend="installation_configuration"/> for details.
ja: 有効なJSON-Cが無い場合には、出力の替りに、エラー通知を得ます。JSON-Cを有効にするには--with-jsondir=/path/to/json-cをコンフィギュアで指定します。詳細については<xref linkend="installation_configuration"/>をご覧下さい。

note: Tag: refpurpose
en: Takes as input KML representation of geometry and outputs a PostGIS geometry object
ja: ジオメトリのKML表現の入力をとり、PostGISジオメトリオブジェクトを出力します。

note: Tag: para
en: Constructs a PostGIS ST_Geometry object from the OGC KML representation.
ja: OGC KML表現からPostGIS ST_Geometryオブジェクトを生成します。

note: Tag: para
en: ST_GeomFromKML works only for KML Geometry fragments. It throws an error if you try to use it on a whole KML document.
ja: ST_GeomFromKMLは、KMLのうちジオメトリ部分でのみ動作します。KML文書全体に使用しようとするとエラーが投げられます。

note: Tag: para
en: OGC KML versions supported: <itemizedlist> <listitem> <para>KML 2.2.0 Namespace</para> </listitem> </itemizedlist> OGC KML standards, cf: <link xlink:href="http://www.opengeospatial.org/standards/kml">http://www.opengeospatial.org/standards/kml</link>:
ja: 対応するOGC KMLの版は次の通りです。<itemizedlist> <listitem> <para>KML 2.2.0 Namespace</para> </listitem> </itemizedlist>OGC KML標準については<link xlink:href="http://www.opengeospatial.org/standards/kml">http://www.opengeospatial.org/standards/kml</link>をご覧ください。

note: Tag: para
en: Availability: 1.5, requires libxml2 2.6+
ja: Availability: 1.5 libxml2 2.6以上が必要です。

note: Tag: para
en: ST_GeomFromKML function not support SQL/MM curves geometries.
ja: ST_GeomFromKML関数はSQL/MM曲線ジオメトリに対応していません。

note: Tag: refpurpose
en: Creates a geometry instance from a TWKB ("<link xlink:href="https://github.com/TWKB/Specification/blob/master/twkb.md">Tiny Well-Known Binary</link>") geometry representation.
ja: TWKB ("<link xlink:href="https://github.com/TWKB/Specification/blob/master/twkb.md">Tiny Well-Known Binary</link>")ジオメトリ表現からジオメトリインスタンスを生成します。

note: Tag: para
en: The <varname>ST_GeomFromTWKB</varname> function, takes a a TWKB ("<link xlink:href="https://github.com/TWKB/Specification/blob/master/twkb.md">Tiny Well-Known Binary</link>") geometry representation (WKB) and creates an instance of the appropriate geometry type.
ja: <varname>ST_GeomFromTWKB</varname>は、TWKB ("<link xlink:href="https://github.com/TWKB/Specification/blob/master/twkb.md">Tiny Well-Known Binary</link>")ジオメトリ表現を取り、適切なジオメトリタイプとなるインスタンスを生成します。

note: Tag: refpurpose
en: Return a specified ST_Geometry value from GML representation. This is an alias name for ST_GeomFromGML
ja: GML表現から指定したST_Geometry値を返します。これはST_GeomFromGMLの別名です。

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.50 (except for curves support).
ja: &sqlmm_compliant; SQL-MM 3: 5.1.50 (曲線対応を除く)

note: Tag: refpurpose
en: Creates a LineString from an Encoded Polyline.
ja: エンコード化ポリラインからラインストリングを生成します。

note: Tag: para
en: Creates a LineString from an Encoded Polyline string.
ja: エンコード化ポリラインからラインストリングを生成します。

note: Tag: para
en: Optional <varname>precision</varname> specifies how many decimal places will be preserved in Encoded Polyline. Value should be the same on encoding and decoding, or coordinates will be incorrect.
ja: 任意パラメータ<varname>precision</varname>は、ポリライン符号化の際の桁数を決定するものです。符号化と復号とで同じ値であるべきで、異なる場合には座標が正しくなりません。

note: Tag: para
en: See http://developers.google.com/maps/documentation/utilities/polylinealgorithm
ja: http://developers.google.com/maps/documentation/utilities/polylinealgorithmを参照して下さい。

note: Tag: refpurpose
en: Return a point from a GeoHash string.
ja: GeoHash文字列からポイントを返します。

note: Tag: para
en: Return a point from a GeoHash string. The point represents the center point of the GeoHash.
ja: GeoHash文字列からポイントを返します。ポイントはGeoHashの中心点を表します。

note: Tag: para
en: If no <varname>precision</varname> is specified ST_PointFromGeoHash returns a point based on full precision of the input GeoHash string.
ja: <varname>precision</varname>を指定しない場合には、ST_PointFromGeoHashは、入力GeoHash文字列の最大精度に基づくポイントを返します。

note: Tag: para
en: If <varname>precision</varname> is specified ST_PointFromGeoHash will use that many characters from the GeoHash to create the point.
ja: <varname>precision</varname>を指定した場合には、ST_PointFromGeoHashは、ポイント生成のために、GeoHasoから多数の文字を使用します。

note: Tag: refpurpose
en: Creates a table based on the structure of FlatGeobuf data.
ja: FlatGeobufデータの構造に基づいてテーブルを生成します。

note: Tag: para
en: Creates a table based on the structure of FlatGeobuf data. (<link xlink:href="http://flatgeobuf.org">http://flatgeobuf.org</link>).
ja: FlatGeobufデータの構造に基づいてテーブルを生成します (<link xlink:href="http://flatgeobuf.org">http://flatgeobuf.org</link>)。

note: Tag: para
en: <varname>schema</varname> Schema name.
ja: <varname>schema</varname> スキーマ名。

note: Tag: para
en: <varname>table</varname> Table name.
ja: <varname>table</varname> テーブル名。

note: Tag: para
en: <varname>data</varname> Input FlatGeobuf data.
ja: <varname>data</varname>入力FlatGeobufデータ。

note: Tag: refpurpose
en: Reads FlatGeobuf data.
ja: FlatGeobufデータを読みます。

note: Tag: para
en: Reads FlatGeobuf data (<link xlink:href="http://flatgeobuf.org">http://flatgeobuf.org</link>). NOTE: PostgreSQL bytea cannot exceed 1GB.
ja: FlatGeobufデータを読みます (<link xlink:href="http://flatgeobuf.org">http://flatgeobuf.org</link>)。 ご注意: PostgreSQLのbytea型は1GBを超えられません。

note: Tag: para
en: <varname>tabletype</varname> reference to a table type.
ja: <varname>tabletype</varname> テーブルタイプへの参照。

note: Tag: para
en: <varname>data</varname> input FlatGeobuf data.
ja: <varname>data</varname> 入力FlatGeobufデータ。

note: Tag: title
en: Linear Referencing
ja: 線型参照

note: Tag: refpurpose
en: Returns a point interpolated along a line at a fractional location.
ja: ラインに沿って、割合で示された位置の補間ポイントを返します。

note: Tag: para
en: Returns a point interpolated along a line at a fractional location. First argument must be a LINESTRING. Second argument is a float between 0 and 1 representing the fraction of line length where the point is to be located. The Z and M values are interpolated if present.
ja: ラインに沿って、割合で示された位置の補間ポイントを返します。一つ目の引数はLINESTRINGです。二つ目の引数は0から1の間の浮動小数点数で、ライン長に対するポイントの位置の割合を表現します。Z値とM値が存在する場合には補間計算を行います。

note: Tag: para
en: See <xref linkend="ST_LineLocatePoint"/> for computing the line location nearest to a Point.
ja: ポイントに最も近いライン位置の計算については<xref linkend="ST_LineLocatePoint"/>を参照して下さい。

note: Tag: para
en: This function computes points in 2D and then interpolates values for Z and M, while <xref linkend="ST_3DLineInterpolatePoint"/> computes points in 3D and only interpolates the M value.
ja: この関数は2次元のポイントとして計算して、Z値とM値は補間値を計算します。<xref linkend="ST_3DLineInterpolatePoint"/>は3次元のポイントとして計算して、M値のみ補間値を計算します。

note: Tag: para
en: Since release 1.1.1 this function also interpolates M and Z values (when present), while prior releases set them to 0.0.
ja: 1.1.1から、この関数はM軸やZ軸の内挿点も (存在するなら)計算するようになりました。それより前の版では0.0となります。

note: Tag: para
en: Availability: 0.8.2, Z and M supported added in 1.1.1
ja: Availability: 0.8.2 Z軸とM軸のサポートが1.1.1で追加されました

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Line_Interpolate_Point.
ja: Changed: 2.1.0 2.0.xまでではST_Line_Interpolate_Pointと呼んでいました。

note: Tag: para
en: A LineString with the interpolated point at 20% position (0.20)
ja: ラインストリングの20% (0.20)位置の補完ポイント

note: Tag: para
en: The mid-point of a 3D line:
ja: 3次元ラインの中間点:

note: Tag: para
en: The closest point on a line to a point:
ja: ライン上のポイントに最も近いポイント:

note: Tag: refpurpose
en: Returns a point interpolated along a 3D line at a fractional location.
ja: 3次元ラインに沿って、割合で示された位置の補間ポイントを返します。

note: Tag: para
en: Returns a point interpolated along a 3D line at a fractional location. First argument must be a LINESTRING. Second argument is a float between 0 and 1 representing the point location as a fraction of line length. The M value is interpolated if present.
ja: 3次元ラインに沿って、割合で示された位置の補間ポイントを返します。一つ目の引数はLINESTRINGです。二つ目の引数は0から1の間の浮動小数点数で、ライン長に対するポイントの位置の割合を表現します。M値が存在する場合には補間計算を行います。

note: Tag: para
en: computes points in 2D and then interpolates the values for Z and M, while this function computes points in 3D and only interpolates the M value.
ja: 2次元ポイントの計算とZ値とM値の補間値を計算しますが、この関数は3次元ポイントを計算し、M値だけ補間計算を行います。

note: Tag: para
en: Return point 20% along 3D line
ja: 3次元ラインに沿って20%のポイントを返します

note: Tag: refpurpose
en: Returns points interpolated along a line at a fractional interval.
ja: ラインに沿って、割合で示された複数の位置の補間ポイントを返します。

note: Tag: para
en: Returns one or more points interpolated along a line at a fractional interval. The first argument must be a LINESTRING. The second argument is a float8 between 0 and 1 representing the spacing between the points as a fraction of line length. If the third argument is false, at most one point will be constructed (which is equivalent to <xref linkend="ST_LineInterpolatePoint"/>.)
ja: ラインに沿った割合による間隔にある一つ以上の補間ポイントを返します。一つ目の引数はLINESTRINGでなければなりません。二つ目の引数はfloat8型の0から1の間の値でなければなりません。この値はライン長に対するポイント間隔の割合を示します。三つ目の引数がFALSEの場合には、一つ以下のポイントが構築されます (<xref linkend="ST_LineInterpolatePoint"/>と同じです)。

note: Tag: para
en: If the result has zero or one points, it is returned as a POINT. If it has two or more points, it is returned as a MULTIPOINT.
ja: 結果が0以上のポイントを持つ場合にはPOINTが返ります。二つ以上のポイントを持つ場合にはMULTIPOINTが返ります。

note: Tag: para
en: A LineString with points interpolated every 20%
ja: 20%刻みで補間されたポイントを持つラインストリング

note: Tag: refpurpose
en: Returns the fractional location of the closest point on a line to a point.
ja: ポイントに最も近いライン上のポイントの位置を割合で返します。

note: Tag: para
en: Returns a float between 0 and 1 representing the location of the closest point on a LineString to the given Point, as a fraction of <link linkend="ST_Length2D">2d line</link> length.
ja: ラインストリング上の、与えたポイントへの最短点を、<link linkend="ST_Length2D">2次元ラインストリング</link>の総延長に対する割合として0から1の区間で返します。

note: Tag: para
en: You can use the returned location to extract a Point (<xref linkend="ST_LineInterpolatePoint"/>) or a substring (<xref linkend="ST_LineSubstring"/>).
ja: 返された位置は、ポイント(<xref linkend="ST_LineInterpolatePoint"/>)または、部分ラインストリング(<xref linkend="ST_LineSubstring"/>)の抽出に使用することができます。

note: Tag: para
en: This is useful for approximating numbers of addresses
ja: この関数は、住所番号に近づくのに使えます (訳注: 道路方式の住居表示の場合)。

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Line_Locate_Point.
ja: Changed: 2.1.0 2.0.xまでではST_Line_Locate_Pointと呼んでいました。

note: Tag: refpurpose
en: Returns the part of a line between two fractional locations.
ja: 二つの割合位置からラインの一部を返します。

note: Tag: para
en: Computes the line which is the section of the input line starting and ending at the given fractional locations. The first argument must be a LINESTRING. The second and third arguments are values in the range [0, 1] representing the start and end locations as fractions of line length. The Z and M values are interpolated for added endpoints if present.
ja: 与えられた割合位置を開始点と終了点とした、入力ラインの一部を計算します。一つ目の引数はLINESTRINGでなければなりません。二つ目と三つ目の引数は[0, 1]の範囲内で、開始点と終了点の、ライン長に対する割合の位置です。Z値とM値が存在する場合には、追加された終了点に対して補間計算を行います。

note: Tag: para
en: If <varname>startfraction</varname> and <varname>endfraction</varname> have the same value this is equivalent to <xref linkend="ST_LineInterpolatePoint"/>.
ja: <varname>startfraction</varname>と<varname>endfraction</varname>が同じ値である場合には、<xref linkend="ST_LineInterpolatePoint"/>と同じになります。

note: Tag: para
en: This only works with LINESTRINGs. To use on contiguous MULTILINESTRINGs first join them with <xref linkend="ST_LineMerge"/>.
ja: この関数はLINESTRINGに対してのみ動作します。連続するMULTILINESTRINGで使うには、先に<xref linkend="ST_LineMerge"/>で結合させます。

note: Tag: para
en: Since release 1.1.1 this function interpolates M and Z values. Prior releases set Z and M to unspecified values.
ja: 1.1.1リリースからは、この関数はM値とZ値を補間します。それより前のリリースでは、Z値とM値は不定値になります。

note: Tag: para
en: Enhanced: 3.4.0 - Support for geography was introduced.
ja: Enhanced: 3.4.0 ジオグラフィ対応が導入されました。

note: Tag: para
en: Changed: 2.1.0. Up to 2.0.x this was called ST_Line_Substring.
ja: Changed: 2.1.0 2.0.xではST_Line_Substringと呼ばれていました。

note: Tag: para
en: Availability: 1.1.0, Z and M supported added in 1.1.1
ja: Availability: 1.1.0 Z軸とM軸のサポートが1.1.1で追加されました

note: Tag: para
en: A LineString seen with 1/3 midrange overlaid (0.333, 0.666)
ja: 中心の1/3区間 (0.333, 0.666)

note: Tag: para
en: If start and end locations are the same, the result is a POINT.
ja: 開始点と終了点とが同じ場合には、結果はPOINTになります。

note: Tag: para
en: A query to cut a LineString into sections of length 100 or shorter. It uses <varname>generate_series()</varname> with a CROSS JOIN LATERAL to produce the equivalent of a FOR loop.
ja: LINESTRINGを長さ100以下の断片に分解するクエリ。FORループと同等のものを生成するために<varname>generate_series()</varname>とCROSS JOIN LATERALとを併用しています。

note: Tag: para
en: Geography implementation measures along a spheroid, geometry along a line
ja: ジオグラフィ実装では回転楕円体面に沿って計測し、ジオメトリではラインに沿って計測します。

note: Tag: refpurpose
en: Returns the point(s) on a geometry that match a measure value.
ja: M値に一致するジオメトリ上のポイントを返します。

note: Tag: para
en: Returns the location(s) along a measured geometry that have the given measure values. The result is a Point or MultiPoint. Polygonal inputs are not supported.
ja: M値を持つジオメトリに沿った位置を返します。結果はポイントまたはマルチポイントです。ポリゴン系入力には対応していません。

note: Tag: para
en: If <varname>offset</varname> is provided, the result is offset to the left or right of the input line by the specified distance. A positive offset will be to the left, and a negative one to the right.
ja: <varname>offset</varname>が与えられた場合には、結果は、入力ラインの左または右に、指定された距離だけ移動します。正のオフセット値で左に、負の値で右にそれぞれ移動します。

note: Tag: para
en: Use this function only for linear geometries with an M component
ja: この関数は、M要素を持つライン系ジオメトリでのみ使います。

note: Tag: para
en: The semantic is specified by the <emphasis>ISO/IEC 13249-3 SQL/MM Spatial</emphasis> standard.
ja: <emphasis>ISO/IEC 13249-3 SQL/MM 空間標準</emphasis>で規定されているため、このような意味になります。

note: Tag: para
en: Availability: 1.1.0 by old name ST_Locate_Along_Measure.
ja: Availability: 1.1.0 それまではST_Locale_Along_Measureでした。

note: Tag: para
en: Changed: 2.0.0 in prior versions this used to be called ST_Locate_Along_Measure.
ja: Changed: 2.0.0 以前の版ではST_Locate_Along_Measureと呼ばれていました。

note: Tag: refpurpose
en: Returns the portions of a geometry that match a measure range.
ja: M値の範囲に合致する部分ジオメトリを返します。

note: Tag: para
en: Return a geometry (collection) with the portions of the input measured geometry that match the specified measure range (inclusively).
ja: 指定された範囲のM値を持つ入力ジオメトリの部分ジオメトリとなるジオメトリ (コレクション)を全て返します。

note: Tag: para
en: If the <varname>offset</varname> is provided, the result is offset to the left or right of the input line by the specified distance. A positive offset will be to the left, and a negative one to the right.
ja: <varname>offset</varname>が与えられた場合には、結果は、入力ラインの左または右に、指定された距離だけ移動します。正のオフセット値で左に、負の値で右にそれぞれ移動します。

note: Tag: para
en: Clipping a non-convex POLYGON may produce invalid geometry.
ja: 凸でないPOLYGONを抜き出すと不正なジオメトリを返すことがあります。

note: Tag: para
en: Availability: 1.1.0 by old name ST_Locate_Between_Measures.
ja: Availability: 1.1.0 それより前はST_Locate_Between_Measuresでした。

note: Tag: para
en: Changed: 2.0.0 - in prior versions this used to be called ST_Locate_Between_Measures.
ja: Changed: 2.0.0 以前の版ではST_Locate_Between_Measuresと呼ばれていました。

note: Tag: para
en: Enhanced: 3.0.0 - added support for POLYGON, TIN, TRIANGLE.
ja: Enhanced: 3.0.0 - POLYGON, TIN, TRIANGLEへの対応が追加されました。

note: Tag: para
en: A LineString with the section between measures 2 and 8, offset to the left
ja: M値が2と8の間になる辺を持ち左にずれたラインストリング

note: Tag: refpurpose
en: Returns the portions of a geometry that lie in an elevation (Z) range.
ja: 標高 (Z値)範囲にある部分ジオメトリを返します。

note: Tag: para
en: Returns a geometry (collection) with the portions of a geometry that lie in an elevation (Z) range.
ja: 標高 (Z値)範囲にある部分ジオメトリとなるジオメトリ (コレクション)を返します。

note: Tag: refpurpose
en: Returns the interpolated measure of a geometry closest to a point.
ja: ジオメトリのポイントに最も近いポイント上の補間M値を返します。

note: Tag: para
en: Returns an interpolated measure value of a linear measured geometry at the location closest to the given point.
ja: ライン系のM値を持つジオメトリについて、与えられたポイントに最も近い位置におけるM値の補間値を返します。

note: Tag: refpurpose
en: Interpolates measures along a linear geometry.
ja: ラインに沿ったM値を補間します。

note: Tag: para
en: Return a derived geometry with measure values linearly interpolated between the start and end points. If the geometry has no measure dimension, one is added. If the geometry has a measure dimension, it is over-written with new values. Only LINESTRINGS and MULTILINESTRINGS are supported.
ja: 開始点と終了点の間で線形補間したM値を持つ派生ジオメトリを返します。ジオメトリがM値を持たない場合にはM値が追加されます。ジオメトリがM値を持つ場合には新値に置き換えられます。LINESTRINGとMULTILINESTRINGだけに対応しています。

note: Tag: title
en: Table Management Functions
ja: テーブル管理関数

note: Tag: para
en: These functions assist in defining tables containing geometry columns.
ja: これらの関数は、ジオメトリカラムを含むテーブルの定義を支援します。

note: Tag: refpurpose
en: Adds a geometry column to an existing table.
ja: ジオメトリカラムを既存のテーブルに追加します。

note: Tag: para
en: Adds a geometry column to an existing table of attributes. The <varname>schema_name</varname> is the name of the table schema. The <varname>srid</varname> must be an integer value reference to an entry in the SPATIAL_REF_SYS table. The <varname>type</varname> must be a string corresponding to the geometry type, eg, 'POLYGON' or 'MULTILINESTRING' . An error is thrown if the schemaname doesn't exist (or not visible in the current search_path) or the specified SRID, geometry type, or dimension is invalid.
ja: ジオメトリカラムを既存の属性テーブルに追加します。<varname>schema_name</varname>はスキーマ名です。<varname>srid</varname>はSPATIAL_REF_SYSテーブルのエントリを参照する整数でなければなりません。<varname>type</varname>は'POLYGON'や'MULTILINESTRING'といった、ジオメトリタイプを示す文字でなければなりません。指定したスキーマが存在しない (または現在のsearch_pathからは見えない)場合、または指定したSRID、ジオメトリタイプもしくは次元が不正である場合はエラーが投げられます。

note: Tag: para
en: Changed: 2.0.0 This function no longer updates geometry_columns since geometry_columns is a view that reads from system catalogs. It by default also does not create constraints, but instead uses the built in type modifier behavior of PostgreSQL. So for example building a wgs84 POINT column with this function is now equivalent to: <code>ALTER TABLE some_table ADD COLUMN geom geometry(Point,4326);</code>
ja: Changed: 2.0.0 geometry_columnsがシステムカタログを読むビューになったため、geometry_columnsを更新しないようになりました。デフォルトでは制約を生成せず、PostgreSQLの型修飾子を使います。この関数によるWGS 84のPOINTカラムの構築と<code>ALTER TABLE some_table ADD COLUMN geom geometry(Point,4326);</code>とは等価です。

note: Tag: para
en: Changed: 2.0.0 If you require the old behavior of constraints use the default <varname>use_typmod</varname>, but set it to false.
ja: Changed: 2.0.0 制約を使う必要がある場合には、<varname>use_typmod</varname>をFALSEにします。

note: Tag: para
en: Changed: 2.0.0 Views can no longer be manually registered in geometry_columns, however views built against geometry typmod tables geometries and used without wrapper functions will register themselves correctly because they inherit the typmod behavior of their parent table column. Views that use geometry functions that output other geometries will need to be cast to typmod geometries for these view geometry columns to be registered correctly in geometry_columns. Refer to <xref linkend="Manual_Register_Spatial_Column"/>.
ja: Changed: 2.0.0 ビューについては、geometry_columnsへの手動登録はできなくなりました。しかし、typmodテーブルジオメトリに対して構築されていて、かつラッパ関数が無いビューは、親テーブルカラムのtypmodの挙動を継承するので、正しく登録されます。他のジオメトリを出力するジオメトリ関数を使うビューについては、ビューのジオメトリカラムが正しく登録されるようにするため、typmodジオメトリへのキャストが必要です。<xref linkend="Manual_Register_Spatial_Column"/>を参照して下さい。

note: Tag: para
en: Enhanced: 2.0.0 use_typmod argument introduced. Defaults to creating typmod geometry column instead of constraint-based.
ja: Enhanced: 2.0.0 use_typmod引数が導入されました。デフォルトでは制約を基にしたものでなくtypmodジオメトリカラムが生成されます。

note: Tag: refpurpose
en: Removes a geometry column from a spatial table.
ja: ジオメトリカラムを空間テーブルから除去します。

note: Tag: para
en: Removes a geometry column from a spatial table. Note that schema_name will need to match the f_table_schema field of the table's row in the geometry_columns table.
ja: ジオメトリカラムを空間テーブルから除去します。schema_nameはgeometry_columnsテーブルの該当行のf_table_schemaフィールドと一致しなければならないことにご注意ください。

note: Tag: para
en: Changed: 2.0.0 This function is provided for backward compatibility. Now that since geometry_columns is now a view against the system catalogs, you can drop a geometry column like any other table column using <code>ALTER TABLE</code>
ja: Changed: 2.0.0 この関数は後方互換のためのものです。geometry_columnsは現在はシステムカタログに対するビューですので、他のテーブルのカラムと同じように<code>ALTER TABLE</code>を使った削除が可能です。

note: Tag: refpurpose
en: Drops a table and all its references in geometry_columns.
ja: テーブルとgeometry_columnsの当該テーブルへの参照の全てを削除します。

note: Tag: para
en: Drops a table and all its references in geometry_columns. Note: uses current_schema() on schema-aware pgsql installations if schema is not provided.
ja: テーブルとgeometry_columnsの当該テーブルへの参照の全てを削除します。スキーマ対応版PostgreSQLではスキーマが与えられない場合はcurrent_schema()を使います。

note: Tag: para
en: Changed: 2.0.0 This function is provided for backward compatibility. Now that since geometry_columns is now a view against the system catalogs, you can drop a table with geometry columns like any other table using <code>DROP TABLE</code>
ja: Changed: 2.0.0で この関数は後方互換のためのものです。geometry_columnsは現在はシステムカタログに対するビューですので、他のテーブルのカラムと同じように<code>DROP TABLE</code>を使った削除が可能です。

note: Tag: refpurpose
en: Returns the SRID defined for a geometry column.
ja: ジオメトリカラムで定義されているSRIDを返します。

note: Tag: para
en: Returns the integer SRID of the specified geometry column by searching through the GEOMETRY_COLUMNS table. If the geometry column has not been properly added (e.g. with the <xref linkend="AddGeometryColumn"/> function), this function will not work.
ja: 指定したジオメトリカラムSRID整数値をGEOMETRY_COLUMNSテーブルの探索によって返します。ジオメトリカラムが正しく追加されていない (例: <xref linkend="AddGeometryColumn"/>関数)場合には、この関数は動作しません。

note: Tag: refpurpose
en: Ensures geometry columns are defined with type modifiers or have appropriate spatial constraints.
ja: ジオメトリカラムが型修飾子で定義されるか、適切な空間制約を持つようにします。

note: Tag: para
en: Ensures geometry columns have appropriate type modifiers or spatial constraints to ensure they are registered correctly in the <varname>geometry_columns</varname> view. By default will convert all geometry columns with no type modifier to ones with type modifiers.
ja: ジオメトリカラムが適切な型修飾子を持つか、<varname>geometry_columns</varname>ビュー内で正しく登録されていることを確実にするために空間制約を持つようにします。デフォルトでは、型修飾子を持たないすべてのジオメトリカラムを型修飾子を持つカラムに変換します。

note: Tag: para
en: For backwards compatibility and for spatial needs such as table inheritance where each child table may have different geometry type, the old check constraint behavior is still supported. If you need the old behavior, you need to pass in the new optional argument as false <varname>use_typmod=false</varname>. When this is done geometry columns will be created with no type modifiers but will have 3 constraints defined. In particular, this means that every geometry column belonging to a table has at least three constraints:
ja: 後方互換のためと、それぞれの子テーブルが異なるジオメトリタイプを持つテーブル継承といった空間テーブルにとって必要があるためとの二つの理由から、古いCHECK制約の挙動がなお有効になっています。古い挙動が必要な場合には、新しいオプション引数で<varname>use_typmod=false</varname>を渡す必要があります。これが実行されると、型修飾子なしのジオメトリカラムが生成され、三つの制約が定義されます。特に、これは、テーブルに属するすべてのジオメトリカラムが少なくとも三つの制約を持つことを意味します:

note: Tag: para
en: <varname>enforce_dims_geom</varname> - ensures every geometry has the same dimension (see <xref linkend="ST_NDims"/>)
ja: <varname>enforce_dims_the_geom</varname> - あらゆるジオメトリが同じ次元を持つことを確実にします (<xref linkend="ST_NDims"/>をご覧下さい)

note: Tag: para
en: <varname>enforce_geotype_geom</varname> - ensures every geometry is of the same type (see <xref linkend="GeometryType"/>)
ja: <varname>enforce_geotype_the_geom</varname> - あらゆるジオメトリが同じ型を持つことを確実にします (<xref linkend="GeometryType"/>をご覧下さい)

note: Tag: para
en: <varname>enforce_srid_geom</varname> - ensures every geometry is in the same projection (see <xref linkend="ST_SRID"/>)
ja: <varname>enforce_srid_the_geom</varname> - あらゆるジオメトリが同じ投影法になることを確実にします (<xref linkend="ST_SRID"/>をご覧下さい)

note: Tag: para
en: If a table <varname>oid</varname> is provided, this function tries to determine the srid, dimension, and geometry type of all geometry columns in the table, adding constraints as necessary. If successful, an appropriate row is inserted into the geometry_columns table, otherwise, the exception is caught and an error notice is raised describing the problem.
ja: テーブルに<varname>oid</varname>がある場合には、この関数はテーブルのジオメトリカラム全てについて、SRIDと次元とジオメトリタイプを判定して、必要に応じて制約を追加しようとします。 成功した場合には、<varname>geometry_columns</varname>に適切な行が追加され、その他の場合には、例外が捕まえられ、問題を記述したエラーが通知されます。

note: Tag: para
en: If the <varname>oid</varname> of a view is provided, as with a table oid, this function tries to determine the srid, dimension, and type of all the geometries in the view, inserting appropriate entries into the <varname>geometry_columns</varname> table, but nothing is done to enforce constraints.
ja: ビューの<varname>oid</varname>がある場合、テーブルの場合と同じで、SIRDと次元とジオメトリタイプを判定して、適切なエントリを<varname>geometry_columns</varname>テーブルに挿入しますが、制約の追加はされません。

note: Tag: para
en: The parameterless variant is a simple wrapper for the parameterized variant that first truncates and repopulates the geometry_columns table for every spatial table and view in the database, adding spatial constraints to tables where appropriate. It returns a summary of the number of geometry columns detected in the database and the number that were inserted into the <varname>geometry_columns</varname> table. The parameterized version simply returns the number of rows inserted into the <varname>geometry_columns</varname> table.
ja: パラメタの無い形式は、<varname>geometry_columns</varname>の行を削除したうえで、全ての空間テーブルと空間ビューについて再挿入し、適切な空間制約をテーブルに追加する、パラメタ付きの形式の単純なラッパです。パラメタが無い形式は、検出したジオメトリカラムの数の要約と<varname>geometry_columns</varname>に挿入された行の数とを返します。パラメタ付きの形式は単純に<varname>geometry_columns</varname>に挿入された行の数を返します。

note: Tag: para
en: Changed: 2.0.0 By default, now uses type modifiers instead of check constraints to constrain geometry types. You can still use check constraint behavior instead by using the new <varname>use_typmod</varname> and setting it to false.
ja: Changed: 2.0.0 デフォルトでは、ジオメトリタイプの制限について、制約を確認する代わりに型修飾子を使います。新しい<varname>use_typmod</varname>をFALSEに設定して使うことで、制約確認を使用することができます。

note: Tag: para
en: Enhanced: 2.0.0 <varname>use_typmod</varname> optional argument was introduced that allows controlling if columns are created with typmodifiers or with check constraints.
ja: Enhanced: 2.0.0 <varname>use_typmod</varname>任意引数が導入されました。カラムが型修飾子で生成されるか制約チェックで作られるかの制御ができます。

note: Tag: refpurpose
en: Updates the SRID of all features in a geometry column, and the table metadata.
ja: ジオメトリカラム内の全ての地物のSRIDを更新し、テーブルのメタデータを更新します。

note: Tag: para
en: Updates the SRID of all features in a geometry column, updating constraints and reference in geometry_columns. If the column was enforced by a type definition, the type definition will be changed. Note: uses current_schema() on schema-aware pgsql installations if schema is not provided.
ja: ジオメトリカラム内の全ての地物のSRIDを更新し、制約を更新し、geometry_columnsの参照を更新します。カラムが型定義で強制されているなら、型定義は変更されます。ご注意: スキーマ対応版PostgreSQLでは、スキーマが提供されていない場合には、current_schema()を使用します。

note: Tag: para
en: Insert geometries into roads table with a SRID set already using <link linkend="ST_GeomFromEWKT">EWKT format</link>:
ja: ジオメトリを、<link linkend="ST_GeomFromEWKT">EWKT書式</link>を使って、SRIDを持つ道路テーブルに挿入します:

note: Tag: para
en: This will change the srid of the roads table to 4326 from whatever it was before:
ja: これにより道路テーブルが、以前がどんなSRIDであっても、4326に変更されます:

note: Tag: para
en: The prior example is equivalent to this DDL statement:
ja: 上述の例と、次のDDL手続き (訳注: DDLはData Definition Languageの略で、データ構造の操作を行う言語を指し、この場合は CREATE TABLEやALTER TABLE等が該当します)とは同じです:

note: Tag: para
en: If you got the projection wrong (or brought it in as unknown) in load and you wanted to transform to web mercator all in one shot you can do this with DDL but there is no equivalent PostGIS management function to do so in one go.
ja: ロードしたデータの変換座標系が誤りである (またはunknownになっている)けれどもWebメルカトルに一度の処理で変換したい場合、DDLで実行可能ですが、PostGIS管理関数では一度の処理ですむ等価なものはありません。

note: Tag: title
en: Measurement Functions
ja: 計測関数

note: Tag: para
en: These functions compute measurements of distance, area and angles. There are also functions to compute geometry values determined by measurements.
ja: この関数は、距離、面積、角度の測定値を計算します。測定値から決定されるジオメトリ値を計算する関数もあります。

note: Tag: refpurpose
en: Returns the area of a polygonal geometry.
ja: ポリゴンジオメトリの面積を返します。

note: Tag: para
en: Returns the area of a polygonal geometry. For geometry types a 2D Cartesian (planar) area is computed, with units specified by the SRID. For geography types by default area is determined on a spheroid with units in square meters. To compute the area using the faster but less accurate spherical model use <varname>ST_Area(geog,false)</varname>.
ja: ポリゴンジオメトリの面積を返します。ジオメトリ型では2次元のデカルト (平面)面積が、SRIDで指定した単位で計算されます。ジオグラフィ型では、デフォルトでは、面積は回転楕円体上にあるものとし、平方メートル単位で計算されます。より速いものの精度が落ちる計算のために、 <varname>ST_Area(geog,false)</varname>で球面モデルを使った計算ができます。

note: Tag: para
en: Enhanced: 2.0.0 - support for 2D polyhedral surfaces was introduced.
ja: Enhanced: 2.0.0 - 2次元多面体サーフェス対応が導入されました。

note: Tag: para
en: Enhanced: 2.2.0 - measurement on spheroid performed with GeographicLib for improved accuracy and robustness. Requires PROJ &gt;= 4.9.0 to take advantage of the new feature.
ja: Enhanced: 2.2.0 - 精度とロバスト性の向上のためにGeographicLibを使って回転楕円体面上での計測を行うようにしています。この新機能を使うには、Proj 4.9.0以上が必要です。

note: Tag: para
en: Changed: 3.0.0 - does not depend on SFCGAL anymore.
ja: Changed: 3.0.0 - SFCGALに依存しなくなりました。

note: Tag: para
en: For polyhedral surfaces, only supports 2D polyhedral surfaces (not 2.5D). For 2.5D, may give a non-zero answer, but only for the faces that sit completely in XY plane.
ja: 多面体サーフェスについて、2次元多面体サーフェスのみ対応します (2.5次元は対応しません)。2.5次元について、0でない答が与えられるかも知れませんが、完全にXY平面に付いているサーフェスのみです。

note: Tag: para
en: Return area in square feet for a plot of Massachusetts land and multiply by conversion to get square meters. Note this is in square feet because EPSG:2249 is Massachusetts State Plane Feet
ja: マサチューセッツのプロットから平方フィートの面積を返すものと、乗算で平方フィートから平方メートルに変換するものです。EPSG:2249はマサチューセッツ州フィート平面であるので、平方フィートで面積が出ることに注意して下さい。

note: Tag: para
en: Return area square feet and transform to Massachusetts state plane meters (EPSG:26986) to get square meters. Note this is in square feet because 2249 is Massachusetts State Plane Feet and transformed area is in square meters since EPSG:26986 is state plane Massachusetts meters
ja: 平方フィートの面積を返すものと、マサチューセッツ州メートル平面 (EPSG:26986)に変換して平方メートルを得るものです。EPSG:2249はマサチューセッツ州フィート平面であり、EPSG:26986はマサチューセッツ州メートル平面であることに注意して下さい。

note: Tag: para
en: Return area square feet and square meters using geography data type. Note that we transform to our geometry to geography (before you can do that make sure your geometry is in WGS 84 long lat 4326). Geography always measures in meters. This is just for demonstration to compare. Normally your table will be stored in geography data type already.
ja: ジオグラフィ型を使って平方フィートと平方メートルを返すものです。 ジオメトリをジオグラフィに変換することに注意して下さい (変換に先立ってジオメトリがWGS 84緯度経度のEPSG:4326であることを確認します)。ジオグラフィは常にメートルで計測されます。これは比較のためのデモンストレーションです。通常は、ジオグラフィ型が既に格納されているものです。

note: Tag: para
en: If your data is in geography already:
ja: ジオグラフィのデータが既にある場合:

note: Tag: refpurpose
en: Returns the north-based azimuth of a line between two points.
ja: 北を基準とした2点間の線の方位角を返します。

note: Tag: para
en: Returns the azimuth in radians of the target point from the origin point, or NULL if the two points are coincident. The azimuth angle is a positive clockwise angle referenced from the positive Y axis (geometry) or the North meridian (geography): North = 0; Northeast = &#x03C0;/4; East = &#x03C0;/2; Southeast = 3&#x03C0;/4; South = &#x03C0;; Southwest 5&#x03C0;/4; West = 3&#x03C0;/2; Northwest = 7&#x03C0;/4.
ja: 原点から目標点に向いたラジアン単位の方位を返しますが、2点が一致する場合にはNULLを返します。方位角は、Y軸 (ジオメトリ)または子午線北向き (ジオグラフィ)から時計回りに増えていきます。すなわち、北は0、北東は&#x03C0;/4、東は&#x03C0;/2、南東は3&#x03C0;/4、南は&#x03C0;、南西は5&#x03C0;/4、西は3&#x03C0;/2、北西は7&#x03C0;/4、となります。

note: Tag: para
en: For the geography type, the azimuth solution is known as the <link xlink:href="https://en.wikipedia.org/wiki/Geodesics_on_an_ellipsoid">inverse geodesic problem</link>.
ja: ジオグラフィでは、方位角計算問題は<link xlink:href="https://en.wikipedia.org/wiki/Geodesics_on_an_ellipsoid">inverse geodesic problem</link>として知られます。

note: Tag: para
en: The azimuth is a mathematical concept defined as the angle between a reference vector and a point, with angular units in radians. The result value in radians can be converted to degrees using the PostgreSQL function <varname>degrees()</varname>.
ja: 方位角は参照ベクトルと一つのポイントとの間の角度と定義される数学的概念で、角度の単位はラジアンです。ラジアン単位の結果はPostgreSQL関数<varname>degrees()</varname>で度に変換できます。

note: Tag: para
en: Azimuth can be used in conjunction with <xref linkend="ST_Translate"/> to shift an object along its perpendicular axis. See the <varname>upgis_lineshift()</varname> function in the <link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiplpgsqlfunctions">PostGIS wiki</link> for an implementation of this.
ja: 方位角は、垂直軸に沿ってシフトさせるには<xref linkend="ST_Translate"/>と併用します。実装については<link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiplpgsqlfunctions">PostGIS wiki</link>内の関数<varname>upgis_lineshift()</varname>をご覧下さい。

note: Tag: para
en: Enhanced: 2.0.0 support for geography was introduced.
ja: Enhanced: 2.0.0 ジオグラフィ対応が導入されました。

note: Tag: para
en: Enhanced: 2.2.0 measurement on spheroid performed with GeographicLib for improved accuracy and robustness. Requires PROJ &gt;= 4.9.0 to take advantage of the new feature.
ja: Enhanced: 2.2.0 - 精度とロバスト性の向上のためにGeographicLibを使って回転楕円体面上での計測を行うようにしています。この新機能を使うには、Proj 4.9.0以上が必要です。

note: Tag: para
en: Geometry Azimuth in degrees
ja: 度単位のジオメトリの方位

note: Tag: para
en: Blue: origin Point(25,45); Green: target Point(75, 100); Yellow: Y axis or North; Red: azimuth angle.
ja: 青: 原点 (25,45)、緑: 目標点 (75,100)、黄: Y軸または北、赤: 方位角

note: Tag: para
en: Blue: origin Point(75, 100); Green: target Point(25, 45); Yellow: Y axis or North; Red: azimuth angle.
ja: 青: 原点 (75,100)、緑: 目標点 (25,45)、黄: Y軸または北、赤: 方位角

note: Tag: refpurpose
en: Returns the angle between two vectors defined by 3 or 4 points, or 2 lines.
ja: 3点もしくは4点、または2線で定義される二つのベクタ間の角度を返します。

note: Tag: para
en: Computes the clockwise angle between two vectors.
ja: 二つのベクタの時計回りの角度を計算します。

note: Tag: para
en: <emphasis role="bold">Variant 1:</emphasis> computes the angle enclosed by the points P1-P2-P3. If a 4th point provided computes the angle points P1-P2 and P3-P4
ja: <emphasis role="bold">形式1:</emphasis>P1-P2-P3がなす角度を計算します。4番目のポイントが充てられた場合には、P1-P2とP3-P4がなす角度を計算します。

note: Tag: para
en: <emphasis role="bold">Variant 2:</emphasis> computes the angle between two vectors S1-E1 and S2-E2, defined by the start and end points of the input lines
ja: <emphasis role="bold">形式2:</emphasis> 入力ラインで定義される始端と終端ベクトルS1-E1とS2-E2の間の角度を計算します。

note: Tag: para
en: The result is a positive angle between 0 and 2&#x03C0; radians. The radian result can be converted to degrees using the PostgreSQL function <varname>degrees()</varname>.
ja: 結果は正の角度で0と2πラジアンの間です。ラジアンはPostgreSQL関数<varname>degrees()</varname>で度に変換できます。

note: Tag: para
en: Note that <varname>ST_Angle(P1,P2,P3) = ST_Angle(P2,P1,P2,P3)</varname>.
ja: <varname>ST_Angle(P1,P2,P3) = ST_Angle(P2,P1,P2,P3)</varname>となることに注意して下さい。

note: Tag: para
en: Angle between three points
ja: 3点間の角度

note: Tag: para
en: Angle between vectors defined by four points
ja: 4点で定義されたベクタ間の角度

note: Tag: para
en: Angle between vectors defined by the start and end points of lines
ja: ラインの始端と終端で定義されるベクタ間の角度

note: Tag: refpurpose
en: Returns the 2D point on g1 that is closest to g2. This is the first point of the shortest line from one geometry to the other.
ja: g1上にある、g2と最近傍となる2次元ポイントを返します。これは、あるジオメトリから他のジオメトリへの最短ラインの一つ目のポイントです。

note: Tag: para
en: Returns the 2-dimensional point on <varname>geom1</varname> that is closest to <varname>geom2</varname>. This is the first point of the shortest line between the geometries (as computed by <xref linkend="ST_ShortestLine"/>).
ja: <varname>geom2</varname>と最近傍となる<varname>geom1</varname>上の2次元ポイントを返します。これは、ジオメトリ間の最短ライン (<xref linkend="ST_ShortestLine"/>で生成されるものと同じです)の一つ目のポイントです。

note: Tag: para
en: If you have a 3D Geometry, you may prefer to use <xref linkend="ST_3DClosestPoint"/>.
ja: 3次元ジオメトリの場合には<xref linkend="ST_3DClosestPoint"/>の方が良いでしょう。

note: Tag: para
en: Enhanced: 3.4.0 - Support for geography.
ja: Enhanced: 3.4.0 - ジオグラフィに対応しました。

note: Tag: para
en: The closest point for a Point and a LineString is the point itself. The closest point for a LineString and a Point is a point on the line.
ja: ポイントとラインストリングの最近傍ポイントは引数で与えたポイントそのものです。ラインストリングとポイントの最近傍ポイントはラインストリング上のポイントです。

note: Tag: para
en: The closest point on polygon A to polygon B
ja: ポリゴンA上のポリゴンBへの最近傍点

note: Tag: refpurpose
en: Returns the 3D point on g1 that is closest to g2. This is the first point of the 3D shortest line.
ja: g1上の、g2に最も近い3次元ポイントを返します。これは3次元の最短ラインの始点です。

note: Tag: para
en: Returns the 3-dimensional point on g1 that is closest to g2. This is the first point of the 3D shortest line. The 3D length of the 3D shortest line is the 3D distance.
ja: g1上の、g2に最も近い3次元ポイントを返します。3次元最短線の一つ目のポイントです。3次元最短線の長さは、3次元距離と同じです。

note: Tag: para
en: Changed: 2.2.0 - if 2 2D geometries are input, a 2D point is returned (instead of old behavior assuming 0 for missing Z). In case of 2D and 3D, Z is no longer assumed to be 0 for missing Z.
ja: Changed: 2.2.0 - 二つの2次元ジオメトリが入力である場合には、2次元ポイントが返ります (古い挙動では、存在しないZの値について0を仮定していました)。2次元と3次元の場合には、もはや、存在しないZの値について0を仮定しません。

note: Tag: para
en: linestring and point -- both 3d and 2d closest point
ja: ラインストリングとポイント -- 3次元と2次元の両方の最も近いポイント

note: Tag: para
en: linestring and multipoint -- both 3d and 2d closest point
ja: ラインストリングとマルチポイント -- 3次元と2次元の両方の最も近いポイント

note: Tag: para
en: Multilinestring and polygon both 3d and 2d closest point
ja: マルチラインストリングとポリゴン -- 3次元と2次元の両方の最も近いポイント

note: Tag: refpurpose
en: Returns the distance between two geometry or geography values.
ja: 二つのジオメトリ値またはジオグラフィ値間の距離を返します。

note: Tag: para
en: For <xref linkend="geometry"/> types returns the minimum 2D Cartesian (planar) distance between two geometries, in projected units (spatial ref units).
ja: <xref linkend="geometry"/>型では、二つのジオメトリ間の2次元のデカルト (平面)距離の最小値を返します。単位は投影の単位 (空間参照系の単位)です。

note: Tag: para
en: For <xref linkend="geography"/> types defaults to return the minimum geodesic distance between two geographies in meters, compute on the spheroid determined by the SRID. If <varname>use_spheroid</varname> is false, a faster spherical calculation is used.
ja: <xref linkend="geography"/>型では、二つのジオグラフィ間の最小の測地距離を、メートル単位で返します。SRIDで決定される回転楕円体で計算します。<varname>use_spheroid</varname>がFALSEの場合には、球面が計算に使われます。

note: Tag: para
en: Availability: 1.5.0 geography support was introduced in 1.5. Speed improvements for planar to better handle large or many vertex geometries
ja: Availability: 1.5.0 1.5でジオグラフィ対応が導入されました。大きいジオメトリや頂点の多いジオメトリについての速度が改善しました

note: Tag: para
en: Enhanced: 2.1.0 improved speed for geography. See <link xlink:href="http://boundlessgeo.com/2012/07/making-geography-faster/">Making Geography faster</link> for details.
ja: Enhanced: 2.1.0 ジオグラフィでの速度が改善されました。詳細は<link xlink:href="http://boundlessgeo.com/2012/07/making-geography-faster/">Making Geography faster</link>をご覧ください。

note: Tag: para
en: Enhanced: 2.1.0 - support for curved geometries was introduced.
ja: Enhanced: 2.1.0 - 曲線ジオメトリ対応が導入されました。

note: Tag: title
en: Geometry Examples
ja: ジオメトリの例

note: Tag: para
en: Geometry example - units in planar degrees 4326 is WGS 84 long lat, units are degrees.
ja: ジオメトリの例 - 平面の単位で4326はWGS84経度緯度なので、単位は度。

note: Tag: para
en: Geometry example - units in meters (SRID: 3857, proportional to pixels on popular web maps). Although the value is off, nearby ones can be compared correctly, which makes it a good choice for algorithms like KNN or KMeans.
ja: ジオメトリの例 - メートル単位 (SIRD: 3857, 一般的なWebマップのピクセルに比例)。値は正しくありませんが、近傍の比較は正しくでき、KNNやKMeansなどのアルゴリズムに適しています。

note: Tag: para
en: Geometry example - units in meters (SRID: 3857 as above, but corrected by cos(lat) to account for distortion)
ja: ジオメトリの例 - メートル単位 (SRID:3857, 上と同じですが、歪みを考慮してcos(lat)で修正しています)

note: Tag: para
en: Geometry example - units in meters (SRID: 26986 Massachusetts state plane meters) (most accurate for Massachusetts)
ja: ジオメトリの例 - メートル単位 (SRID: 26986, マサチューセッツ州平面メートル) (マサチューセッツで最も精度が高い)

note: Tag: para
en: Geometry example - units in meters (SRID: 2163 US National Atlas Equal area) (least accurate)
ja: ジオメトリの例 - メートル単位 (SRID: 2163, 米国ナショナルアトラス正積図法) (最も精度が低い)

note: Tag: title
en: Geography Examples
ja: ジオグラフィの例

note: Tag: para
en: Same as geometry example but note units in meters - use sphere for slightly faster and less accurate computation.
ja: ジオメトリの例と同じですが、メートル単位である点に注意して下さい - 球面の使用で、わずかな速度向上と低精度の計算を行います。

note: Tag: refpurpose
en: Returns the 3D cartesian minimum distance (based on spatial ref) between two geometries in projected units.
ja: 投影座標系の単位で、二つのジオメトリ間の3次元デカルト距離の最小値を返します (空間参照系に基づきます)。

note: Tag: para
en: Returns the 3-dimensional minimum cartesian distance between two geometries in projected units (spatial ref units).
ja: 投影座標系の単位で、二つのジオメトリ間の3次元デカルト距離の最小値を返します (空間参照系に基づきます)。

note: Tag: para
en: Changed: 2.2.0 - In case of 2D and 3D, Z is no longer assumed to be 0 for missing Z.
ja: Changed: 2.2.0 - 2次元と3次元の場合には、もはや、存在しないZの値について0を仮定しません。

note: Tag: para
en: Changed: 3.0.0 - SFCGAL version removed
ja: Changed: 3.0.0 - SFCGAL版は削除されました

note: Tag: refpurpose
en: Returns minimum distance in meters between two lon/lat geometries using a spherical earth model.
ja: 球面の地球モデルを使って、二つの経度/緯度ジオメトリの最小距離をメートル単位で返します。

note: Tag: para
en: Returns minimum distance in meters between two lon/lat points. Uses a spherical earth and radius derived from the spheroid defined by the SRID. Faster than <xref linkend="ST_Distance_Spheroid"/>, but less accurate. PostGIS Versions prior to 1.5 only implemented for points.
ja: 二つの経度緯度ジオメトリの間の最短距離をメートル単位で返します。SRIDで定義された回転楕円体に由来する半径となる球面を使います。<xref linkend="ST_Distance_Spheroid"/>より高速ですが、精度が悪くなります。PostGISの1.5より前の版ではポイント間の距離の計測だけを実装していました。

note: Tag: para
en: Availability: 1.5 - support for other geometry types besides points was introduced. Prior versions only work with points.
ja: Availability: 1.5 - ポイント以外のジオメトリが導入されました。以前の版ではポイントでのみ動作しました。

note: Tag: para
en: Changed: 2.2.0 In prior versions this used to be called ST_Distance_Sphere
ja: Changed: 2.2.0 前の版ではこの関数はST_Distance_Sphereと呼ばれていました

note: Tag: refpurpose
en: Returns the minimum distance between two lon/lat geometries using a spheroidal earth model.
ja: 回転楕円体面の地球モデルを使って、二つの経度/緯度ジオメトリの最小距離を返します。

note: Tag: para
en: Returns minimum distance in meters between two lon/lat geometries given a particular spheroid. See the explanation of spheroids given for <xref linkend="ST_Length_Spheroid"/>.
ja: 与えられた回転楕円体面の、二つの経度/緯度ジオメトリの最小距離をメートル単位で返します。回転楕円体面の詳細については<xref linkend="ST_Length_Spheroid"/>をご覧下さい。

note: Tag: para
en: This function does not look at the SRID of the geometry. It assumes the geometry coordinates are based on the provided spheroid.
ja: この関数はジオメトリのSRIDを見ません。ジオメトリの座標は与えられた回転楕円体に基づくものと仮定します。

note: Tag: para
en: Changed: 2.2.0 In prior versions this was called ST_Distance_Spheroid
ja: Changed: 2.2.0 前の版ではこの関数はST_Distance_Sphereと呼ばれていました

note: Tag: refpurpose
en: Returns the Fréchet distance between two geometries.
ja: 二つのジオメトリのフレシェ距離を返します。

note: Tag: para
en: Implements algorithm for computing the Fréchet distance restricted to discrete points for both geometries, based on <link xlink:href="http://www.kr.tuwien.ac.at/staff/eiter/et-archive/cdtr9464.pdf">Computing Discrete Fréchet Distance</link>. The Fréchet distance is a measure of similarity between curves that takes into account the location and ordering of the points along the curves. Therefore it is often better than the Hausdorff distance.
ja: 両方のジオメトリの離散点への制限を受けたフレシェ距離の計算アルゴリズムの実装は<link xlink:href="http://www.kr.tuwien.ac.at/staff/eiter/et-archive/cdtr9464.pdf">Computing Discrete Fréchet Distance</link>を基にしています。フレシェ距離は曲線の位置と点の並び順とを考慮に入れた曲線間の類似度を計測するものです。ハウスドルフ距離よりも良いことがしばしばあります。

note: Tag: para
en: When the optional densifyFrac is specified, this function performs a segment densification before computing the discrete Fréchet distance. The densifyFrac parameter sets the fraction by which to densify each segment. Each segment will be split into a number of equal-length subsegments, whose fraction of the total length is closest to the given fraction.
ja: 任意引数densifyFracが指定されると、この関数は、離散フレシェ距離の計算の前に、辺密度を増加させます。densifyFracパラメータは辺の高密度化に使う比率を設定します。それぞれの辺は多数の等長の辺に分割され、分割辺長の合計長に対する比は与えた比率に近くなります。

note: Tag: para
en: Units are in the units of the spatial reference system of the geometries.
ja: 単位はジオメトリの空間参照系の単位です。

note: Tag: para
en: The current implementation supports only vertices as the discrete locations. This could be extended to allow an arbitrary density of points to be used.
ja: 現在の実装では、離散位置は、頂点のみに対応しています。任意の密度でポイントを使用することができるよう拡張されています。

note: Tag: para
en: The smaller densifyFrac we specify, the more accurate Fréchet distance we get. But, the computation time and the memory usage increase with the square of the number of subsegments.
ja: densityFracに小さい値を指定すると、フレシェ距離の精度が増します。しかし、分割辺数の2乗に比例して計算時間とメモリ利用量が増大します。

note: Tag: para
en: Availability: 2.4.0 - requires GEOS &gt;= 3.7.0
ja: Availability: 2.4.0 - GEOS &gt;= 3.7.0が必要です

note: Tag: refpurpose
en: Returns the Hausdorff distance between two geometries.
ja: 二つのジオメトリ間のハウスドルフ距離を返します。

note: Tag: para
en: Returns the <link xlink:href="http://en.wikipedia.org/wiki/Hausdorff_distance">Hausdorff distance</link> between two geometries. The Hausdorff distance is a measure of how similar or dissimilar 2 geometries are.
ja: 二つのジオメトリ間の<link xlink:href="https://ja.wikipedia.org/wiki/%E3%83%8F%E3%82%A6%E3%82%B9%E3%83%89%E3%83%AB%E3%83%95%E8%B7%9D%E9%9B%A2">ハウスドルフ距離</link>を返します。ハウスドルフ距離は二つのジオメトリのどれぐらい似ているかを示す尺度です。

note: Tag: para
en: The function actually computes the "Discrete Hausdorff Distance". This is the Hausdorff distance computed at discrete points on the geometries. The <parameter>densifyFrac</parameter> parameter can be specified, to provide a more accurate answer by densifying segments before computing the discrete Hausdorff distance. Each segment is split into a number of equal-length subsegments whose fraction of the segment length is closest to the given fraction.
ja: この関数は実際に「離散ハウスドルフ距離」を計算します。これはジオメトリの離散ポイントにおけるハウスドルフ距離の計算を行ったものです。<parameter>densifyFrac</parameter>パラメータが指定された場合には、離散ハウスドルフ距離の計算の前に辺の密度を高くして、精度の高い結果が得られるようにします。個々の辺は、与えた割合に近い辺長で等分されます。

note: Tag: para
en: This algorithm is NOT equivalent to the standard Hausdorff distance. However, it computes an approximation that is correct for a large subset of useful cases. One important case is Linestrings that are roughly parallel to each other, and roughly equal in length. This is a useful metric for line matching.
ja: このアルゴリズムは標準的なハウスドルフ距離と等価では*ありません*。しかし、使用可能な場面の大部分で正しくなる近似計算がなされています。重要なものに、それぞれが概ね平行で概ね等しい長さのラインストリングがあります。これはラインのマッチングに使える基準です。

note: Tag: para
en: Hausdorff distance (red) and distance (yellow) between two lines
ja: 2線間のハウスドルフ距離 (赤)と距離 (黄)

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Hausdorff distance with densification.
ja: <emphasis role="bold">Example:</emphasis> 高密度化したうえで求めたハウスドルフ距離。

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> For each building, find the parcel that best represents it. First we require that the parcel intersect with the building geometry. <code>DISTINCT ON</code> guarantees we get each building listed only once. <code>ORDER BY .. ST_HausdorffDistance</code> selects the parcel that is most similar to the building.
ja: <emphasis role="bold">例:</emphasis> 個々の建物について、最もよく表現する区画を見つけます。最初に建物ジオメトリとインタセクトする区画を求めます。<code>DISTINCT ON</code>で、個々の建物が一回ずつしかリストに挙がらないことが保障されます。<code>ORDER BY .. ST_HausdorffDistance</code>で、最も建物に近い区画を選択します。

note: Tag: refpurpose
en: Returns the 2D length of a linear geometry.
ja: 線系ジオメトリの2次元長を返します。

note: Tag: para
en: For geometry types: returns the 2D Cartesian length of the geometry if it is a LineString, MultiLineString, ST_Curve, ST_MultiCurve. For areal geometries 0 is returned; use <xref linkend="ST_Perimeter"/> instead. The units of length is determined by the spatial reference system of the geometry.
ja: ジオメトリ型: LINESTRING, MULTILINESTRING, ST_Curve, ST_MultiCurveの場合には2次元デカルト距離を返します。面ジオメトリでは0を返すので<xref linkend="ST_Perimeter"/>を代わりに使います。長さの単位はジオメトリの空間参照系で決まります。

note: Tag: para
en: For geography types: computation is performed using the inverse geodesic calculation. Units of length are in meters. If PostGIS is compiled with PROJ version 4.8.0 or later, the spheroid is specified by the SRID, otherwise it is exclusive to WGS84. If <varname>use_spheroid = false</varname>, then the calculation is based on a sphere instead of a spheroid.
ja: ジオグラフィ型: 計算は逆測地問題を用いています。長さの単位はメートルです。PROJ 4.8.0以上でPostGISをコンパイルしている場合には、回転楕円体面はSRIDで指定されたものとなり、それより前はWGS84となります。<varname>use_spheroid = false</varname>とすると、計算は回転楕円体面でなく真球面で行います。

note: Tag: para
en: Currently for geometry this is an alias for ST_Length2D, but this may change to support higher dimensions.
ja: 現在は、ジオメトリに対してはST_Length2Dの別名ですが、高次元対応に変更されるかも知れません。

note: Tag: para
en: Changed: 2.0.0 Breaking change -- in prior versions applying this to a MULTI/POLYGON of type geography would give you the perimeter of the POLYGON/MULTIPOLYGON. In 2.0.0 this was changed to return 0 to be in line with geometry behavior. Please use ST_Perimeter if you want the perimeter of a polygon
ja: Changed: 2.0.0 大幅な変更 -- 以前の版ではジオグラフィのPOLYGONやMULTIPOLYGONへの適用によってPOLYGONやMULTIPOLYGONの周囲長を返しました。2.0.0版ではジオメトリの挙動に従うため0を返すように変更しました。ポリゴンの周囲長を求める場合は、ST_Perimeterを使います

note: Tag: para
en: For geography the calculation defaults to using a spheroidal model. To use the faster but less accurate spherical calculation use ST_Length(gg,false);
ja: ジオグラフィでは計算は回転楕円体面モデルを使用します。計算が速い反面精度が低い球面計算を使うには、 ST_Length(gg,false)とします。

note: Tag: para
en: Availability: 1.5.0 geography support was introduced in 1.5.
ja: Availability: 1.5.0 ジオグラフィt対応が導入されました。

note: Tag: para
en: Return length in feet for line string. Note this is in feet because EPSG:2249 is Massachusetts State Plane Feet
ja: ラインストリングのフィート単位の長さを返します。EPSG:2249はフィート単位のマサチューセッツ州平面なので、フィート単位になることに注意して下さい。

note: Tag: para
en: Return length of WGS 84 geography line
ja: WGS84ジオグラフィのラインの長さを返します。

note: Tag: refpurpose
en: Returns the 2D length of a linear geometry. Alias for <varname>ST_Length</varname>
ja: LINESTRINGまたはMULTILINESTRINGに対して、ジオメトリの2次元長を返します。これは<varname>ST_Length</varname>の別名です。

note: Tag: para
en: Returns the 2D length of the geometry if it is a linestring or multi-linestring. This is an alias for <varname>ST_Length</varname>
ja: LINESTRINGまたはMULTILINESTRINGに対して、ジオメトリの2次元長を返します。これは<varname>ST_Length</varname>の別名です。

note: Tag: refpurpose
en: Returns the 3D length of a linear geometry.
ja: 線ジオメトリの3次元長を返します。

note: Tag: para
en: Returns the 3-dimensional or 2-dimensional length of the geometry if it is a LineString or MultiLineString. For 2-d lines it will just return the 2-d length (same as ST_Length and ST_Length2D)
ja: LINESTRINGまたはMULTILINESTRINGの場合には、そのジオメトリの3次元長または2次元長を返します。2次元ラインでは2次元長を返します (ST_LengthとST_Length2Dと同じです)。

note: Tag: para
en: Changed: 2.0.0 In prior versions this used to be called ST_Length3D
ja: Changed: 2.0.0 以前の版ではST_Length3Dと呼ばれていました

note: Tag: para
en: Return length in feet for a 3D cable. Note this is in feet because EPSG:2249 is Massachusetts State Plane Feet
ja: 3次元ケーブルの長さをフィート単位で返します。EPSG:2249はフィート単位のマサチューセッツ州平面なので、フィート単位になることに注意して下さい。

note: Tag: refpurpose
en: Returns the 2D or 3D length/perimeter of a lon/lat geometry on a spheroid.
ja: 回転楕円体面上の経度緯度のジオメトリの2次元または3次元の長さ/周長を返します。

note: Tag: para
en: Calculates the length or perimeter of a geometry on an ellipsoid. This is useful if the coordinates of the geometry are in longitude/latitude and a length is desired without reprojection. The spheroid is specified by a text value as follows:
ja: 回転楕円体面上のジオメトリの周長を返します。この関数は、ジオメトリの座標が経度/緯度で、投影変換なしで長さを求めたい場合に使います。回転楕円体は次のように文字列値で指定します:

note: Tag: para
en: For example:
ja: 例:

note: Tag: para
en: Changed: 2.2.0 In prior versions this was called ST_Length_Spheroid and had the alias ST_3DLength_Spheroid
ja: Changed: 2.2.0 これより前の版では、これはST_Length_Spheroidと呼ばれ、ST_3DLength_Spheroidという別名を持っていました。

note: Tag: refpurpose
en: Returns the 2D longest line between two geometries.
ja: 二つのジオメトリ間の2次元最長ラインを返します。

note: Tag: para
en: Returns the 2-dimensional longest line between the points of two geometries. The line returned starts on <varname>g1</varname> and ends on <varname>g2</varname>.
ja: 二つのジオメトリのポイントで作られる2次元の最長ラインを返します。ラインは<varname>g1</varname>上から始まり、<varname>g2</varname>上で終わります。

note: Tag: para
en: The longest line always occurs between two vertices. The function returns the first longest line if more than one is found. The length of the line is equal to the distance returned by <xref linkend="ST_MaxDistance"/>.
ja: 最長ラインは常に二つの頂点となります。一つ以上の最長ラインが発見された場合には、この関数は最初のものを返します。ラインの長さは<xref linkend="ST_MaxDistance"/>が返す距離と同じです。

note: Tag: para
en: If g1 and g2 are the same geometry, returns the line between the two vertices farthest apart in the geometry. The endpoints of the line lie on the circle computed by <xref linkend="ST_MinimumBoundingCircle"/>.
ja: g1とg2が同じジオメトリの場合には、ジオメトリで最も遠くに離れる2頂点を結ぶラインが返ります。このラインの端点は<xref linkend="ST_MinimumBoundingCircle"/>で計算された円の上に存在します。

note: Tag: para
en: Longest line between a point and a line
ja: ポイントとラインストリングの間の最長となるライン

note: Tag: para
en: Longest line between two polygons
ja: 二つのポリゴンの間の最長となるライン

note: Tag: para
en: Longest line across a single geometry. The length of the line is equal to the Maximum Distance. The endpoints of the line lie on the Minimum Bounding Circle.
ja: 一つのジオメトリを横切る最長のラインです。ラインの長さは最大距離と同じです。ラインの端点は最小境界円上に存在します。

note: Tag: refpurpose
en: Returns the 3D longest line between two geometries
ja: 二つのジオメトリ間の3次元最長ラインを返します。

note: Tag: para
en: Returns the 3-dimensional longest line between two geometries. The function returns the first longest line if more than one. The line returned starts in g1 and ends in g2. The 3D length of the line is equal to the distance returned by <xref linkend="ST_3DMaxDistance"/>.
ja: 二つのジオメトリ間の3次元最長ラインを返します。該当が複数ある場合には最初の最長ラインを返します。返されるラインは、g1から始まりg2で終わります。ラインの3次元長は<xref linkend="ST_3DMaxDistance"/>が返す距離と同じです。

note: Tag: para
en: linestring and point -- both 3d and 2d longest line
ja: ラインストリングとポイント -- 3次元と2次元の最長ライン

note: Tag: para
en: linestring and multipoint -- both 3d and 2d longest line
ja: ラインストリングとマルチポイント -- 3次元と2次元の最長ライン

note: Tag: para
en: MultiLineString and Polygon both 3d and 2d longest line
ja: マルチラインストリングとポリゴンの3次元と2次元の最長ライン

note: Tag: refpurpose
en: Returns the 2D largest distance between two geometries in projected units.
ja: 二つのジオメトリ間の2次元最長距離を空間参照系の単位で返します。

note: Tag: para
en: Returns the 2-dimensional maximum distance between two geometries, in projected units. The maximum distance always occurs between two vertices. This is the length of the line returned by <xref linkend="ST_LongestLine"/>.
ja: 二つのジオメトリの2次元最長距離を空間参照系の単位で返します。最長距離は常に二つの頂点間で発生します。これは<xref linkend="ST_LongestLine"/>が返すラインの長さと同じです。

note: Tag: para
en: If g1 and g2 are the same geometry, returns the distance between the two vertices farthest apart in that geometry.
ja: g1とg2が同じジオメトリであった場合には、そのジオメトリ内の最も遠くなる二つの頂点間の距離を返します。

note: Tag: para
en: Maximum distance between a point and lines.
ja: ポイントとラインの最長距離。

note: Tag: para
en: Maximum distance between vertices of a single geometry.
ja: 一つのジオメトリ内の頂点間の最長距離。

note: Tag: refpurpose
en: Returns the 3D cartesian maximum distance (based on spatial ref) between two geometries in projected units.
ja: 二つのジオメトリ間の3次元最大デカルト距離 (空間参照系に基づく)を空間参照系の単位で返します。

note: Tag: para
en: Returns the 3-dimensional maximum cartesian distance between two geometries in projected units (spatial ref units).
ja: 二つのジオメトリ間の3次元の最大デカルト距離を空間参照系の単位で返します。

note: Tag: refpurpose
en: Returns the minimum clearance of a geometry, a measure of a geometry's robustness.
ja: ジオメトリのクリアランスの最小値を返します。この値はジオメトリのロバスト性を示すものです。

note: Tag: para
en: It is possible for a geometry to meet the criteria for validity according to <xref linkend="ST_IsValid"/> (polygons) or <xref linkend="ST_IsSimple"/> (lines), but to become invalid if one of its vertices is moved by a small distance. This can happen due to loss of precision during conversion to text formats (such as WKT, KML, GML, GeoJSON), or binary formats that do not use double-precision floating point coordinates (e.g. MapInfo TAB).
ja: <xref linkend="ST_IsValid"/> (ポリゴン)または<xref linkend="ST_IsSimple"/> (ライン)に従って、ジオメトリは妥当性基準を満たせますが、そのうちの一つの頂点が短い距離だけ移動すると不正になります。これは、テキスト書式 (WKT, KML, GML, GeoJSON等)に変換する際の精度の損失や、倍精度浮動小数点座標値を使わない書式 (MapInfo TAB等)で発生する可能性があります。

note: Tag: para
en: The minimum clearance is a quantitative measure of a geometry's robustness to change in coordinate precision. It is the largest distance by which vertices of the geometry can be moved without creating an invalid geometry. Larger values of minimum clearance indicate greater robustness.
ja: クリアランスの最小値は、座標精度を変更するためのジオメトリのロバスト性を定量的に計測したものです。ジオメトリの頂点が不正なジオメトリとなることなしに移動できる最大距離です。

note: Tag: para
en: If a geometry has a minimum clearance of <varname>e</varname>, then:
ja: ジオメトリがクリアランスの最小値<varname>e</varname>を持つ場合:

note: Tag: para
en: No two distinct vertices in the geometry are closer than the distance <varname>e</varname>.
ja: 距離<varname>e</varname>より近くなるジオメトリ内の二つの個別の頂点はありません。

note: Tag: para
en: No vertex is closer than <varname>e</varname> to a line segment of which it is not an endpoint.
ja: 終端となる辺を除いて、辺との距離が<varname>e</varname>より近い頂点は存在しません。

note: Tag: para
en: If no minimum clearance exists for a geometry (e.g. a single point, or a MultiPoint whose points are identical), the return value is <varname>Infinity</varname>.
ja: ジオメトリのクリアランスの最小値が存在しない (単一POINT、要素が同じMULTIPOINT等)場合には、返り値は<varname>Infinity</varname>になります。

note: Tag: para
en: To avoid validity issues caused by precision loss, <xref linkend="ST_ReducePrecision"/> can reduce coordinate precision while ensuring that polygonal geometry remains valid.
ja: 精度の損失による有効性の問題を回避するには、 <xref linkend="ST_ReducePrecision"/>を使うと、ポリゴンジオメトリの妥当性を確実に維持しつつ座標値の精度を減らせられます。

note: Tag: refpurpose
en: Returns the two-point LineString spanning a geometry's minimum clearance.
ja: ジオメトリの最小クリアランスを示す、2点のラインストリングを返します。

note: Tag: para
en: Returns the two-point LineString spanning a geometry's minimum clearance. If the geometry does not have a minimum clearance, <varname>LINESTRING EMPTY</varname> is returned.
ja: ジオメトリの最小クリアランスを示す、2点のラインストリングを返します。ジオメトリが最小クリアランスを持たない場合には、<varname>LINESTRING EMPTY</varname>が返ります。

note: Tag: para
en: Availability: 2.3.0 - requires GEOS &gt;= 3.6.0
ja: Availability: 2.3.0 - GEOS 3.6.0以上が必要です。

note: Tag: refpurpose
en: Returns the length of the boundary of a polygonal geometry or geography.
ja: ポリゴンジオメトリまたはジオグラフィの境界の長さを返します。

note: Tag: para
en: Returns the 2D perimeter of the geometry/geography if it is a ST_Surface, ST_MultiSurface (Polygon, MultiPolygon). 0 is returned for non-areal geometries. For linear geometries use <xref linkend="ST_Length"/>. For geometry types, units for perimeter measures are specified by the spatial reference system of the geometry.
ja: ジオメトリ/ジオグラフィがST_SrrfaceまたはST_MultiSurface (POLYGONまたはMULTIPOLYGON)の場合に、2次元周囲長を返します。面ジオメトリでない場合には0を返します。ラインストリングについては<xref linkend="ST_Length"/>を使います。ジオメトリに対しては、周囲長の計測単位は空間参照系によります。

note: Tag: para
en: For geography types, the calculations are performed using the inverse geodesic problem, where perimeter units are in meters. If PostGIS is compiled with PROJ version 4.8.0 or later, the spheroid is specified by the SRID, otherwise it is exclusive to WGS84. If <varname>use_spheroid = false</varname>, then calculations will approximate a sphere instead of a spheroid.
ja: ジオグラフィに対しては、測地線の逆測地問題を使って計算し、長さの単位はメートルです。PostGISをPROJ 4.8.0以上でコンパイルしているなら、回転楕円体面はSRIDで指定されたものですが、そうでなければ、WGS84に限定されます。<varname>use_spheroid = false</varname>とすると、回転楕円体面でなく近似する球面で計算します。

note: Tag: para
en: Currently this is an alias for ST_Perimeter2D, but this may change to support higher dimensions.
ja: 現在は、この関数はST_Perimeter2Dの別名ですが、高次元対応に変更されるかも知れません。

note: Tag: para
en: Availability 2.0.0: Support for geography was introduced
ja: Availability: 2.0.0 ジオグラフィ対応が導入されました。

note: Tag: para
en: Return perimeter in feet for Polygon and MultiPolygon. Note this is in feet because EPSG:2249 is Massachusetts State Plane Feet
ja: POLYGONとMULTIPOLYGONに対するフィート単位の周囲長を返します。EPSG:2249はフィート単位のマサチューセッツ平面なので、フィート単位です。

note: Tag: para
en: Return perimeter in meters and feet for Polygon and MultiPolygon. Note this is geography (WGS 84 long lat)
ja: ポリゴンとマルチポリゴンのメートル単位とフィート単位の周囲長を返します。ジオグラフィ (WGS 84経度緯度)であることに注意して下さい。

note: Tag: refpurpose
en: Returns the 2D perimeter of a polygonal geometry. Alias for <varname>ST_Perimeter</varname>.
ja: ポリゴンジオメトリの2次元周長を返します。<varname>ST_Perimeter</varname>の別名です。

note: Tag: para
en: Returns the 2-dimensional perimeter of a polygonal geometry.
ja: ポリゴンジオメトリの2次元周長を返します。

note: Tag: para
en: This is currently an alias for ST_Perimeter. In future versions ST_Perimeter may return the highest dimension perimeter for a geometry. This is still under consideration
ja: これは、現在はST_Perimeterの別名です。将来的に、ST_Perimeterがジオメトリの最大次元の周囲長を返すようになるかも知れません。これは、まだ考慮中です。

note: Tag: refpurpose
en: Returns the 3D perimeter of a polygonal geometry.
ja: ポリゴンジオメトリの3次元周長を返します。

note: Tag: para
en: Returns the 3-dimensional perimeter of the geometry, if it is a polygon or multi-polygon. If the geometry is 2-dimensional, then the 2-dimensional perimeter is returned.
ja: POLYGONまたはMULTIPOLYGONジオメトリの場合には、3次元周囲長を返します。ジオメトリが2次元の場合には、2次元周囲長を返します。

note: Tag: para
en: Changed: 2.0.0 In prior versions this used to be called ST_Perimeter3D
ja: Changed: 2.0.0 以前の版ではST_Perimeter3Dと呼ばれていました。

note: Tag: para
en: Perimeter of a slightly elevated polygon in the air in Massachusetts state plane feet
ja: フィート単位のマサチューセッツ州平面での、大気中にある、わずかに持ち上げられたポリゴンの周囲長です。

note: Tag: refpurpose
en: Returns the 2D shortest line between two geometries
ja: 二つのジオメトリの3次元の最短ラインを返します。

note: Tag: para
en: Returns the 2-dimensional shortest line between two geometries. The line returned starts in <varname>geom1</varname> and ends in <varname>geom2</varname>. If <varname>geom1</varname> and <varname>geom2</varname> intersect the result is a line with start and end at an intersection point. The length of the line is the same as <xref linkend="ST_Distance"/> returns for g1 and g2.
ja: 二つのジオメトリの間の2次元の最短ラインを返します。返されるラインは<varname>geom1</varname>内から始まり、<varname>geom2</varname>内で終わります。<varname>geom1</varname>と<varname>geom2</varname>がインタセクトしている場合には、結果はインタセクションするポイントを始点と終点にしたラインになります。ラインの長さは<xref linkend="ST_Distance"/> でg1とg2を引数に取った時と同じになります。

note: Tag: para
en: Enhanced: 3.4.0 - support for geography.
ja: Enhanced: 3.4.0 - ジオグラフィに対応しました。

note: Tag: para
en: Shortest line between Point and LineString
ja: ポイントとラインストリングの最短ライン

note: Tag: para
en: Shortest line between Polygons
ja: ポリゴン間の最短ライン

note: Tag: refpurpose
en: Returns the 3D shortest line between two geometries
ja: 二つのジオメトリの3次元の最短ラインを返します。

note: Tag: para
en: Returns the 3-dimensional shortest line between two geometries. The function will only return the first shortest line if more than one, that the function finds. If g1 and g2 intersects in just one point the function will return a line with both start and end in that intersection-point. If g1 and g2 are intersecting with more than one point the function will return a line with start and end in the same point but it can be any of the intersecting points. The line returned will always start in g1 and end in g2. The 3D length of the line this function returns will always be the same as <xref linkend="ST_3DDistance"/> returns for g1 and g2.
ja: 二つのジオメトリの3次元長が最短となるラインを返します。見つかった最短線が複数ある場合は、最初のもののみ返します。g1とg2が1点のみでインタセクトする場合は、インタセクション点を開始点と終了点とします。g1とg2が1点より多くインタセクトする場合は、同じ点を開始点と終了点としますが、その点は不定です。返されるラインは常にg1側を始点、g2側を終点とします。この関数が返すラインの長さは、常にg1とg2を指定した場合の<xref linkend="ST_3DDistance"/>が返す値と同じになります。

note: Tag: para
en: linestring and point -- both 3d and 2d shortest line
ja: ラインストリングとポイント -- 3次元と2次元の最短ライン

note: Tag: para
en: linestring and multipoint -- both 3d and 2d shortest line
ja: ラインストリングとマルチポイント -- 3次元と2次元の最短ライン

note: Tag: para
en: MultiLineString and polygon both 3d and 2d shortest line
ja: マルチラインストリングとポリゴンの3次元と2次元の最短ライン

note: Tag: title
en: Operators
ja: 演算子

note: Tag: title
en: Bounding Box Operators
ja: バウンディングボックス演算子

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's 2D bounding box intersects B's 2D bounding box.
ja: Aの2次元バウンディングボックスがBの2次元バウンディングボックスとインタセクトする場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>&amp;&amp;</varname> operator returns <varname>TRUE</varname> if the 2D bounding box of geometry A intersects the 2D bounding box of geometry B.
ja: <varname>&amp;&amp;</varname>演算子は、Aの2次元バウンディングボックスがBの2次元バウンディングボックスとインタセクトする場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: This operand will make use of any indexes that may be available on the geometries.
ja: これのオペランドは、ジオメトリで使用できるインデックスを使用します。

note: Tag: para
en: Availability: 1.5.0 support for geography was introduced.
ja: Availability: 1.5.0 ジオグラフィ対応が導入されました。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a geometry's (cached) 2D bounding box intersects a 2D float precision bounding box (BOX2DF).
ja: ジオメトリの (キャッシュされている)2次元バウンディングボックスが単精度浮動小数点数による2次元バウンディングボックスとインタセクトする場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>&amp;&amp;</varname> operator returns <varname>TRUE</varname> if the cached 2D bounding box of geometry A intersects the 2D bounding box B, using float precision. This means that if B is a (double precision) box2d, it will be internally converted to a float precision 2D bounding box (BOX2DF)
ja: <varname>&amp;&amp;</varname>演算子は、ジオメトリAのキャッシュされた2次元バウンディングボックスが、2次元バウンディングボックスBとインタセクトする場合に、<varname>TRUE</varname>を返します。単精度浮動小数点数によるバウンディングボックスを使います。Bが倍精度浮動小数点数を使うbox2dである場合には、単精度浮動小数点数によるバウンディングボックス (BOX2DF)に変換されることになります。

note: Tag: para
en: This operand is intended to be used internally by BRIN indexes, more than by users.
ja: この被演算子は、ユーザが使うためというよりも内部でBRINインデックスに使うために導入されました。

note: Tag: para
en: Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+.
ja: Availability: 2.3.0 BRIN (Block Range INdexes)が導入されました。PostgreSQL 9.5以上が必要です。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a 2D float precision bounding box (BOX2DF) intersects a geometry's (cached) 2D bounding box.
ja: 単精度浮動小数点数による2次元バウンディングボックスがジオメトリの (キャッシュされている)2次元バウンディングボックスとインタセクトする場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>&amp;&amp;</varname> operator returns <varname>TRUE</varname> if the 2D bounding box A intersects the cached 2D bounding box of geometry B, using float precision. This means that if A is a (double precision) box2d, it will be internally converted to a float precision 2D bounding box (BOX2DF)
ja: <varname>&amp;&amp;</varname>演算子は、2次元バウンディングボックスAが、ジオメトリBのキャッシュされた2次元バウンディングボックスとインタセクトする場合に、<varname>TRUE</varname>を返します。単精度浮動小数点数によるバウンディングボックスを使います。Aが倍精度浮動小数点数を使うbox2dである場合には、単精度浮動小数点数によるバウンディングボックス (BOX2DF)に変換されることになります。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if two 2D float precision bounding boxes (BOX2DF) intersect each other.
ja: 二つの単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)が相互にインタセクトする場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>&amp;&amp;</varname> operator returns <varname>TRUE</varname> if two 2D bounding boxes A and B intersect each other, using float precision. This means that if A (or B) is a (double precision) box2d, it will be internally converted to a float precision 2D bounding box (BOX2DF)
ja: <varname>&amp;&amp;</varname>演算子は、2次元バウンディングボックスAとBが相互にインタセクトする場合に、<varname>TRUE</varname>を返します。単精度浮動小数点数によるバウンディングボックスを使います。AまたはBが倍精度浮動小数点数を使うbox2dである場合には、バウンディングボックス (BOX2DF)に変換されることになります。

note: Tag: para
en: This operator is intended to be used internally by BRIN indexes, more than by users.
ja: この演算子は、ユーザが使うためというよりも内部でBRINインデックスに使うために導入されました。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's n-D bounding box intersects B's n-D bounding box.
ja: Aのn次元バウンディングボックスがBのn次元バウンディングボックスとインタセクトする場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>&amp;&amp;&amp;</varname> operator returns <varname>TRUE</varname> if the n-D bounding box of geometry A intersects the n-D bounding box of geometry B.
ja: <varname>&amp;&amp;&amp;</varname>演算子は、Aのn次元バウンディングボックスがBのn次元バウンディングボックスとインタセクトする場合に<varname>TRUE</varname>を返します。

note: Tag: title
en: Examples: 3D LineStrings
ja: 例: 3次元ラインストリング

note: Tag: title
en: Examples: 3M LineStrings
ja: 例: XYMラインストリング

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a geometry's (cached) n-D bounding box intersects a n-D float precision bounding box (GIDX).
ja: ジオメトリの (キャッシュされている)n次元バウンディングボックスが単精度浮動小数点数によるn次元バウンディングボックス (GIDX)とインタセクトする場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>&amp;&amp;&amp;</varname> operator returns <varname>TRUE</varname> if the cached n-D bounding box of geometry A intersects the n-D bounding box B, using float precision. This means that if B is a (double precision) box3d, it will be internally converted to a float precision 3D bounding box (GIDX)
ja: <varname>&amp;&amp;&amp;</varname>演算子は、ジオメトリAのキャッシュされたn次元バウンディングボックスが、n次元バウンディングボックスBとインタセクトする場合に、<varname>TRUE</varname>を返します。単精度浮動小数点数によるバウンディングボックスを使います。Bが倍精度浮動小数点数を使うbox3dである場合には、単精度浮動小数点数による3次元バウンディングボックス (GIDX)に変換されることになります。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a n-D float precision bounding box (GIDX) intersects a geometry's (cached) n-D bounding box.
ja: 単精度浮動小数点数によるn次元バウンディングボックス (GIDX)がジオメトリの (キャッシュされている)n次元バウンディングボックスとインタセクトする場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>&amp;&amp;&amp;</varname> operator returns <varname>TRUE</varname> if the n-D bounding box A intersects the cached n-D bounding box of geometry B, using float precision. This means that if A is a (double precision) box3d, it will be internally converted to a float precision 3D bounding box (GIDX)
ja: <varname>&amp;&amp;&amp;</varname>演算子は、n次元バウンディングボックスAが、ジオメトリBのキャッシュされたn次元バウンディングボックスとインタセクトする場合に、<varname>TRUE</varname>を返します。単精度浮動小数点数によるバウンディングボックスを使います。Aが倍精度浮動小数点数を使うbox3dである場合には、単精度浮動小数点数による3次元バウンディングボックス (GIDX)に変換されることになります。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if two n-D float precision bounding boxes (GIDX) intersect each other.
ja: 二つの単精度浮動小数点数によるn次元バウンディングボックス (GIDX)が相互にインタセクトする場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>&amp;&amp;&amp;</varname> operator returns <varname>TRUE</varname> if two n-D bounding boxes A and B intersect each other, using float precision. This means that if A (or B) is a (double precision) box3d, it will be internally converted to a float precision 3D bounding box (GIDX)
ja: <varname>&amp;&amp;&amp;</varname>演算子は、n次元バウンディングボックスAとBが相互にインタセクトする場合に、<varname>TRUE</varname>を返します。単精度浮動小数点数によるバウンディングボックスを使います。AまたはBが倍精度浮動小数点数を使うbox3dである場合には、単精度浮動小数点数による3次元バウンディングボックス (GIDX)に変換されることになります。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box overlaps or is to the left of B's.
ja: AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの左にある場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>&amp;&lt;</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A overlaps or is to the left of the bounding box of geometry B, or more accurately, overlaps or is NOT to the right of the bounding box of geometry B.
ja: <varname>&amp;&lt;</varname>演算子は、AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの左にある場合に<varname>TRUE</varname>を返します。条件についてより詳細に言うと、BのバウンディングボックスをオーバラップするかBのバウンディングボックスの右に*ない*場合です。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box overlaps or is below B's.
ja: AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの下にある場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>&amp;&lt;|</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A overlaps or is below of the bounding box of geometry B, or more accurately, overlaps or is NOT above the bounding box of geometry B.
ja: <varname>&amp;&lt;|</varname>演算子は、AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの下にある場合に<varname>TRUE</varname>を返します。条件についてより詳細に言うと、BのバウンディングボックスをオーバラップするかBのバウンディングボックスの上に*ない*場合です。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A' bounding box overlaps or is to the right of B's.
ja: AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの右にある場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>&amp;&gt;</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A overlaps or is to the right of the bounding box of geometry B, or more accurately, overlaps or is NOT to the left of the bounding box of geometry B.
ja: <varname>&amp;&gt;</varname>演算子は、AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの右にある場合に<varname>TRUE</varname>を返します。条件についてより詳細に言うと、BのバウンディングボックスをオーバラップするかBのバウンディングボックスの左に*ない*場合です。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is strictly to the left of B's.
ja: Aのバウンダリボックスが、厳密にBのバウンダリボックスの左にある場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>&lt;&lt;</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A is strictly to the left of the bounding box of geometry B.
ja: <varname>&lt;&lt;</varname>演算子はAのバウンダリボックスが、厳密にBのバウンダリボックスの左にある場合に<varname>TRUE</varname>を返します。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is strictly below B's.
ja: Aのバウンダリボックスが、厳密にBのバウンダリボックスの下にある場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>&lt;&lt;|</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A is strictly below the bounding box of geometry B.
ja: <varname>&lt;&lt;|</varname>演算子は、Aのバウンダリボックスが、厳密にBのバウンダリボックスの下にある場合に<varname>TRUE</varname>を返します。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if the coordinates and coordinate order geometry/geography A are the same as the coordinates and coordinate order of geometry/geography B.
ja: ジオメトリ/ジオグラフィ Aの座標と座標の並び順がジオメトリ/ジオグラフィ Bと同じ場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>&#61;</varname> operator returns <varname>TRUE</varname> if the coordinates and coordinate order geometry/geography A are the same as the coordinates and coordinate order of geometry/geography B. PostgreSQL uses the =, &lt;, and &gt; operators defined for geometries to perform internal orderings and comparison of geometries (ie. in a GROUP BY or ORDER BY clause).
ja: <varname>&#61;</varname>演算子は、ジオメトリ/ジオグラフィ Aの座標と座標の並び順がジオメトリ/ジオグラフィ Bと同じ場合に<varname>TRUE</varname>を返します。PostgreSQLは、ジオメトリの内部の順位付けと比較 (GROUP BYやORDER BY節などで使います)のために、ジオメトリ用に定義されている=, &lt;および&gt; 演算子を使います。

note: Tag: para
en: Only geometry/geography that are exactly equal in all respects, with the same coordinates, in the same order, are considered equal by this operator. For "spatial equality", that ignores things like coordinate order, and can detect features that cover the same spatial area with different representations, use <xref linkend="ST_OrderingEquals"/> or <xref linkend="ST_Equals"/>
ja: この演算子は、同じ座標値と並び順である、全ての点で確実に同じジオメトリ/ジオグラフィだけを同じと考えます。「空間的に等価」、つまり、並び順は無視し、異なる表現でも同じ空間領域を占めるかどうかをテストするには、<xref linkend="ST_OrderingEquals"/>または<xref linkend="ST_Equals"/>を使います。

note: Tag: para
en: This operand will NOT make use of any indexes that may be available on the geometries. For an index assisted exact equality test, combine &#61; with &amp;&amp;.
ja: この演算子は、ジオメトリで有効なインデックスを一切*使いません*。インデックスを使った確実な等価性試験を行うには、&#61;と&amp;&amp;を併用します。

note: Tag: para
en: Changed: 2.4.0, in prior versions this was bounding box equality not a geometric equality. If you need bounding box equality, use <xref linkend="ST_Geometry_Same"/> instead.
ja: Changed: 2.4.0, 以前の版では、ジオメトリ自体の等価性でなくバウンディングボックスが等価かどうかを見ていました。バウンディングボックスが等価かどうかを知る必要がある場合には、替わりに<xref linkend="ST_Geometry_Same"/>を使います。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is strictly to the right of B's.
ja: Aのバウンダリボックスが、厳密にBのバウンダリボックスの右にある場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>&gt;&gt;</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A is strictly to the right of the bounding box of geometry B.
ja: <varname>&gt;&gt;</varname>演算子は、Aのバウンダリボックスが、厳密にBのバウンダリボックスの右にある場合に<varname>TRUE</varname>を返します。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is contained by B's.
ja: AのバウンダリボックスがBのバウンダリボックスに含まれている場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>@</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A is completely contained by the bounding box of geometry B.
ja: <varname>@</varname>演算子は、AのバウンダリボックスがBのバウンダリボックスに、完全に含まれている場合に<varname>TRUE</varname>を返します。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a geometry's 2D bounding box is contained into a 2D float precision bounding box (BOX2DF).
ja: ジオメトリの2次元バウンディングボックスが単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)に包含される場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>@</varname> operator returns <varname>TRUE</varname> if the A geometry's 2D bounding box is contained the 2D bounding box B, using float precision. This means that if B is a (double precision) box2d, it will be internally converted to a float precision 2D bounding box (BOX2DF)
ja: <varname>@</varname>演算子は、ジオメトリAの2次元バウンディングボックスが、2次元バウンディングボックスBに包含される場合に、<varname>TRUE</varname>を返します。単精度浮動小数点数によるバウンディングボックスを使います。Bが倍精度浮動小数点数を使うbox2dである場合には、単精度浮動小数点数によるバウンディングボックス (BOX2DF)に変換されることになります。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a 2D float precision bounding box (BOX2DF) is contained into a geometry's 2D bounding box.
ja: 単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)がジオメトリの2次元バウンディングボックスに包含される場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>@</varname> operator returns <varname>TRUE</varname> if the 2D bounding box A is contained into the B geometry's 2D bounding box, using float precision. This means that if B is a (double precision) box2d, it will be internally converted to a float precision 2D bounding box (BOX2DF)
ja: <varname>@</varname>演算子は、2次元バウンディングボックスAが、ジオメトリBの2次元バウンディングボックスに包含される場合に、<varname>TRUE</varname>を返します。単精度浮動小数点数によるバウンディングボックスを使います。Aが倍精度浮動小数点数を使うbox2dである場合には、単精度浮動小数点数によるバウンディングボックス (BOX2DF)に変換されることになります。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a 2D float precision bounding box (BOX2DF) is contained into another 2D float precision bounding box.
ja: 二つの単精度浮動小数点数によるn次元バウンディングボックス (GIDX)の一方がもう一方を包含する場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>@</varname> operator returns <varname>TRUE</varname> if the 2D bounding box A is contained into the 2D bounding box B, using float precision. This means that if A (or B) is a (double precision) box2d, it will be internally converted to a float precision 2D bounding box (BOX2DF)
ja: <varname>@</varname>演算子は、2次元バウンディングボックスAが2次元バウンディングボックスBに包含される場合には、<varname>TRUE</varname>を返します。単精度浮動小数点数によるバウンディングボックスを使います。AまたはBが倍精度浮動小数点数を使うbox2dである場合には、単精度浮動小数点数によるバウンディングボックス (BOX2DF)に変換されることになります。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box overlaps or is above B's.
ja: AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの上にある場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>|&amp;&gt;</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A overlaps or is above the bounding box of geometry B, or more accurately, overlaps or is NOT below the bounding box of geometry B.
ja: <varname>|&amp;&gt;</varname>演算子は、AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの上にある場合に<varname>TRUE</varname>を返します。条件についてより詳細に言うと、BのバウンディングボックスをオーバラップするかBのバウンディングボックスの下に*ない*場合です。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is strictly above B's.
ja: Aのバウンダリボックスが、厳密にBのバウンダリボックスの上にある場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>|&gt;&gt;</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A is strictly above the bounding box of geometry B.
ja: <varname>|&gt;&gt;</varname>演算子は、Aのバウンダリボックスが、厳密にBのバウンダリボックスの上にある場合に<varname>TRUE</varname>を返します。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box contains B's.
ja: AのバウンディングボックスがBのバウンディングボックスを含む場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>~</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A completely contains the bounding box of geometry B.
ja: <varname>~</varname>演算子は、AのバウンディングボックスがBのバウンディングボックスを、完全に含む場合に<varname>TRUE</varname>を返します。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a geometry's 2D bonding box contains a 2D float precision bounding box (GIDX).
ja: ジオメトリの (キャッシュされている)2次元バウンディングボックスが単精度浮動小数点数によるn次元バウンディングボックス (GIDX)を包含する場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>~</varname> operator returns <varname>TRUE</varname> if the 2D bounding box of a geometry A contains the 2D bounding box B, using float precision. This means that if B is a (double precision) box2d, it will be internally converted to a float precision 2D bounding box (BOX2DF)
ja: <varname>~</varname>演算子は、ジオメトリAの2次元バウンディングボックスが、2次元バウンディングボックスBを包含する場合に、<varname>TRUE</varname>を返します。単精度浮動小数点数によるバウンディングボックスを使います。Bが倍精度浮動小数点数を使うbox2dである場合には、単精度浮動小数点数によるバウンディングボックス (BOX2DF)に変換されることになります。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a 2D float precision bounding box (BOX2DF) contains a geometry's 2D bonding box.
ja: 単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)をジオメトリの (キャッシュされている)2次元バウンディングボックスが包含する場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>~</varname> operator returns <varname>TRUE</varname> if the 2D bounding box A contains the B geometry's bounding box, using float precision. This means that if A is a (double precision) box2d, it will be internally converted to a float precision 2D bounding box (BOX2DF)
ja: <varname>~</varname>演算子は、2次元バウンディングボックスAが、ジオメトリBの2次元バウンディングボックスを包含する場合に、<varname>TRUE</varname>を返します。単精度浮動小数点数によるバウンディングボックスを使います。Aが倍精度浮動小数点数を使うbox2dである場合には、単精度浮動小数点数によるバウンディングボックス (BOX2DF)に変換されることになります。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if a 2D float precision bounding box (BOX2DF) contains another 2D float precision bounding box (BOX2DF).
ja: 二つの単精度浮動小数点数による2次元バウンディングボックス (BOX2DF)の一方がもう一方を包含する場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>~</varname> operator returns <varname>TRUE</varname> if the 2D bounding box A contains the 2D bounding box B, using float precision. This means that if A is a (double precision) box2d, it will be internally converted to a float precision 2D bounding box (BOX2DF)
ja: <varname>~</varname>演算子は、2次元バウンディングボックスAが、2次元バウンディングボックスBを包含する場合に、<varname>TRUE</varname>を返します。単精度浮動小数点数によるバウンディングボックスを使います。AまたはBが倍精度浮動小数点数を使うbox2dである場合には、単精度浮動小数点数によるバウンディングボックス (BOX2DF)に変換されることになります。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is the same as B's.
ja: AのバウンディングボックスがBのバウンディングボックスと同じ場合に <varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>~=</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry/geography A is the same as the bounding box of geometry/geography B.
ja: <varname>~=</varname>演算子はジオメトリ/ジオグラフィAのバウンディングボックスがジオメトリ/ジオグラフィBのバウンディングボックスと同じ場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: Availability: 1.5.0 changed behavior
ja: Availability: 1.5.0 挙動が変更されました

note: Tag: para
en: This operator has changed behavior in PostGIS 1.5 from testing for actual geometric equality to only checking for bounding box equality. To complicate things it also depends on if you have done a hard or soft upgrade which behavior your database has. To find out which behavior your database has you can run the query below. To check for true equality use <xref linkend="ST_OrderingEquals"/> or <xref linkend="ST_Equals"/>.
ja: この演算子の挙動はPostGIS 1.5で、実際のジオメトリとしての等価性のテストから、バウンディングボックスの等価性のテストに変更されました。ハードアップグレードまたはソフトアップグレードを実行している場合は、データベースがどの挙動を持つかに動作が依存して、ややこしくなります。データベースがどの挙動を持つか判断するために、下のクエリを実行することができます。本当の等価性をチェックするには<xref linkend="ST_OrderingEquals"/>または <xref linkend="ST_Equals"/>を使用します。

note: Tag: title
en: Distance Operators
ja: 距離演算子

note: Tag: refpurpose
en: Returns the 2D distance between A and B.
ja: AとBの2次元距離を返します。

note: Tag: para
en: The <varname>&lt;-&gt;</varname> operator returns the 2D distance between two geometries. Used in the "ORDER BY" clause provides index-assisted nearest-neighbor result sets. For PostgreSQL below 9.5 only gives centroid distance of bounding boxes and for PostgreSQL 9.5+, does true KNN distance search giving true distance between geometries, and distance sphere for geographies.
ja: <varname>&lt;-&gt;</varname>演算子は二つのジオメトリの2次元距離を返します。"ORDER BY"句内で使われ、インデックスの援助を受けた近傍結果集合を提供します。PostgreSQL 9.5より前では、バウンディングボックスの中心距離を出すだけでしたが、PostgreSQL 9.5以上では、ジオメトリ間の本当の距離が与えられた本当のKNN距離検索を行います。ジオグラフィでは球面上の距離を計算します。

note: Tag: para
en: This operand will make use of 2D GiST indexes that may be available on the geometries. It is different from other operators that use spatial indexes in that the spatial index is only used when the operator is in the ORDER BY clause.
ja: これのオペランドはジオメトリで利用できるインデックスを使用します。他の演算子との相違点は、ORDER BY句でのみインデックスが使用される点です。

note: Tag: para
en: Index only kicks in if one of the geometries is a constant (not in a subquery/cte). e.g. 'SRID=3005;POINT(1011102 450541)'::geometry instead of a.geom
ja: ジオメトリのひとつが定数となる (副問い合わせ/共通テーブル式にない)場合 (a.geomでなく'SRID=3005;POINT(1011102 450541)'::geometry等となる場合)には、インデックスが有効になるだけです。

note: Tag: para
en: Refer to <link xlink:href="https://postgis.net/workshops/postgis-intro/knn.html">PostGIS workshop: Nearest-Neighbor Searching</link> for a detailed example.
ja: 詳細な例については<link xlink:href="http://workshops.opengeo.org/postgis-intro/knn.html">OpenGeo workshop: Nearest-Neighbour Searching</link>を参照して下さい。

note: Tag: para
en: Enhanced: 2.2.0 -- True KNN ("K nearest neighbor") behavior for geometry and geography for PostgreSQL 9.5+. Note for geography KNN is based on sphere rather than spheroid. For PostgreSQL 9.4 and below, geography support is new but only supports centroid box.
ja: Enhanced: 2.2.0 ジオメトリとジオグラフィとのKNN (k近傍法)の動作が本当のものになりました。ジオグラフィのKNNは回転楕円体面上でなく球面上の計算となることに注意して下さい。PostgreSQL 9.4以下では、ジオグラフィに対応していますが、バウンディングボックスの重心に対応するだけです。

note: Tag: para
en: Changed: 2.2.0 -- For PostgreSQL 9.5 users, old Hybrid syntax may be slower, so you'll want to get rid of that hack if you are running your code only on PostGIS 2.2+ 9.5+. See examples below.
ja: Changed: 2.2.0 PostgreSQL 9.5では、古いハイブリッド書式は遅くなりる可能性があります。そのため、PostGIS 2.2以上かつPostgreSQL 9.5以上においてのみ動作させる場合には、そのやり方をり除きたくなるでしょう。

note: Tag: para
en: Availability: 2.0.0 -- Weak KNN provides nearest neighbors based on geometry centroid distances instead of true distances. Exact results for points, inexact for all other types. Available for PostgreSQL 9.1+
ja: Availability: 2.0.0 弱いKNNによって、実際の距離の代わりにジオメトリの重心による近傍が得られます。ポイントは確実な結果を得て、他のタイプは全て不確実な結果を得ます。PostgreSQL 9.1以上で有効です。

note: Tag: para
en: Then the KNN raw answer:
ja: KNNの生の答は次のとおりです。

note: Tag: para
en: If you run "EXPLAIN ANALYZE" on the two queries you would see a performance improvement for the second.
ja: 二つのクエリで"EXPLAIN ANALYZE"を実行すると、二つ目で速度が改善したことが分かります。

note: Tag: para
en: For users running with PostgreSQL &lt; 9.5, use a hybrid query to find the true nearest neighbors. First a CTE query using the index-assisted KNN, then an exact query to get correct ordering:
ja: PostgreSQL 9.5未満では、実際の近傍を発見するために、ハイブリッドのクエリを使います。最初にインデックスを用いたKNNを使って共通テーブル式 (CTE)クエリを行い、正しい順序を得る確実なクエリを実行します。

note: Tag: refpurpose
en: Returns the distance between A and B trajectories at their closest point of approach.
ja: AトラジェクトリとBトラジェクトリとの最接近する時の距離を返します。

note: Tag: para
en: The <varname>|=|</varname> operator returns the 3D distance between two trajectories (See <xref linkend="ST_IsValidTrajectory"/>). This is the same as <xref linkend="ST_DistanceCPA"/> but as an operator it can be used for doing nearest neighbor searches using an N-dimensional index (requires PostgreSQL 9.5.0 or higher).
ja: <varname>|=|</varname>演算子は二つのトラジェクトリの3次元距離を返します (<xref linkend="ST_IsValidTrajectory"/>を参照して下さい)。これは、<xref linkend="ST_DistanceCPA"/>と同じですが、N次元インデックスを使った近傍探索 (PostgreSQL 9.5.0以上)で使われる演算子です。

note: Tag: para
en: This operand will make use of ND GiST indexes that may be available on the geometries. It is different from other operators that use spatial indexes in that the spatial index is only used when the operator is in the ORDER BY clause.
ja: この演算子は、ジオメトリで使用可能なND GiST (n次元GiST)インデックスを使用します。他の空間インデックスを使う演算子と違い、ORDER BY句でのみ空間インデックスを使います。

note: Tag: para
en: Index only kicks in if one of the geometries is a constant (not in a subquery/cte). e.g. 'SRID=3005;LINESTRINGM(0 0 0,0 0 1)'::geometry instead of a.geom
ja: ジオメトリのひとつが定数となる (副問い合わせ/共通テーブル式にない)場合 (a.geomでなく'SRID=3005;LINESTRINGM(0 0 0,0 0 1)'::geometry等となる場合)には、インデックスが有効になるだけです。

note: Tag: para
en: Availability: 2.2.0. Index-supported only available for PostgreSQL 9.5+
ja: Availability:: 2.2.0 インデックス対応はPostgreSQL 9.5以上でのみ有効です。

note: Tag: refpurpose
en: Returns the 2D distance between A and B bounding boxes.
ja: AのバウンディングボックスとBのバウンディングボックスの2次元距離を返します。

note: Tag: para
en: The <varname>&lt;#&gt;</varname> operator returns distance between two floating point bounding boxes, possibly reading them from a spatial index (PostgreSQL 9.1+ required). Useful for doing nearest neighbor <emphasis role="strong">approximate</emphasis> distance ordering.
ja: <varname>&lt;#&gt;</varname>演算子は二つの浮動小数点数によるバウンディングボックス間の距離を返します。可能なら空間インデックス (PostgreSQL 9.1以上が必要です)を読みます。近傍の<emphasis role="strong">概ねの</emphasis>距離による並び替えに使います。

note: Tag: para
en: This operand will make use of any indexes that may be available on the geometries. It is different from other operators that use spatial indexes in that the spatial index is only used when the operator is in the ORDER BY clause.
ja: これのオペランドはジオメトリで利用できるインデックスを使用します。他の演算子との相違点は、ORDER BY句でのみインデックスが使用される点です。

note: Tag: para
en: Index only kicks in if one of the geometries is a constant e.g. ORDER BY (ST_GeomFromText('POINT(1 2)') &lt;#&gt; geom) instead of g1.geom &lt;#&gt;.
ja: ジオメトリのひとつがg1.geom &lt;#&gt;と違って ORDER BY (ST_GeomFromText('POINT(1 2)') &lt;#&gt; geom)というように定数である場合には、インデックスが有効になるだけです。

note: Tag: para
en: Availability: 2.0.0 -- KNN only available for PostgreSQL 9.1+
ja: Availability: 2.0.0 PostgreSQL 9.1以上でのみ有効です。

note: Tag: refpurpose
en: Returns the n-D distance between the A and B geometries or bounding boxes
ja: AとBの間またはそれらのバウンディングボックスの間のn次元距離を返します

note: Tag: para
en: The <varname>&lt;&lt;-&gt;&gt;</varname> operator returns the n-D (euclidean) distance between the centroids of the bounding boxes of two geometries. Useful for doing nearest neighbor <emphasis role="strong">approximate</emphasis> distance ordering.
ja: <varname>&lt;&lt;-&gt;&gt;</varname>演算子は、二つのジオメトリのバウンディングボックスの重心のn次元 (ユークリッド)距離を返します。近傍の<emphasis role="strong">概ねの</emphasis>距離による並び替えに使います。

note: Tag: para
en: This operand will make use of n-D GiST indexes that may be available on the geometries. It is different from other operators that use spatial indexes in that the spatial index is only used when the operator is in the ORDER BY clause.
ja: これのオペランドはジオメトリで利用できるインデックスを使用します。他の演算子との相違点は、ORDER BY句でのみインデックスが使用される点です。

note: Tag: para
en: Availability: 2.2.0 -- KNN only available for PostgreSQL 9.1+
ja: Availability: 2.0.0 KNNはPostgreSQL 9.1以上でのみ有効です。

note: Tag: title
en: Geometry Output
ja: ジオメトリ出力

note: Tag: para
en: These functions convert geometry objects into various textual or binary formats.
ja: これらの関数は、ジオメトリオブジェクトを様々な文字列形式やバイナリ形式に変換するものです。

note: Tag: refpurpose
en: Return the Well-Known Text (WKT) representation of the geometry with SRID meta data.
ja: ジオメトリのSRIDメタデータが付いたWell-Known Text (WKT)表現を返します。

note: Tag: para
en: Returns the Well-Known Text representation of the geometry prefixed with the SRID. The optional <parameter>maxdecimaldigits</parameter> argument may be used to reduce the maximum number of decimal digits after floating point used in output (defaults to 15).
ja: SRIDを前に置いたジオメトリのWell-Known Text表現を返します。任意引数<parameter>maxdecimaldigits</parameter>で、出力で使用される小数点以下の最大桁数を減らすことができます (デフォルトは15です)。

note: Tag: para
en: To perform the inverse conversion of EWKT representation to PostGIS geometry use <xref linkend="ST_GeomFromEWKT"/>.
ja: EWKT表現をPostGISジオメトリに逆変換するには<xref linkend="ST_GeomFromEWKT"/>を使用します。

note: Tag: para
en: Using the <parameter>maxdecimaldigits</parameter> parameter can cause output geometry to become invalid. To avoid this use <xref linkend="ST_ReducePrecision"/> with a suitable gridsize first.
ja: 任意引数<parameter>maxdecimaldigits</parameter>を使用することで、出力ジオメトリが不正になる可能性があります。これを回避するには、前もって<xref linkend="ST_ReducePrecision"/>に適切なグリッドサイズを与えてこれを使用します。

note: Tag: para
en: The WKT spec does not include the SRID. To get the OGC WKT format use <xref linkend="ST_AsText"/>.
ja: WKT仕様はSRIDを含みません。OGC WKT書式を得るには<xref linkend="ST_AsText"/>を使用します。

note: Tag: para
en: WKT format does not maintain precision so to prevent floating truncation, use <xref linkend="ST_AsBinary"/> or <xref linkend="ST_AsEWKB"/> format for transport.
ja: WKT書式は精度を維持しないので、切り捨てを防ぐには、データ転送に<xref linkend="ST_AsBinary"/>または<xref linkend="ST_AsEWKB"/>を使用します。

note: Tag: para
en: Enhanced: 3.1.0 support for optional precision parameter.
ja: Enhanced: 3.1.0 精度パラメータ (任意)に対応しました。

note: Tag: para
en: Enhanced: 2.0.0 support for Geography, Polyhedral surfaces, Triangles and TIN was introduced.
ja: Enhanced: 2.0.0 ジオグラフィ対応、多面体サーフェス対応、三角形対応、TIN対応が導入されました。

note: Tag: refpurpose
en: Return the Well-Known Text (WKT) representation of the geometry/geography without SRID metadata.
ja: ジオメトリ/ジオグラフィのSRIDメタデータのないWell-Known Text (WKT)表現を返します。

note: Tag: para
en: Returns the OGC <link linkend="OpenGISWKBWKT">Well-Known Text</link> (WKT) representation of the geometry/geography. The optional <parameter>maxdecimaldigits</parameter> argument may be used to limit the number of digits after the decimal point in output ordinates (defaults to 15).
ja: ジオメトリ/ジオグラフィの<link linkend="OpenGISWKBWKT">Well-Known Text</link> (WKT)表現を返します。任意引数<parameter>maxdecimaldigits</parameter>は、出力で使われる小数点以下の最大桁数を制限するのに使います (デフォルトは15)。

note: Tag: para
en: To perform the inverse conversion of WKT representation to PostGIS geometry use <xref linkend="ST_GeomFromText"/>.
ja: ＷKT表現をPostGISジオメトリに逆変換するには<xref linkend="ST_GeomFromText"/>を使います。

note: Tag: para
en: The standard OGC WKT representation does not include the SRID. To include the SRID as part of the output representation, use the non-standard PostGIS function <xref linkend="ST_AsEWKT"/>
ja: 標準のOGC WKT表現はSRIDを含みません。出力表現にSRIDを持たせるには、非標準のPostGIS関数<xref linkend="ST_AsEWKT"/>を使います。

note: Tag: para
en: The textual representation of numbers in WKT may not maintain full floating-point precision. To ensure full accuracy for data storage or transport it is best to use <link linkend="OpenGISWKBWKT">Well-Known Binary</link> (WKB) format (see <xref linkend="ST_AsBinary"/> and <parameter>maxdecimaldigits</parameter>).
ja: WKTにおける数字の文字表現では、完全な浮動小数点数の精度を維持しないことがあります。データ保存や転送で完全な精度を得るには<link linkend="OpenGISWKBWKT">Well-Known Binary</link> (WKB)書式を使用するのが最善です (<xref linkend="ST_AsBinary"/>および<parameter>maxdecimaldigits</parameter>をご覧下さい)。

note: Tag: para
en: Availability: 1.5 - support for geography was introduced.
ja: Availability: 1.5 - ジオグラフィ対応が導入されました。

note: Tag: para
en: Enhanced: 2.5 - optional parameter precision introduced.
ja: Enhanced: 2.5 - 精度の任意引数が導入されました。

note: Tag: para
en: Full precision output is the default.
ja: 完全な出力制度がデフォルトです。

note: Tag: para
en: The <parameter>maxdecimaldigits</parameter> argument can be used to limit output precision.
ja: 引数<parameter>maxdecimaldigits</parameter>は、出力精度の制限に使います。

note: Tag: refpurpose
en: Return the OGC/ISO Well-Known Binary (WKB) representation of the geometry/geography without SRID meta data.
ja: ジオメトリ/ジオグラフィの、SRIDメタデータを持たないOGC/ISO Well-Knownバイナリ (WKB)表現を返します。

note: Tag: para
en: Returns the OGC/ISO <link linkend="OpenGISWKBWKT">Well-Known Binary</link> (WKB) representation of the geometry. The first function variant defaults to encoding using server machine endian. The second function variant takes a text argument specifying the endian encoding, either little-endian ('NDR') or big-endian ('XDR').
ja: ジオメトリのOGC/ISO<link linkend="OpenGISWKBWKT">Well-Knownバイナリ</link> (WKB)表現を返します。最初の形式では、サーバ機のエンディアンをデフォルトとして使います。二つ目の形式では、リトルエンディアン ('NDR')またはビッグエンディアン ('XDR')を指定する文字列を取ります。

note: Tag: para
en: WKB format is useful to read geometry data from the database and maintaining full numeric precision. This avoids the precision rounding that can happen with text formats such as WKT.
ja: WKB書式は、ジオメトリデータをデータベースから、完全な数値精度を維持して読み取るために使われます。これにより、WKT等のテキスト書式で発生する丸め誤差を回避できます。

note: Tag: para
en: To perform the inverse conversion of WKB to PostGIS geometry use <xref linkend="ST_GeomFromWKB"/>.
ja: ＷKB表現をPostGISジオメトリに逆変換するには<xref linkend="ST_GeomFromWKB"/>を使います。

note: Tag: para
en: The OGC/ISO WKB format does not include the SRID. To get the EWKB format which does include the SRID use <xref linkend="ST_AsEWKB"/>
ja: OGC/ISO WKB書式はSRIDを持ちません。SRIDを含むEWKB書式を得るには<xref linkend="ST_AsEWKB"/>を使います。

note: Tag: para
en: The default behavior in PostgreSQL 9.0 has been changed to output bytea in hex encoding. If your GUI tools require the old behavior, then SET bytea_output='escape' in your database.
ja: PostgreSQL 9.0でのデフォルトの振る舞いが変更され、出力がbytea型の16進数エンコーディングなりました。GUIツールで古い振る舞いが必要な場合には、データベース内で SET bytea_output='escape' を実行します。

note: Tag: para
en: Enhanced: 2.0.0 support for higher coordinate dimensions was introduced.
ja: Enhanced: 2.0.0 高次元が導入されました。

note: Tag: para
en: Enhanced: 2.0.0 support for specifying endian with geography was introduced.
ja: Enhanced: 2.0.0 ジオグラフィでのエンディアン指定が導入されました。

note: Tag: para
en: Availability: 1.5.0 geography support was introduced.
ja: Availability: 1.5.0 ジオグラフィが導入されました。

note: Tag: para
en: Changed: 2.0.0 Inputs to this function can not be unknown -- must be geometry. Constructs such as <code>ST_AsBinary('POINT(1 2)')</code> are no longer valid and you will get an <code>n st_asbinary(unknown) is not unique error</code>. Code like that needs to be changed to <code>ST_AsBinary('POINT(1 2)'::geometry);</code>. If that is not possible, then install <filename>legacy.sql</filename>.
ja: Changed: 2.0.0 この関数への入力は不明な型にすることができなくなり、必ずジオメトリでなければなりません。<code>ST_AsBinary('POINT(1 2)')</code>といった構築ではもはや妥当ではなく、<code>n st_asbinary(unknown) is not unique error</code>が得られます。このようなコードは<code>ST_AsBinary('POINT(1 2)'::geometry);</code>に変更する必要があります。これが不可能な場合には<filename>legacy.sql</filename>をインストールして下さい。

note: Tag: refpurpose
en: Return the Extended Well-Known Binary (EWKB) representation of the geometry with SRID meta data.
ja: ジオメトリの、SRIDメタデータを持つExtended Well-Knownバイナリ (EWKB)表現を返します。

note: Tag: para
en: Returns the <link linkend="EWKB_EWKT">Extended Well-Known Binary</link> (EWKB) representation of the geometry with SRID metadata. The first function variant defaults to encoding using server machine endian. The second function variant takes a text argument specifying the endian encoding, either little-endian ('NDR') or big-endian ('XDR').
ja: ジオメトリの、SRIDメタデータを持つ<link linkend="EWKB_EWKT">Extended Well-Knownバイナリ</link> (EWKB)表現を返します。最初の形式では、サーバ機のエンディアンをデフォルトとして使います。二つ目の形式では、リトルエンディアン ('NDR')またはビッグエンディアン ('XDR')を指定する文字列を取ります。

note: Tag: para
en: To perform the inverse conversion of EWKB to PostGIS geometry use <xref linkend="ST_GeomFromEWKB"/>.
ja: EＷKB表現をPostGISジオメトリに逆変換するには<xref linkend="ST_GeomFromEWKB"/>を使います。

note: Tag: para
en: To get the OGC/ISO WKB format use <xref linkend="ST_AsBinary"/>. Note that OGC/ISO WKB format does not include the SRID.
ja: OGC/ISO WKB書式を得るには<xref linkend="ST_AsBinary"/>を使います。OGC/ISO WKB書式はSRIDを持たないことに注意して下さい。

note: Tag: refpurpose
en: Returns a Geometry in HEXEWKB format (as text) using either little-endian (NDR) or big-endian (XDR) encoding.
ja: ジオメトリのHEXEWKB表現を (文字列として)返します。リトルエンディアン (NDR)またはビッグエンディアン (XDR)のどちらかのエンコーディングを使います。

note: Tag: para
en: Returns a Geometry in HEXEWKB format (as text) using either little-endian (NDR) or big-endian (XDR) encoding. If no encoding is specified, then NDR is used.
ja: ジオメトリのHEXEWKB表現を (文字列として)返します。リトルエンディアン (NDR)またはビッグエンディアン (XDR)のどちらかのエンコーディングを使います。エンコーディングを指定しない場合はNDRを使います。

note: Tag: refpurpose
en: Returns an Encoded Polyline from a LineString geometry.
ja: ラインストリングジオメトリから符号化したポリラインを返します。

note: Tag: para
en: Returns the geometry as an Encoded Polyline. This format is used by Google Maps with precision=5 and by Open Source Routing Machine with precision=5 and 6.
ja: 符号化したポリラインを返します。この書式はGoogle Mapsではprecision=5で、Open Source Routing Machineでは precision=5と6を使います。

note: Tag: para
en: Basic
ja: 基本

note: Tag: para
en: Use in conjunction with geography linestring and geography segmentize, and put on google maps
ja: ジオグラフィ型のラインストリングとジオグラフィ型のセグメント化したラインストリングを結合してGoogle Mapsに置きます。

note: Tag: para
en: javascript will look something like this where $ variable you replace with query result
ja: JavaScriptコードは、クエリの結果を$変数と置き換えると次のようになります。

note: Tag: refpurpose
en: Return a FlatGeobuf representation of a set of rows.
ja: 行の集合のFlatGeobuf表現を返します。

note: Tag: para
en: Return a FlatGeobuf representation (<link xlink:href="http://flatgeobuf.org">http://flatgeobuf.org</link>) of a set of rows corresponding to a FeatureCollection. NOTE: PostgreSQL bytea cannot exceed 1GB.
ja: FeatureCollectionに対応する行の集合のFlatGeobuf表現 (<link xlink:href="http://flatgeobuf.org">http://flatgeobuf.org</link>) を返します。ご注意: PostgreSQLのbytea型は1GBを超えられません。

note: Tag: para
en: <varname>row</varname> row data with at least a geometry column.
ja: <varname>row</varname> 少なくとも一つのジオメトリカラムを持つ行データ。

note: Tag: para
en: <varname>index</varname> toggle spatial index creation. Default is false.
ja: <varname>index</varname> 空間インデックスの生成の切り替え。デフォルトはFALSEです。

note: Tag: para
en: <varname>geom_name</varname> is the name of the geometry column in the row data. If NULL it will default to the first found geometry column.
ja: <varname>geom_name</varname> 行データにおけるジオメトリカラムのカラム名。NULLの場合には、最初に見つけたジオメトリカラムとします。

note: Tag: refpurpose
en: Return a Geobuf representation of a set of rows.
ja: 行集合のGeobuf表現を返します。

note: Tag: para
en: Return a Geobuf representation (<link xlink:href="https://github.com/mapbox/geobuf">https://github.com/mapbox/geobuf</link>) of a set of rows corresponding to a FeatureCollection. Every input geometry is analyzed to determine maximum precision for optimal storage. Note that Geobuf in its current form cannot be streamed so the full output will be assembled in memory.
ja: FeatureCollectionに対応する行集合のGeobuf表現 (<link xlink:href="https://github.com/mapbox/geobuf">https://github.com/mapbox/geobuf</link>)を返します。最適な格納のために最大精度を決定しますが、そのために全ての入力ジオメトリは解析されます。現在の形式でのGeobufはストリーム化できないので、完全な出力はメモリ内で組み立てられることに注意して下さい。

note: Tag: refpurpose
en: Return a geometry or feature in GeoJSON format.
ja: GeoJSON形式のジオメトリまたは地物を返します。

note: Tag: para
en: Returns a geometry as a GeoJSON "geometry" object, or a row as a GeoJSON "feature" object.
ja: ジオメトリについてはGeoJSONの"geometry"オブジェクトとして返し、行についてGeoJSONの"feature"オブジェクトとして返します。

note: Tag: para
en: The resulting GeoJSON geometry and feature representations conform with the <link xlink:href="https://tools.ietf.org/html/rfc7946">GeoJSON specifications RFC 7946</link>, except when the parsed geometries are referenced with a CRS other than WGS84 longitude and latitude (<link xlink:href="https://epsg.io/4326">EPSG:4326</link>, <link xlink:href="http://epsg.io/4326.gml">urn:ogc:def:crs:OGC::CRS84</link>); the GeoJSON geometry object will then have a short CRS SRID identifier attached by default. 2D and 3D Geometries are both supported. GeoJSON only supports SFS 1.1 geometry types (no curve support for example).
ja: GeoJSONのジオメトリと地物の表現は、<link xlink:href="https://tools.ietf.org/html/rfc7946">GeoJSON specifications RFC 7946</link>に準拠しますが、入力ジオメトリのCRSががWGS84経度緯度 (<link xlink:href="https://epsg.io/4326">EPSG:4326</link>, <link xlink:href="http://epsg.io/4326.gml">urn:ogc:def:crs:OGC::CRS84</link>)以外の時は準拠しません。GeoJSONのgeometryオブジェクトに短いCRS SRID識別子がデフォルトで追加されます。2次元と3次元のジオメトリの両方に対応します。GeoJSONはSFS 1.1ジオメトリタイプにのみ対応します (たとえば曲線には対応していません)。

note: Tag: para
en: The <varname>geom_column</varname> parameter is used to distinguish between multiple geometry columns. If omitted, the first geometry column in the record will be determined. Conversely, passing the parameter will save column type lookups.
ja: <varname>geom_column</varname>パラメータは複数のジオメトリカラムを区別するために使われます。省略すると、レコードの最初のジオメトリカラムに決定されます。逆にパラメータを渡すとカラムの型の調査が省かれます。

note: Tag: para
en: The <varname>maxdecimaldigits</varname> argument may be used to reduce the maximum number of decimal places used in output (defaults to 9). If you are using EPSG:4326 and are outputting the geometry only for display, <varname>maxdecimaldigits</varname>=6 can be a good choice for many maps.
ja: <varname>maxdecimaldigits</varname>引数は、出力で使用される小数部の桁数の最大値を減らすために使われます (デフォルトでは9)。EPSG:4326を使っていて、表示専用でジオメトリを出力する場合には、<varname>maxdecimaldigits</varname>=6が、多くの地図で良い選択となります。

note: Tag: para
en: The <varname>options</varname> argument can be used to add BBOX or CRS in GeoJSON output:
ja: <varname>options</varname>引数は、GeoJSON出力でBBOXまたはCRSを追加するために使われます。次のようにします。

note: Tag: para
en: 0: means no option
ja: 0: オプションなし

note: Tag: para
en: 2: GeoJSON Short CRS (e.g EPSG:4326)
ja: 2: GeoJSON Short CRS (たとえば EPSG:4326)

note: Tag: para
en: 4: GeoJSON Long CRS (e.g urn:ogc:def:crs:EPSG::4326)
ja: 4: GeoJSON Long CRS (たとえば urn:ogc:def:crs:EPSG:4326)

note: Tag: para
en: 8: GeoJSON Short CRS if not EPSG:4326 (default)
ja: 8: EPSG:4326でない場合にGeoJSON Short CRS (デフォルト)

note: Tag: para
en: The <varname>id_column</varname> parameter is used to set the "id" member of the returned GeoJSON features. As per GeoJSON RFC, this SHOULD be used whenever a feature has a commonly used identifier, such as a primary key. When not specified, the produced features will not get an "id" member and any columns other than the geometry, including any potential keys, will just end up inside the feature’s "properties" member.
ja: <varname>id_column</varname>パラメータは、返されるGeoJSONの地物の"id"メンバの値設定に使われます。GeoJSON RFCによると、これは、主キーのように地物が共通して使用する識別子を持つときは常に*使うべき*とされています。指定しない場合には、生成される地物に"id"メンバが入りません。ジオメトリ以外のカラムは、潜在的なキーも含めて、地物の"properties"メンバ内に入ります。

note: Tag: para
en: The GeoJSON specification states that polygons are oriented using the Right-Hand Rule, and some clients require this orientation. This can be ensured by using <xref linkend="ST_ForcePolygonCCW"/>. The specification also requires that geometry be in the WGS84 coordinate system (SRID = 4326). If necessary geometry can be projected into WGS84 using <xref linkend="ST_Transform"/>: <code>ST_Transform( geom, 4326 )</code>.
ja: GeoJSON仕様では、ポリゴンは右手規則を使い、この方向を求めるクライアントがあります。これは<xref linkend="ST_ForcePolygonCCW"/>を使用して確実に対応します。仕様はまたジオメトリの座標系としてWGS84 (SRID=4326)が求められます。必要なら<xref linkend="ST_Transform"/>を<code>ST_Transform( geom, 4326 )</code>のように使って、ジオメトリをWGS84に座標変換します。

note: Tag: para
en: GeoJSON can be tested and viewed online at <link xlink:href="http://geojson.io/">geojson.io</link> and <link xlink:href="http://geojson.io/">geojsonlint.com</link>. It is widely supported by web mapping frameworks:
ja: GeoJSONは<link xlink:href="http://geojson.io/">geojson.io</link>と <link xlink:href="http://geojson.io/">geojsonlint.com</link>で、オンラインでのテストと表示が可能です。また、Webマッピングフレームワークで広く対応されています。

note: Tag: link
en: OpenLayers GeoJSON Example
ja: OpenLayers GeoJSONの例

note: Tag: link
en: Leaflet GeoJSON Example
ja: Leaflet GeoJSONの例

note: Tag: link
en: Mapbox GL GeoJSON Example
ja: Mapbox GL GeoJSONの例

note: Tag: para
en: Changed: 2.0.0 support default args and named args.
ja: Changed: 2.0.0 デフォルト引数と名前付き引数に対応しました。

note: Tag: para
en: Changed: 3.0.0 support records as input
ja: Changed: 3.0.0 レコードの入力に対応しました

note: Tag: para
en: Changed: 3.0.0 output SRID if not EPSG:4326.
ja: Changed: 3.0.0 EPSG:4326以外の場合のSRID出力。

note: Tag: para
en: Changed: 3.5.0 allow specifying the column containing the feature id
ja: Changed: 3.5.0 地物のidを含むカラムを指定できるようになりました

note: Tag: para
en: Generate a FeatureCollection:
ja: FeatureCollectionの生成:

note: Tag: para
en: Generate a Feature:
ja: Featureの生成:

note: Tag: para
en: Don't forget to transform your data to WGS84 longitude, latitude to conform with the GeoJSON specification:
ja: データをGeoJSON使用に準拠したWGS84経度緯度に変換するのを忘れないで下さい。

note: Tag: para
en: 3D geometries are supported:
ja: 3次元ジオメトリへの対応:

note: Tag: para
en: Options argument can be used to add BBOX and CRS in GeoJSON output:
ja: Options引数は、GeoJSON出力でBBOXまたはCRSを追加するために使われます:

note: Tag: refpurpose
en: Return the geometry as a GML version 2 or 3 element.
ja: GML第2版または第3版としてジオメトリを返します。

note: Tag: para
en: Return the geometry as a Geography Markup Language (GML) element. The version parameter, if specified, may be either 2 or 3. If no version parameter is specified then the default is assumed to be 2. The <varname>maxdecimaldigits</varname> argument may be used to reduce the maximum number of decimal places used in output (defaults to 15).
ja: Geography Markup Language (GML)要素としてジオメトリを返します。versionパラメータは、指定する場合には2か3になります。versionパラメータが無い場合には、デフォルトは2です。<varname>maxdecimaldigits</varname>引数は出力に使用する小数点以下桁数 (デフォルトは15です)の最大値を減らすために使えます。

note: Tag: para
en: GML 2 refer to 2.1.2 version, GML 3 to 3.1.1 version
ja: GML2では2.1.2版を参照し、GML3では3.1.1を参照します。

note: Tag: para
en: The 'options' argument is a bitfield. It could be used to define CRS output type in GML output, and to declare data as lat/lon:
ja: 最後の'options'引数はビットフィールドです。GML出力のCRS出力型を定義するために、また緯度/経度でデータを宣言するために使います。

note: Tag: para
en: 0: GML Short CRS (e.g EPSG:4326), default value
ja: 0: GML Short CRS (たとえば EPSG:4326)、デフォルト値

note: Tag: para
en: 1: GML Long CRS (e.g urn:ogc:def:crs:EPSG::4326)
ja: 1: GML Long CRS (たとえば urn:ogc:def:crs:EPSG:4326)

note: Tag: para
en: 2: For GML 3 only, remove srsDimension attribute from output.
ja: 2: GML 3のみ対応。srsDimension属性を出力から削除します。

note: Tag: para
en: 4: For GML 3 only, use &lt;LineString&gt; rather than &lt;Curve&gt; tag for lines.
ja: 4: GML 3のみ対応。線について&lt;Curve&gt;でなく&lt;LineString&gt;要素を使います。

note: Tag: para
en: 16: Declare that data are lat/lon (e.g srid=4326). Default is to assume that data are planars. This option is useful for GML 3.1.1 output only, related to axis order. So if you set it, it will swap the coordinates so order is lat lon instead of database lon lat.
ja: 16: データは緯度/経度 (すなわち SRID=4326)です。デフォルトではデータは平面上にあると仮定します。このオプションはGML 3.1.1による出力でのみ使われ、軸のオーダに関連します。これを設定すると、座標の順序を入れ替えるので、データベースの経度/緯度の順でなく緯度/経度の順になります。

note: Tag: para
en: 32: Output the box of the geometry (envelope).
ja: 32: ジオメトリのボックス (エンベロープ)を出力します。

note: Tag: para
en: The 'namespace prefix' argument may be used to specify a custom namespace prefix or no prefix (if empty). If null or omitted 'gml' prefix is used
ja: 'namespace prefix'引数は、カスタム名前空間のプリフィクスを指定したり、名前空間プリフィクスを指定しない (空にした場合)ために使用します。NULLを指定するか省略した場合には、'gml'プレフィクスを使用します。

note: Tag: para
en: Enhanced: 2.0.0 prefix support was introduced. Option 4 for GML3 was introduced to allow using LineString instead of Curve tag for lines. GML3 Support for Polyhedral surfaces and TINS was introduced. Option 32 was introduced to output the box.
ja: Enhanced: 2.0.0 プレフィクスが導入されました。 GML 3用であるoptionsの4は、曲線のかわりにラインストリングを使えるようにするためのものです。GML 3の多面体サーフェスとTINが導入されました。optionsの32はボックスを出力するために導入されました。

note: Tag: para
en: Changed: 2.0.0 use default named args
ja: Changed: 2.0.0 デフォルトの名前付き引数を使います。

note: Tag: para
en: Enhanced: 2.1.0 id support was introduced, for GML 3.
ja: Enhanced: 2.1.0 GML 3用にidが導入されました。

note: Tag: para
en: Only version 3+ of ST_AsGML supports Polyhedral Surfaces and TINS.
ja: ST_AsGMLのGML 3版以上では多面体サーフェスとTINに対応しています。

note: Tag: title
en: Examples: Version 2
ja: 例: 2版

note: Tag: title
en: Examples: Version 3
ja: 例: 3版

note: Tag: refpurpose
en: Return the geometry as a KML element.
ja: ジオメトリをKML要素として返します。

note: Tag: para
en: Return the geometry as a Keyhole Markup Language (KML) element. default maximum number of decimal places is 15, default namespace is no prefix.
ja: ジオメトリをKeyhole Markup Language (KML)要素として返します。デフォルトの最大の小数点以下の桁数は15で、デフォルトの名前空間はプリフィクス無しです。

note: Tag: para
en: Requires PostGIS be compiled with Proj support. Use <xref linkend="PostGIS_Full_Version"/> to confirm you have proj support compiled in.
ja: PostGISがProj対応でコンパイルされている必要があります。<xref linkend="PostGIS_Full_Version"/>を使ってProj対応でコンパイルされているか確認して下さい。

note: Tag: para
en: Availability: 1.2.2 - later variants that include version param came in 1.3.2
ja: Availability: 1.2.2 - versionパラメータが付く形式は1.3.2からです。

note: Tag: para
en: Enhanced: 2.0.0 - Add prefix namespace, use default and named args
ja: Enhanced: 2.0.0 - プレフィクスの名前空間の追加、デフォルト値と名前付き引数の追加

note: Tag: para
en: Changed: 3.0.0 - Removed the "versioned" variant signature
ja: Changed: 3.0.0 - "version"の付いた形式の削除

note: Tag: para
en: AsKML output will not work with geometries that do not have an SRID
ja: AsKML出力はSRIDを持たないジオメトリでは動作しません。

note: Tag: refpurpose
en: Return the Degrees, Minutes, Seconds representation of the given point.
ja: 与えられたポイントの度・分・秒表現を返します。

note: Tag: para
en: Returns the Degrees, Minutes, Seconds representation of the point.
ja: ポイントの度・分・秒表現を返します。

note: Tag: para
en: It is assumed the point is in a lat/lon projection. The X (lon) and Y (lat) coordinates are normalized in the output to the "normal" range (-180 to +180 for lon, -90 to +90 for lat).
ja: 緯度/経度座標系のポイントを前提としています。X(経度)とY(緯度)座標系は「正常な」範囲 (経度は-180から180、緯度は-90から90)に正常化されます。

note: Tag: para
en: The text parameter is a format string containing the format for the resulting text, similar to a date format string. Valid tokens are "D" for degrees, "M" for minutes, "S" for seconds, and "C" for cardinal direction (NSEW). DMS tokens may be repeated to indicate desired width and precision ("SSS.SSSS" means " 1.0023").
ja: text引数は結果文字列のための書式を含む書式文字列です。日付書式文字列に近いものです。妥当なトークンは"D"が度、"M"が分、"S"が秒、"C" (cardinal direction)が4方位 (NSEW)です。DMSトークンは、求める幅と精度で示すために、繰り返せます ("SSS.SSSS"では" 1.0023"になります)。

note: Tag: para
en: "M", "S", and "C" are optional. If "C" is omitted, degrees are shown with a "-" sign if south or west. If "S" is omitted, minutes will be shown as decimal with as many digits of precision as you specify. If "M" is also omitted, degrees are shown as decimal with as many digits precision as you specify.
ja: "M"と"S"と"C"は必須ではありません。"C"が省略された場合には、南または西の場合には"-"符号がついたうえで、指定した精度で、度が表示されます。"M"も省略された場合には、指定した精度の桁数で十進の度が表示されます。

note: Tag: para
en: If the format string is omitted (or zero-length) a default format will be used.
ja: 書式文字列が省略された (または長さが0の)場合には、デフォルトの書式が使われます。

note: Tag: para
en: Default format.
ja: デフォルト書式。

note: Tag: para
en: Providing a format (same as the default).
ja: 書式を指定 (デフォルトと同じ)。

note: Tag: para
en: Characters other than D, M, S, C and . are just passed through.
ja: D, M, S, C以外の文字は通過するだけです。

note: Tag: para
en: Signed degrees instead of cardinal directions.
ja: 4方位文字でなく符号で示された度。

note: Tag: para
en: Decimal degrees.
ja: 十進の度。

note: Tag: para
en: Excessively large values are normalized.
ja: 過大な値が正常化されます。

note: Tag: refpurpose
en: Returns geometry as a MARC21/XML record with a geographic datafield (034).
ja: ジオメトリを、地理データフィールド (034)を持つMARC21/XMLデータとして返します。

note: Tag: para
en: This function returns a MARC21/XML record with <link xlink:href="https://www.loc.gov/marc/bibliographic/bd034.html">Coded Cartographic Mathematical Data</link> representing the bounding box of a given geometry. The <varname>format</varname> parameter allows to encode the coordinates in subfields <varname>$d</varname>,<varname>$e</varname>,<varname>$f</varname> and <varname>$g</varname> in all formats supported by the MARC21/XML standard. Valid formats are:
ja: この関数は与えられたジオメトリのバウンディングボックスを表現する<link xlink:href="https://www.loc.gov/marc/bibliographic/bd034.html">コード化地図数値データ</link>を持つMARC21/XMLのデータを返します。<varname>format</varname>パラメータを使うと、MARC21/XMLが対応する全てのフォーマットにおける<varname>$d</varname>、<varname>$e</varname>、<varname>$f</varname>、<varname>$g</varname>サブフィールド内の座標を符号化できます。妥当なフォーマットは次の通りです。

note: Tag: para
en: cardinal direction, degrees, minutes and seconds (default): <varname>hdddmmss</varname>
ja: 経緯度識別値、度、分、秒 (デフォルト): <varname>hdddmmss</varname>

note: Tag: para
en: decimal degrees with cardinal direction: <varname>hddd.dddddd</varname>
ja: 経緯度識別値付き十進の度: <varname>hddd.dddddd</varname>

note: Tag: para
en: decimal degrees without cardinal direction: <varname>ddd.dddddd</varname>
ja: 経緯度識別値なし十進の度: <varname>ddd.dddddd</varname>

note: Tag: para
en: decimal minutes with cardinal direction: <varname>hdddmm.mmmm</varname>
ja: 経緯度識別値付き十進の分: <varname>hdddmm.mmmm</varname>

note: Tag: para
en: decimal minutes without cardinal direction: <varname>dddmm.mmmm</varname>
ja: 経緯度識別値なし十進の分: <varname>dddmm.mmmm</varname>

note: Tag: para
en: decimal seconds with cardinal direction: <varname>hdddmmss.sss</varname>
ja: 経緯度識別値付き十進の秒: <varname>hdddmmss.sss</varname>

note: Tag: para
en: The decimal sign may be also a comma, e.g. <varname>hdddmm,mmmm</varname>.
ja: 小数点は<varname>hdddmm,mmmm</varname>のようにカンマでも構いません。

note: Tag: para
en: The precision of decimal formats can be limited by the number of characters after the decimal sign, e.g. <varname>hdddmm.mm</varname> for decimal minutes with a precision of two decimals.
ja: 10進数形式の精度は小数点以下の数字の数によって制限されます。十進の分で<varname>hdddmm.mm</varname>の場合には2桁の精度となります。

note: Tag: para
en: This function ignores the Z and M dimensions.
ja: この関数はZ値とM値を無視します。

note: Tag: para
en: This function does not support non lon/lat geometries, as they are not supported by the MARC21/XML standard (Coded Cartographic Mathematical Data).
ja: この関数は経度/緯度でないジオメトリには対応していません。MARC21/XML標準 (コード化地図数値データ)で対応していないためです。

note: Tag: para
en: The MARC21/XML Standard does not provide any means to annotate the spatial reference system for Coded Cartographic Mathematical Data, which means that this information will be lost after conversion to MARC21/XML.
ja: MARC21/XML標準では、コード化地図数値データに空間参照系情報を与えることはできません。これはMARC21/XMLへの変換で空間参照系情報が失われることを意味します。

note: Tag: para
en: Converting a <varname>POINT</varname> to MARC21/XML formatted as hdddmmss (default)
ja: <varname>POINT</varname>のhdddmmss (デフォルト)を使ったMARC21/XMLへの変換

note: Tag: para
en: Converting a <varname>POLYGON</varname> to MARC21/XML formatted in decimal degrees
ja: <varname>POLYGON</varname>の、十進の度を使ったMARC21/XMLへの変換

note: Tag: para
en: Converting a <varname>GEOMETRYCOLLECTION</varname> to MARC21/XML formatted in decimal minutes. The geometries order in the MARC21/XML output correspond to their order in the collection.
ja: <varname>GEOMETRYCOLLECTION</varname>の、十進の分を使ったMARC21/XMLへの変換。MARC21/XML出力のジオメトリの順序はコレクション内の順序に対応しています。

note: Tag: refpurpose
en: Transforms a geometry into the coordinate space of a MVT tile.
ja: ジオメトリをMVTタイルの座標空間に変換します。

note: Tag: para
en: Transforms a geometry into the coordinate space of a MVT (<link xlink:href="https://www.mapbox.com/vector-tiles/">Mapbox Vector Tile</link>) tile, clipping it to the tile bounds if required. The geometry must be in the coordinate system of the target map (using <xref linkend="ST_Transform"/> if needed). Commonly this is <link xlink:href="https://en.wikipedia.org/wiki/Web_Mercator_projection">Web Mercator</link> (SRID:3857).
ja: ジオメトリをMVT (<link xlink:href="https://www.mapbox.com/vector-tiles/">Mapbox Vector Tile</link>)タイルの座標空間に変換し、必要ならタイルの境界で切り抜きます。ジオメトリは対象地図の座標系でなければなりません (必要なら<xref linkend="ST_Transform"/>を使います)。一般にこれは<link xlink:href="https://en.wikipedia.org/wiki/Web_Mercator_projection">Web Mercator</link> (SRID:3857)です。

note: Tag: para
en: The function attempts to preserve geometry validity, and corrects it if needed. This may cause the result geometry to collapse to a lower dimension.
ja: この関数は、ジオメトリに妥当性を保持しようとし、必要なら修正します。これによって、結果ジオメトリが低い次元に落ちる可能性があります。

note: Tag: para
en: The rectangular bounds of the tile in the target map coordinate space must be provided, so the geometry can be transformed, and clipped if required. The bounds can be generated using <xref linkend="ST_TileEnvelope"/>.
ja: 対象地図の座標空間内のタイルを示す四角形の境界を与えなければなりません。ジオメトリが変換され、必要なら切り抜きます。境界は<xref linkend="ST_TileEnvelope"/>で生成できます。

note: Tag: para
en: This function is used to convert geometry into the tile coordinate space required by <xref linkend="ST_AsMVT"/>.
ja: この関数はジオメトリを<xref linkend="ST_AsMVT"/>が求める座標空間に変換するために使います。

note: Tag: para
en: <varname>geom</varname> is the geometry to transform, in the coordinate system of the target map.
ja: <varname>geom</varname>は変換するジオメトリで、対象地図の座標系です。

note: Tag: para
en: <varname>bounds</varname> is the rectangular bounds of the tile in map coordinate space, with no buffer.
ja: <varname>bounds</varname>は地図の座標空間内のタイルの四角形境界で、バッファはありません。

note: Tag: para
en: <varname>extent</varname> is the tile extent size in tile coordinate space as defined by the <link xlink:href="https://www.mapbox.com/vector-tiles/specification/">MVT specification</link>. Defaults to 4096.
ja: <varname>extent</varname>は<link xlink:href="https://www.mapbox.com/vector-tiles/specification/">MVT specification</link>で定義されるタイル座標空間でのタイルのサイズです。デフォルトは4096です。

note: Tag: para
en: <varname>buffer</varname> is the buffer size in tile coordinate space for geometry clippig. Defaults to 256.
ja: <varname>buffer</varname>は、ジオメトリの切り抜きを行うためのタイル座標空間におけるバッファサイズです。デフォルトは256です。

note: Tag: para
en: <varname>clip_geom</varname> is a boolean to control if geometries are clipped or encoded as-is. Defaults to true.
ja: <varname>clip_geom</varname>はジオメトリを切り抜くかそのままで符号化するかを制御する真偽値です。デフォルトはTRUEです。

note: Tag: para
en: From 3.0, Wagyu can be chosen at configure time to clip and validate MVT polygons. This library is faster and produces more correct results than the GEOS default, but it might drop small polygons.
ja: 3.0からは、MVTポリゴンのクリップと検証にコンフィギュア時にWagyuを選択することができるようになりました。このライブラリは、デフォルトのGEOSと比べて、速度が速く、より正確な結果が得られますが、小さいポリゴンが削除されることがあります。

note: Tag: para
en: Canonical example for a Web Mercator tile using a computed tile bounds to query and clip geometry.
ja: クエリを実行してジオメトリをクリップするために計算されたタイル境界を使うウェブメルカトルのタイルの標準的な例です。

note: Tag: refpurpose
en: Aggregate function returning a MVT representation of a set of rows.
ja: 行集合のMVT表現を返す集約関数です。

note: Tag: para
en: An aggregate function which returns a binary <link xlink:href="https://www.mapbox.com/vector-tiles/">Mapbox Vector Tile</link> representation of a set of rows corresponding to a tile layer. The rows must contain a geometry column which will be encoded as a feature geometry. The geometry must be in tile coordinate space and valid as per the <link xlink:href="https://www.mapbox.com/vector-tiles/specification/">MVT specification</link>. <xref linkend="ST_AsMVTGeom"/> can be used to transform geometry into tile coordinate space. Other row columns are encoded as feature attributes.
ja: タイルレイヤに対応する行集合を<link xlink:href="https://www.mapbox.com/vector-tiles/">Mapbox Vector Tile</link>表現で返す集約関数です。行には地物ジオメトリとして符号化されるgeometryが必ずあります。ジオメトリはタイルの座標空間に存在しなければならず、<link xlink:href="https://www.mapbox.com/vector-tiles/specification/">MVT specification</link>として妥当でなければなりません。<xref linkend="ST_AsMVTGeom"/>はジオメトリをタイルの座標空間に変換するのに使えます。他のカラムは地物の属性として符号化されます。

note: Tag: para
en: The <link xlink:href="https://www.mapbox.com/vector-tiles/">Mapbox Vector Tile</link> format can store features with varying sets of attributes. To use this capability supply a JSONB column in the row data containing Json objects one level deep. The keys and values in the JSONB values will be encoded as feature attributes.
ja: <link xlink:href="https://www.mapbox.com/vector-tiles/">Mapbox Vector Tile</link>書式は、様々な属性就業を持つ地物を格納することができます。この能力を使うには、JSONオブジェクトを１レベルの深さで持っている行データ内のJSONBカラムを提供します。JSONB値のキーと値は地物の属性として符号化されます。

note: Tag: para
en: Tiles with multiple layers can be created by concatenating multiple calls to this function using <varname>||</varname> or <varname>STRING_AGG</varname>.
ja: この関数への複数の呼び出しを<varname>||</varname>や<varname>STRING_AGG</varname>で繋げることで、複数レイヤのタイルを作ることができます。

note: Tag: para
en: Do not call with a <varname>GEOMETRYCOLLECTION</varname> as an element in the row. However you can use <xref linkend="ST_AsMVTGeom"/> to prepare a geometry collection for inclusion.
ja: <varname>GEOMETRYCOLLECTION</varname>を行の要素として、この関数を呼ばないでください。しかしながら、ジオメトリコレクションを含ませるための準備として、<xref linkend="ST_AsMVTGeom"/>を使うことができます。

note: Tag: para
en: <varname>name</varname> is the name of the layer. Default is the string "default".
ja: <varname>name</varname>はレイヤ名です。デフォルトは"default"という文字列です。

note: Tag: para
en: <varname>extent</varname> is the tile extent in screen space as defined by the specification. Default is 4096.
ja: <varname>extent</varname>は、仕様で定義されている画面空間内のタイル範囲です。NULLの場合には、4096をデフォルト値とします。

note: Tag: para
en: <varname>geom_name</varname> is the name of the geometry column in the row data. Default is the first geometry column. Note that PostgreSQL by default automatically <link xlink:href="https://www.postgresql.org/docs/current/sql-syntax-lexical.html#SQL-SYNTAX-IDENTIFIERS">folds unquoted identifiers to lower case</link>, which means that unless the geometry column is quoted, e.g. <varname>"MyMVTGeom"</varname>, this parameter must be provided as lowercase.
ja: <varname>geom_name</varname>は、行データ内のジオメトリカラム名です。デフォルトはジオメトリカラムのうちの先頭です。PostgreSQLはデフォルトでは自動的に<link xlink:href="https://www.postgresql.org/docs/current/sql-syntax-lexical.html#SQL-SYNTAX-IDENTIFIERS">引用符で括らない識別子は小文字になります</link>。これは、ジオメトリカラムがカラム名が引用符で括られる(<varname>"MyMVTGeom"</varname>等)ようになっていない場合には、このパラメータは小文字で渡さなければなりません。

note: Tag: para
en: <varname>feature_id_name</varname> is the name of the Feature ID column in the row data. If NULL or negative the Feature ID is not set. The first column matching name and valid type (smallint, integer, bigint) will be used as Feature ID, and any subsequent column will be added as a property. JSON properties are not supported.
ja: <varname>feature_id_name</varname>は行データの地物IDカラムの名前です。NULLまたは負数の場合には地物IDは設定されません。名前が合致し、妥当な型 (smallint, integer, bigint)である最初のカラムが地物IDに使われます。後続のカラムは全てプロパティとして追加されます。JSONプロパティには対応していません。

note: Tag: para
en: Enhanced: 3.0 - added support for Feature ID.
ja: Enhanced: 3.0 - 地物IDへの対応を追加。

note: Tag: para
en: Enhanced: 2.5.0 - added support parallel query.
ja: Enhanced: 2.5.0 - パラレルクエリへの対応の追加。

note: Tag: refpurpose
en: Returns SVG path data for a geometry.
ja: ジオメトリからSVGパスデータを返します。

note: Tag: para
en: Return the geometry as Scalar Vector Graphics (SVG) path data. Use 1 as second argument to have the path data implemented in terms of relative moves, the default (or 0) uses absolute moves. Third argument may be used to reduce the maximum number of decimal digits used in output (defaults to 15). Point geometries will be rendered as cx/cy when 'rel' arg is 0, x/y when 'rel' is 1. Multipoint geometries are delimited by commas (","), GeometryCollection geometries are delimited by semicolons (";").
ja: Scalar Vector Graphics (SVG)としてジオメトリを返します。 第2引数に1を指定すると、相対移動によるパスデータ実装を返し、絶対移動の場合はデフォルト (または0)とします。第3引数は、出力の十進数の最大桁数を減らすために使います (デフォルトは15です)。ポイントジオメトリは、'rel'が0のときはポイントはcx/cyに、'rel'が1のときはx/yに、それぞれ出力されます。マルチポイントはコンマ (",")で区切られ、ジオメトリコレクションはセミコロン (";")で区切られます。

note: Tag: para
en: For working with PostGIS SVG graphics, checkout <link xlink:href="https://github.com/dr-jts/pg_svg">pg_svg</link> library which provides plpgsql functions for working with outputs from ST_AsSVG.
ja: PostGIS SVG グラフィックを使うには、ST_AsSVGからの出力を操作するためのPL/pgSQL関数を提供する<link xlink:href="https://github.com/dr-jts/pg_svg">pg_svg</link>ライブラリをチェックアウトして下さい。

note: Tag: para
en: Enhanced: 3.4.0 to support all curve types
ja: Enhanced: 3.4.0 全ての曲線タイプに対応しました

note: Tag: para
en: Changed: 2.0.0 to use default args and support named args
ja: Changed: 2.0.0 - デフォルト引数と名前付き引数に対応しました。

note: Tag: para
en: Availability: 1.2.2. Availability: 1.4.0 Changed in PostGIS 1.4.0 to include L command in absolute path to conform to <link xlink:href="http://www.w3.org/TR/SVG/paths.html#PathDataBNF">http://www.w3.org/TR/SVG/paths.html#PathDataBNF</link>
ja: Availability: 1.2.2. Availability: 1.4.0 PostGIS 1.4.0で<link xlink:href="http://www.w3.org/TR/SVG/paths.html#PathDataBNF">http://www.w3.org/TR/SVG/paths.html#PathDataBNF</link>に従うため、絶対パスにLコマンドが入りました。

note: Tag: para
en: Circular string
ja: 曲線ストリング

note: Tag: para
en: Multi-curve
ja: マルチ曲線

note: Tag: para
en: Multi-surface
ja: マルチサーフェス

note: Tag: refpurpose
en: Returns the geometry as TWKB, aka "Tiny Well-Known Binary"
ja: TWKB (Tiny Well-Known Binary)としてジオメトリを出力します。

note: Tag: para
en: Returns the geometry in TWKB (Tiny Well-Known Binary) format. TWKB is a <link xlink:href="https://github.com/TWKB/Specification/blob/master/twkb.md">compressed binary format</link> with a focus on minimizing the size of the output.
ja: TWKB (Tiny Well-Known Binary) 書式としてジオメトリを返します。TWKBは、出力サイズを最小化することに焦点を当てた<link xlink:href="https://github.com/TWKB/Specification/blob/master/twkb.md">compressed binary format</link> (圧縮バイナリ書式)です。

note: Tag: para
en: The decimal digits parameters control how much precision is stored in the output. By default, values are rounded to the nearest unit before encoding. If you want to transfer more precision, increase the number. For example, a value of 1 implies that the first digit to the right of the decimal point will be preserved.
ja: decimaldigitsパラメータによって、出力に持たせる精度を制御できます。デフォルトでは、符号化前に値は単位上の最近値に丸められます。精度が高いものを転送したいなら、これの数字を大きくします。たとえば、1の値は小数点の右に1桁の数字が保存されます。

note: Tag: para
en: The sizes and bounding boxes parameters control whether optional information about the encoded length of the object and the bounds of the object are included in the output. By default they are not. Do not turn them on unless your client software has a use for them, as they just use up space (and saving space is the point of TWKB).
ja: include_sizesとinclude_bounding_boxesパラメータによって、符号化オブジェクトの長さに関する任意情報の有無やオブジェクトの境界の有無を制御できます。デフォルトでは、無しです。クライアントソフトウェアが、これらの情報を使用しないなら、このパラメータを有効にしないで下さい。空白が増える (しかも空白の抑制がTWKBのポイントである)ためです。

note: Tag: para
en: The array-input form of the function is used to convert a collection of geometries and unique identifiers into a TWKB collection that preserves the identifiers. This is useful for clients that expect to unpack a collection and then access further information about the objects inside. You can create the arrays using the <link xlink:href="https://www.postgresql.org/docs/current/functions-aggregate.html">array_agg</link> function. The other parameters operate the same as for the simple form of the function.
ja: 配列入力の形式は、ジオメトリのコレクションを変換して、一意の識別子をTWKBコレクションに持たせるためのものです。これは、コレクションを展開して、オブジェクト内部に関する情報にさらにアクセスするのに使えます。<link xlink:href="http://www.postgresql.org/docs/current/functions-aggregate.html">array_agg</link>関数を使用して配列を生成できます。他のパラメータは、単純な形式のものと同じです。

note: Tag: para
en: The format specification is available online at <link xlink:href="https://github.com/TWKB/Specification">https://github.com/TWKB/Specification</link>, and code for building a JavaScript client can be found at <link xlink:href="https://github.com/TWKB/twkb.js">https://github.com/TWKB/twkb.js</link>.
ja: 書式仕様は<link xlink:href="https://github.com/TWKB/Specification">https://github.com/TWKB/Specification</link>にあります。JavaScriptクライアントを構築するプログラムは<link xlink:href="https://github.com/TWKB/twkb.js">https://github.com/TWKB/twkb.js</link>にあります。

note: Tag: para
en: Enhanced: 2.4.0 memory and speed improvements.
ja: Enhanced: 2.4.0 メモリと速度の改善。

note: Tag: para
en: To create an aggregate TWKB object including identifiers aggregate the desired geometries and objects first, using "array_agg()", then call the appropriate TWKB function.
ja: 識別子を含むTWKBオブジェクトの集計を生成するには、まず、"array_agg()"を使って求めるジオメトリとオブジェクトを集計して、その後に適切なTWKB関数を呼んでいます。

note: Tag: refpurpose
en: Returns a Geometry in X3D xml node element format: ISO-IEC-19776-1.2-X3DEncodings-XML
ja: ジオメトリをX3Dノード要素書式 (ISO-IEC-19776-1.2-X3DEncodings-XML)で返します。

note: Tag: para
en: Returns a geometry as an X3D xml formatted node element <link xlink:href="http://www.web3d.org/standards/number/19776-1">http://www.web3d.org/standards/number/19776-1</link>. If <varname>maxdecimaldigits</varname> (precision) is not specified then defaults to 15.
ja: X3D XMLで表されたノード要素 <link xlink:href="http://www.web3d.org/standards/number/19776-1">http://www.web3d.org/standards/number/19776-1</link>としたジオメトリを返します。<varname>maxdecimaldigits</varname> (精度)を指定しない場合には、デフォルトは15です。

note: Tag: para
en: There are various options for translating PostGIS geometries to X3D since X3D geometry types don't map directly to PostGIS geometry types and some newer X3D types that might be better mappings we have avoided since most rendering tools don't currently support them. These are the mappings we have settled on. Feel free to post a bug ticket if you have thoughts on the idea or ways we can allow people to denote their preferred mappings.
ja: PostGISジオメトリをX3Dに変換するための任意引数が様々あります。X3Dジオメトリ型は、PostGISジオメトリタイプに対応付けされていないためです。また、より良い対応付けになると思われるものの、ほとんどのレンダリングツールが今のところは対応していないため、開発者が避けてきた新しいX3Dタイプに対応付けをしていないためでもあります。これらは開発者が決定した対応付けです。開発者が皆さんにより好まれる対応付けを示せるようなアイデアや方法に関する考えを持っているなら、お気軽にバグチケットを出して下さい。

note: Tag: para
en: Below is how we currently map PostGIS 2D/3D types to X3D types
ja: 次に現時点のPostGIS 2次元/3次元型からX3D型への対応付けを示します。

note: Tag: para
en: The 'options' argument is a bitfield. For PostGIS 2.2+, this is used to denote whether to represent coordinates with X3D GeoCoordinates Geospatial node and also whether to flip the x/y axis. By default, <code>ST_AsX3D</code> outputs in database form (long,lat or X,Y), but X3D default of lat/lon, y/x may be preferred.
ja: 'options'引数はビットフィールドです。PostGIS 2.2以上では、これはX3D GeoCoordinates Geospatialノードを表現するかどうか、また、X/Y軸を反対にするかどうかで使います。<code>ST_AsX3D</code>は、デフォルトではデータベースの形式(経度, 緯度またはX, Y)で出力しますが、X3Dのlat/lon, y/xのデフォルトが好まれるでしょう。

note: Tag: para
en: 0: X/Y in database order (e.g. long/lat = X,Y is standard database order), default value, and non-spatial coordinates (just regular old Coordinate tag).
ja: 0: データベース内のX/Y順 (経度/緯度=X, Yが標準です)とします。デフォルト値です。非空間座標 (一般的な古いCoordinate要素です)です。

note: Tag: para
en: 1: Flip X and Y. If used in conjunction with the GeoCoordinate option switch, then output will be default "latitude_first" and coordinates will be flipped as well.
ja: 1: XとYを反対にします。GeoCoordinate任意スイッチと併せて使用されると、出力は"latitude_first" (緯度が先)となり、座標が同じように反対になります。

note: Tag: para
en: 2: Output coordinates in GeoSpatial GeoCoordinates. This option will throw an error if geometries are not in WGS 84 long lat (srid: 4326). This is currently the only GeoCoordinate type supported. <link xlink:href="http://www.web3d.org/documents/specifications/19775-1/V3.2/Part01/components/geodata.html#Specifyingaspatialreference">Refer to X3D specs specifying a spatial reference system.</link>. Default output will be <code>GeoCoordinate geoSystem='"GD" "WE" "longitude_first"'</code>. If you prefer the X3D default of <code>GeoCoordinate geoSystem='"GD" "WE" "latitude_first"'</code> use <code>(2 + 1)</code> = <code>3</code>
ja: 2: GeoSpatial GeoCoordinates内への座標出力。WGS 84経度緯度 (SRID: 4326)でない場合にエラーが投げられます。現在はGeoCoordinate型のみ対応します。<link xlink:href="http://www.web3d.org/documents/specifications/19775-1/V3.2/Part01/components/geodata.html#Specifyingaspatialreference">X3D specs specifying a spatial reference system.</link>を参照して下さい。デフォルト出力は<code>GeoCoordinate geoSystem='"GD" "WE" "longitude_first"'</code>となります。X3Dのデフォルトである<code>GeoCoordinate geoSystem='"GD" "WE" "latitude_first"'</code>とするには、<code>(2 + 1)</code> = <code>3</code>とします。

note: Tag: entry
en: PostGIS Type
ja: PostGISタイプ

note: Tag: entry
en: 2D X3D Type
ja: 2次元X3Dタイプ

note: Tag: entry
en: 3D X3D Type
ja: 3次元X3Dタイプ

note: Tag: entry
en: not yet implemented - will be PolyLine2D
ja: 未実装 - PolyLine2Dの予定

note: Tag: entry
en: outputs the space delimited coordinates
ja: 空白区切り座標値を出力

note: Tag: entry
en: Invalid X3D markup
ja: 不正なX3Dマークアップ

note: Tag: entry
en: IndexedFaceSet (inner rings currently output as another faceset)
ja: IndexedFaceSet (内環は現在は他のfacesetとして出力)

note: Tag: entry
en: TriangleSet2D (Not Yet Implemented)
ja: TriangleSet2D (未実装)

note: Tag: para
en: 2D geometry support not yet complete. Inner rings currently just drawn as separate polygons. We are working on these.
ja: 2次元ジオメトリ対応はまだ不完全です。 内環は現在は分けられたポリゴンとして描画されるだけです。作業中です。

note: Tag: para
en: Lots of advancements happening in 3D space particularly with <link xlink:href="https://www.web3d.org/wiki/index.php/X3D_and_HTML5">X3D Integration with HTML5</link>
ja: 3次元空間については、特に<link xlink:href="https://www.web3d.org/wiki/index.php/X3D_and_HTML5">X3D Integration with HTML5</link>で大きな進歩があります。

note: Tag: para
en: There is also a nice open source X3D viewer you can use to view rendered geometries. Free Wrl <link xlink:href="http://freewrl.sourceforge.net/">http://freewrl.sourceforge.net/</link> binaries available for Mac, Linux, and Windows. Use the FreeWRL_Launcher packaged to view the geometries.
ja: また、描画されたジオメトリを閲覧するための素晴らしいオープンソースのX3Dビューアがあります。Free Wrl <link xlink:href="http://freewrl.sourceforge.net/">http://freewrl.sourceforge.net/</link>のバイナリがMac, Linux, Windows用であります。ジオメトリを見るためのパッケージであるFreeWRL_Launcherを使います。

note: Tag: para
en: Also check out <link xlink:href="https://git.osgeo.org/gitea/robe/postgis_x3d_viewer">PostGIS minimalist X3D viewer</link> that utilizes this function and <link xlink:href="http://www.x3dom.org/">x3dDom html/js open source toolkit</link>.
ja: この関数と<link xlink:href="http://www.x3dom.org/">x3dDom html/js open source toolkit</link>を用いた<link xlink:href="https://git.osgeo.org/gitea/robe/postgis_x3d_viewer">PostGIS minimalist X3D viewer</link>を開いてみて下さい。

note: Tag: para
en: Enhanced: 2.2.0: Support for GeoCoordinates and axis (x/y, long/lat) flipping. Look at options for details.
ja: Enhanced: 2.2.0: GeoCoordinatesと軸 (x/y, 経度/緯度)の反転に対応しました。詳細はoptionsを見て下さい。

note: Tag: title
en: Example: Create a fully functional X3D document - This will generate a cube that is viewable in FreeWrl and other X3D viewers.
ja: 例: 完全に機能するX3D文書の作成 - FreeWrlや他のX3Dビューアで見ることができる立方体を生成しています。

note: Tag: title
en: PostGIS buildings
ja: PostGISの建物

note: Tag: para
en: Copy and paste the output of this query to <link xlink:href="http://postgis.net/docs/support/viewers/x3d_viewer.htm">x3d scene viewer</link> and click Show
ja: このクエリの出力を<link xlink:href="http://postgis.net/docs/support/viewers/x3d_viewer.htm">x3d scene viewer</link>にコピーして貼り付けて、Showをクリックします。

note: Tag: para
en: Buildings formed by subdividing PostGIS and extrusion
ja: PostGISのデータ細分化と押し出しによって形成された建物

note: Tag: title
en: Example: An Octagon elevated 3 Units and decimal precision of 6
ja: 例: 高さ3単位で精度が6桁の八角柱

note: Tag: title
en: Example: TIN
ja: 例: TIN

note: Tag: title
en: Example: Closed multilinestring (the boundary of a polygon with holes)
ja: 例: 閉じたラインストリング (穴のあるポリゴンの境界)

note: Tag: refpurpose
en: Return a GeoHash representation of the geometry.
ja: ジオメトリのGeoHash表現を返します。

note: Tag: para
en: Computes a <link xlink:href="http://en.wikipedia.org/wiki/Geohash">GeoHash</link> representation of a geometry. A GeoHash encodes a geographic Point into a text form that is sortable and searchable based on prefixing. A shorter GeoHash is a less precise representation of a point. It can be thought of as a box that contains the point.
ja: ジオメトリの<link xlink:href="https://ja.wikipedia.org/wiki/%E3%82%B8%E3%82%AA%E3%83%8F%E3%83%83%E3%82%B7%E3%83%A5">ジオハッシュ</link>表現を計算します。ジオハッシュは地理座標系のポイントを、前置に基づいた文字列として符号化したもので、ソート可能かつ検索可能です。短いジオハッシュではポイントは低精度に表現されています。これは、ポイントを含むボックスと考えることができます。

note: Tag: para
en: Non-point geometry values with non-zero extent can also be mapped to GeoHash codes. The precision of the code depends on the geographic extent of the geometry.
ja: 0でない範囲を持つ、ポイントでないジオメトリ値はジオハッシュコードに対応付けできます。コードの精度はジオメトリの地理範囲に依存します。

note: Tag: para
en: If <varname>maxchars</varname> is not specified, the returned GeoHash code is for the smallest cell containing the input geometry. Points return a GeoHash with 20 characters of precision (about enough to hold the full double precision of the input). Other geometric types may return a GeoHash with less precision, depending on the extent of the geometry. Larger geometries are represented with less precision, smaller ones with more precision. The box determined by the GeoHash code always contains the input feature.
ja: <varname>maxchars</varname>が指定されていない場合には、返されるジオハッシュコードは、入力ジオメトリを含む最も小さいセルです。ポイントでは、20文字の精度 (入力の完全な倍精度浮動小数点数の保持十分です)ジオハッシュを返します。他のジオメトリタイプでは、より低い精度のジオハッシュを返しますが、精度はジオメトリの範囲に依存します。大きいジオメトリは低い精度となり、小さいジオメトリは高い精度になります。ジオハッシュコードで決まるボックスは常に入力入力地物を含んでいます。

note: Tag: para
en: If <varname>maxchars</varname> is specified the returned GeoHash code has at most that many characters. It maps to a (possibly) lower precision representation of the input geometry. For non-points, the starting point of the calculation is the center of the bounding box of the geometry.
ja: <varname>maxchars</varname>が指定された場合には、この値は、返されるジオハッシュコードの最大文字数になります。入力ジオメトリは(おそらく)より低い精度で表現されます。ポイントでない場合には、計算の最初のポイントはジオメトリのバウンダリボックスの中心となります。

note: Tag: para
en: ST_GeoHash requires input geometry to be in geographic (lon/lat) coordinates.
ja: ST_GeoHashの入力ジオメトリは、地理座標系 (経度/緯度)でなければなりません。

note: Tag: title
en: Overlay Functions
ja: 重ね合わせ関数

note: Tag: para
en: These functions compute results arising from the overlay of two geometries. These are also known as point-set theoretic boolean operations. Some related functions are also provided.
ja: これらの関数は、二つのジオメトリの重ね合わせから生まれる結果を計算するものです。ポイント集合理論の真偽値演算を行うものもあります。関連する関数もいくつか提供されています。

note: Tag: refpurpose
en: Computes the portion of a geometry falling within a rectangle.
ja: 長方形内に落ちるジオメトリの一部を返します。

note: Tag: para
en: Clips a geometry by a 2D box in a fast and tolerant but possibly invalid way. Topologically invalid input geometries do not result in exceptions being thrown. The output geometry is not guaranteed to be valid (in particular, self-intersections for a polygon may be introduced).
ja: 2次元ボックスでジオメトリを切り抜きます。高速ですが不正な方法になることもあります。トポロジ的に不正な入力ジオメトリでは例外が投げられ結果を返しません。出力ジオメトリの妥当性は保証されません (ポリゴンで自己インタセクションができるかも知れません)。

note: Tag: refpurpose
en: Computes a geometry representing the part of geometry A that does not intersect geometry B.
ja: ジオメトリBとインタセクトしていないジオメトリAの一部を表現するジオメトリを計算します。

note: Tag: para
en: Returns a geometry representing the part of geometry A that does not intersect geometry B. This is equivalent to <code>A - ST_Intersection(A,B)</code>. If A is completely contained in B then an empty atomic geometry of appropriate type is returned.
ja: ジオメトリBとインタセクトしていないジオメトリAの一部を表現するジオメトリを計算します。これは<code>A - ST_Intersection(A,B)</code>と同じです。Aが完全にBに包含されている場合には、適切なタイプの空のジオメトリが返されます。

note: Tag: para
en: This is the only overlay function where input order matters. ST_Difference(A, B) always returns a portion of A.
ja: これは、重ね合わせ関数では唯一の入力順序を気にしなければならない関数です。ST_Difference(A, B)は常にAの一部を返します。

note: Tag: para
en: If the optional <code>gridSize</code> argument is provided, the inputs are snapped to a grid of the given size, and the result vertices are computed on that same grid. (Requires GEOS-3.9.0 or higher)
ja: 任意引数<code>gridSize</code>が与えらえれた場合には、入力は与えられた大きさのグリッドにスナップされ、結果の￥頂点は同じグリッド上で計算されます (GEOS-3.9.0以上が必要)。

note: Tag: para
en: Enhanced: 3.1.0 accept a gridSize parameter.
ja: Enhanced: 3.1.0 gridSizeパラメータを受け付けるようになりました。

note: Tag: para
en: Requires GEOS &gt;= 3.9.0 to use the gridSize parameter.
ja: gridSizeパラメータを使うにはGEOS 3.9.0以上が必要です。

note: Tag: para
en: &Z_support; However, the result is computed using XY only. The result Z values are copied, averaged or interpolated.
ja: &Z_support; ただし、結果はXYのみを使用して計算されます。結果のZ値は複写するか、平均値になるか、補間されます。

note: Tag: para
en: The input linestrings
ja: 入力ラインストリング

note: Tag: para
en: The difference of the two linestrings
ja: 二つのラインストリングの差

note: Tag: para
en: The difference of 2D linestrings.
ja: 次では、2次元ラインストリングの差を求めます。

note: Tag: para
en: The difference of 3D points.
ja: 次では、3次元ラインストリングの差を求めます。

note: Tag: refpurpose
en: Computes a geometry representing the shared portion of geometries A and B.
ja: ジオメトリAとジオメトリBの共通部分を表現するジオメトリを返します。

note: Tag: para
en: Returns a geometry representing the point-set intersection of two geometries. In other words, that portion of geometry A and geometry B that is shared between the two geometries.
ja: 二つのジオメトリのポイント集合の交差を表現するジオメトリを返します。言い換えると、ジオメトリAとジオメトリBの一部であって、二つのジオメトリで共有される部分を返します。

note: Tag: para
en: If the geometries have no points in common (i.e. are disjoint) then an empty atomic geometry of appropriate type is returned.
ja: ジオメトリが共通するポイントを持っていない (つまり接続されていない)場合には、適切なタイプの空のジオメトリが返されます。

note: Tag: para
en: ST_Intersection in conjunction with <xref linkend="ST_Intersects"/> is useful for clipping geometries such as in bounding box, buffer, or region queries where you only require the portion of a geometry that is inside a country or region of interest.
ja: <xref linkend="ST_Intersects"/>と併用するST_Intersectionは、バウンディングボックス、バッファや、対象の国や領域の内部にあるジオメトリの部分のみが必要な場合に使う領域クエリといったようなジオメトリの切り抜きに使えます。

note: Tag: para
en: &geography_transform; It first determines the best SRID that fits the bounding box of the 2 geography objects (if geography objects are within one half zone UTM but not same UTM will pick one of those) (favoring UTM or Lambert Azimuthal Equal Area (LAEA) north/south pole, and falling back on mercator in worst case scenario) and then intersection in that best fit planar spatial ref and retransforms back to WGS84 geography.
ja: &geography_transform; 最初に二つのジオグラフィ値のバウンディングボックスに適合する最適なSRIDを決定します (二つのジオグラフィ値がUTMゾーンの半分以内だけど同じUTMゾーンでない場合はどちらか一つを選びます) (UTMまたはランベルト正積方位図法の北極又は南極を優先し、最悪の場合にメルカトルに後退します)。次に、最適な平面空間参照系でインタセクトする領域を計算して、WGS84ジオグラフィに再変換します。

note: Tag: para
en: This function will drop the M coordinate values if present.
ja: この関数はM値が存在している場合には削除します。

note: Tag: para
en: If working with 3D geometries, you may want to use SFGCAL based <xref linkend="ST_3DIntersection"/> which does a proper 3D intersection for 3D geometries. Although this function works with Z-coordinate, it does an averaging of Z-Coordinate.
ja: 3次元ジオメトリで動作しますが、SFCGALベースの<xref linkend="ST_3DIntersection"/>は。3次元ジオメトリの確実な3次元インタセクトした領域を返すので、これを使った方がいいかも知れません。この関数はZ値があっても動作しますが、Z値は平均化されます。

note: Tag: para
en: Enhanced: 3.1.0 accept a gridSize parameter
ja: Enhanced: 3.1.0 gridSizeパラメータを受け付けるようになりました

note: Tag: para
en: Requires GEOS &gt;= 3.9.0 to use the gridSize parameter
ja: gridSizeパラメータを使うにはGEOS 3.9.0以上が必要です

note: Tag: para
en: Changed: 3.0.0 does not depend on SFCGAL.
ja: Changed: 3.0.0 SFCGAL非依存になりました。

note: Tag: para
en: Availability: 1.5 support for geography data type was introduced.
ja: Availability: 1.5 ジオグラフィ型が導入されました。

note: Tag: para
en: Clip all lines (trails) by country. Here we assume country geom are POLYGON or MULTIPOLYGONS. NOTE: we are only keeping intersections that result in a LINESTRING or MULTILINESTRING because we don't care about trails that just share a point. The dump is needed to expand a geometry collection into individual single MULT* parts. The below is fairly generic and will work for polys, etc. by just changing the where clause.
ja: 国別に全てのライン (trains)を切り抜きます。 国のジオメトリはPOLYGONまたはMULTIPOLYGONであると仮定します。ご注意: ポイントだけを共有するtrailsは気にしないので、LINESTRINGまたはMULTILINESTRINGの結果となるインタセクションだけを保持しています。ジオメトリコレクションを個々のマルチ系ジオメトリの要素に分解するためにダンプが必要です。下の例は非常に汎用的で、WHERE節を変更するだけでポリゴンでも動作します。

note: Tag: para
en: For polys e.g. polygon landmarks, you can also use the sometimes faster hack that buffering anything by 0.0 except a polygon results in an empty geometry collection. (So a geometry collection containing polys, lines and points buffered by 0.0 would only leave the polygons and dissolve the collection shell.)
ja: ランドマーク等のポリゴンに対しては、ポリゴンを除いたジオメトリを0.0でバッファを実行すると空ジオメトリコレクションが得られる、という速度向上のための技を使うことができます (それで、ポリゴン、ラインストリング、ポイントを含むジオメトリコレクションを0.0でバッファを実行すると、ポリゴンのみが残り、ジオメトリコレクションでなくなります)。

note: Tag: title
en: Examples: 2.5Dish
ja: 例: 2.5次元的なもの

note: Tag: para
en: Note this is not a true intersection, compare to the same example using <xref linkend="ST_3DIntersection"/>.
ja: これは、本当のインタセクションではありません。<xref linkend="ST_3DIntersection"/>の同じ例と比較して下さい。

note: Tag: refpurpose
en: Aggregate function which unions geometries in a memory-efficent but slower way
ja: ジオメトリを結合する集約関数で、メモリを効率的に使いますが処理時間のかかるものです。

note: Tag: para
en: An aggregate function that unions the input geometries, merging them to produce a result geometry with no overlaps. The output may be a single geometry, a MultiGeometry, or a Geometry Collection.
ja: 入力ジオメトリを結合してオーバラップをしない結果ジオメトリを生成する集約関数です。出力は単一ジオメトリ、マルチ系ジオメトリ、ジオメトリコレクションのいずれにかなる可能性があります。

note: Tag: para
en: Produces the same result as <xref linkend="ST_Union"/>, but uses less memory and more processor time. This aggregate function works by unioning the geometries incrementally, as opposed to the ST_Union aggregate which first accumulates an array and then unions the contents using a fast algorithm.
ja: <xref linkend="ST_Union"/>と同じ結果を生成しますが、メモリ使用が少なく、処理時間が長くなります。この集約関数はジオメトリの逐次加算的結合で動作しています。これは、最初に配列を蓄積して高速アルゴリズムで結合するST_Union集約関数と反対です。

note: Tag: refpurpose
en: Nodes a collection of lines.
ja: ラインストリングの集合にノードを作成します。

note: Tag: para
en: Returns a (Multi)LineString representing the fully noded version of a collection of linestrings. The noding preserves all of the input nodes, and introduces the least possible number of new nodes. The resulting linework is dissolved (duplicate lines are removed).
ja: ラインストリングのコレクションに完全にノードが加えられたものを表現する(マルチ)ラインストリングを返します。全ての入力ノードを保存したうえで、可能な最低の数だけノードを加えています。結果の線はディゾルブされています (重複線が削除されます)。

note: Tag: para
en: This is a good way to create fully-noded linework suitable for use as input to <xref linkend="ST_Polygonize"/>.
ja: これは<xref linkend="ST_Polygonize"/>への入力に適した、完全にノードを加えた線を生成する良い方法です。

note: Tag: para
en: can also be used to node and dissolve linework. It provides an option to specify a gridSize, which can provide simpler and more robust output. See also <xref linkend="ST_Union"/> for an aggregate variant.
ja: も、ラインのノード追加とディゾルブに使うことができます。gridSizeを指定する任意引数を与えると、より単純かつよりロバストな出力が得られます。集約関数版については<xref linkend="ST_Union"/>をご覧下さい。

note: Tag: para
en: Changed: 2.4.0 this function uses GEOSNode internally instead of GEOSUnaryUnion. This may cause the resulting linestrings to have a different order and direction compared to PostGIS &lt; 2.4.
ja: Changed: 2.4.0 この関数は内部でGEOSUnaryUnionの替わりにGEOSNodeを使用しています。ラインストリングの並び順と方向がPostGIS 2.4より前のものと違うことになるかも知れません。

note: Tag: para
en: Noding a 3D LineString which self-intersects
ja: 自己交差する3次元ラインストリグにノードを加えます。

note: Tag: para
en: Noding two LineStrings which share common linework. Note that the result linework is dissolved.
ja: 線を共有する二つのラインストリングにノードを加えます。結果の線はディゾルブされます。

note: Tag: refpurpose
en: Returns a collection of geometries created by splitting a geometry by another geometry.
ja: ジオメトリを他のジオメトリで分割してできたジオメトリのコレクションを返します。

note: Tag: para
en: The function supports splitting a LineString by a (Multi)Point, (Multi)LineString or (Multi)Polygon boundary, or a (Multi)Polygon by a LineString. When a (Multi)Polygon is used as as the blade, its linear components (the boundary) are used for splitting the input. The result geometry is always a collection.
ja: この関数は（MULTI)POINT、(MULTI)LINESTRING、(MULTI)POLYGONの境界によるLINESTRINGの分割と、LINESTRINGによる(MULTI)POLYGONの分割に対応します。(MULTI)POLYGONを刃として使うとき、線要素 (境界)は入力の分割に使われます。結果ジオメトリは常にコレクションです。

note: Tag: para
en: This function is in a sense the opposite of <xref linkend="ST_Union"/>. Applying ST_Union to the returned collection should theoretically yield the original geometry (although due to numerical rounding this may not be exactly the case).
ja: この関数は<xref linkend="ST_Union"/>の逆のようなものです。返されるコレクションにST_Unionを与えると、理論的には元のジオメトリが得られます (丸め誤差のために確実に同じになるものではありません)。

note: Tag: para
en: If the the input and blade do not intersect due to numerical precision issues, the input may not be split as expected. To avoid this situation it may be necessary to snap the input to the blade first, using <xref linkend="ST_Snap"/> with a small tolerance.
ja: 入力と刃が数値の精度の問題でインタセクトしない場合には、入力が思ったように分割されない可能性があります。この状況を避けるには、先に、<xref linkend="ST_Snap"/>に小さい許容値を与えて、入力を刃にスナップする必要があるかも知れません。

note: Tag: para
en: Availability: 2.0.0 requires GEOS
ja: Availability: 2.0.0 GEOSが必要です

note: Tag: para
en: Enhanced: 2.2.0 support for splitting a line by a multiline, a multipoint or (multi)polygon boundary was introduced.
ja: Enhanced: 2.2.0 ライン分割をマルチライン、マルチポイントまたはポリゴンもしくはマルチポリゴンの境界で行えるようにしました。

note: Tag: para
en: Enhanced: 2.5.0 support for splitting a polygon by a multiline was introduced.
ja: Enhanced: 2.5.0 マルチラインによるポリゴンの分割に対応するようになりました。

note: Tag: para
en: Split a Polygon by a Line.
ja: ラインでポリゴンを分割します。

note: Tag: para
en: Before Split
ja: 分割前

note: Tag: para
en: After split
ja: 分割後

note: Tag: para
en: Split a MultiLineString by a Point, where the point lies exactly on both LineStrings elements.
ja: マルチラインストリングをポイントで分割します。ポイントは確実にラインストリングの要素の上に存在するようにします。

note: Tag: para
en: Split a LineString by a Point, where the point does not lie exactly on the line. Shows using <xref linkend="ST_Snap"/> to snap the line to the point to allow it to be split.
ja: ラインストリングをライン上にないポイントで分割します。<xref linkend="ST_Snap"/>を使ってラインをポイントにスナップして分割できるようにしています。

note: Tag: refpurpose
en: Computes a rectilinear subdivision of a geometry.
ja: ジオメトリの線の分割を計算します。

note: Tag: para
en: Returns a set of geometries that are the result of dividing <varname>geom</varname> into parts using rectilinear lines, with each part containing no more than <code>max_vertices</code>.
ja: <varname>geom</varname>を直線で分割したジオメトリの集合を返します。個々の部分は<code>max_vertices</code>以下の頂点になります。

note: Tag: para
en: <code>max_vertices</code> must be 5 or more, as 5 points are needed to represent a closed box. <code>gridSize</code> can be specified to have clipping work in fixed-precision space (requires GEOS-3.9.0+).
ja: <code>max_vertices</code>は5以上でなければなりません。5点が閉じたボックスに必要だからです。<code>gridSize</code>は固定精度空間での切り出しに指定できます (GEOS 3.9.0以上が必要)。

note: Tag: para
en: Point-in-polygon and other spatial operations are normally faster for indexed subdivided datasets. Since the bounding boxes for the parts usually cover a smaller area than the original geometry bbox, index queries produce fewer "hit" cases. The "hit" cases are faster because the spatial operations executed by the index recheck process fewer points.
ja: ポリゴン内のポイントと他の空間演算は、通常ではインデックスが付いた細分化されたデータセットの方が速くなります。通常は分割したジオメトリのバウンディングボックスは元ジオメトリのものよりも小さい領域になるので、インデックスのクエリで「当たり」となる場合が少なくなります。インデックスの再チェックによって実行される空間演算で処理されるポイント数が少なくなるので、「当たり」の場合は速度が速くなります。

note: Tag: para
en: This is a <link xlink:href="https://www.postgresql.org/docs/current/queries-table-expressions.html#QUERIES-TABLEFUNCTIONS">set-returning function</link> (SRF) that return a set of rows containing single geometry values. It can be used in a SELECT list or a FROM clause to produce a result set with one record for each result geometry.
ja: これは<link xlink:href="https://www.postgresql.org/docs/current/queries-table-expressions.html#QUERIES-TABLEFUNCTIONS">集合を返す関数</link> (SRF)です。単一ジオメトリ値を含む行の集合を返します。SELECTリストまたはFROM節で、結果ジオメトリごとに一つのレコードとなる結果集合を生成できます。

note: Tag: para
en: Enhanced: 2.5.0 reuses existing points on polygon split, vertex count is lowered from 8 to 5.
ja: Enhanced: 2.5.0 ポリゴン分割で存在するポイントを再利用して頂点数の最小値を8から5に変更。

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Subdivide a polygon into parts with no more than 10 vertices, and assign each part a unique id.
ja: <emphasis role="bold">例:</emphasis> 個々のポリゴンが10頂点とならないようなポリゴンの分割と、個々に一意のIDの割り当て。

note: Tag: para
en: Subdivided to maximum 10 vertices
ja: 最大10頂点での分割

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Densify a long geography line using ST_Segmentize(geography, distance), and use ST_Subdivide to split the resulting line into sublines of 8 vertices.
ja: <emphasis role="bold">例:</emphasis> 長いジオグラフィのラインのST_Segmentize(geography, distance)による緻密化と、ST_Subdivideによるラインを8頂点の分割線への分割を行います。

note: Tag: para
en: The densified and split lines.
ja: ラインの緻密化と分割。

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Subdivide the complex geometries of a table in-place. The original geometry records are deleted from the source table, and new records for each subdivided result geometry are inserted.
ja: <emphasis role="bold">例:</emphasis> テーブルの適切な位置での複雑なジオメトリの分割。元のジオメトリのレコードはソーステーブルから削除され、分割された結果ジオメトリが代わりの新しいレコードになります。

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Create a new table containing subdivided geometries, retaining the key of the original geometry so that the new table can be joined to the source table. Since ST_Subdivide is a set-returning (table) function that returns a set of single-value rows, this syntax automatically produces a table with one row for each result part.
ja: <emphasis role="bold">例:</emphasis> 分割されたジオメトリを持つ新しいテーブルを作ります。元のジオメトリのキーを保持して、新しいテーブルは元のテーブルと結合できます。ST_Subdivideは集合を返す関数で、行は単一の値を持つものですので、この構文で、結果の部分ごとに一つの行となるテーブルが自動的に生成されます。

note: Tag: refpurpose
en: Computes a geometry representing the portions of geometries A and B that do not intersect.
ja: ジオメトリAとジオメトリBがインタセクトしていない部分を表現するジオメトリを返します。

note: Tag: para
en: Returns a geometry representing the portions of geonetries A and B that do not intersect. This is equivalent to <code>ST_Union(A,B) - ST_Intersection(A,B)</code>. It is called a symmetric difference because <code>ST_SymDifference(A,B) = ST_SymDifference(B,A)</code>.
ja: ジオメトリAとジオメトリBがインタセクトしていない部分を表現するジオメトリを返します。この関数は、<code>ST_Union(A,B) - ST_Intersection(A,B)</code>と同じです。SymDifference (対象差)と呼ばれるのは<code>ST_Union(A,B) - ST_Intersection(A,B)</code>だからです。

note: Tag: para
en: The original linestrings shown together
ja: 二つある元のラインストリングの両方

note: Tag: para
en: The symmetric difference of the two linestrings
ja: 二つのラインストリングの対称差

note: Tag: refpurpose
en: Computes the union of the components of a single geometry.
ja: 単一のジオメトリの要素の結合を計算します。

note: Tag: para
en: A single-input variant of <xref linkend="ST_Union"/>. The input may be a single geometry, a MultiGeometry, or a GeometryCollection. The union is applied to the individual elements of the input.
ja: 単一入力の形式の<xref linkend="ST_Union"/>です。入力は単一ジオメトリ、マルチ系ジオメトリ、ジオメトリコレクションが可能です。結合は、入力の個々のエレメントに適用されます。

note: Tag: para
en: This function can be used to fix MultiPolygons which are invalid due to overlapping components. However, the input components must each be valid. An invalid input component such as a bow-tie polygon may cause an error. For this reason it may be better to use <xref linkend="ST_MakeValid"/>.
ja: この関数は要素間のオーバラップが原因で不正とされるマルチポリゴンを修正するのに使えます。しかしながら、入力の要素は妥当でなければなりません。蝶ネクタイポリゴンのような入力の個々の要素はエラーを引き起こすかも知れません。このため<xref linkend="ST_MakeValid"/>を使う方が良いかも知れません。

note: Tag: para
en: Another use of this function is to node and dissolve a collection of linestrings which cross or overlap to make them <link linkend="Simple_Geometry">simple</link>. (<xref linkend="ST_Node"/> also does this, but it does not provide the <code>gridSize</code> option.)
ja: この関数は、他に、クロスやオーバラップするラインストリングのコレクションを<link linkend="Simple_Geometry">単純</link>にするためのノード追加とディソルブに使われます (<xref linkend="ST_Node"/> も同様のことを行いますが、任意引数<code>gridSize</code>を与えることができません。)

note: Tag: para
en: It is possible to combine ST_UnaryUnion with <xref linkend="ST_Collect"/> to fine-tune how many geometries are be unioned at once. This allows trading off between memory usage and compute time, striking a balance between ST_Union and <xref linkend="ST_MemUnion"/>.
ja: 一度に結合するジオメトリの数量を調整するためにST_UnaryUnionと<xref linkend="ST_Collect"/>とを混ぜることができます。メモリ使用と処理時間のトレードオフが可能になり、ST_Unionと<xref linkend="ST_MemUnion"/>とのバランスが得られます。

note: Tag: refpurpose
en: Computes a geometry representing the point-set union of the input geometries.
ja: 入力ジオメトリのポイント集合の結合を表現するジオメトリを返します。

note: Tag: para
en: Unions the input geometries, merging geometry to produce a result geometry with no overlaps. The output may be an atomic geometry, a MultiGeometry, or a Geometry Collection. Comes in several variants:
ja: 入力ジオメトリを結合してオーバラップをしない結果ジオメトリを生成します。出力は単一ジオメトリ、マルチ系ジオメトリ、ジオメトリコレクションのいずれにかなる可能性があります。次の通り複数の形式があります。

note: Tag: para
en: <emphasis role="bold">Two-input variant:</emphasis> returns a geometry that is the union of two input geometries. If either input is NULL, then NULL is returned.
ja: <emphasis role="bold">二入力形式:</emphasis> 二つの入力ジオメトリの結合のジオメトリを返します。いずれかの入力がNULLの場合にはNULLを返します。

note: Tag: para
en: <emphasis role="bold">Array variant:</emphasis> returns a geometry that is the union of an array of geometries.
ja: <emphasis role="bold">配列形式:</emphasis> ジオメトリ配列を結合したジオメトリを返します。

note: Tag: para
en: <emphasis role="bold">Aggregate variant:</emphasis> returns a geometry that is the union of a rowset of geometries. The ST_Union() function is an "aggregate" function in the terminology of PostgreSQL. That means that it operates on rows of data, in the same way the SUM() and AVG() functions do and like most aggregates, it also ignores NULL geometries.
ja: <emphasis role="bold">集約関数形式:</emphasis> ジオメトリの集合を結合したジオメトリを返します。ST_Union()関数は、PostgreSQL用語で言うところの「集約関数」です。つまり、SUM()やMEAN()と同じ方法で複数のデータ行の操作を行い、他の集約関数と同じようにNULLジオメトリを無視します。

note: Tag: para
en: See <xref linkend="ST_UnaryUnion"/> for a non-aggregate, single-input variant.
ja: 非集約関数で入力が一つの形式である<xref linkend="ST_UnaryUnion"/>も参照して下さい。

note: Tag: para
en: The ST_Union array and set variants use the fast Cascaded Union algorithm described in <link xlink:href="http://blog.cleverelephant.ca/2009/01/must-faster-unions-in-postgis-14.html">http://blog.cleverelephant.ca/2009/01/must-faster-unions-in-postgis-14.html</link>
ja: ST_Unionの配列形式と集合形式では、<link xlink:href="http://blog.cleverelephant.ca/2009/01/must-faster-unions-in-postgis-14.html">http://blog.cleverelephant.ca/2009/01/must-faster-unions-in-postgis-14.html</link>で紹介されている早いカスケード結合アルゴリズムを使っています。

note: Tag: para
en: A <code>gridSize</code> can be specified to work in fixed-precision space. The inputs are snapped to a grid of the given size, and the result vertices are computed on that same grid. (Requires GEOS-3.9.0 or higher)
ja: 固定精度空間で動作するよう<code>gridSize</code>を指定できます。入力は与えられたグリッドにスナップされ、結果の頂点は同じグリッド上で計算されます (GEOS-3.9.0以上が必要です)。

note: Tag: para
en: may sometimes be used in place of ST_Union, if the result is not required to be non-overlapping. ST_Collect is usually faster than ST_Union because it performs no processing on the collected geometries.
ja: は、結果に重ね合わせが無いことを求めていない場合には、時々ST_Unionの代わりに用いられます。ST_Collectは、集めレれたジオメトリに処理を実行しないため、通常はST_Unionより早い動作速度になります。

note: Tag: para
en: ST_Union creates MultiLineString and does not sew LineStrings into a single LineString. Use <xref linkend="ST_LineMerge"/> to sew LineStrings.
ja: ST_UnionはMULTILINESTRINGを生成し、新しいLINESTRINGを単一のLINESTRINGに縫い付けません。LINESTRINGに縫い付けるには<xref linkend="ST_LineMerge"/>を使用します。

note: Tag: para
en: NOTE: this function was formerly called GeomUnion(), which was renamed from "Union" because UNION is an SQL reserved word.
ja: ご注意: この関数は以前は、"Union"から名称変更してGeomUnion()と呼ばれていました。UNIONはSQLの予約語であるためです。

note: Tag: para
en: Availability: 1.4.0 - ST_Union was enhanced. ST_Union(geomarray) was introduced and also faster aggregate collection in PostgreSQL.
ja: Availability: 1.4.0 - ST_Unionが機能強化されました。ST_Union(geomarray)が導入され、PostgreSQLの高速なコレクションの集約が導入されました。

note: Tag: para
en: Aggregate version is not explicitly defined in OGC SPEC.
ja: 集約関数版は、OGC仕様に明示的に定義されていません。

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 5.1.19 the z-index (elevation) when polygons are involved.
ja: &sqlmm_compliant; SQL-MM 3: 5.1.19 ポリゴンが含まれる時、Z値 (標高)を持ちます。

note: Tag: para
en: Aggregate example
ja: 集約関数版の例

note: Tag: para
en: Non-Aggregate example
ja: 非集約関数の例

note: Tag: para
en: 3D example - sort of supports 3D (and with mixed dimensions!)
ja: 3次元の例 - 3次元 (かつ混合次元)の種類

note: Tag: para
en: 3d example not mixing dimensions
ja: 3次元の例 - 混合次元なし

note: Tag: title
en: Geometry Processing
ja: ジオメトリ処理関数

note: Tag: para
en: These functions compute geometric constructions, or alter geometry size or shape.
ja: これらの関数は幾何的構造の計算、すなわちジオメトリのサイズや形状を変更します。

note: Tag: refpurpose
en: Computes a geometry covering all points within a given distance from a geometry.
ja: あるジオメトリからの距離が指定された距離以下となる点全ての集合となるジオメトリを返します。

note: Tag: para
en: Computes a POLYGON or MULTIPOLYGON that represents all points whose distance from a geometry/geography is less than or equal to a given distance. A negative distance shrinks the geometry rather than expanding it. A negative distance may shrink a polygon completely, in which case POLYGON EMPTY is returned. For points and lines negative distances always return empty results.
ja: ジオメトリ/ジオグラフィからの距離が与えられた距離より短くなる全ての点を表現するPOLYGONまたはMULTIPOLYGONを生成します。距離に負数を指定すると、ジオメトリは拡大されずに縮小されます。負の距離ではポリゴンを完全に縮小し切る可能性があり、その時はPOLYGON EMPTYを返します。ポイントとラインで負の距離を指定すると、常に空を返します。

note: Tag: para
en: For geometry, the distance is specified in the units of the Spatial Reference System of the geometry. For geography, the distance is specified in meters.
ja: ジオメトリの場合、指定される距離の単位は、ジオメトリの空間参照系の単位です。ジオグラフィの場合、指定される距離の単位はメートルです。

note: Tag: para
en: The optional third parameter controls the buffer accuracy and style. The accuracy of circular arcs in the buffer is specified as the number of line segments used to approximate a quarter circle (default is 8). The buffer style can be specified by providing a list of blank-separated key=value pairs as follows:
ja: 3番目のパラメータは任意で、バッファの精度とスタイルを扱います。バッファの円弧の精度は四分の一円の近似に使用される辺の数です (デフォルトは8)。バッファのスタイルは キー=値 のペアを空白区切りでリストにして指定します。キーは次の通りです。

note: Tag: para
en: 'quad_segs=#' : number of line segments used to approximate a quarter circle (default is 8).
ja: 'quad_segs=#' : 四分の一円近似に使う辺の数 (デフォルトは8)。

note: Tag: para
en: 'endcap=round|flat|square' : endcap style (defaults to "round"). 'butt' is accepted as a synonym for 'flat'.
ja: 'endcap=round|flat|square' : 終端スタイル (デフォルトは "round")。'butt'は'flat'の同義語として受け付けます。

note: Tag: para
en: 'join=round|mitre|bevel' : join style (defaults to "round"). 'miter' is accepted as a synonym for 'mitre'.
ja: 'join=round|mitre|bevel' : 接続スタイル (デフォルトは"round")。'miter'も'mitre'の同義語として受け付けます。

note: Tag: para
en: 'mitre_limit=#.#' : mitre ratio limit (only affects mitered join style). 'miter_limit' is accepted as a synonym for 'mitre_limit'.
ja: 'mitre_limit=#.#' : マイター比 (訳注: 継ぎ目の内側と外側の距離と線幅との比)の最大値 (継ぎ目スタイルがmiterである場合のみ有効)。'miter_limit'は'mitre_limit'の同義語として受け付けます。

note: Tag: para
en: 'side=both|left|right' : 'left' or 'right' performs a single-sided buffer on the geometry, with the buffered side relative to the direction of the line. This is only applicable to LINESTRING geometry and does not affect POINT or POLYGON geometries. By default end caps are square.
ja: 'side=both|left|right' : 'left'または'right'については、線の方向から見た相対的なサイドで、ジオメトリの片側バッファを実行します。これはLINESTRINGジオメトリにだけ関連して、POINTまたはPOLYGONジオメトリには影響がありません。デフォルトでは終端スタイルは四角形です。

note: Tag: para
en: &geography_transform; It determines a planar spatial reference system that best fits the bounding box of the geography object (trying UTM, Lambert Azimuthal Equal Area (LAEA) North/South pole, and finally Mercator ). The buffer is computed in the planar space, and then transformed back to WGS84. This may not produce the desired behavior if the input object is much larger than a UTM zone or crosses the dateline
ja: &geography_transform; ジオメトリのバウンディングボックスに最適な平面空間参照系を決定します (UTM、ランベルト正積方位図法の北極/南極、最後はメルカトルです)。バッファは平面空間で計算あｓれ、WGS84に戻されます。このため、入力がUTMゾーンと比べて非常に大きくなったり、日付変更線とクロスしたりする場合に、求める動作をしないことがあります

note: Tag: para
en: Buffer output is always a valid polygonal geometry. Buffer can handle invalid inputs, so buffering by distance 0 is sometimes used as a way of repairing invalid polygons. <xref linkend="ST_MakeValid"/> can also be used for this purpose.
ja: バッファ出力は常に妥当なポリゴンジオメトリです。バッファは不正な入力を処理できるので、不正なポリゴンを修復する方法として、距離0のバッファリングが使われます。同じ目的の関数としては<xref linkend="ST_MakeValid"/>が使われます。

note: Tag: para
en: Buffering is sometimes used to perform a within-distance search. For this use case it is more efficient to use <xref linkend="ST_DWithin"/>.
ja: バッファ作成は時々、距離内にある地物を検索する際に使われます。この使い方については、<xref linkend="ST_DWithin"/>の方が効率的です。

note: Tag: para
en: This function ignores the Z dimension. It always gives a 2D result even when used on a 3D geometry.
ja: この関数はZ値を無視します。この関数を3次元ジオメトリ上で使用したとしても、常に2次元の結果となります。

note: Tag: para
en: Enhanced: 2.5.0 - ST_Buffer geometry support was enhanced to allow for side buffering specification <code>side=both|left|right</code>.
ja: Enhanced: 2.5.0 - ST_Bufferのジオメトリ対応版が強化され、バッファを施す側を<code>side=both|left|right</code>で指定できるようになりました。

note: Tag: para
en: Availability: 1.5 - ST_Buffer was enhanced to support different endcaps and join types. These are useful for example to convert road linestrings into polygon roads with flat or square edges instead of rounded edges. Thin wrapper for geography was added.
ja: Availability: 1.5 - ST_Bufferが強化され、様々な終端と継ぎ目に対応するようになりました。たとえば、道路ラインストリングを道路ポリゴンに変換する際に終端を丸でなく平面や四角で処理したい場合などに使えます。ジオグラフィ用の薄いラッパが追加されました。

note: Tag: para
en: quad_segs=8 (default)
ja: quad_segs=8 (デフォルト)

note: Tag: para
en: quad_segs=2 (lame)
ja: quad_segs=2 (不十分)

note: Tag: para
en: endcap=round join=round (default)
ja: endcap=round join=round (デフォルト)

note: Tag: para
en: join=mitre mitre_limit=5.0 (default mitre limit)
ja: join=mitre mitre_limit=5.0 (デフォルトの最大マイター比)

note: Tag: para
en: right-hand-winding, polygon boundary side=left
ja: 右回り、ポリゴン境界は左

note: Tag: para
en: right-hand-winding, polygon boundary side=right
ja: 右回り、ポリゴン境界は右

note: Tag: refpurpose
en: Creates a polygonal geometry formed by the linework of a geometry.
ja: 与えられたジオメトリの構成ラインワークから面ジオメトリを生成します。

note: Tag: para
en: Creates an areal geometry formed by the constituent linework of the input geometry. The input can be a LineString, MultiLineString, Polygon, MultiPolygon or a GeometryCollection. The result is a Polygon or MultiPolygon, depending on input. If the input linework does not form polygons, NULL is returned.
ja: 入力ジオメトリの構成するラインワークから面ジオメトリを生成します。入力はLINESTRING、MULTILINESTRING、POLYGON、MULTIPOLYGON、GEOMETRYCOLLECTIONが可能です。入力ラインワークがポリゴンを形成しない場合には、NULLが返ります。

note: Tag: para
en: Unlike <xref linkend="ST_MakePolygon"/>, this function accepts rings formed by multiple lines, and can form any number of polygons.
ja: <xref linkend="ST_MakePolygon"/>と違い、この関数は複数の線で形成されたリングを受け付け、任意の数量のポリゴンを形成できます。

note: Tag: para
en: This function converts inner rings into holes. To turn inner rings into polygons as well, use <xref linkend="ST_Polygonize"/>.
ja: この関数は内側リングを穴に変換します。内側リングもポリゴンに変換したい場合には<xref linkend="ST_Polygonize"/>を使います。

note: Tag: para
en: Input linework must be correctly noded for this function to work properly. <xref linkend="ST_Node"/> can be used to node lines.
ja: この関数が確実に動作するためには、ラインワークに正しくノードが加えられていなければなりません。ラインにノードを加えるには<xref linkend="ST_Node"/>を使用します。

note: Tag: para
en: If the input linework crosses, this function will produce invalid polygons. <xref linkend="ST_MakeValid"/> can be used to ensure the output is valid.
ja: 入力ラインワークがクロスする場合には、この関数は不正なポリゴンを生成します。<xref linkend="ST_MakeValid"/>で、出力を確実に妥当なものにすることができます。

note: Tag: para
en: Input lines
ja: 入力ライン

note: Tag: para
en: Area result
ja: 結果のポリゴン

note: Tag: para
en: Create a donut from two circular polygons
ja: 二つの円ポリゴンからのドーナツの生成

note: Tag: para
en: , <xref linkend="ST_MakePolygon"/>, <xref linkend="ST_MakeValid"/>, <xref linkend="ST_Node"/>, <xref linkend="ST_Polygonize"/>, <xref linkend="ST_BdPolyFromText"/>, <xref linkend="ST_BdMPolyFromText"/> (wrappers to this function with standard OGC interface)
ja: , <xref linkend="ST_MakePolygon"/>, <xref linkend="ST_MakeValid"/>, <xref linkend="ST_Node"/>, <xref linkend="ST_Polygonize"/>, <xref linkend="ST_BdPolyFromText"/>, <xref linkend="ST_BdMPolyFromText"/> (標準ＯGCインタフェースを持つこの関数へのラッパ)

note: Tag: refpurpose
en: Returns the geometric center of a geometry.
ja: ジオメトリの幾何学的重心を返します。

note: Tag: para
en: Computes a point which is the geometric center of mass of a geometry. For [<varname>MULTI</varname>]<varname>POINT</varname>s, the centroid is the arithmetic mean of the input coordinates. For [<varname>MULTI</varname>]<varname>LINESTRING</varname>s, the centroid is computed using the weighted length of each line segment. For [<varname>MULTI</varname>]<varname>POLYGON</varname>s, the centroid is computed in terms of area. If an empty geometry is supplied, an empty <varname>GEOMETRYCOLLECTION</varname> is returned. If <varname>NULL</varname> is supplied, <varname>NULL</varname> is returned. If <varname>CIRCULARSTRING</varname> or <varname>COMPOUNDCURVE</varname> are supplied, they are converted to linestring with CurveToLine first, then same than for <varname>LINESTRING</varname>
ja: ジオメトリの幾何学的重心を計算します。[<varname>MULTI</varname>]<varname>POINT</varname>に対しては、入力座標の算術平均として計算されます。 [<varname>MULTI</varname>]<varname>LINESTRING</varname>に対しては、各辺の重み付き長さとして計算されます。 [<varname>MULTI</varname>]<varname>POLYGON</varname>に対しては、面積から計算されます。空ジオメトリが与えられた場合には、空の<varname>GEOMETRYCOLLECTION</varname>が返されます。<varname>NULL</varname>が与えられた場合には、<varname>NULL</varname>が返されます。<varname>CIRCULARSTRING</varname>または<varname>COMPOUNDCURVE</varname>が与えられた場合には、まずCurveToLineで直線に変換されてから、<varname>LINESTRING</varname>と同じ計算を行います。

note: Tag: para
en: For mixed-dimension input, the result is equal to the centroid of the component Geometries of highest dimension (since the lower-dimension geometries contribute zero "weight" to the centroid).
ja: 入力が混合次元の場合には、結果は最大次元のジオメトリの重心と同じになります (低次元ジオメトリは重心に0の「重み」を与えるためです)。

note: Tag: para
en: Note that for polygonal geometries the centroid does not necessarily lie in the interior of the polygon. For example, see the diagram below of the centroid of a C-shaped polygon. To construct a point guaranteed to lie in the interior of a polygon use <xref linkend="ST_PointOnSurface"/>.
ja: ポリゴンジオメトリに対しては、重心は必ずしもポリゴンの内部にあるわけではないことに注意して下さい。たとえば、下図のCの形のポリゴンの重心をご覧下さい。ポリゴン内部にポイントがあることを保障するには<xref linkend="ST_PointOnSurface"/>を使います。

note: Tag: para
en: New in 2.3.0 : supports <varname>CIRCULARSTRING</varname> and <varname>COMPOUNDCURVE</varname> (using CurveToLine)
ja: New in 2.3.0 : <varname>CIRCULARSTRING</varname>と<varname>COMPOUNDCURVE</varname>に対応するようになりました (CurveToLineを使います)。

note: Tag: para
en: Availability: 2.4.0 support for geography was introduced.
ja: Availability: 2.4.0 ジオグラフィが導入されました。

note: Tag: para
en: In the following illustrations the red dot is the centroid of the source geometry.
ja: 次に示す図では、赤点が入力ジオメトリの重心です。

note: Tag: para
en: Centroid of a <varname>MULTIPOINT</varname>
ja: <varname>MULTIPOINT</varname>の重心

note: Tag: para
en: Centroid of a <varname>LINESTRING</varname>
ja: <varname>LINESTRING</varname>の重心

note: Tag: para
en: Centroid of a <varname>POLYGON</varname>
ja: <varname>POLYGON</varname>の重心

note: Tag: para
en: Centroid of a <varname>GEOMETRYCOLLECTION</varname>
ja: <varname>GEOMETRYCOLLECTION</varname>の重心

note: Tag: refpurpose
en: Returns a smoothed version of a geometry, using the Chaikin algorithm
ja: チャイキンのアルゴリズムを使って、与えられたジオメトリの平滑化されたものを返します。

note: Tag: para
en: Smoothes a linear or polygonal geometry using <link xlink:href="http://www.idav.ucdavis.edu/education/CAGDNotes/Chaikins-Algorithm/Chaikins-Algorithm.html">Chaikin's algorithm</link>. The degree of smoothing is controlled by the <varname>nIterations</varname> parameter. On each iteration, each interior vertex is replaced by two vertices located at 1/4 of the length of the line segments before and after the vertex. A reasonable degree of smoothing is provided by 3 iterations; the maximum is limited to 5.
ja: <link xlink:href="http://www.idav.ucdavis.edu/education/CAGDNotes/Chaikins-Algorithm/Chaikins-Algorithm.html">チャイキンのアルゴリズム</link>を使ってラインまたはポリゴンのジオメトリの平滑化を行います。平滑化の度合いは<varname>nIterations</varname>パラメータで制御します。繰り返しごとに、各々の内部の頂点は、頂点を挟む辺の上で、長さが1/4となる位置の二つの頂点に置き換えます。平滑化の合理的な度合いは3回反復です。最大値は5に制限されています。

note: Tag: para
en: If <varname>preserveEndPoints</varname> is true, the endpoints of Polygon rings are not smoothed. The endpoints of LineStrings are always preserved.
ja: <varname>preserveEndPoints</varname>がTRUEの場合には、ポリゴンの環の終端が平滑化されません。ラインストリングの終端は常に保存されます。

note: Tag: para
en: The number of vertices doubles with each iteration, so the result geometry may have many more points than the input. To reduce the number of points use a simplification function on the result (see <xref linkend="ST_Simplify"/>, <xref linkend="ST_SimplifyPreserveTopology"/> and <xref linkend="ST_SimplifyVW"/>).
ja: 頂点数は繰り返し回数の2倍です。結果ジオメトリは入力ジオメトリより多くのポイントを含むことになります。ポイント数を減らすには、結果に対して単純化関数を実行します (<xref linkend="ST_Simplify"/>, <xref linkend="ST_SimplifyPreserveTopology"/>, <xref linkend="ST_SimplifyVW"/>を参照して下さい)。

note: Tag: para
en: The result has interpolated values for the Z and M dimensions when present.
ja: 結果には、Z値とM値が存在する場合には、これらの補間値が入ります。

note: Tag: para
en: Smoothing a triangle:
ja: 三角形の平滑化:

note: Tag: para
en: Smoothing a Polygon using 1, 2 and 3 iterations:
ja: 1, 2, 3反復を使ったポリゴンの平滑化:

note: Tag: para
en: Smoothing a LineString using 1, 2 and 3 iterations:
ja: 1, 2, 3反復を使ったラインストリングの平滑化:

note: Tag: refpurpose
en: Computes a possibly concave geometry that contains all input geometry vertices
ja: 全ての入力ジオメトリの頂点を含む凹ジオメトリを計算します。

note: Tag: para
en: A concave hull is a (usually) concave geometry which contains the input, and whose vertices are a subset of the input vertices. In the general case the concave hull is a Polygon. The concave hull of two or more collinear points is a two-point LineString. The concave hull of one or more identical points is a Point. The polygon will not contain holes unless the optional <varname>param_allow_holes</varname> argument is specified as true.
ja: 凹包は (通常は)入力ジオメトリを包含する凹ジオメトリで、凹ジオメトリの頂点は入力頂点の部分集合です。一般的に凹包はポリゴンです。二つ以上の同一線上の点の凹包は2点のラインストリングです。一つ以上の同一点の凹包はポイントです。 <varname>param_allow_holes</varname>引数ににTRUEを与えない限りポリゴンは穴を持ちません。

note: Tag: para
en: One can think of a concave hull as "shrink-wrapping" a set of points. This is different to the <link linkend="ST_ConvexHull">convex hull</link>, which is more like wrapping a rubber band around the points. A concave hull generally has a smaller area and represents a more natural boundary for the input points.
ja: 凹包はジオメトリの集合を「真空パック」したジオメトリと考えることができます。輪ゴムで囲うのに似ている<link linkend="ST_ConvexHull">凸包</link>と違います。凹包は一般的に面積が小さく、また入力ポイントからなる境界が自然になります。

note: Tag: para
en: The <varname>param_pctconvex</varname> controls the concaveness of the computed hull. A value of 1 produces the convex hull. Values between 1 and 0 produce hulls of increasing concaveness. A value of 0 produces a hull with maximum concaveness (but still a single polygon). Choosing a suitable value depends on the nature of the input data, but often values between 0.3 and 0.1 produce reasonable results.
ja: <varname>param_pctconvex</varname>は計算される凹包の凹度を制御するためのものです。1では凸包になります。1から0に変化させると凹度が増加していきます。0では最大の凹度の凹包になります (ただし単一ポリゴンのままです)。適切な値は入力データ固有のものですが、多くの場合0.3と0.1の間が適正な結果となります。

note: Tag: para
en: Technically, the <varname>param_pctconvex</varname> determines a length as a fraction of the difference between the longest and shortest edges in the Delaunay Triangulation of the input points. Edges longer than this length are "eroded" from the triangulation. The triangles remaining form the concave hull.
ja: 技術的には<varname>param_pctconvex</varname>は、入力ポイントのドロネー三角分割における最長エッジと最短エッジとの差の割合で示される長さを決定します。この長さより長いエッジは、三角分割で「浸食」されます。残りの三角形は凹包を形成します。

note: Tag: para
en: For point and linear inputs, the hull will enclose all the points of the inputs. For polygonal inputs, the hull will enclose all the points of the input <emphasis>and also</emphasis> all the areas covered by the input. If you want a point-wise hull of a polygonal input, convert it to points first using <xref linkend="ST_Points"/>.
ja: ポイントとラインの入力では、凹包は入力ポイントをポイントとラインの入力では、凹包は全ての入力ポイントを包みます。ポリゴン入力では、凹包は全ての入力ポイントを含み、<emphasis>なおかつ</emphasis>入力ポリゴンが及ぶ全ての面を含みます。ポリゴン入力でもポイントとして計算した凹包が欲しい場合には、<xref linkend="ST_Points"/>を使って、まずポイントに変換して下さい。

note: Tag: para
en: This is not an aggregate function. To compute the concave hull of a set of geometries use <xref linkend="ST_Collect"/> (e.g. <code>ST_ConcaveHull( ST_Collect( geom ), 0.80)</code>.
ja: これは集約関数ではありません。ジオメトリ集合の凹包の計算には<xref linkend="ST_Collect"/>を使います (例 <code>ST_ConcaveHull( ST_Collect( geom ), 0.80)</code>)。

note: Tag: para
en: Enhanced: 3.3.0, GEOS native implementation enabled for GEOS 3.11+
ja: Enhanced: 3.3.0, GEOS 3.11からGEOSネイティブ実装が有効になりました

note: Tag: para
en: Concave Hull of a MultiPoint
ja: マルチポイントの凹包

note: Tag: para
en: Concave Hull of a MultiPoint, allowing holes
ja: 穴を作れるマルチポイントの凹包

note: Tag: para
en: Comparing a concave hull of a Polygon to the concave hull of the constituent points. The hull respects the boundary of the polygon, whereas the points-based hull does not.
ja: ポリゴンの凹包と構成ポイントの凹包との比較。凹包はポリゴンの境界を考慮しますが、ポイントを基にした凹包では考慮されません。

note: Tag: para
en: Using with ST_Collect to compute the concave hull of a geometry set.
ja: ST_Collectの併用でジオメトリ集合の凹包の計算。

note: Tag: refpurpose
en: Computes the convex hull of a geometry.
ja: ジオメトリの凸包を計算します。

note: Tag: para
en: Computes the convex hull of a geometry. The convex hull is the smallest convex geometry that encloses all geometries in the input.
ja: ジオメトリの凸包を計算します。凸包は、入力ジオメトリのすべてを囲む最小の凸ジオメトリです。

note: Tag: para
en: One can think of the convex hull as the geometry obtained by wrapping an rubber band around a set of geometries. This is different from a <link linkend="ST_ConcaveHull">concave hull</link> which is analogous to "shrink-wrapping" the geometries. A convex hull is often used to determine an affected area based on a set of point observations.
ja: 凸包は、ジオメトリの集合に輪ゴムをかけて得られるジオメトリと見ることができます。これは「真空パック」に似ている<link linkend="ST_ConcaveHull">凹包</link>と異なります。凸包は観察ポイントの集合に基づいて、響を受けた領域を決定するために、しばしば使われます。

note: Tag: para
en: In the general case the convex hull is a Polygon. The convex hull of two or more collinear points is a two-point LineString. The convex hull of one or more identical points is a Point.
ja: 凸包は一般的にポリゴンです。二つ以上の同一線上のポイントの凸包は、2点のラインストリングになります。一つ以上の同一ポイントの凸包はポイントです。

note: Tag: para
en: This is not an aggregate function. To compute the convex hull of a set of geometries, use <xref linkend="ST_Collect"/> to aggregate them into a geometry collection (e.g. <code>ST_ConvexHull(ST_Collect(geom))</code>.
ja: 集約関数ではありません。ジオメトリ集合の凸包を計算するには、ジオメトリ集合をジオメトリコレクションに集約する<xref linkend="ST_Collect"/>を使います (<code>ST_ConvexHull(ST_Collect(geom))</code>等)。

note: Tag: para
en: Convex Hull of a MultiLinestring and a MultiPoint
ja: マルチラインストリングとマルチポイントの凸包

note: Tag: para
en: Using with ST_Collect to compute the convex hulls of geometry sets.
ja: ST_Collectを使ってジオメトリ集合の凸包を計算します。

note: Tag: refpurpose
en: Returns the Delaunay triangulation of the vertices of a geometry.
ja: ジオメトリの頂点のドローネ三角形を返します。

note: Tag: para
en: Computes the <link xlink:href="http://en.wikipedia.org/wiki/Delaunay_triangulation">Delaunay triangulation</link> of the vertices of the input geometry. The optional <varname>tolerance</varname> can be used to snap nearby input vertices together, which improves robustness in some situations. The result geometry is bounded by the convex hull of the input vertices. The result geometry representation is determined by the <varname>flags</varname> code:
ja: 入力ジオメトリの頂点の<link xlink:href="http://en.wikipedia.org/wiki/Delaunay_triangulation">ドロネー三角形</link>を計算します。任意引数<varname>tolerance</varname>は、入力頂点が近いとスナップする際に使います。ロバスト性が増すことがあります。結果ジオメトリの境界は入力頂点の凸包と同じになります。結果ジオメトリの表現は、次に示す<varname>flags</varname>コードによって変わります。

note: Tag: para
en: <code>0</code> - a GEOMETRYCOLLECTION of triangular POLYGONs (default)
ja: <code>0</code> - 三角形のPOLYGONからなるGEOMETRYCOLLECTION (デフォルト)

note: Tag: para
en: <code>1</code> - a MULTILINESTRING of the edges of the triangulation
ja: <code>1</code> - 三角形の辺のMULTILINESTRING

note: Tag: para
en: <code>2</code> - A TIN of the triangulation
ja: <code>2</code> - 三角形のTIN

note: Tag: para
en: Original polygons
ja: 元のポリゴン

note: Tag: para
en: ST_DelaunayTriangles of 2 polygons: delaunay triangle polygons each triangle themed in different color
ja: 二つのポリゴンのST_DelaunayTriangles: ポリゴンごとに異なる色をつけたドロネー三角形ポリゴン

note: Tag: para
en: -- delaunay triangles as multilinestring
ja: マルチラインストリングにしたドロネー三角形

note: Tag: para
en: -- delaunay triangles of 45 points as 55 triangle polygons
ja: 45個のポイントから生成した55個のドロネー三角形

note: Tag: para
en: Example using vertices with Z values.
ja: Z値を持つ頂点を使う例。

note: Tag: refpurpose
en: Removes vertices based on their M value
ja: M値に基づいて頂点を削除します。

note: Tag: para
en: Filters out vertex points based on their M-value. Returns a geometry with only vertex points that have a M-value larger or equal to the min value and smaller or equal to the max value. If max-value argument is left out only min value is considered. If fourth argument is left out the m-value will not be in the resulting geometry. If resulting geometry have too few vertex points left for its geometry type an empty geometry will be returned. In a geometry collection geometries without enough points will just be left out silently.
ja: M値に基づいた頂点ポイントのフィルタリングを行います。返されるジオメトリは最小値(min値)以上かつ最大値(max値)以下のM値を持つポイントだけでできています。最大値の引数が指定されていない場合には、最小値のみ考慮されます。第4引数が指定されていない場合には、M値は結果ジオメトリに存在しません。結果ジオメトリの頂点ポイントの数が、ジオメトリを構成するに必要な数に達しない場合には、空ジオメトリが返されます。ジオメトリコレクション内の、十分なポイントを持たないジオメトリ要素は消えます。

note: Tag: para
en: This function is mainly intended to be used in conjunction with ST_SetEffectiveArea. ST_EffectiveArea sets the effective area of a vertex in its m-value. With ST_FilterByM it then is possible to get a simplified version of the geometry without any calculations, just by filtering
ja: この関数は主にST_SetEffectiveAreaとの併用を意図しています。ST_SetEffectiveAreaは頂点の有効面積をM値に設定します。ST_FilterByMによるフィルタリングだけで、他の計算なしに簡略化されたジオメトリを得られます。

note: Tag: para
en: There is a difference in what ST_SimplifyVW returns when not enough points meet the criteria compared to ST_FilterByM. ST_SimplifyVW returns the geometry with enough points while ST_FilterByM returns an empty geometry
ja: ポイント数が基準を満たすのに十分でない時のST_SimplifyVWの返り値とST_FilterByMの返り値とで違いがあります。ST_FilterByMは空ジオメトリを返し、ST_SimplifyVWは十分なポイントを持つジオメトリを返します。

note: Tag: para
en: Note that the returned geometry might be invalid
ja: 返されるジオメトリは不正である場合があることに注意して下さい。

note: Tag: para
en: This function returns all dimensions, including the Z and M values
ja: この関数は全ての次元を返し、Z値もM値も残ります。

note: Tag: para
en: A linestring is filtered
ja: フィルタリングされたラインストリング

note: Tag: refpurpose
en: Generates a multipoint of random points contained in a Polygon or MultiPolygon.
ja: ポリゴン内やマルチポリゴン内にランダムなマルチポイントを生成します。

note: Tag: para
en: ST_GeneratePoints generates a multipoint consisting of a given number of pseudo-random points which lie within the input area. The optional <varname>seed</varname> is used to regenerate a deterministic sequence of points, and must be greater than zero.
ja: ST_GeneratePointsは、入力の面の内側に、与えられた数の疑似乱数によってマルチポイントを生成します。決定的な点列を生成する場合には任意パラメータ<varname>seed</varname>を使います。この際、0より大きい数を指定します。

note: Tag: para
en: Enhanced: 3.0.0, added seed parameter
ja: Enhanced: 3.0.0 seedパラメータの追加

note: Tag: para
en: Generated a multipoint consisting of 12 Points overlaid on top of original polygon using a random seed value 1996
ja: 乱数シード値に1996を使った、元のポリゴンの上に重なった12個のポイントの生成

note: Tag: para
en: Given a table of polygons s, return 12 individual points per polygon. Results will be different each time you run.
ja: ポリゴンテーブル s があって、ポリゴンごとに12の個別のポイントが返されます。結果は実行するたびに異なります。

note: Tag: refpurpose
en: Returns the geometric median of a MultiPoint.
ja: マルチポイントの幾何学的中央値を返します。

note: Tag: para
en: Computes the approximate geometric median of a MultiPoint geometry using the Weiszfeld algorithm. The geometric median is the point minimizing the sum of distances to the input points. It provides a centrality measure that is less sensitive to outlier points than the centroid (center of mass).
ja: マルチポイントジオメトリの幾何中央値の近似値を、Weiszfeldアルゴリズムを使って計算します。幾何中央値は、入力ポイントとの距離の合計を最小にするポイントです。幾何中央値によって、重心よりもはみ出しにくい中心測定ができます。

note: Tag: para
en: The algorithm iterates until the distance change between successive iterations is less than the supplied <varname>tolerance</varname> parameter. If this condition has not been met after <varname>max_iterations</varname> iterations, the function produces an error and exits, unless <varname>fail_if_not_converged</varname> is set to <code>false</code> (the default).
ja: このアルゴリズムでは、成功した回次の間の距離の変化が、<varname>tolerance</varname>パラメータよりも小さくなるまで繰り返します。<varname>max_iterations</varname>回を超えた場合には、関数は<varname>fail_if_not_converged</varname>を<code>FALSE</code>に指定している (デフォルト)場合を除いて、エラーを生成して終了します。

note: Tag: para
en: If a <varname>tolerance</varname> argument is not provided, the tolerance value is calculated based on the extent of the input geometry.
ja: <varname>tolerance</varname>値が渡されていない場合には、デフォルトの許容値は、入力ジオメトリの範囲を基に計算されます。

note: Tag: para
en: If present, the input point M values are interpreted as their relative weights.
ja: 存在する場合には、入力ポイントのM値は相対的な重みに解釈されます。

note: Tag: para
en: Enhanced: 2.5.0 Added support for M as weight of points.
ja: Enhanced: 2.5.0 ポイントの重みとしてのM値の対応が追加されました。

note: Tag: para
en: Comparison of the geometric median (red) and centroid (turquoise) of a MultiPoint.
ja: マルチポイントの幾何的中央値 (赤)と重心 (青緑)との比較。

note: Tag: refpurpose
en: Return the lines formed by sewing together a MultiLineString.
ja: MULTILINESTRINGを縫い合わせて形成したラインを返します。

note: Tag: para
en: Returns a LineString or MultiLineString formed by joining together the line elements of a MultiLineString. Lines are joined at their endpoints at 2-way intersections. Lines are not joined across intersections of 3-way or greater degree.
ja: MULTILINESTRINGの要素を結合して形成されたLINESTRINGまたはMULTILINESTRINGを返します。ラインは2方向交点の終端で結合します。ラインは3方向以上の交点では結合しません。

note: Tag: para
en: If <emphasis role="bold">directed</emphasis> is TRUE, then ST_LineMerge will not change point order within LineStrings, so lines with opposite directions will not be merged
ja: <emphasis role="bold">directed</emphasis>がTRUEの場合には、ST_LineMergeはラインストリグ内のポイントの順序を変更しないため、反対方向のラインはマージされません。

note: Tag: para
en: Only use with MultiLineString/LineStrings. Other geometry types return an empty GeometryCollection
ja: MULTILINESTRING/LINESTRINGでのみ使用します。他のジオメトリタイプでは空のGEMETRYCOLLECTIONを返します。

note: Tag: para
en: Enhanced: 3.3.0 accept a directed parameter.
ja: Enhanced: 3.3.0 directedパラメータを付け付けるようになりました。

note: Tag: para
en: Requires GEOS &gt;= 3.11.0 to use the directed parameter.
ja: directedパラメータを使うにはGEOS 3.11.0以上が必要です。

note: Tag: para
en: This function strips the M dimension.
ja: この関数はM値を取り除きます。

note: Tag: para
en: Merging lines with different orientation.
ja: 異なる向きのラインのマージ。

note: Tag: para
en: Lines are not merged across intersections with degree &gt; 2.
ja: インタセクト位置で方向数 &gt; 2 となるラインはマージされません。

note: Tag: para
en: If merging is not possible due to non-touching lines, the original MultiLineString is returned.
ja: 接触するラインが無くマージができない場合には、元のMULTILINESTRINGが返されます。

note: Tag: para
en: Lines with opposite directions are not merged if directed = TRUE.
ja: directed = TRUEの場合には、対応方向のラインはマージされません。

note: Tag: para
en: Example showing Z-dimension handling.
ja: Z値処理を示す例。

note: Tag: refpurpose
en: Computes the largest circle contained within a geometry.
ja: ジオメトリに含まれる最大の円を計算します。

note: Tag: para
en: Finds the largest circle that is contained within a (multi)polygon, or which does not overlap any lines and points. Returns a record with fields:
ja: (MULTI)POLYGONに含まれるか、全てのラインとポイントをオーバラップしない最大の円を探します。返されるレコードには次のフィールドがあります。

note: Tag: para
en: <varname>center</varname> - center point of the circle
ja: <varname>center</varname> - 円の中心点

note: Tag: para
en: <varname>nearest</varname> - a point on the geometry nearest to the center
ja: <varname>nearest</varname> - 中心に最も近い、ジオメトリ上のポイント

note: Tag: para
en: <varname>radius</varname> - radius of the circle
ja: <varname>radius</varname> - 円の半径

note: Tag: para
en: For polygonal inputs, the circle is inscribed within the boundary rings, using the internal rings as boundaries. For linear and point inputs, the circle is inscribed within the convex hull of the input, using the input lines and points as further boundaries.
ja: ポリゴン系の入力の時は、内側のリングを境界として使用して、円は境界リングに内接します。ラインやポイントの入力の時は、入力ラインとポイントを境界に使用して、円は入力の凸包に内接します。

note: Tag: para
en: Requires GEOS &gt;= 3.9.0.
ja: GEOS 3.9.0以上が必要です。

note: Tag: para
en: Maximum inscribed circle of a polygon. Center, nearest point, and radius are returned.
ja: ポリゴンの最大の内接円。中心点、最近傍点、半径が返ります。

note: Tag: para
en: Maximum inscribed circle of a multi-linestring. Center, nearest point, and radius are returned.
ja: マルチラインストリングの最大の内接円。中心点、最近点と半径が返ります。

note: Tag: refpurpose
en: Computes the largest circle not overlapping a geometry.
ja: ジオメトリとオーバラップ市内最大の円を計算します。

note: Tag: para
en: Finds the largest circle which does not overlap a set of point and line obstacles. (Polygonal geometries may be included as obstacles, but only their boundary lines are used.) The center of the circle is constrained to lie inside a polygonal boundary, which by default is the convex hull of the input geometry. The circle center is the point in the interior of the boundary which has the farthest distance from the obstacles. The circle itself is provided by the center point and a nearest point lying on an obstacle determining the circle radius.
ja: 障害物となるポイント集合またはライン集合に重ならない最大の円を探します (ポリゴンジオメトリは障害物として取り込まれますが、境界線しか使われません)。円の中心はポリゴン境界の内側に存在するという制約があります。ポリゴン境界は、デフォルトでは入力ジオメトリの凸包です。円の中心は、障害物から最も遠い距離を持つ境界の内部の点です。円自体は中心点と、円半径を決める障害物上にある点の最近傍点から決まります。

note: Tag: para
en: The circle center is determined to a given accuracy specified by a distance tolerance, using an iterative algorithm. If the accuracy distance is not specified a reasonable default is used.
ja: 円の中心は、反復的なアルゴリズムを使って、距離許容値で指定された精度に決定されます。精度距離が指定されていな場合には、妥当なデフォルトが使われます。

note: Tag: para
en: Returns a record with fields:
ja: 次のフィールドを含むレコードを返します:

note: Tag: para
en: To find the largest empty circle in the interior of a polygon, see <xref linkend="ST_MaximumInscribedCircle"/>.
ja: ポリゴン内部において最大の空の円を見つけるには、<xref linkend="ST_MaximumInscribedCircle"/>をご覧下さい。

note: Tag: para
en: Largest Empty Circle within a set of lines.
ja: ラインの集合の中で最大の空の円。

note: Tag: para
en: Largest Empty Circle within a set of points, constrained to lie in a polygon. The constraint polygon boundary must be included as an obstacle, as well as specified as the constraint for the circle center.
ja: ポリゴン内に存在する制約を課されたポイント集合内の最大の空の円。制約ポリゴンの境界は障害物として含めるとともに、円の中心の制約としても指定しなければなりません。

note: Tag: refpurpose
en: <refpurpose>Returns the smallest circle polygon that contains a geometry.</refpurpose>
ja: <refpurpose>入力ジオメトリを含む最小の円を返します。</refpurpose>

note: Tag: para
en: <para>Returns the smallest circle polygon that contains a geometry.</para>
ja: <para>入力ジオメトリを含む最小の円を返します。</para>

note: Tag: para
en: The bounding circle is approximated by a polygon with a default of 48 segments per quarter circle. Because the polygon is an approximation of the minimum bounding circle, some points in the input geometry may not be contained within the polygon. The approximation can be improved by increasing the number of segments. For applications where an approximation is not suitable <xref linkend="ST_MinimumBoundingRadius"/> may be used.
ja: 円はポリゴンで近似されます。デフォルトでは、1周の4分の1で48辺です。このポリゴンは円の最小バウンディングボックスの近似であるので、入力ジオメトリのいくつかの点はポリゴンに入らない可能性があります。この近似は辺の数を増やすことによって改善され、辺の数を増やすことで得られる不利益は小さいです。ポリゴン近似が適切でない場合のアプリケーションにおいては、<xref linkend="ST_MinimumBoundingRadius"/>を使います。

note: Tag: para
en: Use with <xref linkend="ST_Collect"/> to get the minimum bounding circle of a set of geometries.
ja: ジオメトリの集合の最小境界円を得るには<xref linkend="ST_Collect"/>と併用します。

note: Tag: para
en: To compute two points lying on the minimum circle (the "maximum diameter") use <xref linkend="ST_LongestLine"/>.
ja: 最小円 (最大対角線)上の二つのポイントを計算するには<xref linkend="ST_MinimumBoundingCircle"/>を使います。

note: Tag: para
en: The ratio of the area of a polygon divided by the area of its Minimum Bounding Circle is referred to as the <emphasis>Reock compactness score</emphasis>.
ja: ポリゴンの面積を最小包含円の面積で割った比率は、 <emphasis>Reock コンパクト度スコア</emphasis>と呼ばれます。

note: Tag: para
en: Minimum bounding circle of a point and linestring. Using 8 segs to approximate a quarter circle
ja: ポイントとラインストリングの最小包含円です。4分の1円の近似に8区分使用しています。

note: Tag: refpurpose
en: Returns the center point and radius of the smallest circle that contains a geometry.
ja: ジオメトリを完全に包含する最小円の中心ポイントと半径を返します。

note: Tag: para
en: Computes the center point and radius of the smallest circle that contains a geometry. Returns a record with fields:
ja: ジオメトリを含む最小円の中心点と半径を計算します。返されるレコードには次のフィールドがあります。

note: Tag: para
en: Availability - 2.3.0
ja: Availability: 2.3.0

note: Tag: refpurpose
en: Returns a minimum-area rectangle containing a geometry.
ja: ジオメトリを囲む最小の回転四角形を返します。

note: Tag: para
en: Returns the minimum-area rotated rectangle enclosing a geometry. Note that more than one such rectangle may exist. May return a Point or LineString in the case of degenerate inputs.
ja: ジオメトリを囲む最小の回転四角形を返します。最小回転四角形が複数個存在することがあるので注意して下さい。入力が退化している場合には、ポイントまたはラインストリングを返すことがあります。

note: Tag: para
en: Requires GEOS &gt;= 3.6.0.
ja: GEOS 3.6.0以上が必要です。

note: Tag: para
en: Oriented envelope of a point and linestring.
ja: ポイントとラインストリングの回転したエンベロープ。

note: Tag: refpurpose
en: Returns an offset line at a given distance and side from an input line.
ja: 与えられた距離と方面に入力ラインをずらしたラインを返します。

note: Tag: para
en: Return an offset line at a given distance and side from an input line. All points of the returned geometries are not further than the given distance from the input geometry. Useful for computing parallel lines about a center line.
ja: 与えられた距離と方面に入力ラインをずらしたラインを返します。返されるジオメトリの全てのポイントは、入力ジオメトリより与えられた距離以上には離れません。中心線に対する平行線を計算するのに使用します。

note: Tag: para
en: For positive distance the offset is on the left side of the input line and retains the same direction. For a negative distance it is on the right side and in the opposite direction.
ja: 距離が正の場合には、入力ラインの左側にずらして、方向が保持されます。負の場合には、右側にずらし、逆方向のラインになります。

note: Tag: para
en: Units of distance are measured in units of the spatial reference system.
ja: 距離の単位は空間参照系の単位です。

note: Tag: para
en: Note that output may be a MULTILINESTRING or EMPTY for some jigsaw-shaped input geometries.
ja: 入力ジオメトリがジグソーパズルのような形状の場合には、出力がMULTILINESTRINGまたはEMPTYになることがあるので、注意して下さい。

note: Tag: para
en: The optional third parameter allows specifying a list of blank-separated key=value pairs to tweak operations as follows:
ja: 任意指定の第3引数では、空白区切りのkey=valueペアの一覧を指定して、次のような操作をすることができます。

note: Tag: para
en: 'quad_segs=#' : number of segments used to approximate a quarter circle (defaults to 8).
ja: 'quad_segs=#' : 4分の1円区分数に近づけるために使われる区分の数 (デフォルトは8)。

note: Tag: para
en: 'join=round|mitre|bevel' : join style (defaults to "round"). 'miter' is also accepted as a synonym for 'mitre'.
ja: 'join=round|mitre|bevel' : 接続スタイル (デフォルトは"round")。'miter'も'mitre'の同義語として受け付けます。

note: Tag: para
en: 'mitre_limit=#.#' : mitre ratio limit (only affects mitred join style). 'miter_limit' is also accepted as a synonym for 'mitre_limit'.
ja: 'mitre_limit=#.#' : マイターの割合制限 (接続スタイルがマイターである場合のみ影響が出ます)。'miter_limit'も'mitre_limit'の同義語として受け付けます。

note: Tag: para
en: Behavior changed in GEOS 3.11 so offset curves now have the same direction as the input line, for both positive and negative offsets.
ja: GEOS 3.11 では動作が変更され、正と負の両方のオフセットで、オフセット曲線が入力ラインと同じ方向になりました。

note: Tag: para
en: Enhanced: 2.5 - added support for GEOMETRYCOLLECTION and MULTILINESTRING
ja: Enhanced: 2.5 - GEOMETRYCOLLECTIONとULTILINESTRINGへの対応追加

note: Tag: para
en: Compute an open buffer around roads
ja: 道路の周りの開いたバッファの算出

note: Tag: para
en: 15, 'quad_segs=4 join=round' original line and its offset 15 units.
ja: 15, 'quad_segs=4 join=round' 元のラインと15単位ずらしたライン。

note: Tag: para
en: -15, 'quad_segs=4 join=round' original line and its offset -15 units
ja: -15, 'quad_segs=4 join=round' 元のラインと-15単位ずらしたライン

note: Tag: para
en: double-offset to get more curvy, note the first reverses direction, so -30 + 15 = -15
ja: 二重にずらして曲線を得ます。1回目で逆方向にしていて、-30 + 15 = -15としています。

note: Tag: para
en: double-offset to get more curvy,combined with regular offset 15 to get parallel lines. Overlaid with original.
ja: 二重にずらして曲線を得て、順方向に15ずらして平行線を得ます。元のラインを覆います。

note: Tag: para
en: 15, 'quad_segs=4 join=bevel' shown with original line
ja: 15, 'quad_segs=4 join=bevel' と元のライン

note: Tag: para
en: 15,-15 collected, join=mitre mitre_limit=2.1
ja: join=mitre mitre_limit=2.1で、15ずらしたものと-15ずらしたものとを集めたもの。

note: Tag: refpurpose
en: Computes a point guaranteed to lie in a polygon, or on a geometry.
ja: ポリゴン内またはジオメトリ上にあるのが保証されたポイントを返します。

note: Tag: para
en: Returns a <varname>POINT</varname> which is guaranteed to lie in the interior of a surface (<varname>POLYGON</varname>, <varname>MULTIPOLYGON</varname>, and <varname>CURVEPOLYGON</varname>). In PostGIS this function also works on line and point geometries.
ja: サーフェス (<varname>POLYGON</varname>、<varname>MULTIPOLYGON</varname>、<varname>CURVEPOLYGON</varname>)の内部にあることを保証された<varname>POINT</varname>を返します。PostGISでは、この関数はラインジオメトリやポイントジオメトリでも動作します。

note: Tag: para
en: &sqlmm_compliant; SQL-MM 3: 8.1.5, 9.5.6. The specifications define ST_PointOnSurface for surface geometries only. PostGIS extends the function to support all common geometry types. Other databases (Oracle, DB2, ArcSDE) seem to support this function only for surfaces. SQL Server 2008 supports all common geometry types.
ja: &sqlmm_compliant; SQL-MM 3: 8.1.5, 9.5.6. 仕様では、サーフェスジオメトリのみのST_PointOnSurfaceが定義されています。PostGISは、すべての一般的なジオメトリタイプに対応するよう拡張しています。他のデータベース (Oracle、DB2、ArcSDE)は、サーフェスに対してのみこの機能をサポートしているようです。SQL Server 2008では、すべての一般的なジオメトリタイプに対応しています。

note: Tag: para
en: Point on surface of a <varname>MULTIPOINT</varname>
ja: <varname>MULTIPOINT</varname>に対するサーフェス上の点

note: Tag: para
en: Point on surface of a <varname>LINESTRING</varname>
ja: <varname>LINESTRING</varname>に対するサーフェス上の点

note: Tag: para
en: Point on surface of a <varname>POLYGON</varname>
ja: <varname>POLYGON</varname>に対するサーフェス上の点

note: Tag: para
en: Point on surface of a <varname>GEOMETRYCOLLECTION</varname>
ja: <varname>GEOMETRYCOLLECTION</varname>に対するサーフェス上の点

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> The result of ST_PointOnSurface is guaranteed to lie within polygons, whereas the point computed by <xref linkend="ST_Centroid"/> may be outside.
ja: <emphasis role="bold">例:</emphasis> <xref linkend="ST_Centroid"/>で計算されたポイントはポリゴンの外になる場合があるのに対して、ST_PointOnSurfaceの結果はポリゴン内に存在することが保証されます。

note: Tag: para
en: Red: point on surface; Green: centroid
ja: 赤: サーフェス上のポイント、緑: 重心

note: Tag: refpurpose
en: Computes a collection of polygons formed from the linework of a set of geometries.
ja: ジオメトリ集合のラインワークから形成されるポリゴンのコレクションを計算します。

note: Tag: para
en: Creates a GeometryCollection containing the polygons formed by the linework of a set of geometries. If the input linework does not form any polygons, an empty GeometryCollection is returned.
ja: ジオメトリの集合のラインワークで形成されるポリゴンを含むジオメトリコレクションを生成します。入力ラインワークがポリゴンを形成しない場合には、空のジオメトリコレクションを返します。

note: Tag: para
en: This function creates polygons covering all delimited areas. If the result is intended to form a valid polygonal geometry, use <xref linkend="ST_BuildArea"/> to prevent holes being filled.
ja: この関数は、区切られた領域の全てを覆うポリゴンを生成します。結果が妥当なポリゴンジオメトリになるようにするには、<xref linkend="ST_BuildArea"/>を使用して、穴が埋められないようにします。

note: Tag: para
en: The input linework must be correctly noded for this function to work properly. To ensure input is noded use <xref linkend="ST_Node"/> on the input geometry before polygonizing.
ja: この関数が正しく動作するには、入力ラインワークは正しくノードが追加されている必要があります。入力が正しくノードが追加されるようにするにはポリゴン化の前に入力ジオメトリに対して<xref linkend="ST_Node"/>を使います。

note: Tag: para
en: GeometryCollections can be difficult to handle with external tools. Use <xref linkend="ST_Dump"/> to convert the polygonized result into separate polygons.
ja: ジオメトリコレクションは外部ツールで扱うのに難しいことがあります。<xref linkend="ST_Dump"/>でポリゴン化された結果を分かれたポリゴンに変換します。

note: Tag: para
en: Polygonized result
ja: ポリゴン化の結果

note: Tag: para
en: Polygonizing a table of linestrings:
ja: ラインストリングのテーブルのポリゴン化:

note: Tag: refpurpose
en: Returns a valid geometry with points rounded to a grid tolerance.
ja: 全ての与えられたグリッド許容値に丸められたポイントからなる妥当なジオメトリを返します。

note: Tag: para
en: Returns a valid geometry with all points rounded to the provided grid tolerance, and features below the tolerance removed.
ja: 全ての与えられたグリッド許容値に丸められたポイントからなる妥当なジオメトリを返します。許容値より下の地物は削除されます。

note: Tag: para
en: Unlike <xref linkend="ST_SnapToGrid"/> the returned geometry will be valid, with no ring self-intersections or collapsed components.
ja: <xref linkend="ST_SnapToGrid"/>と違い、返されるジオメトリは妥当で、自己交差の環や崩壊した要素を伴いません。

note: Tag: para
en: Precision reduction can be used to:
ja: 精度提言は次の場合に使います。

note: Tag: para
en: match coordinate precision to the data accuracy
ja: 座標精度をデータ精度に合わせる

note: Tag: para
en: reduce the number of coordinates needed to represent a geometry
ja: ジオメトリを表現するのに必要な座標の数を減らす

note: Tag: para
en: ensure valid geometry output to formats which use lower precision (e.g. text formats such as WKT, GeoJSON or KML when the number of output decimal places is limited).
ja: 低精度書式 (出力桁数が制限されるWKT, GeoJSON, KML等のテキスト書式)への出力ジオメトリの妥当性の確保。

note: Tag: para
en: export valid geometry to systems which use lower or limited precision (e.g. SDE, Oracle tolerance value)
ja: 妥当なジオメトリの低精度や制度制限のあるシステム (SDE, Oracle許容値等)へのエクスポート

note: Tag: para
en: Precision reduction can reduce number of vertices
ja: 精度を落とすことで頂点数を減らすことができます。

note: Tag: para
en: Precision reduction splits polygons if needed to ensure validity
ja: 妥当性を確保するために必要な場合には、精度を落とす際にポリゴンを分割します。

note: Tag: refpurpose
en: Returns a collection containing paths shared by the two input linestrings/multilinestrings.
ja: 二つのLINESTRING/MULTILINESTRINGの入力が共有するパスのコレクションを返します。

note: Tag: para
en: Returns a collection containing paths shared by the two input geometries. Those going in the same direction are in the first element of the collection, those going in the opposite direction are in the second element. The paths themselves are given in the direction of the first geometry.
ja: 二つの入力ジオメトリが共有するパスのコレクションを返します。順方向に行くものはコレクションの一つ目の要素にあり、逆方向は二つ目の要素にあります。これらのパス自体は一つ目のジオメトリの方向をもとにします。

note: Tag: title
en: Examples: Finding shared paths
ja: 例: 共有パスの探索

note: Tag: para
en: A multilinestring and a linestring
ja: マルチラインストリングとラインストリング

note: Tag: para
en: The shared path of multilinestring and linestring overlaid with original geometries.
ja: マルチラインストリングとラインストリングとの共有パスと元のジオメトリ。

note: Tag: refpurpose
en: Returns a simplified representation of a geometry, using the Douglas-Peucker algorithm.
ja: Douglas-Peukerアルゴリズムを使用して、簡略化したジオメトリを返します。

note: Tag: para
en: Computes a simplified representation of a geometry using the <link xlink:href="https://en.wikipedia.org/wiki/Ramer%E2%80%93Douglas%E2%80%93Peucker_algorithm">Douglas-Peucker algorithm</link>. The simplification <varname>tolerance</varname> is a distance value, in the units of the input SRS. Simplification removes vertices which are within the tolerance distance of the simplified linework. The result may not be valid even if the input is.
ja: 単純化したジオメトリの表現を計算します。<link xlink:href="https://en.wikipedia.org/wiki/Ramer%E2%80%93Douglas%E2%80%93Peucker_algorithm">Douglas-Peucker algorithm</link> を使います。単純化の <varname>tolerance</varname> (許容値) は、距離の値で、単位は入力 SRS (空間参照系) の単位です。単純化によって、単純化された線の許容値距離内にある頂点は削除されます。入力が有効であっても結果が有効にならないことがあります。

note: Tag: para
en: The function can be called with any kind of geometry (including GeometryCollections), but only line and polygon elements are simplified. Endpoints of linear geometry are preserved.
ja: この関数は、どの種類のジオメトリでも (GEOMETRYCOLLECTION であっても) 呼ぶことができますが、ライン要素とポリゴン要素だけが単純化されます。線ジオメトリの端点は保持されます。

note: Tag: para
en: The <varname>preserveCollapsed</varname> flag retains small geometries that would otherwise be removed at the given tolerance. For example, if a 1m long line is simplified with a 10m tolerance, when <varname>preserveCollapsed</varname> is true the line will not disappear. This flag is useful for rendering purposes, to prevent very small features disappearing from a map.
ja: <varname>preserveCollapsed</varname>フラグは、与えられた許容値では削除される小さいジオメトリを保持します。たとえば、10m許容値で1m長の線をたぬんかする場合に<varname>preserveCollapsed</varname>がTRUEの場合には、このラインが消えることがありません。このフラグは、非常に小さい地物がマップから消えるのを防ぐために、地図描画目的の際に使います。

note: Tag: para
en: The returned geometry may lose its simplicity (see <xref linkend="ST_IsSimple"/>), topology may not be preserved, and polygonal results may be invalid (see <xref linkend="ST_IsValid"/>). Use <xref linkend="ST_SimplifyPreserveTopology"/> to preserve topology and ensure validity.
ja: 返されるジオメトリは単純性を喪失している場合があり (<xref linkend="ST_IsSimple"/>参照)、トポロジが保持されていないばあ外アリ、ポリゴンの結果が不正になる可能性があります (<xref linkend="ST_IsValid"/>参照)。トポロジを保全し、妥当性を確保するには、<xref linkend="ST_SimplifyPreserveTopology"/>を使います。

note: Tag: para
en: This function does not preserve boundaries shared between polygons. Use <xref linkend="ST_CoverageSimplify"/> if this is required.
ja: この関数は、ポリゴン間で共有される境界は保持されません。保持するには<xref linkend="ST_CoverageSimplify"/>を使います。

note: Tag: para
en: A circle simplified too much becomes a triangle, medium an octagon,
ja: 簡略化をやりすぎて三角形になった円、八角形になった円です。

note: Tag: para
en: Simplifying a set of lines. Lines may intersect after simplification.
ja: ラインの集合の簡略化。ラインは簡略化後のインタセクトする場合があります。

note: Tag: para
en: Simplifying a MultiPolygon. Polygonal results may be invalid.
ja: MULTIPOLYGONの簡略化。ポリゴンの結果は不正になることがあります。

note: Tag: refpurpose
en: Returns a simplified and valid representation of a geometry, using the Douglas-Peucker algorithm.
ja: Douglas-Peuckerアルゴリズムを使用して、単純化した妥当なジオメトリを返します。

note: Tag: para
en: Computes a simplified representation of a geometry using a variant of the <link xlink:href="https://en.wikipedia.org/wiki/Ramer%E2%80%93Douglas%E2%80%93Peucker_algorithm">Douglas-Peucker algorithm</link> which limits simplification to ensure the result has the same topology as the input. The simplification <varname>tolerance</varname> is a distance value, in the units of the input SRS. Simplification removes vertices which are within the tolerance distance of the simplified linework, as long as topology is preserved. The result will be valid and simple if the input is.
ja: <link xlink:href="https://en.wikipedia.org/wiki/Ramer%E2%80%93Douglas%E2%80%93Peucker_algorithm">Douglas-Peucker algorithm</link>の一種を用いて単純化したジオメトリを計算します。結果のトポロジが入力と同じになるように単純化を制限します。簡略化の<varname>tolerance</varname> (許容値)は距離値で、単位は入力SRSの単位です。簡略化によって、トポロジが保持される限り、簡略化された線の許容距離値内の頂点が削除されます。入力が妥当かつ単純な場合には、結果は妥当かつ単純です。

note: Tag: para
en: The function can be called with any kind of geometry (including GeometryCollections), but only line and polygon elements are simplified. For polygonal inputs, the result will have the same number of rings (shells and holes), and the rings will not cross. Ring endpoints may be simplified. For linear inputs, the result will have the same number of lines, and lines will not intersect if they did not do so in the original geometry. Endpoints of linear geometry are preserved.
ja: この関数は、どの種類のジオメトリ (GEOMETRYCOLLECTIONも含む)を引数にとっても呼ぶことができますが、ラインとポリゴン要素だけを単純化します。結果はリングの数は同じで、入力が相互にインタセクトしていないなら結果も相互にインタセクトしません。線ジオメトリの端点は保持されます。

note: Tag: para
en: For the same example as <xref linkend="ST_Simplify"/>, ST_SimplifyPreserveTopology prevents oversimplification. The circle can at most become a square.
ja: <xref linkend="ST_Simplify"/>と同じ例で、ST_SimplifyPreserveTopologyでは過単純化を防止します。円は少なくとも四角形にはします。

note: Tag: para
en: Simplifying a set of lines, preserving topology of non-intersecting lines.
ja: 非交差ラインのトポロジを保全した、ラインの集合の単純化を行います。

note: Tag: para
en: Simplifying a MultiPolygon, preserving topology of shells and holes.
ja: 外側リングと内側リングのトポロジを保全したMULTIPOLYGONを単純化します。

note: Tag: refpurpose
en: Computes a simplifed topology-preserving outer or inner hull of a polygonal geometry.
ja: ポリゴンジオメトリに対してトポロジを保存した状態で簡略化した外側または内側の凹包を計算します。

note: Tag: para
en: Computes a simplified topology-preserving outer or inner hull of a polygonal geometry. An outer hull completely covers the input geometry. An inner hull is completely covered by the input geometry. The result is a polygonal geometry formed by a subset of the input vertices. MultiPolygons and holes are handled and produce a result with the same structure as the input.
ja: ポリゴンジオメトリに対してトポロジを保存した状態で簡略化した外側または内側の凹包を計算します。外側の凹包は入力ジオメトリを完全に覆います。内側の凹包は完全に入力ジオメトリに覆われます。返される結果は、入力ポリゴンの頂点の部分集合から形成されるポリゴンジオメトリです。MULTIPOLUGONと穴は処理され、結果は入力ジオメトリと同じ構造になります。

note: Tag: para
en: The reduction in vertex count is controlled by the <varname>vertex_fraction</varname> parameter, which is a number in the range 0 to 1. Lower values produce simpler results, with smaller vertex count and less concaveness. For both outer and inner hulls a vertex fraction of 1.0 produces the original geometry. For outer hulls a value of 0.0 produces the convex hull (for a single polygon); for inner hulls it produces a triangle.
ja: 頂点数の減少は<varname>vertex_fraction</varname>パラメータで制御できます。0から1の範囲を取ります。小さい値では簡略化が進み、頂点数が減り、凹性が下がります。外側の凹包も内側の凹包も、vertex_fraction値が1.0では、元のジオメトリが生成されます。0.0では、外側の凹包については凸包 (単一ポリゴンの場合)が生成され、内側の凹包については三角形が生成されます。

note: Tag: para
en: The simplification process operates by progressively removing concave corners that contain the least amount of area, until the vertex count target is reached. It prevents edges from crossing, so the result is always a valid polygonal geometry.
ja: 単純化処理では、頂点数が目標に達するまで、最も少ない面積を持つ凹の角を徐々に削除しています。これによりエッジがクロスするのを防ぎ、常に妥当なポリゴンジオメトリを返します。

note: Tag: para
en: To get better results with geometries that contain relatively long line segments, it might be necessary to "segmentize" the input, as shown below.
ja: 相対的に辺が長いジオメトリでより良い結果を得るには、次のように、辺の分割を行います。

note: Tag: para
en: Requires GEOS &gt;= 3.11.0.
ja: GEOS 3.11.0以上が必要です。

note: Tag: para
en: Outer hull of a Polygon
ja: ポリゴンの外側の凹包

note: Tag: para
en: Inner hull of a Polygon
ja: ポリゴンの内側の凹包

note: Tag: para
en: Outer hull simplification of a MultiPolygon, with segmentization
ja: 中間点を挿入したマルチポリゴンの外側の凹包による簡略化

note: Tag: refpurpose
en: Returns a simplified representation of a geometry, using the Visvalingam-Whyatt algorithm
ja: Visvalingam-Whyattアルゴリズムを使用して、入力ジオメトリを簡略化したジオメトリを返します。

note: Tag: para
en: Returns a simplified representation of a geometry using the <link xlink:href="https://en.wikipedia.org/wiki/Visvalingam%E2%80%93Whyatt_algorithm">Visvalingam-Whyatt algorithm</link>. The simplification <varname>tolerance</varname> is an area value, in the units of the input SRS. Simplification removes vertices which form "corners" with area less than the tolerance. The result may not be valid even if the input is.
ja: <link xlink:href="https://en.wikipedia.org/wiki/Visvalingam%E2%80%93Whyatt_algorithm">Visvalingam-Whyattアルゴリズム</link>を使用して、入力ジオメトリを簡略化したジオメトリを返します。<varname>tolerance</varname>は面積値で、単位は入力SRSの単位です。単純化によって、許容値より小さい面積の「角」となる頂点が削除されます。入力が妥当な場合にでも、結果が不正になる場合があります。

note: Tag: para
en: The returned geometry may lose its simplicity (see <xref linkend="ST_IsSimple"/>), topology may not be preserved, and polygonal results may be invalid (see <xref linkend="ST_IsValid"/>). Use <xref linkend="ST_SimplifyPreserveTopology"/> to preserve topology and ensure validity. <xref linkend="ST_CoverageSimplify"/> also preserves topology and validity.
ja: 返されるジオメトリは単純性を喪失している場合があり (<xref linkend="ST_IsSimple"/>を参照)、トポロジが保持されていない可能性があり、ポリゴンの結果が不正になる場合があります (<xref linkend="ST_IsValid"/>参照)。トポロジを保全し、妥当性を確保するには、<xref linkend="ST_SimplifyPreserveTopology"/>を使います。<xref linkend="ST_CoverageSimplify"/>でもトポロジ保全と妥当性確保ができます。

note: Tag: para
en: This function handles 3D and the third dimension will affect the result.
ja: この関数は3次元を扱います。第3次元は結果に影響を与えます。

note: Tag: para
en: A LineString is simplified with a minimum-area tolerance of 30.
ja: LINESTRINGは30の最小面積の許容値を30にして簡略化しています。

note: Tag: para
en: Simplifying a line.
ja: 線の単純化。

note: Tag: para
en: Simplifying a polygon.
ja: ポリゴンの単純化。

note: Tag: refpurpose
en: Sets the effective area for each vertex, using the Visvalingam-Whyatt algorithm.
ja: Visvalingam-Whyattアルゴリズムを使って有効範囲となる個々の頂点を置きます。

note: Tag: para
en: Sets the effective area for each vertex, using the Visvalingam-Whyatt algorithm. The effective area is stored as the M-value of the vertex. If the optional "threshold" parameter is used, a simplified geometry will be returned, containing only vertices with an effective area greater than or equal to the threshold value.
ja: Visvalingam-Whyattアルゴリズムから有効範囲となる個々の頂点を置きます。有効範囲はジオメトリのM値として格納されます。任意引数である第2引数を使うと、しきい値以上の有効範囲となる頂点だけで構築されるジオメトリを返します。

note: Tag: para
en: This function can be used for server-side simplification when a threshold is specified. Another option is to use a threshold value of zero. In this case, the full geometry will be returned with effective areas as M-values, which can be used by the client to simplify very quickly.
ja: この関数は、しきい値を使うことでサーバサイド簡略化に使えます。もう一つの任意引数はしきい値を0にする際に使用します。この場合、完全なジオメトリを得ますが、クライアントが非常に高速に簡略化するために使うM値として格納している有効範囲を持っています。

note: Tag: para
en: Will actually do something only with (multi)lines and (multi)polygons but you can safely call it with any kind of geometry. Since simplification occurs on a object-by-object basis you can also feed a GeometryCollection to this function.
ja: (MULTI)LINEと(MULTI)POLYGONとで実際に動作をしますが、どのような種類のジオメトリでも安全に呼ぶことができます。簡略化はオブジェクトごとに行われるので、ジオメトリコレクションでこの関数を呼ぶことができます。

note: Tag: para
en: Note that returned geometry might lose its simplicity (see <xref linkend="ST_IsSimple"/>)
ja: 返されるジオメトリは単純性 (<xref linkend="ST_IsSimple"/>参照)を失うことがあります。

note: Tag: para
en: Note topology may not be preserved and may result in invalid geometries. Use (see <xref linkend="ST_SimplifyPreserveTopology"/>) to preserve topology.
ja: トポロジは保存されているとは限らず、不正なジオメトリを返すことがあります。トポロジを保存するには<xref linkend="ST_SimplifyPreserveTopology"/>を使います。

note: Tag: para
en: The output geometry will lose all previous information in the M-values
ja: 出力ジオメトリは、入力時に持っていたM値の情報の全てを失います。

note: Tag: para
en: This function handles 3D and the third dimension will affect the effective area
ja: この関数は3次元を扱います。第3次元は結果に影響を与えます。

note: Tag: para
en: Calculating the effective area of a LineString. Because we use a threshold value of zero, all vertices in the input geometry are returned.
ja: ラインストリングの有効範囲の計算。しきい値を0にしているので、入力ジオメトリの全ての頂点が返ります。

note: Tag: refpurpose
en: Computes the constrained Delaunay triangulation of polygons
ja: ポリゴンの制約付きドロネー三角分割を計算します。

note: Tag: para
en: Computes the constrained Delaunay triangulation of polygons. Holes and Multipolygons are supported.
ja: ポリゴンの制約付きドロネー三角分割を計算します。穴やMULTIPOLYGONに対応しています。

note: Tag: para
en: The "constrained Delaunay triangulation" of a polygon is a set of triangles formed from the vertices of the polygon, and covering it exactly, with the maximum total interior angle over all possible triangulations. It provides the "best quality" triangulation of the polygon.
ja: ポリゴンの「制約付きドロネー三角分割」は、ポリゴンの頂点から形成された三角形の集合で、ポリゴンを確実に覆い、内角和が考えられる三角分割の中で最大になります。この関数によって、ポリゴンの「最高品質」の三角分割が得られます。

note: Tag: para
en: Triangulation of a square.
ja: 正方形の三角分割。

note: Tag: para
en: Triangulation of the letter P.
ja: 文字Pの三角分割。

note: Tag: para
en: Polygon Triangulation
ja: ポリゴンの三角分割

note: Tag: title
en: Same example as ST_Tesselate
ja: ST_Tesselateと同じ例

note: Tag: para
en: ST_AsText output
ja: ST_AsTextの出力:

note: Tag: para
en: Original polygon
ja: 元のポリゴン

note: Tag: para
en: Triangulated Polygon
ja: 三角分割したポリゴン

note: Tag: refpurpose
en: Returns the boundaries of the Voronoi diagram of the vertices of a geometry.
ja: ジオメトリの頂点からボロノイ図のセルを返します。

note: Tag: para
en: Computes a two-dimensional <link xlink:href="https://en.wikipedia.org/wiki/Voronoi_diagram">Voronoi diagram</link> from the vertices of the supplied geometry and returns the boundaries between cells in the diagram as a MultiLineString. Returns null if input geometry is null. Returns an empty geometry collection if the input geometry contains only one vertex. Returns an empty geometry collection if the <varname>extend_to</varname> envelope has zero area.
ja: 与えられたジオメトリの頂点から2次元<link xlink:href="https://ja.wikipedia.org/wiki/ボロノイ図">ボロノイ図</link>を生成し、ボロノイ図のサイト間の境界をMULTILIESTRINGで返します。入力ジオメトリがNULLの場合にはNULLを返します。入力ジオメトリの頂点が一つの場合には空ジオメトリを返します。<varname>extend_to</varname>で作られるエンベロープの面積が0の場合には空ジオメトリを返します。

note: Tag: para
en: Optional parameters:
ja: 任意パラメータ:

note: Tag: para
en: <varname>tolerance</varname>: The distance within which vertices will be considered equivalent. Robustness of the algorithm can be improved by supplying a nonzero tolerance distance. (default = 0.0)
ja: <varname>tolerance</varname>: 複数の頂点を同一のものと捉える距離。0でない値を許容距離として与えるとアルゴリズムのロバスト性が改善します (デフォルトは0.0)。

note: Tag: para
en: <varname>extend_to</varname>: If present, the diagram is extended to cover the envelope of the supplied geometry, unless smaller than the default envelope (default = NULL, default envelope is the bounding box of the input expanded by about 50%).
ja: <varname>extend_to</varname>: これが与えられている場合には、与えられたジオメトリのエンベロープを覆うように図が拡張されます。デフォルト値以上でないと有効ではありません (デフォルトはNULLで、デフォルトのエンベロープは入力ジオメトリのバウンディングボックスから50%拡張したものです)。

note: Tag: para
en: Voronoi diagram lines, with tolerance of 30 units
ja: 30単位の許容距離を持つボロノイ図のライン

note: Tag: refpurpose
en: Returns the cells of the Voronoi diagram of the vertices of a geometry.
ja: ジオメトリの頂点からボロノイ図のセルを返します。

note: Tag: para
en: Computes a two-dimensional <link xlink:href="https://en.wikipedia.org/wiki/Voronoi_diagram">Voronoi diagram</link> from the vertices of the supplied geometry. The result is a GEOMETRYCOLLECTION of POLYGONs that covers an envelope larger than the extent of the input vertices. Returns null if input geometry is null. Returns an empty geometry collection if the input geometry contains only one vertex. Returns an empty geometry collection if the <varname>extend_to</varname> envelope has zero area.
ja: 与えられたジオメトリの頂点から2次元<link xlink:href="https://ja.wikipedia.org/wiki/ボロノイ図">ボロノイ図</link>を生成します。結果はPOLYGONのGEOMETRYCOLLECTIONで、、入力の頂点の範囲以上のエンベロープを覆います。入力ジオメトリがNULLの場合にはNULLを返します。入力ジオメトリの頂点が一つの場合には空ジオメトリを返します。<varname>extend_to</varname>で作られるエンベロープの面積が0の場合には空ジオメトリを返します。

note: Tag: para
en: Points overlaid on top of Voronoi diagram
ja: ボロノイ図の上にポイントを置いた図

note: Tag: para
en: Voronoi diagram, with tolerance of 30 units
ja: 許容距離30単位のボロノイ図

note: Tag: title
en: Raster Reference
ja: ラスタ リファレンス

note: Tag: para
en: The functions given below are the ones which a user of PostGIS Raster is likely to need and which are currently available in PostGIS Raster. There are other functions which are required support functions to the raster objects which are not of use to a general user.
ja: ここで挙げる関数は、PostGISラスタにとって必要と思われるもので、現在PostGISラスタで有効なものです。他に、一般的なユーザが利用しない、ラスタオブジェクトに対して求められるサポート関数があります。

note: Tag: para
en: <varname>raster</varname> is a new PostGIS type for storing and analyzing raster data.
ja: <varname>raster</varname>は、ラスタデータの格納と分析のための新しいPostGIS型です。

note: Tag: para
en: For loading rasters from raster files please refer to <xref linkend="RT_Loading_Rasters"/>
ja: ラスタファイルからラスタをロードするには<xref linkend="RT_Loading_Rasters"/>を参照して下さい。

note: Tag: para
en: For the examples in this reference we will be using a raster table of dummy rasters - Formed with the following code
ja: このリファレンスにおける例ではダミーラスタのラスタテーブルを使っています。ラスタは次のようなコードで形成しています。

note: Tag: title
en: Raster Support Data types
ja: ラスタサポートデータ型

note: Tag: para
en: This section lists the PostgreSQL data types specifically created to support raster functionality.
ja: 本節では、ラスタ機能をサポートするために作られたPostgreSQLデータ型の一覧を挙げます。

note: Tag: refpurpose
en: A spatial datatype with two fields - geom (holding a geometry object) and val (holding a double precision pixel value from a raster band).
ja: geom (ジオメトリオブジェクトを保持)とval (ラスタバンドからのピクセル値を倍精度浮動小数点数で保持)の2フィールドからなるデータ型。

note: Tag: para
en: geomval is a compound data type consisting of a geometry object referenced by the .geom field and val, a double precision value that represents the pixel value at a particular geometric location in a raster band. It is used by the ST_DumpAsPolygon and Raster intersection family of functions as an output type to explode a raster band into geometry polygons.
ja: geomvalは.geomフィールドで参照されるジオメトリオブジェクトと、特定の地理位置におけるラスタバンドのピクセル値を表現する浮動小数点数のvalからなる複合型です。ポリゴンにラスタバンドを展開するための出力型として、ST_DumpAsPolygonとラスタのインタセクション関連関数群に使われます。

note: Tag: refpurpose
en: <refpurpose>A composite type used as input into the ST_AddBand function defining the attributes and initial value of the new band.</refpurpose>
ja: <refpurpose>ST_AddBandの入力に使われる複合型で、新しいバンドの属性と初期値からなります。</refpurpose>

note: Tag: para
en: <para>A composite type used as input into the ST_AddBand function defining the attributes and initial value of the new band.</para>
ja: <para>ST_AddBandの入力に使われる複合型で、新しいバンドの属性と初期値からなります。</para>

note: Tag: para
en: 1-based value indicating the position where the new band will be added amongst the raster's bands. If NULL, the new band will be added at the end of the raster's bands.
ja: ラスタのバンド群のうち新しいバンドが追加される位置を示す1始まりの値。NULLの場合には、新しいバンドはラスタバンド群の末尾に追加されます。

note: Tag: para
en: Pixel type of the new band. One of defined pixel types as described in <xref linkend="RT_ST_BandPixelType"/>.
ja: 新しいバンドのピクセルタイプ。定義されたピクセルタイプは<xref linkend="RT_ST_BandPixelType"/>に記述されています。

note: Tag: para
en: Initial value that all pixels of new band will be set to.
ja: 新しいバンドに設定する初期値。

note: Tag: para
en: NODATA value of the new band. If NULL, the new band will not have a NODATA value assigned.
ja: 新しいバンドのNODATA値。NULLの場合には、新しいバンドにNODATA値を設定しません。

note: Tag: refpurpose
en: <refpurpose>A composite type for use when needing to express a raster and a band index of that raster.</refpurpose>
ja: <refpurpose>ラスタとそのバンドインデックスを表現する必要がある時に使われる複合型。</refpurpose>

note: Tag: para
en: <para>A composite type for use when needing to express a raster and a band index of that raster.</para>
ja: <para>ラスタとそのバンドインデックスを表現する必要がある時に使われる複合型。</para>

note: Tag: para
en: The raster in question/
ja: 問題にするラスタ。

note: Tag: para
en: 1-based value indicating the band of raster
ja: ラスタのバンドを示す1始まりの値。

note: Tag: refpurpose
en: raster spatial data type.
ja: ラスタ空間データ型。

note: Tag: para
en: raster is a spatial data type used to represent raster data such as those imported from JPEGs, TIFFs, PNGs, digital elevation models. Each raster has 1 or more bands each having a set of pixel values. Rasters can be georeferenced.
ja: rasterは、JPEG, TIFF, PNG, デジタル標高モデルといったラスタデータを表現する空間データ型です。ラスタはそれぞれ1以上のバンドを持ち、バンドはそれぞれにピクセル値の集合を持ちます。ラスタには地理参照を与えることができます。

note: Tag: para
en: Requires PostGIS be compiled with GDAL support. Currently rasters can be implicitly converted to geometry type, but the conversion returns the <xref linkend="RT_ST_ConvexHull"/> of the raster. This auto casting may be removed in the near future so don't rely on it.
ja: PostGISをGDALサポート付きでコンパイルする必要があります。 現在、ラスタは暗黙にジオメトリ型に変換することができますが、ラスタの<xref linkend="RT_ST_ConvexHull"/>を返します。この自動キャストは近いうちに削除するかも知れないので、この関数に頼らないようにして下さい。

note: Tag: refpurpose
en: <refpurpose>A composite type used as input into the ST_Reclass function defining the behavior of reclassification.</refpurpose>
ja: <refpurpose>ST_Reclass関数への入力として使用する複合型です。再分類の挙動を定義します。</refpurpose>

note: Tag: para
en: <para>A composite type used as input into the ST_Reclass function defining the behavior of reclassification.</para>
ja: <para>ST_Reclass関数への入力として使用する複合型です。再分類の挙動を定義します。</para>

note: Tag: para
en: The band number of band to reclassify.
ja: 再分類対象バンドの番号。

note: Tag: para
en: range expression consisting of comma delimited range:map_range mappings. : to define mapping that defines how to map old band values to new band values. ( means &gt;, ) means less than, ] &lt; or equal, [ means &gt; or equal
ja: コンマ区切りの範囲表現。古い値から新しい値にマップする方法を定義します。 '('は「これより大きい」、')'は「これより小さい」、'['は「これ以上」、']'は「これ以下」、をそれぞれ示します。

note: Tag: para
en: ( notation is optional so a-b means the same as (a-b)
ja: '('標記は必須ではありません。'a-b'は'(a-b)'と同じ意味になります。

note: Tag: para
en: One of defined pixel types as described in <xref linkend="RT_ST_BandPixelType"/>
ja: <xref linkend="RT_ST_BandPixelType"/>の記述にあるピクセルタイプの一つ。

note: Tag: para
en: Value to treat as no data. For image outputs that support transparency, these will be blank.
ja: NODATAとして扱う値。透過が可能な画像出力では、この値は空白になります。

note: Tag: title
en: Example: Reclassify band 2 as an 8BUI where 255 is nodata value
ja: 例: 2番バンドを8BUIで255をNODATAに再分類

note: Tag: title
en: Example: Reclassify band 1 as an 1BB and no nodata value defined
ja: 例: 1番バンドを1BBでNODATAを定義しないで再分類

note: Tag: refpurpose
en: A composite type returned by the ST_SummaryStats and ST_SummaryStatsAgg functions.
ja: ST_SummaryStats関数とST_SummaryStatsAgg関数の出力として使う複合型です。

note: Tag: para
en: A composite type returned by the <xref linkend="RT_ST_SummaryStats"/> and <xref linkend="RT_ST_SummaryStatsAgg"/> functions.
ja: <xref linkend="RT_ST_SummaryStats"/>関数と<xref linkend="RT_ST_SummaryStatsAgg"/>関数の出力として使う複合型です。

note: Tag: para
en: Number of pixels counted for the summary statistics.
ja: 統計情報で使ったピクセルの数。

note: Tag: para
en: Sum of all counted pixel values.
ja: 統計情報で使ったピクセルの値の合計。

note: Tag: para
en: Arithmetic mean of all counted pixel values.
ja: 統計情報で使ったピクセルの値の平均。

note: Tag: para
en: Standard deviation of all counted pixel values.
ja: 統計情報で使ったピクセルの値の標準偏差。

note: Tag: para
en: Minimum value of counted pixel values.
ja: 統計情報で使ったピクセルの値の最小値。

note: Tag: para
en: Maximum value of counted pixel values.
ja: 統計情報で使ったピクセルの値の最大値。

note: Tag: refpurpose
en: <refpurpose>A composite type used as input into the ST_Union function defining the bands to be processed and behavior of the UNION operation.</refpurpose>
ja: <refpurpose>ST_Union関数の入力に使う複合型です。処理するバンドと結合処理の挙動を定義します。</refpurpose>

note: Tag: para
en: <para>A composite type used as input into the ST_Union function defining the bands to be processed and behavior of the UNION operation.</para>
ja: <para>ST_Union関数の入力に使う複合型です。処理するバンドと結合処理の挙動を定義します。</para>

note: Tag: para
en: 1-based value indicating the band of each input raster to be processed.
ja: 処理する入力ラスタごとのバンドを示す1始まりの値です。

note: Tag: para
en: Type of UNION operation. One of defined types as described in <xref linkend="RT_ST_Union"/>.
ja: 結合処理の種別。<xref linkend="RT_ST_Union"/>に記述がある、定義された種別のうち一つを取ります。

note: Tag: title
en: Raster Management
ja: ラスタ管理

note: Tag: refpurpose
en: Adds raster constraints to a loaded raster table for a specific column that constrains spatial ref, scaling, blocksize, alignment, bands, band type and a flag to denote if raster column is regularly blocked. The table must be loaded with data for the constraints to be inferred. Returns true if the constraint setting was accomplished and issues a notice otherwise.
ja: ロードされたラスタテーブルの特定のカラムにラスタ制約を追加します。制約には空間参照系、スケール、ブロックサイズ、アラインメント、バンド数、バンド型、ラスタカラムが規則正しいブロックかどうかを示すフラグがあります。テーブルは制約が推論されるためのデータがロードされなければなりません。制約の設定が完了するとtrueを返し、問題があると通知を返します。

note: Tag: para
en: Generates constraints on a raster column that are used to display information in the <varname>raster_columns</varname> raster catalog. The <varname>rastschema</varname> is the name of the table schema the table resides in. The <varname>srid</varname> must be an integer value reference to an entry in the SPATIAL_REF_SYS table.
ja: ラスタカラム上に、ラスタカタログ<varname>raster_columns</varname>で情報を表示するために使われる制約を生成します。<varname>rastschema</varname>は、テーブルがあるテーブルスキーマの名前です。<varname>srid</varname>はSPATIAL_REF_SYSテーブル内のエントリを参照する整数でなければなりません。

note: Tag: para
en: <varname>raster2pgsql</varname> loader uses this function to register raster tables
ja: <varname>raster2pgsql</varname>はこの関数を使ってラスタテーブルを登録します。

note: Tag: para
en: Valid constraint names to pass in: refer to <xref linkend="RT_Raster_Columns"/> for more details.
ja: 渡すのに妥当な制約名は次の通りです。詳細情報については<xref linkend="RT_Raster_Columns"/>を参照して下さい。

note: Tag: para
en: <varname>blocksize</varname> sets both X and Y blocksize
ja: <varname>blocksize</varname> ブロックのXとY両方のサイズを指定します

note: Tag: para
en: <varname>blocksize_x</varname> sets X tile (width in pixels of each tile)
ja: <varname>blocksize_x</varname> Xタイル(タイル毎のピクセル幅)を設定します

note: Tag: para
en: <varname>blocksize_y</varname> sets Y tile (height in pixels of each tile)
ja: <varname>blocksize_y</varname> Yタイル(タイル毎のピクセル幅)を設定します

note: Tag: para
en: <varname>extent</varname> computes extent of whole table and applies constraint all rasters must be within that extent
ja: <varname>extent</varname> テーブル全体の範囲を計算し、全てのラスタがこの範囲内にある制約を適用します

note: Tag: para
en: <varname>num_bands</varname> number of bands
ja: <varname>num_bands</varname> バンド数

note: Tag: para
en: <varname>pixel_types</varname> reads array of pixel types for each band ensure all band n have same pixel type
ja: <varname>pixel_types</varname> バンドごとにピクセルタイプを読み、全てのバンドが同じピクセルタイプであることを確認します。

note: Tag: para
en: <varname>regular_blocking</varname> sets spatially unique (no two rasters can be spatially the same) and coverage tile (raster is aligned to a coverage) constraints
ja: <varname>regular_blocking</varname> 空間的に一意 (二つのラスタが空間的に同じにならない)であり、カバレッジタイル (ラスタがカバレッジに整列する)制約であるようにします。

note: Tag: para
en: <varname>same_alignment</varname> ensures they all have same alignment meaning any two tiles you compare will return true for. Refer to <xref linkend="RT_ST_SameAlignment"/>.
ja: <varname>same_alignment</varname> 同じアラインメントを持つようにします。任意の2タイルについて比較するとtrueを返すという意味です。<xref linkend="RT_ST_SameAlignment"/>を参照して下さい。

note: Tag: para
en: <varname>srid</varname> ensures all have same srid
ja: <varname>srid</varname> 全て同じSRIDを持っていることを確認するためのものです。

note: Tag: para
en: More -- any listed as inputs into the above functions
ja: その他 -- 上の関数への入力で一覧が挙げられています。

note: Tag: para
en: This function infers the constraints from the data already present in the table. As such for it to work, you must create the raster column first and then load it with data.
ja: この関数はテーブル内に存在するデータから制約を推論します。動作させるには、まずラスタカラムを生成し、その後にデータをロードする必要があります。

note: Tag: para
en: If you need to load more data in your tables after you have already applied constraints, you may want to run the DropRasterConstraints if the extent of your data has changed.
ja: 制約を適用した後にデータをさらにロードする必要がある場合には、データ範囲が変わるならDropRasterConstraintsを使います。

note: Tag: title
en: Examples: Apply all possible constraints on column based on data
ja: 例: カラムに対して全てのありえる制約をデータに基づいて適用する

note: Tag: title
en: Examples: Apply single constraint
ja: 例: 単一の制約を適用する

note: Tag: refpurpose
en: Drops PostGIS raster constraints that refer to a raster table column. Useful if you need to reload data or update your raster column data.
ja: ラスタテーブルカラムを参照するPostGISラスタ制約を削除します。データの再読み込みやラスタカラムデータの更新の際に使えます。

note: Tag: para
en: Drops PostGIS raster constraints that refer to a raster table column that were added by <xref linkend="RT_AddRasterConstraints"/>. Useful if you need to load more data or update your raster column data. You do not need to do this if you want to get rid of a raster table or a raster column.
ja: <xref linkend="RT_AddRasterConstraints"/>で追加された、ラスタテーブルカラムを参照するPostGISラスタ制約を削除します。データの追加ロードやラスタカラムデータの更新で使えます。ラスタテーブルまたはラスタカラムのridを取得したい場合には使う必要がありません。

note: Tag: para
en: To drop a raster table use the standard
ja: ラスタテーブルを削除するには、次の標準的なSQLを使います。

note: Tag: para
en: To drop just a raster column and leave the rest of the table, use standard SQL
ja: ラスタカラムを削除してテーブルの残りのカラムを置いておくには、次の標準的なSQLを使います。

note: Tag: para
en: the table will disappear from the <varname>raster_columns</varname> catalog if the column or table is dropped. However if only the constraints are dropped, the raster column will still be listed in the <varname>raster_columns</varname> catalog, but there will be no other information about it aside from the column name and table.
ja: カラムまたはテーブルが削除されると、テーブルは<varname>raster_columns</varname>カタログから見えなくなります。しかしながら、制約だけが削除されたので、ラスタカラムはなお<varname>raster_columns</varname>カタログに残ります。ただし、カラム名とテーブルからの内部に関する他の情報は存在しません。

note: Tag: refpurpose
en: Tag a raster column as being an overview of another.
ja: ラスタカラムに対して、他のオーバビューであることをタグ付けします。

note: Tag: para
en: Adds constraints on a raster column that are used to display information in the <varname>raster_overviews</varname> raster catalog.
ja: <varname>raster_overviews</varname>ラスタカタログ内の情報を表示するために使われるラスタカラムに制約を追加します。

note: Tag: para
en: The <varname>ovfactor</varname> parameter represents the scale multiplier in the overview column: higher overview factors have lower resolution.
ja: <varname>ovfactor</varname>引数は、オーバビューカラムの縮尺乗数を示します。縮尺乗数は大きいほど低い解像度になります。

note: Tag: para
en: When the <varname>ovschema</varname> and <varname>refschema</varname> parameters are omitted, the first table found scanning the <varname>search_path</varname> will be used.
ja: <varname>ovschema</varname>と<varname>refschema</varname>が省略されると、<varname>search_path</varname>を走査して発見した最初のテーブルを使います。

note: Tag: refpurpose
en: Untag a raster column from being an overview of another.
ja: ラスタカラムに対して他のオーバビューであることをタグ付けしているのを解除します。

note: Tag: para
en: Remove from a raster column the constraints used to show it as being an overview of another in the <varname>raster_overviews</varname> raster catalog.
ja: ラスタカラムから、<varname>raster_overviews</varname>ラスタカタログ内にある、他のラスタのオーバビューであるこをと示すために使われる制約を削除します。

note: Tag: para
en: When the <varname>ovschema</varname> parameter is omitted, the first table found scanning the <varname>search_path</varname> will be used.
ja: <varname>ovschema</varname>が省略されると、<varname>search_path</varname>を走査して発見した最初のテーブルを使います。

note: Tag: refpurpose
en: Reports the version of the GDAL library in use by PostGIS.
ja: PostGISで使っているGDALライブラリの版を報告します。

note: Tag: para
en: Reports the version of the GDAL library in use by PostGIS. Will also check and report if GDAL can find its data files.
ja: PostGISで使っているGDALライブラリの版を報告します。GDALがデータファイルを発見できるかについてもチェックして、報告します。

note: Tag: refpurpose
en: Reports full raster library build date.
ja: 完全なラスタライブラリをビルドした日付を報告します。

note: Tag: para
en: Reports raster build date
ja: ラスタをビルドした日付を報告します。

note: Tag: refpurpose
en: <refpurpose>Reports full raster version and build configuration infos.</refpurpose>
ja: <refpurpose>完全なラスタの版とビルドコンフィギュレーション情報を報告します。</refpurpose>

note: Tag: para
en: <para>Reports full raster version and build configuration infos.</para>
ja: <para>完全なラスタの版とビルドコンフィギュレーション情報を報告します。</para>

note: Tag: refpurpose
en: Returns a list of raster formats supported by PostGIS through GDAL. Only those formats with can_write=True can be used by ST_AsGDALRaster
ja: 使用しているGDALライブラリが対応するラスタ書式の一覧を返します。この一覧でcan_write=TrueとなっているものだけがST_AsGDALRasterで使えます。

note: Tag: para
en: Returns a list of raster formats short_name,long_name and creator options of each format supported by GDAL. Use the short_name as input in the <varname>format</varname> parameter of <xref linkend="RT_ST_AsGDALRaster"/>. Options vary depending on what drivers your libgdal was compiled with. <varname>create_options</varname> returns an xml formatted set of CreationOptionList/Option consisting of name and optional <varname>type</varname>, <varname>description</varname> and set of <varname>VALUE</varname> for each creator option for the specific driver.
ja: 使用しているGDALライブラリが対応するラスタ書式のshort_name, long_nameと作成オプションの一覧を返します。short_nameは、<xref linkend="RT_ST_AsGDALRaster"/>の<varname>format</varname>パラメタに使います。オプションはGDALライブラリのコンパイルに使ったドライバに依存します。<varname>create_options</varname>は、XML形式のCretionOptionList/Optionの集合で、ドライバごとの生成オプションごとに、名前を持ち、追加情報の<varname>type</varname>, <varname>description</varname>と<varname>VALUE</varname>の集合を持ちます。

note: Tag: para
en: Changed: 2.5.0 - add can_read and can_write columns.
ja: Changed: 2.5.0 - can_readカラムとcan_writeカラムを追加。

note: Tag: para
en: Changed: 2.0.6, 2.1.3 - by default no drivers are enabled, unless GUC or Environment variable gdal_enabled_drivers is set.
ja: Changed: 2.0.6, 2.1.3 - GUC (訳注: Grand Unified Configurationの略で、動的に変更できるPostgreSQLパラメータ)または環境変数gdal_enabled_driversが設定されていないデフォルトではドライバが全て無効になりました。

note: Tag: para
en: Availability: 2.0.0 - requires GDAL &gt;= 1.6.0.
ja: Availability: 2.0.0 - GDAL 1.6.0以上が必要です。

note: Tag: title
en: Examples: List of Drivers
ja: 例: ドライバ一覧

note: Tag: title
en: Example: List of options for each driver
ja: 例: ドライバ毎のオプション一覧

note: Tag: refpurpose
en: <refpurpose>Generates a set of vector contours from the provided raster band, using the <link xlink:href="https://gdal.org/api/gdal_alg.html?highlight=contour#_CPPv421GDALContourGenerateEx15GDALRasterBandHPv12CSLConstList16GDALProgressFuncPv">GDAL contouring algorithm</link>.</refpurpose>
ja: <refpurpose>与えられたラスタバンドから等高線ベクタを生成します。<link xlink:href="https://gdal.org/api/gdal_alg.html?highlight=contour#_CPPv421GDALContourGenerateEx15GDALRasterBandHPv12CSLConstList16GDALProgressFuncPv">GDAL等高線生成アルゴリズム</link>を使います。</refpurpose>

note: Tag: para
en: <para>Generates a set of vector contours from the provided raster band, using the <link xlink:href="https://gdal.org/api/gdal_alg.html?highlight=contour#_CPPv421GDALContourGenerateEx15GDALRasterBandHPv12CSLConstList16GDALProgressFuncPv">GDAL contouring algorithm</link>.</para>
ja: <para>与えられたラスタバンドから等高線ベクタを生成します。<link xlink:href="https://gdal.org/api/gdal_alg.html?highlight=contour#_CPPv421GDALContourGenerateEx15GDALRasterBandHPv12CSLConstList16GDALProgressFuncPv">GDAL等高線生成アルゴリズム</link>を使います。</para>

note: Tag: para
en: When the <varname>fixed_levels</varname> parameter is a non-empty array, the <varname>level_interval</varname> and <varname>level_base</varname> parameters are ignored.
ja: <varname>fixed_levels</varname>パラメータが空でない配列である時、<varname>level_interval</varname>と<varname>level_base</varname>とは無視されます。

note: Tag: para
en: Input parameters are:
ja: 入力パラメータは次の通りです:

note: Tag: para
en: The raster to generate the contour of
ja: 等高線を生成するラスタ

note: Tag: para
en: The band to generate the contour of
ja: 等高線を生成するバンド

note: Tag: para
en: The elevation interval between contours generated
ja: 生成する等高線の標高間隔

note: Tag: para
en: The "base" relative to which contour intervals are applied, this is normally zero, but could be different. To generate 10m contours at 5, 15, 25, ... the LEVEL_BASE would be 5.
ja: 等高線の標高間隔に適用される相対値の「基礎値」です。通常は0ですが、そうでない場合もあります。10m等高線であって、5, 15, 25 ...で等高線を生成する場合には、LEVEL_BASEは5になります。

note: Tag: para
en: If <literal>true</literal>, contour polygons will be created, rather than polygon lines.
ja: <literal>true</literal> の場合には、等高線ポリゴンが作られます。ラインストリングではありません。

note: Tag: para
en: Return values are a set of records with the following attributes:
ja: 返り値は次に示す属性を持つ行の集合です。

note: Tag: para
en: The geometry of the contour line.
ja: 等高線のジオメトリ。

note: Tag: para
en: A unique identifier given to the contour line by GDAL.
ja: GDALが等高線に与える一意の識別子。

note: Tag: para
en: The raster value the line represents. For an elevation DEM input, this would be the elevation of the output contour.
ja: ラインが表現するラスタ値。標高DEM入力の場合、出力等高線の標高となります。

note: Tag: refpurpose
en: Interpolates a gridded surface based on an input set of 3-d points, using the X- and Y-values to position the points on the grid and the Z-value of the points as the surface elevation.
ja: X値とY値を使用してグリッド上のポイントを配置し、ポイントのZ値をサーフェス標高として配置し、3次元ポイントの入力セットに基づいてグリッドサーフェスを補間します。

note: Tag: para
en: Interpolates a gridded surface based on an input set of 3-d points, using the X- and Y-values to position the points on the grid and the Z-value of the points as the surface elevation. There are five interpolation algorithms available: inverse distance, inverse distance nearest-neighbor, moving average, nearest neighbor, and linear interpolation. See the <link xlink:href="https://gdal.org/programs/gdal_grid.html#interpolation-algorithms">gdal_grid documentation</link> for more details on the algorithms and their parameters. For more information on how interpolations are calculated, see the <link xlink:href="https://gdal.org/tutorials/gdal_grid_tut.html">GDAL grid tutorial</link>.
ja: X値とY値を使用してグリッド上のポイントを配置し、ポイントのZ値をサーフェス標高として配置し、3次元ポイントの入力セットに基づいてグリッドサーフェスを補間します。逆距離、逆距離最近傍、移動平均、最近傍、線形補間の五つの補間アルゴリズムが使用できます。アルゴリズムとそれらのパラメータに関する詳細情報については<link xlink:href="https://gdal.org/programs/gdal_grid.html#interpolation-algorithms">gdal_grid documentation</link>を参照して下さい。どのように補間計算が行われているかの詳細情報については<link xlink:href="https://gdal.org/tutorials/gdal_grid_tut.html">GDAL grid tutorial</link>をご覧下さい。

note: Tag: para
en: The points to drive the interpolation. Any geometry with Z-values is acceptable, all points in the input will be used.
ja: 補間を駆動するポイント。Z値を持つジオメトリなら全て受け付けられ、全ての入力ポイントが使用されます。

note: Tag: para
en: A string defining the algorithm and algorithm options, in the format used by <link xlink:href="https://gdal.org/programs/gdal_grid.html#interpolation-algorithms">gdal_grid</link>. For example, for an inverse-distance interpolation with a smoothing of 2, you would use "invdist:smoothing=2.0"
ja: アルゴリズムとそのオプションを定義する文字列で、<link xlink:href="https://gdal.org/programs/gdal_grid.html#interpolation-algorithms">gdal_grid</link>で使われる書式で記述します。たとえば、逆距離補間

note: Tag: para
en: A raster template to drive the geometry of the output raster. The width, height, pixel size, spatial extent and pixel type will be read from this template.
ja: 出力ラスタのジオメトリを駆動するためのラスタテンプレート。幅、高さ、ピクセルｙサイズ、空間範囲、ピクセルタイプがこのテンプレートから読み込まれます。

note: Tag: para
en: By default the first band in the template raster is used to drive the output raster, but that can be adjusted with this parameter.
ja: デフォルトではテンプレートラスタの最初のバンドが出力ラスタの駆動に使われますが、このパラメータで調整できます。

note: Tag: refpurpose
en: Change the SRID of all rasters in the user-specified column and table.
ja: ユーザが指定したカラムとテーブルにあるラスタの全てについてSRIDを変更します。

note: Tag: para
en: Change the SRID of all rasters in the user-specified column and table. The function will drop all appropriate column constraints (extent, alignment and SRID) before changing the SRID of the specified column's rasters.
ja: ユーザが指定したカラムとテーブルにあるラスタの全てについてSRIDを変更します。この関数は全ての適切なカラム制約 (extent, alignment, SRID)を削除してから、指定したカラムのラスタのSRIDを変更します。

note: Tag: para
en: The data (band pixel values) of the rasters are not touched by this function. Only the raster's metadata is changed.
ja: この関数はラスタのデータ (バンドピクセル値)を触りません。ラスタのメタデータのみ変更します。

note: Tag: refpurpose
en: Create an reduced resolution version of a given raster coverage.
ja: 与えられたラスタカバレッジから解像度を落としたものを生成します。

note: Tag: para
en: Create an overview table with resampled tiles from the source table. Output tiles will have the same size of input tiles and cover the same spatial extent with a lower resolution (pixel size will be 1/<varname>factor</varname> of the original in both directions).
ja: 元のテーブルからリサンプリングを施したタイルのオーバビューテーブルを生成します。出力タイルは入力タイルと同じサイズで、同じ空間範囲を持ち、入力タイルより低い解像度 (ピクセル数は縦横ともに元のタイルの1/<varname>factor</varname>倍になります)を持ちます。

note: Tag: para
en: The overview table will be made available in the <varname>raster_overviews</varname> catalog and will have raster constraints enforced.
ja: オーバビューテーブルは<varname>raster_overviews</varname>カタログに出現し、ラスタ制約を持ちます。

note: Tag: para
en: Algorithm options are: 'NearestNeighbor', 'Bilinear', 'Cubic', 'CubicSpline', and 'Lanczos'. Refer to: <link xlink:href="http://www.gdal.org/gdalwarp.html">GDAL Warp resampling methods</link> for more details.
ja: アルゴリズム指定オプションは'NearestNeighbor', 'Bilinear', 'Cubic', 'CubicSpline', 'Lanczos'です。詳細については<link xlink:href="http://www.gdal.org/gdalwarp.html">GDAL Warp resampling methods</link>をご覧ください。

note: Tag: para
en: Output to generally better quality but slower to product format
ja: 高品質ですが遅い生成書式での出力

note: Tag: para
en: Output to faster to process default nearest neighbor
ja: デフォルトの最近傍補間を使った早い処理による出力

note: Tag: title
en: Raster Constructors
ja: ラスタコンストラクタ

note: Tag: refpurpose
en: Returns a raster with the new band(s) of given type added with given initial value in the given index location. If no index is specified, the band is added to the end.
ja: 与えられたタイプで、与えられた初期値にした新しいバンドを、与えられたインデックス位置に追加したラスタを返します。インデックス位置を指定していない場合には、バンドは末尾に追加されます。

note: Tag: para
en: Returns a raster with a new band added in given position (index), of given type, of given initial value, and of given nodata value. If no index is specified, the band is added to the end. If no <varname>fromband</varname> is specified, band 1 is assumed. Pixel type is a string representation of one of the pixel types specified in <xref linkend="RT_ST_BandPixelType"/>. If an existing index is specified all subsequent bands &gt;= that index are incremented by 1. If an initial value greater than the max of the pixel type is specified, then the initial value is set to the highest value allowed by the pixel type.
ja: 指定した位置(index)に、指定したタイプの、指定した初期値を持ち、指定したNODATA値を持つ、追加された新しいバンドを持つラスタを返します。インデックス位置を指定していない場合には、バンドは末尾に追加されます。<varname>fromband</varname>が指定されない場合には、1番バンドと仮定します。ピクセルタイプは<xref linkend="RT_ST_BandPixelType"/>で指定されているピクセルタイプの文字列表現です。既存のインデックスが指定された場合には、バンドのインデックス &gt;= 指定インデックス となるバンドのインデックスは1ずつ足されます。初期値としてピクセルタイプの最大値を超えた値が指定された場合には、初期値にピクセルタイプの許容最大値が指定されます。

note: Tag: para
en: For the variant that takes an array of <xref linkend="addbandarg"/> (Variant 1), a specific addbandarg's index value is relative to the raster at the time when the band described by that addbandarg is being added to the raster. See the Multiple New Bands example below.
ja: <xref linkend="addbandarg"/>の配列を取る版 (一つ目の版)では、指定したaddbandargのインデックス値は、addbandargで示されるバンドがラスタに追加される時のラスタとの相対値です。下の複数バンドの例を参照してください。

note: Tag: para
en: For the variant that takes an array of rasters (Variant 5), if <varname>torast</varname> is NULL then the <varname>fromband</varname> band of each raster in the array is accumulated into a new raster.
ja: ラスタの配列を取る版 (五つ目の版)では、<varname>torast</varname>がNULLなら、配列内のラスタごとの<varname>fromband</varname>のバンドが新しいラスタに集約されます。

note: Tag: para
en: For the variants that take <varname>outdbfile</varname> (Variants 6 and 7), the value must include the full path to the raster file. The file must also be accessible to the postgres server process.
ja: <varname>outdbfile</varname>を取る版 (六つ目と七つ目の版)では、値はラスタファイルへのフルパスを含まなければなりません。また、ファイルはPostgreSQLサーバプロセスがアクセス可能でなければなりません。

note: Tag: para
en: Enhanced: 2.1.0 support for addbandarg added.
ja: Enhanced: 2.1.0 addbandarg対応が追加されました。

note: Tag: para
en: Enhanced: 2.1.0 support for new out-db bands added.
ja: Enhanced: 2.1.0 out-dbバンドが追加されました。

note: Tag: title
en: Examples: Single New Band
ja: 例: 単一バンド

note: Tag: title
en: Examples: Multiple New Bands
ja: 例: 複数の新規バンド

note: Tag: title
en: Examples: New Out-db band
ja: 例: データベース外のバンド

note: Tag: refpurpose
en: Converts a PostGIS geometry to a PostGIS raster.
ja: PostGISジオメトリをPostGISラスタに変換します。

note: Tag: para
en: Converts a PostGIS geometry to a PostGIS raster. The many variants offers three groups of possibilities for setting the alignment and pixelsize of the resulting raster.
ja: PostGISジオメトリをPostGISラスタに変換します。多数の形式がありますが、結果ラスタのアラインメントとピクセルサイズを設定する三つの考えられる類型に分かれます。

note: Tag: para
en: The first group, composed of the two first variants, produce a raster having the same alignment (<varname>scalex</varname>, <varname>scaley</varname>, <varname>gridx</varname> and <varname>gridy</varname>), pixel type and nodata value as the provided reference raster. You generally pass this reference raster by joining the table containing the geometry with the table containing the reference raster.
ja: 一つ目の群は、最初の2形式です。 アラインメント (<varname>scalex</varname>, <varname>scaley</varname>, <varname>gridx</varname>, <varname>gridy</varname>)、ピクセルタイプ、NODATA値が提供される参照ラスタと同じとなるラスタを生成します。一般的にこの参照ラスタは、ジオメトリを含むテーブルを参照ラスタを含むテーブルに結合して渡します。

note: Tag: para
en: The second group, composed of four variants, let you set the dimensions of the raster by providing the parameters of a pixel size (<varname>scalex</varname> &amp; <varname>scaley</varname> and <varname>skewx</varname> &amp; <varname>skewy</varname>). The <varname>width</varname> &amp; <varname>height</varname> of the resulting raster will be adjusted to fit the extent of the geometry. In most cases, you must cast integer <varname>scalex</varname> &amp; <varname>scaley</varname> arguments to double precision so that PostgreSQL choose the right variant.
ja: 二つ目の群は、4形式あります。ピクセルサイズ (<varname>scalex</varname> &amp; <varname>scaley</varname>と<varname>skewx</varname> &amp; <varname>skewy</varname>)の引数を渡してラスタのピクセル範囲を設定します。結果ラスタの<varname>width</varname> &amp; <varname>height</varname>はジオメトリの範囲にあわせて調整されます。ほとんどの場合、PostgreSQLが正しい形式を選択するために、<varname>scalex</varname> &amp; <varname>scaley</varname>の整数引数を倍精度浮動小数点数にキャストしなければなりません。

note: Tag: para
en: The third group, composed of four variants, let you fix the dimensions of the raster by providing the dimensions of the raster (<varname>width</varname> &amp; <varname>height</varname>). The parameters of the pixel size (<varname>scalex</varname> &amp; <varname>scaley</varname> and <varname>skewx</varname> &amp; <varname>skewy</varname>) of the resulting raster will be adjusted to fit the extent of the geometry.
ja: 三つ目の群は、4形式あります。ラスタのピクセル範囲 (<varname>width</varname> &amp; <varname>height</varname>)を渡してラスタのピクセル範囲を固定するものです。結果ラスタのピクセルサイズ(<varname>scalex</varname> &amp; <varname>scaley</varname>と<varname>skewx</varname> &amp; <varname>skewy</varname>)の引数はジオメトリの範囲にあわせて調整されます。

note: Tag: para
en: The two first variants of each of those two last groups let you specify the alignment with an arbitrary corner of the alignment grid (<varname>gridx</varname> &amp; <varname>gridy</varname>) and the two last variants takes the upper left corner (<varname>upperleftx</varname> &amp; <varname>upperlefty</varname>).
ja: 二つ目の群と三つ目の群の群内前半2形式は、アラインメントグリッド (<varname>gridx</varname> &amp; <varname>gridy</varname>)の適切な隅でアラインメントを特定します。群内後半2形式は左上隅 (<varname>upperleftx</varname> &amp; <varname>upperlefty</varname>)を取ります。

note: Tag: para
en: Each group of variant allows producing a one band raster or a multiple bands raster. To produce a multiple bands raster, you must provide an array of pixel types (<varname>pixeltype[]</varname>), an array of initial values (<varname>value</varname>) and an array of nodata values (<varname>nodataval</varname>). If not provided pixeltyped defaults to 8BUI, values to 1 and nodataval to 0.
ja: これらの群のそれぞれによって、1バンドまたは複数バンドのラスタを生成することができます。複数バンドのラスタを生成するには、ピクセルタイプ配列 (<varname>pixeltype[]</varname>)、初期値配列 (<varname>value</varname>)、NODATA値配列 (<varname>nodataval</varname>)を渡す必要があります。ピクセルタイプが渡されていない場合には、デフォルトは8BUIになり、初期値については1、NODATA値については0になります。

note: Tag: para
en: The output raster will be in the same spatial reference as the source geometry. The only exception is for variants with a reference raster. In this case the resulting raster will get the same SRID as the reference raster.
ja: 出力ラスタは元のジオメトリと同じ空間参照系になります。参照ラスタを使う形式は例外で、結果ラスタは参照ラスタと同じSRIDになります。

note: Tag: para
en: The optional <varname>touched</varname> parameter defaults to false and maps to the GDAL ALL_TOUCHED rasterization option, which determines if pixels touched by lines or polygons will be burned. Not just those on the line render path, or whose center point is within the polygon.
ja: 任意引数<varname>touched</varname>は、デフォルトではFALSEになります。GDALのALL_TOUCHEDラスタ化オプションに相当し、ラインまたはポリゴンに接触するピクセルが描画されます。ライン上にあるか中心点がポリゴン内部にあるピクセルが描画されるだけではありません。

note: Tag: para
en: This is particularly useful for rendering jpegs and pngs of geometries directly from the database when using in combination with <xref linkend="RT_ST_AsPNG"/> and other <xref linkend="RT_ST_AsGDALRaster"/> family of functions.
ja: これは特にジオメトリをデータベースから<xref linkend="RT_ST_AsPNG"/>や<xref linkend="RT_ST_AsGDALRaster"/>系の関数を併用して直接JPEGやPNGに描画する際に使えます。

note: Tag: para
en: Not yet capable of rendering complex geometry types such as curves, TINS, and PolyhedralSurfaces, but should be able too once GDAL can.
ja: 曲線、TIN、多面体サーフェスのような複雑なジオメトリタイプのレンダリングは、まだできませんが、GDALができることは実現できます。

note: Tag: title
en: Examples: Output geometries as PNG files
ja: 例: ジオメトリをPNGファイルとして出力

note: Tag: para
en: black circle
ja: 黒い円

note: Tag: para
en: example from buffer rendered with just PostGIS
ja: PostGISだけで描画したバッファの例

note: Tag: refpurpose
en: Returns one or more bands of an existing raster as a new raster. Useful for building new rasters from existing rasters.
ja: 既存のラスタの、一つ以上のバンドを新しいラスタとして返します。既存のラスタから新しいラスタを構築する際に使えます。

note: Tag: para
en: Returns one or more bands of an existing raster as a new raster. Useful for building new rasters from existing rasters or export of only selected bands of a raster or rearranging the order of bands in a raster. If no band is specified or any of specified bands does not exist in the raster, then all bands are returned. Used as a helper function in various functions such as for deleting a band.
ja: 既存のラスタの、一つ以上のバンドを新しいラスタとして返します。既存ラスタから新しいラスタを構築したり、ラスタの選択したバンドのみを出力したり、バンドの並びを改める際に使えます。バンドが指定されない場合や指定したバンドがラスタに存在しない場合には、全てのバンドを返します。バンド削除等の様々な関数を補助する関数として使われています。

note: Tag: para
en: For the <code>nbands</code> as text variant of function, the default delimiter is <code>,</code> which means you can ask for <code>'1,2,3'</code> and if you wanted to use a different delimiter you would do <code>ST_Band(rast, '1@2@3', '@')</code>. For asking for multiple bands, we strongly suggest you use the array form of this function e.g. <code>ST_Band(rast, '{1,2,3}'::int[]);</code> since the <code>text</code> list of bands form may be removed in future versions of PostGIS.
ja: <code>nbands</code>を文字列とする版では、デフォルトのデリミタは<code>,</code>です。<code>'1,2,3'</code>と指定できます。異なるデリミタを使いたい場合には、<code>ST_Band(rast, '1@2@3', '@')</code>とします。複数バンドを指定する際に、<code>ST_Band(rast, '{1,2,3}'::int[]);</code>というような、配列を使うことを強くお勧めします。<code>text</code>によるバンド一覧を取る形式は、PostGISの将来の版で削除するかも知れません。

note: Tag: para
en: original (column rast)
ja: 元画像 (rastカラム)

note: Tag: refpurpose
en: Cover georeferenced area with a grid of empty raster tiles.
ja: 空のラスタタイルのグリッドでジオリファレンスを施されている領域を生成します。

note: Tag: para
en: Create a set of raster tiles with <xref linkend="RT_ST_MakeEmptyRaster"/>. Grid dimension is <varname>width</varname> &amp; <varname>height</varname>. Tile dimension is <varname>tilewidth</varname> &amp; <varname>tileheight</varname>. The covered georeferenced area is from upper left corner (<varname>upperleftx</varname>, <varname>upperlefty</varname>) to lower right corner (<varname>upperleftx</varname> + <varname>width</varname> * <varname>scalex</varname>, <varname>upperlefty</varname> + <varname>height</varname> * <varname>scaley</varname>).
ja: <xref linkend="RT_ST_MakeEmptyRaster"/>でラスタ集合を生成します。グリッドの次元は<varname>width</varname>と<varname>height</varname>です。タイルの次元は<varname>tilewidth</varname>と<varname>tileheight</varname>です。領域は左上隅(<varname>upperleftx</varname>, <varname>upperlefty</varname>)から右下隅 (<varname>upperleftx</varname> + <varname>width</varname> * <varname>scalex</varname>, <varname>upperlefty</varname> + <varname>height</varname> * <varname>scaley</varname>)で形成されます。

note: Tag: para
en: Note that scaley is generally negative for rasters and scalex is generally positive. So lower right corner will have a lower y value and higher x value than the upper left corner.
ja: ラスタのscaleyは一般的に負数で、scalexは一般的に正数です。右下隅は、左上隅より、yは小さな値、xは大きな値になります。

note: Tag: title
en: Examples Basic
ja: 基本的な例

note: Tag: para
en: Create 16 tiles in a 4x4 grid to cover the WGS84 area from upper left corner (22, 77) to lower right corner (55, 33).
ja: WGS84で左上が(22, 27)で右下が(55, 53)となる範囲の4x4グリッドの16タイルを生成します。

note: Tag: refpurpose
en: Returns an empty raster (having no bands) of given dimensions (width &amp; height), upperleft X and Y, pixel size and rotation (scalex, scaley, skewx &amp; skewy) and reference system (srid). If a raster is passed in, returns a new raster with the same size, alignment and SRID. If srid is left out, the spatial ref is set to unknown (0).
ja: 与えられたピクセル範囲 (width &amp; height)、左上のX,Y、ピクセルサイズ、回転 (scalex, scaley, skewx, skewy)と空間参照系 (srid)が指定された空ラスタ (バンドを持たないラスタ)を返します。ラスタが渡されると、新しいラスタは渡されたラスタと同じサイズ、アラインメント、SRIDになります。SRIDが指定されていない場合には、空間参照系は不明 (0)とされます。

note: Tag: para
en: Returns an empty raster (having no band) of given dimensions (width &amp; height) and georeferenced in spatial (or world) coordinates with upper left X (upperleftx), upper left Y (upperlefty), pixel size and rotation (scalex, scaley, skewx &amp; skewy) and reference system (srid).
ja: 与えられたピクセル範囲 (width &amp; height)を持ち、かつ、左上隅のX (upperleftx)とY (upperlefty)、ピクセルサイズと回転 (scalex, scaley, skewx, skewy)、空間参照系 (srid)によって空間 (またはワールド)座標上で地理参照された空ラスタ (バンドを持たないラスタ)を返します。

note: Tag: para
en: The last version use a single parameter to specify the pixel size (pixelsize). scalex is set to this argument and scaley is set to the negative value of this argument. skewx and skewy are set to 0.
ja: 最後の形式では、ピクセルサイズを一つの引数 (pixelsize)で指定しています。scalexはこの引数に、scaleyは引数の正負逆の数に、それぞれ設定され、skewxとskewyは0に設定されます。

note: Tag: para
en: If an existing raster is passed in, it returns a new raster with the same meta data settings (without the bands).
ja: 既存のラスタを渡すと、同じメタデータ設定 (バンド以外)を持つ新しいラスタが返ります。

note: Tag: para
en: If no srid is specified it defaults to 0. After you create an empty raster you probably want to add bands to it and maybe edit it. Refer to <xref linkend="RT_ST_AddBand"/> to define bands and <xref linkend="RT_ST_SetValue"/> to set initial pixel values.
ja: SRIDが設定されていない場合には、デフォルトは0です。空ラスタを生成した後に、バンドの追加や編集を行うことになります。<xref linkend="RT_ST_AddBand"/>でバンドを定義し、<xref linkend="RT_ST_SetValue"/>で初期ピクセル値を設定します。

note: Tag: refpurpose
en: <refpurpose>Returns a set of rasters resulting from the split of the input raster based upon the desired dimensions of the output rasters.</refpurpose>
ja: <refpurpose>求められた出力ラスタのピクセル数に基づいて入力ラスタを分割した結果のラスタ集合を返します。</refpurpose>

note: Tag: para
en: <para>Returns a set of rasters resulting from the split of the input raster based upon the desired dimensions of the output rasters.</para>
ja: <para>求められた出力ラスタのピクセル数に基づいて入力ラスタを分割した結果のラスタ集合を返します。</para>

note: Tag: para
en: If <varname>padwithnodata</varname> = FALSE, edge tiles on the right and bottom sides of the raster may have different dimensions than the rest of the tiles. If <varname>padwithnodata</varname> = TRUE, all tiles will have the same dimensions with the possibility that edge tiles being padded with NODATA values. If raster band(s) do not have NODATA value(s) specified, one can be specified by setting <varname>nodataval</varname>.
ja: <varname>padwithnodata</varname>がFALSEである場合には、ラスタの右端と下端のタイルは、他のタイルと異なるピクセル範囲を持つことがあります。<varname>padwithnodata</varname>がTRUEの場合には、全てのタイルは同じピクセル範囲を持ち、端のタイルにNODATA値が詰められます。ラスタバンドにNODATA値が指定されていない場合には、<varname>nodataval</varname>で指定することができます。

note: Tag: para
en: If a specified band of the input raster is out-of-db, the corresponding band in the output rasters will also be out-of-db.
ja: 入力ラスタの指定したバンドがデータベース外ラスタの場合には、出力ラスタ内の対応するバンドもデータベース外になります。

note: Tag: refpurpose
en: Return a set of configured tiles from an arbitrarily tiled raster coverage.
ja: 任意のタイル化されたラスタカバレッジから構成されたタイルの集合を返します。

note: Tag: para
en: Return a set of tiles having the specified scale (<varname>sfx</varname>, <varname>sfy</varname>) and max size (<varname>tw</varname>, <varname>th</varname>) and covering the specified extent (<varname>ext</varname>) with data coming from the specified raster coverage (<varname>tab</varname>, <varname>col</varname>).
ja: 指定された縮尺 (<varname>sfx</varname>, <varname>sfy</varname>)と最大サイズ (<varname>tw</varname>, <varname>th</varname>)を持ち、指定された範囲 (<varname>ext</varname>)を包含し、指定されたラスタカバレッジ (<varname>tab</varname>, <varname>col</varname>)からのデータを持つタイルの集合を返します。

note: Tag: refpurpose
en: Returns a raster from a supported GDAL raster file.
ja: 対応するGDALラスタファイルからラスタを返します。

note: Tag: para
en: Returns a raster from a supported GDAL raster file. <varname>gdaldata</varname> is of type bytea and should be the contents of the GDAL raster file.
ja: 対応するGDALラスタファイルからラスタを返します。<varname>gdaldata</varname>はbytea型で、GDALラスタファイルの中身です。

note: Tag: para
en: If <varname>srid</varname> is NULL, the function will try to automatically assign the SRID from the GDAL raster. If <varname>srid</varname> is provided, the value provided will override any automatically assigned SRID.
ja: <varname>srid</varname>がNULLの場合には、この関数は、GDALラスタから自動的にSRIDを設定しようとします。<varname>srid</varname>が与えられている場合には、与えられた値が自動的に設定したSRIDを上書きします。

note: Tag: title
en: Raster Accessors
ja: ラスタアクセサ

note: Tag: refpurpose
en: Returns the georeference meta data in GDAL or ESRI format as commonly seen in a world file. Default is GDAL.
ja: GDAL書式または一般的にワールドファイルでみられるESRI書式の地理参照メタデータを返します。デフォルトはGDALです。

note: Tag: para
en: Returns the georeference meta data including carriage return in GDAL or ESRI format as commonly seen in a <link xlink:href="http://en.wikipedia.org/wiki/World_file">world file</link>. Default is GDAL if no type specified. type is string 'GDAL' or 'ESRI'.
ja: GDAL書式または一般的に<link xlink:href="http://en.wikipedia.org/wiki/World_file">world file</link> (英語版WikiPedia)でみられるESRI書式の地理参照メタデータを返します。書式を指定したいない場合のデフォルトはGDALです。書式は'GDAL'または'ESRI'の文字列です。

note: Tag: para
en: Difference between format representations is as follows:
ja: 書式の表現の違いは次の通りです。

note: Tag: refpurpose
en: Returns the height of the raster in pixels.
ja: ラスタの高さをピクセル単位で返します。

note: Tag: para
en: Returns the height of the raster.
ja: ラスタの高さをピクセル単位で返します。

note: Tag: refpurpose
en: <refpurpose>Returns true if the raster is empty (width = 0 and height = 0). Otherwise, returns false.</refpurpose>
ja: <refpurpose>ラスタが空 (幅が0で高さが0)の場合にはTRUEを返します。他の場合には、FALSEを返します。</refpurpose>

note: Tag: para
en: <para>Returns true if the raster is empty (width = 0 and height = 0). Otherwise, returns false.</para>
ja: <para>ラスタが空 (幅が0で高さが0)の場合にはTRUEを返します。他の場合には、FALSEを返します。</para>

note: Tag: refpurpose
en: <refpurpose>Returns the amount of space (in bytes) the raster takes.</refpurpose>
ja: <refpurpose>ラスタが取る領域の合計をバイト単位で返します。</refpurpose>

note: Tag: para
en: <para>Returns the amount of space (in bytes) the raster takes.</para>
ja: <para>ラスタが取る領域の合計をバイト単位で返します。</para>

note: Tag: para
en: This is a nice compliment to PostgreSQL built in functions pg_column_size, pg_size_pretty, pg_relation_size, pg_total_relation_size.
ja: この関数はPostgreSQLビルトイン関数pg_clumn_size, pg_size_pretty, pg_relation_size, pg_total_relation_sizeへのすばらしい賛辞です。

note: Tag: para
en: pg_relation_size which gives the byte size of a table may return byte size lower than ST_MemSize. This is because pg_relation_size does not add toasted table contribution and large geometries are stored in TOAST tables. pg_column_size might return lower because it returns the compressed size.
ja: テーブルのバイト単位のサイズを得るpg_relation_sizeはST_MemSizeよりも小さい値を返すことがあります。pg_relation_sizeはTOASTテーブルの寄与分を追加せず、大きなジオメトリはTOASTテーブルに格納されるためです。pg_column_sizeは圧縮後のサイズを返すので、小さくなることがあります。

note: Tag: refpurpose
en: Returns basic meta data about a raster object such as pixel size, rotation (skew), upper, lower left, etc.
ja: ピクセル数、回転 (スキュー)、左上隅位置等のラスタオブジェクトに関する基本的なメタデータを返します。

note: Tag: para
en: Returns basic meta data about a raster object such as pixel size, rotation (skew), upper, lower left, etc. Columns returned: upperleftx | upperlefty | width | height | scalex | scaley | skewx | skewy | srid | numbands
ja: ピクセルサイズ、回転 (skew)、左上隅位置等のラスタオブジェクトに関する基本的なメタデータを返します。返されるカラムはupperleftx | upperlefty | width | height | scalex | scaley | skewx | skewy | srid | numbandsです。

note: Tag: refpurpose
en: <refpurpose>Returns the number of bands in the raster object.</refpurpose>
ja: <refpurpose>ラスタオブジェクトのバンド数を返します。</refpurpose>

note: Tag: para
en: <para>Returns the number of bands in the raster object.</para>
ja: <para>ラスタオブジェクトのバンド数を返します。</para>

note: Tag: refpurpose
en: Returns the pixel height in geometric units of the spatial reference system.
ja: 空間参照系の地理的な単位でのピクセルの高さを返します。

note: Tag: para
en: Returns the height of a pixel in geometric units of the spatial reference system. In the common case where there is no skew, the pixel height is just the scale ratio between geometric coordinates and raster pixels.
ja: 空間参照系の地理的な単位でのピクセルの高さを返します。スキューが無い一般的な状況では、ピクセル高は地理座標とラスタピクセルのスケール率です。

note: Tag: para
en: Refer to <xref linkend="RT_ST_PixelWidth"/> for a diagrammatic visualization of the relationship.
ja: 関係について図示したものは<xref linkend="RT_ST_PixelWidth"/>を参照して下さい。

note: Tag: title
en: Examples: Rasters with no skew
ja: 例: スキューの無いラスタ

note: Tag: title
en: Examples: Rasters with skew different than 0
ja: 例: スキューが0でないラスタ

note: Tag: refpurpose
en: Returns the pixel width in geometric units of the spatial reference system.
ja: 空間参照系の地理的な単位でのピクセルの幅を返します。

note: Tag: para
en: Returns the width of a pixel in geometric units of the spatial reference system. In the common case where there is no skew, the pixel width is just the scale ratio between geometric coordinates and raster pixels.
ja: 空間参照系の地理的な単位でのピクセルの幅を返します。スキューが無い一般的な状況では、ピクセル幅は地理座標とラスタピクセルのスケール率です。

note: Tag: para
en: The following diagram demonstrates the relationship:
ja: 関係について次の図に示します。

note: Tag: para
en: Pixel Height: Pixel size in the j direction
ja: ピクセル高: j方向のピクセルサイズ

note: Tag: para
en: Pixel Width: Pixel size in the i direction
ja: ピクセル幅: i方向のピクセルサイズ

note: Tag: refpurpose
en: Returns the X component of the pixel width in units of coordinate reference system.
ja: 空間参照系の地理的な単位でのピクセル幅のX成分を返します。

note: Tag: para
en: Returns the X component of the pixel width in units of coordinate reference system. Refer to <link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> for more details.
ja: 空間参照系の地理的な単位でのピクセル幅のX成分を返します。詳細については<link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> (英語版WikiPedia)をご覧ください。

note: Tag: para
en: Changed: 2.0.0. In WKTRaster versions this was called ST_PixelSizeX.
ja: Changed: 2.0.0. WKTRaster版ではST_PixelSizeXと呼ばれていました。

note: Tag: refpurpose
en: Returns the Y component of the pixel height in units of coordinate reference system.
ja: 空間参照系の地理的な単位でのピクセル幅のY成分を返します。

note: Tag: para
en: Returns the Y component of the pixel height in units of coordinate reference system. May be negative. Refer to <link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> for more details.
ja: 空間参照系の地理的な単位でのピクセル幅のY成分を返します。詳細については<link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> (英語版WikiPedia)をご覧ください。

note: Tag: para
en: Changed: 2.0.0. In WKTRaster versions this was called ST_PixelSizeY.
ja: Changed: 2.0.0. WKTRaster版ではST_PixelSizeYと呼ばれていました。

note: Tag: refpurpose
en: Returns the raster's upper left corner as geometric X and Y (longitude and latitude) given a column and row. Column and row starts at 1.
ja: ラスタの指定した列と行における左上隅の地理座標X値とY値 (経度と緯度)を返します。列と行の番号は1始まりです。

note: Tag: para
en: Returns the upper left corner as geometric X and Y (longitude and latitude) given a column and row. Returned X and Y are in geometric units of the georeferenced raster. Numbering of column and row starts at 1 but if either parameter is passed a zero, a negative number or a number greater than the respective dimension of the raster, it will return coordinates outside of the raster assuming the raster's grid is applicable outside the raster's bounds.
ja: ラスタの指定した列と行における左上隅の地理座標X値とY値 (経度と緯度)を返します。X値とY値の単位は、地理参照されたラスタの地理単位です。列と行の数字は1始まりですが、引数に0、負数またはラスタのピクセル範囲を超える値が渡されている場合には、ラスタのグリッドがラスタ範囲外に適用できると仮定して、範囲外の座標を返します。

note: Tag: refpurpose
en: Returns the geometric X coordinate upper left of a raster, column and row. Numbering of columns and rows starts at 1.
ja: ラスタの指定した列と行における左上隅の地理座標のX値を返します。列と行の番号は1始まりです。

note: Tag: para
en: Returns the upper left X coordinate of a raster column row in geometric units of the georeferenced raster. Numbering of columns and rows starts at 1 but if you pass in a negative number or number higher than number of columns in raster, it will give you coordinates outside of the raster file to left or right with the assumption that the skew and pixel sizes are same as selected raster.
ja: ラスタの指定した列と行における左上隅の地理座標のX値を地理参照したラスタの地理単位で返します。列と行の番号は1始まりです。負数またはラスタの列数を超える値を渡した場合には、スキューとピクセルサイズが選択したラスタと同じであるという仮定のもとで、ラスタファイルから左または右にはずれた座標値を返します。

note: Tag: para
en: For non-skewed rasters, providing the X column is sufficient. For skewed rasters, the georeferenced coordinate is a function of the ST_ScaleX and ST_SkewX and row and column. An error will be raised if you give just the X column for a skewed raster.
ja: スキューの無いラスタでは、X列を与えれば十分です。スキューのあるラスタの場合には、地理参照のとれた座標はST_ScaleXとST_SkewXおよび行と列の関数となります。スキューのあるラスタでX列のみ与えた場合にはエラーが発生します。

note: Tag: para
en: Changed: 2.1.0 In prior versions, this was called ST_Raster2WorldCoordX
ja: Changed: 2.1.0 以前の版ではST_Raster2WorldCoordXと呼ばれていました。

note: Tag: refpurpose
en: Returns the geometric Y coordinate upper left corner of a raster, column and row. Numbering of columns and rows starts at 1.
ja: ラスタの指定した列と行における左上隅の地理座標のY値を返します。列と行の番号は1始まりです。

note: Tag: para
en: Returns the upper left Y coordinate of a raster column row in geometric units of the georeferenced raster. Numbering of columns and rows starts at 1 but if you pass in a negative number or number higher than number of columns/rows in raster, it will give you coordinates outside of the raster file to left or right with the assumption that the skew and pixel sizes are same as selected raster tile.
ja: ラスタの指定した列と行における左上隅の地理座標のY値を地理参照したラスタの地理単位で返します。列と行の番号は1始まりです。負数またはラスタの列数や行数を超える値を渡した場合には、スキューとピクセルサイズが選択したラスタと同じであるという仮定のもとで、ラスタファイルから左または右にはずれた座標値を返します。

note: Tag: para
en: For non-skewed rasters, providing the Y column is sufficient. For skewed rasters, the georeferenced coordinate is a function of the ST_ScaleY and ST_SkewY and row and column. An error will be raised if you give just the Y row for a skewed raster.
ja: スキューの無いラスタでは、Y行を与えれば十分です。スキューのあるラスタの場合には、地理参照のとれた座標はST_ScaleYとST_SkewYおよび行と列の関数となります。スキューのあるラスタでY行のみ与えた場合にはエラーが発生します。

note: Tag: para
en: Changed: 2.1.0 In prior versions, this was called ST_Raster2WorldCoordY
ja: Changed: 2.1.0 以前の版ではST_Raster2WorldCoordYと呼ばれていました。

note: Tag: refpurpose
en: Returns the rotation of the raster in radian.
ja: ラスタの回転をラジアンで返します。

note: Tag: para
en: Returns the uniform rotation of the raster in radian. If a raster does not have uniform rotation, NaN is returned. Refer to <link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> for more details.
ja: ラスタの回転をラジアンで返します。ラスタが回転を持っていない場合には、NaNが返されます。詳細については<link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> (英語版WikiPedia)を参照して下さい。

note: Tag: refpurpose
en: Returns the georeference X skew (or rotation parameter).
ja: 空間参照のXスキュー (回転パラメータ)を返します。

note: Tag: para
en: Returns the georeference X skew (or rotation parameter). Refer to <link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> for more details.
ja: 空間参照のXスキュー (回転パラメータ)を返します。詳細については<link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> (英語版WikiPedia)を参照して下さい。

note: Tag: refpurpose
en: Returns the georeference Y skew (or rotation parameter).
ja: 空間参照のYスキュー (回転パラメータ)を返します。

note: Tag: para
en: Returns the georeference Y skew (or rotation parameter). Refer to <link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> for more details.
ja: 空間参照のYスキュー (回転パラメータ)を返します。詳細については<link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> (英語版WikiPedia)を参照して下さい。

note: Tag: refpurpose
en: Returns the spatial reference identifier of the raster as defined in spatial_ref_sys table.
ja: ラスタのspatial_ref_sysテーブルで定義されている空間参照系識別番号を返します。

note: Tag: para
en: Returns the spatial reference identifier of the raster object as defined in the spatial_ref_sys table.
ja: ラスタのspatial_ref_sysテーブルで定義されている空間参照系識別番号を返します。

note: Tag: para
en: From PostGIS 2.0+ the srid of a non-georeferenced raster/geometry is 0 instead of the prior -1.
ja: 空間参照を持たないラスタ/ジオメトリのSRIDは、以前は-1でしたがPostGIS 2.0以上では0になります。

note: Tag: refpurpose
en: <refpurpose>Returns a text summary of the contents of the raster.</refpurpose>
ja: <refpurpose>ラスタの中身の概要が文字列で返されます。</refpurpose>

note: Tag: para
en: <para>Returns a text summary of the contents of the raster.</para>
ja: <para>ラスタの中身の概要が文字列で返されます。</para>

note: Tag: refpurpose
en: <refpurpose>Returns the upper left X coordinate of raster in projected spatial ref.</refpurpose>
ja: <refpurpose>適用されている空間参照系でのラスタの左上隅のX座標値を返します。</refpurpose>

note: Tag: para
en: <para>Returns the upper left X coordinate of raster in projected spatial ref.</para>
ja: <para>適用されている空間参照系でのラスタの左上隅のX座標値を返します。</para>

note: Tag: refpurpose
en: <refpurpose>Returns the upper left Y coordinate of raster in projected spatial ref.</refpurpose>
ja: <refpurpose>適用されている空間参照系でのラスタの左上隅のY座標値を返します。</refpurpose>

note: Tag: para
en: <para>Returns the upper left Y coordinate of raster in projected spatial ref.</para>
ja: <para>適用されている空間参照系でのラスタの左上隅のY座標値を返します。</para>

note: Tag: refpurpose
en: <refpurpose>Returns the width of the raster in pixels.</refpurpose>
ja: <refpurpose>ラスタの幅をピクセル単位で返します。</refpurpose>

note: Tag: para
en: <para>Returns the width of the raster in pixels.</para>
ja: <para>ラスタの幅をピクセル単位で返します。</para>

note: Tag: refpurpose
en: Returns the upper left corner as column and row given geometric X and Y (longitude and latitude) or a point geometry expressed in the spatial reference coordinate system of the raster.
ja: ラスタの空間参照系による地理座標のX値とY値 (経度と緯度)またはポイントジオメトリに対応するピクセルの左上隅を返します。

note: Tag: para
en: Returns the upper left corner as column and row given geometric X and Y (longitude and latitude) or a point geometry. This function works regardless of whether or not the geometric X and Y or point geometry is outside the extent of the raster. Geometric X and Y must be expressed in the spatial reference coordinate system of the raster.
ja: 地理座標のX値とY値 (経度と緯度)またはポイントジオメトリに対応するピクセルの左上隅を返します。X値、Y値やポイントジオメトリがラスタの範囲外であるかないかにかかわらず動作します。地理座標のX値とY値はラスタの空間参照系で表現しなければなりません。

note: Tag: refpurpose
en: Returns the column in the raster of the point geometry (pt) or a X and Y world coordinate (xw, yw) represented in world spatial reference system of raster.
ja: ラスタの空間参照系に基づくポイントジオメトリ (pt)またはX,Y座標値 (xw,yw)に対応するラスタの列を返します。

note: Tag: para
en: Returns the column in the raster of the point geometry (pt) or a X and Y world coordinate (xw, yw). A point, or (both xw and yw world coordinates are required if a raster is skewed). If a raster is not skewed then xw is sufficient. World coordinates are in the spatial reference coordinate system of the raster.
ja: ラスタの空間参照系に基づくポイントジオメトリ (pt)またはX,Y座標値 (xw,yw)に対応するラスタの列を返します。ラスタがスキューされている場合には、ポイントかxwとywの両方かが必要です。ラスタがスキューされていない場合には、xwを指定すれば十分です。ワールド座標系はラスタの空間参照系です。

note: Tag: para
en: Changed: 2.1.0 In prior versions, this was called ST_World2RasterCoordX
ja: Changed: 2.1.0 以前の版ではST_World2RasterCoordXと呼ばれていました。

note: Tag: refpurpose
en: Returns the row in the raster of the point geometry (pt) or a X and Y world coordinate (xw, yw) represented in world spatial reference system of raster.
ja: ラスタの空間参照系に基づくポイントジオメトリ (pt)またはX,Y座標値 (xw,yw)に対応するラスタの行を返します。

note: Tag: para
en: Returns the row in the raster of the point geometry (pt) or a X and Y world coordinate (xw, yw). A point, or (both xw and yw world coordinates are required if a raster is skewed). If a raster is not skewed then xw is sufficient. World coordinates are in the spatial reference coordinate system of the raster.
ja: ラスタの空間参照系に基づくポイントジオメトリ (pt)またはX,Y座標値 (xw,yw)に対応するラスタの行を返します。ラスタがスキューされている場合には、ポイントかxwとywの両方かが必要です。ラスタがスキューされていない場合には、ywを指定すれば十分です。ワールド座標系はラスタの空間参照系です。

note: Tag: para
en: Changed: 2.1.0 In prior versions, this was called ST_World2RasterCoordY
ja: Changed: 2.1.0 以前の版ではST_World2RasterCoordYと呼ばれていました。

note: Tag: title
en: Raster Band Accessors
ja: ラスタバンドアクセサ

note: Tag: refpurpose
en: Returns basic meta data for a specific raster band. band num 1 is assumed if none-specified.
ja: 指定したラスタバンドの基本的なメタデータを返します。バンド番号を指定しない場合には、1番と仮定します。

note: Tag: para
en: Returns basic meta data about a raster band. Columns returned: pixeltype, nodatavalue, isoutdb, path, outdbbandnum, filesize, filetimestamp.
ja: 指定したラスタバンドの基本的なメタデータを返します。返されるカラムは pixeltype, nodatavalue, isoutdb, path, outdbbandnum, filesize, filetimestamp です。

note: Tag: para
en: If raster contains no bands then an error is thrown.
ja: ラスタがバンドを持たない場合にはエラーが投げられます。

note: Tag: para
en: If band has no NODATA value, nodatavalue are NULL.
ja: バンドにNODATA値が無い場合には、nodatavalueはNULLになります。

note: Tag: para
en: If isoutdb is False, path, outdbbandnum, filesize and filetimestamp are NULL. If outdb access is disabled, filesize and filetimestamp will also be NULL.
ja: isoutdbがFALSEの場合には、path, outdbbandnum, filedizeおよびfiletimestampはNULLです。outdbのアクセスが禁止されているなら、filesizeとfiletimestampがNULLになります。

note: Tag: para
en: Enhanced: 2.5.0 to include <emphasis>outdbbandnum</emphasis>, <emphasis>filesize</emphasis> and <emphasis>filetimestamp</emphasis> for outdb rasters.
ja: Enhanced: 2.5.0 outdbラスタに<emphasis>outdbbandnum</emphasis>, <emphasis>filesize</emphasis>と<emphasis>filetimestamp</emphasis>を取り入れました。

note: Tag: title
en: Examples: Variant 1
ja: 例: 一つ目の形式

note: Tag: title
en: Examples: Variant 2
ja: 例: 二つ目の形式

note: Tag: refpurpose
en: Returns the value in a given band that represents no data. If no band num 1 is assumed.
ja: 指定されたバンドについてデータが無いことを表現する値を返します。バンド番号を指定しない場合には、1番と仮定します。

note: Tag: para
en: Returns the value that represents no data for the band
ja: 指定されたバンドについてデータが無いことを表現する値を返します。

note: Tag: refpurpose
en: Returns true if the band is filled with only nodata values.
ja: 指定したバンドがNODATA値だけで満たされている場合には、TRUEを返します。

note: Tag: para
en: Returns true if the band is filled with only nodata values. Band 1 is assumed if not specified. If the last argument is TRUE, the entire band is checked pixel by pixel. Otherwise, the function simply returns the value of the isnodata flag for the band. The default value for this parameter is FALSE, if not specified.
ja: 指定したバンドがNODATA値だけで満たされている場合には、TRUEを返します。バンド番号を指定しない場合には、1番と仮定します。最後の引数がTRUEの場合には、全バンドについてピクセル毎に調べます。他の場合には、isnodataフラグの値を返すだけです。この引数を指定しない場合のデフォルト値はFALSEです。

note: Tag: para
en: If the flag is dirty (this is, the result is different using TRUE as last parameter and not using it) you should update the raster to set this flag to true, by using ST_SetBandIsNodata(), or ST_SetBandNodataValue() with TRUE as last argument. See <xref linkend="RT_ST_SetBandIsNoData"/>.
ja: フラグが汚れている (最後の引数をTRUEにした場合としない場合とで結果が違う)場合には、ST_SetBandIsNodata関数、または最後の引数をTRUEにしたST_BandNodataValue関数を使って、フラグにTRUEを設定するためにラスタを更新するべきです。<xref linkend="RT_ST_SetBandIsNoData"/>を参照して下さい。

note: Tag: refpurpose
en: Returns system file path to a band stored in file system. If no bandnum specified, 1 is assumed.
ja: ファイルシステムに格納されているバンドのシステムファイルパスを返します。バンド番号が指定されていない場合には、1番と仮定します。

note: Tag: para
en: Returns system file path to a band. Throws an error if called with an in db band.
ja: バンドへのシステムファイルパスを返します。データベース内に格納されているバンドでこの関数を呼んだ場合にはエラーが投げられます。

note: Tag: refpurpose
en: Returns the file size of a band stored in file system. If no bandnum specified, 1 is assumed.
ja: ファイルシステムに格納されているバンドのファイルサイズを返します。バンド番号が指定されていない場合には、1番と仮定します。

note: Tag: para
en: Returns the file size of a band stored in file system. Throws an error if called with an in db band, or if outdb access is not enabled.
ja: ファイルシステムに格納されているバンドのファイルサイズを返します。データベース内バンドを与えるか、データベース外バンドにアクセスできない場合にはエラーが投げられます。

note: Tag: para
en: This function is typically used in conjunction with ST_BandPath() and ST_BandFileTimestamp() so a client can determine if the filename of a outdb raster as seen by it is the same as the one seen by the server.
ja: この関数は一般的にST_BandPath()とST_BandFileTimestamp()とを併用して、データベース外ラスタのファイル名が、この関数から見えるものとサーバから見えるものと同じかどうかを判断することができます。

note: Tag: refpurpose
en: Returns the file timestamp of a band stored in file system. If no bandnum specified, 1 is assumed.
ja: ファイルシステムに格納されているバンドのファイルタイムスタンプ返します。バンド番号が指定されていない場合には、1番と仮定します。

note: Tag: para
en: Returns the file timestamp (number of seconds since Jan 1st 1970 00:00:00 UTC) of a band stored in file system. Throws an error if called with an in db band, or if outdb access is not enabled.
ja: ファイルシステムに保存されているバンドのファイルタイムスタンプを返します (UTC 1970年1月1日 0時0分0秒からの秒数)。データベース内バンドの場合またはデータベース外ラスタへのアクセスが無効な場合にはエラーが投げられます。

note: Tag: para
en: This function is typically used in conjunction with ST_BandPath() and ST_BandFileSize() so a client can determine if the filename of a outdb raster as seen by it is the same as the one seen by the server.
ja: この関数は通常、ST_BandPath() および ST_BandFileSize() と組み合わせて使用されるため、クライアントは、outdb ラスタのファイル名がサーバーによって見られるものと同じであるかどうかを判断できます。

note: Tag: refpurpose
en: Returns the type of pixel for given band. If no bandnum specified, 1 is assumed.
ja: 指定したバンドのピクセルタイプを返します。バンド番号が指定されていない場合には、1番と仮定します。

note: Tag: para
en: Returns name describing data type and size of values stored in each cell of given band.
ja: 与えられたバンドのセルに格納されるデータの型とサイズを示す名前を返します。

note: Tag: para
en: There are 11 pixel types. Pixel Types supported are as follows:
ja: ピクセルタイプは11通りあります。対応しているピクセルタイプは次の通りです。

note: Tag: para
en: 1BB - 1-bit boolean
ja: 1BB - 1ビット真偽値

note: Tag: para
en: 2BUI - 2-bit unsigned integer
ja: 2BUI - 2ビット符号なし整数

note: Tag: para
en: 4BUI - 4-bit unsigned integer
ja: 4BUI - 4ビット符号なし整数

note: Tag: para
en: 8BSI - 8-bit signed integer
ja: 8BSI - 8ビット整数

note: Tag: para
en: 8BUI - 8-bit unsigned integer
ja: 8BUI - 8ビット符号なし整数

note: Tag: para
en: 16BSI - 16-bit signed integer
ja: 16BSI - 16ビット整数

note: Tag: para
en: 16BUI - 16-bit unsigned integer
ja: 16BUI - 16ビット符号なし整数

note: Tag: para
en: 32BSI - 32-bit signed integer
ja: 32BSI - 32ビット整数

note: Tag: para
en: 32BUI - 32-bit unsigned integer
ja: 32BUI - 32ビット符号なし整数

note: Tag: para
en: 32BF - 32-bit float
ja: 32BF - 32ビット浮動小数点数

note: Tag: para
en: 64BF - 64-bit float
ja: 64BF - 64ビット浮動小数点数

note: Tag: refpurpose
en: <refpurpose>Returns the minimum value this pixeltype can store.</refpurpose>
ja: <refpurpose>このピクセルタイプが格納できる最小値を返します。</refpurpose>

note: Tag: para
en: <para>Returns the minimum value this pixeltype can store.</para>
ja: <para>このピクセルタイプが格納できる最小値を返します。</para>

note: Tag: refpurpose
en: <refpurpose>Returns true if there is no band with given band number. If no band number is specified, then band number 1 is assumed.</refpurpose>
ja: <refpurpose>指定したバンド番号のバンドが無い場合には、TRUEを返します。バンド番号を指定していない場合には、1番と仮定します。</refpurpose>

note: Tag: para
en: <para>Returns true if there is no band with given band number. If no band number is specified, then band number 1 is assumed.</para>
ja: <para>指定したバンド番号のバンドが無い場合には、TRUEを返します。バンド番号を指定していない場合には、1番と仮定します。</para>

note: Tag: title
en: Raster Pixel Accessors and Setters
ja: ラスタピクセルアクセサとセッター

note: Tag: refpurpose
en: <refpurpose>Returns the polygon geometry that bounds the pixel for a particular row and column.</refpurpose>
ja: <refpurpose>指定した行と列のピクセルの境界となるジオメトリを返します。</refpurpose>

note: Tag: para
en: <para>Returns the polygon geometry that bounds the pixel for a particular row and column.</para>
ja: <para>指定した行と列のピクセルの境界となるジオメトリを返します。</para>

note: Tag: refpurpose
en: Returns the polygon geometry that bounds every pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel.
ja: 全てのピクセルについて境界となるジオメトリを、ピクセルごとのピクセル値とラスタ座標系のXとYとを付けて返します。

note: Tag: para
en: Returns the polygon geometry that bounds every pixel of a raster band along with the value (double precision), the X and the Y raster coordinates (integers) of each pixel.
ja: 全てのピクセルについて境界となるジオメトリを、ピクセルごとのピクセル値 (倍精度浮動小数点数)とラスタ座標系のXとY (ともに整数)とを付けて返します。

note: Tag: para
en: Return record format: <parameter>geom</parameter> <xref linkend="geometry"/>, <parameter>val</parameter> double precision, <parameter>x</parameter> integer, <parameter>y</parameter> integers.
ja: 返されるレコードの書式は、<xref linkend="geometry"/>型の<parameter>geom</parameter>、倍精度浮動小数点数の<parameter>val</parameter>、整数の<parameter>x</parameter>、整数の<parameter>y</parameter>です。

note: Tag: para
en: When <parameter>exclude_nodata_value</parameter> = TRUE, only those pixels whose values are not NODATA are returned as points.
ja: <parameter>exclude_nodata_value</parameter>がTRUEの時、値がNODATAでないこれらのピクセルだけをポイントとして返します。

note: Tag: para
en: ST_PixelAsPolygons returns one polygon geometry for every pixel. This is different than ST_DumpAsPolygons where each geometry represents one or more pixels with the same pixel value.
ja: ST_PixelAsPolygonsは、ピクセルごとに一つのポリゴンジオメトリを返します。ST_DumpAsPolygonsとは、 一つのジオメトリが同じ値となる一つ以上のピクセルを表現する点で違います。

note: Tag: para
en: Enhanced: 2.1.0 exclude_nodata_value optional argument was added.
ja: Enhanced: 2.1.0 任意引数exclude_nodata_valueが追加されました。

note: Tag: para
en: Changed: 2.1.1 Changed behavior of exclude_nodata_value.
ja: Changed: 2.1.1 exclude_nodata_valueの挙動を変更しました。

note: Tag: refpurpose
en: <refpurpose>Returns a point geometry of the pixel's upper-left corner.</refpurpose>
ja: <refpurpose>ピクセルの左上隅のポイントジオメトリを返します。</refpurpose>

note: Tag: para
en: <para>Returns a point geometry of the pixel's upper-left corner.</para>
ja: <para>ピクセルの左上隅のポイントジオメトリを返します。</para>

note: Tag: refpurpose
en: <refpurpose>Returns a point geometry for each pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel. The coordinates of the point geometry are of the pixel's upper-left corner.</refpurpose>
ja: <refpurpose>全てのピクセルについてポイントジオメトリを、ピクセルごとのピクセル値とラスタ座標系のXとYとを付けて返します。ポイントジオメトリの座標はピクセルの左上隅です。</refpurpose>

note: Tag: para
en: <para>Returns a point geometry for each pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel. The coordinates of the point geometry are of the pixel's upper-left corner.</para>
ja: <para>全てのピクセルについてポイントジオメトリを、ピクセルごとのピクセル値とラスタ座標系のXとYとを付けて返します。ポイントジオメトリの座標はピクセルの左上隅です。</para>

note: Tag: refpurpose
en: <refpurpose>Returns the centroid (point geometry) of the area represented by a pixel.</refpurpose>
ja: <refpurpose>ピクセルで表現される面の重心 (ポイントジオメトリ)を返します。</refpurpose>

note: Tag: para
en: <para>Returns the centroid (point geometry) of the area represented by a pixel.</para>
ja: <para>ピクセルで表現される面の重心 (ポイントジオメトリ)を返します。</para>

note: Tag: para
en: Enhanced: 3.2.0 Faster now implemented in C.
ja: Enhanced: 3.2.0 C言語による、より高速な実装。

note: Tag: refpurpose
en: <refpurpose>Returns the centroid (point geometry) for each pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel. The point geometry is the centroid of the area represented by a pixel.</refpurpose>
ja: <refpurpose>全てのピクセルについて重心 (ポイントジオメト)リを、ピクセルごとのピクセル値とラスタ座標系のXとYとを付けて返します。ポイントジオメトリの座標はピクセルで表現される面の重心です。</refpurpose>

note: Tag: para
en: <para>Returns the centroid (point geometry) for each pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel. The point geometry is the centroid of the area represented by a pixel.</para>
ja: <para>全てのピクセルについて重心 (ポイントジオメト)リを、ピクセルごとのピクセル値とラスタ座標系のXとYとを付けて返します。ポイントジオメトリの座標はピクセルで表現される面の重心です。</para>

note: Tag: refpurpose
en: Returns the value of a given band in a given columnx, rowy pixel or at a particular geometric point. Band numbers start at 1 and assumed to be 1 if not specified. If <varname>exclude_nodata_value</varname> is set to false, then all pixels include <varname>nodata</varname> pixels are considered to intersect and return value. If <varname>exclude_nodata_value</varname> is not passed in then reads it from metadata of raster.
ja: 指定したバンドにおけるcolumnx, rowyで指定したピクセルまたは指定したジオメトリポイントに対応するピクセルの値を返します。 バンド番号は1始まりで、指定しない場合には、1番と仮定します。<varname>exclude_nodata_value</varname>がFALSEに設定された場合には、<varname>NODATA</varname> ピクセルを含む全てのピクセルがインタセクトするかが考慮され、値を返します。<varname>exclude_nodata_value</varname>を渡さない場合には、ラスタのメタデータから読みます。

note: Tag: para
en: Returns the value of a given band in a given columnx, rowy pixel or at a given geometry point. Band numbers start at 1 and band is assumed to be 1 if not specified.
ja: 与えたバンドの、与えた列番号、行番号のピクセル、または与えたジオメトリのポイントにおける値を返します。バンド番号は1始まりで、指定しない場合には、1番と仮定します。

note: Tag: para
en: If <varname>exclude_nodata_value</varname> is set to true, then only non <varname>nodata</varname> pixels are considered. If <varname>exclude_nodata_value</varname> is set to false, then all pixels are considered.
ja: <varname>exclude_nodata_value</varname>がTRUEの場合には、<varname>nodata</varname>値でないピクセルだけを考慮します。<varname>exclude_nodata_value</varname>がFALSEの場合には、全てのピクセルが考慮されます。

note: Tag: para
en: The allowed values of the <varname>resample</varname> parameter are "nearest" which performs the default nearest-neighbor resampling, and "bilinear" which performs a <link xlink:href="https://en.wikipedia.org/wiki/Bilinear_interpolation">bilinear interpolation</link> to estimate the value between pixel centers.
ja: <varname>resample</varname>パラメータの取ることができる値は、デフォルトである最近傍探索リサンプリングを行う"nearest"、バイリニア補間 (<link xlink:href="https://en.wikipedia.org/wiki/Bilinear_interpolation">WikiPedia 英語版</link>)を行う"bilinear"です。ピクセル中心間の値を見積もるためのものです。

note: Tag: para
en: Enhanced: 3.2.0 resample optional argument was added.
ja: Enhanced: 3.2.0 任意引数resampleが追加されました。

note: Tag: para
en: Enhanced: 2.0.0 exclude_nodata_value optional argument was added.
ja: Enhanced: 2.0.0 任意引数exclude_nodata_valueが追加されました。

note: Tag: refpurpose
en: Returns the nearest non-<varname>NODATA</varname> value of a given band's pixel specified by a columnx and rowy or a geometric point expressed in the same spatial reference coordinate system as the raster.
ja: 与えられたバンドの、columnxとrowyで指定されるか、またはラスタと同じ空間参照系で表現されたポイントで指定されたピクセルに最も近い<varname>NODATA</varname>でない値を返します。

note: Tag: para
en: Returns the nearest non-<varname>NODATA</varname> value of a given band in a given columnx, rowy pixel or at a specific geometric point. If the columnx, rowy pixel or the pixel at the specified geometric point is <varname>NODATA</varname>, the function will find the nearest pixel to the columnx, rowy pixel or geometric point whose value is not <varname>NODATA</varname>.
ja: 与えられたバンドの、columnxとrowyで指定されるか、またはラスタと同じ空間参照系で表現されたポイントで指定されたピクセルに最も近い<varname>NODATA</varname>でない値を返します。columnx, rowyピクセルまたは指定したジオメトリポイントのピクセルが<varname>NODATA</varname>である場合には、この関数は、columnx, rowyピクセルかジオメトリポイントのピクセルから最も近い<varname>NODATA</varname>.でないピクセルを探索します。

note: Tag: para
en: Band numbers start at 1 and <varname>bandnum</varname> is assumed to be 1 if not specified. If <varname>exclude_nodata_value</varname> is set to false, then all pixels include <varname>nodata</varname> pixels are considered to intersect and return value. If <varname>exclude_nodata_value</varname> is not passed in then reads it from metadata of raster.
ja: バンド番号は1始まりで、<varname>bandnum</varname>が指定されていない場合には、1番と仮定します。<varname>exclude_nodata_value</varname>がFALSEに設定された場合には、<varname>NODATA</varname>ピクセルを含む全てのピクセルがインタセクトするかが考慮され、値を返します。<varname>exclude_nodata_value</varname>を渡さない場合には、ラスタのメタデータから読みます。

note: Tag: para
en: ST_NearestValue is a drop-in replacement for ST_Value.
ja: ST_NearestValueはST_Valueと交換可能です。

note: Tag: refpurpose
en: Returns a geometry with the same X/Y coordinates as the input geometry, and values from the raster copied into the Z dimension using the requested resample algorithm.
ja: 入力ジオメトリと同じX/y座標値と、指定されたリサンプリングアルゴリズムを使ってラスタから複写されたZ値とを持つジオメトリを返します。

note: Tag: para
en: Returns a geometry with the same X/Y coordinates as the input geometry, and values from the raster copied into the Z dimensions using the requested resample algorithm.
ja: 入力ジオメトリと同じX/Y座標値と、指定されたリサンプリングアルゴリズムを使ってラスタから複写されたZ値とを持つジオメトリを返します。

note: Tag: para
en: The <varname>resample</varname> parameter can be set to "nearest" to copy the values from the cell each vertex falls within, or "bilinear" to use <link xlink:href="https://en.wikipedia.org/wiki/Bilinear_interpolation">bilinear interpolation</link> to calculate a value that takes neighboring cells into account also.
ja: <varname>resample</varname>パラメータの取ることができる値は、デフォルトである最近傍探索リサンプリングを行う"nearest"、バイリニア補間 (<link xlink:href="https://en.wikipedia.org/wiki/Bilinear_interpolation">WikiPedia 英語版</link>)を行う"bilinear"です。近隣セルも考慮に入れた値を計算するためのものです。

note: Tag: refpurpose
en: Returns a geometry with the same X/Y coordinates as the input geometry, and values from the raster copied into the M dimension using the requested resample algorithm.
ja: 入力ジオメトリと同じX/Y値を持ち、かつ、指定されたリサンプリングアルゴリズムを使ってラスタから複写されたM値を持つジオメトリを返します。

note: Tag: para
en: Returns a geometry with the same X/Y coordinates as the input geometry, and values from the raster copied into the M dimensions using the requested resample algorithm.
ja: 入力ジオメトリと同じX/Y値を持ち、かつ、指定されたリサンプリングアルゴリズムを使ってラスタから複写されたM値を持つジオメトリを返します。

note: Tag: refpurpose
en: Returns a 2-D double precision array of the non-<varname>NODATA</varname> values around a given band's pixel specified by either a columnX and rowY or a geometric point expressed in the same spatial reference coordinate system as the raster.
ja: 与えられたバンドのcolumnX, columnYか、ラスタと同じ空間参照系のジオメトリポイントで指定されたピクセルの周囲にある、<varname>NODATA</varname>でない2次元倍精度浮動小数点数配列を返します。

note: Tag: para
en: Returns a 2-D double precision array of the non-<varname>NODATA</varname> values around a given band's pixel specified by either a columnX and rowY or a geometric point expressed in the same spatial reference coordinate system as the raster. The <varname>distanceX</varname> and <varname>distanceY</varname> parameters define the number of pixels around the specified pixel in the X and Y axes, e.g. I want all values within 3 pixel distance along the X axis and 2 pixel distance along the Y axis around my pixel of interest. The center value of the 2-D array will be the value at the pixel specified by the columnX and rowY or the geometric point.
ja: 与えられたバンドのcolumnX, columnYか、ラスタと同じ空間参照系のジオメトリポイントで指定されたピクセルの周囲にある、<varname>NODATA</varname>でない2次元倍精度浮動小数点数配列を返します。<varname>distanceX</varname>と<varname>distanceY</varname>引数は、たとえば、対象ピクセルからX軸に沿って3ピクセルとしてY軸に沿って2ピクセルというふうに、指定したピクセルの周囲のピクセル数を、それぞれX方向とY方向に定義します。2次元配列の中心の値はcolumnX, columnYまたはジオメトリポイントで指定したピクセルの値です。

note: Tag: para
en: The number of elements along each axis of the returning 2-D array is 2 * (<varname>distanceX</varname>|<varname>distanceY</varname>) + 1. So for a <varname>distanceX</varname> and <varname>distanceY</varname> of 1, the returning array will be 3x3.
ja: 返される2次元配列の各軸の要素数は2 * (<varname>distanceX</varname>|<varname>distanceY</varname>) + 1です。<varname>distanceX</varname>と<varname>distanceY</varname>を1にすると、3x3の配列が返ります。

note: Tag: para
en: The 2-D array output can be passed to any of the raster processing builtin functions, e.g. ST_Min4ma, ST_Sum4ma, ST_Mean4ma.
ja: 2次元配列の出力はST_Min4ma, ST_Sum4ma, ST_Mean4maといったあらゆるラスタ処理関数に渡すことができます。

note: Tag: refpurpose
en: Returns modified raster resulting from setting the value of a given band in a given columnx, rowy pixel or the pixels that intersect a particular geometry. Band numbers start at 1 and assumed to be 1 if not specified.
ja: 与えられたバンドのcolumnX, columnYか、ラスタと同じ空間参照系のジオメトリポイントで指定されたピクセルの値または指定したジオメトリとインタセクトするピクセル群の値を設定することから得られる、変更されたラスタを返します。バンド番号は1始まりで、指定しない場合には、1番と仮定します。

note: Tag: para
en: Returns modified raster resulting from setting the specified pixels' values to new value for the designated band given the raster's row and column or a geometry. If no band is specified, then band 1 is assumed.
ja: 指定されたバンドの、与えられたラスタの行と列またはジオメトリで指定したピクセルの値を新しい値に設定することで得られる、変更したラスタを返します。バンドが指定されいていない場合には、1番と仮定します。

note: Tag: para
en: Enhanced: 2.1.0 Geometry variant of ST_SetValue() now supports any geometry type, not just point. The geometry variant is a wrapper around the geomval[] variant of ST_SetValues()
ja: Enhanced: 2.1.0 ST_SetValueでジオメトリを用いる形式が、ポイントだけでなくあらゆるジオメトリタイプに対応するようになりました。ジオメトリを用いる形式はST_SetValuesのgeomval[]を用いる形式をラップしたものです。

note: Tag: refpurpose
en: Returns modified raster resulting from setting the values of a given band.
ja: 与えられたバンドに複数の値を設定して、変更されたラスタを返します。

note: Tag: para
en: Returns modified raster resulting from setting specified pixels to new value(s) for the designated band. <varname>columnx</varname> and <varname>rowy</varname> are 1-indexed.
ja: 指定したバンドの指定したピクセルに新しい値を設定した結果として変更されたラスタを返します。<varname>columnx</varname>と<varname>rowy</varname>は1始まりです。

note: Tag: para
en: If <varname>keepnodata</varname> is TRUE, those pixels whose values are NODATA will not be set with the corresponding value in <varname>newvalueset</varname>.
ja: <varname>keepnodata</varname>がTRUEの場合には、NODATA値を持つピクセルは<varname>newvalueset</varname>に一致する値に設定しません。

note: Tag: para
en: For Variant 1, the specific pixels to be set are determined by the <varname>columnx</varname>, <varname>rowy</varname> pixel coordinates and the dimensions of the <varname>newvalueset</varname> array. <varname>noset</varname> can be used to prevent pixels with values present in <varname>newvalueset</varname> from being set (due to PostgreSQL not permitting ragged/jagged arrays). See example Variant 1.
ja: 一つ目の形式では、設定するピクセルを<varname>columnx</varname>, <varname>rowy</varname>のピクセル座標で決定し、 範囲を<varname>newvalueset</varname>配列で決定します。<varname>noset</varname>によって、ピクセルを<varname>newvalueset</varname>内にある値で、一部を設定されないようにすることができます (PostgreSQLは不調和配列、ジャグ配列を許さないため)。一つ目の形式の例をご覧ください。

note: Tag: para
en: Variant 2 is like Variant 1 but with a simple double precision <varname>nosetvalue</varname> instead of a boolean <varname>noset</varname> array. Elements in <varname>newvalueset</varname> with the <varname>nosetvalue</varname> value with be skipped. See example Variant 2.
ja: 二つ目の形式では、一つ目の形式と似ていますが、倍精度浮動小数点数のスカラ値である<varname>nosetvalue</varname>を<varname>noset</varname>配列の代わりに使う点が違います。<varname>nosetvalue</varname>の値になる<varname>newvalueset</varname>内の要素の設定は行いません。二つ目の形式の例をご覧下さい。

note: Tag: para
en: For Variant 3, the specific pixels to be set are determined by the <varname>columnx</varname>, <varname>rowy</varname> pixel coordinates, <varname>width</varname> and <varname>height</varname>. See example Variant 3.
ja: 三つ目の形式では、設定するピクセルを<varname>columnx</varname>, <varname>rowy</varname>のピクセル座標と<varname>width</varname>, <varname>height</varname>.で決定します。三つ目の形式の例をご覧ください。

note: Tag: para
en: Variant 4 is the same as Variant 3 with the exception that it assumes that the first band's pixels of <varname>rast</varname> will be set.
ja: 四つ目の形式では、<varname>rast</varname>の1番バンドのピクセルを設定すると仮定する点を除いては、三つ目の形式と同じです。

note: Tag: para
en: For Variant 5, an array of <xref linkend="geomval"/> is used to determine the specific pixels to be set. If all the geometries in the array are of type POINT or MULTIPOINT, the function uses a shortcut where the longitude and latitude of each point is used to set a pixel directly. Otherwise, the geometries are converted to rasters and then iterated through in one pass. See example Variant 5.
ja: 五つ目の形式では、設定するピクセルを<xref linkend="geomval"/>の配列で決定します。配列内の全てのジオメトリのタイプがPOINTまたはMULTIPOINTである場合には、ポイントごとの経度と緯度がピクセルの設定に直接使うためのショートカットに使われます。他の場合には、ジオメトリはラスタに変換され一つずつ渡されます。五つ目の形式の例をご覧下さい。

note: Tag: title
en: Examples: Variant 3
ja: 例: 三つ目の形式

note: Tag: title
en: Examples: Variant 5
ja: 例: 五つ目の形式

note: Tag: para
en: The following shows that geomvals later in the array can overwrite prior geomvals
ja: 配列内における後のgeomvalsで前のgeomvalsを上書きできることを示しています。

note: Tag: para
en: This example is the opposite of the prior example
ja: この例は前の例の逆です。

note: Tag: refpurpose
en: Get the values of the specified band as a 2-dimension array.
ja: 指定したバンドの値を2次元で得ます。

note: Tag: para
en: Get the values of the specified band as a 2-dimension array (first index is row, second is column). If <varname>nband</varname> is NULL or not provided, all raster bands are processed.
ja: 指定したバンドの値を2次元で得ます (一つ目の添え字で行、二つ目の添え字で列に、それぞれ対応します)。<varname>nband</varname>がNULLまたは指定されていない場合には、全てのラスタバンドが処理されます。

note: Tag: refpurpose
en: Get the columnx, rowy coordinates of the pixel whose value equals the search value.
ja: 検索値と同じ値を持つピクセルのcolumnx, rowyピクセル座標を得ます。

note: Tag: para
en: Get the columnx, rowy coordinates of the pixel whose value equals the search value. If no band is specified, then band 1 is assumed.
ja: 検索値と同じ値を持つピクセルのcolumnx, rowyピクセル座標を得ます。バンドを指定しない場合には、1番と仮定します。

note: Tag: title
en: Raster Editors
ja: ラスタエディタ

note: Tag: refpurpose
en: Set Georeference 6 georeference parameters in a single call. Numbers should be separated by white space. Accepts inputs in GDAL or ESRI format. Default is GDAL.
ja: 地理参照6パラメタを一度に設定します。数値は空白で区切ります。GDALまたはESRI書式の入力を受け付けます。デフォルトはGDALです。

note: Tag: para
en: Set Georeference 6 georeference parameters in a single call. Accepts inputs in 'GDAL' or 'ESRI' format. Default is GDAL. If 6 coordinates are not provided will return null.
ja: 地理参照6パラメタを一度に設定します。'GDAL'または'ESRI'書式の入力を受け付けます。デフォルトはGDALです。6パラメタが与えられない場合には、NULLを返します。

note: Tag: para
en: If the raster has out-db bands, changing the georeference may result in incorrect access of the band's externally stored data.
ja: ラスタがデータベース外のバンドを持っている場合には、地理参照の変更によって、バンドの外部保存されているデータに正しくアクセスできなくなることがあります。

note: Tag: para
en: Enhanced: 2.1.0 Addition of ST_SetGeoReference(raster, double precision, ...) variant
ja: Enhanced: 2.1.0 ST_SetGeoReference(raster, double precision, ...)形式を追加しました。

note: Tag: refpurpose
en: Set the rotation of the raster in radian.
ja: ラスタの回転をラジアン単位で設定します。

note: Tag: para
en: Uniformly rotate the raster. Rotation is in radian. Refer to <link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> for more details.
ja: ラスタを回転させます。回転はラジアン単位です。詳細については<link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> (英語版WikiPedia)をご覧下さい。

note: Tag: refpurpose
en: Sets the X and Y size of pixels in units of coordinate reference system. Number units/pixel width/height.
ja: ピクセルサイズのX値とY値を空間参照系の単位で設定します。数値は単位/ピクセルの幅または高さです。

note: Tag: para
en: Sets the X and Y size of pixels in units of coordinate reference system. Number units/pixel width/height. If only one unit passed in, assumed X and Y are the same number.
ja: ピクセルサイズのX値とY値を空間参照系の単位で設定します。数値は単位/ピクセルの幅または高さです。一つだけ渡した場合には、X値とY値は同じ値に設定されます。

note: Tag: para
en: ST_SetScale is different from <xref linkend="RT_ST_Rescale"/> in that ST_SetScale do not resample the raster to match the raster extent. It only changes the metadata (or georeference) of the raster to correct an originally mis-specified scaling. ST_Rescale results in a raster having different width and height computed to fit the geographic extent of the input raster. ST_SetScale do not modify the width, nor the height of the raster.
ja: ST_SetScaleはラスタの範囲をあわせるためのリサンプリングをしない点で<xref linkend="RT_ST_Rescale"/>と異なります。根本的に誤った設定を行ったのを訂正するためにラスタのメタデータ (地理参照)を変更するだけです。ST_Rescaleは、入力ラスタの地理範囲に合わせて計算された幅、高さを持つラスタを返します。ST_SetScaleはラスタの幅も高さも変更しません。

note: Tag: para
en: Changed: 2.0.0 In WKTRaster versions this was called ST_SetPixelSize. This was changed in 2.0.0.
ja: Changed: 2.0.0 WKTRaster版では、ST_SetPixelSizeと呼ばれていました。2.0.0で変更されました。

note: Tag: refpurpose
en: Sets the georeference X and Y skew (or rotation parameter). If only one is passed in, sets X and Y to the same value.
ja: 地理参照のスキュー (回転パラメタ)のX値とY値を設定します。一つだけ渡した場合には、X値とY値は同じ値に設定されます。

note: Tag: para
en: Sets the georeference X and Y skew (or rotation parameter). If only one is passed in, sets X and Y to the same value. Refer to <link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> for more details.
ja: 地理参照のスキュー (回転パラメタ)のX値とY値を設定します。一つだけ渡した場合には、X値とY値は同じ値に設定されます。詳細については<link xlink:href="http://en.wikipedia.org/wiki/World_file">World File</link> (英語版WikiPedia)をご覧下さい。

note: Tag: refpurpose
en: Sets the SRID of a raster to a particular integer srid defined in the spatial_ref_sys table.
ja: スタのSRIDをspatial_ref_sysに定義されている特定の整数値に設定します。

note: Tag: para
en: Sets the SRID on a raster to a particular integer value.
ja: ラスタのSRIDを特定の整数値に設定します。

note: Tag: para
en: This function does not transform the raster in any way - it simply sets meta data defining the spatial ref of the coordinate reference system that it's currently in. Useful for transformations later.
ja: ラスタの投影変換は行いません。単にメタデータを空間参照系の定義されている値に設定するだけです。後で投影変換を行う場合に使います。

note: Tag: refpurpose
en: Sets the value of the upper left corner of the pixel of the raster to projected X and Y coordinates.
ja: ラスタの左上隅の投影座標系のX値とY値を設定します。

note: Tag: para
en: Set the value of the upper left corner of raster to the projected X and Y coordinates
ja: ラスタの左上隅の投影座標系のX値とY値を設定します。

note: Tag: refpurpose
en: Resample a raster using a specified resampling algorithm, new dimensions, an arbitrary grid corner and a set of raster georeferencing attributes defined or borrowed from another raster.
ja: 指定したリサンプリングアルゴリズム、新しいピクセル範囲、グリッドの隅、定義するか他のラスタから借りてきた地理参照属性を使ってリサンプリングを行います。

note: Tag: para
en: Resample a raster using a specified resampling algorithm, new dimensions (width &amp; height), a grid corner (gridx &amp; gridy) and a set of raster georeferencing attributes (scalex, scaley, skewx &amp; skewy) defined or borrowed from another raster. If using a reference raster, the two rasters must have the same SRID.
ja: 指定したリサンプリングアルゴリズム、新しいピクセル範囲 (width &amp; height)、グリッド隅 (gridx &amp; gridy)、定義するか他のラスタから借りてきた地理参照属性 (scalex, scaley, skewx, skewy)を使ってリサンプリングを行います。参照ラスタを使用する場合には、二つのラスタは同じSRIDでなければなりません。

note: Tag: para
en: New pixel values are computed using one of the following resampling algorithms:
ja: 新しいピクセル値は次のリサンプリングアルゴリズムの一つを使って計算されます:

note: Tag: para
en: NearestNeighbor (english or american spelling)
ja: NearestNeighbor (最近傍補間、英語又は米式綴り方)

note: Tag: para
en: Bilinear
ja: Bilinear (双線形補間)

note: Tag: para
en: Cubic
ja: Cubic (3次補完)

note: Tag: para
en: CubicSpline
ja: CubicSpline (3次スプライン補完)

note: Tag: para
en: Lanczos
ja: Lanczos (ランチョス補間)

note: Tag: para
en: <para>Max</para>
ja: <para>Max (最大)</para>

note: Tag: para
en: <para>Min</para>
ja: <para>Min (最小)</para>

note: Tag: para
en: The default is NearestNeighbor which is the fastest but results in the worst interpolation.
ja: デフォルトはNearestNeighbor (最近傍補間)です。最も実行速度が速いですが、結果の補間が最も悪くなります。

note: Tag: para
en: A maxerror percent of 0.125 is used if no <varname>maxerr</varname> is specified.
ja: <varname>maxerr</varname>が指定されていない場合には0.125とします。

note: Tag: para
en: Refer to: <link xlink:href="http://www.gdal.org/gdalwarp.html">GDAL Warp resampling methods</link> for more details.
ja: 詳細については <link xlink:href="http://www.gdal.org/gdalwarp.html">GDAL Warp resampling methods</link>をご覧下さい。

note: Tag: para
en: Availability: 2.0.0 Requires GDAL 1.6.1+
ja: Availability: 2.0.0 GDAL 1.6.1以上が必要です。

note: Tag: para
en: Enhanced: 3.4.0 max and min resampling options added
ja: Enhanced: 3.4.0 リサンプリング選択肢に最大と最小を追加

note: Tag: refpurpose
en: Resample a raster by adjusting only its scale (or pixel size). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline, Lanczos, Max or Min resampling algorithm. Default is NearestNeighbor.
ja: スケール (ピクセルサイズ)だけを調整するリサンプリングを行います。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (英語または米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最近傍補間です。

note: Tag: para
en: Resample a raster by adjusting only its scale (or pixel size). New pixel values are computed using one of the following resampling algorithms:
ja: スケール (またはピクセルサイズ)だけを調整するリサンプリングを行います。新しいピクセル値は次のリサンプリングアルゴリズム使って計算されます:

note: Tag: para
en: <varname>scalex</varname> and <varname>scaley</varname> define the new pixel size. scaley must often be negative to get well oriented raster.
ja: <varname>scalex</varname>と<varname>scaley</varname>で、新しいピクセルサイズを定義します。ラスタを正しい方向にするには、scaleyは負数でなければならないことがしばしばあります。

note: Tag: para
en: When the new scalex or scaley is not a divisor of the raster width or height, the extent of the resulting raster is expanded to encompass the extent of the provided raster. If you want to be sure to retain exact input extent see <xref linkend="RT_ST_Resize"/>
ja: 新しいscalexまたはscaleyがラスタのwidthまたはheightの除数でない時、結果ラスタの範囲は元のラスタの範囲を含むために拡大されます。<xref linkend="RT_ST_Resize"/>をご覧ください。

note: Tag: para
en: <varname>maxerr</varname> is the threshold for transformation approximation by the resampling algorithm (in pixel units). A default of 0.125 is used if no <varname>maxerr</varname> is specified, which is the same value used in GDAL gdalwarp utility. If set to zero, no approximation takes place.
ja: <varname>maxerr</varname>は、リサンプリングアルゴリズムで変換を行う際に近似を行うかどうかを決めるしきい値です (ピクセル単位)。<varname>maxerr</varname>を設定しない場合には、デフォルトの0.125が使用され、この値はGDALのgdalwarpユーティリティで使われる値と同じです。0に設定した場合には、近似は行われません。

note: Tag: para
en: ST_Rescale is different from <xref linkend="RT_ST_SetScale"/> in that ST_SetScale do not resample the raster to match the raster extent. ST_SetScale only changes the metadata (or georeference) of the raster to correct an originally mis-specified scaling. ST_Rescale results in a raster having different width and height computed to fit the geographic extent of the input raster. ST_SetScale do not modify the width, nor the height of the raster.
ja: ST_Recalcは、ST_SetScaleはラスタ範囲に合わせるためのリサンプリングをしない点で、<xref linkend="RT_ST_SetScale"/>と異なります。ST_SetScaleは根本的に誤った設定を行ったのを訂正するためにラスタのメタデータ (地理参照)を変更するだけです。ST_Rescaleは、入力ラスタの地理範囲に合わせて計算された幅、高さを持つラスタを返します。ST_SetScaleはラスタの幅も高さも変更しません。

note: Tag: para
en: Changed: 2.1.0 Works on rasters with no SRID
ja: Changed: 2.1.0 SRIDなしのラスタで動作するようになりました。

note: Tag: para
en: A simple example rescaling a raster from a pixel size of 0.001 degree to a pixel size of 0.0015 degree.
ja: ラスタのピクセルサイズを0.001度から0.0015度にスケール再設定を行う例です。

note: Tag: refpurpose
en: Resample a raster by adjusting only its skew (or rotation parameters). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. Default is NearestNeighbor.
ja: キュー (回転パラメタ)だけを調整するリサンプリングを行います。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最近傍補間です。

note: Tag: para
en: Resample a raster by adjusting only its skew (or rotation parameters). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. The default is NearestNeighbor which is the fastest but results in the worst interpolation.
ja: スキュー (回転パラメタ)だけを調整するリサンプリングを行います。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最も早いですが最も悪い内挿を行う最近傍補間です。

note: Tag: para
en: <varname>skewx</varname> and <varname>skewy</varname> define the new skew.
ja: <varname>skewx</varname>と<varname>skewy</varname>によって新しいスキューが定義されます。

note: Tag: para
en: The extent of the new raster will encompass the extent of the provided raster.
ja: 新しいラスタの範囲は元のラスタの範囲を含みます。

note: Tag: para
en: A maxerror percent of 0.125 if no <varname>maxerr</varname> is specified.
ja: <varname>maxerr</varname>が指定されていない場合には0.125とします。

note: Tag: para
en: ST_Reskew is different from <xref linkend="RT_ST_SetSkew"/> in that ST_SetSkew do not resample the raster to match the raster extent. ST_SetSkew only changes the metadata (or georeference) of the raster to correct an originally mis-specified skew. ST_Reskew results in a raster having different width and height computed to fit the geographic extent of the input raster. ST_SetSkew do not modify the width, nor the height of the raster.
ja: ST_Reskewは、ST_SetSkewがラスタの範囲をあわせるためのリサンプリングをしない点で<xref linkend="RT_ST_SetSkew"/>と異なります。根本的に誤った設定を行ったのを訂正するためにラスタのメタデータ (地理参照)を変更するだけです。ST_Reskewは、入力ラスタの地理範囲に合わせて計算された幅、高さを持つラスタを返します。ST_SetSkewはラスタの幅も高さも変更しません。

note: Tag: para
en: A simple example reskewing a raster from a skew of 0.0 to a skew of 0.0015.
ja: スキューを0.0から0.0015に再設定する簡単な例です。

note: Tag: refpurpose
en: Resample a raster by snapping it to a grid. New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. Default is NearestNeighbor.
ja: グリッドにスナップすることでラスタをリサンプリングします。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間('Lanczos')を用います。デフォルトは最近傍補間です。

note: Tag: para
en: Resample a raster by snapping it to a grid defined by an arbitrary pixel corner (gridx &amp; gridy) and optionally a pixel size (scalex &amp; scaley). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. The default is NearestNeighbor which is the fastest but results in the worst interpolation.
ja: 任意のピクセル隅 (gridx &amp; gridy)と、任意引数としてピクセルサイズ (scalex &amp; scaley)によって定義されるグリッドにスナップすることでラスタをリサンプリングします。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最も早いですが最も悪い内挿を行う最近傍補間です。

note: Tag: para
en: <varname>gridx</varname> and <varname>gridy</varname> define any arbitrary pixel corner of the new grid. This is not necessarily the upper left corner of the new raster and it does not have to be inside or on the edge of the new raster extent.
ja: <varname>gridx</varname>と<varname>gridy</varname>は、新しいグリッドの任意のピクセル隅を定義します。これは新しいラスタの左上隅に必ずなるものではありません。新しいラスタ範囲の内部または境界である必要はありません。

note: Tag: para
en: You can optionally define the pixel size of the new grid with <varname>scalex</varname> and <varname>scaley</varname>.
ja: 任意引数として、新しいグリッドのピクセルサイズを<varname>scalex</varname>と<varname>scaley</varname>で指定することができます。

note: Tag: para
en: Use <xref linkend="RT_ST_Resample"/> if you need more control over the grid parameters.
ja: グリッドパラメタより多くの制御が必要な場合には、<xref linkend="RT_ST_Resample"/>を使います。

note: Tag: para
en: A simple example snapping a raster to a slightly different grid.
ja: ラスタをわずかに異なるグリッドにスナップさせる簡単な例です。

note: Tag: refpurpose
en: Resize a raster to a new width/height
ja: ラスタを新しい幅、高さにサイズ再設定を行います。

note: Tag: para
en: Resize a raster to a new width/height. The new width/height can be specified in exact number of pixels or a percentage of the raster's width/height. The extent of the the new raster will be the same as the extent of the provided raster.
ja: ラスタを新しい幅、高さにサイズ再設定を行います。新しい幅、高さはピクセル数で確実に指定するか、ラスタの幅、高さの比率で指定します。新しいラスタの範囲は元のラスタの範囲と同じです。

note: Tag: para
en: New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. The default is NearestNeighbor which is the fastest but results in the worst interpolation.
ja: 新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最も早いですが最も悪い内挿を行う最近傍補間です。

note: Tag: para
en: Variant 1 expects the actual width/height of the output raster.
ja: 一つ目の形式では、出力ラスタの実際の幅、高さを予定しています。

note: Tag: para
en: Variant 2 expects decimal values between zero (0) and one (1) indicating the percentage of the input raster's width/height.
ja: 二つ目の形式では、0から1の間の値で、入力ラスタの幅、高さに対する比率を指定しています。

note: Tag: para
en: Variant 3 takes either the actual width/height of the output raster or a textual percentage ("20%") indicating the percentage of the input raster's width/height.
ja: 三つ目の形式では、出力ラスタの実際の幅、高さを取るか、文字列による入力ラスタの幅、高さに対する百分率 ("20%")を取ります。

note: Tag: para
en: Availability: 2.1.0 Requires GDAL 1.6.1+
ja: Availability: 2.1.0 GDAL 1.6.1以上が必要です。

note: Tag: refpurpose
en: Reprojects a raster in a known spatial reference system to another known spatial reference system using specified resampling algorithm. Options are NearestNeighbor, Bilinear, Cubic, CubicSpline, Lanczos defaulting to NearestNeighbor.
ja: ラスタを既知の空間参照系から他の既知の空間参照系に、指定したリサンプリングアルゴリズムで投影変換します。新しいピクセル値のリサンプリングアルゴリズムとして最近傍補間 ('NearestNeighbor' (米式綴り方))、双線形補間 ('Bilinear')、3次補間 ('Cubic')、3次スプライン補間 ('CubicSpline')、ランチョス補間 ('Lanczos')を用います。デフォルトは最近傍補間です。

note: Tag: para
en: Reprojects a raster in a known spatial reference system to another known spatial reference system using specified pixel warping algorithm. Uses 'NearestNeighbor' if no algorithm is specified and maxerror percent of 0.125 if no maxerr is specified.
ja: ラスタを既知の空間参照系から他の既知の空間参照系に、指定したリサンプリングアルゴリズムで投影変換します。algorithmが指定されていない場合には'NearestNeighbor'とし、maxerrorが指定されていない場合には0.125とします。

note: Tag: para
en: ST_Transform is often confused with ST_SetSRID(). ST_Transform actually changes the coordinates of a raster (and resamples the pixel values) from one spatial reference system to another, while ST_SetSRID() simply changes the SRID identifier of the raster.
ja: ST_TransformはしばしばST_SetSRIDと混同されます。ST_Transformは、ある空間参照系から別の空間参照系に変更する際に、実際にラスタの座標を変更します (かつピクセル値のリサンプリングを行います)が、ST_SetSRIDは単にラスタの空間参照系識別子を変更するだけです。

note: Tag: para
en: Unlike the other variants, Variant 3 requires a reference raster as <varname>alignto</varname>. The transformed raster will be transformed to the spatial reference system (SRID) of the reference raster and be aligned (ST_SameAlignment = TRUE) to the reference raster.
ja: 三つ目の形式は、他の形式と違い、<varname>alignto</varname>として参照ラスタが求められます。投影変換したラスタは参照ラスタの空間参照系 (SRID)に投影変換して、参照ラスタと同じアラインメントを持つようにします (ST_SameAlignmentがTRUEになるようにします)。

note: Tag: para
en: If you find your transformation support is not working right, you may need to set the environment variable PROJSO to the .so or .dll projection library your PostGIS is using. This just needs to have the name of the file. So for example on windows, you would in Control Panel -&gt; System -&gt; Environment Variables add a system variable called <varname>PROJSO</varname> and set it to <varname>libproj.dll</varname> (if you are using proj 4.6.1). You'll have to restart your PostgreSQL service/daemon after this change.
ja: 変換機能が思ったように働かない場合には、環境変数PROJSOをPostGISが使用する投影変換ライブラリの.soまたは.dllに指定する必要があるかも知れません。ファイル名の指定だけ必要です。Windowsでの例として、コントロールパネル-&gt;システム-&gt;システムの詳細設定-&gt;環境変数で、<varname>PROJSO</varname>という名前のシステム変数を追加して、<varname>libproj.dll</varname> (Proj 4.6.1を使用している場合)を設定します。変更後はPostgreSQLサービス/デーモンを再起動します。

note: Tag: para
en: When transforming a coverage of tiles, you almost always want to use a reference raster to insure same alignment and no gaps in your tiles as demonstrated in example: Variant 3.
ja: タイルのカバレッジを変換する時には、ほとんどの場合で、「例: 三つ目の形式」で示す通り、同じアラインメントになり、かつタイル内に隙間がなくなるようにするために、参照ラスタを使用したくなります。

note: Tag: para
en: Enhanced: 2.1.0 Addition of ST_Transform(rast, alignto) variant
ja: Enhanced: 2.1.0 ST_Tranfrorm(rast, alignto)の形式を追加しました。

note: Tag: para
en: original mass state plane meters (mass_stm)
ja: 元のラスタはメートル単位のマサチューセッツ州平面 (mass_stm)

note: Tag: para
en: After transform to wgs 84 long lat (wgs_84)
ja: WGS84経度緯度に変換した後 (wgs_84)

note: Tag: para
en: After transform to wgs 84 long lat with bilinear algorithm instead of NN default (wgs_84_bilin)
ja: 最近傍補間の代わりに双線形補間を使ってWGS84経度緯度に変換した後 (wgs_84_bilin)

note: Tag: para
en: The following shows the difference between using ST_Transform(raster, srid) and ST_Transform(raster, alignto)
ja: 次に示す例は、ST_Transform(raster, srid)とST_Transform(raster, alignto)との違いを示しています。

note: Tag: para
en: not_aligned
ja: アラインメントなし

note: Tag: para
en: aligned
ja: アラインメントあり

note: Tag: title
en: Raster Band Editors
ja: ラスタバンドエディタ

note: Tag: refpurpose
en: Sets the value for the given band that represents no data. Band 1 is assumed if no band is specified. To mark a band as having no nodata value, set the nodata value = NULL.
ja: 指定したバンドにNODATAを表現する値を設定します。バンドを指定しない場合には、1番と仮定します。NODATA値を持たないようにするには、nodatavalueにNULLを指定します。

note: Tag: para
en: Sets the value that represents no data for the band. Band 1 is assumed if not specified. This will affect results from <xref linkend="RT_ST_Polygon"/>, <xref linkend="RT_ST_DumpAsPolygons"/>, and the ST_PixelAs...() functions.
ja: 指定したバンドにNODATAを表現する値を設定します。バンドを指定しない場合には、1番と仮定します。この関数は<xref linkend="RT_ST_Polygon"/>, <xref linkend="RT_ST_DumpAsPolygons"/>, ST_PixelAs系関数群からの結果に影響を与えます。

note: Tag: refpurpose
en: Sets the isnodata flag of the band to TRUE.
ja: バンドのisnodataフラグをTRUEにします。

note: Tag: para
en: Sets the isnodata flag for the band to true. Band 1 is assumed if not specified. This function should be called only when the flag is considered dirty. That is, when the result calling <xref linkend="RT_ST_BandIsNoData"/> is different using TRUE as last argument and without using it
ja: バンドのisnodataフラグをTRUEにします。バンドを指定しない場合には、1番と仮定します。isnodataフラグが汚れている場合にのみ呼ぶべきものです。<xref linkend="RT_ST_BandIsNoData"/>の、最後の引数にTRUEを設定した場合の結果と指定しない場合の結果とで異なっている時です。

note: Tag: refpurpose
en: Update the external path and band number of an out-db band
ja: データベース外バンドの外部パスとバンド番号を更新します。

note: Tag: para
en: Updates an out-db band's external raster file path and external band number.
ja: データベース外バンドの外部パスと外部バンド番号を更新します。

note: Tag: para
en: If <varname>force</varname> is set to true, no tests are done to ensure compatibility (e.g. alignment, pixel support) between the external raster file and the PostGIS raster. This mode is intended for file system changes where the external raster resides.
ja: <varname>force</varname>がTRUEの場合には、外部ラスタファイルとPostGISラスタとの互換性 (例：アラインメント、ピクセル対応)確認のためのテストを行いません。このモードは、外部ラスタファイルが存在するファイルシステムの変更を目的としています。

note: Tag: refpurpose
en: Update the external band number of an out-db band
ja: データベース外バンドの外部バンド番号の更新

note: Tag: para
en: Updates an out-db band's external band number. This does not touch the external raster file associated with the out-db band
ja: データベース外バンドの外部バンド番号を更新します。データベース外バンドと関連する外部ラスタファイルには触れません。

note: Tag: para
en: If <varname>force</varname> is set to true, no tests are done to ensure compatibility (e.g. alignment, pixel support) between the external raster file and the PostGIS raster. This mode is intended for where bands are moved around in the external raster file.
ja: <varname>force</varname>がTRUEの場合には、外部ラスタファイルとPostGISラスタとの互換性 (例：アラインメント、ピクセル対応)確認のためのテストを行いません。このモードは、バンドが外部ラスタファイル内で移動する場所を対象としています。

note: Tag: para
en: Internally, this method replaces the PostGIS raster's band at index <varname>band</varname> with a new band instead of updating the existing path information.
ja: 内部的には、このメソッドは、存在するパス情報を更新する替わりに、PostGISラスタの<varname>band</varname>で指定したバンドを新しいバンドに置き換えます。

note: Tag: title
en: Raster Band Statistics and Analytics
ja: ラスタバンド統計情報と解析

note: Tag: refpurpose
en: Returns the number of pixels in a given band of a raster or raster coverage. If no band is specified defaults to band 1. If exclude_nodata_value is set to true, will only count pixels that are not equal to the nodata value.
ja: ラスタまたはラスタカバレッジの指定したバンドのピクセル数を返します。バンドを指定しない場合には、1番と仮定します。exclude_nodata_valueをTRUEに設定している場合には、NODATA値と等しくないピクセルのみを数えます。

note: Tag: para
en: Returns the number of pixels in a given band of a raster or raster coverage. If no band is specified <varname>nband</varname> defaults to 1.
ja: ラスタまたはラスタカバレッジの指定したバンドのピクセル数を返します。<varname>nband</varname>でバンドを指定しない場合には、1番と仮定します。

note: Tag: para
en: If <varname>exclude_nodata_value</varname> is set to true, will only count pixels with value not equal to the <varname>nodata</varname> value of the raster. Set <varname>exclude_nodata_value</varname> to false to get count all pixels
ja: <varname>exclude_nodata_value</varname>をTRUEに設定している場合には、<varname>nodata</varname>値と等しくないピクセルのみ数えます。<varname>exclude_nodata_value</varname>をFALSEに設定している場合には、全てのピクセルを数えます。

note: Tag: para
en: Changed: 3.1.0 - The ST_Count(rastertable, rastercolumn, ...) variants removed. Use <xref linkend="RT_ST_CountAgg"/> instead.
ja: Changed: 3.1.0 - ST_Count(rastertable, rastercolumn, ...) の形式は削除されました。代わりに<xref linkend="RT_ST_CountAgg"/>を使用します。

note: Tag: refpurpose
en: Aggregate. Returns the number of pixels in a given band of a set of rasters. If no band is specified defaults to band 1. If exclude_nodata_value is set to true, will only count pixels that are not equal to the NODATA value.
ja: 集約関数です。ラスタ集合の与えられたバンドのピクセル数を返します。バンドが指定されていない場合には、1番と仮定します。exclude_nodata_valueをTRUEに設定している場合には、NODATA値と等しくないピクセルのみを数えます。

note: Tag: para
en: Returns the number of pixels in a given band of a set of rasters. If no band is specified <varname>nband</varname> defaults to 1.
ja: ラスタ集合の与えられたバンドのピクセル数を返します。<varname>nband</varname>でバンドを指定しない場合には、1番と仮定します。

note: Tag: para
en: If <varname>exclude_nodata_value</varname> is set to true, will only count pixels with value not equal to the <varname>NODATA</varname> value of the raster. Set <varname>exclude_nodata_value</varname> to false to get count all pixels
ja: <varname>exclude_nodata_value</varname>をTRUEに設定している場合には、<varname>NODATA</varname>値と等しくないピクセルのみを数えます。<varname>exclude_nodata_value</varname>をFALSEに設定している場合には、全てのピクセルを数えます。

note: Tag: para
en: By default will sample all pixels. To get faster response, set <varname>sample_percent</varname> to value between zero (0) and one (1)
ja: デフォルトでは、全てのピクセルを見ます。より早い応答を得るには、<varname>sample_percent</varname>値を0から1の間で設定します。

note: Tag: refpurpose
en: Returns a set of record summarizing a raster or raster coverage data distribution separate bin ranges. Number of bins are autocomputed if not specified.
ja: ラスタまたはラスタカバレッジのビン範囲で分割したデータ分布をまとめるヒストグラムの集合を返します。ビン数を指定しない場合には自動計算されます。

note: Tag: para
en: Returns set of records consisting of min, max, count, percent for a given raster band for each bin. If no band is specified <varname>nband</varname> defaults to 1.
ja: 最小値、最大値、合計数、全体から見た割合からなるレコードの集合を返します。<varname>nband</varname>でバンドを指定しない場合には、1番と仮定します。

note: Tag: para
en: By default only considers pixel values not equal to the <varname>nodata</varname> value . Set <varname>exclude_nodata_value</varname> to false to get count all pixels.
ja: デフォルトでは、<varname>nodata</varname>と同じピクセル値は考慮に入れません。<varname>exclude_nodata_value</varname>をFALSEに設定すると全てのピクセルを数えます。

note: Tag: para
en: width: an array indicating the width of each category/bin. If the number of bins is greater than the number of widths, the widths are repeated.
ja: カテゴリ/ビン毎の幅を示す配列です。ビン数の指定がwidth要素数を超える場合には、widthを繰り返します。

note: Tag: para
en: Example: 9 bins, widths are [a, b, c] will have the output be [a, b, c, a, b, c, a, b, c]
ja: 例: ビン9個、widthが[a, b, c]では、[a, b, c, a, b, c, a, b, c]が出力されます。

note: Tag: para
en: Number of breakouts -- this is the number of records you'll get back from the function if specified. If not specified then the number of breakouts is autocomputed.
ja: 取り出し数 -- 関数から戻そうとするレコード数です。指定しない場合には、自動計算されます。

note: Tag: para
en: compute the histogram from the right rather than from the left (default). This changes the criteria for evaluating a value x from [a, b) to (a, b]
ja: ヒストグラムを右から計算します (デフォルトは左からです)。値の評価の優先順位が、X軸について[a, b)から(a, b]に変わります。

note: Tag: para
en: Changed: 3.1.0 Removed ST_Histogram(table_name, column_name) variant.
ja: Changed: 3.1.0 ST_Histogram(table_name, column_name) の形式は削除されました。

note: Tag: title
en: Example: Single raster tile - compute histograms for bands 1, 2, 3 and autocompute bins
ja: 例: 単一ラスタタイル - ビン数を自動計算とした、1番、2番、3番バンドのヒストグラムの計算

note: Tag: title
en: Example: Just band 2 but for 6 bins
ja: 例: ビン数を6で固定して2番バンドだけを計算

note: Tag: refpurpose
en: <refpurpose>Compute quantiles for a raster or raster table coverage in the context of the sample or population. Thus, a value could be examined to be at the raster's 25%, 50%, 75% percentile.</refpurpose>
ja: <refpurpose>ラスタまたはラスタテーブルカバレッジのサンプルまたは母集団の分位数を計算します。値がラスタの25%,50%,75%にあるかを調べることができます。</refpurpose>

note: Tag: para
en: <para>Compute quantiles for a raster or raster table coverage in the context of the sample or population. Thus, a value could be examined to be at the raster's 25%, 50%, 75% percentile.</para>
ja: <para>ラスタまたはラスタテーブルカバレッジのサンプルまたは母集団の分位数を計算します。値がラスタの25%,50%,75%にあるかを調べることができます。</para>

note: Tag: para
en: If <varname>exclude_nodata_value</varname> is set to false, will also count pixels with no data.
ja: <varname>exclude_nodata_value</varname>をFALSEに設定している場合には、NODATA値となるピクセルも数えます。

note: Tag: para
en: Changed: 3.1.0 Removed ST_Quantile(table_name, column_name) variant.
ja: Changed: 3.1.0 ST_Quantile(table_name, column_name) の形式は削除されました。

note: Tag: refpurpose
en: Returns summarystats consisting of count, sum, mean, stddev, min, max for a given raster band of a raster or raster coverage. Band 1 is assumed is no band is specified.
ja: ラスタまたはラスタカバレッジの指定したバンドについて、ピクセル数、合計値、平均値、標準偏差、最小値、最大値からなる統計情報の概要を返します。バンドを指定しない場合には、1番と仮定します。

note: Tag: para
en: Returns <xref linkend="summarystats"/> consisting of count, sum, mean, stddev, min, max for a given raster band of a raster or raster coverage. If no band is specified <varname>nband</varname> defaults to 1.
ja: ラスタまたはラスタカバレッジの指定したバンドについて、ピクセル数、合計値、平均値、標準偏差、最小値、最大値からなる<xref linkend="summarystats"/>による統計情報の概要を返します。<varname>nband</varname>でバンドを指定しない場合には、1番と仮定します。

note: Tag: para
en: By default only considers pixel values not equal to the <varname>nodata</varname> value. Set <varname>exclude_nodata_value</varname> to false to get count of all pixels.
ja: デフォルトでは、<varname>nodata</varname>と同じピクセル値は考慮に入れません。<varname>exclude_nodata_value</varname>をFALSEに設定すると全てのピクセルを数えます。

note: Tag: para
en: By default will sample all pixels. To get faster response, set <varname>sample_percent</varname> to lower than 1
ja: デフォルトでは、全てのピクセルを見ます。より早い応答を得るには、<varname>sample_percent</varname>値を1未満で設定します。

note: Tag: para
en: Changed: 3.1.0 ST_SummaryStats(rastertable, rastercolumn, ...) variants are removed. Use <xref linkend="RT_ST_SummaryStatsAgg"/> instead.
ja: Changed: 3.1.0 ST_SummaryStats(rastertable, rastercolumn, ...) の形式は削除されました。代わりに<xref linkend="RT_ST_SummaryStatsAgg"/>を使用します。

note: Tag: title
en: Example: Single raster tile
ja: 例: 単一ラスタタイル

note: Tag: title
en: Example: Summarize pixels that intersect buildings of interest
ja: 例: 対象とする建物とインタセクトするピクセルの概要

note: Tag: para
en: This example took 574ms on PostGIS windows 64-bit with all of Boston Buildings and aerial Tiles (tiles each 150x150 pixels ~ 134,000 tiles), ~102,000 building records
ja: この例は、ボストンの建物の全て (約102,000件)と空中写真タイル (150x150ピクセルで約134,000タイル)とで、Windows 64ビット上のPostGISで計算したところ、574ミリ秒かかりました。

note: Tag: title
en: Example: Raster coverage
ja: 例:ラスタカバレッジ

note: Tag: refpurpose
en: Aggregate. Returns summarystats consisting of count, sum, mean, stddev, min, max for a given raster band of a set of raster. Band 1 is assumed is no band is specified.
ja: 集約関数です。ラスタ集合の指定したバンドについて、ピクセル数、合計値、平均値、標準偏差、最小値、最大値からなる統計情報の概要を返します。バンドを指定しない場合には、1番と仮定します。

note: Tag: para
en: By default only considers pixel values not equal to the <varname>NODATA</varname> value. Set <varname>exclude_nodata_value</varname> to False to get count of all pixels.
ja: デフォルトでは、<varname>NODATA</varname>と同じピクセル値は考慮に入れません。<varname>exclude_nodata_value</varname>をFALSEに設定すると全てのピクセルを数えます。

note: Tag: para
en: By default will sample all pixels. To get faster response, set <varname>sample_percent</varname> to value between 0 and 1
ja: デフォルトでは全てのピクセルを見ます。よりい早い応答を得るには、<varname>sample_percent</varname>を0から1の間で設定します。

note: Tag: refpurpose
en: Returns a set of records containing a pixel band value and count of the number of pixels in a given band of a raster (or a raster coverage) that have a given set of values. If no band is specified defaults to band 1. By default nodata value pixels are not counted. and all other values in the pixel are output and pixel band values are rounded to the nearest integer.
ja: ラスタ　(またはラスタカバレッジ)の指定されたバンドで、指定した値を持つピクセルを対象として、ピクセルバンド値とピクセル数からなるレコードの集合を返します。バンドを指定しない場合には、1番と仮定します。デフォルトではNODATA値のピクセルは数えられず、ピクセルの他の値は出力され、ピクセルバンド値は最も近い整数に丸められます。

note: Tag: para
en: Returns a set of records with columns <varname>value</varname> <varname>count</varname> which contain the pixel band value and count of pixels in the raster tile or raster coverage of selected band.
ja: ラスタタイルまたはラスタカバレッジの指定したバンドにおけるピクセルバンド値とピクセル数にあたる、<varname>value</varname>と<varname>count</varname>からなるレコードの集合を返します。

note: Tag: para
en: If no band is specified <varname>nband</varname> defaults to 1. If no <varname>searchvalues</varname> are specified, will return all pixel values found in the raster or raster coverage. If one searchvalue is given, will return an integer instead of records denoting the count of pixels having that pixel band value
ja: <varname>nband</varname>でバンドを指定しない場合には、1番と仮定します。<varname>searchvalues</varname>が指定されていない場合には、ラスタまたはラスタカバレッジで発見した全てのピクセル値が返ります。searchvalueを一つ指定した場合には、指定したピクセルバンド値を持つピクセルの数を示すレコードでなく、整数を返します。

note: Tag: title
en: Raster Inputs
ja: ラスタ入力

note: Tag: refpurpose
en: Return a raster value from a Well-Known Binary (WKB) raster.
ja: Well-Known Binary (WKB)ラスタからラスタ値を返します。

note: Tag: para
en: Given a Well-Known Binary (WKB) raster, return a raster.
ja: Well-Known Binary (WKB)ラスタが与えられると、ラスタを返します。

note: Tag: refpurpose
en: Return a raster value from a Hex representation of Well-Known Binary (WKB) raster.
ja: Well-Knownバイナリ (WKB)ラスタの16進数表現からラスタを返します。

note: Tag: para
en: Given a Well-Known Binary (WKB) raster in Hex representation, return a raster.
ja: Well-Known Binary (WKB)ラスタが16進数表現で与えられると、ラスタを返します。

note: Tag: title
en: Raster Outputs
ja: 出力

note: Tag: refpurpose
en: Return the Well-Known Binary (WKB) representation of the raster.
ja: ラスタのWell-Known Binary (WKB)表現を返します。

note: Tag: para
en: Returns the Binary representation of the raster. If <varname>outasin</varname> is TRUE, out-db bands are treated as in-db. Refer to raster/doc/RFC2-WellKnownBinaryFormat located in the PostGIS source folder for details of the representation.
ja: ラスタのバイナリ表現を返します。<varname>outasin</varname>がTRUEの場合には、データベース外のバンドがデータベース内のバンドとして扱われます。表現の詳細については、PostGISソースフォルダにあるraster/doc/RFC2-WellKnownBinaryFormatをご覧下さい。

note: Tag: para
en: This is useful in binary cursors to pull data out of the database without converting it to a string representation.
ja: データを文字列表現に変換せずにデータベース外に引き出すためのバイナリカーソルに使えます。

note: Tag: para
en: By default, WKB output contains the external file path for out-db bands. If the client does not have access to the raster file underlying an out-db band, set <varname>outasin</varname> to TRUE.
ja: デフォルトでは、WKB出力には、データベース外のバンドの外部ファイルパスを含みます。クライアントがデータベース外にあるラスタファイルにアクセスできない場合には、<varname>outasin</varname>をTRUEに設定します。

note: Tag: para
en: Enhanced: 2.1.0 Addition of <varname>outasin</varname>
ja: Enhanced: 2.1.0 <varname>outasin</varname>の追加

note: Tag: para
en: Enhanced: 2.5.0 Addition of <varname>ST_AsWKB</varname>
ja: Enhanced: 2.5.0 <varname>ST_AsWKB</varname>の追加

note: Tag: refpurpose
en: Return the Well-Known Binary (WKB) in Hex representation of the raster.
ja: Well-Known Binary (WKB)ラスタを16進数表現で返します。

note: Tag: para
en: Returns the Binary representation in Hex representation of the raster. If <varname>outasin</varname> is TRUE, out-db bands are treated as in-db. Refer to raster/doc/RFC2-WellKnownBinaryFormat located in the PostGIS source folder for details of the representation.
ja: ラスタのバイナリの16進数表現を返します。<varname>outasin</varname>がTRUEの場合には、データベース外のバンドがデータベース内のバンドとして扱われます。表現の詳細については、PostGISソースフォルダにあるraster/doc/RFC2-WellKnownBinaryFormatをご覧下さい。

note: Tag: para
en: By default, Hex WKB output contains the external file path for out-db bands. If the client does not have access to the raster file underlying an out-db band, set <varname>outasin</varname> to TRUE.
ja: デフォルトでは、WKB出力には、データベース外のバンドの外部ファイルパスを含みます。クライアントがデータベース外バンドを持っているラスタファイルにアクセスできない場合には、<varname>outasin</varname>をTRUEに設定します。

note: Tag: refpurpose
en: Return the raster tile in the designated GDAL Raster format. Raster formats are one of those supported by your compiled library. Use ST_GDALDrivers() to get a list of formats supported by your library.
ja: 指定されたGDALラスタ書式でラスタタイルを返します。ラスタ書式はコンパイルしたライブラリが対応するものです。ライブラリが対応する書式の一覧を得るにはST_GDALRasters()を使います。

note: Tag: para
en: Returns the raster tile in the designated format. Arguments are itemized below:
ja: 指定された書式でラスタタイルを返します。引数は次の通りです。

note: Tag: para
en: <varname>format</varname> format to output. This is dependent on the drivers compiled in your libgdal library. Generally available are 'JPEG', 'GTIff', 'PNG'. Use <xref linkend="RT_ST_GDALDrivers"/> to get a list of formats supported by your library.
ja: <varname>format</varname> 出力書式です。libgdalライブラリでコンパイルしたドライバに依存します。一般的には'JPEG', 'GTIff', 'PNG'が有効になっています。ライブラリが対応する形式の一覧を得るには<xref linkend="RT_ST_GDALDrivers"/>を使います。

note: Tag: para
en: <varname>options</varname> text array of GDAL options. Valid options are dependent on the format. Refer to <link xlink:href="http://www.gdal.org/frmt_various.html">GDAL Raster format options</link> for more details.
ja: <varname>options</varname> GDALオプションの文字列配列です。妥当なオプションは書式に依存します。詳細については<link xlink:href="http://www.gdal.org/frmt_various.html">GDAL Raster format options</link>をご覧下さい。

note: Tag: para
en: <varname>srs</varname> The proj4text or srtext (from spatial_ref_sys) to embed in the image
ja: <varname>srs</varname> 画像に埋め込むproj4textまたはsrtext (spatial_ref_sysから)です。

note: Tag: title
en: JPEG Output Example, multiple tiles as single raster
ja: 複数タイルを単一ラスタとするJPEG出力例

note: Tag: title
en: Using PostgreSQL Large Object Support to export raster
ja: PostgreSQLラージオブジェクト対応を使ったラスタの出力

note: Tag: para
en: One way to export raster into another format is using <link xlink:href="https://www.postgresql.org/docs/current/static/lo-funcs.html">PostgreSQL large object export functions</link>. We'lll repeat the prior example but also exporting. Note for this you'll need to have super user access to db since it uses server side lo functions. It will also export to path on server network. If you need export locally, use the psql equivalent lo_ functions which export to the local file system instead of the server file system.
ja: ラスタを他の書式に出力する方法の一つとして、<link xlink:href="https://www.postgresql.org/docs/current/static/lo-funcs.html">PostgreSQL large object export functions</link>の使用があります。前の例の繰り返しですが、出力も行います。サーバ側のlo関数を使うため、データベースへのスーパーユーザ権限が必要となることに注意して下さい。また、サーバネットワーク上のパスに出力します。ローカルに出力するには、psqlで、サーバのファイルシステムでなくローカルのファイルシステムに出力する等価のlo_関数を使います。

note: Tag: title
en: GTIFF Output Examples
ja: GTIFF出力の例

note: Tag: refpurpose
en: Return the raster tile selected bands as a single Joint Photographic Exports Group (JPEG) image (byte array). If no band is specified and 1 or more than 3 bands, then only the first band is used. If only 3 bands then all 3 bands are used and mapped to RGB.
ja: ラスタの選択されたバンドを、単一のJoint Photographic Exports Group (JPEG)画像としてバイト配列で返します。バンドを指定せず、1バンドか3より多いバンドがある場合には、1番バンドを使用します。3バンドのみ指定した場合には、3バンドを使用し、RGBに対応付けます。

note: Tag: para
en: Returns the selected bands of the raster as a single Joint Photographic Exports Group Image (JPEG). Use <xref linkend="RT_ST_AsGDALRaster"/> if you need to export as less common raster types. If no band is specified and 1 or more than 3 bands, then only the first band is used. If 3 bands then all 3 bands are used. There are many variants of the function with many options. These are itemized below:
ja: ラスタの選択されたバンドを、単一のJoint Photographic Exports Group (JPEG)画像として返します。 より一般でないラスタタイプで出力する必要がある場合には、<xref linkend="RT_ST_AsGDALRaster"/>を使います。バンドを指定せず、1バンドか3より多いバンドがある場合には、1番バンドを使用します。3バンドのみ指定した場合には、3バンドを使用します。この関数には多数の任意引数が付くさまざまな形式があります。引数については次の通りです。

note: Tag: para
en: <varname>nband</varname> is for single band exports.
ja: <varname>nband</varname> 単一バンド出力のためのものです。

note: Tag: para
en: <varname>nbands</varname> is an array of bands to export (note that max is 3 for JPEG) and the order of the bands is RGB. e.g ARRAY[3,2,1] means map band 3 to Red, band 2 to green and band 1 to blue
ja: <varname>nbands</varname> 出力バンドの配列 (JPEGでは3要素が最大です)で、バンドの並び順はRGBです。たとえばARRAY[3,2,1]は、3番バンドを赤、2番バンドを緑、1番バンドを青にそれぞれ対応させます。

note: Tag: para
en: <varname>quality</varname> number from 0 to 100. The higher the number the crisper the image.
ja: <varname>quality</varname> 0から100の数値です。高いほどしっかりした画像になります。

note: Tag: para
en: <varname>options</varname> text Array of GDAL options as defined for JPEG (look at create_options for JPEG <xref linkend="RT_ST_GDALDrivers"/>). For JPEG valid ones are <varname>PROGRESSIVE</varname> ON or OFF and <varname>QUALITY</varname> a range from 0 to 100 and default to 75. Refer to <link xlink:href="http://www.gdal.org/frmt_various.html">GDAL Raster format options</link> for more details.
ja: <varname>options</varname> JPEGのために定義するGDALオプションの文字列配列です (<xref linkend="RT_ST_GDALDrivers"/>のcreate_optionsを見てください)。JPEGの妥当なパラメタは <varname>PROGRESSIVE</varname>の'ON'または'OFF'と、<varname>QUALITY</varname>の0から100までの数 (デフォルトは75)です。詳細については <link xlink:href="http://www.gdal.org/frmt_various.html">GDAL Raster format options</link>をご覧下さい。

note: Tag: title
en: Examples: Output
ja: 例: 出力

note: Tag: refpurpose
en: Return the raster tile selected bands as a single portable network graphics (PNG) image (byte array). If 1, 3, or 4 bands in raster and no bands are specified, then all bands are used. If more 2 or more than 4 bands and no bands specified, then only band 1 is used. Bands are mapped to RGB or RGBA space.
ja: ラスタの選択されたバンドを、単一のportable network graphics (PNG)画像としてバイト配列で返します。バンドを指定せず、1バンドか3バンドか4バンドある場合には、全てのバンドを使用します。バンドを指定せず、2バンドか4より多いバンドがある場合には、1番バンドを使用します。対象バンドはRGBまたはRGBAに対応付けられます。

note: Tag: para
en: Returns the selected bands of the raster as a single Portable Network Graphics Image (PNG). Use <xref linkend="RT_ST_AsGDALRaster"/> if you need to export as less common raster types. If no band is specified, then the first 3 bands are exported. There are many variants of the function with many options. If no <varname>srid</varname> is specified then then srid of the raster is used. These are itemized below:
ja: ラスタの選択されたバンドを、単一のportable network graphics (PNG)画像として返します。より一般でないラスタタイプで出力する必要がある場合には、<xref linkend="RT_ST_AsGDALRaster"/>を使います。バンドを指定しない場合には、前から3バンドを出力します。この関数には多数の任意引数が付くさまざまな形式があります。<varname>srid</varname>が指定されない場合には、sridはラスタが使用しているSRIDを指定します。引数の一覧は次の通りです。

note: Tag: para
en: <varname>nbands</varname> is an array of bands to export (note that max is 4 for PNG) and the order of the bands is RGBA. e.g ARRAY[3,2,1] means map band 3 to Red, band 2 to green and band 1 to blue
ja: <varname>nbands</varname> 出力バンドの配列 (PNGでは4要素が最大です)で、バンドの並び順はRGBAです。たとえばARRAY[3,2,1]は、3番バンドを赤、2番バンドを緑、1番バンドを青にそれぞれ対応させます。

note: Tag: para
en: <varname>compression</varname> number from 1 to 9. The higher the number the greater the compression.
ja: <varname>compression</varname> 1から9の数を指定します。大きいほど圧縮効率が上がります。

note: Tag: para
en: <varname>options</varname> text Array of GDAL options as defined for PNG (look at create_options for PNG of <xref linkend="RT_ST_GDALDrivers"/>). For PNG valid one is only ZLEVEL (amount of time to spend on compression -- default 6) e.g. ARRAY['ZLEVEL=9']. WORLDFILE is not allowed since the function would have to output two outputs. Refer to <link xlink:href="http://www.gdal.org/frmt_various.html">GDAL Raster format options</link> for more details.
ja: <varname>options</varname> PNGのために定義するGDALオプションの文字列配列です (<xref linkend="RT_ST_GDALDrivers"/>のcreate_optionsを見てください)。PNGの妥当なパラメタはZLEVEL (圧縮に費やす時間の合計で、デフォルトは6)です。ARRAY['ZLEVEL=9']というようにします。この関数が二つの出力を行う必要があるため、ワールドファイルはPNGでは許されません。詳細については<link xlink:href="http://www.gdal.org/frmt_various.html">GDAL Raster format options</link>をご覧下さい。

note: Tag: refpurpose
en: Return the raster selected bands as a single TIFF image (byte array). If no band is specified or any of specified bands does not exist in the raster, then will try to use all bands.
ja: ラスタの選択されたバンドを、単一のTIFF画像 (バイト配列)として返します。バンドを指定しないか指定したバンドがラスタ内に無い場合には、全てのバンドの使用を試みます。

note: Tag: para
en: Returns the selected bands of the raster as a single Tagged Image File Format (TIFF). If no band is specified, will try to use all bands. This is a wrapper around <xref linkend="RT_ST_AsGDALRaster"/>. Use <xref linkend="RT_ST_AsGDALRaster"/> if you need to export as less common raster types. There are many variants of the function with many options. If no spatial reference SRS text is present, the spatial reference of the raster is used. These are itemized below:
ja: ラスタの選択されたバンドを、単一のTagged Image File Format (TIFF)画像として返します。バンドを指定しない場合には、全てのバンドの使用を試みます。この関数は<xref linkend="RT_ST_AsGDALRaster"/>のラッパです。より一般でないラスタタイプで出力する必要がある場合には、<xref linkend="RT_ST_AsGDALRaster"/>を使います。この関数には多数の任意引数が付くさまざまな形式があります。空間参照系 (SRS)の文字列表現が指定されていない場合には、ラスタの空間参照系を使います。引数については次の通りです。

note: Tag: para
en: <varname>nbands</varname> is an array of bands to export (note that max is 3 for PNG) and the order of the bands is RGB. e.g ARRAY[3,2,1] means map band 3 to Red, band 2 to green and band 1 to blue
ja: <varname>nbands</varname> 出力バンドの配列 (PNGでは3要素が最大です)で、バンドの並び順はRGBです。たとえばARRAY[3,2,1]は、3番バンドを赤、2番バンドを緑、1番バンドを青にそれぞれ対応させます。

note: Tag: para
en: <varname>compression</varname> Compression expression -- JPEG90 (or some other percent), LZW, JPEG, DEFLATE9.
ja: <varname>compression</varname> 圧縮式 -- JPEG90 (または他のパーセント値), LZW, JPEG, DEFLATE9のいずれかです。

note: Tag: para
en: <varname>options</varname> text Array of GDAL create options as defined for GTiff (look at create_options for GTiff of <xref linkend="RT_ST_GDALDrivers"/>). or refer to <link xlink:href="http://www.gdal.org/frmt_various.html">GDAL Raster format options</link> for more details.
ja: <varname>options</varname> GTiffを定義するGDALオプションの文字列配列です (<xref linkend="RT_ST_GDALDrivers"/>のGTiff用のcreate_optionsを見てください)。詳細については<link xlink:href="http://www.gdal.org/frmt_various.html">GDAL Raster format options</link>をご覧下さい。

note: Tag: para
en: <varname>srid</varname> srid of spatial_ref_sys of the raster. This is used to populate the georeference information
ja: <varname>srid</varname> ラスタのspatial_ref_sysのSRIDです。地理参照情報を登録するために使われます。

note: Tag: title
en: Examples: Use jpeg compression 90%
ja: 例: JPEG90%品質圧縮の使用

note: Tag: title
en: Raster Processing: Map Algebra
ja: ラスタ処理: 地図代数

note: Tag: refpurpose
en: Returns the raster clipped by the input geometry. If band number is not specified, all bands are processed. If <varname>crop</varname> is not specified or TRUE, the output raster is cropped. If <varname>touched</varname> is set to TRUE, then touched pixels are included, otherwise only if the center of the pixel is in the geometry it is included.
ja: 入力ジオメトリで切り取ったラスタを返します。バンドが指定されていない場合には、全てのバンドが処理されます。<varname>crop</varname>が指定されていなかったりTRUE となっている場合には、出力ラスタは切り取られます。<varname>touched</varname>がTRUEの場合には、接触するピクセルは取り込まれ、TRUEでない場合には、中心がジオメトリ内にあるピクセルだけが取り込まれます。

note: Tag: para
en: Returns a raster that is clipped by the input geometry <varname>geom</varname>. If band index is not specified, all bands are processed.
ja: 入力ジオメトリ<varname>geom</varname>で切り取ったラスタを返します。バンドが指定されていない場合には、全てのバンドが処理されます。

note: Tag: para
en: Rasters resulting from ST_Clip must have a nodata value assigned for areas clipped, one for each band. If none are provided and the input raster do not have a nodata value defined, nodata values of the resulting raster are set to ST_MinPossibleValue(ST_BandPixelType(rast, band)). When the number of nodata value in the array is smaller than the number of band, the last one in the array is used for the remaining bands. If the number of nodata value is greater than the number of band, the extra nodata values are ignored. All variants accepting an array of nodata values also accept a single value which will be assigned to each band.
ja: ST_Clipが返すラスタは、バンド毎に一つずつ必ず切り取った領域に適用するNODATA値を持ちます。NODATA値が渡されず、入力ラスタがNODATA値を持たない場合には、結果ラスタのNODATA値はST_MinPossibleValue(ST_BandPixelType(rast, band))に設定されます。配列におけるNODATA値の要素数がバンド数より小さい場合には、配列の最後の要素が残りのバンドに適用されます。NODATA値の要素数がバンド数より多い場合には、超過分は無視されます。全てのNODATA値配列を受け付ける形式では、バンド毎に適用される単一値も受け付けます。

note: Tag: para
en: If <varname>crop</varname> is not specified, true is assumed meaning the output raster is cropped to the intersection of the <varname>geom</varname>and <varname>rast</varname> extents. If <varname>crop</varname> is set to false, the new raster gets the same extent as <varname>rast</varname>. If <varname>touched</varname> is set to true, then all pixels in the <varname>rast</varname> that intersect the geometry are selected.
ja: <varname>crop</varname> が指定されていない場合には、TRUE として扱われ、出力ラスタは <varname>geom</varname> と <varname>rast</varname> の範囲の共有領域で切り取ります。<varname>crop</varname> が FALSE に指定されている場合には、新しいラスタは <varname>rast</varname> と同じ範囲になります。<varname>touched</varname> が TRUE に指定されている場合には、ジオメトリとインタセクトする <varname>rast</varname> 内の全てのピクセルが選択されます。

note: Tag: para
en: The default behavior is touched=false, which will only select pixels where the center of the pixel is covered by the geometry.
ja: デフォルトの振る舞いは touched=false で、中心がジオメトリに含まれているピクセルを選択するだけです。

note: Tag: para
en: Enhanced: 3.5.0 - touched argument added.
ja: Enhanced: 3.5.0 - 引数 touched を追加。

note: Tag: para
en: Enhanced: 2.1.0 Rewritten in C
ja: Enhanced: 2.1.0 C言語で記述されました

note: Tag: para
en: Examples here use Massachusetts aerial data available on MassGIS site <link xlink:href="https://www.mass.gov/info-details/massgis-data-20082009-aerial-imagery">MassGIS Aerial Orthos</link>.
ja: ここの例では、MassGIS サイト上の <link xlink:href="https://www.mass.gov/info-details/massgis-data-20082009-aerial-imagery">MassGIS Aerial Orthos</link> にあるマサチューセッツ空中写真データを使っています。

note: Tag: title
en: Examples: Comparing selecting all touched vs. not all touched
ja: 例: 全ての touched と touchedでない との選択の比較

note: Tag: title
en: Examples: 1 band clipping (not touched)
ja: 例: 1バンドの切り取り (touched でない)

note: Tag: para
en: Full raster tile before clipping
ja: 切り取り前の完全なラスタタイル

note: Tag: para
en: After Clipping
ja: 切り取り後

note: Tag: title
en: Examples: 1 band clipping with no crop and add back other bands unchanged
ja: 例: クロップがなく他のバンドは切り取らず1バンドを切り取る

note: Tag: para
en: After Clipping - surreal
ja: 切り取り後 - シュールですね

note: Tag: title
en: Examples: Clip all bands
ja: 例: 全バンドの切り取り

note: Tag: refpurpose
en: Creates a new raster of up to four 8BUI bands (grayscale, RGB, RGBA) from the source raster and a specified band. Band 1 is assumed if not specified.
ja: 元のラスタと指定したバンドから4個までの8BUIバンド (grayscale, RGB, RGBA)からなる新しいラスタを生成します。

note: Tag: para
en: Apply a <varname>colormap</varname> to the band at <varname>nband</varname> of <varname>rast</varname> resulting a new raster comprised of up to four 8BUI bands. The number of 8BUI bands in the new raster is determined by the number of color components defined in <varname>colormap</varname>.
ja: <varname>rast</varname>の<varname>nband</varname>で示されるバンドに<varname>colormap</varname>を適用し、4個までの8BUIバンドからなる新しいラスタを返します。新しいラスタの8BUIバンドの数は<varname>colormap</varname>で定義された色要素の数で決まります。

note: Tag: para
en: If <varname>nband</varname> is not specified, then band 1 is assumed.
ja: <varname>nband</varname>が指定されていない場合には、1番と仮定します。

note: Tag: para
en: <varname>colormap</varname> can be a keyword of a pre-defined colormap or a set of lines defining the value and the color components.
ja: <varname>colormap</varname>は事前定義された色マップまたは値を定義する行の集合と色要素のキーワードです。

note: Tag: para
en: Valid pre-defined <varname>colormap</varname> keyword:
ja: 妥当な事前定義された<varname>colormap</varname>キーワードは次の通りです。

note: Tag: para
en: <varname>grayscale</varname> or <varname>greyscale</varname> for a one 8BUI band raster of shades of gray.
ja: <varname>grayscale</varname>または<varname>greyscale</varname> 1個の8BUIバンドからなるラスタで、グレーの陰影です。

note: Tag: para
en: <varname>pseudocolor</varname> for a four 8BUI (RGBA) band raster with colors going from blue to green to red.
ja: <varname>pseudocolor</varname> 4個の8BUIバンド (RGBA)からなるラスタで、青から緑、赤に移るものです。

note: Tag: para
en: <varname>fire</varname> for a four 8BUI (RGBA) band raster with colors going from black to red to pale yellow.
ja: <varname>fire</varname> 4個の8BUIバンド (RGBA)からなるラスタで、黒から赤、淡黄色に移るものです。

note: Tag: para
en: <varname>bluered</varname> for a four 8BUI (RGBA) band raster with colors going from blue to pale white to red.
ja: <varname>bluered</varname> 4個の8BUIバンド (RGBA)からなるラスタで、青からペールホワイト、赤に移るものです。

note: Tag: para
en: Users can pass a set of entries (one per line) to <varname>colormap</varname> to specify custom colormaps. Each entry generally consists of five values: the pixel value and corresponding Red, Green, Blue, Alpha components (color components between 0 and 255). Percent values can be used instead of pixel values where 0% and 100% are the minimum and maximum values found in the raster band. Values can be separated with commas (','), tabs, colons (':') and/or spaces. The pixel value can be set to <emphasis>nv</emphasis>, <emphasis>null</emphasis> or <emphasis>nodata</emphasis> for the NODATA value. An example is provided below.
ja: カスタムカラーマップを指定するためにエントリ (1行1エントリ)の集合を<varname>colormap</varname>に渡すことができます。それぞれのエントリは一般的に、ピクセル値、ピクセル値と対応する赤、緑、青、アルファ要素(0から255の間の色要素)からなる5個の値を持ちます。ピクセル値の替わりに百分率値を使うことができ、0%がラスタバンドでの最小値、100%が最大値になります。値はコンマ('.')、タブ、コロン(':')、空白で区切られます。NODATA値に対しては、ピクセル値を<emphasis>nv</emphasis>, <emphasis>null</emphasis>, <emphasis>nodata</emphasis>のいずれかに設定できます。例を次に示します。

note: Tag: para
en: The syntax of <varname>colormap</varname> is similar to that of the color-relief mode of GDAL <link xlink:href="http://www.gdal.org/gdaldem.html#gdaldem_color_relief">gdaldem</link>.
ja: <varname>colormap</varname>の構文は、GDALツールの<link xlink:href="http://www.gdal.org/gdaldem.html#gdaldem_color_relief">gdaldem</link>の起伏モードに似ています。

note: Tag: para
en: Valid keywords for <varname>method</varname>:
ja: <varname>method</varname>の妥当なキーワードは次の通りです。

note: Tag: para
en: <varname>INTERPOLATE</varname> to use linear interpolation to smoothly blend the colors between the given pixel values
ja: <varname>INTERPOLATE</varname> 与えられたピクセル値の間での滑らかな色合成のための線形補間に使います。

note: Tag: para
en: <varname>EXACT</varname> to strictly match only those pixels values found in the colormap. Pixels whose value does not match a colormap entry will be set to 0 0 0 0 (RGBA)
ja: <varname>EXACT</varname> カラーマップで見つかったピクセル値だけを厳格に一致させます。カラーマップエントリに一致しないピクセルに対しては0 0 0 0 (RGBA)が設定されます。

note: Tag: para
en: <varname>NEAREST</varname> to use the colormap entry whose value is closest to the pixel value
ja: <varname>NEAREST</varname> ピクセル値に最も近い値にあうカラーマップエントリを使います。

note: Tag: para
en: A great reference for colormaps is <link xlink:href="http://www.colorbrewer2.org">ColorBrewer</link>.
ja: カラーマップの偉大な参考情報は<link xlink:href="http://www.colorbrewer2.org">ColorBrewer</link>にあります。

note: Tag: para
en: The resulting bands of new raster will have no NODATA value set. Use <xref linkend="RT_ST_SetBandNoDataValue"/> to set a NODATA value if one is needed.
ja: 新しいラスタの結果バンドにはNODATA値が入りません。NODATA値が必要な場合には、 <xref linkend="RT_ST_SetBandNoDataValue"/>を使ってNODATA値をセットします。

note: Tag: para
en: This is a junk table to play with
ja: これは試行のためのがらくたテーブルです。

note: Tag: title
en: Examples: Compare different color map looks using ST_AsPNG
ja: 例: ST_AsPNGを使用して異なるカラーマップを比較する

note: Tag: refpurpose
en: Creates a new one-8BUI band raster from the source raster and specified bands representing Red, Green and Blue
ja: 元のラスタと指定したバンドを赤、緑、青バンドとして一つの8BUIバンドを持つラスタを生成します。

note: Tag: para
en: Create a raster with one 8BUI band given three input bands (from one or more rasters). Any input band whose pixel type is not 8BUI will be reclassified using <xref linkend="RT_ST_Reclass"/>.
ja: 三つの入力バンド (一つ以上のラスタ)を与えられ、一つの8BUIバンドを持つラスタを生成します。タイプが8BUIでない入力バンドは全て<xref linkend="RT_ST_Reclass"/>で再分類されます。

note: Tag: para
en: This function is not like <xref linkend="RT_ST_ColorMap"/> with the <varname>grayscale</varname> keyword as ST_ColorMap operates on only one band while this function expects three bands for RGB. This function applies the following equation for converting RGB to Grayscale: 0.2989 * RED + 0.5870 * GREEN + 0.1140 * BLUE
ja: この関数は<xref linkend="RT_ST_ColorMap"/>に<varname>grayscale</varname>キーワードを与えた場合とは違います。ST_ColorMapでは一つのバンドを扱いますが、この関数ではRGBの3バンドを期待します。この関数は 0.2989 * 赤 + 0.5870 * 緑 + 0.1140 * 青 という式を適用してRGBをグレースケールにしています。

note: Tag: refpurpose
en: <refpurpose>Returns a raster or a set of geometry-pixelvalue pairs representing the shared portion of two rasters or the geometrical intersection of a vectorization of the raster and a geometry.</refpurpose>
ja: <refpurpose>二つのラスタの共有部分またはベクタ化したラスタとジオメトリとのインタセクトした部分を表現する、ラスタまたはジオメトリとピクセル値の組の集合を返します。</refpurpose>

note: Tag: para
en: <para>Returns a raster or a set of geometry-pixelvalue pairs representing the shared portion of two rasters or the geometrical intersection of a vectorization of the raster and a geometry.</para>
ja: <para>二つのラスタの共有部分またはベクタ化したラスタとジオメトリとのインタセクトした部分を表現する、ラスタまたはジオメトリとピクセル値の組の集合を返します。</para>

note: Tag: para
en: The first three variants, returning a setof geomval, works in vector space. The raster is first vectorized (using <xref linkend="RT_ST_DumpAsPolygons"/>) into a set of geomval rows and those rows are then intersected with the geometry using the <xref linkend="ST_Intersection"/> (geometry, geometry) PostGIS function. Geometries intersecting only with a nodata value area of a raster returns an empty geometry. They are normally excluded from the results by the proper usage of <xref linkend="RT_ST_Intersects"/> in the WHERE clause.
ja: 前半の三つの形式は、geomvalの集合を返すもので、ベクタ空間で動作します。ラスタは初めにgeomval行の集合にベクトル化されます (<xref linkend="RT_ST_DumpAsPolygons"/>を使用)。これらの行はPostGIS関数の<xref linkend="ST_Intersection"/>(geometry, geometry)を使ってジオメトリとインタセクトさせます。NODATA値の領域とだけインタセクトするジオメトリについては空ジオメトリを返します。通常はWHERE節で<xref linkend="RT_ST_Intersects"/>を使って結果から確実に排除します。

note: Tag: para
en: You can access the geometry and the value parts of the resulting set of geomval by surrounding them with parenthesis and adding '.geom' or '.val' at the end of the expression. e.g. (ST_Intersection(rast, geom)).geom
ja: 丸括弧でくくって式の末尾に'.geom'や'.val'をつけることにより、geomvalの結果集合のジオメトリや値の部分にアクセスすることができます。たとえば(ST_Intersection(rast, geom)).geom等とします。

note: Tag: para
en: The other variants, returning a raster, works in raster space. They are using the two rasters version of ST_MapAlgebraExpr to perform the intersection.
ja: 他の形式は、ラスタを引数に取り、ラスタを返します。ST_MapAlgebraExprの二つのラスタを取る形式を使って、インタセクトしている部分を取得します。

note: Tag: para
en: The extent of the resulting raster corresponds to the geometrical intersection of the two raster extents. The resulting raster includes 'BAND1', 'BAND2' or 'BOTH' bands, following what is passed as the <varname>returnband</varname> parameter. Nodata value areas present in any band results in nodata value areas in every bands of the result. In other words, any pixel intersecting with a nodata value pixel becomes a nodata value pixel in the result.
ja: 結果ラスタの範囲は、二つのラスタの範囲についてインタセクトしている部分です。結果ラスタは、<varname>returnband</varname>引数として渡されたものにあわせられた'BAND1','BAND2','BOTH'バンドを含みます。どのバンドでもNODATA値の領域は、結果ラスタの全てのバンドのNODATA値領域に現れます。言い換えると、あらゆるNODATA値ピクセルとインタセクトしているピクセルは、結果ラスタではNODATA値ピクセルになります。

note: Tag: para
en: Rasters resulting from ST_Intersection must have a nodata value assigned for areas not intersecting. You can define or replace the nodata value for any resulting band by providing a <varname>nodataval[]</varname> array of one or two nodata values depending if you request 'BAND1', 'BAND2' or 'BOTH' bands. The first value in the array replace the nodata value in the first band and the second value replace the nodata value in the second band. If one input band do not have a nodata value defined and none are provided as an array, one is chosen using the ST_MinPossibleValue function. All variant accepting an array of nodata value can also accept a single value which will be assigned to each requested band.
ja: インタセクトしなかった領域にNODATA値を入れるために、ST_Intersectionからの結果ラスタは、NODATA値を持たなければなりません。結果ラスタのどのバンドにも、一つか二つのNODATA値を持つ<varname>nodataval[]</varname>配列を与えることでNODATA値を定義したり置き換えたりできます。この配列は、引数で与えた'BAND1','BAND2','BOTH'バンドに依存します。 配列の一つ目の値は、一つ目のバンドのNODATA値を入れ替えるものです。二つ目の値は二つ目のバンドのNODATA値を入れ替えるものです。入力バンドの一つがNODATA値を持っておらず、かつ配列を渡さなかった場合には、ST_MinPossibleValue関数を使ってNODATA値が選ばれます。NODATA値の配列を受け付ける形式の全てが、単一値を受け付けます。単一値は結果ラスタのそれぞれのバンドに適用されます。

note: Tag: para
en: In all variants, if no band number is specified band 1 is assumed. If you need an intersection between a raster and geometry that returns a raster, refer to <xref linkend="RT_ST_Clip"/>.
ja: 全ての形式で、バンド番号を指定していない場合には、1番と仮定します。ラスタとジオメトリを引数にとり、ラスタを得たい場合には、<xref linkend="RT_ST_Clip"/>を参照して下さい。

note: Tag: para
en: To get more control on the resulting extent or on what to return when encountering a nodata value, use the two rasters version of <xref linkend="RT_ST_MapAlgebraExpr2"/>.
ja: NODATA値に遭遇した時の、結果範囲や返された物に関して、より多くの制御を行いたい場合には、<xref linkend="RT_ST_MapAlgebraExpr2"/>の二つのラスタを取る形式を使います。

note: Tag: para
en: To compute the intersection of a raster band with a geometry in raster space, use <xref linkend="RT_ST_Clip"/>. ST_Clip works on multiple bands rasters and does not return a band corresponding to the rasterized geometry.
ja: ラスタバンドとジオメトリとがインタセクトする部分を計算するには、<xref linkend="RT_ST_Clip"/>を使います。ST_Clipは複数のバンドで動作し、ラスタ化されたジオメトリに従ったバンドを返すことはしません。

note: Tag: para
en: ST_Intersection should be used in conjunction with <xref linkend="RT_ST_Intersects"/> and an index on the raster column and/or the geometry column.
ja: ST_Intersectionは、<xref linkend="RT_ST_Intersects"/>と組み合わせて、ラスタカラムとジオメトリカラムのインデックスを使うべきです。

note: Tag: para
en: Enhanced: 2.0.0 - Intersection in the raster space was introduced. In earlier pre-2.0.0 versions, only intersection performed in vector space were supported.
ja: Enhanced: 2.0.0 - ラスタ空間のインタセクションが導入されました。2.0.0より前の版では、ベクタ空間でのインタセクションの計算のみに対応していました。

note: Tag: title
en: Examples: Geometry, Raster -- resulting in geometry vals
ja: 例: ジオメトリとラスタ -- ジオメトリと値を得る

note: Tag: refpurpose
en: Callback function version - Returns a one-band raster given one or more input rasters, band indexes and one user-specified callback function.
ja: コールバック関数版 - 一つ以上の入力ラスタ、バンドインデックスと一つのユーザ定義コールバック関数から、一つのバンドからなるラスタを返します。

note: Tag: para
en: Returns a one-band raster given one or more input rasters, band indexes and one user-specified callback function.
ja: 一つ以上の入力ラスタ、バンドインデックスと一つのユーザ定義コールバック関数から、一つのバンドからなるラスタを返します。

note: Tag: para
en: Rasters on which the map algebra process is evaluated.
ja: 地図代数処理が行われるラスタです。

note: Tag: para
en: <varname>rastbandargset</varname> allows the use of a map algebra operation on many rasters and/or many bands. See example Variant 1.
ja: <varname>rastbandargset</varname>によって、多数のラスタと多数のバンドにおいて地図代数処理が使用できます。一つ目の形式の例を見て下さい。

note: Tag: para
en: Band numbers of the raster to be evaluated. nband can be an integer or integer[] denoting the bands. nband1 is band on rast1 and nband2 is band on rast2 for the 2 raster/2band case.
ja: 処理を行うラスタのバンド番号です。nbandはバンドを示す整数スカラまたは整数配列です。2ラスタ/2バンドの場合では、nband1はrast1のバンド、nband2はrast2のバンドです。

note: Tag: para
en: The <varname>callbackfunc</varname> parameter must be the name and signature of an SQL or PL/pgSQL function, cast to a regprocedure. An example PL/pgSQL function example is:
ja: <varname>callbackfunc</varname>引数は、SQLまたはPL/pgSQL関数の名前とシグニチャでなければならず、regprocedureにキャストしなければなりません。PL/pgSQL関数の例は次の通りです:

note: Tag: para
en: The <varname>callbackfunc</varname> must have three arguments: a 3-dimension double precision array, a 2-dimension integer array and a variadic 1-dimension text array. The first argument <varname>value</varname> is the set of values (as double precision) from all input rasters. The three dimensions (where indexes are 1-based) are: raster #, row y, column x. The second argument <varname>position</varname> is the set of pixel positions from the output raster and input rasters. The outer dimension (where indexes are 0-based) is the raster #. The position at outer dimension index 0 is the output raster's pixel position. For each outer dimension, there are two elements in the inner dimension for X and Y. The third argument <varname>userargs</varname> is for passing through any user-specified arguments.
ja: <varname>callbackfunc</varname>は、三つの引数を持たなければなりません。すなわち、3次元倍精度浮動小数点数配列、2次元整数配列、VARIADICの1次元文字列配列です。第1引数<varname>value</varname>は、全ての入力ラスタからの値 (倍精度浮動小数点数)の配列です。3次元 (1始まり)は、ラスタ番号、行、列です。第2引数<varname>position</varname>は、出力ラスタと入力ラスタからのピクセル位置の集合です。一つ目の次元の添え字 (0はじまりです)はラスタ番号です。一つ目の次元の添え字が0の場合に指される位置は、出力ラスタのピクセル位置です。二つ目の次元はXとYからなる二つの要素を持ちます。三つ目の引数<varname>userargs</varname>はユーザ定義関数特有の引数としてそのまま渡されます。

note: Tag: para
en: Passing a <type>regprocedure</type> argument to a SQL function requires the full function signature to be passed, then cast to a <type>regprocedure</type> type. To pass the above example PL/pgSQL function as an argument, the SQL for the argument is:
ja: <type>regprocedure</type>引数をSQL関数に渡す場合には、渡し先の完全な関数シグネチャが必要で、さらに<type>regprocedure</type>にキャストします。上の例のPL/pgSQL関数を引数として渡すには、引数のSQLは次のようになります:

note: Tag: para
en: Note that the argument contains the name of the function, the types of the function arguments, quotes around the name and argument types, and a cast to a <type>regprocedure</type>.
ja: 引数には関数名が含まれ、関数引数の型、関数名と引数型を引用符で括ったもの、<type>regprocedure</type>へのキャストが存在することに注意して下さい。

note: Tag: para
en: An n-dimensional array (matrix) of numbers used to filter what cells get passed to map algebra call-back function. 0 means a neighbor cell value should be treated as no-data and 1 means value should be treated as data. If weight is set to true, then the values, are used as multipliers to multiple the pixel value of that value in the neighborhood position.
ja: N次元の数値配列 (行列)で、地図代数コールバック関数に渡すセルを決めるためのフィルタに使われます。0は近隣セル値をNODATAとして扱うべきであることを示し、1はデータとして扱うべきであることをそれぞれ意味します。weightがTRUEに指定されいる場合には、この配列の値は、近隣セルのピクセル値に対して掛け算を行うための数になります。

note: Tag: para
en: boolean (true/false) to denote if a mask value should be weighted (multiplied by original value) or not (only applies to proto that takes a mask).
ja: マスク値に重みづけを施す (元の値に対して乗算を行う)か、施さない (マスク処理だけを行う)かを示す真偽値です。

note: Tag: para
en: If <varname>pixeltype</varname> is passed in, the one band of the new raster will be of that pixeltype. If pixeltype is passed NULL or left out, the new raster band will have the same pixeltype as the specified band of the first raster (for extent types: INTERSECTION, UNION, FIRST, CUSTOM) or the specified band of the appropriate raster (for extent types: SECOND, LAST). If in doubt, always specify <varname>pixeltype</varname>.
ja: <varname>pixeltype</varname>を渡した場合には、新しいラスタの一つのバンドが、そのピクセルタイプになります。pixeltypeにNULLを渡したり指定しなかった場合には、新しいラスタのピクセルタイプは、一つ目のラスタ (extenttypeがINTERSECTION, UNION, FIRST, CUSTOMの場合)か、適切なラスタ (extenttypeがSECOND, LASTの場合)の指定したバンドと同じピクセルタイプになります。疑問を感じたら常に<varname>pixeltype</varname>を渡します。

note: Tag: para
en: The resulting pixel type of the output raster must be one listed in <xref linkend="RT_ST_BandPixelType"/> or left out or set to NULL.
ja: 出力ラスタのピクセルタイプは、必ず<xref linkend="RT_ST_BandPixelType"/>に挙げられたものの一つになるか、省略されるか、NULLに設定されます。

note: Tag: para
en: Possible values are INTERSECTION (default), UNION, FIRST (default for one raster variants), SECOND, LAST, CUSTOM.
ja: INTERSECTION (デフォルト), UNION, FIRST (一つのラスタを取る形式でのデフォルト), SECOND, LAST, CUSTOMのいずれかになります。

note: Tag: para
en: If <varname>extentype</varname> is CUSTOM, a raster must be provided for <varname>customextent</varname>. See example 4 of Variant 1.
ja: <varname>extentype</varname>がCUSTOMである場合には、ラスタは<varname>customextent</varname>で提供されます。一つ目の形式の例4をご覧下さい。

note: Tag: para
en: The distance in pixels from the reference cell in x direction. So width of resulting matrix would be <code>2*distancex + 1</code>.If not specified only the reference cell is considered (neighborhood of 0).
ja: 参照セルからのピクセル単位の距離です。結果として得られる行列の幅は<code>2*distancex + 1</code>となります。指定しない場合には、参照セルだけが対象となります (0の距離の近隣ピクセル)。

note: Tag: para
en: The distance in pixels from reference cell in y direction. Height of resulting matrix would be <code>2*distancey + 1</code> .If not specified only the reference cell is considered (neighborhood of 0).
ja: 参照セルからのピクセル単位の距離です。結果として得られる行列の高さは<code>2*distancey + 1</code>となります。指定しない場合には、参照セルが対象となります (0の距離の近隣ピクセル)。

note: Tag: para
en: The third argument to the <varname>callbackfunc</varname> is a <type>variadic text</type> array. All trailing text arguments are passed through to the specified <varname>callbackfunc</varname>, and are contained in the <varname>userargs</varname> argument.
ja: <varname>callbackfunc</varname>の三つ目の引数は<type>variadic text</type>配列です。全ての文字列引数は指定された<varname>callbackfunc</varname>にそのまま渡され、<varname>userargs</varname>引数に含まれます。

note: Tag: para
en: For more information about the VARIADIC keyword, please refer to the PostgreSQL documentation and the "SQL Functions with Variable Numbers of Arguments" section of <link xlink:href="http://www.postgresql.org/docs/current/static/xfunc-sql.html">Query Language (SQL) Functions</link>.
ja: VARIADICキーワードに関する詳細情報については、PostgreSQL文書と<link xlink:href="http://www.postgresql.org/docs/current/static/xfunc-sql.html">Query Language (SQL) Functions</link> (訳注: 日本語版は「<link xlink:href="http://www.postgresql.jp/document/current/html/xfunc-sql.html">問い合わせ言語 （SQL）関数</link>」です)の"SQL Functions with Variable Numbers of Arguments" (訳注: 日本語版は「可変長引数を取るSQL関数」)節を参照して下さい。

note: Tag: para
en: The <type>text[]</type> argument to the <varname>callbackfunc</varname> is required, regardless of whether you choose to pass any arguments to the callback function for processing or not.
ja: <varname>callbackfunc</varname>への<type>text[]</type>引数は、あらゆる引数を処理のためにユーザ関数に渡すかどうかの選択にかかわらず求められます。

note: Tag: para
en: Variant 1 accepts an array of <varname>rastbandarg</varname> allowing the use of a map algebra operation on many rasters and/or many bands. See example Variant 1.
ja: 一つ目の形式では、多数のラスタやバンドで地図代数演算が使えるようになるための<varname>rastbandarg</varname>配列を受け付けます。一つ目の形式の例をご覧下さい。

note: Tag: para
en: Variants 2 and 3 operate upon one or more bands of one raster. See example Variant 2 and 3.
ja: 二つ目と三つ目の形式では、一つのラスタにおける一つ以上のバンドについて演算を行います。二つ目の形式と三つ目の形式の例をご覧下さい。

note: Tag: para
en: Variant 4 operate upon two rasters with one band per raster. See example Variant 4.
ja: 四つ目の形式では、二つのラスタにおいて、それぞれ一つずつのバンドについて演算を行います。四つ目の形式の例をご覧下さい。

note: Tag: para
en: Availability: 2.2.0: Ability to add a mask
ja: Availability: 2.2.0: マスクが追加されました。

note: Tag: para
en: One raster, one band
ja: 一つのラスタ、一つのバンド

note: Tag: para
en: One raster, several bands
ja: 一つのラスタ、複数のバンド

note: Tag: para
en: Several rasters, several bands
ja: 複数のラスタ、複数のバンド

note: Tag: para
en: Complete example of tiles of a coverage with neighborhood. This query only works with PostgreSQL 9.1 or higher.
ja: 近隣ピクセルを併用したカバレッジのタイルの完全な例です。クエリはPostgreSQL 9.1以上でのみ動作します。

note: Tag: para
en: Example like the prior one for tiles of a coverage with neighborhood but works with PostgreSQL 9.0.
ja: 前の例である近隣ピクセルを併用したカバレッジのタイルに似ていますがPostgreSQL 9.0で動作します。

note: Tag: title
en: Examples: Variants 2 and 3
ja: 例: 二つ目の形式と三つ目の形式

note: Tag: title
en: Examples: Variant 4
ja: 例: 四つ目の形式

note: Tag: para
en: Two rasters, two bands
ja: 二つのラスタ、二つのバンド

note: Tag: title
en: Examples: Using Masks
ja: 例: マスクの使用

note: Tag: para
en: no mask mean value (same as having all 1s in mask matrix)
ja: no mask mean value (マスクなし平均値) (マスク配列に全て1があるのと同じ)

note: Tag: para
en: mask only consider neighbors, exclude center
ja: mask only consider neighbors, exclude center (近隣セルのみ注目し、中心セルを除くマスク)

note: Tag: para
en: mask weighted only consider neighbors, exclude center multi other pixel values by 2
ja: mask weighted only consider neighbors, exclude center multi other pixel values by 2 (近隣のみ考慮に入れて中心を除き、2を掛けるウェイトマスク)

note: Tag: refpurpose
en: <refpurpose>Expression version - Returns a one-band raster given one or two input rasters, band indexes and one or more user-specified SQL expressions.</refpurpose>
ja: <refpurpose>数式版 - 一つか二つの入力ラスタ、バンド番号、一つ以上のユーザ定義SQL式から一つのバンドを持つラスタを返します。</refpurpose>

note: Tag: para
en: <para>Expression version - Returns a one-band raster given one or two input rasters, band indexes and one or more user-specified SQL expressions.</para>
ja: <para>数式版 - 一つか二つの入力ラスタ、バンド番号、一つ以上のユーザ定義SQL式から一つのバンドを持つラスタを返します。</para>

note: Tag: title
en: Description: Variants 1 and 2 (one raster)
ja: 説明: 一つ目の形式と二つ目の形式 (一つのラスタ)

note: Tag: para
en: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation defined by the <varname>expression</varname> on the input raster (<varname>rast</varname>). If <varname>nband</varname> is not provided, band 1 is assumed. The new raster will have the same georeference, width, and height as the original raster but will only have one band.
ja: <varname>expression</varname>で定義された妥当なPostgreSQL代数演算を入力ラスタ (<varname>rast</varname>)に適用して、一つのバンドを持つラスタを生成します。<varname>nband</varname>が指定されない場合には、1番バンドと仮定します。新しいラスタは、元のラスタと同じ地理参照、幅、高さになりますが、バンドは一つだけとなります。

note: Tag: para
en: If <varname>pixeltype</varname> is passed in, then the new raster will have a band of that pixeltype. If pixeltype is passed NULL, then the new raster band will have the same pixeltype as the input <varname>rast</varname> band.
ja: <varname>pixeltype</varname>が渡された場合には、新しいラスタのバンドは、そのピクセルタイプになります。pixeltypeにNULLが渡された場合には、新しいラスタは入力<varname>rast</varname>のバンドのピクセルタイプと同じになります。

note: Tag: para
en: Keywords permitted for <varname>expression</varname>
ja: <varname>expression</varname>のキーワードは次の通りです。

note: Tag: para
en: <varname>[rast]</varname> - Pixel value of the pixel of interest
ja: <varname>[rast]</varname> - 演算対象ピクセルの値

note: Tag: para
en: <varname>[rast.val]</varname> - Pixel value of the pixel of interest
ja: <varname>[rast.val]</varname> - 演算対象ピクセルの値

note: Tag: para
en: <varname>[rast.x]</varname> - 1-based pixel column of the pixel of interest
ja: <varname>[rast.x]</varname> - 演算対象ピクセルの列 (1始まり)

note: Tag: para
en: <varname>[rast.y]</varname> - 1-based pixel row of the pixel of interest
ja: <varname>[rast.y]</varname> - 演算対象ピクセルの行 (1始まり)

note: Tag: title
en: Description: Variants 3 and 4 (two raster)
ja: 説明: 三つ目と四つ目の形式 (二つのラスタ)

note: Tag: para
en: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation to the two bands defined by the <varname>expression</varname> on the two input raster bands <varname>rast1</varname>, (<varname>rast2</varname>). If no <varname>band1</varname>, <varname>band2</varname> is specified band 1 is assumed. The resulting raster will be aligned (scale, skew and pixel corners) on the grid defined by the first raster. The resulting raster will have the extent defined by the <varname>extenttype</varname> parameter.
ja: <varname>expression</varname>で定義された妥当な二つのバンドへのPostgreSQL代数演算を入力ラスタ <varname>rast1</varname>, (<varname>rast2</varname>)に適用して、一つのバンドを持つラスタを生成します。<varname>band1</varname>, <varname>band2</varname>が指定されない場合には、1番バンドと仮定します。新しいラスタは、一つ目のラスタと同じアラインメント (スケール、スキュー、ピクセル隅)を持ちます。新しいラスタは、<varname>extenttype</varname>引数で定義される範囲になります。

note: Tag: para
en: A PostgreSQL algebraic expression involving the two rasters and PostgreSQL defined functions/operators that will define the pixel value when pixels intersect. e.g. (([rast1] + [rast2])/2.0)::integer
ja: 二つのラスタとPostgreSQL定義済み関数/演算子を含むPostgreSQL代数式です。関数と演算子は、二つのピクセルがインタセクトするピクセルの値を定めます。たとえば(([rast1] + [rast2])/2.0)::integerといったふうになります。

note: Tag: para
en: The resulting pixel type of the output raster. Must be one listed in <xref linkend="RT_ST_BandPixelType"/>, left out or set to NULL. If not passed in or set to NULL, will default to the pixeltype of the first raster.
ja: 出力ラスタのピクセルタイプです。必ず<xref linkend="RT_ST_BandPixelType"/>に挙げられたものの一つになるか、省略されるか、NULLに設定されます。引数として渡されないかNULLが渡された場合には、一つ目のラスタのピクセルタイプになります。

note: Tag: para
en: Controls the extent of resulting raster
ja: 新しいラスタの範囲を制御します。

note: Tag: para
en: <varname>INTERSECTION</varname> - The extent of the new raster is the intersection of the two rasters. This is the default.
ja: <varname>INTERSECTION</varname> - 新しいラスタの範囲は二つのラスタのインタセクトした領域です。これがデフォルトです。

note: Tag: para
en: <varname>UNION</varname> - The extent of the new raster is the union of the two rasters.
ja: <varname>UNION</varname> - 新しいラスタの範囲は二つのラスタの結合です。

note: Tag: para
en: <varname>FIRST</varname> - The extent of the new raster is the same as the one of the first raster.
ja: <varname>FIRST</varname> - 新しいラスタの範囲は一つ目のラスタと同じです。

note: Tag: para
en: <varname>SECOND</varname> - The extent of the new raster is the same as the one of the second raster.
ja: <varname>SECOND</varname> - 新しいラスタの範囲は二つ目のラスタと同じです。

note: Tag: para
en: An algebraic expression involving only <varname>rast2</varname> or a constant that defines what to return when pixels of <varname>rast1</varname> are nodata values and spatially corresponding rast2 pixels have values.
ja: <varname>rast1</varname>がNODATA値で、特にrast2ピクセルに値がある時に、<varname>rast2</varname>だけを返すか返すべき値を定義する定数を含む代数式です。

note: Tag: para
en: An algebraic expression involving only <varname>rast1</varname> or a constant that defines what to return when pixels of <varname>rast2</varname> are nodata values and spatially corresponding rast1 pixels have values.
ja: <varname>rast2</varname>がNODATA値で、特にrast2ピクセルに値がある時に、<varname>rast1</varname>だけを返すか返すべき値を定義する定数を含む代数式です。

note: Tag: para
en: A numeric constant to return when spatially corresponding rast1 and rast2 pixels are both nodata values.
ja: rast1とrast2のピクセルの両方がNOADTA値になる場合に返すべき定数です。

note: Tag: para
en: Keywords permitted in <varname>expression</varname>, <varname>nodata1expr</varname> and <varname>nodata2expr</varname>
ja: 有効な<varname>expression</varname>, <varname>nodata1expr</varname>, <varname>nodata2expr</varname>のキーワードは次の通りです。

note: Tag: para
en: <varname>[rast1]</varname> - Pixel value of the pixel of interest from <varname>rast1</varname>
ja: <varname>[rast1]</varname> - <varname>rast1</varname>の演算対象ピクセルの値

note: Tag: para
en: <varname>[rast1.val]</varname> - Pixel value of the pixel of interest from <varname>rast1</varname>
ja: <varname>[rast1.val]</varname> - <varname>rast1</varname>の演算対象ピクセルの値

note: Tag: para
en: <varname>[rast1.x]</varname> - 1-based pixel column of the pixel of interest from <varname>rast1</varname>
ja: <varname>[rast1.x]</varname> - <varname>rast1</varname>の演算対象ピクセルの列 (1始まり)

note: Tag: para
en: <varname>[rast1.y]</varname> - 1-based pixel row of the pixel of interest from <varname>rast1</varname>
ja: <varname>[rast1.y]</varname> - <varname>rast1</varname>の演算対象ピクセルの行 (1始まり)

note: Tag: para
en: <varname>[rast2]</varname> - Pixel value of the pixel of interest from <varname>rast2</varname>
ja: <varname>[rast2]</varname> - <varname>rast2</varname>の演算対象ピクセルの値

note: Tag: para
en: <varname>[rast2.val]</varname> - Pixel value of the pixel of interest from <varname>rast2</varname>
ja: <varname>[rast2.val]</varname> - <varname>rast2</varname>の演算対象ピクセルの値

note: Tag: para
en: <varname>[rast2.x]</varname> - 1-based pixel column of the pixel of interest from <varname>rast2</varname>
ja: <varname>[rast2.x]</varname> - <varname>rast2</varname>の演算対象ピクセルの列 (1始まり)

note: Tag: para
en: <varname>[rast2.y]</varname> - 1-based pixel row of the pixel of interest from <varname>rast2</varname>
ja: <varname>[rast2.y]</varname> - <varname>rast2</varname>の演算対象ピクセルの行 (1始まり)

note: Tag: title
en: Examples: Variants 1 and 2
ja: 例: 一つ目の形式と二つ目の形式

note: Tag: title
en: Examples: Variant 3 and 4
ja: 例: 三つ目の形式と四つ目の形式

note: Tag: refpurpose
en: 1 raster band version: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation on the input raster band and of pixeltype provided. Band 1 is assumed if no band is specified.
ja: 1バンド版: 入力バンドに対する妥当なPostgreSQL代数演算で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、1番を仮定します。

note: Tag: para
en: is deprecated as of 2.1.0. Use <xref linkend="RT_ST_MapAlgebra_expr"/> instead.
ja: は2.1.0で非推奨になりました。代わりに<xref linkend="RT_ST_MapAlgebra_expr"/> を使います。

note: Tag: para
en: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation defined by the <varname>expression</varname> on the input raster (<varname>rast</varname>). If no <varname>band</varname> is specified band 1 is assumed. The new raster will have the same georeference, width, and height as the original raster but will only have one band.
ja: 入力ラスタ (<varname>rast</varname>)に対して<varname>expression</varname>で定義される妥当なPostgreSQL代数演算で形成されるラスタを返します。生成されるラスタは指定したピクセルタイプとなる1バンドラスタです。<varname>band</varname>を指定しない場合には、1番と仮定します。新しいラスタは、元のラスタと同じ地理参照、幅、高さを持ちますが、一つのバンドしか持ちません。

note: Tag: para
en: In the expression you can use the term <varname>[rast]</varname> to refer to the pixel value of the original band, <varname>[rast.x]</varname> to refer to the 1-based pixel column index, <varname>[rast.y]</varname> to refer to the 1-based pixel row index.
ja: 数式の中では、<varname>[rast]</varname>で元のバンドのピクセル値を、<varname>[rast.x]</varname>で1始まりの列番号、<varname>[rast.y]</varname>で1始まりの行番号を、それぞれ参照することができます。

note: Tag: para
en: Create a new 1 band raster from our original that is a function of modulo 2 of the original raster band.
ja: 元のラスタから1バンドラスタを生成します。元のラスタバンドの値について2で割った余りが入ります。

note: Tag: para
en: Create a new 1 band raster of pixel-type 2BUI from our original that is reclassified and set the nodata value to be 0.
ja: ピクセルタイプが2BUIの1バンドラスタを生成します。元のラスタに対して再分類を行った値が入り、NODATA値を0に設定します。

note: Tag: para
en: original (column rast_view)
ja: 元のラスタ (rast_viewカラム)

note: Tag: para
en: Create a new 3 band raster same pixel type from our original 3 band raster with first band altered by map algebra and remaining 2 bands unaltered.
ja: 新しいバンドを三つ持つラスタを生成します。元のバンドを三つ持つラスタと同じピクセルタイプです。1番バンドは地図代数関数によって変更され、残りの二つのバンドは値が代わりません。

note: Tag: refpurpose
en: 2 raster band version: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation on the two input raster bands and of pixeltype provided. band 1 of each raster is assumed if no band numbers are specified. The resulting raster will be aligned (scale, skew and pixel corners) on the grid defined by the first raster and have its extent defined by the "extenttype" parameter. Values for "extenttype" can be: INTERSECTION, UNION, FIRST, SECOND.
ja: 2バンド版: 二つの入力バンドに対する妥当なPostgreSQL代数演算で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、どちらも1番と仮定します。結果ラスタは、一つ目のラスタのアラインメント (スケール、スキュー、ピクセル角位置)にあわされます。範囲は"extenttype"引数で定義されます。取りうる"extenttype"の値はINTERSECTION, UNION, FIRST, SECONDです。

note: Tag: para
en: If <varname>pixeltype</varname> is passed in, then the new raster will have a band of that pixeltype. If pixeltype is passed NULL or no pixel type specified, then the new raster band will have the same pixeltype as the input <varname>rast1</varname> band.
ja: <varname>pixeltype</varname>が渡された場合には、新しいラスタは、指定されたピクセルタイプのバンドを持ちます。pixeltypeとしてNULLが渡されたりピクセルタイプを指定しない場合には、新しいラスタは<varname>rast1</varname>と同じピクセルタイプになります。

note: Tag: para
en: Use the term <varname>[rast1.val]</varname> <varname>[rast2.val]</varname> to refer to the pixel value of the original raster bands and <varname>[rast1.x]</varname>, <varname>[rast1.y]</varname> etc. to refer to the column / row positions of the pixels.
ja: 数式の中で使える語は、元バンドのピクセル値を参照する <varname>[rast1.val]</varname>, <varname>[rast2.val]</varname>、1始まりの列/行インデックスを参照する<varname>[rast1.x]</varname>, <varname>[rast1.y]</varname>などです。

note: Tag: title
en: Example: 2 Band Intersection and Union
ja: 例: 2バンドの共有と結合

note: Tag: para
en: mapalgebra intersection
ja: インタセクションの場合

note: Tag: para
en: map algebra union
ja: 結合の場合

note: Tag: title
en: Example: Overlaying rasters on a canvas as separate bands
ja: 例: 別個のバンドとしてキャンバス上にラスタをオーバレイする

note: Tag: title
en: Example: Overlay 2 meter boundary of select parcels over an aerial imagery
ja: 例: 選択した区画の2メートル幅境界線を空中写真にオーバレイする

note: Tag: para
en: The blue lines are the boundaries of select parcels
ja: 青線が対象区画の境界です

note: Tag: refpurpose
en: 1 band version - Creates a new one band raster formed by applying a valid PostgreSQL function on the input raster band and of pixeltype prodived. Band 1 is assumed if no band is specified.
ja: 1バンド版 - 入力バンドに対する妥当なPostgreSQL関数で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、1番と仮定します。

note: Tag: para
en: is deprecated as of 2.1.0. Use <xref linkend="RT_ST_MapAlgebra"/> instead.
ja: は2.1.0で非推奨になりました。代わりに<xref linkend="RT_ST_MapAlgebra"/>を使います。

note: Tag: para
en: Creates a new one band raster formed by applying a valid PostgreSQL function specified by the <varname>onerasteruserfunc</varname> on the input raster (<varname>rast</varname>). If no <varname>band</varname> is specified, band 1 is assumed. The new raster will have the same georeference, width, and height as the original raster but will only have one band.
ja: 入力ラスタ (<varname>rast</varname>)に対して<varname>onerasteruserfunc</varname>で指定される妥当なPostgreSQL関数で形成されたラスタを返します。生成されるラスタは指定したピクセルタイプとなる1バンドラスタです。<varname>band</varname>を指定しない場合には、1番と仮定します。新しいラスタは、元のラスタと同じ地理参照、幅、高さを持ちますが、一つのバンドしか持ちません。

note: Tag: para
en: The <varname>onerasteruserfunc</varname> parameter must be the name and signature of a SQL or PL/pgSQL function, cast to a regprocedure. A very simple and quite useless PL/pgSQL function example is:
ja: <varname>onerasteruserfunc</varname>引数は SQL関数またはPL/pgSQL関数の名前とシグネチャで、regprocedureにキャストします。大変単純で本当に使えないPL/pgSQL関数の例を挙げます:

note: Tag: para
en: The <varname>userfunction</varname> may accept two or three arguments: a float value, an optional integer array, and a variadic text array. The first argument is the value of an individual raster cell (regardless of the raster datatype). The second argument is the position of the current processing cell in the form '{x,y}'. The third argument indicates that all remaining parameters to <xref linkend="RT_ST_MapAlgebraFct"/> shall be passed through to the <varname>userfunction</varname>.
ja: <varname>userfunction</varname>は、2または3の引数を受け付けます。すなわち、float8値、任意引数の整数配列、VARIADIC文字列配列です。第1引数はラスタセルごとの値です (ラスタのデータ型に関係なく)。第2引数は現在の処理セルの位置で、'{x,y}'であらわされます。第3引数は、<xref linkend="RT_ST_MapAlgebraFct"/>へのパラメータの残っているもの全てが<varname>userfunction</varname>に渡されることを示します。

note: Tag: para
en: Passing a <type>regprodedure</type> argument to a SQL function requires the full function signature to be passed, then cast to a <type>regprocedure</type> type. To pass the above example PL/pgSQL function as an argument, the SQL for the argument is:
ja: <type>regprocedure</type>引数をSQL関数に渡す場合には、渡し先の完全な関数シグネチャが必要で、さらに<type>regprocedure</type>にキャストします。上の例のPL/pgSQL関数を引数として渡すには、引数のSQLは次のようになります:

note: Tag: para
en: The third argument to the <varname>userfunction</varname> is a <type>variadic text</type> array. All trailing text arguments to any <xref linkend="RT_ST_MapAlgebraFct"/> call are passed through to the specified <varname>userfunction</varname>, and are contained in the <varname>args</varname> argument.
ja: <varname>userfunction</varname>の第3引数は<type>variadic text</type>配列です。どの<xref linkend="RT_ST_MapAlgebraFct"/>にもついてくる全ての文字列引数は、指定された<varname>userfunction</varname>に、そのまま渡されて、<varname>args</varname>引数内に入ります。

note: Tag: para
en: The <type>text[]</type> argument to the <varname>userfunction</varname> is required, regardless of whether you choose to pass any arguments to your user function for processing or not.
ja: <varname>userfunction</varname>への<type>text[]</type>引数は、あらゆる引数を処理のためにユーザ関数に渡すかどうかの選択にかかわらず求められます。

note: Tag: para
en: Create a new 1 band raster of pixel-type 2BUI from our original that is reclassified and set the nodata value to a passed parameter to the user function (0).
ja: ピクセルタイプが2BUIの1バンドラスタを生成します。元のラスタに対して再分類を行った値が入り、NODATA値をユーザ関数に渡される引数の値 (0)に設定します。

note: Tag: para
en: original (column rast-view)
ja: 元のラスタ (rast_viewカラム)

note: Tag: refpurpose
en: 2 band version - Creates a new one band raster formed by applying a valid PostgreSQL function on the 2 input raster bands and of pixeltype prodived. Band 1 is assumed if no band is specified. Extent type defaults to INTERSECTION if not specified.
ja: 2バンド版 - 二つの入力バンドに対する妥当なPostgreSQL関数で形成された、指定したピクセルタイプとなる1バンドラスタを生成します。バンドを指定しない場合には、1番と仮定します。"extenttype"のデフォルトはINTERSECTIONです。

note: Tag: para
en: Creates a new one band raster formed by applying a valid PostgreSQL function specified by the <varname>tworastuserfunc</varname> on the input raster <varname>rast1</varname>, <varname>rast2</varname>. If no <varname>band1</varname> or <varname>band2</varname> is specified, band 1 is assumed. The new raster will have the same georeference, width, and height as the original rasters but will only have one band.
ja: 二つの入力ラスタ (<varname>rast1</varname>, <varname>rast2</varname>)に対して<varname>tworastuserfunc</varname>で指定される妥当なPostgreSQL関数で形成されるラスタを返します。<varname>band1</varname>または<varname>band2</varname>が指定されていない場合には、1番と仮定します。新しいラスタは、元のラスタと同じ地理参照、幅、高さを持ちますが、一つのバンドしか持ちません。

note: Tag: para
en: If <varname>pixeltype</varname> is passed in, then the new raster will have a band of that pixeltype. If pixeltype is passed NULL or left out, then the new raster band will have the same pixeltype as the input <varname>rast1</varname> band.
ja: <varname>pixeltype</varname>が渡された場合には、新しいラスタはそのピクセルタイプのバンドを持ちます。pixelteypeとしてNULLが渡されたりピクセルタイプを指定しない場合には、新しいラスタは<varname>rast1</varname>の入力バンドと同じピクセルタイプになります。

note: Tag: para
en: The <varname>tworastuserfunc</varname> parameter must be the name and signature of an SQL or PL/pgSQL function, cast to a regprocedure. An example PL/pgSQL function example is:
ja: <varname>tworastuserfunc</varname>引数は、SQLまたはPL/pgSQL関数の名前とシグニチャでなければならず、regprocedureにキャストしなければなりません。PL/pgSQL関数の例は次の通りです:

note: Tag: para
en: The <varname>tworastuserfunc</varname> may accept three or four arguments: a double precision value, a double precision value, an optional integer array, and a variadic text array. The first argument is the value of an individual raster cell in <varname>rast1</varname> (regardless of the raster datatype). The second argument is an individual raster cell value in <varname>rast2</varname>. The third argument is the position of the current processing cell in the form '{x,y}'. The fourth argument indicates that all remaining parameters to <xref linkend="RT_ST_MapAlgebraFct2"/> shall be passed through to the <varname>tworastuserfunc</varname>.
ja: <varname>tworastuserfunc</varname>は3または4の引数を受け付けます。すなわち、一つ目の倍精度浮動小数点数、二つ目の倍精度浮動小数点数、任意引数の整列配列、VARIADIC文字列配列です。第1引数は<varname>rast1</varname>のラスタセルごとの値です (ラスタのデータ型に関係なく)。第1引数は<varname>rast2</varname>のラスタセルごとの値です。第3引数は現在の処理セルの位置で、'{x,y}'であらわされます。第4引数は<xref linkend="RT_ST_MapAlgebraFct2"/>へのパラメータの残っているもの全てが<varname>tworastuserfunc</varname>に渡されることを示します。

note: Tag: para
en: The fourth argument to the <varname>tworastuserfunc</varname> is a <type>variadic text</type> array. All trailing text arguments to any <xref linkend="RT_ST_MapAlgebraFct2"/> call are passed through to the specified <varname>tworastuserfunc</varname>, and are contained in the <varname>userargs</varname> argument.
ja: <varname>tworastuserfunc</varname>引数は <type>variadic text</type>配列です。どの<xref linkend="RT_ST_MapAlgebraFct2"/>にもついてくる全ての文字列引数は、指定された<varname>tworastuserfunc</varname>に、そのまま渡されて、<varname>userargs</varname>引数内に入ります。

note: Tag: para
en: The <type>text[]</type> argument to the <varname>tworastuserfunc</varname> is required, regardless of whether you choose to pass any arguments to your user function for processing or not.
ja: <varname>tworastuserfunc</varname>への<type>text[]</type>引数は、あらゆる引数を処理のためにユーザ関数に渡すかどうかの選択にかかわらず求められます。

note: Tag: para
en: map bands overlay (canvas) (R: small road, G: circle, B: big road)
ja: バンドオーバレイ (キャンバス)の図 (赤:小さい道 緑:円、青:大きな道)

note: Tag: title
en: User Defined function that takes extra args
ja: 追加引数を取るユーザ定義関数

note: Tag: para
en: user defined with extra args and different bands from same raster
ja: 追加引数を持つユーザ定義関数と同じラスタからの異なるバンド

note: Tag: refpurpose
en: 1-band version: Map Algebra Nearest Neighbor using user-defined PostgreSQL function. Return a raster which values are the result of a PLPGSQL user function involving a neighborhood of values from the input raster band.
ja: 1バンド版: ユーザ定義PostgreSQL関数を使用する最近傍地図代数関数です。入力ラスタバンドの近傍の値を与えたPL/pgSQLユーザ定義関数の結果からなるラスタを返します。

note: Tag: para
en: (one raster version) Return a raster which values are the result of a PLPGSQL user function involving a neighborhood of values from the input raster band. The user function takes the neighborhood of pixel values as an array of numbers, for each pixel, returns the result from the user function, replacing pixel value of currently inspected pixel with the function result.
ja: (1バンド版) 入力ラスタバンドの近傍の値を与えたPL/pgSQLユーザ定義関数の結果からなるラスタを返します。ユーザ定義関数は近傍のピクセル値を数の配列として取り、ピクセル毎に、ユーザ定義関数からの結果を返し、現在の対象ピクセルのピクセル値を関数の返り値に置き換えます。

note: Tag: para
en: Raster on which the user function is evaluated.
ja: ユーザ定義関数が評価されるラスタです。

note: Tag: para
en: Band number of the raster to be evaluated. Default to 1.
ja: 評価されるラスタのバンド番号です。デフォルトは1です。

note: Tag: para
en: The resulting pixel type of the output raster. Must be one listed in <xref linkend="RT_ST_BandPixelType"/> or left out or set to NULL. If not passed in or set to NULL, will default to the pixeltype of the <varname>rast</varname>. Results are truncated if they are larger than what is allowed for the pixeltype.
ja: 出力ラスタのピクセルタイプです。<xref linkend="RT_ST_BandPixelType"/>の一覧にあるものか、指定しないか、NULLを指定します。指定しないかNULLを指定した場合には、<varname>rast</varname>のピクセルタイプがデフォルトになります。結果ピクセル値がピクセルタイプが許容する範囲を超える場合には、切り詰められます。

note: Tag: para
en: The width of the neighborhood, in cells.
ja: セル単位の近傍の幅です。

note: Tag: para
en: The height of the neighborhood, in cells.
ja: セル単位の近傍の高さです。

note: Tag: para
en: PLPGSQL/psql user function to apply to neighborhood pixels of a single band of a raster. The first element is a 2-dimensional array of numbers representing the rectangular pixel neighborhood
ja: ラスタの単一バンドの近傍ピクセルに適用されるPL/pgSQLユーザ定義関数です。一つ目の要素は、近傍ピクセルの四角形を表現する数値の2次元配列です。

note: Tag: para
en: Defines what value to pass to the function for a neighborhood pixel that is nodata or NULL
ja: NODATAまたはNULLとなる近傍ピクセルにおける関数に渡す値を定義します。

note: Tag: para
en: 'ignore': any NODATA values encountered in the neighborhood are ignored by the computation -- this flag must be sent to the user callback function, and the user function decides how to ignore it.
ja: 'ignore': 近傍で遭遇したNODATA値全てが計算から除外されます。ユーザ定義関数に必ず送られ、ユーザ定義関数が対処方法を決定します。

note: Tag: para
en: 'NULL': any NODATA values encountered in the neighborhood will cause the resulting pixel to be NULL -- the user callback function is skipped in this case.
ja: 'NULL': 近傍で遭遇したNODATA値全てが結果をNULLとします。この場合はユーザ定義関数が呼び出されません。

note: Tag: para
en: 'value': any NODATA values encountered in the neighborhood are replaced by the reference pixel (the one in the center of the neighborhood). Note that if this value is NODATA, the behavior is the same as 'NULL' (for the affected neighborhood)
ja: 'value': 近傍で遭遇したNODATA値全てが参照ピクセル (近傍の中心にあるピクセル)の値に置き換えられます。この値がNODATAになった場合には、'NULL'と同じ挙動を取ります (影響のある近傍について)。

note: Tag: para
en: Arguments to pass into the user function.
ja: ユーザ定義関数に渡される引数です。

note: Tag: para
en: Examples utilize the katrina raster loaded as a single tile described in <link xlink:href="http://trac.osgeo.org/gdal/wiki/frmts_wtkraster.html">http://trac.osgeo.org/gdal/wiki/frmts_wtkraster.html</link> and then prepared in the <xref linkend="RT_ST_Rescale"/> examples
ja: 単一タイルとしてロードされたカトリーナのラスタを使った例です。<link xlink:href="http://trac.osgeo.org/gdal/wiki/frmts_wtkraster.html">http://trac.osgeo.org/gdal/wiki/frmts_wtkraster.html</link>に説明があります。また、<xref linkend="RT_ST_Rescale"/>の例で準備を行っています

note: Tag: para
en: First band of our raster
ja: ラスタの1番バンド

note: Tag: para
en: new raster after averaging pixels within 4x4 pixels of each other
ja: ピクセル毎に4x4ピクセル内のピクセル平均を計算したラスタ

note: Tag: refpurpose
en: Creates a new raster composed of band types reclassified from original. The nband is the band to be changed. If nband is not specified assumed to be 1. All other bands are returned unchanged. Use case: convert a 16BUI band to a 8BUI and so forth for simpler rendering as viewable formats.
ja: 元のラスタから再分類したバンドタイプからなるラスタを生成します。nbandは変更するバンドです。nbandが指定されていない場合には、1と仮定します。他の全てのバンドは変更せずに返します。可視画像の書式としてより単純な描画を行うために、16BUIバンドを8BUIバンドに変換する、等のために使います。

note: Tag: para
en: Creates a new raster formed by applying a valid PostgreSQL algebraic operation defined by the <varname>reclassexpr</varname> on the input raster (<varname>rast</varname>). If no <varname>band</varname> is specified band 1 is assumed. The new raster will have the same georeference, width, and height as the original raster. Bands not designated will come back unchanged. Refer to <xref linkend="reclassarg"/> for description of valid reclassification expressions.
ja: 入力ラスタ (<varname>rast</varname>)に<varname>reclassexpr</varname>で定義する妥当なPostgreSQL代数演算子を適用して新しいラスタを生成します。<varname>band</varname>が指定されていない場合には、1番と仮定します。新しいラスタは、元のラスタと同じ地理参照、幅、高さを持ちます。指示されていないバンドは変更せずに返ります。妥当な再分類の数式の説明については<xref linkend="reclassarg"/>を参照して下さい。

note: Tag: para
en: The bands of the new raster will have pixel type of <varname>pixeltype</varname>. If <varname>reclassargset</varname> is passed in then each reclassarg defines behavior of each band generated.
ja: 新しいラスタのバンドは<varname>pixeltype</varname>で指定するピクセルタイプになります。<varname>reclassargset</varname>を渡した場合は、個々のreclassargが生成されるバンド毎の挙動を定義します。

note: Tag: para
en: Create a new raster from the original where band 2 is converted from 8BUI to 4BUI and all values from 101-254 are set to nodata value.
ja: 元ラスタから新しいラスタを生成しますが、2番バンドを8BUIから4BUIに変換して、101-254をNODATA値にします。

note: Tag: title
en: Example: Advanced using multiple reclassargs
ja: 例: 複数の再分類を使った高度な例

note: Tag: para
en: Create a new raster from the original where band 1,2,3 is converted to 1BB,4BUI, 4BUI respectively and reclassified. Note this uses the variadic <varname>reclassarg</varname> argument which can take as input an indefinite number of reclassargs (theoretically as many bands as you have)
ja: 元ラスタから新しいラスタを生成しますが、1番、2番、3番バンドを1BB, 4BUI, 4BUIにそれぞれ変換して再分類します。再分類の識別番号 (理論的には元ラスタと同数のバンド)を入力するために取るVARIADIC <varname>reclassarg</varname> 引数を使っています。

note: Tag: title
en: Example: Advanced Map a single band 32BF raster to multiple viewable bands
ja: 例: 単一バンドで32BFのラスタをの可視ラスタへの高度な対応付け

note: Tag: para
en: Create a new 3 band (8BUI,8BUI,8BUI viewable raster) from a raster that has only one 32bf band
ja: 32BFバンドを一つ持つだけのラスタから三つのバンド (8BUI, 8BUI, 8BUI可視ラスタ)を生成します

note: Tag: refpurpose
en: Returns the union of a set of raster tiles into a single raster composed of 1 or more bands.
ja: ラスタタイルの集合を結合して1以上のバンドからなる単一ラスタを返します。

note: Tag: para
en: Returns the union of a set of raster tiles into a single raster composed of at least one band. The resulting raster's extent is the extent of the whole set. In the case of intersection, the resulting value is defined by <varname>uniontype</varname> which is one of the following: LAST (default), FIRST, MIN, MAX, COUNT, SUM, MEAN, RANGE.
ja: ラスタタイルの集合を結合して少なくとも一つのバンドからなる単一ラスタを返します。結果ラスタの範囲は集合全体の範囲です。インタセクトする場合には、結果値は、LAST (デフォルト), FIRST, MIN, MAX, COUNT, SUM, MEAN, RANGEのいずれかとなる<varname>uniontype</varname>で定義されます。

note: Tag: para
en: In order for rasters to be unioned, they must all have the same alignment. Use <xref linkend="RT_ST_SameAlignment"/> and <xref linkend="RT_ST_NotSameAlignmentReason"/> for more details and help. One way to fix alignment issues is to use <xref linkend="RT_ST_Resample"/> and use the same reference raster for alignment.
ja: ラスタを結合するには、全てが同じアラインメントを持たなくてはなりません。<xref linkend="RT_ST_SameAlignment"/>と<xref linkend="RT_ST_NotSameAlignmentReason"/>で詳細情報や助けとなる情報が得られます。アラインメント問題を修正する一つの方法として、<xref linkend="RT_ST_Resample"/>を使い、アラインメントの同じ参照ラスタを使います。

note: Tag: para
en: Enhanced: 2.1.0 Improved Speed (fully C-Based).
ja: Enhanced: 2.1.0 速度が改善されました (完全にC言語で記述しました)。

note: Tag: para
en: Availability: 2.1.0 ST_Union(rast, unionarg) variant was introduced.
ja: Availability: 2.1.0 ST_Union(rast, unionarg)の形式が導入されました。

note: Tag: para
en: Enhanced: 2.1.0 ST_Union(rast) (variant 1) unions all bands of all input rasters. Prior versions of PostGIS assumed the first band.
ja: Enhanced: 2.1.0 ST_Union(rast) (一つ目の形式)で、全ての入力ラスタの全てのバンドを結合するようになりました。以前の版のPostGISでは、一つ目のバンドと仮定していました。

note: Tag: para
en: Enhanced: 2.1.0 ST_Union(rast, uniontype) (variant 4) unions all bands of all input rasters.
ja: Enhanced: 2.1.0 ST_Union(rast, uniontype) (四つ目の形式)で、全ての入力ラスタの全てのバンドを結合するようになりました。

note: Tag: title
en: Examples: Reconstitute a single band chunked raster tile
ja: 例: 塊になっているラスタタイルの単一バンドへの再構成

note: Tag: title
en: Examples: Return a multi-band raster that is the union of tiles intersecting geometry
ja: 例: タイルのジオメトリとインタセクトするタイルを結合した複数バンドのラスタ

note: Tag: para
en: Here we use the longer syntax if we only wanted a subset of bands or we want to change order of bands
ja: バンドの部分集合が欲しいだけの場合や、バンドの並び順を変更したい場合には、より長い書き方にします。

note: Tag: title
en: Built-in Map Algebra Callback Functions
ja: 組み込み地図代数コールバック関数

note: Tag: refpurpose
en: Raster processing function that calculates the number of unique pixel values in a neighborhood.
ja: 近隣のピクセル値のうち一意となるものを数えるラスタ処理関数です。

note: Tag: para
en: Calculate the number of unique pixel values in a neighborhood of pixels.
ja: 近隣のピクセル値のうち一意となるものを数えます。

note: Tag: para
en: Variant 1 is a specialized callback function for use as a callback parameter to <xref linkend="RT_ST_MapAlgebraFctNgb"/>.
ja: 一つ目の形式は、<xref linkend="RT_ST_MapAlgebraFctNgb"/>へのコールバック引数として使用する専用コールバック関数です。

note: Tag: para
en: Variant 2 is a specialized callback function for use as a callback parameter to <xref linkend="RT_ST_MapAlgebra"/>.
ja: 二つ目の形式は、<xref linkend="RT_ST_MapAlgebra"/>へのコールバック引数として使用する専用コールバック関数です。

note: Tag: para
en: Use of Variant 1 is discouraged since <xref linkend="RT_ST_MapAlgebraFctNgb"/> has been deprecated as of 2.1.0.
ja: 一つ目の形式は、<xref linkend="RT_ST_MapAlgebraFctNgb"/>が2.1.0で非推奨となったので、使用しないようになります。

note: Tag: para
en: Enhanced: 2.1.0 Addition of Variant 2
ja: Enhanced: 2.1.0 二つ目の形式の追加

note: Tag: refpurpose
en: Raster processing function that interpolates a pixel's value from the pixel's neighborhood.
ja: 近隣のピクセル値の内挿補間を行うラスタ処理関数です。

note: Tag: para
en: Calculate an interpolated value for a pixel using the Inverse Distance Weighted method.
ja: 近隣のピクセル値の逆距離加重法 (IDW=Inverse Distance Weighted method)による内挿補間を行います。

note: Tag: para
en: There are two optional parameters that can be passed through <varname>userargs</varname>. The first parameter is the power factor (variable k in the equation below) between 0 and 1 used in the Inverse Distance Weighted equation. If not specified, default value is 1. The second parameter is the weight percentage applied only when the value of the pixel of interest is included with the interpolated value from the neighborhood. If not specified and the pixel of interest has a value, that value is returned.
ja: <varname>userargsに</varname>渡される、二つの任意引数があります。一つ目は、逆距離加重法の式に与える0から1の間を取る冪数 (下の式の変数k)です。指定しない場合には、デフォルトは1とします。二つ目は、対象ピクセルの値が近隣セルからの補間値に含まれている場合にのみ適用される重み率です。指定せず、かつ対象ピクセルが値を持っている場合には、そのピクセルの持つ値が返されます。

note: Tag: para
en: The basic inverse distance weight equation is:
ja: 基本的な逆距離加重法の方程式は次の通りです。

note: Tag: para
en: k = power factor, a real number between 0 and 1
ja: k = 冪数で、0から1の浮動小数点数を取ります。

note: Tag: para
en: This function is a specialized callback function for use as a callback parameter to <xref linkend="RT_ST_MapAlgebra"/>.
ja: この関数は<xref linkend="RT_ST_MapAlgebra"/>へのコールバック引数として使用する専用コールバック関数です。

note: Tag: refpurpose
en: Raster processing function that calculates the maximum pixel value in a neighborhood.
ja: 近隣のピクセル値の最大値を計算するラスタ処理関数です。

note: Tag: para
en: Calculate the maximum pixel value in a neighborhood of pixels.
ja: 近隣のピクセル値の最大値を計算します。

note: Tag: para
en: For Variant 2, a substitution value for NODATA pixels can be specified by passing that value to userargs.
ja: 二つ目の形式では、userargsに渡す値でNODATAピクセルに代入する値を指定できます。

note: Tag: refpurpose
en: Raster processing function that calculates the mean pixel value in a neighborhood.
ja: 近隣のピクセル値の平均値を計算するラスタ処理関数です。

note: Tag: para
en: Calculate the mean pixel value in a neighborhood of pixels.
ja: 近隣のピクセル値の平均値を計算します。

note: Tag: refpurpose
en: Raster processing function that calculates the minimum pixel value in a neighborhood.
ja: 近隣のピクセル値の最小値を計算するラスタ処理関数です。

note: Tag: para
en: Calculate the minimum pixel value in a neighborhood of pixels.
ja: 近隣のピクセル値の最小値を計算します。

note: Tag: refpurpose
en: Raster processing function that returns the minimum distance (in number of pixels) between the pixel of interest and a neighboring pixel with value.
ja: 対象ピクセルと値を持つ近隣ピクセルとの最短距離をピクセル単位で返すラスタ処理関数です。

note: Tag: para
en: Return the shortest distance (in number of pixels) between the pixel of interest and the closest pixel with value in the neighborhood.
ja: 対象ピクセルと値を持つ近隣ピクセルとの最短距離をピクセル単位で返します。

note: Tag: para
en: The intent of this function is to provide an informative data point that helps infer the usefulness of the pixel of interest's interpolated value from <xref linkend="RT_ST_InvDistWeight4ma"/>. This function is particularly useful when the neighborhood is sparsely populated.
ja: この関数の意図は、<xref linkend="RT_ST_InvDistWeight4ma"/>から対象ピクセルの内挿補間された値の有用性を判断することを補助するのに有益なデータポイントを提供することです。この関数は近隣セルの密度が小さい時に特に使えます。

note: Tag: refpurpose
en: Raster processing function that calculates the range of pixel values in a neighborhood.
ja: 近隣のピクセル値の範囲を計算するラスタ処理関数です。

note: Tag: para
en: Calculate the range of pixel values in a neighborhood of pixels.
ja: 近隣のピクセル値の範囲を計算します。

note: Tag: refpurpose
en: Raster processing function that calculates the standard deviation of pixel values in a neighborhood.
ja: 近隣のピクセル値の標準偏差を計算するラスタ処理関数です。

note: Tag: para
en: Calculate the standard deviation of pixel values in a neighborhood of pixels.
ja: 近隣のピクセル値の標準偏差を計算します。

note: Tag: refpurpose
en: Raster processing function that calculates the sum of all pixel values in a neighborhood.
ja: 近隣のピクセル値の合計を計算するラスタ処理関数です。

note: Tag: para
en: Calculate the sum of all pixel values in a neighborhood of pixels.
ja: 近隣のピクセル値の合計を計算します。

note: Tag: title
en: Raster Processing: DEM (Elevation)
ja: ラスタ処理: DEM (標高)

note: Tag: refpurpose
en: Returns the aspect (in degrees by default) of an elevation raster band. Useful for analyzing terrain.
ja: 標高ラスタバンドの傾斜方向 (デフォルトの単位は度)を返します。地形解析に使えます。

note: Tag: para
en: Returns the aspect (in degrees by default) of an elevation raster band. Utilizes map algebra and applies the aspect equation to neighboring pixels.
ja: 標高ラスタバンドの傾斜方向 (デフォルトの単位は度)を返します。地図代数を利用して、傾斜方向方程式を隣接ピクセルに適用します。

note: Tag: para
en: <varname>units</varname> indicates the units of the aspect. Possible values are: RADIANS, DEGREES (default).
ja: <varname>units</varname>は、傾斜方向の単位を示します。取りえる値はRADIANS, DEGREES (デフォルト)です。

note: Tag: para
en: When <varname>units</varname> = RADIANS, values are between 0 and 2 * pi radians measured clockwise from North.
ja: <varname>units</varname>がRADIANSの時、値は0から2πラジアンの間で、北から時計回りに計ります。

note: Tag: para
en: When <varname>units</varname> = DEGREES, values are between 0 and 360 degrees measured clockwise from North.
ja: <varname>units</varname>がDEGREESの時、値は0から360度の間で、北から時計回りに計ります。

note: Tag: para
en: If slope of pixel is zero, aspect of pixel is -1.
ja: ピクセルの傾斜角が0の場合には、傾斜方向は-1とします。

note: Tag: para
en: For more information about Slope, Aspect and Hillshade, please refer to <link xlink:href="http://webhelp.esri.com/arcgisdesktop/9.3/index.cfm?TopicName=How%20Hillshade%20works">ESRI - How hillshade works</link> and <link xlink:href="http://e2b.erdas.com/fieldguide/wwhelp/wwhimpl/common/html/wwhelp.htm?context=FieldGuide&amp;file=Aspect_Images.html">ERDAS Field Guide - Aspect Images</link>.
ja: 傾斜角、傾斜方および陰影起伏に関する詳細情報については、<link xlink:href="http://webhelp.esri.com/arcgisdesktop/9.3/index.cfm?TopicName=How%20Hillshade%20works">ESRI - How hillshade works</link>および<link xlink:href="http://e2b.erdas.com/fieldguide/wwhelp/wwhimpl/common/html/wwhelp.htm?context=FieldGuide&amp;file=Aspect_Images.html">ERDAS Field Guide - Aspect Images</link>を参照して下さい。

note: Tag: para
en: Enhanced: 2.1.0 Uses ST_MapAlgebra() and added optional <varname>interpolate_nodata</varname> function parameter
ja: Enhanced: 2.1.0 ST_MapAlgebra()を使用するようにし、<varname>interpolate_nodata</varname>任意引数を追加しました。

note: Tag: para
en: Changed: 2.1.0 In prior versions, return values were in radians. Now, return values default to degrees
ja: Changed: 2.1.0 以前の版では、返り値はラジアン単位でした。現在は、デフォルトでは度で返します。

note: Tag: para
en: Complete example of tiles of a coverage. This query only works with PostgreSQL 9.1 or higher.
ja: カバレッジのタイルの完全な例です。このクエリはPostgreSQL 9.1以上でのみ動作します。

note: Tag: refpurpose
en: Returns the hypothetical illumination of an elevation raster band using provided azimuth, altitude, brightness and scale inputs.
ja: 与えられた方位、高度、明度、スケールの入力を使って標高ラスタバンドの仮想照明を返します。

note: Tag: para
en: Returns the hypothetical illumination of an elevation raster band using the azimuth, altitude, brightness, and scale inputs. Utilizes map algebra and applies the hill shade equation to neighboring pixels. Return pixel values are between 0 and 255.
ja: 与えられた方位、高度、明度、スケールの入力を使って標高ラスタバンドの仮想照明を返します。地図代数を使って、陰影図方程式を隣接ピクセルに適用します。返されるピクセル値は0と255の間です。

note: Tag: para
en: <varname>azimuth</varname> is a value between 0 and 360 degrees measured clockwise from North.
ja: <varname>azimuth</varname>は0から360度の間の値で、北から時計回りに計ります。

note: Tag: para
en: <varname>altitude</varname> is a value between 0 and 90 degrees where 0 degrees is at the horizon and 90 degrees is directly overhead.
ja: <varname>altitude</varname>は0から90度の間で、0が水平、90が鉛直上向きです。

note: Tag: para
en: <varname>max_bright</varname> is a value between 0 and 255 with 0 as no brightness and 255 as max brightness.
ja: <varname>max_bright</varname>は0から255までの間で、0は明度なしで、255が最大明度です。

note: Tag: para
en: <varname>scale</varname> is the ratio of vertical units to horizontal. For Feet:LatLon use scale=370400, for Meters:LatLon use scale=111120.
ja: <varname>scale</varname>は鉛直単位と水平単位との比です。フィート:経度緯度ではscale=370400となり、メートル:経度緯度ではscale=111120となります。

note: Tag: para
en: If <varname>interpolate_nodata</varname> is TRUE, values for NODATA pixels from the input raster will be interpolated using <xref linkend="RT_ST_InvDistWeight4ma"/> before computing the hillshade illumination.
ja: <varname>interpolate_nodata</varname>がTRUEの場合には、入力ラスタのNODATAピクセルの値は陰影図を計算する前に<xref linkend="RT_ST_InvDistWeight4ma"/>を使って内挿を行います。

note: Tag: para
en: For more information about Hillshade, please refer to <link xlink:href="http://webhelp.esri.com/arcgisdesktop/9.3/index.cfm?TopicName=How%20Hillshade%20works">How hillshade works</link>.
ja: 陰影図に関する詳細情報については <link xlink:href="http://webhelp.esri.com/arcgisdesktop/9.3/index.cfm?TopicName=How%20Hillshade%20works">How hillshade works</link>をご覧下さい。

note: Tag: para
en: Changed: 2.1.0 In prior versions, azimuth and altitude were expressed in radians. Now, azimuth and altitude are expressed in degrees
ja: Changed: 2.1.0 以前の版ではazimuthとaltitudeはラジアン単位で表現しました。現在はazimuthとaltitudeは度単位で表現します。

note: Tag: refpurpose
en: Returns a raster with the calculated "roughness" of a DEM.
ja: DEMの「粗度」を計算したラスタを返します。

note: Tag: para
en: Calculates the "roughness" of a DEM, by subtracting the maximum from the minimum for a given area.
ja: 指定された領域の最大値から最小値を減じることでDEMの「粗度」を計算したラスタを返します。

note: Tag: refpurpose
en: Returns the slope (in degrees by default) of an elevation raster band. Useful for analyzing terrain.
ja: 標高ラスタバンドの傾斜角 (デフォルトでは度単位)を返します。地形解析に使えます。

note: Tag: para
en: Returns the slope (in degrees by default) of an elevation raster band. Utilizes map algebra and applies the slope equation to neighboring pixels.
ja: 標高ラスタバンドの傾斜角 (デフォルトでは度単位)を返します。地図代数を使って、傾斜角方程式を隣接ピクセルに適用します。

note: Tag: para
en: <varname>units</varname> indicates the units of the slope. Possible values are: RADIANS, DEGREES (default), PERCENT.
ja: <varname>units</varname>は傾斜角の単位を示します。取りえる値はRADIANS, DEGREES (デフォルト), PERCENTです。

note: Tag: para
en: If <varname>interpolate_nodata</varname> is TRUE, values for NODATA pixels from the input raster will be interpolated using <xref linkend="RT_ST_InvDistWeight4ma"/> before computing the surface slope.
ja: <varname>interpolate_nodata</varname>がTRUEの場合には、入力ラスタのNODATAピクセルの値は表面傾斜角を計算する前に<xref linkend="RT_ST_InvDistWeight4ma"/>を使って内挿を行います。

note: Tag: para
en: For more information about Slope, Aspect and Hillshade, please refer to <link xlink:href="http://webhelp.esri.com/arcgisdesktop/9.3/index.cfm?TopicName=How%20Hillshade%20works">ESRI - How hillshade works</link> and <link xlink:href="http://e2b.erdas.com/fieldguide/wwhelp/wwhimpl/common/html/wwhelp.htm?context=FieldGuide&amp;file=Slope_Images.html">ERDAS Field Guide - Slope Images</link>.
ja: 傾斜角、傾斜方および陰影起伏に関する詳細情報については、<link xlink:href="http://webhelp.esri.com/arcgisdesktop/9.3/index.cfm?TopicName=How%20Hillshade%20works">ESRI - How hillshade works</link>および<link xlink:href="http://e2b.erdas.com/fieldguide/wwhelp/wwhimpl/common/html/wwhelp.htm?context=FieldGuide&amp;file=Slope_Images.html">ERDAS Field Guide - Slope Images</link>を参照して下さい。

note: Tag: para
en: Enhanced: 2.1.0 Uses ST_MapAlgebra() and added optional <varname>units</varname>, <varname>scale</varname>, <varname>interpolate_nodata</varname> function parameters
ja: Enhanced: 2.1.0 ST_MapAlgebra()を使用するようにし、<varname>units</varname>, <varname>scale</varname>, <varname>interpolate_nodata</varname>任意引数を追加しました。

note: Tag: refpurpose
en: Returns a raster with the calculated Topographic Position Index.
ja: 地形的位置指数を計算したラスタを返します。

note: Tag: para
en: Calculates the Topographic Position Index, which is defined as the focal mean with radius of one minus the center cell.
ja: 地形的位置指数 (TPI=Topographic Position Index)を計算します。地形的位置指数は、半径1における近傍平均値から中心セルの値を引いたものです。

note: Tag: para
en: This function only supports a focalmean radius of one.
ja: この関数は、近傍平均値半径が1についてのみ対応しています。

note: Tag: refpurpose
en: Returns a raster with the calculated Terrain Ruggedness Index.
ja: 起伏指標を計算したラスタを返します。

note: Tag: para
en: Terrain Ruggedness Index is calculated by comparing a central pixel with its neighbors, taking the absolute values of the differences, and averaging the result.
ja: 起伏指標 (TRI=Terrain Ruggedness Index)は、中心ピクセルと隣接ピクセルを、差の絶対値の平均を取って比較することで計算されます。

note: Tag: title
en: Raster Processing: Raster to Geometry
ja: ラスタ処理: ラスタからジオメトリ

note: Tag: refpurpose
en: Returns the box 3d representation of the enclosing box of the raster.
ja: ラスタを囲むボックスのbox3d表現を返します。

note: Tag: para
en: Returns the box representing the extent of the raster.
ja: ラスタの範囲を表現するボックスを返します。

note: Tag: para
en: The polygon is defined by the corner points of the bounding box ((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MAXX</varname>, <varname>MAXY</varname>))
ja: ポリゴンは、バウンディングボックス ((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MAXX</varname>, <varname>MAXY</varname>))の4隅のポイントにより定義されます。

note: Tag: para
en: Changed: 2.0.0 In pre-2.0 versions, there used to be a box2d instead of box3d. Since box2d is a deprecated type, this was changed to box3d.
ja: Changed: 2.0.0 以前の版では、box3dでなくbox2dを使っていました。box2dは非推奨型となり、box3dに変更しました。

note: Tag: refpurpose
en: Return the convex hull geometry of the raster including pixel values equal to BandNoDataValue. For regular shaped and non-skewed rasters, this gives the same result as ST_Envelope so only useful for irregularly shaped or skewed rasters.
ja: BandNoDataValueと等しいピクセル値を含むラスタの凸包ジオメトリを返します。一般的な形状でスキューのないラスタでは、ST_Envelopeと同じ結果になります。不規則な形状をしているか回転しているラスタでのみ使います。

note: Tag: para
en: Return the convex hull geometry of the raster including the NoDataBandValue band pixels. For regular shaped and non-skewed rasters, this gives more or less the same result as ST_Envelope so only useful for irregularly shaped or skewed rasters.
ja: NoDataValue値のピクセルを含むラスタの凸包ジオメトリを返します。一般的な形状でスキューのないラスタでは、ST_Envelopeと同じ結果になります。不規則な形状をしているかスキューのあるラスタでのみ使います。

note: Tag: para
en: ST_Envelope floors the coordinates and hence add a little buffer around the raster so the answer is subtly different from ST_ConvexHull which does not floor.
ja: ST_Envelopeは、座標値の小数部を切り捨て、ラスタのまわりに小さなバッファを追加します。小数部の切り捨てを行わないST_ConvexHullの答と若干異なります。

note: Tag: para
en: Refer to <link xlink:href="http://trac.osgeo.org/postgis/wiki/WKTRaster/SpecificationWorking01">PostGIS Raster Specification</link> for a diagram of this.
ja: これの図については<link xlink:href="http://trac.osgeo.org/postgis/wiki/WKTRaster/SpecificationWorking01">PostGIS Raster Specification</link>を参照して下さい。

note: Tag: refpurpose
en: Returns a set of geomval (geom,val) rows, from a given raster band. If no band number is specified, band num defaults to 1.
ja: 指定されたラスタバンドからgeomval (geom,val)行の集合を返します。バンドを指定しない場合のデフォルトは1です。

note: Tag: para
en: This is a set-returning function (SRF). It returns a set of geomval rows, formed by a geometry (geom) and a pixel band value (val). Each polygon is the union of all pixels for that band that have the same pixel value denoted by val.
ja: 集合を返す関数 (SRF=set-returning function)です。geomval行の集合を返します。geomvalはジオメトリ (geom)とピクセルバンド値 (val)からなります。それぞれのポリゴンは、指定したバンドの、valで示される値と同じピクセル値を持っている全てのピクセルの結合です。

note: Tag: para
en: ST_DumpAsPolygon is useful for polygonizing rasters. It is the reverse of a GROUP BY in that it creates new rows. For example it can be used to expand a single raster into multiple POLYGONS/MULTIPOLYGONS.
ja: ST_DumpAsPolygonはラスタのポリゴン化に使えます。新しい行を生成するのでGROUP BYの逆です。たとえば、単一ラスタを複数のPOLYGON/MULTIPOLYGONに展開できます。

note: Tag: para
en: Changed 3.3.0, validation and fixing is disabled to improve performance. May result invalid geometries.
ja: Changed 3.3.0, 能率向上のため評価と修正が無効になりました。不正なジオメトリを返すことがあります。

note: Tag: para
en: Availability: Requires GDAL 1.7 or higher.
ja: Availability: GDAL 1.7以上が必要です。

note: Tag: para
en: If there is a no data value set for a band, pixels with that value will not be returned except in the case of exclude_nodata_value=false.
ja: バンドにNODATA値が設定されている場合には、exclude_nodata_value=falseが設定されている場合を除いて、NODATA値を持つピクセルは返りません。

note: Tag: para
en: If you only care about count of pixels with a given value in a raster, it is faster to use <xref linkend="RT_ST_ValueCount"/>.
ja: ラスタ内の与えられた値を持つピクセルの数にのみ注意する場合には<xref linkend="RT_ST_ValueCount"/>を使う方が速いです。

note: Tag: para
en: This is different than ST_PixelAsPolygons where one geometry is returned for each pixel regardless of pixel value.
ja: これは、ピクセル値にかかわらずピクセルごとに一つのジオメトリを返すST_PixelAsPolygonsと違います。

note: Tag: refpurpose
en: Returns the polygon representation of the extent of the raster.
ja: ラスタの範囲のポリゴン表現を返します。

note: Tag: para
en: Returns the polygon representation of the extent of the raster in spatial coordinate units defined by srid. It is a float8 minimum bounding box represented as a polygon.
ja: SRIDで定義されている空間参照系上でのラスタの範囲のポリゴン表現を返します。ポリゴンで表現されるfloat8の最小バウンディングボックスです。

note: Tag: para
en: The polygon is defined by the corner points of the bounding box ((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MINY</varname>))
ja: ポリゴンはバウンディングボックスの隅のポイント、すなわち ((<varname>MINX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MAXY</varname>), (<varname>MAXX</varname>, <varname>MINY</varname>), (<varname>MINX</varname>, <varname>MINY</varname>))です。

note: Tag: refpurpose
en: Return the convex hull geometry of the raster excluding NODATA pixels.
ja: NODATA値を除いたラスタの凸包ジオメトリを返します。

note: Tag: para
en: Return the convex hull geometry of the raster excluding NODATA pixels. If <varname>nband</varname> is NULL, all bands of the raster are considered.
ja: NODATA値を除いたラスタの凸包ジオメトリを返します。<varname>nband</varname>がNULLの場合には、ラスタの全てのバンドが考慮されます。

note: Tag: refpurpose
en: Returns a multipolygon geometry formed by the union of pixels that have a pixel value that is not no data value. If no band number is specified, band num defaults to 1.
ja: NODATA値でないピクセル値を持つピクセルの結合で形成されるマルチポリゴンジオメトリを返します。バンドを指定しない場合のデフォルトは1です。

note: Tag: para
en: Availability: 0.1.6 Requires GDAL 1.7 or higher.
ja: Availability: 0.1.6 GDAL 1.7以上が必要です。

note: Tag: para
en: Enhanced: 2.1.0 Improved Speed (fully C-Based) and the returning multipolygon is ensured to be valid.
ja: Enhanced: 2.1.0 速度を改善し (完全にC言語で記述しました)、確実に妥当なマルチポリゴンを返すようにしました。

note: Tag: para
en: Changed: 2.1.0 In prior versions would sometimes return a polygon, changed to always return multipolygon.
ja: Changed: 2.1.0 以前の版では、時々ポリゴンを返しましたが、常にマルチポリゴンを返すように変更しました。

note: Tag: title
en: Raster Operators
ja: ラスタ演算子

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box intersects B's bounding box.
ja: AのバウンディングボックスがBのバウンディングボックスとインタセクトする場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>&amp;&amp;</varname> operator returns <varname>TRUE</varname> if the bounding box of raster/geometr A intersects the bounding box of raster/geometr B.
ja: <varname>&amp;&amp;</varname>演算子は、AのバウンディングボックスがBのバウンディングボックスにインタセクトする場合に <varname>TRUE</varname>を返します。

note: Tag: para
en: This operand will make use of any indexes that may be available on the rasters.
ja: これのオペランドは、ラスタで使用できるインデックスを使用します。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is to the left of B's.
ja: AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの左にある場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: The <varname>&amp;&lt;</varname> operator returns <varname>TRUE</varname> if the bounding box of raster A overlaps or is to the left of the bounding box of raster B, or more accurately, overlaps or is NOT to the right of the bounding box of raster B.
ja: <varname>&amp;&lt;</varname>演算子は、AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの左にある場合に<varname>TRUE</varname>を返します。条件についてより詳細に言うと、BのバウンディングボックスをオーバラップするかBのバウンディングボックスの右に*ない*場合です。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is to the right of B's.
ja: AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの右にある場合に <varname>TRUE</varname> を返します。

note: Tag: para
en: The <varname>&amp;&gt;</varname> operator returns <varname>TRUE</varname> if the bounding box of raster A overlaps or is to the right of the bounding box of raster B, or more accurately, overlaps or is NOT to the left of the bounding box of raster B.
ja: <varname>&amp;&gt;</varname>演算子は、AのバウンディングボックスがBのバウンディングボックスをオーバラップするか、Bのバウンディングボックスの右にある場合に<varname>TRUE</varname>を返します。条件についてより詳細に言うと、BのバウンディングボックスをオーバラップするかBのバウンディングボックスの左に*ない*場合です。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is the same as B's. Uses double precision bounding box.
ja: AのバウンディングボックスがBのバウンディングボックスと同じ場合に<varname>TRUE</varname>を返します。倍精度浮動小数点数のバウンディングボックスを使います。

note: Tag: para
en: The <varname>&#61;</varname> operator returns <varname>TRUE</varname> if the bounding box of raster A is the same as the bounding box of raster B. PostgreSQL uses the =, &lt;, and &gt; operators defined for rasters to perform internal orderings and comparison of rasters (ie. in a GROUP BY or ORDER BY clause).
ja: <varname>&#61;</varname>演算子は、AのバウンディングボックスがBのバウンディングボックスと同じ場合に <varname>TRUE</varname> を返します。PostgreSQLは内部でラスタの順序決定や比較 (GROUP BY節やORDER BY節など)を行うためにラスタ用として定義している=, &lt;, &gt;演算子を使用します。

note: Tag: para
en: This operand will NOT make use of any indexes that may be available on the rasters. Use <xref linkend="RT_Raster_Same"/> instead. This operator exists mostly so one can group by the raster column.
ja: これのオペランドは、ラスタで利用できるインデックスを使いません。代わりに<xref linkend="RT_Raster_Same"/>を使います。この演算子はラスタカラムのGROUP BYに使うのがほとんどです。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is contained by B's. Uses double precision bounding box.
ja: AのバウンディングボックスがBのバウンディングボックスに含まれる場合に<varname>TRUE</varname>を返します。倍精度浮動小数点数のバウンディングボックスを使います。

note: Tag: para
en: The <varname>@</varname> operator returns <varname>TRUE</varname> if the bounding box of raster/geometry A is contained by bounding box of raster/geometr B.
ja: <varname>@</varname>は、ラスタまたはジオメトリであるAのバウンディングボックスが、ラスタまたはジオメトリであるBのバウンディングボックスに含まれる場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: This operand will use spatial indexes on the rasters.
ja: これのオペランドは、ラスタのインデックスを使用します。

note: Tag: para
en: Availability: 2.0.0 raster @ raster, raster @ geometry introduced
ja: Availability: 2.0.0 raster @ raster, raster @ geometry が導入されました。

note: Tag: para
en: Availability: 2.0.5 geometry @ raster introduced
ja: Availability: 2.0.5 geometry @ raster が導入されました。

note: Tag: para
en: The <varname>~=</varname> operator returns <varname>TRUE</varname> if the bounding box of raster A is the same as the bounding box of raster B.
ja: <varname>~=</varname>演算子は、AのバウンディングボックスがBのバウンディングボックスと同じ場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: Very useful usecase is for taking two sets of single band rasters that are of the same chunk but represent different themes and creating a multi-band raster
ja: 大変便利な利用局面として、単一バンドを持つラスタ集合が二つあって、これらは同じデータなのに異なる主題を表現する場合で、これらを取って複数バンドのラスタを生成する局面です。

note: Tag: refpurpose
en: Returns <varname>TRUE</varname> if A's bounding box is contains B's. Uses double precision bounding box.
ja: AのバウンディングボックスがBのバウンディングボックスを含む場合に<varname>TRUE</varname>を返します。倍精度浮動小数点数のバウンディングボックスを使います。

note: Tag: para
en: The <varname>~</varname> operator returns <varname>TRUE</varname> if the bounding box of raster/geometry A is contains bounding box of raster/geometr B.
ja: <varname>~</varname>演算子は、ラスタまたはジオメトリであるAのバウンディングボックスがラスタまたはジオメトリであるBのバウンディングボックスを含む場合に<varname>TRUE</varname>を返します。

note: Tag: title
en: Raster and Raster Band Spatial Relationships
ja: ラスタとラスタバンドの空間関係関数

note: Tag: refpurpose
en: Return true if no points of raster rastB lie in the exterior of raster rastA and at least one point of the interior of rastB lies in the interior of rastA.
ja: rastAの外にrastBの点が無く、rastAの内部にrastBの内部の点が一つ以上ある場合にTRUEを返します。

note: Tag: para
en: Raster rastA contains rastB if and only if no points of rastB lie in the exterior of rastA and at least one point of the interior of rastB lies in the interior of rastA. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
ja: rastAの外にrastBの点が無く、rastAの内部にrastBの内部の点が一つ以上ある場合に限って、rastAはrastBを包含しています。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

note: Tag: para
en: This function will make use of any indexes that may be available on the rasters.
ja: この関数はラスタで利用できるインデックスを使用します。

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Contains(ST_Polygon(raster), geometry) or ST_Contains(geometry, ST_Polygon(raster)).
ja: ラスタとジオメトリの空間関係をテストするには、ST_Contains(ST_Polygon(raster), geometry)またはST_Contains(geometry, ST_Polygon(raster))というふうに、ラスタにST_Polygonを使います。

note: Tag: para
en: ST_Contains() is the inverse of ST_Within(). So, ST_Contains(rastA, rastB) implies ST_Within(rastB, rastA).
ja: ST_Contains()はST_Within()の逆です。ST_Contains(rastA, rastB)はST_Within(rastB, rastA)を示します。

note: Tag: refpurpose
en: Return true if rastB intersects the interior of rastA but not the boundary or exterior of rastA.
ja: rastBがrastAの内部でインタセクトし、かつrastAの境界とも外部ともインタセクトしない場合にTRUEを返します。

note: Tag: para
en: Raster rastA contains properly rastB if rastB intersects the interior of rastA but not the boundary or exterior of rastA. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
ja: rastBがrastAの内部でインタセクトし、かつrastAの境界とも外部ともインタセクトしない場合には、rastAはrastBに対してContainsProperly (確実に包含している)です。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

note: Tag: para
en: Raster rastA does not contain properly itself but does contain itself.
ja: rastAは自身にはContainsProperlyではありませんが、Containsです。

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_ContainsProperly(ST_Polygon(raster), geometry) or ST_ContainsProperly(geometry, ST_Polygon(raster)).
ja: ラスタとジオメトリの空間関係をテストするには、ST_ContainsProperly(ST_Polygon(raster), geometry)またはST_ContainsProperly(geometry, ST_Polygon(raster))というふうに、ラスタにST_Polygonを使います。

note: Tag: refpurpose
en: Return true if no points of raster rastB lie outside raster rastA.
ja: rastBがrastAの外部に点を持たない場合にTRUEを返します。

note: Tag: para
en: Raster rastA covers rastB if and only if no points of rastB lie in the exterior of rastA. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
ja: rastAの外部にrastBの点が無い場合には、rastAはrastBに対してCoversです。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Covers(ST_Polygon(raster), geometry) or ST_Covers(geometry, ST_Polygon(raster)).
ja: ラスタとジオメトリの空間関係をテストするには、ST_Covers(ST_Polygon(raster), geometry)またはST_Covers(geometry, ST_Polygon(raster))というふうに、ラスタにST_Polygonを使います。

note: Tag: refpurpose
en: Return true if no points of raster rastA lie outside raster rastB.
ja: rastAがrastBの外部に点を持たない場合にTRUEを返します。

note: Tag: para
en: Raster rastA is covered by rastB if and only if no points of rastA lie in the exterior of rastB. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
ja: rastAがrastBの外部に点を持たない場合には、rastAはrastBに対してCoveredByです。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_CoveredBy(ST_Polygon(raster), geometry) or ST_CoveredBy(geometry, ST_Polygon(raster)).
ja: ラスタとジオメトリの空間関係をテストするには、ST_CoveredBy(ST_Polygon(raster), geometry)またはST_CoveredBy(geometry, ST_Polygon(raster))というふうに、ラスタにST_Polygonを使います。

note: Tag: refpurpose
en: Return true if raster rastA does not spatially intersect rastB.
ja: rastAがrastBとインタセクトしない場合にTRUEを返します。

note: Tag: para
en: Raster rastA and rastB are disjointed if they do not share any space together. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
ja: rastAがrastBとインタセクトしない場合には、rastAとrastBはDisjointです。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

note: Tag: para
en: This function does NOT use any indexes.
ja: この関数はインデックスを*使いません*。

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Disjoint(ST_Polygon(raster), geometry).
ja: ラスタとジオメトリの空間関係をテストするには、ST_Disjoint(ST_Polygon(raster), geometry)というふうに、ラスタにST_Polygonを使います。

note: Tag: refpurpose
en: Return true if raster rastA spatially intersects raster rastB.
ja: rastAがrastBとインタセクトする場合にTRUEを返します。

note: Tag: para
en: Return true if raster rastA spatially intersects raster rastB. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
ja: rastAがrastBとインタセクトする場合にTRUEを返します。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

note: Tag: para
en: Enhanced: 2.0.0 support raster/raster intersects was introduced.
ja: Enhanced: 2.0.0 ラスタ/ラスタのインタセクト対応が導入されました。

note: Tag: para
en: Changed: 2.1.0 The behavior of the ST_Intersects(raster, geometry) variants changed to match that of ST_Intersects(geometry, raster).
ja: Changed: 2.1.0 ST_Intersects(raster, geometry)形式の挙動が ST_Intersects(geometry, raster)とあうように変更されました。

note: Tag: refpurpose
en: Return true if raster rastA and rastB intersect but one does not completely contain the other.
ja: rastAとrastBがインタセクトして、かつ一方がもう一方に完全には包含されない場合にはTRUEを返します。

note: Tag: para
en: Return true if raster rastA spatially overlaps raster rastB. This means that rastA and rastB intersect but one does not completely contain the other. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
ja: rastAがrastBをオーバラップする場合にTRUEを返します。rastAとrastBがインタセクトして、かつ一方がもう一方に完全には包含されない場合にはいう意味です。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Overlaps(ST_Polygon(raster), geometry).
ja: ラスタとジオメトリの空間関係をテストするには、ST_Overlaps(ST_Polygon(raster), geometry)というふうに、ラスタにST_Polygonを使います。

note: Tag: refpurpose
en: Return true if raster rastA and rastB have at least one point in common but their interiors do not intersect.
ja: rastAとrastBが少なくとも一つの共通の点を持ち、かつ二つのラスタの内部同士がインタセクトしない場合にTRUEを返します。

note: Tag: para
en: Return true if raster rastA spatially touches raster rastB. This means that rastA and rastB have at least one point in common but their interiors do not intersect. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
ja: rastAがrastBに接触する場合にTRUEを返します。rastAとrastBが少なくとも一つの共通の点を持ち、かつ二つのラスタの内部同士がインタセクトしないという意味です。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Touches(ST_Polygon(raster), geometry).
ja: ラスタとジオメトリの空間関係をテストするには、ST_Touches(ST_Polygon(raster), geometry)というふうに、ラスタにST_Polygonを使います。

note: Tag: refpurpose
en: Returns true if rasters have same skew, scale, spatial ref, and offset (pixels can be put on same grid without cutting into pixels) and false if they don't with notice detailing issue.
ja: ラスタが同じスキュー、スケール、空間参照系、オフセットを持つ (ピクセルが分割されることなく同じグリッドに置かれている)場合にTRUEを返し、そうでない場合は問題を詳述する通知とともにFALSEを返します。

note: Tag: para
en: Non-Aggregate version (Variants 1 and 2): Returns true if the two rasters (either provided directly or made using the values for upperleft, scale, skew and srid) have the same scale, skew, srid and at least one of any of the four corners of any pixel of one raster falls on any corner of the grid of the other raster. Returns false if they don't and a NOTICE detailing the alignment issue.
ja: 非集計版 (一つ目と二つ目の形式): 二つのラスタ (直接与えたラスタでも左上隅、スケール、スキュー、SRIDを使って作ったものでも)が同じスキュー、スケール、空間参照系、を持ち、少なくとも4隅の一つがもう一方のラスタのグリッド隅に落ちる場合にTRUEを返します。そうでない場合には、問題に言及した警告を出します。

note: Tag: para
en: Aggregate version (Variant 3): From a set of rasters, returns true if all rasters in the set are aligned. The ST_SameAlignment() function is an "aggregate" function in the terminology of PostgreSQL. That means that it operates on rows of data, in the same way the SUM() and AVG() functions do.
ja: 集約関数版 (三つ目の形式): ラスタ集合から、全てのラスタが同じアラインメントを持つ場合にTRUEを返します。ST_SameAlignment()関数はPostgreSQLの用語で言うところの「集約」関数です。SUM()やAVG()といった複数のデータ行での操作を意味します。

note: Tag: para
en: Enhanced: 2.1.0 addition of Aggegrate variant
ja: Enhanced: 2.1.0 集約関数版の追加

note: Tag: title
en: Examples: Rasters
ja: 例: ラスタ

note: Tag: refpurpose
en: <refpurpose>Returns text stating if rasters are aligned and if not aligned, a reason why.</refpurpose>
ja: <refpurpose>ラスタが同じアラインメントを持つかどうか、また、持たない場合にはその理由を示す文字列を返します。</refpurpose>

note: Tag: para
en: <para>Returns text stating if rasters are aligned and if not aligned, a reason why.</para>
ja: <para>ラスタが同じアラインメントを持つかどうか、また、持たない場合にはその理由を示す文字列を返します。</para>

note: Tag: para
en: If there are several reasons why the rasters are not aligned, only one reason (the first test to fail) will be returned.
ja: ラスタが同じアラインメントを持たない理由が複数ある場合には、一つだけ （最初のテストで失敗した)理由を返します。

note: Tag: refpurpose
en: Return true if no points of raster rastA lie in the exterior of raster rastB and at least one point of the interior of rastA lies in the interior of rastB.
ja: rastAがrastBの外部に点を持たず、rastAの内部の少なくとも一つの点がrastBの内部にある場合にTRUEを返します。

note: Tag: para
en: Raster rastA is within rastB if and only if no points of rastA lie in the exterior of rastB and at least one point of the interior of rastA lies in the interior of rastB. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
ja: rastAがrastBの外部に点を持たず、rastAの内部の少なくとも一つの点がrastBの内部にある場合にrastAはrastBに対してWithinです。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_Within(ST_Polygon(raster), geometry) or ST_Within(geometry, ST_Polygon(raster)).
ja: ラスタとジオメトリの空間関係をテストするには、ST_Within(ST_Polygon(raster), geometry)またはST_Within(geometry, ST_Polygon(raster))というふうに、ラスタにST_Polygonを使います。

note: Tag: para
en: ST_Within() is the inverse of ST_Contains(). So, ST_Within(rastA, rastB) implies ST_Contains(rastB, rastA).
ja: ST_Within()はST_Contains()の逆です。ST_Within(rastA, rastB)はST_Contains(rastB, rastA)を示します。

note: Tag: refpurpose
en: Return true if rasters rastA and rastB are within the specified distance of each other.
ja: rastAとrastBが指定した距離内にある場合にTRUEを返します。

note: Tag: para
en: Return true if rasters rastA and rastB are within the specified distance of each other. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
ja: rastAとrastBが指定した距離内にある場合にTRUEを返します。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

note: Tag: para
en: The distance is specified in units defined by the spatial reference system of the rasters. For this function to make sense, the source rasters must both be of the same coordinate projection, having the same SRID.
ja: distanceはラスタの空間参照系で定義される単位です。この関数が意味あるものにするには、元のラスタが両方とも同じ空間参照系である、つまり同じSRIDを持たなければなりません。

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_DWithin(ST_Polygon(raster), geometry).
ja: ラスタとジオメトリの空間関係をテストするには、ST_DWithin(ST_Polygon(raster), geometry)というふうに、ラスタにST_Polygonを使います。

note: Tag: refpurpose
en: Return true if rasters rastA and rastB are fully within the specified distance of each other.
ja: rastAとrastBが指定した距離内に完全に収まる場合にTRUEを返します。

note: Tag: para
en: Return true if rasters rastA and rastB are fully within the specified distance of each other. If the band number is not provided (or set to NULL), only the convex hull of the raster is considered in the test. If the band number is provided, only those pixels with value (not NODATA) are considered in the test.
ja: rastAとrastBが指定した距離内に完全に収まる場合にTRUEを返します。バンド番号が指定されていないかNULLに指定されている場合には、ラスタの凸包のみを考慮してテストします。バンド番号が指定されている場合には、値を持つ (NODATAでない)ピクセルについてテストします。

note: Tag: para
en: To test the spatial relationship of a raster and a geometry, use ST_Polygon on the raster, e.g. ST_DFullyWithin(ST_Polygon(raster), geometry).
ja: ラスタとジオメトリの空間関係をテストするには、ST_DFullyWithin(ST_Polygon(raster), geometry)というふうに、ラスタにST_Polygonを使います。

note: Tag: title
en: Raster Tips
ja: ラスタに関する技法

note: Tag: para
en: This section documents various gotchas and tips related to PostGIS Raster.
ja: 本節では、PostGISラスタに関連する様々な落とし穴や技法について説明します。

note: Tag: title
en: Out-DB Rasters
ja: データベース外ラスタ

note: Tag: title
en: Directory containing many files
ja: 多数のファイルを持つディレクトリ

note: Tag: para
en: When GDAL opens a file, GDAL eagerly scans the directory of that file to build a catalog of other files. If this directory contains many files (e.g. thousands, millions), opening that file becomes extremely slow (especially if that file happens to be on a network drive such as NFS).
ja: GDALはファイルを開く時に、そのファイルのディレクトリを熱心にスキャンして、他のファイルのカタログを構築します。このディレクトリに多数のファイル (千とか万とか)あるとします。一つのファイルを開くと動作が非常に遅くなります (特にNFSのようなネットワークドライブの場合)。

note: Tag: para
en: To control this behavior, GDAL provides the following environment variable: <link xlink:href="https://trac.osgeo.org/gdal/wiki/ConfigOptions#GDAL_DISABLE_READDIR_ON_OPEN">GDAL_DISABLE_READDIR_ON_OPEN</link>. Set <varname>GDAL_DISABLE_READDIR_ON_OPEN</varname> to <varname>TRUE</varname> to disable directory scanning.
ja: この振る舞いを制御するために、GDALには<link xlink:href="https://trac.osgeo.org/gdal/wiki/ConfigOptions#GDAL_DISABLE_READDIR_ON_OPEN">GDAL_DISABLE_READDIR_ON_OPEN</link>という環境変数があります。<varname>GDAL_DISABLE_READDIR_ON_OPEN</varname>を<varname>TRUE</varname>に設定すると、ディレクトリのスキャンを無効にします。

note: Tag: para
en: In Ubuntu (and assuming you are using PostgreSQL's packages for Ubuntu), <varname>GDAL_DISABLE_READDIR_ON_OPEN</varname> can be set in <emphasis>/etc/postgresql/POSTGRESQL_VERSION/CLUSTER_NAME/environment</emphasis> (where POSTGRESQL_VERSION is the version of PostgreSQL, e.g. 9.6 and CLUSTER_NAME is the name of the cluster, e.g. maindb). You can also set PostGIS environment variables here as well.
ja: Ubuntuでは (Ubuntu用PostgreSQLのパッケージを使っていると仮定します)、<varname>GDAL_DISABLE_READDIR_ON_OPEN</varname>が<emphasis>/etc/postgresql/POSTGRESQL_VERSION/CLUSTER_NAME/environment</emphasis>内で設定できます (POSTGRESQL_VERSIONは9.6等のPostgreSQLのバージョンで、CLUSTER_NAMEはmaindb等のクラスタ名です)。PostGIS環境変数もここで同じく設定できます。

note: Tag: title
en: Maximum Number of Open Files
ja: 開くことができるファイルの最大数

note: Tag: para
en: The maximum number of open files permitted by Linux and PostgreSQL are typically conservative (typically 1024 open files per process) given the assumption that the system is consumed by human users. For Out-DB Rasters, a single valid query can easily exceed this limit (e.g. a dataset of 10 year's worth of rasters with one raster for each day containing minimum and maximum temperatures and we want to know the absolute min and max value for a pixel in that dataset).
ja: LinuxとPostgreSQLが許している、開くことができるファイルの最大数は、通常は増加していません (通常、プロセスあたり1024ファイルです)。システムは人間のユーザが使用するという仮定に立っているからです。データベース外ラスタは、一つの妥当なクエリで簡単に制限超過させることができます (例えば、10年分のラスタからなるデータセットで、個々のラスタは日別最低気温、最大気温を持っていて、データセット内の最大値と最小値を得たい場合などです)。

note: Tag: para
en: The easiest change to make is the following PostgreSQL setting: <link xlink:href="https://www.postgresql.org/docs/current/static/runtime-config-resource.html#GUC-MAX-FILES-PER-PROCESS">max_files_per_process</link>. The default is set to 1000, which is far too low for Out-DB Rasters. A safe starting value could be 65536 but this really depends on your datasets and the queries run against those datasets. This setting can only be made on server start and probably only in the PostgreSQL configuration file (e.g. <emphasis>/etc/postgresql/POSTGRESQL_VERSION/CLUSTER_NAME/postgresql.conf</emphasis> in Ubuntu environments).
ja: 最も簡単な変更方法は、PostgreSQL設定<link xlink:href="https://www.postgresql.org/docs/current/static/runtime-config-resource.html#GUC-MAX-FILES-PER-PROCESS">max_files_per_process</link>です。デフォルトとして1000が設定されていますが、データベース外ラスタとしては非常に低い値です。安全な開始値は65536でしょう。ただし、実際には、これはデータベースとデータベースに対して実行されるクエリに依存します。サーバ開始時のみ、かつPostgreSQLコンフィギュレーションファイル (例: Ubuntu環境では<emphasis>/etc/postgresql/POSTGRESQL_VERSION/CLUSTER_NAME/postgresql.conf</emphasis>)内のみで設定できます。

note: Tag: para
en: The major change to make is the Linux kernel's open files limits. There are two parts to this:
ja: 主な変更はLinuxカーネルのファイルを開く制限です。次の通り、二つに分かれます:

note: Tag: para
en: <para>Maximum number of open files for the entire system</para>
ja: <para>システム全体で開くことができるファイルの最大数</para>

note: Tag: para
en: <para>Maximum number of open files per process</para>
ja: <para>プロセスごとに開くことができるファイルの最大数</para>

note: Tag: title
en: <title>Maximum number of open files for the entire system</title>
ja: <title>システム全体で開くことができるファイルの最大数</title>

note: Tag: para
en: You can inspect the current maximum number of open files for the entire system with the following example:
ja: 次の例で、システム全体の、現在の開くことができるファイルの最大値を調べることができます:

note: Tag: para
en: If the value returned is not large enough, add a file to <emphasis>/etc/sysctl.d/</emphasis> as per the following example:
ja: 返された値が十分には大きくない場合には、次に示す例に従って、<emphasis>/etc/sysctl.d/</emphasis>にファイルを追加します。

note: Tag: title
en: <title>Maximum number of open files per process</title>
ja: <title>プロセスごとの開けるファイルの最大数</title>

note: Tag: para
en: We need to increase the maximum number of open files per process for the PostgreSQL server processes.
ja: PostgreSQLのサーバプロセスごとに開けるファイルの最大数を増やす必要があります。

note: Tag: para
en: To see what the current PostgreSQL service processes are using for maximum number of open files, do as per the following example (make sure to have PostgreSQL running):
ja: 現在のPostgreSQLサービスのプロセスは開くことができるファイルの最大数を使っていて、次の例のようになっています (PostgreSQLが実行されていることを確認して下さい)。

note: Tag: para
en: In the example above, we inspected the open files limit for Process 31718. It doesn't matter which PostgreSQL process, any of them will do. The response we are interested in is <emphasis>Max open files</emphasis>.
ja: 上の例では、プロセスに対する開くことができるファイルの制限が31718になっています。どのプロセスがどうするかは問題ではありません。関心を持っている応答は<emphasis>Max open files</emphasis>です。

note: Tag: para
en: We want to increase <emphasis>Soft Limit</emphasis> and <emphasis>Hard Limit</emphasis> of <emphasis>Max open files</emphasis> to be greater than the value we specified for the PostgreSQL setting <varname>max_files_per_process</varname>. In our example, we set <varname>max_files_per_process</varname> to 65536.
ja: <emphasis>Max open files</emphasis>の<emphasis>Soft Limit</emphasis>と<emphasis>Hard Limit</emphasis>をPostgreSQLの設定で指定した<varname>max_files_per_process</varname>よりも多くなるようにしたいと思っています。この例では、<varname>max_files_per_process</varname>を65536にしています。

note: Tag: para
en: In Ubuntu (and assuming you are using PostgreSQL's packages for Ubuntu), the easiest way to change the <emphasis>Soft Limit</emphasis> and <emphasis>Hard Limit</emphasis> is to edit <emphasis role="strong">/etc/init.d/postgresql</emphasis> (SysV) or <emphasis role="strong">/lib/systemd/system/postgresql*.service</emphasis> (systemd).
ja: Ubuntu (かつ、Ubuntu用PostgreSQLパッケージを使用しているものとします)では、<emphasis>Soft Limit</emphasis>と<emphasis>Hard Limit</emphasis>の変更については、<emphasis role="strong">/etc/init.d/postgresql</emphasis> (SysV)または<emphasis role="strong">/lib/systemd/system/postgresql*.service</emphasis> (systemd)を編集するのが簡単な方法です。

note: Tag: para
en: Let's first address the SysV Ubuntu case where we add <emphasis role="strong">ulimit -H -n 262144</emphasis> and <emphasis role="strong">ulimit -n 131072</emphasis> to <emphasis role="strong">/etc/init.d/postgresql</emphasis>.
ja: まず、SysV Ubuntuを扱います。<emphasis role="strong">ulimit -H -n 262144</emphasis>と<emphasis role="strong">ulimit -n 131072</emphasis>を<emphasis role="strong">/etc/init.d/postgresql</emphasis>に追加します。

note: Tag: para
en: Now to address the systemd Ubuntu case. We will add <emphasis role="strong">LimitNOFILE=131072</emphasis> to every <emphasis role="strong">/lib/systemd/system/postgresql*.service</emphasis> file in the <emphasis role="strong">[Service]</emphasis> section.
ja: Ubuntuのsystemdを扱います。<emphasis role="strong">LimitNOFILE=131072</emphasis>を<emphasis role="strong">/lib/systemd/system/postgresql*.service</emphasis>の各ファイルの<emphasis role="strong">[Service]</emphasis>セクション内に記述します。

note: Tag: para
en: After making the necessary systemd changes, make sure to reload the daemon
ja: 必要なシステムの変更を行った後、デーモンのリロードを必ず行ってください。

note: Tag: title
en: Spatial Relationships
ja: 空間関係関数

note: Tag: para
en: These functions determine spatial relationships between geometries.
ja: これらの関数は、ジオメトリ間の空間的な関係を判定します。

note: Tag: title
en: Topological Relationships
ja: トポロジ関係関数

note: Tag: refpurpose
en: Tests if two geometries spatially intersect in 3D - only for points, linestrings, polygons, polyhedral surface (area)
ja: 二つのジオメトリが3次元空間において空間的にインタセクトするかどうかをテストします。ポイント、ラインストリング、ポリゴン、多面体サーフェス (面)についてのみ動作します。

note: Tag: para
en: Overlaps, Touches, Within all imply spatial intersection. If any of the aforementioned returns true, then the geometries also spatially intersect. Disjoint implies false for spatial intersection.
ja: オーバラップ、接触、包含は全て、ジオメトリがインタセクトしていることを意味しています。これらがTRUEを返す場合は、空間的にインタセクトしています。非接続は、空間インタセクトについてFALSEとなります。

note: Tag: para
en: Because of floating robustness failures, geometries don't always intersect as you'd expect them to after geometric processing. For example the closest point on a linestring to a geometry may not lie on the linestring. For these kind of issues where a distance of a centimeter you want to just consider as intersecting, use <xref linkend="ST_3DDWithin"/>.
ja: 浮動小数点数のロバスト性の障害のため、ジオメトリ処理後に期待するようなインタセクトが常にあるわけではないことになります。たとえば、ジオメトリに対するラインストリング上の最接近点がラインストリング上に無いことがあります。インタセクトと考えたいのにセンチメートル程度の距離があると、この問題は発生しますが、この種の問題への対応には、<xref linkend="ST_3DDWithin"/>を使います。

note: Tag: para
en: Changed: 3.0.0 SFCGAL backend removed, GEOS backend supports TINs.
ja: Changed: 3.0.0 SFCGALバックエンドが削除され、GEOSバックエンドではTINに対応しました。

note: Tag: title
en: TIN Examples
ja: TINの例

note: Tag: refpurpose
en: Tests if every point of B lies in A, and their interiors have a point in common
ja: Bの全てのポイントがA内にあり、かつ、双方の内部に共有点が存在するかどうかをテストします。

note: Tag: para
en: Returns TRUE if geometry A contains geometry B. A contains B if and only if all points of B lie inside (i.e. in the interior or boundary of) A (or equivalently, no points of B lie in the exterior of A), and the interiors of A and B have at least one point in common.
ja: ジオメトリAがジオメトリBを含む場合にはTRUEを返します。AがBを含むというのは、Bのポイントの全てがAの内側 (つまりAの内部または境界)にあり (Aの外部にBのポイントが全くないとも言えます)、かつBの内部の少なくとも一つのポイントがAの内部にある場合に限ります。

note: Tag: para
en: In mathematical terms: <emphasis>ST_Contains(A, B) ⇔ (A ⋂ B = B) ∧ (Int(A) ⋂ Int(B) ≠ ∅) </emphasis>
ja: 数学用語では: <emphasis>ST_Contains(A, B) ⇔ (A ⋂ B = B) ∧ (Int(A) ⋂ Int(B) ≠ ∅) </emphasis>

note: Tag: para
en: The contains relationship is reflexive: every geometry contains itself. (In contrast, in the <xref linkend="ST_ContainsProperly"/> predicate a geometry does <emphasis>not</emphasis> properly contain itself.) The relationship is antisymmetric: if <code>ST_Contains(A,B) = true</code> and <code>ST_Contains(B,A) = true</code>, then the two geometries must be topologically equal (<code>ST_Equals(A,B) = true</code>).
ja: 包含関係は反射関係です。あらゆるジオメトリは自己を包含します (対照的に<xref linkend="ST_ContainsProperly"/>述語内ではジオメトリは確実な包含には<emphasis>なりません</emphasis>)。また、包含関係は非対称です。<code>ST_Contains(A,B) = true</code>かつ<code>ST_Contains(B,A) = true</code>の場合には、二つのジオメトリはトポロジ的に等価です (<code>ST_Equals(A,B) = true</code>)。

note: Tag: para
en: ST_Contains is the converse of <xref linkend="ST_Within"/>. So, <code>ST_Contains(A,B) = ST_Within(B,A)</code>.
ja: ST_Containsは<xref linkend="ST_Within"/>の反対です。<code>ST_Contains(A,B) = ST_Within(B,A)</code>となります。

note: Tag: para
en: Because the interiors must have a common point, a subtlety of the definition is that polygons and lines do <emphasis>not</emphasis> contain lines and points lying fully in their boundary. For further details see <link xlink:href="http://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html">Subtleties of OGC Covers, Contains, Within</link>. The <xref linkend="ST_Covers"/> predicate provides a more inclusive relationship.
ja: 内部が必ず共通の点を持たなければならないので、定義の微妙な点は、ポリゴンとラインが境界であるラインとポイントを<emphasis>含まない</emphasis>ことです。詳細については、<link xlink:href="http://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html">Subtleties of OGC Covers, Contains, Within</link>をご覧下さい。<xref linkend="ST_Covers"/>述語は、より包括的な関係を提供します。

note: Tag: para
en: &index_aware; To avoid index use, use the function <function>_ST_Contains</function>.
ja: &index_aware; インデックスの使用を避けるには<function>_ST_Contains</function>関数を使います。

note: Tag: para
en: Enhanced: 2.3.0 Enhancement to PIP short-circuit extended to support MultiPoints with few points. Prior versions only supported point in polygon.
ja: Enhanced: 2.3.0 PIP short-circuit (ポリゴンとポイントに限定した高速判定)を少ないポイントからなるマルチポイントに対応することができるよう拡張しました。以前の版ではポリゴンとポイントの組み合わせにだけ対応していました。

note: Tag: para
en: Enhanced: 3.0.0 enabled support for <varname>GEOMETRYCOLLECTION</varname>
ja: Enhanced: 3.0.0 <varname>GEOMETRYCOLLECTION</varname>への対応が可能となりました

note: Tag: para
en: Do not use this function with invalid geometries. You will get unexpected results.
ja: この関数を不正なジオメトリで呼ばないでください。予期しない結果が返されます。

note: Tag: para
en: NOTE: this is the "allowable" version that returns a boolean, not an integer.
ja: ご注意: これは論理値を返して整数を返さないのが「許される」版です。

note: Tag: para
en: &sfs_compliant; s2.1.1.2 // s2.1.13.3 - same as within(geometry B, geometry A)
ja: &sfs_compliant; s2.1.1.2 // s2.1.13.3 - within(geometry B, geometry A)と同じ

note: Tag: para
en: <function>ST_Contains</function> returns <varname>TRUE</varname> in the following situations:
ja: 次に示す図全てで、<function>ST_Contains</function>は<varname>TRUE</varname>を返します。

note: Tag: para
en: <function>ST_Contains</function> returns <varname>FALSE</varname> in the following situations:
ja: 次に示す状況では<function>ST_Contains</function>は<varname>FALSE</varname>を返します。

note: Tag: para
en: Due to the interior intersection condition <function>ST_Contains</function> returns <varname>FALSE</varname> in the following situations (whereas <function>ST_Covers</function> returns <varname>TRUE</varname>):
ja: 次に示す状況にあっては、内部のインタセクトの状態のために (<function>ST_Covers</function>だと<varname>TRUE</varname>を返すのに)<function>ST_Contains</function>は<varname>FALSE</varname>を返します。

note: Tag: refpurpose
en: Tests if every point of B lies in the interior of A
ja: Bの全てのポイントがAの内部にあるかをテストします。

note: Tag: para
en: Returns <varname>true</varname> if every point of B lies in the interior of A (or equivalently, no point of B lies in the the boundary or exterior of A).
ja: Bの全てのポイントがAの内部にある (もしくはBのポイントでAの外部にあるポイントが無い)場合に<varname>TRUE</varname>を返します。

note: Tag: para
en: In mathematical terms: <emphasis>ST_ContainsProperly(A, B) ⇔ Int(A) ⋂ B = B </emphasis>
ja: 数学用語では: <emphasis>ST_ContainsProperly(A, B) ⇔ Int(A) ⋂ B = B </emphasis>

note: Tag: para
en: A contains B properly if the DE-9IM Intersection Matrix for the two geometries matches [T**FF*FF*]
ja: 二つのジオメトリのDE-9IM交差行列が[T**FF*FF*]に合致する場合には、AがBを完全に含みます。

note: Tag: para
en: A does not properly contain itself, but does contain itself.
ja: Aは自身を正しく含むことはありませんが、自身を含みます。

note: Tag: para
en: A use for this predicate is computing the intersections of a set of geometries with a large polygonal geometry. Since intersection is a fairly slow operation, it can be more efficient to use containsProperly to filter out test geometries which lie fully inside the area. In these cases the intersection is known a priori to be exactly the original test geometry.
ja: 大きいポリゴンジオメトリでのジオメトリの集合のインタセクションを計算する際にこの述語を使います。インタセクションはかなり遅いので、ContainsProperlyを使って、対象ジオメトリのうち全体が領域内にあるものを抜き出すことができ、効率的になります。これらの場面では、インタセクションは確実に元の対象ジオメトリであることが直感的に分かります。

note: Tag: para
en: &index_aware; To avoid index use, use the function <function>_ST_ContainsProperly</function>.
ja: &index_aware; インデックスの使用を避けるには<function>_ST_ContainsProperly</function>関数を使います。

note: Tag: para
en: The advantage of this predicate over <xref linkend="ST_Contains"/> and <xref linkend="ST_Intersects"/> is that it can be computed more efficiently, with no need to compute topology at individual points.
ja: この関数は、個々のポイントでトポロジを計算する必要が無く、より効率的に計算できる点で、<xref linkend="ST_Contains"/>と<xref linkend="ST_Intersects"/>より優れています。

note: Tag: refpurpose
en: Tests if every point of A lies in B
ja: Aの全てのポイントがB内にあるかをテストします。

note: Tag: para
en: Returns <varname>true</varname> if every point in Geometry/Geography A lies inside (i.e. intersects the interior or boundary of) Geometry/Geography B. Equivalently, tests that no point of A lies outside (in the exterior of) B.
ja: ジオメトリ/ジオグラフィAの全ての点がジオメトリ/ジオグラフィBの内側にある (つまりBの境界か内部とインタセクトする)場合に<varname>TRUE</varname>を返します。AにBの外側にある (Bの外部にある)点が無いかどうかをテストする、と言い換えられます。

note: Tag: para
en: In mathematical terms: <emphasis>ST_CoveredBy(A, B) ⇔ A ⋂ B = A </emphasis>
ja: 数学用語では: <emphasis>ST_CoveredBy(A, B) ⇔ A ⋂ B = A </emphasis>

note: Tag: para
en: ST_CoveredBy is the converse of <xref linkend="ST_Covers"/>. So, <code>ST_CoveredBy(A,B) = ST_Covers(B,A)</code>.
ja: ST_CoveredByは<xref linkend="ST_Covers"/>の反対です。<code>ST_CoveredBy(A,B) = ST_Covers(B,A)</code>となります。

note: Tag: para
en: Generally this function should be used instead of <xref linkend="ST_Within"/>, since it has a simpler definition which does not have the quirk that "boundaries are not within their geometry".
ja: 一般に、この関数は<xref linkend="ST_Within"/>の代わりに使います。「境界がジオメトリの内側に無い」という奇妙な言葉が定義に含まれないためです。

note: Tag: para
en: &index_aware; To avoid index use, use the function <function>_ST_CoveredBy</function>.
ja: &index_aware; インデックスの使用を避けるには<function>_ST_CoveredBy</function>関数を使います。

note: Tag: para
en: Not an OGC standard, but Oracle has it too.
ja: これはOGC標準と違いますがOracleは持っています。

note: Tag: refpurpose
en: Tests if every point of B lies in A
ja: Bの全ての点がA内にあるかをテストします。

note: Tag: para
en: Returns <varname>true</varname> if every point in Geometry/Geography B lies inside (i.e. intersects the interior or boundary of) Geometry/Geography A. Equivalently, tests that no point of B lies outside (in the exterior of) A.
ja: ジオメトリ/ジオグラフィBの全てのポイントがジオメトリ/ジオグラフィAの内側にある (内部または境界とインタセクトする)場合に<varname>TRUE</varname>を返します。Aの外部にBの点が無いことと等価です。

note: Tag: para
en: In mathematical terms: <emphasis>ST_Covers(A, B) ⇔ A ⋂ B = B </emphasis>
ja: 数学用語では: <emphasis>ST_Covers(A, B) ⇔ A ⋂ B = B </emphasis>

note: Tag: para
en: ST_Covers is the converse of <xref linkend="ST_CoveredBy"/>. So, <code>ST_Covers(A,B) = ST_CoveredBy(B,A)</code>.
ja: ST_Covers は<xref linkend="ST_CoveredBy"/>の逆です。<code>ST_Covers(A,B) = ST_CoveredBy(B,A)</code>となります。

note: Tag: para
en: Generally this function should be used instead of <xref linkend="ST_Contains"/>, since it has a simpler definition which does not have the quirk that "geometries do not contain their boundary".
ja: 一般に、この関数は<xref linkend="ST_Contains"/>の代わりに使われるべきものです。定義が「ジオメトリがその境界を含まない」という奇妙なものになっていないからです。

note: Tag: para
en: &index_aware; To avoid index use, use the function <function>_ST_Covers</function>.
ja: &index_aware; インデックスの使用を避けるには<function>_ST_Covers</function>関数を使います。

note: Tag: para
en: Enhanced: 2.4.0 Support for polygon in polygon and line in polygon added for geography type
ja: Enhanced: 2.4.0 ジオグラフィ型を使う形式においてポリゴンの中のポリゴンとポリゴンの中のラインストリングへの対応を追加

note: Tag: para
en: Enhanced: 2.3.0 Enhancement to PIP short-circuit for geometry extended to support MultiPoints with few points. Prior versions only supported point in polygon.
ja: Enhanced: 2.3.0 ジオメトリについて、PIP short-circuit (ポリゴンとポイントに限定した高速判定)を少ないポイントからなるマルチポイントに対応することができるよう拡張しました。以前の版ではポリゴンとポイントの組み合わせにだけ対応していました。

note: Tag: para
en: Geometry example
ja: ジオメトリの例

note: Tag: para
en: Geeography Example
ja: ジオグラフィの例

note: Tag: refpurpose
en: Tests if two geometries have some, but not all, interior points in common
ja: 二つのジオメトリが内部に共有ポイントを持ち、かつそれだけにならないようになっているかテストします。

note: Tag: para
en: Compares two geometry objects and returns <varname>true</varname> if their intersection "spatially crosses"; that is, the geometries have some, but not all interior points in common. The intersection of the interiors of the geometries must be non-empty and must have dimension less than the maximum dimension of the two input geometries, and the intersection of the two geometries must not equal either geometry. Otherwise, it returns <varname>false</varname>. The crosses relation is symmetric and irreflexive.
ja: 二つのジオメトリを比較して、「空間的にクロスしている」場合に<varname>TRUE</varname>を返します。ジオメトリは内部の共通点をいくつか持っていますが、全て持っているわけではありません。ジオメトリの内部の共通部分は空ではなく、二つのジオメトリの最大図形次元より小さくなければなりません。二つのジオメトリの共通部分は、入力ジオメトリのいずれとも同じであってはなりません。クロスでないなら<varname>FALSE</varname>を返します。クロスの関係は対称ですが無反射です。

note: Tag: para
en: In mathematical terms: <emphasis>ST_Crosses(A, B) ⇔ (dim( Int(A) ⋂ Int(B) ) &lt; max( dim( Int(A) ), dim( Int(B) ) )) ∧ (A ⋂ B ≠ A) ∧ (A ⋂ B ≠ B) </emphasis>
ja: 数学用語では: <emphasis>ST_Crosses(A, B) ⇔ (dim( Int(A) ⋂ Int(B) ) &lt; max( dim( Int(A) ), dim( Int(B) ) )) ∧ (A ⋂ B ≠ A) ∧ (A ⋂ B ≠ B) </emphasis>

note: Tag: para
en: Geometries cross if their DE-9IM Intersection Matrix matches:
ja: DE-9IM交差行列が次の通り合致するとジオメトリはクロスしています:

note: Tag: para
en: <code>T*T******</code> for Point/Line, Point/Area, and Line/Area situations
ja: Point/Line, Point/Area, Line/Areaの場合には<code>T*T******</code>

note: Tag: para
en: <code>T*****T**</code> for Line/Point, Area/Point, and Area/Line situations
ja: Line/Point, Area/Point, Area/Lineの場合には<code>T*****T**</code>

note: Tag: para
en: <code>0********</code> for Line/Line situations
ja: Line/Lineの場合には<code>0********</code>

note: Tag: para
en: the result is <varname>false</varname> for Point/Point and Area/Area situations
ja: 点/点の状況や面/面の状況では、結果は<varname>FALSE</varname>です

note: Tag: para
en: The OpenGIS Simple Features Specification defines this predicate only for Point/Line, Point/Area, Line/Line, and Line/Area situations. JTS / GEOS extends the definition to apply to Line/Point, Area/Point and Area/Line situations as well. This makes the relation symmetric.
ja: OpenGIS Simple Feature Specificationでは、この述語はPoint/Line, Point/Area, Line/Line, Line/Areaの場合についてのみ定義されています。JTS/GEOSでは、Line/Point, Area/Point, Area/Lineについて拡張しています。これによって関係が対称になっています。

note: Tag: para
en: The following situations all return <varname>true</varname>.
ja: 次の場合には全て<varname>TRUE</varname>を返します。

note: Tag: para
en: Consider a situation where a user has two tables: a table of roads and a table of highways.
ja: roads (道路)とhighways (高速道路)の2つのテーブルを持っている場面を考えます。

note: Tag: para
en: To determine a list of roads that cross a highway, use a query similar to:
ja: 次のようなクエリを使って、highwayとクロスするroadsのリストを決定します。

note: Tag: refpurpose
en: Tests if two geometries have no points in common
ja: 二つのジオメトリが共有点を持たないようになっているかテストします。

note: Tag: para
en: Returns <varname>true</varname> if two geometries are disjoint. Geometries are disjoint if they have no point in common.
ja: 二つのジオメトリが接続されていない場合に<varname>TRUE</varname>を返します。ジオメトリに共有点が全くない場合を指します。

note: Tag: para
en: If any other spatial relationship is true for a pair of geometries, they are not disjoint. Disjoint implies that <xref linkend="ST_Intersects"/> is false.
ja: 二つのジオメトリが他の空間関係がTRUEである場合には接続されていない状況にはありません。接続されていない場合にあｈ<xref linkend="ST_Intersects"/>はFALSEを返します。

note: Tag: para
en: In mathematical terms: <emphasis>ST_Disjoint(A, B) ⇔ A ⋂ B = ∅ </emphasis>
ja: 数学用語では: <emphasis>ST_Disjoint(A, B) ⇔ A ⋂ B = ∅ </emphasis>

note: Tag: para
en: This function call does not use indexes. A negated <xref linkend="ST_Intersects"/> predicate can be used as a more performant alternative that uses indexes: <code>ST_Disjoint(A,B) = NOT ST_Intersects(A,B)</code>
ja: この関数呼び出しはインデックスを使いません。<xref linkend="ST_Intersects"/>の否定には、インデックスを使用する、より効率の良い選択肢を使うことができます: <code>ST_Disjoint(A,B) = NOT ST_Intersects(A,B)</code>

note: Tag: refpurpose
en: Tests if two geometries include the same set of points
ja: 二つのジオメトリが同じ点集合になっているかテストします。

note: Tag: para
en: Returns <varname>true</varname> if the given geometries are "topologically equal". Use this for a 'better' answer than '='. Topological equality means that the geometries have the same dimension, and their point-sets occupy the same space. This means that the order of vertices may be different in topologically equal geometries. To verify the order of points is consistent use <xref linkend="ST_OrderingEquals"/> (it must be noted ST_OrderingEquals is a little more stringent than simply verifying order of points are the same).
ja: ジオメトリが「トポロジ的に等価である」場合に<varname>TRUE</varname>を返します。'='より良い答を得るのに使います。トポロジ的に等価であるとは、ジオメトリが同じ図形次元で、点集合が同じ空間を占めていることを指します。頂点の順位が同じでなくても構いません。ポイントの順序の確認には一貫して<xref linkend="ST_OrderingEquals"/>を使います (ST_OrderingEqualsは、単純なポイントの順序が同じであるかを確認するより多少厳しいです)。

note: Tag: para
en: In mathematical terms: <emphasis>ST_Equals(A, B) ⇔ A = B </emphasis>
ja: 数学用語では: <emphasis>ST_Equals(A, B) ⇔ A = B </emphasis>

note: Tag: para
en: The following relation holds: <emphasis>ST_Equals(A, B) ⇔ ST_Within(A,B) ∧ ST_Within(B,A) </emphasis>
ja: 次の関係が成り立ちます: <emphasis>ST_Equals(A, B) ⇔ ST_Within(A,B) ∧ ST_Within(B,A) </emphasis>

note: Tag: para
en: Changed: 2.2.0 Returns true even for invalid geometries if they are binary equal
ja: Changed: 2.2.0 この関数は、どちらのジオメトリも不正であっても、バイナリで同じ場合ならTRUEを返します。

note: Tag: refpurpose
en: Tests if two geometries intersect (they have at least one point in common)
ja: 二つのジオメトリがインタセクトしている (少なくとも一つの共有点がある)かどうかテストします。

note: Tag: para
en: Returns <varname>true</varname> if two geometries intersect. Geometries intersect if they have any point in common.
ja: 二つのジオメトリがインタセクトする場合に<varname>TRUE</varname>を返します。任意の共有点を持つ場合を指します。

note: Tag: para
en: For geography, a distance tolerance of 0.00001 meters is used (so points that are very close are considered to intersect).
ja: ジオグラフィに対しては、0.00001メートルの距離許容値が使われます (このため非常に近いポイントはインタセクトしているとみなされます)。

note: Tag: para
en: In mathematical terms: <emphasis>ST_Intersects(A, B) ⇔ A ⋂ B ≠ ∅ </emphasis>
ja: 数学用語では: <emphasis>ST_Intersects(A, B) ⇔ A ⋂ B ≠ ∅ </emphasis>

note: Tag: para
en: Geometries intersect if their DE-9IM Intersection Matrix matches one of:
ja: DE-9IM交差行列が次の通り合致するとジオメトリはインタセクトしています:

note: Tag: para
en: Spatial intersection is implied by all the other spatial relationship tests, except <xref linkend="ST_Disjoint"/>, which tests that geometries do NOT intersect.
ja: 空間的なインタセクションは全ての他の空間関係テスト関数に含まれます。例外は<xref linkend="ST_Disjoint"/>で、全てのジオメトリがインタセクトしていないかどうかをテストすることになります。

note: Tag: para
en: Changed: 3.0.0 SFCGAL version removed and native support for 2D TINS added.
ja: Changed: 3.0.0 SFCGAL版を削除し、2次元TINのネイティブ対応を追加しました。

note: Tag: para
en: Enhanced: 2.5.0 Supports GEOMETRYCOLLECTION.
ja: Enhanced: 2.5.0 ジオメトリコレクションに対応しました。

note: Tag: para
en: Performed by the GEOS module (for geometry), geography is native
ja: ジオメトリについては、GEOSモジュールで実現しています。ジオグラフィについてはネイティブです。

note: Tag: para
en: Availability: 1.5 support for geography was introduced.
ja: Availability: 1.5 ジオグラフィ対応が導入されました。

note: Tag: para
en: For geography, this function has a distance tolerance of about 0.00001 meters and uses the sphere rather than spheroid calculation.
ja: ジオグラフィでは、この関数は0.00001メートルの距離許容を持ち、回転楕円体計算でなく球面を使います。

note: Tag: refpurpose
en: Returns a number indicating the crossing behavior of two LineStrings
ja: 二つのラインストリングがどのように交差しているかを示す数字を返します。

note: Tag: para
en: Given two linestrings returns an integer between -3 and 3 indicating what kind of crossing behavior exists between them. 0 indicates no crossing. This is only supported for <varname>LINESTRING</varname>s.
ja: 二つのラインストリングを与えると、-3から3までの整数が返ります。この整数は、どのようにクロスしているかを示すもので、0は交差無しを意味します。この関数は<varname>LINESTRING</varname>にのみ対応しています。

note: Tag: para
en: The crossing number has the following meaning:
ja: 交差の番号は次の通りです。

note: Tag: para
en: 0: LINE NO CROSS
ja: 0: クロスが無い

note: Tag: para
en: -1: LINE CROSS LEFT
ja: -1: 左クロス

note: Tag: para
en: 1: LINE CROSS RIGHT
ja: 1: 右クロス

note: Tag: para
en: -2: LINE MULTICROSS END LEFT
ja: -2: 複数クロスで最後が左

note: Tag: para
en: 2: LINE MULTICROSS END RIGHT
ja: 2: 複数クロスで最後が右

note: Tag: para
en: -3: LINE MULTICROSS END SAME FIRST LEFT
ja: -3: 複数クロスで開始終了ともに左

note: Tag: para
en: 3: LINE MULTICROSS END SAME FIRST RIGHT
ja: 3: 複数クロスで開始終了ともに右

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> LINE CROSS LEFT and LINE CROSS RIGHT
ja: <emphasis role="bold">例:</emphasis> 左クロスと右クロス

note: Tag: para
en: Blue: Line A; Green: Line B
ja: 青: ライン A、緑: ライン B

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> LINE MULTICROSS END SAME FIRST LEFT and LINE MULTICROSS END SAME FIRST RIGHT
ja: <emphasis role="bold">例:</emphasis> 複数回クロスで開始終了ともに左と、複数回クロスで開始終了ともに右

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> LINE MULTICROSS END LEFT and LINE MULTICROSS END RIGHT
ja: <emphasis role="bold">例:</emphasis> 複数回クロスで最後が左と複数回クロスで最後が右

note: Tag: para
en: <emphasis role="bold">Example:</emphasis> Finds all streets that cross
ja: <emphasis role="bold">例:</emphasis> 全てのクロスするストリートを見つける

note: Tag: refpurpose
en: Tests if two geometries represent the same geometry and have points in the same directional order
ja: 二つのジオメトリが同じジオメトリを表現し、かつ点の並び順が同じかどうかをテストします。

note: Tag: para
en: ST_OrderingEquals compares two geometries and returns t (TRUE) if the geometries are equal and the coordinates are in the same order; otherwise it returns f (FALSE).
ja: ST_OrderingEqualsは、二つのジオメトリを比較して、ジオメトリが同じで、座標値が同じ順序である場合には、t (TRUE)を返し、それ以外の場合には、f (FALSE)を返します。

note: Tag: para
en: This function is implemented as per the ArcSDE SQL specification rather than SQL-MM. http://edndoc.esri.com/arcsde/9.1/sql_api/sqlapi3.htm#ST_OrderingEquals
ja: この関数は、SQL-MM仕様ではなくArcSDE SQL仕様に従って実装しています。http://edndoc.esri.com/arcsde/9.1/sql_api/sqlapi3.htm#ST_OrderingEqualsをご覧ください。

note: Tag: refpurpose
en: Tests if two geometries have the same dimension and intersect, but each has at least one point not in the other
ja: 二つのジオメトリが同じ次元を持ち、インタセクトして、かつ相手と重ならない点少なくとも一つあるかをテストします。

note: Tag: para
en: Returns TRUE if geometry A and B "spatially overlap". Two geometries overlap if they have the same dimension, their interiors intersect in that dimension. and each has at least one point inside the other (or equivalently, neither one covers the other). The overlaps relation is symmetric and irreflexive.
ja: ジオメトリAとBが「空間的にオーバラップする」場合にTRUEを返します。ジオメトリが同じ次元で、内部のインタセクションも同じ次元で、少なくとも一つの点がもう一方の外側にある (一方がもう一方を覆っている状態でないのと等価です)と、二つのジオメトリがオーバラップしていると言います。オーバラップの関係は、対称性があり、無反射性があります。

note: Tag: para
en: In mathematical terms: <emphasis>ST_Overlaps(A, B) ⇔ ( dim(A) = dim(B) = dim( Int(A) ⋂ Int(B) )) ∧ (A ⋂ B ≠ A) ∧ (A ⋂ B ≠ B) </emphasis>
ja: 数学用語では: <emphasis>ST_Overlaps(A, B) ⇔ ( dim(A) = dim(B) = dim( Int(A) ⋂ Int(B) )) ∧ (A ⋂ B ≠ A) ∧ (A ⋂ B ≠ B) </emphasis>

note: Tag: para
en: &index_aware; To avoid index use, use the function <function>_ST_Overlaps</function>.
ja: &index_aware; インデックスの使用を避けるには<function>_ST_Overlaps</function>関数を使います。

note: Tag: para
en: <function>ST_Overlaps</function> returns <varname>TRUE</varname> in the following situations:
ja: 次に示す図全てで、<function>ST_Overlaps</function>は<varname>TRUE</varname>を返します。

note: Tag: para
en: A Point on a LineString is contained, but since it has lower dimension it does not overlap or cross.
ja: ラインストリング上のポイントが含まますが、次元が低いのでオーバラップにもクロスにもなりません。

note: Tag: para
en: A LineString that partly covers a Polygon intersects and crosses, but does not overlap since it has different dimension.
ja: 部分的にポリゴンを覆うラインストリングはインタセクトもクロスもしますが、異なり次元なのでオーバラップしません。

note: Tag: para
en: Two Polygons that intersect but with neither contained by the other overlap, but do not cross because their intersection has the same dimension.
ja: 二つのポリゴンがインタセクトするものの一方が他方のオーバラップを含んでいませんが、インタセクトが同じ次元なのでクロスしません。

note: Tag: refpurpose
en: Tests if two geometries have a topological relationship matching an Intersection Matrix pattern, or computes their Intersection Matrix
ja: 二つのジオメトリが与えられた交差行列パターンに合致するトポロジ関係があるかどうかを見るか、交差行列を計算するかします。

note: Tag: para
en: These functions allow testing and evaluating the spatial (topological) relationship between two geometries, as defined by the <link xlink:href="http://en.wikipedia.org/wiki/DE-9IM">Dimensionally Extended 9-Intersection Model</link> (DE-9IM).
ja: これらの関数で、二つのジオメトリに対する<link xlink:href="http://en.wikipedia.org/wiki/DE-9IM">次元拡張9交差モデル</link> (Dimensionally Extended 9-Intersection Model, DE-9IM)で定義される空間 (トポロジ)関係のテストと評価が可能になります。

note: Tag: para
en: The DE-9IM is specified as a 9-element matrix indicating the dimension of the intersections between the Interior, Boundary and Exterior of two geometries. It is represented by a 9-character text string using the symbols 'F', '0', '1', '2' (e.g. <code>'FF1FF0102'</code>).
ja: DE-9IMは9要素の行列で、二つのジオメトリの内部、境界、外部のインタセクションの次元を示しています。'F', '0', '1', '2'の文字による9文字の文字列で表現します (例えば <code>'FF1FF0102'</code>)。

note: Tag: para
en: A specific kind of spatial relationship can be tested by matching the intersection matrix to an <emphasis>intersection matrix pattern</emphasis>. Patterns can include the additional symbols 'T' (meaning "intersection is non-empty") and '*' (meaning "any value"). Common spatial relationships are provided by the named functions <xref linkend="ST_Contains"/>, <xref linkend="ST_ContainsProperly"/>, <xref linkend="ST_Covers"/>, <xref linkend="ST_CoveredBy"/>, <xref linkend="ST_Crosses"/>, <xref linkend="ST_Disjoint"/>, <xref linkend="ST_Equals"/>, <xref linkend="ST_Intersects"/>, <xref linkend="ST_Overlaps"/>, <xref linkend="ST_Touches"/>, and <xref linkend="ST_Within"/>. Using an explicit pattern allows testing multiple conditions of intersects, crosses, etc in one step. It also allows testing spatial relationships which do not have a named spatial relationship function. For example, the relationship "Interior-Intersects" has the DE-9IM pattern <code>T********</code>, which is not evaluated by any named predicate.
ja: <emphasis>intersection matrix pattern</emphasis>で、特定の種類の空間関係のテストができます。パターンでは追加の文字 'T' (「インタセクションが空でない」という意味)と '*' (「値はなんでもいい」という意味)を使うことができます。一般的な空間関係については、名前の付いた関数<xref linkend="ST_Contains"/>, <xref linkend="ST_ContainsProperly"/>, <xref linkend="ST_Covers"/>, <xref linkend="ST_CoveredBy"/>, <xref linkend="ST_Crosses"/>, <xref linkend="ST_Disjoint"/>, <xref linkend="ST_Equals"/>, <xref linkend="ST_Intersects"/>, <xref linkend="ST_Overlaps"/>, <xref linkend="ST_Touches"/>, <xref linkend="ST_Within"/>として提供されます。明示的なパターンを使うことで、インタセクト、クロス等の複数のテストを一回でできるようになります。また、名前のある空間関係関数を持たない空間関係のテストも可能になります。たとえば、「内部インタセクション」という空間関係は、名前の付いた空間関係関数では評価できませんが、<code>T********</code>のDE-9IMで評価できます。

note: Tag: para
en: For more information refer to <xref linkend="eval_spatial_rel"/>.
ja: 詳細情報については<xref linkend="eval_spatial_rel"/>をご覧下さい。

note: Tag: para
en: <emphasis role="bold">Variant 1:</emphasis> Tests if two geometries are spatially related according to the given <varname>intersectionMatrixPattern</varname>.
ja: <emphasis role="bold">一つ目の形式:</emphasis> 二つのジオメトリが、与えられた<varname>intersectionMatrixPattern</varname>による空間関係に合うかどうかを見ます。

note: Tag: para
en: Unlike most of the named spatial relationship predicates, this does NOT automatically include an index call. The reason is that some relationships are true for geometries which do NOT intersect (e.g. Disjoint). If you are using a relationship pattern that requires intersection, then include the &amp;&amp; index call.
ja: 他の名前の付いた空間関係述語の多くと異なり、この関数は自動ではインデックスの呼び出しを*行いません*。インタセクト*しない*ジオメトリでTRUEになる関係があるためです。インタセクションが求められる関係パターンを使用している場合には、関数呼び出しに&amp;&amp;を取り入れてください。

note: Tag: para
en: It is better to use a named relationship function if available, since they automatically use a spatial index where one exists. Also, they may implement performance optimizations which are not available with full relate evaluation.
ja: 存在するなら、名前の追加空間関係関数を使う方が良いです。空間インデックスが存在するなら自動で使用してくれるからです。また、完全な関係評価では有効にならない能率最適化が実装されていることがあります。

note: Tag: para
en: <emphasis role="bold">Variant 2:</emphasis> Returns the DE-9IM matrix string for the spatial relationship between the two input geometries. The matrix string can be tested for matching a DE-9IM pattern using <xref linkend="ST_RelateMatch"/>.
ja: <emphasis role="bold">二つ目の形式:</emphasis> 二つのジオメトリの空間関係のDE-9IM行列文字列を返します。行列文字列は、<xref linkend="ST_RelateMatch"/>を使ったDE-9IMパターンと合致するかテストさせることができます。

note: Tag: para
en: <emphasis role="bold">Variant 3:</emphasis> Like variant 2, but allows specifying a <emphasis role="bold">Boundary Node Rule</emphasis>. A boundary node rule allows finer control over whether the endpoints of MultiLineStrings are considered to lie in the DE-9IM Interior or Boundary. The <varname>boundaryNodeRule</varname> values are:
ja: <emphasis role="bold">三つ目の形式:</emphasis> 二つ目の形式と同じですが、<emphasis role="bold">境界ノード規則</emphasis>の指定ができる点が異なります。この規則によって、マルチラインストリングの端点がDE-9IMの内部または境界上にあると判定されるかどうかを細かく制御できます。<varname>boundaryNodeRule</varname>の値は次の通りです:

note: Tag: para
en: <code>1</code>: <emphasis role="bold">OGC-Mod2</emphasis> - line endpoints are in the Boundary if they occur an odd number of times. This is the rule defined by the OGC SFS standard, and is the default for <function>ST_Relate</function>.
ja: <code>1</code>: <emphasis role="bold">OGC-Mod2</emphasis> - 線の端点が奇数回出現する場合に境界内にあるとします。これはOGC SFS標準で定義された規則で、<function>ST_Relate</function>のデフォルトです。

note: Tag: para
en: <code>2</code>: <emphasis role="bold">Endpoint</emphasis> - all endpoints are in the Boundary.
ja: <code>2</code>: <emphasis role="bold">Endpoint</emphasis> - 全ての端点は境界上にあります。

note: Tag: para
en: <code>3</code>: <emphasis role="bold">MultivalentEndpoint</emphasis> - endpoints are in the Boundary if they occur more than once. In other words, the boundary is all the "attached" or "inner" endpoints (but not the "unattached/outer" ones).
ja: <code>3</code>: <emphasis role="bold">MultivalentEndpoint</emphasis> - 端点が2回以上出現する場合に境界内にあるとします。言い換えると、境界は全ての「接続された」または「内部の」端点です (「接続していない」や「外部の」端点ではない)。

note: Tag: para
en: <code>4</code>: <emphasis role="bold">MonovalentEndpoint</emphasis> - endpoints are in the Boundary if they occur only once. In other words, the boundary is all the "unattached" or "outer" endpoints.
ja: <code>4</code>: <emphasis role="bold">MonovalentEndpoint</emphasis> - 端点が1回だけ出現する場合に限って、境界内にあるとします。言い換えると境界は全ての「接続していない」または「外部の」端点です。

note: Tag: para
en: This function is not in the OGC spec, but is implied. see s2.1.13.2
ja: OGC仕様にはありませんが実装しました。s2.1.13.2をご覧下さい。

note: Tag: para
en: Enhanced: 2.0.0 - added support for specifying boundary node rule.
ja: Enhanced: 2.0.0 - 境界ノード規則が追加されました。

note: Tag: para
en: Using the boolean-valued function to test spatial relationships.
ja: 真偽値関数を使って空間関係を見ます。

note: Tag: para
en: Testing a custom spatial relationship pattern as a query condition, with <code>&amp;&amp;</code> to enable using a spatial index.
ja: 独自の空間関係パターンを問い合わせ条件としてテストします。空間インデックスの使用を有効にするために<code>&amp;&amp;</code>を使っています。

note: Tag: para
en: Computing the intersection matrix for spatial relationships.
ja: 空間関係交差行列を計算します。

note: Tag: para
en: Using different Boundary Node Rules to compute the spatial relationship between a LineString and a MultiLineString with a duplicate endpoint <code>(3 3)</code>:
ja: 異なる境界ノード規則を使って、端点が重複するLINESTRINGとMULTILINESTRING間の空間関係を計算します <code>(3 3)</code>:

note: Tag: para
en: Using the <emphasis role="bold">OGC-Mod2</emphasis> rule (1) the duplicate endpoint is in the <emphasis role="bold">interior</emphasis> of the MultiLineString, so the DE-9IM matrix entry [aB:bI] is <code>0</code> and [aB:bB] is <code>F</code>.
ja: <emphasis role="bold">OGC-Mod2</emphasis>規則 (1)を使うと、重複端点はMULTILINESTRINGの<emphasis role="bold">内部</emphasis>になり、DE-9IM行列の [aB:bl]は<code>0</code>で、[aB:bB]は<code>F</code>です。

note: Tag: para
en: Using the <emphasis role="bold">Endpoint</emphasis> rule (2) the duplicate endpoint is in the <emphasis role="bold">boundary</emphasis> of the MultiLineString, so the DE-9IM matrix entry [aB:bI] is <code>F</code> and [aB:bB] is <code>0</code>.
ja: <emphasis role="bold">Endpoint</emphasis>規則 (2)を使うと、重複端点はMULTILINESTRINGの<emphasis role="bold">境界</emphasis>となり、DE-9IM行列の[aB:bI]は<code>F</code>で、[aB:bB]は<code>0</code>です。

note: Tag: refpurpose
en: Tests if a DE-9IM Intersection Matrix matches an Intersection Matrix pattern
ja: DE-9IM交差行列が交差行列パターンに合致するかどうかを見ます。

note: Tag: para
en: Tests if a <link xlink:href="http://en.wikipedia.org/wiki/DE-9IM">Dimensionally Extended 9-Intersection Model</link> (DE-9IM) <varname>intersectionMatrix</varname> value satisfies an <varname>intersectionMatrixPattern</varname>. Intersection matrix values can be computed by <xref linkend="ST_Relate"/>.
ja: <link xlink:href="http://en.wikipedia.org/wiki/DE-9IM">次元拡張9交差モデル</link> (Dimensionally Extended 9-Intersection Model, DE-9IM) <varname>intersectionMatrix</varname>の値が <varname>intersectionMatrixPattern</varname>を満たすかどうかを見ます。交差行列値は<xref linkend="ST_Relate"/>で計算します。

note: Tag: para
en: Patterns for common spatial relationships matched against intersection matrix values, for a line in various positions relative to a polygon
ja: あるポリゴンとの様々な相対的な位置にあるラインを想定した交差行列値に合致する一般的な空間関係のパターン

note: Tag: refpurpose
en: Tests if two geometries have at least one point in common, but their interiors do not intersect
ja: 二つのジオメトリが少なくとも一つの共有点を持ち、かつ内部でインタセクトしていないようになっているかテストします。

note: Tag: para
en: Returns <varname>TRUE</varname> if A and B intersect, but their interiors do not intersect. Equivalently, A and B have at least one point in common, and the common points lie in at least one boundary. For Point/Point inputs the relationship is always <varname>FALSE</varname>, since points do not have a boundary.
ja: AとBがインタセクトするがAの内部とBの内部がインタセクトしない場合には<varname>TRUE</varname>を返します。AとBが少なくとも一つの共有点があり、共有点が少なくとも一つの境界の上にあることと同じです。ポイント/ポイント入力では、ポイントは境界を持たないため、常に<varname>FALSE</varname>を返します。

note: Tag: para
en: In mathematical terms: <emphasis>ST_Touches(A, B) ⇔ (Int(A) ⋂ Int(B) = ∅) ∧ (A ⋂ B ≠ ∅) </emphasis>
ja: 数学用語では: <emphasis>ST_Touches(A, B) ⇔ (Int(A) ⋂ Int(B) = ∅) ∧ (A ⋂ B ≠ ∅) </emphasis>

note: Tag: para
en: This relationship holds if the DE-9IM Intersection Matrix for the two geometries matches one of:
ja: この関係は、二つのジオメトリのDE-9IM交差行列がどれか一つに合致すると、関係が保持されていることになります:

note: Tag: para
en: &index_aware; To avoid using an index, use <function>_ST_Touches</function> instead.
ja: &index_aware; インデックスの使用を避けるには<function>_ST_Touches</function>を代わりに使います。

note: Tag: para
en: The <function>ST_Touches</function> predicate returns <varname>TRUE</varname> in the following examples.
ja: 次の例では<function>ST_Touches</function>述語は<varname>TRUE</varname>を返します。

note: Tag: refpurpose
en: Tests if every point of A lies in B, and their interiors have a point in common
ja: Aの全てのポイントがB内にあり、かつ両方の内部が共有点を持つかどうかをテストします。

note: Tag: para
en: Returns TRUE if geometry A is within geometry B. A is within B if and only if all points of A lie inside (i.e. in the interior or boundary of) B (or equivalently, no points of A lie in the exterior of B), and the interiors of A and B have at least one point in common.
ja: ジオメトリAがジオメトリB内にある場合にTRUEを返します。Aの全ての点がBの内側 (内部または境界)にあり、Aの内部とBの内部に少なくとも一つの共有点がある場合に限って、AはB内にあると言います。

note: Tag: para
en: For this function to make sense, the source geometries must both be of the same coordinate projection, having the same SRID.
ja: 渡すジオメトリが両方とも同じSRIDでなければ、この関数は意味がありません。

note: Tag: para
en: In mathematical terms: <emphasis>ST_Within(A, B) ⇔ (A ⋂ B = A) ∧ (Int(A) ⋂ Int(B) ≠ ∅) </emphasis>
ja: 数学用語では: <emphasis>ST_Within(A, B) ⇔ (A ⋂ B = A) ∧ (Int(A) ⋂ Int(B) ≠ ∅) </emphasis>

note: Tag: para
en: The within relation is reflexive: every geometry is within itself. The relation is antisymmetric: if <code>ST_Within(A,B) = true</code> and <code>ST_Within(B,A) = true</code>, then the two geometries must be topologically equal (<code>ST_Equals(A,B) = true</code>).
ja: 内にある、という関係性には反射性があります。全てのジオメトリは、自分の内にあると言えます。また、非対称性を持ちます。<code>ST_Within(A,B) = true</code>かつ<code>ST_Within(B,A) = true</code>の場合には、二つのジオメトリは必ずトポロジ的に等価 (<code>ST_Equals(A,B) = true</code>)になります。

note: Tag: para
en: ST_Within is the converse of <xref linkend="ST_Contains"/>. So, <code>ST_Within(A,B) = ST_Contains(B,A)</code>.
ja: ST_Withinは<xref linkend="ST_Contains"/>の反対です。<code>ST_Within(A,B) = ST_Contains(B,A)</code>となります。

note: Tag: para
en: Because the interiors must have a common point, a subtlety of the definition is that lines and points lying fully in the boundary of polygons or lines are <emphasis>not</emphasis> within the geometry. For further details see <link xlink:href="http://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html">Subtleties of OGC Covers, Contains, Within</link>. The <xref linkend="ST_CoveredBy"/> predicate provides a more inclusive relationship.
ja: 内部が必ず共有点を持つので、定義は、ポリゴンまたはラインの境界上にあるラインまたはポイントはジオメトリの内に<emphasis>ない</emphasis>という微妙なものになります。詳細については、<link xlink:href="http://lin-ear-th-inking.blogspot.com/2007/06/subtleties-of-ogc-covers-spatial.html">Subtleties of OGC Covers, Contains, Within</link>をご覧下さい。<xref linkend="ST_CoveredBy"/>述語はより包括的な関係を提供します。

note: Tag: para
en: &index_aware; To avoid index use, use the function <function>_ST_Within</function>.
ja: &index_aware; インデックスの使用を避けるには<function>_ST_Within</function>関数を使います。

note: Tag: title
en: Distance Relationships
ja: 距離関係関数

note: Tag: refpurpose
en: Tests if two 3D geometries are within a given 3D distance
ja: 二つの3次元ジオメトリが与えらえれた3次元距離内にあるかどうかをテストします。

note: Tag: para
en: Returns true if the 3D distance between two geometry values is no larger than distance <varname>distance_of_srid</varname>. The distance is specified in units defined by the spatial reference system of the geometries. For this function to make sense the source geometries must be in the same coordinate system (have the same SRID).
ja: 二つのジオメトリ値の3次元距離が<varname>distance_of_srid</varname>以下なら<varname>TRUE</varname>を返します。距離の単位はジオメトリの空間参照系の単位です。この関数から意味のある結果を得るには、引数に使うジオメトリを同じ空間系 (同じSRIDを持つ)にしなければなりません。

note: Tag: refpurpose
en: Tests if two 3D geometries are entirely within a given 3D distance
ja: 二つの3次元ジオメトリが完全に与えらえれた3次元距離内にあるかどうかをテストします。

note: Tag: para
en: Returns true if the 3D geometries are fully within the specified distance of one another. The distance is specified in units defined by the spatial reference system of the geometries. For this function to make sense, the source geometries must both be of the same coordinate projection, having the same SRID.
ja: 3次元ジオメトリが他のジオメトリとの距離が、完全に指定した範囲内ならtrueを返します。距離の単位はジオメトリの空間参照系で定義されているものとされます。この関数が意味を持つためには、与えられるジオメトリは両方とも同じ座標系で同じSRIDを持つ必要があります。

note: Tag: refpurpose
en: Tests if a geometry is entirely inside a distance of another
ja: ジオメトリが完全に他のジオメトリの指定距離内にあるかどうかをテストします

note: Tag: para
en: Returns true if <code>g2</code> is entirely within <code>distance</code> of <code>g1</code>. Visually, the condition is true if <code>g2</code> is contained within a <code>distance</code> buffer of <code>g1</code>. The distance is specified in units defined by the spatial reference system of the geometries.
ja: <code>g2</code>が完全に<code>g1</code>の<code>distance</code>で指定した距離内にある場合にTRUEを返します。見た目で言うと、<code>g2</code>が<code>g1</code>の<code>distance</code>ぶん膨らませたバッファに含まれる場合にTRUEを返します。

note: Tag: para
en: Changed: 3.5.0 : the logic behind the function now uses a test of containment within a buffer, rather than the ST_MaxDistance algorithm. Results will differ from prior versions, but should be closer to user expectations.
ja: Changed: 3.5.0 : この関数のロジックとしては、今のところ、バッファ内に包含するかどうかのテストを使っています。ST_MaxDistanceアルゴリズムではありません。前の版と結果が異なる可能性がありますが、ユーザの期待に近づくはずです。

note: Tag: refpurpose
en: Tests if two geometries are within a given distance
ja: 二つのジオメトリが与えらえれた距離内にあるかどうかをテストします。

note: Tag: para
en: Returns true if the geometries are within a given distance
ja: ジオメトリが与えられた距離内にある場合にはTRUEを返します。

note: Tag: para
en: For <type>geometry</type>: The distance is specified in units defined by the spatial reference system of the geometries. For this function to make sense, the source geometries must be in the same coordinate system (have the same SRID).
ja: <type>geometry</type>: 距離の単位は空間参照系で定義される単位です。この関数が意味のあるものにするためには、与えられるジオメトリは両方とも同じ座標系である (同じSRIDを持つ)必要があります。

note: Tag: para
en: For <type>geography</type>: units are in meters and distance measurement defaults to <varname>use_spheroid = true</varname>. For faster evaluation use <varname>use_spheroid = false</varname> to measure on the sphere.
ja: <type>geography</type>: 単位はメートルで、距離の測定の既定値は<varname>use_spheroid = true</varname>です。より高速な評価のために、<varname>use_spheroid = false</varname>として球面で測定します。

note: Tag: para
en: Use <xref linkend="ST_3DDWithin"/> for 3D geometries.
ja: 3次元ジオメトリでは<xref linkend="ST_3DDWithin"/>を使います。

note: Tag: para
en: This function call includes a bounding box comparison that makes use of any indexes that are available on the geometries.
ja: この関数の呼び出しによって、ジオメトリで使用可能なインデクスを使用したバウンディングボックスの比較が自動的に行われます。

note: Tag: para
en: Availability: 1.5.0 support for geography was introduced
ja: Availability: 1.5.0 ジオグラフィが導入されました。

note: Tag: para
en: Enhanced: 2.1.0 improved speed for geography. See <link xlink:href="http://blog.opengeo.org/2012/07/12/making-geography-faster/">Making Geography faster</link> for details.
ja: Enhanced: 2.1.0で、ジオグラフィでの速度が向上しました。詳細については<link xlink:href="http://blog.opengeo.org/2012/07/12/making-geography-faster/">Making Geography faster</link>を参照して下さい。

note: Tag: para
en: Enhanced: 2.1.0 support for curved geometries was introduced.
ja: Enhanced: 2.1.0 曲線ジオメトリ対応が導入されました。

note: Tag: para
en: Prior to 1.3, <xref linkend="ST_Expand"/> was commonly used in conjunction with &amp;&amp; and ST_Distance to test for distance, and in pre-1.3.4 this function used that logic. From 1.3.4, ST_DWithin uses a faster short-circuit distance function.
ja: 1.3以前の<xref linkend="ST_Expand"/>は、 距離をテストするために、&amp;&amp;と、ST_Distanceとを一般的に併用していました。1.3.4より前では、この関数はそのロジックを使っていました。1.3.4からST_DWithinは、より速いショートサーキットを使った距離関数を使います。

note: Tag: refpurpose
en: Tests if a point geometry is inside a circle defined by a center and radius
ja: ポイントジオメトリが中心と半径で定められた円の内側にあるかをテストします。

note: Tag: para
en: Returns true if the geometry is a point and is inside the circle with center <varname>center_x</varname>,<varname>center_y</varname> and radius <varname>radius</varname>.
ja: ジオメトリが点であり、<varname>center_x</varname>,<varname>center_y</varname>の中心点と<varname>radius</varname>の半径を持つ円の内側にある場合はTRUEを返します。

note: Tag: para
en: Does not use spatial indexes. Use <xref linkend="ST_DWithin"/> instead.
ja: この関数は空間インデックスを使用しません。代わりに<xref linkend="ST_DWithin"/>を使って下さい。

note: Tag: para
en: Changed: 2.2.0 In prior versions this was called ST_Point_Inside_Circle
ja: Changed: 2.2.0 前のバージョンではST_Point_Inside_Circleと呼ばれていました。

note: Tag: title
en: SFCGAL Functions Reference
ja: SFCGAL 関数リファレンス

note: Tag: para
en: SFCGAL is a C++ wrapper library around CGAL that provides advanced 2D and 3D spatial functions. For robustness, geometry coordinates have an exact rational number representation.
ja: SFCGALはCGALのC++ラッパライブラリです。CGALは高度な2次元と3次元の空間関数を提供します。堅牢性のためにジオメトリ座標は正確な有理数表現を持ちます。

note: Tag: para
en: Installation instructions for the library can be found on the SFCGAL home page (<link xlink:href="http://www.sfcgal.org">http://www.sfcgal.org</link>). To enable the functions use <code>create extension postgis_sfcgal</code>.
ja: このライブラリのインストール手順はSFCGALサイト (<link xlink:href="http://www.sfcgal.org">http://www.sfcgal.org</link>)にあります。機能を有効にするには<code>create extension postgis_sfcgal</code>とします。

note: Tag: title
en: SFCGAL Management Functions
ja: SFCGAL 管理関数

note: Tag: para
en: This section lists functions for determining version of SFCGAL and library dependencies you are running.
ja: このセクションでは、SFCGALのバージョンとライブラリの依存関係を確認するための関数の一覧を示します。

note: Tag: refpurpose
en: <refpurpose>Returns the version of SFCGAL in use</refpurpose>
ja: <refpurpose>使用しているSFCGALのバージョンを返します</refpurpose>

note: Tag: para
en: <para>Returns the version of SFCGAL in use</para>
ja: <para>使用しているSFCGALのバージョンを返します</para>

note: Tag: refpurpose
en: <refpurpose>Returns the full version of SFCGAL in use including CGAL and Boost versions</refpurpose>
ja: <refpurpose>CGALとBoostのバージョンを含む、使用しているSFCGALの完全なバージョンを返します</refpurpose>

note: Tag: para
en: <para>Returns the full version of SFCGAL in use including CGAL and Boost versions</para>
ja: <para>CGALとBoostのバージョンを含む、使用しているSFCGALの完全なバージョンを返します</para>

note: Tag: title
en: SFCGAL Accessors and Setters
ja: SFCGAL アクセサとセッター

note: Tag: para
en: These functions access or set properties of geometries. Geometries primarily supported by these functions are TINS and Polyhedral Surfaces.
ja: これらの関数はジオメトリのプロパティに対するアクセスと設定を行います。これらの関数が主に対応するジオメトリは、TIN と多面体サーフェスです。

note: Tag: refpurpose
en: Force LHR orientation
ja: LHR (Left Hand Rule)方向に強制します。

note: Tag: refpurpose
en: Check if a surface is or not planar
ja: サーフェスが平面であるかないかをチェックします。

note: Tag: refpurpose
en: Test if the geometry is a solid. No validity check is performed.
ja: ジオメトリが立体であるかどうかをテストします。妥当性チェックは行いません。

note: Tag: refpurpose
en: Cast the geometry into a solid. No check is performed. To obtain a valid solid, the input geometry must be a closed Polyhedral Surface or a closed TIN.
ja: ジオメトリを立体にキャストします。チェックはしません。妥当な立体を得るには、入力ジオメトリは閉じた多面体サーフェスか閉じたTINでなければなりません。

note: Tag: refpurpose
en: Determine surface orientation
ja: サーフェスの方向を判定します。

note: Tag: para
en: The function only applies to polygons. It returns -1 if the polygon is counterclockwise oriented and 1 if the polygon is clockwise oriented.
ja: この関数はポリゴンのみ受け付けます。ポリゴンが反時計回りなら-1を返し、時計回りなら1を返します。

note: Tag: refpurpose
en: Calculates the area of a geometry
ja: ジオメトリの面積を計算します

note: Tag: para
en: Calculates the area of a geometry.
ja: ジオメトリの面積を計算します。

note: Tag: para
en: Performed by the SFCGAL module
ja: SFCGALモジュールによって実行されます

note: Tag: para
en: NOTE: this function returns a double precision value representing the area.
ja: ご注意: この関数は、面積を表現する倍精度浮動小数点数を返します。

note: Tag: refpurpose
en: Computes area of 3D surface geometries. Will return 0 for solids.
ja: 3次元の面ジオメトリの面積を計算します。立体の場合は0を返します。

note: Tag: para
en: Note: By default a PolyhedralSurface built from WKT is a surface geometry, not solid. It therefore has surface area. Once converted to a solid, no area.
ja: ご注意: デフォルトでは、WKTから生成されたPolyhedralSurfaceは面ジオメトリで、立体ではありません。サーフェス面を持ちます。立体に変換すると、面を持ちません。

note: Tag: refpurpose
en: Computes the volume of a 3D solid. If applied to surface (even closed) geometries will return 0.
ja: 3次元立体の体積を計算します。面ジオメトリは (閉じていても)0を返します。

note: Tag: para
en: &sqlmm_compliant; SQL-MM IEC 13249-3: 9.1 (same as CG_3DVolume)
ja: &sqlmm_compliant; SQL-MM IEC 13249-3: 9.1 (CG_3DVolumeと同じ)

note: Tag: para
en: When closed surfaces are created with WKT, they are treated as areal rather than solid. To make them solid, you need to use <xref linkend="CG_MakeSolid"/>. Areal geometries have no volume. Here is an example to demonstrate.
ja: WKTで閉じた面を生成した時、それは立体でなく面として扱われるます。立体にするには<xref linkend="CG_MakeSolid"/>を使います。面ジオメトリは体積を持ちません。例を挙げます。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_ForceLHR"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="CG_ForceLHR"/>を代わりに使います。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_IsPlanar"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="CG_IsPlanar"/>を代わりに使います。

note: Tag: para
en: Availability: 2.2.0: This was documented in 2.1.0 but got accidentally left out in 2.1 release.
ja: Availability: 2.2.0: これは2.1.0のマニュアルに記述されていましたが、2.1版では偶然に外れてしまいました。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_IsSolid"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="CG_IsSolid"/>を代わりに使います。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_MakeSolid"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="CG_MakeSolid"/>を代わりに使います。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_Orientation"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="CG_Orientation"/>を代わりに使います。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_3DArea"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="CG_3DArea"/>を代わりに使います。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_Volume"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="CG_Volume"/>を代わりに使います。

note: Tag: para
en: &sqlmm_compliant; SQL-MM IEC 13249-3: 9.1 (same as ST_3DVolume)
ja: &sqlmm_compliant; SQL-MM IEC 13249-3: 9.1 (ST_3DVolumeと同じ)

note: Tag: para
en: When closed surfaces are created with WKT, they are treated as areal rather than solid. To make them solid, you need to use <xref linkend="ST_MakeSolid"/>. Areal geometries have no volume. Here is an example to demonstrate.
ja: WKTで閉じた面を生成した時、それは立体でなく面として扱われるます。立体にするには<xref linkend="ST_MakeSolid"/>を使います。面ジオメトリは堆積を持ちません。例を挙げます。

note: Tag: title
en: SFCGAL Processing and Relationship Functions
ja: SFCGAL 処理関数および関係関数

note: Tag: refpurpose
en: Computes the intersection of two geometries
ja: 二つのジオメトリのインタセクトする (共有する)部分を計算します

note: Tag: para
en: Computes the intersection of two geometries.
ja: 二つのジオメトリのインタセクトする (共有する)部分を計算します。

note: Tag: para
en: NOTE: this function returns a geometry representing the intersection.
ja: ご注意: この関数はインタセクトした部分を表現するジオメトリを返します。

note: Tag: refpurpose
en: Tests if two 3D geometries intersect
ja: 二つの3次元ジオメトリがインタセクトするかどうかをテストします

note: Tag: para
en: Tests if two 3D geometries intersect. 3D geometries intersect if they have any point in common in the three-dimensional space.
ja: 二つの3次元ジオメトリがインタセクトするかどうかをテストします。3次元空間で共通する点が存在するなら、3次元ジオメトリはインタセクトしています。

note: Tag: refpurpose
en: Computes the geometric difference between two geometries
ja: 二つのジオメトリの幾何学的な差を計算します

note: Tag: para
en: Computes the geometric difference between two geometries. The resulting geometry is a set of points that are present in geomA but not in geomB.
ja: 二つのジオメトリの幾何学的な差を計算します。返されるジオメトリは、geomAに存在するがgeomBに存在しない点の集合です。

note: Tag: para
en: NOTE: this function returns a geometry.
ja: ご注意: この関数はジオメトリを返します。

note: Tag: refpurpose
en: Perform 3D difference
ja: 3次元の差分を計算します。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_3DDifference"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="CG_3DDifference"/>を代わりに使います。

note: Tag: para
en: Returns that part of geom1 that is not part of geom2.
ja: geom2に含まれないgeom1の一部を返します。

note: Tag: para
en: 3D images were generated using PostGIS <xref linkend="ST_AsX3D"/> and rendering in HTML using <link xlink:href="http://www.x3dom.org">X3Dom HTML Javascript rendering library</link>.
ja: PostGIS関数<xref linkend="ST_AsX3D"/>を使って3次元イメージを生成し、<link xlink:href="http://www.x3dom.org">X3Dom HTML Javascript redering library</link>を使ってHTMLでの描画を行います。

note: Tag: para
en: Original 3D geometries overlaid. geom2 is the part that will be removed.
ja: 元の3次元ジオメトリを重ねたもの。geom2は削除部分にあたります。

note: Tag: para
en: What's left after removing geom2
ja: geom2を削除した後に残るもの

note: Tag: refpurpose
en: Computes the minimum distance between two geometries
ja: 二つのジオメトリの最小距離を返します

note: Tag: para
en: Computes the minimum distance between two geometries.
ja: 二つのジオメトリの最小距離を返します。

note: Tag: para
en: NOTE: this function returns a double precision value representing the distance.
ja: ご注意: この関数は、距離を表現する倍精度浮動小数点数を返します。

note: Tag: refpurpose
en: Computes the minimum 3D distance between two geometries
ja: 二つのジオメトリの最小3次元距離を返します

note: Tag: para
en: Computes the minimum 3D distance between two geometries.
ja: 二つのジオメトリの最小3次元距離を返します。

note: Tag: para
en: NOTE: this function returns a double precision value representing the 3D distance.
ja: ご注意: この関数は、3次元距離を表現する倍精度浮動小数点数を返します。

note: Tag: refpurpose
en: Computes the 3D convex hull of a geometry.
ja: ジオメトリの3次元の凸包を計算します。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_3DConvexHull"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="CG_3DConvexHull"/>を代わりに使います。

note: Tag: para
en: Original geometry overlaid with 3D convex hull
ja: 3次元凸包をオーバレイした元のジオメトリ

note: Tag: refpurpose
en: Perform 3D intersection
ja: 3次元のインタセクトした (共有する)部分を計算します。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_3DIntersection"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="CG_3DIntersection"/>を代わりに使います。

note: Tag: para
en: Return a geometry that is the shared portion between geom1 and geom2.
ja: geom1とgeom2の間で共有される部分のジオメトリを返します。

note: Tag: para
en: Original 3D geometries overlaid. geom2 is shown semi-transparent
ja: 元の3次元ジオメトリを重ねたものでgeom2は半透明で表示

note: Tag: para
en: Intersection of geom1 and geom2
ja: geom1とgeom2の共有部分

note: Tag: para
en: 3D linestrings and polygons
ja: 3次元ラインストリングとポリゴン

note: Tag: para
en: Cube (closed Polyhedral Surface) and Polygon Z
ja: 立方体 (閉じた多面体サーフェス)と3次元ポリゴン

note: Tag: para
en: Intersection of 2 solids that result in volumetric intersection is also a solid (ST_Dimension returns 3)
ja: 二つの立体の共通部分もまた立体です (ST_Dimensionで3を返します)

note: Tag: refpurpose
en: Computes the union of two geometries
ja: 二つのジオメトリの結合を計算します

note: Tag: para
en: Computes the union of two geometries.
ja: 二つのジオメトリの結合を計算します。

note: Tag: para
en: NOTE: this function returns a geometry representing the union.
ja: ご注意: この関数は結合を表現するジオメトリを返します。

note: Tag: refpurpose
en: Perform 3D union.
ja: 3次元の結合を計算します。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_3DUnion"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="CG_3DUnion"/>を代わりに使います。

note: Tag: para
en: Availability: 3.3.0 aggregate variant was added
ja: Availability: 3.3.0 集約関数の形式が追加されました

note: Tag: para
en: <emphasis role="bold">Aggregate variant:</emphasis> returns a geometry that is the 3D union of a rowset of geometries. The ST_3DUnion() function is an "aggregate" function in the terminology of PostgreSQL. That means that it operates on rows of data, in the same way the SUM() and AVG() functions do and like most aggregates, it also ignores NULL geometries.
ja: <emphasis role="bold">集約関数形式:</emphasis> ジオメトリの集合を3次元結合したジオメトリを返します。ST_3DUnion()関数は、PostgreSQL用語で言うところの「集約関数」です。つまり、SUM()やMEAN()と同じ方法で複数のデータ行の操作を行い、他の集約関数と同じようにNULLジオメトリを無視します。

note: Tag: refpurpose
en: Perform 3D union using postgis_sfcgal.
ja: postgis_sfcgalを使用して3次元結合を実行します。

note: Tag: para
en: <emphasis role="bold">Aggregate variant:</emphasis> returns a geometry that is the 3D union of a rowset of geometries. The CG_3DUnion() function is an "aggregate" function in the terminology of PostgreSQL. That means that it operates on rows of data, in the same way the SUM() and AVG() functions do and like most aggregates, it also ignores NULL geometries.
ja: <emphasis role="bold">集約関数形式:</emphasis> ジオメトリの行集合を結合した3次元ジオメトリを返します。CG_3DUnion()関数は、PostgreSQL用語で言うところの「集約関数」です。つまり、SUM()やMEAN()と同じ方法で複数のデータ行の操作を行い、他のほとんどの集約関数と同じようにNULLジオメトリを無視します。

note: Tag: para
en: Original 3D geometries overlaid. geom2 is the one with transparency.
ja: 元の3次元ジオメトリを重ねたもの。geom2は半透明で示しています。

note: Tag: para
en: Union of geom1 and geom2
ja: geom1とgeom2の結合

note: Tag: refpurpose
en: Computes an Alpha-shape enclosing a geometry
ja: ジオメトリを囲むアルファシェイプを計算します。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_AlphaShape"/> instead.
ja: は3.5.0では非推奨です。代わりに<xref linkend="CG_AlphaShape"/>を使います。

note: Tag: para
en: Computes the <link xlink:href="https://en.wikipedia.org/wiki/Alpha_shape">Alpha-Shape</link> of the points in a geometry. An alpha-shape is a (usually) concave polygonal geometry which contains all the vertices of the input, and whose vertices are a subset of the input vertices. An alpha-shape provides a closer fit to the shape of the input than the shape produced by the <link linkend="ST_ConvexHull">convex hull</link>.
ja: ジオメトリのポイントの<link xlink:href="https://ja.wikipedia.org/wiki/%E3%82%A2%E3%83%AB%E3%83%95%E3%82%A1%E3%82%B7%E3%82%A7%E3%82%A4%E3%83%97">アルファシェイプ</link>を計算します。アルファシェイプは (通常は)入力の頂点を全て含む凹ポリゴンジオメトリで、このジオメトリの頂点は入力頂点の部分集合です。アルファシェイプは入力ジオメトリのシェイプを<link linkend="ST_ConvexHull">凸包</link>で生成されるシェイプよりも適合したものにします。

note: Tag: para
en: The "closeness of fit" is controlled by the <varname>alpha</varname> parameter, which can have values from 0 to infinity. Smaller alpha values produce more concave results. Alpha values greater than some data-dependent value produce the convex hull of the input.
ja: 「適合度」は<varname>alpha</varname>パラメータで制御します。このパラメータは0から無限大の数を取ります。小さいα値では凹が増える結果になりますα値がデータ依存の値より大きいと入力の凸包が生成されます。

note: Tag: para
en: Following the CGAL implementation, the alpha value is the <emphasis>square</emphasis> of the radius of the disc used in the Alpha-Shape algorithm to "erode" the Delaunay Triangulation of the input points. See <link xlink:href="https://doc.cgal.org/latest/Alpha_shapes_2/index.html#Chapter_2D_Alpha_Shapes">CGAL Alpha-Shapes</link> for more information. This is different from the original definition of alpha-shapes, which defines alpha as the radius of the eroding disc.
ja: CGAL実装に従うと、α値は、アルファシェイプアルゴリズムで、入力ジオメトリのドロネー三角形を侵食するために使われる円の半径の<emphasis>2乗</emphasis>です。詳細情報については<link xlink:href="https://doc.cgal.org/latest/Alpha_shapes_2/index.html#Chapter_2D_Alpha_Shapes">CGAL Alpha-Shapes</link>をご覧下さい。元のアルファシェイプの定義と違います。元はα値を侵食円の半径と定義しています。

note: Tag: para
en: The computed shape does not contain holes unless the optional <varname>allow_holes</varname> argument is specified as true.
ja: 計算されたシェイプは<varname>allow_holes</varname>をTRUEに設定しない限りは穴を持ちません。

note: Tag: para
en: This function effectively computes a concave hull of a geometry in a similar way to <xref linkend="ST_ConcaveHull"/>, but uses CGAL and a different algorithm.
ja: この関数はジオメトリの凹包を<xref linkend="ST_ConcaveHull"/>と似た方法で効率的に計算しますが、CGALや異なるアルゴリズムを使います。

note: Tag: para
en: Availability: 3.5.0 - requires SFCGAL &gt;= 1.4.1.
ja: Availability: 3.5.0 - SFCGAL &gt;= 1.4.1 が必要です。

note: Tag: para
en: Alpha-shape of a MultiPoint (same example As <xref linkend="CG_OptimalAlphaShape"/>)
ja: MULTIPOINTOのアルファシェイプ (<xref linkend="CG_OptimalAlphaShape"/>と同じ)

note: Tag: para
en: Alpha-shape of a MultiPoint, allowing holes (same example as <xref linkend="CG_OptimalAlphaShape"/>)
ja: 穴を許容したMULTIPOINTOのアルファシェイプ (<xref linkend="CG_OptimalAlphaShape"/>と同じ)

note: Tag: para
en: Alpha-shape of a MultiPoint, allowing holes (same example as <xref linkend="ST_ConcaveHull"/>)
ja: マルチポイントのアルファシェイプで穴を許す (<xref linkend="ST_ConcaveHull"/>と同じ)

note: Tag: refpurpose
en: Computes approximal convex partition of the polygon geometry
ja: ポリゴンジオメトリの近似凸分割を計算します

note: Tag: para
en: Computes approximal convex partition of the polygon geometry (using a triangulation).
ja: ポリゴンジオメトリの近似凸分割を計算します (三角形分割を使います)。

note: Tag: para
en: A partition of a polygon P is a set of polygons such that the interiors of the polygons do not intersect and the union of the polygons is equal to the interior of the original polygon P. CG_ApproxConvexPartition and CG_GreeneApproxConvexPartition functions produce approximately optimal convex partitions. Both these functions produce convex decompositions by first decomposing the polygon into simpler polygons; CG_ApproxConvexPartition uses a triangulation and CG_GreeneApproxConvexPartition a monotone partition. These two functions both guarantee that they will produce no more than four times the optimal number of convex pieces but they differ in their runtime complexities. Though the triangulation-based approximation algorithm often results in fewer convex pieces, this is not always the case.
ja: ポリゴンPの分割は、内部同士がインタセクトせず、結合すると元のポリゴンPの内部と同じになるようなポリゴンの集合です。CG_ApproxConvexPartition関数とCG_GreeneApproxConvexPartition関数は、概ね最適な凸分割を生成します。両方の関数は、最初にポリゴンをより単純なポリゴンに分解したうえで凸分解を行います。CG_ApproxConvexPartitionは三角形を使い、CG_GreeneApproxConvexPartitionは単調分割を使います。両方の関数は、凸分割の要素数について最適数の4倍を超えないことを保証しますが、実行時の複雑さが異なります。三角形ベースの近似アルゴリズムでは、しばしば、凸要素が少なくなりますが、常にそうなるとは限りません。

note: Tag: para
en: Availability: 3.5.0 - requires SFCGAL &gt;= 1.5.0.
ja: Availability: 3.5.0 - SFCGAL &gt;= 1.5.0が必要です。

note: Tag: para
en: Requires SFCGAL &gt;= 1.5.0
ja: SFCGAL &gt;= 1.5.0 が必要

note: Tag: para
en: Approximal Convex Partition (same example As <xref linkend="CG_YMonotonePartition"/>, <xref linkend="CG_GreeneApproxConvexPartition"/> and <xref linkend="CG_OptimalConvexPartition"/>)
ja: 近似凸分割 (<xref linkend="CG_YMonotonePartition"/>, <xref linkend="CG_GreeneApproxConvexPartition"/>および<xref linkend="CG_OptimalConvexPartition"/>と同じ例です)

note: Tag: refpurpose
en: Compute the approximate medial axis of an areal geometry.
ja: 面ジオメトリの近似的な中心軸を計算します。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_ApproximateMedialAxis"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="CG_ApproximateMedialAxis"/>を代わりに使います。

note: Tag: para
en: Return an approximate medial axis for the areal input based on its straight skeleton. Uses an SFCGAL specific API when built against a capable version (1.2.0+). Otherwise the function is just a wrapper around CG_StraightSkeleton (slower case).
ja: ストレートスケルトンを基に、実際の入力の近似的な中心軸を返します。可能な版(1.2.0以上)でビルドするとSFCGAL独自APIを使います。そうでない場合には、CG_StraightSkeleton (遅い)関数をラッピングした関数となります。

note: Tag: para
en: A polygon and its approximate medial axis
ja: ポリゴンと近似的な中心軸

note: Tag: refpurpose
en: Return a constrained Delaunay triangulation around the given input geometry.
ja: 入力ジオメトリの周りの制約付きドロネー三角形を返します。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_ConstrainedDelaunayTriangles"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="CG_ConstrainedDelaunayTriangles"/>を代わりに使います。

note: Tag: para
en: Return a <link xlink:href="https://en.wikipedia.org/wiki/Constrained_Delaunay_triangulation">Constrained Delaunay triangulation</link> around the vertices of the input geometry. Output is a TIN.
ja: 入力ジオメトリの周りの制約付きドロネー三角形 (<link xlink:href="https://en.wikipedia.org/wiki/Constrained_Delaunay_triangulation">Constrained Delaunay triangulation</link>)を返します。出力はTINです。

note: Tag: para
en: CG_ConstrainedDelaunayTriangles of 2 polygons
ja: 二つのポリゴンのCG_ConstrainedDelaunayTriangles

note: Tag: para
en: of 2 polygons. Triangle edges cross polygon boundaries.
ja: 二つのポリゴン。三角形の辺はポリゴンの境界にクロスしています。

note: Tag: refpurpose
en: Extrude a surface to a related volume
ja: 関連するボリュームにサーフェスを押し出します。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_Extrude"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="CG_Extrude"/>を代わりに使います。

note: Tag: para
en: Original octagon formed from buffering point
ja: ポイントのバッファから形成された元の八角形

note: Tag: para
en: Hexagon extruded 30 units along Z produces a PolyhedralSurfaceZ
ja: Z方向に30単位押し出して得たPolyhedralSurfaceZ

note: Tag: para
en: Original linestring
ja: 元のラインストリング

note: Tag: para
en: LineString Extruded along Z produces a PolyhedralSurfaceZ
ja: ラインストリングをZ方向に押し出したPolyhedralSurfaceZ

note: Tag: refpurpose
en: Straight Skeleton Extrusion
ja: ストレートスケルトンの押し出し

note: Tag: para
en: Computes an extrusion with a maximal height of the polygon geometry.
ja: ポリゴンジオメトリの最大高での押出しを計算します。

note: Tag: para
en: Perhaps the first (historically) use-case of straight skeletons: given a polygonal roof, the straight skeleton directly gives the layout of each tent. If each skeleton edge is lifted from the plane a height equal to its offset distance, the resulting roof is "correct" in that water will always fall down to the contour edges (the roof's border), regardless of where it falls on the roof. The function computes this extrusion aka "roof" on a polygon. If the argument body_height > 0, so the polygon is extruded like with CG_Extrude(polygon, 0, 0, body_height). The result is an union of these polyhedralsurfaces.
ja: ストレートスケルトンの (歴史上の)最初の使用例は、おそらく、ポリゴンの屋根を与えて、ストレートスケルトンでテントの配置を得るというものだったでしょう。スケルトンの個々のエッジは平面からオフセット距離分引き上げられ、水が、屋根のどこに落ちるか関係なく、常に輪郭のエッジ (屋根の境界線)に落ちるという点で、結果の屋根は「正しい」ものになります。この関数はこのポリゴンの押出し、別名「屋根」を計算します。引数のbody_height が body_height > 0 となる場合には、ポリゴンはCG_Extrude(polygon, 0, 0, body_height)で押し出されるようになります。結果はこれらの多面体サーフェスの結合となります。

note: Tag: para
en: Computes approximal monotone convex partition of the polygon geometry.
ja: ポリゴンジオメトリの近似的な単調凸分割を計算します。

note: Tag: para
en: Greene Approximal Convex Partition (same example As <xref linkend="CG_YMonotonePartition"/>, <xref linkend="CG_ApproxConvexPartition"/> and <xref linkend="CG_OptimalConvexPartition"/>)
ja: グリーン近似凸分割 (<xref linkend="CG_YMonotonePartition"/>, <xref linkend="CG_ApproxConvexPartition"/>, <xref linkend="CG_OptimalConvexPartition"/>と同じ例です)

note: Tag: refpurpose
en: Performs Minkowski sum
ja: ミンコフスキー和を求めます。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_MinkowskiSum"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="CG_MinkowskiSum"/>を代わりに使います。

note: Tag: para
en: This function performs a 2D minkowski sum of a point, line or polygon with a polygon.
ja: ポリゴンと、ポイント、ライン、ポリゴンのいずれかとの2次元のミンコフスキー和を計算します。

note: Tag: para
en: A minkowski sum of two geometries A and B is the set of all points that are the sum of any point in A and B. Minkowski sums are often used in motion planning and computer-aided design. More details on <link xlink:href="https://en.wikipedia.org/wiki/Minkowski_addition">Wikipedia Minkowski addition</link>.
ja: 二つのジオメトリAとBのミンコフスキー和はAとBのあらゆるポイントの和の集合です。ミンコフスキー和は、しばしば動作計画とCADで使われます。より詳細な情報について<link xlink:href="https://en.wikipedia.org/wiki/Minkowski_addition">Wikipedia Minkowski addition</link>をご覧ください。

note: Tag: para
en: The first parameter can be any 2D geometry (point, linestring, polygon). If a 3D geometry is passed, it will be converted to 2D by forcing Z to 0, leading to possible cases of invalidity. The second parameter must be a 2D polygon.
ja: 一つ目の引数は2次元ジオメトリ (ポイント、ラインストリング、ポリゴン)とすることができます。3次元ジオメトリを渡すと、Zを0とした2次元に強制され、この場合は無効と考えられます。二つ目の引数は2次元ポリゴンでなければなりません。

note: Tag: para
en: Implementation utilizes <link xlink:href="http://doc.cgal.org/latest/Minkowski_sum_2/">CGAL 2D Minkowskisum</link>.
ja: <link xlink:href="http://doc.cgal.org/latest/Minkowski_sum_2/">CGAL 2D Minkowskisum</link>を利用して実装しています。

note: Tag: para
en: Minkowski Sum of Linestring and circle polygon where Linestring cuts thru the circle
ja: ラインストリングと円ポリゴンであって、ラインストリングがポリゴンを横切るミンコフスキー和

note: Tag: para
en: Before Summing
ja: ミンコフスキー和を実行する前

note: Tag: para
en: After summing
ja: ミンコフスキー和実行後

note: Tag: para
en: Minkowski Sum of a polygon and multipoint
ja: ポリゴンとマルチポイントとのミンコフスキー和

note: Tag: para
en: After summing: polygon is duplicated and translated to position of points
ja: ミンコフスキー和実行後: 重複ポリゴンが生成されポイントの位置に移動

note: Tag: refpurpose
en: Computes an Alpha-shape enclosing a geometry using an "optimal" alpha value.
ja: 「最適」アルファ値を使ってジオメトリを囲むアルファシェイプを計算します。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_OptimalAlphaShape"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="CG_OptimalAlphaShape"/>を代わりに使います。

note: Tag: para
en: Computes the "optimal" alpha-shape of the points in a geometry. The alpha-shape is computed using a value of α chosen so that:
ja: ジオメトリのポイントの「最適」のアルファシェイプを計算します。アルファシェイプは次に示す項目のようになるよう選択されたα値を使います:

note: Tag: para
en: the number of polygon elements is equal to or smaller than <varname>nb_components</varname> (which defaults to 1)
ja: ポリゴン要素数は<varname>nb_components</varname>以下になります (デフォルトは1です)

note: Tag: para
en: all input points are contained in the shape
ja: 全ての入力ポイントはシェイプの中に含まれます

note: Tag: para
en: The result will not contain holes unless the optional <varname>allow_holes</varname> argument is specified as true.
ja: 任意引数<varname>allow_holes</varname>にTRUEが設定されていない限りは、結果には穴が含まれません。

note: Tag: para
en: Availability: 3.3.0 - requires SFCGAL &gt;= 1.4.1.
ja: Availability: 3.3.0 - SFCGAL &gt;= 1.4.1 が必要です。

note: Tag: para
en: Optimal alpha-shape of a MultiPoint (same example as <xref linkend="CG_AlphaShape"/>)
ja: MULTIPOINTの最適アルファシェイプ (<xref linkend="CG_AlphaShape"/>と同じ)

note: Tag: para
en: Optimal alpha-shape of a MultiPoint, allowing holes (same example as <xref linkend="CG_AlphaShape"/>)
ja: 穴を許したMULTIPOINTの最適アルファシェイプ (<xref linkend="CG_AlphaShape"/>と同じ)

note: Tag: refpurpose
en: Computes an optimal convex partition of the polygon geometry
ja: ポリゴンジオメトリの最適凸分割を計算します

note: Tag: para
en: Computes an optimal convex partition of the polygon geometry.
ja: ポリゴンジオメトリの最適凸分割を計算します。

note: Tag: para
en: A partition of a polygon P is a set of polygons such that the interiors of the polygons do not intersect and the union of the polygons is equal to the interior of the original polygon P. CG_OptimalConvexPartition produces a partition that is optimal in the number of pieces.
ja: ポリゴンPの分割は、内部同士がインタセクトせず、結合すると元のポリゴンPの内部と同じになるようなポリゴンの集合です。CG_OptimalConvexPartitionは、分割要素数について最適な分割を生成します。

note: Tag: para
en: Optimal Convex Partition (same example As <xref linkend="CG_YMonotonePartition"/>, <xref linkend="CG_ApproxConvexPartition"/> and <xref linkend="CG_GreeneApproxConvexPartition"/>)
ja: 最適凸分割 (<xref linkend="CG_YMonotonePartition"/>, <xref linkend="CG_ApproxConvexPartition"/>, <xref linkend="CG_GreeneApproxConvexPartition"/>と同じ例)

note: Tag: refpurpose
en: Compute a straight skeleton from a geometry
ja: ジオメトリからストレートスケルトンを計算します。

note: Tag: para
en: Requires SFCGAL &gt;= 1.3.8 for option use_distance_as_m
ja: 任意引数use_distance_as_mを使用するにはSFCGAL &gt;= 1.3.8が必要です

note: Tag: para
en: Straight Skeleton of polygon
ja: ポリゴンのストレートスケルトン

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_StraightSkeleton"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="CG_StraightSkeleton"/>を代わりに使います。

note: Tag: refpurpose
en: Perform surface Tessellation of a polygon or polyhedralsurface and returns as a TIN or collection of TINS
ja: ポリゴンまたは多面体サーフェスのテッセレーションを計算し、TINまたはTINコレクションを返します。

note: Tag: para
en: is deprecated as of 3.5.0. Use <xref linkend="CG_Tesselate"/> instead.
ja: は3.5.0では非推奨です。<xref linkend="CG_Tesselate"/>を代わりに使います。

note: Tag: para
en: Takes as input a surface such a MULTI(POLYGON) or POLYHEDRALSURFACE and returns a TIN representation via the process of tessellation using triangles.
ja: (MULTI)POLYGONまたはPOLYHEDRALSURFACEのような面を入力に取り、三角形を使ったテッセレーション処理を通してTIN表現を返します。

note: Tag: para
en: does similar to this function except that it returns a geometry collection of polygons instead of a TIN and also only works with 2D geometries.
ja: はこの関数に似ていますが、TINの代わりにジオメトリコレクションを返す点と2次元ジオメトリだけで機能する点とは除きます。

note: Tag: para
en: Original Cube
ja: 元の立方体

note: Tag: para
en: ST_AsText output:
ja: ST_AsTextの出力:

note: Tag: para
en: Tessellated Cube with triangles colored
ja: 彩色した三角形によるテッセレーションを施した立方体

note: Tag: para
en: Tessellated Polygon
ja: テッセレーションを施したポリゴン

note: Tag: refpurpose
en: Triangulates a polygonal geometry
ja: ポリゴンジオメトリを三角形にします

note: Tag: para
en: Triangulates a polygonal geometry.
ja: ポリゴンジオメトリを三角形にします。

note: Tag: para
en: NOTE: this function returns a geometry representing the triangulated result.
ja: ご注意: この関数は三角形化した結果を表現するジオメトリを返します。

note: Tag: refpurpose
en: Compute a visibility polygon from a point or a segment in a polygon geometry
ja: ポリゴンジオメトリ内のポイント又は辺から可視領域ポリゴンを計算する

note: Tag: para
en: Visibility from the point
ja: ポイントからの可視領域

note: Tag: para
en: Visibility from the segment
ja: 辺からの可視領域

note: Tag: refpurpose
en: Computes y-monotone partition of the polygon geometry
ja: ポリゴンジオメトリのY単調分割を計算します

note: Tag: para
en: Computes y-monotone partition of the polygon geometry.
ja: ポリゴンジオメトリのY単調分割を計算します。

note: Tag: para
en: A partition of a polygon P is a set of polygons such that the interiors of the polygons do not intersect and the union of the polygons is equal to the interior of the original polygon P. A y-monotone polygon is a polygon whose vertices v1,…,vn can be divided into two chains v1,…,vk and vk,…,vn,v1, such that any horizontal line intersects either chain at most once. This algorithm does not guarantee a bound on the number of polygons produced with respect to the optimal number.
ja: ポリゴンPの分割は、内部同士がインタセクトせず、結合すると元のポリゴンPの内部と同じになるようなポリゴンの集合です。Y単調のポリゴンとは、頂点v1,…vnが、v1,…,vkとvk,…,vn,v1の二つのチェーンに、水平線がどちらかのチェーンに、たかだか1回インタセクトするようになるように分割することができるポリゴンです。このアルゴリズムは、最適なポリゴン数に対して生成されるポリゴン数の限度を保証しません。

note: Tag: para
en: Y-Monotone Partition (same example As <xref linkend="CG_ApproxConvexPartition"/>, <xref linkend="CG_GreeneApproxConvexPartition"/> and <xref linkend="CG_OptimalConvexPartition"/>)
ja: Y単調分割 (<xref linkend="CG_ApproxConvexPartition"/>, <xref linkend="CG_GreeneApproxConvexPartition"/>, <xref linkend="CG_OptimalConvexPartition"/>と同じ例です)

note: Tag: title
en: Spatial Reference System Functions
ja: 空間参照系関数

note: Tag: para
en: These functions work with the Spatial Reference System of geometries as defined in the <varname>spatial_ref_sys</varname> table.
ja: これらの関数は<varname>spatial_ref_sys</varname>テーブルで定義されているジオメトリの空間参照系と連携します。

note: Tag: refpurpose
en: Return a new geometry with coordinates transformed to a different spatial reference system using the inverse of a defined coordinate transformation pipeline.
ja: 定義した座標変換パイプラインの逆変換を使って、異なる空間参照系に座標値を変換した新しいジオメトリを返します。

note: Tag: para
en: Return a new geometry with coordinates transformed to a different spatial reference system using a defined coordinate transformation pipeline to go in the inverse direction.
ja: 定義した座標変換パイプラインの逆方向への変換を使って、異なる空間参照系に座標値を変換した新しいジオメトリを返します。

note: Tag: para
en: Refer to <xref linkend="ST_TransformPipeline"/> for details on writing a transformation pipeline.
ja: 変換パイプラインの記述に関する詳細については<xref linkend="ST_TransformPipeline"/>を参照して下さい。

note: Tag: para
en: The SRID of the input geometry is ignored, and the SRID of the output geometry will be set to zero unless a value is provided via the optional <varname>to_srid</varname> parameter. When using <xref linkend="ST_TransformPipeline"/> the pipeline is executed in a forward direction. Using `ST_InverseTransformPipeline()` the pipeline is executed in the inverse direction.
ja: 入力ジオメトリのSRIDは無視され、任意パラメータ <varname>to_srid</varname> から値が提供されていない場合には出力ジオメトリのSRIDは0に設定されます。<xref linkend="ST_TransformPipeline"/>を使うときには、パイプラインが順方向に実行されます。`ST_InverseTransformPipeline()`を使うと、パイプラインは逆方向に実行されます。

note: Tag: para
en: Transforms using pipelines are a specialised version of <xref linkend="ST_Transform"/>. In most cases `ST_Transform` will choose the correct operations to convert between coordinate systems, and should be preferred.
ja: パイプラインを用いた変換は<xref linkend="ST_Transform"/>の特別版です。ほとんどの場合、`ST_Transform`は、座標系間の変換において正しい演算子を選択します。こちらの方が推奨されます。

note: Tag: para
en: Change WGS 84 long lat to UTM 31N using the EPSG:16031 conversion
ja: EPSG:16031変換を使ったWGS 84 経度緯度から UTM31Nへの変換

note: Tag: para
en: GDA2020 example.
ja: GDA2020の例。

note: Tag: refpurpose
en: Set the SRID on a geometry.
ja: ジオメトリにSRIDを設定します。

note: Tag: para
en: Sets the SRID on a geometry to a particular integer value. Useful in constructing bounding boxes for queries.
ja: ジオメトリのSRIDを特定の整数値に設定します。クエリのためのバウンディングボックスを生成する際に使います。

note: Tag: para
en: This function does not transform the geometry coordinates in any way - it simply sets the meta data defining the spatial reference system the geometry is assumed to be in. Use <xref linkend="ST_Transform"/> if you want to transform the geometry into a new projection.
ja: この関数はジオメトリを変換せず、ジオメトリが仮定する空間参照系を定義するメタデータを設定するだけです。ジオメトリを新しい投影法に変換したい場合は<xref linkend="ST_Transform"/>を使います。

note: Tag: para
en: -- Mark a point as WGS 84 long lat --
ja: -- ポイントをWGS84経度緯度に設定 --

note: Tag: para
en: -- Mark a point as WGS 84 long lat and then transform to web mercator (Spherical Mercator) --
ja: -- ポイントをWGS84経度緯度に設定したうえで、WEBメルカトル(球面メルカトル)に変換 --

note: Tag: refpurpose
en: Returns the spatial reference identifier for a geometry.
ja: ジオメトリの空間参照系識別子を返します。

note: Tag: refpurpose
en: Return a new geometry with coordinates transformed to a different spatial reference system.
ja: 異なる空間参照系に投影変換された新しいジオメトリを返します。

note: Tag: para
en: Returns a new geometry with its coordinates transformed to a different spatial reference system. The destination spatial reference <varname>to_srid</varname> may be identified by a valid SRID integer parameter (i.e. it must exist in the <varname>spatial_ref_sys</varname> table). Alternatively, a spatial reference defined as a PROJ.4 string can be used for <varname>to_proj</varname> and/or <varname>from_proj</varname>, however these methods are not optimized. If the destination spatial reference system is expressed with a PROJ.4 string instead of an SRID, the SRID of the output geometry will be set to zero. With the exception of functions with <varname>from_proj</varname>, input geometries must have a defined SRID.
ja: 異なる空間参照系に投影変換された新しいジオメトリを返します。変換先空間参照系である<varname>to_srid</varname>は、妥当なSRID整数パラメータ (<varname>spatial_ref_sys</varname>にあるということ)です。他にも、<varname>to_proj</varname>と<varname>from_proj</varname>にPROJ.4文字列で定義された空間参照系を指定することができますが、最適化されません。変換先空間参照系がSRIDの代わりにPROJ.4文字列で表現されている場合には、出力ジオメトリのSRIDは0になります。<varname>from_proj</varname>を使う場合には、入力ジオメトリは定義されたSRIDを持っていなければなりません。

note: Tag: para
en: ST_Transform is often confused with <xref linkend="ST_SetSRID"/>. ST_Transform actually changes the coordinates of a geometry from one spatial reference system to another, while ST_SetSRID() simply changes the SRID identifier of the geometry.
ja: ST_Transformはしばしば<xref linkend="ST_SetSRID"/>と混同されます。ST_Transformは実際にジオメトリの座標を、ある空間参照系から他のものに変換します。ST_SetSRIDは単にジオメトリのSRIDを変更するだけです。

note: Tag: para
en: ST_Transform automatically selects a suitable conversion pipeline given the source and target spatial reference systems. To use a specific conversion method, use <xref linkend="ST_TransformPipeline"/>.
ja: ST_Transformは変換元空間参照系と変換先空間参照系に与える適切な変換パイプラインを自動的に選択します。特定の変換法を使用するには<xref linkend="ST_TransformPipeline"/>を使います。

note: Tag: para
en: Requires PostGIS be compiled with PROJ support. Use <xref linkend="PostGIS_Full_Version"/> to confirm you have PROJ support compiled in.
ja: PostGISはPROJ対応でコンパイルする必要があります。PROJ対応でコンパイルしたかを確認するには<xref linkend="PostGIS_Full_Version"/>を使います。

note: Tag: para
en: If using more than one transformation, it is useful to have a functional index on the commonly used transformations to take advantage of index usage.
ja: 一つ以上の変換を行う場合は、インデクスの利点を得るために、使用する変換に関する関数インデクスを持つと便利です。

note: Tag: para
en: Enhanced: 2.3.0 support for direct PROJ.4 text was introduced.
ja: Enhanced: 2.3.0 直接のPROJ.4文字列への対応が導入されました。

note: Tag: para
en: Change Massachusetts state plane US feet geometry to WGS 84 long lat
ja: マサチューセッツ州平面座標系 (アメリカ測量フィート)をWGS84経度緯度に変更します。

note: Tag: para
en: Example of creating a partial functional index. For tables where you are not sure all the geometries will be filled in, its best to use a partial index that leaves out null geometries which will both conserve space and make your index smaller and more efficient.
ja: 部分関数インデクスを作る例です。全てのジオメトリが入っているとは確信できないテーブルのためには、スペースの節約とインデクスを小さく効率的にするために、NULLジオメトリを無視する部分インデクスを使うのが最善です。

note: Tag: para
en: Examples of using PROJ.4 text to transform with custom spatial references.
ja: PROJ.4テキストを使って、独自の空間参照系に投影変換する例です。

note: Tag: title
en: Configuring transformation behavior
ja: 変換の挙動の設定

note: Tag: para
en: Sometimes coordinate transformation involving a grid-shift can fail, for example if PROJ.4 has not been built with grid-shift files or the coordinate does not lie within the range for which the grid shift is defined. By default, PostGIS will throw an error if a grid shift file is not present, but this behavior can be configured on a per-SRID basis either by testing different <varname>to_proj</varname> values of PROJ.4 text, or altering the <varname>proj4text</varname> value within the <varname>spatial_ref_sys</varname> table.
ja: グリッドシフトを含む座標変換は、ときどき失敗します。たとえば、PROJ.4にグリッドシフトファイルを付けてビルドされていなかった場合や、座標がグリッドシフト定義の範囲内に無い、といった場合です。デフォルトでは、PostGISはグリッドシフトファイルが無い場合はエラーを投げますが、この挙動は、PROJ.4 テキストの<varname>to_proj</varname>値の変更を試みたり、<varname>spatial_ref_sys</varname>テーブルの<varname>proj4text</varname>値を変更したりすることで、SRID毎の原則を設定することができます。

note: Tag: para
en: For example, the proj4text parameter +datum=NAD87 is a shorthand form for the following +nadgrids parameter:
ja: たとえば、proj4textパラメータ +datum=NAD87 は次に示す+nadgridsパラメータの短縮形です。

note: Tag: para
en: The @ prefix means no error is reported if the files are not present, but if the end of the list is reached with no file having been appropriate (ie. found and overlapping) then an error is issued.
ja: 接頭辞@は、ファイルが無くてもエラー報告をしないという意味ですが、適切だった (発見されてオーバラップした)ファイルがないままリストの終わりに達した場合はエラーが出ます。

note: Tag: para
en: If, conversely, you wanted to ensure that at least the standard files were present, but that if all files were scanned without a hit a null transformation is applied you could use:
ja: 逆に、少なくとも標準的なファイルが確実にあって欲しいけれども、該当が無いまま全てのファイルが走査された場合に、NULL変換としたいなら、次が使えます。

note: Tag: para
en: The null grid shift file is a valid grid shift file covering the whole world and applying no shift. So for a complete example, if you wanted to alter PostGIS so that transformations to SRID 4267 that didn't lie within the correct range did not throw an ERROR, you would use the following:
ja: NULLグリッドシフトファイルは、世界全体をカバーして、シフトを行わない、妥当なグリッドシフトファイルです。 完全な例のために、正しい範囲にないSRID 4267への変換でエラーが投げられないようPostGISを変えたいなら、次のようにします。

note: Tag: refpurpose
en: <refpurpose>Return a new geometry with coordinates transformed to a different spatial reference system using a defined coordinate transformation pipeline.</refpurpose>
ja: <refpurpose>定義されている座標変換パイプラインを使用して異なる空間参照系に変換された新しいジオメトリを返します。</refpurpose>

note: Tag: para
en: <para>Return a new geometry with coordinates transformed to a different spatial reference system using a defined coordinate transformation pipeline.</para>
ja: <para>定義されている座標変換パイプラインを使用して異なる空間参照系に変換された新しいジオメトリを返します。</para>

note: Tag: para
en: Transformation pipelines are defined using any of the following string formats:
ja: 変換パイプラインは次の文字列書式のいずれかをつかって定義されます。

note: Tag: para
en: <varname>urn:ogc:def:coordinateOperation:AUTHORITY::CODE</varname>. Note that a simple <varname>EPSG:CODE</varname> string does not uniquely identify a coordinate operation: the same EPSG code can be used for a CRS definition.
ja: <varname>urn:ogc:def:coordinateOperation:AUTHORITY::CODE</varname>。単純な<varname>EPSG:CODE</varname>文字列は座標操作を一意に識別できません。CRS定義に同じEPSGコードが使用できるためです。

note: Tag: para
en: A PROJ pipeline string of the form: <varname>+proj=pipeline ...</varname>. Automatic axis normalisation will not be applied, and if necessary the caller will need to add an additional pipeline step, or remove <varname>axisswap</varname> steps.
ja: PROJパイプライン文字列: <varname>+proj=pipeline ...</varname>。自動の軸正規化が適用されません。必要なら呼び出し元が追加のパイプライン段階を必要とします。もしくは<varname>axisswap</varname>段階を削除する必要があります。

note: Tag: para
en: Concatenated operations of the form: <varname>urn:ogc:def:coordinateOperation,coordinateOperation:EPSG::3895,coordinateOperation:EPSG::1618</varname>.
ja: 操作の連結: <varname>urn:ogc:def:coordinateOperation,coordinateOperation:EPSG::3895,coordinateOperation:EPSG::1618</varname>。

note: Tag: para
en: The SRID of the input geometry is ignored, and the SRID of the output geometry will be set to zero unless a value is provided via the optional <varname>to_srid</varname> parameter. When using `ST_TransformPipeline()` the pipeline is executed in a forward direction. Using <xref linkend="ST_InverseTransformPipeline"/> the pipeline is executed in the inverse direction.
ja: 入力ジオメトリのSRIDは無視され、任意パラメータ <varname>to_srid</varname> から値が提供されていない場合には出力ジオメトリのSRIDは0に設定されます。`ST_TransformPipeline()`を使うときには、パイプラインが順方向に実行されます。<xref linkend="ST_InverseTransformPipeline"/>を使うと、パイプラインは逆方向に実行されます。

note: Tag: refpurpose
en: Return the list of SRS codes associated with the given authority.
ja: 指定した機関に関連付けられたSRSコードの一覧を返します。

note: Tag: para
en: Returns a set of all <varname>auth_srid</varname> for the given <varname>auth_name</varname>.
ja: 与えられた<varname>auth_name</varname>に関する全ての<varname>auth_srid</varname>の集合を返します。

note: Tag: para
en: Proj version 6+
ja: Proj 6以上

note: Tag: para
en: List the first ten codes associated with the EPSG authority.
ja: EPSG機関に関連付けられているコードの最初の10件の一覧を得ます。

note: Tag: refpurpose
en: Return a metadata record for the requested authority and srid.
ja: 求める機関と空間参照識別子に関するメタデータレコードを返します。

note: Tag: para
en: Returns a metadata record for the requested <varname>auth_srid</varname> for the given <varname>auth_name</varname>. The record will have the <varname>auth_name</varname>, <varname>auth_srid</varname>, <varname>srname</varname>, <varname>srtext</varname>, <varname>proj4text</varname>, and the corners of the area of usage, <varname>point_sw</varname> and <varname>point_ne</varname>.
ja: 指定した<varname>auth_name</varname>に関して求める<varname>auth_srid</varname>のメタデータレコードを貸します。レコードには<varname>auth_name</varname>, <varname>auth_srid</varname>, <varname>srname</varname>, <varname>srtext</varname>, <varname>proj4text</varname>と適用範囲の隅を示す<varname>point_sw</varname>と<varname>point_ne</varname>が含まれます。

note: Tag: para
en: Get the metadata for EPSG:3005.
ja: EPSG:3005のメタデータを取得します。

note: Tag: refpurpose
en: Return metadata records for every spatial reference system in the underlying Proj database.
ja: Projデータベース内のあらゆる空間参照系のメタデータレコードを返します。

note: Tag: funcdef
en: setof record <function>postgis_srs_all</function>
ja: <function>postgis_srs_all</function>レコードの集合

note: Tag: para
en: Returns a set of all metadata records in the underlying Proj database. The records will have the <varname>auth_name</varname>, <varname>auth_srid</varname>, <varname>srname</varname>, <varname>srtext</varname>, <varname>proj4text</varname>, and the corners of the area of usage, <varname>point_sw</varname> and <varname>point_ne</varname>.
ja: Projデータベース内にある全てのメタデータレコードを返します。レコードには<varname>auth_name</varname>, <varname>auth_srid</varname>, <varname>srname</varname>, <varname>srtext</varname>, <varname>proj4text</varname>と適用範囲の隅を示す<varname>point_sw</varname>と<varname>point_ne</varname>が含まれます。

note: Tag: para
en: Get the first 10 metadata records from the Proj database.
ja: Projデータベースから最初の10件のメタデータレコードを得ます。

note: Tag: refpurpose
en: Return metadata records for projected coordinate systems that have areas of usage that fully contain the bounds parameter.
ja: boundsパラメータを完全に含む適用範囲を持つ投影座標系のメタデータレコードを返します。

note: Tag: para
en: Return a set of metadata records for projected coordinate systems that have areas of usage that fully contain the bounds parameter. Each record will have the <varname>auth_name</varname>, <varname>auth_srid</varname>, <varname>srname</varname>, <varname>srtext</varname>, <varname>proj4text</varname>, and the corners of the area of usage, <varname>point_sw</varname> and <varname>point_ne</varname>.
ja: boundsパラメータを完全に含む適用範囲を持つ投影座標系のメタデータレコードを返します。レコードには<varname>auth_name</varname>, <varname>auth_srid</varname>, <varname>srname</varname>, <varname>srtext</varname>, <varname>proj4text</varname>と適用範囲の隅を示す<varname>point_sw</varname>と<varname>point_ne</varname>が含まれます。

note: Tag: para
en: The search only looks for projected coordinate systems, and is intended for users to explore the possible systems that work for the extent of their data.
ja: この検索では、投影座標系のみが対象となります。お持ちのデータの範囲で動作しうる座標系を探索することを目的としています。

note: Tag: para
en: Search for projected coordinate systems in Louisiana.
ja: ルイジアナ州の投影座標系を探索します。

note: Tag: para
en: Scan a table for max extent and find projected coordinate systems that might suit.
ja: 最大範囲を得るためにテーブルをスキャンして、適していると言えそうな投影座標系を見つけます。

note: Tag: title
en: Trajectory Functions
ja: トラジェクトリ関数

note: Tag: para
en: These functions support working with trajectories. A trajectory is a linear geometry with increasing measures (M value) on each coordinate. Spatio-temporal data can be modeled by using relative times (such as the epoch) as the measure values.
ja: これらの関数はトラジェクトリで動作します。トラジェクトリは、M値が座標ごとに増加していく線形ジオメトリです。時空間データはM値を相対時間 (エポック等)としてモデル化できます。

note: Tag: refpurpose
en: Tests if the geometry is a valid trajectory.
ja: ジオメトリが妥当なトラジェクトリであるかどうかをテストします。

note: Tag: para
en: Tests if a geometry encodes a valid trajectory. A valid trajectory is represented as a <varname>LINESTRING</varname> with measures (M values). The measure values must increase from each vertex to the next.
ja: ジオメトリが妥当なトラジェクトリの符号化したものとなっているかをテストします。妥当なトラジェクトリは、M値 (Measure)を持つ<varname>LINESTRING</varname>で表現されます。M値は始点から順次増加していかなければなりません。

note: Tag: para
en: Valid trajectories are expected as input to spatio-temporal functions like <xref linkend="ST_ClosestPointOfApproach"/>
ja: <xref linkend="ST_ClosestPointOfApproach"/>等の時空間関数は、妥当なトラジェクトリを入力値として期待します。

note: Tag: refpurpose
en: Returns a measure at the closest point of approach of two trajectories.
ja: 二つのトラジェクトリの最接近時の距離を返します。

note: Tag: para
en: Returns the smallest measure at which points interpolated along the given trajectories are the least distance apart.
ja: 与えられたトラジェクトリに沿って補間された最小距離となる点のM値の最小値を返します。

note: Tag: para
en: Inputs must be valid trajectories as checked by <xref linkend="ST_IsValidTrajectory"/>. Null is returned if the trajectories do not overlap in their M ranges.
ja: 妥当なトラジェクトリは<xref linkend="ST_IsValidTrajectory"/>で確認できます。トラジェクトリのM値の範囲が重ならない場合にはNULLが返ります。

note: Tag: para
en: To obtain the actual points at the computed measure use <xref linkend="ST_LocateAlong"/> .
ja: 計算されたM値で実際のポイントを得るには<xref linkend="ST_LocateAlong"/>を使います。

note: Tag: refpurpose
en: Returns the distance between the closest point of approach of two trajectories.
ja: 二つのトラジェクトリの最接近する時の距離を返します。

note: Tag: para
en: Returns the distance (in 2D) between two trajectories at their closest point of approach.
ja: 二つのトラジェクトリの最接近する時の (2次元)距離を返します。

note: Tag: refpurpose
en: Tests if the closest point of approach of two trajectories is within the specified distance.
ja: 二つのトラジェクトリの最接近時の距離が指定距離内であるかどうかをテストします。

note: Tag: para
en: Tests whether two moving objects have ever been closer than the specified distance.
ja: 二つの移動オブジェクトが指定距離より近づいているかどうかをテストします。

note: Tag: para
en: Inputs must be valid trajectories as checked by <xref linkend="ST_IsValidTrajectory"/>. False is returned if the trajectories do not overlap in their M ranges.
ja: 入力は<xref linkend="ST_IsValidTrajectory"/>で確認された妥当なトラジェクトリでなければなりません。トラジェクトリのM値の範囲が重ならない場合にはFALSEを返します。

note: Tag: title
en: Affine Transformations
ja: アフィン変換

note: Tag: para
en: These functions change the position and shape of geometries using <link xlink:href="https://en.wikipedia.org/wiki/Affine_transformation">affine transformations</link>.
ja: これらの関数は<link xlink:href="https://ja.wikipedia.org/wiki/%E3%82%A2%E3%83%95%E3%82%A3%E3%83%B3%E5%86%99%E5%83%8F">アフィン変換</link>を使用してジオメトリの位置と形状を変更するものです。

note: Tag: refpurpose
en: Apply a 3D affine transformation to a geometry.
ja: ジオメトリに3次元アフィン変換を適用します。

note: Tag: para
en: Applies a 3D affine transformation to the geometry to do things like translate, rotate, scale in one step.
ja: 3次元アフィン変換をジオメトリに適用して移動、回転、拡大縮小を一度に行います。

note: Tag: para
en: Version 1: The call <programlisting>ST_Affine(geom, a, b, c, d, e, f, g, h, i, xoff, yoff, zoff) </programlisting> represents the transformation matrix <programlisting>/ a  b  c  xoff \
    | d  e  f  yoff |
    | g  h  i  zoff |
    \ 0  0  0     1 /</programlisting> and the vertices are transformed as follows: <programlisting>x' = a*x + b*y + c*z + xoff
    y' = d*x + e*y + f*z + yoff
    z' = g*x + h*y + i*z + zoff</programlisting> All of the translate / scale functions below are expressed via such an affine transformation.
ja: 一つ目の形式では、次のように関数を呼んでいます。<programlisting>ST_Affine(geom, a, b, c, d, e, f, g, h, i, xoff, yoff, zoff) </programlisting> これは次のような変換行列を表現しています。<programlisting>/ a  b  c  xoff \
    | d  e  f  yoff |
    | g  h  i  zoff |
    \ 0  0  0     1 /</programlisting>次のようにも表現できます。<programlisting>x' = a*x + b*y + c*z + xoff
    y' = d*x + e*y + f*z + yoff
    z' = g*x + h*y + i*z + zoff</programlisting>全ての移動/拡大縮小関数はこのようなアフィン変換を経由しています。

note: Tag: para
en: Version 2: Applies a 2d affine transformation to the geometry. The call <programlisting>ST_Affine(geom, a, b, d, e, xoff, yoff)</programlisting> represents the transformation matrix <programlisting>/  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  /</programlisting> and the vertices are transformed as follows: <programlisting>x' = a*x + b*y + xoff
    y' = d*x + e*y + yoff
    z' = z </programlisting> This method is a subcase of the 3D method above.
ja: 二つ目の形式では、2次元アフィン変換をジオメトリに適用します。次のように関数を呼んでいます。<programlisting>ST_Affine(geom, a, b, d, e, xoff, yoff)</programlisting>これは次のような変換行列を表現しています。<programlisting>/  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  /</programlisting>頂点は次のように変換されます。<programlisting>x' = a*x + b*y + xoff
    y' = d*x + e*y + yoff
    z' = z </programlisting>このメソッドは上述の3次元メソッドの特異ケースです。

note: Tag: para
en: Availability: 1.1.2. Name changed from Affine to ST_Affine in 1.2.2
ja: Availability: 1.1.2 AffineからST_Affineに名称変更しました。

note: Tag: refpurpose
en: Rotates a geometry about an origin point.
ja: ジオメトリを原点について回転させます。

note: Tag: para
en: Rotates geometry rotRadians counter-clockwise about the origin point. The rotation origin can be specified either as a POINT geometry, or as x and y coordinates. If the origin is not specified, the geometry is rotated about POINT(0 0).
ja: ジオメトリを原点について反時計回りにrotRadiasnぶん回転させます。原点はPOINTジオメトリか、xとyの座標値を指定します。原点を指定しない場合にはPOINT(0,0)について回転させます。

note: Tag: para
en: Enhanced: 2.0.0 additional parameters for specifying the origin of rotation were added.
ja: Enhanced: 2.0.0 回転の原点を指定するパラメタを追加しました。

note: Tag: para
en: Availability: 1.1.2. Name changed from Rotate to ST_Rotate in 1.2.2
ja: Availability: 1.1.2 RotateからST_Rotateに名称変更しました。

note: Tag: refpurpose
en: Rotates a geometry about the X axis.
ja: ジオメトリをX軸について回転させます。

note: Tag: para
en: Rotates a geometry geomA - rotRadians about the X axis.
ja: ジオメトリgeomAをX軸についてrotRadiansぶん回転させます。

note: Tag: para
en: <code>ST_RotateX(geomA, rotRadians)</code> is short-hand for <code>ST_Affine(geomA, 1, 0, 0, 0, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), cos(rotRadians), 0, 0, 0)</code>.
ja: <code>ST_RotateX(geomA, rotRadians)</code>は<code>ST_Affine(geomA, 1, 0, 0, 0, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), cos(rotRadians), 0, 0, 0)</code>の短縮版です。

note: Tag: para
en: Availability: 1.1.2. Name changed from RotateX to ST_RotateX in 1.2.2
ja: Availability: 1.1.2 1.2.2でRotateXからST_RotateXに名称変更しました。

note: Tag: refpurpose
en: Rotates a geometry about the Y axis.
ja: ジオメトリをY軸について回転させます。

note: Tag: para
en: Rotates a geometry geomA - rotRadians about the y axis.
ja: ジオメトリgeomAをY軸についてrotRadiansぶん回転させます。

note: Tag: para
en: <code>ST_RotateY(geomA, rotRadians)</code> is short-hand for <code>ST_Affine(geomA, cos(rotRadians), 0, sin(rotRadians), 0, 1, 0, -sin(rotRadians), 0, cos(rotRadians), 0, 0, 0)</code>.
ja: <code>ST_RotateY(geomA, rotRadians)</code>は<code>ST_Affine(geomA, cos(rotRadians), 0, sin(rotRadians), 0, 1, 0, -sin(rotRadians), 0, cos(rotRadians), 0, 0, 0)</code>の省略形です。

note: Tag: para
en: Availability: 1.1.2. Name changed from RotateY to ST_RotateY in 1.2.2
ja: Availability: 1.1.2 1.2.2でRotateYからST_RotateYに名称変更しました。

note: Tag: refpurpose
en: Rotates a geometry about the Z axis.
ja: ジオメトリをZ軸について回転させます。

note: Tag: para
en: Rotates a geometry geomA - rotRadians about the Z axis.
ja: ジオメトリgeomAをZ軸についてrotRadiansぶん回転させます。

note: Tag: para
en: This is a synonym for ST_Rotate
ja: この関数はST_Rotateと同じです。

note: Tag: para
en: <code>ST_RotateZ(geomA, rotRadians)</code> is short-hand for <code>SELECT ST_Affine(geomA, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), cos(rotRadians), 0, 0, 0, 1, 0, 0, 0)</code>.
ja: <code>ST_RotateZ(geomA, rotRadians)</code>は<code>SELECT ST_Affine(geomA, cos(rotRadians), -sin(rotRadians), 0, sin(rotRadians), cos(rotRadians), 0, 0, 0, 1, 0, 0, 0)</code>の短縮版です。

note: Tag: para
en: Availability: 1.1.2. Name changed from RotateZ to ST_RotateZ in 1.2.2
ja: Availability: 1.1.2 1.2.2でRotateZからST_RotateZに名称変更しました。

note: Tag: refpurpose
en: Scales a geometry by given factors.
ja: 与えた係数でジオメトリを拡大縮小します。

note: Tag: para
en: Scales the geometry to a new size by multiplying the ordinates with the corresponding factor parameters.
ja: 対応するパラメータで軸を乗算してジオメトリを新しいサイズに拡大縮小します。

note: Tag: para
en: The version taking a geometry as the <varname>factor</varname> parameter allows passing a 2d, 3dm, 3dz or 4d point to set scaling factor for all supported dimensions. Missing dimensions in the <varname>factor</varname> point are equivalent to no scaling the corresponding dimension.
ja: <varname>factor</varname>パラメータでジオメトリを取る形式では、2次元、3次元 (XYZ. XYM)、4次元のポイントで、全ての対応する次元のスケーリングの乗数を設定することができます。<varname>factor</varname>ポイントの欠けた次元については、対応する次元は拡大縮小をしないのと等価になります。

note: Tag: para
en: The three-geometry variant allows a "false origin" for the scaling to be passed in. This allows "scaling in place", for example using the centroid of the geometry as the false origin. Without a false origin, scaling takes place relative to the actual origin, so all coordinates are just multiplied by the scale factor.
ja: 三つのジオメトリを与える形式では、拡大縮小に「仮原点」を渡すことができます。これにより、たとえば、仮原点としてジオメトリの重心を使うといった、「適切な位置での拡大縮小」が可能となります。仮原点を使わない場合には、拡大縮小は実際の原点からの位置で行われるので、全ての座標は拡大縮小係数との積になります。

note: Tag: para
en: Availability: 1.1.0.
ja: Availability: 1.1.0

note: Tag: para
en: Enhanced: 2.2.0 support for scaling all dimension (<varname>factor</varname> parameter) was introduced.
ja: Enhanced: 2.2.0 全ての次元の拡大縮小 (<varname>factor</varname>パラメータ)への対応が導入されました。

note: Tag: para
en: Enhanced: 2.5.0 support for scaling relative to a local origin (<varname>origin</varname> parameter) was introduced.
ja: Enhanced: 2.5.0 局所原点 (<varname>origin</varname>パラメータ)を使った拡大縮小への対応を導入しました。

note: Tag: refpurpose
en: Translates a geometry by given offsets.
ja: 与えられたオフセットでジオメトリを変換します。

note: Tag: para
en: Returns a new geometry whose coordinates are translated delta x,delta y,delta z units. Units are based on the units defined in spatial reference (SRID) for this geometry.
ja: deltax, deltay, deltazぶん移動した新しいジオメトリを返します。単位は、このジオメトリの空間参照系 (SRID)で定義された単位です。

note: Tag: para
en: Move a point 1 degree longitude
ja: ポイントを経度1度ぶん移動させます。

note: Tag: para
en: Move a linestring 1 degree longitude and 1/2 degree latitude
ja: ラインストリングを緯度1度ぶん、経度1/2度ぶん移動させます。

note: Tag: para
en: Move a 3d point
ja: 3次元ポイントを移動させます。

note: Tag: para
en: Move a curve and a point
ja: 曲線とポイントを移動させます。

note: Tag: refpurpose
en: Translates and scales a geometry by given offsets and factors.
ja: 与えられた係数とオフセットでジオメトリを変換します。

note: Tag: para
en: Translates the geometry using the deltaX and deltaY args, then scales it using the XFactor, YFactor args, working in 2D only.
ja: deltaXとdeltaY引数を使ってジオメトリを移動させ、XFactor,YFactor引数で拡大縮小させます。2次元でのみ動作します。

note: Tag: para
en: <code>ST_TransScale(geomA, deltaX, deltaY, XFactor, YFactor)</code> is short-hand for <code>ST_Affine(geomA, XFactor, 0, 0, 0, YFactor, 0, 0, 0, 1, deltaX*XFactor, deltaY*YFactor, 0)</code>.
ja: <code>ST_TransScale(geomA, deltaX, deltaY, XFactor, YFactor)</code>は<code>ST_Affine(geomA, XFactor, 0, 0, 0, YFactor, 0, 0, 0, 1, deltaX*XFactor, deltaY*YFactor, 0)</code>の短縮版です。

note: Tag: title
en: Troubleshooting Functions
ja: トラブルシューティング関数

note: Tag: para
en: These functions are utilities for troubleshooting and repairing geometry data. They are only needed if the geometry data is corrupted in some way, which should never happen under normal circumstances.
ja: これらの関数はトラブルシューティングとジオメトリデータの修復を行うためのものです。ジオメトリデータが、通常の環境では発生しえない出来事によって破損している場合のみ有効です。

note: Tag: title
en: PostGIS Geometry/Geography/Box Data Types
ja: PostGIS Geometry/Geography/Box データ型

note: Tag: para
en: This section lists the custom PostgreSQL data types installed by PostGIS to represent spatial data.
ja: このセクションでは、空間データを表現するためにPostGISとともにインストールされたカスタムPostgreSQLデータ型の一覧を示します。

note: Tag: para
en: Each data type describes its type casting behavior. A <link xlink:href="https://www.postgresql.org/docs/current/sql-expressions.html#SQL-SYNTAX-TYPE-CASTS">type cast</link> converts values of one data type into another type. PostgreSQL allows defining casting behavior for custom types, along with the functions used to convert type values. Casts can have <emphasis role="bold">automatic</emphasis> behavior, which allows automatic conversion of a function argument to a type supported by the function.
ja: データ型ごとに、型キャストのふるまいが記述されています。<link xlink:href="https://www.postgresql.jp/document/current/html/sql-expressions.html#SQL-SYNTAX-TYPE-CASTS">型キャスト</link>によって、あるデータ型の値が他のデータ型に変換されます。PostgreSQLでは、型を変換するために使われる関数に加えて、ユーザ定義型のキャストのふるまいの定義が可能です。キャストは<emphasis role="bold">自動</emphasis>的なふるまいを持つことができ、それによって、関数の引数をその関数が対応する型に自動的に変換できます。

note: Tag: para
en: Some casts have <emphasis role="bold">explicit</emphasis> behavior, which means the cast must be specified using the syntax <varname>CAST(myval As sometype)</varname> or <varname>myval::sometype</varname>. Explicit casting avoids the issue of ambiguous casts, which can occur when using an overloaded function which does not support a given type. For example, a function may accept a box2d or a box3d, but not a geometry. Since geometry has an automatic cast to both box types, this produces an "ambiguous function" error. To prevent the error use an explicit cast to the desired box type.
ja: キャストには<emphasis role="bold">明示的な</emphasis>ふるまいがあります。このふるまいは、キャストは<varname>CAST(myval As sometype)</varname>または<varname>myval::sometype</varname>という書式で指定されます。与えられた型に対応していないオーバロード関数を使うときに発生するあいまいなキャストの問題は、明示的なキャストによって回避できます。例えば、関数はbox2dまたはbox3dを受け付けるがジオメトリを受け付けない場合です。ジオメトリはボックス型の両方への自動キャストが可能なため、「あいまいな関数」エラーが発生します。このエラーを防ぐには、求められるボックス型への明示的なキャストを使用します。

note: Tag: para
en: All data types can be cast to <varname>text</varname>, so this does not need to be specified explicitly.
ja: 全てのデータ型は<varname>text</varname>にキャストできます。このため、明示的に指定する必要はありません。

note: Tag: refpurpose
en: The type representing a 2-dimensional bounding box.
ja: 2次元バウンディングボックスを表現する型。

note: Tag: para
en: <varname>box2d</varname> is a spatial data type used to represent the two-dimensional bounding box enclosing a geometry or collection of geometries. For example, the <xref linkend="ST_Extent"/> aggregate function returns a <varname>box2d</varname> object.
ja: <varname>box2d</varname>は、ジオメトリまたはジオメトリコレクションの、2次元の囲い込んでいるボックスを表現するために使われる空間データ型です。たとえば、集約関数<xref linkend="ST_Extent"/>は<varname>box2d</varname>インスタンスを返します。

note: Tag: para
en: The representation contains the values <varname>xmin, ymin, xmax, ymax</varname>. These are the minimum and maximum values of the X and Y extents.
ja: <varname>xmin, ymin, xmax, ymax</varname>の値を含む表現。これらは、XとYの範囲の最小値と最大値を示しています。

note: Tag: para
en: <varname>box2d</varname> objects have a text representation which looks like <code>BOX(1 2,5 6)</code>.
ja: <varname>box2d</varname>のテキスト表現は<code>BOX(1 2,5 6)</code>のようになります。

note: Tag: para
en: This table lists the automatic and explicit casts allowed for this data type:
ja: このテーブルでは、このデータ型で許容される明示的なキャストと自動キャストの一覧を挙げます。

note: Tag: refpurpose
en: The type representing a 3-dimensional bounding box.
ja: 3次元バウンディングボックスを表現する型。

note: Tag: para
en: <varname>box3d</varname> is a PostGIS spatial data type used to represent the three-dimensional bounding box enclosing a geometry or collection of geometries. For example, the <xref linkend="ST_3DExtent"/> aggregate function returns a <varname>box3d</varname> object.
ja: <varname>box3d</varname>は、ジオメトリまたはジオメトリのコレクションを囲む3次元のボックスを表現するために使われるPostGIS空間データ型です。たとえば、集約関数の<xref linkend="ST_3DExtent"/>は<varname>box3d</varname>オブジェクトを返します。

note: Tag: para
en: The representation contains the values <varname>xmin, ymin, zmin, xmax, ymax, zmax</varname>. These are the minimum and maximum values of the X, Y and Z extents.
ja: この表現は、<varname>xmin, ymin, zmin, xmax, ymax, zmax</varname>です。これらは、X, Y, Zの範囲の最小値と最大値を取ります。

note: Tag: para
en: <varname>box3d</varname> objects have a text representation which looks like <code>BOX3D(1 2 3,5 6 5)</code>.
ja: <varname>box3d</varname>のテキスト表現は<code>BOX3D(1 2 3,5 6 5)</code>のようになります。

note: Tag: refpurpose
en: The type representing spatial features with planar coordinate systems.
ja: 平面座標系を持つ空間地物を表現する型。

note: Tag: para
en: <varname>geometry</varname> is a fundamental PostGIS spatial data type used to represent a feature in planar (Euclidean) coordinate systems.
ja: <varname>geometry</varname>は、平面 (ユークリッド)座標系上の地物を表現するために使われる基本的なPostGISの空間データ型です。

note: Tag: para
en: All spatial operations on geometry use the units of the Spatial Reference System the geometry is in.
ja: ジオメトリ上の全ての空間演算子は、ジオメトリが所属する空間参照系の単位を使います。

note: Tag: refpurpose
en: A composite type used to describe the parts of complex geometry.
ja: 複雑なジオメトリの部品を記述するために使われる複合型です。

note: Tag: para
en: <varname>geometry_dump</varname> is a <link xlink:href="https://www.postgresql.org/docs/current/rowtypes.html">composite data type</link> containing the fields:
ja: <varname>geometry_dump</varname>は、次のフィールドを持つ<link xlink:href="https://www.postgresql.jp/document/current/html/rowtypes.html">複合型</link>です。

note: Tag: para
en: <varname>geom</varname> - a geometry representing a component of the dumped geometry. The geometry type depends on the originating function.
ja: <varname>geom</varname> - ダンプされたジオメトリの要素を表現するジオメトリです。ジオメトリタイプは、使われた関数に依存します。

note: Tag: para
en: <varname>path[]</varname> - an integer array that defines the navigation path within the dumped geometry to the <varname>geom</varname> component. The path array is 1-based (i.e. <varname>path[1]</varname> is the first element.)
ja: <varname>path[]</varname> - ダンプされたジオメトリ内における<varname>geom</varname>要素へのパスを定義する1次整数配列。パス配列は1始まりです (<varname>path[1]</varname>が最初の要素です)。

note: Tag: para
en: It is used by the <varname>ST_Dump*</varname> family of functions as an output type to explode a complex geometry into its constituent parts.
ja: <varname>ST_Dump*</varname>系関数で複雑なジオメトリを構成部品に分解する出力型として使います。

note: Tag: refpurpose
en: The type representing spatial features with geodetic (ellipsoidal) coordinate systems.
ja: 地理座標系 (回転楕円体)座標系を持つ空間地物を表現する型です。

note: Tag: para
en: <varname>geography</varname> is a spatial data type used to represent a feature in geodetic coordinate systems. Geodetic coordinate systems model the earth using an ellipsoid.
ja: <varname>geography</varname>は、地理座標系上で地物を表現するために使われる空間型です。地理座標系は回転楕円体で地球をモデル化します。

note: Tag: para
en: Spatial operations on the geography type provide more accurate results by taking the ellipsoidal model into account.
ja: ジオグラフィ型を用いた空間演算によって、回転楕円体モデルを考慮するので、より精度の良い結果が得られます。

note: Tag: entry
en: explicit
ja: 明示的なキャスト

note: Tag: title
en: Geometry Validation
ja: ジオメトリ検証

note: Tag: para
en: These functions test whether geometries are valid according to the OGC SFS standard. They also provide information about the nature and location of invalidity. There is also a function to create a valid geometry out of an invalid one.
ja: これらの関数は、ジオメトリがOGC SFS標準として妥当かどうかをテストします。また、不正となった場合の種類と位置に関する情報の提供も行います。不正なジオメトリから妥当なジオメトリを生成する機能もあります。

note: Tag: refpurpose
en: Tests if a geometry is well-formed in 2D.
ja: ジオメトリが2次元で整形されているかのテスト。

note: Tag: para
en: Tests if an ST_Geometry value is well-formed and valid in 2D according to the OGC rules. For geometries with 3 and 4 dimensions, the validity is still only tested in 2 dimensions. For geometries that are invalid, a PostgreSQL NOTICE is emitted providing details of why it is not valid.
ja: ST_Geometry値が整形式であり、2次元で妥当かどうかをOGC規則に沿ってテストします。3次元と4次元のジオメトリでは、評価は2次元で行います。ジオメトリが不正なら、PostgreSQL NOTICEが出力され、不正である理由の詳細が示されます。

note: Tag: para
en: For the version with the <varname>flags</varname> parameter, supported values are documented in <xref linkend="ST_IsValidDetail"/> This version does not print a NOTICE explaining invalidity.
ja: <varname>flags</varname>パラメータを持つ版が対応する値については<xref linkend="ST_IsValidDetail"/>で説明しています。

note: Tag: para
en: For more information on the definition of geometry validity, refer to <xref linkend="OGC_Validity"/>
ja: ジオメトリ評価に関する詳細情報については<xref linkend="OGC_Validity"/>を参照してください。

note: Tag: para
en: SQL-MM defines the result of ST_IsValid(NULL) to be 0, while PostGIS returns NULL.
ja: SQL-MMでは、ST_IsValid(NULL)は0を返しますが、PostGISではNULLを返します。

note: Tag: para
en: The version accepting flags is available starting with 2.0.0.
ja: フラグを受け付ける形式は、2.0.0から有効になりました。

note: Tag: para
en: Neither OGC-SFS nor SQL-MM specifications include a flag argument for ST_IsValid. The flag is a PostGIS extension.
ja: OGC-SFSもSQL-MMもST_IsValidでフラグ引数を含む仕様になっていません。フラグはPostGIS独自拡張です。

note: Tag: refpurpose
en: Returns a <varname>valid_detail</varname> row stating if a geometry is valid or if not a reason and a location.
ja: ジオメトリが妥当か、妥当でないなら理由と位置をそれぞれ示す<varname>valid_detail</varname>行を返します。

note: Tag: para
en: Returns a <varname>valid_detail</varname> row, containing a boolean (<varname>valid</varname>) stating if a geometry is valid, a varchar (<varname>reason</varname>) stating a reason why it is invalid and a geometry (<varname>location</varname>) pointing out where it is invalid.
ja: <varname>valid_detail</varname>行を返します。これには、ジオメトリが妥当かどうかを示す真偽値 (<varname>valid</varname>)、不正である理由を示す文字列 (<varname>reason</varname>)、不正である位置を指摘するジオメトリ (<varname>location</varname>)からなります。

note: Tag: para
en: Useful to improve on the combination of <xref linkend="ST_IsValid"/> and <xref linkend="ST_IsValidReason"/> to generate a detailed report of invalid geometries.
ja: 不正ジオメトリの詳細報告の生成をする<xref linkend="ST_IsValid"/>と<xref linkend="ST_IsValidReason"/>の組み合わせを改善するために使います。

note: Tag: para
en: The optional <varname>flags</varname> parameter is a bitfield. It can have the following values:
ja: 任意パラメータ<varname>flags</varname>はビットフィールドです。次の値を持つことができます。

note: Tag: para
en: 0: Use usual OGC SFS validity semantics.
ja: 0: 通常のOGC SFS評価モデルを使用します。

note: Tag: para
en: 1: Consider certain kinds of self-touching rings (inverted shells and exverted holes) as valid. This is also known as "the ESRI flag", since this is the validity model used by those tools. Note that this is invalid under the OGC model.
ja: 1: ある種の自己接触リング (逆の外リングと逆の穴リング)を妥当とします。この評価モデルはこれらのツールで使われるため「ESRIフラグ」とも言われます。OGCモデルでは不正とされることに注意してください。

note: Tag: refpurpose
en: Returns text stating if a geometry is valid, or a reason for invalidity.
ja: ジオメトリが妥当か否かを示す文字列を返し、不正な場合は理由を返します。

note: Tag: para
en: Returns text stating if a geometry is valid, or if invalid a reason why.
ja: ジオメトリが妥当かどうか、不正な場合はその理由を示す文字列を返します。

note: Tag: para
en: Useful in combination with <xref linkend="ST_IsValid"/> to generate a detailed report of invalid geometries and reasons.
ja: 不正なジオメトリと理由の詳細報告を生成するのに、<xref linkend="ST_IsValid"/>と併用します。

note: Tag: para
en: Allowed <varname>flags</varname> are documented in <xref linkend="ST_IsValidDetail"/>.
ja: 許される<varname>flags</varname>は、 <xref linkend="ST_IsValidDetail"/>にあります。

note: Tag: para
en: Availability: 2.0 version taking flags.
ja: Availability: 2.0 フラグを取る形式。

note: Tag: refpurpose
en: Attempts to make an invalid geometry valid without losing vertices.
ja: 頂点を失うことなしに不正なジオメトリを妥当なジオメトリにしようと試みます。

note: Tag: para
en: The function attempts to create a valid representation of a given invalid geometry without losing any of the input vertices. Valid geometries are returned unchanged.
ja: 与えられた不正なジオメトリを、入力ジオメトリの頂点を捨てずに、妥当な表現で生成しようとします。妥当なジオメトリは変更せずに返します。

note: Tag: para
en: Supported inputs are: POINTS, MULTIPOINTS, LINESTRINGS, MULTILINESTRINGS, POLYGONS, MULTIPOLYGONS and GEOMETRYCOLLECTIONS containing any mix of them.
ja: 対応する入力はPOINTS, MULTIPOINTS, LINESTRING, MULTILINESTRING, POLYGON, MULTIPOLYGON, GEOMETRYCOLLECTIONおよびそれらの混交したものです。

note: Tag: para
en: In case of full or partial dimensional collapses, the output geometry may be a collection of lower-to-equal dimension geometries, or a geometry of lower dimension.
ja: 完全または部分的な次元崩壊の場合には、出力ジオメトリは、同次元まはた低い次元のジオメトリのコレクションか、低い次元のジオメトリコレクションになります。

note: Tag: para
en: Single polygons may become multi-geometries in case of self-intersections.
ja: 単一ポリゴンは、自己インタセクトがある場合には、マルチポリゴンになります。

note: Tag: para
en: The <varname>params</varname> argument can be used to supply an options string to select the method to use for building valid geometry. The options string is in the format "method=linework|structure keepcollapsed=true|false". If no "params" argument is provided, the "linework" algorithm will be used as the default.
ja: <varname>params</varname>引数は、妥当なジオメトリを構築するために使うメソッドを選択するための任意文字列を与えるのに使えます。任意文字列は"method=linework|structure keepcollapsed=true|false"という書式に従います。"params"引数が無い場合には、"linework"アルゴリズムがデフォルトとして使われます。

note: Tag: para
en: The "method" key has two values.
ja: "method"キーに対して取り得る値は二つあります。

note: Tag: para
en: "linework" is the original algorithm, and builds valid geometries by first extracting all lines, noding that linework together, then building a value output from the linework.
ja: "linework"は従来のアルゴリズムです。はじめに全てのラインを抽出し、線画からノードを生成して、そこから妥当なジオメトリを構築します。

note: Tag: para
en: "structure" is an algorithm that distinguishes between interior and exterior rings, building new geometry by unioning exterior rings, and then differencing all interior rings.
ja: "structure"は、リングの内と外の間を識別して、外リングを結合し、全ての内リングとの差を取ることで新しいジオメトリを構築します。

note: Tag: para
en: The "keepcollapsed" key is only valid for the "structure" algorithm, and takes a value of "true" or "false". When set to "false", geometry components that collapse to a lower dimensionality, for example a one-point linestring would be dropped.
ja: "keepcollapsed"キーは"structure"アルゴリズムでのみ有効です。"true"または"false"を取ります。"false"が指定された場合には、1点のLINESTRING等のような低い次元に崩壊したジオメトリ要素が出てきます。

note: Tag: para
en: Enhanced: 2.0.1, speed improvements
ja: Enhanced: 2.0.1 速度の改善

note: Tag: para
en: Enhanced: 2.1.0, added support for GEOMETRYCOLLECTION and MULTIPOINT.
ja: Enhanced: 2.1.0 GEOMETRYCOLLECTIONとMULTIPOINTの対応の追加

note: Tag: para
en: Enhanced: 3.1.0, added removal of Coordinates with NaN values.
ja: Enhanced: 3.1.0 NaN値を持つ座標の削除が追加されました。

note: Tag: para
en: Enhanced: 3.2.0, added algorithm options, 'linework' and 'structure' which requires GEOS &gt;= 3.10.0.
ja: Enhanced: 3.2.0, アルゴリズムに関する任意パラメータ'linework'と'structure'が追加されました。GEOS 3.10.0以上が必要です。

note: Tag: para
en: before_geom: MULTIPOLYGON of 2 overlapping polygons
ja: before_geom: 二つのオーバラップしているポリゴンからなるマルチポリゴン

note: Tag: para
en: after_geom: MULTIPOLYGON of 4 non-overlapping polygons
ja: after_geom: 4 つのオーバーラップしないポリゴンのマルチポリゴン

note: Tag: para
en: after_geom_structure: MULTIPOLYGON of 1 non-overlapping polygon
ja: after_geom_structure: 一つのオーバラップしないポリゴンからなるマルチポリゴン

note: Tag: para
en: before_geom: MULTIPOLYGON of 6 overlapping polygons
ja: before_geom: 六つのオーバラップしているポリゴンからなるマルチポリゴン

note: Tag: para
en: after_geom: MULTIPOLYGON of 14 Non-overlapping polygons
ja: after_geom: 14個のオーバラップしていないポリゴンからなるマルチポリゴン

note: Tag: para
en: after_geom_structure: MULTIPOLYGON of 1 Non-overlapping polygon
ja: after_geom_structure: 一つのオーバラップしないポリゴンからなるマルチポリゴン

note: Tag: title
en: Version Functions
ja: バージョン関数

note: Tag: para
en: These functions report and upgrade PostGIS versions.
ja: これらの関数はPostGISのバージョンを報告したりアップグレードします。

note: Tag: refpurpose
en: Packages and upgrades PostGIS extensions (e.g. postgis_raster, postgis_topology, postgis_sfcgal) to given or latest version.
ja: PostGISエクステンション (例: postgis_raster, postgis_topology, postgis_sfcgal)について、指定したバージョンまたは最新版にパッケージ化し、アップグレードします。

note: Tag: para
en: Packages and upgrades PostGIS extensions to given or latest version. Only extensions you have installed in the database will be packaged and upgraded if needed. Reports full PostGIS version and build configuration infos after. This is short-hand for doing multiple CREATE EXTENSION .. FROM unpackaged and ALTER EXTENSION .. UPDATE for each PostGIS extension. Currently only tries to upgrade extensions postgis, postgis_raster, postgis_sfcgal, postgis_topology, and postgis_tiger_geocoder.
ja: PostGISエクステンションについて、指定したバージョンまたは最新版にパッケージ化し、アップグレードします。データベースにインストールしたエクステンションだけがパッケージ化、アップグレードする必要があるなら、そのようにできます。完全なPostGISバージョンとビルド時のコンフィギュレーション情報とが後で報告されます。これは、PostGISエクステンションごとに、CREATE EXTENSION . FROMのパッケージの取消、ALTER EXTENSION ..とUPDATEとの複数回の実行の省略版です。現在はpostgis, postgis_raster, postgis_sfcgal, postgis_topology, postgis_tiger_geocoderだけのアップグレードを試みます。

note: Tag: para
en: Changed: 3.4.0 to add target_version argument.
ja: Changed: 3.4.0 target_version引数が追加されました。

note: Tag: para
en: Changed: 3.3.0 support for upgrades from any PostGIS version. Does not work on all systems.
ja: Changed: 3.3.0 どのPostGISのバージョンからでもアップグレードできるようになりました。ただし全てのシステムで動作するわけではありません。

note: Tag: para
en: Changed: 3.0.0 to repackage loose extensions and support postgis_raster.
ja: Changed: 3.0.0 緩いエクステンションを再パッケージし、また、postgis_rasterに対応しました。

note: Tag: refpurpose
en: Reports full PostGIS version and build configuration infos.
ja: 完全なPostGISのバージョン情報とコンフィギュレーション情報を報告します。

note: Tag: para
en: Reports full PostGIS version and build configuration infos. Also informs about synchronization between libraries and scripts suggesting upgrades as needed.
ja: 完全なPostGISのバージョン情報とコンフィギュレーション情報を報告します。ライブラリとスクリプトとの間の同期について情報を提供して、必要に応じてアップグレードの提案に関する情報を提供します。

note: Tag: para
en: Enhanced: 3.4.0 now includes extra PROJ configurations NETWORK_ENABLED, URL_ENDPOINT and DATABASE_PATH of proj.db location
ja: Enhanced: 3.4.0 現在、外部PROJ設定のNETWORK_ENABLED、URL_ENDPOINT、proj.db位置のDATABASE_PATHがあります

note: Tag: refpurpose
en: Returns the version number of the GEOS library.
ja: GEOSライブラリのバージョン番号を返します。

note: Tag: para
en: Returns the version number of the GEOS library, or <varname>NULL</varname> if GEOS support is not enabled.
ja: GEOSライブラリのバージョン番号を返します。GEOS対応が有効でない場合は<varname>NULL</varname>を返します。

note: Tag: refpurpose
en: Returns the version number of the GEOS library against which PostGIS was built.
ja: PostGISのビルドに使われたGEOSライブラリのバージョン番号を返します。

note: Tag: para
en: Returns the version number of the GEOS library, or against which PostGIS was built.
ja: GEOSライブラリのバージョン番号、またはPostGISのビルドに使ったバージョン番号を返します。

note: Tag: refpurpose
en: Returns the version number of the liblwgeom library. This should match the version of PostGIS.
ja: liblwgeomライブラリのバージョン番号を返します。PostGISのバージョンと同じになるべきものです。

note: Tag: para
en: Returns the version number of the liblwgeom library/
ja: liblwgeomライブラリのバージョン番号を返します。

note: Tag: refpurpose
en: Returns the version number of the libxml2 library.
ja: LibXML2ライブラリのバージョン番号を返します。

note: Tag: para
en: Returns the version number of the LibXML2 library.
ja: LibXML2ライブラリのバージョン番号を返します。

note: Tag: refpurpose
en: Returns the version number of the libjson-c library.
ja: libjson-cライブラリのバージョン番号を返します。

note: Tag: para
en: Returns the version number of the LibJSON-C library.
ja: LibJSON-Cライブラリのバージョン番号を返します。

note: Tag: refpurpose
en: <refpurpose>Returns build date of the PostGIS library.</refpurpose>
ja: <refpurpose>PostGISライブラリのビルド日付を返します。</refpurpose>

note: Tag: para
en: <para>Returns build date of the PostGIS library.</para>
ja: <para>PostGISライブラリのビルド日付を返します。</para>

note: Tag: refpurpose
en: <refpurpose>Returns the version number of the PostGIS library.</refpurpose>
ja: <refpurpose>PostGISのバージョン番号を返します。</refpurpose>

note: Tag: para
en: <para>Returns the version number of the PostGIS library.</para>
ja: <para>PostGISのバージョン番号を返します。</para>

note: Tag: refpurpose
en: Returns the version number of the PROJ4 library.
ja: PROJ4のバージョン番号を返します。

note: Tag: para
en: Returns the version number of the PROJ library and some configuration options of proj.
ja: PROJライブラリのバージョン番号とProjの設定オプションを返します。

note: Tag: para
en: Enhanced: 3.4.0 now includes NETWORK_ENABLED, URL_ENDPOINT and DATABASE_PATH of proj.db location
ja: Enhanced: 3.4.0 現在、NETWORK_ENABLED、URL_ENDPOINT、proj.db位置のDATABASE_PATHがあります

note: Tag: refpurpose
en: Returns the version number of the PROJ library against which PostGIS was built.
ja: PostGISのビルドに使われたPROJライブラリのバージョン番号を返します。

note: Tag: para
en: Returns the version number of the PROJ library, or against which PostGIS was built.
ja: PROJライブラリのバージョンを返しますが、PostGISのビルドに使われたもののバージョン番号です。

note: Tag: refpurpose
en: Returns the version number of the internal Wagyu library.
ja: 内部のWagyuライブラリのバージョン番号を返します。

note: Tag: para
en: Returns the version number of the internal Wagyu library, or <varname>NULL</varname> if Wagyu support is not enabled.
ja: 内部のWagyuライブラリのバージョン番号を返します。Wagyu対応が有効でない場合には<varname>NULL</varname>を返します。

note: Tag: refpurpose
en: <refpurpose>Returns build date of the PostGIS scripts.</refpurpose>
ja: <refpurpose>PostGISスクリプトのビルド日付を返します。</refpurpose>

note: Tag: para
en: <para>Returns build date of the PostGIS scripts.</para>
ja: <para>PostGISスクリプトのビルド日付を返します。</para>

note: Tag: refpurpose
en: <refpurpose>Returns version of the PostGIS scripts installed in this database.</refpurpose>
ja: <refpurpose>このデータベースにインストールしたPostGISスクリプトのバージョンを返します。</refpurpose>

note: Tag: para
en: <para>Returns version of the PostGIS scripts installed in this database.</para>
ja: <para>このデータベースにインストールしたPostGISスクリプトのバージョンを返します。</para>

note: Tag: para
en: If the output of this function doesn't match the output of <xref linkend="PostGIS_Scripts_Released"/> you probably missed to properly upgrade an existing database. See the <link linkend="upgrading">Upgrading</link> section for more info.
ja: この関数の出力と<xref linkend="PostGIS_Scripts_Released"/>とが合わない場合、既存のデータベースの確実なアップグレードに失敗しているかも知れません。詳細情報については<link linkend="upgrading">Upgrading</link>をご覧ください。

note: Tag: refpurpose
en: <refpurpose>Returns the version number of the postgis.sql script released with the installed PostGIS lib.</refpurpose>
ja: <refpurpose>インストールしたPostGISライブラリとともにリリースされたpostgis.sqlスクリプトのバージョン番号を返します。</refpurpose>

note: Tag: para
en: <para>Returns the version number of the postgis.sql script released with the installed PostGIS lib.</para>
ja: <para>インストールしたPostGISライブラリとともにリリースされたpostgis.sqlスクリプトのバージョン番号を返します。</para>

note: Tag: para
en: Starting with version 1.1.0 this function returns the same value of <xref linkend="PostGIS_Lib_Version"/>. Kept for backward compatibility.
ja: 1.1.0からこの関数は<xref linkend="PostGIS_Lib_Version"/>と同じ値を返すようになりました。後方互換のためです。

note: Tag: refpurpose
en: <refpurpose>Returns PostGIS version number and compile-time options.</refpurpose>
ja: <refpurpose>PostGISバージョン番号とコンパイルオプションを返します。</refpurpose>

note: Tag: para
en: <para>Returns PostGIS version number and compile-time options.</para>
ja: <para>PostGISバージョン番号とコンパイルオプションを返します。</para>

note: Tag: title
en: Appendix
ja: 付録

note: Tag: subtitle
en: Release Notes
ja: リリースノート

note: Tag: para
en: This version requires PostgreSQL 12-17, GEOS 3.8 or higher, and Proj 6.1+. To take advantage of all features, GEOS 3.12+ is needed. To take advantage of all SFCGAL features, SFCGAL 1.5.0+ is needed.
ja: このバージョンにはPostgreSQL 12-17、GEOS 3.8以上、Proj 6.1以上が必要です。全ての機能を利用するにはGEOS 3.12以上が必要です。全てのSFCGAL機能を使用するにはSFCGAL 1.5.0以上が必要です。

note: Tag: para
en: Many thanks to our translation teams, in particular:
ja: 翻訳チームに感謝します、特に次の方々です:

note: Tag: para
en: Dapeng Wang, Zuo Chenwei from HighGo (Chinese Team)
ja: HighGoのDapeng Wangさん、Zuo Chenweiさん (中国語チーム)

note: Tag: para
en: Teramoto Ikuhiro (Japanese Team)
ja: Teramoto Ikuhiroさん (日本語チーム)

note: Tag: para
en: Vincent Bre (French Team)
ja: Vincent Breさん (フランス語チーム)

note: Tag: title
en: Breaking Changes
ja: 大幅な変更

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5546">#5546</link>, TopoGeometry &lt;&gt; TopoGeometry is now ambiguous, to get the old behaviour, assuming your TopoGeometry objects are named tg1 and tg2, use: ( id(tg1) &lt;&gt; id(tg2) OR topology_id(tg1) &lt;&gt; topology_id(tg2) OR layer_id(tg1) &lt;&gt; layer_id(tg2) OR type(tg1) &lt;&gt; type(tg2) ) (Sandro Santilli)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5546">#5546</link>, TopoGeometry &lt;&gt; TopoGeometryが現在ではあいまいです。古いふるまいで動作させるには、TopoGeometryオブジェクトがtg1とtg2とするなら、次のようにしないといけません: ( id(tg1) &lt;&gt; id(tg2) OR topology_id(tg1) &lt;&gt; topology_id(tg2) OR layer_id(tg1) &lt;&gt; layer_id(tg2) OR type(tg1) &lt;&gt; type(tg2) ) (Sandro Santilliさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5536">#5536</link>, comments are not anymore included in PostGIS extensions (Sandro Santilli)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5536">#5536</link>, コメントがPostGISエクステンションに含まれなくなりました (Sandro Santilliさん)

note: Tag: para
en: xmllint is now required to build comments (Sandro Santilli)
ja: xmllintは、今ではコメントの作成が必須になっています (Sandro Santilliさん)

note: Tag: para
en: DocBook5 XSL is now required to build html (Sandro Santilli)
ja: DocBook5 XSLはHTMLのビルドが必須になりました (Sandro Santilliさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5602">#5602</link>, Drop support for GEOS 3.6 and 3.7 (Regina Obe)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5602">#5602</link>, GEOS 3.6と3.7の対応を終了しました (Regina Obeさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5571">#5571</link>, Improve ST_GeneratePoints performance, but old seeded pseudo random points will need to be regenerated.
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5571">#5571</link>, ST_GeneratePointsの効率を改善しましたが、古いシード生成を使った疑似乱数のポイントを再生成する必要があります。

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5596">#5596</link>, GH-749, Allow promoting column as an id in ST_AsGeoJson(record,..). Views and materialized views that use the ST_AsGeoJSON(record ..) will need rebuilding to upgrade to new signature (Jan Tojnar)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5596">#5596</link>, GH-749, カラムをST_AsGeoJson(record,..)内のIDにできるようになりました。ST_AsGeoJSON(record ..)を使うビューとマテリアライズドビューは、新しい関数シグネチャへのアップグレードのために再構築する必要があります (Jan Tojnarさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5496">#5496</link>, ST_Clip all variants replaced, will require rebuilding of materialized views that use them (Regina Obe)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5496">#5496</link>, 全ての形式のST_Clipを入れ替えました。使用する場合にはマテリアライズドビューの再構築が必要になります (Regina Obeさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5659">#5659</link>, ST_DFullyWithin behaviour has changed to be ST_Contains(ST_Buffer(A, R), B) (Paul Ramsey)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5659">#5659</link>, ST_DFullyWithinのふるまいがST_Contains(ST_Buffer(A, R), B)に変更されました (Paul Ramseyさん)

note: Tag: para
en: Remove the WFS_locks extra package. (Paul Ramsey)
ja: 外部パッケージWFS_locksの削除 (Paul Ramseyさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5747">5747</link>, <link xlink:href="https://github.com/postgis/postgis/pull/776">GH-776</link>, ST_Length: Return 0 for CurvePolygon (Dan Baston)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5747">5747</link>, <link xlink:href="https://github.com/postgis/postgis/pull/776">GH-776</link>, ST_Length: 曲線ポリゴンで0を返す (Dan Bastonさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5770">5770</link>, support for GEOS 3.13 and RelateNG. Most functionality remains the same, but new GEOS predicate implementation has a few small changes.
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5770">5770</link>, GEOS 3.13とRelateNGに対応しました。ほとんどの機能は同じですが、新しいGEOS述語の実装では若干の変更があります。

note: Tag: para
en: Boundary Node Rule relate matrices might be different when using the "multi-valent end point" rule.
ja: "multi-valent end point" 規則 (他のジオメトリの境界になっている終点も境界とする)を使う時、境界ノード規則の関係行列が異なる場合があります。

note: Tag: para
en: Relate matrices for situations with invalid MultiPolygons with shared boundaries might be different. Run ST_MakeValid to get valid inputs to feed to the calculation.
ja: 境界を共有する不正なマルチポリゴンの関係行列は異なる可能性があります。入力ジオメトリをST_MakeValidで妥当なものにしてから計算に渡して下さい。

note: Tag: para
en: Zero length LineStrings are treated as if they are the equivalent Point object.
ja: 長さが0のラインストリングは、等価なポイントオブジェクトとして扱われます。

note: Tag: title
en: Deprecated signatures
ja: 非推奨の関数シグネチャ

note: Tag: para
en: <link xlink:href="https://github.com/postgis/postgis/pull/761">GH-761</link>, ST_StraightSkeleton => CG_StraightSkeleton (Loïc Bartoletti)
ja: <link xlink:href="https://github.com/postgis/postgis/pull/761">GH-761</link>, ST_StraightSkeleton => CG_StraightSkeleton (Loïc Bartolettiさん)

note: Tag: para
en: <link xlink:href="https://git.osgeo.org/gitea/postgis/postgis/pulls/189">GH-189</link>, All SFCGAL functions now use the prefix CG_, with the old ones using ST_ being deprecated. (Loïc Bartoletti)
ja: <link xlink:href="https://git.osgeo.org/gitea/postgis/postgis/pulls/189">GH-189</link>, 全てのSFCGAL関数のプレフィクスをCG_にしていて、ST_を使う古い関数名は非推奨です。(Loïc Bartolettiさん)

note: Tag: title
en: New features
ja: 新機能

note: Tag: para
en: Improvements in the 'postgis' script: <itemizedlist> <listitem><para>new command list-enabled</para></listitem> <listitem><para>new command list-all</para></listitem> <listitem><para>command upgrade upgrades all databases that need to be</para></listitem> <listitem><para>command status reports status of all databases</para></listitem> </itemizedlist> (Sandro Santilli)
ja: 'postgis'スクリプトの改良: <itemizedlist> <listitem><para>新コマンド list-enabled</para></listitem> <listitem><para>新コマンド list-all</para></listitem> <listitem><para>全てのアップグレードが必要なデータベースのアップグレードコマンド upgrade</para></listitem> <listitem><para>全てのデータベースの状況を報告するコマンド status</para></listitem> </itemizedlist> (Sandro Santilliさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5742">#5742</link>, expose version of PROJ at compile time (Sandro Santilli)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5742">#5742</link>, コンパイル時の PROJ のバージョンの表示 (Sandro Santilliさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5721">#5721</link>, postgis_topology: Allow sharing sequences between different topologies (Lars Opsahl)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5721">#5721</link>, postgis_topology: 異なるトポロジ間でのシーケンスの共有ができるようにしました (Lars Opsahlさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5667">#5667</link>, postgis_topology: TopoGeo_LoadGeometry (Sandro Santilli)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5667">#5667</link>, postgis_topology: TopoGeo_LoadGeometry (Sandro Santilliさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5055">#5055</link>, add explicit &lt;&gt; geometry operator to prevent non-unique error with &lt;&gt; and &#x21;= (Paul Ramsey)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5175">#5175</link>, &lt;&gt;と&#x21;=での非一意性エラーを避けるための明示的な&lt;&gt;ジオメトリ演算子の追加 (Paul Ramseyさん)

note: Tag: para
en: Add ST_HasZ/ST_HasM (Loïc Bartoletti)
ja: ST_HasZ/ST_HasMの追加 (Loïc Bartolettiさん)

note: Tag: para
en: <link xlink:href="https://git.osgeo.org/gitea/postgis/postgis/pulls/123">GT-123</link>, postgis_sfcgal: CG_YMonotonePartition, CG_ApproxConvexPartition, CG_GreeneApproxConvexPartition and CG_OptimalConvexPartition (Loïc Bartoletti)
ja: <link xlink:href="https://git.osgeo.org/gitea/postgis/postgis/pulls/123">GT-123</link>, postgis_sfcgal: CG_YMonotonePartition, CG_ApproxConvexPartition, CG_GreeneApproxConvexPartition, CG_OptimalConvexPartition (Loïc Bartolettiさん)

note: Tag: para
en: <link xlink:href="https://git.osgeo.org/gitea/postgis/postgis/pulls/156">GT-156</link>, postgis_sfcgal: CG_Visibility (Loïc Bartoletti)
ja: <link xlink:href="https://git.osgeo.org/gitea/postgis/postgis/pulls/156">GT-156</link>, postgis_sfcgal: CG_Visibility (Loïc Bartolettiさん)

note: Tag: para
en: <link xlink:href="https://git.osgeo.org/gitea/postgis/postgis/pulls/157">GT-157</link>, postgis_sfcgal: Add ST_ExtrudeStraightSkeleton (Loïc Bartoletti)
ja: <link xlink:href="https://git.osgeo.org/gitea/postgis/postgis/pulls/157">GT-157</link>, postgis_sfcgal: ST_ExtrudeStraightSkeletonの追加 (Loïc Bartolettiさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5496">#5496</link>, postgis_raster: ST_Clip support for touched (Regina Obe)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5496">#5496</link>, postgis_raster: ST_Clipで接触への対応 (Regina Obeさん)

note: Tag: para
en: <link xlink:href="https://github.com/postgis/postgis/pull/760">GH-760</link>, postgis_sfcgal: CG_Intersection, CG_3DIntersects, CG_Intersects, CG_Difference, CG_Union (and aggregate), CG_Triangulate, CG_Area, CG_3DDistance, CG_Distance (Loïc Bartoletti)
ja: <link xlink:href="https://github.com/postgis/postgis/pull/760">GH-760</link>, postgis_sfcgal: CG_Intersection, CG_3DIntersects, CG_Intersects, CG_Difference, CG_Union (集約関数版含む), CG_Triangulate, CG_Area, CG_3DDistance, CG_Distance (Loïc Bartolettiさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5687">#5687</link>, Don't rely on search_path to determine postgis schema Fix for PG17 security change (Regina Obe)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5687">#5687</link>, PostGISスキーマの決定についてsearch_pathに依存してはいけません。PG17のセキュリティ変更のためです (Regina Obeさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5705">#5705</link>, <link xlink:href="https://github.com/postgis/postgis/pull/767">GH-767</link>, ST_RemoveIrrelevantPointsForView (Sam Peters)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5705">#5705</link>, <link xlink:href="https://github.com/postgis/postgis/pull/767">GH-767</link>, ST_RemoveIrrelevantPointsForView (Sam Petersさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5706">#5706</link>, <link xlink:href="https://github.com/postgis/postgis/pull/768">GH-768</link>, ST_RemoveSmallParts (Sam Peters)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5706">#5706</link>, <link xlink:href="https://github.com/postgis/postgis/pull/768">GH-768</link>, ST_RemoveSmallParts (Sam Petersさん)

note: Tag: title
en: Enhancements
ja: 性能強化

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5550">5550</link>, Fix upgrades from 2.x in sandboxed systems (Sandro Santilli)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5550">5550</link>, 酸度ボックスシステムでの2.xからのアップグレードの修正 (Sandro Santilliさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/3587">#3587</link>, postgis_topology: faster load of big lines in topologies (Sandro Santilli)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/3587">#3587</link>, postgis_topology: topologies内の大きなラインのより高速なロード (Sandro Santilliさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5670">#5670</link>, postgis_topology: faster ST_CreateTopoGeo (Sandro Santilli)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5670">#5670</link>, postgis_topology: 高速な ST_CreateTopoGeo (Sandro Santilliさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5531">#5531</link>, documentation format upgraded to DocBook 5 (Sandro Santilli)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5531">#5531</link>, DocBook 5へのドキュメント書式更新 (Sandro Santilliさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5543">#5543</link>, allow building without documentation (Sandro Santilli)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5543">#5543</link>, ドキュメントなしでのビルドが可能になりました (Sandro Santilliさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5596">#5596</link>, <link xlink:href="https://github.com/postgis/postgis/pull/749">GH-749</link>, Allow promoting column as an id in ST_AsGeoJson(record,..). (Jan Tojnar)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5596">#5596</link>, <link xlink:href="https://github.com/postgis/postgis/pull/749">GH-749</link>, カラムをST_AsGeoJson(record,..)内のIDにできるようになりました。(Jan Tojnarさん)

note: Tag: para
en: <link xlink:href="https://github.com/postgis/postgis/pull/744">GH-744</link>, Don't create docbook.css for the HTML manual, use style.css instead (Chris Mayo)
ja: <link xlink:href="https://github.com/postgis/postgis/pull/744">GH-744</link>, HTMLマニュアル用のdocbook.cssを生成せず、style.cssを代わりに使用します (Chris Mayoさん)

note: Tag: para
en: Faster implementation of point-in-poly cached index (Paul Ramsey)
ja: キャッシュされたインデックスのポリゴン内のポイントの高速になる実装 (Paul Ramseyさん)

note: Tag: para
en: Improve performance of ST_GeneratePoints (Paul Ramsey)
ja: ST_GeneratePointsの効率改善 (Paul Ramseyさん)

note: Tag: para
en: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5361">#5361</link>, ST_CurveN, ST_NumCurves and consistency in accessors on curved geometry (Paul Ramsey)
ja: <link xlink:href="https://trac.osgeo.org/postgis/ticket/5361">#5361</link>, ST_CurveN, ST_NumCurvesと曲線ジオメトリのアクセサの一貫性 (Paul Ramseyさん)

note: Tag: para
en: <link xlink:href="https://github.com/postgis/postgis/pull/761">GH-761</link>, postgis_sfcgal: Add an optional parameter to CG_StraightSkeleton (was ST_StraightSkeleton) to use m as a distance in result (Hannes Janetzek, Loïc Bartoletti)
ja: <link xlink:href="https://github.com/postgis/postgis/pull/761">GH-761</link>, postgis_sfcgal: 結果の距離をメートルにするためのCG_StraightSkeleton (旧 ST_StraightSkeleton)の任意パラメータの追加 (Hannes Janetzekさん, Loïc Bartolettiさん)

note: Tag: title
en: Reporting Problems
ja: 問題を報告する

note: Tag: title
en: Reporting Software Bugs
ja: ソフトウェアのバグを報告する

note: Tag: para
en: Reporting bugs effectively is a fundamental way to help PostGIS development. The most effective bug report is that enabling PostGIS developers to reproduce it, so it would ideally contain a script triggering it and every information regarding the environment in which it was detected. Good enough info can be extracted running <code>SELECT postgis_full_version()</code> [for PostGIS] and <code>SELECT version()</code> [for postgresql].
ja: 効率的なバグの報告はPostGISの開発を助ける本質的な方法です。最も効率的なバグ報告は、PostGIS開発者がそれを再現できるようにすることで、それの引き金となったスクリプトと検出された環境に沿った全ての情報を含んでいるのが理想です。<code>SELECT postgis_full_version()</code> [PostGIS]と<code>SELECT version()</code> [PostgreSQL]とを実行することで十分に良い情報を得ることができます。

note: Tag: para
en: If you aren't using the latest release, it's worth taking a look at its <link xlink:href="https://git.osgeo.org/gitea/postgis/postgis/raw/branch/master/NEWS">release changelog</link> first, to find out if your bug has already been fixed.
ja: 最新版を使っていない場合には<link xlink:href="https://git.osgeo.org/gitea/postgis/postgis/raw/branch/master/NEWS">release changelog</link>をまず見て、既にバグフィクスされていないかを探すのは価値のあることです。

note: Tag: para
en: Using the <link xlink:href="http://trac.osgeo.org/postgis/">PostGIS bug tracker</link> will ensure your reports are not discarded, and will keep you informed on its handling process. Before reporting a new bug please query the database to see if it is a known one, and if it is please add any new information you have about it.
ja: <link xlink:href="http://trac.osgeo.org/postgis/">PostGIS bug tracker</link>を使うと、レポートが捨てられず、それの対応プロセスが通知されることを保証します。新しいバグを報告する前にデータベースに問い合わせて、既知のバグかどうかを見て下さい。既知のものでしたら、それに関して持っているあらゆる新しい情報を追加して下さい。

note: Tag: para
en: You might want to read Simon Tatham's paper about <link xlink:href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">How to Report Bugs Effectively</link> before filing a new report.
ja: 新しいレポートを記入する前にSimon Tathamさんの<link xlink:href="http://www.chiark.greenend.org.uk/~sgtatham/bugs.html">How to Report Bugs Effectively</link>に関するページを読むと良いでしょう。

note: Tag: title
en: Reporting Documentation Issues
ja: 文書の問題を報告する

note: Tag: para
en: The documentation should accurately reflect the features and behavior of the software. If it doesn't, it could be because of a software bug or because the documentation is in error or deficient.
ja: 文書は、ソフトウェアの機能と挙動を正確に反映するべきものです。正確でない場合は、ソフトウェアのバグがあるか、または文書に誤り若しくは不十分な箇所があることが考えられます。

note: Tag: para
en: Documentation issues can also be reported to the <link xlink:href="http://trac.osgeo.org/postgis">PostGIS bug tracker</link>.
ja: 文書の問題も<link xlink:href="http://trac.osgeo.org/postgis">PostGIS bug tracker</link>に報告することができます。

note: Tag: para
en: If your revision is trivial, just describe it in a new bug tracker issue, being specific about its location in the documentation.
ja: 訂正が小さいものなら、バグトラッカの新しい問題の中に、文書内の位置を特定して記述して下さい。

note: Tag: para
en: If your changes are more extensive, a patch is definitely preferred. This is a four step process on Unix (assuming you already have <link xlink:href="https://git-scm.com/">git</link> installed):
ja: 変更が大きい場合は、パッチが確実に好まれます。Unix上で次の4ステップの処理を行います (既に<link xlink:href="https://git-scm.com/">git</link>をインストールしていると仮定します)。

note: Tag: para
en: Clone the PostGIS' git repository. On Unix, type:
ja: PostGISのgitリポジトリを複製します。UNIXでは次のように入力します。

note: Tag: para
en: This will be stored in the directory postgis
ja: これでpostgisディレクトリに格納されます

note: Tag: para
en: Make your changes to the documentation with your favorite text editor. On Unix, type (for example):
ja: お使いのテキストエディタで文書に変更を加えます。Unixでは、たとえば次のようにします。

note: Tag: para
en: Note that the documentation is written in DocBook XML rather than HTML, so if you are not familiar with it please follow the example of the rest of the documentation.
ja: 文書はHTMLでなくDocBook XMLで書かれていますので、慣れていないなら、残りの文書の例にならって下さい。

note: Tag: para
en: Make a patch file containing the differences from the master copy of the documentation. On Unix, type:
ja: 文書のマスタコピーからパッチファイルを作成します。Unixでは次のように入力します。

note: Tag: para
en: Attach the patch to a new issue in bug tracker.
ja: バグトラッカ内の新しい問題にパッチが取り付けられます。

note: Tag: title
en: Data Management
ja: データ管理

note: Tag: title
en: Spatial Data Model
ja: 空間データ モデル

note: Tag: title
en: OGC Geometry
ja: OGC ジオメトリ

note: Tag: para
en: The Open Geospatial Consortium (OGC) developed the <link xlink:href="https://www.ogc.org/standards/sfa"><emphasis>Simple Features Access</emphasis></link> standard (SFA) to provide a model for geospatial data. It defines the fundamental spatial type of <emphasis role="bold">Geometry</emphasis>, along with operations which manipulate and transform geometry values to perform spatial analysis tasks. PostGIS implements the OGC Geometry model as the PostgreSQL data types <link linkend="PostGIS_Geometry">geometry</link> and <link linkend="PostGIS_Geography">geography</link>.
ja: Open Geospatial Consortium (OGC)は、地理空間データのモデルを提供するために<link xlink:href="https://www.ogc.org/standards/sfa"><emphasis>Simple Features Access</emphasis></link> (SFA)標準を開発しました。これは、<emphasis role="bold">ジオメトリ (Geometry)</emphasis>の基本的な空間タイプを、空間解析処理実行のための操作や変換といった演算に沿って定義します。PostGISは空間解析タスクを実現するためにOGCジオメトリモデル値をPostgreSQLデータ型の<link linkend="PostGIS_Geometry">geometry</link>、<link linkend="PostGIS_Geography">geography</link>として実装しています。

note: Tag: para
en: Geometry is an <emphasis>abstract</emphasis> type. Geometry values belong to one of its <emphasis>concrete</emphasis> subtypes which represent various kinds and dimensions of geometric shapes. These include the <emphasis role="bold">atomic</emphasis> types <link linkend="Point">Point</link>, <link linkend="LineString">LineString</link>, <link linkend="LinearRing">LinearRing</link> and <link linkend="Polygon">Polygon</link>, and the <emphasis role="bold">collection</emphasis> types <link linkend="MultiPoint">MultiPoint</link>, <link linkend="MultiLineString">MultiLineString</link>, <link linkend="MultiPolygon">MultiPolygon</link> and <link linkend="GeometryCollection">GeometryCollection</link>. The <link xlink:href="https://portal.ogc.org/files/?artifact_id=25355"><emphasis>Simple Features Access - Part 1: Common architecture v1.2.1</emphasis></link> adds subtypes for the structures <link linkend="PolyhedralSurface">PolyhedralSurface</link>, <link linkend="Triangle">Triangle</link> and <link linkend="TIN">TIN</link>.
ja: ジオメトリは<emphasis>抽象的な</emphasis>タイプです。ジオメトリ値は複数ある<emphasis>具体的な</emphasis>サブタイプの一つに属します。サブタイプは様々な種類の様々な次元のジオメトリの形状を表現するものです。これらには<emphasis role="bold">原子的な</emphasis>タイプである<link linkend="Point">ポイント (Point)</link>、<link linkend="LineString">ラインストリング (LineString)</link>、<link linkend="LinearRing">リニアリング (LinearRing)</link>、<link linkend="Polygon">ポリゴン (Polygon)</link>があります。また、<emphasis role="bold">コレクション (collection)</emphasis> (訳注: 「マルチ系」と書いている場合があります)タイプの<link linkend="MultiPoint">マルチポイント (MultiPoint)</link>、<link linkend="MultiLineString">マルチラインストリング (MultiLineString)</link>、<link linkend="MultiPolygon">マルチポリゴン (MultiPolygon)</link>、<link linkend="GeometryCollection">ジオメトリコレクション (GeometryCollection)</link>があります。 <link xlink:href="https://portal.ogc.org/files/?artifact_id=25355"><emphasis>Simple Features Access - Part 1: Common architecture v1.2.1</emphasis></link>では<link linkend="PolyhedralSurface">多面体サーフェス (PolyhedralSurface)</link>、<link linkend="Triangle">三角形 (Triangle)</link>、<link linkend="TIN">TIN</link>が追加されています。

note: Tag: para
en: Geometry models shapes in the 2-dimensional Cartesian plane. The PolyhedralSurface, Triangle, and TIN types can also represent shapes in 3-dimensional space. The size and location of shapes are specified by their <emphasis role="bold">coordinates</emphasis>. Each coordinate has a X and Y <emphasis role="bold">ordinate</emphasis> value determining its location in the plane. Shapes are constructed from points or line segments, with points specified by a single coordinate, and line segments by two coordinates.
ja: ジオメトリは2次元デカルト平面上の形状をモデル化しています。多面体サーフェス、三角形、TINは3次元空間内の形状を表現することもできます。形状のサイズと位置は<emphasis role="bold">座標</emphasis>によって指定されます。それぞれの座標は、平面上で位置を判定するXとYの<emphasis role="bold">座標軸</emphasis>値を持っています。形状はポイントと線分から構築され、ポイントは単一の座標で定められ、線分は二つの座標値から定められます。

note: Tag: para
en: Coordinates may contain optional Z and M ordinate values. The Z ordinate is often used to represent elevation. The M ordinate contains a measure value, which may represent time or distance. If Z or M values are present in a geometry value, they must be defined for each point in the geometry. If a geometry has Z or M ordinates the <emphasis role="bold">coordinate dimension</emphasis> is 3D; if it has both Z and M the coordinate dimension is 4D.
ja: 座標は任意軸ZとMを持つことができます。Z軸はしばしば標高を示すために使われます。M軸は計測値が入りますが、計測値は時間であったり距離であったりします。Z値またはM値はジオメトリ値の中にあり、ジオメトリの各ポイントで定義されているものです。ジオメトリがZ値またはM値を持っている場合には<emphasis role="bold">座標次元</emphasis>は三次元です。Z値とM値の両方を持っている場合には四次元です。

note: Tag: para
en: Geometry values are associated with a <emphasis role="bold">spatial reference system</emphasis> indicating the coordinate system in which it is embedded. The spatial reference system is identified by the geometry SRID number. The units of the X and Y axes are determined by the spatial reference system. In <emphasis role="bold">planar</emphasis> reference systems the X and Y coordinates typically represent easting and northing, while in <emphasis role="bold">geodetic</emphasis> systems they represent longitude and latitude. SRID 0 represents an infinite Cartesian plane with no units assigned to its axes. See <xref linkend="spatial_ref_sys"/>.
ja: ジオメトリ値は、そのジオメトリが組み込まれている座標系を示す<emphasis role="bold">空間参照系</emphasis>に関連付けられます。空間参照系はジオメトリのSRID番号で識別されます。X軸とY軸の単位は空間参照系によって決まります。<emphasis role="bold">平面</emphasis>参照系では伝統的にX座標値とY座標値が東、北をそれぞれ示します。<emphasis role="bold">地理</emphasis>参照系では、経度と緯度を表現しています。SRIDが0の場合には、軸の単位が無い、無限の直交平面を表します。<xref linkend="spatial_ref_sys"/>を参照して下さい。

note: Tag: para
en: The geometry <emphasis role="bold">dimension</emphasis> is a property of geometry types. Point types have dimension 0, linear types have dimension 1, and polygonal types have dimension 2. Collections have the dimension of the maximum element dimension.
ja: ジオメトリの<emphasis role="bold">次元</emphasis>は、ジオメトリタイプのプロパティです。ポイントタイプは0次元、ラインタイプは1次元、ポリゴンタイプは2次元、コレクションは要素の次元の最大値、となります。

note: Tag: para
en: A geometry value may be <emphasis role="bold">empty</emphasis>. Empty values contain no vertices (for atomic geometry types) or no elements (for collections).
ja: ジオメトリ値は<emphasis role="bold">empty</emphasis>になることがあります。空値とは、非マルチ系ジオメトリの場合は頂点を持っていないという意味で、コレクションでは要素を持っていないという意味です。

note: Tag: para
en: An important property of geometry values is their spatial <emphasis role="bold">extent</emphasis> or <emphasis role="bold">bounding box</emphasis>, which the OGC model calls <emphasis role="bold">envelope</emphasis>. This is the 2 or 3-dimensional box which encloses the coordinates of a geometry. It is an efficient way to represent a geometry's extent in coordinate space and to check whether two geometries interact.
ja: ジオメトリ値の重要なプロパティは<emphasis role="bold">範囲 (extent)</emphasis>または<emphasis role="bold">バウンディングボックス (bounding box)</emphasis>です。OGCモデルでは<emphasis role="bold">エンベロープ (envelope)</emphasis>と呼ばれています。これは、ジオメトリの座標を囲む2次元または3次元のボックスです。ジオメトリの座標空間内の範囲を表現するための、また、二つのジオメトリの相互関係をチェックするための、効率の良い方法です。

note: Tag: para
en: The geometry model allows evaluating topological spatial relationships as described in <xref linkend="DE-9IM"/>. To support this the concepts of <emphasis role="bold">interior</emphasis>, <emphasis role="bold">boundary</emphasis> and <emphasis role="bold">exterior</emphasis> are defined for each geometry type. Geometries are topologically closed, so they always contain their boundary. The boundary is a geometry of dimension one less than that of the geometry itself.
ja: ジオメトリモデルでは、<xref linkend="DE-9IM"/>に示されている通り、トポロジ空間関係を評価することができます。これに対応するために、<emphasis role="bold">内部 (interior)</emphasis>、<emphasis role="bold">境界 (boundary)</emphasis>、<emphasis role="bold">外部 (exterior)</emphasis>の概念が、ジオメトリタイプ毎に定義されます。ジオメトリはトポロジ的に閉じていて、常に境界を持っています。境界の次元はジオメトリの次元より1小さくなります。

note: Tag: para
en: The OGC geometry model defines validity rules for each geometry type. These rules ensure that geometry values represents realistic situations (e.g. it is possible to specify a polygon with a hole lying outside the shell, but this makes no sense geometrically and is thus invalid). PostGIS also allows storing and manipulating invalid geometry values. This allows detecting and fixing them if needed. See <xref linkend="OGC_Validity"/>
ja: OGCジオメトリモデルは、ジオメトリタイプ毎に妥当性規則が定義されています。これらの規則によって、ジオメトリ値が現実的な状況を示すようになります (たとえば、外部に穴を持つポリゴンを指定できますが、ジオメトリ的に無意味であり、よって不正とします)。PostGISは不正なジオメトリ値を格納、操作することができます。これによって、必要なら修正できることになります。<xref linkend="OGC_Validity"/>を参照して下さい。

note: Tag: title
en: Point
ja: ポイント (Point)

note: Tag: para
en: A Point is a 0-dimensional geometry that represents a single location in coordinate space.
ja: ポイントは、座標空間内の一つの位置を表現する0次元ジオメトリです。

note: Tag: title
en: LineString
ja: ラインストリング (LineString)

note: Tag: para
en: A LineString is a 1-dimensional line formed by a contiguous sequence of line segments. Each line segment is defined by two points, with the end point of one segment forming the start point of the next segment. An OGC-valid LineString has either zero or two or more points, but PostGIS also allows single-point LineStrings. LineStrings may cross themselves (self-intersect). A LineString is <emphasis role="bold">closed</emphasis> if the start and end points are the same. A LineString is <emphasis role="bold">simple</emphasis> if it does not self-intersect.
ja: ラインストリングは連続する一連の線分で形成される1次元のラインです。線分はそれぞれ2点で定義付けられ、ある線分の終点は次の線分の始点を形成します。OGC妥当なラインストリングには、0または2以上のポイントがあります。ただしPostGISはラインストリングの一つのポイントを許容します。ラインストリングは、自身とクロスする場合があります (自己交差)。始端と終端とが同じ場合にはラインストリングは<emphasis role="bold">閉じた</emphasis>ことになります。自己交差しない場合には、ラインストリングは<emphasis role="bold">単純</emphasis>です。

note: Tag: title
en: LinearRing
ja: リニアリング (LinearRing)

note: Tag: para
en: A LinearRing is a LineString which is both closed and simple. The first and last points must be equal, and the line must not self-intersect.
ja: リニアリングは閉じていて、かつ単純なラインスリングです。始端と終端は同じでなければなりませんし、ラインは自己交差してはなりません。

note: Tag: title
en: Polygon
ja: ポリゴン (Polygon)

note: Tag: para
en: A Polygon is a 2-dimensional planar region, delimited by an exterior boundary (the shell) and zero or more interior boundaries (holes). Each boundary is a <link linkend="LinearRing">LinearRing</link>.
ja: ポリゴンは2次元平面領域です。一つの外側の境界 (殻)と0個以上の内の境界 (穴)とで区切られています。それぞれの境界は<link linkend="LinearRing">リニアリング</link>です。

note: Tag: title
en: MultiPoint
ja: マルチポイント (MultiPoint)

note: Tag: para
en: A MultiPoint is a collection of Points.
ja: マルチポイントはポイントのコレクションです。

note: Tag: title
en: MultiLineString
ja: マルチラインストリング (MultiLineString)

note: Tag: para
en: A MultiLineString is a collection of LineStrings. A MultiLineString is closed if each of its elements is closed.
ja: マルチラインストリングはラインストリングのコレクションです。各要素が閉じている場合には、そのマルチラインストリングは閉じています。

note: Tag: title
en: MultiPolygon
ja: マルチポリゴン (MultiPolygon)

note: Tag: para
en: A MultiPolygon is a collection of non-overlapping, non-adjacent Polygons. Polygons in the collection may touch only at a finite number of points.
ja: マルチポリゴンは相互にオーバラップも隣接もしていないポリゴンのコレクションです。コレクション内のポリゴンの接触は有限数のポイントでのみ可能です。

note: Tag: title
en: GeometryCollection
ja: ジオメトリコレクション (GeometryCollection)

note: Tag: para
en: A GeometryCollection is a heterogeneous (mixed) collection of geometries.
ja: ジオメトリコレクションは、ジオメトリの異種 (混合)のコレクションです。

note: Tag: title
en: PolyhedralSurface
ja: 多面体サーフェス (PolyhedralSurface)

note: Tag: para
en: A PolyhedralSurface is a contiguous collection of patches or facets which share some edges. Each patch is a planar Polygon. If the Polygon coordinates have Z ordinates then the surface is 3-dimensional.
ja: 多角形はサーフェスは、パッチまたはエッジを共有する面の隣接するコレクションです。それぞれのパッチは平面ポリゴンです。ポリゴンがZ値を持つ場合には、サーフェスは3次元になります。

note: Tag: title
en: Triangle
ja: 三角形 (Triangle)

note: Tag: para
en: A Triangle is a polygon defined by three distinct non-collinear vertices. Because a Triangle is a polygon it is specified by four coordinates, with the first and fourth being equal.
ja: 三角形は三つの異なる非共線頂点で定義されるポリゴンです。三角形はポリゴンですので、四つの座標で指定され、一つ目と四つ目は同じです。

note: Tag: para
en: A TIN is a collection of non-overlapping <link linkend="Triangle">Triangle</link>s representing a <link xlink:href="https://en.wikipedia.org/wiki/Triangulated_irregular_network">Triangulated Irregular Network</link>.
ja: TINは<link xlink:href="https://en.wikipedia.org/wiki/Triangulated_irregular_network">Triangulated Irregular Network</link>を表現する、オーバラップしない<link linkend="Triangle">三角形</link>のコレクションです。

note: Tag: title
en: SQL/MM Part 3 - Curves
ja: SQL/MM Part 3 - 曲線

note: Tag: para
en: The <link xlink:href="https://www.iso.org/obp/ui/#iso:std:iso-iec:13249:-3:ed-5:v1:en"><emphasis>ISO/IEC 13249-3 SQL Multimedia - Spatial</emphasis></link> standard (SQL/MM) extends the OGC SFA to define Geometry subtypes containing curves with circular arcs. The SQL/MM types support 3DM, 3DZ and 4D coordinates.
ja: <link xlink:href="https://www.iso.org/obp/ui/#iso:std:iso-iec:13249:-3:ed-5:v1:en"><emphasis>ISO/IEC 13249-3 SQL Multimedia - Spatial</emphasis></link>標準 (SQL/MM) は、OGC SFAを拡張して、曲線ジオメトリを含むサブタイプを定義しています。SQL/MMタイプはXYM, XYZ, XYZMに対応します。

note: Tag: para
en: All floating point comparisons within the SQL-MM implementation are performed to a specified tolerance, currently 1E-8.
ja: SQL-MM実装での全ての浮動小数点数の比較では、所定の丸め誤差があります。現在は1E-8です。

note: Tag: title
en: CircularString
ja: 曲線ストリング (CircularStringCircularString)

note: Tag: para
en: CircularString is the basic curve type, similar to a LineString in the linear world. A single arc segment is specified by three points: the start and end points (first and third) and some other point on the arc. To specify a closed circle the start and end points are the same and the middle point is the opposite point on the circle diameter (which is the center of the arc). In a sequence of arcs the end point of the previous arc is the start point of the next arc, just like the segments of a LineString. This means that a CircularString must have an odd number of points greater than 1.
ja: 曲線ストリングは、基本的な曲線タイプです。線形の世界のラインストリングに似ています。単一の円弧線分は、始点、終点 (1番目と3番目)、弧の他の点の三つの点で定義されます。閉じた円を指定するには、開始点と終了点を同じにし、中間点を対称点 (円弧の中心)に置きます。連続する円弧では、前の円弧の終端と次の円弧の始端とが同じです。よって曲線ストリングは1以上の奇数個のポイントを持つことになります。

note: Tag: title
en: CompoundCurve
ja: 複合曲線 (CompoundCurve)

note: Tag: para
en: A CompoundCurve is a single continuous curve that may contain both circular arc segments and linear segments. That means that in addition to having well-formed components, the end point of every component (except the last) must be coincident with the start point of the following component.
ja: 複合曲線は、曲線区間と直線区間の両方を含むことができる単一の連続した曲線です。このことは、整形された要素を持つことに加えて、全ての要素の最後のポイントは次の要素の最初のポイントでなければならないことを意味します。

note: Tag: title
en: CurvePolygon
ja: 曲線ポリゴン (CurvePolygon)

note: Tag: para
en: A CurvePolygon is like a polygon, with an outer ring and zero or more inner rings. The difference is that a ring can be a CircularString or CompoundCurve as well as a LineString.
ja: 曲線ポリゴンは、外側の輪がひとつで0以上の内側のリングがある点はポリゴンに似ています。違いは、ポリゴンのリングはラインストリングですが曲線ポリゴンのリングは曲線ストリングまたは複合ストリングである点です。

note: Tag: para
en: As of PostGIS 1.4 PostGIS supports compound curves in a curve polygon.
ja: PostGIS 1.4から、PostGISで曲線ポリゴンで複合曲線をサポートするようになりました。

note: Tag: para
en: Example: A CurvePolygon with the shell defined by a CompoundCurve containing a CircularString and a LineString, and a hole defined by a CircularString
ja: 例: CIRCULARSTRINGとLINESTRINGからなるCOMPOUNDCURVEで定義される外殻を持ち、CIRCULARSTRINGで定義される穴を持つCURVEPOLYGON

note: Tag: title
en: MultiCurve
ja: マルチ曲線 (Multicurve)

note: Tag: para
en: A MultiCurve is a collection of curves which can include LineStrings, CircularStrings or CompoundCurves.
ja: マルチ曲線は曲線のコレクションで、ラインストリング、曲線ストリング、複合曲線を含むことができます。

note: Tag: title
en: MultiSurface
ja: マルチサーフェス (MultiSurface)

note: Tag: para
en: A MultiSurface is a collection of surfaces, which can be (linear) Polygons or CurvePolygons.
ja: マルチサーフェスはサーフェスのコレクションです。サーフェスは(線形)ポリゴンまたは曲線ポリゴンとなることができます。

note: Tag: title
en: WKT and WKB
ja: WKTとWKB

note: Tag: para
en: The OGC SFA specification defines two formats for representing geometry values for external use: Well-Known Text (WKT) and Well-Known Binary (WKB). Both WKT and WKB include information about the type of the object and the coordinates which define it.
ja: OGC SFA仕様では、ジオメトリ値を外部で使用するための表現として二つの標準書式が定義されています。Well-Known Text (WKT)とWell-Known Binary (WKB)です。WKTとWKBは両方ともそのオブジェクトを定義するタイプと座標に関する情報を含んでいます。

note: Tag: para
en: Well-Known Text (WKT) provides a standard textual representation of spatial data. Examples of WKT representations of spatial objects are:
ja: Well-Known Text (WKT)で空間データの標準的な文字表現が可能です。空間オブジェクトのWKT表現の例を次に挙げます。

note: Tag: para
en: Input and output of WKT is provided by the functions <xref linkend="ST_AsText"/> and <xref linkend="ST_GeomFromText"/>:
ja: WKTの入出力は関数<xref linkend="ST_AsText"/>と<xref linkend="ST_GeomFromText"/>によって提供されます。

note: Tag: para
en: For example, a statement to create and insert a spatial object from WKT and a SRID is:
ja: 例えば、WKTとSRIDからの空間オブジェクトの生成と挿入のステートメントは次の通りです。

note: Tag: para
en: Well-Known Binary (WKB) provides a portable, full-precision representation of spatial data as binary data (arrays of bytes). Examples of the WKB representations of spatial objects are:
ja: Well-Known Binary (WKB)は、空間データのバイナリデータ (バイト列)で、移植可能かつ正確な表現です。空間オブジェクトのWKB表現を次に挙げます。

note: Tag: para
en: Input and output of WKB is provided by the functions <xref linkend="ST_AsBinary"/> and <xref linkend="ST_GeomFromWKB"/>:
ja: WKBの入出力は関数<xref linkend="ST_AsBinary"/>と<xref linkend="ST_GeomFromWKB"/>が提供されています。次のように使います。

note: Tag: para
en: For example, a statement to create and insert a spatial object from WKB is:
ja: たとえば、WKBから空間オブジェクトの生成、挿入は次のようにします。

note: Tag: title
en: Geometry Data Type
ja: ジオメトリデータタイプ

note: Tag: para
en: PostGIS implements the OGC Simple Features model by defining a PostgreSQL data type called <varname>geometry</varname>. It represents all of the geometry subtypes by using an internal type code (see <xref linkend="GeometryType"/> and <xref linkend="ST_GeometryType"/>). This allows modelling spatial features as rows of tables defined with a column of type <varname>geometry</varname>.
ja: PostGISは、<varname>geometry</varname>というPostgreSQIデータ型を定義して、OGC Simple Features model を実装しています。これで、内部タイプコード (<xref linkend="GeometryType"/>と<xref linkend="ST_GeometryType"/>参照)で全てのジオメトリのサブタイプを表現します。これにより、カラム型で定義されたテーブルの行として、空間地物をモデリングすることが可能となります。

note: Tag: para
en: The <varname>geometry</varname> data type is <emphasis>opaque</emphasis>, which means that all access is done via invoking functions on geometry values. Functions allow creating geometry objects, accessing or updating all internal fields, and compute new geometry values. PostGIS supports all the functions specified in the OGC <link xlink:href="https://portal.ogc.org/files/?artifact_id=25354"><emphasis>Simple feature access - Part 2: SQL option</emphasis></link> (SFS) specification, as well many others. See <xref linkend="reference"/> for the full list of functions.
ja: <varname>geometry</varname>データ型は<emphasis>透過</emphasis>です。ジオメトリ値に関する関数から全てにアクセスできることを意味します。関数によって、ジオメトリオブジェクトの生成、全ての内部フィールドへのアクセスと更新、新しいジオメトリ値の計算が可能です。PostGISは、OGC <link xlink:href="https://portal.ogc.org/files/?artifact_id=25354"><emphasis>Simple feature access - Part 2: SQL option</emphasis></link> (SFS)仕様で定義されている全ての関数に、他の多数の関数とあわせて対応しています。関数の完全な一覧は<xref linkend="reference"/>をご覧下さい。

note: Tag: para
en: PostGIS follows the SFA standard by prefixing spatial functions with "ST_". This was intended to stand for "Spatial and Temporal", but the temporal part of the standard was never developed. Instead it can be interpreted as "Spatial Type".
ja: PostGISは、空間関数にプリフィクス"ST_"を付けて、SFA標準に従っています。これは、"Spatial and Temporal (空間と時間)"を示していますが、標準の時間の部分はまだ開発していません。その代わりに"Spatial Type (空間タイプ)"と解釈できます。

note: Tag: para
en: The SFA standard specifies that spatial objects include a Spatial Reference System identifier (SRID). The SRID is required when creating spatial objects for insertion into the database (it may be defaulted to 0). See <xref linkend="ST_SRID"/> and <xref linkend="spatial_ref_sys"/>
ja: SFA標準は、空間オブジェクトは空間参照系識別子 (SRID)を含むと規程しています。SRIDは、空間オブジェクトをデータベースに挿入するために生成した時に求められます (デフォルトとして0になるかも知れません)。<xref linkend="ST_SRID"/>と<xref linkend="spatial_ref_sys"/>をご覧下さい。

note: Tag: para
en: To make querying geometry efficient PostGIS defines various kinds of spatial indexes, and spatial operators to use them. See <xref linkend="build-indexes"/> and <xref linkend="using-query-indexes"/> for details.
ja: ジオメトリのクエリを効率的にするため、PostGISでは様々な種類の空間インデクスを定義しています。詳細については<xref linkend="build-indexes"/>と<xref linkend="using-query-indexes"/>をご覧下さい。

note: Tag: title
en: PostGIS EWKB and EWKT
ja: PostGIS EWKBとEWKT

note: Tag: para
en: OGC SFA specifications initially supported only 2D geometries, and the geometry SRID is not included in the input/output representations. The OGC SFA specification 1.2.1 (which aligns with the ISO 19125 standard) adds support for 3D (ZYZ) and measured (XYM and XYZM) coordinates, but still does not include the SRID value.
ja: OGC SFA仕様は、まず2次元ジオメトリのみに対応しました。また、入出力表現にジオメトリのSRIDは取り入れていまません。OGC SFA仕様 1.2.1 (ISO 19125標準に準拠)では3次元 (XYZ)とM値 (XYMとXYZM)座標に対応するようになりましたが、SIRD値の取り込みは依然行われていません。

note: Tag: para
en: Because of these limitations PostGIS defined extended EWKB and EWKT formats. They provide 3D (XYZ and XYM) and 4D (XYZM) coordinate support and include SRID information. Including all geometry information allows PostGIS to use EWKB as the format of record (e.g. in DUMP files).
ja: これらの制限のため、PostGISでは拡張書式であるEWKBとEWKTを定義しました。3次元 (XYZ, XYM)と4次元 (XYZN)座標系に対応し、SRID情報を取り込めるようにしました。すべてのジオメトリ情報を含めたので、PostGISはEWKBを格納用書式 (DUMPファイル等)として使えるようになりました。

note: Tag: para
en: EWKB and EWKT are used for the "canonical forms" of PostGIS data objects. For input, the canonical form for binary data is EWKB, and for text data either EWKB or EWKT is accepted. This allows geometry values to be created by casting a text value in either HEXEWKB or EWKT to a geometry value using <varname>::geometry</varname>. For output, the canonical form for binary is EWKB, and for text it is HEXEWKB (hex-encoded EWKB).
ja: PostGISデータオブジェクトの「カノニカルな形式」のためにEWKBとEWKTを使います。入力では、バイナリデータのカノニカルな形式はEWKB、テキストデータについてはEWKBかEWKTが受け付けられます。これにより、HEXEWKBまたはEWKTのテキスト値から<varname>::geometry</varname>を使用してキャストを行い、ジオメトリ値が生成できるようになりました。出力では、バイナリのカノニカルな形式はEWKBで、テキストはHEXEWKB (HEXエンコードを施したEWKB)です。

note: Tag: para
en: For example this statement creates a geometry by casting from an EWKT text value, and outputs it using the canonical form of HEXEWKB:
ja: たとえば、この手続きでは、EWKTテキスト値からのキャストでジオメトリを生成して、HEXWKBのカノニカルな形式を使った出力を行います。

note: Tag: para
en: PostGIS EWKT output has a few differences to OGC WKT:
ja: PostGIS EWKT出力はOGC WKTと次の通り相違点があります。

note: Tag: para
en: For 3DZ geometries the Z qualifier is omitted:
ja: XYZジオメトリでZ修飾子が省略されます。

note: Tag: para
en: For 3DM geometries the M qualifier is included:
ja: M値を含むXYMジオメトリ:

note: Tag: para
en: For 4D geometries the ZM qualifier is omitted:
ja: 4次元ジオメトリでZM修飾子を省略:

note: Tag: para
en: EWKT avoids over-specifying dimensionality and the inconsistencies that can occur with the OGC/ISO format, such as:
ja: EWKTは、次のようにOGC/ISO書式で発生しうる過剰次元と不整合を回避しています。

note: Tag: para
en: PostGIS extended formats are currently a superset of the OGC ones, so that every valid OGC WKB/WKT is also valid EWKB/EWKT. However, this might vary in the future, if the OGC extends a format in a way that conflicts with the PosGIS definition. Thus you SHOULD NOT rely on this compatibility!
ja: PostGISの拡張書式はOGC書式の上位互換であり、全ての妥当なOGC WKB/WKTは妥当なEWKB/EWKTでもあります。しかし、OGCがPostGISの定義と衝突する方法で書式を拡張した場合には、将来的に書式を変更する可能性があります。ゆえに、この互換性に*頼るべきではありません*!

note: Tag: para
en: Examples of the EWKT text representation of spatial objects are:
ja: 空間オブジェクトのEWKTテキスト表現の例:

note: Tag: para
en: SRID=32632;POINT(0 0) -- XY with SRID
ja: SRID=32632;POINT(0 0) -- SRID付きXY

note: Tag: para
en: SRID=4326;MULTIPOINTM(0 0 0,1 2 1) -- XYM with SRID
ja: SRID=4326;MULTIPOINTM(0 0 0,1 2 1) -- SRID付きXYM

note: Tag: para
en: Input and output using these formats is available using the following functions:
ja: これらの書式を使う入出力は次の関数を使うと有効です。

note: Tag: para
en: For example, a statement to create and insert a PostGIS spatial object using EWKT is:
ja: たとえば、EWKTを使ってPostGISの空間オブジェクトを作成し挿入するステートメントは次の通りです。

note: Tag: title
en: Geography Data Type
ja: ジオグラフィデータタイプ

note: Tag: para
en: The PostGIS <varname>geography</varname> data type provides native support for spatial features represented on "geographic" coordinates (sometimes called "geodetic" coordinates, or "lat/lon", or "lon/lat"). Geographic coordinates are spherical coordinates expressed in angular units (degrees).
ja: <varname>geography</varname>データタイプによって地理座標 ("geographic", "geodetic", "lat/lon", "lon/lat"など)上の空間地物表現にネイティブに対応できます。地理座標系は角度 (度)単位で表現される球面座標系です。

note: Tag: para
en: The basis for the PostGIS geometry data type is a plane. The shortest path between two points on the plane is a straight line. That means functions on geometries (areas, distances, lengths, intersections, etc) are calculated using straight line vectors and cartesian mathematics. This makes them simpler to implement and faster to execute, but also makes them inaccurate for data on the spheroidal surface of the earth.
ja: PostGISジオメトリ型の基礎は平面です。平面上の2点間の最短経路は直線です。ジオメトリに関する関数 (面積、距離、長さ、インタセクション等)は直線ベクトルとデカルト平面を使って計算しています。これで実装が簡単になり実行速度も上がりますが、地球の球面の上にあるデータについては不正確になります。

note: Tag: para
en: The PostGIS geography data type is based on a spherical model. The shortest path between two points on the sphere is a great circle arc. Functions on geographies (areas, distances, lengths, intersections, etc) are calculated using arcs on the sphere. By taking the spheroidal shape of the world into account, the functions provide more accurate results.
ja: PostGISジオグラフィというデータ型は球面モデルに基づいています。球面上の2点の最短経路は大円の弧にあたります。ジオグラフィの関数 (面積、距離、長さ、インタセクション等)は球面上の弧を使います。球面上の世界の形状を考慮に入れるので、より正確な結果が得られます。

note: Tag: para
en: Because the underlying mathematics is more complicated, there are fewer functions defined for the geography type than for the geometry type. Over time, as new algorithms are added the capabilities of the geography type will expand. As a workaround one can convert back and forth between geometry and geography types.
ja: 基礎となる数学はより複雑になるため、ジオグラフィ型で定義された関数はジオメトリ型で定義された関数よりも少なくなります。時間が経つにつれて新しいアルゴリズムが追加されて、ジオグラフィの機能が拡大していきます。回避策として、ジオメトリ型とジオグラフィ型との相互変換が可能です。

note: Tag: para
en: Like the geometry data type, geography data is associated with a spatial reference system via a spatial reference system identifier (SRID). Any geodetic (long/lat based) spatial reference system defined in the <varname>spatial_ref_sys</varname> table can be used. (Prior to PostGIS 2.2, the geography type supported only WGS 84 geodetic (SRID:4326)). You can add your own custom geodetic spatial reference system as described in <xref linkend="user-spatial-ref-sys"/>.
ja: ジオグラフィ型は、ジオメトリ型のように、空間参照系識別子 (SRID)を介して空間参照系と関連付けられます。<varname>spatial_ref_sys</varname>テーブルで定義されているあらゆる地理空間参照系 (経度/緯度を使う)が使えます (PostGIS 2.2より前ではジオグラフィ型はWGS 84地理座標系 (SRID:4326)にのみ対応していました)。<xref linkend="user-spatial-ref-sys"/>に書いている通り、独自の空間参照系を追加することもできます。

note: Tag: para
en: For all spatial reference systems the units returned by measurement functions (e.g. <xref linkend="ST_Distance"/>, <xref linkend="ST_Length"/>, <xref linkend="ST_Perimeter"/>, <xref linkend="ST_Area"/>) and for the distance argument of <xref linkend="ST_DWithin"/> are in meters.
ja: 計測関数 (例 <xref linkend="ST_Distance"/>、<xref linkend="ST_Length"/>、<xref linkend="ST_Perimeter"/>、<xref linkend="ST_Area"/>)によって返されるものの単位と、<xref linkend="ST_DWithin"/>の引数で与えられる距離との、空間参照系の単位は、メートルです。

note: Tag: title
en: Creating Geography Tables
ja: ジオグラフィテーブルの生成

note: Tag: para
en: You can create a table to store geography data using the <link xlink:href="https://www.postgresql.org/docs/current/sql-createtable.html">CREATE TABLE</link> SQL statement with a column of type <varname>geography</varname>. The following example creates a table with a geography column storing 2D LineStrings in the WGS84 geodetic coordinate system (SRID 4326):
ja: ジオグラフィデータを格納するテーブルは、SQLステートメント<link xlink:href="https://www.postgresql.org/docs/current/sql-createtable.html">CREATE TABLE</link>に<varname>geography</varname>型のカラムを付けることで生成することができます。2次元ラインストリングをWGS84地理座標系 (SRID 4326)で保存するジオグラフィカラムを持つテーブルを生成する例を次に示します。

note: Tag: para
en: The geography type supports two optional type modifiers:
ja: 二つの任意の型修飾子に対応するジオグラフィ型:

note: Tag: para
en: the spatial type modifier restricts the kind of shapes and dimensions allowed in the column. Values allowed for the spatial type are: POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON, GEOMETRYCOLLECTION. The geography type does not support curves, TINS, or POLYHEDRALSURFACEs. The modifier supports coordinate dimensionality restrictions by adding suffixes: Z, M and ZM. For example, a modifier of 'LINESTRINGM' only allows linestrings with three dimensions, and treats the third dimension as a measure. Similarly, 'POINTZM' requires four dimensional (XYZM) data.
ja: 空間の型修飾子は、カラム内で許される形状の種類や次元を規制します。値によって空間型はPOINT、LINESTRING、POLYGON、MULTIPOINT、MULTILINESTRING、MULTIPOLYGON、GEOMETRYCOLLECTIONが可能です。ジオグラフィ型は曲線や三角形、多面体サーフェスに対応していません。型修飾子に後置詞Z、M、ZMを付けることで、座標次元の制約に対応しています。たとえば、'LINESTRINGM'は、3次元で3番目の軸はMであるラインストリングのみを許します。同様に'POINTZM'では4次元 (XYZM)データが求められます。

note: Tag: para
en: the SRID modifier restricts the spatial reference system SRID to a particular number. If omitted, the SRID defaults to 4326 (WGS84 geodetic), and all calculations are performed using WGS84.
ja: SRID修飾子は空間参照系(SRID)を特定の数値になるよう制約します。省略した場合には、デフォルトは4326 (WGS84地理座標系)となり、全ての計算はWGS84を使ったものになります。

note: Tag: para
en: Examples of creating tables with geography columns:
ja: ジオグラフィカラムを持つテーブルの生成の例を次に挙げます。

note: Tag: para
en: Create a table with 2D POINT geography with the default SRID 4326 (WGS84 long/lat):
ja: SRIDがデフォルトの4326 (WGS84 経度/緯度)である2次元ポイントジオグラフィを持つテーブルの生成:

note: Tag: para
en: Create a table with 2D POINT geography in NAD83 longlat:
ja: NAD83緯度/経度の2次元ポイントジオグラフィを持つテーブルの生成:

note: Tag: para
en: Create a table with 3D (XYZ) POINTs and an explicit SRID of 4326:
ja: SRIDを4326で明示した3次元 (XYZ)ポイントジオグラフィを持つテーブルの生成:

note: Tag: para
en: Create a table with 2D LINESTRING geography with the default SRID 4326:
ja: SRIDがデフォルトの4326である2次元ラインストリングジオグラフィを持つテーブルの生成:

note: Tag: para
en: Create a table with 2D POLYGON geography with the SRID 4267 (NAD 1927 long lat):
ja: SRIDがデ4326 (NAD 1927 経度/緯度)である2次元ポリゴンジオグラフィを持つテーブルの生成:

note: Tag: para
en: Geography fields are registered in the <varname>geography_columns</varname> system view. You can query the <varname>geography_columns</varname> view and see that the table is listed:
ja: ジオグラフィカラムは<varname>geography_columns</varname>システムビューに登録されます。<varname>geography_columns</varname>ビューにクエリを出してテーブルを見るには、次の通りにします。

note: Tag: para
en: Creating a spatial index works the same as for geometry columns. PostGIS will note that the column type is GEOGRAPHY and create an appropriate sphere-based index instead of the usual planar index used for GEOMETRY.
ja: 空間インデックスはジオメトリカラムと同じように機能します。PostGISは、カラム型がジオグラフィであると通知したうえで、ジオメトリに使う通常の平面用インデックスでなく、球面を基にした適切なインデックスを生成します。

note: Tag: title
en: Using Geography Tables
ja: ジオグラフィテーブルの使用

note: Tag: para
en: You can insert data into geography tables in the same way as geometry. Geometry data will autocast to the geography type if it has SRID 4326. The <link linkend="EWKB_EWKT">EWKT and EWKB</link> formats can also be used to specify geography values.
ja: ジオメトリと同じ方法でジオグラフィテーブルにデータを挿入できます。ジオメトリデータは、SRID 4326の場合には、ジオグラフィ型に自動キャストされます。<link linkend="EWKB_EWKT">EWKTとEWKB</link>書式はジオグラフィ値を指定するために使うことができます。

note: Tag: para
en: Any geodetic (long/lat) spatial reference system listed in <varname>spatial_ref_sys</varname> table may be specified as a geography SRID. Non-geodetic coordinate systems raise an error if used.
ja: <varname>spatial_ref_sys</varname>テーブルにある地理 (経度/緯度)参照系は、ジオグラフィのSRIDとして指定することができます。非地理座標系を使うとエラーが発生します。

note: Tag: para
en: Query and measurement functions use units of meters. So distance parameters should be expressed in meters, and return values should be expected in meters (or square meters for areas).
ja: クエリと計測関数はメートル単位となります。そのため距離パラメータはメートル (面積の場合は平方メートル)単位となります。

note: Tag: para
en: You can see the power of geography in action by calculating how close a plane flying a great circle route from Seattle to London (LINESTRING(-122.33 47.606, 0.0 51.5)) comes to Reykjavik (POINT(-21.96 64.15)) (<link xlink:href="http://gc.kls2.com/cgi-bin/gc?PATH=SEA-LHR">map the route</link>).
ja: シアトルからロンドンへの (LINESTRING(-122.33 47.606, 0.0 51.5))大円航路を行く航空機がレイキャビク (POINT(-21.96 64.15)) にどれだけ近づくかを計算することで、ジオグラフィの力を見ことができます (<link xlink:href="http://gc.kls2.com/cgi-bin/gc?PATH=SEA-LHR">航路の地図表示</link>)。

note: Tag: para
en: The geography type calculates the true shortest distance of 122.235 km over the sphere between Reykjavik and the great circle flight path between Seattle and London.
ja: ジオグラフィ型は、レイキャビクとシアトル－ロンドン間の大円航路との距離について、球面上で122.235 kmという本当の最短距離を計算します。

note: Tag: para
en: The geometry type calculates a meaningless cartesian distance between Reykjavik and the straight line path from Seattle to London plotted on a flat map of the world. The nominal units of the result is "degrees", but the result doesn't correspond to any true angular difference between the points, so even calling them "degrees" is inaccurate.
ja: ジオメトリ型では、平面の世界地図上で見て、レイキャビクとシアトル－ロンドン間の直線とのデカルト距離が計算され、意味がありません。計算結果の名目上の単位は「度」ですが、点間の本当の角度差に応じるものではなく、「度」と呼ぶこと自体が不正確です。

note: Tag: title
en: When to use the Geography data type
ja: ジオグラフィ型を使用すべき時

note: Tag: para
en: The geography data type allows you to store data in longitude/latitude coordinates, but at a cost: there are fewer functions defined on GEOGRAPHY than there are on GEOMETRY; those functions that are defined take more CPU time to execute.
ja: ジオグラフィ型によって、経度緯度座標でデータを格納できるようになりましたが、ジオグラフィで定義されている関数が、ジオメトリより少ないのと、実行にCPU時間がかかる、というところが犠牲になっています。

note: Tag: para
en: The data type you choose should be determined by the expected working area of the application you are building. Will your data span the globe or a large continental area, or is it local to a state, county or municipality?
ja: 選択した型が、期待する領域から出ないことを、ジオメトリ型にして使用する条件とすべきです。使用するデータは地球全体か、大陸か、州か、自治体か?

note: Tag: para
en: If your data is contained in a small area, you might find that choosing an appropriate projection and using GEOMETRY is the best solution, in terms of performance and functionality available.
ja: データが小さいエリア内におさまるなら、適切な投影を選択してジオメトリを使うのが、効率面でも機能面でも最も良い方法です。

note: Tag: para
en: If your data is global or covers a continental region, you may find that GEOGRAPHY allows you to build a system without having to worry about projection details. You store your data in longitude/latitude, and use the functions that have been defined on GEOGRAPHY.
ja: データが地球全体か大陸なら、ジオグラフィで投影法の細かい問題を気にせずにシステムを構築できるでしょう。経度/緯度のデータを保存して、ジオグラフィで定義された関数使います。

note: Tag: para
en: If you don't understand projections, and you don't want to learn about them, and you're prepared to accept the limitations in functionality available in GEOGRAPHY, then it might be easier for you to use GEOGRAPHY than GEOMETRY. Simply load your data up as longitude/latitude and go from there.
ja: 投影法を理解していなくて、学習したくもなくて、かつ、ジオグラフィで使える関数が限られていることを受け入れるのなら、ジオグラフィを使った方が簡単です。単純にデータを経度/緯度でロードして、そこから進めて下さい。

note: Tag: para
en: Refer to <xref linkend="PostGIS_TypeFunctionMatrix"/> for compare between what is supported for Geography vs. Geometry. For a brief listing and description of Geography functions, refer to <xref linkend="PostGIS_GeographyFunctions"/>
ja: ジオグラフィとジオメトリ間のサポート状況の比較については<xref linkend="PostGIS_TypeFunctionMatrix"/>をご覧下さい。ジオグラフィ関数の簡潔なリストと説明については<xref linkend="PostGIS_GeographyFunctions"/>をご覧下さい。

note: Tag: title
en: Geography Advanced FAQ
ja: ジオグラフィに関する高度なよくある質問

note: Tag: para
en: Do you calculate on the sphere or the spheroid?
ja: 球または回転楕円体のどちらで計算するのでしょうか?

note: Tag: para
en: By default, all distance and area calculations are done on the spheroid. You should find that the results of calculations in local areas match up will with local planar results in good local projections. Over larger areas, the spheroidal calculations will be more accurate than any calculation done on a projected plane.
ja: デフォルトでは、全ての距離と面積の計算は回転楕円体で行います。局所的なエリアでの計算結果と良好な投影を施した平面での結果と比較して下さい。大きなエリアの場合は、回転楕円体計算は、投影平面上でのどの計算よりも精度が高くなります。

note: Tag: para
en: All the geography functions have the option of using a sphere calculation, by setting a final boolean parameter to 'FALSE'. This will somewhat speed up calculations, particularly for cases where the geometries are very simple.
ja: 全てのジオグラフィ関数には、最後の真偽パラメータを'FALSE'にすると球面を使った計算を行うというオプションがあります。これは、特にジオメトリが非常に単純である場合に計算を速くするためのものです。

note: Tag: para
en: What about the date-line and the poles?
ja: 日付変更線や極に関してはどうなっていますか?

note: Tag: para
en: All the calculations have no conception of date-line or poles, the coordinates are spherical (longitude/latitude) so a shape that crosses the dateline is, from a calculation point of view, no different from any other shape.
ja: 全ての計算に日付変更線や極の概念がありません。座標は球 (経度/緯度)であるので、日付変更線とクロスする形状は、計算の観点からは、他のものと変わりありません。

note: Tag: para
en: What is the longest arc you can process?
ja: 処理できる最も長い弧はどうなりますか?

note: Tag: para
en: We use great circle arcs as the "interpolation line" between two points. That means any two points are actually joined up two ways, depending on which direction you travel along the great circle. All our code assumes that the points are joined by the *shorter* of the two paths along the great circle. As a consequence, shapes that have arcs of more than 180 degrees will not be correctly modelled.
ja: 大圏の弧を2点の「補完線」として使用しています。任意の2点は、実際には2方向につながっていて、どちらの方向に行くかに依存します。PostGISの全てのコードは、大圏コースの2コースのうち*短い*方でつながっていると仮定しています。結果として、180度以上の弧を持つ形状は正しくモデル化されません。

note: Tag: para
en: Why is it so slow to calculate the area of Europe / Russia / insert big geographic region here ?
ja: なぜヨーロッパやロシアといった大きな範囲の面積計算はとても遅いのですか?

note: Tag: para
en: Because the polygon is so darned huge! Big areas are bad for two reasons: their bounds are huge, so the index tends to pull the feature no matter what query you run; the number of vertices is huge, and tests (distance, containment) have to traverse the vertex list at least once and sometimes N times (with N being the number of vertices in the other candidate feature).
ja: ポリゴンがとんでもなく大きいからです。二つの理由から、大きなエリアは悪いです。一つは、バウンダリボックスが大きいため、どのようなクエリを走らせても、インデックスがフィーチャーを引っ張ってくる傾向にあるためです。もう一つは、頂点数が巨大で、テスト (距離、包含)関数では、少なくとも1回、通常はN (Nは、もう一方のフィーチャーの頂点数)回、頂点を横断しなければならないためです。

note: Tag: para
en: As with GEOMETRY, we recommend that when you have very large polygons, but are doing queries in small areas, you "denormalize" your geometric data into smaller chunks so that the index can effectively subquery parts of the object and so queries don't have to pull out the whole object every time. Please consult <xref linkend="ST_Subdivide"/> function documentation. Just because you *can* store all of Europe in one polygon doesn't mean you *should*.
ja: ジオメトリでは、大きなポリゴンを持っているけれども小さな範囲のクエリを実行する時、ジオメトリデータ情報を小片に「非正規化」します。これにより、インデックスが効果的にオブジェクトの一部を問い合わせるようになり、またクエリが常にオブジェクト全体を引っ張りこむようなことがないようになります。<xref linkend="ST_Subdivide"/>を参照して下さい。ヨーロッパ全体を一つのポリゴンに*格納できる*からといって、*そうすべき*だというわけではありません。

note: Tag: para
en: PostGIS is compliant with the Open Geospatial Consortium’s (OGC) Simple Features specification. That standard defines the concepts of geometry being <emphasis>simple</emphasis> and <emphasis>valid</emphasis>. These definitions allow the Simple Features geometry model to represent spatial objects in a consistent and unambiguous way that supports efficient computation. (Note: the OGC SF and SQL/MM have the same definitions for simple and valid.)
ja: PostGISはOpen Geospatial Consortium (OGC)のSimple Feature Specificationに準拠しています。この標準では、<emphasis>単純</emphasis>なジオメトリと<emphasis>妥当</emphasis>なジオメトリの概念が定義されています。これらの定義によって、Simple Featureのジオメトリモデルが一貫性があって、かつ明確な方法で空間オブジェクトを表現することができ、効率的な計算を助けます (OGC Simple FeatureとSQL/MMとにおいては、単純性と妥当性について同じ定義です)。

note: Tag: title
en: Simple Geometry
ja: 単純ジオメトリ

note: Tag: para
en: A <emphasis>simple</emphasis> geometry is one that has no anomalous geometric points, such as self intersection or self tangency.
ja: <emphasis>単純</emphasis>なジオメトリは、自己交差や自己接触といった異常な幾何学上のポイントを持たないジオメトリです。

note: Tag: para
en: A <varname>POINT</varname> is inherently <emphasis>simple</emphasis> as a 0-dimensional geometry object.
ja: <varname>POINT</varname>は0次元ジオメトリオブジェクトとして常に<emphasis>単純</emphasis>です。

note: Tag: para
en: <varname>MULTIPOINT</varname>s are <emphasis>simple</emphasis> if no two coordinates (<varname>POINT</varname>s) are equal (have identical coordinate values).
ja: <varname>MULTIPOINT</varname>は、任意の二つの座標値 (<varname>POINT</varname>)が同じでないなら<emphasis>単純</emphasis>です。

note: Tag: para
en: A <varname>LINESTRING</varname> is <emphasis>simple</emphasis> if it does not pass through the same point twice, except for the endpoints. If the endpoints of a simple LineString are identical it is called <emphasis>closed</emphasis> and referred to as a Linear Ring.
ja: <varname>LINESTRING</varname>は、同じポイントを二回通過しないものが<emphasis>単純</emphasis>です。単純なラインストリングの端点が同一の場合には、<emphasis>閉じている</emphasis>とされ、線形リングと呼ばれます。

note: Tag: emphasis
en: <emphasis role="bold">(a)</emphasis> and <emphasis role="bold">(c)</emphasis> are simple <varname>LINESTRING</varname>s. <emphasis role="bold">(b)</emphasis> and <emphasis role="bold">(d)</emphasis> are not simple. <emphasis role="bold">(c)</emphasis> is a closed Linear Ring.
ja: <emphasis role="bold">(a)</emphasis>と<emphasis role="bold">(c)</emphasis>は単純な<varname>LINESTRING</varname>です。<emphasis role="bold">(b)</emphasis>と<emphasis role="bold">(d)</emphasis>は単純ではありません。<emphasis role="bold">(c)</emphasis>は閉じた線形リングです。

note: Tag: para
en: A <varname>MULTILINESTRING</varname> is <emphasis>simple</emphasis> only if all of its elements are simple and the only intersection between any two elements occurs at points that are on the boundaries of both elements.
ja: <varname>MULTILINESTRING</varname>は、要素が全て単純で、かつ、全ての要素同士のインタセクションが要素の境界上でのみ出現する場合には、<emphasis>単純</emphasis>です。

note: Tag: emphasis
en: <emphasis role="bold">(e)</emphasis> and <emphasis role="bold">(f)</emphasis> are simple <varname>MULTILINESTRING</varname>s. <emphasis role="bold">(g)</emphasis> is not simple.
ja: <emphasis role="bold">(e)</emphasis>と<emphasis role="bold">(f)</emphasis>は単純な<varname>MULTILINESTRING</varname>です。<emphasis role="bold">(g)</emphasis>は単純ではありません。

note: Tag: para
en: <varname>POLYGON</varname>s are formed from linear rings, so valid polygonal geometry is always <emphasis>simple</emphasis>.
ja: <varname>POLYGON</varname>は線形リングから形成されるので、妥当なポリゴンジオメトリは常に<emphasis>単純</emphasis>です。

note: Tag: para
en: To test if a geometry is simple use the <xref linkend="ST_IsSimple"/> function:
ja: ジオメトリが単純かどうかを試すには<xref linkend="ST_IsSimple"/>関数を使います。次のようにします。

note: Tag: para
en: Generally, PostGIS functions do not require geometric arguments to be simple. Simplicity is primarily used as a basis for defining geometric validity. It is also a requirement for some kinds of spatial data models (for example, linear networks often disallow lines that cross). Multipoint and linear geometry can be made simple using <xref linkend="ST_UnaryUnion"/>.
ja: 一般的にPostGIS関数は引数ジオメトリの単純性を求めていません。単純性は主にジオメトリの妥当性を定義するための基礎として用いられます。空間データモデルによっては要件としていることもあります (たとえば、線形ネットワークはしばしばクロスを認めません)。マルチポイントと線形ジオメトリは<xref linkend="ST_UnaryUnion"/>を使って単純にできます。

note: Tag: title
en: Valid Geometry
ja: 妥当なジオメトリ

note: Tag: para
en: Geometry validity primarily applies to 2-dimensional geometries (<varname>POLYGON</varname>s and <varname>MULTIPOLYGON</varname>s) . Validity is defined by rules that allow polygonal geometry to model planar areas unambiguously.
ja: ジオメトリの妥当性は主に2次元ジオメトリ (<varname>POLYGON</varname>と<varname>MULTIPOLYGON</varname>)に適用されます。妥当性はポリゴンジオメトリが平面領域を明確にモデル化できる規則によって定義されます。

note: Tag: para
en: A <varname>POLYGON</varname> is <emphasis>valid</emphasis> if:
ja: <varname>POLYGON</varname>は次の条件では<emphasis>妥当</emphasis>です。

note: Tag: para
en: the polygon boundary rings (the exterior shell ring and interior hole rings) are <emphasis>simple</emphasis> (do not cross or self-touch). Because of this a polygon cannot have cut lines, spikes or loops. This implies that polygon holes must be represented as interior rings, rather than by the exterior ring self-touching (a so-called "inverted hole").
ja: ポリゴン境界リング (外側の殻リングと内側の穴リング)が<emphasis>単純</emphasis> (交差も自己接触もしていない)であること。これによりポリゴンは切断線、トゲ、循環を持つことができなくなります。これは、ポリゴンの穴を外側のリングの自己接触 (いわゆる "inverted hole" (逆穴))でなく、内側のリングとして表現されなけれならないことを意味します。

note: Tag: para
en: boundary rings do not cross
ja: 境界リングがクロスしないこと

note: Tag: para
en: boundary rings may touch at points but only as a tangent (i.e. not in a line)
ja: 境界リングは点で接触したとしても接点として接触すること (線上にあってはなりません)

note: Tag: para
en: interior rings are contained in the exterior ring
ja: 内側リングは外側リング内にあること

note: Tag: para
en: the polygon interior is simply connected (i.e. the rings must not touch in a way that splits the polygon into more than one part)
ja: ポリゴン内部は単純に接続されていること (リングはポリゴンを複数に分割するように接触してはなりません)

note: Tag: emphasis
en: <emphasis role="bold">(h)</emphasis> and <emphasis role="bold">(i)</emphasis> are valid <varname>POLYGON</varname>s. <emphasis role="bold">(j-m)</emphasis> are invalid. <emphasis role="bold">(j)</emphasis> can be represented as a valid <varname>MULTIPOLYGON</varname>.
ja: <emphasis role="bold">(h)</emphasis>と<emphasis role="bold">(i)</emphasis>は妥当な<varname>POLYGON</varname>です。<emphasis role="bold">(j-m)</emphasis>は不正です。<emphasis role="bold">(j)</emphasis>は妥当な<varname>MULTIPOLYGON</varname>として表すことができます。

note: Tag: para
en: A <varname>MULTIPOLYGON</varname> is <emphasis>valid</emphasis> if:
ja: <varname>MULTIPOLYGON</varname>は次の条件では<emphasis>妥当</emphasis>です。

note: Tag: para
en: its element <varname>POLYGON</varname>s are valid
ja: 要素となる<varname>POLYGON</varname>が妥当であること

note: Tag: para
en: elements do not overlap (i.e. their interiors must not intersect)
ja: 要素がオーバラップしない (内部同士がインタセクトしない)こと

note: Tag: para
en: elements touch only at points (i.e. not along a line)
ja: 要素同士の接触が点でけである (線に沿って接触しない)こと

note: Tag: emphasis
en: <emphasis role="bold">(n)</emphasis> is a valid <varname>MULTIPOLYGON</varname>. <emphasis role="bold">(o)</emphasis> and <emphasis role="bold">(p)</emphasis> are invalid.
ja: <emphasis role="bold">(n)</emphasis>は妥当な<varname>MULTIPOLYGON</varname>です。<emphasis role="bold">(o)</emphasis>と<emphasis role="bold">(p)</emphasis>は不正です。

note: Tag: para
en: These rules mean that valid polygonal geometry is also <emphasis>simple</emphasis>.
ja: これらの規則は妥当なポリゴンジオメトリも<emphasis>単純</emphasis>であることも示しています。

note: Tag: para
en: For linear geometry the only validity rule is that <varname>LINESTRING</varname>s must have at least two points and have non-zero length (or equivalently, have at least two distinct points.) Note that non-simple (self-intersecting) lines are valid.
ja: 線ジオメトリについては、<varname>LINESTRING</varname>が少なくとも二つのポイントを持ち、長さが0でない (少なくとも二つの異なるポイントを持つことと同じ)、というのが唯一の妥当性規則です。単純でない (自己交差がある)ラインは妥当です。

note: Tag: para
en: <varname>POINT</varname> and <varname>MULTIPOINT</varname> geometries have no validity rules.
ja: <varname>POINT</varname>と<varname>MULTIPOINT</varname>は妥当性規則を持っていません。

note: Tag: title
en: Managing Validity
ja: 妥当性の管理

note: Tag: para
en: PostGIS allows creating and storing both valid and invalid Geometry. This allows invalid geometry to be detected and flagged or fixed. There are also situations where the OGC validity rules are stricter than desired (examples of this are zero-length linestrings and polygons with inverted holes.)
ja: PostGISは妥当なジオメトリも不正なジオメトリも、生成も格納もできます。このため、不正なジオメトリを検出し、フラグを付け、訂正することができます。OGC妥当性規則が求める規則 (長さが0のラインストリングや逆穴を持つポリゴン等)よりも厳格であることもあります。

note: Tag: para
en: Many of the functions provided by PostGIS rely on the assumption that geometry arguments are valid. For example, it does not make sense to calculate the area of a polygon that has a hole defined outside of the polygon, or to construct a polygon from a non-simple boundary line. Assuming valid geometric inputs allows functions to operate more efficiently, since they do not need to check for topological correctness. (Notable exceptions are that zero-length lines and polygons with inversions are generally handled correctly.) Also, most PostGIS functions produce valid geometry output if the inputs are valid. This allows PostGIS functions to be chained together safely.
ja: PostGISが提供する関数の多くは、引数ジオメトリが妥当であるとの仮定によっています。たとえば、ポリゴンの外部に穴があるポリゴンの面積を計算しても意味がありませんし、単純でない境界線からポリゴンを形成するのも意味がありません。妥当なジオメトリ入力を仮定することで、トポロジ的に正しいことを確認する必要がなくなるので、関数がより効率的に動作することができます (例外として、長さ0のラインと反転したポリゴンは一般的に正しく取り扱われます)。また、ほとんどのPostGIS関数は、入力ジオメトリが妥当な場合には、妥当なジオメトリ出力を生成します。これにより、PostGIS関数を安全に連鎖させられます。

note: Tag: para
en: If you encounter unexpected error messages when calling PostGIS functions (such as "GEOS Intersection() threw an error!"), you should first confirm that the function arguments are valid. If they are not, then consider using one of the techniques below to ensure the data you are processing is valid.
ja: PostGIS関数を呼ぶときに予期しないエラーメッセージ ("GEOS Intersection() threw an error!"等)に遭遇する場合には、まず関数の引数が妥当かどうかを確認します。妥当でないなら、次に示す方法のいずれかによる、処理中のデータの妥当性の確認を検討して下さい。

note: Tag: para
en: If a function reports an error with valid inputs, then you may have found an error in either PostGIS or one of the libraries it uses, and you should report this to the PostGIS project. The same is true if a PostGIS function returns an invalid geometry for valid input.
ja: 関数が妥当な入力でエラーを報告する場合には、PostGISまたは使用しているライブラリの一つの中にエラーがあるのを発見することがありますが、その際はPostGISプロジェクトに報告して下さい。PostGIS関数が妥当な入力から不正なジオメトリを返す場合も同様です。

note: Tag: para
en: To test if a geometry is valid use the <xref linkend="ST_IsValid"/> function:
ja: ジオメトリが妥当かをテストするには<xref linkend="ST_IsValid"/>関数を使います。次のようにします。

note: Tag: para
en: Information about the nature and location of an geometry invalidity are provided by the <xref linkend="ST_IsValidDetail"/> function:
ja: ジオメトリの不正性の性質と位置に関する情報は<xref linkend="ST_IsValidDetail"/>関数で得られます。次のようにします。

note: Tag: para
en: In some situations it is desirable to correct invalid geometry automatically. Use the <xref linkend="ST_MakeValid"/> function to do this. (<code>ST_MakeValid</code> is a case of a spatial function that <emphasis>does</emphasis> allow invalid input!)
ja: 不正なジオメトリを自動的に訂正することが望ましいような状況があります。その際は<xref linkend="ST_MakeValid"/>関数を使います (<code>ST_MakeValid</code>は不正な入力を<emphasis>許す</emphasis>特別な関数です)。

note: Tag: para
en: By default, PostGIS does not check for validity when loading geometry, because validity testing can take a lot of CPU time for complex geometries. If you do not trust your data sources, you can enforce a validity check on your tables by adding a check constraint:
ja: 複雑なジオメトリの不正性テストには多大なCPU時間を取ることになるため、デフォルトでは、ジオメトリのロード時にPostGISは妥当性の確認をしません。データソースが信用できない場合には、チェック制約を使って、テーブル上で妥当性を強制的に確認することができます。次のようにします。

note: Tag: title
en: Spatial Reference Systems
ja: 空間参照系

note: Tag: para
en: A <link xlink:href="https://en.wikipedia.org/wiki/Spatial_reference_system">Spatial Reference System</link> (SRS) (also called a Coordinate Reference System (CRS)) defines how geometry is referenced to locations on the Earth's surface. There are three types of SRS:
ja: <link xlink:href="https://en.wikipedia.org/wiki/Spatial_reference_system">空間参照系</link> (Spatial Reference System, SRS) (座標参照系、Coordinate Reference System, CRSとも呼ばれます)は、ジオメトリが地表上の位置をどのように参照するかを定義しています。SRSには次の通り三種あります。

note: Tag: para
en: A <emphasis role="bold">geodetic</emphasis> SRS uses angular coordinates (longitude and latitude) which map directly to the surface of the earth.
ja: <emphasis role="bold">測地</emphasis> (geodetic) 空間参照系は、地表に直接対応付けられる極座標系 (経度と緯度)を使います。

note: Tag: para
en: A <emphasis role="bold">projected</emphasis> SRS uses a mathematical projection transformation to "flatten" the surface of the spheroidal earth onto a plane. It assigns location coordinates in a way that allows direct measurement of quantities such as distance, area, and angle. The coordinate system is Cartesian, which means it has a defined origin point and two perpendicular axes (usually oriented North and East). Each projected SRS uses a stated length unit (usually metres or feet). A projected SRS may be limited in its area of applicability to avoid distortion and fit within the defined coordinate bounds.
ja: <emphasis role="bold">投影</emphasis> (projected)空間参照系は、回転楕円体面を「平面にする」ための数学的な投影変換を使います。距離、面積、角度といった量を直接計測することが可能な位置座標系です。この座標系はデカルト座標系ですので、原点と二つの直交軸 (通常は来北と東方向)が定義されています。個々の投影座標系は、定まった距離単位 (通常はメートルかフィート)を使います。投影座標系は、歪みを避けて定義された座標範囲に納めるために、適応範囲を制限してもいいことになっています。

note: Tag: para
en: A <emphasis role="bold">local</emphasis> SRS is a Cartesian coordinate system which is not referenced to the earth's surface. In PostGIS this is specified by a SRID value of 0.
ja: <emphasis role="bold">局所</emphasis> (local)座標系は、地表への参照がないデカルト座標系です。PostGISではSRID値を0に指定します。

note: Tag: para
en: There are many different spatial reference systems in use. Common SRSes are standardized in the European Petroleum Survey Group <link xlink:href="http://www.epsg.org/">EPSG database</link>. For convenience PostGIS (and many other spatial systems) refers to SRS definitions using an integer identifier called a SRID.
ja: 使用されている空間参照系には多数の相違点があります。一般的空間参照系は欧州石油調査グループ (European Petroleum Survey Group)の<link xlink:href="http://www.epsg.org/">EPSG database</link>で標準化されています。利便性向上のためPostGIS (と多くの空間系)はSRIDと呼ぶ整数を使って空間参照系の定義を参照します。

note: Tag: para
en: A geometry is associated with a Spatial Reference System by its SRID value, which is accessed by <xref linkend="ST_SRID"/>. The SRID for a geometry can be assigned using <xref linkend="ST_SetSRID"/>. Some geometry constructor functions allow supplying a SRID (such as <xref linkend="ST_Point"/> and <xref linkend="ST_MakeEnvelope"/>). The <link linkend="EWKB_EWKT">EWKT</link> format supports SRIDs with the <code>SRID=n;</code> prefix.
ja: ジオメトリは、SRID値で空間参照系に関連付けられています。SRID値の取得には<xref linkend="ST_SRID"/>を使います。ジオメトリのSRIDの設定には<xref linkend="ST_SetSRID"/>を使います。ジオメトリ構築関数の中には、SRIDを与えられるものもあります (<xref linkend="ST_Point"/>や<xref linkend="ST_MakeEnvelope"/>等)。<link linkend="EWKB_EWKT">EWKT</link>書式は<code>SRID=n;</code>を前置することでSRIDに対応できます。

note: Tag: para
en: Spatial functions processing pairs of geometries (such as <link linkend="Overlay_Functions">overlay</link> and <link linkend="Spatial_Relationships">relationship</link> functions) require that the input geometries are in the same spatial reference system (have the same SRID). Geometry data can be transformed into a different spatial reference system using <xref linkend="ST_Transform"/> and <xref linkend="ST_TransformPipeline"/>. Geometry returned from functions has the same SRS as the input geometries.
ja: 二つのジオメトリを処理する空間関数 (<link linkend="Overlay_Functions">オーバレイ関数</link> 、<link linkend="Spatial_Relationships">関係関数</link>など)の入力ジオメトリは、同じ空間参照系である (同じSRIDを持つ)必要があります。<xref linkend="ST_Transform"/>や<xref linkend="ST_TransformPipeline"/>を使うことで、ジオメトリデータを異なる空間参照系に変換できます。関数から返されるジオメトリは、入力ジオメトリと同じ空間参照系になります。

note: Tag: title
en: SPATIAL_REF_SYS Table
ja: SPATIAL_REF_SYSテーブル

note: Tag: para
en: The <varname>SPATIAL_REF_SYS</varname> table used by PostGIS is an OGC-compliant database table that defines the available spatial reference systems. It holds the numeric SRIDs and textual descriptions of the coordinate systems.
ja: PostGISが使用する<varname>SPATIAL_REF_SYS</varname>テーブルは利用可能な空間参照系を定義するOGC準拠のデータベーステーブルです。このテーブルは、数値でSRIDを持ち、文字列で座標系の記述を持っています。

note: Tag: para
en: The <varname>spatial_ref_sys</varname> table definition is:
ja: <varname>spatial_ref_sys</varname>の定義は次の通りです。

note: Tag: para
en: The columns are:
ja: カラムは次の通りです。

note: Tag: para
en: An integer code that uniquely identifies the <link xlink:href="http://en.wikipedia.org/wiki/SRID">Spatial Reference System</link> (SRS) within the database.
ja: データベース内の<link xlink:href="http://en.wikipedia.org/wiki/SRID">Spatial Reference System</link> (SRS, 空間参照系)で一意に識別される整数コードです。

note: Tag: para
en: The name of the standard or standards body that is being cited for this reference system. For example, "EPSG" is a valid <varname>auth_name</varname>.
ja: この参照系に引用されている標準の名前もしくは標準そのものです。たとえば「EPSG」は妥当な<varname>auth_name</varname>です。

note: Tag: para
en: The ID of the Spatial Reference System as defined by the Authority cited in the <varname>auth_name</varname>. In the case of EPSG, this is the EPSG code.
ja: 空間参照系のIDは<varname>auth_name</varname>に引用される機関によって定義されます。ここがEPSGの場合には、これはEPSGコードです。

note: Tag: para
en: The Well-Known Text representation of the Spatial Reference System. An example of a WKT SRS representation is:
ja: 空間参照系のWell-Knownテキスト表現です。たとえば、WKT SRSの表現は、次のようになります。

note: Tag: para
en: For a discussion of SRS WKT, see the OGC standard <link xlink:href="http://docs.opengeospatial.org/is/12-063r5/12-063r5.html">Well-known text representation of coordinate reference systems</link>.
ja: SRS WKTの詳細については、OGC標準の<link xlink:href="http://docs.opengeospatial.org/is/12-063r5/12-063r5.html">Well-known text representation of coordinate reference systems</link>をご覧下さい。

note: Tag: para
en: PostGIS uses the PROJ library to provide coordinate transformation capabilities. The <varname>proj4text</varname> column contains the PROJ coordinate definition string for a particular SRID. For example:
ja: PostGISは座標変換機能を提供するためにProj4ライブラリを用いています。 <varname>proj4text</varname>カラムには、特定のSRIDを示すProj4座標定義文字列が入ります。たとえば次のようになります。

note: Tag: para
en: For more information see the <link xlink:href="https://proj.org/">PROJ web site</link>. The <filename>spatial_ref_sys.sql</filename> file contains both <varname>srtext</varname> and <varname>proj4text</varname> definitions for all EPSG projections.
ja: 詳細情報については<link xlink:href="https://proj.org/">PROJウェブサイト</link>をご覧下さい。<filename>spatial_ref_sys.sql</filename>ファイルには、全てのEPSG投影について、<varname>srtext</varname>と<varname>proj4text</varname>の定義があります。

note: Tag: para
en: When retrieving spatial reference system definitions for use in transformations, PostGIS uses fhe following strategy:
ja: 投影変換で空間参照系の定義を使用する場合には、次の戦略を取ります。

note: Tag: para
en: If <varname>auth_name</varname> and <varname>auth_srid</varname> are present (non-NULL) use the PROJ SRS based on those entries (if one exists).
ja: <varname>auth_name</varname>と<varname>auth_srid</varname>がある (NULLでない)場合には、これに基づいてPROJSRSを使います (存在する場合)。

note: Tag: para
en: If <varname>srtext</varname> is present create a SRS using it, if possible.
ja: <varname>srtext</varname>がある場合には、可能ならそれを使用してSRSを生成します。

note: Tag: para
en: If <varname>proj4text</varname> is present create a SRS using it, if possible.
ja: <varname>proj4text</varname>がある場合には、可能ならこれを使用してSRSを生成します。

note: Tag: title
en: User-Defined Spatial Reference Systems
ja: ユーザ定義空間参照系

note: Tag: para
en: The PostGIS <varname>spatial_ref_sys</varname> table contains over 3000 of the most common spatial reference system definitions that are handled by the <link xlink:href="https://proj.org">PROJ</link> projection library. But there are many coordinate systems that it does not contain. You can add SRS definitions to the table if you have the required information about the spatial reference system. Or, you can define your own custom spatial reference system if you are familiar with PROJ constructs. Keep in mind that most spatial reference systems are regional and have no meaning when used outside of the bounds they were intended for.
ja: PostGIS<varname>spatial_ref_sys</varname>テーブルには<link xlink:href="https://proj.org/">PROJ</link>投影ライブラリで処理される最も一般的な空間参照系定義3000件以上があります。しかし、そこに無い多くの座標系があります。空間参照系に関する必要な情報がある場合は、SRS定義をテーブルに追加できます。PROJに詳しいなら独自の空間参照系を定義することもできます。ほとんどの空間参照系は地域的なものであり、目的の範囲外で使用する場合は意味を持たない点に注意してください。

note: Tag: para
en: A resource for finding spatial reference systems not defined in the core set is <link xlink:href="http://spatialreference.org/">http://spatialreference.org/</link>
ja: PostGISのコアセットに入っていない空間参照系を探すための素晴らしい資料が<link xlink:href="http://spatialreference.org/">http://spatialreference.org/</link>にあります。

note: Tag: para
en: Some commonly used spatial reference systems are: <link xlink:href="http://spatialreference.org/ref/epsg/4326/">4326 - WGS 84 Long Lat</link>, <link xlink:href="http://spatialreference.org/ref/epsg/4269/">4269 - NAD 83 Long Lat</link>, <link xlink:href="http://spatialreference.org/ref/epsg/3395/">3395 - WGS 84 World Mercator</link>, <link xlink:href="http://spatialreference.org/ref/epsg/2163/">2163 - US National Atlas Equal Area</link>, and the 60 WGS84 UTM zones. UTM zones are one of the most ideal for measurement, but only cover 6-degree regions. (To determine which UTM zone to use for your area of interest, see the <link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiplpgsqlfunctionsDistance">utmzone PostGIS plpgsql helper function</link>.)
ja: 一般的に使用される空間参照系には<link xlink:href="http://spatialreference.org/ref/epsg/4326/">4326 - WGS 84経度緯度</link>、<link xlink:href="http://spatialreference.org/ref/epsg/4269/">4269 - NAD 83 経度緯度</link>、<link xlink:href="http://spatialreference.org/ref/epsg/3395/">3395 - WGS 84 メルカトル</link>、<link xlink:href="http://spatialreference.org/ref/epsg/2163/">2163 - 米国ナショナルアトラス正積図法</link>、60個のWGS84 UTMゾーンがあります。UTMゾーンは計測に最適ですが、6度 (訳注: 経度)の領域のみをカバーします (対象地域に使用するUTMゾーンを決定するには<link xlink:href="http://trac.osgeo.org/postgis/wiki/UsersWikiplpgsqlfunctionsDistance">utmzone PostGIS plpgsql helper function</link>を参照してください)。

note: Tag: para
en: US states use State Plane spatial reference systems (meter or feet based) - usually one or 2 exists per state. Most of the meter-based ones are in the core set, but many of the feet-based ones or ESRI-created ones will need to be copied from <link xlink:href="http://spatialreference.org">spatialreference.org</link>.
ja: 米国の州では、州平面空間参照系 (メートルまたはフィート単位)を使用します。この空間参照系は州ごとに一つか二つ存在します。ほとんどのメートル単位のものはコアのセットに存在しますが、フィート単位の多数のものやESRIが作成したものは<link xlink:href="http://spatialreference.org">spatialreference.org</link>からロードする必要があります。

note: Tag: para
en: You can even define non-Earth-based coordinate systems, such as <link xlink:href="http://spatialreference.org/ref/iau2000/mars-2000/">Mars 2000</link> This Mars coordinate system is non-planar (it's in degrees spheroidal), but you can use it with the <varname>geography</varname> type to obtain length and proximity measurements in meters instead of degrees.
ja: 地球外の座標系でさえも定義することができます。たとえば<link xlink:href="http://spatialreference.org/ref/iau2000/mars-2000/">Mars 2000</link>です。この火星の座標系は非平面 (回転楕円体の度)ですが、<varname>geography</varname>型で、度でなくメートル単位で長さや近接測定値を取得することができます。

note: Tag: para
en: Here is an example of loading a custom coordinate system using an unassigned SRID and the PROJ definition for a US-centric Lambert Conformal projection:
ja: 割当外のSRIDとPROJ定義を使って米国中央のランベルト正角円錐図法の独自座標系をロードする例を次に示します。

note: Tag: title
en: Spatial Tables
ja: 空間テーブル

note: Tag: title
en: Creating a Spatial Table
ja: 空間テーブルを作る

note: Tag: para
en: You can create a table to store geometry data using the <link xlink:href="https://www.postgresql.org/docs/current/sql-createtable.html">CREATE TABLE</link> SQL statement with a column of type <varname>geometry</varname>. The following example creates a table with a geometry column storing 2D (XY) LineStrings in the BC-Albers coordinate system (SRID 3005):
ja: <varname>geometry</varname>型のカラムを付けた<link xlink:href="https://www.postgresql.org/docs/current/sql-createtable.html">CREATE TABLE</link> SQLステートメントでジオメトリデータを保存するテーブルを生成することができます。次の例では、BC-アルベルス座標系 (SRID 3005)の2次元 (XY)ラインストリングを保存するジオメトリカラムを持つテーブルを生成します。

note: Tag: para
en: The <varname>geometry</varname> type supports two optional <emphasis role="bold">type modifiers</emphasis>:
ja: <varname>geometry</varname>型は、次の通り、二つの任意指定<emphasis role="bold">型修飾子</emphasis>に対応しています。

note: Tag: para
en: the <emphasis role="bold">spatial type modifier</emphasis> restricts the kind of shapes and dimensions allowed in the column. The value can be any of the supported <link linkend="RefObject">geometry subtypes</link> (e.g. POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON, GEOMETRYCOLLECTION, etc). The modifier supports coordinate dimensionality restrictions by adding suffixes: Z, M and ZM. For example, a modifier of 'LINESTRINGM' allows only linestrings with three dimensions, and treats the third dimension as a measure. Similarly, 'POINTZM' requires four dimensional (XYZM) data.
ja: <emphasis role="bold">空間タイプ修飾子</emphasis>はカラムで許される形状と次元の種類を制約するものです。値は、対応している<link linkend="RefObject">ジオメトリタイプ</link> (POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON, GEOMETRYCOLLECTION等)なら全て可能です。空間タイプ修飾子は、後置詞 Z, M, ZMを付け加えることで座標次元の制約に対応します。例えば、`LINESTRINGM`修飾子では、3次元で3番目がM軸となるラインストリングだけを許します。同様に、'POINTZM'では4次元 (XYZM)データが求められます。

note: Tag: para
en: the <emphasis role="bold">SRID modifier</emphasis> restricts the <link linkend="spatial_ref_sys">spatial reference system</link> SRID to a particular number. If omitted, the SRID defaults to 0.
ja: <emphasis role="bold">SRID修飾子</emphasis>は<link linkend="spatial_ref_sys">空間参照系</link>のSRIDを特定の数値に制約します。省略した場合には、デフォルトは0となります。

note: Tag: para
en: Examples of creating tables with geometry columns:
ja: ジオグラフィカラムを持つテーブルの生成の例を次に挙げます。

note: Tag: para
en: Create a table holding any kind of geometry with the default SRID:
ja: デフォルトSRIDであらゆる種類のジオメトリを保持するテーブルの生成:

note: Tag: para
en: Create a table with 2D POINT geometry with the default SRID:
ja: 2次元ポイントでSRIDがデフォルトのテーブル作成:

note: Tag: para
en: Create a table with 3D (XYZ) POINTs and an explicit SRID of 3005:
ja: 3次元 (XYZ)ポイントでSRIDが3005のテーブル作成:

note: Tag: para
en: Create a table with 4D (XYZM) LINESTRING geometry with the default SRID:
ja: 4次元 (XYZM)ラインストリングでSRIDがデフォルトのテーブル作成:

note: Tag: para
en: Create a table with 2D POLYGON geometry with the SRID 4267 (NAD 1927 long lat):
ja: 2次元ポリゴンでSRIDが4276 (NAD 1927地理座標系)のテーブル作成:

note: Tag: para
en: It is possible to have more than one geometry column in a table. This can be specified when the table is created, or a column can be added using the <link xlink:href="https://www.postgresql.org/docs/current/sql-altertable.html">ALTER TABLE</link> SQL statement. This example adds a column that can hold 3D LineStrings:
ja: 一つのテーブルが一つ以上のジオメトリカラムを持つことができます。テーブル生成時に指定するか、<link xlink:href="https://www.postgresql.org/docs/current/sql-altertable.html">ALTER TABLE</link> SQLステートメントを使って追加するかで実現できます。次に3次元ラインストリングを格納するカラムを追加する例を示します。

note: Tag: title
en: GEOMETRY_COLUMNS View
ja: GEOMETRY_COLUMNSビュー

note: Tag: para
en: The OGC <emphasis>Simple Features Specification for SQL</emphasis> defines the <varname>GEOMETRY_COLUMNS</varname> metadata table to describe geometry table structure. In PostGIS <varname>geometry_columns</varname> is a view reading from database system catalog tables. This ensures that the spatial metadata information is always consistent with the currently defined tables and views. The view structure is:
ja: OGC <emphasis>Simple Features Specification for SQL</emphasis>は、ジオメトリテーブル構造を記述するための<varname>GEOMETRY_COLUMNS</varname>メタデータテーブルを定義しています。PostGISでは<varname>geometry_columns</varname>は、データベースのシステムカタログテーブルから読み取るビューです。これによって、空間メタデータ情報が常に現在定義されているテーブルやビューと矛盾しなくなります。

note: Tag: para
en: The fully qualified name of the feature table containing the geometry column. There is no PostgreSQL analogue of "catalog" so that column is left blank. For "schema" the PostgreSQL schema name is used (<varname>public</varname> is the default).
ja: ジオメトリカラムを持っている地物テーブルの完全修飾名。PostgreSQLには"catalog"の類似カラムが無いので、このカラムは空白のままです。"schema"についてはPostgreSQLスキーマ名が使われます (デフォルトは<varname>public</varname>です)。

note: Tag: para
en: The name of the geometry column in the feature table.
ja: フィーチャーテーブル内のジオメトリカラムの名前。

note: Tag: para
en: The coordinate dimension (2, 3 or 4) of the column.
ja: カラムの座標次元 (2, 3, 4)。

note: Tag: para
en: The ID of the spatial reference system used for the coordinate geometry in this table. It is a foreign key reference to the <varname>spatial_ref_sys</varname> table (see <xref linkend="spatial_ref_sys_table"/>).
ja: このテーブルのジオメトリの座標系として使用される座標系空間参照系のIDです。<varname>spatial_ref_sys</varname>テーブルを参照する外部キーです (<xref linkend="spatial_ref_sys_table"/>を参照して下さい)。

note: Tag: para
en: The type of the spatial object. To restrict the spatial column to a single type, use one of: POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON, GEOMETRYCOLLECTION or corresponding XYM versions POINTM, LINESTRINGM, POLYGONM, MULTIPOINTM, MULTILINESTRINGM, MULTIPOLYGONM, GEOMETRYCOLLECTIONM. For heterogeneous (mixed-type) collections, you can use "GEOMETRY" as the type.
ja: 空間オブジェクトの型。空間カラムを単一型に制限するには、POINT、LINESTRING、POLYGON、MULTIPOINT、MULTILINESTRING、MULTIPOLYGON、GEOMETRYCOLLECTIONのうちのいずれかを、また、XYMで使う場合には、LINESTRINGM、POLYGONM、MULTIPOINTM、MULTILINESTRINGM、MULTIPOLYGONM、GEOMETRYCOLLECTIONMのうちのいずれかを使います。複数の型が混合するコレクションの場合は"GEOMETRY"を型とすることができます。

note: Tag: title
en: Manually Registering Geometry Columns
ja: 手動でジオメトリカラムをgeometry_columnsに登録する

note: Tag: para
en: Two of the cases where you may need this are the case of SQL Views and bulk inserts. For bulk insert case, you can correct the registration in the geometry_columns table by constraining the column or doing an alter table. For views, you could expose using a CAST operation. Note, if your column is typmod based, the creation process would register it correctly, so no need to do anything. Also views that have no spatial function applied to the geometry will register the same as the underlying table geometry column.
ja: これが必要になる事例に、SQLビューとバルクインサートの二つがあります。バルクインサートの場合には、カラムに制約を与えるか、ALTER TABLEを実行することで、geometry_columnsテーブル内の登録を訂正することができます。ビューの場合には、CAST演算を使用します。カラムが型修飾子に基づく場合には、生成処理によって正しく登録されるので、何も行う必要がありません。ジオメトリに適用する空間関数を持たないビューも、基礎となるテーブルのジオメトリカラムと同じように登録されます。

note: Tag: para
en: Although the old-constraint based method is still supported, a constraint-based geometry column used directly in a view, will not register correctly in geometry_columns, as will a typmod one. In this example we define a column using typmod and another using constraints.
ja: 古い制約を基にした手法は現在も対応していますが、制約を基にしたジオメトリカラムで直接的にビューで使われている場合は、型修飾子のようには正しくgeometry_columnsに登録されません。次の例では、型修飾子を使ったカラム定義と、制約に基づくカラムの定義とを行っています。

note: Tag: para
en: If we run in psql
ja: psqlで次を実行します。

note: Tag: para
en: We observe they are defined differently -- one is typmod, one is constraint
ja: 型修飾子と制約に基づくのとでは異なった定義になっているのが見えます。

note: Tag: para
en: In geometry_columns, they both register correctly
ja: geometry_columnsでは、両方とも正しく登録されています。

note: Tag: para
en: However -- if we were to create a view like this
ja: しかし、次のようにビューを作ろうとします。

note: Tag: para
en: The typmod based geom view column registers correctly, but the constraint based one does not.
ja: 型修飾子によるgeomのビューカラムは正しく登録されますが、制約に基づくものは正しく登録されません。

note: Tag: para
en: This may change in future versions of PostGIS, but for now to force the constraint-based view column to register correctly, you need to do this:
ja: これは、将来的にPostGISの版で変更されるかもしれませんが、今のところは、制約に基づくビューカラムを正しく登録させるには、次のようにします。

note: Tag: title
en: Loading Spatial Data
ja: 空間データのロード

note: Tag: para
en: Once you have created a spatial table, you are ready to upload spatial data to the database. There are two built-in ways to get spatial data into a PostGIS/PostgreSQL database: using formatted SQL statements or using the Shapefile loader.
ja: 空間テーブルを作成したら、これでGISデータをデータベースにアップロードする準備ができたことになります。現在、PostGIS/PostgreSQLデータベースにデータをロードするには、SQLステートメントを使う、またはシェープファイルのローダ/ダンパを使う、という二つの方法があります。

note: Tag: title
en: Using SQL to Load Data
ja: SQLを使ってロードする

note: Tag: para
en: If spatial data can be converted to a text representation (as either WKT or WKB), then using SQL might be the easiest way to get data into PostGIS. Data can be bulk-loaded into PostGIS/PostgreSQL by loading a text file of SQL <code>INSERT</code> statements using the <code>psql</code> SQL utility.
ja: 空間データを文字表現 (WKTかWKB)に変換できたら、SQLを使うのがPostGISにデータを持たせる最も簡単です。SQLユーティリティの<code>psql</code>を使用して、SQLの<code>INSERT</code>ステートメントのテキストファイルをロードすると、データをPostGIS/PostgreSQLに一括読み込みできます。

note: Tag: para
en: A SQL load file (<filename>roads.sql</filename> for example) might look like this:
ja: データアップロードファイル (たとえば<filename>roads.sql</filename>)は次のようになるでしょう。

note: Tag: para
en: The SQL file can be loaded into PostgreSQL using <code>psql</code>:
ja: SQLファイルのPostgreSQLへのロードは<code>psql</code>を使います。次のようにします。

note: Tag: title
en: Using the Shapefile Loader
ja: シェープファイルローダを使う

note: Tag: para
en: The <filename>shp2pgsql</filename> data loader converts Shapefiles into SQL suitable for insertion into a PostGIS/PostgreSQL database either in geometry or geography format. The loader has several operating modes selected by command line flags.
ja: <filename>shp2pgsql</filename>データローダは、ESRIシェープファイルをPostGIS/PostgreSQLデータベースに、ジオメトリまたはジオグラフィとして挿入するための適切なSQLに変換します。ローダには、次に示すコマンドラインフラグによって区別される、いくつかの操作モードがあります。

note: Tag: para
en: There is also a <filename>shp2pgsql-gui</filename> graphical interface with most of the options as the command-line loader. This may be easier to use for one-off non-scripted loading or if you are new to PostGIS. It can also be configured as a plugin to PgAdminIII.
ja: グラフィカルユーザインタフェースを持つ<filename>shp2pgsql-gui</filename>もあります。コマンドラインローダのオプションのほとんどが使えます。これは、スクリプト化されていない1回限りのロードの場合や、PostGIS初心者がロードする場合に、簡単に使用できます。PgAdminIIIのプラグインとすることもできます。

note: Tag: term
en: (c|a|d|p) These are mutually exclusive options:
ja: (c|a|d|p) 相互に排他的なオプションです。

note: Tag: para
en: Creates a new table and populates it from the Shapefile. <emphasis>This is the default mode.</emphasis>
ja: 新しいテーブルの作成とシェープファイルからのデータの読み込みを行います。<emphasis>これがデフォルトモードです</emphasis>。

note: Tag: para
en: Appends data from the Shapefile into the database table. Note that to use this option to load multiple files, the files must have the same attributes and same data types.
ja: シェープファイルからデータベーステーブルにデータを追加します。複数のファイルをロードするためにこのオプションを使う場合は、これらのファイルは同じ属性と同じデータ型を持つ必要があります。

note: Tag: para
en: Drops the database table before creating a new table with the data in the Shapefile.
ja: シェープファイルにあるデータを持つ新しいテーブルを作成する前にデータベーステーブルを削除します。

note: Tag: para
en: Only produces the table creation SQL code, without adding any actual data. This can be used if you need to completely separate the table creation and data loading steps.
ja: テーブル作成のSQLコードを生成するだけで、実際のデータは追加しません。このモードは、テーブル作成とデータロードとを完全に分けたい場合に使用します。

note: Tag: para
en: Display help screen.
ja: ヘルプ画面を表示します。

note: Tag: para
en: Use the PostgreSQL "dump" format for the output data. This can be combined with -a, -c and -d. It is much faster to load than the default "insert" SQL format. Use this for very large data sets.
ja: 出力データにPostgreSQLのダンプ書式を用います。このモードは-a, -c, -dと組み合わせて利用します。デフォルトの"insert"によるSQL書式よりも、大変早くロードできます。大きなデータセットではこちらを使用して下さい。

note: Tag: para
en: Creates and populates the geometry tables with the specified SRID. Optionally specifies that the input shapefile uses the given FROM_SRID, in which case the geometries will be reprojected to the target SRID.
ja: 指定したSRIDを持つジオメトリテーブルの生成や追加を行います。FROM_SRIDが与えられた場合には、入力シェープファイルに、これを使います 。この場合には、ジオメトリは変更先SRIDに投影変換します。

note: Tag: para
en: Keep identifiers' case (column, schema and attributes). Note that attributes in Shapefile are all UPPERCASE.
ja: 識別子 (カラム、スキーマおよび属性)の大文字小文字を保持します。シェープファイルの属性は全て大文字であることに注意して下さい。

note: Tag: para
en: Coerce all integers to standard 32-bit integers, do not create 64-bit bigints, even if the DBF header signature appears to warrant it.
ja: 全ての整数を標準の32ビット整数に強制します。DBFヘッダではそれが正当であったとしても、64ビットのbigintを生成しません。

note: Tag: para
en: Create a GiST index on the geometry column.
ja: ジオメトリカラムにGiSTインデックスを生成します。

note: Tag: para
en: -m <filename>a_file_name</filename> Specify a file containing a set of mappings of (long) column names to 10 character DBF column names. The content of the file is one or more lines of two names separated by white space and no trailing or leading space. For example:
ja: -m <filename>a_file_name</filename>で、長いカラム名を10文字のDBFカラム名に対応付けるファイルを指定します。ファイルは、1以上の行を持ちます。各行は空白区切りで二つの名前を持ち、行頭行末に空白を入れません。例を次に示します。

note: Tag: para
en: Generate simple geometries instead of MULTI geometries. Will only succeed if all the geometries are actually single (I.E. a MULTIPOLYGON with a single shell, or or a MULTIPOINT with a single vertex).
ja: マルチ系ジオメトリの替りに単一ジオメトリを生成します。全てのジオメトリが実際に単一である (たとえば単一の外環でなるMULTIPOLYGONや単一の頂点でなるMULTIPOINT)場合にのみ成功します。

note: Tag: para
en: Force the output geometry to have the specified dimensionality. Use the following strings to indicate the dimensionality: 2D, 3DZ, 3DM, 4D.
ja: 出力ジオメトリが特定の次元を持つよう強制します。次元は、2D, 3DZ, 3DM, 4Dの文字列を使います。

note: Tag: para
en: If the input has fewer dimensions that specified, the output will have those dimensions filled in with zeroes. If the input has more dimensions that specified, the unwanted dimensions will be stripped.
ja: 入力の次元が出力より小さい場合には、出力では0が入ります。入力の次元が大きい場合には、外されます。

note: Tag: para
en: Output WKT format, instead of WKB. Note that this can introduce coordinate drifts due to loss of precision.
ja: 出力書式をWKBでなくWKTにします。精度が低下して、座標変動が発生しうることに注意が必要です。

note: Tag: para
en: Execute each statement on its own, without using a transaction. This allows loading of the majority of good data when there are some bad geometries that generate errors. Note that this cannot be used with the -D flag as the "dump" format always uses a transaction.
ja: トランザクションを使わずに、ステートメントごとに実行するようにします。エラーの元となる不良なジオメトリがいくつか含んでいる時に、大半の良好なデータのロードが可能にするものです。ダンプ書式ではトランザクションを常に使うので、-Dフラグを指定している場合には使えません。

note: Tag: para
en: Specify encoding of the input data (dbf file). When used, all attributes of the dbf are converted from the specified encoding to UTF8. The resulting SQL output will contain a <code>SET CLIENT_ENCODING to UTF8</code> command, so that the backend will be able to reconvert from UTF8 to whatever encoding the database is configured to use internally.
ja: 入力データ (dbfファイル)のエンコーディングを指定します。全てのdbfの属性は指定されたエンコーディングからUTF8に変換されます。SQL出力結果には <code>SET CLIENT_ENCODING to UTF8</code>が含まれるようになり、バックエンドはUTF-8からデータベースが内部利用のために設定したエンコーディングに再変換できます。

note: Tag: para
en: NULL geometries handling policy (insert*,skip,abort)
ja: NULLジオメトリ操作方針(insert*=挿入, skip=スキップ, abort=強制終了)を選択します。

note: Tag: para
en: -n Only import DBF file. If your data has no corresponding shapefile, it will automatically switch to this mode and load just the dbf. So setting this flag is only needed if you have a full shapefile set, and you only want the attribute data and no geometry.
ja: DBFファイルのみインポートします。対応するシェープファイルを持っていない場合、 自動的にこのモードになり、DBFファイルのみロードします。 このフラグは、完全なシェープファイル群を持っていて、属性データだけが欲しくてジオメトリが欲しくない時のみ使用します。

note: Tag: para
en: Use geography type instead of geometry (requires lon/lat data) in WGS84 long lat (SRID=4326)
ja: ジオメトリ型のかわりに、ジオグラフィ型で、WGS84経度緯度 (SRID=4326)を使用します (経度緯度データが必要です)。

note: Tag: para
en: Specify the tablespace for the new table. Indexes will still use the default tablespace unless the -X parameter is also used. The PostgreSQL documentation has a good description on when to use custom tablespaces.
ja: 新しいテーブルのテーブル空間を指定します。 -Xパラメータが使われない場合には、インデックスはデフォルトのテーブル空間を使用します。PostgreSQL文書には、テーブル空間を用いるべき時に関する良い文書があります。

note: Tag: para
en: Specify the tablespace for the new table's indexes. This applies to the primary key index, and the GIST spatial index if -I is also used.
ja: 新しいテーブルのインデックスで使われるテーブル空間を指定します。 主キーインデックスに適用され、-Iが合わせて使われている場合にはGiST空間インデックスにも適用されます。

note: Tag: para
en: When used, this flag will prevent the generation of <code>ANALYZE</code> statements. Without the -Z flag (default behavior), the <code>ANALYZE</code> statements will be generated.
ja: このフラグをこれを使う時、<code>ANALYZE</code>手続きの生成を防ぎます。-Zフラグが無い (デフォルトの振る舞い)場合には、<code>ANALYZE</code>手続きが生成されます。

note: Tag: para
en: An example session using the loader to create an input file and loading it might look like this:
ja: ローダを使って入力ファイルを生成してアップロードするセッション例は次の通りです。

note: Tag: para
en: A conversion and load can be done in one step using UNIX pipes:
ja: 変換とアップロードはUNIXのパイプを使うと一回で実行できます。

note: Tag: title
en: Extracting Spatial Data
ja: 空間データの抽出

note: Tag: para
en: Spatial data can be extracted from the database using either SQL or the Shapefile dumper. The section on SQL presents some of the functions available to do comparisons and queries on spatial tables.
ja: 空間データはSQLかシェープファイルダンパを使うと抽出できます。SQLの節では空間テーブルで比較とクエリに使用できる関数を示します。

note: Tag: title
en: Using SQL to Extract Data
ja: SQLを使ってデータを抽出する

note: Tag: para
en: The most straightforward way of extracting spatial data out of the database is to use a SQL <code>SELECT</code> query to define the data set to be extracted and dump the resulting columns into a parsable text file:
ja: データベース外へのデータ抽出の最も簡単な方法は、抽出するデータセットを定義し、<code>SELECT</code>問い合わせを使って、結果カラムを解析可能なテキストファイルにダンプすることです。

note: Tag: para
en: There will be times when some kind of restriction is necessary to cut down the number of records returned. In the case of attribute-based restrictions, use the same SQL syntax as used with a non-spatial table. In the case of spatial restrictions, the following functions are useful:
ja: 返されるレコードの数を減らすためにある種の制限が必要になる場合があります。属性ベースで制限をかける場合には、非空間テーブルで使うのと同じSQL文を使います。空間に制限をかけるには次の関数を使います。

note: Tag: para
en: This function tells whether two geometries share any space.
ja: この関数は、二つのジオメトリが空間を共有しているかどうかをテストします。

note: Tag: para
en: This tests whether two geometries are geometrically identical. For example, if 'POLYGON((0 0,1 1,1 0,0 0))' is the same as 'POLYGON((0 0,1 1,1 0,0 0))' (it is).
ja: この関数で、二つのジオメトリが幾何的に同一であるかを見ることができます。たとえば、'POLYGON((0 0,1 1,1 0,0 0))' は 'POLYGON((0 0,1 1,1 0,0 0))' と同じかを見ることができます (これは同じとなります)。

note: Tag: para
en: Next, you can use these operators in queries. Note that when specifying geometries and boxes on the SQL command line, you must explicitly turn the string representations into geometries function. The 312 is a fictitious spatial reference system that matches our data. So, for example:
ja: 次に、これらの演算子をクエリで使うことができます。SQLコマンドラインからジオメトリとボックスの指定を行うときは、明示的に文字列表現をジオメトリに変換しなければならないことに注意して下さい。たとえば、次のようになります。ただし312は架空の空間参照系番号で、ここでのデータに合致しています。

note: Tag: para
en: The above query would return the single record from the "ROADS_GEOM" table in which the geometry was equal to that value.
ja: 上のクエリは"ROADS_GEOM"テーブルから、その値と等価である単一のレコードを返します。

note: Tag: para
en: To check whether some of the roads passes in the area defined by a polygon:
ja: 道路がポリゴンで定義した面を通過するかどうかをチェックするには次のようにします。

note: Tag: para
en: The most common spatial query will probably be a "frame-based" query, used by client software, like data browsers and web mappers, to grab a "map frame" worth of data for display.
ja: 最も一般的な空間クエリは「フレームベース」のクエリでしょう。これは、表示するためのデータの価値のある「マップフレーム」を取得するために、データブラウザやウェブマッパのようなクライアントソフトウェアに使われます。

note: Tag: para
en: When using the "&amp;&amp;" operator, you can specify either a BOX3D as the comparison feature or a GEOMETRY. When you specify a GEOMETRY, however, its bounding box will be used for the comparison.
ja: "&amp;&amp;"演算子を使うとき、比較フィーチャーをBOX3DかGEOMETRYかに指定することができます。ただし、GEOMETRYを指定すると、それのバウンディングボックスが比較に使われます。

note: Tag: para
en: Using a "BOX3D" object for the frame, such a query looks like this:
ja: 次に示すクエリのように、フレームにBOX3Dオブジェクトを使います。

note: Tag: para
en: Note the use of the SRID 312, to specify the projection of the envelope.
ja: エンベロープの投影を指定するためにSRID 312を使っていることに注意して下さい。

note: Tag: title
en: Using the Shapefile Dumper
ja: ダンパを使う

note: Tag: para
en: The <filename>pgsql2shp</filename> table dumper connects to the database and converts a table (possibly defined by a query) into a shape file. The basic syntax is:
ja: <filename>pgsql2shp</filename>テーブルダンパは、データベースに直接接続して、テーブル (あるいはクエリによって定義されたもの)をシェープファイルに変換するものです。基本的な文は次の通りです。

note: Tag: para
en: The commandline options are:
ja: コマンドラインオプションは次の通りです。

note: Tag: para
en: Write the output to a particular filename.
ja: 特定のファイル名に出力を書きこみます。

note: Tag: para
en: The database host to connect to.
ja: 接続先データベースのホスト名。

note: Tag: para
en: The port to connect to on the database host.
ja: 接続先データベースのポート。

note: Tag: para
en: The password to use when connecting to the database.
ja: データベースに接続するためのパスワード。

note: Tag: para
en: The username to use when connecting to the database.
ja: データベースに接続する際のユーザ名。

note: Tag: para
en: In the case of tables with multiple geometry columns, the geometry column to use when writing the shape file.
ja: 複数のジオメトリカラムを持つテーブルの場合の、シェープファイルの出力に使用するジオメトリカラム。

note: Tag: para
en: Use a binary cursor. This will make the operation faster, but will not work if any NON-geometry attribute in the table lacks a cast to text.
ja: バイナリカーソルを使います。これは、実行時間を短くしますが、テーブルの非ジオメトリ属性がテキストへのキャストを持っていない場合には、動作しません。

note: Tag: para
en: Raw mode. Do not drop the <varname>gid</varname> field, or escape column names.
ja: Rawモード。<varname>gid</varname>フィールドを落としたり、カラム名をエスケープしてはいけません。

note: Tag: para
en: Remap identifiers to ten character names. The content of the file is lines of two symbols separated by a single white space and no trailing or leading space: VERYLONGSYMBOL SHORTONE ANOTHERVERYLONGSYMBOL SHORTER etc.
ja: 識別名を10文字名に再割り当てします。 ファイルの中身は、一つの空白で区切られ、前と後に空白が無い二つのシンボルの行からなります。VERYLONGSYMBOL SHORTONE ANOTHERVERYLONGSYMBOL SHORTER等となります。

note: Tag: title
en: Spatial Indexes
ja: 空間インデックス

note: Tag: para
en: Spatial indexes make using a spatial database for large data sets possible. Without indexing, a search for features requires a sequential scan of every record in the database. Indexing speeds up searching by organizing the data into a structure which can be quickly traversed to find matching records.
ja: インデックスによって巨大データセットの空間データベースの使用が可能となります。インデックス無しでは、地物の検索を行う際に、データベースの全てのレコードに対するシーケンシャルスキャンが必要となります。インデックスによって、レコード探索のために早く移動できる構造を構築するので、検索速度が向上します。

note: Tag: para
en: The B-tree index method commonly used for attribute data is not very useful for spatial data, since it only supports storing and querying data in a single dimension. Data such as geometry (which has 2 or more dimensions) requires an index method that supports range query across all the data dimensions. One of the key advantages of PostgreSQL for spatial data handling is that it offers several kinds of index methods which work well for multi-dimensional data: GiST, BRIN and SP-GiST indexes.
ja: 一般的に属性データに使われるインデックス手法でありB木は、空間データではあまり有用ではありません。1次元データの格納とクエリにだけしか対応していないためです。ジオメトリのような2次元以上の次元を持つデータでは、全ての次元の範囲を指定できるインデックス手法が求められます。PostgreSQLの空間データ処理に関する主要な利点の一つに、多次元データで上手く動作するGiST、BRIN、SP-GiSTの複数のインデックス手法を提供していることです。

note: Tag: para
en: <emphasis role="bold">GiST (Generalized Search Tree)</emphasis> indexes break up data into "things to one side", "things which overlap", "things which are inside" and can be used on a wide range of data-types, including GIS data. PostGIS uses an R-Tree index implemented on top of GiST to index spatial data. GiST is the most commonly-used and versatile spatial index method, and offers very good query performance.
ja: <emphasis role="bold">GiST (Generalized Search Tree)</emphasis>インデックスは、データを「一方にあるもの」「オーバラップするもの」「内部にあるもの」に分解するもので、GISデータを含む幅広い範囲で使えます。PostGISはGiSTインデックス空間データをR木インデックス実装のベースにています。GiSTは最も一般的に使われ、多目的なインデックス手法で、非常に良好な問い合わせ効率を提供しています。

note: Tag: para
en: <emphasis role="bold">BRIN (Block Range Index)</emphasis> indexes operate by summarizing the spatial extent of ranges of table records. Search is done via a scan of the ranges. BRIN is only appropriate for use for some kinds of data (spatially sorted, with infrequent or no update). But it provides much faster index create time, and much smaller index size.
ja: <emphasis role="bold">BRIN (Block Range Index)</emphasis>インデックスは、空間範囲を集計することで動作します。探索は範囲のスキャンを通して行われます。BRINは一部の種類 (空間的にソートされ、更新がほぼ無いか全く無い)のデータだけに適切です。しかし、インデックス生成時間は非所に早く、インデックスサイズは非常に小さくなります。

note: Tag: para
en: <emphasis role="bold">SP-GiST (Space-Partitioned Generalized Search Tree)</emphasis> is a generic index method that supports partitioned search trees such as quad-trees, k-d trees, and radix trees (tries).
ja: <emphasis role="bold">SP-GiST (Space-Partitioned Generalized Search Tree)</emphasis>は4分木、kd木、基数木 (トライ木)のような部分木探索に対応する一般的なインデックス手法です。

note: Tag: para
en: Spatial indexes store only the bounding box of geometries. Spatial queries use the index as a <emphasis role="bold">primary filter</emphasis> to quickly determine a set of geometries potentially matching the query condition. Most spatial queries require a <emphasis role="bold">secondary filter</emphasis> that uses a spatial predicate function to test a more specific spatial condition. For more information on queying with spatial predicates see <xref linkend="using-query-indexes"/>.
ja: 空間インデックスはジオメトリのバウンディングボックスだけを格納します。空間クエリはインデックスは<emphasis role="bold">初期フィルタ</emphasis>として使用して、クエリ条件に一致する可能性のあるジオメトリを早く求めます。ほとんどの空間クエリでは、空間述語関数を使って特定の空間条件をテストする<emphasis role="bold">二次フィルタ</emphasis>が必要です。空間述語関数を使ったクエリの詳細情報については<xref linkend="using-query-indexes"/>をご覧下さい。

note: Tag: para
en: See also the <link xlink:href="https://postgis.net/workshops/postgis-intro/indexing.html">PostGIS Workshop section on spatial indexes</link>, and the <link xlink:href="https://www.postgresql.org/docs/current/indexes.html">PostgreSQL manual</link>.
ja: また、<link xlink:href="https://postgis.net/workshops/postgis-intro/indexing.html">PostGIS Workshop section on spatial indexes</link>と<link xlink:href="https://www.postgresql.org/docs/current/indexes.html">PostgreSQL manual</link>もご覧下さい。

note: Tag: title
en: GiST Indexes
ja: GiSTインデックス

note: Tag: para
en: GiST stands for "Generalized Search Tree" and is a generic form of indexing for multi-dimensional data. PostGIS uses an R-Tree index implemented on top of GiST to index spatial data. GiST is the most commonly-used and versatile spatial index method, and offers very good query performance. Other implementations of GiST are used to speed up searches on all kinds of irregular data structures (integer arrays, spectral data, etc) which are not amenable to normal B-Tree indexing. For more information see the <link xlink:href="https://www.postgresql.org/docs/current/gist.html">PostgreSQL manual</link>.
ja: GiSTは「汎用検索木 (Generalized Search Tree)」の意味で、多次元データのインデックスの一般化された形式です。PostGISはGiST上で実装しているR木インデックスをを空間データのインデックスに使用しています。GiSTは最も一般的に使われ、多目的なインデックス手法で、クエリ能率を非常に良くします。他のGiSTの実装は、通常のB木インデックスに従わない全ての種類の不規則なデータ構造 (整数配列, スペクトラルデータ等)の検索速度を向上させるために使います。詳細情報については<link xlink:href="https://www.postgresql.org/docs/current/gist.html">PostgreSQL manual</link>をご覧ください。

note: Tag: para
en: Once a spatial data table exceeds a few thousand rows, you will want to build an index to speed up spatial searches of the data (unless all your searches are based on attributes, in which case you'll want to build a normal index on the attribute fields).
ja: GISデータテーブルが数千行を超えたら、空間検索の速度向上のためインデックスを構築したくなるでしょう (これは属性検索でない場合です。属性でしたら通常のインデックスを属性フィールドに追加します)。

note: Tag: para
en: The syntax for building a GiST index on a "geometry" column is as follows:
ja: GiSTインデックスをジオメトリカラムに追加するための文は次の通りです。

note: Tag: para
en: The above syntax will always build a 2D-index. To get the an n-dimensional index for the geometry type, you can create one using this syntax:
ja: 上の文では常に2次元インデックスを構築します。n次元インデックスをジオメトリ型で使うには、次の文でインデックスを生成できます。

note: Tag: para
en: Building a spatial index is a computationally intensive exercise. It also blocks write access to your table for the time it creates, so on a production system you may want to do in in a slower CONCURRENTLY-aware way:
ja: 空間インデックスの構築は、計算量を集中させて行われます。また、この時には、テーブルへの書き込みアクセスがブロックされます。そのため、本番システムではより遅いCONCURRENTLYを選択するかも知れません。次のようにします。

note: Tag: para
en: After building an index, it is sometimes helpful to force PostgreSQL to collect table statistics, which are used to optimize query plans:
ja: インデックス構築後に、時々PostgreSQLにテーブルの統計情報を集めさせると助かります。クエリプランの最適化に使われます。

note: Tag: title
en: BRIN Indexes
ja: BRINインデックス

note: Tag: para
en: BRIN stands for "Block Range Index". It is a general-purpose index method introduced in PostgreSQL 9.5. BRIN is a <emphasis>lossy</emphasis> index method, meaning that a secondary check is required to confirm that a record matches a given search condition (which is the case for all provided spatial indexes). It provides much faster index creation and much smaller index size, with reasonable read performance. Its primary purpose is to support indexing very large tables on columns which have a correlation with their physical location within the table. In addition to spatial indexing, BRIN can speed up searches on various kinds of attribute data structures (integer, arrays etc). For more information see the <link xlink:href="https://www.postgresql.org/docs/current/brin.html">PostgreSQL manual</link>.
ja: BRINは"Block Range Index"の略です。PostgreSQL 9.5で導入された汎用インデックス手法です。BRINは<emphasis>不可逆</emphasis>インデックス手法であり、レコードが与えた検索条件に合致することを確認する二番目のチェックが必要であることを意味しています (全ての空間インデックスで言えます)。非常に速いインデックス作成、非常に小さいインデックスサイズで、合理的な読み込み効率を持ちます。主目的は、非常に大きいテーブルのテーブル内の物理位置と関係があるカラムにインデックスを作ることに対応するためです。空間インデックスに加えて、BRINは様々な種類の属性データ構造 (整数、配列等)で速度向上させることができます。詳細情報については<link xlink:href="https://www.postgresql.org/docs/current/brin.html">PostgreSQL manual</link>をご覧ください。

note: Tag: para
en: Once a spatial table exceeds a few thousand rows, you will want to build an index to speed up spatial searches of the data. GiST indexes are very performant as long as their size doesn't exceed the amount of RAM available for the database, and as long as you can afford the index storage size, and the cost of index update on write. Otherwise, for very large tables BRIN index can be considered as an alternative.
ja: 空間テーブルが、ひとたび数千行を超えると、データの空間検索の速度向上にインデックスが必要と感じることになります。GiSTインデックスは、サイズがデータベースで使えるRAM容量を超えず、インデックスのストレージサイズに余裕があり、書き込み時のインデックス更新コストにも余裕があるなら、非常に高いパフォーマンスを発揮します。そうでない場合には、非常に大きなテーブルにおいては、BRINインデックスを代替に考えることができます。

note: Tag: para
en: A BRIN index stores the bounding box enclosing all the geometries contained in the rows in a contiguous set of table blocks, called a <emphasis>block range</emphasis>. When executing a query using the index the block ranges are scanned to find the ones that intersect the query extent. This is efficient only if the data is physically ordered so that the bounding boxes for block ranges have minimal overlap (and ideally are mutually exclusive). The resulting index is very small in size, but is typically less performant for read than a GiST index over the same data.
ja: BRINインデックスは、連続するテーブルブロックの集合 (<emphasis>ブロック範囲</emphasis>と言います)の全てのジオメトリを囲むバウンディングボックスを格納します。インデックスを使用した問い合わせを実行する時に、問い合わせ範囲とインタセクトするブロック範囲を見つけるためにスキャンします。これは、データが物理的に整列していて、ブロック範囲のバウンディングボックスのオーバラップが最小である (理想的には相互に排他的である)場合に限って効率的です。結果インデックスは非常に小さいサイズですが、通常、読み込み効率は、同じデータにおけるGiSTインデックスより悪くなります。

note: Tag: para
en: Building a BRIN index is much less CPU-intensive than building a GiST index. It's common to find that a BRIN index is ten times faster to build than a GiST index over the same data. And because a BRIN index stores only one bounding box for each range of table blocks, it's common to use up to a thousand times less disk space than a GiST index.
ja: BRINインデックスの構築は、はGiSTインデックスと比べて、CPU集中を非常に減らします。BRINインデックスはGiSTインデックスよりも、同じデータに対して10倍速く構築するのが普通です。BRINインデックスはテーブルブロックの範囲ごとに一つのバウンディングボックスしか格納しないので、GiSTインデックスと比べて、ディスクスペースを1000倍少なくできます。

note: Tag: para
en: You can choose the number of blocks to summarize in a range. If you decrease this number, the index will be bigger but will probably provide better performance.
ja: レンジ内で要約するブロック数を選択できます。この数字を減らすと、インデックスは大きくなりますが、効率向上の助けになる可能性があります。

note: Tag: para
en: For BRIN to be effective, the table data should be stored in a physical order which minimizes the amount of block extent overlap. It may be that the data is already sorted appropriately (for instance, if it is loaded from another dataset that is already sorted in spatial order). Otherwise, this can be accomplished by sorting the data by a one-dimensional spatial key. One way to do this is to create a new table sorted by the geometry values (which in recent PostGIS versions uses an efficient Hilbert curve ordering):
ja: BRINを効果的にするには、テーブルデータをブロック範囲のオーバラップの量を最小にするような物理的オーダーで格納します。データが既に適切に並び替えられているかも知れません (たとえば、既に空間オーダーで並び替えられているデータセットを他のデータベースからロードする場合)。そうでない場合には、一つの空間キーによるデータの並べ替えで実現できます。一つの方法として、ジオメトリ値で並べ替えた新しいテーブルを生成することです (最近のPostGISのバージョンで効果的なヒルベルト曲線オーダーが使われています)。

note: Tag: para
en: Alternatively, data can be sorted in-place by using a GeoHash as a (temporary) index, and clustering on that index:
ja: もしくは、データは、ジオハッシュを (一時的な)インデックスに使い、そのインデックスでクラスタリングを行うことによって適切に並べ替えることができます。

note: Tag: para
en: The syntax for building a BRIN index on a <code>geometry</code> column is:
ja: BRINインデックスを<code>ジオメトリ</code>カラムに追加するための文は次の通りです。

note: Tag: para
en: The above syntax builds a 2D index. To build a 3D-dimensional index, use this syntax:
ja: 上の文で2次元インデックスを構築します。3次元インデックスをビルドするには、この文を使います。

note: Tag: para
en: You can also get a 4D-dimensional index using the 4D operator class:
ja: また、4次元演算子クラスを使う4次元インデックスを使うこともできます。

note: Tag: para
en: The above commands use the default number of blocks in a range, which is 128. To specify the number of blocks to summarise in a range, use this syntax
ja: 上記のコマンドでは、範囲のブロック数はデフォルトの128を使用しています。集計で範囲のブロック数を指定するには、この文を使います。

note: Tag: para
en: Keep in mind that a BRIN index only stores one index entry for a large number of rows. If your table stores geometries with a mixed number of dimensions, it's likely that the resulting index will have poor performance. You can avoid this performance penalty by choosing the operator class with the least number of dimensions of the stored geometries
ja: また、BRINインデックスは、多数の行で一つのインデックス値を格納することを心に留めておいて下さい。テーブルに違う次元のジオメトリを格納する場合には、インデックスの効率が悪くなります。この効率欠落を回避するには、格納したジオメトリの次元数の最小値となる演算子クラスを選択します。

note: Tag: para
en: The <code>geography</code> datatype is supported for BRIN indexing. The syntax for building a BRIN index on a geography column is:
ja: 「ジオグラフィ」型もまたBRINインデックスに対応しています。BRINインデックスを「ジオグラフィ」カラムに構築するための文は次の通りです。

note: Tag: para
en: The above syntax builds a 2D-index for geospatial objects on the spheroid.
ja: 上の文では常に回転楕円体面上の地理空間オブジェクトの2次元インデックスを構築します。

note: Tag: para
en: Currently, only "inclusion support" is provided, meaning that just the <varname>&amp;&amp;</varname>, <varname>~</varname> and <varname>@</varname> operators can be used for the 2D cases (for both <code>geometry</code> and <code>geography</code>), and just the <varname>&amp;&amp;&amp;</varname> operator for 3D geometries. There is currently no support for kNN searches.
ja: 現在のところは「包括対応」だけをここで考えています。これは、<varname>&amp;&amp;</varname>, <varname>~</varname>, <varname>@</varname>の演算子だけが2次元で使われることを意味します (<code>ジオメトリ</code>と<code>ジオグラフィ</code>の両方)。 <varname>&amp;&amp;&amp;</varname>演算子は3次元ジオメトリで使えます。しばらくはKNN検索に対応しません。

note: Tag: para
en: An important difference between BRIN and other index types is that the database does not maintain the index dynamically. Changes to spatial data in the table are simply appended to the end of the index. This will cause index search performance to degrade over time. The index can be updated by performing a <code>VACUUM</code>, or by using a special function <code>brin_summarize_new_values(regclass)</code>. For this reason BRIN may be most appropriate for use with data that is read-only, or only rarely changing. For more information refer to the <link xlink:href="https://www.postgresql.org/docs/current/brin-intro.html#BRIN-OPERATION">manual</link>.
ja: BRINと他のインデックスとの重要な違いは、データベースがインデックスを動的に保守しないことです。テーブルの空間データを変更すると、単純にインデックスの末尾に追加しています。このためインデックス探索の能率が時間とともに低下します。インデックスは<code>VACUUM</code>か空間関数<code>brin_summarize_new_values(regclass)</code>を実行することで更新できます。このため、BRINは読み込み専用か、書き込みがほとんど発生しないよなデータでの利用では最も適切になりえます。詳細情報については、<link xlink:href="https://www.postgresql.org/docs/current/brin-intro.html#BRIN-OPERATION">manual</link>をご覧下さい。

note: Tag: para
en: To summarize using BRIN for spatial data:
ja: 空間データにBRINを使用して集計するには:

note: Tag: para
en: Index build time is very fast, and index size is very small.
ja: インデックス構築時間は非常に速く、インデックスサイズは非常に小さいです。

note: Tag: para
en: Index query time is slower than GiST, but can still be very acceptable.
ja: インデックスのクエリ時間はGiSTより遅いですが、十分許容できます。

note: Tag: para
en: Requires table data to be sorted in a spatial ordering.
ja: テーブルデータを空間順序で並べ替える必要があります。

note: Tag: para
en: Requires manual index maintenance.
ja: 手動でインデックスの保守をする必要があります。

note: Tag: para
en: Most appropriate for very large tables, with low or no overlap (e.g. points), which are static or change infrequently.
ja: 巨大なテーブルであって、オーバラップが少ないか無く (ポイントなど)、かつ静的か頻繁には変更しないようなものに、最も適しています。

note: Tag: para
en: More effective for queries which return relatively large numbers of data records.
ja: 比較的多数のデータレコードを返すクエリでの使用が、より効果的です。

note: Tag: title
en: SP-GiST Indexes
ja: SP-GiSTインデックス

note: Tag: para
en: SP-GiST stands for "Space-Partitioned Generalized Search Tree" and is a generic form of indexing for multi-dimensional data types that supports partitioned search trees, such as quad-trees, k-d trees, and radix trees (tries). The common feature of these data structures is that they repeatedly divide the search space into partitions that need not be of equal size. In addition to spatial indexing, SP-GiST is used to speed up searches on many kinds of data, such as phone routing, ip routing, substring search, etc. For more information see the <link xlink:href="https://www.postgresql.org/docs/current/spgist.html">PostgreSQL manual</link>.
ja: SP-GiSTは、「空間分割された一般探索木」を表します。四分木、k次元木、基数木 (トライ木)のような分割探索木に対応するインデックスの総称的な形式です。このデータ構造の一般的な機能は、検索空間を反復して分割することですが、分割は等しいサイズである必要はありません。SP-GiSTは、GISインデックスだけでなく、電話回線のルーティングや、IPルーティング、部分文字列検索等といった、様々な種類のデータを探索する速度の向上に使われます。詳細情報については<link xlink:href="https://www.postgresql.org/docs/current/spgist.html">PostgreSQL manual</link>をご覧下さい。

note: Tag: para
en: As it is the case for GiST indexes, SP-GiST indexes are lossy, in the sense that they store the bounding box enclosing spatial objects. SP-GiST indexes can be considered as an alternative to GiST indexes.
ja: GiSTインデックスを利用しているので、空間オブジェクトを覆うバウンディングボックスを保存するという意味で、SP-GiSTインデックスは不可逆です。SP-GiSTインデックスは、GiSTインデックスの代替と考えることができます。

note: Tag: para
en: Once a GIS data table exceeds a few thousand rows, an SP-GiST index may be used to speed up spatial searches of the data. The syntax for building an SP-GiST index on a "geometry" column is as follows:
ja: 一度GISデータテーブルが数千行を超えると、データの空間探索の速度向上にSP-GiSTインデックスを使うと良いかも知れません。「ジオメトリ」カラムにSP-GiSTインデックスを構築するための文は次の通りです。

note: Tag: para
en: The above syntax will build a 2-dimensional index. A 3-dimensional index for the geometry type can be created using the 3D operator class:
ja: 上の文では、2次元インデックスを構築します。ジオメトリ型の3次元インデックスは、次のように、3次元演算子クラスを使用して生成します。

note: Tag: para
en: Building a spatial index is a computationally intensive operation. It also blocks write access to your table for the time it creates, so on a production system you may want to do in in a slower CONCURRENTLY-aware way:
ja: 空間インデックスの構築は、計算量を集中させて行われます。また、この時には、テーブルへの書き込みアクセスがブロックされます。そのため、本番システムでは、より遅いCONCURRENTLYを選択するかも知れません。次のようにします。

note: Tag: para
en: An SP-GiST index can accelerate queries involving the following operators:
ja: SP-GiSTインデックスは次の演算子を含むクエリの実行速度を向上させられます。

note: Tag: para
en: &lt;&lt;, &amp;&lt;, &amp;&gt;, &gt;&gt;, &lt;&lt;|, &amp;&lt;|, |&amp;&gt;, |&gt;&gt;, &amp;&amp;, @&gt;, &lt;@, and ~=, for 2-dimensional indexes,
ja: 2次元インデックスについては &lt;&lt;, &amp;&lt;, &amp;&gt;, &gt;&gt;, &lt;&lt;|, &amp;&lt;|, |&amp;&gt;, |&gt;&gt;, &amp;&amp;, @&gt;, &lt;@, ~=です。

note: Tag: para
en: &amp;/&amp;, ~==, @&gt;&gt;, and &lt;&lt;@, for 3-dimensional indexes.
ja: 3次元インデックスについては &amp;/&amp;, ~==, @&gt;&gt;, and &lt;&lt;@ 。

note: Tag: para
en: There is no support for kNN searches at the moment.
ja: 現時点ではkNN探索に対応していません。

note: Tag: title
en: Tuning Index Usage
ja: インデックス使用のチューニング

note: Tag: para
en: Ordinarily, indexes invisibly speed up data access: once an index is built, the PostgreSQL query planner automatically decides when to use it to improve query performance. But there are some situations where the planner does not choose to use existing indexes, so queries end up using slow sequential scans instead of a spatial index.
ja: 通常、インデックスは知らないうちにデータアクセスの速度を向上します。ひとたびインデックスを構築すれば、PostgreSQLクエリプランナは自動的にクエリの能率を向上させるために使うべきかどうかを決定します。しかし、プランナが既存のインデックスを選択せず、遅いシーケンシャルスキャンを使い続ける場合があります。

note: Tag: para
en: If you find your spatial indexes are not being used, there are a few things you can do:
ja: 空間インデックスが使われていないのが分かった場合には、少しの行えることがあります。

note: Tag: para
en: Examine the query plan and check your query actually computes the thing you need. An erroneous JOIN, either forgotten or to the wrong table, can unexpectedly retrieve table records multiple times. To get the query plan, execute with <code>EXPLAIN</code> in front of the query.
ja: クエリプランの試験とクエリの確認で、必要なものを計算できます。誤ったJOINや忘れ去られたテーブルや間違ったテーブルでは、予期しないテーブルレコード検索が複数回行われることがありえます。クエリプランを得るにはクエリの先頭に<code>EXPLAIN</code>を付けて実行します。

note: Tag: para
en: Make sure statistics are gathered about the number and distributions of values in a table, to provide the query planner with better information to make decisions around index usage. <command>VACUUM ANALYZE</command> will compute both.
ja: テーブル内の値の数量と分布に関する統計情報を収集するとともに、クエリプランナにインデックス使用にかかる意思決定のための、より良い情報を与えるようにします。<command>VACUUM ANALYZE</command>は両方を計算します。

note: Tag: para
en: You should regularly vacuum your databases anyways. Many PostgreSQL DBAs run <command>VACUUM</command> as an off-peak cron job on a regular basis.
ja: データベースに対する定期的なvacuumは常に実行するべきです。多くのPostgreSQLデータベースエージェントは、閑散時のcronジョブとして定期的に<command>VACUUM</command>を実行します。

note: Tag: para
en: If vacuuming does not help, you can temporarily force the planner to use the index information by using the command <command>SET ENABLE_SEQSCAN TO OFF;</command>. This way you can check whether the planner is at all able to generate an index-accelerated query plan for your query. You should only use this command for debugging; generally speaking, the planner knows better than you do about when to use indexes. Once you have run your query, do not forget to run <command>SET ENABLE_SEQSCAN TO ON;</command> so that the planner will operate normally for other queries.
ja: VACUUMが役に立たない場合には、<command>SET ENABLE_SEQSCAN TO OFF;</command>コマンドを使用して、一時的にプランナにインデックス情報の使用を強制することができます。この方法で、プランナがインデックス使用を多くしたクエリプランを生成できるかどうかを確認できます。このコマンドはデバッグにのみ使用してください。一般的に言えば、プランナはインデックスを使用するタイミングをよく知っています。クエリを実行したら<command>SET ENABLE_SEQSCAN TO ON;</command>を実行して、他のクエリでは通常操作にすることを忘れないでください。

note: Tag: para
en: If <command>SET ENABLE_SEQSCAN TO OFF;</command> helps your query to run faster, your Postgres is likely not tuned for your hardware. If you find the planner wrong about the cost of sequential versus index scans try reducing the value of <varname>RANDOM_PAGE_COST</varname> in <code>postgresql.conf</code>, or use <command>SET RANDOM_PAGE_COST TO 1.1;</command>. The default value for <varname>RANDOM_PAGE_COST</varname> is 4.0. Try setting it to 1.1 (for SSD) or 2.0 (for fast magnetic disks). Decreasing the value makes the planner more likely to use index scans.
ja: <command>SET ENABLE_SEQSCAN TO OFF;</command>でクエリ速度が向上する場合には、PostgreSQLのハードウェア関連のチューンが行われていないのかも知れません。プランナがシーケンシャル対インデックスのコストが誤っている場合には、<code>postgresql.conf</code>内にある<varname>RANDOM_PAGE_COST</varname>の値を変更してみて下さい。<command>SET RANDOM_PAGE_COST TO 1.1;</command>とします。<varname>RANDOM_PAGE_COST</varname>のデフォルト値は4.0です。1.1 (SSDの場合)または2.0 (高速磁気ディスクの場合)を試してみて下さい。値を小さくするほど、プランナがインデックススキャンをしやすくなります。

note: Tag: para
en: If <command>SET ENABLE_SEQSCAN TO OFF;</command> does not help your query, the query may be using a SQL construct that the Postgres planner is not yet able to optimize. It may be possible to rewrite the query in a way that the planner is able to handle. For example, a subquery with an inline SELECT may not produce an efficient plan, but could possibly be rewritten using a LATERAL JOIN.
ja: <command>SET ENABLE_SEQSCAN TO OFF;</command>がクエリの助けにならないなら、クエリはPostgreSQLプランナがまだ最適化できないSQL構成なのかも知れません。プランナが処理できるようにクエリを再記述できるかもしれません。例えば、インラインSELECTを持つ副問い合わせがあると、効果的なプランを作らないことがあり、LATERAL JOINを使うように書き換えることができます。

note: Tag: para
en: For more information see the Postgres manual section on <link xlink:href="https://www.postgresql.org/docs/current/runtime-config-query.html">Query Planning</link>.
ja: 詳細情報についてはPostgreSQLマニュアルの<link xlink:href="https://www.postgresql.jp/document/current/html/runtime-config-query.html">問い合わせ計画</link>節をご覧下さい。

note: Tag: title
en: Spatial Queries
ja: 空間クエリ

note: Tag: para
en: The <emphasis>raison d'etre</emphasis> of spatial databases is to perform queries inside the database which would ordinarily require desktop GIS functionality. Using PostGIS effectively requires knowing what spatial functions are available, how to use them in queries, and ensuring that appropriate indexes are in place to provide good performance.
ja: 空間データベースの<emphasis>レゾンデートル</emphasis>は、通常ならデスクトップGISの機能が必要なクエリをデータベース内で実行することです。PostGISを使うには、使用可能な空間関数は何かを知り、またクエリ内でどう使うかを知って、適切なインデックスで能率を向上させることが求められます。

note: Tag: title
en: Determining Spatial Relationships
ja: 空間関係の決定

note: Tag: para
en: Spatial relationships indicate how two geometries interact with one another. They are a fundamental capability for querying geometry.
ja: 空間関係は、二つのジオメトリについて、一方がもう一方にどのような相互関係になっているかを示すものです。ジオメトリのクエリにおける基本的な機能です。

note: Tag: title
en: Dimensionally Extended 9-Intersection Model
ja: 次元拡張9交差モデル

note: Tag: para
en: According to the <link xlink:href="http://www.opengeospatial.org/standards/sfs">OpenGIS Simple Features Implementation Specification for SQL</link>, "the basic approach to comparing two geometries is to make pair-wise tests of the intersections between the Interiors, Boundaries and Exteriors of the two geometries and to classify the relationship between the two geometries based on the entries in the resulting 'intersection' matrix."
ja: <link xlink:href="http://www.opengeospatial.org/standards/sfs">OpenGIS Simple Features Implementation Specification for SQL</link>によると「二つのジオメトリの比較の基本的なアプローチは、二つのジオメトリの内部、境界、外部のインタセクションの比較と、『インタセクション行列』の要素に基づく2ジオメトリの関係の分類です」。

note: Tag: para
en: In the theory of point-set topology, the points in a geometry embedded in 2-dimensional space are categorized into three sets:
ja: 点集合トポロジでは、2次元空間に埋め込まれたジオメトリの中にあるポイントは、次に示す三つの集合に分類されます。

note: Tag: glossterm
en: <glossterm>Boundary</glossterm>
ja: <glossterm>境界</glossterm>

note: Tag: para
en: The boundary of a geometry is the set of geometries of the next lower dimension. For <varname>POINT</varname>s, which have a dimension of 0, the boundary is the empty set. The boundary of a <varname>LINESTRING</varname> is the two endpoints. For <varname>POLYGON</varname>s, the boundary is the linework of the exterior and interior rings.
ja: ジオメトリの境界は、一次元低いジオメトリです。<varname>POINT</varname>では、次元が0になり、境界は空集合です。<varname>LINESTRING</varname>の境界は二つの端点です。<varname>POLYGON</varname>の境界は、外環と内環の線です。

note: Tag: glossterm
en: <glossterm>Interior</glossterm>
ja: <glossterm>内部 (Interior)</glossterm>

note: Tag: para
en: The interior of a geometry are those points of a geometry that are not in the boundary. For <varname>POINT</varname>s, the interior is the point itself. The interior of a <varname>LINESTRING</varname> is the set of points between the endpoints. For <varname>POLYGON</varname>s, the interior is the areal surface inside the polygon.
ja: ジオメトリの内部は、ジオメトリの境界以外のポイントです。<varname>POINT</varname>では、内部はポイント自体です。<varname>LINESTRING</varname>の内部は端点の間のポイントの集合です。<varname>POLYGON</varname>の内部は、ポリゴン内部の面です。

note: Tag: glossterm
en: <glossterm>Exterior</glossterm>
ja: <glossterm>外部 (Exterior)</glossterm>

note: Tag: para
en: The exterior of a geometry is the rest of the space in which the geometry is embedded; in other words, all points not in the interior or on the boundary of the geometry. It is a 2-dimensional non-closed surface.
ja: ジオメトリの外部はジオメトリが組み込まれた空間の残りです。言い換えると、ジオメトリの内部にも境界にもない点の全てです。これは2次元の閉じていない面になります。

note: Tag: para
en: The <link xlink:href="http://en.wikipedia.org/wiki/DE-9IM">Dimensionally Extended 9-Intersection Model</link> (DE-9IM) describes the spatial relationship between two geometries by specifying the dimensions of the 9 intersections between the above sets for each geometry. The intersection dimensions can be formally represented in a 3x3 <emphasis role="bold">intersection matrix</emphasis>.
ja: <link xlink:href="http://en.wikipedia.org/wiki/DE-9IM">次元拡張9交差モデル</link> (Dimensionally Extended 9-Intersection Model, DE-9IM)は、二つのジオメトリの空間関係を九つの交差の次元を指定することで記述します。交差次元は3×3の<emphasis role="bold">交差行列</emphasis>で正式に表現することができます。

note: Tag: para
en: For a geometry <emphasis>g</emphasis> the <emphasis>Interior</emphasis>, <emphasis>Boundary</emphasis>, and <emphasis>Exterior</emphasis> are denoted using the notation <emphasis>I(g)</emphasis>, <emphasis>B(g)</emphasis>, and <emphasis>E(g)</emphasis>. Also, <emphasis>dim(s)</emphasis> denotes the dimension of a set <emphasis>s</emphasis> with the domain of <literal>{0,1,2,F}</literal>:
ja: ジオメトリ<emphasis>g</emphasis>に対する<emphasis>内部</emphasis>、<emphasis>境界</emphasis>、<emphasis>外部</emphasis>は<emphasis>I(g)</emphasis>、<emphasis>B(g)</emphasis>、<emphasis>E(g)</emphasis>と表記します。また、<emphasis>dim(s)</emphasis>は<emphasis>s</emphasis>の集合を<literal>{0,1,2,F}</literal>の値で示すます。

note: Tag: para
en: <literal>0</literal> =&gt; point
ja: <literal>0</literal> =&gt; 点

note: Tag: para
en: <literal>1</literal> =&gt; line
ja: <literal>1</literal> =&gt; 線

note: Tag: para
en: <literal>2</literal> =&gt; area
ja: <literal>2</literal> =&gt; 面

note: Tag: para
en: <literal>F</literal> =&gt; empty set
ja: <literal>F</literal> =&gt; 空集合

note: Tag: para
en: Using this notation, the intersection matrix for two geometries <emphasis>a</emphasis> and <emphasis>b</emphasis> is:
ja: この表記法を使うと、二つのジオメトリ<emphasis>a</emphasis>と<emphasis>b</emphasis>の交差行列は次の通りです。

note: Tag: emphasis
en: <emphasis role="bold">Interior</emphasis>
ja: <emphasis role="bold">内部 (Interior)</emphasis>

note: Tag: emphasis
en: <emphasis role="bold">Boundary</emphasis>
ja: <emphasis role="bold">境界 (Boundary)</emphasis>

note: Tag: emphasis
en: <emphasis role="bold">Exterior</emphasis>
ja: <emphasis role="bold">外部 (Exterior)</emphasis>

note: Tag: para
en: Visually, for two overlapping polygonal geometries, this looks like:
ja: 二つのオーバラップするポリゴンについて可視化すると、次のようになります。

note: Tag: para
en: Reading from left to right and top to bottom, the intersection matrix is represented as the text string '<emphasis role="bold">212101212</emphasis>'.
ja: 左から右に、上から下に読みます。交差行列の文字列表現は'<emphasis role="bold">212101212</emphasis>'です。

note: Tag: para
en: For more information, refer to:
ja: 詳細情報については次をご覧下さい。

note: Tag: para
en: <link xlink:href="http://www.opengeospatial.org/standards/sfs">OpenGIS Simple Features Implementation Specification for SQL</link> (version 1.1, section 2.1.13.2)
ja: <link xlink:href="http://www.opengeospatial.org/standards/sfs">OpenGIS Simple Features Implementation Specification for SQL</link> (1.1版, 2.1.13.2節)

note: Tag: title
en: Named Spatial Relationships
ja: 名前付き空間関係

note: Tag: para
en: To make it easy to determine common spatial relationships, the OGC SFS defines a set of <emphasis>named spatial relationship predicates</emphasis>. PostGIS provides these as the functions <xref linkend="ST_Contains"/>, <xref linkend="ST_Crosses"/>, <xref linkend="ST_Disjoint"/>, <xref linkend="ST_Equals"/>, <xref linkend="ST_Intersects"/>, <xref linkend="ST_Overlaps"/>, <xref linkend="ST_Touches"/>, <xref linkend="ST_Within"/>. It also defines the non-standard relationship predicates <xref linkend="ST_Covers"/>, <xref linkend="ST_CoveredBy"/>, and <xref linkend="ST_ContainsProperly"/>.
ja: 共通の空間関係を簡単に決定できるように、PGC SFSは<emphasis>名前付き空間関係述語</emphasis>の集合を定義しています。PostGISでは<xref linkend="ST_Contains"/>、<xref linkend="ST_Crosses"/>、<xref linkend="ST_Disjoint"/>、<xref linkend="ST_Equals"/>、<xref linkend="ST_Intersects"/>、<xref linkend="ST_Overlaps"/>、<xref linkend="ST_Touches"/>、<xref linkend="ST_Within"/>が提供されています。非標準の空間関係述語<xref linkend="ST_Covers"/>、<xref linkend="ST_CoveredBy"/>、<xref linkend="ST_ContainsProperly"/>も定義されています。

note: Tag: para
en: Spatial predicates are usually used as conditions in SQL <code>WHERE</code> or <code>JOIN</code> clauses. The named spatial predicates automatically use a spatial index if one is available, so there is no need to use the bounding box operator <code>&amp;&amp;</code> as well. For example:
ja: 空間述語は通常SQLの<code>WHERE</code>節や<code>JOIN</code>節内で条件に使用されます。名前付き空間述語は、インデックスが有効なら自動的に空間インデックスを使うので、バウンディングボックス演算子<code>&amp;&amp;</code>を使う必要はありません。例えば次のようになります。

note: Tag: para
en: For more details and illustrations, see the <link xlink:href="https://postgis.net/workshops/postgis-intro/spatial_relationships.html">PostGIS Workshop.</link>
ja: 詳細や図については<link xlink:href="https://postgis.net/workshops/postgis-intro/spatial_relationships.html">PostGIS Workshop</link>をご覧下さい。

note: Tag: title
en: General Spatial Relationships
ja: 一般的な空間関係

note: Tag: para
en: In some cases the named spatial relationships are insufficient to provide a desired spatial filter condition.
ja: 名前付き空間関係が求める空間フィルタ条件を与えるのに不十分となる場合があります。

note: Tag: para
en: For example, consider a linear dataset representing a road network. It may be required to identify all road segments that cross each other, not at a point, but in a line (perhaps to validate some business rule). In this case <xref linkend="ST_Crosses"/> does not provide the necessary spatial filter, since for linear features it returns <varname>true</varname> only where they cross at a point.
ja: 例えば、道路ネットワークを表現する線データセットを考えてみます。点でなく線で交差する全ての道路の辺を識別しなければならないことがあります (ビジネスルールの検証のためならありえます)。この場合、<xref linkend="ST_Crosses"/>では、点で交差する場合しか<varname>true</varname>を返さないので、必要な空間フィルタになりません。

note: Tag: para
en: A two-step solution would be to first compute the actual intersection (<xref linkend="ST_Intersection"/>) of pairs of road lines that spatially intersect (<xref linkend="ST_Intersects"/>), and then check if the intersection's <xref linkend="ST_GeometryType"/> is '<varname>LINESTRING</varname>' (properly dealing with cases that return <varname>GEOMETRYCOLLECTION</varname>s of <varname>[MULTI]POINT</varname>s, <varname>[MULTI]LINESTRING</varname>s, etc.).
ja: 2ステップ解決法を示します。まず、空間的にインタセクトしている同路線の二本を抜き出し (<xref linkend="ST_Intersects"/>)、実際にインタセクトしている部分を計算 (<xref linkend="ST_Intersection"/>)します。次いで、インタセクトしている部分の<xref linkend="ST_GeometryType"/>が<varname>LINESTRING</varname>' かどうかを確認します (<varname>[MULTI]POINT</varname>、<varname>[MULTI]LINESTRING</varname>等の<varname>GEOMETRYCOLLECTION</varname>を返す場合に適切に処理します)。

note: Tag: para
en: Clearly, a simpler and faster solution is desirable.
ja: 明らかに、より単純でより速い解法が望ましいです。

note: Tag: para
en: A second example is locating wharves that intersect a lake's boundary on a line and where one end of the wharf is up on shore. In other words, where a wharf is within but not completely contained by a lake, intersects the boundary of a lake on a line, and where exactly one of the wharf's endpoints is within or on the boundary of the lake. It is possible to use a combination of spatial predicates to find the required features:
ja: 二つ目の例では、湖の境界とインタセクトし、かつ終端が岸に上がっている波止場を見つけます。言い換えると、波止場が湖に含まれるが完全には含まれず、湖の境界線とインタセクトして、波止場の終端が確実に湖内または境界にある場合を指します。空間述語を併用すると求める地物を見つけることができます。

note: Tag: para
en: ... but needless to say, this is quite complicated.
ja: … 言うまでもないですが非常に複雑ですね。

note: Tag: para
en: These requirements can be met by computing the full DE-9IM intersection matrix. PostGIS provides the <xref linkend="ST_Relate"/> function to do this:
ja: この要件は完全なDE-9IM交差行列の計算で満たすことができます。PostGISは、これを行う<xref linkend="ST_Relate"/>関数を提供しています。次のようにします:

note: Tag: para
en: To test a particular spatial relationship, an <emphasis role="bold">intersection matrix pattern</emphasis> is used. This is the matrix representation augmented with the additional symbols <literal>{T,*}</literal>:
ja: 特定の空間関係をテストするには、<emphasis role="bold">交差行列パターン</emphasis>を使います。これは、追加シンボル<literal>{T,*}</literal>で拡張された行列表現です。

note: Tag: para
en: <literal>T</literal> =&gt; intersection dimension is non-empty; i.e. is in <literal>{0,1,2}</literal>
ja: <literal>T</literal> =&gt; インタセクションの次元は空ではないという意味です。すなわち<literal>{0,1,2}</literal>のいずれかです。

note: Tag: para
en: <literal>*</literal> =&gt; don't care
ja: <literal>*</literal> =&gt; 何でも良い

note: Tag: para
en: Using intersection matrix patterns, specific spatial relationships can be evaluated in a more succinct way. The <xref linkend="ST_Relate"/> and the <xref linkend="ST_RelateMatch"/> functions can be used to test intersection matrix patterns. For the first example above, the intersection matrix pattern specifying two lines intersecting in a line is '<emphasis role="bold">1*1***1**</emphasis>':
ja: 交差行列パターンを使って、特定の空間関係の評価がより簡潔な方法で可能です。交差行列パターンのテストに<xref linkend="ST_Relate"/>と<xref linkend="ST_RelateMatch"/>を使うことができます。上に挙げた一つ目の例では、二つのラインがライン内部でインタセクトする交差行列パターンは'<emphasis role="bold">1*1***1**</emphasis>'となります。

note: Tag: para
en: For the second example, the intersection matrix pattern specifying a line partly inside and partly outside a polygon is '<emphasis role="bold">102101FF2</emphasis>':
ja: 二つ目の例です。一本のラインが部分的にポリゴン内部とポリゴン外部とにある場合の交差行列パターンは '<emphasis role="bold">102101FF2</emphasis>'となります。

note: Tag: title
en: Using Spatial Indexes
ja: 空間インデックスを使う

note: Tag: para
en: When constructing queries using spatial conditions, for best performance it is important to ensure that a spatial index is used, if one exists (see <xref linkend="build-indexes"/>). To do this, a spatial operator or index-aware function must be used in a <code>WHERE</code> or <code>ON</code> clause of the query.
ja: 空間条件を使用するクエリを構築する時、最良の効果を得るには、空間インデックスが存在する場合に (<xref linkend="build-indexes"/>参照)これを確実に使用することが重要です。そのためには、<code>WHERE</code>節や<code>ON</code>節で、空間演算子またはインデックス対応関数を使用しなければなりません。

note: Tag: para
en: Spatial operators include the bounding box operators (of which the most commonly used is <xref linkend="geometry_overlaps"/>; see <xref linkend="operators-bbox"/> for the full list) and the distance operators used in nearest-neighbor queries (the most common being <xref linkend="geometry_distance_knn"/>; see <xref linkend="operators-distance"/> for the full list.)
ja: 空間演算子には、バウンディングボックス演算子 (最もよく使われるのは<xref linkend="geometry_overlaps"/>です。<xref linkend="operators-bbox"/>参照)、および近傍クエリで使用される距離演算子 (最もよく使われるのは<xref linkend="geometry_distance_knn"/>です。<xref linkend="operators-distance"/>参照)が含まれます。

note: Tag: para
en: Index-aware functions automatically add a bounding box operator to the spatial condition. Index-aware functions include the named spatial relationship predicates <xref linkend="ST_Contains"/>, <xref linkend="ST_ContainsProperly"/>, <xref linkend="ST_CoveredBy"/>, <xref linkend="ST_Covers"/>, <xref linkend="ST_Crosses"/>, <xref linkend="ST_Intersects"/>, <xref linkend="ST_Overlaps"/>, <xref linkend="ST_Touches"/>, <xref linkend="ST_Within"/>, <xref linkend="ST_Within"/>, and <xref linkend="ST_3DIntersects"/>, and the distance predicates <xref linkend="ST_DWithin"/>, <xref linkend="ST_DFullyWithin"/>, <xref linkend="ST_3DDFullyWithin"/>, and <xref linkend="ST_3DDWithin"/> .)
ja: インデックス対応関数は、自動的にバウンディングボックス演算子を空間条件に追加します。インデックス対応関数は空間関係述語を含みます。空間関係述語には、<xref linkend="ST_Contains"/>, <xref linkend="ST_ContainsProperly"/>, <xref linkend="ST_CoveredBy"/>, <xref linkend="ST_Covers"/>, <xref linkend="ST_Crosses"/>, <xref linkend="ST_Intersects"/>, <xref linkend="ST_Overlaps"/>, <xref linkend="ST_Touches"/>, <xref linkend="ST_Within"/>, <xref linkend="ST_Within"/>, <xref linkend="ST_3DIntersects"/>があり、距離述語には<xref linkend="ST_DWithin"/>, <xref linkend="ST_DFullyWithin"/>, <xref linkend="ST_3DDFullyWithin"/>, <xref linkend="ST_3DDWithin"/> があります。

note: Tag: para
en: Functions such as <xref linkend="ST_Distance"/> do <emphasis>not</emphasis> use indexes to optimize their operation. For example, the following query would be quite slow on a large table:
ja: <xref linkend="ST_Distance"/>といった関数は、演算の最適化のためにはインデックスを<emphasis>使用しません</emphasis>。例えば、次のクエリは、大きなテーブルでは非常に遅くなります。

note: Tag: para
en: This query selects all the geometries in <code>geom_table</code> which are within 100 units of the point (100000, 200000). It will be slow because it is calculating the distance between each point in the table and the specified point, ie. one <varname>ST_Distance()</varname> calculation is computed for <emphasis role="bold">every</emphasis> row in the table.
ja: このクエリは<code>geom_table</code>テーブル内の、(100000, 200000)のポイントから100単位内にある全てのジオメトリを選択します。テーブル内の個々のポイントと指定したポイントとの距離を計算しているため、非常に遅くなります。すなわち、1回の<varname>ST_Distance()</varname>の計算で、テーブルの<emphasis role="bold">全ての</emphasis>行について計算することになります。

note: Tag: para
en: The number of rows processed can be reduced substantially by using the index-aware function <xref linkend="ST_DWithin"/>:
ja: インデックス対応関数<xref linkend="ST_DWithin"/>を使用すると、処理行数を実質的に減らすことができます。次のようにします。

note: Tag: para
en: This query selects the same geometries, but it does it in a more efficient way. This is enabled by <varname>ST_DWithin()</varname> using the <varname>&amp;&amp;</varname> operator internally on an expanded bounding box of the query geometry. If there is a spatial index on <code>geom</code>, the query planner will recognize that it can use the index to reduce the number of rows scanned before calculating the distance. The spatial index allows retrieving only records with geometries whose bounding boxes overlap the expanded extent and hence which <emphasis>might</emphasis> be within the required distance. The actual distance is then computed to confirm whether to include the record in the result set.
ja: このクエリは、同じジオメトリを選択しますが、より効率的な方法を取ります。 <varname>ST_DWithin()</varname>が内部で<varname>&amp;&amp;</varname>演算子をクエリジオメトリのバウンディングボックスを拡大したボックスで使うことによって可能となります。<code>geom</code>上に空間インデックスが存在するなら、クエリプランナは距離計算の前に対象行数を減らすためにインデックスを使えることを認識します。空間インデックスによって、バウンディングボックスが拡張された範囲とオーバラップするジオメトリだけを検索して、そのため、求めようとする距離内にある<emphasis>かも知れない</emphasis>ジオメトリを検索することができます。その後で、結果集合内のレコードを含めるかどうかを確認するための実際の距離計算が行われます。

note: Tag: para
en: For more information and examples see the <link xlink:href="https://postgis.net/workshops/postgis-intro/indexing.html">PostGIS Workshop</link>.
ja: 詳細情報と例については<link xlink:href="https://postgis.net/workshops/postgis-intro/indexing.html">PostGIS Workshop</link>をご覧下さい。

note: Tag: title
en: Examples of Spatial SQL
ja: 空間SQLの例

note: Tag: para
en: The examples in this section make use of a table of linear roads, and a table of polygonal municipality boundaries. The definition of the <varname>bc_roads</varname> table is:
ja: 本節の例では、線の道路のテーブルとポリゴンの市区町村境界テーブルとを使います。<varname>bc_roads</varname>テーブルの定義は次の通りです。

note: Tag: para
en: The definition of the <varname>bc_municipality</varname> table is:
ja: <varname>bc_municipality</varname>テーブルの定義は次の通りです。

note: Tag: para
en: What is the total length of all roads, expressed in kilometers?
ja: 道路の総延長はkm表記でいくらになるでしょう?

note: Tag: para
en: You can answer this question with a very simple piece of SQL:
ja: この問題は、次のようなとても単純なSQLで答えを得ることができます。

note: Tag: para
en: How large is the city of Prince George, in hectares?
ja: プリンスジョージ市の大きさはha表記でいくらになるでしょう?

note: Tag: para
en: This query combines an attribute condition (on the municipality name) with a spatial calculation (of the polygon area):
ja: このクエリでは、属性条件 (municipality name, 自治体名)に (ポリゴン面積の)空間計算を併用しています。

note: Tag: para
en: What is the largest municipality in the province, by area?
ja: 県内で最も大きな面積となる自治体はどこでしょう?

note: Tag: para
en: This query uses a spatial measurement as an ordering value. There are several ways of approaching this problem, but the most efficient is below:
ja: このクエリでは、順序付けの値に空間計測関数を使っています。この問題に対しては複数の方法がありますが、最も効果的な方法は次の通りです。

note: Tag: para
en: Note that in order to answer this query we have to calculate the area of every polygon. If we were doing this a lot it would make sense to add an area column to the table that could be indexed for performance. By ordering the results in a descending direction, and them using the PostgreSQL "LIMIT" command we can easily select just the largest value without using an aggregate function like MAX().
ja: このクエリの答えを出すためには、全てのポリゴンの面積を求める必要があることに注意して下さい。このクエリを多く実行する場合、性能向上のためにテーブルにareaカラムを追加して、別のインデックスを追加することができるようにするのは、意義のあることです。結果を距離について降順に並べ替え、PostgreSQLの"LIMIT"コマンドを用いることで、max()のような集約関数を使わずに、簡単に最も大きい値を集約関数を得ることができます。

note: Tag: para
en: What is the length of roads fully contained within each municipality?
ja: 各自治体内に含まれる道路の総延長はいくらでしょう?

note: Tag: para
en: This is an example of a "spatial join", which brings together data from two tables (with a join) using a spatial interaction ("contained") as the join condition (rather than the usual relational approach of joining on a common key):
ja: これは、二つのテーブルからデータを持ち込んで (結合して)いるので「空間結合」の例です。しかし、結合の条件として共通キーの上で接続するという普通のリレーションのやり方でなく空間インタラクション条件 (「含む」)を使っています。

note: Tag: para
en: This query takes a while, because every road in the table is summarized into the final result (about 250K roads for the example table). For smaller datasets (several thousand records on several hundred) the response can be very fast.
ja: このクエリは、テーブル内の全ての道路の合計を最終結果 (この例での話ですが約250Kmの道です)にまとめられるので、少し時間がかかります。より小さいオーバレイ (数百の道路で数千のレコード)の場合、応答はもっと早くなりえます。

note: Tag: para
en: Create a new table with all the roads within the city of Prince George.
ja: プリンスジョージ市内の全ての道路からなるテーブルを作ります。

note: Tag: para
en: This is an example of an "overlay", which takes in two tables and outputs a new table that consists of spatially clipped or cut resultants. Unlike the "spatial join" demonstrated above, this query creates new geometries. An overlay is like a turbo-charged spatial join, and is useful for more exact analysis work:
ja: これは「オーバレイ」の例です。つまり、二つのテーブルを取得して、空間的に切り取られた結果からなる新しいテーブルを出力します。上で示した「空間結合」と違い、このクエリは実際に新しいジオメトリを生成します。生成されたオーバレイはターボのかかった空間結合みたいなもので、より確かな解析作業に便利です。

note: Tag: para
en: What is the length in kilometers of "Douglas St" in Victoria?
ja: ビクトリア州の「ダグラス通り」の長さはkm表記でいくらになるでしょう?

note: Tag: para
en: What is the largest municipality polygon that has a hole?
ja: 穴を持つ自治体ポリゴンのうち最も大きいのはどれでしょう?

note: Tag: title
en: Raster Data Management, Queries, and Applications
ja: ラスタデータの管理、クエリ、アプリケーション

note: Tag: title
en: Loading and Creating Rasters
ja: ラスタのロードと生成

note: Tag: para
en: For most use cases, you will create PostGIS rasters by loading existing raster files using the packaged <varname>raster2pgsql</varname> raster loader.
ja: <varname>raster2pgsql</varname>ラスタローダを使ってPostGISラスタを既存のラスタファイルからロードするのは、最もよく行われます。

note: Tag: title
en: Using raster2pgsql to load rasters
ja: raster2pgsqlを使ってラスタをロードする

note: Tag: para
en: The <varname>raster2pgsql</varname> is a raster loader executable that loads GDAL supported raster formats into SQL suitable for loading into a PostGIS raster table. It is capable of loading folders of raster files as well as creating overviews of rasters.
ja: <varname>raster2pgsql</varname>は、GDALがサポートするラスタ書式をPostGISラスタテーブルにロードするのに適切なSQLにする実行ファイルです。ラスタのオーバビューの生成だけでなく、ラスタファイルのフォルダのロードも可能です。

note: Tag: para
en: Since the raster2pgsql is compiled as part of PostGIS most often (unless you compile your own GDAL library), the raster types supported by the executable will be the same as those compiled in the GDAL dependency library. To get a list of raster types your particular <varname>raster2pgsql</varname> supports use the <varname>-G</varname> switch.
ja: かなり多くの場合、(ご自分のGDALライブラリをコンパイルしない限り) raster2pgsqlはPostGISの一部としてコンパイルされるので、実行ファイルがサポートするラスタタイプはGDALの依存ライブラリでコンパイルされたものと同じになります。お手持ちの<varname>raster2pgsql</varname>がサポートするラスタタイプの一覧は、<varname>-G</varname>スイッチで見ることができます。

note: Tag: para
en: When creating overviews of a specific factor from a set of rasters that are aligned, it is possible for the overviews to not align. Visit <link xlink:href="http://trac.osgeo.org/postgis/ticket/1764">http://trac.osgeo.org/postgis/ticket/1764</link> for an example where the overviews do not align.
ja: 同じアラインメントを持つラスタの集合から特定の要素のオーバビューを生成する時、オーバビューが同じアラインメントを持たないことがあります。オーバビューが同じアラインメントを持たない例については<link xlink:href="http://trac.osgeo.org/postgis/ticket/1764">http://trac.osgeo.org/postgis/ticket/1764</link>をご覧下さい。

note: Tag: title
en: Example Usage
ja: 使用例

note: Tag: para
en: An example session using the loader to create an input file and uploading it chunked in 100x100 tiles might look like this:
ja: ローダを用いて入力ファイルを100x100のタイルで生成して、データベースにアップロードする例は、次の通りです。

note: Tag: para
en: If you do not specify the schema as part of the target table name, the table will be created in the default schema of the database or user you are connecting with.
ja: 対象テーブル名の一部としてスキーマを指定しない場合には、テーブルはデータベースのデフォルトスキーマ内かユーザが接続しているスキーマ内に作られます。

note: Tag: para
en: A conversion and upload can be done all in one step using UNIX pipes:
ja: 変換とアップロードはUNIXのパイプを使うと一回で実行できます。

note: Tag: para
en: Load rasters Massachusetts state plane meters aerial tiles into a schema called <varname>aerial</varname> and create a full view, 2 and 4 level overview tables, use copy mode for inserting (no intermediary file just straight to db), and -e don't force everything in a transaction (good if you want to see data in tables right away without waiting). Break up the rasters into 128x128 pixel tiles and apply raster constraints. Use copy mode instead of table insert. (-F) Include a field called filename to hold the name of the file the tiles were cut from.
ja: マサチューセッツ州平面のメートル単位の空中写真タイルを<varname>aerial</varname>という名前のスキーマにロードします。 元の画像と2, 4レベルのオーバビューのテーブルとを生成します。 データ格納にCOPYを使用し (データベースに仲介ファイルなくまっすぐ入ります)、-eでトランザクションを指定しないようにします (待たずにテーブルのデータを見たい場合には良いです)。ラスタを128x128ピクセルのタイルに分解してラスタ制約を適用します。INSERTモードでなくCOPYモードを使用します。-Fで、カラム名をタイル切り出し元ファイルのファイル名にします。

note: Tag: para
en: The -G commands outputs a list something like
ja: -Gコマンドの出力は次のようになります

note: Tag: title
en: raster2pgsql options
ja: raster2pgsqlオプション

note: Tag: para
en: Display help screen. Help will also display if you don't pass in any arguments.
ja: ヘルプを表示します。引数を全く指定しない場合にも表示されます。

note: Tag: para
en: Print the supported raster formats.
ja: サポートされているラスタ書式を印字します。

note: Tag: para
en: Create new table and populate it with raster(s), <emphasis>this is the default mode</emphasis>
ja: 新しいテーブルを生成し、ラスタを入れます。<emphasis>これがデフォルトモードです</emphasis>。

note: Tag: para
en: Append raster(s) to an existing table.
ja: 既存のテーブルにラスタを追加します。

note: Tag: para
en: Drop table, create new one and populate it with raster(s)
ja: テーブルを削除し、新しいテーブルを生成し、ラスタを入れます。

note: Tag: para
en: Prepare mode, only create the table.
ja: 準備モード、テーブルを作るだけです。

note: Tag: term
en: Raster processing: Applying constraints for proper registering in raster catalogs
ja: ラスタ処理: ラスタカタログに適切に登録するための制約の適用

note: Tag: para
en: Apply raster constraints -- srid, pixelsize etc. to ensure raster is properly registered in <varname>raster_columns</varname> view.
ja: SRIDやピクセルサイズ等のラスタ制約を適用して、<varname>raster_columns</varname>ビューで適切な登録ができるようにします。

note: Tag: para
en: Disable setting the max extent constraint. Only applied if -C flag is also used.
ja: 制約の最大範囲を無効にします。-Cフラグが使われている場合のみ適用されます。

note: Tag: para
en: Set the constraints (spatially unique and coverage tile) for regular blocking. Only applied if -C flag is also used.
ja: 正規ブロック制約 (空間的に一意で網羅タイル)を適用します。-Cフラグが使用されている場合のみ適用されます。

note: Tag: term
en: Raster processing: Optional parameters used to manipulate input raster dataset
ja: ラスタ処理: 入力ラスタデータセットの操作に使われる追加的なパラメータ

note: Tag: para
en: Assign output raster with specified SRID. If not provided or is zero, raster's metadata will be checked to determine an appropriate SRID.
ja: 出力ラスタを指定されたSRIDにします。 指定しないか0を指定した場合、ラスタのメタデータに対して、適切なSRIDを決定するためのチェックを行います。

note: Tag: para
en: Index (1-based) of band to extract from raster. For more than one band index, separate with comma (,). If unspecified, all bands of raster will be extracted.
ja: ラスタから抽出するバンドのインデクス (1始まり)。1より多いバンドを抽出するには、コンマ(,)で区切ります。指定しない場合、全てのバンドが抽出されます。

note: Tag: para
en: Cut raster into tiles to be inserted one per table row. <varname>TILE_SIZE</varname> is expressed as WIDTHxHEIGHT or set to the value "auto" to allow the loader to compute an appropriate tile size using the first raster and applied to all rasters.
ja: 行毎に挿入するラスタを切断します。<varname>TILE_SIZE</varname>は、「幅x高さ」で表現しますが、"auto"を指定すると、最初のラスタを使って適切なタイルサイズが計算され、全てのラスタに適用されます。

note: Tag: para
en: Pad right-most and bottom-most tiles to guarantee that all tiles have the same width and height.
ja: 全てのタイルが同じ幅と高さを持つことを保証するために、右端、下端のタイルに詰め物を施します。

note: Tag: para
en: Register the raster as a filesystem (out-db) raster.
ja: ファイルシステム (データベース外)ラスタとして、ラスタを登録します。

note: Tag: para
en: Only the metadata of the raster and path location to the raster is stored in the database (not the pixels).
ja: データベースには、ラスタのメタデータとラスタのファイルパスのみ格納されます (ピクセルは格納されません)。

note: Tag: para
en: Create overview of the raster. For more than one factor, separate with comma(,). Overview table name follows the pattern o_<varname>overview factor</varname>_<varname>table</varname>, where <varname>overview factor</varname> is a placeholder for numerical overview factor and <varname>table</varname> is replaced with the base table name. Created overview is stored in the database and is not affected by -R. Note that your generated sql file will contain both the main table and overview tables.
ja: ラスタのオーバビューを生成します。一つより多い係数を用いる場合は、コンマ (,) で区切ります。オーバビューのテーブル名はo_<varname>overview factor</varname>_<varname>table</varname>となります。<varname>overview factor</varname>にはオーバビュー係数が入り、<varname>table</varname>には基底テーブル名が入ります。生成されるオーバビューはデータベースに格納され、-Rは無視されます。生成されたSQLファイルは元データのテーブルとオーバビューテーブルの両方を含むことに注意して下さい。

note: Tag: para
en: NODATA value to use on bands without a NODATA value.
ja: NODATA値を持たないバンドで使用するNODATA値を設定します。

note: Tag: term
en: Optional parameters used to manipulate database objects
ja: テータベースオブジェクトの操作に使われる追加的なパラメータ

note: Tag: para
en: Specify name of destination raster column, default is 'rast'
ja: 出力先ラスタカラムの名前を指定します。デフォルトは'rast'です。

note: Tag: para
en: Add a column with the name of the file
ja: ファイル名でカラムを追加します。

note: Tag: para
en: Specify the name of the filename column. Implies -F.
ja: ファイル名カラムの名前を指定します。-Fを暗に含みます。

note: Tag: para
en: Wrap PostgreSQL identifiers in quotes.
ja: PostgreSQL識別子に引用符を付けます。

note: Tag: para
en: Create a GiST index on the raster column.
ja: ラスタカラムにGiSTインデクスを生成します。

note: Tag: para
en: Vacuum analyze the raster table.
ja: ラスタテーブルにvacuum analyzeを行います。

note: Tag: para
en: Keeps empty tiles and skips NODATA value checks for each raster band. Note you save time in checking, but could end up with far more junk rows in your database and those junk rows are not marked as empty tiles.
ja: 空タイルを保持してラスタバンドごとのNODATA値のチェックを省きます。チェック時間を抑えることになりますが、データベース内の不要な行がずっと増えて、これらの行が空タイルとされないことに注意して下さい。

note: Tag: para
en: Specify the tablespace for the new table. Note that indices (including the primary key) will still use the default tablespace unless the -X flag is also used.
ja: 生成されるテーブルのテーブルスペースを指定します。-Xフラグを併用しない場合には、インデクス (主キーを含む)はデフォルトのテーブルスペースを使用することにご注意ください。

note: Tag: para
en: Specify the tablespace for the table's new index. This applies to the primary key and the spatial index if the -I flag is used.
ja: テーブルの新しいインデクスに使うテーブル空間を指定します。主キーに適用され、-Iフラグがある場合においては空間インデクスにも適用されます。

note: Tag: para
en: Use copy statements instead of insert statements. Optionally specify <varname>max_rows_per_copy</varname>; default 50 when not specified.
ja: COPYステートメントを使い、INSERTを使いません。任意で<varname>max_rows_per_copy</varname>を指定します。指定しない場合のデフォルト値は50です。

note: Tag: para
en: Execute each statement individually, do not use a transaction.
ja: ステートメント毎に実行して、トランザクションを使用しないようにします。

note: Tag: para
en: Control endianness of generated binary output of raster; specify 0 for XDR and 1 for NDR (default); only NDR output is supported now
ja: 生成されるラスタのバイナリ出力のエンディアンを制御します。XDR (訳注: ビッグエンディアン)の場合は0を、NDR (訳注:リトルエンディアン)の場合は1を、それぞれ指定します。デフォルトは1です。現時点ではNDR出力のみサポートします。

note: Tag: para
en: Specify version of output format. Default is 0. Only 0 is supported at this time.
ja: 出力書式の版を指定します。デフォルトは0です。現時点では0のみサポートします。

note: Tag: title
en: Creating rasters using PostGIS raster functions
ja: PostGISラスタ関数を用いたラスタの生成

note: Tag: para
en: On many occasions, you'll want to create rasters and raster tables right in the database. There are a plethora of functions to do that. The general steps to follow.
ja: データベース内でラスタやラスタテーブルを生成したい場合が多くあります。これを行うための関数が多数あります。一般的な手順は次の通りです。

note: Tag: para
en: Create a table with a raster column to hold the new raster records which can be accomplished with:
ja: 新しいラスタ行を保持するためのラスタカラムを持つテーブルを生成します:

note: Tag: para
en: There are many functions to help with that goal. If you are creating rasters not as a derivative of other rasters, you will want to start with: <xref linkend="RT_ST_MakeEmptyRaster"/>, followed by <xref linkend="RT_ST_AddBand"/>
ja: この目標で助けとなる関数は多数あります。他のラスタの派生でないラスタを生成する場合、<xref linkend="RT_ST_MakeEmptyRaster"/>と<xref linkend="RT_ST_AddBand"/>を順次実行して作業を開始します

note: Tag: para
en: You can also create rasters from geometries. To achieve that you'll want to use <xref linkend="RT_ST_AsRaster"/> perhaps accompanied with other functions such as <xref linkend="RT_ST_Union"/> or <xref linkend="RT_ST_MapAlgebraFct2"/> or any of the family of other map algebra functions.
ja: ジオメトリからラスタを生成することもできます。<xref linkend="RT_ST_AsRaster"/>を使います。<xref linkend="RT_ST_Union"/>や<xref linkend="RT_ST_MapAlgebraFct2"/>や、地図解析関数群等といった、他の関数を組み合わせる場合もあります。

note: Tag: para
en: There are even many more options for creating new raster tables from existing tables. For example you can create a raster table in a different projection from an existing one using <xref linkend="RT_ST_Transform"/>
ja: 既存テーブルから新しいラスタテーブルを生成するための多数の選択肢があります。たとえば、<xref linkend="RT_ST_Transform"/>を使って、既存テーブルから異なる投影法のラスタテーブルを生成します

note: Tag: para
en: Once you are done populating your table initially, you'll want to create a spatial index on the raster column with something like:
ja: はじめにテーブルにデータを入れたら、ラスタカラムに空間インデクスを生成したくなるでしょう:

note: Tag: para
en: Note the use of <xref linkend="RT_ST_ConvexHull"/> since most raster operators are based on the convex hull of the rasters.
ja: <xref linkend="RT_ST_ConvexHull"/>を使用していることに注意して下さい。多くのラスタ演算子はラスタの凸包を元にしています。

note: Tag: para
en: Pre-2.0 versions of PostGIS raster were based on the envelop rather than the convex hull. For the spatial indexes to work properly you'll need to drop those and replace with convex hull based index.
ja: 2.0より前の PostGIS ラスタは、エンベロープを基本にして、凸包ではありませんでした。空間インデクスを適切に働かせるには、エンベロープを基本にしたインデクスを削除して、凸包を元にしたインデクスに置き換えます。

note: Tag: para
en: Apply raster constraints using <xref linkend="RT_AddRasterConstraints"/>
ja: <xref linkend="RT_AddRasterConstraints"/>を用いてラスタ制約を適用します

note: Tag: title
en: Using "out db" cloud rasters
ja: 「データベース外」クラウドラスタの使用

note: Tag: para
en: The <varname>raster2pgsql</varname> tool uses GDAL to access raster data, and can take advantage of a key GDAL feature: the ability to read from rasters that are <link xlink:href="https://gdal.org/user/virtual_file_systems.html#network-based-file-systems">stored remotely</link> in cloud "object stores" (e.g. AWS S3, Google Cloud Storage).
ja: <varname>raster2pgsql</varname>ツールはGDALを使用してラスタデータにアクセスします。また、クラウドの「オブジェクト保存」 (AWS S3やGoogle Cloud Storage等)に<link xlink:href="https://gdal.org/user/virtual_file_systems.html#network-based-file-systems">リモート格納</link>されたラスタを読む能力という、重要なGDAL機能の利点を享受することができます。

note: Tag: para
en: Efficient use of cloud stored rasters requires the use of a "cloud optimized" format. The most well-known and widely used is the "<link xlink:href="https://gdal.org/drivers/raster/cog.html">cloud optimized GeoTIFF</link>" format. Using a non-cloud format, like a JPEG, or an un-tiled TIFF will result in very poor performance, as the system will have to download the entire raster each time it needs to access a subset.
ja: クラウドストレージの効率的な仕様には、「クラウド最適化」された書式の使用が必要です。最も知られて幅広く使われているものは、 "<link xlink:href="https://gdal.org/drivers/raster/cog.html">cloud optimized GeoTIFF</link>"です。JPEGや非タイル化TIFFなどの非クラウド書式を使うと、発揮される能力は非常に貧弱になります。システムがラスタの一部分にアクセスする必要に迫られるたびに全体をダウンロードするためです。

note: Tag: para
en: First, load your raster into the cloud storage of your choice. Once it is loaded, you will have a URI to access it with, either an "http" URI, or sometimes a URI specific to the service. (e.g., "s3://bucket/object"). To access non-public buckets, you will need to supply GDAL config options to authenticate your connection. Note that this command is <emphasis>reading</emphasis> from the cloud raster and <emphasis>writing</emphasis> to the database.
ja: まず、ラスタをあなたが選択したクラウドストレージに保存します。保存したら、アクセスに使うURIが得られます。"http"URIか、時々特別なサービスを示すURI ( "s3://bucket/object"等)です。非公開バケットにアクセスするには、接続認証のためのGDALコンフィギュレーションオプションが必要になります。このコマンドはクラウドラスタから<emphasis>読み</emphasis>、データベースに<emphasis>書き</emphasis>ます。

note: Tag: para
en: Once the table is loaded, you need to give the database permission to read from remote rasters, by setting two permissions, <xref linkend="postgis_enable_outdb_rasters"/> and <xref linkend="postgis_gdal_enabled_drivers"/>.
ja: テーブルがロードされたら、データベースにリモートラスタらか読むためのアクセス許可を与えます。<xref linkend="postgis_enable_outdb_rasters"/>と<xref linkend="postgis_gdal_enabled_drivers"/>の、二つのアクセス許可を設定します。

note: Tag: para
en: To make the changes sticky, set them directly on your database. You will need to re-connect to experience the new settings.
ja: 確実に変更するには、データベースに直接設定します。新しい設定を使うには再接続が必要です。

note: Tag: para
en: For non-public rasters, you may have to provide access keys to read from the cloud rasters. The same keys you used to write the <varname>raster2pgsql</varname> call can be set for use inside the database, with the <xref linkend="postgis_gdal_vsi_options"/> configuration. Note that multiple options can be set by space-separating the <varname>key=value</varname> pairs.
ja: 非公開ラスタの場合、クラウドラスタから読み取るアクセスキーを与えなければならない場合があります。<varname>raster2pgsql</varname>の書き込みに使用したのと同じキーを、データベース内で<xref linkend="postgis_gdal_vsi_options"/>設定と共に使用するように設定できます。<varname>key=value</varname>ペアをスペースで区切ることで、複数のオプションを設定できることに注意してください。

note: Tag: para
en: Once you have the data loaded and permissions set you can interact with the raster table like any other raster table, using the same functions. The database will handle all the mechanics of connecting to the cloud data when it needs to read pixel data.
ja: データをロードし、パーミッションが設定されると、ラスタテーブルは他のラスタテーブルとおなじように、同じ関数を使って、対話的処理が可能となります。データベースは、ピクセルデータの読み取りが必要なら、クラウドへの接続の全てを扱います。

note: Tag: title
en: Raster Catalogs
ja: ラスタカタログ

note: Tag: para
en: There are two raster catalog views that come packaged with PostGIS. Both views utilize information embedded in the constraints of the raster tables. As a result the catalog views are always consistent with the raster data in the tables since the constraints are enforced.
ja: PostGISが生成する、二つのラスタカタログのビューがあります。両方ともラスタテーブルの制約の中に埋め込まれる情報を用いています。結果として、カタログビューは、テーブル内のラスタデータに制約が働くため、常にラスタデータとの矛盾がありません。

note: Tag: para
en: <varname>raster_columns</varname> this view catalogs all the raster table columns in your database.
ja: <varname>raster_columns</varname> ラスタタイプのデータベースにおける全てのラスタテーブルカラムのカタログです。

note: Tag: para
en: <varname>raster_overviews</varname> this view catalogs all the raster table columns in your database that serve as overviews for a finer grained table. Tables of this type are generated when you use the <varname>-l</varname> switch during load.
ja: <varname>raster_overviews</varname> データベース内の、より詳細なテーブルのためのオーバビューを提供するラスタテーブルのカラム全てのカタログです。この種のテーブルは、ロード時に<varname>-l</varname>を指定した時に生成されます。

note: Tag: title
en: Raster Columns Catalog
ja: ラスタカラムカタログ

note: Tag: para
en: The <varname>raster_columns</varname> is a catalog of all raster table columns in your database that are of type raster. It is a view utilizing the constraints on the tables so the information is always consistent even if you restore one raster table from a backup of another database. The following columns exist in the <varname>raster_columns</varname> catalog.
ja: <varname>raster_columns</varname>は、ラスタタイプのデータベースにおける全てのラスタテーブルカラムのカタログです。テーブルの制約を使ったビューなので、他のデータベースのバックアップからラスタテーブルをリストアしたとしても、情報は常に矛盾がありません。<varname>raster_columns</varname>カタログには次のカラムがあります。

note: Tag: para
en: If you created your tables not with the loader or forgot to specify the <varname>-C</varname> flag during load, you can enforce the constraints after the fact using <xref linkend="RT_AddRasterConstraints"/> so that the <varname>raster_columns</varname> catalog registers the common information about your raster tiles.
ja: ローダを使わずにテーブルを生成したり、ロード時に<varname>-C</varname> フラグを忘れたりした場合には、事後に<xref linkend="RT_AddRasterConstraints"/>で制約を強制でき、<varname>raster_columns</varname>カタログは、ラスタタイルの共通の情報を登録します。

note: Tag: para
en: <varname>r_table_catalog</varname> The database the table is in. This will always read the current database.
ja: <varname>r_table_catalog</varname> テーブルが存在するデータベースです。これは常に現在のデータベースを読みます。

note: Tag: para
en: <varname>r_table_schema</varname> The database schema the raster table belongs to.
ja: <varname>r_table_schema</varname> ラスタテーブルが属するデータベーススキーマです。

note: Tag: para
en: <varname>r_table_name</varname> raster table
ja: <varname>r_table_name</varname> ラスタテーブルです。

note: Tag: para
en: <varname>r_raster_column</varname> the column in the <varname>r_table_name</varname> table that is of type raster. There is nothing in PostGIS preventing you from having multiple raster columns per table so its possible to have a raster table listed multiple times with a different raster column for each.
ja: <varname>r_raster_column</varname> ラスタタイプである<varname>r_table_name</varname>テーブルのカラムです。PostGISには、一つのテーブルに複数のラスタカラムを持つことを妨げません。異なるラスタカラムを持つラスタテーブルが、ラスタカラム毎に複数回出現するテーブルを持つことができます。

note: Tag: para
en: <varname>srid</varname> The spatial reference identifier of the raster. Should be an entry in the <xref linkend="spatial_ref_sys"/>.
ja: <varname>srid</varname> ラスタの空間参照系識別番号です。<xref linkend="spatial_ref_sys"/>にあるエントリであるべきです。

note: Tag: para
en: <varname>scale_x</varname> The scaling between geometric spatial coordinates and pixel. This is only available if all tiles in the raster column have the same <varname>scale_x</varname> and this constraint is applied. Refer to <xref linkend="RT_ST_ScaleX"/> for more details.
ja: <varname>scale_x</varname> 地理空間座標とピクセルの間の拡大縮小係数です。これは、ラスタカラムのすべてのタイルが同じ<varname>scale_x</varname>を持ち、制約が適用されている場合のみ出現します。詳細情報については<xref linkend="RT_ST_ScaleX"/>を参照してください。

note: Tag: para
en: <varname>scale_y</varname> The scaling between geometric spatial coordinates and pixel. This is only available if all tiles in the raster column have the same <varname>scale_y</varname> and the <varname>scale_y</varname> constraint is applied. Refer to <xref linkend="RT_ST_ScaleY"/> for more details.
ja: <varname>scale_y</varname> 地理空間座標とピクセルの間の拡大縮小係数です。これは、ラスタカラムのすべてのタイルが同じ<varname>scale_y</varname>を持ち、<varname>scale_y</varname>の制約が適用されている場合のみ出現します。詳細情報については<xref linkend="RT_ST_ScaleY"/>を参照してください。

note: Tag: para
en: <varname>blocksize_x</varname> The width (number of pixels across) of each raster tile . Refer to <xref linkend="RT_ST_Width"/> for more details.
ja: <varname>blocksize_x</varname> ラスタタイルごとの幅 (横方向のピクセル数)です。詳細情報については<xref linkend="RT_ST_Width"/>を参照してください。

note: Tag: para
en: <varname>blocksize_y</varname> The width (number of pixels down) of each raster tile . Refer to <xref linkend="RT_ST_Height"/> for more details.
ja: <varname>blocksize_y</varname> ラスタタイルごとの高さ (縦方向のピクセル数)です。詳細情報については<xref linkend="RT_ST_Height" />を参照してください。

note: Tag: para
en: <varname>same_alignment</varname> A boolean that is true if all the raster tiles have the same alignment . Refer to <xref linkend="RT_ST_SameAlignment"/> for more details.
ja: <varname>same_alignment</varname> 全てのラスタタイルが同じアラインメントを持っているかを示す真偽値です。詳細情報については<xref linkend="RT_ST_SameAlignment"/>を参照してください。

note: Tag: para
en: <varname>regular_blocking</varname> If the raster column has the spatially unique and coverage tile constraints, the value with be TRUE. Otherwise, it will be FALSE.
ja: <varname>regular_blocking</varname> ラスタカラムが空間的に一意かつカバレッジタイルの制約を持つなら、TRUEとなります。その他の場合はFALSEになります。。

note: Tag: para
en: <varname>num_bands</varname> The number of bands in each tile of your raster set. This is the same information as what is provided by
ja: <varname>num_bands</varname> ラスタ集合のタイルごとのバンド数。これと同じ情報が得られる関数は

note: Tag: para
en: <varname>pixel_types</varname> An array defining the pixel type for each band. You will have the same number of elements in this array as you have number of bands. The pixel_types are one of the following defined in <xref linkend="RT_ST_BandPixelType"/>.
ja: <varname>pixel_types</varname> バンドごとのピクセルタイプを定義する配列です。この配列の要素数はバンド数と同じです。pixel_typesは、<xref linkend="RT_ST_BandPixelType"/>で定義されるピクセルタイプの一つを取ります。

note: Tag: para
en: <varname>nodata_values</varname> An array of double precision numbers denoting the <varname>nodata_value</varname> for each band. You will have the same number of elements in this array as you have number of bands. These numbers define the pixel value for each band that should be ignored for most operations. This is similar information provided by <xref linkend="RT_ST_BandNoDataValue"/>.
ja: <varname>nodata_values</varname> バンド毎の<varname>nodata_value</varname>を示す倍精度浮動小数点数の配列です。バンド数と同じ配列数となります。これらの値は、バンド毎のほとんどの処理で無視されるべきピクセル値の定義です。これは<xref linkend="RT_ST_BandNoDataValue"/>で得られる情報と似ています。

note: Tag: para
en: <varname>out_db</varname> An array of boolean flags indicating if the raster bands data is maintained outside the database. You will have the same number of elements in this array as you have number of bands.
ja: <varname>out_db</varname> ラスタバンドデータがデータベース外で維持されているかを示す真偽値の配列です。この配列の添え字はバンド番号と同じです。

note: Tag: para
en: <varname>extent</varname> This is the extent of all the raster rows in your raster set. If you plan to load more data that will change the extent of the set, you'll want to run the <xref linkend="RT_DropRasterConstraints"/> function before load and then reapply constraints with <xref linkend="RT_AddRasterConstraints"/> after load.
ja: <varname>extent</varname> ラスタ集合における全てのラスタ行の範囲です。集合の範囲を変更するデータを別途ロードする予定である場合、ロード前に<xref linkend="RT_DropRasterConstraints"/>関数を実行して、ロード後に<xref linkend="RT_AddRasterConstraints"/>で制約を再適用します。

note: Tag: para
en: <varname>spatial_index</varname> A boolean that is true if raster column has a spatial index.
ja: <varname>spatial_index</varname> 空間インデクスを持っているかどうかを示す真偽値です。

note: Tag: title
en: Raster Overviews
ja: ラスタオーバビュー

note: Tag: para
en: <varname>raster_overviews</varname> catalogs information about raster table columns used for overviews and additional information about them that is useful to know when utilizing overviews. Overview tables are cataloged in both <varname>raster_columns</varname> and <varname>raster_overviews</varname> because they are rasters in their own right but also serve an additional special purpose of being a lower resolution caricature of a higher resolution table. These are generated along-side the main raster table when you use the <varname>-l</varname> switch in raster loading or can be generated manually using <xref linkend="RT_AddOverviewConstraints"/>.
ja: <varname>raster_overviews</varname>は、オーバビューで使われるラスタテーブルカラムに関する情報のカタログで、オーバビューを用いる際に知っておくと便利な情報も持ちます。オーバビューテーブルは<varname>raster_columns</varname>と<varname>raster_overviews</varname>の両方のカタログに入れられます。オーバビューもラスタの一つであるのは確かですが、より高い解像度テーブルの解像度を落としたカリカチュアになるという特殊な目的を満たすためでもあるからです。ラスタをロードする際に<varname>-l</varname>スイッチを使うと、オーバビューが主ラスタテーブルと一緒に生成されます。もしくは、<xref linkend="RT_AddOverviewConstraints"/>を使うと手動で生成できます。

note: Tag: para
en: Overview tables contain the same constraints as other raster tables as well as additional informational only constraints specific to overviews.
ja: オーバビューテーブルには、他のラスタテーブルと同じ制約と、オーバビュー特有の制約となる追加情報があります。

note: Tag: para
en: The information in <varname>raster_overviews</varname> does not duplicate the information in <varname>raster_columns</varname>. If you need the information about an overview table present in <varname>raster_columns</varname> you can join the <varname>raster_overviews</varname> and <varname>raster_columns</varname> together to get the full set of information you need.
ja: <varname>raster_overviews</varname>の情報は<varname>raster_columns</varname>とは重複しません。<varname>raster_columns</varname>にあるオーバビューテーブルに関する情報が必要な場合は、<varname>raster_overviews</varname>と<varname>raster_columns</varname>とを結合すると、必要な情報の集合を完全に取得することができます。

note: Tag: para
en: Two main reasons for overviews are:
ja: オーバビューの主たる理由は次の二つです。

note: Tag: para
en: Low resolution representation of the core tables commonly used for fast mapping zoom-out.
ja: ズームアウトした際の地図表示を早くするために、元のテーブルの低解像度表現が一般的に使われます。

note: Tag: para
en: Computations are generally faster to do on them than their higher resolution parents because there are fewer records and each pixel covers more territory. Though the computations are not as accurate as the high-res tables they support, they can be sufficient in many rule-of-thumb computations.
ja: レコード数が少なく、ピクセル毎の適用範囲が広いため、高解像度の元テーブルより計算が一般的に早くなります。計算は高解像度テーブルより精度は落ちますが、大まかな計算には十分でありえます。

note: Tag: para
en: The <varname>raster_overviews</varname> catalog contains the following columns of information.
ja: <varname>raster_overviews</varname>カタログには、次の情報のカラムがあります。

note: Tag: para
en: <varname>o_table_catalog</varname> The database the overview table is in. This will always read the current database.
ja: <varname>o_table_catalog</varname> オーバビューテーブルが存在するデータベースです。常に現在のデータベースを読みます。

note: Tag: para
en: <varname>o_table_schema</varname> The database schema the overview raster table belongs to.
ja: <varname>o_table_schema</varname> オーバビューラスタテーブルが属するデータベーススキーマです。

note: Tag: para
en: <varname>o_table_name</varname> raster overview table name
ja: <varname>o_table_name</varname> ラスタオーバビューテーブル名です。

note: Tag: para
en: <varname>o_raster_column</varname> the raster column in the overview table.
ja: <varname>o_raster_column</varname> オーバビューテーブル内のラスタカラムです。

note: Tag: para
en: <varname>r_table_catalog</varname> The database the raster table that this overview services is in. This will always read the current database.
ja: <varname>r_table_catalog</varname> このオーバビューの元となるラスタテーブルのデータベースです。常に現在のデータベースを読みます。

note: Tag: para
en: <varname>r_table_schema</varname> The database schema the raster table that this overview services belongs to.
ja: <varname>r_table_schema</varname> このオーバビューの元となるラスタテーブルが属するデータベーススキーマです。

note: Tag: para
en: <varname>r_table_name</varname> raster table that this overview services.
ja: <varname>r_table_name</varname> このオーバビューの元となるラスタテーブルです。

note: Tag: para
en: <varname>r_raster_column</varname> the raster column that this overview column services.
ja: <varname>r_raster_column</varname> このオーバビューの元となるラスタカラムです。

note: Tag: para
en: <varname>overview_factor</varname> - this is the pyramid level of the overview table. The higher the number the lower the resolution of the table. raster2pgsql if given a folder of images, will compute overview of each image file and load separately. Level 1 is assumed and always the original file. Level 2 is will have each tile represent 4 of the original. So for example if you have a folder of 5000x5000 pixel image files that you chose to chunk 125x125, for each image file your base table will have (5000*5000)/(125*125) records = 1600, your (l=2) <varname>o_2</varname> table will have ceiling(1600/Power(2,2)) = 400 rows, your (l=3) <varname>o_3</varname> will have ceiling(1600/Power(2,3) ) = 200 rows. If your pixels aren't divisible by the size of your tiles, you'll get some scrap tiles (tiles not completely filled). Note that each overview tile generated by raster2pgsql has the same number of pixels as its parent, but is of a lower resolution where each pixel of it represents (Power(2,overview_factor) pixels of the original).
ja: <varname>overview_factor</varname> - オーバビューテーブルのピラミッドレベルです。高い数字ほど解像度が低くなります。raster2pgsqlは、画像のフォルダを渡された場合は、分割して、イメージファイルのオーバビューの計算とロードを行います。レベル1は元ファイルと同じです。レベル2は、元ファイルの4分の1になります。たとえば、5000x5000ピクセルの画像ファイルのフォルダがあるとして、125x125に分ける場合、画像ファイルごとに(5000*5000)/(125*125) = 1600行のレコードを持ち、<varname>o_2</varname>テーブル (レベル2)はceiling(1600/Power(2,2)) = 400行、<varname>o_3</varname>(レベル3)ではceiling(1600/Power(2,3) ) = 200行のレコードを持ちます。ピクセルがタイルサイズで割り切れない場合、スクラップタイル (完全には値が入っていない)が得られます。raster2pgsqlによって生成される個々のオーバビュータイルは、元となるラスタと同じピクセル数を持ち、個々のピクセルの表現範囲 (オリジナルの Power(2,overview_factor)ピクセル分)が低い解像度になっている点に注意して下さい。

note: Tag: title
en: Building Custom Applications with PostGIS Raster
ja: PostGISラスタを使ったカスタムアプリケーションの構築

note: Tag: para
en: The fact that PostGIS raster provides you with SQL functions to render rasters in known image formats gives you a lot of options for rendering them. For example you can use OpenOffice / LibreOffice for rendering as demonstrated in <link xlink:href="http://www.postgresonline.com/journal/archives/244-Rendering-PostGIS-Raster-graphics-with-LibreOffice-Base-Reports.html">Rendering PostGIS Raster graphics with LibreOffice Base Reports</link>. In addition you can use a wide variety of languages as demonstrated in this section.
ja: PostGISラスタに知られている画像書式でラスタをレンダリングするためのSQL関数があります。このことから多数のレンダリングの選択肢が使えます。たとえば、OpenOffice/LibreOfficeを使ってレンダリングが可能で、<link xlink:href="http://www.postgresonline.com/journal/archives/244-Rendering-PostGIS-Raster-graphics-with-LibreOffice-Base-Reports.html">Rendering PostGIS Raster graphics with LibreOffice Base Reports</link>にデモンストレーションがあります。さらに、本節で示す通り、多種多様な言語を使用できます。

note: Tag: title
en: PHP Example Outputting using ST_AsPNG in concert with other raster functions
ja: ST_AsPNG を他の関数とあわせて使った PHP 出力例

note: Tag: para
en: In this section, we'll demonstrate how to use the PHP PostgreSQL driver and the <xref linkend="RT_ST_AsGDALRaster"/> family of functions to output band 1,2,3 of a raster to a PHP request stream that can then be embedded in an img src html tag.
ja: 本節では、PHPのPostgreSQLドライバと<xref linkend="RT_ST_AsGDALRaster"/>等の関数を使って、HTML imgタグに埋め込むことができるPHPリクエストストリームにラスタの1、2、3バンドを出力する方法を示します。

note: Tag: para
en: The sample query demonstrates how to combine a whole bunch of raster functions together to grab all tiles that intersect a particular wgs 84 bounding box and then unions with <xref linkend="RT_ST_Union"/> the intersecting tiles together returning all bands, transforms to user specified projection using <xref linkend="RT_ST_Transform"/>, and then outputs the results as a png using <xref linkend="RT_ST_AsPNG"/>.
ja: サンプルクエリでは、 指定したWGS84バウンディングボックスにインタセクトするタイルを取って、 <xref linkend="RT_ST_Union"/>でインタセクトしたタイルを結合して全てのバンドを返し、<xref linkend="RT_ST_Transform"/>でユーザ指定投影法に変換し、<xref linkend="RT_ST_AsPNG"/>を使ってPNGで結果を出力するためのラスタ関数群全体をまとめる方法を示します。

note: Tag: para
en: You would call the below using <programlisting>http://mywebserver/test_raster.php?srid=2249</programlisting> to get the raster image in Massachusetts state plane feet.
ja: 次で示すスクリプトは、<programlisting>http://mywebserver/test_raster.php?srid=2249</programlisting>で、マサチューセッツ州平面 (フィート単位)のラスタ画像を取得するものです。

note: Tag: title
en: ASP.NET C# Example Outputting using ST_AsPNG in concert with other raster functions
ja: ST_AsPNGを他の関数とあわせて使ったASP.NET C#出力例

note: Tag: para
en: In this section, we'll demonstrate how to use Npgsql PostgreSQL .NET driver and the <xref linkend="RT_ST_AsGDALRaster"/> family of functions to output band 1,2,3 of a raster to a PHP request stream that can then be embedded in an img src html tag.
ja: 本節では、Npgsql PostgreSQL .NETドライバと<xref linkend="RT_ST_AsGDALRaster"/>等の関数を使って、HTML imgタグに埋め込むことができるように、ラスタの1、2、3バンドを出力する方法を示します。

note: Tag: para
en: You will need the npgsql .NET PostgreSQL driver for this exercise which you can get the latest of from <link xlink:href="http://npgsql.projects.postgresql.org/">http://npgsql.projects.postgresql.org/</link>. Just download the latest and drop into your ASP.NET bin folder and you'll be good to go.
ja: この例ではNpgsql .NET PostgreSQLドライバが必要です。最新版は<link xlink:href="http://npgsql.projects.postgresql.org/">http://npgsql.projects.postgresql.org/</link>にあります。最新版をダウンロードして、ASP.NET の binフォルダに入れるだけでうまくいきます。

note: Tag: para
en: This is same example as <xref linkend="RT_PHP_Output"/> except implemented in C#.
ja: この例はC#で実装している点を除いては<xref linkend="RT_PHP_Output"/>と同じです。

note: Tag: para
en: You would call the below using <programlisting>http://mywebserver/TestRaster.ashx?srid=2249</programlisting> to get the raster image in Massachusetts state plane feet.
ja: 次で示すスクリプトは、<programlisting>http://mywebserver/TestRaster.ashx?srid=2249</programlisting>で、マサチューセッツ州平面 (フィート単位)のラスタ画像を取得します。

note: Tag: title
en: Java console app that outputs raster query as Image file
ja: rasterクエリを画像ファイルで出力するJavaコンソールアプリケーション

note: Tag: para
en: This is a simple java console app that takes a query that returns one image and outputs to specified file.
ja: これは、一つの画像を返すクエリを取り、指定したファイルに出力する、簡単なJavaコンソールアプリケーションです。

note: Tag: para
en: You can download the latest PostgreSQL JDBC drivers from <link xlink:href="http://jdbc.postgresql.org/download.html">http://jdbc.postgresql.org/download.html</link>
ja: 最新のPostgreSQL JDBCドライバは<link xlink:href="http://jdbc.postgresql.org/download.html">http://jdbc.postgresql.org/download.html</link>からダウンロードできます。

note: Tag: para
en: You can compile the following code using a command something like:
ja: あとで示すコードをコンパイルします。コマンドは次の通りです。

note: Tag: para
en: And call it from the command-line with something like
ja: 次のようにコマンドラインから呼び出します。

note: Tag: title
en: Use PLPython to dump out images via SQL
ja: PLPython を使って SQL を介して画像をダンプする

note: Tag: para
en: This is a plpython stored function that creates a file in the server directory for each record. Requires you have plpython installed. Should work fine with both plpythonu and plpython3u.
ja: これは、サーバディレクトリ内でレコードごとにファイルを生成するPythonストアド関数です。plpythonが必要です。plpythonuとplpython3uの両方が正しく動作します。

note: Tag: title
en: Outputting Rasters with PSQL
ja: PSQLでラスタを出力する

note: Tag: para
en: Sadly PSQL doesn't have easy to use built-in functionality for outputting binaries. This is a bit of a hack that piggy backs on PostgreSQL somewhat legacy large object support. To use first launch your psql commandline connected to your database.
ja: PSQLから組み込み機能を用いてバイナリを出力するのは簡単ではありません。ここで紹介する方法は、レガシーなラージオブジェクトをサポートするPostgreSQL上に乗っかる、ちょっとしたハックです。まずは、psqlを起動して、データベースに接続します。

note: Tag: para
en: Unlike the python approach, this approach creates the file on your local computer.
ja: この方法はPythonの場合と違い、ローカル機にファイルが生成されます。

note: Tag: title
en: PostGIS Functions new or enhanced in %
ja: PostGIS % で新規作成/機能強化された関数

note: Tag: para
en: The functions given below are PostGIS functions that were added or enhanced.
ja: 次に示す関数は、新規作成または機能強化されたPostGIS関数です。

note: Tag: para
en: Functions new in PostGIS %
ja: PostGIS % で新規作成された関数

note: Tag: para
en: Functions enhanced in PostGIS %
ja: PostGIS % で機能強化された関数

note: Tag: para
en: Functions changed in PostGIS %
ja: PostGIS % で変更された関数

note: Tag: para
en: This method needs address_standardizer extension.
ja: このメソッドはaddress_standardizerエクステンションが必要です。

note: Tag: para
en: This method supports Circular Strings and Curves.
ja: このメソッドは曲線ストリングと曲線に対応しています。

note: Tag: para
en: For geography this is a thin wrapper around the geometry implementation.
ja: この関数のジオグラフィ版はジオメトリ実装にかぶせた薄いラッパです。

note: Tag: para
en: This function automatically includes a bounding box comparison that makes use of any spatial indexes that are available on the geometries.
ja: この関数の呼び出しによって、ジオメトリで使用可能なインデックスを使用するバウンディングボックスの比較が自動的に行われます。

note: Tag: para
en: This function supports M coordinates.
ja: この関数はM値に対応します。

note: Tag: para
en: This function supports Polyhedral surfaces.
ja: この関数は多面体サーフェスに対応しています。

note: Tag: para
en: This method is also provided by SFCGAL backend.
ja: このメソッドはSFCGALバックエンドでも提供されます。

note: Tag: para
en: This method needs SFCGAL backend.
ja: このメソッドにはSFCGALバックエンドが必要です。

note: Tag: para
en: This method implements the <link xlink:href="http://www.opengeospatial.org/standards/sfs">OGC Simple Features Implementation Specification for SQL 1.1.</link>
ja: このメソッドは<link xlink:href="http://www.opengeospatial.org/standards/sfs">OGC Simple Features Implementation Specification for SQL 1.1</link>の実装です。

note: Tag: para
en: This method implements the SQL/MM specification.
ja: このメソッドはSQL/MM仕様の実装です。

note: Tag: para
en: This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
ja: この関数は三角形と不規則三角網 (TIN)に対応しています。

note: Tag: para
en: This function supports 3d and will not drop the z-index.
ja: この関数は3次元に対応し、Z値を削除しません。

note: Tag: para
en: New in this release
ja: このリリースの新機能

note: Tag: para
en: Enhanced in this release
ja: このリリースで強化

note: Tag: para
en: Aggregate
ja: 集約関数

note: Tag: para
en: Window function
ja: ウィンドウ関数

note: Tag: para
en: Requires GEOS (3.9,3.10,3.11,3.12) or higher
ja: GEOS (3.9,3.10,3.11,3.12) 以上

note: Tag: para
en: Requires SFCGAL 1.5 or higher
ja: SFCGAL 1.5以上が必要

note: Tag: para
en: 2.5/3D support
ja: 2.5次元/3次元対応

note: Tag: para
en: Supports geography
ja: ジオグラフィ対応
