PostGIS - en to ja translation catalogue (176 entries)

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 <ulink url="https://trac.osgeo.org/postgis/wiki/UsersWikiInstall">PostGIS User contributed compile guides</ulink> and <ulink url="http://trac.osgeo.org/postgis/wiki/DevWikiMain">PostGIS Dev Wiki</ulink>.
ja: 本節では、一般的なコンパイル手順を示します。Windows用や他のOS用等にコンパイルするなら、<ulink url="https://trac.osgeo.org/postgis/wiki/UsersWikiInstall">PostGIS User contributed compile guides</ulink>や<ulink url="http://trac.osgeo.org/postgis/wiki/DevWikiMain">PostGIS Dev Wiki</ulink>で、より詳細な助けが見つかるかも知れません。

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

note: Tag: para
en: If you are a windows user, you can get stable builds via Stackbuilder or <ulink url="https://postgis.net/windows_downloads">PostGIS Windows download site</ulink> We also have <ulink url="https://postgis.net/windows_downloads">very bleeding-edge windows experimental builds</ulink> 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ユーザの場合は、スタックビルダか、<ulink url="http://www.postgis.org/download/windows/">PostGIS Windows download site</ulink>から安定版を得ることができます。また、週に1回か2回のビルドと刺激的なことがあった時の随時ビルドとを行っている<ulink url="https://postgis.net/windows_downloads">very bleeding-edge windows experimental builds</ulink>もあります。これらは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. <ulink url="https://www.postgresql.org"> https://www.postgresql.org </ulink> .
ja: PostgreSQLをインストールしていないならPostgreSQLインストールガイドを参照して下さい。<ulink url="http://www.postgresql.org/">http://www.postgresql.org/</ulink>にあります。

note: Tag: para
en: For GEOS functionality, when you install PostgresSQL 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 <ulink url="&postgis_download_url;"> &postgis_download_url; </ulink>
ja: ダウンロードサイト<ulink url="&postgis_download_url;"> &postgis_download_url; </ulink>からソースのアーカイブを入手します。

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 <ulink url="https://git-scm.com/"> git </ulink> repository <ulink url="https://git.osgeo.org/gitea/postgis/postgis/"> https://git.osgeo.org/gitea/postgis/postgis/ </ulink> .
ja: もしくは <ulink url="https://git-scm.com/"> git </ulink>レポジトリ<ulink url="https://git.osgeo.org/gitea/postgis/postgis/"> https://git.osgeo.org/gitea/postgis/postgis/ </ulink>からチェックアウトします。

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 <ulink url="https://www.postgresql.org"> https://www.postgresql.org </ulink> .
ja: PostgreSQL &min_postgres_version; - &max_postgres_version;。PostgreSQLの完全なインストール (サーバヘッダを含む)が必要です。PostgreSQLは<ulink url="http://www.postgresql.org/"> http://www.postgresql.org/</ulink>にあります。

note: Tag: para
en: For a full PostgreSQL / PostGIS support matrix and PostGIS/GEOS support matrix refer to <ulink url="https://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS">https://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS</ulink>
ja: 完全なPosgreSQL/PostGIS対応表とPostGIS/GEOS対応表については<ulink url="http://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS">http://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS</ulink>をご覧ください。

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 <ulink url="https://proj.org/"> https://proj.org/ </ulink> .
ja: 投影変換ライブラリProj。Proj 6.1以上が必要です。Projライブラリは、PostGISの座標系投影変換機能に使われます。Projは<ulink url="https://proj.org/"> https://proj.org/ </ulink>からダウンロードできます。

note: Tag: para
en: GEOS geometry library, version 3.6 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 <ulink url="https://libgeos.org/"> https://libgeos.org </ulink>.
ja: ジオメトリライブラリGEOS、3.6以上が必要ですが、全ての関数と機能の利点を完全に得るにはGEOS 3.12以上が必要です。GEOSは<ulink url="https://libgeos.org/"> https://libgeos.org/ </ulink>からダウンロードできます。

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

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 <ulink url="https://github.com/json-c/json-c/releases">https://github.com/json-c/json-c/releases/</ulink>.
ja: JSON-C 0.9以上。JSON-Cは現在、ST_GeomFromGeoJsonによるGeoJSONの取り込みに使われます。JSON-Cは<ulink url="https://github.com/json-c/json-c/releases/">https://github.com/json-c/json-c/releases/</ulink>からダウンロード可能です。

note: Tag: para
en: GDAL, version 2+ is required 3+ is preferred. This is required for raster support. <ulink url="https://gdal.org/download.html">https://gdal.org/download.html</ulink>.
ja: GDAL, version 2以上が必要で以上が好ましいです。ラスタ機能に必要です。<ulink url="https://gdal.org/download.html">https://gdal.org/download.html</ulink>。

note: Tag: para
en: If compiling with PostgreSQL+JIT, LLVM version &gt;=6 is required <ulink url="https://trac.osgeo.org/postgis/ticket/4125">https://trac.osgeo.org/postgis/ticket/4125</ulink>.
ja: PostgreSQL+JITでコンパイルする場合には、LLVM 6版以上が必要です。<ulink url="https://trac.osgeo.org/postgis/ticket/4125">https://trac.osgeo.org/postgis/ticket/4125</ulink>を参照して下さい。

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. <ulink url="http://www.gtk.org/"> http://www.gtk.org/ </ulink> .
ja: GTK (GTK+2.0, 2.8+が必要)。シェープファイルのローダであるshp2pgsql-guiのコンパイル用です。<ulink url="http://www.gtk.org/">http://www.gtk.org/</ulink>にあります。

note: Tag: para
en: SFCGAL, version 1.3.1 (or higher), 1.4.1 or higher is recommended and required 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: <ulink url="https://oslandia.gitlab.io/SFCGAL/dev.html">https://oslandia.gitlab.io/SFCGAL/dev.html</ulink>) <ulink url="https://gitlab.com/Oslandia/SFCGAL/">https://gitlab.com/Oslandia/SFCGAL/</ulink>.
ja: SFCGL 1.3.1 (以上)、1.4.1以上が推奨で、全ての機能を使うに必要です。SFCGALは<xref linkend="reference_sfcgal"/>に示すような追加的な2次元や3次元の高度な解析関数をPostGISに与えることができます。GEOSと両方のバックエンドから提供される2次元関数 (ST_IntersectionやST_Areaなど)で、SFCGALを使用することもできます。SFCGALがインストールされている場合には、PostgreSQLコンフィギュレーション変数<code>postgis.backend</code>を使ってエンドユーザがどちらのバックエンドを使うか選択できます (デフォルトはGEOS)。ご注意: SFCGAL 1.2は少なくともCGAL 4.3とBooset 1.54が必要です (<ulink url="https://oslandia.gitlab.io/SFCGAL/dev.html">https://oslandia.gitlab.io/SFCGAL/dev.html</ulink>) <ulink url="https://gitlab.com/Oslandia/SFCGAL/">https://gitlab.com/Oslandia/SFCGAL/</ulink>。

note: Tag: para
en: In order to build the <xref linkend="Address_Standardizer"/> you will also need PCRE <ulink url="http://www.pcre.org">http://www.pcre.org</ulink> (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 <ulink url="http://www.pcre.org">http://www.pcre.org</ulink> (通常は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 <ulink url="https://github.com/protobuf-c/protobuf-c">protobuf-c</ulink>. 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が必要です。<ulink url="https://github.com/protobuf-c/protobuf-c">protobuf-c</ulink>をご覧下さい。デフォルトでは、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. <ulink url="http://cunit.sourceforge.net/">http://cunit.sourceforge.net/</ulink>
ja: CUnit (<filename>CUnit</filename>)。レグレッションテストに必要です。<ulink url="http://cunit.sourceforge.net/">http://cunit.sourceforge.net/</ulink>にあります。

note: Tag: para
en: DocBook (<filename>xsltproc</filename>) is required for building the documentation. Docbook is available from <ulink url="http://www.docbook.org/"> http://www.docbook.org/ </ulink> .
ja: DocBook (<filename>xsltproc</filename>)。文書のビルドに必要です。<ulink url="http://www.docbook.org/">http://www.docbook.org/</ulink>にあります。

note: Tag: para
en: DBLatex (<filename>dblatex</filename>) is required for building the documentation in PDF format. DBLatex is available from <ulink url="http://dblatex.sourceforge.net/"> http://dblatex.sourceforge.net/ </ulink> .
ja: DBLatex (<filename>dblatex</filename>)。文書をPDFでビルドするのに必要です。<ulink url="http://dblatex.sourceforge.net/">http://dblatex.sourcforge.net/</ulink>にあります。

note: Tag: para
en: ImageMagick (<filename>convert</filename>) is required to generate the images used in the documentation. ImageMagick is available from <ulink url="http://www.imagemagick.org/"> http://www.imagemagick.org/ </ulink> .
ja: ImageMagick (<filename>convert</filename>)。文書で使う画像を生成するのに必要です。<ulink url="http://www.imagemagick.org/">http://www.imagemagick.org/</ulink>にあります。

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 <ulink url="http://trac.osgeo.org/postgis/ticket/635"> http://trac.osgeo.org/postgis/ticket/635 </ulink> to track this bug.
ja: このパラメータは現在のところ壊れていて、PostgreSQLのインストール先にしかインストールされません。このバグのトラックについては<ulink url="http://trac.osgeo.org/postgis/ticket/635">http://trac.osgeo.org/postgis/ticket/635</ulink>をご覧ください。

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>>--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>>--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: <ulink url="http://oss.metaparadigm.com/json-c/">JSON-C</ulink> 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: <ulink url="http://oss.metaparadigm.com/json-c/">JSON-C</ulink>は、MITライセンスのJSONライブラリで、PostGISのST_GeomFromJSONに必須です。PostGISのビルドに使う特定のJSON-Cを手動で指定する場合に、このパラメータ (<command>--with-jsondir=/path/to/jsondir</command>)を使います。

note: Tag: para
en: <ulink url="http://www.pcre.org/">PCRE</ulink> 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: <ulink url="http://www.pcre.org/">PCRE</ulink>は、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 <ulink url="http://trac.osgeo.org/postgis/ticket/748">http://trac.osgeo.org/postgis/ticket/748</ulink> 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の検出とこれを用いたコンパイルを試みますが、ローダ破損を引き起こす非互換性問題のもとで実行する場合には、このコマンドで無効にできます。これを使ったコンフィギュレーションによって解決する問題の例は<ulink url="http://trac.osgeo.org/postgis/ticket/748">http://trac.osgeo.org/postgis/ticket/748</ulink>にあります。ご注意: これを切ることで多くの機能がなくなるわけではありません。まだ文書化されていなくて試験段階である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 <ulink url="https://trac.osgeo.org/postgis/wiki/CodeRepository"> code repository </ulink> , the first step is really to run the script
ja: PostGISを<ulink url="https://trac.osgeo.org/postgis/wiki/CodeRepository">コードレポジトリ</ulink>から得る場合には、はじめに次のスクリプトを実行します。

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 <ulink url="http://www.postgis.us/study_guides">PostGIS / PostgreSQL Study Guides</ulink>
ja: HTMLとPDFのビルド済みのものは<ulink url="http://www.postgis.us/study_guides">PostGIS / PostgreSQL Study Guides</ulink>にあります。

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 <ulink url="https://www.postgresql.org/docs/current/libpq-envars.html">psql environment variables</ulink>
ja: <code>make check</code>は、テスト実行のためにpsqlを使用し、psql環境変数を使用します。一般的なpsql環境変数で上書きすると便利なのが <varname>PGUSER</varname>,<varname>PGPORT</varname>, and <varname>PGHOST</varname>です。<ulink url="https://www.postgresql.org/docs/current/libpq-envars.html">環境変数</ulink>を参照して下さい。

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 -> extensions.
ja: 以上を実行すると、PgAdmin -> 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: <ulink url="http://www.pcre.org">http://www.pcre.org</ulink>. 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系システムにインストールされていますが、<ulink url="http://www.pcre.org">http://www.pcre.org</ulink>から最新版をダウンロードできます。<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 <ulink url="http://postgis.net/windows_downloads/">Windows Unreleased Versions</ulink> 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ジオコーダエクステンションが無かったり、インストールしているものより新しい版のものが欲しい場合には、<ulink url="http://postgis.net/windows_downloads/">Windows Unreleased Versions</ulink>で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: 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: 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: 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: 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 <ulink url="http://www.7-zip.org/">http://www.7-zip.org/</ulink>
ja: Windowsでは7-zipです。<ulink url="http://www.7-zip.org/">http://www.7-zip.org/</ulink>からダウンロードできる無償の圧縮解凍ツールです。

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 <ulink url="http://gnuwin32.sourceforge.net/packages/wget.htm">http://gnuwin32.sourceforge.net/packages/wget.htm</ulink>
ja: Windows用については、コンパイル済みのバイナリを<ulink url="http://gnuwin32.sourceforge.net/packages/wget.htm">http://gnuwin32.sourceforge.net/packages/wget.htm</ulink>から取得できます。

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>変数が正しくセットされたかをチェックして下さい。
